> ## 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.

# Collection Project Audit Log Entries

`projectAuditLogEntries` là nhật ký kiểm tra của dự án: chia sẻ, lời mời, chuyển quyền sở hữu, tải xuống và các thao tác quản trị. Mỗi tài liệu là một sự kiện trên một dự án. `web` sở hữu collection này; schema là `services/web/app/src/models/ProjectAuditLogEntry.mjs`, và phần lõi ghi thông qua `services/web/app/src/Features/Project/ProjectAuditLogHandler.mjs`.

#### Trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id của mục. | `ProjectAuditLogEntry.mjs:4` |
| `projectId` | ObjectId | Dự án mà sự kiện liên quan. | `ProjectAuditLogEntry.mjs:6` |
| `operation` | String | Điều gì đã xảy ra, một tên dạng kebab-case như `send-invite` (xem bảng bên dưới). | `ProjectAuditLogEntry.mjs:8` |
| `initiatorId` | ObjectId | Người dùng đã thực hiện, hoặc quản trị viên với các thao tác quản trị. | `ProjectAuditLogEntry.mjs:9` |
| `ipAddress` | String | Địa chỉ IP của yêu cầu (`req.ip`). | `ProjectAuditLogEntry.mjs:10` |
| `timestamp` | Date | Thời điểm mục được ghi (mặc định `Date.now`). | `ProjectAuditLogEntry.mjs:11` |
| `info` | Object | Chi tiết sự kiện; các khóa phụ thuộc vào thao tác. | `ProjectAuditLogEntry.mjs:12` |
| `managedSubscriptionId` | ObjectId | Gói đăng ký nhóm được quản lý của một người dùng liên quan. Chỉ tìm thấy khi tính năng `saas` bật (`services/web/app/src/Features/Subscription/SubscriptionLocator.mjs:111-112`), nên không bao giờ có trong CE. | `ProjectAuditLogEntry.mjs:7` |
| `__v` | Number | Khóa phiên bản của Mongoose, được thêm bởi `ProjectAuditLogEntry.create`. | `ProjectAuditLogHandler.mjs:103` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `ProjectAuditLogHandler.mjs:80-105` (`addEntry`), `:157-171` (`addEntryInBackground`) | Tạo một mục (mỗi gói đăng ký được quản lý liên quan một mục, điều chỉ xảy ra với `saas`). |
| `ProjectAuditLogHandler.mjs:120-150` (`addEntryIfManaged`), `:175-190` | Chỉ ghi khi có gói đăng ký được quản lý liên quan. Trong CE, truy vấn đó luôn không trả về gì, nên các lệnh gọi này không ghi mục nào. |
| `services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:24-32` (`logOnProject`) | Bảng quản trị của chúng tôi ghi các thao tác quản trị với quản trị viên là người khởi tạo. |
| `services/web/app/src/Features/Project/ProjectDeleter.mjs:392` | Xóa mọi mục của dự án khi dự án đã xóa hết hạn (`expireDeletedProject`, `ProjectDeleter.mjs:344`). |
| `tools/migrations/20220913125500_migrate_auditLog_to_collections.mjs` | Migration một lần: đã chuyển các mảng `projects.auditLog` cũ vào collection này. |

Các thao tác do phần lõi ghi bằng `addEntry` hoặc `addEntryInBackground`:

| `operation` | Vị trí ghi (`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>` (ví dụ `project-exported-docx`) | `Downloads/ProjectDownloadsController.mjs:153-158` |

Các thao tác do các module của chúng tôi ghi (`services/web/modules/...`):

| `operation` | Vị trí ghi |
| - | - |
| `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`) |

Phần lõi cũng gọi `addEntryIfManaged` cho `project-created`, `project-deleted`, `project-archived`, `project-unarchived`, `project-trashed`, `project-untrashed`, `project-restored`, `project-cloned` (`Project/ProjectController.mjs:292-479`) và `project-history-version-restored`, `project-history-version-downloaded` (`History/HistoryController.mjs:334`, `:396`, `:454`, `:711`). Những lệnh này không ghi gì trong CE; các mục `project-deleted` và `project-restored` trong cơ sở dữ liệu CE đến từ bảng quản trị.

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:128-130` (`listProjectEntries`) | Nhật ký kiểm tra dự án trong bảng quản trị của chúng tôi, `GET /admin/project/:projectId/audit-log/list` (`services/web/modules/admin-tools/app/src/AdminToolsRouter.mjs:120-124`). |

Phần lõi CE không có trang nào hiển thị nhật ký này.

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `timestamp_1` | `{ timestamp: 1 }` | TTL, `expireAfterSeconds: 78840000` (2,5 năm) | `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` ban đầu tạo `project_id_1` trên `{ projectId: 1 }`; `20250912102601` thay nó bằng chỉ mục kết hợp. Các đánh dấu `index: true` của schema không được áp dụng vì tự động tạo chỉ mục của Mongoose đã tắt (`services/web/app/src/infrastructure/Mongoose.mjs:7`). Migration chỉ mục của `managedSubscriptionId` chỉ được gắn thẻ `saas`.

#### Ghi chú

* Các mục hết hạn 2,5 năm sau `timestamp` thông qua chỉ mục TTL, và mọi mục của một dự án biến mất khi bản ghi dự án đã xóa của nó hết hạn.


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