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:建业务表 → 查结构 → 删表回滚