Daptin状态机管理：企业级工作流自动化的核心

Daptin状态机管理：企业级工作流自动化的核心

【免费下载链接】daptinDaptin - Backend As A Service - GraphQL/JSON-API Headless CMS项目地址: https://gitcode.com/gh_mirrors/da/daptin

Daptin作为后端即服务（Backend As A Service）平台，提供了强大的状态机管理功能，帮助企业实现复杂工作流的自动化。通过Finite State Machines（FSM），Daptin能够定义记录的有效状态、自动创建状态跟踪表、存储状态机定义并提供高效的状态转换接口，是企业级工作流自动化的核心引擎。

什么是Daptin状态机？

Daptin状态机是基于有限状态机理论实现的工作流管理系统，它允许开发者定义实体的生命周期状态和状态之间的合法转换。这一系统主要通过以下组件实现：

• smd表：存储状态机定义，包括名称、初始状态和事件转换规则
• {tablename}_state表：自动创建的状态跟踪表，记录每个实体实例的当前状态
• HTTP端点：提供状态机启动和状态转换的API接口

Daptin状态机管理界面展示了如何为待办事项启用状态机功能

状态机核心组件与架构

状态机定义表（smd）

状态机定义存储在smd表中，包含以下关键字段：

事件定义格式

事件定义采用JSON格式，描述了状态之间的转换规则：

[ { "name": "approve", "label": "Approve", "color": "#28a745", "src": ["pending"], "dst": "approved" }, { "name": "reject", "label": "Reject", "color": "#dc3545", "src": ["pending"], "dst": "rejected" } ]

每个事件包含：

• name：事件标识符，用于API调用
• label：UI显示名称
• color：UI渲染颜色
• src：有效的源状态数组
• dst：转换后的目标状态

快速上手：创建你的第一个状态机

步骤1：定义状态机

通过YAML定义一个订单工作流状态机：

StateMachineDescriptions: - Name: order_workflow Label: Order Workflow InitialState: pending Events: - Name: confirm Label: Confirm Order Src: [pending] Dst: confirmed - Name: ship Label: Ship Order Src: [confirmed] Dst: shipped - Name: deliver Label: Mark Delivered Src: [shipped] Dst: delivered - Name: cancel Label: Cancel Order Src: [pending, confirmed] Dst: cancelled

步骤2：启用状态跟踪

在表定义中启用状态跟踪：

Tables: - TableName: order IsStateTrackingEnabled: true Columns: - Name: customer_name DataType: varchar(200) ColumnType: label - Name: total DataType: decimal ColumnType: measurement

当IsStateTrackingEnabled设为true时，Daptin会自动创建order_state表来跟踪订单状态。

步骤3：使用API管理状态

启动状态机实例

# 获取状态机定义ID SMD_ID=$(curl -s http://localhost:6336/api/smd \ -H "Authorization: Bearer $TOKEN" | jq -r '.data[0].id') # 为订单启动状态机 curl -X POST "http://localhost:6336/track/start/$SMD_ID" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"typeName":"order","referenceId":"订单ID"}'

应用状态转换

# 确认订单 curl -X POST "http://localhost:6336/track/event/order/状态实例ID/confirm" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{}' # 发货 curl -X POST "http://localhost:6336/track/event/order/状态实例ID/ship" \ -H "Authorization: Bearer $TOKEN" \ -d '{}'

状态机可视化与监控

Daptin状态机可以通过Mermaid语法可视化，帮助开发者理解和设计工作流程：

你可以使用API获取状态机定义并自动生成可视化代码：

const smd = await fetch('/api/smd/ORDER_WORKFLOW_ID').then(r => r.json()); const events = JSON.parse(smd.data.attributes.events); let mermaid = 'stateDiagram-v2\n'; mermaid += ` [*] --> ${smd.data.attributes.initial_state}\n`; events.forEach(e => { e.src.forEach(src => { mermaid += ` ${src} --> ${e.dst}: ${e.name}\n`; }); });

企业级应用最佳实践

权限控制

状态机操作需要适当的权限控制，只有授权用户才能：

• 创建状态机定义
• 启动状态机实例
• 应用状态转换

通过设置smd表的权限，可以精确控制谁能执行这些操作。

审计跟踪

Daptin自动跟踪所有状态转换：

• 每次转换增加版本号
• 创建状态审计记录
• 发布事件到PubSub主题

与自定义操作结合

对于复杂工作流，可以将状态机与自定义操作结合使用：

1. 在状态转换后触发自定义操作
2. 使用操作检查业务规则后再允许状态转换
3. 结合定时任务自动触发状态转换

常见问题与解决方案

问题：无法启动状态机

错误信息：refer object not allowed

解决方案：检查用户对smd表的"refer"权限，确保有足够权限引用状态机定义。

问题：状态转换失败

错误信息：event 'ship' inappropriate in current state 'pending'

解决方案：检查当前状态和事件定义，确保从当前状态可以执行该事件。使用以下命令查看有效转换：

curl "http://localhost:6336/api/smd" \ -H "Authorization: Bearer $TOKEN" | \ jq -r '.data[0].attributes.events' | \ jq -r '.[] | "\(.name): \(.src | join(", ")) -> \(.dst)"'

总结

Daptin状态机管理为企业提供了强大而灵活的工作流自动化解决方案。通过简单的定义和配置，你可以实现复杂的业务流程自动化，提高工作效率并减少人为错误。无论是订单处理、内容审核还是客户服务流程，Daptin状态机都能成为你业务自动化的核心引擎。

要了解更多关于Daptin状态机的技术细节，请参考wiki/State-Machines.md文档。

【免费下载链接】daptinDaptin - Backend As A Service - GraphQL/JSON-API Headless CMS项目地址: https://gitcode.com/gh_mirrors/da/daptin