xsl
cd0ddb131b
- 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 造数
60 lines
1.9 KiB
Python
60 lines
1.9 KiB
Python
"""报告域的请求/响应模型。
|
|
|
|
Wire 响应统一走 ok() 信封（架构文档 §9.2），这里的模型只描述 ``data`` 部分；
|
|
雪花 ID 一律以字符串返回，避免 JS 精度丢失（NFR-MAINT-01 契约先行）。
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class ReportCreateRequest(BaseModel):
|
|
questionnaire: dict[str, object] = Field(
|
|
default_factory=dict, description="问卷答案；字段结构由产品定稿后在路由层收紧"
|
|
)
|
|
photo_object_key: str = Field(
|
|
min_length=1, max_length=255, description="临时桶里已上传照片的对象键（report_photo 场景）"
|
|
)
|
|
request_key: str | None = Field(
|
|
default=None, max_length=128, description="幂等键；相同键返回同一任务且不重复扣配额"
|
|
)
|
|
|
|
|
|
class ReportRegenerateRequest(BaseModel):
|
|
request_key: str | None = Field(
|
|
default=None, max_length=128, description="幂等键；相同键返回同一任务且不重复扣配额"
|
|
)
|
|
|
|
|
|
class ReportExportRequest(BaseModel):
|
|
request_key: str | None = Field(
|
|
default=None, max_length=128, description="幂等键；相同键返回同一导出任务且不重复扣配额"
|
|
)
|
|
|
|
|
|
class ReportExportResponse(BaseModel):
|
|
task_id: str
|
|
status: str = Field(description="tk_task 状态；导出完成后任务中心可取到 asset_key")
|
|
|
|
|
|
class ReportSubmitResponse(BaseModel):
|
|
task_id: str
|
|
report_id: str
|
|
status: str = Field(description="tk_task 状态；报告本体状态与其同步推进")
|
|
version: int
|
|
|
|
|
|
class ReportItem(BaseModel):
|
|
report_id: str
|
|
tier: str
|
|
status: str
|
|
version: int
|
|
result: dict[str, object] = Field(
|
|
description="按阶段键组织的产物；failed 报告只透错误摘要（中间态留给流水线复用）"
|
|
)
|
|
created_at: datetime
|
|
completed_at: datetime | None
|