- 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 造数
packages/report/ — 美学报告(占位)
职责(架构 §4.1):触发判定、生成编排、版本管理、分享。 不负责:具体的视觉分析与文案生成(调 AI 能力层)。
待实现
- 表:
rp_reportrp_inputrp_share - 架构 §7.1 的 24 步生成链路(这是全系统最复杂的一条)
这条链路上不能妥协的四件事
- 原图生命周期:直传 COS 临时桶 → Worker 拉取 → 第 14 步显式删除 →
桶级 2 小时生命周期兜底(TD-20 / CR-02)。
rp_input只存派生特征与图片元信息。 - 失败即退款:任何步骤失败 →
tk_task转 failed →billing.refund()。 - 分步可恢复:视觉分析结果必须落中间态,LLM 或渲染失败时不重跑视觉分析 (也就不需要用户重新上传)。
- 生成后校验不可跳过:禁忌违反、色值在板内、维度引用存在、无医疗/贬损表述。 最多重试 2 次,仍失败降级为规则直出模板文案,绝不放行违规内容。