2.6 KiB
2.6 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）
開發工作目錄（防呆）
- 只在
member-platform內開發與提交。 - 後端只改
member-platform/backend。 - 前端只改
member-platform/frontend。 - 根目錄外的
member-backend/member-frontend若有另一份 clone，視為非主要工作副本，避免混用。
提交順序（固定）
- 先在
member-platform/backend或member-platform/frontend各自 commit / push。 - 再回
member-platform根目錄，提交子模組版本指標變更（submodule pointer）並 push。 - 部署端只需要更新
member-platform，再執行git submodule update --init --recursive。
文件邊界
- 本輪只保留可開發、可交辦、可驗收文件。
- 最終規格白皮書延後到專案完成後再產出。