virtus/reader
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
reader/FLOWS.md
T
virtus 669addf799
Build and Push Reader Image / docker (push) Failing after 22s
Details
feat: Revamp EPUB import process with batch upload support and enhanced API integration 
- Introduced a new batch import client for handling multiple EPUB files simultaneously.
- Updated API routes for previewing and importing EPUB files, improving error handling and response management.
- Enhanced genre management during import, allowing for dynamic creation and association of genres.
- Implemented long-fetch handling to accommodate lengthy processing times for large EPUB files.
- Refined UI components for better user experience in the import workflow.
2026-05-11 15:27:13 +07:00

1.6 KiB
Raw Permalink Blame History

Flows - Reader Web

Luon xem reader-api la canonical behavior.

Flow 1: Web Login and Session

  • Trigger: user bam dang nhap Google.
  • Preconditions: env OAuth hop le.
  • Steps:
    1. User xac thuc Google qua NextAuth.
    2. Web co session cookie.
    3. Web goi endpoint user de hydrate profile/state.
  • Success: user vao trang co tinh nang ca nhan hoa.

Flow 2: Browse -> Novel Detail -> Read Chapter

  • Trigger: user click tu home/search/genre.
  • Steps:
    1. Goi /api/novels/browse hoac /api/novels/{idOrSlug}.
    2. Goi /api/truyen/{id}/chapters lay muc luc.
    3. Doc chapter qua luong chapter hien co cua web.
  • Failure handling:
    • 404: thong bao khong tim thay truyen/chuong.
    • 5xx: retry UI + fallback message.

Flow 3: Bookmark and Progress Sync

  • Trigger: user bookmark hoac chuyen chuong.
  • Steps:
    1. Bookmark: GET/POST/DELETE /api/user/bookmarks.
    2. Progress: POST /api/user/reading-progress.
    3. UI cap nhat trang thai optimistic + reconcile API.
  • Expected parity: cung nghia status voi mobile.

Flow 4: Comment / Rating / Recommendation

  • Comment: GET/POST /api/truyen/{id}/comments.
  • Rating: POST /api/truyen/{id}/rate.
  • Recommendation: /api/user/recommendations.
  • Error rules: follow CONTRACT.md.

Flow 5: MOD EPUB Import Wizard

  • Route: /mod/import
  • Steps (khớp app/mod/import/import-client.tsx):
    1. Chọn thể loại / tạo thể loại qua /api/mod/the-loai.
    2. Upload EPUB để preview: POST /api/import/uploads/preview (multipart).
    3. Gợi ý metadata (tuỳ bước): POST /api/mod/epub/ai-suggest.
    4. Import/xử lý EPUB: POST /api/mod/epub (multipart; có luồng preview và apply).
Reference in New Issue View Git Blame Copy Permalink