From f7cc8fb18dd4bcdfb1edf4b43658e12d5a4065db Mon Sep 17 00:00:00 2001 From: ssw Date: Fri, 26 Jun 2026 20:14:41 +0800 Subject: [PATCH] =?UTF-8?q?docs(skill):=20data-management=20v0.11d+=20step?= =?UTF-8?q?=20machine=20+=209/9=20e2e=20+=20webapi=20shim=20=E9=A2=84?= =?UTF-8?q?=E5=AD=98=20bug=20=E6=A0=87=E8=AE=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 (2026-06-26 v0.11d+): 1. **step machine 3 步镜像** (镜像 web dataModel/Form.vue:42-242 + 后端 DbTableController.java:92-112) - step 0 基础信息 (table 正则 + tableName 必填) - step 1 字段定义 (字段数 ≥ 1 + primaryKey + 字段 vmodel + dataType 白名单 6 种 + decimal dataLength + 字段不重复 + fieldName 必填) - step 2 关键字+唯一性 (Java/SQL 关键字 + EXIST001 表名重复) 2. **关键镜像**: - 字段类型白名单: {varchar, int, datetime, decimal, bigint, text} (镜像 L19-26) - decimal dataLength 格式: ^\d+(?:,\d*)?$ (镜像 L185, 197) - 字段 vmodel 正则 /i flag: 允许大写开头 (镜像 L184) 3. **9/9 端到端验证** (tdd10): - 5 个 step machine 拦截 (SQL keyword / 字段数=0 / 无 primaryKey / 非法 dataType / 字段重复 / decimal 格式错 / 表名重复) - 2 个镜像 web 行为 (成功路径 + F_NAME 字段大写) 4. **关键新发现** (drift 防御): - web dm designer 位置: dataModel/Form.vue (不是 sysForm/Form.vue) - '请在数据库中添加对应的数据表' 实际是 getDbTableModel 抛, 不是 create 误报 - 字段正则 /i flag 镜像 web 行为 - webapi shim 预存 bug: loadDataModel.createDataModel 返回 undefined (范围外, 后续专项) Co-Authored-By: Claude --- skills/data-management/SKILL.md | 54 +++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) diff --git a/skills/data-management/SKILL.md b/skills/data-management/SKILL.md index 3b4a0fa..83a83a2 100644 --- a/skills/data-management/SKILL.md +++ b/skills/data-management/SKILL.md @@ -11,6 +11,8 @@ type: skill > - ❌ `--fields` 简化版 path (v0.11+ 推荐 `--ai-json`, 走 web 端 buildFormData) > > 📦 **dacli dm 已迁移到 Picocli (2026-06-05)**:`dacli dm --help` 自动生成精准 help。`dacli dm` 共 6 个子命令(list/table/query/create/update/drop),全部走 `DacliKit` 静态工具类,详见 `dacli-ts` 技能 (TS 版, v0.7+ 替代; 本段 Java v10.6 Picocli 注释仅历史参考)。 +> +> 🚀 **v0.11d+ 重大更新 (2026-06-26)**: `dacli dm create` 加 **step machine 校验** (3 step 镜像 web `dataModel/Form.vue:42-242` + 后端 `DbTableController.java:92-112`), 聚合错误一次报, AI 不用去浏览器试错. 详见 `MEMORY dacli-dm-create-step-machine-2026-06-26.md`. ## 何时使用 @@ -192,6 +194,58 @@ dacli dm drop --table=customer --- +## 🚀 v0.11d+ `dacli dm create` step machine 校验 + +> **新增 (2026-06-26)**: `dacli dm create` 在发 API 前跑 **3 step 校验**, 镜像 web `dataModel/Form.vue:42-242` + 后端 `DbTableController.java:92-112`. 校验失败 → 聚合错误一次报; 校验通过 → 1 次 create API. +> +> **详细设计**: 见 `MEMORY dacli-dm-create-step-machine-2026-06-26.md` (drift 防御 + 行号 + 反模式) + +### 3 step 对应 web + 后端行号 + +| Step | 校验内容 | 镜像 web 行号 | 镜像后端行号 | +|------|---------|-------------|------------| +| **step 0 基础信息** | table 必填 + table 正则 + maxlength 50 + tableName 必填 | `dataModel/Form.vue:42-61` schemas (L50 table 正则 + L57 tableName 必填) | (web 端校验) | +| **step 1 字段定义** | 字段数 ≥ 1 + 至少 1 个 primaryKey + 字段 vmodel 正则 + dataType 白名单 (6 种) + decimal dataLength 格式 + 字段不重复 + fieldName 必填 | `dataModel/Form.vue:174-209` exist() + `L213` + `L215-216` + `L19-26` options | (web 端校验) | +| **step 2 关键字+唯一性** | Java 关键字 + SQL 关键字 + 表名重复 (后端 EXIST001 预校验) | (web 端不预校验) | `DbTableController.java:92-112` checkName + `L269-275` createTable status 0/1/-1 | + +### 关键镜像: 字段类型白名单 (web `dataModel/Form.vue:19-26`) + +```ts +const VALID_DATA_TYPES = ['varchar', 'int', 'datetime', 'decimal', 'bigint', 'text'] +``` + +6 种类型外 (如 `xml`, `json`, `longtext` 等) 会被 step 1 拦截. + +### 关键镜像: decimal dataLength 格式 (web `dataModel/Form.vue:185, 197`) + +```ts +const DECIMAL_LENGTH_REGEXP = /^\d+(?:,\d*)?$/ // 例: 12 或 12,4 +``` + +`abc` / `12.5` 等会被 step 1 拦截. + +### 端到端验证 (tdd10, 9/9 预期匹配) + +``` +✓ Test 1 成功路径: table 合法 + 1 字段 + primaryKey → 3/3 step machine ✓ +✗ Test 2 SQL 关键字 'select': 表名含 SQL keyword → step 2 拦截 +✗ Test 3 字段数 = 0: empty fields → step 1 拦截 +✗ Test 4 无 primaryKey: 所有字段 primaryKey=false → step 1 拦截 +✗ Test 5 非法 dataType: dataType='xml' → step 1 拦截 +✓ Test 6 F_NAME 字段: 字段名大写开头 (FIELD_REGEXP /i 放行) → 3/3 step machine ✓ (镜像 web 行为) +✗ Test 7 字段重复: field 出现 2 次 → step 1 拦截 +✗ Test 8 decimal 格式错: dataLength='abc' → step 1 拦截 +✗ Test 9 表名重复: EXIST001 预校验 → step 2 拦截 +``` + +### 已知预存 bug (webapi shim, 范围外) + +`loadDataModel.createDataModel` 返回 `undefined`, 导致后续 `r.code` 报错. +**根因**: webapi shim 调用 defHttp 时丢失了响应. 这是 v0.11+ 镜像架构的预存 bug, 不属于 Phase 2.2 step machine 范围. +**workaround**: 用 `curl` 调 JNPF API 临时建表, 或修 webapi shim (后续专项任务). + +--- + ## 真实场景示例 ### 场景 1:建业务表 → 查结构 → 删表回滚