{"service": "研发需求排期引擎", "what": "输入需求清单+人力配置 → 输出可执行排期（含关键路径/资源空洞/超墙预警）。面向游戏研发与多项目并行团队，先算产能可行性再排程。", "version": "1.2.0", "how_to_call": {"step1": "本接口为 POST，需请求头 X-API-Key。浏览器地址栏是 GET，无法调用。", "step2": "按量付费：不带支付凭证会返回 402 + 报价（金额 0.10 元）与支付链接。", "step3": "完成支付后携带 Payment-Proof 重新 POST，即返回排期结果。", "curl": "curl -X POST \\\n  -H 'X-API-Key: <你的Key>' \\\n  -H 'Content-Type: application/json' \\\n  -d @input.json \\\n  https://flyingfish.cloud/sched/schedule"}, "sample_input": {"note": "最小可跑示例（2需求/4人）。完整契约见 /schema 字段说明。", "body": {"action": "schedule", "payload": {"meta": {"project": "示例项目", "wall_days": 20, "start_date": "2026-10-01", "time_unit": "day"}, "people": [{"id": "U1", "name": "交互-张三", "role": "ux"}, {"id": "Q1", "name": "白模-李四", "role": "whitemodel"}, {"id": "C1", "name": "客户端-王五", "role": "client"}, {"id": "S1", "name": "服务端-赵六", "role": "server"}], "requirements": [{"id": "R001", "name": "登录流程改版", "priority": "high", "segments": [{"func": "ux", "person": "U1", "duration": 2}, {"func": "whitemodel", "person": "Q1", "duration": 2}, {"func": "client", "person": "C1", "duration": 4}, {"func": "server", "person": "S1", "duration": 3}]}, {"id": "R002", "name": "排行榜页面", "priority": "medium", "segments": [{"func": "client", "person": "C1", "duration": 3}, {"func": "server", "person": "S1", "duration": 2}]}], "config": {}}}}, "sample_output": {"note": "上述输入的真实输出（节选）。makespan=8天<里程碑截止点20天 → feasible=true。", "body": {"ok": true, "result": {"meta": {"project": "示例项目", "makespan": 8.0, "wall_days": 20.0, "feasible": true, "converged": true, "unplaced_count": 0}, "schedule": {"people": [{"id": "C1", "role": "client", "utilization": 0.875, "tasks": [{"req": "R001", "func": "client", "start": 4.0, "end": 8.0}, {"req": "R002", "func": "client", "start": 0.0, "end": 3.0}]}, {"id": "Q1", "role": "whitemodel", "utilization": 0.25, "tasks": [{"req": "R001", "func": "whitemodel", "start": 2.0, "end": 4.0}]}]}, "self_check": {"passed": true, "violations": [], "idle_gaps": [], "overload": []}, "decisions": {"makespan": 8.0, "resource_queue": {"U1": [["R001", "ux"]], "C1": [["R001", "client"], ["R002", "client"]]}}}}}, "endpoints": {"GET /health": "存活探针（免鉴权）", "GET /": "本说明页（免鉴权）", "POST /schedule": "★ 排期主接口（需 X-API-Key / Payment-Proof）"}, "field_hint": {"meta.wall_days": "里程碑截止点（milestone deadline）——项目硬性交付节点，从开工起算的天数；不填无法判超期。亦可写作 milestone_deadline_days", "people[].availability": "不可用区间 [{from,to}]，无日历的排期=假可行", "requirements[].priority": "high/medium/low，主排序键", "segments[].func": "ux/whitemodel/visual/client/server/restore/integrate", "segments[].duration": "工时（天），>0 才排入"}}