> ## 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` 是项目的审计日志：共享、邀请、所有权转移、下载以及管理员操作。一个文档是一个项目上的一个事件。由 `web` 负责；schema 为 `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 | 发生了什么，为 kebab-case 名称，例如 `send-invite`（见下表）。 | `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`) | 创建一个条目（每个相关的托管订阅一个，这只在 `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`），schema 中的 `index: true` 标记不会生效。`managedSubscriptionId` 的索引迁移只带 `saas` 标签。

#### 说明

* 条目通过 TTL 索引在 `timestamp` 之后 2.5 年过期；项目的已删除记录过期时，该项目的所有条目也会一并删除。


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