流程引擎

状态机引擎

VortFlow 的核心是 FlowEngine——一个状态机驱动的流程引擎。每种工作项类型有独立的状态定义和流转规则，AI 员工的所有操作都受状态机约束。

需求生命周期

需求的完整生命周期包含 10 个阶段：

阶段	状态标识	关键动作
需求录入	intake	AI 帮助结构化录入
待评审	pending_review	提交给评审人
已评审	reviewed	评审通过，进入产品流程
产品完善	pm_refine	产品经理细化需求、原型
UI 设计	design	设计师完成 UI 设计
拆分估时	breakdown	拆分子任务、估算工时
分配开发	dev_assign	分配开发人员
开发中	in_progress	代码开发
测试中	testing	提测验证
已完成	done	交付完成

任务状态流转

todo → in_progress → done → closed

缺陷状态流转

pending → confirmed → fixing → fixed → closed
                             ↘ rejected

状态机规则

• 只能按预定义路径流转，不允许跳步
• AI 调用 vortflow_update_progress 时自动检查状态合法性
• 非法状态转换会被拒绝并返回提示
• 每次状态变更自动触发通知

通知机制

VortFlow 内置 Notifier，在以下场景自动推送通知：

场景	通知对象	通道
新需求创建	项目成员	IM + WebSocket
状态变更	相关负责人	IM + WebSocket
任务分配	被分配人	IM
Bug 提交	开发负责人	IM
评审请求	评审人	IM

IM 消息聚合

VortFlow 通过 im_aggregator 将短时间内的多条 IM 操作合并通知，避免消息轰炸。

权限控制

VortFlow 定义了 5 个权限点，通过 OpenVort 的 RBAC 体系管理：

权限	说明
vortflow.story	需求管理
vortflow.task	任务管理
vortflow.bug	缺陷管理
vortflow.assign	角色分配
vortflow.admin	VortFlow 管理