virtus
1b1217ace2
Build and Push Reader API Image / docker (push) Successful in 26s
chore(docker): remove MongoDB service and related configurations from local setup feat(migrations): create ChapterMeta table and add search_name, size_bytes, mtime_epoch, lastScannedAt, review_status, and review_payload columns to SourceAsset chore(dependencies): remove motor and pymongo from project dependencies
43 lines
2.7 KiB
Markdown
43 lines
2.7 KiB
Markdown
# Cross-Repo Endpoint Mapping Matrix
|
|
|
|
Muc tieu: map 1-1 giua API backend, Web va Mobile cho user-facing flows.
|
|
|
|
Legend:
|
|
- `Y`: da tich hop
|
|
- `P`: partial / can verify them
|
|
- `N`: 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 | `GET /api/import/assets/search` | Y | Y | N | Web MOD import wizard step 1 |
|
|
| Import | `GET /api/import/assets/{id}/preview-metadata` | Y | Y | N | Web MOD import wizard step 2 |
|
|
| Import | `POST /api/import/assets/{id}/ai-suggest` | Y | Y | N | Gen toi da 6 genres + short description |
|
|
| Import | `POST /api/import/assets/{id}/review` | Y | Y | N | Save reviewed metadata before import |
|
|
| Import | `POST /api/import/assets/{id}/parse-preview` | Y | Y | N | TOC/regex-start preview (10 head/mid/tail samples) |
|
|
| Import | `POST /api/import/assets/{id}/start-import` | Y | Y | N | Start import session |
|
|
| Import | `GET /api/import/sessions/{sessionId}` | Y | Y | N | Poll import progress |
|
|
|
|
## 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. Mobile import flow currently not planned (MOD-only on web).
|