-- ---------------------------- -- 出入院随访模块 + 宣教模块 开关(sys_config 参数配置表) -- ---------------------------- -- 本脚本一次建两个键,都可重复执行(幂等): -- -- 键名:inhospvisit.enabled -- 键值:true = 启用(默认,等价于不配置这一行) -- false = 关闭 -- -- 键名:publicity.enabled -- 键值:true = 启用(默认) -- false = 关闭(入院宣教与药品宣教都不再执行) -- -- 关闭 inhospvisit 后的行为: -- 1) 【HTTP 面】{@code /smartor/patinhosp} 前缀下的端点**全部**被 -- InhospVisitAvailabilityInterceptor 拦下,返回明确业务错误 -- 「出入院随访功能未启用(参数配置 inhospvisit.enabled=false),该接口不可用」而不是 404。 -- 受管的是**前缀通配** /smartor/patinhosp/**(不再逐个枚举路径), -- 当前实测覆盖 15 个端点(3 随访触发 + 9 基础查询/CRUD + 3 复合端点)。 -- ✅ **以后再往本模块加接口,自动受管,不需要改这个配置、也不用改 WebConfig** -- —— 只要新控制器仍挂在 /smartor/patinhosp 前缀下。 -- ⚠️ 口径变更史:原设计只拦 2 个随访触发端点,基础查询刻意不拦 -- (理由:"关随访不该让出入院记录查不到")。用户实机发现 -- POST /smartor/patinhosp/selectPatMedInhospList 在开关关闭后仍能查到, -- 决定改为"关就整个模块的 HTTP 面不可用"。 -- 覆盖性由 sql/_probe/verify_inhospvisit_switch.py 从控制器源码**实测**核对 -- (新控制器若挂错前缀会被它 FAIL 出来)。 -- 2) ⚠️ **只拦 HTTP,不动跨模块数据契约**:InhospVisitDataService(HIS 采集、档案汇聚、 -- 统计等模块内部/跨模块访问)**照常可用**。理由:那是数据同步链路, -- 关掉随访不该让 HIS 写不进出入院记录(数据断流比"页面看不到"严重得多)。 -- 所以"整个模块不可用"的准确含义是「该模块的 HTTP 面不可用」。 -- 3) ⚠️ **定时任务也受此开关控制**(2025 修复,与原先的"已拍板:不受控"相反 —— 见下)。 -- RyTask 的 5 个入口已全部接开关:dealOutHospInfo / dealOutHospInfoBySchedule / -- dealTaskGroupOutHosp / rollTaskGroupCycle 走门面,dealSubtaskDeadline 走入口守卫。 -- 关闭后模块实现打 WARN「模块未启用…跳过」并返回 0,当天不再生成随访。 -- -- ⚠️⚠️ 这条**推翻了原设计**,必须知道风险变了: -- 原设计的理由是"关掉定时任务 = 当天全院随访停摆,而开关是热读的, -- 一次误操作没有任何反馈渠道"。现在它确实会停掉定时任务,所以: -- · 误操作代价 = 当天全院随访不生成(与原设计担心的一致); -- · 但反馈渠道**变好了** —— 关闭时日志里会明确打出 -- 「【出入院随访】模块未启用(参数配置 inhospvisit.enabled=false),… 跳过」, -- 而不是像原来那样"关了开关却毫无效果、也没任何提示"; -- · 开关在「系统管理 → 参数设置」里可见可改,比去「定时任务」里找 sys_job 更直观。 -- 要暂停定时任务仍然可以去「系统管理 → 定时任务」暂停 sys_job(两条路都有效): -- ryTask.dealOutHospInfo / ryTask.dealOutHospInfoBySchedule / ryTask.dealTaskGroupOutHosp -- **本开关覆盖的定时任务入口已全覆盖**(5 个): -- dealOutHospInfo / dealOutHospInfoBySchedule / dealTaskGroupOutHosp / -- rollTaskGroupCycle / dealSubtaskDeadline -- 其中 rollTaskGroupCycle 走门面(完成了模块化方案里一直没做的"第 10 步"切换), -- dealSubtaskDeadline 因模块侧无完整入口而采用"入口自带守卫"。 -- 另:手术随访(dealOperationInfo)与门诊随访(门诊生成)各自受 -- othervisit.enabled / outpatientvisit.enabled 管辖,不受本开关管(这是刻意的)。 -- 4) 改完立即生效,最多 10 秒(进程内开关缓存 TTL),不需要重启。 -- -- 关闭 publicity 后的行为: -- 1) 【生成侧】入院宣教(sys_config: in.helibrary.switch = "2" 时执行)与药品宣教 -- (仅 sltd 站点)都不再生成 —— 出入院随访主流程回调 PublicityApi, -- 由 PublicityFacade 判本开关后跳过; -- 2) 【发送侧】已生成的宣教子任务(subtask.type = "3",含"通知")**也不再发出** —— -- RyTask#sfHandlle 与 RedisMqReceiver#tsakHandle 都在派发前判本开关, -- 关闭时跳过所有通道(电话/短信/公众号/人工)并打 WARN: -- 「【宣教】模块未启用(参数配置 publicity.enabled=false),跳过宣教发送。subtaskId=..., patid=...」 -- ⚠️ 2025 修复前**只**管住了生成侧:关掉开关后已生成的宣教照样发出去。 -- ⚠️ 跳过时刻意**不推进 subtask 状态、也不记失败** —— 关闭是"暂时不发", -- 不是"这个患者不需要宣教";标成失败会让这条宣教在开关恢复后永远丢失。 -- 开关打开后,下一次 longTaskSend / compensateTask 会照常把它捞出来发出。 -- 3) 出入院随访主流程不受影响(宣教失败绝不拖垮随访),其它类型的随访(type 1/2/4)也不受影响; -- 4) 改完立即生效,最多 10 秒,不需要重启。 -- -- 注意:本项目用的 MySQL 版本可能不支持 ADD COLUMN IF NOT EXISTS, -- 因此这里用 information_schema 判断后再动态执行。 -- ---------------------------- SET @sys_config_exists = ( SELECT COUNT(1) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'sys_config' AND COLUMN_NAME = 'config_key' ); -- --------------------------------------------------------------- -- 1) inhospvisit.enabled -- --------------------------------------------------------------- SET @ddl = IF(@sys_config_exists = 0, 'SELECT ''sys_config 表不存在,请先执行建表脚本'' AS warning', 'INSERT INTO sys_config (config_name, config_key, config_value, config_type, create_by, create_time, remark) SELECT ''出入院随访模块开关'', ''inhospvisit.enabled'', ''true'', ''Y'', ''admin'', SYSDATE(), ''出入院随访总开关(运行时读取,改完最多10秒生效):true启用,false关闭;默认true。注意:2025修复后本开关也作用于定时任务(dealOutHospInfo等3个入口),关闭=当天不再生成随访'' FROM DUAL WHERE NOT EXISTS (SELECT 1 FROM sys_config WHERE config_key = ''inhospvisit.enabled'')'); PREPARE inhospvisit_stmt FROM @ddl; EXECUTE inhospvisit_stmt; DEALLOCATE PREPARE inhospvisit_stmt; -- --------------------------------------------------------------- -- 2) publicity.enabled -- --------------------------------------------------------------- SET @ddl = IF(@sys_config_exists = 0, 'SELECT ''sys_config 表不存在,请先执行建表脚本'' AS warning', 'INSERT INTO sys_config (config_name, config_key, config_value, config_type, create_by, create_time, remark) SELECT ''宣教模块开关'', ''publicity.enabled'', ''true'', ''Y'', ''admin'', SYSDATE(), ''宣教(入院宣教/药品宣教)总开关(运行时读取,改完最多10秒生效):true启用,false关闭;默认true。同时管生成侧与发送侧(type=3宣教/通知)'' FROM DUAL WHERE NOT EXISTS (SELECT 1 FROM sys_config WHERE config_key = ''publicity.enabled'')'); PREPARE publicity_stmt FROM @ddl; EXECUTE publicity_stmt; DEALLOCATE PREPARE publicity_stmt; -- 查询当前值 -- SELECT config_id, config_name, config_key, config_value, remark FROM sys_config -- WHERE config_key IN ('inhospvisit.enabled', 'publicity.enabled');