virtus/reader-api

Files

T

virtus 1b1217ace2

Build and Push Reader API Image / docker (push) Successful in 26s

Details

feat(storage): add delete_href method to remove files and clean up empty directories

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

2026-05-03 20:57:29 +07:00

1.7 KiB

Raw Blame History

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.

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.