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