xsl/meida_backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
58 Commits 1 Branch 0 Tags
76a0502ea33a92cd2135ca2ac834c5c47a0e4d79
Commit Graph
11 Commits
Author SHA1 Message Date
xsl 7bcbb8d40b feat(agent,report): 会话持久化与画像注入、报告反馈与预约留资——PM/开发双Agent迭代1-3
CI / lint / typecheck / import-linter / tests / secrets (push) Canceled after 0s
Details 
- 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
xsl 00ef56b08b fix(report): 错误 hint 去除「任务中心」指向 + PDF 元数据 AI 生成标识
CI / lint / typecheck / import-linter / tests / secrets (push) Canceled after 0s
Details 
- errors.py：IDEMPOTENCY_CONFLICT / TASK_STATE_INVALID 的 hint 改为「首页报告」口径（App 无任务中心页，经 hint 透出会误导）
- report.html.j2：head 增加 author/description/generator meta（WeasyPrint 落入 PDF 属性，AI 生成内容标识 CR-05）
- test_report_export.py：+2 单测（模板 meta 渲染 + PDF 产物 Info 字典解压断言，不新增依赖）

多 agent 评审 R3/R4 产物；单测 576 passed
 2026-08-30 23:17:00 +08:00
xsl cd0ddb131b feat(report): 报告 PDF 导出管线（Phase A，WeasyPrint 服务端渲染） 
- POST /reports/{id}/export：request_key 幂等 + hd_export 日配额三段式（reserve/commit/refund）+ tier2 熔断场景闸（BudgetGuardDep），仅 succeeded 报告可导
- GET /reports/{id}/export/download：归属校验 + 路径收敛（rendered_asset_key 必须落在 report_export_dir 内），FileResponse 携带 UTF-8 文件名
- celery 任务 meida.report.export（cpu 队列）：渲染→落盘 var/exports→回写 rendered_asset_key；业务性拒绝（报告状态变化）结案退款不重试，基础设施异常重试一次后兜底结案退款
- packages/report/pdf：Jinja2 模板 + WeasyPrint 渲染器（url_fetcher 全拒外部资源防 SSRF；维度中文名按 DIMENSION_BY_KEY 回填；色板维度渲染色卡）
- 单测 10 例（资格/幂等/并发同键/下载校验/渲染）；scripts/seed_pdf_e2e.sql 供本地 E2E 造数
 2026-08-30 13:17:23 +08:00
xsl cb8a1e3c0f fix(report): FE 问卷键名双侧兼容 + worker 持久事件循环（live E2E 两处修复）
CI / lint / typecheck / import-linter / tests / secrets (push) Canceled after 0s
Details 
FE↔后端联调实测暴露并修复：
1. 问卷键名三处错位（FE height_cm/weight_kg/psych_style vs 文档
   height/weight/psyche_style）——vision._bmi 多键取值、diagnosis 维度
   装配与规则上下文双键或运算，两侧谁改键名都不再炸
2. celery worker asyncio.run 每投递起新 loop + 模块级引擎缓存 →
   asyncpg 连接跨 loop（同进程第 3 个报告任务必现 RuntimeError:
   attached to a different loop；集成测试单循环掩盖）。新增
   apps/worker/loop.py 持久 loop，report/ping 两任务接入

E2E 终态： psyche_style/height_weight 恢复、BMI 体型确定值、ok 26/32、
真实 LLM 文案通过校验 degraded=False。
 2026-08-15 01:05:10 +08:00
xsl 38dfaaf479 merge: T15 报告编排骨架与失败退款（T-P3-07/09） 2026-08-14 22:18:51 +08:00
xsl e8208d2972 feat(report): orchestration skeleton with staged pipeline and refund-on-failure 
POST /reports 骨架：资格校验→终身配额预扣→tk_task→cpu 队列；动态装配
流水线（dotted-path 注册、缺阶段即 CONFIG_ERROR）；中间态逐段落库、失败
退款、derived_features 跨重试/重生成复用（T-P3-07/09）。

实现：packages/report 的 pipeline.py（Stage 契约保持不变，新增 assemble_stages/
run_pipeline/StageFailureError，ReportContext 增可选 task_id 参数、向后兼容）、
repo.py、schemas.py、service.py（重放优先于资格校验、reserve+建行+建任务同事务、
提交后才投递、并发同键落败回滚）；apps/api/routers/reports.py 填桩（send_task 按
任务名投递，不 import apps.worker）；apps/worker/report_tasks.py（worker 侧自建
gateway 装配、状态归一 QUEUED→RUNNING、成功 commit 配额+成本聚合写 model_info、
基础设施异常重试一次、重试耗尽兜底失败退款）。测试：单测 6 个（装配缺失/空配置/
协议违约/顺序执行/失败保留产物），集成 6 场景（预扣 lifetime/PENDING、成功
committed+两阶段键、同 request_key 幂等不重复扣、二次首生成 40920、阶段失败
refund+derived_features 保留、regenerate 走 m: 月配额 version+1 复用视觉中间态）。

偏差说明：
1) apps/worker/celery_app.py 的 include 只含 apps.worker.tasks（禁改文件），真
worker 进程注册 meida.report.generate 需协调者合并时把 include 补上
apps.worker.report_tasks；API 侧已按任务名 send_task，两侧只靠名字衔接，测试
不受影响。2) ReportContext 增加可选 task_id 关键字参数（失败结案要推动
tk_task），Stage 协议/DEFAULT_STAGE_PATHS/stage_names 未动，T16/T17 兼容。
3) JSONB 深变更用 flag_modified 显式标脏（重新赋相等新 dict 会被 flush 的按值
比较跳过，集成测试抓到过该坑）。4) POST 后 tk_task 保持 PENDING（任务文档
§4 场景 1 口径），QUEUED→RUNNING 由 worker 入口归一。
 2026-08-14 22:18:14 +08:00
xsl fc3393887f merge: T16 确定性视觉与 32 维诊断装配（T-P3-01/06） 2026-08-14 22:15:37 +08:00
xsl e7076c9c01 feat(report): deterministic vision provider and 32-dimension diagnosis assembly 
dimensions.py 逐行编码需求文档 §4（32 项四要素、缺失显式 skipped）+
VisionProvider 接口位与确定性实现 + 规则引擎联动 rule_hits（T-P3-01/06）。

实现：
- dimensions.py：DimensionSpec 恰 32 项（number 1~32 连续，33/34 永不复用），
  basic_coverage 口径机器可读：full 10 / label 3 / partial 8 / none 11，
  初级覆盖 21/32（BASIC_FULL_KEYS + BASIC_COVERED_KEYS）。
- vision.py：VisionProvider Protocol（派生特征形状写进 docstring，真实
  RTMPose/BiRefNet 实现后续按此替换）+ DeterministicVisionProvider（问卷
  BMI/自评驱动体型与肤色，sha256(object_key+canonical问卷) 驱动其余枚举，
  同输入同输出）+ build_vision_provider（未知名 CONFIG_ERROR）。
- vision_stage.py：derived_features 已存在 → skipped/reused（T-P3-09）；
  否则分析 → 写中间态并 flush；photo_meta.quality_flags 透传进产物（T-P3-01）。
- diagnosis_stage.py：32 维恒全键，缺输入显式 skipped+原因（T-P3-06 红线）；
  每维四要素 value/confidence/source/evidence/rule_hits + status；构造
  RuleContext → RuleService 载入 published 规则 → evaluate，body_shape/color
  类命中回落 #5/#19/#21，全量命中聚合进 #28/#30 的 rule_hits 与 evidence；
  色板 #19/#20/#21 从 kb_color 按季型读取，库空 → skipped「色板未录入」。

测试：单测 29 项（32 项完整性/编号连续/确定性/工厂拒绝未知名；四要素齐全
性——故意缺问卷+缺视觉断言 32 键全在且全部 skipped 带原因；规则命中进
rule_hits 用内置最小规则集不连库）；集成 1 项（种 2 条 published 规则 →
VisionStage → DiagnosisStage：中间态落库与复用 skipped/reused、32 维全键、
rule_hits 出现、kb_color 空时色板 skipped、coverage basic_full=10/32）。
全绿：ruff check/format、mypy packages/report、lint-imports；单测 536 通过
（3 处既有 skip）、集成 46 通过。

偏差说明：
1. 任务文档写 RulesService，实际类名为 RuleService（packages/rules/service.py），按实际代码调用。
2. kb_color 联表键采用四季代码 spring/summer/autumn/winter（仓库无既定口径），已在 vision.py 注释声明。
3. 任务文档只给 basic_coverage 四枚举，需求表格中的「粗判/8色/3色」归入 partial、「Top1」归入 label。
 2026-08-14 22:14:54 +08:00
xsl e78ba3feef feat(report): LLM copy generation with mandatory post-validation and fallback 
report_copy/v1 prompt（系统段零变量）+ 结构化 ReportCopy + 素材组装
（skipped 不进 prompt/超长裁剪）+ 贬损词表/一致性/绝对化三重校验 +
重试一次后降级规则直出模板（T-P3-10/11）。

- copy.py：ReportCopy(schema 宽进严出取舍见注释)/compose_prompt_material
  （ok 过滤+6000 字符裁剪，低优先级先丢、硬结论不丢，记录 dropped_keys）/
  render_fallback_copy 零 LLM 降级模板
- validation.py：PEJORATIVE_TERMS 35 词（源自合规 §3，初版内嵌注释）+
  一致性三规则（枚举同款含别名/色值在板内/建议句需规则支撑·宽松口径）+
  绝对化用语兜底
- copy_stage.py / validation_stage.py：任何出口 passed=true 或抛错，
  语义层重试一次（与网关解析层重试独立），仍违规降级模板并 fail-close 自证
- 单测 25 例（词表含变形/三规则正反/降级零违规）+ 集成 4 例
  （FakeProvider 全栈：干净通过/脏一次修正通过/持续脏降级且最终文案
  零贬损词——黄金断言）；全量 529 单测 + 49 集成全绿

偏差说明：
1. prompts/report_copy/v1.txt 非新建——LLM 批次已放置初版（user 段变量
   为 {payload}），按本任务契约改写为 {dimensions_json} 并补内容红线
   （该文件任务文档明确归 T17，无与他人冲突）。
2. check_conclusion_consistency 按契约签名 (copy, dimensions) 之外增加
   可选 rule_hits 关键字参数：规则③的支撑判定需兼容命中内嵌在维度/
   顶层列表两种 T16 契约形态，缺省时不追责（宽松口径）。
3. 绝对化用语未按单字「最」拦截，取营销语境复合词（最好/最合适/第一/
   百分百等 17 词）：单字会误杀「最近/最终」等中性词，红线范围不变。
4. 集成文件未挂 MEIDA_RUN_INTEGRATION skipif：用例为 FakeProvider 内存
   装配、不依赖真实 PG/Redis，按任务要求仍放 tests/integration/ 并带
   integration marker。
 2026-08-14 22:09:09 +08:00
xsl d974526904 chore(prep): shared groundwork for batch-4 (report pipeline) 
第四批（T15 编排/T16 视觉诊断/T17 文案校验）协调提交：
- 迁移 0006：rp_report（result JSONB 按阶段键承载中间态）/rp_input
 （derived_features 视觉中间态）/rp_share（V1 只建结构）
- ORM 三模型；错误码 40420/40920（文案无价格字样）
- 配置：report_pipeline_stages（dotted path 动态装配）+ vision/tier
- packages/report/pipeline.py：Stage Protocol + ReportContext（三任务共同契约，
  动态 import 的动机与代价写在 docstring）
- 路由桩 reports.py 已注册
 2026-08-14 21:51:05 +08:00
xsl 7c67506474 feat(domains): identity, billing, task services and domain placeholders 
Billing implements reserve -> commit -> refund against bl_quota and bl_ledger
with row-level locking and idempotency keys; the refund commits on its own
transaction so a failed request cannot silently keep a user's quota. Task
implements the unified task centre over the state machine. Identity issues and
resolves users. Remaining domains are placeholders whose READMEs state what
belongs there and what must not.
 2026-08-14 00:26:39 +08:00