"""报告域的请求/响应模型。

Wire 响应统一走 ok() 信封（架构文档 §9.2），这里的模型只描述 ``data`` 部分；
雪花 ID 一律以字符串返回，避免 JS 精度丢失（NFR-MAINT-01 契约先行）。
"""

from __future__ import annotations

from datetime import datetime
from typing import Literal

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 场景）；本地降级路线下为 "
            "POST /uploads/direct 返回的相对路径，建报告时做存在性校验"
        ),
    )
    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


# ---------------------------------------------------------------------------
# T-P3-21：维度级结论反馈
# ---------------------------------------------------------------------------
FeedbackVerdict = Literal["accurate", "inaccurate"]


class FeedbackCreateRequest(BaseModel):
    dimension_key: str = Field(
        min_length=1, max_length=64, description="报告 result.diagnosis.dimensions 的 key"
    )
    verdict: FeedbackVerdict = Field(description="准（accurate）/ 不准（inaccurate）")
    correction: str | None = Field(
        default=None, max_length=200, description="verdict=inaccurate 时的可选修正，≤200 字"
    )


class FeedbackUpsertResponse(BaseModel):
    dimension_key: str
    verdict: str
    updated: bool = Field(description="true=同维度已有反馈被覆盖更新；false=新建")


class FeedbackItem(BaseModel):
    dimension_key: str
    verdict: str
    correction: str | None
    created_at: datetime


# ---------------------------------------------------------------------------
# T-P3-22：预约留资（topic 预留通用性，首期 full_report）
# ---------------------------------------------------------------------------
class ReservationCreateRequest(BaseModel):
    topic: str = Field(min_length=1, max_length=32)


class ReservationResponse(BaseModel):
    topic: str
    created: bool = Field(description="false=已存在（幂等命中，HTTP 仍 200）")
    created_at: datetime


class ReservationListResponse(BaseModel):
    topics: list[str]