member-platform/docs/ARCHITECTURE_AND_CONFIG.md

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/TASKPLAN_FRONTEND.md
  • 前端任務進度與驗收條件
• docs/TASKPLAN_BACKEND.md
  • 後端任務進度與驗收條件
• docs/API_CLIENTS_SQL.sql
  • api_clients 白名單表與初始資料 SQL
• docs/DB_SCHEMA_SNAPSHOT.md
  • 目前資料庫 schema 快照（欄位/索引/約束）

目前狀態（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）