feat: 输出报工超额快照字段

tests/test_report_over_limit.py

@@ -26,6 +26,7 @@ from app.services.report_over_limit import (
     parse_process_order,
     refresh_report_over_limit_snapshot,
 )
+from app.services.serializers import report_out
 from app.timezone import now
 
 
@@ -810,3 +811,56 @@ def test_approve_report_refreshes_over_limit_snapshot_after_correction(monkeypat
         assert saved.items[0].over_limit_current_report_qty == Decimal("60.00")
     finally:
         db.close()
+
+
+def test_report_out_exposes_over_limit_snapshot_fields():
+    report = ProductionReport(
+        id=1,
+        session_id=1,
+        attendance_point_name="总厂",
+        employee_phone="13800000000",
+        report_date=datetime(2026, 7, 25).date(),
+        start_at=datetime(2026, 7, 25, 8),
+        end_at=datetime(2026, 7, 25, 10),
+        status=ReportStatus.pending,
+        submitted_at=datetime(2026, 7, 25, 10),
+        has_over_limit=True,
+        over_limit_summary="1项超额",
+    )
+    item = ProductionReportItem(
+        id=1,
+        report=report,
+        attendance_point_name="总厂",
+        device_no="A",
+        project_no="P1",
+        product_name="产品A",
+        raw_material_batch_no="LOT-1",
+        process_name="1",
+        good_qty=60,
+        defect_qty=0,
+        scrap_qty=0,
+        standard_beat=1,
+        over_limit_status=OVER_LIMIT_STATUS_EXCEEDED,
+        over_limit_type="first_process_material",
+        over_limit_reason="1序累计报工数量超过本批次材料可支撑数量",
+        over_limit_checked_at=datetime(2026, 7, 25, 10),
+        over_limit_check_source="submit",
+        over_limit_batch_no="LOT-1",
+        over_limit_product_gross_weight_kg=Decimal("2.0000"),
+        over_limit_issued_weight_kg=Decimal("100.000000"),
+        over_limit_max_reportable_qty=Decimal("50.00"),
+        over_limit_previous_good_qty=None,
+        over_limit_current_cumulative_qty=Decimal("60.00"),
+        over_limit_current_report_qty=Decimal("60.00"),
+    )
+    report.items = [item]
+    report.allocations = []
+    report.audit_logs = []
+
+    output = report_out(report)
+
+    assert output.has_over_limit is True
+    assert output.over_limit_summary == "1项超额"
+    assert output.items[0].over_limit_status == OVER_LIMIT_STATUS_EXCEEDED
+    assert output.items[0].over_limit_reason == "1序累计报工数量超过本批次材料可支撑数量"
+    assert output.items[0].over_limit_max_reportable_qty == 50