Skip to content
Merged

Dev #75

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions .changeset/merge-approval-active-form.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
"@coding-flow/flow-approval-presenter": patch
"@coding-flow/flow-pc-approval": patch
"@coding-flow/flow-mobile-approval": patch
---

fix: 合并审批查看非首条流程后提交表单数据为空(减签被 formData 必填校验拦截)

- 新增 `ActiveFormAction`(`@coding-flow/flow-approval-presenter`):表单保存/校验动作跟随「当前查看或提交的记录」切换,表单实例未挂载时用记录初始数据兜底,不再提交空 `formData`。
- PC / 移动端审批表单视图改为只注册一个表单动作,并按待办记录记忆化表单实例;此前固定 key 只保留第一条记录的表单实例,查看第二条记录后 `getFieldsValue()` 返回 `{}`,请求被服务端 `Required field formData cannot be empty` 拒绝(减签等动作在合并审批中无法提交)。
- 合并审批查看单条流程时同步切换表单实例,详情接口尚未返回期间提交也不会落到上一条记录的表单上。
- 修复按待办记录缓存表单实例引入的崩溃:`createFormInstance` 内部调用 `Form.useForm()`,本质是 hook 工厂,每次渲染必须按相同顺序、相同次数调用;改为每次渲染都按待办记录调用一次并复用首次创建的实例,避免重渲染时 hook 数量变化抛 `Cannot read properties of undefined (reading 'length')`(`areHookInputsEqual`)。
22 changes: 22 additions & 0 deletions .changeset/reduce-audit-action.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
"@coding-flow/flow-types": patch
"@coding-flow/flow-core": patch
"@coding-flow/flow-approval-presenter": patch
"@coding-flow/flow-pc-form": patch
"@coding-flow/flow-pc-approval": patch
"@coding-flow/flow-mobile-approval": patch
"@coding-flow/flow-design": patch
---

feat: 支持减签动作 REDUCE_AUDIT(codingapi/flow-engine#266、codingapi/flow-frontend#72)

- `ActionType` 增加 `REDUCE_AUDIT`,`actionOptions` 增加「减签」,设计器可配置减签动作。
- PC / 移动端新增减签按钮与提交逻辑,通过 `advice.forwardOperatorIds` 传递被减签人;与加签同构,支持自定义弹框内容与事件总线触发。
- 新增 `ReduceAuditViewPlugin`(`ReduceAuditViewPluginKey`)用于替换减签人员选择视图;默认实现为占位,集成方应列出当前节点的待审批人(不含当前审批人)。
- 设计器新增减签动作配置:仅「减签人员范围」(script),不提供「最大可选人数」。
- `FlowMessageKey.APPROVAL_REDUCE_AUDIT` 增加默认提示文案。

fix: 测试反馈问题(codingapi/flow-frontend#72)

- 合并审批(记录合并)必须先勾选要处理的流程记录才能提交,取消勾选会同步清空选择;此前表单有数据即可绕过校验,导致未选择流程也能通过/拒绝/保存/转办。
- 设计器「相同人员提交配置」未配置时默认展示「手动审批」,与后端未配置时的实际行为一致(issue #224 已移除默认策略,不再显示空值)。
7 changes: 4 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,10 +98,11 @@ React 18、TypeScript 5、pnpm 10、Rsbuild/Rslib(构建)、@rstest/core(

## 开发规范

### 禁止自动提交
### 提交、推送与分支合并

- **未经用户明确要求,任何情况下不得执行 `git commit` / `git push` / `git merge` 操作**
- 所有代码变更需经用户审核后再提交
- **允许执行 `git commit` 与 `git push`**:提交前必须完成本地编译与测试验证,提交信息使用中文并说明改动内容
- **禁止主动合并分支**:不得执行 `git merge`,也不得自行合并或关闭 PR;`dev` / `main` 的合并一律由用户决定
- 推送后保持分支可审核状态,由用户决定是否合并

### 基本规范

Expand Down
7 changes: 4 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,10 +103,11 @@ React 18、TypeScript 5、pnpm 10、Rsbuild/Rslib(构建)、@rstest/core(

## 开发规范

### 禁止自动提交
### 提交、推送与分支合并

- **未经用户明确要求,任何情况下不得执行 `git commit` / `git push` / `git merge` 操作**
- 所有代码变更需经用户审核后再提交
- **允许执行 `git commit` 与 `git push`**:提交前必须完成本地编译与测试验证,提交信息使用中文并说明改动内容
- **禁止主动合并分支**:不得执行 `git merge`,也不得自行合并或关闭 PR;`dev` / `main` 的合并一律由用户决定
- 推送后保持分支可审核状态,由用户决定是否合并

### 基本规范

Expand Down
42 changes: 22 additions & 20 deletions docs/capabilities/flow-approval-presenter/action-factory.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: flow-approval-presenter/action-factory
module: flow-pc-approval / flow-mobile-approval / flow-design(跨包能力)
description: 动作工厂(单例模式),按 ActionType 注册并渲染对应的审批动作组件(Pass/Reject/Save/AddAudit/Delegate/Return/Transfer/Custom)
description: 动作工厂(单例模式),按 ActionType 注册并渲染审批动作组件(9 种,含减签)
status: 已实现
scope: 前端
source: 项目自有
Expand All @@ -13,53 +13,55 @@ content_hash: f7a515768b1b96d57764e598af53346093fa715a56a151c9bef9474c9846aaeb

## 解决什么问题

流程审批支持 8 种动作类型(Pass、Reject、Save、AddAudit、Delegate、Return、Transfer、Custom),每种动作对应不同的 UI 组件和交互逻辑。ActionFactory 通过工厂模式实现:
审批动作按类型映射到不同 React 组件,三端各自注册:

- 按动作类型动态获取对应的 React 组件
- PC 端和移动端各自注册不同的组件实现
- 设计器中也有独立的 ActionFactory 用于配置表单
- 按 `action.type` 动态取组件;
- PC 与移动端组件实现不同;
- 设计器用另一份工厂渲染动作配置表单。

## 如何使用

### 1. PC 端 / 移动端审批组件
### 1. 审批端(PC / 移动端)

```typescript
import { ActionFactory } from "@/components/flow-approval/components/action/factory";

const factory = ActionFactory.getInstance();

// PC 端:获取组件类型
const Component = factory.getFlowActionComponent(action);
// 渲染: <Component action={action} />

// 移动端:直接渲染
factory.render(action); // 返回 JSX
const Component = factory.getFlowActionComponent(action); // PC
factory.render(action); // 移动端
```

### 2. 设计器中的动作表单工厂
### 2. 设计器动作表单

```typescript
import { ActionFactory } from "@/script-components/components/action/components/factory";

const factory = ActionFactory.getInstance();
const FormComponent = factory.getActionForm(actionType);
// 渲染: <FormComponent {...props} />
const FormComponent = ActionFactory.getInstance().getActionForm(actionType);
```

### 3. 支持的动作类型
### 3. 支持的动作类型(9 种)

| ActionType | PC 组件 | 移动端组件 | 设计器表单 |
|------------|---------|-----------|-----------|
| PASS | PassAction | PassAction | - |
| REJECT | RejectAction | RejectAction | RejectActionForm |
| SAVE | SaveAction | SaveAction | - |
| ADD_AUDIT | AddAuditAction | AddAuditAction | AddAuditActionForm |
| REDUCE_AUDIT | ReduceAuditAction | ReduceAuditAction | ReduceAuditActionForm |
| DELEGATE | DelegateAction | DelegateAction | DelegateActionForm |
| RETURN | ReturnAction | ReturnAction | - |
| TRANSFER | TransferAction | TransferAction | TransferActionForm |
| CUSTOM | CustomAction | CustomAction | CustomActionForm |

### 4. 批量能力

| 项 | 说明 |
|---|---|
| 服务端标记 | `actions[].batchable`,缺省视为 `true` |
| 当前为 `false` | `REDUCE_AUDIT`(候选人/目标按流程实例隔离) |
| 前端行为 | 合并列表(`todos.length > 1`)不展示 `batchable=false` 的动作;进入单条流程后展示 |

## 使用实例

- `FlowApprovalActions` 组件通过 ActionFactory 遍历流程节点的动作列表,逐个渲染对应的动作组件
- `CustomAction` 组件通过 ActionFactory(`getFlowActionComponent`)获取 `triggerType` 对应的动作组件
- `FlowApprovalActions` 遍历动作列表,逐个用工厂渲染;
- `CustomAction` 通过 `getFlowActionComponent` 渲染 `triggerType` 对应组件。
1 change: 1 addition & 0 deletions docs/capabilities/flow-core/message-registry.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,7 @@ Toast.show(registry.get(FlowMessageKey.APPROVAL_SAVE, actionCtx));
| `approval.reject` | `操作成功` | 审批驳回 |
| `approval.delegate` | `操作成功` | 委托 |
| `approval.add_audit` | `操作成功` | 加签 |
| `approval.reduce_audit` | `操作成功` | 减签 |
| `approval.transfer` | `操作成功` | 转交 |
| `approval.return` | `操作成功` | 退回 |
| `approval.revoke` | `流程已撤回` | 撤回 |
Expand Down
2 changes: 1 addition & 1 deletion docs/capabilities/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
|------|------|------|------|------|
| [antd/antd](./antd/antd.md) | antd | Ant Design (PC) / Ant Design Mobile (移动端) UI 组件库,提供丰富的预置组件 | 前端 | 框架:Ant Design |
| [flow-approval/sub-process-record](./flow-approval/sub-process-record.md) | flow-approval | PC 与移动端审批时间线中的子流程聚合状态、完成进度和实例明细展示 | 前端 | 项目自有 |
| [flow-approval-presenter/action-factory](./flow-approval-presenter/action-factory.md) | flow-approval-presenter | 动作工厂(单例模式),按 ActionType 注册并渲染对应的审批动作组件(Pass/Reject/Save/AddAudit/Delegate/Ret... | 前端 | 项目自有 |
| [flow-approval-presenter/action-factory](./flow-approval-presenter/action-factory.md) | flow-approval-presenter | 动作工厂(单例模式),按 ActionType 注册并渲染审批动作组件(9 种,含减签) | 前端 | 项目自有 |
| [flow-core/event-bus](./flow-core/event-bus.md) | flow-core | 全局事件总线(单例模式),提供 on/emit/off 发布订阅通信能力 | 前端 | 项目自有 |
| [flow-core/groovy-formatter](./flow-core/groovy-formatter.md) | flow-core | Groovy 脚本格式化与转换工具,提供脚本格式化、标记管理、元数据提取、return 表达式解析等能力 | 前端 | 项目自有 |
| [flow-core/http-client](./flow-core/http-client.md) | flow-core | 基于 axios 封装的 HTTP 客户端,提供请求/响应拦截器、token 自动管理、分页查询、文件下载等能力 | 前端 | 项目自有 |
Expand Down
8 changes: 4 additions & 4 deletions docs/integration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

## 指南列表

| 文档 | 说明 |
|------|------|
| [插件定制机制](./plugin-customization.md) | 框架的全部扩展点与插件体系:内核层(ViewBindPlugin / EventBus / Presenter / HttpClient / FlowMessageRegistry / GroovyScriptConvertorUtil)、审批领域层(FlowApprovalApi / 子视图插件 / ActionInterceptor / DialogContentProvider / AdvicePolicyProvider 审批意见策略 / FormActionContext / maxOperatorCount 选人数限制 / Mock 模式)、PC/移动审批层(布局与动作 key / APPROVAL_ADVICE_VIEW_KEY / ActionFactory / 样式定制)、流程设计器层(FlowNodeRegistry / 设计器视图插件 / 策略机制) |
| [消息提示定制](./message-customization.md) | 如何自定义框架中所有消息提示的文案,包括审批动作、流程设计器、系统消息等 |
| 文档 | 说明 | 主要内容 |
|------|------|----------|
| [插件定制机制](./plugin-customization.md) | 全部扩展点与插件体系 | 内核层:ViewBindPlugin / EventBus / Presenter / HttpClient / FlowMessageRegistry<br>审批层:FlowApprovalApi / 8 个子视图插件 / ActionInterceptor / DialogContentProvider / AdvicePolicyProvider / 合并审批 / Mock<br>PC/移动层:布局与动作 key / ActionFactory / 样式<br>设计器层:FlowNodeRegistry / 视图插件 / 策略 |
| [消息提示定制](./message-customization.md) | 自定义全部消息文案 | 审批动作 / 流程设计器 / 系统消息 |
1 change: 1 addition & 0 deletions docs/integration/message-customization.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,7 @@ registry.register(FlowMessageKey.DESIGN_SCRIPT_COMPILE_FAILED, (data) =>
| `approval.reject` | `操作成功` | 审批驳回 |
| `approval.delegate` | `操作成功` | 委托 |
| `approval.add_audit` | `操作成功` | 加签 |
| `approval.reduce_audit` | `操作成功` | 减签 |
| `approval.transfer` | `操作成功` | 转交 |
| `approval.return` | `操作成功` | 退回 |
| `approval.revoke` | `流程已撤回` | 撤回 |
Expand Down
Loading
Loading