From 4f3eb280aa2a862b2134b0c414a8f99818f964df Mon Sep 17 00:00:00 2001
From: virtus <fevirtus@gmail.com>
Date: Sun, 3 May 2026 20:58:20 +0700
Subject: [PATCH] feat: Update documentation for EPUB import flow and clarify
 mobile scope limitations

---
 CROSS_REPO_ENDPOINT_MATRIX.md | 8 ++++++++
 FEATURES.md                   | 4 ++++
 FLOWS.md                      | 4 ++++
 3 files changed, 16 insertions(+)

diff --git a/CROSS_REPO_ENDPOINT_MATRIX.md b/CROSS_REPO_ENDPOINT_MATRIX.md
index bd9eb2a..a36721b 100644
--- a/CROSS_REPO_ENDPOINT_MATRIX.md
+++ b/CROSS_REPO_ENDPOINT_MATRIX.md
@@ -26,9 +26,17 @@ Legend:
 | Comment | `GET/POST /api/truyen/{id}/comments` | Y | Y | Y | |
 | Rating | `POST /api/truyen/{id}/rate` | Y | Y | N | Mobile chua thay rating flow |
 | Search | `GET /api/truyen/suggest` | Y | Y | N | Mobile search suggest can bo sung |
+| Import | `GET /api/import/assets/search` | Y | Y | N | Web MOD-only flow |
+| Import | `GET /api/import/assets/{id}/preview-metadata` | Y | Y | N | Web MOD-only flow |
+| Import | `POST /api/import/assets/{id}/ai-suggest` | Y | Y | N | Web MOD-only flow |
+| Import | `POST /api/import/assets/{id}/review` | Y | Y | N | Web MOD-only flow |
+| Import | `POST /api/import/assets/{id}/parse-preview` | Y | Y | N | Web MOD-only flow |
+| Import | `POST /api/import/assets/{id}/start-import` | Y | Y | N | Web MOD-only flow |
+| Import | `GET /api/import/sessions/{sessionId}` | Y | Y | N | Web MOD-only flow |
 
 ## Priority gaps de dong bo tiep
 
 1. Mobile: `user/settings`, `recommendations`, `rate`, `suggest`.
 2. Web/Mobile chapter-read strategy can unify (`chapters/{id}` vs `by-number`).
 3. Chuan hoa error contract implementation theo `CONTRACT.md`.
+4. Import EPUB is intentionally out of mobile scope.
diff --git a/FEATURES.md b/FEATURES.md
index 83b1cb1..3b0478a 100644
--- a/FEATURES.md
+++ b/FEATURES.md
@@ -28,3 +28,7 @@ Trang thai tinh nang mobile `reader-app` theo parity voi web.
 
 - Contract: `reader-app/CONTRACT.md`
 - Mapping: `reader-app/CROSS_REPO_ENDPOINT_MATRIX.md`
+
+## Note
+
+- EPUB import flow is currently MOD-only on web (`reader /mod/import`), not in mobile scope.
diff --git a/FLOWS.md b/FLOWS.md
index f6690c3..6e013fc 100644
--- a/FLOWS.md
+++ b/FLOWS.md
@@ -46,3 +46,7 @@ Muc tieu: mobile follow cung business behavior voi web.
 - Recommendation flow (`/api/user/recommendations`)
 - Rating flow (`/api/truyen/{id}/rate`)
 - Search suggest flow (`/api/truyen/suggest`)
+
+## Out of Scope (Current)
+
+- EPUB import flow (`/api/import/*`) is MOD-only on web and not planned for mobile client.