141 lines
5.6 KiB
JSON
141 lines
5.6 KiB
JSON
{
|
||
"$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=<wfId>,且 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=<id> 或传 '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 组件/路由"
|
||
}
|
||
]
|
||
}
|