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
-- ----------------------------
-- 模板模块开关(sys_config 参数配置表)
-- ----------------------------
-- 键名:template.enabled
-- 键值:true  = 启用(默认,等价于不配置这一行)
--       false = 关闭
--
-- 读取方式:TemplateSwitch#isEnabled()
--   sys_config 热读 + 10 秒进程内缓存,fail-open(读不到 / 读库异常都按 true 处理)。
--
-- 关闭后的行为:
--   1) 本模块 66 个模板管理端点会被 TemplateAvailabilityInterceptor 拦下,
--      返回明确业务错误「模板功能未启用(参数配置 template.enabled=false),该接口不可用」,
--      而不是 404(前端能区分"模块被关闭"和"地址写错了");
--   2) 跨模块调用也会被拒:其它模块经 TemplateFacade 取模板时,
--      6 个数据方法统一抛 TemplateModuleDisabledException(提示语与上面一致)。
--      调用方各自决定降级方式,已在 4 个调用点逐个明确:
--        RyTask / RedisMqReceiver  -> 如实记「发送失败」并升级下一通道(不掩盖)
--        ServiceTaskServiceImpl     -> 返回空列表,患者宣教页面照常可开可提交
--        ChatWebSocketHandler       -> 抛异常(语音问卷本就模板驱动,继续走只会 NPE)
--      ⚠️ 也就是说:**关闭模板会连带停掉宣教短信的内容生成**,这是刻意的 ——
--      取不到模板内容就是没内容可发,不该记成"发送成功"。
--   3) ⚠️ 受管的是"管模板数据"的端点,共 66 个前缀,包含刻意留在 smartor 的
--      3 个模板管理控制器(SvyLibTemplateController / SvyTaskController /
--      SvyTaskTemplateController)。完整清单见 TemplateWebConfig#guardedPathPatterns()
--      或 sql/_probe/verify_template_switch.py 的输出。
--   4) ⚠️ **不受管**:IvrTaskVisitResultController / IvrTasksmsController /
--      IvrTaskcallrecordController —— 它们是"任务执行记录"(运行时实例),
--      已按职责移出模板模块;关掉"模板"不该让"任务执行记录查询"停摆。
--      服务子任务 / 档案 / 服务任务 / 问卷任务实例 / 方案流程等非模板端点同样不受管。
--   5) 改完立即生效,最多 10 秒,不需要重启。
--
-- 注意 1:本项目用的 MySQL 版本可能不支持 ADD COLUMN IF NOT EXISTS,
--         因此这里用 information_schema 判断后再动态执行,脚本可重复执行。
-- 注意 2:SysConfigServiceImpl#selectConfigByKey 里**写 Redis 的那行是注释掉的**
--         (只读 Redis 缓存、读不到就查库)。所以若历史上有人手动往 Redis 写过这个键,
--         改库不一定立刻看得见。稳妥做法:走「系统管理 → 参数设置」页面改(会清缓存),
--         或执行 UPDATE 后删掉 Redis 里的 sys_config:template.enabled。
-- ----------------------------
 
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'
);
 
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 ''模板模块开关'', ''template.enabled'', ''true'', ''Y'', ''admin'', SYSDATE(),
            ''模板模块总开关(运行时读取,改完最多10秒生效):true启用,false关闭;默认true。关闭后66个模板管理端点与TemplateFacade跨模块调用一并被拒''
     FROM DUAL
     WHERE NOT EXISTS (SELECT 1 FROM sys_config WHERE config_key = ''template.enabled'')');
 
PREPARE template_stmt FROM @ddl;
EXECUTE template_stmt;
DEALLOCATE PREPARE template_stmt;
 
-- 日常开关操作(二选一,改完最多 10 秒生效):
--   关闭:UPDATE sys_config SET config_value = 'false', update_time = SYSDATE() WHERE config_key = 'template.enabled';
--   开启:UPDATE sys_config SET config_value = 'true',  update_time = SYSDATE() WHERE config_key = 'template.enabled';
 
-- 查询当前值
-- SELECT config_id, config_name, config_key, config_value, remark FROM sys_config WHERE config_key = 'template.enabled';