Merge pull request #34 from codingapi/dev

update md

Author: xlorne

CLAUDE.md

@@ -59,13 +59,16 @@ pnpm run dev:app-pc
 ### Frontend Structure
 
 - **apps/app-pc** - PC client application
+- **apps/app-mobile** - Mobile client application (in development)
 - **packages/flow-design** - Flow designer component library using @flowgram.ai fixed-layout-editor
+- **packages/flow-core** - Core API library with HTTP client and service interfaces
+- **packages/flow-types** - TypeScript type definitions for the entire frontend
   - `pages/design-panel/types.ts` - TypeScript interfaces for Workflow, FlowNode, FlowForm
   - `FlowNode.blocks?: FlowNode[]` - Child nodes for hierarchical structure
   - `FlowNode.strategies` - Node strategies configuration
   - `FlowNode.actions` - Node actions configuration
 
-Note: `app-mobile`, `flow-pc`, and `flow-mobile` are planned but not yet implemented.
+Note: `app-mobile` is currently in development. `flow-pc` and `flow-mobile` packages are planned but not yet implemented.
 
 ### Data Structure: Blocks vs Edges
 
@@ -105,6 +108,8 @@ The workflow engine is organized into 8 layers:
 
 4. **Record Layer** (`com.codingapi.flow.record`)
    - `FlowRecord` - Execution record with states (TODO/DONE, RUNNING/FINISH/ERROR/DELETE)
+   - `FlowTodoRecord` - Todo record for pending tasks
+   - `FlowTodoMerge` - Todo merge record for aggregation
    - Tracks processId, nodeId, currentOperatorId, formData, parallel branch info
 
 5. **Session Layer** (`com.codingapi.flow.session`)
@@ -116,12 +121,13 @@ The workflow engine is organized into 8 layers:
    - `OperatorManager` - Manages node operators
    - `NodeStrategyManager` - Manages node strategies, provides `loadOperators()`, `generateTitle()`, `verifySession()`, `getTimeoutTime()`, `isDone()`
    - `WorkflowStrategyManager` - Manages workflow strategies
+   - `FlowNodeManager` - Node management functionality
    - `FlowNodeState` - Classifies nodes as block nodes or branch nodes for traversal
    - `FlowNodeEdgeManager` - Traverses hierarchical node structure via blocks to find next nodes
 
 7. **Strategy Layer** (`com.codingapi.flow.strategy`)
    - `INodeStrategy` - Interface with `copy()`, `getId()`, `strategyType()`
-   - **Node strategies** (14 types): MultiOperatorAuditStrategy, TimeoutStrategy, SameOperatorAuditStrategy, RecordMergeStrategy, ResubmitStrategy, AdviceStrategy, OperatorLoadStrategy, ErrorTriggerStrategy, NodeTitleStrategy, FormFieldPermissionStrategy, DelayStrategy, TriggerStrategy, SubProcessStrategy, RevokeStrategy
+   - **Node strategies** (16 types): MultiOperatorAuditStrategy, TimeoutStrategy, SameOperatorAuditStrategy, RecordMergeStrategy, ResubmitStrategy, AdviceStrategy, OperatorLoadStrategy, ErrorTriggerStrategy, NodeTitleStrategy, FormFieldPermissionStrategy, DelayStrategy, TriggerStrategy, RouterStrategy, SubProcessStrategy, RevokeStrategy
    - **Workflow strategies** (2 types): InterfereStrategy, UrgeStrategy
 
 8. **Script Layer** (`com.codingapi.flow.script.runtime`)
@@ -133,7 +139,7 @@ The workflow engine is organized into 8 layers:
 - **Common Interfaces** (`com.codingapi.flow.common`)
    - `ICopyAbility` - Interface for copy capability (used by strategies and actions)
    - `IMapConvertor` - Interface for Map conversion (used by strategies and actions)
-- **Repository Pattern** (`com.codingapi.flow.repository`) - Abstraction for data persistence, isolates framework from implementation. Implementations are in `flow-engine-starter-infra` under `com.codingapi.flow.infra.repository.impl`. Access via `RepositoryHolderContext` singleton. Pattern: Interface in framework, implementation in infra using JPA entities and convertors.
+- **Repository Pattern** (`com.codingapi.flow.repository`) - Abstraction for data persistence, isolates framework from implementation. Includes: WorkflowRepository, FlowRecordRepository, WorkflowBackupRepository, ParallelBranchRepository, DelayTaskRepository, UrgeIntervalRepository, FlowTodoRecordRepository, FlowTodoMergeRepository. Implementations are in `flow-engine-starter-infra` under `com.codingapi.flow.infra.repository.impl`. Access via `RepositoryHolderContext` singleton. Pattern: Interface in framework, implementation in infra using JPA entities and convertors.
 - **Gateway Pattern** (`com.codingapi.flow.gateway`) - Anti-corruption layer for external system integration (operators, users). Access via `GatewayContext` singleton.
 - **Domain Objects** (`com.codingapi.flow.domain`) - DelayTask, DelayTaskManager, UrgeInterval
 - **Event System** (`com.codingapi.flow.event`) - 5 event types: FlowRecordStartEvent, FlowRecordTodoEvent, FlowRecordDoneEvent, FlowRecordFinishEvent, FlowRecordUrgeEvent
@@ -156,6 +162,9 @@ When a node is executed, methods are called in this order:
 **FlowActionService** (executing an action):
 1. Validate request → Validate operator → Get record → Validate state → Load workflow → Get current node → Get action → Build form data → Create session → Verify session → Execute action
 
+**FlowDetailService** (querying workflow details):
+1. Fetch workflow details by processId → Include workflow definition, current records, form data
+
 **PassAction.run()** (typical action):
 1. Check if node done (StrategyManager) → Update current record → Generate subsequent records → Trigger next nodes → Save records → Push events
 

Design.md

@@ -306,7 +306,7 @@ Workflow
 
 #### 策略类型
 
-**节点策略 (14种)**:
+**节点策略 (16种)**:
 
 | 策略类 | 说明 |
 |-------|------|
@@ -322,6 +322,7 @@ Workflow
 | FormFieldPermissionStrategy | 表单字段权限策略 |
 | DelayStrategy | 延迟策略 |
 | TriggerStrategy | 触发策略 |
+| RouterStrategy | 路由策略 |
 | SubProcessStrategy | 子流程策略 |
 | RevokeStrategy | 撤回策略（REVOKE_NEXT撤回下级/REVOKE_CURRENT撤回到当前节点） |
 

PRD.md

@@ -176,12 +176,16 @@ Flow Engine 是一个企业级流程引擎，支持可视化流程设计、动
 ### 3.1 扩展能力
 
 - **自定义脚本**: 支持 Groovy 脚本扩展
-  - 发起人匹配脚本
-  - 审批人加载脚本
-  - 节点标题脚本
-  - 条件判断脚本
-  - 异常触发脚本
-  - 拒绝动作脚本
+  - 发起人匹配脚本 (OperatorMatchScript)
+  - 审批人加载脚本 (OperatorLoadScript)
+  - 节点标题脚本 (NodeTitleScript)
+  - 条件判断脚本 (ConditionScript)
+  - 路由节点脚本 (RouterNodeScript)
+  - 子流程脚本 (SubProcessScript)
+  - 触发器脚本 (TriggerScript)
+  - 异常触发脚本 (ErrorTriggerScript)
+  - 拒绝动作脚本 (RejectActionScript)
+  - 自定义动作脚本 (CustomScript)
 
 - **自定义节点**: 支持扩展新的节点类型
 

README.md

@@ -89,6 +89,8 @@ flow-engine
 │       │   ├── ActionManager     # 动作管理器
 │       │   ├── NodeStrategyManager # 节点策略管理器
 │       │   ├── OperatorManager   # 操作者管理器
+│       │   ├── FlowNodeManager  # 节点管理器
+│       │   ├── FlowNodeState    # 节点状态分类
 │       │   └── WorkflowStrategyManager # 工作流策略管理器
 │       ├── node                  # 节点层
 │       │   ├── nodes             # 节点实现（15种）
@@ -111,6 +113,7 @@ flow-engine
 │       │   ├── helper            # 节点助手
 │       │   │   ├── BackNodeHelper           # 退回节点助手
 │       │   │   └── ParallelNodeRelationHelper # 并行关系助手
+│       │   ├── IBlockNode       # 块节点接口
 │       │   ├── BaseFlowNode      # 节点抽象基类
 │       │   ├── BaseAuditNode     # 审批节点抽象基类
 │       │   ├── IFlowNode         # 节点接口
@@ -119,20 +122,27 @@ flow-engine
 │       │   └── IFlowOperator     # 操作者接口
 │       ├── pojo                  # 数据对象
 │       │   ├── body              # FlowAdviceBody 请求体
-│       │   └── request           # 请求对象
-│       │       ├── FlowActionRequest  # 动作请求
-│       │       ├── FlowCreateRequest  # 创建请求
-│       │       ├── FlowRevokeRequest  # 撤回请求
-│       │       └── FlowUrgeRequest    # 催办请求
+│       │   ├── request           # 请求对象
+│       │   │   ├── FlowActionRequest  # 动作请求
+│       │   │   ├── FlowCreateRequest  # 创建请求
+│       │   │   ├── FlowRevokeRequest  # 撤回请求
+│       │   │   └── FlowUrgeRequest    # 催办请求
+│       │   └── response          # 响应对象
+│       │       ├── FlowOperator   # 流程操作者
+│       │       └── FlowContent   # 流程内容
 │       ├── record                # 流程记录
-│       │   └── FlowRecord        # 执行记录（TODO/DONE状态）
+│       │   ├── FlowRecord        # 执行记录（TODO/DONE状态）
+│       │   ├── FlowTodoRecord    # 待办记录
+│       │   └── FlowTodoMerge     # 待办合并记录
 │       ├── repository            # 仓储接口（持久化抽象）
 │       │   ├── WorkflowRepository
 │       │   ├── FlowRecordRepository
 │       │   ├── WorkflowBackupRepository
 │       │   ├── ParallelBranchRepository
 │       │   ├── DelayTaskRepository
-│       │   └── UrgeIntervalRepository
+│       │   ├── UrgeIntervalRepository
+│       │   ├── FlowTodoRecordRepository
+│       │   └── FlowTodoMergeRepository
 │       ├── script                # 脚本系统
 │       │   ├── node              # 节点脚本（8种）
 │       │   │   ├── OperatorMatchScript  # 发起人匹配脚本
@@ -156,12 +166,13 @@ flow-engine
 │       │   │   ├── FlowActionService    # 流程动作服务
 │       │   │   ├── FlowDelayTriggerService # 延迟触发服务
 │       │   │   ├── FlowRevokeService    # 流程撤回服务
-│       │   │   └── FlowUrgeService      # 流程催办服务
+│       │   │   ├── FlowUrgeService      # 流程催办服务
+│       │   │   └── FlowDetailService   # 流程详情服务
 │       │   └── FlowService       # 服务接口
 │       ├── session               # 会话层
 │       │   ├── FlowSession       # 执行上下文
 │       │   └── FlowAdvice        # 审批参数（意见、签名、退回节点等）
-│       ├── strategy              # 策略层（16种：14种节点策略 + 2种工作流策略）
+│       ├── strategy              # 策略层（18种：16种节点策略 + 2种工作流策略）
 │       │   ├── node                # 节点策略
 │       │   │   ├── MultiOperatorAuditStrategy  # 多人审批策略
 │       │   │   ├── TimeoutStrategy          # 超时策略
@@ -175,6 +186,7 @@ flow-engine
 │       │   │   ├── FormFieldPermissionStrategy # 字段权限策略
 │       │   │   ├── DelayStrategy            # 延迟策略
 │       │   │   ├── TriggerStrategy          # 触发策略
+│       │   │   ├── RouterStrategy          # 路由策略
 │       │   │   ├── SubProcessStrategy       # 子流程策略
 │       │   │   ├── RevokeStrategy           # 撤回策略
 │       │   │   ├── NodeStrategyFactory      # 节点策略工厂
@@ -198,9 +210,12 @@ flow-engine
 ├── flow-engine-example           # 示例项目
 └── frontend                      # 前端项目
     ├── apps
-    │   └── app-pc                # PC端应用
+    │   ├── app-pc                # PC端应用
+    │   └── app-mobile            # 移动端应用（开发中）
     └── packages
-        └── flow-design           # 流程设计器
+        ├── flow-design           # 流程设计器组件库
+        ├── flow-core            # 核心 API 库
+        └── flow-types           # TypeScript 类型定义库
 ```
 
 ## 技术栈

TODO.md

@@ -83,6 +83,7 @@
 | FormFieldPermissionStrategy | ✅ | 表单字段权限策略 |
 | DelayStrategy | ✅ | 延迟策略（支持秒/分钟/小时/天） |
 | TriggerStrategy | ✅ | 触发策略 |
+| RouterStrategy | ✅ | 路由策略 |
 | SubProcessStrategy | ✅ | 子流程策略 |
 | RevokeStrategy | ✅ | 撤回策略（撤回下级/撤回到当前节点） |
 | InterfereStrategy | ✅ | 干预策略（工作流级别） |

frontend/apps/app-mobile/README.md

@@ -1,36 +1,67 @@
-# Rsbuild project
+# Flow Engine 移动端应用
+
+Flow Engine 的移动端流程管理应用（开发中）。
+
+## 简介
+
+`app-mobile` 是 Flow Engine 的移动端 Web 应用，将提供简化的移动操作界面。
+
+> **注意**: 此应用目前处于开发阶段，功能尚未完整实现。
+
+### 核心依赖
+
+- `@flow-engine/flow-core` - 核心 API 库
+- `@flow-engine/flow-types` - TypeScript 类型定义
+- `antd` - Ant Design 组件库（移动端适配）
+- `react-router` + `react-router-dom` - 路由管理
 
 ## Setup
 
-Install the dependencies:
+安装依赖:
 
 ```bash
 pnpm install
 ```
 
-## Get started
+## 开发
 
-Start the dev server, and the app will be available at [http://localhost:3000](http://localhost:3000).
+启动开发服务器，应用将在 [http://localhost:3000](http://localhost:3000) 访问。
 
 ```bash
 pnpm run dev
 ```
 
-Build the app for production:
+## 构建
+
+构建生产版本:
 
 ```bash
 pnpm run build
 ```
 
-Preview the production build locally:
+预览生产构建:
 
 ```bash
 pnpm run preview
 ```
 
-## Learn more
+## 计划功能
+
+### 移动端优化
+
+- 响应式设计适配移动设备
+- 触摸优化的交互体验
+- 简化的流程处理界面
 
-To learn more about Rsbuild, check out the following resources:
+### 核心功能
+
+- 待办任务列表
+- 流程审批操作
+- 流程进度查看
+- 消息通知
+
+## Learn more
 
-- [Rsbuild documentation](https://rsbuild.rs) - explore Rsbuild features and APIs.
-- [Rsbuild GitHub repository](https://github.com/web-infra-dev/rsbuild) - your feedback and contributions are welcome!
+- [Rsbuild documentation](https://rsbuild.rs) - Rsbuild 特性和 API
+- [Rspack documentation](https://rspack.rs) - 底层打包工具
+- [Flow Engine Docs](https://github.com/codingapi/flow-engine) - 完整文档

frontend/apps/app-pc/README.md

@@ -1,36 +1,77 @@
-# Rsbuild project
+# Flow Engine PC 端应用
+
+Flow Engine 的 PC 端流程管理应用。
+
+## 简介
+
+`app-pc` 是 Flow Engine 的 PC 端 Web 应用，提供完整的流程管理功能。
+
+### 核心依赖
+
+- `@flow-engine/flow-design` - 流程设计器组件库
+- `@flow-engine/flow-core` - 核心 API 库
+- `@flow-engine/flow-types` - TypeScript 类型定义
+- `antd` - Ant Design 组件库
+- `react-router` + `react-router-dom` - 路由管理
 
 ## Setup
 
-Install the dependencies:
+安装依赖:
 
 ```bash
 pnpm install
 ```
 
-## Get started
+## 开发
 
-Start the dev server, and the app will be available at [http://localhost:3000](http://localhost:3000).
+启动开发服务器，应用将在 [http://localhost:3000](http://localhost:3000) 访问。
 
 ```bash
 pnpm run dev
 ```
 
-Build the app for production:
+## 构建
+
+构建生产版本:
 
 ```bash
 pnpm run build
 ```
 
-Preview the production build locally:
+预览生产构建:
 
 ```bash
 pnpm run preview
 ```
 
-## Learn more
+## 核心功能
 
-To learn more about Rsbuild, check out the following resources:
+### 流程设计
+
+- 可视化流程设计器
+- 15 种节点类型支持
+- 节点配置面板
+- 表单设计
+- 高级设置
+
+### 流程管理
+
+- 流程定义管理
+- 流程实例管理
+- 待办/已办列表
+- 流程历史记录
+
+### 流程操作
+
+- 通过/拒绝审批
+- 保存草稿
+- 加签/委派
+- 退回/转办
+- 流程撤回
+
+## Learn more
 
-- [Rsbuild documentation](https://rsbuild.rs) - explore Rsbuild features and APIs.
-- [Rsbuild GitHub repository](https://github.com/web-infra-dev/rsbuild) - your feedback and contributions are welcome!
+- [Rsbuild documentation](https://rsbuild.rs) - Rsbuild 特性和 API
+- [Rspack documentation](https://rspack.rs) - 底层打包工具
+- [Flow Engine Docs](https://github.com/codingapi/flow-engine) - 完整文档
+- [AGENTS.md](./AGENTS.md) - 开发指南