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
1.7 KiB
1.7 KiB
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:
- Resolve current user identity.
- Validate role/permission.
- 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:
tocorregex(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.