# 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