Industry
/
aps-agent
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
aps-agent/docs
History
z.zhang 8b7063f1f8 feat(features): FF-01 功能开关文件化配置（fail-open 可见性开关） 
- 后端 server/agent_core/feature_flags.py：12 键功能目录 + JSON 配置（默认 server/data/features.json，APS_FEATURES_PATH 可覆盖）
- 网关 GET /api/features（P0 只读，实时读文件，fail-open 显式 error）
- 前端四处入口按开关隐藏：右侧导轨 / ProjectPanel / AppMenuBar 菜单 / Ctrl+K 命令面板
- 语义：可用性开关非权限边界，文件缺失/损坏默认全开
- 验证：tests/golden/test_feature_flags.py 6 passed
- 文档：harness.md 端点备案 + CHANGELOG
 		2026-09-02 02:46:18 +08:00
..
algorithm feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
architecture feat(features): FF-01 功能开关文件化配置（fail-open 可见性开关） 2026-09-02 02:46:18 +08:00
development feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
integrations feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
product feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
CHANGELOG.md feat(features): FF-01 功能开关文件化配置（fail-open 可见性开关） 2026-09-02 02:46:18 +08:00
README.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-1-evidence-chain-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-2-contract-gate-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-3-approval-note-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-4-confirm-batch-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-6-audit-ledger-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-7-doc-drift-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-8-audit-mirror-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-9-contract-gen-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-10-approval-delegate-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-11-evidence-item-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-12-approval-transfer-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-13-audit-export-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-14-audit-alerts-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-15-trace-run-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-65-aps-end-to-end-baseline.json feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-65-aps-end-to-end-parallel-implementation-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-65-aps-end-to-end-plan-audit.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-65-aps-end-to-end-runtime-baseline.json feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-65-aps-end-to-end-runtime-final.json feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-65-aps-end-to-end-state.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-65-aps-end-to-end-work-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-66-solver-isolation-parallel-implementation-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-66-solver-isolation-runtime.json feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-66-solver-isolation-state.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-66-solver-isolation-work-plan.md feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） 2026-08-20 11:39:21 +08:00
round-67-approval-migration-parallel-implementation-plan.md fix(approval): round-67 审批迁移 fail-closed 与 grant digest 归一化（R67-B1） 2026-08-20 10:09:04 +08:00
round-67-approval-migration-state.md fix(approval): round-67 审批迁移 fail-closed 与 grant digest 归一化（R67-B1） 2026-08-20 10:09:04 +08:00
round-67-approval-migration-work-plan.md fix(approval): round-67 审批迁移 fail-closed 与 grant digest 归一化（R67-B1） 2026-08-20 10:09:04 +08:00

README.md

APS Agent 文档大管家

本文件是文档体系的唯一入口。
改代码、加功能、改功能、改门禁、改模块登记——同一轮必须在本体系留痕，否则视为交付未完成。

1. 目录地图（按角色分类）

目录 读者 内容
CHANGELOG.md 全员 变更登记簿：每次代码/功能变动一条记录（大管家的账本）
product/ 产品经理 / 业务方 定位、功能清单、业务旅程、验收口径
architecture/ 架构 / 后端 / 前端 分层、门禁、可重生模块、契约与数据流
algorithm/ 算法 / OR / 数据 已落地求解逻辑、冲突语义、目标算法路线
根目录 plan.md 全员（蓝图） 完整架构蓝图；细节以本 docs/ 落地文档为准

旧扁平文件（PROGRESS.md / FEATURES.md / HARNESS.md / REGEN.md）已迁入上述分类，请勿再往根下堆新文档。

2. 写文档的硬规则（活文档铁律）

2.1 什么时候必须改文档

你改了什么 必须更新
任意功能增删改、修 bug、改交互 CHANGELOG.md 追加一节
产品能力边界 / 功能状态 product/features.md
核心用户路径或业务语义 product/journeys.md
_POWER_MAP、API 端点权限 architecture/harness.md
moduleId 增删改名 architecture/modules.md
排产规则、冲突类型、策略模板 algorithm/scheduling-v1.md
架构分层、技术选型重大变更 architecture/overview.md + 必要时同步 plan.md

2.2 CHANGELOG 写法（强制模板）

## YYYY-MM-DD — 一句话标题

- **类型**：feature | fix | refactor | docs | chore
- **做了什么**：3～8 条，写结果不写流水账
- **涉及路径**：关键文件/目录
- **验证**：命令 + 结果（如 `24 passed` / 构建成功）
- **文档同步**：勾选本次已改的文档
- **遗留**：未做完的点（可空）

2.3 真相优先级（防「文档骗人」）

  1. 可运行代码与黄金测试 > 本文档 > plan.md 蓝图
  2. 文档里写「已落地」必须能在代码里指到路径；写「规划中」必须标明未实现
  3. 禁止把演示数据写成产品定位（本产品无行业/工厂硬编码）

3. 快速导航

产品经理

  1. 产品定位与边界
  2. 功能清单与对照
  3. 真实需求吸收（康尼芜湖/排产逻辑）
  4. 柔性排产全流程模拟操作手册
  5. 对标西门子 Opcenter APS
  6. 功能落地规格
  7. 核心业务旅程
  8. 变更登记簿

架构 / 研发

  1. 架构总览
  2. Harness 门禁
  3. 可重生模块
  4. Plan 可重生运行时
  5. 蓝图全文：plan.md

算法

  1. 排产 v1（已落地）
  2. 约束与算法路线（规划）

本地跑起来

见仓库根 README.md。

4. 文档维护责任

角色 责任
每次改代码的 Agent / 开发者 同一轮更新 CHANGELOG + 对应分类文档
产品评审 以 product/ 为准验收，不以聊天记录为准
架构评审 以 architecture/ + plan.md 为准；冲突时先改文档再改代码或反过来同轮对齐

大管家索引 · 与代码同生命周期维护

Round 65 闭环 APS 索引