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
59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
# Flows - Reader API
|
|
|
|
Backend flow theo domain, de web/mobile follow giong nhau.
|
|
|
|
## Flow A: Auth Identity Unification
|
|
|
|
- Input:
|
|
- Web session cookie (NextAuth)
|
|
- Mobile bearer JWT
|
|
- Behavior:
|
|
1. Resolve current user identity.
|
|
2. Validate role/permission.
|
|
3. Return consistent auth errors (`401/403`).
|
|
|
|
## Flow B: Discovery and Reading
|
|
|
|
- Discovery:
|
|
- `/api/genres`
|
|
- `/api/novels/browse`
|
|
- `/api/novels/{idOrSlug}`
|
|
- Reading:
|
|
- `/api/truyen/{id}/chapters`
|
|
- `/api/chapters/{chapterId}` or chapter-by-number variant
|
|
- Rule: response shape on dinh de client render.
|
|
|
|
## Flow C: User Personalization
|
|
|
|
- Bookmark: `/api/user/bookmarks`.
|
|
- Progress: `/api/user/reading-progress`.
|
|
- Settings: `/api/user/settings`.
|
|
- Recommendations: `/api/user/recommendations`.
|
|
- Rule: idempotent where possible, clear conflict semantics.
|
|
|
|
## Flow D: Social Interaction
|
|
|
|
- Comments: `/api/truyen/{id}/comments`.
|
|
- Rating: `/api/truyen/{id}/rate`.
|
|
- Rule: enforce auth + anti-invalid payload + stable error format.
|
|
|
|
## 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}`
|
|
|
|
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.
|