31 lines
1.2 KiB
Markdown
31 lines
1.2 KiB
Markdown
# member 系統文件入口（Architecture & Config）
|
||
|
||
## 入口說明
|
||
這份文件是入口索引。若你只要快速開始，先看：
|
||
1. `docs/BACKEND_BOOTSTRAP.md`
|
||
2. `docs/BACKEND_ARCHITECTURE.md`
|
||
3. `docs/FRONTEND_ARCHITECTURE.md`
|
||
|
||
## 文件地圖
|
||
- `docs/index.md`
|
||
- 前端開工入口（給前端 AI 的第一份）
|
||
- `docs/BACKEND_BOOTSTRAP.md`
|
||
- 後端啟動步驟（環境、安裝、建表、啟動）
|
||
- `docs/BACKEND_ARCHITECTURE.md`
|
||
- memberapi 後端模組、資料流、API、安全策略
|
||
- `docs/FRONTEND_ARCHITECTURE.md`
|
||
- member 前端架構（可直接開工版）
|
||
- `docs/FRONTEND_API_CONTRACT.md`
|
||
- 前端 API request/response 契約
|
||
- `docs/FRONTEND_IMPLEMENTATION_CHECKLIST.md`
|
||
- 前端實作與交付核對清單
|
||
- `docs/API_CLIENTS_SQL.sql`
|
||
- `api_clients` 白名單表與初始資料 SQL
|
||
|
||
## 目前狀態（2026-03-29）
|
||
- 後端骨架：已建立（FastAPI + SQLAlchemy）
|
||
- 核心 API：已建立（health/internal/admin）
|
||
- API key 驗證：已建立（`X-Client-Key` + `X-API-Key`）
|
||
- Authentik JWT 驗證：已建立（`/me` 路由 + JWKS 驗簽）
|
||
- Authentik Admin API（建立/更新使用者）：已建立（`/internal/authentik/users/ensure`）
|