feat(flow): unify member-group-permission admin workflow and docs

docs/index.md

@@ -1,24 +1,38 @@
 # member docs index
 
-## 先看這三份
-1. `docs/FRONTEND_ARCHITECTURE.md`
-2. `docs/FRONTEND_API_CONTRACT.md`
-3. `docs/FRONTEND_IMPLEMENTATION_CHECKLIST.md`
+## 0. 先看這兩份（入口）
+1. `docs/ARCHITECTURE_AND_CONFIG.md`
+2. `docs/BACKEND_ARCHITECTURE.md`
 
-## 系統架構與後端
-- `docs/ARCHITECTURE_AND_CONFIG.md`
-- `docs/BACKEND_ARCHITECTURE.md`
+## 1. 架構核心（你現在的實際模型）
+- 業務層級：`公司 companies -> 品牌站台 sites -> 會員 users`
+- 功能層級：`系統 systems -> 模組 modules`
+- 授權層級：`scope(company/site) + system + module(可空) + action`
+- 權限來源：`直接授權 + 群組授權`
+
+## 2. 前端交辦（直接丟給另一隻 AI）
+1. `docs/FRONTEND_API_CONTRACT.md`
+2. `docs/FRONTEND_HANDOFF_SCHEMA_V2.md`
+3. `docs/FRONTEND_ARCHITECTURE.md`
+
+## 3. 後端與環境
 - `docs/BACKEND_BOOTSTRAP.md`
-
-## 任務管理
-- `docs/TASKPLAN_FRONTEND.md`
 - `docs/TASKPLAN_BACKEND.md`
-- `docs/ORG_MEMBER_MANAGEMENT_PLAN.md`（公司組織/會員管理規劃）
-- `docs/FRONTEND_HANDOFF_SCHEMA_V2.md`（前端交辦清單，直接給另一隻 AI）
+- `backend/.env.development`（本機開發）
 
-## SQL 與配置
-- `backend/scripts/init_schema.sql`
-- `docs/DB_SCHEMA_SNAPSHOT.md`
+## 4. DB（單一來源）
+- `backend/scripts/init_schema.sql`（完整 schema）
+- `docs/DB_SCHEMA_SNAPSHOT.md`（目前資料庫結構快照）
 
-## 給前端 AI 的一句話交接
-請先完成 `/me`、`/me/permissions/snapshot`、`/admin/permissions/grant|revoke` 三組 API 對接，並依 `FRONTEND_IMPLEMENTATION_CHECKLIST.md` 逐項完成。
+## 5. 管理流程（建議操作順序）
+1. 建立 `systems`、`modules`
+2. 建立 `companies`、`sites`
+3. 建立/同步 `members`（可同步 Authentik）
+4. 建立 `permission-groups`
+5. 在會員頁指定會員所屬群組
+6. 在權限頁做直接授權，或在群組頁做群組授權
+
+## 6. 前端頁面責任切分
+- 會員頁：會員基本資料 + 群組指派
+- 群組頁：群組 CRUD + 群組權限列表 + 群組授權/撤銷
+- 權限管理頁：直接授權/撤銷 + 直接授權列表（可逐筆撤銷）