> ## 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 History Sync State

`projectHistorySyncState` lưu một tài liệu cho mỗi dự án đã được đồng bộ lại: trạng thái của lần đồng bộ lại đang chạy hoặc gần nhất, khi project-history dựng lại lịch sử của một dự án từ những gì web và docstore đang giữ. Collection này thuộc project-history và không có schema Mongoose; mã là lớp `SyncState` cùng các hàm trợ giúp của nó trong `services/project-history/app/js/SyncManager.js`.

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Được tạo bởi upsert. | `SyncManager.js:233-237` |
| `project_id` | ObjectId | Dự án. | `SyncManager.js:233-237` |
| `resyncProjectStructure` | Boolean | `true` khi project-history đang chờ cấu trúc dự án (cây tệp) từ web. | `SyncManager.js:457`, `536-543` |
| `resyncDocContents` | Array of String | Đường dẫn của các doc mà nó vẫn đang chờ nội dung. | `SyncManager.js:458`, `482`, `545-546` |
| `origin` | Object | Ai đã yêu cầu đồng bộ lại, ví dụ giá trị mặc định `{ kind: 'history-resync' }`. | `SyncManager.js:150`, `459` |
| `hardResync` | Boolean | `true` cho đồng bộ lại cứng, loại bỏ trước các cập nhật đang xếp hàng và trạng thái đồng bộ cũ. | `SyncManager.js:81-100`, `152`, `460` |
| `recoverCorruptedFiles` | Boolean | Tùy chọn của yêu cầu đồng bộ lại (`HttpController.js:963-964`). Trong đồng bộ lại cứng, doc có nội dung lịch sử bị hỏng sẽ bị gỡ bỏ rồi thêm lại từ docstore (`SyncManager.js:942-951`). | `SyncManager.js:153`, `461` |
| `history` | Array of Object | 100 trạng thái gần nhất, mới nhất trước, mỗi trạng thái là `{ syncState, timestamp }`; `syncState` chứa năm trường ở trên. | `SyncManager.js:41`, `202-208` |
| `lastUpdated` | Date | Thời điểm ghi gần nhất. | `SyncManager.js:209` |
| `resyncCount` | Number | Số lần đồng bộ lại đã bắt đầu. | `SyncManager.js:215` |
| `resyncPendingSince` | Date | Thời điểm lần đồng bộ lại đang chạy bắt đầu; bị gỡ bỏ khi nó kết thúc. | `SyncManager.js:217`, `224-225` |
| `expiresAt` | Date | Được đặt thành 90 ngày sau khi một lần đồng bộ lại kết thúc, và bị gỡ bỏ khi có lần đang chạy. Chỉ mục TTL xóa tài liệu vào thời điểm này. | `SyncManager.js:42`, `216`, `221-223` |
| `stuckClearCount` | Number | Số lần một lần đồng bộ lại bị kẹt đã được xóa và khởi động lại; bị gỡ bỏ khi một lần đồng bộ lại kết thúc. | `SyncManager.js:261`, `226` |
| `lastStuckClearAt` | Date | Thời điểm của lần xóa như vậy gần nhất. | `SyncManager.js:262`, `227` |
| `lastStuckDocPaths` | Array of String | Các đường dẫn doc vẫn còn chờ ở lần xóa gần nhất. | `SyncManager.js:262`, `228` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `services/project-history/app/js/SyncManager.js:195-249` | `setResyncState`: upsert trạng thái. Được gọi khi một lần đồng bộ lại bắt đầu (`SyncManager.js:163`) và trong khi project-history xử lý các cập nhật đồng bộ lại (`services/project-history/app/js/UpdatesProcessor.js:637`, `784`). |
| `SyncManager.js:257-266` | `_recordStuckClearInSyncState`: đếm một lần đồng bộ lại bị kẹt được xóa. |
| `SyncManager.js:251-255` | `clearResyncState`: xóa tài liệu khi bắt đầu đồng bộ lại cứng (`SyncManager.js:87`), khi gọi project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1363-1396`), và khi một lần đồng bộ lại chỉ cấu trúc phải bắt đầu lại (`SyncManager.js:705-716`). |
| `SyncManager.js:273-289` | `clearResyncStateIfAllAfter`: xóa một trạng thái đã hoàn tất có toàn bộ lịch sử mới hơn một ngày cho trước. Không có gì trong `app/js` gọi nó. |
| `SyncManager.js:171-181` | `cloneResyncState`: sao chép trạng thái sang một dự án khác, cho project-history `POST /project/:project_id/clone` (`HttpController.js:57`, `124`), mà không có gì trong web gọi. |

Một lần đồng bộ lại được bắt đầu bởi project-history `POST /project/:project_id/resync` (`HttpController.js:950-994`), bởi các cron job thử lại (`services/project-history/app/js/RetryManager.js:156-179`, `server-ce/config/crontab-history`), và bởi chính project-history khi việc xử lý cập nhật cần đến (`UpdatesProcessor.js:75`, `224`).

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `SyncManager.js:187-193` | `getResyncState`: tải trạng thái. Được dùng để quyết định liệu một lần đồng bộ lại có đang chạy trước khi bắt đầu lần mới (`SyncManager.js:106-149`), để bỏ qua các cập nhật thông thường khi nó đang chạy (`SyncManager.js:291-300`), và sau một lần flush để báo cáo lần đồng bộ lại đang chạy (`UpdatesProcessor.js:463-466`). |
| `HttpController.js:533-545` | `GET /project/:project_id/resync-pending`: liệu một lần đồng bộ lại đang chạy hay bị kẹt. |
| `HttpController.js:563-585` | `GET /project/:project_id/debug-info`: trạng thái đồng bộ cùng với bản ghi lỗi. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145021_create_projectHistorySyncState_indexes.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0` | `tools/migrations/20190912145021_create_projectHistorySyncState_indexes.mjs` |

#### Ghi chú

* Một lần đồng bộ lại đang chạy khi `resyncProjectStructure` là `true` hoặc `resyncDocContents` không rỗng (`SyncManager.js:565-567`). Nó được coi là bị kẹt sau 4 giờ, và bị kẹt vĩnh viễn sau 5 lần xóa (`SyncManager.js:43-44`, `569-585`).
* Khi một lần đồng bộ lại kết thúc, project-history cũng đặt `overleaf.history.lastResyncedAt` trên dự án (`SyncManager.js:239-248`).


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