virtus/reader
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3036854cf2e80f6561f7fdab088dce70f0013525
reader/ARCHITECTURE.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.8 KiB
Raw Blame History

Reader Suite Architecture (Web)

Tai lieu nay mo ta vai tro cua reader (web app) trong bo 3 he thong: Web + Android + API.

Vai tro trong he thong

  • reader la frontend web cho end-user va mot phan workflow cho MOD/ADMIN.
  • reader KHONG duoc tro thanh noi xu ly business logic chinh.
  • reader-api la API trung tam, la nguon su that cho contract va domain behavior.

Nguyen tac thong nhat voi mobile + backend

  • API-first: moi tinh nang user-facing moi phai co endpoint ro rang trong reader-api.
  • Contract-first: web va mobile dung chung schema response, error code, pagination.
  • Auth parity:
    • Web: NextAuth session cookies.
    • Mobile: Bearer JWT.
    • Ca hai deu map vao cung user identity trong backend.
  • Data ownership:
    • PostgreSQL (web): metadata co cau truc (user, novel, genre, comment, bookmark...).
    • Chapter body / file lon: do reader-api orchestrate (NAS storage refs, khong con MongoDB trong stack).

Kien truc module web

  • App layer (app/*): route, rendering, page composition.
  • UI layer (components/*): reusable components, khong chua business rule quan trong.
  • Data access layer: goi REST API qua READER_API_ORIGIN (rewrite trong next.config.mjs va/hoac proxy trong app/api/*/route.ts).
  • Auth adapter: dong bo session NextAuth va profile API.

Quy uoc tich hop API

  • Base URL local: http://localhost:8000 (qua READER_API_ORIGIN).
  • Khong hard-code endpoint trong component; gom theo domain (novels, chapters, user...).
  • Luon xu ly 3 nhom loi:
    • validation/business (4xx)
    • auth (401/403)
    • he thong (5xx)

Definition of Done (Web)

  • Tinh nang moi co endpoint tai reader-api hoac da duoc architect chap thuan.
  • Khong duplicate business logic voi mobile.
  • Da test luong auth va state dong bo profile/bookmark/progress.
  • README va contract docs duoc cap nhat neu co thay doi API.
Reference in New Issue View Git Blame Copy Permalink