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

14 KiB
Raw Blame History

变更登记簿（CHANGELOG）

大管家的账本。 每次改代码、加功能、改功能、修缺陷，同一轮必须追加一节。
写法见 docs/README.md §2.2。旧名：PROGRESS.md（已迁入本文件）。

2026-07-16 — 订单分解 MRP 首切片 + BOM/工艺路线可维护（对标西门子）

  • 类型：feature + docs
  • 做了什么：
    • 新增 MRP 领域服务 server/aps_domain/mrp.py：订单按 BOM/工艺路线分解为 自制（进排产）/ 采购建议（净需求=毛需求−库存−在途，建议下单日按采购前置期倒排）/ 委外建议（isExternal 外协工艺步骤）；写入 purchaseOrders/outsourceOrders DRAFT 建议表，重复分解幂等替换
    • order.decompose 登记 P1；GET /api/mrp + POST /api/mrp/decompose；对话口令「分解订单 SOxxx / 生成采购建议 / MRP」走同一动作
    • MD-02 深化：新增 master.bom.upsert（明细用量/关键料）与 master.routing.upsert（准备/单件时间/外协标记）两个 P2 动作；主数据面板选中成品后可直接编辑 BOM 与工艺步骤
    • 订单面板新增「分解建议」视图与「分解此单」按钮，展示采购/委外建议（含来源订单、建议下单日、前置期）
    • 黄金测试 tests/golden/test_mrp.py：缺料出采购建议+前置期倒排、充足物料零建议、外协往返、指定订单幂等、BOM 用量联动
  • 涉及路径：server/aps_domain/mrp.py · server/aps_domain/masterdata.py · server/aps_domain/workflow.py · server/agent_core/harness.py · server/agent_core/intent.py · server/gateway/app.py · server/state/seed.py · server/state/store.py · apps/web/src/orders/OrderPanel.tsx · apps/web/src/master/MasterPanel.tsx · apps/web/src/api/* · tests/golden/test_mrp.py · docs/**
  • 验证：python -m pytest tests\golden -q → 37 passed；npm run build → 成功
  • 文档同步：product/features.md（OR-07）· product/journeys.md（旅程 A4）· product/implementation-spec.md · product/aps-benchmark-siemens.md · architecture/harness.md · architecture/modules.md · 本文件
  • 遗留：建议单确认下达（转正式采购/委外，P2/P3 对接 ERP）、跨订单库存分配、多层 BOM 级联、引擎跳过外协工序占槽为后续切片

2026-07-16 — MD-01/02/03 主数据维护模块首切片

  • 类型：feature + docs
  • 做了什么：
    • 新增主数据领域服务 server/aps_domain/masterdata.py：资源树/物料BOM/日历维保只读投影 + master.line.upsert（产线编辑停启用）/ master.material.upsert（库存在途安全库存）/ master.maintenance.upsert（维保新增取消）三个 P2 写动作
    • 新增 GET /api/master 与 POST /api/master/stage；页面只暂存确认卡，批准统一走 /api/actions/confirm，写前自动 Checkpoint + 审计链
    • 引擎联动修复：find_product_lines / find_workstation_for_operation 补 ACTIVE 过滤（停用资源不进新排产）；维保冲突检测忽略 CANCELLED 窗口
    • 前端新增主数据面板 MasterPanel（资源/物料与BOM/日历与维保三页签），侧栏与右侧工具栏、命令面板均可进入
    • WorldStore 发号器支持 maintenance 表
    • 黄金测试 tests/golden/test_master_data.py：停用产线排除、库存调零缺料增加、维保窗口冲突往返、确认卡校验、审计链完整
  • 涉及路径：server/aps_domain/masterdata.py · server/gateway/app.py · server/aps_domain/workflow.py · server/agent_core/harness.py · server/engines/queries.py · server/engines/rule_engine.py · server/state/store.py · apps/web/src/master/MasterPanel.tsx · apps/web/src/App.tsx · apps/web/src/projects/ProjectPanel.tsx · apps/web/src/api/* · tests/golden/test_master_data.py · docs/**
  • 验证：python -m pytest tests\golden -q → 33 passed；npm run build → 成功
  • 文档同步：product/features.md · product/journeys.md（旅程 A3）· product/implementation-spec.md · architecture/harness.md · architecture/modules.md · 本文件
  • 遗留：工位/设备编辑、BOM/工艺路线版本发布、周日历模板、Excel 导入（MD-04）为后续切片；主数据意图口令（对话入口）后续补齐

2026-07-16 — 对标西门子 Opcenter APS 完善产品功能清单

  • 类型：docs
  • 做了什么：
    • 新增 docs/product/aps-benchmark-siemens.md：以西门子 Opcenter APS（原 Preactor）三大模块 + 8 段标准流程为标尺，逐项盘点覆盖度与差距
    • features.md 扩充：新增「计划层 Advanced Planning」章节（PL-01~PL-06）+ 主数据/订单/排产/执行多项对标功能点（MD-05~07、OR-05~06、SC-07~11、EX-06~09、IND-01~02），差距清单按「缺口×频率」重排
    • implementation-spec.md 编号总表同步新增 25 个功能编号
    • 更新 product 索引与大管家导航
  • 涉及路径：docs/product/aps-benchmark-siemens.md · docs/product/features.md · docs/product/implementation-spec.md · docs/product/README.md · docs/README.md
  • 验证：文档编号一致性自检；未改运行代码
  • 文档同步：product/* · docs/README.md · 本文件
  • 遗留：新登记功能点的落地规格卡随各里程碑（M4/M5/M6）开工时补齐；计划层 AP 为最大缺口

2026-07-16 — Codex 式工作台布局与会话节点导航

  • 类型：feature + fix + docs
  • 做了什么：
    • 将左侧从图标轨/项目面板改为 Codex 桌面端式工作区侧栏：快捷入口、项目列表、当前项目任务、底部设置
    • 去掉顶栏重复项目/任务标题，中央区域回归沉浸式对话；无结果数据时对话区铺满主工作区
    • 订单管理、检查点/版本、会话结果收敛到右侧工具入口，结果视图按当前会话快照展示
    • 新增会话节点导航：对话区最右侧生成消息节点，悬停显示节点摘要，点击滚动到对应消息
    • 修复上一版左侧新结构缺少样式导致原生控件裸露的问题
    • 修复右侧工具展开后的大面积空白：右侧工作区改为吃满剩余空间，竖向工具栏固定贴最右侧
  • 涉及路径：apps/web/src/App.tsx · apps/web/src/projects/ProjectPanel.tsx · apps/web/src/chat/ChatPanel.tsx · apps/web/src/styles.css
  • 验证：npm run build → 成功；python -m pytest tests\golden -q → 28 passed
  • 文档同步：本文件
  • 遗留：左侧快捷入口后续可继续绑定真实“知识库管理”页面；当前先复用设置/集成入口

2026-07-16 — 首屏引导与操作口径专业化

  • 类型：fix + docs
  • 做了什么：
    • 将对话首屏从口号式说明改为“排产工作流 / 方案评估 / 版本治理 / 视图分析”的业务化引导
    • 快捷指令与命令面板改为计划员工作台口径，如“多策略方案对比”“查看当前KPI”“发布当前排产版本”
    • 甘特空态、时间线空态、后端帮助和无版本提示统一为专业表达
    • 增加旧欢迎语本地缓存迁移，命中“左边说，右边动”时自动替换新版欢迎语，不清空其他消息
  • 涉及路径：apps/web/src/chat/ChatPanel.tsx · apps/web/src/App.tsx · apps/web/src/viewport/GanttView.tsx · apps/web/src/timeline/TimelineRail.tsx · server/aps_domain/workflow.py · server/aps_domain/reports.py
  • 验证：npm run build → 成功；python -m pytest tests\golden -q → 28 passed
  • 文档同步：本文件
  • 遗留：项目/任务默认名称后续可随真实项目模板继续行业化

2026-07-16 — OR-01 订单管理首切片 + 审计契约修复

  • 类型：feature + fix + docs
  • 做了什么：
    • 新增订单领域服务：订单只读投影、成品校验、order.upsert/cancel/complete P2 写入逻辑
    • 新增 GET /api/orders 与 POST /api/orders/stage，订单页面只暂存确认卡，批准仍统一走 /api/actions/confirm
    • 前端新增订单管理面板：列表、编辑表单、新建/编辑/取消/完成、内嵌确认卡与批准/驳回
    • 修复审计事件时间契约：新增 at，保留 ts，治理页与旧数据兼容
    • 黄金测试新增 OR-01 覆盖：新增订单进入排产、取消订单排除、确认卡摘要、审计双字段
    • 同步门禁矩阵、模块登记、产品状态、业务旅程与落地规格
  • 涉及路径：server/aps_domain/orders.py · server/aps_domain/workflow.py · server/gateway/app.py · server/agent_core/audit.py · apps/web/src/orders/OrderPanel.tsx · apps/web/src/App.tsx · apps/web/src/api/* · tests/golden/test_order_management.py · docs/**
  • 验证：python -m pytest tests\golden -q → 28 passed；npm run build → 成功
  • 文档同步：product/features.md · product/journeys.md · product/implementation-spec.md · architecture/harness.md · architecture/modules.md · 本文件
  • 遗留：OR-01 后续仍缺多明细、批量变更、附件；OR-03 订单审核状态机未做

2026-07-16 — 产品功能落地规格补全

  • 类型：docs
  • 做了什么：
    • 新增 docs/product/implementation-spec.md，按主数据、订单、排产、执行、对话治理拆出功能落地卡
    • 为每个功能点补充用户目标、最小切片、权力等级、数据对象、API/动作、UI、验收与测试要求
    • 在 features.md 增加落地规格编号，覆盖当前可演示能力、主数据、订单、排产引擎、结果执行、对话治理
    • 更新 product 索引和大管家导航，产品评审可从功能清单跳到落地规格
  • 涉及路径：docs/product/implementation-spec.md · docs/product/features.md · docs/product/README.md · docs/README.md
  • 验证：文档链接与编号自检；未改运行代码，未跑业务测试
  • 文档同步：product/* · docs/README.md · 本文件
  • 遗留：后续实现任一功能时仍需同步 journeys.md、harness.md 或 algorithm/* 的对应落地细节

2026-07-16 — 文档体系重组（大管家 + 分类落地）

  • 类型：docs
  • 做了什么：
    • 建立 docs/README.md 大管家入口与活文档铁律
    • 按角色拆分：product/ · architecture/ · algorithm/
    • PROGRESS.md → CHANGELOG.md；HARNESS/REGEN/FEATURES 迁入对应分类并校正「已落地 vs 规划」口径
    • 种子工厂名改为「演示工厂」（去地域硬编码，与产品通用定位一致）
  • 涉及路径：docs/** · plan.md §12.9 · README.md · server/state/seed.py
  • 验证：文档结构自检；种子仅改展示名，不影响黄金测试键结构
  • 文档同步：本文件 · product/* · architecture/* · algorithm/* · 大管家
  • 遗留：plan.md 蓝图中仍有大量「目标态」章节，以 docs/algorithm/ 与 product/features.md 的状态列为准

2026-07-16 — 产品化整改：缺陷修复 + 设置收敛 + 通用化

  • 类型：fix + feature + docs
  • 做了什么：
    • 修复右侧无数据：/api/gov/tests?run=true 改为 asyncio.to_thread；前端 refreshWorld 逐端点兜底 + 3s 重试
    • 导航收敛：轨道仅 项目/对话/时间线/设置；门禁与重生并入设置
    • 前端种子项目改「演示项目（示例数据）」；顶栏「智能排产 · 通用行业版」
    • 产出功能清单（后迁入 product/features.md）
  • 涉及路径：server/gateway/golden.py · apps/web/src/** · docs/
  • 验证：后端多端点 200；npm run build 通过
  • 遗留：订单/主数据管理页等见 product/features.md 差距清单

2026-07-16 — plan.md 深水区五问补全

  • 类型：docs
  • 做了什么：plan.md 增补约束体系、主控参数、方案优选、插单重排、小样本迁移等蓝图节（目标态，多数未进代码）
  • 涉及路径：plan.md
  • 验证：章节编号连贯
  • 遗留：落地以 algorithm/scheduling-v1.md 为准；蓝图能力标 🔜

2026-07-16 — UI 对标 Codex 操作

  • 类型：feature
  • 做了什么：新建任务前置、Kebab 菜单、任务重命名、多行输入、快捷指令收起
  • 涉及路径：apps/web/src/projects/** · apps/web/src/chat/** · apps/web/src/shell/**
  • 验证：npm run build 通过
  • 遗留：任务状态仍前端固定「运行中」

2026-07-16 — M3 知识与偏好

  • 类型：feature
  • 做了什么：知识资产库 + bigram 检索带出处；日报/版本对比报告；偏好加权缺省策略；意图与前端 evidence/report 块
  • 涉及路径：server/knowledge/** · server/aps_domain/reports.py · apps/web/** · tests/golden/test_m3_knowledge.py
  • 验证：pytest tests/golden -q → 24 passed；npm run build；E2E M3 PASS
  • 遗留：真向量 RAG、会话树服务端化、上下文四层管理

2026-07-16 — M2.5 Codex 级产品表面 + 文档体系初建

  • 类型：feature + docs
  • 做了什么：治理端点、GovConsole、Ctrl+K、过程文档初版
  • 验证：黄金测试全绿；npm run build
  • 遗留：权力矩阵在线编辑 🔜 M4

2026-07-16 — M2 前端补完（项目制 + 折叠 + 分隔条）

  • 类型：feature
  • 做了什么：项目/任务/文件、折叠轨、分隔条、时间线回滚口令
  • 验证：当时黄金测试 15/15；构建通过
  • 遗留：项目数据仍在浏览器 localStorage

2026-07-15~16 — M2 后端（成对状态 + 沙盒 + 时间线）

  • 类型：feature
  • 做了什么：Checkpoint、Explore 沙盒对比、时间线/治理 API、审计链
  • 验证：15/15

2026-07-15 — M0 + M1（Monorepo + 左说右动闭环）

  • 类型：feature
  • 做了什么：FastAPI + React 壳、规则引擎、意图两级管线、Harness、三视图
  • 验证：当时 11/11；断 LLM 可降级

更早 — M-POC

  • 类型：chore
  • 做了什么：poc/workbench.html 静态左说右动验证