kid0317/xiaopaw-team/tech-design

# {产品名} 技术方案
 
## 1. 技术栈选型
-后端：FastAPI + SQLAlchemy 2.0 + SQLite
-前端：原生 HTML + JS + CSS（单文件，无打包）
-测试：pytest + httpx.Client(app)
 
## 2. 分层架构
-`main.py` — FastAPI app + router 挂载
-`routers/{module}.py` — 薄路由层
-`services/{module}.py` — 业务逻辑
-`models/{module}.py` — SQLAlchemy ORM
-`schemas/{module}.py` — Pydantic 请求/响应模型
-`database.py` — engine + SessionLocal
 
## 3. 数据库 Schema

 
## 4. 接口实现要点（对每个接口）
### POST /api/{resource}
- 输入校验：...（schema + 业务校验 + 错误码）
- 业务逻辑：...（步骤 + 事务边界）
- 错误场景：400 xxx / 404 xxx / 500 ...
 
## 5. 测试策略
- 单测覆盖目标 ≥ 80%
- 用 httpx.Client(app) 做 API 测试
- 工厂模式造测试数据，teardown 每次清表
 
## 6. 依赖清单（requirements.txt）
fastapi==0.115.*
sqlalchemy==2.0.*
pytest
httpx

{
  "status": "success",
  "artifacts": [{"path": "tech/tech_design.md", "kind": "doc"}],
  "self_score": 0.85,
  "breakdown": {...},
  "metrics": {"interfaces": 6, "error_codes": 4}
}