aps-agent/docs/CHANGELOG.md

# 变更登记簿（CHANGELOG）

> **大管家的账本。** 每次改代码、加功能、改功能、修缺陷，同一轮必须追加一节。  
> 写法见 [docs/README.md §2.2](./README.md)。旧名：`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` 静态左说右动验证