z.zhang
35131cde88
# Conflicts: # apps/web/e2e/order-closed-loop-contract.spec.ts # apps/web/src/App.tsx # apps/web/src/api/client.ts # apps/web/src/api/types.ts # apps/web/src/chat/ChatPanel.tsx # apps/web/src/gov/GovConsole.tsx # apps/web/src/master/FlexPanel.tsx # apps/web/src/master/MasterPanel.tsx # apps/web/src/orders/OrderPanel.tsx # apps/web/src/projects/ProjectPanel.tsx # apps/web/src/skills/AsyncJobsTab.tsx # apps/web/src/skills/mcpApi.ts # apps/web/src/styles.css # docs/CHANGELOG.md # docs/README.md # docs/algorithm/scheduling-v1.md # docs/algorithm/solution-selection-v1.md # docs/architecture/harness.md # docs/development/e2e.md # docs/product/features.md # docs/product/plan-completion-matrix.md # docs/round-67-approval-migration-parallel-implementation-plan.md # docs/round-67-approval-migration-state.md # docs/round-67-approval-migration-work-plan.md # package.json # packaging/aps-sidecar.spec # packaging/requirements-sidecar.lock # plan.md # pyproject.toml # requirements.txt # server/agent_core/approval_db_store.py # server/agent_core/approval_migrate.py # server/agent_core/approval_store.py # server/agent_core/async_jobs.py # server/agent_core/automation.py # server/agent_core/harness.py # server/agent_core/intent.py # server/aps_domain/attribution.py # server/aps_domain/closed_loop_runtime.py # server/aps_domain/flex.py # server/aps_domain/folder_pack.py # server/aps_domain/importers.py # server/aps_domain/lns.py # server/aps_domain/mes.py # server/aps_domain/mrp.py # server/aps_domain/multimodal.py # server/aps_domain/scenario_selection.py # server/aps_domain/scheduling_problem_v2.py # server/aps_domain/scheduling_validator.py # server/aps_domain/sourcing.py # server/aps_domain/workflow.py # server/db/models.py # server/engines/cp_engine.py # server/engines/nsga2_engine.py # server/engines/solver_process.py # server/engines/solver_worker.py # server/gateway/app.py # server/gateway/plan_api.py # server/sidecar.py # server/state/branches.py # server/state/checkpoints.py # shared/schemas/intent.schema.json # tests/conftest.py # tests/golden/test_approval_database_store.py # tests/golden/test_approval_migration.py # tests/golden/test_assistant.py # tests/golden/test_async_jobs.py # tests/golden/test_automation_gateway.py # tests/golden/test_automation_gears.py # tests/golden/test_cp_cumulative.py # tests/golden/test_cp_operation_level.py # tests/golden/test_desktop_sidecar.py # tests/golden/test_engine_constraint_semantics.py # tests/golden/test_evidence_contract.py # tests/golden/test_folder_pack.py # tests/golden/test_guidance.py # tests/golden/test_importers.py # tests/golden/test_mes.py # tests/golden/test_mes_evidence_v2.py # tests/golden/test_multimodal.py # tests/golden/test_nsga2_engine.py # tests/golden/test_preference_features.py # tests/golden/test_project_file_upload.py # tests/golden/test_solver_engine_isolation.py # tests/golden/test_solver_subprocess.py # 锐扬演示-操作手册.md |
||
|---|---|---|
| .. | ||
| algorithm | ||
| architecture | ||
| demo | ||
| development | ||
| integrations | ||
| product | ||
| CHANGELOG.md | ||
| README.md | ||
| round-1-evidence-chain-plan.md | ||
| round-2-contract-gate-plan.md | ||
| round-3-approval-note-plan.md | ||
| round-4-confirm-batch-plan.md | ||
| round-6-audit-ledger-plan.md | ||
| round-7-doc-drift-plan.md | ||
| round-8-audit-mirror-plan.md | ||
| round-9-contract-gen-plan.md | ||
| round-10-approval-delegate-plan.md | ||
| round-11-evidence-item-plan.md | ||
| round-12-approval-transfer-plan.md | ||
| round-13-audit-export-plan.md | ||
| round-14-audit-alerts-plan.md | ||
| round-15-trace-run-plan.md | ||
| round-65-aps-end-to-end-baseline.json | ||
| round-65-aps-end-to-end-parallel-implementation-plan.md | ||
| round-65-aps-end-to-end-plan-audit.md | ||
| round-65-aps-end-to-end-runtime-baseline.json | ||
| round-65-aps-end-to-end-runtime-final.json | ||
| round-65-aps-end-to-end-state.md | ||
| round-65-aps-end-to-end-work-plan.md | ||
| round-66-solver-isolation-parallel-implementation-plan.md | ||
| round-66-solver-isolation-runtime.json | ||
| round-66-solver-isolation-state.md | ||
| round-66-solver-isolation-work-plan.md | ||
| round-67-approval-migration-parallel-implementation-plan.md | ||
| round-67-approval-migration-runtime.json | ||
| round-67-approval-migration-state.md | ||
| round-67-approval-migration-work-plan.md | ||
| round-68-sap-outbound-p3-parallel-implementation-plan.md | ||
| round-68-sap-outbound-p3-runtime.json | ||
| round-68-sap-outbound-p3-work-plan.md | ||
| round-69-beihai-shipyard-synthetic-dataset-parallel-implementation-plan.md | ||
| round-69-beihai-shipyard-synthetic-dataset-runtime.json | ||
| round-69-beihai-shipyard-synthetic-dataset-state.md | ||
| round-69-beihai-shipyard-synthetic-dataset-work-plan.md | ||
| round-70-approval-database-authoritative-clock-parallel-implementation-plan.md | ||
| round-70-approval-database-authoritative-clock-work-plan.md | ||
| round-71-execution-record.md | ||
| round-71-unfinished-features-completion-plan.md | ||
| round-72-folder-schedule-p2-security-record.md | ||
| round-73-automation-g4-payload-binding-record.md | ||
| round-74-attribution-api-ui-record.md | ||
| round-75-cp-native-infeasible-core-record.md | ||
| round-76-kangni-real-data-trial-audit-fix-log.md | ||
| round-76-kangni-real-data-trial-parallel-implementation-plan.md | ||
| round-76-kangni-real-data-trial-post-goal-audit.md | ||
| round-76-kangni-real-data-trial-record.md | ||
| round-76-kangni-real-data-trial-work-plan.md | ||
| round-77-async-job-security-record.md | ||
| round-78-sobol-sensitivity-record.md | ||
| round-79-diagnostic-lp-attribution-record.md | ||
| round-80-cp-one-at-a-time-record.md | ||
| round-81-cp-rhs-parameter-record.md | ||
| round-82-c7-line-day-capacity-record.md | ||
| round-83-c3-calendar-segmentation-record.md | ||
| round-84-cp-direct-materialization-record.md | ||
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 真相优先级（防「文档骗人」）
- 可运行代码与黄金测试 > 本文档 >
plan.md蓝图 - 文档里写「已落地」必须能在代码里指到路径；写「规划中」必须标明未实现
- 禁止把演示数据写成产品定位（本产品无行业/工厂硬编码）
3. 快速导航
产品经理
架构 / 研发
算法
本地跑起来
见仓库根 README.md。
4. 文档维护责任
| 角色 | 责任 |
|---|---|
| 每次改代码的 Agent / 开发者 | 同一轮更新 CHANGELOG + 对应分类文档 |
| 产品评审 | 以 product/ 为准验收，不以聊天记录为准 |
| 架构评审 | 以 architecture/ + plan.md 为准；冲突时先改文档再改代码或反过来同轮对齐 |
大管家索引 · 与代码同生命周期维护