> ## 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 | معرّف الإدخال. | `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` (سنتان ونصف) | `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` فقط.

#### ملاحظات

* تنتهي صلاحية الإدخالات بعد سنتين ونصف من `timestamp` عبر فهرس TTL، وتزول جميع إدخالات المشروع عند انتهاء صلاحية سجل المشروع المحذوف.


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