webman本身不直接支撑完整oa系统，需补足工作流引擎、权限模型、文档协同等关键能力，否则易卡在“能跑接口却跑不动审批流”阶段；它适合做高性能api网关或核心服务节点，但默认无workflowengine、documentversionmanager及rbac中间件，须自行集成或外挂成熟方案。
Webman 本身不直接支撑完整 OA 系统，但可作为高性能后端服务底座；真正落地需补足工作流引擎、权限模型、文档协同等关键能力，否则容易卡在“能跑接口却跑不动审批流”的阶段。
Webman 能扛住高并发请求，但默认不带 OA 业务逻辑
Webman 是基于 Swoole 的高性能 PHP 框架，启动后常驻内存，HTTP server 层吞吐远高于传统 FPM。它适合做 OA 系统的 API 网关或核心服务节点，比如处理大量待办拉取、消息推送、表单提交。但它的 vendor 里没有 WorkflowEngine、没有 DocumentVersionManager、也不内置 RBAC 权限校验中间件——这些都得自己搭或集成第三方。
- 常见错误现象：用 Webman 写完登录和首页接口，一加审批流程就发现状态流转混乱、驳回后无法回到上一节点
- 使用场景：适合已有成熟 OA 业务模型（如已用过 Activiti 或 Flowable），只需把执行层迁移到 Webman 提升响应速度
- 性能影响：若直接在 Webman 中手写状态机，且未做
cache预热或DB transaction控制，反而比 Laravel + Queue 更容易出现数据不一致
工作流必须外挂或自研状态机，别信“插件一键集成”
Webman 生态里没有类 Camunda 或 Flowable 的原生适配包。所谓“Webman 工作流插件”，多数只是封装了数据库 CRUD 和简单跳转，不支持并行网关、会签、超时自动升级等真实 OA 场景必需特性。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 参数差异：
node_id、next_node、assignee这些字段名看着像流程引擎，实际只是静态配置，无法动态生成分支条件表达式 - 容易踩的坑：用
redis存流程实例 ID，但没做WATCH/MULTI包裹，在多人同时审批同一单据时覆盖操作记录 - 推荐做法：用
Java启一个独立的Flowable REST API服务，Webman 通过curl或guzzle调用；或用PHP实现轻量版状态机，核心逻辑收口在ProcessService::handle()里，强制走事务 + 行锁
文档在线协作不能只靠前端富文本，后端要管版本与冲突
Webman 可以快速返回 WebOffice 或 OnlyOffice 的文档加载 URL，但真正的协同编辑难点在后端：谁改了哪一行、合并冲突怎么判、历史版本怎么存、权限怎么随段落变化——这些 Webman 不管，也管不了。
- 常见错误现象：多人同时编辑 Word 文档，保存后部分修改丢失，日志里只看到
file_updated_at时间戳变了，找不到冲突痕迹 - 使用场景：若用
OnlyOffice，Webman 只需透传回调请求到其docservice，但必须实现callback.php里的onFileSave和onForceSave，且要校验token防伪造 - 兼容性影响：PDF 标注同步依赖
WebSocket长连接，Webman 默认不启用ws协议，需手动注册WebSocketserver 并监听onMessage事件
权限控制必须下沉到数据层，不能只拦在路由或中间件
Webman 的 middleware 可以拦截请求，但 OA 系统里常见“同一张报销单，申请人只能看自己填的内容，财务能看全部字段，领导能看到审批意见但不能改金额”——这种细粒度控制，光靠 if ($user->role === 'leader') 拦不住。
- 容易踩的坑：在 Controller 里用
where('user_id', $uid)查询，但没对amount、bank_account等敏感字段做unset()，JSON 返回时直接暴露 - 推荐做法：用
DTO类定义不同角色的数据视图，例如ReimbursementViewerDto和ReimbursementEditorDto，查询后显式映射，不依赖 ORM 自动填充 - 性能影响：每次查单据都去查
permission_rule表，不如预加载进redis，key 设为perm:{$user_id}:{$resource}，值存 JSON 字符串描述可读/可写字段列表
Webman 做 OA 系统最易被忽略的点，是它不解决“业务状态一致性”问题——比如一个请假单从“已提交”变成“部门审批中”，这个变更必须原子化地更新流程实例、通知记录、待办计数器三处数据，而 Webman 只提供执行环境，不提供事务编排能力。
