2.0 KiB
2.0 KiB
member-platform 文件入口（新架構）
閱讀順序
- docs/ARCHITECTURE.md
- docs/DB_SCHEMA.md
- docs/BACKEND_TASKPLAN.md
- docs/FRONTEND_TASKPLAN.md
- docs/FRONTEND_HANDOFF.md
- docs/INTERNAL_API_HANDOFF.md
- docs/LOCAL_DEV_RUNBOOK.md
- docs/VPS_DEPLOY_RUNBOOK.md
交辦順序（建議）
- 先看 ARCHITECTURE.md 鎖定資料模型與權限模型。
- 再看 DB_SCHEMA.md 對齊 table/欄位/關聯。
- 後端依 BACKEND_TASKPLAN.md 執行 schema/API/Keycloak 同步調整。
- 前端依 FRONTEND_TASKPLAN.md + FRONTEND_HANDOFF.md 開工。
- 其他系統串接時看 INTERNAL_API_HANDOFF.md。
目前狀態
- 架構定版：
Company -> Site、System -> Role。 - 權限定版：
Role只能指派給Site（透過site_roles）。 - 成員授權定版：
User不直接綁Role，僅透過user_sites取得 Site 角色。 - IdP 定版：Keycloak 為唯一 IdP。
- 系統定版：
System/Role由 Keycloak 管理，member 後台僅同步與顯示。 - API 白名單：保留
api_clients。 - 後端：新 schema 與 admin/internal API 已切到 role-site 模型。
- 前端：管理頁已切到新模型（公司/站台/系統/角色/會員/API Clients）。
單一真實來源
Repo 結構（已拆分）
- 整合層（本 repo）：
member-platform（docs / 部署 / 整合） - 後端子模組：backend（submodule:
../member-backend） - 前端子模組：frontend（submodule:
../member-frontend）
文件邊界
- 本輪只保留可開發、可交辦、可驗收文件。
- 最終規格白皮書延後到專案完成後再產出。