Files
tcpserver-flow/app/config/custom_process_config.php
zimoyin 9ddec3dfb9 refactor(flow): 优化流程配置及相关测试
- 在测试代码中统一使用 setPreviousAction 与 setDuration 方法,规范方法调用
- VirtualContextBuilder 允许 setDuration 接收 null,增强灵活性
- VirtualityFlowProcessor 计算步骤持续时间时改进判断逻辑,避免错误持续时间值
- 增加日志记录上一步骤开始时间,方便调试流程状态
- 自定义流程配置文件大幅重构,新增多种晨洗模式配置
- 新增机洗单步骤流程、无晨洗流程、每日首次晨洗、存储超时晨洗等多种流程样例
- 自定义流程支持 override_steps 为 true/false 的不同合并策略说明与示例
- 详细补充配置节点说明,增强配置文档准确性和用户理解
- 自定义语音模板扩展,支持多种语音播报及错误提示文本
- 更新时间验证配置,统一各流程中各步骤时间要求
- 补充“配置自定义节点流程指南”文档,详细说明配置原则、合并策略与使用建议
2026-03-13 18:59:36 +08:00

356 lines
16 KiB
PHP

<?php
/**
* 流程配置文件
*
* 使用说明:
* 1. 在 .env 中设置 FLOW_PROCESS_CONFIG_KEY 指定使用的配置键名
* 2. 每个配置包含:晨洗模式、步骤列表、时间验证、语音模板等
* 3. steps 中的 code 必须与 ProcessNode 的 getCode() 返回值一致
*
* @see \app\flow\config\ProcessConfig 加载和处理逻辑
*/
return [
// ============================================
// 1. 机洗单步骤流程
// ============================================
// 场景:只刷机洗读卡器,自动完成后续步骤
// 流程:机洗 → 终末漂洗 → 干燥 → 结束
// 特点:跳过手工清洗的漂洗和消毒步骤
// ============================================
'machine_wash' => [
'name' => '机洗单步骤流程',
'description' => '只刷机洗后自动完成终末漂洗、干燥、结束',
'override_steps' => true,
// 晨洗配置:禁用
'morning_wash' => [
'mode' => 'none', // none | all | daily_first | storage_time | specific_types
],
// 步骤配置
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => false],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true, 'required' => ['结束']],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true, 'required' => ['清洗']],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true, 'required' => ['漂洗']],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true, 'required' => ['清洗', '漂洗', '消毒']],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true, 'required' => ['机洗']],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true, 'required' => ['终末漂洗']],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true, 'required' => ['干燥']],
],
],
// ============================================
// 2. 标准完整流程
// ============================================
// 场景:完整的七步洗消流程
// 流程:晨洗 → 清洗 → 漂洗 → 消毒 → 终末漂洗 → 干燥 → 结束
// 特点:符合 WS 507-2016 规范,包含所有必需步骤
// ============================================
'standard' => [
'name' => '标准完整流程',
'description' => '包含晨洗在内的完整七步洗消流程',
'override_steps' => true,
// 晨洗配置:每天第一次需要晨洗
'morning_wash' => [
'mode' => 'daily_first', // 每天第一次洗消需要晨洗
'storage_threshold' => 4, // 存储时间阈值(小时)
'morning_start_time' => '00:00:00', // 每日开始时间
],
// 步骤配置
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => true],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
// 默认时间验证配置(秒)
'time_validation' => [
'durations' => [
'清洗' => 120, // 2 分钟
'漂洗' => 60, // 1 分钟
'消毒' => 300, // 5 分钟
'终末漂洗' => 120, // 2 分钟
'干燥' => 30, // 30 秒
'机洗' => 360, // 6 分钟
],
],
],
// ============================================
// 3. 无晨洗流程
// ============================================
// 场景:不需要晨洗功能的医院
// 流程:清洗 → 漂洗 → 消毒 → 终末漂洗 → 干燥 → 结束
// 特点:完全禁用晨洗节点
// ============================================
'no_morning_wash' => [
'name' => '无晨洗流程',
'description' => '不包含晨洗步骤的标准洗消流程',
'override_steps' => true,
// 晨洗配置:完全禁用
'morning_wash' => [
'mode' => 'none',
],
// 步骤配置
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => false],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
],
// ============================================
// 4. 晨洗配置(多种模式)
// ============================================
// 场景:根据不同医院政策配置晨洗规则
// 子配置:
// - morning_wash_daily: 每天第一次
// - morning_wash_storage: 存储超时
// - morning_wash_all: 每次都晨洗
// - morning_wash_specific: 特定类型镜子
// ============================================
// 4.1 每天第一次晨洗(忠县模式)
'morning_wash_daily' => [
'name' => '每天第一次晨洗',
'description' => '每日首次洗消需要晨洗',
'override_steps' => true,
'morning_wash' => [
'mode' => 'daily_first',
'storage_threshold' => 4,
'morning_start_time' => '00:00:00',
],
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => true],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
],
// 4.2 存储超时晨洗(义乌模式)
'morning_wash_storage' => [
'name' => '存储超时晨洗(义乌模式)',
'description' => '普通镜柜超过阈值小时需要晨洗,无菌镜柜免晨消',
'override_steps' => true,
'morning_wash' => [
'mode' => 'storage_time',
'storage_threshold' => 4, // 4 小时阈值
'morning_start_time' => '06:00:00',
],
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => true],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
],
// 4.3 每次都晨洗(高感染风险区)
'morning_wash_all' => [
'name' => '每次都晨洗',
'description' => '每次洗消都需要先进行晨洗',
'override_steps' => true,
'morning_wash' => [
'mode' => 'all',
],
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => true],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
],
// 4.4 特定类型镜子晨洗
'morning_wash_specific' => [
'name' => '特定类型镜子晨洗',
'description' => '只有胃镜、十二指肠镜需要晨洗',
'override_steps' => true,
'morning_wash' => [
'mode' => 'specific_types',
'specific_types' => ['胃镜', '十二指肠镜'],
],
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => true],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
],
// ============================================
// 5. 有干燥流程(默认)
// ============================================
// 场景:包含干燥步骤的完整流程
// 流程:晨洗 → 清洗 → 漂洗 → 消毒 → 终末漂洗 → 干燥 → 结束
// 特点:干燥节点启用,符合规范要求
// ============================================
'with_dry' => [
'name' => '有干燥流程',
'description' => '包含干燥步骤的完整洗消流程',
'override_steps' => true,
// 晨洗配置:每天第一次
'morning_wash' => [
'mode' => 'daily_first',
],
// 步骤配置:干燥启用
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => true],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true], // ✓ 启用干燥
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
// 时间验证
'time_validation' => [
'durations' => [
'清洗' => 120,
'漂洗' => 60,
'消毒' => 300,
'终末漂洗' => 120,
'干燥' => 30, // 干燥至少 30 秒
'机洗' => 360,
],
],
],
// ============================================
// 6. 无干燥流程
// ============================================
// 场景:医院不需要干燥步骤
// 流程:晨洗 → 清洗 → 漂洗 → 消毒 → 终末漂洗 → 结束
// 特点:禁用干燥和终末漂洗
// ============================================
'no_dry' => [
'name' => '无干燥流程',
'description' => '不包含干燥步骤的洗消流程',
'override_steps' => true,
// 晨洗配置:禁用
'morning_wash' => [
'mode' => 'none',
],
// 步骤配置:禁用干燥和终末漂洗
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => false],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => false], // ✗ 禁用
['code' => '干燥', 'class' => 'DryNode', 'enabled' => false], // ✗ 禁用干燥
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
],
// ============================================
// 7. 自定义语音流程
// ============================================
// 场景:需要特殊语音播报的医院
// 特点:每个步骤都有自定义语音内容
// ============================================
'custom_voice' => [
'name' => '自定义语音流程',
'description' => '每个步骤都有特殊语音提示',
'override_steps' => true,
// 晨洗配置:每天第一次
'morning_wash' => [
'mode' => 'daily_first',
],
// 步骤配置:标准流程
'steps' => [
['code' => '晨洗', 'class' => 'MorningWashNode', 'enabled' => true],
['code' => '清洗', 'class' => 'WashNode', 'enabled' => true],
['code' => '漂洗', 'class' => 'RinseNode', 'enabled' => true],
['code' => '消毒', 'class' => 'DisinfectNode', 'enabled' => true],
['code' => '终末漂洗', 'class' => 'FinalRinseNode', 'enabled' => true],
['code' => '干燥', 'class' => 'DryNode', 'enabled' => true],
['code' => '结束', 'class' => 'EndNode', 'enabled' => true],
['code' => '机洗', 'class' => 'MachineWashNode', 'enabled' => true],
],
// 自定义语音模板
'voice_templates' => [
// 正常洗消流程语音
'normal_wash' => [
'晨洗' => '晨洗开始,请进行每日首次清洗准备',
'清洗' => '第一步清洗开始,请认真清洗内镜外表面和管道',
'漂洗' => '第二步漂洗开始,用流动水冲洗残留酶液',
'消毒' => '第三步消毒开始,请确保消毒剂浓度和时间',
'终末漂洗' => '第四步终末漂洗开始,用无菌水彻底冲洗',
'干燥' => '最后一步干燥开始,用压力气枪吹干管道',
'结束' => '清洗流程全部完成,请妥善保管内镜',
'机洗' => '机洗开始,请将内镜放入清洗机',
],
// 晨洗流程语音
'morning_wash' => [
'晨洗' => '晨洗模式启动,今日首次清洗需额外注意',
'清洗' => '晨洗后的第一次清洗,请按标准流程操作',
],
// 错误提示语音
'error_messages' => [
'NOT_ENOUGH_TIME' => '{step}时间不足,还需等待{time}秒',
'PLEASE_SWIPE_OPERATOR' => '请先刷人员卡',
'PLEASE_SWIPE_ENDOSCOPE' => '请刷内镜卡',
],
],
// 时间验证配置
'time_validation' => [
'durations' => [
'清洗' => 120,
'漂洗' => 60,
'消毒' => 300,
'终末漂洗' => 120,
'干燥' => 30,
'机洗' => 360,
],
],
],
];