---
description: 後端引擎與 API 開發規範 (Backend Core & API Development)
---
# lewooogo-backend-core

## 管轄範圍
`apps/api` (FastAPI, Python 3.11, asyncpg)

## 核心約束 (AWOOOI 憲法)
1. **四大鐵律**: Async-First 全域非同步、CORS 嚴格白名單、Pydantic 強型別、`structlog` 結構化日誌（禁止使用 print）。
2. **可觀測性強制注入**: 所有 API 必須包含 OpenTelemetry traces，並將日誌打向唯一端點 `192.168.0.188:4317` (SigNoz)。

## 自動化驗收
修改後端程式碼完成後，請確保 Docker 容器運行中，並執行以下健康度掃描，若未出現 200 則必須繼續修復：

// turbo-all
```bash
curl -s http://localhost:8000/api/v1/health
```
