liusheng
2026-11-09 279d50c151d14d04cb6680b10c82bf32b72968cb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
-- ----------------------------
-- 出入院随访模块 + 宣教模块 开关(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');