> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Audit Log Entries コレクション

`projectAuditLogEntries` は、プロジェクトの監査ログです。共有、招待、所有権の移転、ダウンロード、管理者による操作を記録します。1 つのドキュメントは 1 つのプロジェクトに対する 1 件のイベントです。`web` が管理しており、スキーマは `services/web/app/src/models/ProjectAuditLogEntry.mjs`、コアは `services/web/app/src/Features/Project/ProjectAuditLogHandler.mjs` を通じて書き込みます。

#### フィールド

| フィールド | 型 | 意味 | 出典 |
| - | - | - | - |
| `_id` | ObjectId | エントリ id。 | `ProjectAuditLogEntry.mjs:4` |
| `projectId` | ObjectId | イベントの対象となるプロジェクト。 | `ProjectAuditLogEntry.mjs:6` |
| `operation` | String | 何が起きたか。`send-invite` のような kebab-case の名前です（下の表を参照）。 | `ProjectAuditLogEntry.mjs:8` |
| `initiatorId` | ObjectId | 実行したユーザー、または管理者操作の場合は管理者。 | `ProjectAuditLogEntry.mjs:9` |
| `ipAddress` | String | リクエストの IP アドレス（`req.ip`）。 | `ProjectAuditLogEntry.mjs:10` |
| `timestamp` | Date | エントリが書き込まれた日時（デフォルトは `Date.now`）。 | `ProjectAuditLogEntry.mjs:11` |
| `info` | Object | イベントの詳細。キーは操作によって異なります。 | `ProjectAuditLogEntry.mjs:12` |
| `managedSubscriptionId` | ObjectId | 関係するユーザーの管理対象グループサブスクリプション。`saas` 機能が有効な場合にのみ見つかるため（`services/web/app/src/Features/Subscription/SubscriptionLocator.mjs:111-112`）、CE では設定されません。 | `ProjectAuditLogEntry.mjs:7` |
| `__v` | Number | Mongoose のバージョンキー。`ProjectAuditLogEntry.create` が追加します。 | `ProjectAuditLogHandler.mjs:103` |

#### 書き込むコード

| コード | 動作 |
| - | - |
| `ProjectAuditLogHandler.mjs:80-105` (`addEntry`), `:157-171` (`addEntryInBackground`) | エントリを 1 件作成します（関係する管理対象サブスクリプションごとに 1 件。これは `saas` でのみ起こります）。 |
| `ProjectAuditLogHandler.mjs:120-150` (`addEntryIfManaged`), `:175-190` | 管理対象サブスクリプションが関係する場合にのみ書き込みます。CE ではその検索が常に何も返さないため、これらの呼び出しはエントリを書き込みません。 |
| `services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:24-32` (`logOnProject`) | 私たちの管理パネルは、管理者を実行者として管理者操作を書き込みます。 |
| `services/web/app/src/Features/Project/ProjectDeleter.mjs:392` | 削除済みプロジェクトの期限が切れたとき、そのプロジェクトのすべてのエントリを削除します（`expireDeletedProject`、`ProjectDeleter.mjs:344`）。 |
| `tools/migrations/20220913125500_migrate_auditLog_to_collections.mjs` | 一度きりのマイグレーション: 古い `projects.auditLog` 配列をこのコレクションに移しました。 |

コアが `addEntry` または `addEntryInBackground` で書き込む操作:

| `operation` | 書き込み箇所 (`services/web/app/src/Features/...`) |
| - | - |
| `send-invite`, `revoke-invite`, `resend-invite`, `accept-invite` | `Collaborators/CollaboratorsInviteController.mjs:198`, `:237`, `:293`, `:538` |
| `sharing-link-created`, `sharing-link-updated` | `Collaborators/CollaboratorsInviteController.mjs:698`, `:713` |
| `editor-moved-to-pending` | `Collaborators/CollaboratorsInviteHandler.mjs:183` |
| `remove-collaborator`, `leave-project` | `Collaborators/CollaboratorsController.mjs:67`, `:98` |
| `project-role-changed` | `Collaborators/CollaboratorsHandler.mjs:396` |
| `transfer-ownership` | `Collaborators/OwnershipTransferHandler.mjs:122` |
| `toggle-access-level` | `Project/ProjectController.mjs:268` |
| `accept-via-link-sharing` | `TokenAccess/TokenAccessController.mjs:366`, `:594` |
| `join-via-token`, `readonly-via-sharing-updates` | `TokenAccess/TokenAccessController.mjs:477`, `:660` |
| `project-downloaded` | `Downloads/ProjectDownloadsController.mjs:220`, `:276` |
| `project-exported-<type>` (例: `project-exported-docx`) | `Downloads/ProjectDownloadsController.mjs:153-158` |

私たちのモジュールが書き込む操作（`services/web/modules/...`）:

| `operation` | 書き込み箇所 |
| - | - |
| `integration-repo-linked`, `integration-repo-unlinked` | `github-sync/app/src/GitHubSyncController.mjs:94`, `:201`, `:244`; `gitlab-sync/app/src/GitLabSyncController.mjs:94`, `:213`, `:256`; `gitea-sync/app/src/GiteaSyncController.mjs:94`, `:213`, `:256` |
| `publish-template` | `template-gallery/app/src/TemplateGalleryController.mjs:53` |
| `restore-deleted-doc`, `project-deleted`, `project-restored` | `admin-tools/app/src/AdminProjectManager.mjs:477`, `:492`, `:513`; `admin-tools/app/src/AdminUserManager.mjs:688` (`project-restored`) |

コアは `project-created`、`project-deleted`、`project-archived`、`project-unarchived`、`project-trashed`、`project-untrashed`、`project-restored`、`project-cloned`（`Project/ProjectController.mjs:292-479`）、および `project-history-version-restored`、`project-history-version-downloaded`（`History/HistoryController.mjs:334`、`:396`、`:454`、`:711`）についても `addEntryIfManaged` を呼び出します。これらは CE では何も書き込みません。CE データベースにある `project-deleted` と `project-restored` のエントリは管理パネルによるものです。

#### 読み取るコード

| コード | 動作 |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:128-130` (`listProjectEntries`) | 私たちの管理パネルのプロジェクト監査ログ、`GET /admin/project/:projectId/audit-log/list`（`services/web/modules/admin-tools/app/src/AdminToolsRouter.mjs:120-124`）。 |

CE のコアには、このログを表示するページはありません。

#### インデックス

| 名前 | キー | オプション | マイグレーション |
| - | - | - | - |
| `timestamp_1` | `{ timestamp: 1 }` | TTL, `expireAfterSeconds: 78840000` (2.5 年) | `tools/migrations/20220913105500_create_auditLog_indexes.mjs` |
| `projectId_1_timestamp_-1` | `{ projectId: 1, timestamp: -1 }` | | `tools/migrations/20250912102601_add_timestamp_to_projectAuditLogEntries_index.mjs` |

`tools/migrations/20220929193200_add_auditLog_indexes.mjs` が最初に `{ projectId: 1 }` に `project_id_1` を作成し、`20250912102601` がそれを複合インデックスに置き換えます。Mongoose の自動インデックス作成は無効なため（`services/web/app/src/infrastructure/Mongoose.mjs:7`）、スキーマの `index: true` は適用されません。`managedSubscriptionId` のインデックスのマイグレーションには `saas` タグしか付いていません。

#### 補足

* エントリは TTL インデックスにより `timestamp` から 2.5 年後に期限切れになり、プロジェクトの削除済みレコードの期限が切れると、そのプロジェクトのすべてのエントリも削除されます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.