beige/backend

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