这张地图按「数据怎么进来 → 怎么算 → 凭什么可信 → 怎么交出去」分层。 每一层给出模块位置与验收方式;拿不到的、做不到的,单独列在最后。
平台层零求解逻辑 —— 它的存在只证明一件事:网页算出来的和 CLI 算出来的是同一份结果。
26,863 行 Python,纯 Python wheel,无服务、无 UI、无 LLM 依赖。
models io_csv resources calendar setup kitting lotting mspdi demo
solver/cpsat solver/greedy dispatch/* epsilon whatif reschedule
validator certificate explain trace conformance provenance
compare calibrate recommend risk chain_draft
render replenishment approval revision healthcheck benchmark
cli tools tool_contract mcp_server byoe_bridge
命令行给工程师,工具面给 AI,HTTP 给前端。三者对同一份输入必须给同一份答案。
| CLI 子命令 | 回答什么问题 | 典型调用 |
|---|---|---|
solve | 排一版计划,出 JSON / 甘特 / 证书 | aps solve ./data --solver cpsat --gantt out.html |
explain | 排不下时,最小冲突集是什么 | aps explain data.json |
trace | 这道工序为什么在这个时刻 | aps trace data.json --operation JOB-007-OP2 |
health | 这份数据能不能排(5 类体检) | aps health data.json |
whatif | 插一单,谁会从准时变拖期 | aps whatif ./data --insert job.json |
compare | 计划和实绩差在哪 | aps compare data.json --plan plan.json --actual 报工.csv |
calibrate | 工时系数该不该调(只建议) | aps calibrate compare.json |
recommend | 这个场景该用哪条规则链 | aps recommend data.json |
risk | 按期交付概率与瓶颈敏感性 | aps risk data.json |
conformance | 行业分册参数是否漂移 | aps conformance(或 --only stamping.yaml) |
load | 资源负荷率与槽位占用 | aps load data.json |
replenish | 缺料净额与计划补货 | aps replenish data.json |
lotting | 拆批 / 合批建议 | aps lotting data.json |
import-mspdi | 把 Project 计划转成排产输入 | aps import-mspdi p.xml |
demo chains industries benchmark version | 上手 / 枚举 / 基准 / 版本 | aps demo ./mydata |
给任意 MCP 客户端用。无状态,适合「问一句、要一份结果」。
给同进程 Agent 用。能做推演与方案管理 —— 因为会话状态本就属于进程内。
| 平台端点 | 用途 | 关键判据 |
|---|---|---|
POST /api/v1/solve | 求解并返回 PlanResponse | 与 CLI 逐步同源;缺 horizonStart 直接拒绝,不猜今天 |
POST /api/v1/solve/csv | CSV bundle 内联求解 | 与目录版共用唯一解析器 |
POST /api/v1/reschedule | 拖拽意图重排 | 判据在 movedHonored,不是 HTTP 200 |
POST /api/v1/reschedule/rolling | 滚动编排(实绩覆盖冻结段) | 带符号差分;版本冲突 409 |
POST /api/v1/resource-load | 负荷热力图 | 与 aps load 同一模块、同一分母口径 |
GET /api/v1/chains /industries /csv/template | 枚举与模板 | 模板即契约,改了要同步测试 |
GET /api/v1/assistant/tools | 13 个会话工具的规格 | 清单里不存在 approve/reject(断言 + humanOnly) |
POST /api/v1/assistant/act | 执行单个工具,返回 why 块 | 工具拒绝是领域回答:200 + ok:false,不是 HTTP 错误 |
GET /api/v1/assistant/demo-data | 内置演示数据(六张 CSV) | 打开网页即可问,不必先备数据 |
DELETE /api/v1/assistant/session/{sid} | 丢弃会话 | 会话只存内存(LRU + TTL),重启即丢 |
GET /healthz | 存活探针 | 鉴权豁免,仅此一个 |
「测试全绿」是最弱的证据。这里列的是更强的四种。
每个能力都配一条「把实现改错,测试必须失败」的注入验证。项目历史上抓出过 5 条假复核项。
关键判定模块(risk / compare / calibrate)跑变异分数,低于 85% 不准入。等价变异必须书面接受。
端到端脚本同时起 uvicorn 与 vite,走真实 HTTP 求解,与 CLI 逐条比对工序、资源、起止。
覆盖「两条分支同时触发」的数据(例:一台有日历 + 一台无日历)。只跑单测抓不到回退路径的错。
与 README「已知局限」表一致。写在这里,是为了不让销售话术先于事实。
| 边界 | 现状 | 性质 |
|---|---|---|
| 大规模最优性 | 50 工单内可证最优;更大规模给可行解 + 真实 gap | 已知,不修 |
| 确定性 | 仅 OPTIMAL 成立;限时未证最优时同 seed 可能不同 | 已知,不修 |
| 换型建模 | 同槽位同组成块:充分非必要,会排除部分交错排法 | 已知,不修 |
| 建模耗时 | 200 单 20~30 秒;紧凑窗口可省 36× 变量但证明最优慢 2~4× | 真实劣势 |
| 体检可执行率 | 静态校验的估计值,不含现场临时变更 | 已知 |
| 持久化 | 内核无状态;冻结窗口由调用方传入(专业版有 SQLite 会话存储) | 设计选择 |
| 人员并发 | 技能池容量已建;多工种共享同一设备的并发上限未建模 | 专业版待评审 |
| 边界外 | MRP / ATP / CTP / RCCP / S&OP / OEE / 需求预测 | 属另一产品 |