落地（依据《事项库与办事大厅详细设计 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 两跑幂等（含缺索引自动补建）
This commit is contained in:
chenxing
@@ -138,6 +138,69 @@ CREATE TABLE IF NOT EXISTS `cms_link` (
|
||||
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 事项字典（服务对象/事项类别）';
|
||||
|
||||
-- ============================================================
|
||||
-- 示例数据（联调首屏用，按需执行）
|
||||
-- ============================================================
|
||||
|
||||
Reference in New Issue
Block a user