ThinkPHP 5.1搭建企业工单系统：流程流转与消息通知开发 实战

企业工单系统需用状态机约束流转、策略表驱动多部门自动路由、多通道异步通知及工作日历驱动SLA倒计时，ThinkPHP 5.1通过模型事件、配置驱动、队列与定时任务实现高贴合度业务管控。

用ThinkPHP 5.1搭建企业工单系统，流程流转和消息通知是两个最常卡住开发者的环节。它们不是简单增删改查，而是涉及状态机控制、跨部门路由、时效倒计时和多通道触达。核心不在于写多少代码，而在于设计是否贴合业务真实节奏。

工单状态流转必须用状态机约束

直接在数据库里用字符串字段存“待处理→处理中→已解决→已关闭”看似简单，但很快会失控：比如客服误点“已关闭”，技术部还没看；或财务部跳过审批直接结单。ThinkPHP 5.1适合用模型事件+状态迁移表来管控。

• 定义status_transitions表，字段含from_status、to_status、allowed_role_ids、need_approval（是否需审批）、auto_after_minutes（超时自动跳转分钟数）
• 在工单模型的beforeUpdate钩子中调用checkTransition()方法，校验当前操作是否被transition表允许
• 关键动作如“转交技术部”“升级为紧急单”全部封装成模型方法，不暴露原始status字段修改入口
• 所有状态变更必须记录ticket_logs表，含操作人、时间、前状态、后状态、备注（用于审计与回溯）

多部门自动路由靠策略表驱动

人工分派工单容易积压、错配，尤其当客服提交“支付失败”类问题，应自动进财务组；“APP闪退”则直送研发组。ThinkPHP 5.1可利用配置驱动+运行时策略匹配实现柔性路由。

• 建routing_rules表：rule_name（如“支付类工单”）、match_type（关键词/客户等级/问题类型）、target_dept_code（billing）、priority（1-5）、enabled（1/0）
• 在工单创建接口中，用Db::name('routing_rules')查出匹配规则，按priority取最高优先级的一条，获取target_dept_code
• 结合部门组织架构表（dept_tree），支持向上找父部门兜底——例如“华东客服组”无空闲人时，自动升到“全国客服中心”
• 路由结果写入工单主表的assigned_dept_id和assigned_at，并触发后续通知

消息通知要分通道、带上下文、可追溯

只发站内信等于没通知。用户等反馈、处理人等任务、主管等超时预警，不同角色需要不同内容、不同渠道。ThinkPHP 5.1的命令行+队列+事件监听机制正适合解耦通知逻辑。

立即学习“PHP免费学习笔记（深入）”；

• 建notification_templates表：code（如ticket_assigned）、channel（sms/email/wecom/app_push）、title、content（支持{assignee}、{deadline}等变量）
• 用think-queue扩展异步发通知，避免阻塞主流程；失败任务进retry队列，最多重试3次
• 短信模板走阿里云/腾讯云SDK，企业微信通知调用wecom-api包，邮件用PHPMailer封装
• 每次发送生成notification_records记录，含receiver_id、channel、template_code、status（sent/failed）、error_msg（失败时）

SLA倒计时必须绑定工作日历计算

“2小时内响应”不能按自然小时算。遇到周末、节假日、非工作时段（如22:00–8:00），倒计时应暂停。ThinkPHP 5.1可通过中间件+定时任务协同保障SLA准确性。

• 建work_calendars表存公司日历，标注工作日/节假日/调休日；再建dept_working_hours表存各部门作息（技术部支持7×24，客服部仅9:00–18:00）
• 工单进入“已分派”状态时，调用SlaCalculator::calculateDeadline()，结合日历和部门作息生成精确的sla_deadline_at
• 用php think timer:run命令启动常驻进程，每分钟扫描tickets表中临近超时（剩余≤5分钟）的工单，触发预警通知
• 前端倒计时用AJAX轮询/api/ticket/{id}/sla-remaining接口，后端返回格式化字符串如“还剩0天2小时18分”