-- =============================================================
-- 模块 / 菜单「展示端（platforms）」
--
-- 需求：后台管理模块层面需要能判断一个模块（及其菜单）
--       是 Web 端显示、小程序显示，还是两端都显示。
--
-- 与已有的 views 字段是两个独立维度，不要混淆：
--   views      —— [1]平台端 / [2]租户端（决定出现在哪个后台）
--   platforms  —— ["web"] / ["app"] / ["web","app"]（决定 Web 还是移动端可见）
--
-- 取值约定：
--   ["web"]        仅 Web 端（租户管理后台）可见
--   ["app"]        仅移动端（uniapp APP / 微信小程序）可见
--   ["web","app"]  两端都可见
--   '' 或 NULL     全端可见（默认，保证历史数据行为不变）
--
-- 继承规则：
--   菜单自身配置了 platforms → 以自身为准
--   菜单未配置              → 继承所属模块的 platforms（按 path 前缀归属）
--   两者都未配置            → 全端可见
--
-- 本脚本可重复执行：MySQL 不支持 ADD COLUMN IF NOT EXISTS，
-- 故先用 information_schema 判断，再由动态 SQL 决定加不加列。
-- 若已存在则只更新注释，不会报 1060 Duplicate column name。
-- =============================================================

-- ---------- yz_system_modules ----------
SET @db := DATABASE();
SET @tbl := 'yz_system_modules';
SET @col := 'platforms';
SET @exists := (
  SELECT COUNT(*) FROM information_schema.COLUMNS
  WHERE TABLE_SCHEMA = @db AND TABLE_NAME = @tbl AND COLUMN_NAME = @col
);
SET @sql := IF(@exists = 0,
  CONCAT('ALTER TABLE `', @tbl, '` ADD COLUMN `', @col,
         '` VARCHAR(64) NULL DEFAULT NULL COMMENT ''展示端：web/app JSON数组；空或NULL=全端'' AFTER `is_show`'),
  CONCAT('ALTER TABLE `', @tbl, '` MODIFY COLUMN `', @col,
         '` VARCHAR(64) NULL DEFAULT NULL COMMENT ''展示端：web/app JSON数组；空或NULL=全端''')
);
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;

-- ---------- yz_system_menu ----------
SET @tbl := 'yz_system_menu';
SET @exists := (
  SELECT COUNT(*) FROM information_schema.COLUMNS
  WHERE TABLE_SCHEMA = @db AND TABLE_NAME = @tbl AND COLUMN_NAME = @col
);
SET @sql := IF(@exists = 0,
  CONCAT('ALTER TABLE `', @tbl, '` ADD COLUMN `', @col,
         '` VARCHAR(64) NULL DEFAULT NULL COMMENT ''展示端：web/app JSON数组；空或NULL=继承所属模块'' AFTER `views`'),
  CONCAT('ALTER TABLE `', @tbl, '` MODIFY COLUMN `', @col,
         '` VARCHAR(64) NULL DEFAULT NULL COMMENT ''展示端：web/app JSON数组；空或NULL=继承所属模块''')
);
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;

-- ---------- 校验 ----------
SELECT TABLE_NAME, COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_COMMENT
FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = DATABASE() AND COLUMN_NAME = 'platforms'
  AND TABLE_NAME IN ('yz_system_modules', 'yz_system_menu');

-- =============================================================
-- 使用示例（按需执行）
--   注意：MySQL 5.7+ 可直接用 JSON_ARRAY('web') 生成 '["web"]'，
--   比手写转义双引号更省事。
-- =============================================================

-- 例1：把「客户关系管理」设为仅 Web 端可见（移动端不显示该子系统卡片）
-- UPDATE yz_system_modules SET platforms = JSON_ARRAY('web') WHERE code = 'crm';

-- 例2：把「便捷工具」设为仅移动端可见（Web 端后台不再展示）
-- UPDATE yz_system_modules SET platforms = JSON_ARRAY('app') WHERE code = 'bianjiegongju';

-- 例3：某功能两端都要
-- UPDATE yz_system_modules SET platforms = JSON_ARRAY('web','app') WHERE code = 'cms';

-- 例4：某个具体功能只在小程序上用（如扫码打卡），单独给菜单配置
-- UPDATE yz_system_menu SET platforms = JSON_ARRAY('app') WHERE path = '/tools/notebook';

-- 例5：恢复全端可见（清空即可，NULL 与 '' 都表示全端）
-- UPDATE yz_system_modules SET platforms = NULL WHERE code = 'crm';
-- UPDATE yz_system_modules SET platforms = NULL;   -- 全部恢复

-- =============================================================
-- 回滚
-- =============================================================
-- ALTER TABLE yz_system_modules DROP COLUMN platforms;
-- ALTER TABLE yz_system_menu    DROP COLUMN platforms;