Industry
/
aps-agent
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
aps-agent/docs/product/positioning.md

70 lines
2.7 KiB
Markdown
Raw Permalink Normal View History

first commit
2026-07-21 11:05:57 +08:00
# 产品定位与边界
> 真相优先级：可运行代码 > 本文档 > `plan.md` 蓝图。
---
## 1. 一句话
**APS Agent**：用自然语言驱动、用可视化确认的**计划排产智能体**——左手说意图，右手出甘特/负荷/交期，关键写操作过门禁。
---
## 2. 定位（是什么）
| 维度 | 说明 |
| --- | --- |
| 行业 | **行业无关**。重工/轻工/能源/光伏/电子等离散与准流程制造，靠主数据与知识库差异化，不靠改代码绑死工厂 |
| 规模 | 小厂可单线开箱试排；大厂目标支持多工厂三级排程（S1–S3，**蓝图**，当前实现为单世界演示数据） |
feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） - 智能体核心：Harness 门禁/_POWER_MAP、P2/P3 确认卡、证据链、Plan 运行时 L0-L3、统一工具运行时、自动化 G0-G4 - 领域层：Rule/CP-SAT/GA/NSGA-II/LNS 引擎、13 类约束目录、IIS 冲突归因、敏感性/蒙特卡洛、插单重排、MRP 分解 - 状态层：世界/对话成对快照、分支树、检查点、Saga 补偿、审批文件/DB 双后端 - 集成层：MCP 插件总线、MES/WMS 适配器（stub+HTTP）、异步任务 - 前端：左说右动工作台（聊天+甘特/负荷/交期）、主数据、订单、治理台、分支树、时间线、审计统计 - 桌面端：Electron 壳 + Python Sidecar + NSIS 打包 + 许可证 - 文档：plan.md 蓝图、完成矩阵（50 Done/10 Partial/0 Missing）、CHANGELOG 全量账本、各轮次计划/状态 - 验证基线：黄金测试 1000+ 项、Node 60 项、Web build 通过（详见 docs/CHANGELOG.md）
2026-08-20 11:39:21 +08:00
| 形态 | Web 工作台（当前）→ 桌面壳（Electron 已实现；Tauri 目标态待决策） |
first commit
2026-07-21 11:05:57 +08:00
| 算法角色 | **OR/规则出排程**；ML 只辅助参数/偏好，不直接吐最终排程表 |
| LLM 角色 | 意图理解与叙事润色；断网降级规则解析；**不得编造 KPI 数字** |
---
## 3. 边界（不是什么）
| 非目标（当前） | 说明 |
| --- | --- |
| 完整 MOM/MES 执行系统 | 工单报工、现场执行走后续 MCP 对接，本产品聚焦**计划排产** |
| 绑定某一真实客户工厂 | 种子数据仅为电子装配**演示样例**（工厂名「演示工厂」），可替换 |
feat: 康尼现场数据接入 + 柔性能力池排产 + 对话查数/知识库/报告 - 现场导入：kangni_intake 解析完整生产路线，清演示数据后写入固定轨主数据与柔性轨 - 柔性排产：pool_engine/cp_engine 能力池+虚拟产线，正排/倒排/瓶颈锚 + 滚动窗口 - 对话查数：master_query 支持订单/物料/BOM/工艺路线/委外采购建议，会话焦点指代 - 「把这个订单排产」指代解析；「这个订单有委外吗」等追问应答 - 排产方案报告导出 Excel 工作计划表（工作计划/方案概览/冲突 三表） - 知识库：机加工工艺路线生成模式 + 城轨机构装配模板 - 领域模块：MRP 分解/急单/敏感性/战役/库存投影/产能平衡/计划追溯/MES/SAP 集成桩 - 前端：柔性工作台、柔性甘特、产能池、KPI、方案对比、导入栏等视图 - 需求原始材料 demand/ 加入 .gitignore 不入库 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-23 13:38:43 +08:00
| 已上线 CP-SAT/GA | **CP-SAT + HYBRID（RULE→CP）已上线**；GA 仍可由 RULE 代跑并留痕 |
first commit
2026-07-21 11:05:57 +08:00
| 已上线插单专用管线 | 沙盒多策略对比已有；plan §9.11 秒级快评+LNS 为规划 |
---
## 4. 双入口原则
同一能力尽量支持：
1. **说**：对话意图 → 同构命令 → Harness
2. **点**：按钮/面板/Ctrl+K → 同一命令路径
禁止「对话一条逻辑、页面另一条逻辑」。
---
## 5. 演示数据与生产数据
- 后端世界状态：`server/state/seed.py` 播种 + JSON 持久化
- 前端项目树：浏览器 `localStorage`（尚未服务端项目 API）
- 换客户/换行业：换主数据与订单，**不要**在 UI/意图里写死工厂名或城市名
---
feat: 康尼现场数据接入 + 柔性能力池排产 + 对话查数/知识库/报告 - 现场导入：kangni_intake 解析完整生产路线，清演示数据后写入固定轨主数据与柔性轨 - 柔性排产：pool_engine/cp_engine 能力池+虚拟产线，正排/倒排/瓶颈锚 + 滚动窗口 - 对话查数：master_query 支持订单/物料/BOM/工艺路线/委外采购建议，会话焦点指代 - 「把这个订单排产」指代解析；「这个订单有委外吗」等追问应答 - 排产方案报告导出 Excel 工作计划表（工作计划/方案概览/冲突 三表） - 知识库：机加工工艺路线生成模式 + 城轨机构装配模板 - 领域模块：MRP 分解/急单/敏感性/战役/库存投影/产能平衡/计划追溯/MES/SAP 集成桩 - 前端：柔性工作台、柔性甘特、产能池、KPI、方案对比、导入栏等视图 - 需求原始材料 demand/ 加入 .gitignore 不入库 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-23 13:38:43 +08:00
## 5b. 真实需求输入
- 原始材料目录：仓库根 `demand/`（Word/PPT，客户/方案侧）
- 吸收文档：[demand-kangni-wuhu.md](./demand-kangni-wuhu.md)（已抽象为通用能力编号，案例工厂仅作验收剧本）
- 原则：需求驱动功能清单与里程碑优先级；**实现仍保持行业无关**
---
first commit
2026-07-21 11:05:57 +08:00
## 6. 相关文档
- 功能状态：[features.md](./features.md)
feat: 康尼现场数据接入 + 柔性能力池排产 + 对话查数/知识库/报告 - 现场导入：kangni_intake 解析完整生产路线，清演示数据后写入固定轨主数据与柔性轨 - 柔性排产：pool_engine/cp_engine 能力池+虚拟产线，正排/倒排/瓶颈锚 + 滚动窗口 - 对话查数：master_query 支持订单/物料/BOM/工艺路线/委外采购建议，会话焦点指代 - 「把这个订单排产」指代解析；「这个订单有委外吗」等追问应答 - 排产方案报告导出 Excel 工作计划表（工作计划/方案概览/冲突 三表） - 知识库：机加工工艺路线生成模式 + 城轨机构装配模板 - 领域模块：MRP 分解/急单/敏感性/战役/库存投影/产能平衡/计划追溯/MES/SAP 集成桩 - 前端：柔性工作台、柔性甘特、产能池、KPI、方案对比、导入栏等视图 - 需求原始材料 demand/ 加入 .gitignore 不入库 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-23 13:38:43 +08:00
- 真实需求吸收：[demand-kangni-wuhu.md](./demand-kangni-wuhu.md)
first commit
2026-07-21 11:05:57 +08:00
- 旅程：[journeys.md](./journeys.md)
- 架构：[../architecture/overview.md](../architecture/overview.md)
- 已落地算法：[../algorithm/scheduling-v1.md](../algorithm/scheduling-v1.md)