# 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`

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