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