-- ============================================================ -- bsch_cms 初始化脚本 -- 约定:JPA ddl-auto=update 自动建表;本脚本用于生产显式初始化/评审参考 -- 多租户:site 表挂 sch_id(逻辑外键 → UserBase sys_group.id),文章只挂 site_id, -- 编辑权限经 currentRole.schId → site.sch_id 映射校验 -- ============================================================ -- 1. 站点表(多租户根;一校一主站 + N 院系子站,见《院系子站方案.md》) CREATE TABLE IF NOT EXISTS `cms_site` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `code` VARCHAR(64) NOT NULL COMMENT '站点编码(URL 末段;W4 起不再全局唯一)', `path` VARCHAR(191) NOT NULL DEFAULT '' COMMENT '门户路径(顶层=code;子站=父path/code),URL 唯一标识', `parent_site_id` INT NOT NULL DEFAULT 0 COMMENT '上级站点ID(0=顶层校站点;院系子站挂主站 id,层级固定两层)', `sch_id` INT NULL COMMENT '学校ID(逻辑外键 → UserBase sys_group.id)', `sch_name` VARCHAR(128) NULL COMMENT '学校名称(冗余展示)', `name` VARCHAR(128) NOT NULL COMMENT '站点名称', `theme` VARCHAR(64) NULL DEFAULT 'default' COMMENT '皮肤包名(classpath:/templates/themes/{theme}/)', `config_json` JSON NULL COMMENT '站点配置(logo/联系方式/页脚等;预留 wechat 节点)', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '状态:0=停用 1=启用', `create_by` VARCHAR(64) NULL COMMENT '创建人账号', `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), UNIQUE KEY `uk_site_path` (`path`), UNIQUE KEY `uk_site_parent_code` (`parent_site_id`, `code`), KEY `idx_site_sch` (`sch_id`), KEY `idx_site_parent` (`parent_site_id`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 站点(一校一主站 + N 院系子站)'; -- 2. 栏目表(站点内树形) CREATE TABLE IF NOT EXISTS `cms_category` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `site_id` INT NOT NULL COMMENT '所属站点(逻辑外键 → cms_site.id)', `parent_id` INT NOT NULL DEFAULT 0 COMMENT '父栏目ID(0=根)', `name` VARCHAR(64) NOT NULL COMMENT '栏目名称', `type` TINYINT NOT NULL DEFAULT 1 COMMENT '栏目类型:1=文章列表 2=单页 3=外链', `link_url` VARCHAR(500) NULL COMMENT '外链地址(type=3 必填)', `template` VARCHAR(64) NULL COMMENT '栏目模板覆盖(空=按 type 取默认)', `content` LONGTEXT NULL COMMENT '单页栏目内容(type=2 时门户直接渲染;方案 §8.1 要求,§5.1 原稿漏列此处补齐)', `sort_no` INT NOT NULL DEFAULT 0 COMMENT '同级排序(升序)', `seo_title` VARCHAR(200) NULL COMMENT 'SEO 标题(空=用栏目名)', `seo_description` VARCHAR(500) NULL COMMENT 'SEO 描述', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '0=隐藏 1=显示', `create_by` VARCHAR(64) NULL, `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), KEY `idx_cat_tree` (`site_id`, `parent_id`, `sort_no`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 栏目(树形)'; -- 3. 文章表 CREATE TABLE IF NOT EXISTS `cms_article` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `site_id` INT NOT NULL COMMENT '所属站点(隔离/查询维度)', `category_id` INT NOT NULL COMMENT '所属栏目(逻辑外键 → cms_category.id)', `title` VARCHAR(200) NOT NULL COMMENT '标题', `summary` VARCHAR(500) NULL COMMENT '摘要(列表/SEO 用,空=截取正文)', `content` LONGTEXT NULL COMMENT '正文 HTML(wangEditor 产出,保存时 jsoup 白名单清洗)', `cover_image` VARCHAR(500) NULL COMMENT '封面图 URL', `author_account` VARCHAR(64) NULL COMMENT '作者账号(发布时从 BoaUser 填充)', `author_name` VARCHAR(64) NULL COMMENT '作者姓名(冗余展示)', `source` VARCHAR(128) NULL COMMENT '来源(转载出处)', `status` TINYINT NOT NULL DEFAULT 0 COMMENT '状态:0=草稿 1=已发布 2=已下架', `topmost` TINYINT NOT NULL DEFAULT 0 COMMENT '置顶:0/1', `publish_time` DATETIME NULL COMMENT '发布时间(空=保存即发布;未来=定时发布)', `offline_time` DATETIME NULL COMMENT '下架时间(可选)', `view_count` INT NOT NULL DEFAULT 0 COMMENT '浏览量(MVP 异步累加)', `ext_json` JSON NULL COMMENT '扩展字段(保留键:wechat=推送回执预留、albums=图集演进)', `create_by` VARCHAR(64) NULL, `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), KEY `idx_art_list` (`site_id`, `category_id`, `status`, `publish_time`), KEY `idx_art_site_top` (`site_id`, `status`, `topmost`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 文章'; -- 4. 附件表(正文图片 + 文档附件) CREATE TABLE IF NOT EXISTS `cms_attachment` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `site_id` INT NOT NULL COMMENT '所属站点', `article_id` INT NULL COMMENT '关联文章(编辑器图片保存时回填)', `ref_type` VARCHAR(16) NULL COMMENT '场景引用类型:banner/link/site(B2)', `ref_id` INT NULL COMMENT '场景引用对象ID(B2)', `file_name` VARCHAR(255) NOT NULL COMMENT '原始文件名', `file_path` VARCHAR(500) NOT NULL COMMENT '存储路径(相对 FILE_PATH)', `web_url` VARCHAR(500) NOT NULL COMMENT 'Web 访问 URL', `file_size` BIGINT NULL COMMENT '字节数', `mime_type` VARCHAR(128) NULL COMMENT 'MIME 类型', `create_by` VARCHAR(64) NULL, `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), KEY `idx_att_article` (`article_id`), KEY `idx_att_site` (`site_id`), KEY `idx_att_ref` (`ref_type`, `ref_id`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 附件'; -- 5. 轮播/推荐位表(首页 banner、图片新闻位等) CREATE TABLE IF NOT EXISTS `cms_banner` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `site_id` INT NOT NULL COMMENT '所属站点', `position` VARCHAR(32) NOT NULL DEFAULT 'home' COMMENT '展示位标识(home=首页轮播;皮肤包约定其他位)', `title` VARCHAR(200) NOT NULL COMMENT '标题(alt 文案/无图兜底)', `image_url` VARCHAR(500) NOT NULL COMMENT '图片 URL(上传至 FILE_PATH)', `link_type` TINYINT NOT NULL DEFAULT 1 COMMENT '跳转类型:1=文章 2=栏目 3=外链', `link_value` VARCHAR(500) NULL COMMENT '跳转目标(文章ID/栏目ID/URL,按 link_type 解释)', `sort_no` INT NOT NULL DEFAULT 0 COMMENT '同级排序(升序)', `start_time` DATETIME NULL COMMENT '上线时间(空=立即;未来=定时上线)', `end_time` DATETIME NULL COMMENT '下线时间(可选,门户渲染时过滤)', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '状态:0=停用 1=启用', `create_by` VARCHAR(64) NULL, `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), KEY `idx_banner` (`site_id`, `position`, `status`, `sort_no`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 轮播/推荐位'; -- 6. 友情链接表(页脚/首页分组成员) CREATE TABLE IF NOT EXISTS `cms_link` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `site_id` INT NOT NULL COMMENT '所属站点', `group_name` VARCHAR(64) NOT NULL DEFAULT 'default' COMMENT '分组(上级部门/兄弟院校/合作单位…)', `name` VARCHAR(128) NOT NULL COMMENT '链接名称', `logo_url` VARCHAR(500) NULL COMMENT 'Logo URL(可选,文字链可空)', `link_url` VARCHAR(500) NOT NULL COMMENT '链接地址', `sort_no` INT NOT NULL DEFAULT 0 COMMENT '组内排序(升序)', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '0=隐藏 1=显示', `create_by` VARCHAR(64) NULL, `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), KEY `idx_link` (`site_id`, `group_name`, `sort_no`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 友情链接'; -- 7. 事项表(L1 事项库主表,事项库与办事大厅详细设计 §2.1;跨服务键 = siteCode + item_code) CREATE TABLE IF NOT EXISTS `cms_service_item` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `site_id` INT NOT NULL COMMENT '所属站点', `item_code` VARCHAR(64) NOT NULL COMMENT '事项编码(站内唯一,跨服务键的一半)', `title` VARCHAR(200) NOT NULL COMMENT '事项名称', `summary` VARCHAR(500) NULL COMMENT '一句话简介(列表副标题/快照摘要)', `object_key` VARCHAR(64) NULL COMMENT '服务对象(→ cms_service_dict.dict_key, dict_type=object)', `category_key` VARCHAR(64) NULL COMMENT '事项类别(→ cms_service_dict.dict_key, dict_type=category)', `dept_group_id` INT NULL COMMENT '服务部门(UserBase 组树节点 id 快照)', `dept_name` VARCHAR(128) NULL COMMENT '部门名快照(改名不自动同步)', `handle_mode` TINYINT NOT NULL DEFAULT 1 COMMENT '办理方式:1=线上 2=线下 3=线上线下', `online_flag` TINYINT NOT NULL DEFAULT 1 COMMENT '是否可在线办理:1=是 0=否("在线办理"筛选维度)', `handle_place` VARCHAR(200) NULL COMMENT '办理地点', `handle_time_limit` VARCHAR(64) NULL COMMENT '办理时限(文本,如"3 个工作日")', `promise_time_limit` VARCHAR(64) NULL COMMENT '承诺时限(文本)', `contact_phone` VARCHAR(64) NULL COMMENT '咨询电话', `supervise_phone` VARCHAR(64) NULL COMMENT '监督投诉电话', `process_html` LONGTEXT NULL COMMENT '办理流程 HTML(保存时 jsoup 清洗)', `material_html` LONGTEXT NULL COMMENT '所需材料 HTML(同上)', `notice_html` LONGTEXT NULL COMMENT '注意事项 HTML(同上)', `faq_category_id` INT NULL COMMENT '关联栏目:常见问题(逻辑外键 → cms_category.id)', `notice_category_id` INT NULL COMMENT '关联栏目:公告信息(同上)', `rule_category_id` INT NULL COMMENT '关联栏目:文件规定(同上)', `cover_image` VARCHAR(500) NULL COMMENT '事项图标/封面(上传相对路径)', `sort_no` INT NOT NULL DEFAULT 0 COMMENT '管理端自定义排序(升序,列表第一优先级)', `status` TINYINT NOT NULL DEFAULT 0 COMMENT '状态:0=草稿 1=已发布 2=已下架', `publish_time` DATETIME NULL COMMENT '发布时间', `offline_time` DATETIME NULL COMMENT '下架时间', `view_count` INT NOT NULL DEFAULT 0 COMMENT '指南页浏览量(异步累加,不承诺精确)', `ext_json` JSON NULL COMMENT '扩展(一期仅 apply_url:"我要办理"外链)', `create_by` VARCHAR(64) NULL, `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), UNIQUE KEY `uk_svc_item_code` (`site_id`, `item_code`), KEY `idx_svc_item_list` (`site_id`, `status`, `online_flag`, `sort_no`), KEY `idx_svc_item_obj` (`site_id`, `status`, `object_key`), KEY `idx_svc_item_cat` (`site_id`, `status`, `category_key`), KEY `idx_svc_item_dept` (`site_id`, `status`, `dept_group_id`), KEY `idx_svc_item_portal` (`site_id`, `status`, `sort_no` ASC, `publish_time` DESC, `id` DESC) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 事项(L1 事项库主表)'; -- 8. 事项字典表(服务对象/事项类别;不复用 cms_category——栏目树是内容目录,语义不同) CREATE TABLE IF NOT EXISTS `cms_service_dict` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `site_id` INT NOT NULL COMMENT '所属站点', `dict_type` VARCHAR(32) NOT NULL COMMENT '类型:object=服务对象 category=事项类别', `dict_key` VARCHAR(64) NOT NULL COMMENT '稳定键(站内同类型唯一;被事项引用后不可改)', `dict_name` VARCHAR(128) NOT NULL COMMENT '展示名', `sort_no` INT NOT NULL DEFAULT 0 COMMENT '排序(升序)', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '状态:0=停用 1=启用(停用不出现在筛选,存量引用仍可渲染)', `ext_json` JSON NULL COMMENT '预留扩展(颜色/图标等)', `create_by` VARCHAR(64) NULL, `create_time` DATETIME NULL, `update_by` VARCHAR(64) NULL, `update_time` DATETIME NULL, PRIMARY KEY (`id`), UNIQUE KEY `uk_svc_dict` (`site_id`, `dict_type`, `dict_key`), KEY `idx_svc_dict_list` (`site_id`, `dict_type`, `status`, `sort_no`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = 'CMS 事项字典(服务对象/事项类别)'; -- ============================================================ -- 示例数据(联调首屏用,按需执行) -- ============================================================ -- INSERT INTO cms_site (code, sch_id, sch_name, name, theme) -- VALUES ('demo', 1, 'XX学校', 'XX学校门户网站', 'default'); -- -- INSERT INTO cms_category (site_id, parent_id, name, type, sort_no) -- VALUES (1, 0, '新闻中心', 1, 1), (1, 0, '通知公告', 1, 2), (1, 0, '学校简介', 2, 3); -- -- INSERT INTO cms_banner (site_id, position, title, image_url, link_type, sort_no) -- VALUES (1, 'home', '欢迎访问XX学校', '/upload/cms/demo/202609/example.jpg', 3, 1); -- -- INSERT INTO cms_link (site_id, group_name, name, link_url, sort_no) -- VALUES (1, '上级部门', '教育部', 'http://www.moe.gov.cn', 1);