表单二开（使用AI工具）

表单二开通常分为两类：一类是通过在线表单设计器配置流程表单；另一类是开发正式业务表单，把数据落到业务表，再接入 BPM 审批。AI 工具适合帮助完成需求拆解、表结构设计、前后端代码生成、流程接入和字段权限改造。

本文提炼自 商业版 AI 二开指南，聚焦“表单开发”场景。

适用场景

场景	推荐方式
临时审批、轻量申请	使用表单设计器配置流程表单
普通 CRUD 表单	使用代码生成器 + AI 补齐业务逻辑
带审批的业务单据	使用业务表单接入 BPM
多表、明细、附件、状态机	让 AI 先生成开发计划，再分步实现
字段权限改造	先确认数据模型和流程节点，再接入运行时权限

菜单与上下文关系

表单二开是“表单开发”的一级专题，它不是表单设计器的子页面。两者的边界如下：

能力	主要产物	适合交给 AI 的工作
表单设计器	在线表单配置	字段清单、分组、校验、动态属性和节点权限建议
表单二开	代码、SQL、菜单、接口、页面	业务表结构、后端接口、前端页面、流程接入、字段权限接入
字段权限	流程节点配置 + 前端运行时适配	节点权限矩阵、业务表单权限组件改造

如果只是配置轻量流程表单，先看 表单设计器；如果要生成正式业务功能，再使用本文的 AI 二开工作流。

推荐上下文

向 AI 描述需求时，建议明确引用这些资料：

上下文	用途
AGENTS.md	工作区工程规则、日期字段、SQL 归档等约束
ruoyi-office-prompt/全局代码规范.md	前后端通用开发规范
ruoyi-office-prompt/流程表单-代码生成规范.md	带审批业务单据的标准实现方式
ruoyi-office-prompt/流程表单提示词.md	流程单据需求描述模板
相似业务页面目录	让 AI 复用现有页面结构和交互
后端 SaveReqVO / RespVO	确认字段类型、必填和日期格式

提示词范例

轻量流程表单

适合让 AI 帮你整理字段、分组、校验和动态规则，然后由管理员在表单设计器中配置。

请帮我设计一个【费用报销】流程表单，用于在线表单设计器配置。

字段包括：申请部门、报销类型、报销金额、报销事由、附件、明细表。
要求：
1. 输出字段清单、字段 key、组件类型、是否必填、默认值建议。
2. 输出适合在表单设计器中配置的分组和布局建议。
3. 输出审批节点字段权限建议：发起人、部门负责人、财务审批。
4. 如需动态属性，请给出表达式示例。

普通 CRUD 表单

在【ERP】模块新增【物料分类】管理功能：

1. 数据库表包含：分类名称、分类短码、父级分类 ID、状态、排序。
2. 页面使用树形列表，参考 @ruoyi-office-vben/apps/web-antd/src/views/system/dept。
3. 支持新增、修改、删除、导入、导出、批量删除。
4. 请遵守项目代码规范，生成 SQL、后端代码、前端 API、列表页和表单弹窗。

业务流程单据

新增【集中采购单】业务流程单据。

业务背景：一个采购单采购的商品会分配到多个客户销售订单。
要求：
1. 使用业务表单，不使用在线流程表单。
2. 主表保存单据编号、供应商、金额汇总、流程状态、流程实例 ID。
3. 子表包含采购明细和销售分配明细。
4. 接入 BPM，支持保存草稿、提交审批、审批回调、撤回、删除。
5. 参考 @ruoyi-office-prompt/流程表单-代码生成规范.md。
6. 先输出开发计划，不直接改代码。

开发工作流

建议按下面节奏推进，不要一次让 AI 生成所有文件后直接上线：

1. 先让 AI 输出开发计划，确认表结构、流程标识、菜单、页面目录和接口。
2. 生成数据库 SQL，人工审查字段类型、索引、注释和日期字段。
3. 生成后端 DO、Mapper、Service、Controller、VO 和错误码。
4. 生成前端 API、列表页、表单页和字段配置。
5. 生成菜单权限 SQL，放入 ruoyi-office-db/{YYYYMMDD}_update/。
6. 编译、类型检查、页面验证。
7. 配置流程模型，绑定业务表单或流程表单，发布后联调。

业务表单接入 BPM

业务表单需要在流程模型的“表单设计”步骤中选择“业务表单”，并填写提交路由、查看组件，同时按需要关联数据模型。

关键检查点：

检查项	说明
流程标识	必须和后端业务单据枚举或流程定义 key 对齐
提交路由	用户发起或编辑单据时进入的路由
查看组件	待办、已办、我的流程详情中展示的业务组件
状态字段	主表应保存流程状态和流程实例 ID
回调逻辑	流程通过、拒绝、取消后要同步业务单据状态

字段权限接入

字段权限适合处理“审批节点补填字段”“敏感字段隐藏”“发起人和审批人看到不同字段”等场景。

AI 改造业务表单时，应明确要求：

• 表单数据模型已经导入代码生成器。
• 流程模型已关联主表和明细表。
• 前端业务表单接收并传递 fieldPermission、isApproval、viewType、processStatus。
• 审批前保存可编辑字段，拒绝操作不应被非必要业务校验阻塞。

详细配置见 表单字段权限控制。

审查清单

分类	检查项
数据库	表名、字段类型、日期时间格式、索引、租户字段、逻辑删除
后端	分层、权限、校验、错误码、流程提交和回调
前端	API 类型、列表筛选、表单必填、日期格式、按钮权限
BPM	流程 key、表单类型、路由、节点审批人、字段权限
SQL	日期目录、文件头说明、菜单权限、静态数据
验证	编译、类型检查、流程发起、待办审批、状态同步

常见问题

AI 生成的业务表单可以直接上线吗？

不建议直接上线。AI 能快速生成大部分代码，但仍需要人工审查表结构、权限、流程状态、异常处理和页面交互。

什么时候不用在线表单设计器？

只要涉及业务台账、复杂统计、主子表生命周期、附件归档、移动端独立页面或和其他模块深度联动，就优先使用业务表单。

提示词里最容易漏什么？

最容易漏流程标识、业务状态、日期字段格式、菜单权限 SQL、移动端兼容和字段权限接入。复杂表单建议先让 AI 输出计划再实现。