docs: Revise architecture and contract documentation, clarify mobile API behavior, and update import flow details

This commit is contained in:
2026-05-11 15:28:00 +07:00
parent 4f3eb280aa
commit 6319386a2f
6 changed files with 18 additions and 25 deletions
+3 -8
View File
@@ -26,17 +26,12 @@ Legend:
| Comment | `GET/POST /api/truyen/{id}/comments` | Y | Y | Y | |
| Rating | `POST /api/truyen/{id}/rate` | Y | Y | N | Mobile chua thay rating flow |
| Search | `GET /api/truyen/suggest` | Y | Y | N | Mobile search suggest can bo sung |
| Import | `GET /api/import/assets/search` | Y | Y | N | Web MOD-only flow |
| Import | `GET /api/import/assets/{id}/preview-metadata` | Y | Y | N | Web MOD-only flow |
| Import | `POST /api/import/assets/{id}/ai-suggest` | Y | Y | N | Web MOD-only flow |
| Import | `POST /api/import/assets/{id}/review` | Y | Y | N | Web MOD-only flow |
| Import | `POST /api/import/assets/{id}/parse-preview` | Y | Y | N | Web MOD-only flow |
| Import | `POST /api/import/assets/{id}/start-import` | Y | Y | N | Web MOD-only flow |
| Import | `GET /api/import/sessions/{sessionId}` | Y | Y | N | Web MOD-only flow |
| Import | `POST /api/import/uploads/preview` | Y | Y | N | Upload EPUB multipart (preview) |
| Import | `POST /api/mod/epub`, `POST /api/mod/epub/ai-suggest` | Y | Y | N | Luong `/mod/import` |
| Import | `GET/POST/PUT/DELETE /api/mod/the-loai` | Y | Y | N | MOD quan ly the loai trong wizard |
## Priority gaps de dong bo tiep
1. Mobile: `user/settings`, `recommendations`, `rate`, `suggest`.
2. Web/Mobile chapter-read strategy can unify (`chapters/{id}` vs `by-number`).
3. Chuan hoa error contract implementation theo `CONTRACT.md`.
4. Import EPUB is intentionally out of mobile scope.