chore: update architecture and documentation to reflect removal of MongoDB and transition to NAS storage for chapter content
Build and Push Reader API Image / docker (push) Successful in 1m3s

- Updated `.env.example` to remove MongoDB configuration.
- Revised `ARCHITECTURE.md` to reflect changes in data orchestration and storage strategy.
- Removed `CHAPTER_SAVE_DEBUG.md` and `FIXES_APPLIED.md` as they are no longer relevant.
- Updated `CONTRACT.md` to include new error codes.
- Adjusted endpoint documentation in `CROSS_REPO_ENDPOINT_MATRIX.md` and `README.md` to align with the new import flow.
- Removed legacy import scripts and tables from the codebase.
This commit is contained in:
2026-05-11 15:27:56 +07:00
parent 5a14671b6c
commit c985df7579
12 changed files with 167 additions and 2417 deletions
+8 -15
View File
@@ -39,20 +39,13 @@ Backend flow theo domain, de web/mobile follow giong nhau.
## Flow E: EPUB Import (MOD/ADMIN)
- Step 1 search source:
- `/api/import/assets/search`
- Step 2 review metadata:
- `/api/import/assets/{id}/preview-metadata`
- `/api/import/assets/{id}/ai-suggest`
- `/api/import/assets/{id}/review`
- Step 3 chapter split preview:
- `/api/import/assets/{id}/parse-preview`
- split mode: `toc` or `regex` (chapter-start pattern only)
- Step 4 start import + progress:
- `/api/import/assets/{id}/start-import`
- `/api/import/sessions/{sessionId}`
Luồng trên web (`reader` `/mod/import`):
- Thể loại: `GET/POST/PUT/DELETE /api/mod/the-loai`
- Upload EPUB preview: `POST /api/import/uploads/preview` (multipart)
- Gợi ý metadata: `POST /api/mod/epub/ai-suggest`
- Import EPUB: `POST /api/mod/epub`
Rules:
- No filesystem scan in search request path (scan by cron/incremental).
- Reviewer confirms metadata before import.
- Import writes NAS content + chapter refs, then updates novel counters.
- Import ghi nội dung NAS / refs chương và cập nhật metadata novel khi hoàn tất.