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

`projectAuditLogEntries` projelerin denetim günlüğüdür: paylaşım, davetler, sahiplik devirleri, indirmeler ve yönetici işlemleri. Her belge, bir projedeki bir olaydır. Sahibi `web`'dir; şema `services/web/app/src/models/ProjectAuditLogEntry.mjs` dosyasıdır ve çekirdek `services/web/app/src/Features/Project/ProjectAuditLogHandler.mjs` üzerinden yazar.

#### Alanlar

| Alan | Tür | Anlamı | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Kayıt kimliği. | `ProjectAuditLogEntry.mjs:4` |
| `projectId` | ObjectId | Olayın ilgili olduğu proje. | `ProjectAuditLogEntry.mjs:6` |
| `operation` | String | Ne olduğu; `send-invite` gibi kebab-case bir ad (aşağıdaki tabloya bakın). | `ProjectAuditLogEntry.mjs:8` |
| `initiatorId` | ObjectId | İşlemi yapan kullanıcı veya yönetici işlemlerinde yönetici. | `ProjectAuditLogEntry.mjs:9` |
| `ipAddress` | String | İsteğin IP adresi (`req.ip`). | `ProjectAuditLogEntry.mjs:10` |
| `timestamp` | Date | Kaydın yazıldığı zaman (varsayılan `Date.now`). | `ProjectAuditLogEntry.mjs:11` |
| `info` | Object | Olayın ayrıntıları; anahtarlar işleme göre değişir. | `ProjectAuditLogEntry.mjs:12` |
| `managedSubscriptionId` | ObjectId | İlgili bir kullanıcının yönetilen grup aboneliği. Yalnızca `saas` özelliği açıkken bulunur (`services/web/app/src/Features/Subscription/SubscriptionLocator.mjs:111-112`), bu yüzden CE'de hiçbir zaman ayarlanmaz. | `ProjectAuditLogEntry.mjs:7` |
| `__v` | Number | Mongoose sürüm anahtarı; `ProjectAuditLogEntry.create` tarafından eklenir. | `ProjectAuditLogHandler.mjs:103` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `ProjectAuditLogHandler.mjs:80-105` (`addEntry`), `:157-171` (`addEntryInBackground`) | Bir kayıt oluşturur (ilgili her yönetilen abonelik için bir tane; bu yalnızca `saas` ile olur). |
| `ProjectAuditLogHandler.mjs:120-150` (`addEntryIfManaged`), `:175-190` | Yalnızca yönetilen bir abonelik söz konusuysa yazar. CE'de bu arama hep boş döner, bu yüzden bu çağrılar kayıt yazmaz. |
| `services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:24-32` (`logOnProject`) | Yönetim panelimiz, yönetici işlemlerini yöneticiyi başlatan olarak yazar. |
| `services/web/app/src/Features/Project/ProjectDeleter.mjs:392` | Silinmiş projenin süresi dolduğunda projenin tüm kayıtlarını siler (`expireDeletedProject`, `ProjectDeleter.mjs:344`). |
| `tools/migrations/20220913125500_migrate_auditLog_to_collections.mjs` | Tek seferlik geçiş: eski `projects.auditLog` dizilerini bu koleksiyona taşıdı. |

Çekirdeğin `addEntry` veya `addEntryInBackground` ile yazdığı işlemler:

| `operation` | Yazıldığı yer (`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>` (örneğin `project-exported-docx`) | `Downloads/ProjectDownloadsController.mjs:153-158` |

Modüllerimizin yazdığı işlemler (`services/web/modules/...`):

| `operation` | Yazıldığı yer |
| - | - |
| `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`) |

Çekirdek ayrıca `project-created`, `project-deleted`, `project-archived`, `project-unarchived`, `project-trashed`, `project-untrashed`, `project-restored`, `project-cloned` (`Project/ProjectController.mjs:292-479`) ve `project-history-version-restored`, `project-history-version-downloaded` (`History/HistoryController.mjs:334`, `:396`, `:454`, `:711`) için `addEntryIfManaged` çağırır. Bunlar CE'de hiçbir şey yazmaz; bir CE veritabanındaki `project-deleted` ve `project-restored` kayıtları yönetim panelinden gelir.

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:128-130` (`listProjectEntries`) | Yönetim panelimizin proje denetim günlüğü, `GET /admin/project/:projectId/audit-log/list` (`services/web/modules/admin-tools/app/src/AdminToolsRouter.mjs:120-124`). |

CE çekirdeğinde bu günlüğü gösteren bir sayfa yoktur.

#### Dizinler

| Ad | Anahtarlar | Seçenekler | Geçiş |
| - | - | - | - |
| `timestamp_1` | `{ timestamp: 1 }` | TTL, `expireAfterSeconds: 78840000` (2,5 yıl) | `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` önce `{ projectId: 1 }` üzerinde `project_id_1` dizinini oluşturdu; `20250912102601` onu bileşik dizinle değiştirir. Mongoose otomatik dizinleme kapalı olduğu için (`services/web/app/src/infrastructure/Mongoose.mjs:7`) şemadaki `index: true` işaretleri uygulanmaz. `managedSubscriptionId` dizin geçişi yalnızca `saas` etiketlidir.

#### Notlar

* Kayıtların süresi TTL dizini sayesinde `timestamp` değerinden 2,5 yıl sonra dolar; bir projenin silinmiş proje kaydının süresi dolduğunda projenin tüm kayıtları da gider.


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