commit c98ad4f425c108f201ff72dfec5b15fc13e4e336 Author: ssw Date: Fri Jun 12 18:26:39 2026 +0800 init: TS 版 dacli v0.7 baseline (8 父命令/26+ 子命令, 0.4MB, .claude/skills/dacli-ts) 参考 boot/ 仓库结构初始化, 同步到 gitea:3000/ssw/dacli (private). 包括: - src/ 8 父命令 (form/menu/dm/dict/di/apis/doc/workflow + login/status) + core (client/crypto/help/log/types/config) - src/schema/ FieldBuilder (从 JNPF web 源码提取, 避免 53 个手写 builder) - tests/ vitest 单元 + playwright E2E (含 workSystem/developSystem baseline regression) - scripts/ extract-all.mjs (从 jnpf-web 源码生成 schema) + seed-tds-baseline.ts - doc/ architecture/plan/api/extractors/baseline/RESUME/help-system + v0.6/v0.7 changelog - .claude/skills/dacli-ts/ Claude 集成 skill (SKILL.md + 5 references + 7 examples + 3 baseline) - CLAUDE.md (项目说明) + README.md + prompt.md (开发任务说明书) - 配置文件: package.json/lock, tsconfig, vitest.config, playwright.config diff --git a/.claude/skills/dacli-ts/SKILL.md b/.claude/skills/dacli-ts/SKILL.md new file mode 100644 index 0000000..24f637c --- /dev/null +++ b/.claude/skills/dacli-ts/SKILL.md @@ -0,0 +1,408 @@ +--- +name: dacli-ts +description: Use when working with JNPF platform form/menu/workflow creation, data model design, dictionary setup, or data interface config — provides TypeScript-based dacli CLI commands to drive JNPF without manual UI clicks. Triggers on: 建表单/create form, 建菜单/create menu, 配字典/dictionary, 数据接口/data interface, 数据模型/data model, 工作流/workflow, 表单发布/release form, 表单列表/list forms, 查表单信息/form info, baseline 复刻/baseline clone, JNPF 后台操作, ssw 业务模块开发, 表单迁移. Apply when: 业务人员/AI 想要自动化配置 JNPF 而不是浏览器点击;批量迁移表单/菜单;AI 用 CLI 代替人类在设计器里拖拽;CI/CD 中调用 JNPF API;74 张官方示例的 0 差错验证。 +--- + +# dacli-ts — AI 驱动的 JNPF CLI 工具 (TS 版) + +> **位置**: `$ccWorkDir/dacli/`(原 `test/dacli/`, 2026-06-12 升级到顶层独立项目) +> **运行时**: Node 22 + tsx (启动 < 500ms) +> **入口**: `npx tsx $ccWorkDir/dacli/src/cli.ts `(或 `cd $ccWorkDir/dacli && npx tsx src/cli.ts `) +> **当前状态**: **v0.7 (2026-06-12) — 8 父命令 / 26+ 子命令 + form release endpoint 修 + dm create web 真路径 + AI 需求驱动闭环** +> **目标**: **0 差错** (workSystem 85 + developSystem 29 baseline API + UI 全 0 错) +> **对照**: Java 版 `ssw-dacli` (已废弃归档) 见 `docs/dacli/ssw-dacli/` + +--- + +## 🆕 v0.7 关键校准 (2026-06-12, AI 必读) + +| 校准项 | 旧 (v0.6) | 新 (v0.7) | 影响 | +|--------|-----------|-----------|------| +| **form release endpoint** | PUT `/Actions/State` (返 200 但 state 没真变) | **POST `/Actions/Release`** (web 真路径) | release 真生效, 不再有"假成功" | +| **dm create body shape** | flat `{table, fields, primaryKeyPolicy, ...}` | **`{tableInfo: {...}, tableFieldList: [...]}`** (web `dataModel/Form.vue:218` 同款) | 老 shape 报 `getTableInfo() null` NPE | +| **dm create 自动补 PK** | 不补 | 自动补 `f_id` + `f_tenant_id` 复合 PK + 9 系统列 | 否则 `DbFieldForm.getPrimaryKey() null` NPE | +| **dm fields 解析** | 只看 `{ fields: [...] }` | 兼容 `{ list / fields / array }` 三形态 | 老代码报 0 字段假象 | +| **form export 带物理 schema** | 只导 form 元数据 | 同时调 `/Tables/{t}/Fields` 拉 `_physicalSchema` | 解 #15 跨应用 import 不建表 bug | +| **form import 默认 `--autoTable`** | 没建表能力, 浏览器"该表单已删除" | 默认 true: import 前先建物理表 (复用 `_physicalSchema` 或 `tables[].fields[]`) | 跨应用迁移真闭环 | +| **form create 必传 `--tables`** | 不传时建空表 (`_clone`) | 文档校准: type=1/2 必传 `--tables` 引用已有表 | 不再误建表 | +| **menu create Actions/Module 失败 fallback** | 卡死报 "System abnormality" | 退到低级 `POST /system/Menu` 100% 工作 | tds 等业务库菜单挂得上 | +| **P0 #13 AI 真闭环验证** | 留 P0 | 已验证: subagent 用 dacli-ts 从零搭 `tds_leave` 请假表单 + CRUD 真路径 200 | dacli-ts skill **可独立支撑 AI 完成业务** | + +详见 [doc/v0.7-changelog.md](../../../doc/v0.7-changelog.md) + [references/troubleshooting.md](references/troubleshooting.md) 错误 18-22. + +--- + +## 🆕 v0.6 关键校准 (2026-06-12, AI 必读) + +| 校准项 | 旧 (v0.5) | 新 (v0.6) | 影响 | +|--------|-----------|-----------|------| +| **form list 真总数** | workSystem 52 / developSystem 20 | workSystem **85** / developSystem **29** | v0.5 走 `/list` 子端点强制 `enableFlow=1` → 漏 33+9 张非工作流 form | +| **list 端点修复** | GET `/visualdev/Base/list` | GET `/visualdev/Base` | 见 `src/commands/form/list.ts` + import.ts | +| **浏览器登录路径** | `/web/#/login` (admin 无菜单 → 404) | `/jnpf_app_/login` + `/home` (每 app 独立) | 来自 ssw-e2e-test | +| **浏览器会话复用** | 每个 spec 重登 | Playwright `projects.setup` + `storageState`, TTL 6h | 见 `tests/e2e/auth.setup.ts` | +| **menu create 真路径** | POST /api/system/Menu (低级, 字段易漏) | POST `/api/visualdev/Base/{formId}/Actions/Module` (web 高级 API) | 后端自动 moduleId/propertyJson/授权; 见 `web/views/onlineDev/formDesign/components/CreateMenuModal.vue` | +| **menu unrelease 新命令** | - | `dacli menu unrelease --formId=X` (Actions/Module pc=0 app=0) | DELETE /api/system/Menu/X 报 "System abnormality" 时兜底 | +| **挂菜单 + /model/X 规则** | 隐式 | **至少一个菜单挂表单, `/jnpf_app_/model/` 才生效** (vue-router 动态注册) | 没挂菜单访问必 404 | +| **真业务 vs 预览** | 混用 | `/model/` 真业务 (能 CRUD), `/previewModel?isPreview=1` 只读预览 | previewModel 不能真保存! | +| **form import 已知 bug** | 报"成功" 但浏览器"该表单已删除" | 留 #15 — import 只复制元数据, 不建底层物理表 | 真验证用 #13 AI 重建 | + +详见 [references/playwright.md](references/playwright.md) §2.1-3.5. + +--- + +## ✅ v0.6 状态 (AI 必读 — 全部命令可用了) + +| 命令 | 端到端验证 | 子命令 | 备注 | +|------|------------|--------|------| +| `dacli login / status / switch-app` | ✅ | 3 顶层 | token 持久化 + dbLinkId 自动检测 | +| `dacli form` | ✅ | list/info/create/release/delete/export/import/clone/validate (9) | list 端点 v0.6 修, import 不建表 (#15 留) | +| `dacli dm` | ✅ | list/create/drop/fields (4) | 物理表 CRUD | +| `dacli dict` | ✅ | type-list/data-list (2) | 字典类型 + 数据 | +| `dacli menu` | ✅ | list/create/delete/**unrelease** (4) | create 改 web 真路径; unrelease 新加 | +| `dacli di` | ✅ | list (1) | 数据接口 (弹窗/下拉/关联表单用) | +| `dacli workflow` | ✅ | list/launch/approve (3) | 流程模板/发起/审批 | +| `dacli doc` | ✅ | list (1) | HTML 文档扫描 | +| `dacli apis` | ✅ | list (1) | JNPF OpenAPI /v3/api-docs 查 | + +**测试覆盖** (W5 末): +- 33/33 vitest 单测 PASS (含 FieldBuilder 18 + crypto 5 + config 5 + cli-help 5) +- 11/11 Playwright E2E PASS (smoke 3 + developSystem 4 + workSystem 4) +- **baseline 验证 72/72 form schema 完整** (developSystem 20 + workSystem 52, 0 错) +- typecheck 零警告 + +**AI 工作时的选择**: +- 所有命令 TS 版已可用, **优先用 TS 版** (命令简洁 + 启动 < 500ms) +- 视觉对比 (Playwright 0 视觉差) 仍需手工写 spec, 见 [references/playwright.md](references/playwright.md) +- Java 版仅在 TS 版没实现的边缘场景兜底 (e.g. 报表/门户/portal/codegen) + +--- + +## 0. 何时使用本 skill + +### 触发场景 + +| 用户说 | AI 应该 | +|--------|--------| +| "建一个请假流程" | → `dacli form create + dacli workflow create + dacli menu create` | +| "把这 5 张表单迁到 tds" | → `dacli form export` × 5 + `dacli form import` × 5 | +| "批量加个字典分类" | → `dacli dict data-create` 循环 | +| "查下这个表单字段" | → `dacli form info ` | +| "测一下这个 API" | → `dacli apis info " "` | +| "跑 baseline 复刻" | → `bash examples/baseline/all.sh` | +| "dacli form create 失败" | → [references/troubleshooting.md](references/troubleshooting.md) | +| "找不到错误怎么解" | → troubleshooting.md 错误 1-11 | + +### 不适用场景 + +| 场景 | 原因 | +|------|------| +| 修改 JNPF 平台源码 | CLAUDE.md 禁止 | +| 改 ssw 业务 Java 代码 | 走 `backend-dev` 技能 | +| 仅查文档/写 design | 直接用 web 源码或设计模板 | +| 一次性手动点 1 个表单 | 不如浏览器 | + +--- + +## 1. 启动与基础 + +### 1.1 首次使用 + +```bash +cd $ccWorkDir/dacli +npm install # 装依赖 +npx playwright install chromium # 装浏览器 (baseline 验证用) +npx tsx scripts/extract-all.mjs # 提取 web 源码到 data/*.json +npx tsx src/cli.ts login --appCode=tds # 登录 tds +``` + +**应用对象**: +- `tds` (http://127.0.0.1:13880/api) — 实际业务应用 +- `developSystem` — 21 张 baseline 示例 +- `workSystem` — 53 张 baseline 示例 +- 用户: `admin / 123456` + +### 1.2 状态查询 + +```bash +npx tsx src/cli.ts status # 文本输出 +npx tsx src/cli.ts status --json # JSON 输出 (脚本用) +# → baseUrl / token 路径 / 当前 appCode / dbLinkId / loginAt +``` + +### 1.3 切换应用 + +```bash +npx tsx src/cli.ts switch-app --appCode=developSystem # baseline +npx tsx src/cli.ts switch-app --appCode=workSystem # baseline +npx tsx src/cli.ts switch-app --appCode=tds # 业务 +``` + +--- + +## 2. 8 大父命令速查 + +| 命令 | 用途 | 子命令数 | 详细 | +|------|------|---------|------| +| `dacli form` | 表单 CRUD (clone/release/import/export 全跑通) | 9 | [commands.md](references/commands.md#form) | +| `dacli dm` | 数据模型 (业务库物理表) | 4 | [commands.md](references/commands.md#dm) | +| `dacli dict` | 字典 (类型 + 数据) | 2 | [commands.md](references/commands.md#dict) | +| `dacli menu` | 菜单 (按 app) | 3 | [commands.md](references/commands.md#menu) | +| `dacli di` | 数据接口 (弹窗/下拉/关联) | 1 | [commands.md](references/commands.md#di) | +| `dacli workflow` | 工作流 (模板/发起/审批) | 3 | [commands.md](references/commands.md#workflow) | +| `dacli doc` | HTML 文档 (从 docs/ 扫描) | 1 | [commands.md](references/commands.md#doc) | +| `dacli apis` | JNPF OpenAPI 查 (v3/api-docs) | 1 | [commands.md](references/commands.md#apis) | + +--- + +## 3. ⭐ 5 大决策点 (AI 经常错) + +> **核心**: 这 5 个决策 AI 经常判断错, 按下表查 + +### 决策 1: 创建表单用哪个 type? + +| 场景 | type | webType | 是否需要物理表 | +|------|------|---------|--------------| +| 单表 CRUD | **1** | 2 | ✅ 需要 | +| 主子表 | **1** | 2 | ✅ 需要 2+ 张 | +| 系统表单 | 2 | 2 | (平台内置) | +| **快速 POC / 视图** | **4** | 1 | ❌ 不需要 | +| 数据接口 | 3 | - | ❌ | + +**AI 反模式**: 默认 `type=1, webType=2` 然后去硬建表 → 90% 概率 "Database exception" +**AI 正解**: 先 `dacli dm list` 看库里有什么表 → 复用;或先 `type=4` 跑通再升级 + +### 决策 2: form 提交后是否要 release? + +| 场景 | release? | +|------|----------| +| type=1 (主表) | ✅ 必须 | +| type=2 (系统表单) | ✅ | +| type=3 (数据接口) | ✅ | +| **type=4 (视图)** | **❌ 不需,会 400** | + +### 决策 3: 表单菜单 type 几? + +| 菜单类型 | type | category | 必须含 | +|---------|------|----------|--------| +| 表单菜单 (挂表单) | **3** | Web | `moduleId=` + `urlAddress='model/{enCode}'` | +| 目录 | 1 | Web | - | +| 链接 | 7 | Web | `linkTarget=_blank` | + +### 决策 4: 怎么处理 "Database exception"? + +| 原因 | 解决 | +|------|------| +| `dbLinkId='0'` 错 | 先 `dacli status` 看真实 dbLinkId | +| `tables[].fields[]` 缺字段 | 用 `type=4` 视图绕开 | +| `category='0'` 错 | `dacli form list` 看已有 form 的 category | +| 服务器限流 | `sleep 30` 重试 | + +### 决策 5: 端到端业务实现路径 + +**反模式** (AI 经常走错): +``` +form create → 失败 → 改字段 → form create → 失败 → 改 type → ... (循环) +``` + +**正解** (顺序): +``` +1. dacli dm list 看有什么表 +2. dacli form list 看有什么表单 +3. dacli form info 找一个最相近的看 schema +4. dacli form clone 克隆再改 (最稳) +5. dacli form release 发布 +6. dacli menu create --moduleId= 建菜单 +``` + +**AI 黄金法则**: +> 99% 的"建新表单"应该**先 clone 再改**,不要从零搭。 +> 平台已经有 74 张官方示例 (developSystem 21 + workSystem 53),先找最相近的克隆。 + +--- + +## 4. ⭐ 0 差错验证 (Playwright + baseline) + +### 4.1 0 差错定义 + +| 层面 | 含义 | 工具 | +|------|------|------| +| **API 0 错** | 所有 dacli 命令返回 200/业务成功 | vitest + 集成测试 | +| **UI 0 视觉差** | 复刻的表单/菜单浏览器渲染与原版**像素级一致** | **Playwright Node.js** | + +### 4.2 baseline 复刻流程 + +```bash +# 1. 切到 baseline 应用 +dacli switch-app --appCode=developSystem +dacli login --appCode=developSystem + +# 2. 找到目标表单 +dacli form list | jq '.data.list[] | select(.enCode=="leaveApply") | .id' + +# 3. 导出 + 导入到 tds +dacli form export --out=/tmp/leaveApply.json +dacli switch-app --appCode=tds +dacli form import /tmp/leaveApply.json --enCode=leaveApply_clone + +# 4. 发布 +CLONE_ID=$(dacli form list | jq -r '.data.list[] | select(.enCode=="leaveApply_clone") | .id') +dacli form release $CLONE_ID + +# 5. Playwright 验证 (API + UI 双 0 错) +npx playwright test tests/e2e/baseline/developSystem/leaveApply.spec.ts +``` + +### 4.3 一键回归 74 张 + +```bash +# 跑全部 74 张 (API + UI) +bash examples/baseline/all.sh + +# 仅 API 层 (快, 跳过 Playwright) +SKIP_PLAYWRIGHT=1 bash examples/baseline/all.sh +``` + +### 4.4 baseline 真值源 (W5 末实测) + +| app_code | 表单数 | 来源 | 已验证 (API 层) | +|----------|--------|------|------------------| +| `developSystem` | 20 | 基础示例 (单表/主子表/简单工作流) | ✅ 20/20 schema 完整 | +| `workSystem` | 52 | 复杂示例 (关联/字典/数据接口/复杂流程) | ✅ 52/52 schema 完整 | +| **总计** | **72** | **dacli 0 差错基线 (API 层全 0 错)** | ✅ 72/72 | + +> 注: prompt §1.4 写 21+53=74, 实际 20+52=72 (JNPF 6.2.0 平台侧几个 form 下线). 全部已实测. + +详细: [references/baseline/](references/baseline/) + +--- + +## 5. 关键命令 (AI 一眼能看完) + +```bash +# ===== 登录/状态 (✅ v0.1 跑通) ===== +dacli login --appCode=tds # 默认 admin/123456, baseUrl 自动从 env/nginx/127.0.0.1:30000 探活 +dacli switch-app --appCode=developSystem # 切应用 (覆盖 token) +dacli status # 看登录态 +dacli status --json # 脚本用 + +# ===== 表单只读 (✅ v0.1 跑通) ===== +dacli form list # 列当前应用所有表单 +dacli form list --limit=200 --json # 全列表 + 原始 JSON +dacli form info # 完整 schema +dacli form info --summary # 只打概要 +dacli form export --out=/tmp/x.json # 导出 (备份/baseline) +dacli form validate # 校验 columnData __config__ + +# ===== 表单写 (⚠️ W2 extractor 完成后才能完整跑通) ===== +dacli form create --fullName=X --enCode=X --type=4 --webType=1 # 视图兜底 +dacli form clone --newEnCode=v2 --release # 克隆 + 发布 +dacli form import x.json --enCode=v2 # 导入 +dacli form release # 0→1 +dacli form release --soft # type=4 软跳过 +dacli form delete --yes # 删 (无确认) + +# ===== AI 友好帮助 (所有命令支持) ===== +dacli form create --ai-help # 输出 markdown (purpose/required/optional/source/example) +dacli form create --example # 输出 bash 示例 +dacli form create --source # 输出 web 源码 / API 路径 + +# ===== W2+ 命令 (❌ 未实现, 报 exit 2) ===== +dacli menu / dm / dict / workflow / di / doc / apis + +# ===== baseline 复刻 (W3 启动) ===== +bash .claude/skills/dacli-ts/examples/baseline/all.sh + +# ===== 测试 (W5 末) ===== +npx vitest run # 33/33 单测 (含 FieldBuilder 18) +npx playwright test # 11/11 E2E (smoke 3 + developSystem 4 + workSystem 4) +npx tsc --noEmit # typecheck 0 错 + +# ===== 提资产 (JNPF 升级时) ===== +node scripts/extract-all.mjs # 重跑 4 个 extractor → src/data/*.json + +# ===== baseline 一键回归 ===== +npx playwright test tests/e2e/baseline/developSystem/regression.spec.ts # 20/20 +npx playwright test tests/e2e/baseline/workSystem/regression.spec.ts # 52/52 +``` + +--- + +## 6. AI 工作流建议 + +### 6.1 接到任务时的决策树 + +``` +用户要"建表单/菜单/工作流"? +├─ 已有相近表单? +│ ├─ YES → clone + 改 (模式 1-7 任一) +│ └─ NO → 走完整流程 +│ +走完整流程: +├─ 1. login + status +├─ 2. dm list + dict type-list 了解应用 +├─ 3. form create (clone 优先, type=4 兜底) +├─ 4. release (type≠4 时) +├─ 5. menu create +└─ 6. Playwright 验证 (baseline 0 视觉差) +``` + +### 6.2 接到"查问题"任务时 + +``` +用户报"dacli form create 失败"? +├─ 1. status 看 baseUrl/token/appCode +├─ 2. 跑命令看完整 raw 响应 (含 code/msg) +├─ 3. 查 troubleshooting.md 错误 1-11 +├─ 4. 必要时 跑 extract-all.mjs + 重新跑 +└─ 5. 都失败 → 浏览器手动确认是不是 JNPF 平台问题 +``` + +--- + +## 7. 与 Java 版 dacli 的差异 (W5 末) + +| 维度 | dacli Java (生产) | dacli TS (本 skill) | +|------|-------------------|---------------------| +| **稳定性** | ⭐⭐⭐⭐⭐ (6 月打磨, 261 tests) | ⭐⭐⭐ (W5 末 33+11 tests) | +| **AI 友好度** | ⭐⭐⭐ (Picocli --help) | ⭐⭐⭐⭐⭐ (--ai-help + 提取 web) | +| **Schema 真相** | 53 FieldBuilder 硬编码 | data/*.json 自动提取 (60 jnpfKey + 14 L1 正则) | +| **启动** | 100ms native | < 500ms tsx | +| **0 差错基线** | baseline-summary.md (40 form) | **72 张官方示例** (developSystem 20 + workSystem 52, 0 错) | +| **Playwright** | 走 ssw-e2e-test (Python) | **@playwright/test (Node.js) 集成** | +| **父命令** | 17 (含 portal/report/codegen 等) | 8 (form/dm/dict/menu/di/workflow/doc/apis) | +| **编译** | mvn 慢 | tsx 零编译 | + +**默认推荐** (W5 末): +- 8 大主流场景 → **TS 版** (更快, AI 友好, 0 错验证) +- 边缘场景 (portal/report/codegen) → **Java 版** +- 复刻 baseline → **TS 版** (Node Playwright 集成, 不用切进程) + +--- + +## 8. 必读 references + +| 文档 | 何时读 | +|------|--------| +| [references/commands.md](references/commands.md) | 接到具体命令需求 | +| [references/patterns.md](references/patterns.md) | 接到"建 XX"业务需求 | +| [references/anti-patterns.md](references/anti-patterns.md) | 写完 dacli 命令后自查 | +| [references/troubleshooting.md](references/troubleshooting.md) | 报错时第一查 | +| [references/baseline/README.md](references/baseline/README.md) | 跑 0 差错验证前 | +| [references/playwright.md](references/playwright.md) | 写 baseline 测试时 | + +--- + +## 9. 进阶:定制 skill + +如果需要扩展 skill: +1. 在 `references/` 加新 .md +2. 在 `examples/baseline/` 加新 .sh +3. **不要**改 `SKILL.md` 主入口 (它是 AI 第一眼看的内容) +4. 改完跑"AI 自检": 把 skill 喂给另一个 Claude, 让它完成 1 个任务 + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**配套文档**: [doc/architecture.md](../../doc/architecture.md) +**核心目标**: **74 张官方示例 API 0 错 + 浏览器 0 视觉差** diff --git a/.claude/skills/dacli-ts/examples/baseline/all.sh b/.claude/skills/dacli-ts/examples/baseline/all.sh new file mode 100755 index 0000000..ed71973 --- /dev/null +++ b/.claude/skills/dacli-ts/examples/baseline/all.sh @@ -0,0 +1,58 @@ +#!/bin/bash +# examples/baseline/all.sh — 一键回归 74 张 baseline +# 用法: bash examples/baseline/all.sh [--skip-visual] +set -e + +SKIP_VISUAL=0 +[ "$1" = "--skip-visual" ] && SKIP_VISUAL=1 + +PASS=0 +FAIL=0 +FAILED_FORMS=() + +# 1. 跑 21 张 developSystem baseline +for script in examples/baseline/developSystem/*.sh; do + [ ! -f "$script" ] && continue + echo "" + echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" + echo "▶ $script" + echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" + if [ $SKIP_VISUAL -eq 1 ]; then + SKIP_PLAYWRIGHT=1 bash "$script" || { FAIL=$((FAIL+1)); FAILED_FORMS+=("$script"); continue; } + else + bash "$script" || { FAIL=$((FAIL+1)); FAILED_FORMS+=("$script"); continue; } + fi + PASS=$((PASS+1)) +done + +# 2. 跑 53 张 workSystem baseline +for script in examples/baseline/workSystem/*.sh; do + [ ! -f "$script" ] && continue + echo "" + echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" + echo "▶ $script" + echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" + if [ $SKIP_VISUAL -eq 1 ]; then + SKIP_PLAYWRIGHT=1 bash "$script" || { FAIL=$((FAIL+1)); FAILED_FORMS+=("$script"); continue; } + else + bash "$script" || { FAIL=$((FAIL+1)); FAILED_FORMS+=("$script"); continue; } + fi + PASS=$((PASS+1)) +done + +# 3. 汇总 +TOTAL=$((PASS+FAIL)) +echo "" +echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" +echo "=== baseline 回归结果 ===" +echo " 通过: $PASS / $TOTAL" +echo " 失败: $FAIL" +if [ $FAIL -gt 0 ]; then + echo " 失败列表:" + for f in "${FAILED_FORMS[@]}"; do + echo " - $f" + done + exit 1 +fi +echo " ✓ 0 差错: 全部通过" +exit 0 diff --git a/.claude/skills/dacli-ts/examples/baseline/developSystem/test-form-dev.sh b/.claude/skills/dacli-ts/examples/baseline/developSystem/test-form-dev.sh new file mode 100755 index 0000000..1e5caa6 --- /dev/null +++ b/.claude/skills/dacli-ts/examples/baseline/developSystem/test-form-dev.sh @@ -0,0 +1,65 @@ +#!/usr/bin/env bash +# examples/baseline/developSystem/test-form-dev.sh +# +# 复刻脚本: 把 developSystem 的 test_form_dev 完整复刻到 tds (或当前 app) +# 步骤: export 原表单 → 拿到元数据 → import 到 tds → release → playwright 验证 +# +# 用法: bash examples/baseline/developSystem/test-form-dev.sh +# +# 验证标准 (见 doc/baseline.md): +# 1. API 0 错 (所有 HTTP 200/业务成功) +# 2. 重建后 formData.fields 数量与原版一致 +# 3. Playwright 渲染原版/复刻版 DOM 字段集一致 +# +# 0 差错的精确含义: +# - id / enCode 必然不同 (新表) +# - 时间戳 / 创建人不同 +# - 物理表名前缀 (test_form_dev → test_form_dev_clone) +# - 像素级抗锯齿差异 (1-2 像素) +set -euo pipefail + +cd "$(dirname "$0")/../../../.." + +SRC_APP=developSystem +SRC_ENCODE=test_form_dev +TGT_APP=${TGT_APP:-tds} +CLONE_ENCODE="${SRC_ENCODE}_clone" +TMP=/tmp/${SRC_ENCODE}_orig.json + +echo "▶ [1/6] export 原表单: $SRC_APP/$SRC_ENCODE" +npx tsx src/cli.ts form export "$SRC_ENCODE" --appCode="$SRC_APP" --out="$TMP" + +echo "▶ [2/6] 拿到原表单的元数据 (id/dbLinkId)" +ORIG_INFO=$(npx tsx src/cli.ts form info "$SRC_ENCODE" --appCode="$SRC_APP") +ORIG_ID=$(echo "$ORIG_INFO" | jq -r '.data.id // empty') +ORIG_DBLINK=$(echo "$ORIG_INFO" | jq -r '.data.dbLinkId // empty') +echo " 原 id=$ORIG_ID dbLinkId=$ORIG_DBLINK" + +echo "▶ [3/6] switch 到目标 app + 登录" +npx tsx src/cli.ts switch-app --appCode="$TGT_APP" --force >/dev/null + +echo "▶ [4/6] import 到 $TGT_APP" +npx tsx src/cli.ts form import "$TMP" --appCode="$TGT_APP" --enCode="$CLONE_ENCODE" + +echo "▶ [5/6] release 克隆表单" +CLONE_ID=$(npx tsx src/cli.ts form list --appCode="$TGT_APP" --json | \ + jq -r --arg enc "$CLONE_ENCODE" '.data.list[]? | select(.enCode==$enc) | .id') +if [ -z "$CLONE_ID" ]; then echo "✗ 找不到克隆表单 $CLONE_ENCODE"; exit 1; fi +echo " 克隆 id=$CLONE_ID" +npx tsx src/cli.ts form release "$CLONE_ID" --appCode="$TGT_APP" || echo " (release 失败, 通常 type=4 视图自动跳过)" + +echo "▶ [6/6] 验证 (API 0 错 + 字段集一致)" +ORIG_FIELDS=$(echo "$ORIG_INFO" | jq '.data.formData' | jq '[.. | .__vModel__? // empty] | map(select(. != "")) | length') +CLONE_INFO=$(npx tsx src/cli.ts form info "$CLONE_ID" --appCode="$TGT_APP") +CLONE_FIELDS=$(echo "$CLONE_INFO" | jq '.data.formData' | jq '[.. | .__vModel__? // empty] | map(select(. != "")) | length') + +echo " 原字段数: $ORIG_FIELDS" +echo " 克隆字段数: $CLONE_FIELDS" +if [ "$ORIG_FIELDS" != "$CLONE_FIELDS" ]; then + echo "✗ 字段数不一致! 0 差错失败" + exit 1 +fi + +echo "" +echo "✓ baseline 0 差错通过: $SRC_ENCODE → $CLONE_ENCODE" +echo " 后续可跑: npx playwright test tests/e2e/baseline/developSystem/${SRC_ENCODE}.spec.ts" diff --git a/.claude/skills/dacli-ts/examples/baseline/template.sh b/.claude/skills/dacli-ts/examples/baseline/template.sh new file mode 100644 index 0000000..53d5711 --- /dev/null +++ b/.claude/skills/dacli-ts/examples/baseline/template.sh @@ -0,0 +1,58 @@ +#!/bin/bash +# examples/baseline/template.sh — baseline 复刻脚本模板 +# 复制本文件改 ENCODE / ORIGINAL_ID / APP_CODE 即可 + +set -e + +# ========== 配置 (必改) ========== +APP_CODE="developSystem" # 源 app: developSystem | workSystem +ORIGINAL_ID="469065268790880645" # 源表单 id (从 dacli form list 查) +ENCODE="leaveApply" # 源表单 enCode +CLONE_ENCODE="${ENCODE}_clone" # 克隆 enCode (避免冲突) + +# ========== 可选配置 ========== +SKIP_PLAYWRIGHT="${SKIP_PLAYWRIGHT:-0}" # 1=跳过浏览器验证 (调试用) +TARGET_APP="tds" # 目标 app (通常 tds) + +# ========== 1. 切到源 app, 导出 ========== +echo "▶ [1/6] 导出 $APP_CODE / $ENCODE (id=$ORIGINAL_ID) ..." +dacli switch-app --appCode=$APP_CODE +dacli login --appCode=$APP_CODE +dacli form export $ORIGINAL_ID --out=/tmp/${ENCODE}-orig.json + +# ========== 2. 切到目标 app, 导入 ========== +echo "▶ [2/6] 导入到 $TARGET_APP ..." +dacli switch-app --appCode=$TARGET_APP +dacli login --appCode=$TARGET_APP +dacli form import /tmp/${ENCODE}-orig.json --enCode=$CLONE_ENCODE + +# ========== 3. 拿克隆 id ========== +echo "▶ [3/6] 拿克隆 id ..." +CLONE_ID=$(dacli form list | jq -r ".data.list[] | select(.enCode==\"$CLONE_ENCODE\") | .id") +if [ -z "$CLONE_ID" ]; then + echo "✗ 克隆后查不到 enCode=$CLONE_ENCODE" + exit 1 +fi +echo " 克隆 id: $CLONE_ID" + +# ========== 4. 发布 ========== +echo "▶ [4/6] 发布克隆 ..." +dacli form release $CLONE_ID || echo " ⚠ release 失败 (type=4 视图可跳过)" + +# ========== 5. API 0 错验证 (字段集对比) ========== +echo "▶ [5/6] API 0 错验证 ..." +dacli form validate $CLONE_ID || { echo "✗ schema 校验失败"; exit 1; } +echo " ✓ schema 校验通过" + +# ========== 6. Playwright 浏览器 0 视觉差 ========== +if [ "$SKIP_PLAYWRIGHT" = "1" ]; then + echo "▶ [6/6] Playwright 跳过 (SKIP_PLAYWRIGHT=1)" +else + echo "▶ [6/6] Playwright 浏览器 0 视觉差验证 ..." + npx playwright test e2e/baseline/${APP_CODE}/${ENCODE}.spec.ts +fi + +echo "" +echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" +echo "✓ baseline 复刻成功: $APP_CODE / $ENCODE → $TARGET_APP / $CLONE_ENCODE (id=$CLONE_ID)" +echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" diff --git a/.claude/skills/dacli-ts/examples/create-master-sub-form.sh b/.claude/skills/dacli-ts/examples/create-master-sub-form.sh new file mode 100644 index 0000000..94059dd --- /dev/null +++ b/.claude/skills/dacli-ts/examples/create-master-sub-form.sh @@ -0,0 +1,94 @@ +#!/bin/bash +# examples/create-master-sub-form.sh +# 业务模式 2: 主子表 (TS 版) +# +# AI 用法: +# 1. 复制本文件 +# 2. 改 FULL_NAME, ENCODE, MASTER_FIELDS, SUB_FIELDS +# 3. 跑 bash create-master-sub-form.sh +# +# ⚠️ TS 版主子表 (table jnpfKey) 端到端跑通需 W2-D5 后的 FieldBuilder 全套支持 +# 强烈建议改用 type=4 视图 + 多个 form 替代, 或降级到 Java 版 dacli + +set -e + +# ========== 配置 (AI 必改) ========== +FULL_NAME="订单管理" +ENCODE="order" +TARGET_APP="tds" +DB_LINK_ID="$(npx tsx src/cli.ts status 2>&1 | grep dbLinkId | head -1 | awk -F: '{print $2}' | tr -d ' ,')" +CATEGORY="Form" + +MASTER_TABLE="${ENCODE}_main" # 订单主表 +SUB_TABLE="${ENCODE}_detail" # 订单明细表 + +MASTER_FIELDS='[ + {"field":"f_order_no","fieldName":"订单号","jnpfKey":"input","required":1}, + {"field":"f_customer","fieldName":"客户","jnpfKey":"input","required":1}, + {"field":"f_amount","fieldName":"金额","jnpfKey":"inputNumber","required":1} +]' + +SUB_FIELDS='[ + {"field":"f_product","fieldName":"产品名","jnpfKey":"input","required":1}, + {"field":"f_qty","fieldName":"数量","jnpfKey":"inputNumber","required":1}, + {"field":"f_price","fieldName":"单价","jnpfKey":"inputNumber","required":1} +]' + +# ========== 1. login ========== +echo "▶ 登录 $TARGET_APP ..." +npx tsx src/cli.ts switch-app --appCode=$TARGET_APP > /dev/null +npx tsx src/cli.ts login --appCode=$TARGET_APP > /dev/null + +# ========== 2. 建主表 + 子表 ========== +echo "▶ 建主表 $MASTER_TABLE ..." +npx tsx src/cli.ts dm create \ + --table=$MASTER_TABLE \ + --tableName="订单主表" \ + --dbLinkId=$DB_LINK_ID \ + --fields="$MASTER_FIELDS" + +echo "▶ 建子表 $SUB_TABLE ..." +npx tsx src/cli.ts dm create \ + --table=$SUB_TABLE \ + --tableName="订单明细" \ + --dbLinkId=$DB_LINK_ID \ + --fields="$SUB_FIELDS" + +# ========== 3. 建主子表表单 (手写 tables JSON) ========== +# 注: 主子表 schema 复杂, v1 阶段建议先 clone 现有主子表 baseline 改 +echo "▶ 建主子表表单 $ENCODE (提示: 推荐用 form clone 现有主子表 baseline 改)" + +# 简化版: 用 type=4 视图快速跑通 +npx tsx src/cli.ts form create \ + --fullName="$FULL_NAME" \ + --enCode=$ENCODE \ + --type=4 \ + --webType=1 \ + --dbLinkId=$DB_LINK_ID \ + --category="$CATEGORY" + +# ========== 4. 拿 id, 建菜单 ========== +FORM_ID=$(npx tsx src/cli.ts form list | jq -r ".data.list[] | select(.enCode==\"$ENCODE\") | .id") +npx tsx src/cli.ts menu create \ + --fullName="$FULL_NAME 菜单" \ + --enCode="${ENCODE}Menu" \ + --type=3 \ + --category=Web \ + --moduleId=$FORM_ID \ + --urlAddress="model/$ENCODE" \ + --webType=1 \ + --linkTarget=_self \ + --parentId=0 + +echo "" +echo "✓ 完成: $FULL_NAME (主子表)" +echo " 主表: $MASTER_TABLE" +echo " 子表: $SUB_TABLE" +echo " 表单 id: $FORM_ID (type=4 视图占位, 真实主子表用 form clone 现有 baseline)" +echo "" +echo "⚠ 提示: type=1 主子表 schema 复杂, 推荐 baseline 路径:" +echo " 1. dacli switch-app --appCode=workSystem" +echo " 2. dacli form list --keyword=订单 # 找现有主子表" +echo " 3. dacli form clone --newEnCode=$ENCODE" +echo " 4. dacli form release " +echo " 5. dacli menu update --moduleId=" diff --git a/.claude/skills/dacli-ts/examples/create-simple-form.sh b/.claude/skills/dacli-ts/examples/create-simple-form.sh new file mode 100644 index 0000000..ff16289 --- /dev/null +++ b/.claude/skills/dacli-ts/examples/create-simple-form.sh @@ -0,0 +1,69 @@ +#!/usr/bin/env bash +# examples/create-simple-form.sh +# 业务模式 1: 单表 CRUD (TS 版, 用 type=4 视图兜底) +# +# AI 用法: +# 1. 复制本文件 +# 2. 改 FULL_NAME, ENCODE, FIELDS_JSON +# 3. 跑 bash create-simple-form.sh +# +# 已知 TS 版限制 (与 Java 版差异): +# - 不支持 menu create 高级选项 (--moduleId, --isButtonAuthorize, --isDataAuthorize 等) +# → TS 建菜单只到基础页 (urlAddress+fullName+enCode+type+category) +# - 高级菜单/按钮/数据权限请用 Java 版 (docs/dacli/ssw-dacli/, 已废弃归档) 或浏览器手动补 +set -euo pipefail + +cd "$(dirname "$0")/../.." + +# ========== 配置 (AI 必改) ========== +FULL_NAME="我的请假申请" +ENCODE="myLeave" +TARGET_APP="tds" + +# 拿当前 dbLinkId (从 token 自动) +DB_LINK_ID=$(npx tsx src/cli.ts status 2>&1 | grep dbLinkId | head -1 | awk -F: '{print $2}' | tr -d ' ,') + +# 用 FieldBuilder 风格的字段定义 (type=4 视图, 不需 autoIncrement/identity/columnName) +FIELDS_JSON='[ + {"jnpfKey":"input","label":"姓名","__vModel__":"f_name","__config__":{"required":true}}, + {"jnpfKey":"inputNumber","label":"请假天数","__vModel__":"f_days","__config__":{"required":true}}, + {"jnpfKey":"textarea","label":"请假原因","__vModel__":"f_reason","__config__":{}} +]' + +# ========== 1. login ========== +echo "▶ 登录 $TARGET_APP ..." +npx tsx src/cli.ts switch-app --appCode="$TARGET_APP" >/dev/null + +# ========== 2. 建表单 (type=4 视图, 不动物理表, 100% 成功) ========== +echo "▶ 建表单 $ENCODE (type=4 视图) ..." +npx tsx src/cli.ts form create \ + --fullName="$FULL_NAME" \ + --enCode="$ENCODE" \ + --type=4 \ + --webType=1 \ + --fields="$FIELDS_JSON" \ + --json 2>&1 | tail -5 + +# ========== 3. 拿 id, 建菜单 (TS 版只建基础页) ========== +echo "▶ 建菜单 ..." +FORM_ID=$(npx tsx src/cli.ts form list --json | jq -r --arg enc "$ENCODE" '.list[]? | select(.enCode==$enc) | .id' | head -1) +if [ -z "$FORM_ID" ]; then + echo "✗ 找不到表单 $ENCODE, 跳过建菜单" + exit 1 +fi +npx tsx src/cli.ts menu create \ + --fullName="$FULL_NAME" \ + --enCode="${ENCODE}Menu" \ + --urlAddress="model/$ENCODE" \ + --category=2 \ + --type=2 + +echo "" +echo "✓ 完成 (TS 版, 基础)" +echo " 表单 id: $FORM_ID" +echo " 菜单: ${ENCODE}Menu" +echo "" +echo "浏览器访问: http://127.0.0.1:30000/web/#/model/$ENCODE" +echo "" +echo "⚠️ 高级功能 (按钮权限/数据权限/列表配置) 需用 Java 版 dacli 或浏览器手动补" +echo " 详见 examples/create-simple-form-java.sh (TODO: 加 Java fallback)" diff --git a/.claude/skills/dacli-ts/examples/create-workflow.sh b/.claude/skills/dacli-ts/examples/create-workflow.sh new file mode 100644 index 0000000..5ae1a91 --- /dev/null +++ b/.claude/skills/dacli-ts/examples/create-workflow.sh @@ -0,0 +1,74 @@ +#!/bin/bash +# examples/create-workflow.sh +# 业务模式 3: 工作流表单 (TS 版) +# +# AI 用法: +# 1. 先 create-simple-form.sh 建好表单 +# 2. 改 FORM_ENCODE 引用已建表单 +# 3. 跑 bash create-workflow.sh +# +# ⚠️ TS 版 workflow launch/approve 已跑通, 但 "建流程模板" (含画布 JSON) 还没在 v0.5 实现 +# 推荐: 1) web 端画流程模板 → 拿 id → 2) TS 端 launch/approve + +set -e + +# ========== 配置 ========== +FORM_ENCODE="myLeave" # 引用已建的表单 enCode +WORKFLOW_FULL_NAME="请假审批流" +WORKFLOW_ENCODE="${FORM_ENCODE}Flow" +TARGET_APP="tds" + +# ========== 1. 拿分类 id ========== +echo "▶ 拿工作流分类 id ..." +npx tsx src/cli.ts switch-app --appCode=$TARGET_APP > /dev/null +npx tsx src/cli.ts login --appCode=$TARGET_APP > /dev/null + +# 用 dict 找 WorkflowCategory 类型的 id (各应用可能不同) +CATEGORY_ID=$(npx tsx src/cli.ts dict type-list | jq -r '.data.list[] | select(.enCode | test("流程|Workflow|flow")) | .id' | head -1) +[ -z "$CATEGORY_ID" ] && { + echo "✗ 找不到工作流分类, 请先在 web 端建一个 dict type" + exit 1 +} +echo " 分类 id: $CATEGORY_ID" + +# ========== 2. 拿表单 id ========== +FORM_ID=$(npx tsx src/cli.ts form list | jq -r ".data.list[] | select(.enCode==\"$FORM_ENCODE\") | .id") +[ -z "$FORM_ID" ] && { + echo "✗ 找不到表单 $FORM_ENCODE, 请先跑 create-simple-form.sh" + exit 1 +} +echo " 表单 id: $FORM_ID" + +# ========== 3. 建工作流 (空流程, 节点配 web 端) ========== +echo "▶ 建工作流 $WORKFLOW_ENCODE ..." +npx tsx src/cli.ts workflow create \ + --fullName="$WORKFLOW_FULL_NAME" \ + --enCode=$WORKFLOW_ENCODE \ + --formType=1 \ + --formId=$FORM_ID \ + --category=$CATEGORY_ID + +# ========== 4. 拿工作流 id ========== +WORKFLOW_ID=$(npx tsx src/cli.ts workflow list | jq -r ".data.list[] | select(.enCode==\"$WORKFLOW_ENCODE\") | .id") +echo " 工作流 id: $WORKFLOW_ID" + +echo "" +echo "✓ 工作流创建完成: $WORKFLOW_FULL_NAME" +echo "" +echo "⚠ 重要: 工作流**节点配置**目前 TS 版不完整 (BPMN 25+ 节点类型)" +echo " 必须用 web 端配置节点:" +echo " 1. 浏览器登录: http://127.0.0.1:13880/web/" +echo " 2. 进入 在线开发 → 流程表单 → $WORKFLOW_FULL_NAME" +echo " 3. 设计流程图 (起始 → 部门经理审批 → HR 审批 → 结束)" +echo " 4. 配置每个节点的审批人/条件/消息" +echo " 5. 保存" +echo "" +echo "或者用 baseline 克隆:" +echo " dacli form list --appCode=workSystem --keyword=请假" +echo " dacli form clone --newEnCode=$WORKFLOW_ENCODE" + +# ========== 5. (可选) 发起流程测试 ========== +echo "" +echo "发起流程测试 (假设表单已配好):" +echo " dacli workflow launch $WORKFLOW_ID \\" +echo " --formData='{\"f_name\":\"张三\",\"f_days\":3}'" diff --git a/.claude/skills/dacli-ts/references/anti-patterns.md b/.claude/skills/dacli-ts/references/anti-patterns.md new file mode 100644 index 0000000..26af5e8 --- /dev/null +++ b/.claude/skills/dacli-ts/references/anti-patterns.md @@ -0,0 +1,256 @@ +# anti-patterns.md — 8+ 反模式 (AI 必看) + +> **目标**: 列出 AI 经常犯的错, 提前避免 + +--- + +## 0. ❌ form create type=1/2 不传 --tables (v0.7 新加) + +**反模式**: +```bash +# 已经先 dm create 建好物理表 tds_leave +dacli form create --fullName="员工请假申请" --enCode=tds_leave \ + --type=1 --webType=2 --dbLinkId=$DBLINK +# ↑ 没传 --tables → form/create.ts 默认建空表 tds_leave_clone, 不引用已建好的 tds_leave! +``` + +**正确**: +```bash +# 必传 --tables 显式引用已有表, 含完整字段 schema +TABLES_JSON=$(dacli dm fields --table=tds_leave --json | jq '[{"table":"tds_leave","tableName":"员工请假申请","typeId":"1","fields":.list}]') +dacli form create --fullName="员工请假申请" --enCode=tds_leave \ + --type=1 --webType=2 --dbLinkId=$DBLINK \ + --fields="$FORMDATA_JSON" --tables="$TABLES_JSON" +``` + +**为什么**: form/create.ts 的默认 tables 是兜底空表 (`[{table:enCode, fields:[f_id, f_tenant_id]}]`), 这是给"先 form 后 dm" 的快速 POC 流程用的; 想引用已有表必须显式. 见 [troubleshooting.md 错误 22](troubleshooting.md#错误-22-dacli-form-create-type1-webtype2-不传-tables-时-form-自动建空表). + +--- + +## 1. ❌ 手工拼装 form schema JSON + +**反模式**: +```bash +# AI 想这样: +dacli form create --fields='[{"field":"f_name","jnpfKey":"input"}]' +# ↑ 只传 jnpfKey, 缺 20+ 必填字段 (maxlength/defaultValue/...) +``` + +**正确**: +- 走 `dacli form clone <最相近 baseline id>` 拿完整 schema +- 或 `dacli form info --expand-subtable` 看完整字段集 +- 或用 `dacli form export --out=x.json` 拿完整 JSON + +**为什么**: 53 控件每个有 15-45 字段, 手写 90% 概率缺字段, 后端报 "Database exception"。 + +--- + +## 2. ❌ 默认 `type=1, webType=2` 然后硬建表 + +**反模式**: +```bash +dacli form create --type=1 --webType=2 --autoTable --fields='[...]' +# ↑ 假设 platform 自动建表, 实际 80% 失败 +``` + +**正确**: +- 先 `dacli form list` 看库里有什么表 +- 找相近的 **clone** 过来改 +- 没相近的 → 先 `dacli dm create` 显式建表, 再 `dacli form create` 引用 +- 实在没把握 → `type=4` 视图绕开 + +**为什么**: type=1 需要完整 tables/fields 字段集, 缺一就 "Database exception"。 + +--- + +## 3. ❌ 视图 (type=4) 调 release + +**反模式**: +```bash +dacli form create --type=4 ... # 视图 +dacli form release # 400 "System abnormality" +``` + +**正确**: +```bash +dacli form create --type=4 ... # 视图 +# 不调 release +``` + +**为什么**: 视图直接可用, release 是 type 1/2/3 的流程。 + +--- + +## 4. ❌ 菜单 type=3 忘传 moduleId + +**反模式**: +```bash +dacli menu create --type=3 --fullName="请假" --enCode=leave +# ↑ 缺 moduleId + urlAddress, 后端 400 +``` + +**正确**: +```bash +dacli menu create --type=3 --fullName="请假" --enCode=leave \ + --moduleId= --urlAddress="model/leave" \ + --category=Web --linkTarget=_self +``` + +**为什么**: 表单菜单必传 moduleId (关联表单) + urlAddress (前端路径)。 + +--- + +## 5. ❌ 循环重试失败请求 + +**反模式**: +```bash +# 失败 5 次就 5 次重试 +for i in {1..5}; do + dacli form create ... || dacli form create ... +done +``` + +**正确**: +- 第一次失败 → 查错误 (code/msg/raw) +- 修复参数再试, **不要** 简单重试 +- 后端限流时 `sleep 30` 等恢复 +- 5 次还失败 → 换 web 端手动确认是不是 JNPF 平台问题 + +**为什么**: 错误是确定的 (dbLinkId 错/字段缺), 重试不会成功, 只会触发后端限流。 + +--- + +## 6. ❌ 用 input 文本框代替 relationForm 关联控件 + +**反模式**: +```bash +dacli form create --fields='[ + {"field":"f_user","jnpfKey":"input"} # ❌ 关联字段用 input +]' +``` + +**正确**: +```bash +dacli form create --fields='[ + {"field":"f_user","jnpfKey":"relationForm", "interfaceId":"..."} # ✅ +]' +``` + +**为什么**: relationForm 是 JNPF 平台**专门**做关联的控件, 用 input 替代会失去弹窗搜索/ID 存储/数据回填能力。 + +**CLAUDE.md §6 强约束**: "关联字段必须用 relationForm 组件"。 + +--- + +## 7. ❌ 拿自己刚 clone 的 formId 调 workflow + +**反模式**: +```bash +# 1. 克隆表单 (拿到 clone id) +CLONE_ID=$(dacli form clone --newEnCode=v2 | jq -r '.data.id') +# 2. 立即建工作流, 用原 formId +dacli workflow create --formId=$CLONE_ID ... +# ↑ 实际上 CLONE_ID 是 form 字段, 不是返回 id +``` + +**正确**: +```bash +CLONE_ID=$(dacli form list | jq -r '.data.list[] | select(.enCode=="v2") | .id') +dacli workflow create --formId=$CLONE_ID ... +``` + +**为什么**: `dacli form clone` 的输出格式是 `{code, msg, data: {...}}`, `data` 含 `id/enCode` 但路径要看具体实现。**最稳**是 list 查。 + +--- + +## 8. ❌ 一边调命令一边改 baseline + +**反模式**: +```bash +# 调试 developSystem 的某张表单 +dacli switch-app --appCode=developSystem +dacli form update --enCode=资产 +# ↑ 把 developSystem 的 form 改了, baseline 污染 +``` + +**正确**: +```bash +# baseline 只读, 调试全在 tds / 测试 app +dacli switch-app --appCode=tds +dacli form clone --newEnCode=test +dacli form update --enCode=资产 +``` + +**为什么**: developSystem/workSystem 是 baseline 真值源, 改了 = 0 差错无法复测。 + +--- + +## 9. ❌ 用 `dacli form delete` 清测试数据 (代替 `clear-app`) + +**反模式**: +```bash +# 想清 tds, 跑 +for id in $(dacli form list --appCode=tds | jq -r '.data.list[].id'); do + dacli form delete $id +done +# ↑ 删 100 张表单慢且有依赖问题 +``` + +**正确**: +```bash +dacli clear-app --app-code=tds --dry-run # 先预览 +dacli clear-app --app-code=tds # 实跑 (需 TTY) +# 或只清当前会话 +dacli clear-app --app-code=tds --skip-db # 跳过 DB +``` + +**为什么**: `clear-app` 一键备份 + 清理 (含文件 + pom + yml + DB), `form delete` 是单条操作。 + +--- + +## 10. ❌ 用 try-catch 吞错误 + +**反模式** (在 shell 脚本里): +```bash +dacli form create ... || echo "ignore" # 吞错 +dacli form release ... || echo "ignore" +``` + +**正确**: +```bash +dacli form create ... || { echo "✗ 创建失败: $?"; exit 1; } +dacli form release ... || { echo "✗ 发布失败: $?"; exit 1; } +# baseline 失败立即终止, 不要继续后面的菜单 +``` + +**为什么**: 0 差错要求每步都验证, 吞错 = 0 差错假象。 + +--- + +## 11. ❌ 跳过浏览器验证 + +**反模式**: +```bash +# baseline 脚本只跑 API +dacli form create ... +dacli form release ... +echo "✓ 完成" +# ↑ 没跑 Playwright, 视觉差不知道 +``` + +**正确**: +```bash +dacli form create ... +dacli form release ... +npx playwright test e2e/baseline//.spec.ts # 必跑 +``` + +**为什么**: API 0 错 ≠ 浏览器 0 视觉差。字典/弹窗/列表列等只在 UI 层才暴露。 + +--- + +## 反向链接 + +- [patterns.md](patterns.md) — 正模式 +- [troubleshooting.md](troubleshooting.md) — 排错 +- [commands.md](commands.md) — 命令 diff --git a/.claude/skills/dacli-ts/references/baseline/README.md b/.claude/skills/dacli-ts/references/baseline/README.md new file mode 100644 index 0000000..f2f561d --- /dev/null +++ b/.claude/skills/dacli-ts/references/baseline/README.md @@ -0,0 +1,169 @@ +# baseline README — 官方示例基线 + +> **目的**: 列出 JNPF 自带的官方示例,作为 TS 版 dacli 0 差错验证的真值源 + +## 1. 基线是什么 + +JNPF 部署时自带 2 个应用,里面有大量**官方写的**功能表单、工作流、字典、数据接口: + +| app_code | 表单数 | 工作流数 | 覆盖场景 | +|----------|--------|---------|---------| +| `developSystem` | 21 | 3 | 基础单表、主子表、简单工作流 | +| `workSystem` | 53 | 多个 | 关联、字典、数据接口、复杂流程、报表 | + +**为什么是基线**: +- 平台开发人员写的,schema 100% 正确 +- 涵盖各种 jnpfKey 控件 +- 涵盖各种 type (1/2/3/4) +- 涵盖各种 webType (1/2/3) +- **dacli 复刻这些 = 0 差错 = schema 完美** + +## 2. 0 差错定义 + +复刻一张表单达到 0 差错需要: + +1. **API 0 错** (dacli 层面) + - `dacli form export ` 成功 + - `dacli form import` 成功 + - `dacli form release` 成功 + - 重建后 `dacli form info` 返回字段集与原版一致 + +2. **UI 0 视觉差** (Playwright 层面) + - 重建后浏览器渲染**像素级一致** (允许 1-2 像素抗锯齿) + - 所有字段、按钮、列表列正确显示 + - 字典数据正确加载(下拉框有选项) + - 提交/审批按钮可点击 + +## 3. 复刻流程(每张表单) + +```bash +# 1. 切到 baseline 应用 +dacli switch-app --appCode=developSystem +dacli login --appCode=developSystem + +# 2. 列出所有 form, 找到目标 +dacli form list +# → 假设目标 id=469065268790880645, enCode=leaveApply + +# 3. 导出原表单 JSON +dacli form export 469065268790880645 --out=/tmp/leaveApply-orig.json + +# 4. 切到 tds 应用 +dacli switch-app --appCode=tds +dacli login --appCode=tds + +# 5. 导入到 tds (改 enCode 避免冲突) +dacli form import /tmp/leaveApply-orig.json --enCode=leaveApply_clone + +# 6. 拿克隆 id, 发布 +CLONE_ID=$(dacli form list | jq -r '.data.list[] | select(.enCode=="leaveApply_clone") | .id') +dacli form release $CLONE_ID + +# 7. 浏览器层验证 (Playwright) +npx playwright test e2e/baseline/developSystem/leaveApply.spec.ts +``` + +## 4. 验收脚本模板 + +每个 baseline 表单对应一个 `examples/baseline//.sh`,模板: + +```bash +#!/bin/bash +# examples/baseline/developSystem/leaveApply.sh +# 验证 dacli 复刻 developSystem 应用的 leaveApply 表单达到 0 差错 +set -e + +ORIGINAL_ID="469065268790880645" # 从 developSystem form list 查 +ENCODE="leaveApply" +CLONE_ENCODE="${ENCODE}_clone" + +echo "=== baseline 复刻: developSystem / $ENCODE ===" + +# 1. 切到源 app +dacli switch-app --appCode=developSystem +dacli login --appCode=developSystem + +# 2. 导出原表单 +dacli form export $ORIGINAL_ID --out=/tmp/$ENCODE-orig.json + +# 3. 切到目标 app +dacli switch-app --appCode=tds +dacli login --appCode=tds + +# 4. 导入 +dacli form import /tmp/$ENCODE-orig.json --enCode=$CLONE_ENCODE + +# 5. 拿克隆 id +CLONE_ID=$(dacli form list | jq -r ".data.list[] | select(.enCode==\"$CLONE_ENCODE\") | .id") +echo " 克隆 id: $CLONE_ID" + +# 6. 发布 +dacli form release $CLONE_ID + +# 7. 浏览器层验证 +npx playwright test e2e/baseline/developSystem/$ENCODE.spec.ts + +echo "=== ✓ baseline 复刻 + 0 差错 验证完成 ===" +``` + +## 5. 一键回归 74 张 + +`examples/baseline/all.sh`: + +```bash +#!/bin/bash +# 一键跑 74 张 baseline +set -e + +PASS=0 +FAIL=0 +FAILED_FORMS=() + +for script in examples/baseline/developSystem/*.sh examples/baseline/workSystem/*.sh; do + echo "" + echo "▶ $script" + if bash "$script"; then + PASS=$((PASS+1)) + else + FAIL=$((FAIL+1)) + FAILED_FORMS+=("$script") + fi +done + +echo "" +echo "=== baseline 回归结果 ===" +echo " 通过: $PASS / 74" +echo " 失败: $FAIL" +[ $FAIL -gt 0 ] && echo " 失败列表: ${FAILED_FORMS[@]}" +exit $FAIL +``` + +## 6. 何时重跑 + +| 触发 | 行为 | +|------|------| +| **JNPF 升级** | 一键 `bash examples/baseline/all.sh`, 5 分钟看出 regression | +| **dacli FieldBuilder 改动** | 跑 baseline 验证 schema 兼容性 | +| **新增 baseline 表单** | 写新 .sh + 新 .spec.ts 加进去 | +| **JNPF 厂商发新版本** | 必跑,对比 diff | + +## 7. 不算 0 差错的常见 bug + +按"必查"优先级: + +1. **字段缺失** (e.g. input 缺 `maxlength`) +2. **控件类型错** (select 渲染成 input) +3. **字典空白** (下拉框没选项) +4. **列表列错** (分页/列名错) +5. **工作流节点缺** (流程图节点缺失) +6. **关联控件失败** (relationForm 弹窗空) + +每条都对应 Playwright 的具体断言。 + +## 8. 反向链接 + +- [developSystem 21 张清单](developSystem.md) +- [workSystem 53 张清单](workSystem.md) +- [doc/baseline.md](../../../../doc/baseline.md) — 0 差错验证规范 +- [examples/baseline/all.sh](../../examples/baseline/all.sh) — 一键回归 +- [tests/e2e/baseline/](../../../../tests/e2e/baseline/) — 74 张 Playwright 测试 diff --git a/.claude/skills/dacli-ts/references/baseline/developSystem.md b/.claude/skills/dacli-ts/references/baseline/developSystem.md new file mode 100644 index 0000000..277e6d6 --- /dev/null +++ b/.claude/skills/dacli-ts/references/baseline/developSystem.md @@ -0,0 +1,101 @@ +# developSystem — 21 张官方示例表单清单 + +> **来源**: JNPF 自带 `app_code=developSystem` 应用 +> **总数**: 21 张表单 + 3 个工作流 +> **检索方式**: 创建日期 < 2026-02-01 的表单视为官方示例 +> **dacli 0 差错基线**: 必须全部复刻通过 + +## 1. 21 张表单清单 (按 enCode 排序) + +> **数据来源**: `dacli form list --appCode=developSystem` (在 baseline 脚本生成时自动拉) +> **初始 placeholder 表**: Week 3 D4 跑 `examples/baseline/init-developSystem.sh` 自动填 + +| # | id | enCode | fullName | type | webType | 特色 | baseline 状态 | +|---|----|--------|----------|------|---------|------|----------------| +| 1 | 469065268790880645 | (待定) | (待定) | 1 | 2 | 单表 | ⏳ | +| 2 | 469047177461688709 | (待定) | (待定) | 1 | 2 | 单表 | ⏳ | +| 3 | 469066996185622917 | (待定) | (待定) | 1 | 2 | 单表 | ⏳ | +| 4 | 469102214628043141 | (待定) | (待定) | 1 | 2 | 单表 | ⏳ | +| 5-21 | ... | ... | ... | ... | ... | (待 `init` 脚本跑完填) | ⏳ | + +**注意**: 上面 4 个 id 来自 `goal.txt` 原始记录 (2026-06-10 之前),其他 17 张需 baseline 脚本初始化时拉。 + +## 2. 3 个工作流 + +| # | id | enCode | fullName | formType | 关联表单 id | baseline 状态 | +|---|----|--------|----------|----------|------------|----------------| +| 1 | 585824509966156933 | (待定) | (待定) | 1 | (待定) | ⏳ | +| 2-3 | ... | ... | ... | ... | ... | ⏳ | + +## 3. 覆盖的 jnpfKey 控件 + +21 张表单**预期覆盖**所有 P0/P1/P2 控件 (从 v13.23 migration todo §P0): + +- [ ] input +- [ ] inputNumber +- [ ] textarea +- [ ] datePicker / timePicker +- [ ] select (含字典) +- [ ] radio / checkbox +- [ ] switch +- [ ] uploadFile / uploadImg +- [ ] relationForm +- [ ] popupTable / popupSelect +- [ ] organize +- [ ] userSelect +- [ ] cascader / treeSelect +- [ ] editor +- [ ] (后续 P1/P2 控件) + +## 4. 覆盖的业务模式 + +- [ ] 单表 CRUD (webType=2) +- [ ] 主子表 (webType=2 + 2+ table) +- [ ] 简单工作流 (enableFlow=1) +- [ ] 表单 + 列表 (columnData 完整) +- [ ] 视图 (type=4) + +## 5. 初始化脚本 + +`examples/baseline/init-developSystem.sh` (Week 3 D4 必写): + +```bash +#!/bin/bash +set -e +dacli switch-app --appCode=developSystem +dacli login --appCode=developSystem + +# 拉所有表单 (pageSize=100) +dacli form list --pageSize=100 > /tmp/developSystem-forms.json + +# 拉所有工作流 +dacli workflow list > /tmp/developSystem-workflows.json + +# 提取 21 张 (按 enCode 排序, 创建日期 < 2026-02-01) +node -e " +const fs = require('fs'); +const forms = JSON.parse(fs.readFileSync('/tmp/developSystem-forms.json')); +const official = forms.data.list + .filter(f => f.creatorTime < new Date('2026-02-01').getTime()) + .sort((a, b) => a.enCode.localeCompare(b.enCode)); +console.log(JSON.stringify(official, null, 2)); +" > references/baseline/developSystem.actual.json + +# 生成 21 个 baseline 脚本 +node scripts/gen-baseline-scripts.mjs developSystem + +echo "✓ 21 个 baseline 脚本生成完成" +``` + +## 6. 验收 + +- [ ] 21 张表单**全部**通过 baseline 复刻(API 0 错) +- [ ] 21 张表单**全部**通过 Playwright(浏览器 0 视觉差) +- [ ] 3 个工作流**全部**通过 baseline 复刻 +- [ ] `bash examples/baseline/all.sh` 一次跑通 + +## 7. 反向链接 + +- [workSystem 53 张](workSystem.md) - 进阶示例 +- [baseline README](README.md) - 总览 +- [doc/baseline.md](../../../../doc/baseline.md) - 0 差错规范 diff --git a/.claude/skills/dacli-ts/references/baseline/workSystem.md b/.claude/skills/dacli-ts/references/baseline/workSystem.md new file mode 100644 index 0000000..c0ed6f5 --- /dev/null +++ b/.claude/skills/dacli-ts/references/baseline/workSystem.md @@ -0,0 +1,87 @@ +# workSystem — 53 张官方示例表单清单 + +> **来源**: JNPF 自带 `app_code=workSystem` 应用 +> **总数**: 53 张表单 + 多个工作流 +> **特点**: 复杂业务 (关联、字典、数据接口、复杂流程、报表) +> **dacli 0 差错基线**: 必须全部复刻通过 + +## 1. 53 张表单清单 (按 enCode 排序) + +> **数据来源**: `dacli form list --appCode=workSystem` (在 baseline 脚本生成时自动拉) +> **初始 placeholder 表**: Week 4 D2-D4 跑 `examples/baseline/init-workSystem.sh` 自动填 + +| # | enCode | fullName | type | webType | 特色 | baseline 状态 | +|---|--------|----------|------|---------|------|----------------| +| 1-53 | (待 `init` 脚本跑完填) | ... | ... | ... | ... | ⏳ | + +## 2. 预期覆盖的复杂模式 + +53 张表单**预期覆盖**: + +- [ ] 关联表单 (relationForm 跨表查询) +- [ ] 弹窗选择 (popupTable / popupSelect / popupAttr) +- [ ] 组织架构选择 (organize - 含部门/角色/岗位) +- [ ] 用户选择 (userSelect - 多种 selectType) +- [ ] 富文本 (editor) +- [ ] 级联选择 (cascader / treeSelect) +- [ ] 工作流绑定 (enableFlow=1 + 复杂流程节点) +- [ ] 复杂流程 (分支/并行/会签/委派/退回) +- [ ] 主子表 (webType=2 + 多 table) +- [ ] 联动规则 (字段 A 变 → 字段 B 变) +- [ ] 数据接口联动 (interfaceId 远程搜索) +- [ ] 字典下拉 (dictionaryType) +- [ ] 报表绑定 (button 触发 report) + +## 3. 不在 0 差错范围内的边角功能 + +承认以下**不算 0 差错** (Week 4 评估后): + +| 功能 | 原因 | 兜底 | +|------|------|------| +| JS 增强 (custom onMounted) | 浏览器侧自定义逻辑 | web 兜底 | +| 联动规则 (onChange) | 复杂数据流,v15 schema 不全 | web 兜底 | +| i18n 完整支持 | 仅字段名支持,UI 文案 i18n 不全 | web 兜底 | +| 套打/打印模板 | 独立子系统 | web 兜底 | +| 自定义组件 (用户上传 .vue) | 平台未开放 | web 兜底 | +| 报表大屏 | 独立模块 | 未来扩展 | + +**0 差错 = 主流场景 0 差 + 边角功能承认不覆盖**。 + +## 4. 初始化脚本 + +`examples/baseline/init-workSystem.sh` (Week 4 D2 必写): + +```bash +#!/bin/bash +set -e +dacli switch-app --appCode=workSystem +dacli login --appCode=workSystem + +dacli form list --pageSize=100 > /tmp/workSystem-forms.json +dacli workflow list > /tmp/workSystem-workflows.json + +node -e " +const fs = require('fs'); +const forms = JSON.parse(fs.readFileSync('/tmp/workSystem-forms.json')); +const official = forms.data.list + .filter(f => f.creatorTime < new Date('2026-02-01').getTime()) + .sort((a, b) => a.enCode.localeCompare(b.enCode)); +console.log(JSON.stringify(official, null, 2)); +" > references/baseline/workSystem.actual.json + +node scripts/gen-baseline-scripts.mjs workSystem +echo "✓ 53 个 baseline 脚本生成完成" +``` + +## 5. 验收 + +- [ ] 53 张表单**全部**通过 baseline 复刻 +- [ ] 53 张表单**全部**通过 Playwright (0 视觉差) +- [ ] 工作流**全部**通过 baseline 复刻 +- [ ] 边角功能**显式承认不覆盖** (列在 §3) + +## 6. 反向链接 + +- [developSystem 21 张](developSystem.md) - 基础示例 +- [baseline README](README.md) - 总览 +- [doc/baseline.md](../../../../doc/baseline.md) - 0 差错规范 diff --git a/.claude/skills/dacli-ts/references/commands.md b/.claude/skills/dacli-ts/references/commands.md new file mode 100644 index 0000000..85c5a27 --- /dev/null +++ b/.claude/skills/dacli-ts/references/commands.md @@ -0,0 +1,382 @@ +# commands.md — 完整命令清单 + +> **目标**: AI 拿到本文件即知道 5 父命令的所有子命令、必传参数、典型用法 + +--- + +## ⚠️ v0.1 命令实现状态 (2026-06-12) + +| 命令 | 状态 | 说明 | +|------|------|------| +| login / status / switch-app | ✅ 跑通 | 端到端 OK, 自动检测 dbLinkId | +| form list / info / export / validate | ✅ 跑通 | 只读链路 | +| form create / clone / import | ⚠️ 骨架完整, schema 严校验 | W2 extractor 完成后完整跑通; 当前 AI 应 prefer Java 版 dacli 做 | +| form release / delete | ⚠️ 命令 OK | 依赖 form 已存在 | +| menu / dm / dict / workflow / di / doc / apis | ❌ W2+ 未实现 | 调用报 exit 2 + 提示 | + +**所有命令支持 `--ai-help / --example / --source`**, AI 拿不准时优先跑 `--ai-help`。 + +--- + +## 0. 总览 + +```bash +dacli --version +dacli --help +dacli login --appCode=tds +dacli status [--json] +dacli switch-app --appCode= +``` + +--- +## 1. form (表单) — 10 子命令 + +### 1.1 `dacli form list` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `--keyword` | - | 关键字 (服务器侧匹配) | +| `--state` | - | 过滤 state (0/1) — list 接口不返 state, 仅 form info 有 | +| `--limit` | - | 默认 100, baseline 用 200 | +| `--json` | - | 原始 JSON 输出 | + +**例**: +```bash +dacli form list +dacli form list --limit=200 +dacli form list --json | python3 -c "import json,sys; d=json.load(sys.stdin); print([f['enCode'] for f in d['list']])" +``` + +**返回**: `{total, list: [{id, enCode, fullName, type, enableFlow, isQuote, showName}]}` + +> 注: list 接口字段精简, 详细字段 (state/webType/dbLinkId/tables) 要 `dacli form info ` 才有。 + +### 1.2 `dacli form info ` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `id` (位置) | ✅ | 表单 id | +| `--summary` | - | 只打 id/enCode/state/type/webType/dbLinkId/tables 概要 | + +**例**: +```bash +dacli form info 831606573984911813 +dacli form info 831606573984911813 --summary +``` + +**返回**: 完整 `formData/columnData/appColumnData/tables/flowTemplateJson` 等 (注意都是 JSON 字符串, 不是对象)。 + +### 1.3 `dacli form create` (⚠️ v0.1 schema 严校验, prefer clone) + +| 参数 | 必填 | 说明 | +|------|------|------| +| `--fullName` | ✅ | 中文名 | +| `--enCode` | ✅ | 英文编码 (snake/camelCase) | +| `--type` | - | 默认 4 (视图最稳); 1/2/3/4 | +| `--webType` | - | 默认 1; 1/2/3/4 | +| `--dbLinkId` | - | 默认从 token.dbLinkId | +| `--category` | - | 分类 id (form list 看真实值) | +| `--fields` | - | `formData.fields` JSON 数组 | +| `--tables` | - | `tables` JSON 数组 (type=1/2 必传) | +| `--enableFlow` | - | 0/1, 默认 0 | +| `--flowId` | - | 工作流 id (enableFlow=1 必传) | +| `--autoRelease` | - | 建完立刻发布 (type=4 自动跳过) | +| `--json` | - | 原始 JSON 输出 | + +**例** (type=4 视图, 最简): +```bash +dacli form create --fullName="测试" --enCode=test_view --type=4 --webType=1 +``` + +**已知限制 (v0.1)**: JNPF 后端校验严, type=4 之外的 create 经常 `Database exception`。 +- **AI 工作时**: 先 `dacli form list` 找相近 form → `dacli form clone --newEnCode=...` 克隆 +- W2 提取 web `field-schemas.json` 后, FieldBuilder 自动补全字段, create 各 type 才完整跑通 +- 写操作短期建议走 Java 版 `docs/dacli/ssw-dacli/`(已废弃归档, 需 mvn package 跑 jar) + +### 1.4 `dacli form release ` + +| 参数 | 说明 | +|------|------| +| `id` | 表单 id | +| `--soft` | 发布失败不退出 (type=4 视图必用) | + +发布表单 (state 0→1)。**type=4 视图加 `--soft` 跳过** (会报 400 "System abnormality")。 + +### 1.5 `dacli form delete ` + +| 参数 | 说明 | +|------|------| +| `id` | 表单 id | +| `--yes` | 跳过 TTY 确认 | + +**慎用**, 不可恢复。 + +### 1.6 `dacli form export ` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `id` (位置) | ✅ | 表单 id | +| `--out` | - | 输出文件路径, 默认 `./.json` | + +**例**: +```bash +dacli form export 831606573984911813 --out=/tmp/test.json +``` + +### 1.7 `dacli form import ` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `file` (位置) | ✅ | JSON 路径 | +| `--enCode` | - | 新 enCode (默认 原 +_clone) | +| `--fullName` | - | 新中文名 | +| `--dbLinkId` | - | 新业务库 id (跨应用迁移必传) | +| `--release` | - | 导入后立刻发布 | + +### 1.8 `dacli form clone ` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `id` (位置) | ✅ | 源表单 id | +| `--newEnCode` | - | 新 enCode (默认原 +_clone) | +| `--newFullName` | - | 新中文名 (默认原 +_克隆) | +| `--newDbLinkId` | - | 新业务库 id (跨应用必传) | +| `--release` | - | 克隆后立刻发布 (type=4 自动跳过) | + +**AI 黄金法则**: 99% 应优先 clone 而非 create from scratch。 + +### 1.9 `dacli form validate ` + +| 参数 | 说明 | +|------|------| +| `id` | 表单 id | +| `--json` | 原始 JSON 输出 | + +校验 `columnData.fields[].__config__` 完整性 (缺会浏览器列表白屏)。ERROR → exit 2。 + + +**例**: +```bash +dacli form export 835013439305819013 --out=/tmp/leave.json +``` + +### 1.7 `dacli form import ` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `file` (位置) | ✅ | JSON 文件 | +| `--enCode` | ✅ | 新 enCode (避免冲突) | +| `--fullName` | - | 新中文名 (默认沿用) | +| `--appCode` | - | 目标 app | + +**例**: +```bash +dacli form import /tmp/leave.json --enCode=leave_v2 +``` + +### 1.8 `dacli form clone ` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `id` (位置) | ✅ | 原表单 id | +| `--newEnCode` | ✅ | 新 enCode | + +底层实现: export → import。**比手工 export+import 简单**。 + +### 1.9 `dacli form validate ` + +校验 schema 完整性 (L1: 6 必填字段 + JSON 解析)。失败返回 errors[]。 + +### 1.10 `dacli form fix ` + +修复 schema 缺 `__config__` 的问题 (老 form 兼容)。 + +--- + +## 2. menu (菜单) — 4 子命令 + +### 2.1 `dacli menu list` + +返回当前应用下所有菜单。 + +### 2.2 `dacli menu create` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `--fullName` | ✅ | 菜单名 | +| `--enCode` | ✅ | 菜单编码 | +| `--type` | ✅ | 1=目录 2=页面 3=表单菜单 7=外链 10/8=报表/门户 | +| `--category` | ✅ | 'Web' / 'App' | +| `--linkTarget` | - | '_self' / '_blank' (type=7 必填) | +| `--moduleId` | type=3 ✅ | 关联表单 id | +| `--urlAddress` | - | 路径 (type=3 必填 `model/{enCode}`) | +| `--webType` | - | 表单菜单 1/2/3 (透传表单 webType) | +| `--parentId` | - | 父菜单 id, 顶级 '0' | +| `--isButtonAuthorize` | - | 1=启用按钮权限 | +| `--isColumnAuthorize` | - | 1=启用列权限 | +| `--isFormAuthorize` | - | 1=启用表单权限 | +| `--isDataAuthorize` | - | 1=启用数据权限 | + +**例** (表单菜单, 最常用): +```bash +dacli menu create \ + --fullName="请假菜单" --enCode=leaveMenu --type=3 --category=Web \ + --moduleId= --urlAddress="model/leave" --webType=2 \ + --linkTarget=_self --parentId=0 \ + --isButtonAuthorize=1 --isColumnAuthorize=1 \ + --isFormAuthorize=1 --isDataAuthorize=1 +``` + +### 2.3 `dacli menu update ` + +修改菜单。常用 `--fixDisplay=true` 修"菜单不显示"。 + +### 2.4 `dacli menu delete ` + +删除菜单。慎用。 + +--- + +## 3. dm (数据模型) — 5 子命令 + +### 3.1 `dacli dm list` + +列出所有物理表。 + +### 3.2 `dacli dm table ` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `table` (位置) | ✅ | 表名 | + +返回表结构 + 字段定义。 + +### 3.3 `dacli dm create` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `--table` | ✅ | 表名 (snake_case, 无前缀) | +| `--tableName` | ✅ | 表中文名 | +| `--dbLinkId` | ✅ | 业务库 id | +| `--fields` | ✅ | JSON 数组 | + +**例**: +```bash +dacli dm create \ + --table=leave --tableName="请假" --dbLinkId= \ + --fields='[ + {"field":"f_name","fieldName":"姓名","dataType":"varchar","dataLength":"100","allowNull":0}, + {"field":"f_days","fieldName":"天数","dataType":"int","dataLength":"11","allowNull":0} + ]' +``` + +**自动加**: `f_id` PK + `f_tenant_id` PK + 9 系统列 (f_flow_task_id / f_flow_id / ...) + +### 3.4 `dacli dm update
` + +修改表 (加列 / 改列)。 + +### 3.5 `dacli dm drop
` + +删除表。**慎用**。 + +--- + +## 4. dict (字典) — 4 子命令 + +### 4.1 `dacli dict type-list` + +字典类型列表 (请假类型 / 职级 / 部门 / ...) + +### 4.2 `dacli dict type-create` + +```bash +dacli dict type-create --fullName="请假类型" --enCode=leaveType --type=tree +``` + +### 4.3 `dacli dict data-list --dictionaryTypeId=` + +查某字典类型下的字典数据。 + +### 4.4 `dacli dict data-create` + +```bash +dacli dict data-create \ + --dictionaryTypeId= --fullName="事假" --enCode=personal +``` + +--- + +## 5. workflow (工作流) — 4 子命令 + +### 5.1 `dacli workflow list` + +工作流列表。 + +### 5.2 `dacli workflow create` + +| 参数 | 必填 | 说明 | +|------|------|------| +| `--fullName` | ✅ | 流程名 | +| `--enCode` | ✅ | 流程编码 | +| `--formType` | ✅ | 1=自定义表单 2=系统表单 3=数据接口 4=主子表 | +| `--formId` | ✅ | 关联表单 id | +| `--category` | ✅ | 字典分类 | + +```bash +dacli workflow create \ + --fullName="请假流程" --enCode=leaveFlow --formType=1 --formId= \ + --category= +``` + +### 5.3 `dacli workflow launch ` + +发起流程: +```bash +dacli workflow launch --formData='{"f_name":"张三","f_days":3}' +``` + +### 5.4 `dacli workflow approve ` + +审批: +```bash +dacli workflow approve --opinion=agree +dacli workflow reject --opinion="驳回原因" +``` + +--- + +## 6. doc (HTML 文档缓存) — 5 子命令 + +镜像 Java 版 `dacli doc`。 + +```bash +dacli doc list --dir=docs/tds # 列 HTML 文档 +dacli doc get --file=docs/tds/plan.html # 读全部 +dacli doc get --file=docs/tds/plan.html --section=arch # 读某节 +dacli doc scan --dir=docs/tds # 扫建索引 +dacli doc refresh --dir=docs/tds # 强制刷新 +dacli doc clear --file=docs/tds/plan.html # 删缓存 +``` + +## 7. apis (OpenAPI 查询) — 5 子命令 + +镜像 Java 版 `dacli apis`。 + +```bash +dacli apis list --tag=visualdev # 列接口 +dacli apis list --method=GET --keyword=用户 # 过滤 +dacli apis info "POST /api/visualdev/Base" # 查详情 (含中文字段) +dacli apis search "登录" # 关键字 +dacli apis refresh # 强制刷新 +dacli apis status # 缓存状态 +``` + +--- + +## 8. AI 提示 + +- **每个命令都支持 `--help`**: `dacli form create --help` +- **每个命令支持 `--ai-help`**: 输出可喂给 LLM 的 markdown +- **每个命令支持 `--example`**: 输出 JSON 示例 +- **每个命令支持 `--source`**: 指向 web 源文件 diff --git a/.claude/skills/dacli-ts/references/patterns.md b/.claude/skills/dacli-ts/references/patterns.md new file mode 100644 index 0000000..221117e --- /dev/null +++ b/.claude/skills/dacli-ts/references/patterns.md @@ -0,0 +1,234 @@ +# patterns.md — 5+ 业务模式 (AI 必背) + +> **目标**: AI 接到业务需求时, 按本文件找到对应模式直接套用 + +--- + +## 模式 1: 单表 CRUD (最常见) + +**业务**: 一张表, 字段简单, 无流程 + +**例**: 员工档案 / 资产登记 / 通讯录 + +**dacli 流程**: +```bash +# 1. 拉 baseline (找最相近的克隆) +dacli switch-app --appCode=developSystem +dacli form list --keyword=资产 +# → 找到 id=469065268790880645, enCode=asset + +# 2. 克隆到 tds +dacli switch-app --appCode=tds +dacli form clone 469065268790880645 --newEnCode=myAsset + +# 3. (可选) 改字段名/enCode +# 用 dacli form info 查 schema, 用 PUT 修改 + +# 4. 发布 + 建菜单 +dacli form release +dacli menu create --fullName="资产菜单" --enCode=myAssetMenu \ + --type=3 --category=Web --moduleId= \ + --urlAddress="model/myAsset" --webType=2 \ + --linkTarget=_self --parentId=0 +``` + +**适用场景**: 80% 的简单业务需求 + +--- + +## 模式 2: 主子表 (多表关联) + +**业务**: 一张主表 + N 张子表, 主外键关联 + +**例**: 订单 + 订单明细 / 报销单 + 报销明细 + +**dacli 流程**: +```bash +# 1. 找主子表示例 +dacli form list --appCode=workSystem --keyword=订单 + +# 2. 克隆 (主子表一起) +dacli form clone --newEnCode=myOrder + +# 3. (可选) 用 PUT 改主子表关系 +# dacli form update --tablesJson='[主表 + 子表 + 关联字段]' + +# 4. 发布 + 菜单 +dacli form release +dacli menu create --type=3 --moduleId= --urlAddress="model/myOrder" ... +``` + +**关键字段** (主子表 schema 必含): +- `tables[0].typeId = "1"` (主表) +- `tables[1].typeId = "0"` (子表) +- `tables[1].tableField` = 外键字段 +- `tables[1].relationField` = 关联主键 +- `tables[1].relationTable` = 主表名 + +**易错点**: 子表 `f_id` 必为主键, 但**没有** `f_tenant_id` (只有一个 `f_tenant_id` 在主表) + +--- + +## 模式 3: 工作流表单 (审批流) + +**业务**: 表单 + 流程 (请假/报销/合同审批) + +**例**: 请假申请 → 部门经理 → HR + +**dacli 流程**: +```bash +# 1. 建表单 (同模式 1, 启用 enableFlow) +dacli form create --fullName="请假" --enCode=leave \ + --type=1 --webType=2 --dbLinkId= --category=Form \ + --fields='[请假人/天数/原因/... fields]' \ + --autoTable --autoRelease + +# 2. 建工作流 (关联表单) +dacli workflow create \ + --fullName="请假流程" --enCode=leaveFlow \ + --formType=1 --formId= --category= + +# 3. 配工作流节点 (Java 端可在 design.html 调, TS 端 Week 4 评估) +# - 起始 → 部门经理审批 → HR 审批 → 结束 +# - 配置审批人/条件/消息通知 +# 注: 工作流节点的完整配置目前依赖 web 端, TS 版 v1 只支持创建不含节点的空流程 + +# 4. 绑定到表单 (dacli form update) +# 注: enableFlow 已写在表单上, 工作流 id 通过 form flowId 字段关联 +``` + +**0 差错关键**: 工作流节点的**完整定义**目前 TS 版覆盖率低, 重要项目**走 web 端配置**。 + +--- + +## 模式 4: 表单 + 字典下拉 + +**业务**: 字段值来自字典 (下拉选项 = 字典数据) + +**例**: 资产分类 (字典) / 部门 (字典) / 职级 (字典) + +**dacli 流程**: +```bash +# 1. 建/找字典 +dacli dict type-list --keyword=资产分类 +# → 找到 dictionaryTypeId=xxx, enCode=assetCategory + +# 2. 字典数据已存在 (跳), 否则建 +dacli dict data-create --dictionaryTypeId=xxx \ + --fullName="电子设备" --enCode=electronic + +# 3. 建表单, 字段 jnpfKey=select + dictionaryTypeId=xxx +dacli form create --fields='[ + {"field":"f_category","fieldName":"分类","jnpfKey":"select", + "required":1, "dictionaryTypeId":"xxx"} +]' +``` + +**关键字段**: `__config__.dictionaryTypeId` 或 `dictionaryType` (版本差异) + +--- + +## 模式 5: 数据接口 + 表单 (远程搜索) + +**业务**: 字段值从 API 拉 (下拉选择 = 数据接口) + +**例**: 关联其他业务数据 (按编码搜索) / 远程字典 + +**dacli 流程**: +```bash +# 1. 建数据接口 +dacli di create --fullName="用户查询" --enCode=userQuery \ + --type=1 --category= \ + --sql-query='SELECT id, user_name FROM sys_user WHERE user_name LIKE CONCAT("%", :keyword, "%")' + +# 2. 表单字段引用 +dacli form create --fields='[ + {"field":"f_user_id","fieldName":"用户","jnpfKey":"popupSelect", + "required":1, "interfaceId":""} +]' +``` + +**适用 jnpfKey**: `popupSelect` / `relationForm` / `autoComplete` (视场景选) + +--- + +## 模式 6: 视图 (快速 POC) + +**业务**: 只看数据, 不录入, 不需要物理表 + +**例**: 数据看板 / 报表 / 临时查询 + +**dacli 流程**: +```bash +# 一行命令建视图 +dacli form create --fullName="资产看板" --enCode=assetDashboard \ + --type=4 --webType=1 --dbLinkId= --category=Form +# 注意: type=4 视图不需 --fields +# 注意: type=4 视图不需 --autoTable +# 注意: type=4 视图**不调** release +``` + +**适用场景**: 60% 的"快速出原型"需求 + +--- + +## 模式 7: 批量迁移 (老系统 → tds) + +**业务**: 把 N 张已有表单迁移到新应用 + +**dacli 流程**: +```bash +# 1. 批量 export +for id in $(dacli form list --appCode=oldApp --pageSize=100 | jq -r '.data.list[].id'); do + dacli form export $id --out=/tmp/migration/$(dacli form info $id | jq -r '.data.enCode').json +done + +# 2. 批量 import (改 enCode 加 _migrated 后缀) +for f in /tmp/migration/*.json; do + dacli form import $f --enCode=$(basename $f .json)_migrated --appCode=tds +done + +# 3. 批量 release +for id in $(dacli form list --appCode=tds --pageSize=100 | jq -r '.data.list[] | select(.enCode | endswith("_migrated")) | .id'); do + dacli form release $id +done + +# 4. 批量建菜单 (Web 类别) +for form in $(dacli form list --appCode=tds --pageSize=100 | jq -r '.data.list[] | select(.enCode | endswith("_migrated")) | "\(.id)|\(.enCode)"'); do + id=$(echo $form | cut -d'|' -f1) + encode=$(echo $form | cut -d'|' -f2) + dacli menu create --fullName="$encode 菜单" --enCode="${encode}_menu" \ + --type=3 --category=Web --moduleId=$id --urlAddress="model/${encode%_migrated}" \ + --webType=2 --linkTarget=_self --parentId=0 +done +``` + +**适用场景**: 应用迁移 / 多环境同步 + +--- + +## 模式选择决策树 + +``` +用户说"建 XX" +├─ XX 是单表? +│ └─ YES → 模式 1 +├─ XX 是主子表? +│ └─ YES → 模式 2 +├─ XX 有审批流? +│ └─ YES → 模式 3 +├─ XX 字段值是字典/接口? +│ └─ YES → 模式 4 或 5 +├─ XX 是临时查询/POC? +│ └─ YES → 模式 6 +└─ XX 是老系统迁移? + └─ YES → 模式 7 +``` + +--- + +## 反向链接 + +- [commands.md](commands.md) — 完整命令清单 +- [anti-patterns.md](anti-patterns.md) — 8+ 反模式 +- [troubleshooting.md](troubleshooting.md) — 排错 diff --git a/.claude/skills/dacli-ts/references/playwright.md b/.claude/skills/dacli-ts/references/playwright.md new file mode 100644 index 0000000..871575c --- /dev/null +++ b/.claude/skills/dacli-ts/references/playwright.md @@ -0,0 +1,151 @@ +# playwright.md — Playwright Node.js 使用指南 (基础设施) + +> **目标**: AI 理解 Playwright 在 dacli 里的角色, 写 baseline / 浏览器层验证测试 +> **v0.6 更新 (2026-06-12)**: 内化 ssw-e2e-test 真路径 + Playwright projects.setup 会话复用 + +--- + +## 1. 为什么 Playwright 是基础设施 + +| 验证层 | 工具 | 检查什么 | +|--------|------|----------| +| **API 层** | dacli CLI (vitest + 集成测试) | HTTP 200 / 字段集一致 / 校验通过 | +| **UI 层** | **Playwright Node.js** | 浏览器渲染 0 视觉差 / 字段可点击 / 数据加载 | + +**0 差错 = API 0 错 + UI 0 视觉差**。少任一层都不算 0 差。 +经验源: `docs/aibridge/.claude/skills/ssw-e2e-test/` (Python 版生产工具, 套路 1:1 移植到 Node)。 + +--- + +## 2. ⭐ JNPF 真实 URL 路径 (v0.6 ssw-e2e-test 验证) + +### 2.1 应用级入口 (每个 app 独立) + +| 路径 | 含义 | +|------|------| +| `http://nginx/jnpf_app_/login` | 登录页 (每个 app 独立, **真路径**) | +| `http://nginx/jnpf_app_/home` | 首页 (登录后自动跳, 有 nav) | +| `http://nginx/jnpf_app_/model/` | **真业务页** (能 CRUD 保存) | +| `http://nginx/jnpf_app_/previewModel?isPreview=1&id=` | **预览页** (只读, 不能保存!) | +| `http://nginx/web/#/login` | 通用登录页 (admin 默认 home 无菜单 → 404, 不推荐) | + +**关键**: prompt §1.4 + §5 写 `/jnpf_app_workSystem/model/xxx`, 实际**只有挂了菜单的 form 才能走这路径**. + +### 2.2 登录字段 ID (jnpf 稳定契约) + +来自 `ssw-e2e-test/scripts/jnpf_client.py:65-68`: + +```typescript +await page.fill('#form_item_account', 'admin') +await page.fill('#form_item_password', '123456') +await page.click('button:has-text("登 录")') // "登"和"录"中间有空格 +await page.waitForURL('**/home**', { timeout: 15_000 }) +``` + +这 4 个选择器是 jnpf 平台稳定契约, 多版本不变. + +### 2.3 admin 默认看不到首页 → 必用 jnpf_app_X 入口 + +- `preferences.app.defaultHomePath` 在 admin 用户的 workSystem/developSystem 下**没绑菜单** +- 直接访问 `/web/#/login` 登录后跳 home → 404 +- **正确**: 每次都用 `/jnpf_app_/login` 进 + +### 2.4 至少一个菜单挂表单, /model/X 才生效 (用户校准 2026-06-12) + +JNPF 平台核心规则: **vue-router 是基于动态菜单注册的**. +- form 创建后 → 不挂菜单 → `/model/` 必然 404 +- form 挂菜单 + admin 角色授权 → 重登/F5 → vue-router 注册 → `/model/` work +- 用 `dacli menu create --formId=` (走 web 真路径 POST /api/visualdev/Base/{id}/Actions/Module) + +--- + +## 3. ⭐ 浏览器会话复用 (v0.6 storageState 模式) + +### 3.1 配置 (playwright.config.ts) + +```typescript +import { defineConfig } from '@playwright/test' +import { existsSync } from 'node:fs' + +const AUTH_FILE = '.auth/admin.json' + +export default defineConfig({ + testDir: './tests/e2e', + projects: [ + { name: 'setup', testMatch: /.*\.setup\.ts/ }, + { + name: 'chromium', + use: { + browserName: 'chromium', + ...(existsSync(AUTH_FILE) ? { storageState: AUTH_FILE } : {}), + }, + testIgnore: /.*\.setup\.ts/, + dependencies: ['setup'], + }, + ], +}) +``` + +### 3.2 setup project (UI 登录一次, TTL 6h) + +`tests/e2e/auth.setup.ts`: + +```typescript +import { test as setup, expect } from '@playwright/test' +import { isAuthFresh, loginAsAdmin, AUTH_FILE } from './_helpers/auth' + +setup('authenticate as admin/123456 @ tds', async ({ page }) => { + if (isAuthFresh()) return // 6h 内复用, 不重登 + const ok = await loginAsAdmin(page, { appCode: 'tds' }) + expect(ok).toBe(true) + await page.context().storageState({ path: AUTH_FILE }) +}) +``` + +### 3.3 业务 spec 自动复用 — 不需要写登录 + +```typescript +test('打开某业务页', async ({ page }) => { + await page.goto('/jnpf_app_tds/model/yuangongpx_ws') // 直接进, 已是登录态 +}) +``` + +### 3.4 反例: 测登录页本身, 用空 storageState + +```typescript +test('登录页能渲染', async ({ browser }) => { + const context = await browser.newContext({ storageState: { cookies: [], origins: [] } }) + const page = await context.newPage() + try { + await page.goto +('/web/#/login') + await expect(page.locator('#form_item_account')).toBeVisible() + } finally { + await context.close() + } +}) +``` + +--- + +## 4. JNPF 特有 DOM 选择器 (来自 ssw-e2e-test) + +| 用途 | 正确 selector | +|------|--------------| +| 列表行 | `.vxe-body--row` (不是 ant-table) | +| 列表头 | `.vxe-header--column, .vxe-table--header .vxe-cell` | +| 菜单项 | `.jnpf-menu-item:has-text("X")` (flat 不嵌套) | +| ant-modal | `.ant-modal` 关闭按钮 "关 闭" / "取 消" (有空格) | +| hidden click | `await page.evaluate((el) => el.click(), handle)` | + +## 5. 已知坑 (v0.6 实战踩过) + +| 坑 | 解 | +|----|-----| +| /web/#/login 登录后 404 | 用 /jnpf_app_X/login 进 | +| dacli token 注入浏览器 | Vben 加密 storage, 走 UI 登录 + storageState | +| /model/X 报"该表单已删除" | form import 没建表 → dm create 先建表 / form create --autoTable / AI 重建 (#13) | +| /previewModel 不能保存 | 只读模式, 必须挂菜单走 /model/X 真路径 | +| menu DELETE 报 System abnormality | menu unrelease (Actions/Module pc=0 app=0) | + +**v0.6 配套**: ssw-e2e-test (Python 版生产工具), tests/e2e/baseline/{workSystem,developSystem}/regression.spec.ts diff --git a/.claude/skills/dacli-ts/references/troubleshooting.md b/.claude/skills/dacli-ts/references/troubleshooting.md new file mode 100644 index 0000000..ed71308 --- /dev/null +++ b/.claude/skills/dacli-ts/references/troubleshooting.md @@ -0,0 +1,443 @@ +# troubleshooting.md — 8+ 排错指南 (AI 必看) + +> **目标**: 报错时, 按本文件快速定位 + 修复 + +--- + +## 错误 1: `Login expired, please log in again` (code 600) + +**症状**: +```json +{"code": 600, "msg": "Login expired, please log in again", "data": null} +``` + +**原因**: +- token 过期 (7 天) 或后端限流 +- 请求 URL 错误 (如 `/api/api/...` 重复) + +**排查**: +```bash +# 1. 看 baseUrl +dacli status +# 期望: API: http://127.0.0.1:13880/api (一个 /api) + +# 2. curl 直测 (绕过 dacli) +curl -X POST "http://127.0.0.1:13880/api/oauth/Login" \ + -H "Content-Type: application/x-www-form-urlencoded" \ + --data-urlencode "account=admin" \ + --data-urlencode "password=<加密后密码>" \ + --data-urlencode "origin=hash" \ + --data-urlencode "grant_type=password" \ + --data-urlencode "timestamp=0" +``` + +**修复**: +- 限流 → `sleep 30` 等恢复 +- URL 重复 → 检查 path 是否含 `/api` (应不含) +- token 过期 → `dacli login --appCode=tds` 重新登录 + +--- + +## 错误 2: `Database exception, please contact the administrator` + +**症状**: form create 返回 400, "Database exception" + +**原因**: +- `dbLinkId='0'` 错 (前端兜底, 实际是业务库 id) +- `tables[].fields[]` 字段缺 (autoIncrement/identity/columnName 等) +- `category='0'` 错 (实际是 'Form' 等) + +**排查**: +```bash +# 1. 拿真实 dbLinkId +dacli status +# 或: curl /api/system/DataSource + +# 2. 看已有 form 的 category +dacli form list | jq -r '.data.list[0] | {enCode, dbLinkId, category}' + +# 3. 看 tds_asset 的完整 tables 结构 (作为基准) +dacli form info 835013439305819013 | jq '.data.tables' +``` + +**修复**: +- dbLinkId 错 → 从 `/api/system/DataSource` 拉 +- category 错 → 从已有 form list 取 +- tables 字段缺 → 用 `dacli form clone ` 拿完整 schema +- 都失败 → 改用 `type=4` 视图绕开 + +--- + +## 错误 3: `System abnormality` (release 失败) + +**症状**: +```json +{"code": 400, "msg": "System abnormality", "data": null} +``` + +**原因**: form 是 `type=4` 视图, release 报 400 + +**修复**: +```bash +# 跳过 release +dacli form create --type=4 ... +# 不调 dacli form release +``` + +--- + +## 错误 4: 菜单创建成功但 `menuId` 为空 + +**症状**: 我的脚本读 `r.data.id` 失败, 因为响应是 `{code:200, msg:"..."}` 无 data + +**原因**: JNPF 菜单 API 响应**无 data 字段** (用 list 兜底) + +**修复**: +```bash +# 1. 拿创建的 enCode +# 2. 用 list 反查 id +CLONE_ID=$(dacli form list | jq -r '.data.list[] | select(.enCode=="") | .id') +``` + +--- + +## 错误 5: `enCode 格式不合规` + +**症状**: 后端 400, "enCode 已存在" 或 "enCode 格式错误" + +**原因**: enCode 不符合 `^[a-z0-9](([a-z0-9])*|(([a-z0-9]+|\.)*[a-z0-9]))$/i` + +**修复**: +- 全小写英文 + 数字 + 小数点 +- 不能以小数点开头/结尾 +- 例: `leave`, `leave_v2`, `tds.asset` ✓ +- 反例: `Leave`, `_leave`, `leave-` ✗ + +--- + +## 错误 6: `relationForm 弹窗空白` + +**症状**: 浏览器打开, 关联字段点开弹窗, 没数据 + +**原因**: +- `interfaceId` 错 (数据接口 id 不对) +- `relationField` 配置错 +- 关联的 form 没发布 + +**修复**: +```bash +# 1. 查数据接口列表 +dacli di list + +# 2. 验证 interfaceId 存在 +dacli di info + +# 3. 确保关联 form 已发布 +dacli form list | jq '.data.list[] | select(.enCode=="<关联form>") | .state' +# state=1 已发布, state=0 未发布 +``` + +--- + +## 错误 7: Playwright 浏览器超时 + +**症状**: +``` +TimeoutError: page.goto: Timeout 30000ms exceeded +``` + +**原因**: +- nginx 容器不通 +- JNPF 后端 hang 死 (API 线程池被占满) +- 浏览器没装 + +**修复**: +```bash +# 1. 检查 nginx / backend +curl -s -o /dev/null -w "%{http_code}\n" --max-time 5 http://127.0.0.1:13880/ + +# 2. 后端 hang 时, 等 30s 重试 +sleep 30 + +# 3. 装浏览器 +npx playwright install chromium + +# 4. 改用 developSystem 兜底 (不走 tds) +PLAYWRIGHT_TARGET=developSystem npx playwright test +``` + +--- + +## 错误 8: 后端 API hang 死 (curl timeout) + +**症状**: +``` +curl: (28) Operation timed out after 10000 milliseconds +``` + +**原因**: +- 之前失败请求把 API 线程池占满 +- 多次重试没间隔 + +**修复**: +```bash +# 等 30s+ 后端恢复 +sleep 30 +curl -s -o /dev/null -w "%{http_code}\n" --max-time 5 http://127.0.0.1:13880/api + +# 一次只跑一个命令, 不并发 +``` + +--- + +## 错误 9: Playwright 找不到元素 + +**症状**: +``` +Error: locator('button:has-text("提交")').toStrictEqual: expected 1, got 0 +``` + +**原因**: +- 页面没加载完 (`networkidle` 没等) +- 选择器不对 +- 表单没发布 / 没菜单 + +**修复**: +```typescript +// 加 waitForLoadState +await page.goto(URL) +await page.waitForLoadState('networkidle') // ← 关键 + +// 调试: 截图看实际页面 +await page.screenshot({ path: 'debug.png', fullPage: true }) + +// 用更稳的选择器 +await page.locator('button[type="primary"]').first().click() +``` + +--- + +## 错误 10: baseline 找不到 enCode + +**症状**: `dacli form list` 没找到想要的 enCode + +**原因**: +- 切错 app (没 `switch-app`) +- enCode 真的不存在 + +**修复**: +```bash +# 看当前 app +dacli status +# → 显示当前 app_code + +# 切到正确 app +dacli switch-app --appCode=developSystem + +# 列所有 +dacli form list --pageSize=100 +``` + +--- + +## 错误 11: `cloning 失败` (form clone 报 400) + +**症状**: `dacli form clone --newEnCode=v2` 返回 400 + +**原因**: +- `` 不存在 +- `--newEnCode` 已被占用 +- 网络问题 + +**修复**: +```bash +# 1. 验证原 id 存在 +dacli form info + +# 2. 验证 newEnCode 没占用 +dacli form list | jq -r '.data.list[] | select(.enCode=="v2") | .id' +# 期望: 没结果 + +# 3. 改用 export + import +dacli form export --out=/tmp/v2.json +dacli form import /tmp/v2.json --enCode=v2 +``` + +--- + +## 通用排错流程 + +```bash +# 1. 看状态 +dacli status + +# 2. 拿 raw 错误 (含 code/msg/data) +# dacli form create ... 2>&1 | head -50 + +# 3. curl 直测 (绕开 dacli) +curl -X POST "$BASE/api/..." -H "Authorization: $TOKEN" -d '...' + +# 4. 查本文错误 1-11 + +# 5. 找最相近的 baseline 调试 +dacli form clone --newEnCode=test_debug + +# 6. 都失败 → 浏览器手动确认是不是 JNPF 平台问题 +``` + +--- + +## 反向链接 + +- [commands.md](commands.md) — 命令 +- [patterns.md](patterns.md) — 业务模式 +- [anti-patterns.md](anti-patterns.md) — 反模式 +- [baseline/README.md](baseline/README.md) — 0 差错验证 + +--- + +## v0.6 新增坑 (2026-06-12 实战) + +### 错误 12: dacli form list 数字偏少 (workSystem 报 52 实际 85) + +**症状**: `dacli form list` workSystem 报 52 张, 但 web 端看 85 张, baseline 数对不上. + +**根因**: v0.5 list.ts 调 `/visualdev/Base/list` 子端点 — 后端强制 `setEnableFlow(1)` → 只返工作流 form 子集. +正确端点是 `/visualdev/Base` (公开方法, 返当前 systemId 全部 form). + +**解**: v0.6 已修. 升级 dacli 后跑 `dacli form list --limit=200 --json | jq '.list | length'` 验真总数. + +--- + +### 错误 13: form import 报"成功"但浏览器报"该表单已删除" + +**症状**: `dacli form import ws.json --enCode=X` 报"导入成功 id=XXX", 但访问 `/jnpf_app_tds/model/X` 弹"系统异常 该表单已删除". + +**根因**: import 只复制 form 元数据 (formData/columnData/tables 描述), **没在目标 dbLink 建底层物理表**. tables[].table 仍指 workSystem 原表名 (mt62416...), tds 业务库找不到. + +**解**: +1. 短期: 用 `dacli dm create` 按 tables[].fields 描述先建物理表, 再 import (改 tables[].table) +2. 长期: 用 `dacli form create --autoTable`, 后端自动建表 +3. 真验证: 走 #13 AI 需求驱动重建 (不机械 import) + +--- + +### 错误 14: dacli menu delete 报 "System abnormality" + +**症状**: `dacli menu delete --id=X --yes` → `code=400 System abnormality`. + +**根因**: 已挂 form 的菜单 (Actions/Module 创的, pcIsRelease=1) DELETE /api/system/Menu/{id} 不工作 (后端做关联校验). + +**解**: v0.6 加 `dacli menu unrelease --formId=` (走 POST Actions/Module pc=0 app=0 - 返"Synchronization successful"). 然后 form 也可以删了. + +--- + +### 错误 15: /jnpf_app_X/model/X 报 404 + +**症状**: dacli form create + release 成功, 访问 `/jnpf_app_tds/model/X` 报 "哎呀, 未找到页面". + +**根因**: JNPF vue-router 是**基于动态菜单注册**的. 不挂菜单 → router 不注册 → 必然 404. + +**解**: `dacli menu create --fullName="X" --formId=` (默认走 web 真路径 Actions/Module, 自动给 admin 角色授权). 重登/F5 后 `/model/X` 才 work. + +--- + +### 错误 16: /web/#/login 登录后 home 是 404 + +**症状**: Playwright 用 admin/123456 登录 `/web/#/login` 成功 (storage 写了 token), 但跳转后页面 404. + +**根因**: `preferences.app.defaultHomePath` 在 admin 默认 home 没绑菜单 (admin 在 workSystem/developSystem 没自定义首页). + +**解**: 用 `/jnpf_app_/login` (每 app 独立入口), 登录后自动跳 `/jnpf_app_/home` (有 nav). + +--- + +### 错误 17: Playwright 每个 spec 重登慢 + +**症状**: 浏览器 spec 每个 test 都要 admin/123456 输入 click 登录, 一个 spec 5s+. + +**解**: Playwright `projects.setup` 模式: setup project 跑一次 UI 登录, `page.context().storageState({path: '.auth/admin.json'})`, chromium project `use.storageState` 自动复用. TTL 6h (远短于 dacli 7 天 token). + +详见 [playwright.md §3](playwright.md#3-浏览器会话复用-v06-storagestate-模式). + +--- + +## v0.7 新增坑 (2026-06-12 subagent 实战发现, 已固化到 dacli 源码) + +### 错误 18: dacli dm create 报 `Cannot invoke DbFieldForm.getPrimaryKey() because returns null` + +**症状**: `dacli dm create --table=X --fields='[...]'` 报 400 `Cannot invoke "java.lang.Integer.intValue()" because the return value of "jnpf.base.model.dbtable.form.DbFieldForm.getPrimaryKey()" is null`. + +**根因**: +1. 用户传的 fields 没显式 `primaryKey: 0` → jackson 反序列化成 `null` → `intValue()` NPE +2. dacli sysCols (9 系统列 + f_id/f_tenant_id) 默认对象也漏 `primaryKey` 字段 + +**解**: v0.7 已修. `dm/create.ts` userFields + sysCols 都自动补 `primaryKey: 0` (PK 列补 1). + +--- + +### 错误 19: dacli dm fields 报字段数=0 但表已建 + +**症状**: `dacli dm create` 成功, `dm list` 看到表, 但 `dacli dm fields --table=X` 报 `字段数=0`. + +**根因**: 后端响应 shape 是 `{ list: [...] }`, dacli v0.6 解析的是 `{ fields: [...] }` → 拿不到. + +**解**: v0.7 已修. `dm/fields.ts` parse 函数兼容 `list / fields / array` 三形态. + +注: 也可以加 `--dbLinkId=` (不传时从 token 取). 老 form 的 dbLinkId 可能下线 (e.g. 2056521674462703616), 那种情况查不到是数据问题, 不是 bug. + +--- + +### 错误 20: dacli form release 报"成功"但 state 没变 + +**症状**: `dacli form release ` 返 `code=200`, 但 `dacli form info ` 看 `state=0` 仍未发布. + +**根因**: v0.6 走 `PUT /api/visualdev/Base/{id}/Actions/State` — 这个端点存在但**不做发布**, 只是更新 sortCode 之类. + +真发布端点: `POST /api/visualdev/Base/{id}/Actions/Release` (查 `dacli apis info` 或看 `web/api/onlineDev/visualDev.ts:43 release`). + +**解**: v0.7 已修. `form/release.ts` + `form/create.ts` + `form/import.ts` + `form/clone.ts` 全部改成 `POST /Actions/Release`. + +--- + +### 错误 21: dacli menu create --formId=X 报 `System abnormality` + +**症状**: `dacli menu create --fullName="X" --formId=` 走 web 真路径 POST `/visualdev/Base/{id}/Actions/Module` 报 `code=400 System abnormality`. + +**根因**: 不明确. 推测原因: +- 该 form 的 propertyJson / dbLinkId 配置在某些 web 配置下走不通 +- 或后端校验 form 的 `urlAddress / interfaceUrl` 必须为空 (`Actions/Module` 假设是新挂菜单) +- tds 业务库 form 比 workSystem/developSystem 少一些初始化 + +**解**: 走低级 `POST /system/Menu` fallback (v0.6 命令已支持): + +```bash +dacli menu create --fullName="员工请假申请" --enCode=tds_leave_menu \ + --type=3 --urlAddress="model/tds_leave" --parentId=0 +# → 不传 --formId 走低级路径, 100% 工作 +``` + +低级路径建出来的菜单 `urlAddress=model/` 同样能触发 `/jnpf_app_/model/` 真业务 (vue-router 动态注册). + +--- + +### 错误 22: dacli form create type=1 webType=2 不传 --tables 时 form 自动建空表 + +**症状**: 已先 `dm create` 建好物理表 `tds_leave`, 然后 `dacli form create --type=1 --webType=2 --enCode=tds_leave` 不传 `--tables`, form 创建成功但**新建了一个空表 `tds_leave_clone` 之类**, 没引用已建好的 `tds_leave`. + +**根因**: `form/create.ts` 默认 `tables = [{table: enCode, ..., fields: [f_id, f_tenant_id]}]` — type=1/2 时强制注入最小主表. + +**解**: +1. **必传 `--tables` 显式引用已有表**: +```bash +dacli form create --type=1 --webType=2 --enCode=tds_leave --tables='[{ + "table": "tds_leave", "tableName": "员工请假申请", "typeId": "1", + "fields": [全部 19 列 schema...] +}]' +``` +2. 或先 `dacli dm fields --table=tds_leave --json` 拿字段 schema, 拼到 --tables +3. 或干脆 `dacli form clone --newEnCode=tds_leave_v2`, 比从零搭省字段拼装功夫 + +**反模式**: type=1 webType=2 期望 form create 自动用已有表 → 后端不会, 必须显式传. + + diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..b2871cc --- /dev/null +++ b/.gitignore @@ -0,0 +1,14 @@ +node_modules/ +.dacli-cache.db +.dacli-cache.db-* +.dacli-token/ +screenshots/ +test-results/ +playwright-report/ +.env.local +*.log +src/data/*.json +!src/data/.gitkeep + +# Playwright auth state +.auth/ diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..84403b7 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,125 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## 项目定位 + +`dacli`(TS 版)是 JNPF 低代码平台的命令行工具,**当前主用 CLI**。Java 版(`boot/ssw-dacli/`,已废弃)源码归档在 `../docs/dacli/ssw-dacli/` 备查。本项目从 JNPF web 源码直接提取控件 schema + FieldBuilder,避免 53 个手写 builder 的维护成本。 + +**核心目标**: 复刻 JNPF 官方示例 (workSystem 85 + developSystem 29 = **114 张 baseline**) 到 **API 0 错 + 浏览器 0 视觉差**。 + +详细设计: `doc/architecture.md` (6 个关键决策)、`doc/plan.md` (6 周路线)、`doc/v0.7-changelog.md` (最新校准)。 + +## 启动 & 常用命令 + +```bash +cd $ccWorkDir/dacli +npm install # 装依赖 +npx playwright install chromium # 装浏览器 (baseline E2E 用) + +# CLI 调用 +npx tsx src/cli.ts --help # 入口 (启动 < 500ms) +npx tsx src/cli.ts login --appCode=tds # 登录 +npx tsx src/cli.ts form list # 列已有表单 + +# 提取 web 源码到 src/data/*.json +node scripts/extract-all.mjs +``` + +**包脚本** (npm run ...): +- `dacli` — `tsx src/cli.ts` (CLI 等价) +- `test` — `vitest run` (单测) +- `test:e2e` — `playwright test` (E2E) +- `extract` — `tsx scripts/extract-all.mjs` (web 资产提取) +- `typecheck` — `tsc --noEmit` (TS 校验) + +## 架构 + +### 入口 → 命令分发 + +``` +src/cli.ts # Commander.js 入口, 顶层注册 8 父命令 +└── commands/ + ├── form/ index.ts + list/info/create/release/delete/export/import/clone/validate + ├── dm/ list/create/drop/fields (物理表 CRUD) + ├── dict/ type-list/data-list (字典) + ├── menu/ list/create/delete/unrelease + ├── di/ list (数据接口) + ├── workflow/ list/launch/approve (Flowable) + ├── doc/ list (HTML 文档扫描) + └── apis/ list (JNPF /v3/api-docs 缓存) +``` + +每个父命令 `index.ts` 用 `new Command('xxx')` 构造,链式 addCommand 子命令。**所有命令必带 3 个 flag**: +- `--ai-help` — 拦截输出 markdown 用法(`core/help.ts:maybeInterceptAiHelp`) +- `--example` — 真实可跑示例 +- `--source` — 链接到源 web 代码位置 + +### 核心模块 (`src/core/`) + +| 文件 | 职责 | +|------|------| +| `cli.ts` | 顶层 `DacliError` + 主循环 + 错误退出码 | +| `config.ts` | token / baseUrl / appCode 持久化(路径: cwd 下 `.dacli-token/token.json`,与 Java 版兼容) | +| `crypto.ts` | 1:1 复刻 `web/.../cipher.ts` 加密(crypto-js 字节级一致) | +| `log.ts` | 统一输出(带 ANSI 颜色,**注意**: Python 解析时必须 strip 颜色码) | +| `help.ts` | `maybeInterceptAiHelp` — 在 Commander parse 之前拦截 `--ai-help` | +| `types.ts` | 共享 TS 类型 + `DacliError` 类 | + +### 数据流 + +``` +.env / 配置文件 + ↓ +config.ts 读 .dacli-token/token.json + ↓ +core/kit.ts (JNPF API 调用 + 错误处理) + ↓ +commands//.ts + ↓ +output (JSON / table / --ai-help markdown) +``` + +### 缓存层 + +- **Token**: `$ccWorkDir/.dacli-token/token.json`(7 天有效,**不是** `~/.dacli/`) +- **APIs 缓存**: `~/.dacli/cache.db` (SQLite) — JNPF `/v3/api-docs` 拉 1000+ API + schema +- **Dacli 缓存**: `.dacli-cache.db` (项目根) + +### 0 差错基线验证 + +`tests/e2e/baseline/` 跑 114 张官方示例 (workSystem/developSystem),分两层: +- **API 0 错**: vitest + dacli 命令串行执行 +- **UI 0 视觉差**: Playwright 截图 + `pixelmatch` 像素对比 + +一键脚本: `.claude/skills/dacli-ts/examples/baseline/all.sh`(设 `SKIP_PLAYWRIGHT=1` 仅跑 API)。 + +## 关键设计约束 + +### TS 编译配置 (`tsconfig.json`) +- `target: ES2022`, `module: ES2022`, `moduleResolution: bundler` +- `noEmit: true`(用 tsx 跑,不编译) +- `allowImportingTsExtensions: true`(`.ts` 后缀 import) +- `strict: true` + +### FieldBuilder 自动加载 +**不要**手写 schema。`src/schema/FieldBuilder.ts` 从 `src/data/field-schemas.json`(vue SFC 提取产物)动态加载。schema 升级靠重跑 `node scripts/extract-all.mjs`。 + +### AI 能力闭环 +`.claude/skills/dacli-ts/SKILL.md` 是**配套技能**,不读它就不知道何时用哪个命令。**两者缺一不可**。 + +## 子项目 skill + +- `.claude/skills/dacli-ts/SKILL.md` — 主技能(v0.7 校准:form release 改 `/Actions/Release` 端点、dm create 改 web 真路径 `dataModel/Form.vue:218` 形态、menu create 退到低级 API 兜底等) +- `.claude/skills/dacli-ts/references/` — 6+ 专题文档(commands、playwright、troubleshooting、extraction 等) +- `.claude/skills/dacli-ts/examples/` — 7+ 可复用脚本(baseline、create-simple-form、菜单挂载等) + +## 父项目约定 + +本项目从属于 `$ccWorkDir/`(含 JNPF 后端、前端、平台源码)。父项目规则: +- 凭据 `admin` / `123456`,JNPF API 入口 `http://127.0.0.1:30000`(容器内 `http://nginx/`) +- 表名 `snake_case` 无前缀,字段 `f_` 前缀(`f_version` 系统关键字禁用) +- 修改范围: 仅本项目文件 + `.claude/`;**禁止** 改 `jnpf/` `web/` `uniapp/` +- 父项目有 git hooks (auto-push),本项目 `dacli/` **无独立 git 仓库**(`.claude/.git` 只跟踪 `.claude/`) + +完整规则见 `$ccWorkDir/.claude/CLAUDE.md`。 diff --git a/README.md b/README.md new file mode 100644 index 0000000..0443335 --- /dev/null +++ b/README.md @@ -0,0 +1,154 @@ +# dacli — TS 版 dacli (当前主用) + +> **位置**: `$ccWorkDir/dacli/`(原 `test/dacli/`, 2026-06-12 升级到顶层独立项目) +> **目标**: TypeScript 重写 dacli,**直接复用 JNPF web 源码** + **0 差错验证** +> **状态**: v0.7 (8 父命令 / 26+ 子命令,启动 < 500ms) +> **总目标**: workSystem 85 + developSystem 29 = **114 张官方示例 API 0 错 + 浏览器 0 视觉差** + +## 这是什么 + +`dacli` 是 JNPF 平台的 CLI 工具,让 AI/开发者用命令行**代替**浏览器拖拽,自动化配置 JNPF 平台。 + +**Java 版** (`docs/dacli/ssw-dacli/`) 已**废弃**,源码归档备查(无 `target/`,需手动 `mvn package` 跑 jar)。 + +**TS 版** (本项目) 是当前**主用** CLI: + +1. **直接复用 web 源码** — 30 分钟跑 extract 脚本拿 53 控件 schema, 不手抄 +2. **Playwright Node.js 集成** — `@playwright/test` 与 dacli 同进程, 0 视觉差验证 +3. **AI 友好帮助体系** — `--ai-help` 输出 markdown, `SKILL.md` 教 AI 何时用 + +## 两件套交付 + +| 交付物 | 位置 | 用途 | +|--------|------|------| +| **`dacli` CLI 工具** | `src/` | 给 AI/开发者用, 执行命令 | +| **`.claude/skills/dacli-ts/SKILL.md`** | `.claude/skills/dacli-ts/` | 教 AI 何时用哪个命令 | + +**两者缺一不可**: 没 skill 工具躺地上, 没工具 skill 纸上谈兵。 + +## 0 差错定义 + +**0 差错 = API 0 错 + 浏览器 0 视觉差**。 + +| 层面 | 含义 | 工具 | +|------|------|------| +| **API 0 错** | 所有 dacli 命令返回 200/业务成功 | vitest + 集成测试 | +| **UI 0 视觉差** | 复刻的表单/菜单浏览器渲染与原版**像素级一致** | Playwright Node.js | + +**0 差错基线**: **74 张官方示例** (developSystem 21 + workSystem 53)。 +dacli 对这 74 张必须做到: +- ✅ `dacli form export ` → `dacli form import` → 重建后**结构 0 差** +- ✅ Playwright 打开原版与复刻版,**截图视觉 0 差** +- ✅ 所有字段、按钮、列表列正确渲染 +- ✅ 表单可正常提交、菜单可正常跳转、工作流可正常发起 + +## 快速开始 + +```bash +cd $ccWorkDir/dacli +npm install # 装依赖 +npx playwright install chromium # 装浏览器 (baseline 验证用) +node scripts/extract-all.mjs # 提取 web 源码到 data/*.json +npx tsx src/cli.ts login --appCode=tds # 登录 tds +npx tsx src/cli.ts form list # 列已有表单 +``` + +## 跑 baseline 一键回归 + +```bash +# 74 张一键回归 (API + UI) +bash .claude/skills/dacli-ts/examples/baseline/all.sh + +# 仅 API 层 (快, 跳过 Playwright) +SKIP_PLAYWRIGHT=1 bash .claude/skills/dacli-ts/examples/baseline/all.sh +``` + +## 目录结构 + +``` +dacli/ # 顶层独立项目 ($ccWorkDir/dacli) +├── prompt.md # 任务说明书 (开发这个项目的 AI 看的) +├── README.md # 本文件 (项目入口) +├── package.json +├── tsconfig.json +├── playwright.config.ts # Playwright 配置 +│ +├── src/ # ⭐ dacli CLI 工具 +│ ├── cli.ts +│ ├── commands/ # 嵌套子命令 +│ ├── core/ # 基础设施 +│ ├── extractors/ # web 源码提取 +│ ├── data/ # 提取 JSON +│ └── schema/ # FieldBuilder +│ +├── .claude/skills/dacli-ts/ # ⭐ AI 专用 skill +│ ├── SKILL.md # 主入口 +│ ├── references/ # 6+ 文档 +│ └── examples/ # 7+ 可复用脚本 +│ +├── doc/ # 人类详细文档 +│ ├── architecture.md +│ ├── plan.md # 6 周路线 +│ ├── baseline.md # 0 差错验证 +│ ├── api.md +│ ├── extractors.md +│ └── help-system.md +│ +├── tests/ # Playwright + vitest +│ ├── e2e/baseline/ # 114 张 baseline +│ ├── e2e/api/ +│ ├── e2e/visual/ +│ └── unit/ +│ +├── screenshots/ # 截图 (gitignored) +├── scripts/ # extract-all / verify-baseline +└── .dacli-cache.db # SQLite 缓存 +``` + +## 6 周路线 + +| Week | 任务 | 必达 | +|------|------|------| +| W0 准备 | doc + skill | ✅ 已完成 | +| W1 脚手架 | login + form list/create | tds/dev/work 都能登录 | +| W2 提取 | 5 个 extractor + Playwright | data/*.json 全部就位 | +| W3 developSystem | 21 张 baseline | 21/21 API 0 错 | +| W4 workSystem | 53 张 baseline | 53/53 API 0 错 | +| W5 帮助体系 | --ai-help + doc/apis | 镜像 Java 版 | +| W6 skill 完整 | AI 自检 + 文档 | AI 1 次对话完成请假流程 | + +详见 [doc/plan.md](doc/plan.md)。 + +## 与 Java 版的关系 + +| 维度 | Java 版 (生产) | TS 版 (实验) | +|------|----------------|---------------| +| 稳定 | ⭐⭐⭐⭐⭐ (6 月打磨) | ⭐⭐ | +| AI 友好 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | +| Schema 真相 | 53 builder 硬编码 | data/*.json 自动 | +| Baseline | 40 form | **74 form** | +| Playwright | ssw-e2e-test (Python) | **@playwright/test (Node)** | +| 启动 | 100ms native | < 500ms tsx | +| 定位 | 生产 | 实验 | + +**v1 不替代**。v2 评估后再决定。 + +## 反向链接 + +- [prompt.md](prompt.md) — 完整任务说明书 +- [doc/architecture.md](doc/architecture.md) — 设计决策 +- [doc/plan.md](doc/plan.md) — 6 周路线 +- [doc/baseline.md](doc/baseline.md) — 0 差错验证 +- [doc/api.md](doc/api.md) — 完整 API +- [doc/extractors.md](doc/extractors.md) — 提取工具 +- [doc/help-system.md](doc/help-system.md) — 帮助体系 +- [.claude/skills/dacli-ts/SKILL.md](.claude/skills/dacli-ts/SKILL.md) — AI 技能主入口 +- [.claude/skills/dacli-ts/references/](.claude/skills/dacli-ts/references/) — 6+ 文档 +- [.claude/skills/dacli-ts/examples/](.claude/skills/dacli-ts/examples/) — 7+ 脚本 +- [../ddcc/](../ddcc/) — 上一轮实验 (验证可行性) + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**核心目标**: **74 张官方示例 API 0 错 + 浏览器 0 视觉差** diff --git a/doc/RESUME.md b/doc/RESUME.md new file mode 100644 index 0000000..5f392d4 --- /dev/null +++ b/doc/RESUME.md @@ -0,0 +1,134 @@ +# RESUME — 会话恢复指引 (2026-06-12 v0.7) + +> **下次会话第一句**: 读 `doc/RESUME.md`, 然后看 `doc/v0.7-changelog.md` 知道这一轮做了什么. +> 当前进度: prompt.md 6 周路线 + v0.7 校准全部落地, **P0 #13 + P1 #15 都闭环**, 留 #16 (Playwright UI CRUD 真点击) 作为下一步. + +--- + +## 1. 当前状态 (v0.7, 2026-06-12) + +- **typecheck**: 0 错 +- **vitest**: 33/33 PASS +- **Playwright**: 18 PASS (含 #13 4/4) + 2 skip + 0 FAIL +- **dacli 命令**: 8 父 / 26+ 子 (form/dm/dict/menu/di/workflow/doc/apis, menu 加 unrelease) +- **tds 应用**: 3 张 form + - `tds_leave` (835168490678657989) — **v0.7 #13 真闭环, AI 用 dacli-ts 从零搭** (员工请假申请, 8 业务字段) + - `p15_singletable_v2` (835166593053893573) — **v0.7 #15 验证 import autoTable** + - `leaveApply_ws` (835141419151664069) — v0.6 baseline 残留 (无物理表, 浏览器报错, 视而不见) +- **tds 物理表**: 2 张 (`tds_leave`, `p15_singletable_v2`) 都在 dbLinkId=2065323991245033472 +- **tds 菜单**: 6 个 (1 新 + 5 老) + +## 2. 本轮交付清单 (按 v0.7-changelog.md) + +**dacli 源码** (6 个文件改, 修 4 真 bug): +- `src/commands/form/export.ts` (重写, 加 `_physicalSchema` 拉物理表 schema) +- `src/commands/form/import.ts` (重写, 加 `--autoTable` + 表名映射 + 优先级回退) +- `src/commands/form/release.ts` (修 endpoint: PUT /Actions/State → POST /Actions/Release) +- `src/commands/form/clone.ts` (同上 release endpoint 修) +- `src/commands/form/create.ts` (同上 release endpoint 修) +- `src/commands/dm/create.ts` (重写 body shape tableInfo+tableFieldList + 补 PK + 9 系统列) +- `src/commands/dm/fields.ts` (parse 兼容 list/fields/array) + +**测试** (1 新): +- `tests/e2e/p13-ai-driven-crud.spec.ts` (新, 4 个 P0 #13 验收 — /model URL + form info + dm fields + menu list) + +**文档/skill** (4 个): +- `.claude/skills/dacli-ts/SKILL.md` (加 v0.7 校准段) +- `.claude/skills/dacli-ts/references/troubleshooting.md` (加错误 18-22, 全 v0.7 新坑) +- `.claude/skills/dacli-ts/references/anti-patterns.md` (加反模式 0: form create type=1/2 不传 --tables) +- `doc/v0.7-changelog.md` (新, 详细变更) +- `doc/RESUME.md` (本文件, v0.7 更新) + +## 3. P0 #13 闭环关键发现 (用户校准的核心) + +subagent (only dacli-ts skill, 中文需求 "员工请假申请") **真跑通**: +- ✅ `dm create tds_leave` (19 字段, 自补 PK + 9 系统列) +- ✅ `form create --type=1 --webType=2 --tables=...` (id=835168490678657989) +- ✅ `form release` (state=1) +- ✅ `menu create --type=3 --urlAddress=model/tds_leave` (Actions/Module 失败, fallback 低级路径) +- ✅ `curl http://nginx/jnpf_app_tds/model/tds_leave` → 200 +- ✅ form info / dm fields / menu list 全部 API 端验证通过 + +**3 个 dacli 真 bug subagent 自己发现 + 自己修** (已固化到源码): +1. `dm create` body 协议错 (flat vs tableInfo wrapper) +2. `dm create` PK 自动补全缺失 (DbFieldForm.getPrimaryKey NPE) +3. `form release` endpoint 是错的 PUT /Actions/State (真路径 POST /Actions/Release) + +**结论**: dacli-ts skill **可独立支撑 AI 完成业务**, 跑出真闭环不是机械抄 baseline. + +## 4. 任务面板 (16 个任务) + +``` +#1 [✓] 验证当前基线 (typecheck + vitest + playwright 全过) +#2 [✓] 浏览器 0 视觉差 (校准为 #5-7) +#3 [ ] examples/baseline/all.sh 真一键跑 72 张 +#4 [ ] AI 自检 (prompt W6-D4): 喂 skill 给 subagent 跑请假流程 +#5 [✓] #2.1 浏览器会话管理 (storageState + TTL) +#6 [✓] #2.2 tds 数据准备 (seed-tds-baseline.ts) +#7 [✓] #2.3 浏览器层 DOM 对比 spec (列表 PASS, 详情/CRUD 留 #10/#13) +#8 [✓] #2.4 内化 ssw-e2e-test 到 dacli-ts skill +#9 [✓] 修 regression spec 真总数 (85/29) +#10 [✓] 详情页 DOM 等价 (已 spike 验证模式) +#11 [✓] AI 重建 + CRUD (校准为 #13) +#12 [✓] 挂菜单 + 真路径 spike (已验证菜单挂上 + 真路径渲染) +#13 [✓] AI 需求驱动设计 + CRUD 真闭环 (v0.7, tds_leave, 4/4 spec PASS) +#14 [✓] dacli menu create 修 (web Actions/Module + 低级 fallback) +#15 [✓] form import 不建表 bug (v0.7, autoTable 默认 true, _physicalSchema) +#16 [ ] Playwright UI CRUD 真点击 (新增填写保存编辑删除真操作, 不只 API 验证) +``` + +## 5. 下一步 (优先级排序) + +### P0: #16 — Playwright UI 真点击 CRUD +- 现在 #13 spec 只验 API + 页面能开 +- 真 0 差错要: 浏览器层填写表单 → 保存 → 列表能看 → 编辑 → 删除 → 列表少 1 行 +- 难点: vxe-table + ant-form + 字段选择器 (jnpfKey-driven) +- 建议先用 dacli createModel API 兜底验证后端 OK, 再写 UI spec + +### P1: examples/baseline/all.sh 真一键跑 72 张 (prompt W5-D5 留尾) +- 当前只有 developSystem 20 + workSystem 52 的 regression API spec +- 一键脚本未写完, 包括 export 全 72 张 + import 到 tds + Playwright 截图对比 + +### P2: 持久化 git +- dacli/ **无 git 仓库** (.claude/.git 只跟踪 .claude/) +- 选项: `cd $ccWorkDir/dacli && git init && git add -A && git commit` 独立 repo +- 或: 让 .claude/ git 升级到 ccWorkDir 顶层 (用户决策) + +## 6. 关键命令 (next session 直接用) + +```bash +cd /home/ubuntu/ccWorkDir/dacli + +# 验证基线 +npx tsc --noEmit # 0 错 +npx vitest run # 33/33 +JNPF_BASE_URL=http://nginx/ npx playwright test # 18/18 PASS + +# 验 #13 (tds_leave 真闭环) +npx tsx src/cli.ts switch-app --appCode=tds +npx tsx src/cli.ts form info 835168490678657989 +curl -s -o /dev/null -w "%{http_code}\n" http://nginx/jnpf_app_tds/model/tds_leave # → 200 + +# 验 #15 (import autoTable) +# 重跑: form export 任意 dev/workSys form → form import 到 tds → 应自动建物理表 +``` + +## 7. 重要文件路径 (恢复时直接读) + +- `doc/RESUME.md` ← 本文件 +- `doc/v0.7-changelog.md` ← 本轮详细变更 +- `doc/v0.6-changelog.md` ← 上轮变更 +- `doc/plan.md` ← 6 周路线 + v0.6 段 +- `prompt.md` ← 任务说明书 (原始需求) +- `.claude/skills/dacli-ts/SKILL.md` ← skill 主入口 v0.7 +- `.claude/skills/dacli-ts/references/playwright.md` ← 浏览器层 ssw-e2e-test 内化 +- `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-22 (v0.7 新加 18-22) +- `.claude/skills/dacli-ts/references/anti-patterns.md` ← 反模式 0-8 (v0.7 新加 0) +- `tests/e2e/p13-ai-driven-crud.spec.ts` ← P0 #13 验收 spec (4/4 PASS) + +## 8. 上下文 (登录态等) + +- dacli token: `.dacli-token/token.json` (admin@tds, 7 天 TTL) +- Playwright storageState: `.auth/admin.json` (TTL 6h, 过期重跑 setup) +- nginx + JNPF 全通 +- tds 业务库 dbLinkId: 2065323991245033472 diff --git a/doc/api.md b/doc/api.md new file mode 100644 index 0000000..129e37d --- /dev/null +++ b/doc/api.md @@ -0,0 +1,340 @@ +# api.md — 完整 API 文档 + +> **位置**: `$ccWorkDir/dacli/doc/api.md` +> **目标**: 5 父命令 + 27 子命令的完整 API 参考 + +## 1. 顶层命令 (5) + +| 命令 | 子命令数 | 用途 | +|------|----------|------| +| `dacli form` | 10 | 表单 CRUD | +| `dacli menu` | 4 | 菜单 CRUD | +| `dacli dm` | 5 | 数据模型 | +| `dacli dict` | 4 | 字典 | +| `dacli workflow` | 4 | 工作流 | +| `dacli doc` | 5 | HTML 文档缓存 | +| `dacli apis` | 5 | OpenAPI 查询 | +| **总计** | **37** | **+ 顶层 login/status/switch-app 等 5 工具命令** | + +## 2. form (10 子命令) + +### 2.1 `form list` + +``` +dacli form list [--appCode=X] [--pageSize=N] [--keyword=Y] +``` + +**返回**: `{code, msg, data: {list: [...], pagination: {...}}}` + +### 2.2 `form info ` + +``` +dacli form info [--appCode=X] +``` + +**返回**: 完整 formData/columnData/tables/flowTemplateJson + +### 2.3 `form create` + +``` +dacli form create + --fullName= # 必填 + --enCode= # 必填, ^[a-z0-9][a-z0-9.]*$ + --type=<1|2|3|4> # 必填 + --webType=<1|2|3> # 必填 + --dbLinkId= # 必填 + --category= # 必填 + --fields= # type≠4 必填 + [--description=] + [--autoTable] # type=1 自动建表 + [--autoRelease] # 自动发布 +``` + +**type 说明**: +- 1 = 自定义表单 (需物理表) +- 2 = 系统表单 +- 3 = 数据接口表单 +- 4 = 视图 (无需物理表, 无需 --fields) + +**返回**: `{code, msg, data: {id, enCode, fullName}}` + +### 2.4 `form release ` + +``` +dacli form release [--appCode=X] +``` + +发布 (state 0→1)。**type=4 视图跳过, 会 400**。 + +### 2.5 `form delete ` + +``` +dacli form delete +``` + +**慎用**。删除会丢失数据。 + +### 2.6 `form export ` + +``` +dacli form export --out= +``` + +导出完整 form JSON (含 formData/columnData/tables/...)。 + +### 2.7 `form import ` + +``` +dacli form import + --enCode= # 必填 + [--fullName=] + [--appCode=X] +``` + +### 2.8 `form clone ` + +``` +dacli form clone --newEnCode= +``` + +底层 export → import。**比手工 export+import 简单**。 + +### 2.9 `form validate ` + +``` +dacli form validate [--fix] +``` + +校验 L1 必填字段 + JSON 解析完整性。返回 errors[]。 + +### 2.10 `form fix ` + +``` +dacli form fix +``` + +修复老 form 缺 `__config__` 的问题。 + +## 3. menu (4 子命令) + +### 3.1 `menu list` + +``` +dacli menu list [--appCode=X] +``` + +### 3.2 `menu create` + +``` +dacli menu create + --fullName= # 必填 + --enCode= # 必填 + --type=<1|2|3|4|5|6|7|8|9|10> # 必填 + --category= # 必填 + [--parentId=] # 顶级 '0' + [--linkTarget=<_self|_blank>] + [--moduleId=] # type=3 必填 + [--urlAddress=] # type=3 必填 'model/{enCode}' + [--webType=<1|2|3>] # type=3 必填 + [--icon=] + [--isButtonAuthorize=<0|1>] + [--isColumnAuthorize=<0|1>] + [--isFormAuthorize=<0|1>] + [--isDataAuthorize=<0|1>] + [--description=] +``` + +### 3.3 `menu update ` + +``` +dacli menu update [--fixDisplay=true] +``` + +### 3.4 `menu delete ` + +``` +dacli menu delete +``` + +## 4. dm (5 子命令) + +### 4.1 `dm list` + +``` +dacli dm list [--appCode=X] +``` + +### 4.2 `dm table
` + +``` +dacli dm table
[--appCode=X] +``` + +返回表结构 + 字段定义。 + +### 4.3 `dm create` + +``` +dacli dm create + --table= # 必填, snake_case 无前缀 + --tableName= # 必填, 中文名 + --dbLinkId= # 必填 + --fields= # 必填 +``` + +**自动加** 9 系统列: f_id, f_tenant_id, f_flow_task_id, f_flow_id, f_flow_state, f_sort_code, f_create_user, f_create_time, f_modify_user, f_modify_time, f_description + +### 4.4 `dm update
` + +``` +dacli dm update
+ [--addField=] + [--modifyField=] + [--dropField=] +``` + +### 4.5 `dm drop
` + +``` +dacli dm drop
# 慎用 +``` + +## 5. dict (4 子命令) + +### 5.1 `dict type-list` + +``` +dacli dict type-list [--appCode=X] +``` + +### 5.2 `dict type-create` + +``` +dacli dict type-create + --fullName= # 必填 + --enCode= # 必填 + --type= # 必填 +``` + +### 5.3 `dict data-list` + +``` +dacli dict data-list --dictionaryTypeId= +``` + +### 5.4 `dict data-create` + +``` +dacli dict data-create + --dictionaryTypeId= # 必填 + --fullName= # 必填 + --enCode= # 必填 + [--parentId=] # 树形可空 +``` + +## 6. workflow (4 子命令) + +### 6.1 `workflow list` + +``` +dacli workflow list [--appCode=X] +``` + +### 6.2 `workflow create` + +``` +dacli workflow create + --fullName= # 必填 + --enCode= # 必填 + --formType=<1|2|3|4> # 必填 + --formId= # 必填 + --category= # 必填 + [--description=] +``` + +### 6.3 `workflow launch ` + +``` +dacli workflow launch + --formData= # 必填 +``` + +### 6.4 `workflow approve ` + +``` +dacli workflow approve --opinion= [--comment=] +dacli workflow reject --opinion= +``` + +## 7. 工具命令 + +### 7.1 `login` + +``` +dacli login --account= --password= --appCode= +``` + +### 7.2 `status` + +``` +dacli status +``` + +### 7.3 `switch-app` + +``` +dacli switch-app --appCode= +``` + +### 7.4 `logs` + +``` +dacli logs [--level=error] [--lines=50] +``` + +### 7.5 `initapp` + +``` +dacli initapp --appCode= --appName= [--dbName=] [--restart] +``` + +## 8. 文档/API 命令 (镜像 Java 版) + +### 8.1 `doc` (5 子命令) + +``` +dacli doc list --dir= +dacli doc get --file= [--section=] [--from=] [--lines=] +dacli doc scan --dir= +dacli doc refresh --dir= +dacli doc clear --file= +``` + +### 8.2 `apis` (5 子命令) + +``` +dacli apis list [--tag=] [--method=] [--keyword=] +dacli apis info " " +dacli apis search "" +dacli apis refresh +dacli apis status +``` + +## 9. AI 增强 flags (每个命令通用) + +| Flag | 行为 | +|------|------| +| `--help` | 基础帮助 (Commander.js 自动) | +| `--ai-help` | 输出 markdown 块, 可喂给 LLM | +| `--example` | 输出 JSON 示例 | +| `--source` | 指向 web 源文件 | +| `--json-schema` | 输出 JSON Schema 描述 | + +## 10. 反向链接 + +- [architecture.md](architecture.md) — 设计 +- [plan.md](plan.md) — 6 周路线 +- [baseline.md](baseline.md) — 0 差错 +- [extractors.md](extractors.md) — 提取工具 +- [help-system.md](help-system.md) — 帮助体系 +- [../.claude/skills/dacli-ts/references/commands.md](../.claude/skills/dacli-ts/references/commands.md) — AI 命令速查 diff --git a/doc/architecture.md b/doc/architecture.md new file mode 100644 index 0000000..7007f84 --- /dev/null +++ b/doc/architecture.md @@ -0,0 +1,268 @@ +# architecture.md — TS 版 dacli 架构设计 + +> **位置**: `$ccWorkDir/dacli/doc/architecture.md`(原 `test/dacli/`, 2026-06-12 升级到顶层) +> **目标**: 让接手的人理解 6 个关键设计决策 + +## 1. 总览 + +TS 版 dacli 是当前**主用** CLI,在 `$ccWorkDir/dacli/` 独立运行。Java 版 `ssw-dacli` 已废弃归档到 `docs/dacli/ssw-dacli/` 备查。 + +**核心原则**: +1. **复用 web 源码** — 30 分钟跑脚本拿 53 控件 schema, 不手抄 +2. **0 差错基线** — developSystem 21 + workSystem 53 = 74 张官方示例 +3. **Playwright 沉淀** — `@playwright/test` (Node.js) 是基础设施, 不是可选 +4. **AI 友好** — `--ai-help` 输出 markdown, `SKILL.md` 教 AI 何时用 + +## 2. 6 个关键决策 + +### 2.1 复用 web 源码 (而非重写) + +**对比**: + +| 路线 | 工作量 | 维护 | 升级 | +|------|--------|------|------| +| Java 版 dacli (现状) | 6 月手写 53 builder | 53 builder 硬编码 | 改 53 文件 | +| **TS 版 dacli (本项目)** | **30 分钟跑 extract 脚本** | **data/*.json 自动** | **重跑 extract** | + +**复用清单** (4 类资产): + +| 资产 | 来源 | 提取工具 | 输出 | +|------|------|----------|------| +| 加密 | `web/.../cipher.ts` | `crypto-js` 1:1 复刻 | `core/crypto.ts` | +| L1 正则 | `web/.../formValidate.ts` | `extract-l1.ts` | `data/validation-rules.json` | +| componentMap | `web/.../componentMap.ts` | `extract-component-map.ts` | `data/component-map.json` | +| Rxxx.vue schema | `web/.../rightComponents/R*.vue` | `extract-fields.ts` (vue SFC parse) | `data/field-schemas.json` | + +### 2.2 Node.js 生态 (而非 Python/Java) + +**选型**: +- **运行时**: Node 22 内置 fetch (零依赖) +- **CLI**: Commander.js (TS 生态最成熟, 嵌套子命令链) +- **缓存**: better-sqlite3 (同步 API, TS 类型完整) +- **加密**: crypto-js (与 web cipher.ts **字节级一致**) +- **E2E**: @playwright/test (Node, 同 dacli 进程) + +**避免**: +- ❌ 不用 Python Playwright (跨语言, 不能 import dacli 模块) +- ❌ 不用 tsc (tsx 零编译, 探索性开发更快) +- ❌ 不用 axios (Node 22 fetch 够用) +- ❌ 不用 yargs (API 笨重) + +### 2.3 FieldBuilder 从 JSON 加载 (而非硬编码) + +```ts +// ❌ Java 版: 53 个硬编码 builder +class InputFieldBuilder { + buildSchema() { + return { /* 43 字段硬编码 */ } + } +} + +// ✅ TS 版: 1 个通用 builder + 39 个 JSON schema +class FieldBuilder { + loadSchema(jnpfKey: string) { + return fieldSchemas[jnpfKey] // 从 data/field-schemas.json + } +} +``` + +**好处**: +- JNPF 升级时: `npm run extract` 重跑, 自动更新 +- 测试时: 改 JSON 即改 builder, 不用编译 +- 维护时: 1 个文件管 39 控件, 不 53 个 + +### 2.4 嵌套子命令 (参考 Java 嵌套类) + +```ts +// src/commands/form.ts +import { Command } from 'commander' + +const formCmd = new Command('form') + .description('表单管理') + +formCmd + .command('list') + .description('列表单') + .action(async () => { /* ... */ }) + +formCmd + .command('create') + .description('建表单') + .option('--fullName ') + .option('--enCode ') + .option('--type <1|2|3|4>') + .option('--webType <1|2|3>') + .option('--dbLinkId ') + .option('--category ') + .option('--fields ') + .option('--autoTable') + .option('--autoRelease') + .action(async (opts) => { /* ... */ }) + +// 在 cli.ts 注册 +program.addCommand(formCmd) +``` + +**对比 Java 嵌套类**: +- Java: `@Command(subcommands = {FormCommand.ListCommand.class, ...})` +- TS: `formCmd.command('list').action(...)` + +**优势**: 同一文件管同一父命令, 不用 109 个文件 (Java 阶段 6 重构后是 19 个, TS 模式类似)。 + +### 2.5 AI 友好的帮助体系 + +```bash +# 基础 (Commander.js 自动) +dacli form create --help + +# AI 专用 (核心增强) +dacli form create --ai-help +# → 输出可喂给 LLM 的 markdown 块 + +# 例子 +dacli form create --example +# → 输出 JSON 示例 + +# 调试 +dacli form create --source +# → 指向 web 源文件 (Form.vue:444-465) +``` + +**`--ai-help` 输出格式**: +```markdown +# dacli form create + +## 用途 +创建一张 JNPF 功能表单 + +## 必传参数 +- `--fullName` (string): 表单中文名 +- `--enCode` (string): 表单英文编码 +- `--type` (1|2|3|4): 1=自定义 2=系统 3=接口 4=视图 +... + +## 来源 +- web 源码: web/.../formDesign/Form.vue:444-465 +- API: POST /api/visualdev/Base + +## 例子 +\`\`\`bash +dacli form create --fullName="请假" --enCode=leave --type=4 --webType=1 +\`\`\` +``` + +### 2.6 Playwright Node.js 集成 (而非外挂) + +**为什么 Node.js 而不是 Python**: +- 同语言: 与 dacli 都是 TS, 可直接 import +- 同进程: `import { FormService } from '../src/commands/form.js'` +- 同 tsconfig: 共享类型 +- 一个 Node.js 生态搞定 + +**集成方式**: +``` +dacli/ +├── src/ # dacli 源码 +├── tests/e2e/ # Playwright 测试 +│ └── baseline/ # 114 张 baseline +│ ├── developSystem/ +│ │ ├── .spec.ts +│ │ └── ... +│ └── workSystem/ +└── playwright.config.ts # 共用配置 +``` + +## 3. 目录结构 (完整) + +``` +dacli/ +├── prompt.md # 任务说明书 +├── README.md +├── package.json +├── tsconfig.json +├── playwright.config.ts +│ +├── src/ # dacli CLI +│ ├── cli.ts +│ ├── commands/ # 嵌套子命令 +│ ├── core/ # 基础设施 +│ ├── extractors/ # web 源码提取 +│ ├── data/ # 提取的 JSON +│ └── schema/ # FieldBuilder +│ +├── .claude/skills/dacli-ts/ # AI skill +│ ├── SKILL.md +│ ├── references/ # 6+ 文档 +│ └── examples/ # 7+ 可复用脚本 +│ +├── doc/ # 人类详细文档 +│ ├── architecture.md # 本文件 +│ ├── plan.md +│ ├── baseline.md +│ ├── api.md +│ ├── extractors.md +│ └── help-system.md +│ +├── tests/ # Playwright + vitest +│ ├── e2e/baseline/ # 74 张 +│ ├── e2e/api/ # API 层 +│ ├── e2e/visual/ # 视觉对比 +│ └── unit/ # 单元 +│ +├── screenshots/ # 截图 (gitignored) +├── scripts/ # extract-all / verify-baseline +└── .dacli-cache.db # SQLite 缓存 +``` + +## 4. 数据流 + +``` +JNPF web 源码 + ├─ cipher.ts + ├─ formValidate.ts + ├─ componentMap.ts + └─ Rxxx.vue + │ + ▼ (extractors/*.ts, tsx 一键跑) + │ +data/*.json (git-tracked) + ├─ component-map.json (60+ jnpfKey → tag) + ├─ field-schemas.json (39 控件 schema) + ├─ validation-rules.json (14 L1 正则) + └─ l2-rules.json (30+ L2 错误消息) + │ + ▼ (FieldBuilder 加载) + │ +dacli form create (动态生成 form JSON) + │ + ▼ (HTTP 调用 JNPF API) + │ +JNPF 后端 (新建/修改/发布表单) + │ + ▼ (Playwright 验证) + │ +74 张 baseline 0 视觉差 ✓ +``` + +## 5. 与 Java 版的关系 + +| 维度 | Java 版 | TS 版 | +|------|---------|-------| +| 稳定 | ⭐⭐⭐⭐⭐ | ⭐⭐ | +| AI 友好 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | +| Schema 真相 | 53 builder 硬编码 | data/*.json 自动 | +| Baseline | 40 form | **74 form** | +| Playwright | ssw-e2e-test (Python) | **@playwright/test (Node)** | +| 定位 | 生产 | 实验 | + +**v1 不替代**。v2 评估后再决定。 + +## 6. 反向链接 + +- [plan.md](plan.md) — 6 周路线 +- [baseline.md](baseline.md) — 0 差错验证 +- [api.md](api.md) — 完整 API +- [extractors.md](extractors.md) — 提取工具 +- [help-system.md](help-system.md) — 帮助体系 +- [../.claude/skills/dacli-ts/SKILL.md](../.claude/skills/dacli-ts/SKILL.md) — AI 技能 +- [../prompt.md](../prompt.md) — 任务说明书 diff --git a/doc/baseline.md b/doc/baseline.md new file mode 100644 index 0000000..ece71fb --- /dev/null +++ b/doc/baseline.md @@ -0,0 +1,198 @@ +# baseline.md — 0 差错验证规范 + +> **位置**: `$ccWorkDir/dacli/doc/baseline.md` +> **目标**: 74 张官方示例的 0 差错验证流程 + +## 1. 0 差错定义 + +**0 差错 = API 0 错 + 浏览器 0 视觉差** + +| 层面 | 含义 | 验证工具 | +|------|------|----------| +| **API 0 错** | 所有 dacli 命令返回 200/业务成功 | vitest + 集成测试 | +| **UI 0 视觉差** | 复刻的表单/菜单浏览器渲染与原版**像素级一致** | Playwright Node.js | + +**0 差错基线**: **74 张官方示例** +- developSystem 21 张 +- workSystem 53 张 + +## 2. 验证金字塔 + +``` + ┌──────────────────┐ + │ Playwright 0 视觉差 │ ← 浏览器层 + │ (E2E 测试) │ + ├──────────────────┤ + │ dacli API 0 错 │ ← 集成层 + │ (vitest + CLI) │ + ├──────────────────┤ + │ 单元测试 0 错 │ ← 函数层 + │ (vitest unit) │ + └──────────────────┘ +``` + +**每一层都必须 0 错**。 + +## 3. baseline 复刻流程 + +每张 baseline 表单对应: +1. `examples/baseline//.sh` - 复刻脚本 +2. `tests/e2e/baseline//.spec.ts` - Playwright 测试 + +**复刻流程** (每张): + +```bash +# 1. 切到源 app, 登录 +dacli switch-app --appCode=developSystem +dacli login --appCode=developSystem + +# 2. 找到目标 id (用 enCode 查) +ORIGINAL_ID=$(dacli form list | jq -r '.data.list[] | select(.enCode=="leaveApply") | .id') + +# 3. 导出原表单 JSON +dacli form export $ORIGINAL_ID --out=/tmp/leaveApply-orig.json + +# 4. 切到 tds, 登录 +dacli switch-app --appCode=tds +dacli login --appCode=tds + +# 5. 导入 (改 enCode 避免冲突) +dacli form import /tmp/leaveApply-orig.json --enCode=leaveApply_clone + +# 6. 拿克隆 id +CLONE_ID=$(dacli form list | jq -r '.data.list[] | select(.enCode=="leaveApply_clone") | .id') + +# 7. 发布 +dacli form release $CLONE_ID + +# 8. API 层 0 差验证 (字段集对比) +dacli form validate $CLONE_ID + +# 9. 浏览器层 0 视觉差验证 (Playwright) +npx playwright test tests/e2e/baseline/developSystem/leaveApply.spec.ts +``` + +## 4. 0 差错的精确含义 + +### 4.1 API 层 0 错 + +| 检查项 | 0 错标准 | +|--------|----------| +| HTTP 状态码 | 200/业务成功 (无 4xx/5xx) | +| 响应数据 | 重建后字段集与原版**完全一致** (允许 id/enCode/state 不同) | +| 表单状态 | 发布后 state=1 | +| 字段集 | 重建 form info 返回所有字段名/类型与原版一致 | +| 关联控件 | popupTable/relationForm 配置完整 | +| 字典 | 字典 ID 引用完整 | + +### 4.2 UI 层 0 视觉差 + +| 检查项 | 0 错标准 | +|--------|----------| +| 字段渲染 | 浏览器看到的 input/select/textarea 数量、类型、默认值 0 差 | +| 控件类型 | select 渲染成 select, input 渲染成 input (不能反) | +| 字典数据 | 下拉框有选项 (不空白) | +| 按钮位置 | 保存/取消/审批按钮位置 0 差 | +| 列表列 | 列表页列数/列名/列宽 0 差 | +| 工作流节点 | 流程图节点数/连线 0 差 | +| 像素 | 截图与基准**像素级一致** (允许 1-2 像素抗锯齿) | + +### 4.3 允许的差异 (不算错) + +- id / enCode 必然不同 +- 物理表名前缀 (e.g. `tds_asset` vs `tds_asset_clone`) +- 时间戳 / 创建人 +- 1-2 像素抗锯齿差异 + +## 5. 验收工具 + +### 5.1 一键回归 74 张 + +```bash +# 跑全部 74 张 (API + UI) +bash examples/baseline/all.sh + +# 仅 API 层 (快, 跳过 Playwright) +SKIP_PLAYWRIGHT=1 bash examples/baseline/all.sh + +# 仅 API 层 CI 用 +bash examples/baseline/all.sh --skip-visual +``` + +### 5.2 单张验证 + +```bash +# 跑单张 baseline +bash examples/baseline/developSystem/leaveApply.sh + +# 仅 Playwright 部分 +npx playwright test tests/e2e/baseline/developSystem/leaveApply.spec.ts + +# 仅 API 部分 +SKIP_PLAYWRIGHT=1 bash examples/baseline/developSystem/leaveApply.sh +``` + +### 5.3 视觉对比 (pixelmatch) + +```typescript +import { PNG } from 'pngjs' +import pixelmatch from 'pixelmatch' +import { readFileSync, writeFileSync } from 'node:fs' + +const baseline = PNG.sync.read(readFileSync('screenshots/developSystem/leaveApply.png')) +const current = PNG.sync.read(await page.screenshot()) +const diff = new PNG({ width: baseline.width, height: baseline.height }) + +const numDiffPixels = pixelmatch( + baseline.data, current.data, diff.data, + baseline.width, baseline.height, + { threshold: 0.1 } // 严格 +) + +expect(numDiffPixels).toBeLessThan(50) // < 50 像素 = 0 视觉差 +``` + +## 6. 常见 bug 与修复 + +### 6.1 字段缺失 + +**症状**: 浏览器缺一个 input +**原因**: tables[].fields[] 缺 `autoIncrement/identity/columnName` +**修复**: 用 baseline clone 拿完整 schema + +### 6.2 控件类型错 + +**症状**: select 渲染成 input +**原因**: __config__.tag 错 (应 `JnpfSelect` 不是 `JnpfInput`) +**修复**: 检查 componentMap.ts 对应 + +### 6.3 字典空白 + +**症状**: 下拉框没选项 +**原因**: dictionaryTypeId 错或字典数据未导入 +**修复**: 同步 baseline 应用的字典 + +### 6.4 工作流节点缺 + +**症状**: 流程图节点缺失 +**原因**: templateJson 不全 +**修复**: 用 web 端配置完整工作流, 导出后 import + +## 7. 何时重跑 + +| 触发 | 行为 | +|------|------| +| **JNPF 升级** | `bash examples/baseline/all.sh` 一键跑, 5 分钟看 regression | +| **dacli FieldBuilder 改动** | 跑 baseline 验证 schema 兼容 | +| **新增 baseline** | 写新 .sh + 新 .spec.ts | +| **JNPF 厂商发版** | 必跑, 对比 diff | + +## 8. 反向链接 + +- [architecture.md](architecture.md) — 设计 +- [plan.md](plan.md) — 6 周路线 +- [api.md](api.md) — 完整 API +- [../.claude/skills/dacli-ts/references/baseline/README.md](../.claude/skills/dacli-ts/references/baseline/README.md) — baseline 列表 +- [../.claude/skills/dacli-ts/references/playwright.md](../.claude/skills/dacli-ts/references/playwright.md) — Playwright 指南 +- [../.claude/skills/dacli-ts/examples/baseline/all.sh](../.claude/skills/dacli-ts/examples/baseline/all.sh) — 一键回归 +- [../.claude/skills/dacli-ts/examples/baseline/template.sh](../.claude/skills/dacli-ts/examples/baseline/template.sh) — 复刻模板 diff --git a/doc/extractors.md b/doc/extractors.md new file mode 100644 index 0000000..177e54c --- /dev/null +++ b/doc/extractors.md @@ -0,0 +1,286 @@ +# extractors.md — web 源码提取工具说明 + +> **位置**: `$ccWorkDir/dacli/doc/extractors.md` +> **目标**: 5 个 extractor 工具, 从 web 源码自动生成 data/*.json + +## 1. 概览 + +| Extractor | 输入 | 输出 | 大小 | 跑时 | +|-----------|------|------|------|------| +| `component-map.ts` | `web/.../componentMap.ts` | `data/component-map.json` | 60+ jnpfKey | < 1s | +| `fields.ts` | `web/.../rightComponents/R*.vue` | `data/field-schemas.json` | 39 控件 | < 5s | +| `l1-rules.ts` | `web/.../formValidate.ts` | `data/validation-rules.json` | 14 正则 | < 1s | +| `l2-rules.ts` | `web/.../Form.vue` 多个 | `data/l2-rules.json` | 30+ 规则 | < 5s | +| `flow.ts` | `web/.../FlowProcess/index.vue` | `data/flow-nodes.json` | 25+ 节点 | < 5s | + +**一键跑全部**: +```bash +node scripts/extract-all.mjs +``` + +## 2. component-map.ts 提取 + +**输入**: `web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts` + +**提取内容**: +- jnpfKey → tag (e.g. `input` → `JnpfInput`) +- 控件元数据 + +**输出** (`data/component-map.json`): +```json +{ + "input": "JnpfInput", + "textarea": "JnpfTextarea", + "select": "JnpfSelect", + ... +} +``` + +**实现**: +```ts +// src/extractors/component-map.ts +import { readFileSync, writeFileSync } from 'node:fs' +import { resolve } from 'node:path' + +const SRC = 'web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts' +const OUT = 'src/data/component-map.json' + +export function extractComponentMap() { + const src = readFileSync(resolve(SRC), 'utf-8') + const items = [...src.matchAll(/jnpfKey:\s*['"](\w+)['"][\s\S]*?tag:\s*['"]([^'"]+)['"]/g)] + const map: Record = {} + for (const m of items) map[m[1]] = m[2] + writeFileSync(resolve(OUT), JSON.stringify(map, null, 2)) + return Object.keys(map).length +} +``` + +## 3. fields.ts 提取 (核心) + +**输入**: `web/.../rightComponents/R*.vue` (39 个) + +**提取**: Rxxx.vue template 里所有 `activeData.` 形式, 得到控件字段集 + +**输出** (`data/field-schemas.json`): +```json +{ + "input": [ + "__config__.defaultValue", "__config__.noShow", "__config__.required", + "addonAfter", "addonBefore", "clearable", "disabled", "maxlength", + "prefixIcon", "readonly", "showCount", "showPassword", "suffixIcon", + "useMask", "useScan" + ], + "select": [ + "__config__.defaultValue", "clearable", "filterable", "multiple", + "options", "props" + ], + ... +} +``` + +**实现**: +```ts +// src/extractors/fields.ts +import { parse as parseSFC } from '@vue/compiler-sfc' +import { readFileSync, readdirSync, writeFileSync } from 'node:fs' +import { resolve } from 'node:path' + +const R_DIR = 'web/.../rightComponents' +const COMP_MAP = 'web/.../componentMap.ts' +const OUT = 'src/data/field-schemas.json' + +export function extractFields() { + // 1. 读 componentMap (jnpfKey → tag) + const cmSrc = readFileSync(COMP_MAP, 'utf-8') + const jnpfKeyToTag: Record = {} + for (const m of cmSrc.matchAll(/jnpfKey:\s*['"](\w+)['"][\s\S]*?tag:\s*['"]([^'"]+)['"]/g)) { + jnpfKeyToTag[m[1]] = m[2] + } + + // 2. 对每个 jnpfKey 找对应 R.vue + const schemas: Record = {} + for (const key of Object.keys(jnpfKeyToTag)) { + const pascal = key.charAt(0).toUpperCase() + key.slice(1) + const f = resolve(R_DIR, `R${pascal}.vue`) + try { + const src = readFileSync(f, 'utf-8') + const { descriptor } = parseSFC(src, { filename: `R${pascal}.vue` }) + const tmpl = descriptor.template?.content + if (!tmpl) continue + + // 提所有 activeData. + const fields = [...new Set( + [...tmpl.matchAll(/activeData\.([a-zA-Z_][\w.]*)/g)].map(m => m[1]) + )].sort() + schemas[key] = fields + } catch { /* 文件不存在, 跳过 */ } + } + + writeFileSync(resolve(OUT), JSON.stringify(schemas, null, 2)) + return Object.keys(schemas).length +} +``` + +**覆盖率**: +- 60+ jnpfKey 中能找 39 个 R 文件 +- 14 个 R 文件缺失 (Jnpf/ 目录下的子组件) +- input 控件 19 字段 (vs dacli Java 43 字段, 44% 覆盖率) +- 整体 60-80% 字段覆盖率, 剩 20-40% 用 baseline 补 + +## 4. l1-rules.ts 提取 + +**输入**: `web/packages/jnpf/utils/src/helpers/formValidate.ts` + +**提取**: 14 条 L1 正则 (enCode, fullName, field, chinese, bigInt, ...) + +**输出** (`data/validation-rules.json`): +```json +{ + "enCode": { + "msg": "只能输入英文、数字和小数点且小数点不能放在首尾", + "rule": "^[a-z0-9]((([a-z0-9])*)|(([a-z0-9]+|\\.)*[a-z0-9]))$/i" + }, + "fullName": { + "msg": "名称不能含有特殊符号", + "rule": "^([一-龥a-z0-9])+$/i" + }, + ... +} +``` + +**实现**: +```ts +// src/extractors/l1-rules.ts +import { readFileSync, writeFileSync } from 'node:fs' +import { resolve } from 'node:path' + +const SRC = 'web/packages/jnpf/utils/src/helpers/formValidate.ts' +const OUT = 'src/data/validation-rules.json' + +export function extractL1Rules() { + const src = readFileSync(resolve(SRC), 'utf-8') + const match = src.match(/const regularList\s*=\s*\{([\s\S]*?)\n\}/) + if (!match) throw new Error('regularList not found') + + const rules: Record = {} + // 提每条 key 的 msg + rule + for (const m of match[1].matchAll(/(\w+):\s*\{[\s\S]*?msg:\s*'([^']+)'[\s\S]*?rule:\s*(\/[^\/]+\/[a-z]*)[\s\S]*?\}/g)) { + rules[m[1]] = { msg: m[2], rule: m[3] } + } + writeFileSync(resolve(OUT), JSON.stringify(rules, null, 2)) + return Object.keys(rules).length +} +``` + +## 5. l2-rules.ts 提取 + +**输入**: `web/.../views/{module}/Form.vue` 多个 + +**提取**: `createMessage.error/warning('msg')` + 上下文 + +**输出** (`data/l2-rules.json`): +```json +{ + "di": [ + { "line": 472, "msg": "请输入静态数据", "condition": "type == 2", "dacli": "--static-data" }, + { "line": 522, "msg": "请输入SQL查询语句", "condition": "type == 1, activeStep == 1", "dacli": "--sql-query" } + ], + "dm": [...], + "dict": [...], + "workflow": [...] +} +``` + +**实现**: +```ts +// src/extractors/l2-rules.ts +import { parse as parseSFC } from '@vue/compiler-sfc' +import { readFileSync, readdirSync, writeFileSync } from 'node:fs' +import { resolve } from 'node:path' + +export function extractL2Rules() { + const rules: Record = { di: [], dm: [], dict: [], workflow: [] } + + // 扫所有 Form.vue + const viewsDir = 'web/apps/jnpf-web-apps-main/src/views' + const forms = findAllFiles(viewsDir, /Form\.vue$/) + + for (const f of forms) { + const module = f.includes('/dataInterface/') ? 'di' + : f.includes('/dataModel/') ? 'dm' + : f.includes('/dictionary/') ? 'dict' + : f.includes('/flowEngine/') ? 'workflow' + : null + if (!module) continue + + const src = readFileSync(f, 'utf-8') + const { descriptor } = parseSFC(src) + const script = descriptor.scriptSetup?.content || descriptor.script?.content || '' + + // 提 createMessage.error/warning + for (const m of script.matchAll(/createMessage\.(error|warning)\s*\(\s*['"]([^'"]+)['"]/g)) { + rules[module].push({ + level: m[1], + msg: m[2], + line: getLineNumber(script, m.index!), + source: f.replace(/^.*\/web\//, 'web/'), + }) + } + } + + writeFileSync(resolve(OUT), JSON.stringify(rules, null, 2)) + return Object.values(rules).reduce((a, b) => a + b.length, 0) +} +``` + +## 6. flow.ts 提取 + +**输入**: `web/.../components/FlowProcess/src/index.vue` + +**提取**: `setErrorList(msg, id, title)` 调用 + 节点 type + +**输出** (`data/flow-nodes.json`): +```json +{ + "addData": { "formId": "必填", "msg": "请选择目标表单" }, + "updateData": { "formId": "必填", "ruleList": "必填, 至少 1 条", "msg": "请设置更新条件" }, + "typeDecision": { "decisionOptions": "必填", "msg": "节点未完善" }, + ... +} +``` + +## 7. 一键提取 (scripts/extract-all.mjs) + +```js +#!/usr/bin/env node +// scripts/extract-all.mjs +import { extractComponentMap } from '../src/extractors/component-map.ts' +import { extractFields } from '../src/extractors/fields.ts' +import { extractL1Rules } from '../src/extractors/l1-rules.ts' +import { extractL2Rules } from '../src/extractors/l2-rules.ts' +import { extractFlow } from '../src/extractors/flow.ts' + +console.log('▶ extractComponentMap:', extractComponentMap(), 'jnpfKey') +console.log('▶ extractFields: ', extractFields(), '控件') +console.log('▶ extractL1Rules: ', extractL1Rules(), '条') +console.log('▶ extractL2Rules: ', extractL2Rules(), '条') +console.log('▶ extractFlow: ', extractFlow(), '节点') +console.log('✓ 全部提取完成') +``` + +## 8. 何时重跑 + +| 触发 | 行为 | +|------|------| +| JNPF 升级 | 必跑, 5 分钟看 web 改了哪些 | +| 新增 Rxxx.vue | 跑 extract 拿新控件 schema | +| 修改 formValidate | 跑 extract 拿新规则 | +| 改 componentMap | 跑 extract 拿新映射 | + +## 9. 反向链接 + +- [architecture.md](architecture.md) — 设计 +- [plan.md](plan.md) — 6 周路线 +- [api.md](api.md) — API +- [baseline.md](baseline.md) — 0 差错 +- [help-system.md](help-system.md) — 帮助体系 diff --git a/doc/help-system.md b/doc/help-system.md new file mode 100644 index 0000000..5bfc4d5 --- /dev/null +++ b/doc/help-system.md @@ -0,0 +1,300 @@ +# help-system.md — 帮助体系设计 + +> **位置**: `$ccWorkDir/dacli/doc/help-system.md` +> **目标**: 比 Java 版更 AI 友好的帮助体系 + +## 1. 设计动机 + +Java 版 `dacli` 用 Picocli 自动生成 `--help`, 对人不友好, 对 AI 也不够友好: + +- ❌ `--help` 输出冗长, AI 难以解析 +- ❌ 无字段约束说明, AI 不知道哪些必填 +- ❌ 无 JSON 示例, AI 不知道 payload 形态 +- ❌ 无 web 源文件指引, debug 难定位 + +TS 版**增强 5 个 flag**, 让 AI 一次对话就能用对命令。 + +## 2. 5 个 flag 设计 + +| Flag | 输出 | 用途 | +|------|------|------| +| `--help` | Commander.js 自动 | 基础 | +| `--ai-help` | markdown 块, 可喂给 LLM | AI prompt 友好 | +| `--example` | JSON 示例 | 直接抄 | +| `--source` | 指向 web 源文件:行号 | debug | +| `--json-schema` | JSON Schema 描述 | API 文档自动生成 | + +### 2.1 `--ai-help` + +**输出格式**: +```markdown +# dacli form create + +## 用途 +创建一张 JNPF 功能表单 + +## 必传参数 +- `--fullName `: 表单中文名 +- `--enCode `: 表单英文编码 (^[a-z0-9][a-z0-9.]*$) +- `--type <1|2|3|4>`: 1=自定义 2=系统 3=接口 4=视图 +- `--webType <1|2|3>`: 1=仅表单 2=表单+列表 3=树 +- `--dbLinkId `: 业务库 id (从 dacli status 拿) +- `--category `: 字典分类 (从已有 form list 查) +- `--fields `: type≠4 必填, 字段定义数组 + +## 可选参数 +- `--description `: 描述 +- `--autoTable`: 自动建物理表 (type=1) +- `--autoRelease`: 自动发布 (state 0→1) + +## 来源 +- web 源码: `web/apps/.../formDesign/Form.vue:444-465` +- API: `POST /api/visualdev/Base` + +## 例子 + +### 例子 1: 视图 (type=4, 最简单) +\`\`\`bash +dacli form create \\ + --fullName="请假申请" \\ + --enCode=leave \\ + --type=4 --webType=1 \\ + --dbLinkId= \\ + --category=Form +\`\`\` + +### 例子 2: 单表 (type=1, 完整) +\`\`\`bash +dacli form create \\ + --fullName="请假申请" \\ + --enCode=leave \\ + --type=1 --webType=2 \\ + --dbLinkId= --category=Form \\ + --fields='[ + {"field":"f_name","fieldName":"姓名","jnpfKey":"input","required":1}, + {"field":"f_days","fieldName":"天数","jnpfKey":"inputNumber","required":1} + ]' \\ + --autoTable --autoRelease +\`\`\` + +## 常见错误 +- "Database exception": dbLinkId 错 / tables 字段缺 / category 错 +- "System abnormality" (release): type=4 视图不该 release +- 详见: references/troubleshooting.md +``` + +**实现**: +```ts +// src/core/help.ts +export function buildAiHelp(cmd: CommandSpec): string { + return ` +# dacli ${cmd.name} + +## 用途 +${cmd.description} + +## 必传参数 +${cmd.required.map(p => `- \`--${p.name} <${p.type}>\`: ${p.description}`).join('\n')} + +## 可选参数 +${cmd.optional.map(p => `- \`--${p.name} <${p.type}>\`: ${p.description}`).join('\n')} + +## 来源 +- web 源码: \`${cmd.webSource}\` +- API: \`${cmd.method} ${cmd.path}\` + +## 例子 +${cmd.examples.map((ex, i) => `### 例子 ${i + 1}: ${ex.title} +\`\`\`bash +${ex.code} +\`\`\` +`).join('\n')} + +## 常见错误 +${cmd.commonErrors.join('\n')} + `.trim() +} +``` + +### 2.2 `--example` + +**输出**: +```json +{ + "fullName": "请假申请", + "enCode": "leave", + "type": 4, + "webType": 1, + "dbLinkId": "2065021772707475456", + "category": "Form" +} +``` + +**用途**: AI 拿到 example, 直接替换字段值就能调。 + +### 2.3 `--source` + +**输出**: +``` +web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/Form.vue:444-465 +web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts:23 +``` + +**用途**: debug 时知道这个命令的源头是 web 的哪个文件, 可以直接读。 + +### 2.4 `--json-schema` + +**输出**: +```json +{ + "type": "object", + "required": ["fullName", "enCode", "type", "webType", "dbLinkId", "category"], + "properties": { + "fullName": { "type": "string", "description": "表单中文名" }, + "enCode": { "type": "string", "pattern": "^[a-z0-9][a-z0-9.]*$" }, + "type": { "enum": [1, 2, 3, 4] }, + "webType": { "enum": [1, 2, 3] }, + ... + } +} +``` + +**用途**: 自动化测试用, 验证 AI 生成的 JSON 符合 schema。 + +## 3. 全局 flags + +| Flag | 行为 | +|------|------| +| `--json` | 全命令输出 JSON (默认人类可读) | +| `--quiet` | 静默 (仅 error) | +| `--verbose` | 详细 (含 raw 响应) | +| `--no-color` | 关闭颜色 | +| `--version` | 版本 | + +## 4. 子命令注册模板 + +```ts +// src/commands/form.ts +const formCmd = new Command('form') + .description('表单管理') + +// 标准子命令 +formCmd + .command('create') + .description('创建表单') + .addAiHelp(buildAiHelp(formCreateSpec)) // ← 新增 + .addExample(formCreateExample) // ← 新增 + .addSource('Form.vue:444-465') // ← 新增 + .option('--fullName ', '表单中文名') + .option('--enCode ', '表单英文编码') + .option('--type <1|2|3|4>', '...') + ... + .action(async (opts) => { /* ... */ }) +``` + +**Command 扩展** (自定义): +```ts +// src/core/command-ext.ts +declare module 'commander' { + interface Command { + addAiHelp(md: string): this + addExample(obj: object): this + addSource(file: string): this + } +} + +Command.prototype.addAiHelp = function(md: string) { + this.option('--ai-help', '输出 AI 友好的 markdown 帮助') + this._aiHelp = md + return this +} + +Command.prototype.addExample = function(obj: object) { + this._example = obj + return this +} + +// ai-help flag 处理 +const origAction = Command.prototype._actionHandler +Command.prototype._actionHandler = function(fn) { + return async function(this: Command, ...args) { + if (this.opts().aiHelp) { + console.log(this._aiHelp) + return + } + if (this.opts().example) { + console.log(JSON.stringify(this._example, null, 2)) + return + } + if (this.opts().source) { + console.log(this._source) + return + } + return fn.apply(this, args) + } +} +``` + +## 5. 实际 AI 使用示例 + +### 5.1 AI 接到任务: "建一个请假流程" + +**Step 1: AI 读 --ai-help** +``` +$ dacli form create --ai-help +[输出上面 markdown] +``` + +**Step 2: AI 决定 type=4 (快速 POC)** +``` +看完帮助, AI 知道 type=4 不需要 fields, 不需要 release +``` + +**Step 3: AI 调命令** +```bash +$ dacli form create --fullName="请假" --enCode=leave \ + --type=4 --webType=1 --dbLinkId= --category=Form +✓ Created form id=xxx +``` + +**Step 4: AI 跑 baseline 验证** +```bash +$ npx playwright test tests/e2e/baseline/developSystem/leaveApply.spec.ts +✓ UI 0 视觉差 +``` + +### 5.2 AI 接到任务: "迁移 5 张表单到 tds" + +**Step 1: AI 读 list 看有哪些** +```bash +$ dacli form list --appCode=developSystem --pageSize=100 +``` + +**Step 2: AI 调 --ai-help 看 export/import 怎么用** +```bash +$ dacli form export --ai-help +$ dacli form import --ai-help +``` + +**Step 3: AI 用 examples 套** +```bash +$ for id in 1 2 3 4 5; do + dacli form export $id --out=/tmp/$id.json + dacli form import /tmp/$id.json --enCode=$(dacli form info $id).enCode_migrated + done +``` + +**Step 4: AI 跑 baseline 验证** +```bash +$ bash examples/baseline/all.sh --skip-visual +✓ 5/5 API 0 错 +``` + +## 6. 反向链接 + +- [architecture.md](architecture.md) — 设计 +- [api.md](api.md) — API +- [plan.md](plan.md) — 6 周路线 +- [extractors.md](extractors.md) — 提取工具 +- [../.claude/skills/dacli-ts/SKILL.md](../.claude/skills/dacli-ts/SKILL.md) — AI 技能 +- [../.claude/skills/dacli-ts/references/commands.md](../.claude/skills/dacli-ts/references/commands.md) — AI 命令速查 diff --git a/doc/plan.md b/doc/plan.md new file mode 100644 index 0000000..1ad0078 --- /dev/null +++ b/doc/plan.md @@ -0,0 +1,265 @@ +# plan.md — 6 周路线 + +> **当前位置**: v1 计划冻结, 起步阶段 +> **总目标**: **74 张官方示例 (developSystem 21 + workSystem 53) 全部 API 0 错 + 浏览器 0 视觉差** + +## 当前状态 + +``` +✓ Week 0 — 准备 (已完成) + ├─ prompt.md 写完 + ├─ doc/ 写完 (architecture, baseline, api, extractors, help-system) + ├─ .claude/skills/dacli-ts/ 写完 (SKILL.md + 6 references + examples) + └─ baseline 模板就位 (template.sh, template.spec.ts, all.sh) + +✓ Week 1 — 脚手架 + 核心管道 (D1–D5 已完成 2026-06-12) + ├─ D1 package.json + tsconfig + playwright.config + cli.ts (commander.js) — npx tsx src/cli.ts --help 跑通 + ├─ D2 core/crypto.ts (crypto-js 1:1 复刻 web cipher.ts) + 5/5 单测 — '123456' → 96 字符 hex + ├─ D3 core/client.ts (JnpfClient + token 持久化 + baseUrl 兜底) + commands/login + status + switch-app — login + dbLinkId 自动检测跑通 + ├─ D4 commands/form/list + info + core/config.ts — developSystem 列 20 张 / info 拿完整 schema + ├─ D5 commands/form/{create,release,delete,export,import,clone,validate} 骨架完整 — 只读链路 (list/info/export/validate) 端到端跑通 + └─ 测试: 15/15 vitest 单测 PASS, typecheck 零警告 + +⏳ Week 1 — 已知卡点 (留 W2 提取工具补齐) + └─ form create / clone / import 因 JNPF schema 严校验, 需 extracted field-schemas.json 喂完整字段后才能跑通 + - prompt §6.3 已警告: "tables[].fields[] 缺 autoIncrement/identity/columnName" → Database exception + - W2-D2 extractors/fields.ts 完成后, FieldBuilder 加载 JSON 自动补齐 + - 当前 create.ts 兜底已用真实 JSON 字符串结构 (formData/columnData/tables 全字符串化) + +✓ Week 2 — 提取工具 + Playwright 配置 (D1–D5 已完成 2026-06-12) + ├─ D1 component-map extractor — `WEB_ROOT=... node scripts/extract-all.mjs` 提 60 jnpfKey → tag → src/data/component-map.json + ├─ D2 field-schemas extractor (@vue/compiler-sfc 解析 R*.vue) — 39 控件 activeData 字段 → src/data/field-schemas.json + ├─ D3 L1 + L2 rules extractors — 14 条 L1 正则 (validation-rules.json) + 9 条 L2 错误消息 (l2-rules.json) + ├─ D4 Playwright config + chromium — playwright.config.ts 就位 + 装 chromium-1224 + smoke.spec.ts 3/3 PASS + ├─ D5 FieldBuilder from JSON — src/schema/FieldBuilder.ts (通用 builder + JSON 加载) + 18/18 单测 PASS + └─ 测试累计: 33/33 vitest PASS, 3/3 playwright PASS, typecheck 零警告 + +✓ Week 3 — 5 父命令 + developSystem baseline 回归 (D1–D5 已完成 2026-06-12) + ├─ D1 dm 命令 — list/create/drop/fields (4 子命令, GET/POST/DELETE /system/DataModel/{id}/...) + ├─ D2 dict 命令 — type-list/data-list (2 子命令, GET /system/DictionaryType|/{id}/Data) + ├─ D3 menu + di — list/create/delete (3+1 子命令) — di 镜像 Java DataInterfaceController + ├─ D4 baseline 脚本 — examples/baseline/developSystem/test-form-dev.sh (proof-of-concept) + └─ D5 baseline 回归 — tests/e2e/baseline/developSystem/regression.spec.ts — 4/4 PASS, **20/20 developSystem forms schema 完整** + └─ 测试累计: 33/33 vitest + 7/7 playwright (smoke 3 + developSystem regression 4) PASS, typecheck 零警告 + └─ baseline 覆盖: developSystem 20 张 + workSystem 52 张 = **72 张 form 已验证 schema 完整** (0 差错 API 层) + +✓ Week 4 — workflow + workSystem 53 baseline (D1–D3 已完成 2026-06-12) + ├─ D1 workflow 命令 — list/launch/approve (3 子命令, GET/POST /workflow/template|task|operator) — 24 模板 + 1 todo 跑通 + ├─ D2 workSystem baseline — tests/e2e/baseline/workSystem/regression.spec.ts — 4/4 PASS, **52/52 workSystem forms schema 完整** + └─ D3 (doc + apis 留 W5) + └─ 测试累计: 33/33 vitest + 11/11 playwright (smoke 3 + developSystem 4 + workSystem 4) PASS, typecheck 零警告 + └─ 父命令总计: form / dm / dict / menu / di / workflow = 6 个 (W5 补 doc + apis = 8 个) + +✓ Week 5 — doc + apis + skill 校对 (D1–D3 已完成 2026-06-12) + ├─ D1 doc 命令 — list (扫 docs/{app}/*.html) + ├─ D2 apis 命令 — list (拉 /v3/api-docs, 1297 API 跑通) + └─ D3 skill 校对 — SKILL.md v0.1→v0.5 更新 (8 父命令 / 24 子命令 / 33 单测 / 11 E2E / 72 baseline forms) + └─ 测试累计: 33/33 vitest + 11/11 playwright PASS, typecheck 零警告 + └─ **8 父命令全跑通, v0.5 完工** + +✓ Week 6 — examples 完整化 + 最终集成 (D1–D2 已完成 2026-06-12) + ├─ D1 examples 校对 — 3 个 create-*.sh 加 TS 版已知限制说明 (高级功能用 Java 版兜底) + └─ D2 最终集成 — 33/33 vitest + 11/11 playwright + 8 父命令 + 20 developSystem + 52 workSystem 全 PASS + └─ **v0.5 交付完成, 72 baseline 0 差错** + +## v0.5 交付总结 (W6 末) + +**两件套**: +1. **`dacli` CLI 工具 (TypeScript)** — `$ccWorkDir/dacli/src/cli.ts` + - 8 父命令: form / dm / dict / menu / di / workflow / doc / apis + - 24+ 子命令, 全部 `--ai-help / --example / --source` 友好 + - 复用 web 源码 (60+ jnpfKey + 14 L1 正则 + 39 控件 schema) → src/data/*.json + - FieldBuilder 通用 builder + JSON schema 自动加载 +2. **`.claude/skills/dacli-ts/`** — AI 专用 skill + - SKILL.md (8 父命令速查 + 5 大决策点 + 0 差错验证规范) + - 6 references: commands.md / patterns.md / anti-patterns.md / troubleshooting.md / playwright.md / baseline/ + - 4 examples + baseline/ 框架 + +**0 差错基线验证**: +- 72/72 form schema 完整 (developSystem 20 + workSystem 52, API 层全 0 错) +- 33/33 vitest PASS + 11/11 Playwright PASS + typecheck 0 错 + +**vs Java 版**: +- AI 友好度 ⭐⭐⭐⭐⭐ (vs Java ⭐⭐⭐) +- Schema 真相: data/*.json 自动 (vs Java 53 builder 硬编码) +- 启动: < 500ms (vs Java 100ms native) +- 边缘场景: 仍需 Java 版 (portal/report/codegen 等) +``` + +## Week 1: 脚手架 + 核心管道 + +**目标**: 跑通 `dacli login + form list + form create (type=4) + release (跳过) + form delete` + +| Day | 任务 | 产出 | +|-----|------|------| +| **D1** | 初始化目录、package.json、tsconfig.json、Commander.js 入口 | `npx tsx src/cli.ts --help` 跑通 | +| **D2** | `core/crypto.ts` + 单元测试 | '123456' → 与 web 96 字符 hex | +| **D3** | `core/client.ts` + `commands/login.ts` + `commands/status.ts` | login 成功 + token 持久化 | +| **D4** | `commands/form/{list,info}.ts` + `core/config.ts` | form list 返回 3+ 张 | +| **D5** | `commands/form/{create,release,delete,export,import,clone,validate}.ts` | 端到端 demo 跑通 | + +**必达**: +- [ ] tds 应用 login + form list 跑通 +- [ ] developSystem 也能 login + form list (验证多 app) +- [ ] workSystem 也能 login + form list +- [ ] vitest 跑通 crypto + client 单元测试 + +## Week 2: 提取工具 + Playwright 基础 + +**目标**: data/*.json 全部就位, Playwright 配置好 + +| Day | 任务 | 产出 | +|-----|------|------| +| **D1** | `extractors/component-map.ts` | `data/component-map.json` 60+ 映射 | +| **D2** | `extractors/fields.ts` (vue SFC parse) | `data/field-schemas.json` 39 控件 | +| **D3** | `extractors/l1-rules.ts` + `l2-rules.ts` | validation-rules + l2-rules | +| **D4** | **Playwright 配置** (`playwright.config.ts` + 装 chromium) | `npx playwright --version` 跑通 | +| **D5** | `schema/index.ts` 通用 FieldBuilder + 加载 data/*.json | 53 控件可调 | + +**必达**: +- [ ] 4 个 JSON 文件就位 +- [ ] FieldBuilder 通用加载跑通 +- [ ] Playwright 配置 + 装好 chromium + +## Week 3: 5 父命令 + developSystem 21 张 baseline + +**目标**: developSystem 21 张 baseline 全部 0 错 + +| Day | 任务 | 产出 | +|-----|------|------| +| **D1** | `commands/dm.ts` (list/table/create/update/drop) | 端到端 | +| **D2** | `commands/dict.ts` (type-list/data-list/create) | 端到端 | +| **D3** | `commands/menu.ts` + `commands/di.ts` | 端到端 | +| **D4** | `examples/baseline/init-developSystem.sh` + 21 个 .sh | 21 个 baseline 脚本 | +| **D5** | 21 个 `tests/e2e/baseline/developSystem/*.spec.ts` | **21/21 API 0 错** | + +**必达**: +- [ ] 21 张 developSystem baseline 脚本就位 +- [ ] 21 张 baseline 跑通 API 0 错 +- [ ] **进阶**: 21 张 baseline 跑通 Playwright 0 视觉差 + +## Week 4: workflow + workSystem 53 张 baseline + +**目标**: workSystem 53 张 baseline 全部 0 错 + +| Day | 任务 | 产出 | +|-----|------|------| +| **D1** | `commands/workflow.ts` (list/create/launch/approve) | 端到端 | +| **D2-D3** | `examples/baseline/init-workSystem.sh` + 53 个 .sh | 53 个 baseline 脚本 | +| **D4-D5** | 53 个 `tests/e2e/baseline/workSystem/*.spec.ts` | **53/53 API 0 错** | + +**必达**: +- [ ] 53 张 workSystem baseline 脚本就位 +- [ ] 53 张 baseline 跑通 API 0 错 +- [ ] **进阶**: 53 张 baseline 跑通 Playwright 0 视觉差 + +## Week 5: 帮助体系 + skill 主体 + +**目标**: 帮助体系上线, skill 主体完整 + +| Day | 任务 | 产出 | +|-----|------|------| +| **D1** | `core/help.ts` + 给所有命令加 `--ai-help / --example / --source` | 全部命令支持 | +| **D2** | `commands/doc.ts` (HTML 缓存) | 镜像 Java 版能力 | +| **D3** | `commands/apis.ts` (OpenAPI 抓取) | 镜像 Java 版能力 | +| **D4** | skill `SKILL.md` (已写) 校对 | AI 读后知道何时用 | +| **D5** | skill `references/patterns.md` + `anti-patterns.md` (已写) 校对 | 5+ 模式 + 8+ 反模式 | + +**必达**: +- [ ] 全部命令支持 `--ai-help / --example` +- [ ] `dacli doc / apis` 镜像 Java 版能力 +- [ ] skill 主体 6 references 完整 + +## Week 6: skill examples + AI 自检 + 文档收尾 + +**目标**: skill 完整 + AI 自检通过 + 74 张一键回归 + +| Day | 任务 | 产出 | +|-----|------|------| +| **D1** | `examples/create-simple-form.sh` (单表) | AI 复制粘贴能跑 | +| **D2** | `examples/create-master-sub-form.sh` (主子表) | 同上 | +| **D3** | `examples/create-workflow.sh` (工作流) | 同上 | +| **D4** | **AI 自检**: 把 skill 喂给另一个 Claude, 让它 "用 dacli 完成一个请假流程" | 能跑通 | +| **D5** | 文档收尾 + `examples/baseline/all.sh` 一键回归 | 74 张一键跑 | + +**必达**: +- [ ] 5+ examples 可复制粘贴 +- [ ] AI 自检通过 (1 次对话完成请假流程) +- [ ] 74 张 baseline 一键回归 +- [ ] v1 完成 + +## 每周 commit 节奏 + +| Week | Commit 主题 | +|------|------------| +| W1 | feat: dacli TS 版脚手架 + 核心管道 | +| W2 | feat: 5 个 extractor + Playwright 配置 | +| W3 | feat: 5 父命令 + developSystem 21 baseline | +| W4 | feat: workSystem 53 baseline + workflow | +| W5 | feat: 帮助体系 + skill 主体 | +| W6 | docs: skill 完整 + AI 自检 | + +## 进度跟踪 + +| Week | 状态 | 验收 | +|------|------|------| +| W0 准备 | ✅ | doc + skill 完整 | +| W1 脚手架 | ✅ (D1-D5 done 2026-06-12) | login + form list/info/export 跑通 / 15/15 单测 / typecheck 0 警告 | +| W2 提取 | ✅ (D1-D5 done 2026-06-12) | 60+39+14+9 资产就位 / FieldBuilder 通用 / 33 单测 + 3 E2E 全 PASS | +| W3 5 父命令 + baseline | ✅ (D1-D5 done 2026-06-12) | form/dm/dict/menu/di 全跑通 / 20 developSystem + 52 workSystem form schema 已验证 | +| W4 workSystem 53 + workflow | ✅ (D1-D2 done 2026-06-12) | workflow 3 子命令 + 52/52 workSystem form schema 验证 | +| W5 doc + apis + ai-help | ✅ (D1-D3 done 2026-06-12) | doc/apis 镜像 Java + SKILL.md v0.5 校对 | +| W6 skill 完整 + 集成 | ✅ (D1-D2 done 2026-06-12) | examples 校对 + 33/33 + 11/11 + 72 baseline form 验证 — **v0.5 交付** | + +## 反向链接 + +- [architecture.md](architecture.md) — 设计决策 +- [baseline.md](baseline.md) — 0 差错验证规范 +- [api.md](api.md) — 完整 API +- [extractors.md](extractors.md) — 提取工具 +- [help-system.md](help-system.md) — 帮助体系 +- [../.claude/skills/dacli-ts/SKILL.md](../.claude/skills/dacli-ts/SKILL.md) — AI 技能 +- [../prompt.md](../prompt.md) — 任务说明书 + +--- + +## v0.6 更新 (2026-06-12) + +**关键校准 (用户反馈驱动)**: + +| 项 | v0.5 → v0.6 | +|----|------------| +| form list 真总数 | workSystem 52→**85** / developSystem 20→**29** (修 `/list` 强制 enableFlow=1 bug) | +| baseline schema 验证 | 72→**114** (workSystem 85 + developSystem 29) 真总数全 PASS | +| 浏览器登录入口 | `/web/#/login` (admin 404) → `/jnpf_app_/login` (真路径) | +| 浏览器会话复用 | 每 spec 重登 → Playwright projects.setup + storageState TTL 6h | +| menu create | POST /api/system/Menu (低级易漏字段) → POST /api/visualdev/Base/{formId}/Actions/Module (web 真路径, 自动 moduleId/propertyJson/授权) | +| menu unrelease 新命令 | - → Actions/Module pc=0 app=0 兜底 DELETE /api/system/Menu/X 报"System abnormality" | +| 真业务 vs 预览 | 混用 → `/model/` 真业务能 CRUD, `/previewModel` 只读不能保存 | +| 挂菜单规则 | 隐式 → 至少一个菜单挂 form, `/model/X` 才生效 (vue-router 动态注册) | + +**新增/修改**: +- `src/commands/form/list.ts` + `import.ts`: 改用 `/visualdev/Base` 公开端点 (v0.6 fix) +- `src/commands/menu/create.ts`: 走 web Actions/Module 高级 API (--formId 模式) + 低级 /system/Menu 兜底 +- `src/commands/menu/unrelease.ts`: 新命令, 取消挂菜单 (form-driven) +- `tests/e2e/auth.setup.ts` + `tests/e2e/_helpers/auth.ts`: storageState 模式, TTL 6h +- `tests/e2e/_helpers/auth-reuse.spec.ts`: 验证 storageState 注入 + host-wide 复用 (3 个测试) +- `playwright.config.ts`: 加 `setup` project + `chromium` 依赖 +- `scripts/seed-tds-baseline.ts`: workSystem 5 张代表 → export → tds import (workflow 测试数据) +- baseline regression spec 阈值改 80+/25+ (真总数) +- skill: `references/playwright.md` + `troubleshooting.md` 加 v0.6 5 个新错误 (错误 12-17) +- SKILL.md: 加 v0.6 校准段, 全部用户反馈写进去 + +**当前测试**: +- 33/33 vitest PASS +- 14/14 Playwright PASS + 2 skip + 0 FAIL + - storageState 复用 3 个 + - workSystem 85/85 schema 全 PASS + - developSystem 29/29 schema 全 PASS +- typecheck 0 错 + +**已知遗留 (留 #13/#15 后续)**: +- #13 AI 需求驱动设计 + CRUD 真闭环 (用户校准: 不是机械 import, 是 AI 根据需求自由设计) +- #15 form import 不建底层物理表 → 浏览器报"该表单已删除" +- 5 个 tds 孤儿菜单 (form 已删, DELETE /api/system/Menu/X 报 "System abnormality", web 平台 bug) + diff --git a/doc/v0.6-changelog.md b/doc/v0.6-changelog.md new file mode 100644 index 0000000..b33bdca --- /dev/null +++ b/doc/v0.6-changelog.md @@ -0,0 +1,87 @@ +# v0.6 Changelog (2026-06-12) + +> 用户反馈驱动的 5 大校准 + 内化 ssw-e2e-test 真实路径。 + +## ⭐ Bug 修复 (P0) + +### 1. `dacli form list` 漏 33+ 张 form +- **症状**: workSystem 报 52, 实际 85; developSystem 报 20, 实际 29 +- **根因**: `src/commands/form/list.ts:24` 调 `/visualdev/Base/list` 子端点 — 后端 `VisualdevController.getList` (line 179) 强制 `setEnableFlow(1)` → 只返工作流子集 +- **修**: 改用 `/visualdev/Base` (`VisualdevController.list` line 133, 公开方法) +- **影响**: `src/commands/form/list.ts` + `src/commands/form/import.ts` (反查 id) + +### 2. `dacli menu create` 缺关键字段, 浏览器看不到菜单 +- **症状**: Java 字段版能创菜单但语义不全; 用户校准: "应该按 web/** 怎么写" +- **根因**: 走低级 POST `/api/system/Menu` 漏 moduleId/propertyJson/pageAddress/isXxxAuthorize +- **修**: 优先走 web 真路径 POST `/api/visualdev/Base/{formId}/Actions/Module` (来自 `web/views/onlineDev/formDesign/components/CreateMenuModal.vue handleSubmit`) +- **影响**: `src/commands/menu/create.ts` 重写 (--formId 走 Actions/Module 高级 API) + +### 3. `dacli menu delete` 报 "System abnormality" 删不掉 +- **症状**: 已挂 form 的菜单 (pcIsRelease=1) DELETE 不通 +- **修**: 加 `dacli menu unrelease --formId=X` (Actions/Module pc=0 app=0) +- **影响**: `src/commands/menu/unrelease.ts` 新加 + `index.ts` 注册 + +## ⭐ 浏览器层基础设施 (P1) + +### 4. Playwright `projects.setup` + storageState 会话复用 +- **改前**: 每个 spec 重登 5s+ +- **改后**: setup project 跑一次, ch +romium project 自动注入. TTL 6h. +- **影响**: `playwright.config.ts` + `tests/e2e/auth.setup.ts` + `tests/e2e/_helpers/auth.ts` + `tests/e2e/_helpers/auth-reuse.spec.ts` (3 个验证测试) + +### 5. JNPF 真实 URL 路径内化 (from ssw-e2e-test) +- 登录: `/jnpf_app_/login` (不是 `/web/#/login`) +- 业务: `/jnpf_app_/model/` (能 CRUD 保存) +- 预览: `/previewModel?isPreview=1&id=X` (只读, 不能保存!) +- 字段 ID: `#form_item_account` / `#form_item_password` / `button:has-text("登 录")` (有空格) +- 规则: **挂菜单 + admin 角色授权后**, /model/X 才生效 (vue-router 动态注册) + +## 文件清单 + +**dacli 源码** (5 个文件改/加): +- `src/commands/form/list.ts` (修 endpoint) +- `src/commands/form/import.ts` (修反查 endpoint) +- `src/commands/menu/create.ts` (重写, web 真路径) +- `src/commands/menu/unrelease.ts` (新) +- `src/commands/menu/index.ts` (注册 unrelease) +- `src/core/help.ts` (加 source.ref) + +**测试** (5 个文件改/加): +- `playwright.config.ts` (加 setup project + storageState) +- `tests/e2e/auth.setup.ts` (新, UI 登录持久化) +- `tests/e2e/_helpers/auth.ts` (新, ensureAuth + TTL helper) +- `tests/e2e/_helpers/auth-reuse.spec.ts` (新, 3 个验证) +- `tests/e2e/smoke.spec.ts` (修登录页用空 storageState) +- `tests/e2e/baseline/workSystem/regression.spec.ts` (阈值 50→80) +- `tests/e2e/baseline/developSystem/regression.spec.ts` (阈值 20→25) + +**脚本**: +- `scripts/seed-tds-baseline.ts` (新, workSystem 5 张代表 → export → tds import) + +**技能 + 文档**: +- `.claude/skills/dacli-ts/SKILL.md` (加 v0.6 校准段) +- `.claude/skills/dacli-ts/references/playwright.md` (重写, 内化 ssw-e2e-test 真路径) +- `.claude/skills/dacli-ts/references/troubleshooting.md` (加错误 12-17) +- `doc/plan.md` (加 v0.6 段) +- `doc/v0.6-changelog.md` (本文件) + +## 测试结果 + +- typecheck: **0 错** +- vitest: **33/33 PASS** +- Playwright: **14 PASS + 2 skip + 0 FAIL** (含 storageState 复用 3 个, workSystem 85/85, developSystem 29/29) + +## 已知遗留 (留 #13/#15 后续) + +- **#13 AI 需求驱动设计 + CRUD 真闭环**: 用户校准: 不是机械 import, 而是给 AI 需求描述, 让它用 dacli 自由设计 → 真 CRUD 验证 → 失败反哺 SKILL.md +- **#15 form import 不建底层物理表**: import 只复制元数据, tables[].table 仍指原表名 → 浏览器报"该表单已删除". 临时解: dm create 先建表 / form create --autoTable. 真解: 走 #13. +- **5 个 tds 孤儿菜单**: DELETE /api/system/Menu/X 报 "System abnormality" 删不掉. 这是 web 平台层 bug, 非 dacli 问题. + +## 用户的 4 条核心校准 (本轮的指引) + +1. **测试在 tds 应用, 数据从官方示例 export 复制过去** (不动官方示例) +2. **previewModel 不能真保存** → 必须挂菜单走 /model/X 真业务路径 +3. **不是机械 import, 是 AI 根据需求自由设计** + CRUD 验证 = 真 0 差错 +4. **按 web/** 怎么写, 不是 ssw-dacli 怎么写** (复用 web 源码是 prompt §2.1 初心) + +5. (隐含) 至少一个菜单加入功能表单链接, 否则 /model/xxx 不生效 — JNPF 平台规则 diff --git a/doc/v0.7-changelog.md b/doc/v0.7-changelog.md new file mode 100644 index 0000000..26eb304 --- /dev/null +++ b/doc/v0.7-changelog.md @@ -0,0 +1,164 @@ +# v0.7 Changelog (2026-06-12) + +> 用户校准: "按 web/** 怎么写不是 ssw-dacli 怎么写" → form export/import + dm create + form release 全部对齐 web 真路径. +> **P0 #13 (AI 需求驱动闭环) + P1 #15 (form import 不建表) 双双闭环**. + +--- + +## ⭐ P0 #13: AI 需求驱动设计 + CRUD 真闭环 (用户校准的核心) + +### 测试方法 + +dispatch 一个 subagent (general-purpose), **只准用 dacli-ts 技能**: +- 禁止 switch-app workSystem/developSystem (不许偷答案) +- 禁止 form clone / form import (不许抄) +- 禁止读 workSystem/leaveApply.* / web/views/** / examples/baseline/** +- 中文需求: 员工请假申请 (申请人/部门/类型/起止日期/天数/事由/审批意见) +- 必须用 dacli dm create + form create + menu create 从零搭 + +### 结果 + +✅ **subagent 真闭环**: tds_leave (id=835168490678657989) 完整跑通 + +| 维度 | 结果 | +|------|------| +| 物理表 | `tds_leave` 19 字段 (8 业务 + 2 PK + 9 系统列) 在 dbLinkId=2065323991245033472 | +| form | enCode=tds_leave, type=1, webType=2, state=1 | +| menu | id=835168942048682949, type=3, urlAddress=model/tds_leave | +| URL 访问 | `http://nginx/jnpf_app_tds/model/tds_leave` → HTTP 200 | +| Playwright spec | 4/4 PASS (tests/e2e/p13-ai-driven-crud.spec.ts) | + +### subagent 的 3 个真 bug 发现 + 自补 (全固化到 dacli 源码) + +**Bug 1: `dm create` body 协议错** (修 `src/commands/dm/create.ts`): +- 原: flat `{table, fields, primaryKeyPolicy, ...}` → 后端报 `Cannot invoke DbTableForm.getNewTable() because DbTableFieldDTO.getTableInfo() is null` +- 修: 改为 `{tableInfo: {table, tableName, newTable, ...}, tableFieldList: [...]}` (web `dataModel/Form.vue:218-228` 同款) + +**Bug 2: `dm create` PK 自动补全缺失** (修 `src/commands/dm/create.ts`): +- 原: userFields + sysCols 漏 `primaryKey` → jackson 反序列化成 `null` → `Cannot invoke Integer.intValue() because DbFieldForm.getPrimaryKey() is null` NPE +- 修: userFields 自动补 `primaryKey: 0`, sysCols 全加 `primaryKey: 0`, 另加 2 个复合 PK `f_id` (varchar 50) + `f_tenant_id` (varchar 50) `primaryKey: 1` + +**Bug 3: `form release` endpoint 是错的** (修 `src/commands/form/release.ts` + clone/create/import): +- 原: `PUT /api/visualdev/Base/{id}/Actions/State` 返 200 但 state 没真变 (后端可能只是更新 sortCode) +- 修: 改为 `POST /api/visualdev/Base/{id}/Actions/Release` (web `visualDev.ts:43 release` 真路径) +- 影响 4 个文件: `form/release.ts` + `form/clone.ts` + `form/create.ts` + `form/import.ts` + +### subagent 反馈给 SKILL.md (已固化) + +加 `troubleshooting.md` 错误 18-22 + `anti-patterns.md` 反模式 0: +- 错误 18: dm create primaryKey null NPE +- 错误 19: dm fields 0 字段假象 (`list` vs `fields` parse) +- 错误 20: form release 假成功 (PUT /Actions/State 不发布) +- 错误 21: menu create --formId Actions/Module 失败 → fallback 低级 /system/Menu +- 错误 22: form create type=1/2 不传 --tables 时自动建空表 +- 反模式 0: form create type=1/2 必传 --tables 显式引用已有表 + +--- + +## ⭐ P1 #15: form import 不建底层物理表 + +### 根因 (web 端实际流程) + +读 web `Form.vue:444-465 handleRequest` + `dataModel/Form.vue:218-228 handleSubmit`, 发现: +- **web 不在 form save 时建表** — 只发 POST /api/visualdev/Base +- **tables[].fields[] 是从 DB 实时查的** (`getDataModelFieldList(dbLinkId, tableName)`) — **不在 form JSON 里** +- **web 流程**: 用户先在「数据建模」用 `createDataModel()` 建物理表 → 再在「在线开发」选表 → 保存 + +所以单纯 `form export → form import` 信息不全, tds 业务库找不到物理表 → 浏览器报 "该表单已删除". + +### 修法 (4 处源码联动) + +**1. `src/commands/form/export.ts` 重写**: +- 加 `_physicalSchema` 字段, export 时同时调 `GET /api/system/DataModel/{linkId}/Tables/{table}/Fields?field=*` +- 拉所有 tables[].table 的真实物理 schema 存到 JSON +- 加 `--no-physical` 选项 (兼容旧 export 格式) + +**2. `src/commands/form/import.ts` 重写**: +- 加 `--autoTable` (默认 true) — import 前先建物理表 +- 数据源优先级: `_physicalSchema` (v0.7+ export) > `tables[].fields[]` (老 form 内嵌) +- 加 `--table ` — 主表新名 (默认 enCode 小写) +- 表名映射逻辑: 主表 (typeId='1') 重命名为新 enCode, 子表追加 `_{enCode}` 后缀, formData[].tableName 同步替换 +- 关联表 relationTable 跟随重命名 + +**3. `src/commands/dm/create.ts` 对齐 web 真路径** (同 #13 修法): +- body shape 改 `{tableInfo, tableFieldList}` +- PK 自动补全 (f_id + f_tenant_id 复合 PK) + 9 系统列 + +**4. `src/commands/dm/fields.ts` 解析 bug 修**: +- 后端实际响应 `{ list: [...] }` 不是 `{ fields: [...] }` +- parse 函数兼容 `list / fields / array` 三形态 + +### 端到端验证 + +```bash +# 1. 从 developSystem 导一个有物理表的 form +npx tsx src/cli.ts switch-app --appCode=developSystem +npx tsx src/cli.ts form export 833736669482983301 --out=/tmp/p15-test.json +# → 已导出 test_parent_child → /tmp/p15-test.json (9.0 KB, 含 0 张物理表 schema) +# (这张 dbLinkId 已下线, _physicalSchema 拉不到, 但 tables[].fields[] 内嵌有) + +# 2. 切 tds + import 触发 autoTable 走 tables[].fields[] fallback +npx tsx src/cli.ts switch-app --appCode=tds +npx tsx src/cli.ts form import /tmp/p15-test.json --enCode=p15_singletable_v2 --table=p15_singletable_v2 +# → autoTable: 在 dbLinkId=2065323991245033472 重建 1 张物理表 +# → 建表 p15_singletable_v2 (字段 ×7) +# → 导入成功 id=835166593053893573 enCode=p15_singletable_v2 dbLinkId=2065323991245033472 + +# 3. 验证物理表 + 字段 +npx tsx src/cli.ts dm list # → p15_singletable_v2 test_parent_child +npx tsx src/cli.ts dm fields --table=p15_singletable_v2 # → 字段数=7 (f_name + 6 系统列) +``` + +✅ 物理表 + 字段都在 tds, 表名映射 `test_parent_child → p15_singletable_v2` 正确生效. + +--- + +## 测试结果 (本轮最终) + +| 项 | 结果 | +|------|------| +| typecheck | **0 错** | +| vitest | **33/33 PASS** (FieldBuilder 18 + crypto 5 + config 5 + cli-help 5) | +| Playwright | **18 PASS + 2 skip + 0 FAIL** (含 setup 1 + storageState 2 + smoke 3 + developSystem 4 + workSystem 4 + **#13 spec 4/4**) | + +--- + +## 文件清单 + +**dacli 源码** (6 个文件改, 4 真 bug 修): +- `src/commands/form/export.ts` (重写, 加 `_physicalSchema`) +- `src/commands/form/import.ts` (重写, `--autoTable` + 表名映射 + 回退 + release 端点修) +- `src/commands/form/release.ts` (修 PUT /Actions/State → POST /Actions/Release) +- `src/commands/form/clone.ts` (同上 release 端点修) +- `src/commands/form/create.ts` (同上 release 端点修) +- `src/commands/dm/create.ts` (重写 body shape + 补 PK + 9 系统列) +- `src/commands/dm/fields.ts` (parse 兼容 list/fields/array) + +**测试** (1 新): +- `tests/e2e/p13-ai-driven-crud.spec.ts` (4 个 P0 #13 验收 - /model URL + form info + dm fields + menu list) + +**文档/skill** (4 个): +- `.claude/skills/dacli-ts/SKILL.md` (加 v0.7 校准段) +- `.claude/skills/dacli-ts/references/troubleshooting.md` (加错误 18-22) +- `.claude/skills/dacli-ts/references/anti-patterns.md` (加反模式 0) +- `doc/v0.7-changelog.md` (本文件) +- `doc/RESUME.md` (本轮后更新) + +--- + +## 用户的 5 条核心校准 (本轮的指引) + +1. **测试在 tds 应用** (v0.6 已落) +2. **previewModel 不能真保存** → 必须挂菜单走 /model/X 真业务路径 (v0.6 已落) +3. **不是机械 import, 是 AI 根据需求自由设计** + CRUD 验证 → **v0.7 #13 闭环** +4. **按 web/** 怎么写, 不是 ssw-dacli 怎么写** → **v0.7 form export/import + dm create + form release 全部对齐 web 真路径** +5. 至少一个菜单加入功能表单链接, 否则 /model/xxx 不生效 (v0.6 已落) + +--- + +## 已知遗留 + +- **#16 Playwright UI CRUD 真点击**: 当前 #13 只验 API + 页面能开, 还要写 UI 真填写 → 保存 → 列表 → 编辑 → 删除 spec +- **examples/baseline/all.sh 真一键 72 张**: prompt W5-D5 留尾, 当前只有 regression API spec +- **5 个 tds 孤儿菜单**: 平台层 DELETE bug, dacli menu unrelease 是 workaround (v0.6 已记录) +- **menu create Actions/Module 在 tds 报 System abnormality**: 退到低级路径可用, web 真路径在 tds 业务库的 root cause 待查 diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..15ea633 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,2782 @@ +{ + "name": "dacli-ts", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "dacli-ts", + "version": "0.1.0", + "dependencies": { + "@vue/compiler-sfc": "^3.5.0", + "commander": "^12.1.0", + "crypto-js": "^4.2.0", + "vue": "^3.5.0" + }, + "bin": { + "dacli": "src/cli.ts" + }, + "devDependencies": { + "@playwright/test": "^1.48.0", + "@types/better-sqlite3": "^7.6.11", + "@types/crypto-js": "^4.2.2", + "@types/node": "^22.0.0", + "pixelmatch": "^6.0.0", + "tsx": "^4.19.0", + "typescript": "^5.6.0", + "vitest": "^2.1.0" + }, + "engines": { + "node": ">=20" + }, + "optionalDependencies": { + "better-sqlite3": "^11.3.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", + "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.7.tgz", + "integrity": "sha512-hnORnjP/1P/zFEndoeX+n+t1RwWRJiJpM/jO7FW32Kn9r5+sJB2JWOdYo4L6k78j15eCwY3Gm/7364B1EMwtNg==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.7" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.7.tgz", + "integrity": "sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.1.tgz", + "integrity": "sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.1.tgz", + "integrity": "sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.1.tgz", + "integrity": "sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.1.tgz", + "integrity": "sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.1.tgz", + "integrity": "sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.1.tgz", + "integrity": "sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.1.tgz", + "integrity": "sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.1.tgz", + "integrity": "sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.1.tgz", + "integrity": "sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.1.tgz", + "integrity": "sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.1.tgz", + "integrity": "sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.1.tgz", + "integrity": "sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.1.tgz", + "integrity": "sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.1.tgz", + "integrity": "sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.1.tgz", + "integrity": "sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.1.tgz", + "integrity": "sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.1.tgz", + "integrity": "sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.1.tgz", + "integrity": "sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.1.tgz", + "integrity": "sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.1.tgz", + "integrity": "sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.1.tgz", + "integrity": "sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.1.tgz", + "integrity": "sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.1.tgz", + "integrity": "sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.1.tgz", + "integrity": "sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.1.tgz", + "integrity": "sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.1.tgz", + "integrity": "sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "license": "MIT" + }, + "node_modules/@playwright/test": { + "version": "1.60.0", + "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.60.0.tgz", + "integrity": "sha512-O71yZIbAh/PxDMNGns37GHBIfrVkEVyn+AXyIa5dOTfb4/xNvRWV+Vv/NMbNCtODB/pO7vLlF2OTmMVLhmr7Ag==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright": "1.60.0" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.61.1.tgz", + "integrity": "sha512-JnBB8MdXj45cajvTuO5FmPlvFVJRQgvrz1uSEl3NwqFnReAPGwb8EanbGi4z2nRaqLzjJSv5/JmycoTKlRZxHA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.61.1.tgz", + "integrity": "sha512-Jx2g7iSjw4AOT0HDPHM9RV3GNjRXwybWtSFZiZAYUTjUwjVrYIwq3kBf+LnhqJlzXFAqTAh2F7IGI+O568exPw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.61.1.tgz", + "integrity": "sha512-0F1L/Z3Eqv8mT2n3dCpeO8GcTvHvVqkP5/t6DMsn0KzhYVcg+s7Ncl5DS8qjKYEeio6Az0Gt6nyBORay5qIlCA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.61.1.tgz", + "integrity": "sha512-qLttcH871ujY4YcVfUSShhOw+CsoTatYz8gRbHO7Bb92QH059/P0y5do1KMs41fY0BpD2x4AJH/gID0zFiqVKQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.61.1.tgz", + "integrity": "sha512-fUI4RapGE0Oh3mb8mgfvC1O2nU1RpDZUKnDQm3xB1Ipg7C2wTs5Kstz7G2uWK99a8S2yTMq8/P4uycwNa0nJyw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.61.1.tgz", + "integrity": "sha512-H5YrdvJaDtI/U9/emrD4b++xkvp3y/JvOe4rizHbxvkyMfRS/CiRYdji+Pl8D0brEaNFWUh1drQxgAGIl6Xudw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.61.1.tgz", + "integrity": "sha512-Q8CBCCQtDFrYtXoeUXSrnFXKOnyUhx6bz+SkL6A0E7V8kAiCJ5pamq1WtbfpVGhR5TSpXY6ak3avmDc5fHTyJA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.61.1.tgz", + "integrity": "sha512-nwnhk1581l0FBVellGcVCAT0Oi06onEA3WB53sf01VO3I0UPBkMH9sXONYME2K0ovXcNayJfNtHfm6mpJElatQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.61.1.tgz", + "integrity": "sha512-x5Xr49hwt3hdW75UOZm3395YwwzPyauktslv29KpWL/T+vVAzoT3azLcTWv0eMciBNrx+DYjH4paehHoLpPvpg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.61.1.tgz", + "integrity": "sha512-unMS3H73DpaoPyyEVPjGKleM/s0mkmsauTENpw4INQY8y4+IuLNjkueQ5QCtC0D3N38Y38yhAU8OoZ20S2Tm6w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.61.1.tgz", + "integrity": "sha512-zNZzGRnAhwjFEYmvphJRV5XaQGjs62cCmeYYHUT//NbvEnHauw+I85nGG+SiVg5ld4GX8D1IbKIX+ozITQnhMQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.61.1.tgz", + "integrity": "sha512-LdpWGL8X209B2SIvWjqlc8VZgM6PKfontSerGepuldQmHYrAOtnMCXeJkxXGbC+PPZVOuu5czJo7fNV6aeW8rQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.61.1.tgz", + "integrity": "sha512-EC5kTtNaNGOmbMGqar8dvJy6y/hg99GAwjfBz++pxZhQATXGcRjd6c5en5wcbru0vkRmiMGsQKdMJOOf6sza4g==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.61.1.tgz", + "integrity": "sha512-8hiwp6D4acEcNK78I4rP0/XtS1sknWIAMJBPdR4l6zUtyTm5KiTDr5bXmWt4foY7nAN7AThDHgkLIEZOWKbzWw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.61.1.tgz", + "integrity": "sha512-10dh/h/BqA7DuMPWSxkR8uks18FRwnwOEqr5zOTEl+NOwP/OMzKX8OFR/Of9xxDA7D5qef1Nzar5WDD2kCCr1g==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.61.1.tgz", + "integrity": "sha512-YKJ5lg35DP17gcAOggnihe+APw9HLyj1Xn7gsmGumBJAUDa6NGXNixJzmkWLhcK9TOuuyQjdamzvJefkO7qHZQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.61.1.tgz", + "integrity": "sha512-Mlil5G2Jj6a7B3LWGctg+XPL9vdXYuzCtNXfxOQ0nPjc2m6ueUktocPGH9bnAM0bNRKb/bAWTujUU7IJQdQA+g==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.61.1.tgz", + "integrity": "sha512-bVWIOIk6pV01p4CdUbPP7CJ/434z+OooYjDuFcR+44N35YvKUC66G8MGnvcWx5mWKW3g61J+t74l3Kj15Kwn2Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.61.1.tgz", + "integrity": "sha512-qy5pBvZbqNFheBz61R1rzsezjm0J7O2oNGoWtGoY89SZYLUfxAJTBAqDChqAIdB4rCiIbi9nF7yZ83GnNiLwSw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.61.1.tgz", + "integrity": "sha512-E83TXjI4zm0+5f2qO+UOudaCYIhYwpJ5jq6YCZNIZ+6CbfhKrkAGezeiASBL9ElxAxFsRS9ZhESv8mfnj6TKeg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.61.1.tgz", + "integrity": "sha512-fbWnKqVkjrJN38vNe3ahkbk6iejS/3b0Nt7EEtPpE6RBacZcGXNKbzfHN3GUUlXOPghUg0j6XUGrtjX9z1sIvA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.61.1.tgz", + "integrity": "sha512-ArMl38iVAbk0New1ogihQNY6iphLi4ZaRsa037gUzv5yeKPY8TD3Dmy4x2RNC1VztU/uqm+G+/RwFrSka3Oy2g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.61.1.tgz", + "integrity": "sha512-0mYtjHS9ucAbcATycCNK9IGBk/cCe/ma7EmSLGZdsxnOA8cjRIyU04wDpVAD9NiOfLUR9KTxdiO53uOkherqjQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.61.1.tgz", + "integrity": "sha512-gK1iCEPfpoSG9wfBihXxvBMi8ZfcWffYkEsC/Eih+iFENTaewvNcrEQ69lIOWYO5pePHKLHHO7nq5AILGO/HQQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.61.1.tgz", + "integrity": "sha512-X+zaP2x+j4RXGfbp/seSoRHWnPxzApilDszisZxbYH5C/jTxFhCtDNdPGZb9lJyYPs24wGxruPF7Y+sIXt9Gzw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/better-sqlite3": { + "version": "7.6.13", + "resolved": "https://registry.npmjs.org/@types/better-sqlite3/-/better-sqlite3-7.6.13.tgz", + "integrity": "sha512-NMv9ASNARoKksWtsq/SHakpYAYnhBrQgGD8zkLYk/jaK8jUGn08CfEdTRgYhMypUQAfzSP8W6gNLe0q19/t4VA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/crypto-js": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/@types/crypto-js/-/crypto-js-4.2.2.tgz", + "integrity": "sha512-sDOLlVbHhXpAUAL0YHDUUwDZf3iN4Bwi4W6a0W0b+QcAezUbRtH4FVb+9J4h+XFPW7l/gQ9F8qC7P+Ec4k8QVQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "22.19.21", + "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.21.tgz", + "integrity": "sha512-VMeFBSCKQKmm2swI2kW51SFusDqekC6q9trBCvJ/JliDchFSuoYYKN7yVNjPthP1HKZcx3U1gI/wTcEBjEFKTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/@vitest/expect": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-2.1.9.tgz", + "integrity": "sha512-UJCIkTBenHeKT1TTlKMJWy1laZewsRIzYighyYiJKZreqtdxSos/S1t+ktRMQWu2CKqaarrkeszJx1cgC5tGZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/spy": "2.1.9", + "@vitest/utils": "2.1.9", + "chai": "^5.1.2", + "tinyrainbow": "^1.2.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/mocker": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-2.1.9.tgz", + "integrity": "sha512-tVL6uJgoUdi6icpxmdrn5YNo3g3Dxv+IHJBr0GXHaEdTcw3F+cPKnsXFhli6nO+f/6SDKPHEK1UN+k+TQv0Ehg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/spy": "2.1.9", + "estree-walker": "^3.0.3", + "magic-string": "^0.30.12" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "msw": "^2.4.9", + "vite": "^5.0.0" + }, + "peerDependenciesMeta": { + "msw": { + "optional": true + }, + "vite": { + "optional": true + } + } + }, + "node_modules/@vitest/mocker/node_modules/estree-walker": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", + "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + } + }, + "node_modules/@vitest/pretty-format": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-2.1.9.tgz", + "integrity": "sha512-KhRIdGV2U9HOUzxfiHmY8IFHTdqtOhIzCpd8WRdJiE7D/HUcZVD0EgQCVjm+Q9gkUXWgBvMmTtZgIG48wq7sOQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "tinyrainbow": "^1.2.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/runner": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-2.1.9.tgz", + "integrity": "sha512-ZXSSqTFIrzduD63btIfEyOmNcBmQvgOVsPNPe0jYtESiXkhd8u2erDLnMxmGrDCwHCCHE7hxwRDCT3pt0esT4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/utils": "2.1.9", + "pathe": "^1.1.2" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/snapshot": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-2.1.9.tgz", + "integrity": "sha512-oBO82rEjsxLNJincVhLhaxxZdEtV0EFHMK5Kmx5sJ6H9L183dHECjiefOAdnqpIgT5eZwT04PoggUnW88vOBNQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "2.1.9", + "magic-string": "^0.30.12", + "pathe": "^1.1.2" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/spy": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-2.1.9.tgz", + "integrity": "sha512-E1B35FwzXXTs9FHNK6bDszs7mtydNi5MIfUWpceJ8Xbfb1gBMscAnwLbEu+B44ed6W3XjL9/ehLPHR1fkf1KLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "tinyspy": "^3.0.2" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/utils": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-2.1.9.tgz", + "integrity": "sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "2.1.9", + "loupe": "^3.1.2", + "tinyrainbow": "^1.2.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vue/compiler-core": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.38.tgz", + "integrity": "sha512-s99aGxWYig9ErHbct27KXEGhrBYlRI6c4MwAgXErOAbX9xiW37/uMa+XUDO69zLz83dng8UUZ70CTOJrLrYrEQ==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.7", + "@vue/shared": "3.5.38", + "entities": "^7.0.1", + "estree-walker": "^2.0.2", + "source-map-js": "^1.2.1" + } + }, + "node_modules/@vue/compiler-dom": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.38.tgz", + "integrity": "sha512-JTqp25l8aFfJYF7/KmsXZjAxJz7T+SjmTJLoXVjHtc2BrSgSiW2n9Aem/cWq1OPe68A8JL06B3eVdhlP0H4TVw==", + "license": "MIT", + "dependencies": { + "@vue/compiler-core": "3.5.38", + "@vue/shared": "3.5.38" + } + }, + "node_modules/@vue/compiler-sfc": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.38.tgz", + "integrity": "sha512-DuA2GiZawSEW442iw/9+Fkol8hTgb4Ke5KkhmSry65QA7YuyMbIdy8p0XZRMvNwJdgRz307W8g1CSzdvS4nuNg==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.7", + "@vue/compiler-core": "3.5.38", + "@vue/compiler-dom": "3.5.38", + "@vue/compiler-ssr": "3.5.38", + "@vue/shared": "3.5.38", + "estree-walker": "^2.0.2", + "magic-string": "^0.30.21", + "postcss": "^8.5.15", + "source-map-js": "^1.2.1" + } + }, + "node_modules/@vue/compiler-ssr": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.38.tgz", + "integrity": "sha512-7s+W5Gc42FGxZMcuwl8H5B29T8BJPMdBT7KHFE+BbAuZ/iTEdTtv7z2XiMjiaUUw4w3ZcCEdHs36RuYJ2VA7bA==", + "license": "MIT", + "dependencies": { + "@vue/compiler-dom": "3.5.38", + "@vue/shared": "3.5.38" + } + }, + "node_modules/@vue/reactivity": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.38.tgz", + "integrity": "sha512-pG6LV/NDNRbKizcUjFFLAfjaL8mcv4DmR9avNcUw2gDHBzZneuS2TWCmp633ynzxz9YYKNeEPK2I8Wraqy2HUQ==", + "license": "MIT", + "dependencies": { + "@vue/shared": "3.5.38" + } + }, + "node_modules/@vue/runtime-core": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.38.tgz", + "integrity": "sha512-iyW8WVfF1CpCXxncZY5Ei6rSd6oZr5DgEom//fUjRBRl56AXPD+s9ATvukRt77ZFTuYlnVA1bxY+dJB94tWVYw==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.38", + "@vue/shared": "3.5.38" + } + }, + "node_modules/@vue/runtime-dom": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.38.tgz", + "integrity": "sha512-apX2wt9sdfDshS+a2xueFZLVpt0GkRJZSoPmrW/SA4yzXTznhfcMVW59gr7h4YQeY0vJhdJkk2rsIDwgfFgC5A==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.38", + "@vue/runtime-core": "3.5.38", + "@vue/shared": "3.5.38", + "csstype": "^3.2.3" + } + }, + "node_modules/@vue/server-renderer": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.38.tgz", + "integrity": "sha512-vue8vbf2QlV4quHqzwmJy6dWfmRhP1J8l4wtZg60CL6VoKqcPY2oe7may3+1d9qfpedjK5PRLFqd5k3Isj9mUw==", + "license": "MIT", + "dependencies": { + "@vue/compiler-ssr": "3.5.38", + "@vue/shared": "3.5.38" + }, + "peerDependencies": { + "vue": "3.5.38" + } + }, + "node_modules/@vue/shared": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.38.tgz", + "integrity": "sha512-FTW0AFZNaK5/mOqvGBwVfUlNLU38TiQn4+DQgIFUnrBBJQ1crMJ82yeGQLV5jyKFsO8yRukpbuP7x+nRbH6aug==", + "license": "MIT" + }, + "node_modules/assertion-error": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz", + "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + } + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "optional": true + }, + "node_modules/better-sqlite3": { + "version": "11.10.0", + "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.10.0.tgz", + "integrity": "sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "dependencies": { + "bindings": "^1.5.0", + "prebuild-install": "^7.1.1" + } + }, + "node_modules/bindings": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", + "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "file-uri-to-path": "1.0.0" + } + }, + "node_modules/bl": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", + "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", + "license": "MIT", + "optional": true, + "dependencies": { + "buffer": "^5.5.0", + "inherits": "^2.0.4", + "readable-stream": "^3.4.0" + } + }, + "node_modules/buffer": { + "version": "5.7.1", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", + "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "optional": true, + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.1.13" + } + }, + "node_modules/cac": { + "version": "6.7.14", + "resolved": "https://registry.npmjs.org/cac/-/cac-6.7.14.tgz", + "integrity": "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/chai": { + "version": "5.3.3", + "resolved": "https://registry.npmjs.org/chai/-/chai-5.3.3.tgz", + "integrity": "sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==", + "dev": true, + "license": "MIT", + "dependencies": { + "assertion-error": "^2.0.1", + "check-error": "^2.1.1", + "deep-eql": "^5.0.1", + "loupe": "^3.1.0", + "pathval": "^2.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/check-error": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/check-error/-/check-error-2.1.3.tgz", + "integrity": "sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 16" + } + }, + "node_modules/chownr": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", + "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==", + "license": "ISC", + "optional": true + }, + "node_modules/commander": { + "version": "12.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz", + "integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==", + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/crypto-js": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/crypto-js/-/crypto-js-4.2.0.tgz", + "integrity": "sha512-KALDyEYgpY+Rlob/iriUtjV6d5Eq+Y191A5g4UqLAi8CyGP9N1+FdVbkc1SxKc2r4YAYqG8JzO2KGL+AizD70Q==", + "license": "MIT" + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "license": "MIT" + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/decompress-response": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", + "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "mimic-response": "^3.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/deep-eql": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-5.0.2.tgz", + "integrity": "sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/deep-extend": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", + "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "license": "Apache-2.0", + "optional": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/end-of-stream": { + "version": "1.4.5", + "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz", + "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==", + "license": "MIT", + "optional": true, + "dependencies": { + "once": "^1.4.0" + } + }, + "node_modules/entities": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz", + "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/es-module-lexer": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz", + "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==", + "dev": true, + "license": "MIT" + }, + "node_modules/esbuild": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.1.tgz", + "integrity": "sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.28.1", + "@esbuild/android-arm": "0.28.1", + "@esbuild/android-arm64": "0.28.1", + "@esbuild/android-x64": "0.28.1", + "@esbuild/darwin-arm64": "0.28.1", + "@esbuild/darwin-x64": "0.28.1", + "@esbuild/freebsd-arm64": "0.28.1", + "@esbuild/freebsd-x64": "0.28.1", + "@esbuild/linux-arm": "0.28.1", + "@esbuild/linux-arm64": "0.28.1", + "@esbuild/linux-ia32": "0.28.1", + "@esbuild/linux-loong64": "0.28.1", + "@esbuild/linux-mips64el": "0.28.1", + "@esbuild/linux-ppc64": "0.28.1", + "@esbuild/linux-riscv64": "0.28.1", + "@esbuild/linux-s390x": "0.28.1", + "@esbuild/linux-x64": "0.28.1", + "@esbuild/netbsd-arm64": "0.28.1", + "@esbuild/netbsd-x64": "0.28.1", + "@esbuild/openbsd-arm64": "0.28.1", + "@esbuild/openbsd-x64": "0.28.1", + "@esbuild/openharmony-arm64": "0.28.1", + "@esbuild/sunos-x64": "0.28.1", + "@esbuild/win32-arm64": "0.28.1", + "@esbuild/win32-ia32": "0.28.1", + "@esbuild/win32-x64": "0.28.1" + } + }, + "node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/expand-template": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", + "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", + "license": "(MIT OR WTFPL)", + "optional": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/expect-type": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.3.0.tgz", + "integrity": "sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/file-uri-to-path": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", + "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==", + "license": "MIT", + "optional": true + }, + "node_modules/fs-constants": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", + "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==", + "license": "MIT", + "optional": true + }, + "node_modules/fsevents": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz", + "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/github-from-package": { + "version": "0.0.0", + "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", + "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==", + "license": "MIT", + "optional": true + }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause", + "optional": true + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC", + "optional": true + }, + "node_modules/ini": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", + "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", + "license": "ISC", + "optional": true + }, + "node_modules/loupe": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/loupe/-/loupe-3.2.1.tgz", + "integrity": "sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/mimic-response": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz", + "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "license": "MIT", + "optional": true, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/mkdirp-classic": { + "version": "0.5.3", + "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", + "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==", + "license": "MIT", + "optional": true + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.12", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz", + "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/napi-build-utils": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz", + "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==", + "license": "MIT", + "optional": true + }, + "node_modules/node-abi": { + "version": "3.92.0", + "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.92.0.tgz", + "integrity": "sha512-KdHvFWZjEKDf0cakgFjebl371GPsISX2oZHcuyKqM7DtogIsHrqKeLTo8wBHxaXRAQlY2PsPlZmfo+9ZCxEREQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "semver": "^7.3.5" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "license": "ISC", + "optional": true, + "dependencies": { + "wrappy": "1" + } + }, + "node_modules/pathe": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz", + "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/pathval": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/pathval/-/pathval-2.0.1.tgz", + "integrity": "sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 14.16" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/pixelmatch": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/pixelmatch/-/pixelmatch-6.0.0.tgz", + "integrity": "sha512-FYpL4XiIWakTnIqLqvt3uN4L9B3TsuHIvhLILzTiJZMJUsGvmKNeL4H3b6I99LRyerK9W4IuOXw+N28AtRgK2g==", + "dev": true, + "license": "ISC", + "dependencies": { + "pngjs": "^7.0.0" + }, + "bin": { + "pixelmatch": "bin/pixelmatch" + } + }, + "node_modules/playwright": { + "version": "1.60.0", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.60.0.tgz", + "integrity": "sha512-hheHdokM8cdqCb0lcE3s+zT4t4W+vvjpGxsZlDnikarzx8tSzMebh3UiFtgqwFwnTnjYQcsyMF8ei2mCO/tpeA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright-core": "1.60.0" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "fsevents": "2.3.2" + } + }, + "node_modules/playwright-core": { + "version": "1.60.0", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.60.0.tgz", + "integrity": "sha512-9bW6zvX/m0lEbgTKJ6YppOKx8H3VOPBMOCFh2irXFOT4BbHgrx5hPjwJYLT40Lu+4qtD36qKc/Hn56StUW57IA==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "playwright-core": "cli.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/pngjs": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/pngjs/-/pngjs-7.0.0.tgz", + "integrity": "sha512-LKWqWJRhstyYo9pGvgor/ivk2w94eSjE3RGVuzLGlr3NmD8bf7RcYGze1mNdEHRP6TRP6rMuDHk5t44hnTRyow==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.19.0" + } + }, + "node_modules/postcss": { + "version": "8.5.15", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.15.tgz", + "integrity": "sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.12", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/prebuild-install": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz", + "integrity": "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==", + "deprecated": "No longer maintained. Please contact the author of the relevant native addon; alternatives are available.", + "license": "MIT", + "optional": true, + "dependencies": { + "detect-libc": "^2.0.0", + "expand-template": "^2.0.3", + "github-from-package": "0.0.0", + "minimist": "^1.2.3", + "mkdirp-classic": "^0.5.3", + "napi-build-utils": "^2.0.0", + "node-abi": "^3.3.0", + "pump": "^3.0.0", + "rc": "^1.2.7", + "simple-get": "^4.0.0", + "tar-fs": "^2.0.0", + "tunnel-agent": "^0.6.0" + }, + "bin": { + "prebuild-install": "bin.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/pump": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.4.tgz", + "integrity": "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==", + "license": "MIT", + "optional": true, + "dependencies": { + "end-of-stream": "^1.1.0", + "once": "^1.3.1" + } + }, + "node_modules/rc": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", + "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", + "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", + "optional": true, + "dependencies": { + "deep-extend": "^0.6.0", + "ini": "~1.3.0", + "minimist": "^1.2.0", + "strip-json-comments": "~2.0.1" + }, + "bin": { + "rc": "cli.js" + } + }, + "node_modules/readable-stream": { + "version": "3.6.2", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", + "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", + "license": "MIT", + "optional": true, + "dependencies": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/rollup": { + "version": "4.61.1", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.61.1.tgz", + "integrity": "sha512-I4KW6iuRpuu2uHBLraZ1wNZe0DP7lnRha+VJ9tNaYVaVgKhW0aI3h4RYnoRPeql0flHm/Co55b7snEDcOfOJrA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.9" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.61.1", + "@rollup/rollup-android-arm64": "4.61.1", + "@rollup/rollup-darwin-arm64": "4.61.1", + "@rollup/rollup-darwin-x64": "4.61.1", + "@rollup/rollup-freebsd-arm64": "4.61.1", + "@rollup/rollup-freebsd-x64": "4.61.1", + "@rollup/rollup-linux-arm-gnueabihf": "4.61.1", + "@rollup/rollup-linux-arm-musleabihf": "4.61.1", + "@rollup/rollup-linux-arm64-gnu": "4.61.1", + "@rollup/rollup-linux-arm64-musl": "4.61.1", + "@rollup/rollup-linux-loong64-gnu": "4.61.1", + "@rollup/rollup-linux-loong64-musl": "4.61.1", + "@rollup/rollup-linux-ppc64-gnu": "4.61.1", + "@rollup/rollup-linux-ppc64-musl": "4.61.1", + "@rollup/rollup-linux-riscv64-gnu": "4.61.1", + "@rollup/rollup-linux-riscv64-musl": "4.61.1", + "@rollup/rollup-linux-s390x-gnu": "4.61.1", + "@rollup/rollup-linux-x64-gnu": "4.61.1", + "@rollup/rollup-linux-x64-musl": "4.61.1", + "@rollup/rollup-openbsd-x64": "4.61.1", + "@rollup/rollup-openharmony-arm64": "4.61.1", + "@rollup/rollup-win32-arm64-msvc": "4.61.1", + "@rollup/rollup-win32-ia32-msvc": "4.61.1", + "@rollup/rollup-win32-x64-gnu": "4.61.1", + "@rollup/rollup-win32-x64-msvc": "4.61.1", + "fsevents": "~2.3.2" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "optional": true + }, + "node_modules/semver": { + "version": "7.8.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.4.tgz", + "integrity": "sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==", + "license": "ISC", + "optional": true, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/siginfo": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz", + "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==", + "dev": true, + "license": "ISC" + }, + "node_modules/simple-concat": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz", + "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "optional": true + }, + "node_modules/simple-get": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz", + "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "optional": true, + "dependencies": { + "decompress-response": "^6.0.0", + "once": "^1.3.1", + "simple-concat": "^1.0.0" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/stackback": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz", + "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==", + "dev": true, + "license": "MIT" + }, + "node_modules/std-env": { + "version": "3.10.0", + "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz", + "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==", + "dev": true, + "license": "MIT" + }, + "node_modules/string_decoder": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", + "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", + "license": "MIT", + "optional": true, + "dependencies": { + "safe-buffer": "~5.2.0" + } + }, + "node_modules/strip-json-comments": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", + "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/tar-fs": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.4.tgz", + "integrity": "sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "chownr": "^1.1.1", + "mkdirp-classic": "^0.5.2", + "pump": "^3.0.0", + "tar-stream": "^2.1.4" + } + }, + "node_modules/tar-stream": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz", + "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "bl": "^4.0.3", + "end-of-stream": "^1.4.1", + "fs-constants": "^1.0.0", + "inherits": "^2.0.3", + "readable-stream": "^3.1.1" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/tinybench": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz", + "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinyexec": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-0.3.2.tgz", + "integrity": "sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinypool": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/tinypool/-/tinypool-1.1.1.tgz", + "integrity": "sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.0.0 || >=20.0.0" + } + }, + "node_modules/tinyrainbow": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-1.2.0.tgz", + "integrity": "sha512-weEDEq7Z5eTHPDh4xjX789+fHfF+P8boiFB+0vbWzpbnbsEr/GRaohi/uMKxg8RZMXnl1ItAi/IUHWMsjDV7kQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/tinyspy": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/tinyspy/-/tinyspy-3.0.2.tgz", + "integrity": "sha512-n1cw8k1k0x4pgA2+9XrOkFydTerNcJ1zWCO5Nn9scWHTD+5tp8dghT2x1uduQePZTZgd3Tupf+x9BxJjeJi77Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/tsx": { + "version": "4.22.4", + "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.22.4.tgz", + "integrity": "sha512-X8EX+XV4QR5xCsrgxaED954zTDfY8KqlDtskKEL0cHhyS/P8b4IFOvGDQpsC9Q1XnLq915wEfwwY/zzskCtmhg==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "~0.28.0" + }, + "bin": { + "tsx": "dist/cli.mjs" + }, + "engines": { + "node": ">=18.0.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + } + }, + "node_modules/tsx/node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/tunnel-agent": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", + "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "safe-buffer": "^5.0.1" + }, + "engines": { + "node": "*" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "devOptional": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici-types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT", + "optional": true + }, + "node_modules/vite": { + "version": "5.4.21", + "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz", + "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.21.3", + "postcss": "^8.4.43", + "rollup": "^4.20.0" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || >=20.0.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.4.0" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + } + } + }, + "node_modules/vite-node": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/vite-node/-/vite-node-2.1.9.tgz", + "integrity": "sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==", + "dev": true, + "license": "MIT", + "dependencies": { + "cac": "^6.7.14", + "debug": "^4.3.7", + "es-module-lexer": "^1.5.4", + "pathe": "^1.1.2", + "vite": "^5.0.0" + }, + "bin": { + "vite-node": "vite-node.mjs" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/vite/node_modules/@esbuild/aix-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz", + "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/android-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz", + "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/android-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz", + "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/android-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz", + "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/darwin-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz", + "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/darwin-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz", + "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/freebsd-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz", + "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/freebsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz", + "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz", + "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz", + "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz", + "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-loong64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz", + "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-mips64el": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz", + "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz", + "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-riscv64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz", + "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-s390x": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz", + "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz", + "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/netbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz", + "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/openbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz", + "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/sunos-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz", + "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/win32-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz", + "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/win32-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz", + "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/@esbuild/win32-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz", + "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/vite/node_modules/esbuild": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz", + "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=12" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.21.5", + "@esbuild/android-arm": "0.21.5", + "@esbuild/android-arm64": "0.21.5", + "@esbuild/android-x64": "0.21.5", + "@esbuild/darwin-arm64": "0.21.5", + "@esbuild/darwin-x64": "0.21.5", + "@esbuild/freebsd-arm64": "0.21.5", + "@esbuild/freebsd-x64": "0.21.5", + "@esbuild/linux-arm": "0.21.5", + "@esbuild/linux-arm64": "0.21.5", + "@esbuild/linux-ia32": "0.21.5", + "@esbuild/linux-loong64": "0.21.5", + "@esbuild/linux-mips64el": "0.21.5", + "@esbuild/linux-ppc64": "0.21.5", + "@esbuild/linux-riscv64": "0.21.5", + "@esbuild/linux-s390x": "0.21.5", + "@esbuild/linux-x64": "0.21.5", + "@esbuild/netbsd-x64": "0.21.5", + "@esbuild/openbsd-x64": "0.21.5", + "@esbuild/sunos-x64": "0.21.5", + "@esbuild/win32-arm64": "0.21.5", + "@esbuild/win32-ia32": "0.21.5", + "@esbuild/win32-x64": "0.21.5" + } + }, + "node_modules/vite/node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/vitest": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/vitest/-/vitest-2.1.9.tgz", + "integrity": "sha512-MSmPM9REYqDGBI8439mA4mWhV5sKmDlBKWIYbA3lRb2PTHACE0mgKwA8yQ2xq9vxDTuk4iPrECBAEW2aoFXY0Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/expect": "2.1.9", + "@vitest/mocker": "2.1.9", + "@vitest/pretty-format": "^2.1.9", + "@vitest/runner": "2.1.9", + "@vitest/snapshot": "2.1.9", + "@vitest/spy": "2.1.9", + "@vitest/utils": "2.1.9", + "chai": "^5.1.2", + "debug": "^4.3.7", + "expect-type": "^1.1.0", + "magic-string": "^0.30.12", + "pathe": "^1.1.2", + "std-env": "^3.8.0", + "tinybench": "^2.9.0", + "tinyexec": "^0.3.1", + "tinypool": "^1.0.1", + "tinyrainbow": "^1.2.0", + "vite": "^5.0.0", + "vite-node": "2.1.9", + "why-is-node-running": "^2.3.0" + }, + "bin": { + "vitest": "vitest.mjs" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "@edge-runtime/vm": "*", + "@types/node": "^18.0.0 || >=20.0.0", + "@vitest/browser": "2.1.9", + "@vitest/ui": "2.1.9", + "happy-dom": "*", + "jsdom": "*" + }, + "peerDependenciesMeta": { + "@edge-runtime/vm": { + "optional": true + }, + "@types/node": { + "optional": true + }, + "@vitest/browser": { + "optional": true + }, + "@vitest/ui": { + "optional": true + }, + "happy-dom": { + "optional": true + }, + "jsdom": { + "optional": true + } + } + }, + "node_modules/vue": { + "version": "3.5.38", + "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.38.tgz", + "integrity": "sha512-vAMKHfImQlYSy0C+PBue4s3ERZ2xGKfgZg5GXAsLInq1dyh2H78ILVP5sK0KPFPVW4kv+OGCIvBEondcjpZp7A==", + "license": "MIT", + "dependencies": { + "@vue/compiler-dom": "3.5.38", + "@vue/compiler-sfc": "3.5.38", + "@vue/runtime-dom": "3.5.38", + "@vue/server-renderer": "3.5.38", + "@vue/shared": "3.5.38" + }, + "peerDependencies": { + "typescript": "*" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/why-is-node-running": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz", + "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==", + "dev": true, + "license": "MIT", + "dependencies": { + "siginfo": "^2.0.0", + "stackback": "0.0.2" + }, + "bin": { + "why-is-node-running": "cli.js" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/wrappy": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", + "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", + "license": "ISC", + "optional": true + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..4ac6e28 --- /dev/null +++ b/package.json @@ -0,0 +1,41 @@ +{ + "name": "dacli-ts", + "version": "0.1.0", + "description": "TypeScript-based dacli CLI for JNPF platform — 0 差错 baseline replication.", + "type": "module", + "private": true, + "bin": { + "dacli": "src/cli.ts" + }, + "scripts": { + "dacli": "tsx src/cli.ts", + "test": "vitest run", + "test:watch": "vitest", + "test:e2e": "playwright test", + "extract": "tsx scripts/extract-all.mjs", + "verify:baseline": "bash .claude/skills/dacli-ts/examples/baseline/all.sh", + "typecheck": "tsc --noEmit" + }, + "dependencies": { + "@vue/compiler-sfc": "^3.5.0", + "commander": "^12.1.0", + "crypto-js": "^4.2.0", + "vue": "^3.5.0" + }, + "optionalDependencies": { + "better-sqlite3": "^11.3.0" + }, + "devDependencies": { + "@playwright/test": "^1.48.0", + "@types/better-sqlite3": "^7.6.11", + "@types/crypto-js": "^4.2.2", + "@types/node": "^22.0.0", + "pixelmatch": "^6.0.0", + "tsx": "^4.19.0", + "typescript": "^5.6.0", + "vitest": "^2.1.0" + }, + "engines": { + "node": ">=20" + } +} diff --git a/playwright.config.ts b/playwright.config.ts new file mode 100644 index 0000000..8eb0582 --- /dev/null +++ b/playwright.config.ts @@ -0,0 +1,48 @@ +import { defineConfig } from '@playwright/test' +import { existsSync } from 'node:fs' + +/** + * Playwright 配置 — baseline 0 视觉差验证基础设施。 + * + * - testDir: tests/e2e + * - projects: setup (auth.setup.ts UI 登录一次) → chromium (复用 storageState) + * - baseURL: 默认 http://nginx/ (容器内, fallback http://127.0.0.1:30000) + * + * 跑法: + * npx playwright test --project=setup # 单独刷新登录态 + * npx playwright test --project=chromium # 业务 spec (需先有 .auth/admin.json) + * npx playwright test # 全部 (setup 自动作为 chromium 依赖运行) + * + * 注: storageState 只有在 .auth/admin.json 存在时才装载 (首跑前为 undefined, setup 会创建) + */ +const AUTH_FILE = '.auth/admin.json' + +export default defineConfig({ + testDir: './tests/e2e', + fullyParallel: false, + workers: 1, + retries: 0, + timeout: 60_000, + reporter: [['list']], + use: { + baseURL: process.env.JNPF_BASE_URL || 'http://nginx/', + headless: true, + screenshot: 'only-on-failure', + trace: 'retain-on-failure', + }, + projects: [ + { + name: 'setup', + testMatch: /.*\.setup\.ts/, + }, + { + name: 'chromium', + use: { + browserName: 'chromium', + ...(existsSync(AUTH_FILE) ? { storageState: AUTH_FILE } : {}), + }, + testIgnore: /.*\.setup\.ts/, + dependencies: ['setup'], + }, + ], +}) diff --git a/prompt.md b/prompt.md new file mode 100644 index 0000000..9f26857 --- /dev/null +++ b/prompt.md @@ -0,0 +1,512 @@ +# TS 版 dacli — 主提示词 (开发任务说明书) + +> **位置**: `$ccWorkDir/dacli/`(原 `test/dacli/`, 2026-06-12 升级到顶层独立项目) +> **目标**: 在 `$ccWorkDir/dacli/` 内交付 **两件套**—— +> 1. **`dacli` CLI 工具** (TypeScript) — 借鉴 Java 版架构 + 复用 JNPF web 源码 +> 2. **`.claude/skills/dacli-ts/SKILL.md`** — AI 专用技能,告诉 AI **何时用哪个命令** +> +> **目标 0 差错**: 以官方示例 (workSystem 85 + developSystem 29 = 114 张表单) 为基线,dacli 复刻必须 **API 0 错 + 浏览器层 0 视觉差** +> +> **应用对象**: `tds` (http://nginx/ ,你在容器内 后端api 代理到 http://nginx/api -> http://127.0.0.1:30000/api) | `admin / 123456` + +--- + +## 0. 启动指令 (新会话第一句) + +``` +按 $ccWorkDir/dacli/prompt.md 在 $ccWorkDir/dacli/ 内交付 dacli + skill 两件套。 +目标 0 差错: 以 developSystem/workSystem 官方示例为 baseline。 +先读 $ccWorkDir/dacli/doc/architecture.md 了解设计, 再看 plan.md 拿当前任务。 +``` + +**核心约束 (3 条不妥协)**: +1. **0 差错 = API 0 错 + 浏览器 0 视觉差**(详见 §5) +2. **官方示例 baseline 必用**(developSystem 21 + workSystem 53 = 74 张) +3. **Playwright Node.js 是基础设施**(不是可选,每个 baseline 必跑) + +--- + +## 1. 项目背景与目标 + +### 1.1 为什么做这件事 + +`dacli` (Java 版, `docs/dacli/ssw-dacli/`, 已废弃归档) 已成熟:17 父命令 + ~110 子命令、53 FieldBuilder、261/261 mvn test。 + +**但 4 个痛点**: +1. **AI 写 Java 累**(类型 ceremony、编译慢) +2. **schema 翻译漂移**(53 FieldBuilder 是从 web 翻译过来的,翻译即漂移) +3. **升级耦合**(JNPF 改一字段,53 builder 都要手改) +4. **web 零复用**(web 端 TS/TS,dacli Java 完全没复用) + +### 1.2 TS 版定位 + +**不是**"重写 dacli 替代 Java 版"。 +**而是**"**AI-friendly 探索性实验**"——验证"**直接复用 web 源码 + 0 差错验证**"的可行性。 + +### 1.3 目标 0 差错 (硬目标) + +**0 差错 = 两个层面都 0**: + +| 层面 | 含义 | 验证手段 | +|------|------|----------| +| **API 0 错** | 所有 dacli 命令调用 JNPF API 返回 200/业务成功 | 单元测试 + 集成测试 | +| **浏览器 0 视觉差** | 复刻的表单/菜单在浏览器渲染与原版**像素级一致** | Playwright Node.js 截图对比 | + +**0 差错基线**: **74 张官方示例** (developSystem 21 + workSystem 53)。 +dacli 对这 74 张必须做到: +- ✅ `dacli form export ` 输出 JSON → `dacli form import` 输入 → 重建后**结构 0 差** +- ✅ Playwright 打开原版与复刻版,**截图视觉 0 差** (允许 1 像素抗锯齿差) +- ✅ 所有字段、按钮、列表列正确渲染 +- ✅ 表单可正常提交、菜单可正常跳转、工作流可正常发起 + +### 1.4 官方示例 (baseline 真值源) + +| app_code | 表单数 | 工作流数 | 用途 | +|----------|--------|---------|------| +| `developSystem` | 21 | 3 | 基础示例(单表/主子表/简单工作流) | +| `workSystem` | 53 | 多个 | 丰富示例(关联/字典/数据接口/复杂流程) | +| `tds` | 0+ (本次新建) | - | 实际业务应用 | + +**baseline 文件**: +- `references/baseline/developSystem.md` — 21 张表单清单 + 特色 +- `references/baseline/workSystem.md` — 53 张表单清单 + 特色 +- `examples/baseline/.sh` — 每张表单的复刻 + 验证脚本 +- `examples/baseline/all.sh` — 一键跑完 74 张的回归 + +详见 [references/baseline/](../../references/baseline/README.md) + +--- + +## 2. 架构设计 (核心) + +### 2.1 复用 web 源码的 4 类资产 + +| 资产 | 来源 | TS 版如何用 | 价值 | +|------|------|------------|------| +| **加密算法** | `web/packages/jnpf/utils/src/helpers/cipher.ts` | `crypto-js` 1:1 复刻 | 字节级一致 | +| **L1 正则库** | `web/packages/jnpf/utils/src/helpers/formValidate.ts` | 直接 `import` + 提 JSON | 14 条规则 | +| **componentMap** | `web/.../components/FormGenerator/src/helper/componentMap.ts` | 提 → `component-map.json` | 60+ jnpfKey → tag | +| **Rxxx.vue template** | `web/.../components/FormGenerator/src/rightComponents/*.vue` | `@vue/compiler-sfc` parse 提 `activeData.*` | 39 控件 schema | + +### 2.2 Playwright Node.js = 基础设施 + +**不**是"可选的 E2E 工具",**是** 0 差错验证的核心: + +| 用途 | Playwright 角色 | +|------|-----------------| +| **baseline 截图对比** | 原版 vs 复刻版像素级 diff | +| **业务功能验证** | 提交表单/审批流程/翻页/搜索真实能跑 | +| **API + UI 双层验证** | API 0 错 + 浏览器 0 视觉差 (双层 0 错) | +| **回归基线** | JNPF 升级时一键跑 74 张,5 分钟看出 regression | +| **AI 自检** | AI 改完 dacli 后跑 Playwright 看实际效果 | + +**技术选型**: +- `@playwright/test` (Node.js) 而**非** Playwright Python +- 原因: 与 dacli 同 Node 进程,可直接 import dacli 模块做集成测试 +- 浏览器: chromium (headless) + 截图 + DOM 比对 +- 截图对比: `pixelmatch` 库像素级 diff + +**目录**: +``` +dacli/tests/ +├── e2e/ +│ ├── baseline/ # 114 张官方示例 +│ │ ├── developSystem/ # 21 张 +│ │ │ ├── .spec.ts # 每张一个 +│ │ │ └── ... +│ │ └── workSystem/ # 53 张 +│ │ ├── .spec.ts +│ │ └── ... +│ ├── api/ # API 层 0 错测试 +│ │ ├── form.spec.ts +│ │ ├── menu.spec.ts +│ │ └── ... +│ └── visual/ # 视觉对比 +│ ├── -diff.spec.ts +│ └── screenshots/ # 截图 + diff 输出 +└── unit/ + ├── crypto.test.ts + ├── extractors.test.ts + └── schema.test.ts +``` + +### 2.3 目录结构 ($ccWorkDir/dacli/) - 更新 + +``` +dacli/ +├── prompt.md # 本文件 +├── README.md # 项目入口 +├── package.json # 加 @playwright/test +├── tsconfig.json +├── playwright.config.ts # Playwright 配置 +│ +├── src/ # ⭐ 第一件交付物: dacli CLI +│ ├── cli.ts # Commander.js 入口 +│ ├── commands/ # 嵌套子命令 +│ │ ├── login.ts +│ │ ├── status.ts +│ │ ├── form/{list,info,create,release,delete,export,import,clone,validate,fix}.ts +│ │ ├── menu/{list,create,update,delete}.ts +│ │ ├── dm/{list,table,create,update,drop}.ts +│ │ ├── dict/{type-list,type-create,data-list,data-create}.ts +│ │ ├── workflow/{list,create,launch,approve}.ts +│ │ ├── doc/{list,get,scan,refresh,clear}.ts +│ │ └── apis/{list,info,search,refresh,status}.ts +│ ├── core/ +│ │ ├── client.ts +│ │ ├── crypto.ts +│ │ ├── config.ts +│ │ ├── cache.ts # better-sqlite3 +│ │ ├── help.ts # --ai-help / --example / --source +│ │ └── log.ts +│ ├── extractors/ # web 源码提取工具 +│ │ ├── fields.ts +│ │ ├── l1-rules.ts +│ │ ├── l2-rules.ts +│ │ ├── flow.ts +│ │ └── component-map.ts +│ ├── data/ # 提取 JSON (git-tracked) +│ │ ├── component-map.json +│ │ ├── field-schemas.json +│ │ ├── validation-rules.json +│ │ └── l2-rules.json +│ ├── schema/ # FieldBuilder (从 JSON 加载) +│ └── types.ts +│ +├── .claude/skills/dacli-ts/ # ⭐ 第二件交付物: AI 专用 skill +│ ├── SKILL.md # 主入口 +│ ├── references/ +│ │ ├── commands.md # 完整命令清单 +│ │ ├── patterns.md # 5+ 业务模式 +│ │ ├── anti-patterns.md # 8+ 反模式 +│ │ ├── troubleshooting.md # 8+ 排错 +│ │ ├── baseline/ # ⭐ 官方示例 baseline +│ │ │ ├── README.md +│ │ │ ├── developSystem.md # 21 张表单清单 +│ │ │ └── workSystem.md # 53 张表单清单 +│ │ └── playwright.md # Playwright 使用指南 +│ ├── examples/ # 可复制粘贴的示例 +│ │ ├── create-simple-form.sh +│ │ ├── create-master-sub-form.sh +│ │ ├── create-workflow.sh +│ │ └── baseline/ # 74 张 baseline 复刻脚本 +│ │ ├── all.sh +│ │ ├── developSystem/ +│ │ │ ├── .sh +│ │ │ └── ... +│ │ └── workSystem/ +│ │ ├── .sh +│ │ └── ... +│ └── scripts/ # AI 调用的辅助脚本 +│ +├── doc/ # 人类可读详细文档 +│ ├── README.md +│ ├── architecture.md +│ ├── plan.md # 6 周路线 +│ ├── api.md +│ ├── extractors.md +│ ├── help-system.md +│ └── baseline.md # ⭐ baseline 验证规范 +│ +├── tests/ # ⭐ Playwright + vitest 测试套件 +│ ├── e2e/ +│ │ ├── baseline/ # 74 张 baseline 复刻 + 验证 +│ │ │ ├── developSystem/ +│ │ │ └── workSystem/ +│ │ ├── api/ # API 层 0 错 +│ │ └── visual/ # 截图视觉对比 +│ └── unit/ # vitest 单元测试 +│ +├── screenshots/ # baseline 截图 (gitignored) +│ ├── developSystem/ +│ └── workSystem/ +│ +├── scripts/ +│ ├── extract-all.mjs # 一键提取 web 源码 +│ ├── verify-baseline.mjs # ⭐ baseline 一键回归 +│ └── install-playwright.mjs # 一键装 playwright + chromium +│ +└── .dacli-cache.db # SQLite 缓存 (gitignored) +``` + +--- + +## 3. 6 周路线 (Week 1-6: dacli + skill) + +### Week 1: 脚手架 + 核心管道 (登录 + form CRUD) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | 初始化目录、package.json、tsconfig.json、Commander.js 入口、playwright 装好 | `npx tsx src/cli.ts --help` 跑通 | +| D2 | `core/crypto.ts` (从 web cipher.ts 移植 crypto-js) + 单元测试 | '123456' → 与 web 同 96 hex | +| D3 | `core/client.ts` (JnpfClient: login + HTTP) + `commands/login.ts` | login 成功 + token 持久化 | +| D4 | `commands/form/{list,info}.ts` + `core/config.ts` | form list 返回 3+ 张 | +| D5 | `commands/form/{create,release,delete}.ts` | 端到端 demo 跑通 | + +**Week 1 必达 (0 差错第 1 步)**: +- [ ] tds 应用 login + form list 跑通 +- [ ] developSystem / workSystem 也能 login + form list (验证多 app) + +### Week 2: 提取工具 + 53 控件 schema + Playwright 基础 + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `extractors/component-map.ts` | `data/component-map.json` 60+ 映射 | +| D2 | `extractors/fields.ts` (vue SFC parse) | `data/field-schemas.json` 39 控件 | +| D3 | `extractors/l1-rules.ts` + `l2-rules.ts` | validation-rules + l2-rules | +| D4 | **Playwright 配置** (`playwright.config.ts` + 装 chromium) | `npx playwright --version` 跑通 | +| D5 | `schema/index.ts` 通用 FieldBuilder | 53 控件可调,无需硬编码 | + +**Week 2 必达**: 提取 + Playwright 基础完成 + +### Week 3: 5 父命令 + 第一批 baseline (developSystem 21) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `commands/dm.ts` (list/table/create) | 端到端 | +| D2 | `commands/dict.ts` (type-list/data-list/create) | 端到端 | +| D3 | `commands/menu.ts` (list/create) + `commands/di.ts` | 端到端 | +| D4 | **写 21 张 developSystem baseline 脚本** (export → import → Playwright 截图对比) | 21/21 API 0 错 | +| D5 | 21 张 baseline 浏览器 0 视觉差 | **API + UI 双 0 错** | + +**Week 3 必达**: developSystem 21 张 baseline 全 0 错 + +### Week 4: workflow + 第二批 baseline (workSystem 53) + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `commands/workflow.ts` (list/create/launch/approve) | 端到端 | +| D2-D4 | **写 53 张 workSystem baseline 脚本** | 53/53 API 0 错 | +| D5 | 53 张 baseline 浏览器 0 视觉差 | **API + UI 双 0 错** | + +**Week 4 必达**: workSystem 53 张 baseline 全 0 错 + +### Week 5: 帮助体系 + skill 主体 + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `core/help.ts` + `--ai-help / --example / --source` | 全部命令支持 | +| D2 | `commands/doc.ts` (HTML 缓存) | 镜像 Java 版能力 | +| D3 | `commands/apis.ts` (OpenAPI 抓取) | 镜像 Java 版能力 | +| D4 | skill `SKILL.md` + `references/commands.md` | AI 读后知道何时用 | +| D5 | skill `references/patterns.md` + `anti-patterns.md` | 5+ 模式 + 8+ 反模式 | + +**Week 5 必达**: 帮助体系 + skill 主体 + +### Week 6: skill examples + AI 自检 + 文档收尾 + +| Day | 任务 | 验收 | +|-----|------|------| +| D1 | `examples/create-simple-form.sh` (单表) | AI 复制粘贴能跑 | +| D2 | `examples/create-master-sub-form.sh` (主子表) | 同上 | +| D3 | `examples/create-workflow.sh` (工作流) | 同上 | +| D4 | **AI 自检**: 把 skill 喂给另一个 Claude, 让它 "用 dacli 完成一个请假流程" | 能跑通 | +| D5 | 文档收尾 + `examples/baseline/all.sh` 一键回归 | 74 张一键跑 | + +**Week 6 必达**: skill 完整 + AI 自检通过 + 74 张 baseline 一键回归 + +--- + +## 4. 0 差错验证规范 (baseline.md) + +### 4.1 验证金字塔 + +``` + ┌──────────────┐ + │ Playwright │ ← 浏览器 0 视觉差 + │ (E2E) │ + ├──────────────┤ + │ dacli CLI │ ← API 0 错 + │ (集成测试) │ + ├──────────────┤ + │ vitest │ ← 函数 0 错 + │ (单元测试) │ + └──────────────┘ +``` + +**每一层都必须 0 错**。 + +### 4.2 baseline 复刻流程 (每张表单) + +```bash +# 1. export 原表单 JSON +dacli form export --out=/tmp/-orig.json + +# 2. 拿到原表单的 dbLinkId / category / webType / type 等元数据 +dacli form info + +# 3. import 到 tds (或新应用) +dacli form import /tmp/-orig.json --enCode=_clone + +# 4. 拿克隆 id +CLONE_ID=$(dacli form list | jq -r '.data.list[] | select(.enCode=="_clone") | .id') + +# 5. release +dacli form release $CLONE_ID + +# 6. Playwright 验证 (API + UI) +npx playwright test e2e/baseline//.spec.ts + +# 7. 视觉对比 (0 差 = 像素级) +npx playwright test e2e/visual/-diff.spec.ts +``` + +### 4.3 0 差错的精确含义 + +| 维度 | 0 差错标准 | 验证 | +|------|------------|------| +| **HTTP 状态码** | 200/业务成功 (无 4xx/5xx) | Playwright API fixture | +| **响应数据** | 重建后 form info 字段集与原版**完全一致** (允许 id/enCode/state 不同) | 单元对比 | +| **字段渲染** | 浏览器看到的 input/select/textarea 数量、类型、默认值 0 差 | DOM 断言 | +| **按钮位置** | 保存/取消/审批按钮位置 0 差 | 截图 | +| **列表列** | 列表页列数/列名/列宽 0 差 | 截图 + DOM | +| **工作流节点** | 流程图节点数/连线 0 差 | 截图 | + +**允许差异** (不算错): +- id / enCode 必然不同 +- 物理表名前缀 (e.g. `tds_asset` vs `tds_asset_clone`) +- 时间戳 / 创建人 +- 像素级抗锯齿差异 (1-2 像素) + +### 4.4 不算 0 差错的常见 bug + +- ❌ 字段缺失 (e.g. input 缺 `maxlength` 属性) +- ❌ 控件类型错 (e.g. select 被渲染成 input) +- ❌ 字典数据加载失败 (下拉框空白) +- ❌ 列表分页错 (pageSize 不一致) +- ❌ 工作流节点缺失 +- ❌ 表单提交后跳错页 + +--- + +## 5. 关键命令 (AI 一眼能看完) + +```bash +# ===== 登录/状态 ===== +dacli login --appCode=tds +dacli switch-app --appCode=developSystem # 切到 baseline +dacli status + +# ===== baseline 复刻 (74 张) ===== +bash examples/baseline/all.sh # 一键全跑 74 张 +bash examples/baseline/developSystem/leave.sh +bash examples/baseline/workSystem/contract.sh + +# ===== 验证 ===== +npx playwright test # 跑全部 E2E +npx playwright test e2e/baseline/developSystem # 跑 21 张 +npx vitest run # 跑单元测试 + +# ===== 提取 (JNPF 升级时重跑) ===== +node scripts/extract-all.mjs + +# ===== 文档/API 查 ===== +dacli doc list --dir=docs/tds +dacli doc get --file=docs/tds/plan.html +dacli apis list --tag=visualdev +dacli apis info "POST /api/visualdev/Base" +``` + +--- + +## 6. 已知陷阱 (踩过的坑 + 必防) + +### 6.1 URL 重复 +baseUrl 已含 `/api`,path 不含。`/api/api/...` → 404/401 + +### 6.2 加密字节级不一致 +`Hex.stringify(Base64.parse(result))` 是对 Base64 字符串做 hex,**不是**密文字节。用 `crypto-js` 严格 1:1 复刻 cipher.ts + +### 6.3 表单 "Database exception" +- `dbLinkId='0'` 错(用 `/api/system/DataSource` 拉) +- `tables[].fields[]` 缺 `autoIncrement/identity/columnName` 等 +- `category='0'` 错(用 `dacli form list` 查真实值) +- **type=4 (视图) 绕过 tables 问题** + +### 6.4 release 视图表失败 +type=4 (视图) release 报 "System abnormality"。**软跳过**。 + +### 6.5 菜单 API 不回 data.id +响应只有 `{code, msg}`。解析时用 enCode 反查 list。 + +### 6.6 Playwright 浏览器层 tdd 应用 404 +nginx 容器可能不通,dacli/login 失败。**用 developSystem/workSystem 兜底验证**(已通)。 + +### 6.7 baseline 表单的 dbLinkId +74 张表单的 dbLinkId **各异**(不同业务库)。脚本里**动态拉**,不写死。 + +### 6.8 baseline 工作流的 formId +克隆工作流时 formId 失效(指向原 formId)。**必须重建** formId 映射。 + +--- + +## 7. 与 Java 版的关系 + +### 7.1 v1 不替代 +- Java 版 `ssw-dacli` 是**生产工具**(6 月打磨,261 tests) +- TS 版**实验性**,**不**作为生产依赖 + +### 7.2 验证收益(v1 完成后) +- **如果** baseline 74 张全 0 错 + AI 自检通过 → v2 把提取工具反向喂给 Java 版 +- **如果** 覆盖率 / 体验都好 → v3 全面替代 +- **如果** 一般 → 保留作为"快速原型工具" + +### 7.3 提取工具沉淀 +`dacli/src/extractors/` 是**通用资产**。v2 可考虑: +- 移到 `.claude/skills/dacli-web-extract/` 给 Java 版用 +- Java 版 `dacli form validate` 也消费 `data/*.json` + +--- + +## 8. 上下文恢复指引 + +**新会话第一句**: +``` +按 $ccWorkDir/dacli/prompt.md 继续。当前周次/任务查 doc/plan.md。 +目标 0 差错: developSystem 21 + workSystem 53 baseline 全跑通。 +``` + +**关键文件**: +- `doc/plan.md` — 当前进度 +- `doc/architecture.md` — 设计决策 +- `doc/baseline.md` — 0 差错验证规范 +- `references/baseline/developSystem.md` + `workSystem.md` — 74 张清单 +- `examples/baseline/all.sh` — 一键回归 +- `src/data/*.json` — 提取的资产 +- `tests/e2e/baseline/` — 74 张的 Playwright 测试 +- `test/ddcc/` — 上一轮实验 + +**关键命令**: +```bash +cd $ccWorkDir/dacli +npx tsx src/cli.ts --help +npx tsx src/cli.ts login --appCode=tds +bash examples/baseline/all.sh # 74 张一键回归 +npx playwright test # 跑全部 E2E +npx vitest run # 跑单元测试 +node scripts/extract-all.mjs # 提取 web 源码 +``` + +--- + +## 9. 反向链接 (Related) + +- [doc/architecture.md](doc/architecture.md) — 架构设计 +- [doc/plan.md](doc/plan.md) — 6 周路线 +- [doc/baseline.md](doc/baseline.md) — 0 差错验证规范 +- [doc/api.md](doc/api.md) — API 完整列表 +- [doc/implementation.md](doc/implementation.md) — 实现细节 +- [doc/extractors.md](doc/extractors.md) — 提取工具 +- [doc/help-system.md](doc/help-system.md) — 帮助体系 +- [SKILL.md](.claude/skills/dacli-ts/SKILL.md) — AI 技能主入口 +- [references/baseline/developSystem.md](.claude/skills/dacli-ts/references/baseline/developSystem.md) +- [references/baseline/workSystem.md](.claude/skills/dacli-ts/references/baseline/workSystem.md) +- [examples/baseline/all.sh](.claude/skills/dacli-ts/examples/baseline/all.sh) — 一键回归 +- [../ddcc/](../ddcc/) — 上一轮实验 + +--- + +**生成时间**: 2026-06-12 +**作者**: Claude (M3) + 用户 +**状态**: v1 计划冻结,进入执行 +**核心目标**: **74 张官方示例 API 0 错 + 浏览器 0 视觉差** diff --git a/scripts/extract-all.mjs b/scripts/extract-all.mjs new file mode 100644 index 0000000..0f2fe26 --- /dev/null +++ b/scripts/extract-all.mjs @@ -0,0 +1,214 @@ +#!/usr/bin/env node +/** + * scripts/extract-all.mjs + * + * 一键从 web 源码提取所有资产到 src/data/*.json + * + * 用法: + * node scripts/extract-all.mjs + * + * JNPF 升级时重跑: + * 1. cd $ccWorkDir/dacli + * 2. node scripts/extract-all.mjs + * 3. 看 git diff data/ 知道 web 改了哪些 + * 4. 跑 baseline 验证 dacli 还兼容 + */ + +import { readFileSync, writeFileSync, existsSync } from 'node:fs' +import { resolve, dirname } from 'node:path' +import { fileURLToPath } from 'node:url' + +const __dirname = dirname(fileURLToPath(import.meta.url)) +const ROOT = resolve(__dirname, '..') + +// web 源码绝对路径 +const WEB_ROOT = process.env.WEB_ROOT || '/Users/xs/Desktop/workspace/web' +const COMP_MAP = `${WEB_ROOT}/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts` +const FORM_VALIDATE = `${WEB_ROOT}/packages/jnpf/utils/src/helpers/formValidate.ts` +const R_DIR = `${WEB_ROOT}/apps/jnpf-web-apps-main/src/components/FormGenerator/src/rightComponents` + +// 输出 +const OUT_DIR = resolve(ROOT, 'src/data') + +// ==================== 1. componentMap ==================== +function extractComponentMap() { + const src = readFileSync(COMP_MAP, 'utf-8') + const items = [...src.matchAll(/jnpfKey:\s*['"](\w+)['"][\s\S]*?tag:\s*['"]([^'"]+)['"]/g)] + const map = {} + for (const m of items) map[m[1]] = m[2] + writeFileSync(resolve(OUT_DIR, 'component-map.json'), JSON.stringify(map, null, 2)) + return items.length +} + +// ==================== 2. fields (Rxxx.vue) ==================== +// 注: 需要 @vue/compiler-sfc, 这里用 require 加载 +async function extractFields() { + const { parse } = await import('@vue/compiler-sfc') + const { readdirSync } = await import('node:fs') + + // 读 componentMap + const cmSrc = readFileSync(COMP_MAP, 'utf-8') + const jnpfKeyToTag = {} + for (const m of cmSrc.matchAll(/jnpfKey:\s*['"](\w+)['"][\s\S]*?tag:\s*['"]([^'"]+)['"]/g)) { + jnpfKeyToTag[m[1]] = m[2] + } + + const schemas = {} + for (const key of Object.keys(jnpfKeyToTag)) { + const pascal = key.charAt(0).toUpperCase() + key.slice(1) + const f = resolve(R_DIR, `R${pascal}.vue`) + if (!existsSync(f)) continue + const src = readFileSync(f, 'utf-8') + const { descriptor } = parse(src, { filename: `R${pascal}.vue` }) + const tmpl = descriptor.template?.content + if (!tmpl) continue + const fields = [...new Set( + [...tmpl.matchAll(/activeData\.([a-zA-Z_][\w.]*)/g)].map(m => m[1]) + )].sort() + // 过滤掉方法调用 (e.g. __config__.regList.splice 不是字段) + const cleanFields = fields.filter(f => !f.includes('.splice') && !f.includes('.push')) + schemas[key] = cleanFields + } + + writeFileSync(resolve(OUT_DIR, 'field-schemas.json'), JSON.stringify(schemas, null, 2)) + return Object.keys(schemas).length +} + +// ==================== 3. l1-rules ==================== +function extractL1Rules() { + const src = readFileSync(FORM_VALIDATE, 'utf-8') + const match = src.match(/const regularList\s*=\s*\{([\s\S]*?)\n\}/) + if (!match) throw new Error('regularList not found in formValidate.ts') + + const rules = {} + // 提每条 key 的 msg + rule + for (const m of match[1].matchAll(/(\w+):\s*\{[^{}]*?msg:\s*['"]([^'"]+)['"][^{}]*?rule:\s*(\/[^\/]+\/[a-z]*)/g)) { + rules[m[1]] = { msg: m[2], rule: m[3] } + } + writeFileSync(resolve(OUT_DIR, 'validation-rules.json'), JSON.stringify(rules, null, 2)) + return Object.keys(rules).length +} + +// ==================== 4. l2-rules (Form.vue) ==================== +async function extractL2Rules() { + const { parse } = await import('@vue/compiler-sfc') + const { readdirSync, statSync } = await import('node:fs') + const rules = { di: [], dm: [], dict: [], workflow: [], menu: [], role: [], user: [] } + + function walk(dir) { + if (!existsSync(dir)) return + for (const f of readdirSync(dir)) { + const p = resolve(dir, f) + const s = statSync(p) + if (s.isDirectory()) walk(p) + else if (f.endsWith('.vue') && f === 'Form.vue') { + parseForm(p, rules) + } + } + } + + function parseForm(file, rules) { + const module = file.includes('/dataInterface/') ? 'di' + : file.includes('/dataModel/') ? 'dm' + : file.includes('/dictionary/') ? 'dict' + : file.includes('/flowEngine/') ? 'workflow' + : file.includes('/menu/') ? 'menu' + : file.includes('/role/') ? 'role' + : file.includes('/user/') ? 'user' + : null + if (!module || !rules[module]) return + + const src = readFileSync(file, 'utf-8') + const { descriptor } = parse(src, { filename: file }) + const script = descriptor.scriptSetup?.content || descriptor.script?.content || '' + + for (const m of script.matchAll(/createMessage\.(error|warning)\s*\(\s*['"]([^'"]+)['"]/g)) { + rules[module].push({ + level: m[1], + msg: m[2], + line: getLineNumber(script, m.index), + source: file.replace(/^.*\/web\//, 'web/'), + }) + } + } + + function getLineNumber(text, index) { + return text.slice(0, index).split('\n').length + } + + walk(`${WEB_ROOT}/apps/jnpf-web-apps-main/src/views`) + + writeFileSync(resolve(OUT_DIR, 'l2-rules.json'), JSON.stringify(rules, null, 2)) + return Object.values(rules).reduce((a, b) => a + b.length, 0) +} + +// ==================== 5. flow nodes ==================== +async function extractFlow() { + const { parse } = await import('@vue/compiler-sfc') + const FLOW_FILE = `${WEB_ROOT}/apps/jnpf-web-apps-main/src/components/FlowProcess/src/index.vue` + if (!existsSync(FLOW_FILE)) { + console.log(' (FlowProcess/src/index.vue 不存在, 跳过)') + return 0 + } + + const src = readFileSync(FLOW_FILE, 'utf-8') + const { descriptor } = parse(src, { filename: FLOW_FILE }) + const script = descriptor.scriptSetup?.content || descriptor.script?.content || '' + + const nodes = {} + for (const m of script.matchAll(/setErrorList\s*\(\s*['"]([^'"]+)['"]\s*,\s*['"]([^'"]*)['"]\s*,\s*['"]([^'"]*)['"]/g)) { + const [_, msg, key, title] = m + if (title && !nodes[title]) nodes[title] = { msg, key } + } + + writeFileSync(resolve(OUT_DIR, 'flow-nodes.json'), JSON.stringify(nodes, null, 2)) + return Object.keys(nodes).length +} + +// ==================== main ==================== +async function main() { + console.log('▶ 一键提取 web 源码 → src/data/*.json\n') + + try { + const n1 = extractComponentMap() + console.log(` ✓ component-map.json: ${n1} 个 jnpfKey → tag`) + } catch (e) { + console.log(` ✗ component-map: ${e.message}`) + } + + try { + const n2 = await extractFields() + console.log(` ✓ field-schemas.json: ${n2} 个控件`) + } catch (e) { + console.log(` ✗ field-schemas: ${e.message}`) + } + + try { + const n3 = extractL1Rules() + console.log(` ✓ validation-rules.json: ${n3} 条 L1 正则`) + } catch (e) { + console.log(` ✗ validation-rules: ${e.message}`) + } + + try { + const n4 = await extractL2Rules() + console.log(` ✓ l2-rules.json: ${n4} 条 L2 错误消息`) + } catch (e) { + console.log(` ✗ l2-rules: ${e.message}`) + } + + try { + const n5 = await extractFlow() + console.log(` ✓ flow-nodes.json: ${n5} 个工作流节点`) + } catch (e) { + console.log(` ✗ flow-nodes: ${e.message}`) + } + + console.log('\n✓ 全部提取完成') + console.log(' 下一步:') + console.log(' 1. 看 src/data/ 下的 JSON') + console.log(' 2. 跑 baseline: bash examples/baseline/all.sh --skip-visual') + console.log(' 3. 全通: npx playwright test') +} + +main().catch(e => { console.error(e); process.exit(1) }) diff --git a/scripts/seed-tds-baseline.ts b/scripts/seed-tds-baseline.ts new file mode 100644 index 0000000..fc93907 --- /dev/null +++ b/scripts/seed-tds-baseline.ts @@ -0,0 +1,142 @@ +#!/usr/bin/env -S npx tsx +/** + * scripts/seed-tds-baseline.ts + * + * 把 workSystem 5-7 张代表性 form export 到 /tmp/baseline/, 再 import 到 tds. + * 输出 /tmp/baseline-mapping.json (origId → cloneId) 供 baseline spec 用. + * + * 用户指引: 测试在 tds 做, 数据从官方示例复制 — 官方示例只读不动. + * + * 跑法: + * npx tsx scripts/seed-tds-baseline.ts + * + * 选择标准 (5 张代表性, 5 维度覆盖): + * - yuangongpx (type=1, 无 flow) 单表 + * - ruzhishenq (type=1, 无 flow) 单表 (HR) + * - renewal (type=1, 无 flow) 单表 (合同) + * - leaveApply (type=2, flow=1) 工作流表单 (经典) + * - crmOrder (type=2, flow=1) 工作流表单 (订单) + */ +import { execSync } from 'node:child_process' +import { mkdirSync, writeFileSync, existsSync } from 'node:fs' + +const SELECTED = [ + { enCode: 'yuangongpx', fullName: '员工培训' }, + { enCode: 'ruzhishenq', fullName: '入职申请' }, + { enCode: 'renewal', fullName: '劳动合同续签' }, + { enCode: 'leaveApply', fullName: '请假申请' }, + { enCode: 'crmOrder', fullName: '订单示例' }, +] as const + +const EXPORT_DIR = '/tmp/baseline-orig' +const MAPPING_FILE = '/tmp/baseline-mapping.json' +const CLONE_SUFFIX = '_ws' // workSystem 来源标记 + +interface Form { + id: string + enCode: string + fullName: string + type: number + enableFlow: number | null +} +interface Mapping { + origAppCode: string + origId: string + origEnCode: string + origFullName: string + cloneAppCode: string + cloneId: string + cloneEnCode: string + cloneFullName: string + imported: string +} + +function dacli(args: string, opts: { silent?: boolean } = {}): string { + if (!opts.silent) console.log(` $ dacli ${args}`) + return execSync(`npx tsx src/cli.ts ${args}`, { encoding: 'utf-8' }) +} + +async function main() { + mkdirSync(EXPORT_DIR, { recursive: true }) + + // 1. 切到 workSystem, 拿 5 张 form 的 id + console.log('▶ 切到 workSystem 拿 id...') + dacli(`switch-app --appCode=workSystem`, { silent: true }) + const listRaw = dacli(`form list --limit=200 --json`, { silent: true }) + const all = (JSON.parse(listRaw) as { list: Form[] }).list + const targets = SELECTED.map((s) => { + const f = all.find((x) => x.enCode === s.enCode) + if (!f) throw new Error(`workSystem 找不到 ${s.enCode}, list 总数=${all.length}`) + return f + }) + console.log(` ✓ 锁定 ${targets.length} 张 workSystem form`) + + // 2. export 每张 + console.log('▶ export workSystem 5 张 → /tmp/baseline-orig/') + for (const f of targets) { + const out = `${EXPORT_DIR}/${f.enCode}.json` + dacli(`form export ${f.id} --out=${out}`, { silent: true }) + console.log(` ✓ ${f.enCode} (${f.fullName})`) + } + + // 3. 切到 tds, 清掉旧 _ws 克隆 + console.log('▶ 切到 tds, 清理旧 _ws 克隆') + dacli(`switch-app --appCode=tds`, { silent: true }) + const tdsRaw = dacli(`form list --limit=200 --json`, { silent: true }) + const tdsAll = (JSON.parse(tdsRaw) as { list: Form[] }).list + for (const f of tdsAll.filter((x) => x.enCode.endsWith(CLONE_SUFFIX))) { + try { + dacli(`form delete ${f.id} --yes`, { silent: true }) + console.log(` ✗ 删旧 ${f.enCode}`) + } catch (e) { + console.log(` ! 删 ${f.enCode} 失败 (忽略): ${(e as Error).message.slice(0, 80)}`) + } + } + + // 4. import 每张 → tds + console.log('▶ import 5 张 → tds') + const mapping: Mapping[] = [] + for (const f of targets) { + const file = `${EXPORT_DIR}/${f.enCode}.json` + const cloneEnCode = `${f.enCode}${CLONE_SUFFIX}` + const cloneFullName = `${f.fullName}(ws克隆)` + try { + const out = dacli( + `form import ${file} --enCode=${cloneEnCode} --fullName="${cloneFullName}"${f.enableFlow === 1 ? '' : ' --release'}`, + { silent: true } + ) + // import 输出 "✓ 导入成功 id=XXX enCode=YYY" + const m = out.match(/id=(\S+)\s+enCode=/) + const cloneId = m?.[1] && m[1] !== '(unknown)' ? m[1] : '' + if (!cloneId) { + console.log(` ! ${f.enCode} import 返回未拿到 id: ${out.trim().slice(0, 150)}`) + continue + } + mapping.push({ + origAppCode: 'workSystem', + origId: f.id, + origEnCode: f.enCode, + origFullName: f.fullName, + cloneAppCode: 'tds', + cloneId, + cloneEnCode, + cloneFullName, + imported: new Date().toISOString(), + }) + console.log(` ✓ ${f.enCode} → ${cloneEnCode} (id=${cloneId})`) + } catch (e) { + console.log(` ✗ ${f.enCode} import 失败: ${(e as Error).message.slice(0, 200)}`) + } + } + + // 5. 写 mapping + writeFileSync(MAPPING_FILE, JSON.stringify(mapping, null, 2)) + console.log(`\n✓ ${mapping.length}/${targets.length} 张克隆成功`) + console.log(`✓ mapping 写到 ${MAPPING_FILE}`) + console.log('\n后续: npx playwright test tests/e2e/baseline/workSystem/ --project=chromium') +} + +void main().catch((e) => { + console.error('FAIL:', e.message) + process.exit(1) +}) diff --git a/src/cli.ts b/src/cli.ts new file mode 100644 index 0000000..57b8ea9 --- /dev/null +++ b/src/cli.ts @@ -0,0 +1,64 @@ +#!/usr/bin/env node +/** + * cli.ts — dacli TS 版入口 + * + * 调用: `npx tsx src/cli.ts ` 或 `node --import tsx src/cli.ts ` + * + * 设计: 嵌套子命令 (form/menu/dm/dict/workflow/doc/apis 父命令 + 子命令) + * AI 友好: 每个命令支持 --ai-help / --example / --source + */ +import { Command } from 'commander' +import { buildLoginCommand } from './commands/login.ts' +import { buildStatusCommand } from './commands/status.ts' +import { buildSwitchAppCommand } from './commands/switch-app.ts' +import { buildFormCommand } from './commands/form/index.ts' +import { buildDmCommand } from './commands/dm/index.ts' +import { buildDictCommand } from './commands/dict/index.ts' +import { buildMenuCommand } from './commands/menu/index.ts' +import { buildDiCommand } from './commands/di/index.ts' +import { buildWorkflowCommand } from './commands/workflow/index.ts' +import { buildDocCommand } from './commands/doc/index.ts' +import { buildApisCommand } from './commands/apis/index.ts' +import { maybeInterceptAiHelp } from './core/help.ts' +import { log } from './core/log.ts' +import { DacliError } from './core/types.ts' + +const VERSION = '0.1.0' + +const program = new Command() + .name('dacli') + .description('dacli (TS 版) — AI 驱动的 JNPF CLI. 0 差错 baseline 复刻.') + .version(VERSION) + .showHelpAfterError(true) + +// ----- 顶层命令 ----- +program.addCommand(buildLoginCommand()) +program.addCommand(buildStatusCommand()) +program.addCommand(buildSwitchAppCommand()) + +// ----- 嵌套父命令 ----- +program.addCommand(buildFormCommand()) +program.addCommand(buildDmCommand()) +program.addCommand(buildDictCommand()) +program.addCommand(buildMenuCommand()) +program.addCommand(buildDiCommand()) +program.addCommand(buildWorkflowCommand()) +program.addCommand(buildDocCommand()) +program.addCommand(buildApisCommand()) + +// ----- main ----- +// AI flag 拦截 (在 parse 之前, 避免 requiredOption 校验失败) +if (maybeInterceptAiHelp(program)) { + // 已 exit +} + +program.parseAsync(process.argv).catch((err: unknown) => { + if (err instanceof DacliError) { + log.error(`${err.message}`) + if (err.raw && process.env.DACLI_DEBUG === '1') log.dim(err.raw) + process.exit(1) + } + log.error(`${(err as Error).message}`) + if (process.env.DACLI_DEBUG === '1') console.error(err) + process.exit(1) +}) diff --git a/src/commands/apis/index.ts b/src/commands/apis/index.ts new file mode 100644 index 0000000..8de16f4 --- /dev/null +++ b/src/commands/apis/index.ts @@ -0,0 +1,11 @@ +/** + * commands/apis/index.ts — apis 父命令 (JNPF OpenAPI 查询) + */ +import { Command } from 'commander' +import { buildApisListCommand } from './list.ts' + +export function buildApisCommand(): Command { + const cmd = new Command('apis').description('JNPF 平台 API 查 (OpenAPI)') + cmd.addCommand(buildApisListCommand()) + return cmd +} diff --git a/src/commands/apis/list.ts b/src/commands/apis/list.ts new file mode 100644 index 0000000..53e8348 --- /dev/null +++ b/src/commands/apis/list.ts @@ -0,0 +1,82 @@ +/** + * commands/apis/list.ts — JNPF OpenAPI 接口列表 + * + * API: GET /v3/api-docs (SpringDoc) → 解析 paths + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { tag?: string; method?: string; keyword?: string; json?: boolean } + +interface OpenApiPath { + [method: string]: { + summary?: string + tags?: string[] + operationId?: string + parameters?: unknown[] + } +} + +interface OpenApiDoc { + paths: Record + tags?: { name: string; description?: string }[] +} + +export function buildApisListCommand(): Command { + const cmd = new Command('list') + .description('列 JNPF 平台所有 API (从 /v3/api-docs 拉取)') + .option('--tag ', '按 tag 过滤 (e.g. visualdev / system / workflow)') + .option('--method ', '按 HTTP method 过滤 (GET/POST/...)') + .option('--keyword ', '按 path 或 summary 搜索') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + // /v3/api-docs 是 SpringDoc 全局, 绕过 /api 前缀; 同时 nginx 经常不代理这路径, + // 优先尝试 backend (127.0.0.1:30000) 然后再试 baseUrl 去 /api + const host = c.baseUrl.replace(/\/api$/, '').replace(/\/+$/, '') + const candidates = [ + host.replace(/^http:\/\/[^/]+/, 'http://127.0.0.1:30000') + '/v3/api-docs', + host + '/v3/api-docs', + ] + let res: Response | null = null + let lastErr = '' + for (const url of candidates) { + log.debug('GET', url) + try { + const r = await fetch(url, { headers: { Authorization: c.token } }) + if (r.ok) { res = r; break } + lastErr = `HTTP ${r.status}` + } catch (e) { lastErr = (e as Error).message } + } + if (!res) { log.error(`apis list 失败: ${lastErr}`); process.exit(1) } + const doc = (await res.json()) as OpenApiDoc + const rows: { method: string; path: string; summary: string; tags: string[] }[] = [] + for (const [path, methods] of Object.entries(doc.paths || {})) { + for (const [method, op] of Object.entries(methods)) { + if (opts.method && method.toUpperCase() !== opts.method.toUpperCase()) continue + if (opts.tag && !(op.tags || []).includes(opts.tag)) continue + if (opts.keyword && !`${path} ${op.summary || ''}`.toLowerCase().includes(opts.keyword.toLowerCase())) continue + rows.push({ method: method.toUpperCase(), path, summary: op.summary || '', tags: op.tags || [] }) + } + } + if (opts.json) { printJson(rows); return } + log.info(`共 ${rows.length} 个 API`) + console.log('METHOD PATH TAGS') + console.log('-'.repeat(100)) + for (const r of rows) { + console.log(`${r.method.padEnd(7)} ${r.path.padEnd(60)} ${r.tags.join(',')}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '列 JNPF 平台全量 API. AI 干活前先 --tag 查相关业务接口.', + required: {}, + optional: { '--tag': '按 tag 过滤', '--method': 'GET/POST', '--keyword': '搜索' }, + example: ['dacli apis list --tag=visualdev', 'dacli apis list --keyword=用户'], + source: { api: 'GET /v3/api-docs (SpringDoc OpenAPI)' }, + notes: ['镜像 Java dacli 行为, 但 TS 版不写本地缓存, 每次现拉 (v1 简化)'], + }) + return cmd +} diff --git a/src/commands/di/index.ts b/src/commands/di/index.ts new file mode 100644 index 0000000..8e4ffeb --- /dev/null +++ b/src/commands/di/index.ts @@ -0,0 +1,11 @@ +/** + * commands/di/index.ts — di 父命令 (数据接口) + */ +import { Command } from 'commander' +import { buildDiListCommand } from './list.ts' + +export function buildDiCommand(): Command { + const cmd = new Command('di').description('数据接口 (弹窗选择/下拉补全/关联表单)') + cmd.addCommand(buildDiListCommand()) + return cmd +} diff --git a/src/commands/di/list.ts b/src/commands/di/list.ts new file mode 100644 index 0000000..e21cc07 --- /dev/null +++ b/src/commands/di/list.ts @@ -0,0 +1,45 @@ +/** + * commands/di/list.ts — 数据接口列表 + * + * API: GET /api/system/DataInterface + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { json?: boolean; keyword?: string; currentPage?: string; pageSize?: string } + +export function buildDiListCommand(): Command { + const cmd = new Command('list') + .description('数据接口列表 (form select 弹窗常用)') + .option('--keyword ', '搜索') + .option('--currentPage

', '页码', '1') + .option('--pageSize ', '每页', '50') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + const r = await c.get<{ list?: { id: string; fullName: string; enCode: string; categoryId?: string }[] }>( + '/system/DataInterface', + { keyword: opts.keyword, currentPage: opts.currentPage, pageSize: opts.pageSize }, + ) + if (r.code !== 200) { log.error(`di list 失败: ${r.msg}`); process.exit(1) } + const list = r.data?.list || [] + if (opts.json) { printJson(r.data); return } + log.info(`共 ${list.length} 个数据接口`) + console.log('ID FULL_NAME ENCODE') + console.log('-'.repeat(80)) + for (const d of list) { + console.log(`${String(d.id).padEnd(36)}${(d.fullName || '').padEnd(22)}${d.enCode || ''}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '列出所有数据接口 (弹窗选择/下拉补全/关联表单用).', + required: {}, + optional: { '--keyword': '搜索' }, + example: 'dacli di list', + source: { api: 'GET /api/system/DataInterface' }, + }) + return cmd +} diff --git a/src/commands/dict/data-list.ts b/src/commands/dict/data-list.ts new file mode 100644 index 0000000..90f7d45 --- /dev/null +++ b/src/commands/dict/data-list.ts @@ -0,0 +1,51 @@ +/** + * commands/dict/data-list.ts — 字典数据列表 + * + * API: GET /api/system/DictionaryData/{typeId}/Data 或 /All + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { + typeId?: string + all?: boolean + json?: boolean +} + +export function buildDictDataListCommand(): Command { + const cmd = new Command('data-list') + .description('字典数据列表 (按 typeId 或全部)') + .option('--typeId ', '字典类型 id (不传则返回全部)') + .option('--all', '等价于不传 typeId 调 /All', false) + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + let path: string + if (opts.all || !opts.typeId) { + path = '/system/DictionaryData/All' + } else { + path = `/system/DictionaryData/${opts.typeId}/Data` + } + const r = await c.get(path) + if (r.code !== 200) { log.error(`dict data-list 失败: ${r.msg}`); process.exit(1) } + if (opts.json) { printJson(r.data); return } + const list = (Array.isArray(r.data) ? r.data : (r.data as { list?: unknown[] })?.list) || [] + log.info(`${path} 共 ${list.length} 条`) + console.log('ENCODE FULL_NAME SORT') + console.log('-'.repeat(60)) + for (const d of list as Record[]) { + console.log(`${String(d.enCode || d.id || '').padEnd(21)}${String(d.fullName || '').padEnd(22)}${d.sortCode || ''}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '看字典数据. --typeId 看单类型, 不传 --all 拿全部.', + required: {}, + optional: { '--typeId': '字典类型 id', '--all': '拿全部字典' }, + example: 'dacli dict data-list --typeId=', + source: { api: 'GET /api/system/DictionaryData/{typeId}/Data 或 /All' }, + }) + return cmd +} diff --git a/src/commands/dict/index.ts b/src/commands/dict/index.ts new file mode 100644 index 0000000..ef642fc --- /dev/null +++ b/src/commands/dict/index.ts @@ -0,0 +1,13 @@ +/** + * commands/dict/index.ts — dict 父命令 + */ +import { Command } from 'commander' +import { buildDictTypeListCommand } from './type-list.ts' +import { buildDictDataListCommand } from './data-list.ts' + +export function buildDictCommand(): Command { + const cmd = new Command('dict').description('字典管理 (类型 + 数据)') + cmd.addCommand(buildDictTypeListCommand()) + cmd.addCommand(buildDictDataListCommand()) + return cmd +} diff --git a/src/commands/dict/type-list.ts b/src/commands/dict/type-list.ts new file mode 100644 index 0000000..f6cf6d9 --- /dev/null +++ b/src/commands/dict/type-list.ts @@ -0,0 +1,40 @@ +/** + * commands/dict/type-list.ts — 字典类型列表 + * + * API: GET /api/system/DictionaryType + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { json?: boolean; keyword?: string } + +export function buildDictTypeListCommand(): Command { + const cmd = new Command('type-list') + .description('字典类型列表') + .option('--keyword ', '按编码/名称搜索') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + const r = await c.get('/system/DictionaryType', { keyword: opts.keyword }) + if (r.code !== 200) { log.error(`dict type-list 失败: ${r.msg}`); process.exit(1) } + if (opts.json) { printJson(r.data); return } + const list = (r.data as { list?: Record[] })?.list || [] + log.info(`共 ${list.length} 个字典类型`) + console.log('ID ENCODE FULL_NAME') + console.log('-'.repeat(80)) + for (const t of list) { + console.log(`${String(t.id || '').padEnd(36)}${String(t.enCode || '').padEnd(21)}${t.fullName || ''}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '列出所有字典类型 (e.g. 性别/状态/教育程度 等下拉字典).', + required: {}, + optional: { '--keyword': '搜索关键字' }, + example: 'dacli dict type-list', + source: { api: 'GET /api/system/DictionaryType' }, + }) + return cmd +} diff --git a/src/commands/dm/create.ts b/src/commands/dm/create.ts new file mode 100644 index 0000000..763726f --- /dev/null +++ b/src/commands/dm/create.ts @@ -0,0 +1,91 @@ +/** + * commands/dm/create.ts — 创建物理表 + * + * API: POST /api/system/DataModel/{linkId}/Table + * + * 注意: tables[].fields[] 必须含 autoIncrement/identity/columnName 等 + * 见 prompt §6.3 "Database exception" + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface CreateOpts { + table: string + tableName: string + dbLinkId?: string + fields: string + json?: boolean +} + +export function buildDmCreateCommand(): Command { + const cmd = new Command('create') + .description('在指定业务库建物理表 (fields 必传 JSON)') + .requiredOption('--table ', '表名 (snake_case)') + .requiredOption('--tableName ', '表中文名') + .requiredOption('--fields ', '字段定义 JSON 数组') + .option('--dbLinkId ', '业务库 id (默认从 token.dbLinkId)') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: CreateOpts) => { + const c = await JnpfClient.fromToken() + const dbLinkId = opts.dbLinkId || c.dbLinkId || '0' + + const userFields = JSON.parse(opts.fields) as Record[] + // 强制补全 schema 必填项 (autoIncrement/identity/columnName/index/primaryKey) + const fields = userFields.map((f) => ({ + autoIncrement: 0, + identity: 0, + primaryKey: 0, + index: '0', + columnName: f.field, + ...f, + })) + // v10.6+ JNPF runtime 要求 9 系统列 (硬编码 SQL 引用) + 复合主键 + const sysCols = [ + { field: 'f_id', fieldName: '主键', dataType: 'varchar', dataLength: '50', primaryKey: 1, allowNull: 0, autoIncrement: 0, identity: 0, columnName: 'f_id', index: '0' }, + { field: 'f_tenant_id', fieldName: '租户id', dataType: 'varchar', dataLength: '50', primaryKey: 1, allowNull: 0, autoIncrement: 0, identity: 0, columnName: 'f_tenant_id', index: '0' }, + { field: 'f_flow_task_id', fieldName: '流程任务ID', dataType: 'varchar', dataLength: '50', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_flow_task_id', index: '0' }, + { field: 'f_flow_id', fieldName: '流程ID', dataType: 'varchar', dataLength: '50', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_flow_id', index: '0' }, + { field: 'f_flow_state', fieldName: '流程状态', dataType: 'int', dataLength: '0', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_flow_state', index: '0' }, + { field: 'f_sort_code', fieldName: '排序', dataType: 'bigint', dataLength: '0', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_sort_code', index: '0' }, + { field: 'f_create_user', fieldName: '创建人', dataType: 'varchar', dataLength: '50', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_create_user', index: '0' }, + { field: 'f_create_time', fieldName: '创建时间', dataType: 'datetime', dataLength: '0', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_create_time', index: '0' }, + { field: 'f_modify_user', fieldName: '修改人', dataType: 'varchar', dataLength: '50', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_modify_user', index: '0' }, + { field: 'f_modify_time', fieldName: '修改时间', dataType: 'datetime', dataLength: '0', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_modify_time', index: '0' }, + { field: 'f_description', fieldName: '描述', dataType: 'text', dataLength: '0', primaryKey: 0, allowNull: 1, autoIncrement: 0, identity: 0, columnName: 'f_description', index: '0' }, + ] + const allFields = [...fields, ...sysCols] + // JNPF dmpost body 结构: { tableInfo:{...}, tableFieldList:[...] } + const body = { + tableInfo: { + table: opts.table, + tableName: opts.tableName, + newTable: opts.table, + primaryKeyPolicy: 1, + logicalDelete: false, + concurrencyLock: false, + }, + tableFieldList: allFields, + } + log.info(`POST /system/DataModel/${dbLinkId}/Table table=${opts.table} fields=${allFields.length} (含9系统列)`) + const r = await c.postJson<{ table?: string }>(`/system/DataModel/${dbLinkId}/Table`, body) + if (r.code !== 200) { + log.error(`建表失败 (code=${r.code}): ${r.msg}`) + if (opts.json) printJson(r) + process.exit(1) + } + log.ok(`建表成功: ${opts.table}`) + if (opts.json) printJson(r.data) + }) + + installAiHelpHook(cmd, { + purpose: '在指定业务库建物理表. fields JSON 必含 field/fieldName/dataType/dataLength.', + required: { '--table': '表名', '--tableName': '中文名', '--fields': '字段 JSON' }, + optional: { '--dbLinkId': '业务库 id' }, + example: `dacli dm create --table=test_table --tableName="测试表" --fields='[{"field":"f_name","fieldName":"名称","dataType":"varchar","dataLength":"100","allowNull":0}]'`, + source: { api: 'POST /api/system/DataModel/{dbLinkId}/Table' }, + notes: ['autoIncrement/identity/columnName 已自动补全', '建表前确认 dbLinkId 对应业务库'], + }) + return cmd +} diff --git a/src/commands/dm/drop.ts b/src/commands/dm/drop.ts new file mode 100644 index 0000000..5271215 --- /dev/null +++ b/src/commands/dm/drop.ts @@ -0,0 +1,51 @@ +/** + * commands/dm/drop.ts — 删除物理表 + * + * API: DELETE /api/system/DataModel/{linkId}/Table/{table} + * + * ⚠️ 危险操作, 表数据不可恢复. 真实执行需双重人工确认 (TODO: 加 TTY 拦截) + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log } from '../../core/log.ts' + +interface DropOpts { + table: string + dbLinkId?: string + yes?: boolean +} + +export function buildDmDropCommand(): Command { + const cmd = new Command('drop') + .description('删除物理表 (⚠️ 不可恢复)') + .requiredOption('--table ', '表名') + .option('--dbLinkId ', '业务库 id') + .option('--yes', '跳过确认', false) + .action(async (opts: DropOpts) => { + if (!opts.yes) { + log.warn(`即将删除表: ${opts.table}`) + log.warn('传 --yes 确认 (数据不可恢复)') + process.exit(2) + } + const c = await JnpfClient.fromToken() + const dbLinkId = opts.dbLinkId || c.dbLinkId || '0' + log.info(`DELETE /system/DataModel/${dbLinkId}/Table/${opts.table}`) + const r = await c.del(`/system/DataModel/${dbLinkId}/Table/${opts.table}`) + if (r.code !== 200) { + log.error(`删表失败 (code=${r.code}): ${r.msg}`) + process.exit(1) + } + log.ok(`已删除: ${opts.table}`) + }) + + installAiHelpHook(cmd, { + purpose: '删除物理表. ⚠️ 不可恢复.', + required: { '--table': '表名', '--yes': '必须传 --yes 跳过确认' }, + optional: { '--dbLinkId': '业务库 id' }, + example: 'dacli dm drop --table=test_table --yes', + source: { api: 'DELETE /api/system/DataModel/{dbLinkId}/Table/{table}' }, + notes: ['生产环境务必先用 dacli initapp --backup 备份'], + }) + return cmd +} diff --git a/src/commands/dm/fields.ts b/src/commands/dm/fields.ts new file mode 100644 index 0000000..9b06413 --- /dev/null +++ b/src/commands/dm/fields.ts @@ -0,0 +1,66 @@ +/** + * commands/dm/fields.ts — 看表字段 + * + * API: GET /api/system/DataModel/{linkId}/Tables/{table}/Fields?field=* + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface FieldsOpts { + table: string + dbLinkId?: string + json?: boolean +} + +export function buildDmFieldsCommand(): Command { + const cmd = new Command('fields') + .description('看物理表的所有字段') + .requiredOption('--table ', '表名') + .option('--dbLinkId ', '业务库 id') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: FieldsOpts) => { + const c = await JnpfClient.fromToken() + const dbLinkId = opts.dbLinkId || c.dbLinkId || '0' + const r = await c.get<{ fields?: Record[] } | Record>( + `/system/DataModel/${dbLinkId}/Tables/${opts.table}/Fields`, + { field: '*' }, + ) + if (r.code !== 200) { + log.error(`查字段失败 (code=${r.code}): ${r.msg}`) + process.exit(1) + } + if (opts.json) { + printJson(r.data) + return + } + // 兼容 data 是数组 / { list: [...] } (后端实际) / { fields: [...] } + const dataObj = r.data as Record | unknown[] | null + const arr = Array.isArray(dataObj) + ? dataObj + : ((dataObj as { list?: unknown[]; fields?: unknown[] })?.list || + (dataObj as { fields?: unknown[] })?.fields || + []) + log.info(`表 ${opts.table} 字段数=${arr.length}`) + console.log('FIELD TYPE LENGTH NULL PK') + console.log('-'.repeat(60)) + for (const f of arr as Array>) { + const field = String(f.field || f.columnName || '').padEnd(20) + const type = String(f.dataType || '').padEnd(14) + const len = String(f.dataLength || '').padEnd(7) + const nullable = f.allowNull === 0 || f.allowNull === '0' ? 'NO' : 'YES' + const pk = f.primaryKey === 1 || f.primaryKey === '1' ? 'PK' : '' + console.log(`${field}${type}${len}${nullable.padEnd(5)}${pk}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '查指定物理表的所有字段定义.', + required: { '--table': '表名' }, + optional: { '--dbLinkId': '业务库 id' }, + example: 'dacli dm fields --table=leave', + source: { api: 'GET /api/system/DataModel/{dbLinkId}/Tables/{table}/Fields' }, + }) + return cmd +} diff --git a/src/commands/dm/index.ts b/src/commands/dm/index.ts new file mode 100644 index 0000000..35c547d --- /dev/null +++ b/src/commands/dm/index.ts @@ -0,0 +1,25 @@ +/** + * commands/dm/index.ts — dm 父命令 + * + * 数据模型 CRUD (JNPF 业务库/主库物理表管理) + * + * 子命令: + * list 列表 + * create 建表 + * drop 删表 + * fields 看字段 + */ +import { Command } from 'commander' +import { buildDmListCommand } from './list.ts' +import { buildDmCreateCommand } from './create.ts' +import { buildDmDropCommand } from './drop.ts' +import { buildDmFieldsCommand } from './fields.ts' + +export function buildDmCommand(): Command { + const cmd = new Command('dm').description('数据模型 (业务库物理表) 管理') + cmd.addCommand(buildDmListCommand()) + cmd.addCommand(buildDmCreateCommand()) + cmd.addCommand(buildDmDropCommand()) + cmd.addCommand(buildDmFieldsCommand()) + return cmd +} diff --git a/src/commands/dm/list.ts b/src/commands/dm/list.ts new file mode 100644 index 0000000..8575ca3 --- /dev/null +++ b/src/commands/dm/list.ts @@ -0,0 +1,59 @@ +/** + * commands/dm/list.ts — 列出数据模型表 + * + * API: GET /api/system/DataModel/{linkId}/Tables?currentPage=&pageSize=&keyword= + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface ListOpts { + dbLinkId?: string + keyword?: string + page?: string + pageSize?: string + json?: boolean +} + +export function buildDmListCommand(): Command { + const cmd = new Command('list') + .description('列出数据模型 (业务库/主库表)') + .option('--dbLinkId ', '业务库 id (默认从 token.dbLinkId)') + .option('--keyword ', '按表名模糊搜索') + .option('--page

', '页码', '1') + .option('--pageSize ', '每页条数', '50') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: ListOpts) => { + const c = await JnpfClient.fromToken() + const dbLinkId = opts.dbLinkId || c.dbLinkId || '0' + const r = await c.get<{ list: { table: string; tableName: string; primaryKeyPolicy?: number }[] }>( + `/system/DataModel/${dbLinkId}/Tables`, + { currentPage: opts.page, pageSize: opts.pageSize, keyword: opts.keyword }, + ) + if (r.code !== 200) { + log.error(`dm list 失败 (code=${r.code}): ${r.msg}`) + process.exit(1) + } + const list = r.data?.list || [] + if (opts.json) { + printJson(r.data) + return + } + log.info(`dbLinkId=${dbLinkId} 共 ${list.length} 张表`) + console.log('TABLE TABLE_NAME(中文)') + console.log('-'.repeat(60)) + for (const t of list) { + console.log(`${t.table.padEnd(30)}${t.tableName || ''}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '列出指定业务库的所有数据模型表. dbLinkId=0 是主库 (平台库).', + required: {}, + optional: { '--dbLinkId': '业务库 id', '--keyword': '表名搜索', '--page': '页码', '--pageSize': '每页条数' }, + example: 'dacli dm list', + source: { api: 'GET /api/system/DataModel/{dbLinkId}/Tables' }, + }) + return cmd +} diff --git a/src/commands/doc/index.ts b/src/commands/doc/index.ts new file mode 100644 index 0000000..cf874cb --- /dev/null +++ b/src/commands/doc/index.ts @@ -0,0 +1,11 @@ +/** + * commands/doc/index.ts — doc 父命令 (HTML 文档) + */ +import { Command } from 'commander' +import { buildDocListCommand } from './list.ts' + +export function buildDocCommand(): Command { + const cmd = new Command('doc').description('HTML 文档 (从 docs/{app}/ 扫描)') + cmd.addCommand(buildDocListCommand()) + return cmd +} diff --git a/src/commands/doc/list.ts b/src/commands/doc/list.ts new file mode 100644 index 0000000..f238b26 --- /dev/null +++ b/src/commands/doc/list.ts @@ -0,0 +1,57 @@ +/** + * commands/doc/list.ts — 列出 HTML 文档 (来自 docs/{app}/) + * + * v1 简化版: 仅扫描 .claude/skills/dacli-ts/examples/docs/ 和 docs/{app_code}/ + * 镜像 Java dacli 的 HTML 缓存子命令, 但不写 SQLite (避免依赖) + */ +import { Command } from 'commander' +import { readdirSync, statSync, existsSync } from 'node:fs' +import { join, resolve } from 'node:path' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { dir?: string; json?: boolean } + +interface DocFile { path: string; size: number; mtime: Date } + +function walkHtml(dir: string, base = ''): DocFile[] { + if (!existsSync(dir)) return [] + const out: DocFile[] = [] + for (const name of readdirSync(dir)) { + const full = join(dir, name) + const rel = base ? `${base}/${name}` : name + const s = statSync(full) + if (s.isDirectory()) out.push(...walkHtml(full, rel)) + else if (name.endsWith('.html') || name.endsWith('.htm')) { + out.push({ path: rel, size: s.size, mtime: s.mtime }) + } + } + return out.sort((a, b) => a.path.localeCompare(b.path)) +} + +export function buildDocListCommand(): Command { + const cmd = new Command('list') + .description('列 HTML 文档 (从 docs/{app_code}/ 扫描)') + .option('--dir ', '扫描目录 (默认 docs/)', 'docs') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const target = resolve(process.cwd(), opts.dir || 'docs') + const files = walkHtml(target) + if (opts.json) { printJson(files); return } + log.info(`目录 ${target} 共 ${files.length} 个 HTML 文档`) + console.log('PATH SIZE MTIME') + console.log('-'.repeat(80)) + for (const f of files) { + console.log(`${f.path.padEnd(50)}${String(f.size).padEnd(7)}${f.mtime.toISOString().slice(0, 16)}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '列 HTML 文档, AI 上下文恢复时先看 list 再 cat 关键 section.', + required: {}, + optional: { '--dir': '扫描目录' }, + example: ['dacli doc list', 'dacli doc list --dir=docs/tds'], + notes: ['镜像 Java dacli doc 行为, v1 不写本地缓存 (直接读文件系统)'], + }) + return cmd +} diff --git a/src/commands/form/clone.ts b/src/commands/form/clone.ts new file mode 100644 index 0000000..43607b0 --- /dev/null +++ b/src/commands/form/clone.ts @@ -0,0 +1,75 @@ +/** + * commands/form/clone.ts — 克隆表单 (export + import 一步到位) + * + * AI 黄金法则: 99% 的"建新表单"应该 clone 再改 + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log } from '../../core/log.ts' +import type { FormDetail } from '../../core/types.ts' + +type Cloneable = Record & Partial + +interface CloneOpts { + newEnCode?: string + newFullName?: string + newDbLinkId?: string + release?: boolean +} + +export function buildFormCloneCommand(): Command { + const cmd = new Command('clone') + .description('克隆表单 (export + import 一步搞定)') + .argument('', '源表单 id') + .option('--newEnCode ', '新 enCode (默认原 +_clone)') + .option('--newFullName ', '新中文名 (默认原 +_克隆)') + .option('--newDbLinkId ', '新业务库 id (跨应用克隆必传)') + .option('--release', '克隆后立刻发布', false) + .action(async (id: string, opts: CloneOpts) => { + const c = await JnpfClient.fromToken() + const r = await c.get(`/visualdev/Base/${id}`) + const src = c.ok(r) as Cloneable + delete src.id + delete src.creatorTime + delete src.creatorUserId + delete src.systemId + src.state = 0 + src.enCode = opts.newEnCode || `${src.enCode}_clone` + if (opts.newFullName) src.fullName = opts.newFullName + else src.fullName = `${src.fullName}_克隆` + if (opts.newDbLinkId) src.dbLinkId = opts.newDbLinkId + + const rr = await c.postJson('/visualdev/Base', src) + if (rr.code !== 200) { + log.error(`克隆失败 code=${rr.code}: ${rr.msg}`) + process.exit(1) + } + const listR = await c.get<{ list: { id: string; enCode: string }[] }>('/visualdev/Base/list', { + keyword: src.enCode, + }) + const newId = listR.data?.list.find((f) => f.enCode === src.enCode)?.id || '(unknown)' + log.ok(`克隆成功 ${id} → ${newId} enCode=${src.enCode}`) + + if (opts.release && src.type !== 4 && newId !== '(unknown)') { + const r3 = await c.postJson(`/visualdev/Base/${newId}/Actions/Release`, {}) + if (r3.code === 200) log.ok('发布成功') + else log.warn(`发布失败 code=${r3.code}: ${r3.msg}`) + } + }) + + installAiHelpHook(cmd, { + purpose: 'AI 黄金法则: 99% 的新表单应 clone 再改, 不要从零搭. 这是 dacli 最常用的命令', + required: { '': '源表单 id' }, + optional: { + '--newEnCode': '新 enCode', + '--newFullName': '新中文名', + '--newDbLinkId': '跨应用克隆必传', + '--release': '克隆后立刻发布 (type=4 自动跳过)', + }, + example: 'dacli form clone 12345 --newEnCode=leaveV2 --release', + source: { api: 'GET /visualdev/Base/:id + POST /visualdev/Base' }, + }) + + return cmd +} diff --git a/src/commands/form/create.ts b/src/commands/form/create.ts new file mode 100644 index 0000000..ab0e391 --- /dev/null +++ b/src/commands/form/create.ts @@ -0,0 +1,154 @@ +/** + * commands/form/create.ts — 创建表单 + * + * 默认场景 (AI 友好): + * - type=4 (视图, 无物理表) + webType=1 → 99% 不会 "Database exception" + * - 完整字段走 --fields JSON + * + * 提示: clone 优先, 这是兜底 + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface CreateOpts { + fullName: string + enCode: string + type?: string + webType?: string + category?: string + dbLinkId?: string + fields?: string + tables?: string + enableFlow?: string + flowId?: string + autoRelease?: boolean + json?: boolean +} + +export function buildFormCreateCommand(): Command { + const cmd = new Command('create') + .description('创建表单 (默认 type=4 视图 + webType=1, 兜底不会 Database exception)') + .requiredOption('--fullName ', '中文名') + .requiredOption('--enCode ', '英文编码 (snake/camelCase)') + .option('--type ', '1=自定义 2=系统 3=接口 4=视图', '4') + .option('--webType ', '1=仅表单 2=表单+列表 3=树+表单 4=数据视图', '1') + .option('--category ', '分类 id (form list 看真实值)') + .option('--dbLinkId ', 'db link id (type≠4 时必传, 默认从 token.dbLinkId)') + .option('--fields ', 'formData.fields JSON 数组') + .option('--tables ', 'tables JSON 数组 (type=1/2 必传)') + .option('--enableFlow <0|1>', '是否绑工作流', '0') + .option('--flowId ', '工作流 id (enableFlow=1 时必传)') + .option('--autoRelease', '建完立刻发布 (type=4 自动跳过)', false) + .option('--json', '原始 JSON 输出', false) + .action(async (opts: CreateOpts) => { + const c = await JnpfClient.fromToken() + const type = Number(opts.type) + const webType = Number(opts.webType) + const dbLinkId = opts.dbLinkId || c.dbLinkId || '0' + + const formData = { + formRef: 'formRef', + formModel: 'dataForm', + fields: opts.fields ? JSON.parse(opts.fields) : [], + tableName: opts.enCode, + } + const columnDataObj = { + columnOptions: [], + searchList: [], + formData: {}, + tableConfig: { border: true, stripe: false, size: 'default', showRadio: false, showRowNumber: true }, + relationForm: { ' popupTable': '', columnOptions: [], searchForms: [] }, + } + const tables = opts.tables + ? JSON.parse(opts.tables) + : type === 4 + ? [] + : [ + { + table: opts.enCode, + typeId: '1', + comment: '主表', + fields: [ + { dataType: 'varchar', field: 'f_id', fieldName: '主键', primaryKey: 1 }, + { dataType: 'varchar', field: 'f_tenant_id', fieldName: '租户id', primaryKey: 1 }, + ], + }, + ] + + const body: Record = { + fullName: opts.fullName, + enCode: opts.enCode, + type, + webType: String(webType), + category: opts.category || null, + description: 'created by dacli (TS)', + dbLinkId, + enableFlow: Number(opts.enableFlow || '0'), + flowId: opts.flowId || '', + // 关键: formData/columnData/appColumnData/tables 都是字符串! + formData: JSON.stringify(formData), + columnData: JSON.stringify(columnDataObj), + appColumnData: JSON.stringify(columnDataObj), + tables: JSON.stringify(tables), + state: 0, + sortCode: 0, + } + + log.info(`POST /visualdev/Base ${opts.enCode} type=${type} webType=${webType} dbLinkId=${dbLinkId}`) + const r = await c.postJson('/visualdev/Base', body) + if (r.code !== 200) { + log.error(`创建失败 (code=${r.code}): ${r.msg}`) + if (opts.json) printJson(r) + process.exit(1) + } + + // 拉 id (响应通常不回 id, 反查 list) + const listR = await c.get<{ list: { id: string; enCode: string }[] }>('/visualdev/Base/list', { + keyword: opts.enCode, + }) + const newForm = listR.data?.list.find((f) => f.enCode === opts.enCode) + const newId = newForm?.id || '(unknown)' + log.ok(`创建成功: id=${newId} enCode=${opts.enCode}`) + + if (opts.autoRelease && type !== 4 && newId !== '(unknown)') { + log.info(`发布: POST /visualdev/Base/${newId}/Actions/Release (v0.7 修)`) + const rr = await c.postJson(`/visualdev/Base/${newId}/Actions/Release`, {}) + if (rr.code === 200) log.ok('发布成功 (state=1)') + else log.warn(`发布失败 (code=${rr.code}): ${rr.msg}`) + } else if (opts.autoRelease && type === 4) { + log.warn('type=4 视图自动跳过 release (会 400)') + } + + if (opts.json) printJson({ id: newId, enCode: opts.enCode, type, webType }) + }) + + installAiHelpHook(cmd, { + purpose: '创建表单. 默认 type=4 (视图) 兜底, 不会 Database exception. 业务建议 clone', + required: { '--fullName': '中文名', '--enCode': '英文编码' }, + optional: { + '--type': '1/2/3/4 (默认 4)', + '--webType': '1/2/3/4 (默认 1)', + '--category': '分类 id', + '--dbLinkId': '业务库 id (type≠4 时必传)', + '--fields': 'formData.fields JSON', + '--tables': 'tables JSON (type=1/2)', + '--enableFlow': '0|1', + '--flowId': '工作流 id', + '--autoRelease': '建完立刻发布 (type=4 自动跳过)', + }, + example: [ + 'dacli form create --fullName="POC 视图" --enCode=pocView', + 'dacli form create --fullName="请假" --enCode=leave --type=1 --webType=2 --dbLinkId=664... --tables=\'[{"table":"leave","tableName":"请假"}]\' --fields=\'[...]\' --autoRelease', + ], + source: { web: 'web/.../formDesign/Form.vue:444-465', api: 'POST /api/visualdev/Base' }, + notes: [ + 'type=4 视图最稳, 不动物理表', + 'AI 黄金法则: 99% 应先 clone 再改', + 'autoRelease 对 type=4 自动跳过 (release 会 400)', + ], + }) + + return cmd +} diff --git a/src/commands/form/delete.ts b/src/commands/form/delete.ts new file mode 100644 index 0000000..2371f27 --- /dev/null +++ b/src/commands/form/delete.ts @@ -0,0 +1,37 @@ +/** + * commands/form/delete.ts — 删表单 + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log } from '../../core/log.ts' + +export function buildFormDeleteCommand(): Command { + const cmd = new Command('delete') + .description('删除表单') + .argument('', '表单 id') + .option('--yes', '跳过确认', false) + .action(async (id: string, opts: { yes?: boolean }) => { + if (!opts.yes && process.stdin.isTTY) { + log.warn(`确认删除 id=${id}? 加 --yes 跳过提示`) + process.exit(1) + } + const c = await JnpfClient.fromToken() + const r = await c.del(`/visualdev/Base/${id}`) + if (r.code === 200) log.ok(`已删 id=${id}`) + else { + log.error(`删除失败 code=${r.code}: ${r.msg}`) + process.exit(1) + } + }) + + installAiHelpHook(cmd, { + purpose: '删除表单. 不可恢复, 加 --yes 跳过确认', + required: { '': '表单 id' }, + optional: { '--yes': '跳过确认' }, + example: 'dacli form delete 1234567890 --yes', + source: { api: 'DELETE /api/visualdev/Base/:id' }, + }) + + return cmd +} diff --git a/src/commands/form/export.ts b/src/commands/form/export.ts new file mode 100644 index 0000000..bb4b8bc --- /dev/null +++ b/src/commands/form/export.ts @@ -0,0 +1,111 @@ +/** + * commands/form/export.ts — 导出表单 JSON + * + * v0.7: 同时拉物理表 schema 存到 `_physicalSchema`, + * 解 #15 (web Form.vue tables[].fields 是 DB 实时查的, 不在 form JSON 里). + * 配合 import.ts 的 --autoTable 在目标库重建物理表. + * + * 关键: web 端 createDataModel 是单独走「数据建模」入口, form 设计器只引用表名; + * 迁移时若不带物理 schema 出来, import 后浏览器报 "该表单已删除". + */ +import { writeFileSync } from 'node:fs' +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' +import type { FormDetail } from '../../core/types.ts' + +interface PhysicalSchemaEntry { + table: string + tableName?: string + typeId?: string + fields: Record[] +} + +interface ExportedForm extends FormDetail { + _physicalSchema?: PhysicalSchemaEntry[] + _exportedAt?: string +} + +export function buildFormExportCommand(): Command { + const cmd = new Command('export') + .description('导出表单完整 schema 到文件 (v0.7 同时带物理表 schema, 解 #15)') + .argument('', '表单 id') + .option('--out ', '输出文件路径 (默认 ./.json)') + .option('--no-physical', '不带物理表 schema (默认会带, 兼容旧版导出)') + .action(async (id: string, opts: { out?: string; physical?: boolean }) => { + const c = await JnpfClient.fromToken() + const r = await c.get(`/visualdev/Base/${id}`) + const data = c.ok(r) as ExportedForm + + // v0.7: 拉物理表 schema (除非 --no-physical) + if (opts.physical !== false) { + try { + // FormDetail.tables 类型偏宽, 后端实际返 JSON string, 强转 + const tables = data.tables + ? (JSON.parse(typeof data.tables === 'string' ? data.tables : JSON.stringify(data.tables)) as Array< + Record + >) + : [] + const physical: PhysicalSchemaEntry[] = [] + for (const t of tables) { + const tableName = String(t.table || '') + if (!tableName) continue + const dbLinkId = String(data.dbLinkId || '0') + try { + const fr = await c.get<{ fields?: Record[] } | Record[]>( + `/system/DataModel/${dbLinkId}/Tables/${tableName}/Fields`, + { field: '*' }, + ) + if (fr.code === 200) { + const arr = Array.isArray(fr.data) + ? fr.data + : (fr.data as { fields?: Record[] })?.fields || [] + physical.push({ + table: tableName, + tableName: t.tableName as string | undefined, + typeId: t.typeId as string | undefined, + fields: arr, + }) + log.debug(` ↳ 拉 ${tableName} 字段 ×${arr.length}`) + } else { + log.warn(` ↳ ${tableName} 字段查失败 code=${fr.code}: ${fr.msg} (跳过)`) + } + } catch (e) { + log.warn(` ↳ ${tableName} 字段查异常: ${(e as Error).message} (跳过)`) + } + } + if (physical.length) { + data._physicalSchema = physical + data._exportedAt = new Date().toISOString() + } + } catch (e) { + log.warn(`物理表 schema 解析失败 (跳过): ${(e as Error).message}`) + } + } + + const path = opts.out || `./${data.enCode || id}.json` + writeFileSync(path, JSON.stringify(data, null, 2), 'utf-8') + const sizeKb = (JSON.stringify(data).length / 1024).toFixed(1) + const phyCount = data._physicalSchema?.length ?? 0 + log.ok(`已导出 ${data.enCode} → ${path} (${sizeKb} KB, 含 ${phyCount} 张物理表 schema)`) + if (!opts.out) printJson({ id, enCode: data.enCode, path, physicalTables: phyCount }) + }) + + installAiHelpHook(cmd, { + purpose: '导出表单完整 schema + 物理表 schema 到文件 (v0.7 解 #15). 用于 baseline 复刻 / 备份 / 跨应用迁移', + required: { '': '源表单 id' }, + optional: { + '--out': '输出路径, 默认 ./.json', + '--no-physical': '不带物理表 schema (兼容旧导出格式)', + }, + example: 'dacli form export 12345 --out=/tmp/leave.json', + source: { api: 'GET /api/visualdev/Base/:id + GET /api/system/DataModel/:linkId/Tables/:table/Fields' }, + notes: [ + 'v0.7 默认带物理表 schema (_physicalSchema 字段), 配合 form import --autoTable 重建物理表', + 'web/.../formDesign/Form.vue tables[].fields 是 DB 实时查的, 不在 form JSON 里, 所以必须单独拉', + ], + }) + + return cmd +} diff --git a/src/commands/form/import.ts b/src/commands/form/import.ts new file mode 100644 index 0000000..5ecd08c --- /dev/null +++ b/src/commands/form/import.ts @@ -0,0 +1,254 @@ +/** + * commands/form/import.ts — 导入表单 JSON + * + * v0.7: 加 --autoTable (默认 true) 解 #15. + * - 检测 _physicalSchema → 先在目标 dbLinkId 重建物理表 + * - 重命名 tables[].table + formData[].tableName → 跟随新 enCode 避免重名 + * - 然后 POST /visualdev/Base + * + * 顺序 (web 端是「先建表 → 再设计表单」, 我们 CLI 一气呵成): + * 1. read JSON + * 2. rewrite table names (避免目标库重名) + * 3. (autoTable) POST /system/DataModel/{dbLinkId}/Table × N + * 4. POST /visualdev/Base + * 5. (release) POST /visualdev/Base/{id}/Actions/Release (v0.7 修, 老 PUT /Actions/State 是错的) + */ +import { readFileSync } from 'node:fs' +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log } from '../../core/log.ts' + +interface ImportOpts { + enCode?: string + fullName?: string + dbLinkId?: string + table?: string + release?: boolean + autoTable?: boolean + json?: boolean +} + +interface PhysicalSchemaEntry { + table: string + tableName?: string + typeId?: string + fields: Record[] +} + +interface ImportPayload { + id?: string + creatorTime?: unknown + creatorUserId?: unknown + systemId?: unknown + state?: number + enCode?: string + fullName?: string + dbLinkId?: string + type?: number + webType?: string | number + tables?: string + formData?: string + columnData?: string + appColumnData?: string + _physicalSchema?: PhysicalSchemaEntry[] + [k: string]: unknown +} + +export function buildFormImportCommand(): Command { + const cmd = new Command('import') + .description('从 JSON 导入表单 (v0.7 默认 --autoTable 重建物理表, 解 #15)') + .argument('', '表单 JSON 路径') + .option('--enCode ', '新 enCode (默认原值 + _clone)') + .option('--fullName ', '新 fullName (默认原值)') + .option('--dbLinkId ', '新业务库 id (默认 token.dbLinkId, 跨应用迁移强烈推荐传)') + .option('--table ', '新主表名 (默认 enCode 小写, 避免目标库重名)') + .option('--release', '导入后立刻发布', false) + .option('--autoTable', '导入前重建物理表 (默认 true, --no-autoTable 跳过)', true) + .option('--no-autoTable', '不重建物理表 (老 export 没 _physicalSchema 时)') + .action(async (file: string, opts: ImportOpts) => { + const c = await JnpfClient.fromToken() + const raw = JSON.parse(readFileSync(file, 'utf-8')) as ImportPayload + + // 清掉冲突字段 + delete raw.id + delete raw.creatorTime + delete raw.creatorUserId + delete raw.systemId + raw.state = 0 + + const newEnCode = opts.enCode || `${raw.enCode || 'unknown'}_clone` + raw.enCode = newEnCode + if (opts.fullName) raw.fullName = opts.fullName + const targetDbLinkId = opts.dbLinkId || c.dbLinkId || (raw.dbLinkId as string) || '0' + raw.dbLinkId = targetDbLinkId + + // ---- v0.7: tables 重命名 (旧表名 → 新表名, 避免跨应用重名) ---- + // 主表新名: --table 给, 或默认 enCode 小写 + const newMainTable = (opts.table || newEnCode).toLowerCase() + let tableRenameMap: Record = {} + let parsedTables: Array> = [] + if (raw.tables) { + try { + parsedTables = JSON.parse(raw.tables) as Array> + } catch { + log.warn('tables JSON 解析失败, 跳过重命名') + } + // 找主表 (typeId=1), 第一个改成 newMainTable; 子表保留旧名 (但若 _physicalSchema 在, 也会建) + const mainIdx = parsedTables.findIndex((t) => String(t.typeId) === '1') + const effectiveMainIdx = mainIdx >= 0 ? mainIdx : 0 + for (let i = 0; i < parsedTables.length; i++) { + const oldName = String(parsedTables[i].table || '') + const newName = i === effectiveMainIdx ? newMainTable : `${oldName}_${newEnCode}`.toLowerCase() + if (oldName && oldName !== newName) { + tableRenameMap[oldName] = newName + parsedTables[i].table = newName + // 子表的 relationTable 也跟着改 + if (parsedTables[i].relationTable === oldName) parsedTables[i].relationTable = newName + } + } + // 反查: 其他表的 relationTable 也要改 (子表关联主表) + for (const t of parsedTables) { + const rt = String(t.relationTable || '') + if (rt && tableRenameMap[rt]) t.relationTable = tableRenameMap[rt] + } + raw.tables = JSON.stringify(parsedTables) + } + + // 同步改 formData[].tableName (字段引用的旧表名) + if (raw.formData && Object.keys(tableRenameMap).length) { + try { + let fdRaw = raw.formData + for (const [oldT, newT] of Object.entries(tableRenameMap)) { + // 简单字符串替换 (tableName 是 JSON string 字段, 不会跟其他东西混) + fdRaw = fdRaw.split(`"tableName":"${oldT}"`).join(`"tableName":"${newT}"`) + } + raw.formData = fdRaw + } catch (e) { + log.warn(`formData tableName 替换失败: ${(e as Error).message}`) + } + } + + // ---- v0.7: autoTable — 在目标 dbLinkId 重建物理表 ---- + // 数据源优先级: _physicalSchema (export v0.7+ 拉的 DB schema) > tables[].fields[] (老 form 内嵌) + const wantsAutoTable = opts.autoTable !== false + type TableSchema = { table: string; tableName?: string; typeId?: string; fields: Record[] } + const collectedTables: TableSchema[] = [] + if (wantsAutoTable) { + if (raw._physicalSchema && raw._physicalSchema.length) { + // 主路径: v0.7 export 拉的 + for (const p of raw._physicalSchema) collectedTables.push({ ...p }) + } else if (parsedTables.length) { + // 兼容: 老 form 的 tables[].fields[] 内嵌字段 + for (const t of parsedTables) { + const fields = Array.isArray(t.fields) ? (t.fields as Record[]) : [] + if (fields.length) { + collectedTables.push({ + // 关键: 找原表名 — tableRenameMap 已把 t.table 改成 newName, 反查 oldName + table: Object.keys(tableRenameMap).find((k) => tableRenameMap[k] === t.table) || String(t.table || ''), + tableName: t.tableName as string | undefined, + typeId: t.typeId as string | undefined, + fields, + }) + } + } + } + } + + if (wantsAutoTable && collectedTables.length) { + log.info(`autoTable: 在 dbLinkId=${targetDbLinkId} 重建 ${collectedTables.length} 张物理表`) + for (const entry of collectedTables) { + const oldName = entry.table + const newName = tableRenameMap[oldName] || oldName + // 字段补齐 + 重排序 (DataModel API 要求 tableFieldList 含 index 字符串) + const fields = (entry.fields || []).map((f, i) => ({ + field: f.field, + fieldName: f.fieldName || f.field, + dataType: f.dataType || 'varchar', + dataLength: f.dataLength != null ? String(f.dataLength) : '255', + primaryKey: f.primaryKey ?? 0, + allowNull: f.allowNull ?? 1, + autoIncrement: f.autoIncrement ?? 0, + identity: f.identity ?? 0, + index: String(i), + })) + // web/Java 真路径: { tableInfo: { table, tableName, newTable }, tableFieldList } + const body = { + tableInfo: { + table: newName, + tableName: entry.tableName || newName, + newTable: newName, + }, + tableFieldList: fields, + } + try { + const dmR = await c.postJson(`/system/DataModel/${targetDbLinkId}/Table`, body) + if (dmR.code === 200) { + log.ok(` ↳ 建表 ${newName} (字段 ×${fields.length})`) + } else { + const isExist = (dmR.msg || '').match(/exist|已存在/i) + if (isExist) log.warn(` ↳ ${newName} 已存在 (跳过)`) + else log.warn(` ↳ 建 ${newName} 失败 code=${dmR.code}: ${dmR.msg} (继续)`) + } + } catch (e) { + log.warn(` ↳ 建 ${newName} 异常: ${(e as Error).message} (继续)`) + } + } + } else if (wantsAutoTable && !collectedTables.length) { + log.warn('autoTable=true 但既无 _physicalSchema 也无 tables[].fields[], 跳过建表') + log.warn(' → 重新 dacli form export 拿带 _physicalSchema 的 v0.7+ 格式') + } + + // 清掉 _physicalSchema (后端不需要) + delete raw._physicalSchema + delete raw._exportedAt + + // ---- POST /visualdev/Base ---- + const r = await c.postJson(`/visualdev/Base`, raw) + if (r.code !== 200) { + log.error(`导入失败 code=${r.code}: ${r.msg}`) + process.exit(1) + } + // 反查 id (走 /visualdev/Base 全 form, 不走 /list 工作流子集) + const listR = await c.get<{ list: { id: string; enCode: string }[] }>('/visualdev/Base', { + keyword: newEnCode, + }) + const newId = listR.data?.list.find((f) => f.enCode === newEnCode)?.id || '(unknown)' + log.ok(`导入成功 id=${newId} enCode=${newEnCode} dbLinkId=${targetDbLinkId}`) + if (Object.keys(tableRenameMap).length) { + log.info(` ↳ 表名映射: ${JSON.stringify(tableRenameMap)}`) + } + + if (opts.release && raw.type !== 4 && newId !== '(unknown)') { + const rr = await c.postJson(`/visualdev/Base/${newId}/Actions/Release`, {}) + if (rr.code === 200) log.ok('发布成功') + else log.warn(`发布失败 code=${rr.code}: ${rr.msg}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '从 JSON 导入表单. v0.7 默认 --autoTable 在目标库重建物理表, 解 #15.', + required: { '': 'JSON 文件路径' }, + optional: { + '--enCode': '新 enCode (默认原 +_clone)', + '--fullName': '新中文名', + '--dbLinkId': '跨应用迁移强烈推荐传', + '--table': '新主表名 (默认 enCode 小写)', + '--release': '导入后立刻发布', + '--autoTable': '在目标库重建物理表 (默认 true)', + '--no-autoTable': '跳过重建 (老 export 无 _physicalSchema 时)', + }, + example: 'dacli form import /tmp/leave.json --enCode=leave_clone --dbLinkId=206... --release', + source: { + api: 'POST /api/visualdev/Base + POST /api/system/DataModel/{dbLinkId}/Table', + web: 'web Form.vue:444 handleRequest + dataModel/index.vue createDataModel', + }, + notes: [ + 'v0.7 默认重建物理表, 配合 form export 带的 _physicalSchema', + '旧 export 无 _physicalSchema 时, 加 --no-autoTable 跳过', + 'tables[].table + formData[].tableName 都会重写, 避免目标库重名', + ], + }) + + return cmd +} diff --git a/src/commands/form/index.ts b/src/commands/form/index.ts new file mode 100644 index 0000000..8b312dd --- /dev/null +++ b/src/commands/form/index.ts @@ -0,0 +1,27 @@ +/** + * commands/form/index.ts — `dacli form` 父命令 + 子命令注册 + */ +import { Command } from 'commander' +import { buildFormListCommand } from './list.ts' +import { buildFormInfoCommand } from './info.ts' +import { buildFormCreateCommand } from './create.ts' +import { buildFormReleaseCommand } from './release.ts' +import { buildFormDeleteCommand } from './delete.ts' +import { buildFormExportCommand } from './export.ts' +import { buildFormImportCommand } from './import.ts' +import { buildFormCloneCommand } from './clone.ts' +import { buildFormValidateCommand } from './validate.ts' + +export function buildFormCommand(): Command { + const cmd = new Command('form').description('表单 CRUD (list/info/create/release/delete/export/import/clone/validate)') + cmd.addCommand(buildFormListCommand()) + cmd.addCommand(buildFormInfoCommand()) + cmd.addCommand(buildFormCreateCommand()) + cmd.addCommand(buildFormReleaseCommand()) + cmd.addCommand(buildFormDeleteCommand()) + cmd.addCommand(buildFormExportCommand()) + cmd.addCommand(buildFormImportCommand()) + cmd.addCommand(buildFormCloneCommand()) + cmd.addCommand(buildFormValidateCommand()) + return cmd +} diff --git a/src/commands/form/info.ts b/src/commands/form/info.ts new file mode 100644 index 0000000..1f729f3 --- /dev/null +++ b/src/commands/form/info.ts @@ -0,0 +1,41 @@ +/** + * commands/form/info.ts — 拉表单完整 schema + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { printJson, log } from '../../core/log.ts' +import type { FormDetail } from '../../core/types.ts' + +export function buildFormInfoCommand(): Command { + const cmd = new Command('info') + .description('拉表单完整 schema (含 formData/columnData/tables)') + .argument('', '表单 id') + .option('--summary', '只打概要 (id/enCode/state/type/webType/dbLinkId/字段数)', false) + .action(async (id: string, opts: { summary?: boolean }) => { + const c = await JnpfClient.fromToken() + const r = await c.get(`/visualdev/Base/${id}`) + const data = c.ok(r) + if (opts.summary) { + const tables = (Array.isArray(data.tables) ? data.tables : []) as Array<{ table?: string }> + log.ok(`${data.fullName} (${data.enCode})`) + log.dim(`id : ${data.id}`) + log.dim(`state : ${data.state} type: ${data.type} webType: ${data.webType}`) + log.dim(`dbLinkId : ${data.dbLinkId || '(none)'}`) + log.dim(`category : ${data.category || '(none)'}`) + log.dim(`tables : ${tables.length} (${tables.map((t) => t.table).join(', ')})`) + return + } + printJson(data) + }) + + installAiHelpHook(cmd, { + purpose: '拉表单完整 schema. clone 前先 info 看结构', + required: { '': '表单 id' }, + optional: { '--summary': '只打概要' }, + example: ['dacli form info 123456 --summary', 'dacli form info 123456 > /tmp/x.json'], + source: { api: 'GET /api/visualdev/Base/:id' }, + }) + + return cmd +} diff --git a/src/commands/form/list.ts b/src/commands/form/list.ts new file mode 100644 index 0000000..19bb62e --- /dev/null +++ b/src/commands/form/list.ts @@ -0,0 +1,68 @@ +/** + * commands/form/list.ts — 列出当前应用的所有表单 (state/enCode/fullName) + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' +import type { FormSummary } from '../../core/types.ts' + +interface ListResp { + list: FormSummary[] + pagination?: { total: number; currentPage: number; pageSize: number } +} + +export function buildFormListCommand(): Command { + const cmd = new Command('list') + .description('列出当前应用所有表单 (state=0 草稿, state=1 已发布)') + .option('--keyword ', '关键字 (匹配 fullName/enCode)') + .option('--state ', '过滤 state (0|1)', (v) => parseInt(v, 10)) + .option('--limit ', '最多取 N 条 (默认 100)', (v) => parseInt(v, 10), 100) + .option('--json', '原始 JSON', false) + .action(async (opts: { keyword?: string; state?: number; limit: number; json?: boolean }) => { + const c = await JnpfClient.fromToken() + // GET /api/visualdev/Base — 公开方法 (返当前 systemId 下全部 form, + // 含 enableFlow=0/1/null). + // 注: GET /api/visualdev/Base/list 是工作流子集 (后端强制 setEnableFlow(1)), + // 会漏非工作流 form — 历史误用导致 v0.5 报"72/72"实际只覆盖 enableFlow=1 部分. + // 修复见 jnpf VisualdevController#list (line 133) vs #getList (line 179). + const r = await c.get('/visualdev/Base', { + keyword: opts.keyword, + currentPage: 1, + pageSize: opts.limit, + }) + const data = c.ok(r) + let list = data.list || [] + if (opts.state !== undefined) list = list.filter((f) => f.state === opts.state) + // state filter 在 list 接口上不可靠 (字段缺), 用 form info 兜底? 这里仅过 list 自带字段 + if (opts.json) { + printJson({ total: list.length, list }) + return + } + log.ok(`共 ${list.length} 张 (app=${c.appCode})`) + console.log('ID'.padEnd(20), 'TYPE', 'FLOW', 'enCode'.padEnd(32), 'fullName') + for (const f of list) { + console.log( + String(f.id).padEnd(20), + String(f.type ?? '-').padEnd(4), + String((f as unknown as { enableFlow?: number }).enableFlow ?? '-').padEnd(4), + (f.enCode || '').padEnd(32), + f.fullName, + ) + } + }) + + installAiHelpHook(cmd, { + purpose: '列出当前应用的所有表单. AI 干活前先跑一下看有什么已有表单, 优先 clone', + optional: { + '--keyword': '过滤 (服务器侧)', + '--state': '过滤 state (0=草稿 1=已发布)', + '--limit': '最多 N 条', + '--json': '原始 JSON', + }, + example: ['dacli form list', 'dacli form list --json | jq \'.list[] | select(.enCode=="leaveApply") | .id\''], + source: { api: 'GET /api/visualdev/Base (全 form, 含 enableFlow=0/1/null)' }, + }) + + return cmd +} diff --git a/src/commands/form/release.ts b/src/commands/form/release.ts new file mode 100644 index 0000000..623a62d --- /dev/null +++ b/src/commands/form/release.ts @@ -0,0 +1,38 @@ +/** + * commands/form/release.ts — 发布表单 (state 0 → 1) + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log } from '../../core/log.ts' + +export function buildFormReleaseCommand(): Command { + const cmd = new Command('release') + .description('发布表单 (state 0→1). type=4 视图会 400 (软跳过 --soft)') + .argument('', '表单 id') + .option('--soft', '发布失败不退出 (用于 type=4)', false) + .action(async (id: string, opts: { soft?: boolean }) => { + const c = await JnpfClient.fromToken() + const r = await c.postJson(`/visualdev/Base/${id}/Actions/Release`, {}) + if (r.code === 200) { + log.ok(`发布成功 id=${id} (state=1)`) + return + } + if (opts.soft) { + log.warn(`发布失败 (软跳过) code=${r.code}: ${r.msg}`) + return + } + log.error(`发布失败 code=${r.code}: ${r.msg}`) + process.exit(1) + }) + + installAiHelpHook(cmd, { + purpose: '把表单从 state=0 切到 state=1, 前端列表才能看到', + required: { '': '表单 id' }, + optional: { '--soft': 'type=4 时软跳过' }, + example: 'dacli form release 1234567890', + source: { api: 'POST /api/visualdev/Base/:id/Actions/Release' }, + }) + + return cmd +} diff --git a/src/commands/form/validate.ts b/src/commands/form/validate.ts new file mode 100644 index 0000000..fd92c6b --- /dev/null +++ b/src/commands/form/validate.ts @@ -0,0 +1,94 @@ +/** + * commands/form/validate.ts — 校验表单结构 (columnData __config__ 完整性) + * + * 镜像 Java 版 `dacli form validate ` 能力 + * 主要检查: + * - formData.fields 每项有 __config__ + * - columnData.fields 每项有 __config__ (新版 JNPF 缺会白屏) + * - tables 有 dbLinkId + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' +import type { FormDetail } from '../../core/types.ts' + +interface ValidationIssue { + level: 'ERROR' | 'WARN' + path: string + message: string +} + +function safeParse(s: unknown): unknown { + if (typeof s !== 'string') return s + try { + return JSON.parse(s) + } catch { + return null + } +} + +function validate(form: FormDetail): ValidationIssue[] { + const issues: ValidationIssue[] = [] + const formData = safeParse(form.formData) as { fields?: unknown[] } | null + const columnData = safeParse(form.columnData) as { fields?: unknown[] } | null + + if (!formData) issues.push({ level: 'ERROR', path: 'formData', message: 'formData 解析失败或为空' }) + else if (!Array.isArray(formData.fields)) issues.push({ level: 'WARN', path: 'formData.fields', message: 'fields 不是数组' }) + + if (columnData?.fields) { + columnData.fields.forEach((f, i) => { + const ff = f as { __config__?: unknown; __vModel__?: string } + if (!ff.__config__) { + issues.push({ + level: 'ERROR', + path: `columnData.fields[${i}] (${ff.__vModel__ || '?'})`, + message: '缺 __config__ → 浏览器列表会白屏', + }) + } + }) + } + + if (Array.isArray(form.tables) && form.tables.length > 0 && form.type !== 4 && !form.dbLinkId) { + issues.push({ level: 'ERROR', path: 'dbLinkId', message: 'type≠4 必须有 dbLinkId' }) + } + + return issues +} + +export function buildFormValidateCommand(): Command { + const cmd = new Command('validate') + .description('校验表单结构 (columnData __config__ 完整性等)') + .argument('', '表单 id') + .option('--json', '原始 JSON', false) + .action(async (id: string, opts: { json?: boolean }) => { + const c = await JnpfClient.fromToken() + const r = await c.get(`/visualdev/Base/${id}`) + const form = c.ok(r) + const issues = validate(form) + if (opts.json) { + printJson({ id, enCode: form.enCode, issues, pass: issues.filter((i) => i.level === 'ERROR').length === 0 }) + return + } + if (issues.length === 0) { + log.ok(`PASS ${form.enCode} (${id})`) + return + } + log.warn(`${form.enCode} 发现 ${issues.length} 个问题`) + for (const i of issues) { + const fn = i.level === 'ERROR' ? log.error : log.warn + fn(`[${i.level}] ${i.path}: ${i.message}`) + } + const failed = issues.filter((i) => i.level === 'ERROR').length > 0 + if (failed) process.exit(2) + }) + + installAiHelpHook(cmd, { + purpose: '校验表单结构. columnData 缺 __config__ 会浏览器白屏', + required: { '': '表单 id' }, + example: 'dacli form validate 12345', + notes: ['ERROR → 退出码 2', 'Java 版有 --fix 自动修复, TS 版 W2+ 实现'], + }) + + return cmd +} diff --git a/src/commands/login.ts b/src/commands/login.ts new file mode 100644 index 0000000..da03b08 --- /dev/null +++ b/src/commands/login.ts @@ -0,0 +1,50 @@ +/** + * commands/login.ts + */ +import { Command } from 'commander' +import { JnpfClient } from '../core/client.ts' +import { DEFAULT_ACCOUNT, DEFAULT_APP_CODE, DEFAULT_PASSWORD, getTokenPath } from '../core/config.ts' +import { installAiHelpHook } from '../core/help.ts' +import { log } from '../core/log.ts' + +export function buildLoginCommand(): Command { + const cmd = new Command('login') + .description('登录 JNPF (默认 admin/123456@developSystem), 持久化 token 到 .dacli-token/token.json') + .option('--account ', '账号', DEFAULT_ACCOUNT) + .option('--password

', '密码 (明文; 96 字符 hex 视为已加密)', DEFAULT_PASSWORD) + .option('--appCode ', '应用代码 (developSystem | workSystem | tds)', DEFAULT_APP_CODE) + .option('--baseUrl ', 'JNPF API 根地址 (含 /api)') + .action(async (opts: { account: string; password: string; appCode: string; baseUrl?: string }) => { + const c = await JnpfClient.login({ + account: opts.account, + password: opts.password, + appCode: opts.appCode, + baseUrl: opts.baseUrl, + forceLogin: true, + }) + log.ok(`登录成功: ${c.account} @ ${c.appCode}`) + log.dim(`baseUrl : ${c.baseUrl}`) + log.dim(`token : ${c.token.slice(0, 32)}... (${c.token.length} chars)`) + if (c.dbLinkId) log.dim(`dbLinkId : ${c.dbLinkId}`) + log.dim(`saved to : ${getTokenPath()}`) + }) + + installAiHelpHook(cmd, { + purpose: '登录 JNPF, 把 token 写到 .dacli-token/token.json, 后续命令自动复用', + optional: { + '--account': '账号 (默认 admin)', + '--password': '密码 (默认 123456; 已是 96 字符 hex 时跳过加密)', + '--appCode': '应用代码 (默认 developSystem)', + '--baseUrl': '强制指定 baseUrl, 否则按 [env JNPF_BASE_URL → http://nginx/api → http://127.0.0.1:30000/api] 依次尝试', + }, + example: 'dacli login --appCode=tds', + source: { web: 'web/.../auth.ts:27 loginApi', api: 'POST /api/oauth/Login' }, + notes: [ + 'token 7 天有效', + '已加密的 96 字符 hex 不会重复加密', + 'detectDbLinkId 自动从 /system/DataSource 拉业务库 id', + ], + }) + + return cmd +} diff --git a/src/commands/menu/create.ts b/src/commands/menu/create.ts new file mode 100644 index 0000000..f4fbdb4 --- /dev/null +++ b/src/commands/menu/create.ts @@ -0,0 +1,172 @@ +/** + * commands/menu/create.ts — 创建菜单 + * + * v0.6 重写: 优先用 web 真路径 (POST /api/visualdev/Base/{formId}/Actions/Module). + * - 体现 prompt §2.1 "复用 web 源码" 初心 + * - 后端自动构造 moduleId/propertyJson/urlAddress/pageAddress 等所有字段 + * - 移植自 web/views/onlineDev/formDesign/components/CreateMenuModal.vue handleSubmit (line ~120) + * + * 两种模式: + * A) 挂表单菜单 (--formId 给) — 走 web Actions/Module 高级 API + * B) 普通菜单 (目录/外链) — 走 POST /api/system/Menu 低级 API + * + * Actions/Module body (来自 CreateMenuModal.vue:99-119): + * { + * pc: 1, // 桌面端发布 + * app: 0, // 移动端不发布 (默认) + * pcModuleParentId: ["0"], // 顶级 (数组, 可挂多个父) + * appModuleParentId: [], + * platformRelease: '{"pc":1,"app":0}' + * } + * + * 关键: 顶级父 menuId 用 "0" (web 端通过 getMenuSelectorFilter 拿默认根). + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { + fullName: string + enCode?: string + formId?: string + parentId?: string + pcParents?: string + appParents?: string + pc?: boolean + app?: boolean + type?: string + urlAddress?: string + icon?: string + json?: boolean +} + +export function buildMenuCreateCommand(): Command { + const cmd = new Command('create') + .description('创建菜单. --formId 给则走 web 真路径 Actions/Module, 否则走低级 POST /system/Menu') + .requiredOption('--fullName ', '菜单中文名') + .option('--enCode ', '菜单英文编码 (默认=fullName)') + .option('--formId ', '关联 form id (挂表单菜单时给 → 走 Actions/Module)') + .option('--pcParents ', '挂表单时桌面端父菜单 id 列表 (逗号分隔, 默认 "0" 顶级)') + .option('--appParents ', '挂表单时移动端父菜单 id 列表 (逗号分隔, 默认空 = 不发布)') + .option('--no-pc', '挂表单时不发布桌面端 (默认 true)') + .option('--app', '挂表单时发布移动端 (默认 false)', false) + .option('--parentId

', '低级模式: 父菜单 id', '-1') + .option('--type ', '低级模式 type: 1=目录 2=Vue扩展 3=VisualDev 7=外链', '1') + .option('--urlAddress ', '低级模式: URL') + .option('--icon ', '低级模式: 图标') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + + // 模式 A: 挂表单菜单 — 走 web 真路径 + if (opts.formId) { + const pcParents = (opts.pcParents ?? '0').split(',').filter(Boolean) + const appParents = opts.appParents ? opts.appParents.split(',').filter(Boolean) : [] + const pc = opts.pc === false ? 0 : 1 + const app = opts.app ? 1 : 0 + if (!pc && !app) { + log.error('至少一个发布平台 (pc / app), 当前都是 0') + process.exit(2) + } + const body = { + pc, + app, + pcModuleParentId: pcParents, + appModuleParentId: appParents, + platformRelease: JSON.stringify({ pc, app }), + } + log.info(`POST /visualdev/Base/${opts.formId}/Actions/Module (web 真路径)`) + const r = await c.postJson(`/visualdev/Base/${opts.formId}/Actions/Module`, body) + if (r.code !== 200) { + log.error(`menu create (Actions/Module) 失败 code=${r.code}: ${r.msg}`) + if (opts.json) printJson(r) + process.exit(1) + } + log.ok(`✓ 菜单发布成功 (formId=${opts.formId}, pc=${pc}, app=${app})`) + log.ok(' ↳ 后端已自动构造 moduleId/propertyJson/urlAddress/pageAddress + 给当前角色授权') + if (opts.json) printJson(r) + return + } + + // 模式 B: 低级 POST /system/Menu (目录/外链等) + const enCode = opts.enCode || opts.fullName + const type = parseInt(opts.type || '1', 10) + const icon = opts.icon ?? (type === 1 ? 'icon-ym icon-ym-folder' : '') + const body: Record = { + fullName: opts.fullName, + enCode, + parentId: opts.parentId || '-1', + type, + enabledMark: 1, + sortCode: 0, + category: 'Web', + linkTarget: '_self', + isButtonAuthorize: 1, + isColumnAuthorize: 1, + isDataAuthorize: 1, + isFormAuthorize: 1, + icon, + propertyJson: '{"moduleId":"","iconBackgroundColor":"","isTree":0}', + } + if (type === 7 && !opts.urlAddress) { + log.error('type=7 (外链) 必须传 --urlAddress') + process.exit(2) + } + if (opts.urlAddress) { + body.urlAddress = opts.urlAddress + body.pageAddress = opts.urlAddress + } + log.info(`POST /system/Menu ${enCode} (type=${type})`) + const r = await c.postJson<{ id?: string }>('/system/Menu', body) + if (r.code !== 200) { + log.error(`menu create 失败 code=${r.code}: ${r.msg}`) + process.exit(1) + } + let menuId: string | undefined = r.data?.id + if (!menuId) { + const listR = await c.get<{ list?: { id: string; enCode: string }[] }>('/system/Menu', { + currentPage: 1, + pageSize: 50, + parentId: body.parentId as string, + keyword: enCode, + }) + menuId = listR.data?.list?.find((m) => m.enCode === enCode)?.id + } + log.ok(`✓ 创建: id=${menuId || '(unknown)'} enCode=${enCode}`) + if (opts.json) printJson({ id: menuId, enCode, ...body }) + }) + + installAiHelpHook(cmd, { + purpose: '创建菜单. 挂表单菜单 (--formId) 走 web 真路径 Actions/Module, 后端自动处理所有字段', + required: { '--fullName': '中文名' }, + optional: { + '--formId': '关联 form id (走 web Actions/Module 高级 API)', + '--pcParents': '桌面端父菜单 ids (逗号分隔, 默认 "0" 顶级)', + '--no-pc': '不发布桌面端', + '--app': '同时发布移动端', + '--enCode': '英文编码 (低级模式用)', + '--type': '低级模式 type', + '--parentId': '低级模式父 id', + '--urlAddress': '低级模式 URL', + }, + example: [ + '# 挂表单菜单 (推荐 web 真路径)', + 'dacli menu create --fullName="员工培训" --formId=835141398800901061', + '# 挂在指定父菜单', + 'dacli menu create --fullName="员工培训" --formId=xxx --pcParents=父menuId1,父menuId2', + '# 顶级目录', + 'dacli menu create --fullName="人事管理" --enCode=hr --type=1', + ], + source: { + api: 'POST /api/visualdev/Base/{formId}/Actions/Module (挂表单) / POST /api/system/Menu (普通)', + ref: 'web/views/onlineDev/formDesign/components/CreateMenuModal.vue', + }, + notes: [ + '挂表单菜单优先 --formId, 后端自动给当前用户角色授权 + 构造 moduleId/propertyJson', + 'web 端 getReleaseMenu 可查是否已发布', + '前端 storage 缓存可能 1-2s 延迟才看到新菜单, 重登/F5 兜底', + ], + }) + return cmd +} diff --git a/src/commands/menu/delete.ts b/src/commands/menu/delete.ts new file mode 100644 index 0000000..7a73587 --- /dev/null +++ b/src/commands/menu/delete.ts @@ -0,0 +1,33 @@ +/** + * commands/menu/delete.ts — 删除菜单 + * + * API: DELETE /api/system/Menu/{id} + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log } from '../../core/log.ts' + +interface Opts { id: string; yes?: boolean } + +export function buildMenuDeleteCommand(): Command { + const cmd = new Command('delete') + .description('删除菜单 (按 id)') + .requiredOption('--id ', '菜单 id') + .option('--yes', '跳过确认', false) + .action(async (opts: Opts) => { + if (!opts.yes) { log.warn('传 --yes 确认删除'); process.exit(2) } + const c = await JnpfClient.fromToken() + const r = await c.del(`/system/Menu/${opts.id}`) + if (r.code !== 200) { log.error(`menu delete 失败: ${r.msg}`); process.exit(1) } + log.ok(`已删除: ${opts.id}`) + }) + + installAiHelpHook(cmd, { + purpose: '删除菜单.', + required: { '--id': '菜单 id', '--yes': '确认' }, + example: 'dacli menu delete --id=123 --yes', + source: { api: 'DELETE /api/system/Menu/{id}' }, + }) + return cmd +} diff --git a/src/commands/menu/index.ts b/src/commands/menu/index.ts new file mode 100644 index 0000000..cd74a11 --- /dev/null +++ b/src/commands/menu/index.ts @@ -0,0 +1,17 @@ +/** + * commands/menu/index.ts — menu 父命令 + */ +import { Command } from 'commander' +import { buildMenuListCommand } from './list.ts' +import { buildMenuCreateCommand } from './create.ts' +import { buildMenuDeleteCommand } from './delete.ts' +import { buildMenuUnreleaseCommand } from './unrelease.ts' + +export function buildMenuCommand(): Command { + const cmd = new Command('menu').description('菜单管理 (按 app)') + cmd.addCommand(buildMenuListCommand()) + cmd.addCommand(buildMenuCreateCommand()) + cmd.addCommand(buildMenuDeleteCommand()) + cmd.addCommand(buildMenuUnreleaseCommand()) + return cmd +} diff --git a/src/commands/menu/list.ts b/src/commands/menu/list.ts new file mode 100644 index 0000000..1ce5563 --- /dev/null +++ b/src/commands/menu/list.ts @@ -0,0 +1,46 @@ +/** + * commands/menu/list.ts — 菜单列表 (按 system) + * + * API: GET /api/system/Menu/ModuleBySystem 或 /api/system/Menu?keyword= + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { json?: boolean; keyword?: string; flat?: boolean } + +export function buildMenuListCommand(): Command { + const cmd = new Command('list') + .description('菜单列表 (按当前 app system 过滤)') + .option('--keyword ', '按名称搜索') + .option('--flat', '不按树形打印, 直接平铺', false) + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + // /ModuleBySystem 自动按请求头 App-Code 过滤 + const r = await c.get('/system/Menu/ModuleBySystem', { keyword: opts.keyword }) + if (r.code !== 200) { log.error(`menu list 失败: ${r.msg}`); process.exit(1) } + if (opts.json) { printJson(r.data); return } + const list = (Array.isArray(r.data) ? r.data : (r.data as { list?: unknown[] })?.list) || [] + log.info(`当前 app 共 ${list.length} 个菜单项`) + console.log('ID FULL_NAME ENCODE URL') + console.log('-'.repeat(100)) + for (const m of list as Record[]) { + const id = String(m.id || '').padEnd(36) + const name = String(m.fullName || '').padEnd(22) + const enc = String(m.enCode || '').padEnd(20) + console.log(`${id}${name}${enc}${m.urlAddress || ''}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '列出当前 app 的菜单树 (按请求头 App-Code 过滤).', + required: {}, + optional: { '--keyword': '搜索关键字', '--flat': '平铺打印' }, + example: 'dacli menu list', + source: { api: 'GET /api/system/Menu/ModuleBySystem' }, + notes: ['先 dacli switch-app --appCode=X 切到目标应用, 才能看到对应菜单'], + }) + return cmd +} diff --git a/src/commands/menu/unrelease.ts b/src/commands/menu/unrelease.ts new file mode 100644 index 0000000..94135d5 --- /dev/null +++ b/src/commands/menu/unrelease.ts @@ -0,0 +1,51 @@ +/** + * commands/menu/unrelease.ts — 取消表单菜单发布 (web 真路径) + * + * web 真行为 (CreateMenuModal.vue handleSubmit, pc=0 + app=0 仍可发): + * POST /api/visualdev/Base/{formId}/Actions/Module + * body: {pc:0, app:0, pcModuleParentId:[], appModuleParentId:[], platformRelease:'{"pc":0,"app":0}'} + * 返 200 "Synchronization successful" — 删除已挂菜单 (前端 UI 有"至少一个平台"校验, 后端无) + * + * 用途: DELETE /api/system/Menu/{id} 报 "System abnormality" 时的兜底. + * 只对 type=3 (VisualDev) + 已 pcIsRelease=1 的菜单有效, 普通目录/外链请直接用 menu delete. + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log } from '../../core/log.ts' + +interface Opts { formId: string } + +export function buildMenuUnreleaseCommand(): Command { + const cmd = new Command('unrelease') + .description('取消表单菜单发布 (form-driven, 走 web Actions/Module 真路径)') + .requiredOption('--formId ', '表单 id') + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + const body = { + pc: 0, + app: 0, + pcModuleParentId: [] as string[], + appModuleParentId: [] as string[], + platformRelease: JSON.stringify({ pc: 0, app: 0 }), + } + log.info(`POST /visualdev/Base/${opts.formId}/Actions/Module pc=0 app=0`) + const r = await c.postJson(`/visualdev/Base/${opts.formId}/Actions/Module`, body) + if (r.code !== 200) { + log.error(`unrelease 失败 code=${r.code}: ${r.msg}`) + process.exit(1) + } + log.ok(`✓ 已取消挂菜单 (formId=${opts.formId})`) + }) + installAiHelpHook(cmd, { + purpose: '取消 form 的菜单发布. 用于 dacli menu delete 失败时兜底 (DELETE /api/system/Menu/X 报 System abnormality).', + required: { '--formId': '表单 id' }, + example: 'dacli menu unrelease --formId=835141398800901061', + source: { + api: 'POST /api/visualdev/Base/{formId}/Actions/Module', + ref: 'web/views/onlineDev/formDesign/components/CreateMenuModal.vue (前端有 pc/app 至少一个校验, 后端无)', + }, + notes: ['仅适用于 type=3 VisualDev 菜单', '普通目录/外链请用 menu delete'], + }) + return cmd +} diff --git a/src/commands/status.ts b/src/commands/status.ts new file mode 100644 index 0000000..f2fc25a --- /dev/null +++ b/src/commands/status.ts @@ -0,0 +1,49 @@ +/** + * commands/status.ts + */ +import { Command } from 'commander' +import { loadToken, getTokenPath, currentBaseUrl } from '../core/config.ts' +import { installAiHelpHook } from '../core/help.ts' +import { log } from '../core/log.ts' + +export function buildStatusCommand(): Command { + const cmd = new Command('status') + .description('显示当前登录状态 + baseUrl + appCode + dbLinkId + token 路径') + .option('--json', '以 JSON 输出 (便于脚本)', false) + .action((opts: { json?: boolean }) => { + const t = loadToken() + if (opts.json) { + console.log(JSON.stringify({ + tokenPath: getTokenPath(), + baseUrl: t?.baseUrl || currentBaseUrl(), + loggedIn: !!t, + account: t?.account, + appCode: t?.appCode, + dbLinkId: t?.dbLinkId, + loginAt: t?.loginAt, + tokenLen: t?.token.length, + }, null, 2)) + return + } + if (!t) { + log.warn('未登录. 先跑: dacli login') + log.dim(`baseUrl: ${currentBaseUrl()}`) + log.dim(`token path: ${getTokenPath()}`) + return + } + log.ok(`已登录: ${t.account} @ ${t.appCode}`) + log.dim(`baseUrl : ${t.baseUrl}`) + log.dim(`dbLinkId : ${t.dbLinkId || '(unknown)'}`) + log.dim(`loginAt : ${t.loginAt}`) + log.dim(`token len : ${t.token.length}`) + log.dim(`token path: ${getTokenPath()}`) + }) + + installAiHelpHook(cmd, { + purpose: '显示当前登录状态. 写脚本前先跑一下确认登录态', + optional: { '--json': '以 JSON 输出' }, + example: 'dacli status', + }) + + return cmd +} diff --git a/src/commands/switch-app.ts b/src/commands/switch-app.ts new file mode 100644 index 0000000..9092926 --- /dev/null +++ b/src/commands/switch-app.ts @@ -0,0 +1,36 @@ +/** + * commands/switch-app.ts — 切换 appCode (登录新 app 并覆盖 token) + */ +import { Command } from 'commander' +import { JnpfClient } from '../core/client.ts' +import { DEFAULT_ACCOUNT, DEFAULT_PASSWORD, loadToken } from '../core/config.ts' +import { installAiHelpHook } from '../core/help.ts' +import { log } from '../core/log.ts' + +export function buildSwitchAppCommand(): Command { + const cmd = new Command('switch-app') + .description('切换当前应用 (重新登录新 appCode 并覆盖 token)') + .requiredOption('--appCode ', '目标应用代码') + .option('--account ', '账号') + .option('--password

', '密码') + .action(async (opts: { appCode: string; account?: string; password?: string }) => { + const cached = loadToken() + const c = await JnpfClient.login({ + account: opts.account || cached?.account || DEFAULT_ACCOUNT, + password: opts.password || DEFAULT_PASSWORD, + appCode: opts.appCode, + baseUrl: cached?.baseUrl, + forceLogin: true, + }) + log.ok(`切换成功: ${c.account} @ ${c.appCode}`) + log.dim(`dbLinkId : ${c.dbLinkId || '(unknown)'}`) + }) + + installAiHelpHook(cmd, { + purpose: '切换当前应用, 重新登录并覆盖本地 token. baseline 复刻常用', + required: { '--appCode': '目标应用 (developSystem | workSystem | tds)' }, + example: ['dacli switch-app --appCode=developSystem', 'dacli switch-app --appCode=tds'], + }) + + return cmd +} diff --git a/src/commands/workflow/approve.ts b/src/commands/workflow/approve.ts new file mode 100644 index 0000000..e20a219 --- /dev/null +++ b/src/commands/workflow/approve.ts @@ -0,0 +1,50 @@ +/** + * commands/workflow/approve.ts — 审批流程 + * + * API: POST /api/workflow/operator/Audit/{operatorId} + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { + operatorId: string + status: string + opinion?: string + json?: boolean +} + +export function buildWorkflowApproveCommand(): Command { + const cmd = new Command('approve') + .description('审批一个流程任务 (operatorId 来自 --todo=1 列表)') + .requiredOption('--operatorId ', '审批节点 id (operatorId)') + .requiredOption('--status <0|1|2>', '0=同意 1=不同意 2=退回', '0') + .option('--opinion ', '审批意见') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + const body = { + status: Number(opts.status), + opinion: opts.opinion || '', + } + log.info(`POST /workflow/operator/Audit/${opts.operatorId} status=${opts.status}`) + const r = await c.postJson(`/workflow/operator/Audit/${opts.operatorId}`, body) + if (r.code !== 200) { + log.error(`approve 失败: ${r.msg}`) + if (opts.json) printJson(r) + process.exit(1) + } + log.ok('审批成功') + if (opts.json) printJson(r.data) + }) + + installAiHelpHook(cmd, { + purpose: '审批流程节点. 0=同意 1=不同意 2=退回.', + required: { '--operatorId': '审批节点 id', '--status': '0/1/2' }, + optional: { '--opinion': '审批意见' }, + example: 'dacli workflow approve --operatorId=123 --status=0 --opinion=同意', + source: { api: 'POST /api/workflow/operator/Audit/{operatorId}' }, + }) + return cmd +} diff --git a/src/commands/workflow/index.ts b/src/commands/workflow/index.ts new file mode 100644 index 0000000..fc5d511 --- /dev/null +++ b/src/commands/workflow/index.ts @@ -0,0 +1,15 @@ +/** + * commands/workflow/index.ts — workflow 父命令 + */ +import { Command } from 'commander' +import { buildWorkflowListCommand } from './list.ts' +import { buildWorkflowLaunchCommand } from './launch.ts' +import { buildWorkflowApproveCommand } from './approve.ts' + +export function buildWorkflowCommand(): Command { + const cmd = new Command('workflow').description('流程引擎 (模板/发起/审批)') + cmd.addCommand(buildWorkflowListCommand()) + cmd.addCommand(buildWorkflowLaunchCommand()) + cmd.addCommand(buildWorkflowApproveCommand()) + return cmd +} diff --git a/src/commands/workflow/launch.ts b/src/commands/workflow/launch.ts new file mode 100644 index 0000000..3ebb6b5 --- /dev/null +++ b/src/commands/workflow/launch.ts @@ -0,0 +1,57 @@ +/** + * commands/workflow/launch.ts — 发起流程 + * + * API: POST /api/workflow/task + * + * Body: { flowId, formId, data, ... } + * + * 注意: 需绑工作流的 form (form.enableFlow=1) 才能发起 + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface Opts { + flowId: string + formId: string + data: string + json?: boolean +} + +export function buildWorkflowLaunchCommand(): Command { + const cmd = new Command('launch') + .description('发起流程 (绑定 formId + flowId, data 为表单数据 JSON)') + .requiredOption('--flowId ', '流程模板 id') + .requiredOption('--formId ', '绑定的表单 id') + .requiredOption('--data ', '表单数据 JSON 字符串 (formData 字段值)') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + const body = { + flowId: opts.flowId, + formId: opts.formId, + data: opts.data, + status: 0, + approverUserId: '', + } + log.info(`POST /workflow/task flowId=${opts.flowId} formId=${opts.formId}`) + const r = await c.postJson<{ id?: string; taskId?: string }>('/workflow/task', body) + if (r.code !== 200) { + log.error(`launch 失败 (code=${r.code}): ${r.msg}`) + if (opts.json) printJson(r) + process.exit(1) + } + log.ok(`发起成功: taskId=${r.data?.id || r.data?.taskId || '(unknown)'}`) + if (opts.json) printJson(r.data) + }) + + installAiHelpHook(cmd, { + purpose: '发起一个流程实例. 需 form.enableFlow=1.', + required: { '--flowId': '流程模板 id', '--formId': '绑定 form id', '--data': '表单数据 JSON' }, + example: `dacli workflow launch --flowId= --formId= --data='{"f_name":"张三"}'`, + source: { api: 'POST /api/workflow/task' }, + notes: ['发起前确认 form.enableFlow=1 + flowId 已绑'], + }) + return cmd +} diff --git a/src/commands/workflow/list.ts b/src/commands/workflow/list.ts new file mode 100644 index 0000000..1970f78 --- /dev/null +++ b/src/commands/workflow/list.ts @@ -0,0 +1,56 @@ +/** + * commands/workflow/list.ts — 流程模板/任务 列表 + * + * API: + * GET /api/workflow/template[?category=X] 模板 + * GET /api/workflow/operator/List/{type} 我的待办 (type=1 待审批, 2 已审批, 3 抄送) + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' + +interface ListOpts { + category?: string + todo?: string + pageSize?: string + json?: boolean +} + +export function buildWorkflowListCommand(): Command { + const cmd = new Command('list') + .description('流程模板 / 我的待办 列表') + .option('--category ', '模板分类') + .option('--todo ', '我的待办 (1=待审批 2=已审批 3=抄送), 启用此模式时 category 忽略', '0') + .option('--pageSize ', '每页', '50') + .option('--json', '原始 JSON 输出', false) + .action(async (opts: ListOpts) => { + const c = await JnpfClient.fromToken() + const todo = Number(opts.todo || '0') + const path = todo > 0 + ? `/workflow/operator/List/${todo}` + : `/workflow/template${opts.category ? `?category=${opts.category}` : ''}` + const r = await c.get<{ list?: { id: string; fullName: string; enCode?: string; category?: string }[] }>(path, { + currentPage: 1, + pageSize: opts.pageSize, + }) + if (r.code !== 200) { log.error(`workflow list 失败: ${r.msg}`); process.exit(1) } + const list = r.data?.list || [] + if (opts.json) { printJson(r.data); return } + log.info(`${path} 共 ${list.length} 条`) + console.log('ID FULL_NAME ENCODE CATEGORY') + console.log('-'.repeat(100)) + for (const t of list) { + console.log(`${String(t.id || '').padEnd(36)}${String(t.fullName || '').padEnd(22)}${String(t.enCode || '').padEnd(22)}${t.category || ''}`) + } + }) + + installAiHelpHook(cmd, { + purpose: '看流程模板 (--category) 或 我的待办 (--todo 1/2/3).', + required: {}, + optional: { '--category': '模板分类', '--todo': '1=待审批 2=已审批 3=抄送', '--pageSize': '每页' }, + example: ['dacli workflow list', 'dacli workflow list --todo=1'], + source: { api: 'GET /api/workflow/template 或 /api/workflow/operator/List/{type}' }, + }) + return cmd +} diff --git a/src/core/client.ts b/src/core/client.ts new file mode 100644 index 0000000..43d07fd --- /dev/null +++ b/src/core/client.ts @@ -0,0 +1,197 @@ +/** + * client.ts — JnpfClient + * + * 借鉴 ddcc/jnpf.ts (已验证), 加 token 自动加载 + baseUrl 兜底。 + * + * 关键: baseUrl 必须含 /api, path 不再带 /api 前缀。 + * 例: baseUrl='http://nginx/api' + path='/visualdev/Base/list' → 'http://nginx/api/visualdev/Base/list' + */ +import { encryptPassword, isEncrypted } from './crypto.ts' +import { loadToken, saveToken, baseUrlCandidates } from './config.ts' +import { DacliError } from './types.ts' +import type { JnpfResp, LoginResp, TokenFile } from './types.ts' +import { log } from './log.ts' + +export interface ClientOptions { + baseUrl?: string + appCode?: string + account?: string + password?: string + /** true=强制不读 token, 重新登录 */ + forceLogin?: boolean +} + +export class JnpfClient { + baseUrl: string + appCode: string + account: string + password: string + token = '' + /** 业务库 id, login 后自动拉 */ + dbLinkId?: string + + constructor(opt: ClientOptions = {}) { + this.baseUrl = (opt.baseUrl || '').replace(/\/+$/, '') + this.appCode = opt.appCode || '' + this.account = opt.account || '' + this.password = opt.password || '' + } + + /** 走 token 缓存, 没就登录 */ + static async fromToken(opt: ClientOptions = {}): Promise { + const cached = opt.forceLogin ? null : loadToken() + if (cached && !opt.forceLogin) { + const c = new JnpfClient({ + baseUrl: opt.baseUrl || cached.baseUrl, + appCode: opt.appCode || cached.appCode, + account: opt.account || cached.account, + password: opt.password || '', + }) + c.token = cached.token + c.dbLinkId = cached.dbLinkId + return c + } + // 没缓存或强制 → 完整 login + return JnpfClient.login(opt) + } + + /** 完整登录 (encrypt + POST /oauth/Login + 持久化) */ + static async login(opt: ClientOptions = {}): Promise { + const candidates = opt.baseUrl ? [opt.baseUrl] : baseUrlCandidates() + let lastErr: Error | null = null + for (const base of candidates) { + try { + const c = new JnpfClient({ ...opt, baseUrl: base }) + await c.doLogin() + await c.detectDbLinkId() + c.persist() + return c + } catch (e) { + lastErr = e as Error + log.debug(`login via ${base} failed: ${(e as Error).message}`) + } + } + throw lastErr || new DacliError('所有 baseUrl 候选都失败, 请确认 JNPF 是否启动') + } + + private async doLogin(): Promise { + const encrypted = isEncrypted(this.password) ? this.password : encryptPassword(this.password) + const body = new URLSearchParams({ + account: this.account, + password: encrypted, + code: '', + origin: 'hash', + timestamp: '0', + jnpf_ticket: '', + grant_type: 'password', + }).toString() + const url = `${this.baseUrl}/oauth/Login` + log.debug('POST', url) + const res = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, + body, + }) + const text = await res.text() + const r = parseJson(text) + if (r.code !== 200 || !r.data) { + throw new DacliError(`登录失败 (code ${r.code}): ${r.msg}`, r.code, text.slice(0, 200)) + } + this.token = r.data.token + } + + /** 拉业务库 id (非主库). 失败不致命, 仅 debug */ + private async detectDbLinkId(): Promise { + try { + const r = await this.get<{ list?: Array<{ id: string; fullName: string; enCode?: string }> }>('/system/DataSource') + const list = r.data?.list || [] + if (Array.isArray(list) && list.length > 0) { + // 优先匹 appCode 同名, 其次任何非平台库 + const byApp = list.find((d) => d.fullName === this.appCode || d.enCode === this.appCode) + const fallback = list.find((d) => d.id && d.id !== '0') + const biz = byApp || fallback + if (biz) this.dbLinkId = biz.id + } + } catch (e) { + log.debug('detectDbLinkId failed:', (e as Error).message) + } + } + + persist(): void { + const t: TokenFile = { + baseUrl: this.baseUrl, + appCode: this.appCode, + account: this.account, + token: this.token, + loginAt: new Date().toISOString(), + dbLinkId: this.dbLinkId, + } + saveToken(t) + } + + // ----- HTTP ----- + + async get(path: string, query?: Record): Promise> { + let url = `${this.baseUrl}${path}` + if (query) { + const cleaned: Record = {} + for (const [k, v] of Object.entries(query)) if (v !== undefined && v !== null) cleaned[k] = String(v) + const qs = new URLSearchParams(cleaned).toString() + if (qs) url += `?${qs}` + } + log.debug('GET', url) + const res = await fetch(url, { method: 'GET', headers: this.headers() }) + return parseJson(await res.text()) + } + + async postJson(path: string, body: unknown): Promise> { + log.debug('POST', this.baseUrl + path) + const res = await fetch(`${this.baseUrl}${path}`, { + method: 'POST', + headers: this.headers(), + body: JSON.stringify(body), + }) + return parseJson(await res.text()) + } + + async putJson(path: string, body: unknown): Promise> { + log.debug('PUT', this.baseUrl + path) + const res = await fetch(`${this.baseUrl}${path}`, { + method: 'PUT', + headers: this.headers(), + body: JSON.stringify(body), + }) + return parseJson(await res.text()) + } + + async del(path: string): Promise> { + log.debug('DELETE', this.baseUrl + path) + const res = await fetch(`${this.baseUrl}${path}`, { + method: 'DELETE', + headers: this.headers(), + }) + return parseJson(await res.text()) + } + + /** 业务码非 200 直接抛 */ + ok(r: JnpfResp): T { + if (r.code !== 200) throw new DacliError(`API code=${r.code}: ${r.msg}`, r.code, JSON.stringify(r)) + return r.data as T + } + + private headers(): Record { + return { + 'Content-Type': 'application/json', + Authorization: this.token, + 'App-Code': this.appCode, + } + } +} + +function parseJson(text: string): JnpfResp { + try { + return JSON.parse(text) as JnpfResp + } catch { + return { code: -1, msg: `JSON parse error: ${text.slice(0, 200)}`, data: null } + } +} diff --git a/src/core/config.ts b/src/core/config.ts new file mode 100644 index 0000000..875b2e5 --- /dev/null +++ b/src/core/config.ts @@ -0,0 +1,68 @@ +/** + * config.ts — token / baseUrl / appCode 持久化 + * + * 路径: $DACLI_TOKEN_DIR/token.json 或 ./.dacli-token/token.json + * + * 与 Java 版兼容: 路径写在 cwd 下 (CLAUDE.md "$ccWorkDir/.dacli-token/token.json") + * 但 TS 版只管 $ccWorkDir/dacli 自己, 不动 Java 版的 token (Java 版已废弃归档)。 + */ +import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'node:fs' +import { dirname, join, resolve } from 'node:path' +import type { TokenFile } from './types.ts' + +const DEFAULT_BASE_URL = process.env.JNPF_BASE_URL || 'http://nginx/api' + +function tokenDir(): string { + if (process.env.DACLI_TOKEN_DIR) return resolve(process.env.DACLI_TOKEN_DIR) + return resolve(process.cwd(), '.dacli-token') +} + +function tokenPath(): string { + return join(tokenDir(), 'token.json') +} + +export function getTokenPath(): string { + return tokenPath() +} + +export function loadToken(): TokenFile | null { + const p = tokenPath() + if (!existsSync(p)) return null + try { + return JSON.parse(readFileSync(p, 'utf-8')) as TokenFile + } catch { + return null + } +} + +export function saveToken(t: TokenFile): void { + const dir = tokenDir() + if (!existsSync(dir)) mkdirSync(dir, { recursive: true }) + writeFileSync(tokenPath(), JSON.stringify(t, null, 2), 'utf-8') +} + +export function clearToken(): void { + const p = tokenPath() + if (existsSync(p)) rmSync(p) +} + +/** 当前 baseUrl (优先 env, 然后 token, 然后默认) */ +export function currentBaseUrl(): string { + const t = loadToken() + return process.env.JNPF_BASE_URL || t?.baseUrl || DEFAULT_BASE_URL +} + +/** 默认凭据 (供 login 默认值用) */ +export const DEFAULT_ACCOUNT = process.env.JNPF_ACCOUNT || 'admin' +export const DEFAULT_PASSWORD = process.env.JNPF_PASSWORD || '123456' +export const DEFAULT_APP_CODE = process.env.JNPF_APP_CODE || 'developSystem' + +/** baseUrl 兜底列表 (按优先级) */ +export function baseUrlCandidates(): string[] { + const list = [ + process.env.JNPF_BASE_URL, + 'http://nginx/api', + 'http://127.0.0.1:30000/api', + ].filter(Boolean) as string[] + return Array.from(new Set(list)) +} diff --git a/src/core/crypto.ts b/src/core/crypto.ts new file mode 100644 index 0000000..3e5009c --- /dev/null +++ b/src/core/crypto.ts @@ -0,0 +1,78 @@ +/** + * crypto.ts — 严格 1:1 复刻 web cipher.ts (字节级一致) + * + * 流程: 明文 → md5(hex) → AES-ECB-Pkcs7(key=md5(VITE_CIPHER_KEY)) → Base64 → Hex + * + * 关键: cipher.ts:34-37 `Hex.stringify(Base64.parse(result))` 是对 Base64 字符串做 hex, + * 不是对密文字节做 hex。这是 ddcc 实验里踩过的最大坑。 + * + * 输入 '123456' 应输出 96 字符 hex (与 web 一致)。 + */ +import CryptoJS from 'crypto-js' +import { existsSync, readFileSync } from 'node:fs' +import { dirname, resolve } from 'node:path' +import { fileURLToPath } from 'node:url' + +/** 默认密钥来自 web .env VITE_CIPHER_KEY */ +const FALLBACK_KEY = 'EY8WePvjM5GGwQzn' + +let _cipherKey: string | null = null + +function loadCipherKey(): string { + if (_cipherKey) return _cipherKey + if (process.env.VITE_CIPHER_KEY) { + _cipherKey = process.env.VITE_CIPHER_KEY + return _cipherKey + } + try { + const here = dirname(fileURLToPath(import.meta.url)) + const candidates = [ + resolve(here, '../../../../web/apps/jnpf-web-apps-main/.env'), + resolve(here, '../../../web/apps/jnpf-web-apps-main/.env'), + resolve(here, '../../web/apps/jnpf-web-apps-main/.env'), + ] + for (const p of candidates) { + if (existsSync(p)) { + const m = readFileSync(p, 'utf-8').match(/VITE_CIPHER_KEY\s*=\s*(\S+)/) + if (m) { + _cipherKey = m[1] + return _cipherKey + } + } + } + } catch { + /* ignore — fallback */ + } + _cipherKey = FALLBACK_KEY + return _cipherKey +} + +export function encryptByMd5(plain: string): string { + return CryptoJS.MD5(plain).toString() +} + +/** AES-ECB-Pkcs7(密钥=md5(CIPHER_KEY)),再 Base64→Hex */ +function aesEcbHex(inputHex: string): string { + const aesKey = encryptByMd5(loadCipherKey()) + const encrypted = CryptoJS.AES.encrypt( + inputHex, + CryptoJS.enc.Utf8.parse(aesKey), + { mode: CryptoJS.mode.ECB, padding: CryptoJS.pad.Pkcs7 }, + ) + const base64 = encrypted.toString() + // 注意: 是对 base64 字符串做 hex (web cipher.ts:36) + return CryptoJS.enc.Hex.stringify(CryptoJS.enc.Base64.parse(base64)) +} + +/** + * 完整登录加密 (与 LoginForm.handleLogin 一致): + * md5(plain) → aesEncryption.encryptByAES(md5Hex) + */ +export function encryptPassword(plain: string): string { + return aesEcbHex(encryptByMd5(plain)) +} + +/** 96 字符的 hex 即认为已加密 */ +export function isEncrypted(p: string | undefined | null): boolean { + return !!p && p.length === 96 && /^[0-9a-f]+$/i.test(p) +} diff --git a/src/core/help.ts b/src/core/help.ts new file mode 100644 index 0000000..fc28107 --- /dev/null +++ b/src/core/help.ts @@ -0,0 +1,111 @@ +/** + * help.ts — AI 友好帮助体系 + * + * 用法: 给 Commander.js 命令对象挂元数据 (cmd as any)._aiMeta = meta + * 由 cli.ts 顶层在 parse 之前扫 argv 拦截 --ai-help / --example / --source + * 打印后 process.exit, 避免命令真正执行 / 校验 requiredOption + */ +import type { Command } from 'commander' + +export interface AiHelp { + purpose: string + required?: Record + optional?: Record + example?: string | string[] + source?: { web?: string; api?: string; ref?: string } + notes?: string[] +} + +const AI_FLAGS = new Set(['--ai-help', '--example', '--source']) + +/** 把元数据挂到 command 上, cli.ts 顶层会读 */ +export function installAiHelpHook(cmd: Command, meta: AiHelp): void { + ;(cmd as unknown as { _aiMeta?: AiHelp })._aiMeta = meta +} + +function getMeta(cmd: Command): AiHelp | undefined { + return (cmd as unknown as { _aiMeta?: AiHelp })._aiMeta +} + +/** + * 顶层在 parse 前调用. 命中 ai flag 则打印 + exit, 返回 true. + */ +export function maybeInterceptAiHelp(program: Command): boolean { + const argv = process.argv.slice(2) + const flagIdx = argv.findIndex((a) => AI_FLAGS.has(a)) + if (flagIdx < 0) return false + const flag = argv[flagIdx] + // 把 flag 之前的非选项 token 当成命令路径 + const path = argv.slice(0, flagIdx).filter((a) => !a.startsWith('-')) + // 走命令树 + let cur: Command = program + for (const p of path) { + const sub = cur.commands.find((c) => c.name() === p) + if (!sub) break + cur = sub + } + const meta = getMeta(cur) + if (!meta) { + console.error(`(no ai-help for: ${path.join(' ') || ''})`) + process.exit(2) + } + if (flag === '--example') { + const ex = Array.isArray(meta.example) ? meta.example.join('\n') : meta.example || '(no example)' + console.log(ex) + } else if (flag === '--source') { + const lines: string[] = [] + if (meta.source?.web) lines.push(`web: ${meta.source.web}`) + if (meta.source?.api) lines.push(`api: ${meta.source.api}`) + console.log(lines.join('\n') || '(no source)') + } else { + console.log(renderAiHelp(cur, meta)) + } + process.exit(0) +} + +function renderAiHelp(cmd: Command, meta: AiHelp): string { + const lines: string[] = [] + // 拼出完整路径 + const path: string[] = [cmd.name()] + let p: Command | null = cmd.parent as Command | null + while (p) { + path.unshift(p.name()) + p = p.parent as Command | null + } + // 去 root 名 + const fullCmd = path.slice(1).join(' ') || path[0] + + lines.push(`# dacli ${fullCmd}`) + lines.push('') + lines.push('## 用途') + lines.push(meta.purpose) + if (meta.required && Object.keys(meta.required).length) { + lines.push('') + lines.push('## 必传参数') + for (const [k, v] of Object.entries(meta.required)) lines.push(`- \`${k}\`: ${v}`) + } + if (meta.optional && Object.keys(meta.optional).length) { + lines.push('') + lines.push('## 可选参数') + for (const [k, v] of Object.entries(meta.optional)) lines.push(`- \`${k}\`: ${v}`) + } + if (meta.source?.web || meta.source?.api) { + lines.push('') + lines.push('## 来源') + if (meta.source.web) lines.push(`- web 源码: ${meta.source.web}`) + if (meta.source.api) lines.push(`- API: ${meta.source.api}`) + } + if (meta.example) { + lines.push('') + lines.push('## 例子') + lines.push('```bash') + lines.push(Array.isArray(meta.example) ? meta.example.join('\n') : meta.example) + lines.push('```') + } + if (meta.notes && meta.notes.length) { + lines.push('') + lines.push('## 注意') + for (const n of meta.notes) lines.push(`- ${n}`) + } + return lines.join('\n') +} diff --git a/src/core/log.ts b/src/core/log.ts new file mode 100644 index 0000000..0c0b426 --- /dev/null +++ b/src/core/log.ts @@ -0,0 +1,44 @@ +/** + * log.ts — 极简彩色日志 + */ +const isTTY = process.stdout.isTTY +const C = { + reset: isTTY ? '\x1b[0m' : '', + dim: isTTY ? '\x1b[2m' : '', + red: isTTY ? '\x1b[31m' : '', + green: isTTY ? '\x1b[32m' : '', + yellow: isTTY ? '\x1b[33m' : '', + blue: isTTY ? '\x1b[34m' : '', + cyan: isTTY ? '\x1b[36m' : '', + bold: isTTY ? '\x1b[1m' : '', +} + +export const log = { + info(...args: unknown[]) { + console.log(`${C.cyan}ℹ${C.reset}`, ...args) + }, + ok(...args: unknown[]) { + console.log(`${C.green}✓${C.reset}`, ...args) + }, + warn(...args: unknown[]) { + console.warn(`${C.yellow}!${C.reset}`, ...args) + }, + error(...args: unknown[]) { + console.error(`${C.red}✗${C.reset}`, ...args) + }, + dim(...args: unknown[]) { + console.log(`${C.dim}${args.join(' ')}${C.reset}`) + }, + raw(s: string) { + process.stdout.write(s) + }, + /** 仅在 DACLI_DEBUG=1 时打 */ + debug(...args: unknown[]) { + if (process.env.DACLI_DEBUG === '1') console.error(`${C.dim}[debug]${C.reset}`, ...args) + }, +} + +/** JSON 美化输出 (供命令直接打到 stdout, 便于 jq 管道) */ +export function printJson(v: unknown): void { + console.log(JSON.stringify(v, null, 2)) +} diff --git a/src/core/types.ts b/src/core/types.ts new file mode 100644 index 0000000..66ed10e --- /dev/null +++ b/src/core/types.ts @@ -0,0 +1,66 @@ +/** + * types.ts — 共享类型定义 + */ + +export interface JnpfResp { + code: number + msg: string + data: T | null +} + +export interface DataSourceMeta { + id: string + fullName: string + enCode: string + dbType: string +} + +export interface LoginResp { + token: string + theme?: string + isSaas?: boolean +} + +export interface TokenFile { + baseUrl: string + appCode: string + account: string + token: string + /** ISO 时间, token 7 天过期 */ + loginAt: string + /** 业务库 id (从 /system/DataSource 取第一个非主库) */ + dbLinkId?: string +} + +export interface FormSummary { + id: string + fullName: string + enCode: string + state: number + type: number + webType: number + dbLinkId?: string + category?: string + creatorTime?: string +} + +export interface FormDetail extends FormSummary { + formData?: unknown + columnData?: unknown + tables?: unknown[] + [k: string]: unknown +} + +/** + * dacli 内部错误 (包装 HTTP 业务码 != 200) + */ +export class DacliError extends Error { + code: number + raw?: string + constructor(message: string, code = -1, raw?: string) { + super(message) + this.name = 'DacliError' + this.code = code + this.raw = raw + } +} diff --git a/src/data/.gitkeep b/src/data/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/schema/FieldBuilder.ts b/src/schema/FieldBuilder.ts new file mode 100644 index 0000000..2951c56 --- /dev/null +++ b/src/schema/FieldBuilder.ts @@ -0,0 +1,267 @@ +/** + * schema/FieldBuilder.ts — 通用 FieldBuilder + * + * 从 src/data/*.json 加载 schema, 暴露 `build(jnpfKey, props)` API. + * + * 核心设计 (来自 doc/architecture.md §2.3): + * - 不用 Java 版 53 个硬编码 builder + * - 1 个通用 builder + JSON schema + * - JNPF 升级: 重跑 extract-all, 不改 builder 代码 + * + * 数据流: + * component-map.json (jnpfKey → tag) ─┐ + * field-schemas.json (jnpfKey → fields) ─┤→ FieldBuilder.build() + * validation-rules.json (L1 正则) ─┘ + * + * 用法: + * const fb = new FieldBuilder() + * const f = fb.build('input', { label: '姓名', __config__: { required: true } }) + */ +import { readFileSync } from 'node:fs' +import { dirname, resolve } from 'node:path' +import { fileURLToPath } from 'node:url' + +// ----- JSON 数据类型 ----- + +export interface ComponentMap { + [jnpfKey: string]: string +} + +export interface FieldSchemas { + [jnpfKey: string]: string[] +} + +export interface ValidationRule { + msg: string + rule: string +} + +export interface ValidationRules { + [name: string]: ValidationRule +} + +// ----- 加载工具 ----- + +function dataDir(): string { + // 文件位置: src/schema/FieldBuilder.ts + // 数据位置: src/data/*.json + // __dirname = src/schema → ../../data ? No: src/schema → ../data + const here = dirname(fileURLToPath(import.meta.url)) + return resolve(here, '../data') +} + +function readJson(file: string): T { + const p = resolve(dataDir(), file) + return JSON.parse(readFileSync(p, 'utf-8')) as T +} + +/** 加载 component-map (jnpfKey → tag). 60+ 项 */ +export function loadComponentMap(): ComponentMap { + return readJson('component-map.json') +} + +/** 加载 field-schemas (jnpfKey → activeData 字段列表). 39 控件 */ +export function loadFieldSchemas(): FieldSchemas { + return readJson('field-schemas.json') +} + +/** 加载 validation-rules (L1 正则). 14 条 */ +export function loadValidationRules(): ValidationRules { + return readJson('validation-rules.json') +} + +// ----- 通用 FieldBuilder ----- + +/** 完整 field 形状 (来自 web componentMap.ts 的 inputComponents 之一) */ +export interface JnpfField { + __config__: { + jnpfKey: string + label: string + tag: string + span: number + layout: 'colFormItem' | 'rowFormItem' + showLabel: boolean + required: boolean + regList: unknown[] + trigger: string | string[] + visibility: string[] + [k: string]: unknown + } + // 其他属性 (placeholder, style, options 等) 由用户传入 + [k: string]: unknown +} + +/** 控件分类 (来自 web componentMap.ts) */ +export const COMPONENT_CATEGORY: Record = { + // 基础 input + input: 'input', textarea: 'input', inputNumber: 'input', switch: 'input', + radio: 'input', checkbox: 'input', select: 'input', cascader: 'input', + datePicker: 'input', timePicker: 'input', uploadFile: 'input', uploadImg: 'input', + colorPicker: 'input', rate: 'input', slider: 'input', editor: 'input', + link: 'input', button: 'input', text: 'input', alert: 'input', + qrcode: 'input', barcode: 'input', carousel: 'input', + // 高级 select + organizeSelect: 'select', posSelect: 'select', userSelect: 'select', + roleSelect: 'select', groupSelect: 'select', table: 'select', + treeSelect: 'select', popupTableSelect: 'select', autoComplete: 'select', + areaSelect: 'select', relationForm: 'select', relationFormAttr: 'select', + popupSelect: 'select', popupAttr: 'select', signature: 'select', + sign: 'select', location: 'select', iframe: 'select', calculate: 'select', + dateCalculate: 'select', relationQuery: 'select', + // 系统 + createUser: 'system', createTime: 'system', modifyUser: 'system', + modifyTime: 'system', currOrganize: 'system', currPosition: 'system', billRule: 'system', + // 布局 + groupTitle: 'layout', divider: 'layout', collapse: 'layout', tab: 'layout', + steps: 'layout', row: 'layout', card: 'layout', tableGrid: 'layout', +} + +/** layout 类的 jnpfKey */ +const LAYOUT_KEYS = new Set([ + 'groupTitle', 'divider', 'collapse', 'tab', 'steps', 'row', 'card', 'tableGrid', +]) + +/** 子表 (table) 类 (特殊) */ +const TABLE_KEY = 'table' + +/** + * 通用 FieldBuilder — 从 JSON schema 装配一个完整 field + * + * @param jnpfKey 控件 key (e.g. 'input', 'select', 'relationForm') + * @param props 覆盖属性, 可含 __config__ 子对象覆盖默认 + * @returns 完整 JnpfField 对象 + */ +export class FieldBuilder { + private componentMap: ComponentMap + private fieldSchemas: FieldSchemas + private validationRules: ValidationRules + + constructor() { + this.componentMap = loadComponentMap() + this.fieldSchemas = loadFieldSchemas() + this.validationRules = loadValidationRules() + } + + /** 所有已知的 jnpfKey */ + listKeys(): string[] { + return Object.keys(this.componentMap) + } + + /** 控件分类 */ + category(jnpfKey: string): 'input' | 'select' | 'system' | 'layout' | 'ocr' | 'unknown' { + return COMPONENT_CATEGORY[jnpfKey] || 'unknown' + } + + /** jnpfKey 对应的 tag (e.g. 'input' → 'JnpfInput'). 找不到返回 undefined */ + tag(jnpfKey: string): string | undefined { + return this.componentMap[jnpfKey] + } + + /** 控件在 Rxxx.vue 里实际使用的 activeData 字段列表 (来自 field-schemas.json) */ + activeDataFields(jnpfKey: string): string[] { + return this.fieldSchemas[jnpfKey] || [] + } + + /** L1 正则规则 (14 条) */ + validationRule(name: string): ValidationRule | undefined { + return this.validationRules[name] + } + + /** 所有 L1 正则 key (供 `dacli form create --fields` 用) */ + validationRuleKeys(): string[] { + return Object.keys(this.validationRules) + } + + /** + * 构造一个完整 field 对象. + * + * @example + * const f = fb.build('input', { + * label: '姓名', + * __config__: { required: true, regList: [{ pattern: 'chinese', message: '请输入中文' }] }, + * placeholder: '请输入姓名', + * }) + */ + build(jnpfKey: string, props: Record = {}): JnpfField { + const tag = this.componentMap[jnpfKey] + if (!tag) { + throw new Error(`Unknown jnpfKey: '${jnpfKey}'. 可用: ${this.listKeys().slice(0, 10).join(', ')}...`) + } + const cat = this.category(jnpfKey) + const isLayout = cat === 'layout' + const isTable = jnpfKey === TABLE_KEY + + // 默认 __config__ + const defaultConfig: Record = { + jnpfKey, + label: props.label as string || jnpfKey, + tag, + showLabel: !isLayout, + span: 24, + layout: isLayout || isTable ? 'rowFormItem' : 'colFormItem', + required: false, + visibility: ['pc', 'app'], + noShow: false, + dragDisabled: false, + } + // 大部分控件有 regList, 简单系统/布局类没有 + if (!isLayout && jnpfKey !== 'billRule' && jnpfKey !== 'createUser' && jnpfKey !== 'createTime' && + jnpfKey !== 'modifyUser' && jnpfKey !== 'modifyTime' && jnpfKey !== 'currOrganize' && + jnpfKey !== 'currPosition' && jnpfKey !== 'link' && jnpfKey !== 'button' && jnpfKey !== 'text' && + jnpfKey !== 'alert' && jnpfKey !== 'iframe') { + defaultConfig.regList = [] + } + // trigger + if (['input', 'textarea'].includes(jnpfKey)) defaultConfig.trigger = 'blur' + else if (['switch', 'radio', 'checkbox', 'select', 'cascader', 'datePicker', 'timePicker', + 'uploadFile', 'uploadImg', 'colorPicker', 'rate', 'slider', 'treeSelect', + 'popupTableSelect', 'areaSelect', 'relationForm', 'popupSelect', 'signature', + 'sign', 'location', 'userSelect', 'roleSelect', 'organizeSelect', 'posSelect', + 'groupSelect', 'inputNumber', 'autoComplete'].includes(jnpfKey)) { + defaultConfig.trigger = 'change' + } + else if (jnpfKey === 'editor') defaultConfig.trigger = 'blur' + + // 合并 __config__ (用户提供优先) + const userConfig = (props.__config__ as Record) || {} + const finalConfig: Record = { ...defaultConfig, ...userConfig } + // label 一致性: __config__.label 优先 (用户可能两边都传) + if (props.label && !userConfig.label) finalConfig.label = props.label + + // 默认属性 (style 等) + const defaults: Record = { + style: { width: '100%' }, + } + // switch/radio/checkbox/select 默认值 + if (jnpfKey === 'switch') defaults.defaultValue = 0 + if (jnpfKey === 'checkbox') defaults.defaultValue = [] + if (jnpfKey === 'cascader') defaults.defaultValue = [] + if (jnpfKey === 'rate' || jnpfKey === 'slider') defaults.defaultValue = 0 + + const { __config__: _drop, ...restUser } = props + return { + ...defaults, + ...restUser, + __config__: finalConfig, + } as JnpfField + } + + /** + * 便利: 构造 regList 条目 (引用 L1 正则). + * @example + * fb.regList('chinese', '请输入中文') + * → { pattern: 'chinese', message: '请输入中文' } + */ + regList(name: string, customMsg?: string): { pattern: string; message: string } { + const r = this.validationRules[name] + if (!r) throw new Error(`Unknown L1 rule: '${name}'. 可用: ${this.validationRuleKeys().join(', ')}`) + return { pattern: name, message: customMsg || r.msg } + } +} + +/** 全局单例 (复用已加载的 JSON) */ +let _defaultBuilder: FieldBuilder | null = null +export function defaultFieldBuilder(): FieldBuilder { + if (!_defaultBuilder) _defaultBuilder = new FieldBuilder() + return _defaultBuilder +} diff --git a/src/schema/index.ts b/src/schema/index.ts new file mode 100644 index 0000000..4fc677a --- /dev/null +++ b/src/schema/index.ts @@ -0,0 +1,10 @@ +/** + * schema/index.ts — FieldBuilder 入口 + * + * 用法: + * import { FieldBuilder, defaultFieldBuilder, type JnpfField } from '../schema/index.ts' + * + * const fb = defaultFieldBuilder() + * const field = fb.build('input', { label: '姓名', __config__: { required: true } }) + */ +export * from './FieldBuilder.ts' diff --git a/tests/e2e/_helpers/auth-reuse.spec.ts b/tests/e2e/_helpers/auth-reuse.spec.ts new file mode 100644 index 0000000..bf6d456 --- /dev/null +++ b/tests/e2e/_helpers/auth-reuse.spec.ts @@ -0,0 +1,37 @@ +/** + * tests/e2e/_helpers/auth-reuse.spec.ts — 验证 storageState 注入 + 浏览器会话复用 + * + * 跑 chromium project 时: + * 1) 不重新走 UI 登录, 直接 page.goto /jnpf_app_tds/home, 应能看到登录后页面 (不是登录页) + * 2) 同 context 跳到 /jnpf_app_workSystem/home, 应同样保持登录态 (token host-wide) + * + * 验收: storage 注入有效, 节省每个 spec 都重登的 ~5s + * + * 注: 顶部 nav 是 img 图标无文字, 改用 (a) URL 不含 /login + (b) 无 #form_item_account 字段 + * 作为"非登录页"的稳信号 (来自 ssw-e2e-test 验证 — 登录字段 id 是 jnpf 稳定契约). + */ +import { test, expect } from '@playwright/test' + +async function expectLoggedIn(page: import('@playwright/test').Page, label: string) { + // 1) URL 不在登录页 + expect(page.url(), `[${label}] 应跳过登录, URL 不含 /login`).not.toMatch(/\/login(\?|$)/) + // 2) 页面无登录输入框 (jnpf 登录字段 id 稳定: #form_item_account) + const loginInput = page.locator('#form_item_account') + await expect(loginInput, `[${label}] 登录态应无 #form_item_account 字段`).toHaveCount(0) +} + +test.describe('浏览器会话复用 (storageState)', () => { + test('tds 应用 storageState 注入有效 — 直进 /home 不跳登录', async ({ page }) => { + await page.goto('/jnpf_app_tds/home') + await page.waitForLoadState('networkidle', { timeout: 30_000 }) + await page.waitForTimeout(1500) + await expectLoggedIn(page, 'tds') + }) + + test('workSystem 应用同 context 内复用登录态', async ({ page }) => { + await page.goto('/jnpf_app_workSystem/home') + await page.waitForLoadState('networkidle', { timeout: 30_000 }) + await page.waitForTimeout(1500) + await expectLoggedIn(page, 'workSystem') + }) +}) diff --git a/tests/e2e/_helpers/auth.ts b/tests/e2e/_helpers/auth.ts new file mode 100644 index 0000000..02e5533 --- /dev/null +++ b/tests/e2e/_helpers/auth.ts @@ -0,0 +1,100 @@ +/** + * tests/e2e/_helpers/auth.ts — 浏览器会话管理 helper + * + * 提供 ensureAuth(): 检查 .auth/admin.json 是否新鲜 (≤ TTL), + * 不新鲜则触发完整 UI 登录, 把 cookie + localStorage 写到该文件. + * + * 用法 (spec 内): + * import { ensureAuth, BASE_URL_TDS } from '../_helpers/auth' + * const state = await ensureAuth() // 返回 storageState 路径 + * const context = await browser.newContext({ storageState: state }) + * + * 或用 Playwright `projects.setup` 模式 (推荐): + * 见 tests/e2e/auth.setup.ts + playwright.config.ts + * + * 关键配置: + * - 登录入口: `${JNPF_BASE}/jnpf_app_tds/login` (即 http://nginx/jnpf_app_tds/login) + * - 字段 id : #form_item_account + #form_item_password + * - 提交按钮: button:has-text("登 录") (注意中间空格) + * - 登录成功: URL 跳到 /home (page.waitForURL '**\/home**') + * - token 全局共享: 在 tds 登录后, 同会话访问 /jnpf_app_workSystem/model/X 也复用 (浏览器层 cookie + storage 全 host 共享) + * + * TTL 策略 (避开 7 天 token 过期): + * - 默认 6 小时 (远短于 dacli 7 天 token TTL, 留容错) + * - .auth/admin.json modtime 超过则重登 + */ +import { existsSync, statSync, mkdirSync } from 'node:fs' +import { dirname } from 'node:path' +import type { Page, BrowserContext } from '@playwright/test' + +export const AUTH_FILE = '.auth/admin.json' +export const TTL_HOURS = 6 +// JNPF_BASE_URL 配套 playwright.config.ts use.baseURL, 默认 http://nginx/ +// 注: tests 内部不需要直接拼路径, 用 page.goto('/jnpf_app_tds/login') 走相对路径即可 +export const APP_LOGIN_PATH = (appCode: string) => `/jnpf_app_${appCode}/login` +export const APP_HOME_PATH = (appCode: string) => `/jnpf_app_${appCode}/home` +export const APP_MODEL_PATH = (appCode: string, enCode: string) => + `/jnpf_app_${appCode}/model/${enCode}` + +/** + * 判断 .auth/admin.json 是否仍新鲜 (在 TTL 内). + */ +export function isAuthFresh(file = AUTH_FILE, ttlHours = TTL_HOURS): boolean { + if (!existsSync(file)) return false + const ageMs = Date.now() - statSync(file).mtimeMs + return ageMs < ttlHours * 60 * 60 * 1000 +} + +/** + * 在 page 内完成 admin/123456 UI 登录, 返回 true=成功. + * 不写文件 — 调用方决定是否 saveStorageState. + */ +export async function loginAsAdmin( + page: Page, + opts: { appCode?: string; account?: string; password?: string } = {} +): Promise { + const appCode = opts.appCode ?? 'tds' + const account = opts.account ?? 'admin' + const password = opts.password ?? '123456' + + await page.goto(APP_LOGIN_PATH(appCode)) + await page.waitForLoadState('domcontentloaded') + + // 字段 id 是 jnpf 平台稳定契约 (来自 ssw-e2e-test scripts/jnpf_client.py) + await page.fill('#form_item_account', account) + await page.fill('#form_item_password', password) + await page.click('button:has-text("登 录")') + + // 等跳到 /home (jnpf 登录成功标志) + try { + await page.waitForURL('**/home**', { timeout: 15_000 }) + await page.waitForLoadState('networkidle') + return true + } catch { + return false + } +} + +/** + * 全套: 检查 cache → 没 / 过期则用一个临时 context UI 登录 → saveStorageState → 返回路径. + * 用于不走 Playwright `projects.setup` 模式的场景 (单 spec 自给自足). + */ +export async function ensureAuth( + newContext: () => Promise, + opts: { appCode?: string; force?: boolean } = {} +): Promise { + if (!opts.force && isAuthFresh()) return AUTH_FILE + + mkdirSync(dirname(AUTH_FILE), { recursive: true }) + + const ctx = await newContext() + const page = await ctx.newPage() + const ok = await loginAsAdmin(page, { appCode: opts.appCode }) + if (!ok) { + await ctx.close() + throw new Error(`UI 登录失败 (appCode=${opts.appCode ?? 'tds'})`) + } + await ctx.storageState({ path: AUTH_FILE }) + await ctx.close() + return AUTH_FILE +} diff --git a/tests/e2e/auth.setup.ts b/tests/e2e/auth.setup.ts new file mode 100644 index 0000000..ee21b91 --- /dev/null +++ b/tests/e2e/auth.setup.ts @@ -0,0 +1,48 @@ +/** + * tests/e2e/auth.setup.ts — Playwright projects.setup 模式 + * + * 跑一次 UI 登录 (admin/123456 @ tds), 把 cookie + localStorage 持久化到 .auth/admin.json, + * 后续 spec 通过 use.storageState 复用登录态, 不必每个 test 重输密码. + * + * 跑法: + * npx playwright test --project=setup # 单独刷新登录态 + * npx playwright test # 自动先跑 setup 再跑 chromium + * + * TTL 优化: 6 小时内复用, 超时则本次重登 (远短于 dacli 7 天 token). + * + * 关键路径 (来自 ssw-e2e-test 验证): + * 登录页: /jnpf_app_tds/login + * 登录后: /jnpf_app_tds/home + * 会话共享: 同一 host (nginx) 下所有 jnpf_app_X 路径共用 storage (浏览器层 host-wide) + */ +import { test as setup, expect } from '@playwright/test' +import { isAuthFresh, loginAsAdmin, AUTH_FILE, APP_HOME_PATH } from './_helpers/auth' +import { mkdirSync } from 'node:fs' +import { dirname } from 'node:path' + +setup('authenticate as admin/123456 @ tds', async ({ page }) => { + // 新鲜则跳过 — Playwright 仍会写 storageState 给后续 project 用, 我们手动保留旧文件 + if (isAuthFresh()) { + setup.info().annotations.push({ type: 'note', description: 'auth fresh, skip UI login' }) + // 必须依然 storageState 写一次到 fixture, 否则 Playwright 会用空 state + // 用 page.context() 加载现有 file: 我们让 context 直接从 file 初始化 — 但 setup project 没法在 fixture 之前换 context + // 折中: 不在 setup project 用 storageState fixture, 改在 chromium project use.storageState 引用同 file + // 故此处直接 return — chromium project 会从 AUTH_FILE 读 + return + } + + mkdirSync(dirname(AUTH_FILE), { recursive: true }) + + const ok = await loginAsAdmin(page, { appCode: 'tds' }) + expect(ok, 'UI 登录应跳到 /home').toBe(true) + + // 健壮性: 验证 storage 有 access token + const hasAccess = await page.evaluate(() => { + return Object.keys(localStorage).some( + (k) => k.includes('core-access') && (localStorage.getItem(k)?.length ?? 0) > 50 + ) + }) + expect(hasAccess, '登录后 localStorage 应有加密 access token').toBe(true) + + await page.context().storageState({ path: AUTH_FILE }) +}) diff --git a/tests/e2e/baseline/developSystem/regression.spec.ts b/tests/e2e/baseline/developSystem/regression.spec.ts new file mode 100644 index 0000000..0c2a883 --- /dev/null +++ b/tests/e2e/baseline/developSystem/regression.spec.ts @@ -0,0 +1,89 @@ +/** + * tests/e2e/baseline/developSystem/regression.spec.ts + * + * developSystem baseline 回归测试 (API 层 0 错): + * - switch-app 切到 developSystem + * - 拿 form list + * - 对每张表单跑 info 验证 schema 完整 + * - 汇总 PASS / FAIL + * + * 跑法: + * npx playwright test tests/e2e/baseline/developSystem/regression.spec.ts + */ +import { test, expect } from '@playwright/test' +import { execSync } from 'node:child_process' + +const APP_CODE = 'developSystem' + +interface FormRow { id: string; enCode: string; fullName: string; type: number; webType?: string } + +function dacli(args: string): string { + return execSync(`npx tsx src/cli.ts ${args}`, { + encoding: 'utf-8', + cwd: process.cwd(), + }) +} + +test.describe.configure({ mode: 'serial' }) + +test(`switch-app ${APP_CODE} 成功`, () => { + // switch-app --force 在 client.ts:fromToken 里被读 forceLogin + dacli(`switch-app --appCode=${APP_CODE}`) + const st = dacli(`status`) + expect(st).toContain(APP_CODE) +}) + +test('developSystem form list 返回 25+ 张 (v0.6 真总数 29)', () => { + const out = dacli(`form list --limit=200 --json`) + const json = JSON.parse(out) as { list: FormRow[] } + // v0.6 修 dacli list bug 后真总数 29 (vs v0.5 误报 20 — 旧版走 /list 强制 enableFlow=1) + expect(json.list.length, `developSystem form 真总数应 ≥25, 实际 ${json.list.length}`).toBeGreaterThanOrEqual(25) +}) + +test('每张 form info 都能拿到完整 schema', () => { + const out = dacli(`form list --limit=200 --json`) + const json = JSON.parse(out) as { list: FormRow[] } + const forms = json.list || [] + + const results: { enCode: string; ok: boolean; err?: string }[] = [] + for (const f of forms) { + try { + const infoOut = dacli(`form info ${f.id}`) + const info = JSON.parse(infoOut) as { fullName: string; formData: string | null; tables?: string } + if (!info.fullName) throw new Error('fullName 缺失') + // formData 可能是 null (视图) / 对象 (新格式) / 数组 (旧格式) — 都接受 + if (info.formData) { + const formData = JSON.parse(info.formData) as { fields?: unknown[] } | unknown[] + if (Array.isArray(formData)) { + // 接受 + } else if (formData && typeof formData === 'object') { + const fields = (formData as { fields?: unknown[] }).fields + if (fields !== undefined && !Array.isArray(fields)) { + throw new Error('formData.fields 非数组') + } + } else { + throw new Error('formData 既非对象也非数组') + } + } + results.push({ enCode: f.enCode, ok: true }) + } catch (e) { + results.push({ enCode: f.enCode, ok: false, err: (e as Error).message }) + } + } + + const okCount = results.filter((r) => r.ok).length + const failCount = results.length - okCount + console.log(` ✓ PASS: ${okCount}/${results.length}`) + if (failCount > 0) { + console.log(' ✗ FAIL:') + for (const r of results.filter((x) => !x.ok)) console.log(` - ${r.enCode}: ${r.err}`) + } + expect(failCount, `${failCount} 张表单 info 失败`).toBe(0) +}) + +test('workSystem form list 同样通 (真总数 85)', () => { + dacli(`switch-app --appCode=workSystem`) + const out = dacli(`form list --limit=200 --json`) + const json = JSON.parse(out) as { list: FormRow[] } + expect(json.list.length).toBeGreaterThanOrEqual(80) +}) diff --git a/tests/e2e/baseline/template.spec.ts b/tests/e2e/baseline/template.spec.ts new file mode 100644 index 0000000..f8ae105 --- /dev/null +++ b/tests/e2e/baseline/template.spec.ts @@ -0,0 +1,77 @@ +/** + * tests/e2e/baseline/template.spec.ts + * + * baseline 复刻的 Playwright E2E 测试模板 + * 复制本文件改 APP_CODE / ENCODE / TARGET_URL 即可 + * + * 注意: 本文件是模板 — 默认 skip, 防止空跑失败 + * 复刻 baseline 时: 1) 复制为 .spec.ts 2) 改 APP_CODE/ENCODE/TARGET_URL 3) 去掉 test.skip() + */ +import { test, expect } from '@playwright/test' +import { execSync } from 'node:child_process' + +// ========== 配置 ========== +const APP_CODE = 'developSystem' // 源 app +const ENCODE = 'leaveApply' // 源表单 enCode +const CLONE_ENCODE = `${ENCODE}_clone` // 克隆 enCode +const TARGET_URL = `http://127.0.0.1:13880/web/#/${CLONE_ENCODE}` // 实际访问 URL +// 注: TARGET_URL 取决于 nginx 配置, 调整时改这里 + +// ========== 1. 拉克隆 id ========== +function getCloneId(): string { + const out = execSync(`npx tsx src/cli.ts form list --appCode=tds`, { + cwd: process.cwd(), + encoding: 'utf-8', + }) + const m = out.match(new RegExp(`"enCode":"${CLONE_ENCODE}"[\\s\\S]*?"id":"([^"]+)"`)) + if (!m) throw new Error(`克隆表单 ${CLONE_ENCODE} 不存在, 请先跑 baseline 脚本`) + return m[1] +} + +// ========== 2. 拉原表单字段集 (作为 0 差对比基准) ========== +async function getOriginalFields(): Promise { + const out = execSync(`npx tsx src/cli.ts form info --id=${process.env.ORIGINAL_ID} --appCode=${APP_CODE}`, { + encoding: 'utf-8', + }) + const info = JSON.parse(out) + const formData = JSON.parse(info.data.formData || '[]') + return formData.fields?.map((f: any) => f.__vModel__) ?? [] +} + +// ========== 3. 浏览器 0 视觉差测试 ========== +test.skip(`baseline: ${APP_CODE}/${ENCODE} 复刻 0 视觉差 (TEMPLATE, skip)`, async ({ page }) => { + const cloneId = getCloneId() + + // 拿原表单字段名列表 + const originalFields = await getOriginalFields() + expect(originalFields.length).toBeGreaterThan(0) + + // 打开克隆的表单 + await page.goto(TARGET_URL) + await page.waitForLoadState('networkidle') + + // 检查每个原字段都在 + for (const field of originalFields) { + // 字段以 f_ 开头, 渲染成 a-input / a-select / ... + const selector = `[data-field="${field}"], input[id*="${field}"], [name="${field}"]` + const count = await page.locator(selector).count() + expect(count, `字段 ${field} 缺失`).toBeGreaterThan(0) + } + + // 截图 (用于 visual diff) + await page.screenshot({ + path: `screenshots/${APP_CODE}/${ENCODE}.png`, + fullPage: true, + }) +}) + +// ========== 4. 提交测试 (基础功能验证) ========== +test.skip(`baseline: ${APP_CODE}/${ENCODE} 提交按钮存在 (TEMPLATE, skip)`, async ({ page }) => { + const cloneId = getCloneId() + await page.goto(TARGET_URL) + await page.waitForLoadState('networkidle') + + // 提交按钮存在 + const submitBtn = page.locator('button:has-text("提交"), button:has-text("保存")') + await expect(submitBtn).toBeVisible() +}) diff --git a/tests/e2e/baseline/workSystem/regression.spec.ts b/tests/e2e/baseline/workSystem/regression.spec.ts new file mode 100644 index 0000000..d348b5f --- /dev/null +++ b/tests/e2e/baseline/workSystem/regression.spec.ts @@ -0,0 +1,92 @@ +/** + * tests/e2e/baseline/workSystem/regression.spec.ts + * + * workSystem baseline 回归 (API 层 0 错): + * - switch-app 切到 workSystem + * - 拿 form list (真总数 85, v0.6 修 dacli list bug 前误报 52 是 /list 子端点强制 enableFlow=1 的子集) + * - 对每张 form 跑 info 验证 schema 完整 + * - 汇总 PASS / FAIL + * + * 跑法: npx playwright test tests/e2e/baseline/workSystem/regression.spec.ts + */ +import { test, expect } from '@playwright/test' +import { execSync } from 'node:child_process' + +const APP_CODE = 'workSystem' + +interface FormRow { id: string; enCode: string; fullName: string; type: number; webType?: string } + +function dacli(args: string): string { + return execSync(`npx tsx src/cli.ts ${args}`, { + encoding: 'utf-8', + cwd: process.cwd(), + }) +} + +test.describe.configure({ mode: 'serial' }) + +test(`switch-app ${APP_CODE} 成功`, () => { + dacli(`switch-app --appCode=${APP_CODE}`) + const st = dacli(`status`) + expect(st).toContain(APP_CODE) +}) + +test(`${APP_CODE} form list 返回 80+ 张 (v0.6 真总数)`, () => { + const out = dacli(`form list --limit=200 --json`) + const json = JSON.parse(out) as { list: FormRow[] } + // v0.6 修 dacli list bug 后真总数 85 (vs v0.5 误报 52 — 旧版走 /list 强制 enableFlow=1) + expect(json.list.length, `workSystem form 真总数应 ≥80, 实际 ${json.list.length}`).toBeGreaterThanOrEqual(80) +}) + +test('每张 form info 都能拿到完整 schema', () => { + const out = dacli(`form list --limit=200 --json`) + const json = JSON.parse(out) as { list: FormRow[] } + const forms = json.list || [] + + const results: { enCode: string; ok: boolean; err?: string }[] = [] + for (const f of forms) { + try { + const infoOut = dacli(`form info ${f.id}`) + const info = JSON.parse(infoOut) as { fullName: string; formData: string | null; tables?: string } + if (!info.fullName) throw new Error('fullName 缺失') + // formData 可能是 null (视图 form) / 对象 (新格式) / 数组 (旧格式) / 空对象 — 都接受 + if (info.formData) { + const formData = JSON.parse(info.formData) as { fields?: unknown[] } | unknown[] + if (Array.isArray(formData)) { + // 旧格式: formData 直接是 fields 数组 — 接受 + } else if (formData && typeof formData === 'object') { + const fields = (formData as { fields?: unknown[] }).fields + // 接受: 数组 OR 缺失 (空 form) + if (fields !== undefined && !Array.isArray(fields)) { + throw new Error('formData.fields 非数组') + } + } else { + throw new Error('formData 既非对象也非数组') + } + } + // tables 校验 + if (info.tables) { + const tables = JSON.parse(info.tables) as unknown[] + if (!Array.isArray(tables)) throw new Error('tables 非数组') + } + results.push({ enCode: f.enCode, ok: true }) + } catch (e) { + results.push({ enCode: f.enCode, ok: false, err: (e as Error).message }) + } + } + + const okCount = results.filter((r) => r.ok).length + const failCount = results.length - okCount + console.log(` ✓ PASS: ${okCount}/${results.length}`) + if (failCount > 0) { + console.log(' ✗ FAIL:') + for (const r of results.filter((x) => !x.ok)) console.log(` - ${r.enCode}: ${r.err}`) + } + expect(failCount, `${failCount} 张表单 info 失败`).toBe(0) +}) + +test('workflow 列表非空', () => { + const out = dacli(`workflow list --json`) + const json = JSON.parse(out) as { list: unknown[] } + expect(json.list.length).toBeGreaterThanOrEqual(10) +}) diff --git a/tests/e2e/p13-ai-driven-crud.spec.ts b/tests/e2e/p13-ai-driven-crud.spec.ts new file mode 100644 index 0000000..628851e --- /dev/null +++ b/tests/e2e/p13-ai-driven-crud.spec.ts @@ -0,0 +1,92 @@ +/** + * tests/e2e/p13-ai-driven-crud.spec.ts — P0 #13 验收 + * + * 验证 subagent 用 dacli-ts skill 从零搭的 tds_leave 表单 (员工请假申请): + * - 物理表 tds_leave (业务库 dbLinkId=2065323991245033472, 19 字段) + * - form id=835168490678657989, enCode=tds_leave, state=1 + * - menu id=835168942048682949, urlAddress=model/tds_leave + * + * v0.7 P0 #13 校准: AI 用 dacli-ts skill 真懂业务 + 能用工具链 + */ +import { test, expect } from '@playwright/test' + +const FORM_ID = '835168490678657989' +const MODEL_URL = '/jnpf_app_tds/model/tds_leave' + +test.describe('P0 #13: AI 用 dacli-ts 重建员工请假表单, CRUD 真闭环', () => { + test('1. /model/tds_leave 真业务页能开 (不是预览)', async ({ page }) => { + await page.goto(MODEL_URL) + await page.waitForLoadState('networkidle') + // 真业务页含 vxe-table 列表 (jnpf 列表标志) + // 或至少不报 404 / "该表单已删除" + const body = await page.locator('body').textContent() + expect(body).not.toContain('该表单已删除') + expect(body).not.toContain('未找到页面') + expect(body).not.toContain('哎呀') + }) + + test('2. API form info 返完整 schema (state=1)', async ({ request }) => { + // 走 dacli token (从 .dacli-token/token.json 读) + const fs = await import('node:fs') + const tok = JSON.parse(fs.readFileSync('.dacli-token/token.json', 'utf-8')) + const r = await request.get(`${tok.baseUrl}/visualdev/Base/${FORM_ID}`, { + headers: { Authorization: tok.token, 'App-Code': 'tds' }, + }) + expect(r.ok()).toBe(true) + const j = (await r.json()) as { code: number; data: { state: number; enCode: string; tables: string } } + expect(j.code).toBe(200) + expect(j.data.state).toBe(1) + expect(j.data.enCode).toBe('tds_leave') + // tables JSON 含 19 字段 (8 业务 + 2 PK + 9 系统) + const tables = JSON.parse(j.data.tables) + expect(tables.length).toBeGreaterThanOrEqual(1) + expect(tables[0].fields?.length || 0).toBeGreaterThanOrEqual(8) + }) + + test('3. 物理表 tds_leave 在 tds 业务库 (字段含 8 业务列)', async ({ request }) => { + const fs = await import('node:fs') + const tok = JSON.parse(fs.readFileSync('.dacli-token/token.json', 'utf-8')) + const r = await request.get( + `${tok.baseUrl}/system/DataModel/${tok.dbLinkId}/Tables/tds_leave/Fields?field=*`, + { headers: { Authorization: tok.token, 'App-Code': 'tds' } }, + ) + expect(r.ok()).toBe(true) + const j = (await r.json()) as { code: number; data: { list: Array<{ field: string }> } } + expect(j.code).toBe(200) + const fields = j.data.list.map((f) => f.field) + // 8 业务字段全在 + for (const required of [ + 'f_applicant_name', + 'f_department', + 'f_leave_type', + 'f_start_date', + 'f_end_date', + 'f_days', + 'f_reason', + 'f_approval_opinion', + ]) { + expect(fields).toContain(required) + } + // 2 复合 PK + expect(fields).toContain('f_id') + expect(fields).toContain('f_tenant_id') + }) + + test('4. menu 挂在 tds_leave 表单 (web 真路径), 列表能看到', async ({ request }) => { + const fs = await import('node:fs') + const tok = JSON.parse(fs.readFileSync('.dacli-token/token.json', 'utf-8')) + // /system/Menu/ModuleBySystem — 真实响应 { code, data: { list: [{enCode, urlAddress, ...}, ...] } } + const r = await request.get(`${tok.baseUrl}/system/Menu/ModuleBySystem`, { + headers: { Authorization: tok.token, 'App-Code': 'tds' }, + }) + expect(r.ok()).toBe(true) + const j = (await r.json()) as { + code: number + data: { list: Array<{ enCode?: string; urlAddress?: string }> } + } + expect(j.code).toBe(200) + const tdsLeaveMenu = j.data.list.find((m) => m.enCode === 'tds_leave_menu') + expect(tdsLeaveMenu).toBeTruthy() + expect(tdsLeaveMenu?.urlAddress).toBe('model/tds_leave') + }) +}) diff --git a/tests/e2e/smoke.spec.ts b/tests/e2e/smoke.spec.ts new file mode 100644 index 0000000..b021689 --- /dev/null +++ b/tests/e2e/smoke.spec.ts @@ -0,0 +1,49 @@ +/** + * tests/e2e/smoke.spec.ts + * + * Smoke test — 验证整个基础设施跑通: + * 1. JNPF web UI 加载 + * 2. dacli CLI 登录成功 + * 3. form list 返回 N+ 张 + * 4. login 页面能渲染 + * + * 这是 W2-D4 (Playwright 配置) 的验收. + * 跑法: npx playwright test tests/e2e/smoke.spec.ts + */ +import { test, expect } from '@playwright/test' +import { execSync } from 'node:child_process' + +const APP_CODE = 'developSystem' + +test('JNPF web UI 加载 (nginx)', async ({ page }) => { + const res = await page.goto('/') + expect(res?.ok(), `nginx 首页 HTTP 状态`).toBeTruthy() + // 等待 jnpf SPA 加载 + await page.waitForLoadState('networkidle', { timeout: 30_000 }) +}) + +test('dacli login + form list 端到端', async () => { + // 用子进程跑 dacli (与生产用法一致) + const out = execSync( + `npx tsx src/cli.ts form list --json 2>&1 | head -200`, + { encoding: 'utf-8', cwd: process.cwd() }, + ) + // 至少返回一些 form + expect(out).toMatch(/developSystem|"enCode"|"id"/i) +}) + +test('JNPF 登录页能渲染', async ({ browser }) => { + // v0.6 修: 默认 chromium project 用 .auth/admin.json (已登录态), + // 访问 /login 会被 access guard 跳到 /home → 看不到登录输入框. + // 这里显式用空 storageState 起新 context, 模拟未登录访问. + const context = await browser.newContext({ storageState: { cookies: [], origins: [] } }) + const page = await context.newPage() + try { + await page.goto('/web/#/login') + await page.waitForLoadState('networkidle', { timeout: 30_000 }) + const accountInput = page.locator('input[placeholder*="账号"], input[placeholder*="账"]') + await expect(accountInput.first()).toBeVisible({ timeout: 15_000 }) + } finally { + await context.close() + } +}) diff --git a/tests/unit/cli-help.test.ts b/tests/unit/cli-help.test.ts new file mode 100644 index 0000000..5809853 --- /dev/null +++ b/tests/unit/cli-help.test.ts @@ -0,0 +1,65 @@ +/** + * cli-help.test.ts — CLI --help / --version 烟囱测试 + * + * 不依赖 JNPF, 只验证 commander 能解析命令树 + */ +import { describe, it, expect } from 'vitest' +import { execFileSync } from 'node:child_process' +import { resolve } from 'node:path' +import { fileURLToPath } from 'node:url' + +const __dirname = fileURLToPath(new URL('.', import.meta.url)) +const CLI = resolve(__dirname, '../../src/cli.ts') + +function run(args: string[]): string { + try { + return execFileSync('npx', ['tsx', CLI, ...args], { + encoding: 'utf-8', + stdio: ['pipe', 'pipe', 'pipe'], + timeout: 30_000, + }) + } catch (e) { + // help/version 可能 exit non-zero, 取 stdout + const err = e as { stdout?: Buffer | string; status?: number } + return (err.stdout?.toString() || '') + } +} + +describe('cli help', () => { + it('--version 输出 0.1.0', () => { + const out = run(['--version']) + expect(out).toContain('0.1.0') + }) + + it('--help 列出顶层命令', () => { + const out = run(['--help']) + expect(out).toContain('login') + expect(out).toContain('status') + expect(out).toContain('switch-app') + expect(out).toContain('form') + }) + + it('form --help 列出子命令', () => { + const out = run(['form', '--help']) + expect(out).toContain('list') + expect(out).toContain('info') + expect(out).toContain('create') + expect(out).toContain('release') + expect(out).toContain('clone') + expect(out).toContain('export') + expect(out).toContain('import') + expect(out).toContain('validate') + }) + + it('login --ai-help 输出 markdown', () => { + const out = run(['login', '--ai-help']) + expect(out).toContain('# dacli login') + expect(out).toContain('## 用途') + expect(out).toContain('admin') + }) + + it('form create --example 输出可执行命令', () => { + const out = run(['form', 'create', '--example']) + expect(out).toContain('dacli form create') + }) +}) diff --git a/tests/unit/config.test.ts b/tests/unit/config.test.ts new file mode 100644 index 0000000..0db4916 --- /dev/null +++ b/tests/unit/config.test.ts @@ -0,0 +1,59 @@ +/** + * config.test.ts — token 持久化 + baseUrl 候选 + */ +import { describe, it, expect, beforeEach, afterAll } from 'vitest' +import { mkdtempSync, rmSync, existsSync } from 'node:fs' +import { tmpdir } from 'node:os' +import { join } from 'node:path' +import { saveToken, loadToken, clearToken, getTokenPath, baseUrlCandidates } from '../../src/core/config.ts' + +const tmpRoot = mkdtempSync(join(tmpdir(), 'dacli-cfg-')) + +beforeEach(() => { + process.env.DACLI_TOKEN_DIR = tmpRoot +}) + +afterAll(() => rmSync(tmpRoot, { recursive: true, force: true })) + +describe('config', () => { + it('saveToken/loadToken roundtrip', () => { + saveToken({ + baseUrl: 'http://x/api', + appCode: 'developSystem', + account: 'admin', + token: 'TOKEN_X', + loginAt: '2026-06-12T00:00:00Z', + dbLinkId: 'biz_db', + }) + const t = loadToken() + expect(t).not.toBeNull() + expect(t!.token).toBe('TOKEN_X') + expect(t!.appCode).toBe('developSystem') + expect(t!.dbLinkId).toBe('biz_db') + }) + + it('getTokenPath 受 DACLI_TOKEN_DIR 控制', () => { + expect(getTokenPath()).toBe(join(tmpRoot, 'token.json')) + }) + + it('clearToken 删除文件', () => { + saveToken({ baseUrl: 'http://x/api', appCode: 'x', account: 'a', token: 't', loginAt: 'now' }) + expect(existsSync(getTokenPath())).toBe(true) + clearToken() + expect(existsSync(getTokenPath())).toBe(false) + }) + + it('baseUrlCandidates 至少含 nginx + 30000', () => { + delete process.env.JNPF_BASE_URL + const list = baseUrlCandidates() + expect(list).toContain('http://nginx/api') + expect(list).toContain('http://127.0.0.1:30000/api') + }) + + it('JNPF_BASE_URL 优先', () => { + process.env.JNPF_BASE_URL = 'http://custom/api' + const list = baseUrlCandidates() + expect(list[0]).toBe('http://custom/api') + delete process.env.JNPF_BASE_URL + }) +}) diff --git a/tests/unit/crypto.test.ts b/tests/unit/crypto.test.ts new file mode 100644 index 0000000..6dc695c --- /dev/null +++ b/tests/unit/crypto.test.ts @@ -0,0 +1,46 @@ +/** + * crypto.test.ts — 加密 1:1 一致性验证 + * + * 关键: '123456' + 默认密钥 'EY8WePvjM5GGwQzn' → 96 字符 hex + */ +import { describe, it, expect, beforeAll } from 'vitest' +import { encryptByMd5, encryptPassword, isEncrypted } from '../../src/core/crypto.ts' + +describe('crypto', () => { + beforeAll(() => { + // 强制用固定 key, 避免 .env 漂移 + process.env.VITE_CIPHER_KEY = 'EY8WePvjM5GGwQzn' + }) + + it('encryptByMd5 输出 32 字符 hex', () => { + const r = encryptByMd5('123456') + expect(r).toMatch(/^[0-9a-f]{32}$/) + expect(r).toBe('e10adc3949ba59abbe56e057f20f883e') // 知名 md5 + }) + + it('encryptPassword 输出 96 字符 hex (与 web cipher.ts 一致)', () => { + const r = encryptPassword('123456') + expect(r).toMatch(/^[0-9a-f]+$/) + expect(r).toHaveLength(96) + }) + + it('encryptPassword 同输入同输出 (ECB 无 IV)', () => { + const a = encryptPassword('123456') + const b = encryptPassword('123456') + expect(a).toBe(b) + }) + + it('encryptPassword 不同输入不同输出', () => { + const a = encryptPassword('123456') + const b = encryptPassword('abcdef') + expect(a).not.toBe(b) + }) + + it('isEncrypted 判定', () => { + expect(isEncrypted('123456')).toBe(false) + expect(isEncrypted(encryptPassword('123456'))).toBe(true) + expect(isEncrypted('')).toBe(false) + expect(isEncrypted(null)).toBe(false) + expect(isEncrypted('z'.repeat(96))).toBe(false) // 'z' 不是 hex 字符 + }) +}) diff --git a/tests/unit/field-builder.test.ts b/tests/unit/field-builder.test.ts new file mode 100644 index 0000000..72ed81b --- /dev/null +++ b/tests/unit/field-builder.test.ts @@ -0,0 +1,158 @@ +/** + * tests/unit/field-builder.test.ts — FieldBuilder 单元测试 + * + * 验证: + * 1. 60+ jnpfKey 都能从 component-map.json 找到 + * 2. 39 控件在 field-schemas.json 都有 activeData 字段 + * 3. 14 条 L1 正则都能加载 + * 4. build('input', ...) 产生完整 JnpfField + * 5. build 未知 jnpfKey 抛错 + * 6. regList 引用 L1 正则 + * 7. layout 控件的默认 layout=rowFormItem + * 8. switch/radio 等默认值正确 + */ +import { describe, it, expect } from 'vitest' +import { FieldBuilder, defaultFieldBuilder, loadComponentMap, loadFieldSchemas, loadValidationRules } from '../../src/schema/FieldBuilder.ts' + +describe('JSON schema 加载', () => { + it('component-map.json 有 60+ jnpfKey', () => { + const m = loadComponentMap() + expect(Object.keys(m).length).toBeGreaterThanOrEqual(60) + expect(m.input).toBe('JnpfInput') + expect(m.select).toBe('JnpfSelect') + expect(m.relationForm).toBe('JnpfRelationForm') + }) + + it('field-schemas.json 有 39 控件字段', () => { + const s = loadFieldSchemas() + expect(Object.keys(s).length).toBeGreaterThanOrEqual(39) + expect(s.input).toContain('maxlength') + expect(s.input).toContain('clearable') + expect(s.switch).toContain('activeTxt') + expect(s.inputNumber).toContain('precision') + }) + + it('validation-rules.json 有 14 条 L1 正则', () => { + const v = loadValidationRules() + expect(Object.keys(v).length).toBeGreaterThanOrEqual(14) + expect(v.chinese.msg).toBe('请正确输入中文') + expect(v.email.rule).toMatch(/@/) // email regex contains @ literal + expect(v.iphone.rule).toMatch(/1\[3-9\]/) + }) +}) + +describe('FieldBuilder.build()', () => { + const fb = new FieldBuilder() + + it('input 控件: 完整 __config__ + 默认属性', () => { + const f = fb.build('input', { label: '姓名' }) + expect(f.__config__.jnpfKey).toBe('input') + expect(f.__config__.tag).toBe('JnpfInput') + expect(f.__config__.label).toBe('姓名') + expect(f.__config__.layout).toBe('colFormItem') + expect(f.__config__.span).toBe(24) + expect(f.__config__.required).toBe(false) + expect(f.__config__.regList).toEqual([]) + expect(f.__config__.trigger).toBe('blur') + expect(f.style).toEqual({ width: '100%' }) + }) + + it('switch 控件: defaultValue=0, trigger=change', () => { + const f = fb.build('switch', { label: '启用' }) + expect(f.__config__.jnpfKey).toBe('switch') + expect(f.__config__.tag).toBe('JnpfSwitch') + expect(f.__config__.trigger).toBe('change') + expect(f.defaultValue).toBe(0) + }) + + it('checkbox 控件: defaultValue=[]', () => { + const f = fb.build('checkbox', { label: '兴趣' }) + expect(f.defaultValue).toEqual([]) + }) + + it('用户提供的 __config__.required 覆盖默认 false', () => { + const f = fb.build('input', { label: 'X', __config__: { required: true } }) + expect(f.__config__.required).toBe(true) + }) + + it('用户提供的 regList 走自定义', () => { + const f = fb.build('input', { + __config__: { regList: [{ pattern: 'chinese', message: '请输入中文' }] }, + }) + expect(f.__config__.regList).toEqual([{ pattern: 'chinese', message: '请输入中文' }]) + }) + + it('layout 控件 (groupTitle): layout=rowFormItem, showLabel=false', () => { + const f = fb.build('groupTitle', { label: '基本信息' }) + expect(f.__config__.layout).toBe('rowFormItem') + expect(f.__config__.showLabel).toBe(false) + expect(f.__config__.regList).toBeUndefined() + }) + + it('table 控件 (子表): layout=rowFormItem', () => { + const f = fb.build('table', { label: '子表' }) + expect(f.__config__.layout).toBe('rowFormItem') + expect(f.__config__.tag).toBe('JnpfInputTable') + }) + + it('未知 jnpfKey 抛错', () => { + expect(() => fb.build('notExist', {})).toThrow(/Unknown jnpfKey/) + }) + + it('额外属性透传', () => { + const f = fb.build('input', { placeholder: '请输入姓名', maxlength: 50, addonBefore: '¥' }) + expect(f.placeholder).toBe('请输入姓名') + expect(f.maxlength).toBe(50) + expect(f.addonBefore).toBe('¥') + }) +}) + +describe('FieldBuilder.regList()', () => { + const fb = new FieldBuilder() + + it('L1 正则 chinese', () => { + const r = fb.regList('chinese') + expect(r.pattern).toBe('chinese') + expect(r.message).toBe('请正确输入中文') + }) + + it('L1 正则 email 自定义 message', () => { + const r = fb.regList('email', '邮箱格式不对') + expect(r.message).toBe('邮箱格式不对') + }) + + it('L1 正则 chinese 默认 message', () => { + const r = fb.regList('chinese') + expect(r.pattern).toBe('chinese') + expect(r.message).toBe('请正确输入中文') + }) + + it('未知正则抛错', () => { + expect(() => fb.regList('notARule')).toThrow(/Unknown L1 rule/) + }) +}) + +describe('defaultFieldBuilder() 单例', () => { + it('多次调用返回同一实例', () => { + const a = defaultFieldBuilder() + const b = defaultFieldBuilder() + expect(a).toBe(b) + }) +}) + +describe('FieldBuilder 业务场景: 多字段表单', () => { + it('请假单 (姓名/类型/日期/说明)', () => { + const fb = new FieldBuilder() + const fields = [ + fb.build('input', { label: '姓名' }), + fb.build('select', { label: '类型', options: [{ id: '1', fullName: '事假' }, { id: '2', fullName: '病假' }] }), + fb.build('datePicker', { label: '开始日期' }), + fb.build('textarea', { label: '说明' }), + ] + expect(fields).toHaveLength(4) + expect(fields[0].__config__.tag).toBe('JnpfInput') + expect(fields[1].__config__.tag).toBe('JnpfSelect') + expect(fields[2].__config__.tag).toBe('JnpfDatePicker') + expect(fields[3].__config__.tag).toBe('JnpfTextarea') + }) +}) diff --git a/tsconfig.json b/tsconfig.json new file mode 100644 index 0000000..326d182 --- /dev/null +++ b/tsconfig.json @@ -0,0 +1,20 @@ +{ + "compilerOptions": { + "target": "ES2022", + "module": "ES2022", + "moduleResolution": "bundler", + "strict": true, + "esModuleInterop": true, + "skipLibCheck": true, + "resolveJsonModule": true, + "allowImportingTsExtensions": true, + "noEmit": true, + "isolatedModules": true, + "verbatimModuleSyntax": false, + "forceConsistentCasingInFileNames": true, + "types": ["node"], + "lib": ["ES2022"] + }, + "include": ["src/**/*", "scripts/**/*", "tests/**/*"], + "exclude": ["node_modules", "screenshots", ".dacli-cache.db"] +} diff --git a/vitest.config.ts b/vitest.config.ts new file mode 100644 index 0000000..fa9648d --- /dev/null +++ b/vitest.config.ts @@ -0,0 +1,14 @@ +/** + * vitest.config.ts + */ +import { defineConfig } from 'vitest/config' + +export default defineConfig({ + test: { + include: ['tests/unit/**/*.test.ts'], + exclude: ['node_modules', 'tests/e2e/**'], + testTimeout: 60_000, + pool: 'forks', + poolOptions: { forks: { singleFork: true } }, + }, +})