diff --git a/CLAUDE.md b/CLAUDE.md index 02ae0a2..7917dab 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -440,6 +440,63 @@ dacli form create --ai-json='[{ **实践工具**:`dacli/src/webapi/_loader.ts`(v0.11+ 直接 dynamic import web 端源码)、`dacli apis info`(递归展开 `$ref` + 自动展开 `ActionResult.data`)。 +### 2.7.1. dacli 改动 4 步流程(强制纪律,2026-06-26 v0.11d+) + +> **架构前提**: dacli 不是单方法提交工具, 而是 **webapi 完整规则体系镜像 + 用户浏览器操作模拟**. 所以任何改动必须先读 web 源码 + 后端源码, 不能猜. +> +> **漂移主因**: 绕开"读源码"就开始改 dacli → 错位累积 → 偏离 web 真实行为. 2026-06-26 session 4 次 user "没读源码"提醒都源于此. + +**4 步流程** (缺一不可, 跳过任何一步都算违规): + +1. **读源码** (前置) + - web 端: `web/.../views/.../Form.vue` + `web/.../components/FormGenerator/` + `web/.../components/ColumnDesign/` + `web/.../helper/formUtils.ts` + `web/.../CommonModal/DataSetModal/TableConfigDrawer.vue` + - 后端: `jnpf/.../VisualdevController.java` (create / publish) + `VisualdevServiceImpl.java` (createTable / getPrimaryDbField) + `VisualDevTableCre.java` + - 输出: 完整数据流 (state mutation → submit → backend → DB), 标注行号 + +2. **理解意图** (不只读代码) + - 用户浏览器操作流 (handleNext step 0/1/2 各自做什么) + - 哪些 state mutation 触发表单变化 (FormAttrPane.onTableNameChange 等) + - 哪些校验在哪一步跑 (validate / Generator.getData / ColumnDesign.getData) + - 哪些后端逻辑负责建表/保存 (publish line 628-635 createTable) + - 输出: 设计意图 (commit message 或 design doc 段落) + +3. **镜像设计** (基于理解, 不是猜测) + - web schema 生成 (buildFormData/buildFields) → **webapi import** (不写 JS) + - web 用户输入 (FormAttrPane.onTableNameChange) → **dacli 模拟** (例: `formData.tableName = cleanTable55`) + - web 状态机 (handleNext step 0/1/2) → **dacli step machine** + - web 提交 (handleRequest 1 次 API) → **1 次 create API** (不拆) + - web 发布 (Actions/Release) → **1 次 release API** (autoRelease) + - 后端自动建表 (publish line 628-635) → 触发 publish → 后端从 formData.fields 推 schema + +4. **实现 + 文档同步** (不后置) + - 代码: `dacli/src/...` + - `--help`: Picocli 注解, 描述"为什么这样设计" + "对应 web 端什么行为" + - SKILL.md / references/: AI 学习材料, 标注 web + 后端行号 + - MEMORY: drift 防御, 记录"为什么这样设计" + 复用代码行号 + - **一次提交完整提交, 不分批** + +**反模式 (必须避免)**: +- ❌ **猜测先行**: 先猜 web 行为 → 写 dacli → 跑测试 → 失败 → 找根因 (drift 主因) +- ❌ **增量修补**: user 提示 → 修一个点 → 引入新问题 → 再修 +- ❌ **文档后置**: 写完代码才补文档, AI 看不到"为什么" +- ❌ **--help 不更新**: dacli 用法变化但 help 没改 + +**自检清单** (改前必答): +``` +□ 1. 我读了哪个 web 端源文件? 行号是? +□ 2. 我读了哪个后端源文件? 行号是? +□ 3. web 端的状态流转 + 后端校验都理解了吗? +□ 4. 用户浏览器操作流我能讲清楚吗? (handleNext step 0/1/2) +□ 5. 我为什么用 mirror JS 而不是 webapi import? (或反之) +□ 6. --help 描述更新了吗? 含 "对应 web 端什么行为"? +□ 7. SKILL.md / references/ 同步了吗? +□ 8. MEMORY 记录这次的"为什么这样设计"了吗? +``` + +**为什么**: dacli 改一次错, AI 长期按错的指令跑, drift 累积到后面要花几倍精力修. 而 4 步流程 5-10 分钟读完源码, 一次性写对, 长期省成本. + +**详细记录**: `MEMORY dacli-source-first-discipline-2026-06-26.md` (含 2026-06-26 session 的 4 个反例: type 默认 / columnList 来源 / formData.tableName / --tables 路径) + ### 3. 建表命名规范 - 表名:`snake_case`,无前缀 (`dacli dm create --table=jxcj_xxx` 自动去 `jxcj_` 前缀 → `xxx`,CLAUDE.md 强制) - 字段名:`f_` 前缀 + snake_case