Files
kefu/deploy/perm-button-20261008/RELEASE.md
T
2026-11-16 09:39:42 +08:00

5.9 KiB
Raw Blame History

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-256 c934a4850688934fe5ae858d7a562d5530d24fac384f1f8cdd69d1b4ba98543e。

备份与回滚

  • 发布前 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。