auto(09213057c521): session end @ 2026-06-26T18:56:52 (+1f)

This commit is contained in:
ssw committed 2026-06-26 18:56:52 +08:00
1 parent 647c887367
commit 9dbd94909a
1 file changed
+57
+57
View File
@@ -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