5.9 KiB
5.9 KiB
perm-button-20261008 上线记录
2026-10-08 12:21(CST)完成发布。用户截图(知识加工与检索)+「1.权限要精确到按钮,现在不精确 2.修复页面显示不全bug」。 内网模式,SSH 绑定 192.168.123.43 → 192.168.110.111。
内容
1. 权限精确到按钮
rbac.PERMISSIONS从 28 项拆到 65 项:每个页面一个「页面」码,页面里每个按钮一个码。角色编辑弹窗按「菜单 → 页面 → 按钮」勾选。- 模型清单:新增 / 编辑 / 测连通 / 删除;角色编排单独成页(查看、保存)。
- 智能体:新增 / 编辑 / 删除 / 保存协作方案。
- 客户端账号:修改策略(启用 / 禁用、自动备份)/ 分配可查看的管理端用户 / 强制下线。
- 版本升级:上传安装包 / 发布版本。
- 导出中心:查看记录 / 新建导出 / 下载文件。
- 人员唯一标识:查看 / 确认绑定 / 关联患者 / 解除关联。
- COS 存储:查看 / 保存配置 / 测试连接。
- 知识中心:整理聊天记录、暂停 / 继续 / 取消 / 换模型、整理设置、新聊天自动整理开关、编辑草稿、恢复历史版本、删除已驳回、 审核通过、驳回、一键审核、发布、停用、「客服使用知识」开关、检索测试、导出。
- 角色权限:新增 / 修改 / 删除;权限菜单单独成页(查看、新增、编辑、删除)。
- 用户管理:新增用户 / 修改角色 / 启用停用。
- 原来的码全部保留,只收窄成其中一个按钮(如 model:write = 编辑模型、knowledge:review = 审核通过)。
- 新拆出的码在第一次上线时,按 implied_by 授给持有原码的角色,上线前后每个角色能做的事完全一样。
- 回滚时旧代码删掉新码,原有授权一条没动。
- 接口按按钮的码判权限:
- 同一个保存接口按 ID 是否已存在区分「新增」和「编辑」(模型、智能体、角色)。
- 用户的改角色和启停分开判。
- 「新聊天也自动整理」勾选需要 knowledge:watch。
- 一键审核的后台任务改为核对 knowledge:review:auto。
- 前端每个按钮按同一个码显示或禁用。子页面都没权限的一级菜单不再显示;默认首页(调用统计)没权限的用户登录后进左侧第一个能打开的页面,不再落到 404。
- 修复
PUT /api/v2/users/{id}少传参数导致改角色、启停用户一律 500 的问题。
2. 页面显示不全
- 根因:后台内容区
overflow-x: hidden,表格一宽,右边几列直接被裁掉,也没法滚动。 - 修复:
- 表格在自己的卡片里横向滚动。
- 表头不再一个字一行。
- 模型清单没写宽度的列不再被挤成 0。
- 知识列表的时间改为北京时间短格式,如「2026-10-07 19:39」,并设最小宽度。
- 涉及文件:
src/styles/layout-fixes.css、model-catalog、center。
文件与服务
- 后端 5 个文件:
rbac.py、admin_api.py、archive_api.py、knowledge_api.py、knowledge_review.py。- 线上和改动前的 kefu 工作区一致,三方合并结果就是工作区。
- 差异见
payload-diff.txt。
- 管理后台:换入口 index.html,新增 22 个带哈希的文件。
frontend-head-build/是同一棵源码树把本次 22 个文件改动倒放后的构建:head-build/pbtn_reverse.py倒放,pbtn_build_base.mjs用 vite 预插件读入,不改工作区。- 它的页面依赖图与线上完全一致(只差构建时间)。
- 服务:api、gateway、knowledge-worker 全部换到本次镜像(三个进程启动都跑
rbac.seed)。- 上线时全量整理已结束(22 个账号任务全部完成),没有进行中的任务。
结果
- 当前镜像:
zyt/wecom-admin:perm-button-20261008=current,sha256:36121011b84a6c085183b1f98b05074530be20c7910eb74846fdf720fe364398。 - 本地测试:
- kefu 后端 248 项,只有已知的旧失败 1 项(发布包 URL,线上代码同样失败)。
- 新增 ButtonPermissionTest(模型、智能体、用户、角色、权限菜单的按钮级判定)、按钮码迁移测试、知识中心每个按钮的 403 测试。
- 前端 vitest 35 项(新增:页面里用到的按钮码都在后端登记、菜单裁剪、时间格式),vue-tsc 通过。
- 本地浏览器验证:
- 只有「审核通过 + 编辑模型」的账号:知识中心只看到「批量审核」和详情里的「审核通过」,字段只读;模型清单只有「编辑」可用。
- 左侧没有空菜单,登录后进入第一个能打开的页面。
- 1734 / 1024 / 604 宽度下 17 个页面都没有被裁掉的内容。
- RBAC 演练:用线上三张表的副本跑新 seed(三进程并发),再跑旧 seed 演练回滚,授权精确恢复。
- 候选镜像离线 206 项测试通过。
- 部署后(04-verify):
- 三个容器在新镜像、健康、重启 0 次,文件哈希一致。
- 内置 65 项,无自动登记项。
- viewer 7 → 9 项(角色编排查看、权限菜单查看),operator 17 → 36 项(全是由其原有权限拆出的按钮),admin 拥有全部。
- 原有授权无一丢失,无孤儿授权。
- 改了权限判断的接口匿名 401;经 Nginx(:8369)加载新入口。
- 上线后 api 26 个 200、0 个 403 / 500,三个服务 0 个 Traceback。
- 发布包
perm-button-server-bundle.tar.gz,230,902 字节,SHA-256c934a4850688934fe5ae858d7a562d5530d24fac384f1f8cdd69d1b4ba98543e。
备份与回滚
- 发布前 RBAC 三张表快照:
/home/ps/perm-button-20261008/rbac-before.json(roles 3 / permissions 28 / role_permissions 52, SHA-256 a0a0063f…1b99)。 - 源码备份
source-before/。 - 回滚标签
before-perm-button-20261008(= knowledge-view-20261007,sha256:82a1c2ef…)。 - 回滚:
REMOTE_RELEASE_APPROVED=perm-button-20261008 bash /home/ps/perm-button-20261008/rollback.sh。