Files
beige/backend
yangqianqian df1856d793 上线版: 产品表单统一+form嵌套修复+用户管理+部署+三套叙事
- 产品编辑入口统一走 ProductFormFull(卖点/风格/人群/品牌词全字段);
  修复开任务页 <form> 套 <form> 致"编辑产品"报错、改不了、跳回首个产品
- dashboard 入口卡片对齐实际路由: 系统管理(/config) 与 工作配置(/settings) 分开;
  settings ?tab=products 直达改用挂载后读 URL, 消除 hydration mismatch
- 新增用户管理(users API/admin service/改密页) + alembic 022/023/024
- 上线部署: Dockerfile / docker-compose.prod+https / nginx https / .env.example
- A8 三套正交叙事(痛点/场景/成分背书) + beige 调色去AI化 + 飞轮 text_import 高权重信号

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-30 18:08:13 +08:00
..

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_idworker内解密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