# 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)