v1.10.0:统一回收站、角色权限与操作日志,后台基础治理落地
2026 年 11 月 10 日,卫民CMS 演示站发布 v1.10.0。这一版的改动全部集中在后台,围绕「基础治理」分三批交付:统一回收站、角色权限(RBAC)与操作日志。前台页面、样式与 URL 规则不在改动范围内。
为什么是这三件事
一套内容管理系统能不能交付给客户,往往不取决于首页好不好看,而取决于数据删错了能不能找回来、多人一起用的时候权限能不能分开、谁在什么时候改了什么能不能查得到。v1.9 补齐了媒体库、导航菜单与配置分组,内容维护能力已经成型;v1.10 转向这三项治理能力,让后台从「能改内容」变成「可管、可控、可追溯」。
每一批都要求有可验收的功能增量——新表、新接口或新的后台操作,三批各自独立部署、独立验收,全部通过之后才统一写入更新日志。
第一批:统一回收站
新闻、产品、单页三张内容表新增 delete_time 列与 (site_id, delete_time) 联合索引,0 表示正常,大于 0 为删除时间戳;导航菜单与媒体库沿用同一口径。删除动作由物理删除改为软删除,后台提供恢复与彻底删除,并按删除时间戳成组恢复父项与子项。
更容易被忽略的是查询侧:前台列表、详情、sitemap 以及命令行静态页生成共 10 类查询点,全部补上 delete_time = 0 过滤。只要漏掉一处,回收站里的内容就会被写进前台整页静态缓存,之后即使恢复也看不到变化。后台同时新增跨五类内容的回收站总览,按当前编辑站点隔离。
第二批:角色权限
新增 wm_role、wm_permission 两张表,账号表增加 role_id。权限点用 PHP 常量定义字典,不额外建表;内置超级管理员、内容编辑、只读观察者三种角色,超级管理员短路放行,未分配角色按最小权限处理。
权限不写进会话,每个请求现查一次「账号 → 角色 → 权限点」,所以后台改完权限,对方下一个请求就生效,不需要重新登录。应用级中间件与路由分组各挂一道,防止默认调度绕过;侧边栏按权限显隐,拒绝时写入会话提示并退回仪表盘,不抛服务器错误。演示账号的只读限制优先级最高,即使给它配了写权限也不会放行。
第三批:操作日志
新增 wm_admin_log,由 admin.audit 中间件记录登录、退出与非演示账号的写操作,动作分为登录、退出、新增、编辑、删除、恢复、彻底删除、上传八类。日志只存请求路径与动作码,不记录表单正文、密码与令牌;列表只读、没有删除入口,支持按操作人、模块、动作和时间段筛选,非超级管理员查看时 IP 脱敏。
这里有两个容易踩的时机问题。一是退出请求会在处理过程中清空会话,如果只在事后读取操作人,退出日志就永远写不出来;二是登录时权限上下文尚未刷新,直接取当前角色会记成「未分配角色」。最终采用会话前后双快照,并一律按账号 ID 现查角色名。审计中间件只挂在后台应用级管道最外层,日志模型也不挂静态缓存失效钩子,避免每写一条日志就清一次前台整页缓存。
顺带修掉的一个地基缺陷
验收时发现 v1.9 遗留的一处问题:后台改完内容,前台静态页有时仍是旧数据。根因是 think-orm 3 的模型事件采用「方法式」调用——框架在模型实例上查找 onAfterWrite() / onAfterDelete() 并直接执行,并没有 trait 自动扫描,也没有静态注册接口。原先按旧写法注册的缓存失效钩子从未真正执行,只是被每次部署时手动重建静态页掩盖了。改为实例方法之后,模型保存即触发清理。
验收与改动范围
三批分别通过 51、58、49 项线上验收,覆盖软删除链路、越权拦截、权限即时生效、审计日志完整性、IP 脱敏与缓存三态;静态页重建 15/15,前台 9 个页面全部返回 200,PC 与 375px 手机端截图复验无横向溢出。本次改动集中在后台数据层与后台页面。