用途:在实施非平凡的 CAP 变更时(CDS、服务、处理器、注解),提供一致的实现与验证流程。
适用时机:新增或修改实体、关联、投影或服务暴露;更新 cap/srv/*.js 处理器或事件钩子;重新生成构建产物并验证基本运行时行为。
主要步骤:明确期望行为与受影响文件;若涉及 CDS,先用 cds-mcp 解析定义,并在提出 CAP API/CLI 语法前用 cds-mcp 检查 CAP 文档;在合适层做最小改动,例如 cap/db 放领域模型、cap/srv/-service.cds 放契约、cap/srv/-fiori.cds 放 UI 注解、cap/srv/*.js 放运行时逻辑;CDS 变更后在 cap/ 下运行 npm run build 重建产物;执行紧凑验证清单并报告结果;记录风险、假设与后续事项。
仓库注意事项:HANA 部署后生成的文件夹可能被清空,需再次运行 npm run build;SQLite 本地加载在并行加载时可能触发 SQLITE_BUSY。
实施后可使用清单模板 assets/change-checklist.md。