Printing 模块字段说明（2025-12-12）

PrintingJob

来源：api_v1/views/printing/serializers.py 中的 PrintingJobDetailSerializer

字段	说明
`id`	主键
`printing_order` / `printing_order_id`	关联的印染主订单 ID 与人类可读编号
`product` / `product_name` / `product_code`	关联产品
`quantity` / `unit`	生产数量与单位
`size`	一段尺寸
`pieces`	件数
`description`	备注
`work_state`	业务进展枚举值，详见下表
`work_state_display`	业务进展的中文描述
`status` / `status_id`	stateflow 状态显示值与下一步节点 ID
`is_completed` / `has_started`	是否完成、是否已开始
`business_object_id`	关联流程实例 ID
`created_at` / `updated_at`	创建、更新时间戳

定义于 printing.models.PrintingJobWorkStateEnum：

Serializer 与 Model 完全同步，work_state 可在创建/更新接口提交（字段可选），返回时携带 work_state_display。

来源：api_v1/views/printing/serializers.py 中的 PlateOrderDetailSerializer

PlateOrder 模型当前 没有 work_state 字段。主要字段如下（按序列化器顺序）：

字段	说明
`id` / `design_code`	主键与设计编号（空则回退为主键字符串）
`plate_type` / `plate_date` / `plate_method`	开版类型、时间、方式
`plate_image` / `plate_image_url`	JSONField 存储的图片信息及其对外地址
`image_name` / `plate_notes` / `reprint_reason`	图片名称、注意事项、复版原因
`urgency_level` / `is_invalid`	紧急程度、是否作废
`customer` / `customer_name` / `customer_phone` / `area` / `default_address`	客户与地址信息
`salesperson` / `merchandiser` / `designer` 及对应 `*_name`	关联员工
`style_name` / `fabric` / `fabric_source` / `width` / `production_method`	款式与面料信息
`is_mark_frame` / `drawing_rating` / `color_matching_rating` / `sample_rating` / `difficulty_rating`	标记及评分字段
`sample_meter` / `required_sample_meters`	样品米数及需求
`required_completion_date` / `completion_date`	要求完成与实际完成时间
`approval_result` / `is_ordered` / `customer_feedback`	审批结果、下单状态、客户反馈
`process` / `process_name`	关联流程 ID 与名称
`status` / `status_id` / `is_completed` / `has_started` / `progress_percentage` / `business_object_id` / `last_completed_state`	stateflow 状态相关字段
`print_count`	打印次数
`created_at` / `updated_at`	创建、更新时间戳

由于 PlateOrder 未包含 work_state，前端无需提交该字段；若后续业务需要，可在模型与序列化器中新增字段并同步更新本文档。