ForgeFlow-ERP/backend/app/schemas/operations.py

from __future__ import annotations

from datetime import date, datetime
from decimal import Decimal

from pydantic import BaseModel, ConfigDict, Field


class ContactPayload(BaseModel):
    contact_name: str | None = None
    contact_phone: str | None = None


class SupplierRead(BaseModel):
    model_config = ConfigDict(from_attributes=True)

    id: int
    supplier_code: str
    supplier_name: str
    short_name: str | None = None
    contact_name: str | None = None
    contact_phone: str | None = None
    contacts: list[ContactPayload] = Field(default_factory=list, max_length=3)
    address: str | None = None
    lead_time_days: int
    default_tax_rate: float
    status: str
    remark: str | None = None


class SupplierCreate(BaseModel):
    supplier_name: str
    short_name: str | None = None
    contact_name: str | None = None
    contact_phone: str | None = None
    contacts: list[ContactPayload] = Field(default_factory=list, max_length=3)
    address: str | None = None
    lead_time_days: int = 0
    default_tax_rate: float = 0
    status: str = "ACTIVE"
    remark: str | None = None


class SupplierUpdate(SupplierCreate):
    pass


class WorkCenterRead(BaseModel):
    id: int
    center_code: str
    center_name: str
    dept_id: int
    dept_name: str | None = None
    center_type: str
    shift_pattern: str | None = None
    capacity_hours_per_day: float
    status: str


class WarehouseLocationRead(BaseModel):
    id: int
    warehouse_id: int
    warehouse_code: str
    warehouse_name: str
    location_code: str
    location_name: str
    zone_name: str | None = None
    is_default: bool
    is_locked: bool
    status: str


class PurchaseOrderItemCreate(BaseModel):
    material_item_id: int
    source_demand_id: int | None = None
    order_qty: float = 0
    order_weight_kg: float = 0
    unit_price: float = 0
    remark: str | None = None


class PurchaseOrderCreate(BaseModel):
    supplier_id: int
    order_date: date | None = None
    expected_date: date | None = None
    warning_lead_days: int = Field(default=0, ge=0)
    purchaser_employee_id: int | None = None
    target_warehouse_type: str = "RAW"
    sales_order_ids: list[int] = Field(default_factory=list)
    tax_rate: float = 0
    remark: str | None = None
    items: list[PurchaseOrderItemCreate]


class PurchaseOrderUpdate(PurchaseOrderCreate):
    pass


class PurchaseOrderRead(BaseModel):
    purchase_order_id: int
    po_no: str
    source_type: str = "STOCKING"
    source_order_nos: str | None = None
    sales_order_ids: list[int] = Field(default_factory=list)
    supplier_id: int
    supplier_code: str
    supplier_name: str
    order_date: date
    expected_date: date | None = None
    warning_lead_days: int = 0
    warning_start_date: date | None = None
    is_warning_active: bool = False
    purchaser_employee_id: int | None = None
    purchaser_name: str | None = None
    target_warehouse_type: str = "RAW"
    tax_rate: float
    total_amount: float
    status: str
    display_status: str | None = None
    remark: str | None = None
    line_count: int
    total_order_qty: float = 0
    total_order_weight_kg: float
    total_received_qty: float = 0
    total_received_weight_kg: float
    has_return: bool = False
    total_return_weight_kg: float = 0
    archive_status: str = "未生成"
    archive_version: int | None = None
    archive_created_at: datetime | None = None
    archive_error_message: str | None = None


class PurchaseOrderItemRead(BaseModel):
    purchase_order_item_id: int
    purchase_order_id: int
    po_no: str
    line_no: int
    material_item_id: int
    material_code: str
    material_name: str
    specification: str | None = None
    material_grade: str | None = None
    performance_requirement: str | None = None
    purchase_calc_mode: str | None = None
    source_demand_id: int | None = None
    order_qty: float
    order_weight_kg: float
    received_qty: float
    received_weight_kg: float
    returned_weight_kg: float = 0
    net_received_weight_kg: float = 0
    has_return: bool = False
    unit_price: float
    line_amount: float
    status: str
    display_status: str | None = None
    remark: str | None = None


class PurchaseReceiptItemCreate(BaseModel):
    purchase_order_item_id: int
    material_item_id: int
    location_id: int | None = None
    lot_no: str | None = None
    received_qty: float = 0
    received_weight_kg: float = 0
    unit_cost: float = 0
    remark: str | None = None


class PurchaseReceiptCreate(BaseModel):
    purchase_order_id: int
    warehouse_id: int
    receipt_date: datetime | None = None
    receiver_employee_id: int | None = None
    supplier_delivery_no: str | None = None
    waybill_no: str | None = None
    order_photo_url: str | None = None
    freight_amount: float | None = None
    remark: str | None = None
    items: list[PurchaseReceiptItemCreate]


class PurchaseReceiptRead(BaseModel):
    receipt_id: int
    receipt_no: str
    purchase_order_id: int
    po_no: str
    supplier_id: int
    supplier_name: str
    warehouse_id: int
    warehouse_name: str
    target_warehouse_type: str = "RAW"
    receipt_date: datetime
    receiver_employee_id: int | None = None
    receiver_name: str | None = None
    supplier_delivery_no: str | None = None
    logistics_waybill_no: str | None = None
    logistics_freight_amount: float | None = None
    logistics_photo_url: str | None = None
    material_names: str | None = None
    status: str
    remark: str | None = None
    line_count: int
    total_received_qty: float = 0
    total_received_weight_kg: float
    archive_status: str = "未生成"
    archive_version: int | None = None
    archive_created_at: datetime | None = None
    archive_error_message: str | None = None


class PurchaseReceiptItemRead(BaseModel):
    receipt_item_id: int
    receipt_id: int
    receipt_no: str
    line_no: int
    purchase_order_item_id: int
    material_item_id: int
    material_code: str
    material_name: str
    warehouse_id: int
    warehouse_name: str
    location_id: int | None = None
    location_name: str | None = None
    lot_no: str
    received_qty: float
    received_weight_kg: float
    accepted_qty: float
    accepted_weight_kg: float
    unit_cost: float
    status: str
    quality_status: str | None = None
    remark: str | None = None


class StockLotPurchaseLinkRead(BaseModel):
    purchase_order_id: int
    po_no: str
    purchase_order_item_id: int
    material_item_id: int
    material_code: str
    material_name: str
    lot_id: int
    lot_no: str
    accepted_weight_kg: float
    returned_weight_kg: float
    returnable_weight_kg: float
    unit_cost: float


class RawMaterialReturnOutboundItemCreate(BaseModel):
    lot_id: int
    purchase_order_item_id: int
    return_weight_kg: float
    reason: str | None = None
    remark: str | None = None


class RawMaterialReturnOutboundCreate(BaseModel):
    warehouse_id: int
    return_date: datetime | None = None
    waybill_no: str | None = None
    order_photo_url: str | None = None
    freight_amount: float | None = None
    reason: str | None = None
    remark: str | None = None
    items: list[RawMaterialReturnOutboundItemCreate]


class PurchaseReturnItemRead(BaseModel):
    purchase_return_item_id: int
    purchase_return_id: int
    line_no: int
    purchase_order_item_id: int
    material_item_id: int
    material_code: str
    material_name: str
    lot_id: int
    lot_no: str
    return_weight_kg: float
    unit_cost: float
    amount: float
    reason: str | None = None
    status: str
    remark: str | None = None


class PurchaseReturnRead(BaseModel):
    purchase_return_id: int
    return_no: str
    purchase_order_id: int
    po_no: str
    warehouse_id: int
    warehouse_name: str
    return_date: datetime
    logistics_waybill_no: str | None = None
    logistics_freight_amount: float | None = None
    logistics_photo_url: str | None = None
    reason: str | None = None
    status: str
    remark: str | None = None
    total_return_weight_kg: float
    total_amount: float
    items: list[PurchaseReturnItemRead] = Field(default_factory=list)
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class StockLotRead(BaseModel):
    lot_id: int
    lot_no: str
    parent_lot_id: int | None = None
    lot_role: str | None = None
    material_sub_batch_no: str | None = None
    item_id: int
    item_code: str
    item_name: str
    item_type: str
    specification: str | None = None
    item_remark: str | None = None
    stock_unit_name: str | None = None
    purchase_unit_name: str | None = None
    sales_unit_name: str | None = None
    warehouse_id: int
    warehouse_name: str
    warehouse_type: str | None = None
    location_id: int | None = None
    location_name: str | None = None
    source_doc_type: str
    source_doc_id: int
    source_line_id: int | None = None
    source_receipt_no: str | None = None
    source_purchase_order_no: str | None = None
    source_material_lot_id: int | None = None
    source_material_lot_no: str | None = None
    source_material_sub_batch_no: str | None = None
    source_material_summary: str | None = None
    logistics_waybill_no: str | None = None
    logistics_freight_amount: float | None = None
    logistics_photo_url: str | None = None
    inbound_qty: float
    inbound_weight_kg: float
    remaining_qty: float
    remaining_weight_kg: float
    locked_qty: float
    locked_weight_kg: float
    unit_cost: float
    quality_status: str
    quality_user_name: str | None = None
    status: str
    created_at: datetime
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class StockLotOptionRead(BaseModel):
    lot_id: int
    lot_no: str
    item_id: int
    item_code: str
    item_name: str
    warehouse_id: int
    warehouse_name: str
    remaining_weight_kg: float
    unit_cost: float
    quality_status: str
    status: str
    is_available_for_issue: bool
    disabled_reason: str | None = None


class StockBalanceRead(BaseModel):
    stock_balance_id: int
    item_id: int
    item_code: str
    item_name: str
    item_type: str
    specification: str | None = None
    item_remark: str | None = None
    stock_unit_name: str | None = None
    purchase_unit_name: str | None = None
    sales_unit_name: str | None = None
    warehouse_id: int
    warehouse_name: str
    warehouse_type: str | None = None
    location_id: int | None = None
    location_name: str | None = None
    qty_on_hand: float
    weight_on_hand_kg: float
    qty_available: float
    weight_available_kg: float
    qty_allocated: float
    weight_allocated_kg: float
    avg_unit_cost: float
    updated_at: datetime


class InventoryTxnRead(BaseModel):
    inventory_txn_id: int
    txn_no: str
    txn_type: str
    item_id: int
    item_code: str
    item_name: str
    warehouse_id: int
    warehouse_name: str
    warehouse_type: str | None = None
    location_id: int | None = None
    location_name: str | None = None
    lot_id: int | None = None
    lot_no: str | None = None
    qty_change: float
    weight_change_kg: float
    unit_cost: float
    amount: float
    source_doc_type: str
    source_doc_id: int
    source_line_id: int | None = None
    source_material_lot_id: int | None = None
    source_material_lot_no: str | None = None
    source_material_sub_batch_no: str | None = None
    source_material_summary: str | None = None
    biz_time: datetime
    logistics_waybill_no: str | None = None
    logistics_freight_amount: float | None = None
    logistics_photo_url: str | None = None
    remark: str | None = None
    archive_status: str = "未生成"
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class InventoryTxnLedgerRowRead(InventoryTxnRead):
    direction: str
    source_line_id: int | None = None
    operator_user_id: int | None = None
    operator_name: str | None = None


class InventoryTxnLedgerSummaryRead(BaseModel):
    in_count: int = 0
    out_count: int = 0
    adjust_count: int = 0
    in_qty: float = 0
    out_qty: float = 0
    in_weight_kg: float = 0
    out_weight_kg: float = 0
    latest_biz_time: datetime | None = None


class InventoryTxnLedgerResponse(BaseModel):
    items: list[InventoryTxnLedgerRowRead]
    total: int
    summary: InventoryTxnLedgerSummaryRead


class SelectedStockLotIssueCreate(BaseModel):
    source_lot_id: int
    issued_weight_kg: float
    material_item_id: int | None = None


class WorkOrderCreate(BaseModel):
    source_sales_order_item_id: int | None = None
    product_item_id: int
    planned_qty: float = 0
    issue_weight_kg: float = 0
    selected_stock_lots: list[SelectedStockLotIssueCreate] = Field(default_factory=list)
    planned_start_time: datetime | None = None
    planned_end_time: datetime | None = None
    priority_level: int = 3
    auto_issue_materials: bool = False
    remark: str | None = None


class WorkOrderRead(BaseModel):
    work_order_id: int
    work_order_no: str
    work_order_type: str
    source_sales_order_item_id: int | None = None
    source_order_no: str | None = None
    product_item_id: int
    product_code: str
    product_name: str
    product_version_no: str | None = None
    route_id: int
    route_name: str
    bom_id: int
    planned_qty: float
    released_qty: float
    finished_qty: float
    scrap_qty: float
    planned_start_time: datetime | None = None
    planned_end_time: datetime | None = None
    actual_start_time: datetime | None = None
    actual_end_time: datetime | None = None
    priority_level: int
    status: str
    remark: str | None = None
    operation_count: int
    abnormal_operation_count: int
    reported_good_qty: float = 0
    received_qty: float = 0
    max_receivable_qty: float = 0
    all_operations_done: bool = False
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class WorkOrderMaterialRead(BaseModel):
    work_order_material_id: int
    work_order_id: int
    work_order_no: str
    bom_item_id: int
    material_item_id: int
    material_code: str
    material_name: str
    required_qty: float
    required_weight_kg: float
    issued_qty: float
    issued_weight_kg: float
    returned_qty: float
    returned_weight_kg: float
    material_sub_batch_summary: str | None = None
    issue_amount: float = 0
    status: str
    remark: str | None = None


class WorkOrderMaterialIssueRead(BaseModel):
    material_issue_id: int
    work_order_material_id: int
    work_order_id: int
    work_order_no: str
    material_item_id: int
    material_code: str
    material_name: str
    source_lot_id: int
    source_lot_no: str
    material_sub_batch_no: str
    issued_qty: float
    issued_weight_kg: float
    unit_cost: float
    amount: float
    issue_time: datetime
    remark: str | None = None


class ProductionBatchLedgerTxnRead(BaseModel):
    production_ledger_txn_id: int
    production_ledger_id: int
    txn_type: str
    qty_delta: float = 0
    weight_delta_kg: float = 0
    outside_weight_after_kg: float = 0
    source_doc_type: str | None = None
    source_doc_id: int | None = None
    source_line_id: int | None = None
    biz_time: datetime
    operator_user_id: int | None = None
    remark: str | None = None
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class ProductionBatchLedgerRead(BaseModel):
    production_ledger_id: int
    material_lot_id: int
    material_lot_no: str
    material_item_id: int
    material_code: str | None = None
    material_name: str | None = None
    product_item_id: int
    product_code: str | None = None
    product_name: str | None = None
    status: str
    miniapp_selectable: bool = True
    total_issued_weight_kg: float = 0
    outside_weight_kg: float = 0
    finished_inbound_qty: float = 0
    surplus_inbound_weight_kg: float = 0
    scrap_inbound_weight_kg: float = 0
    writeoff_weight_kg: float = 0
    first_issue_time: datetime | None = None
    last_issue_time: datetime | None = None
    locked_at: datetime | None = None
    reopened_at: datetime | None = None
    lock_count: int = 0
    remark: str | None = None
    material_out_archive_status: str | None = None
    material_out_archive_business_id: int | None = None
    material_out_archive_document_type: str | None = None
    material_out_archive_error_message: str | None = None
    txns: list[ProductionBatchLedgerTxnRead] = Field(default_factory=list)


class ProductionBatchLedgerInboundPreviewRead(BaseModel):
    production_ledger_id: int
    material_lot_no: str
    product_item_id: int
    product_code: str | None = None
    product_name: str | None = None
    material_item_id: int
    material_code: str | None = None
    material_name: str | None = None
    gross_weight_per_piece_kg: float = 0
    net_weight_per_piece_kg: float = 0
    total_issued_weight_kg: float = 0
    outside_weight_kg: float = 0
    finished_inbound_qty: float = 0
    surplus_inbound_weight_kg: float = 0
    scrap_inbound_weight_kg: float = 0
    writeoff_weight_kg: float = 0
    reference_finished_qty: float = 0
    used_material_weight_kg: float = 0
    theoretical_surplus_weight_kg: float = 0
    theoretical_scrap_weight_kg: float = 0


class ProductionBatchLedgerInboundCreate(BaseModel):
    production_ledger_id: int
    finished_qty: float = 0
    surplus_weight_kg: float = 0
    scrap_weight_kg: float = 0
    lock_material_batch: bool = False
    lock_confirmed: bool = False
    deviation_remark: str | None = None
    remark: str | None = None


class ProductionBatchLedgerInboundRead(BaseModel):
    production_ledger_id: int
    material_lot_no: str
    finished_qty: float = 0
    surplus_weight_kg: float = 0
    scrap_weight_kg: float = 0
    finished_lot_id: int | None = None
    surplus_lot_id: int | None = None
    scrap_lot_id: int | None = None
    finished_txn_id: int | None = None
    surplus_txn_id: int | None = None
    scrap_txn_id: int | None = None
    locked: bool = False
    status: str
    remark: str | None = None
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class WorkOrderOperationRead(BaseModel):
    work_order_operation_id: int
    work_order_id: int
    work_order_no: str
    route_operation_id: int
    seq_no: int
    operation_name: str
    work_center_id: int
    work_center_name: str
    planned_qty: float
    report_qty: float
    good_qty: float
    scrap_qty: float
    rework_qty: float
    std_labor_cost: float
    std_machine_cost: float
    std_outsource_cost: float
    allowed_scrap_rate: float
    is_abnormal: bool
    status: str
    remark: str | None = None


class WorkOrderLedgerMaterialRead(BaseModel):
    material_item_id: int
    material_code: str
    material_name: str
    source_lot_id: int
    source_lot_no: str
    issued_weight_kg: float
    returned_weight_kg: float = 0
    unit_cost: float = 0
    amount: float = 0


class WorkOrderLedgerOperationRead(BaseModel):
    work_order_operation_id: int
    seq_no: int
    operation_name: str
    report_qty: float
    good_qty: float
    scrap_qty: float
    status: str


class WorkOrderLedgerLimitRead(BaseModel):
    gross_weight_per_piece_kg: float
    net_weight_per_piece_kg: float
    issued_weight_kg: float
    used_material_weight_kg: float
    returned_material_weight_kg: float
    final_operation_good_qty: float
    finished_received_qty: float
    total_operation_scrap_qty: float
    scrap_inbound_weight_kg: float
    max_finished_inbound_qty: float
    max_scrap_inbound_weight_kg: float
    max_surplus_inbound_weight_kg: float
    tolerance_finished_inbound_qty: float
    tolerance_scrap_inbound_weight_kg: float
    tolerance_surplus_inbound_weight_kg: float


class WorkOrderLedgerRead(BaseModel):
    work_order_id: int
    work_order_no: str
    product_item_id: int
    product_code: str
    product_name: str
    planned_qty: float
    status: str
    remark: str | None = None
    material_summary: str
    source_lot_summary: str
    issued_weight_kg: float
    used_material_weight_kg: float
    returned_material_weight_kg: float
    finished_received_qty: float
    max_finished_inbound_qty: float
    max_scrap_inbound_weight_kg: float
    max_surplus_inbound_weight_kg: float
    limits: WorkOrderLedgerLimitRead
    materials: list[WorkOrderLedgerMaterialRead]
    operations: list[WorkOrderLedgerOperationRead]


class ProductionWorkOrderInboundPreviewRead(BaseModel):
    work_order_id: int
    work_order_no: str
    product_item_id: int
    product_code: str
    product_name: str
    source_lot_id: int
    source_lot_no: str
    material_item_id: int
    material_code: str
    material_name: str
    gross_weight_per_piece_kg: float
    net_weight_per_piece_kg: float
    issued_weight_kg: float
    returned_weight_kg: float
    final_operation_good_qty: float
    finished_inbound_qty: float
    reported_scrap_qty: float
    scrap_inbound_weight_kg: float
    reference_finished_qty: float
    remaining_reference_finished_qty: float
    finished_qty_upper_limit: float
    finished_qty: float
    theoretical_surplus_weight_kg: float
    theoretical_scrap_weight_kg: float


class ProductionWorkOrderInboundCreate(BaseModel):
    work_order_id: int
    finished_qty: float = 0
    surplus_weight_kg: float = 0
    scrap_weight_kg: float = 0
    settle_work_order: bool = False
    settle_confirmed: bool = False
    deviation_remark: str | None = None
    remark: str | None = None


class ProductionWorkOrderInboundRead(BaseModel):
    work_order_id: int
    work_order_no: str
    finished_qty: float = 0
    surplus_weight_kg: float = 0
    scrap_weight_kg: float = 0
    finished_lot_id: int | None = None
    surplus_lot_id: int | None = None
    scrap_lot_id: int | None = None
    finished_txn_id: int | None = None
    surplus_txn_id: int | None = None
    scrap_txn_id: int | None = None
    settled: bool = False
    status: str
    remark: str | None = None
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class OperationReportCreate(BaseModel):
    work_order_id: int
    work_order_operation_id: int
    employee_id: int
    equipment_id: int | None = None
    report_source: str = "MANUAL"
    shift_code: str | None = None
    start_time: datetime
    end_time: datetime
    report_qty: float
    good_qty: float
    scrap_qty: float = 0
    rework_qty: float = 0
    scrap_reason: str | None = None
    downtime_minutes: float = 0
    extra_cost_amount: float = 0
    remark: str | None = None


class OperationReportRead(BaseModel):
    report_id: int
    report_no: str
    work_order_id: int
    work_order_no: str
    work_order_operation_id: int
    seq_no: int
    operation_name: str
    employee_id: int
    employee_name: str
    equipment_id: int | None = None
    equipment_name: str | None = None
    report_source: str
    shift_code: str | None = None
    start_time: datetime
    end_time: datetime
    report_qty: float
    good_qty: float
    scrap_qty: float
    rework_qty: float
    downtime_minutes: float
    extra_cost_amount: float
    is_abnormal: bool
    ref_cycle_seconds: float = 0
    actual_cycle_seconds: float | None = None
    abnormal_reason: str | None = None
    scrap_reason: str | None = None
    remark: str | None = None


class MiniAppOperationReportRead(BaseModel):
    source_report_id: int
    source_item_id: int
    report_no: str
    attendance_point_name: str = ""
    employee_phone: str
    employee_name: str
    report_date: date
    start_time: datetime
    end_time: datetime
    duration_minutes: float = 0
    effective_minutes: float = 0
    status: str
    status_name: str
    reviewer_phone: str | None = None
    reviewed_at: datetime | None = None
    reject_reason: str | None = None
    device_no: str
    project_no: str
    product_name: str
    material_code: str | None = None
    material_name: str | None = None
    raw_material_batch_no: str | None = None
    process_name: str | None = None
    standard_beat: float = 0
    standard_workload: float = 0
    good_qty: float = 0
    defect_qty: float = 0
    scrap_qty: float = 0
    erp_scrap_qty: float = 0
    allocated_minutes: float = 0
    started_at: datetime | None = None
    work_order_id: int | None = None
    work_order_no: str | None = None
    work_order_operation_id: int | None = None
    operation_name: str | None = None
    erp_report_id: int | None = None
    erp_report_no: str | None = None
    is_synced_to_erp: bool = False
    abnormal_reason: str | None = None


class MiniAppOperationReportSyncRead(BaseModel):
    sync_from: datetime | None = None
    sync_to: datetime
    last_synced_at: datetime
    total: int = 0
    synced: int = 0
    skipped: int = 0
    failed: int = 0


class MiniAppOperationReportSyncStateRead(BaseModel):
    last_synced_at: datetime | None = None


class MiniAppScrapRecordCreate(BaseModel):
    source_item_id: int
    scrap_qty: float = 0
    scrap_weight_kg: float = 0
    scrap_reason: str | None = None
    saleable_scrap_weight_kg: float = 0
    scrap_cost_amount: float = 0


class ScrapRecordCreate(BaseModel):
    report_id: int
    work_order_id: int
    work_order_operation_id: int
    item_id: int
    scrap_qty: float
    scrap_weight_kg: float = 0
    scrap_reason: str | None = None
    disposal_type: str = "SCRAP"
    saleable_scrap_weight_kg: float = 0
    scrap_cost_amount: float = 0


class ScrapRecordRead(BaseModel):
    scrap_record_id: int
    scrap_no: str
    report_id: int
    report_no: str
    work_order_id: int
    work_order_no: str
    work_order_operation_id: int
    operation_name: str
    item_id: int
    item_code: str
    item_name: str
    scrap_qty: float
    scrap_weight_kg: float
    scrap_reason: str | None = None
    disposal_type: str
    saleable_scrap_weight_kg: float
    scrap_cost_amount: float
    status: str
    created_at: datetime


class CompletionReceiptItemCreate(BaseModel):
    product_item_id: int
    location_id: int | None = None
    receipt_qty: float
    receipt_weight_kg: float = 0
    remark: str | None = None


class CompletionReceiptCreate(BaseModel):
    work_order_id: int
    warehouse_id: int
    receipt_time: datetime | None = None
    receiver_employee_id: int | None = None
    remark: str | None = None
    settle_work_order: bool = False
    settle_remark: str | None = None
    items: list[CompletionReceiptItemCreate]


class CompletionReceiptRead(BaseModel):
    completion_receipt_id: int
    receipt_no: str
    work_order_id: int
    work_order_no: str
    product_item_id: int
    product_code: str
    product_name: str
    warehouse_id: int
    warehouse_name: str
    receipt_time: datetime
    receiver_employee_id: int | None = None
    receiver_name: str | None = None
    status: str
    line_count: int
    total_receipt_qty: float
    total_receipt_weight_kg: float
    remark: str | None = None


class CompletionReceiptItemRead(BaseModel):
    completion_receipt_item_id: int
    completion_receipt_id: int
    receipt_no: str
    line_no: int
    product_item_id: int
    product_code: str
    product_name: str
    warehouse_id: int
    warehouse_name: str
    location_id: int | None = None
    location_name: str | None = None
    lot_no: str
    source_material_lot_id: int | None = None
    source_material_lot_no: str | None = None
    source_material_sub_batch_no: str | None = None
    source_material_summary: str | None = None
    receipt_qty: float
    receipt_weight_kg: float
    unit_cost: float
    status: str
    remark: str | None = None


class DeliveryItemCreate(BaseModel):
    sales_order_item_id: int | None = None
    product_item_id: int
    lot_id: int | None = None
    delivery_qty: float
    delivery_weight_kg: float = 0
    unit_price: float = 0
    remark: str | None = None


class DeliveryCreate(BaseModel):
    sales_order_id: int | None = None
    customer_id: int | None = None
    warehouse_id: int
    delivery_date: datetime | None = None
    shipper_employee_id: int | None = None
    consignee_name: str | None = None
    consignee_phone: str | None = None
    delivery_address: str | None = None
    waybill_no: str | None = None
    order_photo_url: str | None = None
    freight_amount: float | None = None
    remark: str | None = None
    items: list[DeliveryItemCreate]


class DeliveryRead(BaseModel):
    delivery_id: int
    delivery_no: str
    sales_order_id: int | None = None
    customer_id: int | None = None
    order_no: str | None = None
    customer_name: str | None = None
    warehouse_id: int
    warehouse_name: str
    delivery_date: datetime
    shipper_employee_id: int | None = None
    shipper_name: str | None = None
    consignee_name: str | None = None
    consignee_phone: str | None = None
    delivery_address: str | None = None
    logistics_waybill_no: str | None = None
    logistics_freight_amount: float | None = None
    logistics_photo_url: str | None = None
    product_names: str | None = None
    status: str
    line_count: int
    total_delivery_qty: float
    total_line_amount: float
    remark: str | None = None
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class DeliveryItemRead(BaseModel):
    delivery_item_id: int
    delivery_id: int
    delivery_no: str
    line_no: int
    sales_order_item_id: int | None = None
    order_no: str | None = None
    product_item_id: int
    product_code: str
    product_name: str
    lot_id: int | None = None
    lot_no: str | None = None
    source_material_lot_id: int | None = None
    source_material_lot_no: str | None = None
    source_material_code: str | None = None
    source_material_name: str | None = None
    source_material_sub_batch_no: str | None = None
    source_material_summary: str | None = None
    delivery_qty: float
    delivery_weight_kg: float
    unit_price: float
    line_amount: float
    status: str
    remark: str | None = None


class CustomerSuppliedInboundCreate(BaseModel):
    material_item_id: int
    warehouse_id: int
    location_id: int | None = None
    provider_name: str | None = None
    inbound_weight_kg: float
    lot_no: str | None = None
    remark: str | None = None


class InventorySettlementRead(BaseModel):
    settlement_type: str
    source_doc_type: str
    source_doc_id: int
    doc_no: str
    counterparty_name: str
    biz_date: datetime
    amount: float
    settled_amount: float = 0
    open_amount: float
    status: str
    remark: str | None = None


class EquipmentCreate(BaseModel):
    equipment_name: str
    category_name: str | None = None
    work_center_id: int
    manufacturer: str | None = None
    model_no: str | None = None
    install_date: date | None = None
    rated_power_kw: float = 0
    occupied_area_sqm: float = 0
    maintenance_cycle_hours: float = 0
    next_maintenance_at: datetime | None = None
    status: str = "IDLE"
    remark: str | None = None


class EquipmentRead(BaseModel):
    equipment_id: int
    equipment_code: str
    equipment_name: str
    category_name: str | None = None
    work_center_id: int
    work_center_name: str
    manufacturer: str | None = None
    model_no: str | None = None
    install_date: date | None = None
    rated_power_kw: float
    occupied_area_sqm: float
    maintenance_cycle_hours: float
    last_maintenance_at: datetime | None = None
    next_maintenance_at: datetime | None = None
    status: str
    remark: str | None = None


class MaintenanceOrderCreate(BaseModel):
    equipment_id: int
    maintenance_type: str
    start_time: datetime | None = None
    end_time: datetime | None = None
    downtime_minutes: float = 0
    owner_employee_id: int | None = None
    result_summary: str | None = None
    cost_amount: float = 0
    status: str = "CREATED"


class MaintenanceOrderRead(BaseModel):
    maintenance_order_id: int
    order_no: str
    equipment_id: int
    equipment_code: str
    equipment_name: str
    maintenance_type: str
    start_time: datetime | None = None
    end_time: datetime | None = None
    downtime_minutes: float
    owner_employee_id: int | None = None
    owner_name: str | None = None
    result_summary: str | None = None
    cost_amount: float
    status: str


class QualityInspectionRead(BaseModel):
    receipt_item_id: int
    receipt_id: int
    receipt_no: str
    po_no: str
    supplier_name: str
    target_warehouse_type: str = "RAW"
    material_item_id: int
    material_code: str
    material_name: str
    warehouse_name: str
    location_name: str | None = None
    lot_no: str
    received_qty: float
    received_weight_kg: float
    accepted_qty: float
    accepted_weight_kg: float
    status: str
    quality_status: str
    inspector_name: str | None = None
    receipt_date: datetime
    remark: str | None = None
    archive_status: str = "未生成"
    archive_version: int | None = None
    archive_created_at: datetime | None = None
    archive_error_message: str | None = None


class QualityInspectionAction(BaseModel):
    result: str
    remark: str | None = None


class AccountingPeriodCreate(BaseModel):
    year_no: int
    month_no: int
    start_date: date
    end_date: date
    close_status: str = "OPEN"


class AccountingPeriodRead(BaseModel):
    period_id: int
    period_code: str
    year_no: int
    month_no: int
    start_date: date
    end_date: date
    close_status: str
    closed_at: datetime | None = None


class OverheadEntryCreate(BaseModel):
    period_id: int
    overhead_type: str
    dept_id: int | None = None
    amount: float
    allocation_basis: str = "WORK_HOURS"
    description: str | None = None


class OverheadEntryRead(BaseModel):
    overhead_entry_id: int
    period_id: int
    period_code: str
    year_no: int
    month_no: int
    overhead_type: str
    dept_id: int | None = None
    dept_name: str | None = None
    amount: float
    allocation_basis: str
    description: str | None = None
    created_at: datetime


class ProductMaterialCostExpenseRead(BaseModel):
    key: str
    label: str
    amount: float


class ProductMaterialCostRowRead(BaseModel):
    work_order_id: int
    work_order_no: str
    row_no: int
    biz_date: date | None = None
    product_code: str
    customer_name: str | None = None
    product_name: str
    supply_mode: str
    delivery_note_no: str | None = None
    order_qty: float
    actual_production_qty: float
    shipped_qty: float
    inventory_qty: float
    inventory_value: float
    untaxed_unit_price: float
    untaxed_total_amount: float
    purchase_material_weight_kg: float
    used_material_weight_kg: float
    material_inventory_weight_kg: float
    material_inventory_producible_qty: float
    material_inventory_value: float
    material_grade: str | None = None
    material_unit_price_kg: float
    gross_weight_g: float
    gross_material_cost_per_piece: float
    gross_material_total_cost: float
    net_weight_g: float
    scrap_weight_g: float
    scrap_unit_price_kg: float
    scrap_revenue_per_piece: float
    scrap_total_revenue: float
    material_cost_per_piece: float
    material_total_cost: float
    loss_rate: float
    loss_total_cost: float
    labor_cost_per_piece: float
    labor_total_cost: float
    outsource_cost_per_piece: float
    outsource_total_cost: float
    product_cost_per_piece: float
    product_cost_with_adjustment_per_piece: float
    product_total_cost: float
    rework_qty: float
    rework_cost_per_piece: float
    rework_total_cost: float
    scrap_qty: float
    scrap_residual_value_per_piece: float
    scrap_total_cost: float
    batch_adjustment_avg_cost: float


class ProductMaterialCostSummaryRead(BaseModel):
    row_count: int
    sales_total: float
    gross_material_total: float
    scrap_revenue_total: float
    material_cost_total: float
    material_loss_total: float
    labor_total: float
    outsource_total: float
    rework_total: float
    scrap_total: float
    overhead_total: float
    direct_cost_total: float
    profit_amount: float
    cost_ratio: float


class ProductMaterialCostBoardRead(BaseModel):
    title: str
    date_from: date
    date_to: date
    generated_at: datetime
    rows: list[ProductMaterialCostRowRead]
    expense_rows: list[ProductMaterialCostExpenseRead]
    summary: ProductMaterialCostSummaryRead


class CostAllocationRead(BaseModel):
    cost_allocation_id: int
    period_id: int
    period_code: str
    work_order_id: int
    work_order_no: str
    product_item_id: int
    product_code: str
    product_name: str
    allocation_basis_value: float
    overhead_amount: float
    material_amount: float
    labor_amount: float
    machine_amount: float
    abnormal_loss_amount: float
    total_cost_amount: float
    unit_cost: float


class CostAllocationGenerateResult(BaseModel):
    period_id: int
    period_code: str
    generated_count: int
    rows: list[CostAllocationRead]


class StatementSnapshotCreate(BaseModel):
    period_id: int
    statement_type: str
    report_date: date


class StatementSnapshotRead(BaseModel):
    statement_snapshot_id: int
    snapshot_no: str
    period_id: int
    period_code: str
    statement_type: str
    report_date: date
    summary_json: dict
    created_at: datetime


class ReturnItemCreate(BaseModel):
    sales_order_item_id: int | None = None
    delivery_item_id: int | None = None
    product_item_id: int
    source_lot_id: int | None = None
    return_qty: float
    return_weight_kg: float = 0
    responsibility_type: str | None = None
    remark: str | None = None


class ReturnOrderCreate(BaseModel):
    customer_id: int
    sales_order_id: int | None = None
    delivery_id: int | None = None
    return_date: datetime | None = None
    return_reason: str | None = None
    handler_employee_id: int | None = None
    warehouse_id: int | None = None
    remark: str | None = None
    items: list[ReturnItemCreate]


class ReturnScrapInboundItemCreate(BaseModel):
    delivery_item_id: int
    product_item_id: int
    source_lot_id: int | None = None
    scrap_qty: float = 0
    scrap_weight_kg: float
    unit_cost: float | None = None
    remark: str | None = None


class ReturnScrapInboundCreate(BaseModel):
    customer_id: int
    delivery_id: int
    warehouse_id: int
    inbound_date: datetime | None = None
    return_reason: str | None = None
    handler_employee_id: int | None = None
    remark: str | None = None
    items: list[ReturnScrapInboundItemCreate]


class ReturnOrderRead(BaseModel):
    return_order_id: int
    return_no: str
    customer_id: int
    customer_name: str
    sales_order_id: int | None = None
    order_no: str | None = None
    delivery_id: int | None = None
    delivery_no: str | None = None
    return_date: datetime
    return_reason: str | None = None
    handler_employee_id: int | None = None
    handler_name: str | None = None
    product_names: str | None = None
    status: str
    line_count: int
    total_return_qty: float
    remark: str | None = None
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


class ReturnItemRead(BaseModel):
    return_item_id: int
    return_order_id: int
    return_no: str
    line_no: int
    sales_order_item_id: int | None = None
    delivery_item_id: int | None = None
    delivery_no: str | None = None
    product_item_id: int
    product_code: str
    product_name: str
    source_lot_id: int | None = None
    source_lot_no: str | None = None
    source_material_lot_id: int | None = None
    source_material_lot_no: str | None = None
    source_material_code: str | None = None
    source_material_name: str | None = None
    source_material_sub_batch_no: str | None = None
    source_material_summary: str | None = None
    return_qty: float
    return_weight_kg: float
    disposition_status: str
    responsibility_type: str | None = None
    remark: str | None = None


class ReturnDispositionCreate(BaseModel):
    return_item_id: int
    disposition_type: str
    scrap_weight_kg: float = 0
    extra_cost_amount: float = 0
    scrap_sale_amount: float = 0
    remark: str | None = None


class ReturnDispositionRead(BaseModel):
    return_disposition_id: int
    disposition_no: str
    return_item_id: int
    return_no: str
    product_item_id: int | None = None
    product_code: str
    product_name: str
    return_qty: float = 0
    return_weight_kg: float = 0
    disposition_type: str
    rework_work_order_id: int | None = None
    rework_work_order_no: str | None = None
    rework_report_good_qty: float = 0
    rework_report_scrap_qty: float = 0
    rework_finished_inbound_qty: float = 0
    rework_scrap_inbound_qty: float = 0
    remaining_rework_finished_inbound_qty: float = 0
    remaining_rework_scrap_inbound_qty: float = 0
    rework_close_ready: bool = False
    rework_close_status: str | None = None
    scrap_weight_kg: float
    extra_cost_amount: float
    scrap_sale_amount: float
    closed_at: datetime | None = None
    status: str
    remark: str | None = None
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None


# --- Warehouse unified inbound/outbound schemas ---

BIZ_TYPE_INBOUND = {
    "OPENING",            # 期初入库
    "CUSTOMER_SUPPLIED",  # 客料入库
    "PRODUCTION_SURPLUS", # 生产余料入库
    "OUTSOURCING_SURPLUS",# 委外余料入库
    "PRODUCTION_SCRAP_IN",# 生产废料入库
    "REWORK_SCRAP_IN",    # 返工废料入库（废料库）
    "OUTSOURCING_SCRAP_IN",# 委外废料入库
    "RETURN_IN",          # 退货入库（退货库）
    "RETURN_SCRAP_IN",    # 退货废料入库（废料库）
    "WIP_IN",             # 产中入库（半成品）
    "OUTSOURCING_IN",     # 委外入库（半成品/成品）
    "PRODUCTION_FINISHED",# 生产入库（成品）
}

BIZ_TYPE_OUTBOUND = {
    "PRODUCTION_OUT",     # 生产出库（原材料/辅料）
    "OUTSOURCING_OUT",    # 委外出库（原材料/半成品）
    "SCRAP_OUT",          # 报废出库（原材料）
    "SCRAP_SALE_OUT",     # 废料销售出库（废料库）
    "RETURN_OUT",         # 返工出库（退货库）
    "WIP_OUT",            # 产中出库（半成品）
    "SALES_OUT",          # 销售出库（成品）
}


class WarehouseInboundCreate(BaseModel):
    biz_type: str
    item_id: int
    warehouse_id: int
    location_id: int | None = None
    source_lot_id: int | None = None
    inbound_weight_kg: float = 0
    inbound_qty: float | None = 0
    unit_cost: float | None = None
    lot_no: str | None = None
    source_doc_type: str | None = None
    source_doc_id: int | None = None
    source_line_id: int | None = None
    source_lot_ids: list[int] = Field(default_factory=list)
    source_material_sub_batch_no: str | None = None
    source_material_summary: str | None = None
    provider_name: str | None = None
    waybill_no: str | None = None
    order_photo_url: str | None = None
    freight_amount: float | None = None
    remark: str | None = None
    settle_work_order: bool = False
    settle_remark: str | None = None


class OpeningInventoryImportResult(BaseModel):
    imported: int
    warehouse_type: str
    message: str


class WarehouseOutboundSourceLotCreate(BaseModel):
    source_lot_id: int = Field(gt=0)
    outbound_weight_kg: float = Field(gt=0)


class WarehouseOutboundCreate(BaseModel):
    biz_type: str
    item_id: int
    warehouse_id: int
    location_id: int | None = None
    outbound_weight_kg: float = 0
    outbound_qty: float | None = 0
    target_doc_type: str | None = None
    target_doc_id: int | None = None
    target_doc_line_id: int | None = None
    target_material_sub_batch_no: str | None = None
    sale_unit_price: float | None = None
    buyer_name: str | None = None
    sale_remark: str | None = None
    waybill_no: str | None = None
    order_photo_url: str | None = None
    freight_amount: float | None = None
    outsourcing_party_name: str | None = None
    remark: str | None = None
    source_lots: list[WarehouseOutboundSourceLotCreate] = Field(default_factory=list)


class WarehouseTransferCreate(BaseModel):
    item_id: int
    source_warehouse_id: int
    target_warehouse_id: int
    transfer_weight_kg: float
    lot_id: int | None = None
    remark: str | None = None


# --- Stocktake schemas ---


class StocktakeStartCreate(BaseModel):
    warehouse_ids: list[int] = Field(min_length=1, max_length=1)
    remark: str | None = None


class StocktakeWarehouseRead(BaseModel):
    id: int
    warehouse_id: int
    warehouse_name: str
    warehouse_type: str
    status: str


class StocktakeLineRead(BaseModel):
    id: int
    stocktake_id: int
    line_no: int
    warehouse_id: int
    warehouse_name: str
    warehouse_type: str
    location_id: int | None = None
    location_name: str | None = None
    item_id: int
    item_code: str
    item_name: str
    item_type: str
    lot_id: int | None = None
    lot_no: str | None = None
    source_material_sub_batch_no: str | None = None
    snapshot_qty: float
    snapshot_weight_kg: float
    snapshot_unit_cost: float
    counted_qty: float | None = None
    counted_weight_kg: float | None = None
    diff_qty: float
    diff_weight_kg: float
    diff_amount: float
    diff_type: str
    row_status: str
    error_message: str | None = None
    remark: str | None = None


class StocktakeRead(BaseModel):
    id: int
    stocktake_no: str
    status: str
    started_by_user_id: int | None = None
    imported_by_user_id: int | None = None
    confirmed_by_user_id: int | None = None
    canceled_by_user_id: int | None = None
    started_at: datetime
    exported_at: datetime | None = None
    imported_at: datetime | None = None
    confirmed_at: datetime | None = None
    canceled_at: datetime | None = None
    remark: str | None = None
    warehouses: list[StocktakeWarehouseRead] = Field(default_factory=list)
    summary: dict[str, float | int] = Field(default_factory=dict)


class StocktakeImportPreviewRead(BaseModel):
    stocktake: StocktakeRead
    lines: list[StocktakeLineRead]
    summary: dict[str, float | int]


class StocktakeConfirmCreate(BaseModel):
    confirm_text: str | None = None
    remark: str | None = None


# --- Special warehouse adjustment schemas ---


class SpecialWarehouseAdjustmentLineCreate(BaseModel):
    item_id: int
    lot_id: int | None = None
    location_id: int | None = None
    adjust_qty: Decimal | None = None
    adjust_weight_kg: Decimal | None = None
    unit_cost: Decimal | None = None
    line_reason: str | None = None


class SpecialWarehouseAdjustmentCreate(BaseModel):
    warehouse_id: int
    direction: str
    reason: str | None = None
    lines: list[SpecialWarehouseAdjustmentLineCreate] = Field(min_length=1)


class SpecialWarehouseAdjustmentLineRead(BaseModel):
    model_config = ConfigDict(from_attributes=True)

    id: int
    adjustment_id: int
    line_no: int
    item_id: int
    warehouse_id: int
    location_id: int | None = None
    lot_id: int
    inventory_txn_id: int | None = None
    before_qty: float
    change_qty: float
    after_qty: float
    before_weight_kg: float
    change_weight_kg: float
    after_weight_kg: float
    unit_cost: float
    line_reason: str | None = None


class SpecialWarehouseAdjustmentRead(BaseModel):
    model_config = ConfigDict(from_attributes=True)

    id: int
    adjustment_no: str
    warehouse_id: int
    warehouse_type: str
    direction: str
    reason: str
    status: str
    operator_user_id: int | None = None
    adjusted_at: datetime
    lines: list[SpecialWarehouseAdjustmentLineRead] = Field(default_factory=list)
    archive_status: str | None = None
    archive_business_id: int | None = None
    archive_document_type: str | None = None
    archive_error_message: str | None = None