Files
dacli/data/form-type-rules.json
T

141 lines
5.6 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"$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 组件/路由"
}
]
}