cnc_wams/work/working6/02-项目程序开发详细步骤.md

02-项目程序开发详细步骤

步骤 1：建立工作控制文件

• 创建 README、功能内容、开发步骤、推进台账、任务矩阵、验收证据、决策记录。
• 将 working5 后续深化方向拆分为文件/宏页面、tool editor 页面、native GTK 未实现页面诊断边界三条主线。

步骤 2：读取基准与现有实现

• 读取 work/working5 的任务矩阵、决策记录和验收证据，确认不可回退的既有行为。
• 读取 work/working3/gmoccapy_XYZAB_execution_analysis.md。
• 读取 LinuxCNC gmoccapy 源码和 Glade 文件：
  • linuxcnc/src/emc/usr_intf/gmoccapy/gmoccapy.py
  • linuxcnc/src/emc/usr_intf/gmoccapy/gmoccapy.glade
  • linuxcnc/src/emc/usr_intf/gmoccapy/dialogs.py
• 读取 Web 项目 profile、runtime、state、UI shell 和 tests。

步骤 3：建立页面/按钮/状态映射

• 梳理 native gmoccapy notebook 页面和 Web gmoccapy shell 当前页面。
• 建立文件页面映射：
  • native file chooser、program preview、recent files、program run action。
  • Web program source、preview、load/run/reset 状态。
• 建立宏页面映射：
  • INI macro 配置、宏按钮、MDI command、执行 gate。
  • XYZAB 未配置宏时的诊断边界。
• 建立 tool editor 映射：
  • tool table、active/prepared tool、offset、M6/M61 状态。
  • 只读诊断与可编辑字段边界。
• 建立未实现 native 页面清单：
  • setup/user tabs/tool/touch 等按钮和页面。
  • hard-button pin 与诊断-only action 的映射。

步骤 4：执行现有测试

• 在 app 下运行 npm run smoke:node。
• 运行构建：npm run build。
• 运行浏览器冒烟：npm run smoke。
• 如测试失败，先判断是环境问题、既有改动问题还是本轮新增行为问题。

步骤 5：补充模型和状态

• 在 profile 或 runtime model 中补充 gmoccapy 页面级 schema：
  • file page capability。
  • macro page capability。
  • tool editor capability。
  • native GTK page implementation matrix。
• 在 store 中补充必要 action 或诊断状态：
  • 文件页面的 load/recent/preview gate。
  • 宏执行的 MDI gate 或未配置提示。
  • tool editor 的只读诊断状态。
  • native 未实现页面的 operator message。
• 保持 action 命名和 existing gate 风格一致，避免绕过 LinuxCNC task policy。

步骤 6：补充 UI 诊断

• 在 gmoccapy shell 中增加可测试的诊断行或页面区块。
• 所有新增诊断必须带稳定 data-* 属性。
• 未实现页面必须显示“诊断-only/未实现/配置未启用”的明确状态。
• 文件/宏/tool editor 控件不得在不满足 gate 时显示为可执行。

步骤 7：补充测试

• Node 测试：
  • profile 页面 schema 测试。
  • communication model 页面路径测试。
  • store gate 和 operator message 测试。
• Browser 测试：
  • DOM 诊断行存在。
  • data-* 内容包含关键边界词。
  • 公开 dispatch 或按钮点击能触发预期状态和 gate。
• 如改动 UI，运行 npm run build && npm run smoke。

步骤 8：回归验收

• 运行本轮相关最小测试。
• 运行完整 npm run smoke:node。
• 运行 npm run build。
• 运行 npm run smoke。
• 运行 git diff --check -- web-rtcp-5axis-sim-plan work/working6。

步骤 9：更新台账和证据

• 更新 03-推进台账.md。
• 更新 04-任务矩阵.md 中任务状态。
• 更新 05-验收证据.md 中命令、页面、截图、报告或输出摘要。
• 如涉及架构、对标边界或兼容性取舍，更新 06-决策记录.md。