xsl
d5f366fa4c
第二批（T6~T11）协调提交： - 迁移 0005：kb 七表（entity/relation/rule/chunk vector1024+tsv 生成列/ asset/color/gap），HNSW+GIN 索引，FK 级联 - ORM：七个 Kb* 模型（pgvector Vector/TSVECTOR/Computed） - 配置：检索与 embedding、华为 JWKS、短信全参数组 - 错误码：40110/40111/42910/42911/61000 - 骨架路由：kb.py + auth_sms.py（已注册）；依赖：tencentcloud-sdk-python-sms + spike extra（onnxruntime/opencv）；gitignore：models/ 与 spike 输出
apps/ — 可部署的进程
| 目录 | 进程 |
|---|---|
api/ |
FastAPI 应用：路由、依赖注入、中间件 |
worker/ |
Celery 任务定义与四队列配置（gpu / cpu / io / beat） |
admin/ |
极简运营后台（占位，FR-ADM-01~05） |
API 层的职责边界（架构 §3.1 L3）
只做编排：认证鉴权、参数校验、幂等、配额校验与预扣、统一响应、OpenAPI。
不能放什么
- 业务规则。路由函数里出现
if判断业务条件，几乎总是应该下沉到packages/<域>/service.py或packages/domain/。 - 直接写 SQL 或用 ORM 查表。走域的
service。 - 直接调用外部 API。LLM 走
packages/llm；未来的审核、视觉、换装同理。 - 裸
dict返回。所有响应必须经过packages.shared.response.ok()/fail()。
契约先行（NFR-MAINT-01）
先在 apps/api/schemas.py 定义 Pydantic schema，再写实现。客户端类型由
OpenAPI 生成，schema 一变客户端立刻可见。
Worker 的规矩
- 每个长耗时任务都必须落
tk_task，走packages/task的状态机。 不要自己维护状态字段。 - 失败必须退还配额（
billing.refund()，FR-BILL-05）。apps/worker/tasks.py里的ping_task是形状示例。 - 队列按资源画像分：GPU 推理进
gpu，视觉/渲染进cpu，外部调用进io。 混队列会让「换装排队把报告拖慢」。