de6466737b
- HANDOVER.md: 守印接手第一入口,全景+上手路径+文档地图 - backend/BACKEND_MAP.md: 后端接手地图(路由/模型/AI引擎/评分维度) - 路线图.md: 现状vs目标差距(三视角×双目标矩阵+7/15倒排冲刺) - .env.example x3: 补全 MODEL_VISION/CLAUDE_API_URL 及本地SSE示例 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Clover Backend
FastAPI + Celery + MySQL + MongoDB + Redis
目录结构
backend/
app/
api/v1/ # 路由层（auth/products/tasks/review/delivery）
services/ # 业务逻辑层（按模块拆分）
models/ # SQLAlchemy ORM 模型（14张表）
middleware/ # workspace_guard 等中间件
workers/ # Celery 任务（只传task_id，worker内解密key）
constants/ # 策略命名中心文件，消除打架
utils/ # Fernet加密、SSE工具等
alembic/
versions/ # 001-022 migration 脚本
tests/ # TDD 测试用例
依赖
见 requirements.txt，依赖已锁版本。
启动
本地开发可用 backend/docker-compose.yml。
客户交付请用项目根目录 docker-compose.prod.yml，它不挂载源码、不暴露 MySQL/Mongo/Redis 到宿主机。
铁律提醒
- API Key 绝不进 Celery 参数，只传 task_id
- FERNET_KEY 走环境变量
- 所有查询强制带 workspace_id