fix phase2 gateway matching and release artifact

2026-06-28 22:16:49 +08:00
parent a86de6545f
commit 175166a5dc
17 changed files with 2670 additions and 35 deletions
@@ -4,11 +4,11 @@

 ## 当前状态

- 当前任务：需求修改/二期变更：权限驱动导航和按钮
- 本次变更摘要：已完成登录/刷新响应透出 `user.permissions`，前端新增统一 `can(permission)` 权限封装；菜单按页面权限裁剪，核心真实 API 页面操作按钮按 manage/play 权限裁剪，无权限页面提供明确提示，并避免无权限启动时批量请求导致 403。
- 总体状态：S30 已完成；本地 KVM 开发环境 V2 闭环原冻结 release 为 `s28-v2-20260621220924`；B 已切换并冻结到 `s42-phase2-business-prefix-20260624140000` 作为二期业务前缀小样本联调基线，MySQL 已补齐号码库 migration `20260624095000_number_library` 与业务前缀 migration `20260624121000_business_prefix_gateway_rewrite`，Prisma status 为 up to date，config-publisher 当前 active 配置版本为 `1782286812696`，上一版本为 `1782286145681`，B preflight 直接执行通过；A 已加载业务前缀 Lua SHA `0b7ee595cdcad2f38a670dd8ff3553387820039e`，OpenSIPS 配置 SHA-256 为 `ae1544e9a39d2db114e6981babac042c2ab6d399d59ba597a52b85d597aa5aa5`，最终 `dlg_list` 已清空；T 已完成冻结验收实呼 `s28-1782288889943-ckv83lce@lisglosips-t`，B CDR 入库并计费成功；当前仍未导入真实 80 万手机号段；阿里云迁移前需按 S30 Runbook 重新演练
- 最后更新：2026-06-24 17:50 +08:00
- 当前阻塞：无阻塞。遗留问题：真实 80 万手机号段尚未导入；OpenSIPS dialog 在测试呼叫结束后可能残留，冻结前已通过重启清空，后续应单独分析 dialog 生命周期和 `dlg_end_dlg Operation failed` 根因；本次权限裁剪使用本地 mock API 完成只读账号浏览器冒烟，真实 B 服务器浏览器登录态逐页按钮、真实录音文件播放和 Nginx/X-Accel 链路仍需后续人工复测。
+- 当前任务：需求修改/二期变更：客户网关匹配口径固化与 release artifact 脚本
+- 本次变更摘要：已按“业务前缀优先于主叫前缀，精确规则优先于空业务前缀兜底”更新设计文档、Runbook、客户网关编辑页提示、后端客户网关匹配唯一性校验、A 侧 Lua 热路径仓库脚本，并新增 `scripts/build-release-artifact.mjs` 固化 release artifact 生成规范。
+- 总体状态：S30 已完成；本地 KVM 开发环境 V2 闭环原冻结 release 为 `s28-v2-20260621220924`；B 二期冻结基线为 `s42-phase2-business-prefix-20260624140000`，当前已切换到 Bug 修复 release `s43-bugfix-cdr-quality-rbac-20260624184854`；切换前已生成并校验 MySQL/Redis 备份 `/data/backups/mysql/20260624T104812Z` 与 `/data/backups/redis/20260624T104812Z`；B preflight 通过，API ready 返回 ok，HTTPS 首页加载新前端资产；A 仍加载业务前缀 Lua SHA `0b7ee595cdcad2f38a670dd8ff3553387820039e`，OpenSIPS 配置 SHA-256 仍为 `ae1544e9a39d2db114e6981babac042c2ab6d399d59ba597a52b85d597aa5aa5`；T 未变更；当前仍未导入真实 80 万手机号段；阿里云迁移前需按 S30 Runbook 重新演练
+- 最后更新：2026-06-28 22:09 +08:00
+- 当前阻塞：无阻塞。遗留问题：本次未连接 A/B/T、未部署到服务器、未执行数据库 schema 或服务变更；A 侧 Lua 仅更新仓库文件，发布前需备份 A OpenSIPS/Lua、执行 `opensips -C -f` 并做 A/B/T 实呼验收；本地 Windows 未安装 Lua/luac，Lua 语法未做解释器级检查；真实 80 万手机号段尚未导入；OpenSIPS dialog 残留根因仍待单独分析；真实 B 服务器浏览器登录态逐页按钮、真实录音文件播放和 Nginx/X-Accel 链路仍需用户测试复核。
 - 当前环境：A/B/T 为本地 KVM 开发服务器，通过 Tailscale 联调；开发完成后再迁移阿里云
 - 私密访问资料：`.codex-private/SERVER_ACCESS.md`，只在实际连接时读取，禁止回显

@@ -90,6 +90,120 @@

 ## 交接记录

+### 2026-06-28 22:09 - 需求修改/二期变更：客户网关匹配口径固化与 release artifact 脚本
+
+- 状态：已完成本地代码与文档修改，未发布服务器
+- 操作服务器：本地
+- 完成内容：将产品口径固化为“业务前缀优先于主叫前缀，精确规则优先于空业务前缀兜底”；明确业务前缀只作为客户网关匹配字典，不参与计费、报表或权限隔离；明确客户网关决定客户侧计费、落地网关决定供应商侧成本；后端客户网关保存/启用时校验同一 IP + 同一业务前缀唯一、同一 IP 主叫前缀不互相覆盖、同一网关内主叫前缀不互相覆盖；A 侧热路径仓库 Lua 改为业务前缀优先、空业务前缀下再按最长主叫前缀、最后默认兜底；客户网关编辑页新增匹配规则提示；新增固定 release artifact 脚本与 npm script。
+- 修改文件：`SOFTSWITCH_PLATFORM_DESIGN_V2.md`、`docs/PHASE2_BUSINESS_PREFIX_GATEWAY_MIGRATION_RUNBOOK.md`、`apps/api/src/modules/customer-gateways/customer-gateways.service.ts`、`apps/api/src/modules/customer-gateways/customer-gateways.e2e.spec.ts`、`apps/web/src/pages/CustomerGatewaysPage.jsx`、`infra/server-a/s28/lisglosips_hotpath.lua`、`scripts/build-release-artifact.mjs`、`package.json`、`IMPLEMENTATION_STATUS.md`
+- 验证结果：`node_modules/.bin/tsc.cmd -b tsconfig.build.json --pretty false` 通过；`node_modules/.bin/eslint.cmd` 针对后端/脚本文件通过，Web 页面文件因仓库 ignore 规则被跳过且无错误；客户网关 e2e 7/7 通过，覆盖重复业务前缀和主叫前缀覆盖冲突；`node scripts/build-release-artifact.mjs --release-id s-local-check --check` 通过；`apps/web/node_modules/.bin/vite.CMD build` 通过，产物 `index-BBq8iMHt.js`。
+- 回滚方式：本地回滚上述文件即可；若未来已发布服务器，B 应回滚到上一 release artifact，A 应恢复发布前备份的 `/etc/opensips/lisglosips_hotpath.lua` 并执行 `opensips -C -f /etc/opensips/opensips.cfg` 后重启 OpenSIPS。
+- 未解决问题：未连接服务器、未生成正式 Linux release artifact、未部署 A/B、未做 A/B/T 实呼验收；本地无 Lua/luac，Lua 解释器级语法检查需在 A 或装有 Lua 的环境补跑。
+
+### 2026-06-28 16:45 - 修复用户管理/角色权限页面空白
+
+- 状态：已完成
+- 操作服务器：B
+- 完成内容：
+  - 修复 `apps/web/src/pages/UsersPage.jsx` 中 `emptyUserForm` 未定义导致用户管理页面空白的问题。
+  - 修复 `apps/web/src/pages/RolesPage.jsx` 中 `emptyRoleForm` 未定义导致角色与权限页面空白的问题。
+  - 增加一次轻量源码检查，确认 `apps/web/src/pages` 下 `empty*Form` 引用均有同文件定义。
+  - 重新构建前端并发布到 B 当前 release `/opt/lisglosips/releases/s43-bugfix-cdr-quality-rbac-20260624184854` 的 `apps/web/dist` 与 `public` 目录。
+- 修改文件：`apps/web/src/pages/UsersPage.jsx`、`apps/web/src/pages/RolesPage.jsx`、`IMPLEMENTATION_STATUS.md`；B 当前 release 静态资源目录。
+- 安装软件及固定版本：未安装新软件。
+- 执行的关键命令：`corepack pnpm@10.33.0 lint`、`corepack pnpm@10.33.0 typecheck`、`corepack pnpm@10.33.0 build`、页面 `empty*Form` 引用检查、上传并解包前端 dist、`curl -k https://127.0.0.1/`。
+- 验证结果：
+  - lint 通过。
+  - typecheck 通过。
+  - build 通过。
+  - 页面 `empty*Form` 引用检查无输出，未发现同类缺失定义。
+  - B HTTPS 首页已引用 `/assets/index-BK00zN_M.js` 与 `/assets/index-B2uYBtS3.css`。
+- 回滚方式：恢复上述两个页面文件并重新构建发布；或将 B `public`/`apps/web/dist` 恢复为上一版前端静态资源。
+- 未解决问题：未使用真实浏览器逐页点击复测；请用户强刷后重新进入“用户管理”“角色与权限”确认。
+- 下一任务：等待用户复测反馈。
+
+### 2026-06-28 16:39 - 修复业务前缀页面空白
+
+- 状态：已完成
+- 操作服务器：B
+- 完成内容：
+  - 修复 `apps/web/src/pages/BusinessPrefixesPage.jsx` 中 `emptyBusinessPrefixForm` 未定义导致业务前缀菜单页面空白的问题。
+  - 重新执行本地 lint、typecheck、build，生成新前端资产 `assets/index-CVzJDPkO.js`。
+  - 将 `apps/web/dist` 发布到 B 当前 release `/opt/lisglosips/releases/s43-bugfix-cdr-quality-rbac-20260624184854` 的 `apps/web/dist` 与 `public` 目录。
+- 修改文件：`apps/web/src/pages/BusinessPrefixesPage.jsx`、`IMPLEMENTATION_STATUS.md`；B 当前 release 静态资源目录。
+- 安装软件及固定版本：未安装新软件。
+- 执行的关键命令：`corepack pnpm@10.33.0 lint`、`corepack pnpm@10.33.0 typecheck`、`corepack pnpm@10.33.0 build`、上传并解包前端 dist、`curl -k https://127.0.0.1/`。
+- 验证结果：
+  - lint 通过。
+  - typecheck 通过。
+  - build 通过。
+  - B HTTPS 首页已引用 `/assets/index-CVzJDPkO.js` 与 `/assets/index-B2uYBtS3.css`，不再引用旧 `index-BudcefOn.js`。
+- 回滚方式：恢复 `BusinessPrefixesPage.jsx` 本次修改并重新构建发布；或将 B `public`/`apps/web/dist` 恢复为上一版前端静态资源。
+- 未解决问题：未使用真实浏览器逐页点击复测；请用户刷新页面后重新进入“业务前缀管理”确认。
+- 下一任务：等待用户复测反馈。
+
+### 2026-06-28 16:31 - 修复 B 登录 500：补齐 Argon2id wasm 发布文件
+
+- 状态：已完成
+- 操作服务器：B
+- 完成内容：
+  - 根据 B `lisglosips@api` 日志定位 `/api/v2/auth/login` 500 根因：当前 `s43` release 缺少 `packages/auth/vendor/argon2id/dist/no-simd.wasm`，导致密码校验加载 wasm 失败。
+  - 从上一可用 release `/opt/lisglosips/releases/s42-phase2-business-prefix-20260624140000` 复制 `no-simd.wasm` 与 `simd.wasm` 到当前 release `/opt/lisglosips/releases/s43-bugfix-cdr-quality-rbac-20260624184854`。
+  - 调整文件属主与权限为 `root:lisglosips`、`0640`，重启 `lisglosips@api`。
+  - 在 B 当前 release 内执行 Argon2id hash/verify 冒烟，返回 `argon2-smoke-ok`。
+  - 本地将 `packages/auth/vendor/argon2id/dist/no-simd.wasm` 与 `packages/auth/vendor/argon2id/dist/simd.wasm` 使用 `git add -f` 纳入 Git 跟踪，避免后续发布包再遗漏。
+- 修改文件：B 当前 release 新增/补齐 `packages/auth/vendor/argon2id/dist/no-simd.wasm`、`packages/auth/vendor/argon2id/dist/simd.wasm`；本地暂存上述两个 wasm 文件，并更新 `IMPLEMENTATION_STATUS.md`。
+- 安装软件及固定版本：未安装新软件。
+- 执行的关键命令：`journalctl -u lisglosips@api`、`cp -a`、`chown`、`chmod`、`systemctl restart lisglosips@api`、`curl http://127.0.0.1:3000/api/v2/health/ready`、B Argon2id hash/verify 冒烟、`git add -f packages/auth/vendor/argon2id/dist/*.wasm`。
+- 验证结果：B `lisglosips@api` active；API ready 返回 ok；Argon2id wasm 冒烟通过。用户可重新尝试 Web 登录；未使用或回显用户密码。
+- 回滚方式：如需回滚本次运行修复，可删除 B 当前 release 的两个 wasm 文件并重启 API，但会恢复登录 500；推荐回滚方式仍是将 B `current` 指回 `/opt/lisglosips/releases/s42-phase2-business-prefix-20260624140000` 后重启 API/Worker。
+- 未解决问题：`refresh 401` 在无有效登录态时仍属预期；需用户重新登录确认前端流程。
+- 下一任务：等待用户复测反馈。
+
+### 2026-06-28 16:25 - 启动 A/B/T 本地联调环境供功能检查
+
+- 状态：已完成
+- 操作服务器：A、B、T
+- 完成内容：
+  - A：确认 `opensips`、`lisglosips-redis-auth-proxy`、`rtpengine`、`rtpengine-recording-daemon`、`lisglosips-node-exporter` 均为 active；未修改 A 配置。
+  - B：确认当前 release 为 `/opt/lisglosips/releases/s43-bugfix-cdr-quality-rbac-20260624184854`；启动此前 inactive 的 `lisglosips@recording-worker` 与 `lisglosips@config-publisher`；确认 MySQL、Redis、Nginx、API、CDR Worker、Recording Worker、Config Publisher、HEP、Prometheus、Grafana 均为 active。
+  - T：发现 `opensips` 为 failed；执行 `systemctl reset-failed opensips` 与 `systemctl restart opensips` 后恢复 active；确认 `rtpengine`、`apache2`、`mariadb`、`lisglosips-s28-uas` 均为 active。
+- 修改文件：本地更新 `IMPLEMENTATION_STATUS.md`；服务器未修改配置文件，未执行数据库 migration，未改防火墙。
+- 安装软件及固定版本：未安装新软件。
+- 执行的关键命令：`systemctl is-active`、B `systemctl start lisglosips@recording-worker lisglosips@config-publisher`、T `systemctl reset-failed opensips && systemctl restart opensips`、B `lisglosips-release-preflight.sh`、`curl http://127.0.0.1:3000/api/v2/health/ready`、`curl -k https://127.0.0.1/`、`ss -lunpt`。
+- 验证结果：
+  - A OpenSIPS 配置 SHA-256 仍为 `ae1544e9a39d2db114e6981babac042c2ab6d399d59ba597a52b85d597aa5aa5`，Lua SHA-1 仍为 `0b7ee595cdcad2f38a670dd8ff3553387820039e`；A 监听 `100.90.90.90:15060/udp`。
+  - B preflight 通过；API ready 返回 ok；HTTPS 首页返回 200，加载 `/assets/index-BudcefOn.js` 与 `/assets/index-B2uYBtS3.css`。
+  - T `opensips` active，监听 `100.93.185.30:5060/udp`；UAS 监听 `100.93.185.30:50620/udp`。
+- 回滚方式：如需停止本次启动项，可停止 B 的 `lisglosips@recording-worker`、`lisglosips@config-publisher`，以及按需停止 T `opensips`；B 应用回滚仍可将 `/opt/lisglosips/current` 指回 `/opt/lisglosips/releases/s42-phase2-business-prefix-20260624140000` 后重启服务。
+- 未解决问题：未执行真实呼叫；T OpenSIPS 曾处于 failed，已恢复但未进一步分析失败前原因。
+- 下一任务：等待用户功能检查反馈。
+
+### 2026-06-24 18:58 - 需求修改/二期变更：Bug 修复发布到 B
+
+- 状态：已完成
+- 操作服务器：B；A 只读核对；T 未操作
+- 完成内容：
+  - 已将本地 Git 提交 `a86de65 feat: complete phase2 baseline cdr quality rbac` 构建并发布到 B 新 release：`/opt/lisglosips/releases/s43-bugfix-cdr-quality-rbac-20260624184854`。
+  - 发布内容包含：CDR 后端/API 前端接线、质检中心真实 API、前端页面拆分、权限驱动导航和按钮裁剪。
+  - 切换前 B 当前 release 为 `/opt/lisglosips/releases/s42-phase2-business-prefix-20260624140000`，已作为直接回滚点保留。
+  - 切换前执行 B preflight 通过，并生成 MySQL/Redis 备份：`/data/backups/mysql/20260624T104812Z`、`/data/backups/redis/20260624T104812Z`，SHA256 校验通过。
+  - 首次切换 `s43` 时发现 release 组装缺少 workspace 级 `apps/*/node_modules` 和部分 `packages/*/node_modules` 链接，服务报 `ERR_MODULE_NOT_FOUND`；已立即回滚到 `s42`，确认 API ready 200；随后补齐链接、完成模块解析冒烟后再次切换到 `s43` 成功。
+  - A 侧只读核对：运行中 OpenSIPS 配置 SHA-256 仍为 `ae1544e9a39d2db114e6981babac042c2ab6d399d59ba597a52b85d597aa5aa5`，Lua SHA-1 仍为 `0b7ee595cdcad2f38a670dd8ff3553387820039e`；本次 Bug 修复不需要发布 A，且仓库 `infra/server-a/s28/opensips.cfg` 含部署模板占位符 `@@LISGLOSIPS_REDIS_URL@@`，不能直接覆盖运行中 A 配置。
+- 修改文件：本地更新 `IMPLEMENTATION_STATUS.md`；服务器新增 B release 目录 `/opt/lisglosips/releases/s43-bugfix-cdr-quality-rbac-20260624184854`，未修改数据库 schema，未执行 Prisma migration。
+- 安装软件及固定版本：未安装新软件；复用 B 既有 Node.js `v22.22.2`、pnpm 依赖和 systemd 模板。
+- 执行的关键命令：本地 `corepack pnpm@10.33.0 build`；B `lisglosips-release-preflight.sh`、`systemctl start lisglosips-backup.service`、`sha256sum -c`、创建 release、切换 `/opt/lisglosips/current`、重启 `lisglosips@api`、`lisglosips@cdr-worker`、`lisglosips@recording-worker`、`lisglosips@config-publisher`、`nginx -t`、`systemctl reload nginx`、`curl http://127.0.0.1:3000/api/v2/health/ready`、`curl -k https://127.0.0.1/`。
+- 验证结果：
+  - 本地 build 通过。
+  - B 当前 release 为 `/opt/lisglosips/releases/s43-bugfix-cdr-quality-rbac-20260624184854`。
+  - B `mysql`、`redis-server`、`nginx`、`lisglosips@api`、`lisglosips@cdr-worker`、`lisglosips@recording-worker`、`lisglosips@config-publisher` 均为 active。
+  - B API ready 返回 `{"status":"ok","service":"api",...}`。
+  - B preflight 通过；HTTPS 首页返回 200，并加载新前端资产 `/assets/index-BudcefOn.js` 与 `/assets/index-B2uYBtS3.css`。
+  - A OpenSIPS/Lua 哈希与冻结报告一致，未执行 A 侧写操作或重启。
+- 回滚方式：在 B 执行 `sudo ln -sfn /opt/lisglosips/releases/s42-phase2-business-prefix-20260624140000 /opt/lisglosips/current`，然后重启 `lisglosips@api lisglosips@cdr-worker lisglosips@recording-worker lisglosips@config-publisher` 并执行 preflight；本次未做数据库迁移，通常不需要数据库回滚。
+- 未解决问题：未执行 A/B/T 实呼验收；用户需在 B Web 登录态逐页复测权限按钮、CDR、质检、录音播放和信令入口；真实录音文件播放与 Nginx X-Accel 链路仍需用实际文件复核。
+- 下一任务：等待用户测试反馈或指定下一项。
+
 ### 2026-06-24 17:50 - 需求修改/二期变更：权限驱动导航和按钮

 - 状态：已完成