track/backend/app/schemas/product.py

"""产品 Pydantic Schemas"""
from __future__ import annotations
import uuid
from datetime import datetime
from pydantic import BaseModel, Field


class ProductCreate(BaseModel):
    """创建产品 — serial_number 由后端自动生成 16 位 HEX"""
    # MOM 物料挂载（必填）
    material_id: str = Field(..., max_length=64, description="MOM物料ID(必选)")
    material_name: str = Field("", max_length=255, description="物料名称")
    spec_model: str = Field("", max_length=255, description="规格型号")
    category: str = Field("", max_length=100, description="物料类别")
    material_type: str = Field("", max_length=100, description="物料类型")
    # 可选
    external_serial: str | None = Field(None, max_length=64, description="产品序列号(用户自定义,选填)")
    order_id: uuid.UUID | None = Field(None, description="所属订单ID(选填)")
    order_no: str | None = Field(None, max_length=64, description="订单号(自由键入,选填)")
    parent_product_id: uuid.UUID | None = Field(None, description="父产品ID")

    model_config = {"from_attributes": True}


class ProductUpdate(BaseModel):
    """更新产品"""
    serial_number: str | None = Field(None, min_length=16, max_length=16)
    external_serial: str | None = Field(None, max_length=64)
    material_id: str | None = Field(None, max_length=64)
    material_name: str | None = Field(None, max_length=255)
    spec_model: str | None = Field(None, max_length=255)
    order_no: str | None = Field(None, max_length=64, description="订单号")
    status: str | None = Field(None, max_length=50, description="产品状态")
    parent_product_id: uuid.UUID | None = Field(None)

    model_config = {"from_attributes": True}


class ProductResponse(BaseModel):
    """产品响应"""
    id: uuid.UUID
    serial_number: str
    external_serial: str | None = None
    order_id: uuid.UUID | None = None
    order_no: str = ""
    material_id: str | None
    material_name: str | None = None
    spec_model: str | None = None
    category: str | None = None
    material_type: str | None = None
    parent_product_id: uuid.UUID | None
    current_location_id: str | None = None
    current_location_name: str | None = None
    macro_status: str | None = None  # 🔧 后端预计算的任务树状态（免前端逐条展开）
    overall_status: str | None = None
    # 【当前工序】—— 只反映"此刻在做什么"，绝不拿历史工序冒充。
    #   · 有活跃主干任务(WIP/PENDING) → 该任务工序名
    #   · 否则产品处于宏观终态(待仓库收货/已入库/在库/已出库) → 该终态（表达"货在哪"）
    #   · 否则（活已干完、只剩工序名残留）→ ""（前端显示「—」）
    # ⚠️ 必须与 overall_status 分开：ProductResponse.overall_status 会被"最新主干任务名"
    #    覆盖（见 product_service 的 overall_names），于是已 COMPLETED 的历史工序
    #    （扫码出库 / 测试 / 发货测试…）会被当成"当前工序"长期展示。
    current_step: str = ""
    status: str
    # 🔧 生命周期阶段：PRODUCTION(生产制造/发货测试) | AFTER_SALES(出库后返厂售后维修)
    lifecycle_phase: str = "PRODUCTION"
    created_at: datetime
    # 🔧 最新动态 — 该产品活跃任务的最新记录
    latest_record_time: datetime | None = None
    latest_record_content: str | None = None
    latest_record_has_images: bool = False
    latest_record_assignee_id: str | None = None    # 🔧 最新记录操作人（消除并发张冠李戴）
    latest_record_assignee_name: str | None = None
    # 🔧 当前人滞留时长 — 活跃任务(WIP/PENDING)最早接手时间到现在的时长(小时)
    active_duration_hours: float | None = None
    # 🔧 生产总天数（自创建至今）
    production_days: int = 0          # 自然天
    production_days_workdays: int = 0 # 工作日（排除周末/节假日）

    model_config = {"from_attributes": True}


class ProductScanResponse(BaseModel):
    """扫码查询响应 — 产品信息 + 完整任务树（递归嵌套）"""
    id: uuid.UUID
    serial_number: str
    external_serial: str | None = None
    order_id: uuid.UUID | None = None
    order_no: str = ""
    material_id: str | None
    material_name: str | None = None
    spec_model: str | None = None
    category: str | None = None
    material_type: str | None = None
    parent_product_id: uuid.UUID | None
    current_location_id: str | None = None
    overall_status: str | None = None
    status: str
    # 🔧 生命周期阶段：PRODUCTION(生产制造/发货测试) | AFTER_SALES(出库后返厂售后维修)
    lifecycle_phase: str = "PRODUCTION"
    created_at: datetime
    top_level_tasks: list[TaskSummaryResponse] = []
    task_tree: list[TaskResponse] = []
    assignee_names: dict[str, str] = {}  # 🔧 username→中文姓名映射

    model_config = {"from_attributes": True}


# 延迟导入，避免循环引用
from app.schemas.task import TaskSummaryResponse, TaskResponse  # noqa: E402
ProductScanResponse.model_rebuild()