> ## 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`이 소유하며, 스키마는 `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`) 스키마의 `index: true` 표시는 적용되지 않습니다. `managedSubscriptionId` 인덱스 마이그레이션에는 `saas` 태그만 붙어 있습니다.

#### 참고

* 항목은 TTL 인덱스에 의해 `timestamp`로부터 2.5년 뒤 만료되며, 프로젝트의 삭제된 프로젝트 레코드가 만료되면 그 프로젝트의 모든 항목도 사라집니다.


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