aps-agent/shared/schemas/schedule_result.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "aps://shared/schedule_result",
  "title": "ScheduleResult",
  "description": "排产结果摘要：引擎 solve() 的标准输出（plan.md §9.1），供回复文案/KPI 卡/审计共用。",
  "type": "object",
  "required": ["versionId", "versionNo", "engineType", "strategy", "orderCount", "poCount", "woCount", "conflictCount", "totalTardiness", "avgUtilization"],
  "properties": {
    "versionId": { "description": "排产版本 ID", "type": "integer" },
    "versionNo": { "description": "版本号（如 V20260716-003）", "type": "string" },
    "engineType": { "description": "引擎类型", "type": "string", "enum": ["RULE", "CP", "GA", "HYBRID", "EXTERNAL"] },
    "strategy": { "description": "策略模板", "type": "string" },
    "status": { "description": "版本状态", "type": "string", "enum": ["DRAFT", "PUBLISHED", "ARCHIVED"] },
    "orderCount": { "description": "参与排产的订单项数", "type": "integer" },
    "poCount": { "description": "生成生产订单数", "type": "integer" },
    "woCount": { "description": "生成工单数", "type": "integer" },
    "conflictCount": { "description": "冲突数", "type": "integer" },
    "totalTardiness": { "description": "总延迟（小时）", "type": "number" },
    "avgUtilization": { "description": "平均利用率 0-1", "type": "number" },
    "totalCost": { "description": "预估成本", "type": "number" },
    "evidenceRefs": { "description": "证据引用（run-id 等）", "type": "array", "items": { "type": "string" } },
    "solveStatus": { "description": "求解状态", "type": ["string", "null"] },
    "solveTimeSec": { "description": "求解墙钟秒", "type": ["number", "null"] },
    "optimalityGap": { "description": "最优性差距", "type": ["number", "null"] }
  }
}