c985df7579
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.
2.2 KiB
2.2 KiB
Cross-Repo Endpoint Mapping Matrix
Muc tieu: map 1-1 giua API backend, Web va Mobile cho user-facing flows.
Legend:
Y: da tich hopP: partial / can verify themN: chua tich hop
| Domain | Endpoint | API | Web | Mobile | Notes |
|---|---|---|---|---|---|
| Health | GET /api/health |
Y | P | P | Dung cho monitor, khong phai main UI flow |
| Auth | POST /api/auth/mobile-login |
Y | Y | Y | Web dung route adapter login, mobile dung JWT |
| User | GET /api/user/profile |
Y | P | Y | Web dang goi qua user route proxy |
| User | GET/POST /api/user/bookmarks |
Y | Y | Y | Parity can test theo tabs bookshelf |
| User | DELETE /api/user/bookmarks/{novelId} |
Y | P | Y | Web co remove flow can verify UX parity |
| User | POST /api/user/reading-progress |
Y | P | Y | Can doi chieu dong bo chapter progress |
| User | GET/POST /api/user/settings |
Y | Y | N | Mobile chua thay call settings ro rang |
| User | GET/POST/DELETE /api/user/recommendations |
Y | Y | N | Mobile chua thay provider recommendation |
| Catalog | GET /api/genres |
Y | Y | Y | |
| Catalog | GET /api/novels/browse |
Y | Y | Y | |
| Catalog | GET /api/novels/{idOrSlug} |
Y | Y | Y | |
| Novel | GET /api/truyen/{id}/chapters |
Y | Y | Y | |
| Novel | GET /api/truyen/{id}/chapters/by-number/{n} |
Y | Y | N | Mobile doc chapter theo chapterId endpoint |
| Chapter | GET /api/chapters/{chapterId} |
Y | N | Y | Web doc chapter qua truyen/by-number |
| 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 | 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
- Mobile:
user/settings,recommendations,rate,suggest. - Web/Mobile chapter-read strategy can unify (
chapters/{id}vsby-number). - Chuan hoa error contract implementation theo
CONTRACT.md.