-- ---------------------------- -- 模板模块开关(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';