chenxing
9e28092a8b
build / build-push (push) Successful in 2m26s
落地（依据《事项库与办事大厅详细设计 v1》）
- 事项域垂直包 com.yunhai.cms.svcitem.*（entity/enums/repository/service+impl/event/config/model dto+query+vo）
与 controller/{api,oapi}/svcitem；两表 DDL 进 cms_init.sql（表 7/8）+ upgrade_svcitem_r2.sql
- SvcItemQuery 接缝：门户 8 方法 + 管理端 11 方法统一收口，控制器不再注入实现类
- 门户公开层：doServiceList/doGuide 双路由变体 + M0 可选模板整页回退
（视图名/themeBase/buildUrl/资产主题段四处同源 effectiveTheme，缺模板整包退 default）
- oapi 跨服务快照：与平台 AppAuthFilter 同口径签名（canonical=method\npath?sortedQuery\ntimestamp,
HmacSHA256/Base64, 5min 窗口）+ /oapi/* 强制验签过滤器
- default 皮肤 service.html/guide.html + main.css 服务中心/指南页样式段
审计修复（发现与处置全表见 docs/18-事项库审计与修复记录.md）
- D1 附件引用链：内容资产（封面+正文内嵌图）独立场景 svc_item_asset，保存时按内容派生全量同步归属
（AttachmentService.localAssetUrls/localWebUrl/syncAssets：集合内标记、集合外解除）。
修复根因：upload 带 scene 时只写 ref_type 不写 ref_id，而保存仅按前端提交 id 重绑，
正文图与封面停在半绑定态 → 既不在孤儿口径内也不受 release 管辖，成永久无主行
- D5 归属校验：绑定前做可认领判定（无引用/半绑定/已属本事项方可绑），他事项引用与跨站附件跳过并告警
- D2 部门：组类型改配置 cms.svc.item.dept-group-type（默认 2=学校组，校内科室改 3）；
deptTree 返回嵌套组树；新增 SvcDeptSource 接缝使静态 getGroupTree 可替身（此前部门链零覆盖）
- D4 缓存：事件 scope 语义化，dict/dept 变更整体失效 cms:svcItem（展示名快照不再滞后 5min）
- 站点解析：findByCode 在 uk(parent_site_id,code) 下命中多条会抛异常变 500，
4 处生产调用点改 findFirstByCodeOrderByIdAsc（确定性取最早站点）
- 加固：新增 idx_svc_item_portal（含 DESC 列）对症门户排序 filesort；升级脚本改 information_schema
+PREPARE 幂等索引守卫块（表在缺索引可重跑修复）；clear_cms_data.sql 补事项两表；
view_count 改有界队列+拒绝丢弃告警；SEL_LIST_MAX 截断告警
测试
- 新增 SvcDeptChainIT 7、SvcItemServiceIT 16（含 D1/D5 回归锚点与全方法权限）、
SvcItemOapiIT 9（时间戳超窗/未知 appKey/畸形头/siteCode 歧义）、SvcItemPortalIT 11
（嵌套指南路由/关键词/canonical/浏览量异步）、SvcDictServiceIT 8（改名后缓存即时刷新）
- ThemeContractIT 补"缺可选模板主题资产段必退 default"断言并订正七路由表述
- 全量 mvn -o test：388 测试 0 失败；升级脚本 bsch_cms_test 两跑幂等（含缺索引自动补建）
218 lines
16 KiB
SQL
218 lines
16 KiB
SQL
-- ============================================================
|
||
-- 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);
|