B6 错误态: - 后端已加 TaskStatus.FAILED + 异常区分重试中/耗尽(014迁移ALTER status ENUM) - 前端 TaskStatus 类型加 failed - RecentTasksBar/history STATUS_LABEL 补 failed 标签 - history 页 HISTORY_STATUSES 纳入 failed(否则失败任务前端找不到) - FatalErrorBanner + useSse error 不再静默丢弃 B7: 核实 SSE(ticket换JWT) + 事件消费链无缺口,标绿 tsc EXIT=0
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-004 migration 脚本
tests/ # TDD 测试用例
依赖(需装)
见 requirements.txt(待 BE agent 填)
启动
见 docker-compose.yml(待 BE agent 填)
铁律提醒
- API Key 绝不进 Celery 参数,只传 task_id
- FERNET_KEY 走环境变量
- 所有查询强制带 workspace_id