用途
该技能用于将已确认的 Make App 功能方案转换为审批导航决策,并让业务表单随运行时配置启用审批新建和流程状态展示。每个应用只保留一个“我的审批”入口,业务对象仍使用自己的记录列表。
主要能力
- 导航生成决策:从方案中提取业务对象、用户实际写入动作及审批处理能力,依据默认生成规则给出“生成或不生成”的业务依据,不依赖简单关键词搜索。
- 运行时审批新建分支:成功取得的 Schema 对象含有效 bpmDefinitionKey 时进入审批新建分支;配置读取失败视为错误态,不等同于未绑定。
- 审批新建字段独立授权:使用 bpm-start-config.fields 的完整字段元数据和 readable/editable,不与普通 IAM 字段集合或 createFields 求交。
- 保存与首次发起分离:普通保存不发起;用户选择保存并发起时,先取得已保存记录 ID,再首次发起。失败恢复不重复创建或上传。
- 流程状态展示:业务列表和详情使用只读系统字段 qfei_process_instance_status 展示流程状态,详情标题后显示状态 Tag。
- 边界保持:已有记录编辑沿用既有合同,不将新建发起字段权限扩展到普通编辑;审批中、退回运行态或明确锁定的记录不得通过普通编辑、快捷编辑或批量入口绕过锁。
使用方式
工作顺序为:先从已确认方案提取业务对象、写入动作和审批处理能力并给出导航决策;再调研宿主导航与路由、Schema 适配、普通新建和详情、字段渲染器、请求层、记录创建/附件/Lookup 链路及测试;随后在现有 UI → Service → Make 调用链中接入,审批配置和保存编排放在 Hook/Service,字段集合与状态转换保持纯逻辑;最后按验证场景先补失败测试,再最小实现,并核对普通新建回归与审批字段授权在 UI/Service 一致。
与其他技能的配合
- makeui:负责 Shell、导航位置、Drawer/手机任务页、现有字段控件及 Tag 外观;本技能决定审批分支和字段来源。
- make-app-permission:负责普通 IAM、应用/对象/操作权限;本技能定义审批新建字段分支,不替换普通权限算法。
- make-app-service:负责 API 合同、适配、缓存隔离、错误和取消;本技能提供 Workflow 发起参数与失败语义。
- make-app-actions:负责普通记录操作入口、预检及批量能力;消费同一锁判断,不复制审批任务动作。
- canvas-table-integration:负责桌面列表的只读系统列;手机沿用卡片,不为状态展示新增表格。
- makedsl:负责业务对象建模;不为流程状态或锁补业务字段,不生成流程定义。
适用场景
适用于 Make App 需求方案确认后新建或迭代项目时,需要判断是否默认生成“我的审批”导航,并实现审批新建、保存并提交、提交并保存、流程状态展示等发起侧适配的场景。也适用于涉及 BPM、bpmDefinitionKey、审批新建字段、流程状态及详情标题审批标识的项目。
限制
本期交付范围仅包括导航生成决策及宿主入口、审批新建字段、保存/首次发起、业务列表和详情的流程状态字段、详情标题后的状态 Tag。撤销/撤回按钮与接口、我的审批 npm 包安装升级、任务列表/办理详情、审批意见与动作、审批历史及流程图均不在本期。已有任务中心只接回现有路由;没有任务中心时按默认生成规则保留真实能力边界,不复制页面或添加未经核验的 npm API。方案未说明是否存在写入/审批能力时,只确认缺失事实,不擅自补功能;仅审批处理、没有新建页的方案不新增业务新建功能。