Files
meida_backend/apps
xsl 7bcbb8d40b
CI / lint / typecheck / import-linter / tests / secrets (push) Canceled after 0s
feat(agent,report): 会话持久化与画像注入、报告反馈与预约留资——PM/开发双Agent迭代1-3
- agent: ag_conversation/ag_message 表(迁移0007),上下文组装注入最近报告画像摘要
  (report.profile.latest_profile_summary 经 apps 层闭包注入,同层不互调),历史带最近
  AGENT_HISTORY_TURNS=10 轮;POST/GET /agent/conversations 与消息历史接口
- agent 修复:ChatRequest.conversation_id 改 str(雪花ID超2^53,JS Number丢精度);
  _build_context 挪进 reserve commit 后同一 try,异常走 refund 兜底
- report: rp_feedback(维度反馈 upsert,认同率/修正率 SQL 可算,T-P3-21 最小版——
  L1 记忆未建,不回写结论)+ rp_reservation(预约留资幂等,T-P3-22,预约率口径
  行数/full_report.card_view 去重曝光,门槛≥8%),迁移0008
- 测试:全量 606 passed;ruff/mypy/lint-imports 全绿;E2E 真实 deepseek-v4-flash 验证
  画像注入与历史携带
2026-09-11 21:50:58 +08:00
..

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。 混队列会让「换装排队把报告拖慢」。