member-platform/docs/BACKEND_BOOTSTRAP.md

Backend Bootstrap（memberapi）

1. 環境準備

cd member.ose.tw/backend
python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env

2. 建立資料表

1. 先執行 member.ose.tw/docs/API_CLIENTS_SQL.sql
2. 再執行 member.ose.tw/backend/scripts/init_schema.sql
3. 若是舊資料庫，補跑 member.ose.tw/backend/scripts/migrate_add_authentik_user_id.sql

3. 啟動服務

cd member.ose.tw/backend
./scripts/start_dev.sh

說明：

• start_dev.sh 會用 --env-file .env.development 啟動，不需要每次手改 .env

4. Authentik JWT 最小設定

.env 至少填一種：

• AUTHENTIK_JWKS_URL=<jwks endpoint>
• AUTHENTIK_ISSUER=<issuer url>（系統會推導 <issuer>/jwks/）

可選：

• AUTHENTIK_AUDIENCE=<audience>
• AUTHENTIK_CLIENT_SECRET=<client_secret>（token 為 HS256 時需要）

5. 快速驗證

curl -sS http://127.0.0.1:8000/healthz