member-platform/docs/index.md

member.ose.tw 文件入口（新架構）

閱讀順序

1. docs/ARCHITECTURE.md
2. docs/DB_SCHEMA.md
3. docs/BACKEND_TASKPLAN.md
4. docs/FRONTEND_TASKPLAN.md
5. docs/FRONTEND_HANDOFF.md
6. docs/INTERNAL_API_HANDOFF.md
7. docs/LOCAL_DEV_RUNBOOK.md

交辦順序（建議）

1. 先看 ARCHITECTURE.md 鎖定資料模型與權限模型。
2. 再看 DB_SCHEMA.md 對齊 table/欄位/關聯。
3. 後端依 BACKEND_TASKPLAN.md 執行 schema/API/Keycloak 同步調整。
4. 前端依 FRONTEND_TASKPLAN.md + FRONTEND_HANDOFF.md 開工。
5. 其他系統串接時看 INTERNAL_API_HANDOFF.md。

目前狀態

• 架構定版：Company -> Site、System -> Role。
• 權限定版：Role 只能指派給 Site（透過 site_roles）。
• 成員授權定版：User 不直接綁 Role，僅透過 user_sites 取得 Site 角色。
• IdP 定版：Keycloak 為唯一 IdP。
• API 白名單：保留 api_clients。

單一真實來源

• DB SQL：backend/scripts/init_schema.sql

文件邊界

• 本輪只保留可開發、可交辦、可驗收文件。
• 最終規格白皮書延後到專案完成後再產出。