From 6d7b176fa28a5ef4eb81f0b3f785b62c44b3b202 Mon Sep 17 00:00:00 2001 From: ssw Date: Fri, 12 Jun 2026 09:24:22 +0800 Subject: [PATCH] auto(1dc9423ac708): session end @ 2026-06-12T09:23:51 (+1f) --- docs/dacli/2/java-web-cross-ref.md | 196 ----------------------------- 1 file changed, 196 deletions(-) delete mode 100644 docs/dacli/2/java-web-cross-ref.md diff --git a/docs/dacli/2/java-web-cross-ref.md b/docs/dacli/2/java-web-cross-ref.md deleted file mode 100644 index 7334dfc..0000000 --- a/docs/dacli/2/java-web-cross-ref.md +++ /dev/null @@ -1,196 +0,0 @@ -# v13 Java Builder ↔ JNPF Web 代码 速查对照表 - -> **用途**: 后续 v14 维护/扩展时, 找 Java builder 对应的前端 Rxxx.vue / componentMap.ts 行号 -> **生成**: 2026-06-12 (v13.25 完成 53 FieldBuilder + 5 menu builder + 4 特殊 builder) -> **状态**: 100% 覆盖 (53 控件 + 7 特殊 builder 全部映射到前端 source) - -## 1. 目录结构总览 - -``` -boot/ssw-dacli/src/main/java/ssw/dacli/ -├── form/builder/ -│ ├── FieldBuilder.java (接口) -│ ├── FieldBuilderFactory.java (SPI 工厂) -│ ├── FieldBuildContext.java (字段定义上下文) -│ ├── field/ (53 FieldBuilder) -│ ├── column/ (ColumnDataBuilder) -│ ├── table/ (SubTableFieldBuilder) -│ ├── flow/ (FlowTemplateJsonBuilder) -│ ├── system/ (SystemColumnBuilder) -│ └── reverse/ (FormReverseDebugger + Report) -└── menu/builder/ - ├── MenuBuilder.java (接口) - ├── MenuBuilderFactory.java (SPI 工厂) - ├── MenuBuildContext.java - ├── PropertyJsonBuilder.java (共享) - ├── AuthorizeFieldsBuilder.java (共享) - ├── WebMenuBuilder.java - ├── NoSpaMenuBuilder.java - ├── DataReportMenuBuilder.java - ├── LinkMenuBuilder.java - ├── ButtonMenuBuilder.java - └── reverse/ (MenuReverseDebugger + Report) -``` - -## 2. Java FieldBuilder ↔ JNPF Rxxx.vue 完整对照 (53 个) - -> **命名规则**: `FieldBuilder` ↔ `R.vue` (PascalCase) -> **字段源**: 优先 `Rxxx.vue` (运行时真实 schema), 次选 `componentMap.ts` (设计器 schema) - -### 2.1 v13.1-13.22 (28 P0/P1/P2 字段集) - -| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 | -|---|------------------|---------|---------------|---------------------|---------| -| 1 | `InputFieldBuilder` | input | `RInput.vue` | line 1130+ | 43 字段 (21+22) | -| 2 | `InputNumberFieldBuilder` | inputNumber | `RInputNumber.vue` | line 1220+ | 33 字段 | -| 3 | `TextareaFieldBuilder` | textarea | `RTextarea.vue` | line 2080+ | 29 字段 | -| 4 | `DatePickerFieldBuilder` | datePicker | `RDatePicker.vue` | line 1840+ | 37 字段 | -| 5 | `TimePickerFieldBuilder` | timePicker | `RTimePicker.vue` | line 2030+ | 37 字段 | -| 6 | `UploadFileFieldBuilder` | uploadFile | `RUploadFile.vue` | line 2165+ | 36 字段 | -| 7 | `UploadImgFieldBuilder` | uploadImg | `RUploadImg.vue` | line 2200+ | 36 字段 | -| 8 | `RelationFormFieldBuilder` | relationForm | `RRelationForm/` | line 1175+ | 44 字段 (两阶段) | -| 9 | `PopupTableFieldBuilder` | popupTable | `Jnpf/popupTable/` | line 1400+ | 45 字段 (两阶段) | -| 10 | `PopupSelectFieldBuilder` | popupSelect | `RPopupSelect.vue` | line 1440+ | 中 | -| 11 | `PopupAttrFieldBuilder` | popupAttr | `RPopupAttr.vue` | line 1480+ | 中 | -| 12 | `RelationFormAttrFieldBuilder` | relationFormAttr | `RRelationFormAttr.vue` | line 1280+ | 中 | -| 13 | `RelationQueryFieldBuilder` | relationQuery | `RRelationQuery/` | line 1320+ | 中 | -| 14 | `AutoCompleteFieldBuilder` | autoComplete | `RAutoComplete.vue` | line 1240+ | 32 字段 | -| 15 | `InputTableFieldBuilder` | inputTable | `Jnpf/InputTable/` | line 1380+ | 40 字段 | -| 16 | `OrganizeFieldBuilder` | organize | `Jnpf/organize/` | line 1450+ | 中 | -| 17 | `LocationFieldBuilder` | location | `Jnpf/location/` | line 1340+ | 中 | -| 18 | `AreaSelectFieldBuilder` | areaSelect | `RAreaSelect.vue` | line 1610+ | 中 | -| 19 | `SignatureFieldBuilder` | signature | `Jnpf/signature/` | line 1800+ | 中 | -| 20 | `SignFieldBuilder` | sign | `Jnpf/sign/` | line 1820+ | 中 | -| 21 | `OcrFieldBuilder` | ocr | `Jnpf/ocr/` | line 1680+ | 中 | -| 22 | `CalculateFieldBuilder` | calculate | `Jnpf/calculate/` | line 1650+ | 中 | -| 23 | `DateCalculateFieldBuilder` | dateCalculate | `Jnpf/dateCalculate/` | line 1740+ | 中 | -| 24 | `I18nInputFieldBuilder` | i18nInput | `Jnpf/i18nInput/` | line 1270+ | 中 | -| 25 | `CarouselFieldBuilder` | carousel | `Jnpf/carousel/` | line 887+ | 中 (4 P2 装饰) | -| 26 | `ColorPickerFieldBuilder` | colorPicker | `RColorPicker.vue` | line 604+ | 中 | -| 27 | `RateFieldBuilder` | rate | `RRate.vue` | line 631+ | 低 | -| 28 | `SliderFieldBuilder` | slider | `RSlider.vue` | line 661+ | 低 | - -### 2.2 v13.23 P0 7 盲点 (完整字段集) - -| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 | -|---|------------------|---------|---------------|---------------------|---------| -| 29 | `SelectFieldBuilder` | select | `RSelect.vue` | line 324 | 44 字段 (19+25) | -| 30 | `UserSelectFieldBuilder` | userSelect | `Jnpf/userSelect/` | line 1026 | 35 字段 (15+20) | -| 31 | `GroupTitleFieldBuilder` | groupTitle | `RGroupTitle.vue` | line 1910 | 18 字段 (5+13) | -| 32 | `RadioFieldBuilder` | radio | `RRadio.vue` | line 221 | 47 字段 (18+29) | -| 33 | `DividerFieldBuilder` | divider | `RDivider.vue` | line 1931 | 16 字段 (4+12) | -| 34 | `TableGridFieldBuilder` | tableGrid | `RTableGrid.vue` + `RTableGridTd.vue` | line 2114 | 17+ 字段 (嵌套 tr/td) | -| 35 | `CascaderFieldBuilder` | cascader | `RCascader.vue` | line 377 | 44 字段 (18+26) | - -### 2.3 v13.24 P1 11 控件 (完整字段集) - -| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 | -|---|------------------|---------|---------------|---------------------|---------| -| 36 | `CheckboxFieldBuilder` | checkbox | `RCheckbox.vue` | line 274 | 40 字段 (14+26) | -| 37 | `SwitchFieldBuilder` | switch | `RSwitch.vue` | line 189 | 29 字段 (6+23) | -| 38 | `EditorFieldBuilder` | editor | `REditor.vue` | line 692 | 28 字段 (5+23) | -| 39 | `TreeSelectFieldBuilder` | treeSelect | `RTreeSelect.vue` | line 1190 | 47 字段 (22+25) | -| 40 | `IframeFieldBuilder` | iframe | `RIframe.vue` | line 1596 | 24 字段 (5+19) | -| 41 | `StepsFieldBuilder` | steps | `RSteps.vue` | line 2032 | 24 字段 (5+19) | -| 42 | `RowFieldBuilder` | row | `RRow.vue` | line 2074 | 16 字段 (3+13) | -| 43 | `TabFieldBuilder` | tab | `RTab.vue` | line 1992 | 19 字段 (5+14) | -| 44 | `OrgRightFieldBuilder` | orgRight | `ROrgRight.vue` | line 954 | 38 字段 (16+22) | -| 45 | `LinkFieldBuilder` | link | `RLink.vue` | line 719 | 21 字段 (7+14) | -| 46 | `QrcodeFieldBuilder` | qrcode | `RQrcode.vue` | line 831 | 23 字段 (9+14) | - -### 2.4 v13.25 P2 7 装饰 (layout="rowFormItem") - -| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 | -|---|------------------|---------|---------------|---------------------|---------| -| 47 | `AlertFieldBuilder` | alert | `RAlert.vue` | line 806 | 20 字段 (6+14) | -| 48 | `BarcodeFieldBuilder` | barcode | `RBarcode.vue` | line 858 | 21 字段 (7+14) | -| 49 | `BillRuleFieldBuilder` | billRule | `RBillRule.vue` | line 1876 | 21 字段 (3+18, tag='JnpfInput') | -| 50 | `ButtonFieldBuilder` | button | `RButton.vue` | line 747 | 21 字段 (4+17) | -| 51 | `CardFieldBuilder` | card | `RCard.vue` | line 2093 | 15 字段 (2+13, tag='ACard') | -| 52 | `CollapseFieldBuilder` | collapse | `RCollapse.vue` | line 1951 | 18 字段 (4+14, tag='ACollapse') | -| 53 | `TextFieldBuilder` | text | `RText.vue` | line 776 | 18 字段 (2+16, textStyle 7 字段) | - -## 3. Java 特殊 Builder ↔ JNPF 后端 (4 个) - -> 这些是辅助 builder, 不是 SPI 注册的 FieldBuilder - -| # | Java Builder | 用途 | 字段源 | 字段统计 | -|---|--------------|------|--------|---------| -| S1 | `ColumnDataBuilder` | 列表列 50+ 字段 | `jnpf/前端/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts` 60 项 jnpfKey→tag 对照 | 53 字段 (31+22) | -| S2 | `SubTableFieldBuilder` | 主子表 (form.items.children) | `RTableGrid.vue` + `RTableGridTd.vue` (子表布局) | 25+ 字段 | -| S3 | `FlowTemplateJsonBuilder` | 工作流模板 (formData.flowTemplateJson) | Flowable BPMN 简化 (start+userTask+end) | 14 字段 | -| S4 | `SystemColumnBuilder` | 11 系统列 (dm create 自动补) | `jnpf/后端/.../visualdev/VisualDevInfoVO.java` + `DmCommand.ensureRuntimeColumns` | 11 字段 (枚举) | -| S5 | `FormReverseDebugger` | form info 反向调试器 | 解析 formData, 定位未打磨 jnpfKey | (无 builder 字段, 仅分析) | -| S6 | `MenuReverseDebugger` | menu info 反向调试器 | 解析 menu JSON, 6 维度校验 | (无 builder 字段, 仅分析) | - -## 4. Java Menu Builder ↔ JNPF Web 完整对照 (5 个) - -> **Menu Builder** 处理 `category`/`type` 字段, 对应 JNPF 后端 `permission/.../Menu` 表 - -| # | Java MenuBuilder | category | type | 前端对应 | JNPF 后端 model | -|---|------------------|----------|------|---------|----------------| -| M1 | `WebMenuBuilder` | Web | 1/2/3 | `jnpf/前端/jnpf-web-apps-main/src/views/menu/components/FormMenu/index.vue` | `VisualDevMenuModel.java` (type 字段) | -| M2 | `NoSpaMenuBuilder` | Web | 7 | 同上 + `linkTarget=_self` | 同上 (type=7) | -| M3 | `DataReportMenuBuilder` | Web/App | 10/8 | `DataReport/portal` 路由 | `DataReportModel.java` | -| M4 | `LinkMenuBuilder` | Web | 7 (外链) | `linkTarget=_blank` | 同 WebMenu | -| M5 | `ButtonMenuBuilder` | Web | 0 | 无 urlAddress | 同 WebMenu | - -**共享 builder**: -- `PropertyJsonBuilder` ↔ `FormMenu/index.vue` 字段 3-4 字段 (moduleId/iconBackgroundColor/isTree/webType) -- `AuthorizeFieldsBuilder` ↔ `jnpf/后端/.../permission/...Menu.java` 4 字段 (isButtonAuthorize/isColumnAuthorize/isDataAuthorize/isFormAuthorize) - -## 5. 字段源优先级 (重要) - -v13.1-13.22 builder (28 个) 字段集来自: -1. **baseline** (40 form JSON): 真实实例 (出现频率高的值) -2. **Rxxx.vue**: 设计器 schema (字段名/类型) -3. **componentMap.ts**: jnpfKey→tag 对照 + 部分 schema - -v13.23-13.25 builder (25 个) 字段集来自: -1. **componentMap.ts** (主源): 设计器 schema 100% 真实 -2. **Rxxx.vue**: 运行时真实 schema (event handlers, props, 字典) -3. **baseline** (辅助): 出现次数标注 - -**v14 维护建议**: -- 改 builder 字段集时, 先看 Rxxx.vue (运行时真实) → componentMap.ts (设计器 schema) → baseline (实例) 三层 -- 不要直接用 v13 简化版字段集 (会导致 v14 补完后, 老 builder 字段集不准) - -## 6. 速查命令 - -```bash -# 1. 找 Java builder 对应 Rxxx.vue -ls boot/ssw-dacli/src/main/java/ssw/dacli/form/builder/field/ | grep "Select" -# → SelectFieldBuilder.java - -# 2. 找 Rxxx.vue 对应 componentMap.ts 行号 -grep -A 1 "jnpfKey.*'select'\|jnpfKey.*'userSelect'" jnpf/前端/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts - -# 3. mvn test 全集 -mvn test -pl ssw-dacli -q -# → 261/261 PASS (v13.25 完成) - -# 4. 浏览器层 E2E 验证 -python3 .claude/skills/ssw-e2e-test/scripts/jnpf_browser_e2e.py verify-form \ - --app=tds --form-id=835013439305819013 \ - --menu-name="数据资产管理" \ - --session=/tmp/v13-tds-session.json \ - --expected-labels=资产编码,资产名称 -# → 7/7 label 0 误差 PASS -``` - -## 7. 总结 - -| 维度 | 数量 | 状态 | -|------|------|------| -| Java FieldBuilder | 53 | ✅ 100% 映射 Rxxx.vue / componentMap.ts | -| Java 特殊 Builder | 6 | ✅ ColumnData/SubTable/Flow/System + 2 Reverse | -| Java MenuBuilder | 5 | ✅ Web/NoSpa/DataReport/Link/Button + 2 共享 | -| **总 builder 文件** | **64** | ✅ 100% 覆盖 JNPF 设计器右栏 50 控件 + Jnpf/ 目录 20 子控件 | -| mvn test | 261/261 PASS | ✅ | -| tds 浏览器层 0 误差 | 7/7 label | ✅ | -| baseline 覆盖率 | 90% → 100% (v13.25) | ✅ | - -**v14 候选**: -- 补 7 字段未覆盖 (worktree 拼装, 离线表等) -- 修 v13.25 冲突遗留 (UserSelectFieldBuilder-output.json) -- 跑 tds 真实业务 E2E (Playwright CRUD 5 forms)