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

# Коллекция projectAuditLogEntries

`projectAuditLogEntries` представляет собой журнал аудита проектов: общий доступ, приглашения, передача владения, скачивания и действия администраторов. Каждый документ описывает одно событие в одном проекте. Владельцем является `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 | Что произошло, имя в 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`) |

Ядро также вызывает `addEntryIfManaged` для `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`). В CE они ничего не записывают; записи `project-deleted` и `project-restored` в базе CE появляются из панели администратора.

#### Кто читает

| Код | Что делает |
| - | - |
| `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` сначала создала `project_id_1` по `{ projectId: 1 }`; `20250912102601` заменяет его составным индексом. Пометки `index: true` в схеме не применяются, поскольку автоматическое создание индексов в Mongoose отключено (`services/web/app/src/infrastructure/Mongoose.mjs:7`). Миграция индекса `managedSubscriptionId` имеет только тег `saas`.

#### Примечания

* Записи истекают через 2,5 года после `timestamp` благодаря TTL-индексу, а все записи проекта исчезают, когда истекает срок хранения записи о его удалении.


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