{ "$schema": "form-type-rules/v1", "_meta": { "extractedFrom": "web/apps/jnpf-web-apps-main/src/views/onlineDev/", "extractedAt": "2026-06-22", "purpose": "AI 决策树: type × webType × enableFlow 合法组合 + 默认参数", "ruleOfAuthority": "dacli 文档与本文件冲突时,以本文件为准(数据从 web/ 源码提取)", "sourceFiles": { "formDesign_Form_vue": "web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/Form.vue", "sysForm_Form_vue": "web/apps/jnpf-web-apps-main/src/views/onlineDev/sysForm/Form.vue" } }, "typeRules": [ { "type": 1, "webType": 1, "name": "普通表单", "description": "仅表单(无列表)", "needsPhysicalTable": true, "canRelease": true, "clonePreferred": false, "enableFlowOptions": [false], "defaultDbLinkId": "0", "sourceFile": "views/onlineDev/formDesign/Form.vue", "sourceLine": "formDesign/Form.vue:107-108 (type: 1, webType: 2 默认值; webType=1 需显式切换)" }, { "type": 1, "webType": 2, "name": "流程表单", "description": "表单 + 列表(默认 webType)", "needsPhysicalTable": true, "canRelease": true, "clonePreferred": false, "enableFlowOptions": [false, true], "defaultDbLinkId": "0", "sourceFile": "views/onlineDev/formDesign/Form.vue", "sourceLine": "formDesign/Form.vue:107-108 (type: 1, webType: 2); :189 webType = data.webType || 2" }, { "type": 1, "webType": 3, "name": "流程表单(树)", "description": "表单 + 列表(树形)", "needsPhysicalTable": true, "canRelease": true, "clonePreferred": false, "enableFlowOptions": [true], "defaultDbLinkId": "0", "sourceFile": "views/onlineDev/formDesign/Form.vue", "sourceLine": "formDesign/Form.vue:107-108 (基础); webType=3 需经 toggleWebType 切换" }, { "type": 1, "webType": 4, "name": "数据视图", "description": "仅视图,无物理表(maxStep=1)", "needsPhysicalTable": false, "canRelease": true, "clonePreferred": false, "enableFlowOptions": [false], "defaultDbLinkId": "0", "sourceFile": "views/onlineDev/formDesign/Form.vue", "sourceLine": "formDesign/Form.vue:177, 190 (state.maxStep = state.dataForm.webType == 4 ? 1 : 2)" }, { "type": 2, "webType": 1, "name": "系统表单(报表)", "description": "sysForm 报表(仅展示,无业务表)", "needsPhysicalTable": false, "canRelease": true, "clonePreferred": true, "enableFlowOptions": [false], "defaultDbLinkId": "0", "sourceFile": "views/onlineDev/sysForm/Form.vue", "sourceLine": "sysForm/Form.vue:144-145 (type: 2, webType: 1); :201 setFieldsValue({ type: 2 })" }, { "type": 3, "webType": 1, "name": "接口表单", "description": "sysForm 接口对接(数据来自外部接口)", "needsPhysicalTable": false, "canRelease": true, "clonePreferred": true, "enableFlowOptions": [false], "defaultDbLinkId": "0", "sourceFile": "views/onlineDev/sysForm/Form.vue", "sourceLine": "sysForm/Form.vue:144-145 (基础); type=3 由路由 type 参数指定" }, { "type": 4, "webType": 1, "name": "视图(AI兜底)", "description": "dacli form create 默认 type=4 视图,无物理表,最安全", "needsPhysicalTable": false, "canRelease": true, "clonePreferred": false, "enableFlowOptions": [false], "defaultDbLinkId": "0", "sourceFile": "views/onlineDev/formDesign/Form.vue", "sourceLine": "formDesign/Form.vue:107-108 (基础); dacli/src/commands/form/create.ts:53 默认 type=4" } ], "decisionRules": { "ifNeedsPhysicalTable": "必须先 dacli dm create 建物理表(自动补 9 系统列),再 dacli form create --type=1 --table=X", "ifNoPhysicalTable": "直接 dacli form create --type=4 (默认), 无需 dm create; type=2/3 走 sysForm 路径", "ifClonePreferred": "type=2/3 优先用 dacli form clone 已有模板 (workSystem/developSystem),而非 create", "ifEnableFlowTrue": "必须设置 --enableFlow=1 + --flowId=,且 DB 表必须有 f_flow_task_id 列(dm create 自动补)", "ifWebType4": "type=1 webType=4 → 数据视图,maxStep=1(formDesign/Form.vue:190 自动处理),无物理表", "ifTypeNotInRules": "抛错:未知 type/webType 组合, 提示查本文件 typeRules 列表" }, "commonMistakes": [ { "wrong": "type=1 webType=2(默认)时漏掉 dbLinkId", "right": "dbLinkId 默认从 token 取,但 form create 必须显式 --dbLinkId= 或传 'default' (从 token 解析)" }, { "wrong": "type=2 webType=1(报表)错填 --enableFlow=1", "right": "报表不支持工作流, enableFlowOptions=[false] (本文件 type=2 条目)" }, { "wrong": "type=1 webType=4(视图)调用 dm create 提前建表", "right": "视图无物理表 needsPhysicalTable=false, 禁 dm create (会浪费 + 报错)" }, { "wrong": "type=4 视图用 --autoRelease 期望发布", "right": "type=4 自动跳过 release (create.ts:344-345 注释: 会 400)" }, { "wrong": "type=1 webType=3 树形表单 enableFlow=false", "right": "type=1 webType=3 enableFlowOptions=[true], 树+表单=必绑工作流" }, { "wrong": "把 sysForm 的 type=2 当成 formDesign 的 type=1", "right": "type=1 走 formDesign/Form.vue, type=2 走 sysForm/Form.vue, 是两个独立 Vue 组件/路由" } ] }