hectorzhao/lisglosips

Fork 0

Files

T

hectorzhao 7057fd3c42 feat: add number library routing and cdr location support

2026-06-24 11:39:32 +08:00

164 KiB

Raw Blame History

LisgloSIPS V2 实施状态

本文件用于跨 Codex 会话持续交接。每次新会话开始必须先读取本文件和 SOFTSWITCH_PLATFORM_DESIGN_V2.md；每次任务完成、失败或被阻塞后必须更新本文件。

当前状态

当前任务：需求修改/二期变更：号码库第 6、7 步本地实现并提交 Git
总体状态：S30 已完成；本地 KVM 开发环境 V2 闭环原冻结 release 为 s28-v2-20260621220924，当前 B release 仍为 s33-active-calls-20260623094000，已在该 release 上覆盖发布 s41 用户/角色删除小改；A /etc/opensips/opensips.cfg 已将 fr_inv_timeout 从 30 临时调为 95 并重启；T 已新增 /opt/lisglosips-s40/lisglosips-s40-virtual-calls.py 并启动 10 路虚拟呼叫场景；号码库第 1-7 步已完成本地代码基线，尚未发布到 B/A、尚未执行 MySQL migration、尚未导入真实 80 万号段；阿里云迁移前需按 S30 Runbook 重新演练
最后更新：2026-06-24 11:41 +08:00
当前阻塞：无。遗留风险为 Redis 恢复后 OpenSIPS 热路径可能需要重启 opensips 才恢复，已纳入 S30 Runbook；本次发现并补齐 B config-publisher.env，当前 lisglosips@config-publisher 已 active。
当前环境：A/B/T 为本地 KVM 开发服务器，通过 Tailscale 联调；开发完成后再迁移阿里云
私密访问资料：.codex-private/SERVER_ACCESS.md，只在实际连接时读取，禁止回显

服务器索引

代号	地址	用户	用途
A	`100.90.90.90`	`hector`	OpenSIPS、RTPEngine、录音内存盘、HEP、Exporter
B	`100.90.90.91`	`hector`	API、Worker、Redis、MySQL、录音、HOMER、Prometheus/Grafana
T	`100.93.185.30`	`hector`	已安装 OpenSIPS，模拟客户 SIP 注册与呼叫

任务状态表

状态只能使用：待开始、进行中、已完成、已阻塞、已跳过。

ID	任务	状态	主要产物/验收
S00	SSH 安全接入与凭据迁移	已完成	三机 SSH Key、密码轮换、访问验证、访问 Runbook；后续 SSH 加固只调整管理端口并保留 Key 登录
S01	三机只读资产盘点	已完成	`docs/inventory-A.md`、`inventory-B.md`、`inventory-T.md`、汇总报告
S02	网络与安全组验收	已完成	`docs/infra-check.md`，含本地端口矩阵和未来阿里云安全组清单
S03	Server B 基础系统初始化	已完成	`docs/SERVER_B_BASELINE_RUNBOOK.md`、`infra/server-b/s03/`、远端备份
S04	Server B MySQL 与 Redis	已完成	`docs/SERVER_B_DATA_SERVICES_RUNBOOK.md`、`infra/server-b/s04/`、备份恢复演练
S05	Server B Node.js、Nginx 与 TLS 基线	已完成	`docs/SERVER_B_WEB_RUNTIME_RUNBOOK.md`、`infra/server-b/s05/`、HTTPS 与重启验收
S06	Server B HOMER 与基础监控	已完成	HEP 接收、HOMER API、Prometheus、Grafana、exporters、A Node Exporter
S07	V2 后端 Monorepo 骨架	已完成	NestJS/Fastify/Prisma、日志、配置、健康检查、测试框架；本地和 B 均可构建
S08	数据库 Schema 与迁移	已完成	Prisma Schema、初始化迁移、内置角色/权限种子、B 临时空库迁移和备份恢复测试
S09	登录认证基础	已完成	登录、刷新、退出、Argon2id、Session/Token 安全
S10	用户、角色、权限与审计	已完成	RBAC、内置角色保护、重置密码、审计拦截器
S11	客户管理 API	已完成	客户 CRUD、启停、余额/授信读取、单元与集成测试
S12	充值与不可变余额流水	已完成	客户/供应商充值、幂等、事务、审计、并发测试
S13	客户网关 API	已完成	IP/SIP 注册认证配置、启停、密码安全存储
S14	客户网关策略与 Redis 配置发布	已完成	主被叫匹配、优先级、Outbox、配置版本和回滚
S15	供应商管理 API	已完成	供应商 CRUD、余额/授信、启停
S16	落地网关 API	已完成	CPS/并发/时段/编码/号码转换/周期费率/启停
S17	落地线路组 API	已完成	成员增删、优先级重排、并发汇总、完整性校验
S18	Server A OpenSIPS 基线	已完成	15060、认证、防扫描、MI 本地绑定、Redis/HEP 模块
S19	Server A RTPEngine 与录音 tmpfs	已完成	内核转发、RTP 端口段、3 GiB tmpfs、录音 ready 规则
S20	Server A Redis 热路径与 HEP/指标	已完成	Lua 原子检查、配置读取、HEP 9060、Node Exporter
S21	Server T 客户模拟配置	已完成	IP/SIP 注册两套测试账号、呼叫脚本、失败场景脚本
S22	CDR Redis Stream	已完成	标准事件、XADD/XREADGROUP、ACK、Pending、死信、幂等
S23	最小计费与余额扣减	已完成	Decimal 计费、客户费用/成本、重复 CDR 不重复扣费
S24	录音搬运与播放	已完成	A->B 私网搬运、校验、Range、权限、源文件安全删除
S25	质检后端	已完成	抽检规则、稳定抽样、录音详情、质检保存和审计
S26	Dashboard 聚合	已完成	实时占位/聚合指标、趋势、失败码、异常网关、待质检
S27	React Demo 接入真实 API	已完成	API Client、核心运营页真实 API、错误/加载/空状态
S28	三机端到端联调	已完成	T 发起呼叫，A 转发录音，B 出 CDR/费用/信令/质检
S29	性能、故障与安全测试	已完成	CPS/并发/录音、Redis/MySQL/Worker 故障、越权与重放
S30	备份、Runbook、灰度与上线	已完成	恢复演练、上线/回滚脚本、灰度记录、验收报告

每次新会话的固定开场指令

可直接向 Codex 发送：

请先读取 SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md，
以及本任务关联的现有脚本/代码。只执行状态文件里的当前任务，不提前执行后续任务。
开始前复核上次交接记录；涉及服务器写操作、服务重启、防火墙、密码、数据库迁移或数据删除时先说明影响和回滚点。
完成后运行验收检查，并更新 IMPLEMENTATION_STATUS.md 的任务状态、产物、验证结果、遗留问题和下一任务。

单任务交接记录模板

每完成一个任务，在本节顶部新增记录：

### YYYY-MM-DD HH:mm - Sxx 任务名称

- 状态：已完成 / 已阻塞
- 操作服务器：A / B / T / 本地
- 完成内容：
- 修改文件：
- 安装软件及固定版本：
- 执行的关键命令：只记录无密码版本
- 验证结果：
- 回滚方式：
- 未解决问题：
- 下一任务：Sxx

交接记录

2026-06-24 11:41 - 需求修改/二期变更：号码库第 6、7 步本地实现

状态：已完成本地代码；准备提交 Git；未发布到 B/A，未执行数据库迁移，未重启服务
操作服务器：本地
完成内容：CDR Stream 契约新增可选号码识别快照字段，并保持旧 Stream/pending 消息兼容；CDR Worker 入库 raw_cdrs 时写入 calleeCityCode、calleeCityName、calleeProvinceName、calleeOperator、calleeNumberType。新增 CdrsModule，提供 GET /api/v2/cdrs 与 GET /api/v2/cdrs/:id，复用 cdr.view 权限，支持主叫、被叫、客户网关、落地网关、地级市代码、运营商分页筛选，并返回客户/网关/线路组名称与 rated CDR 费用。Web 话单中心改为读取真实 CDR API，列表和详情展示地级市、运营商、号码类型、SIP 状态码、客户费用、成本和毛利。
修改文件：packages/redis/src/cdr-stream.ts、packages/redis/src/cdr-stream.spec.ts、apps/worker-cdr/src/rating.ts、apps/worker-cdr/src/rating.spec.ts、apps/api/src/modules/app.module.ts、apps/api/src/modules/cdrs/cdrs.module.ts、apps/api/src/modules/cdrs/cdrs.controller.ts、apps/api/src/modules/cdrs/cdrs.service.ts、apps/api/src/modules/cdrs/cdrs.repository.ts、apps/api/src/modules/cdrs/cdrs.service.spec.ts、apps/web/src/api.js、apps/web/src/App.jsx、SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件；继续使用 pnpm 10.33.0、Prisma 6.19.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 vitest run packages/redis/src/cdr-stream.spec.ts apps/worker-cdr/src/rating.spec.ts apps/api/src/modules/cdrs/cdrs.service.spec.ts、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 build
验证结果：typecheck 通过；目标测试 3 个文件、13 条测试通过；lint 通过；workspace build 通过；第一次将全量 test 与 build 并行执行时 3 个依赖本地服务的 e2e beforeAll 因资源争用超时，随后单独重跑 corepack pnpm@10.33.0 test 通过，25 个测试文件、85 条测试全部通过。
回滚方式：恢复上述文件即可；本次未连接服务器、未发布 B/A、未写 Redis、未执行 MySQL migration、未重启 OpenSIPS，因此无远端回滚项。后续若发布，B 发布前需备份 MySQL 和当前 release；A 发布仍需先备份 OpenSIPS 配置/Lua 并执行 opensips -C -f。
未解决问题：真实 80 万号段文件导入、Redis 发布容量评估、落地网关屏蔽地区 API/Web 管理入口、A/B/T 地区屏蔽端到端验收仍未实施；当前 CDR API 已能显示新字段，但历史话单在迁移前/旧消息场景下会显示 UNKNOWN 或 -。
下一任务：提交 Git 后，建议优先补落地网关屏蔽地区管理入口和大批量号码库导入 Runbook，再安排 B/A 发布与 A/B/T 验收。

2026-06-24 11:31 - 需求修改/二期变更：号码库第 4、5 步本地实现

状态：已完成本地代码；未发布到 B/A，未执行数据库迁移，未重启服务
操作服务器：本地
完成内容：Config Publisher 快照新增地级市、手机 7 位号段、固话区号、运营商前缀和落地网关屏蔽地区；Redis 写入版本化 geo_city、phone_segment、area_code、carrier_prefix key，以及 vendor_gateway:{id}:blocked_city_codes/blocked_province_codes set。号码库导入新增 number_library_config outbox，导入后可触发发布器生成新快照。S28 OpenSIPS Lua 热路径新增被叫号码规范化、手机 7 位号段解析、固话区号解析、运营商前缀解析、落地网关城市/省份屏蔽跳过逻辑；全部可用网关都被地区屏蔽时返回 NO_VENDOR_ROUTE_REGION_BLOCKED。S28 opensips.cfg 更新 Lua SHA1、读取追加返回字段，并在成功/失败 CDR Stream 中携带 callee_city_code、callee_city_name、callee_province_name、callee_operator、callee_number_type。
修改文件：apps/worker-config-publisher/src/publisher.ts、apps/worker-config-publisher/src/publisher.spec.ts、apps/api/src/modules/number-library/number-library.repository.ts、infra/server-a/s28/lisglosips_hotpath.lua、infra/server-a/s28/opensips.cfg、SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件；继续使用 pnpm 10.33.0、Prisma 6.19.0。
执行的关键命令：corepack pnpm@10.33.0 vitest run apps/worker-config-publisher/src/publisher.spec.ts apps/api/src/modules/number-library/number-library.e2e.spec.ts、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 build、Get-FileHash -Algorithm SHA1 infra/server-a/s28/lisglosips_hotpath.lua
验证结果：目标测试 2 个文件、4 条测试通过；typecheck 通过；lint 通过；全量 Vitest 24 个测试文件、82 条测试通过；workspace build 通过；本机无 lua、无 opensips 命令，因此未在本地执行 Lua 解释器语法检查和 opensips -C。
回滚方式：恢复上述本地文件即可；本次未连接服务器、未发布 B/A、未写 Redis、未执行 MySQL migration、未重启 OpenSIPS，因此无远端回滚项。后续若发布：B 需先备份 MySQL/Redis 和当前 release，回滚 Redis 可切回 cfg:previous_version；A 需先备份 /etc/opensips/opensips.cfg 与 /etc/opensips/lisglosips_hotpath.lua，回滚时恢复备份、执行 opensips -C -f /etc/opensips/opensips.cfg 通过后重启 OpenSIPS。
未解决问题：第 6 步 CDR Worker 尚未把 callee_city_code、callee_city_name、callee_province_name、callee_operator、callee_number_type 入库到 raw_cdrs 新字段；落地网关屏蔽地区仍缺少 Web/API 管理入口；真实 80 万号段文件导入、Redis 发布容量评估、A/B/T 端到端地区屏蔽验收仍未执行。
下一任务：建议第 6 步改造 CDR Stream/Worker 入库号码识别字段，并补落地网关屏蔽地区的 API/Web 管理入口后，再安排 B/A 发布和 A/B/T 验收。

2026-06-24 11:15 - 需求修改/二期变更：号码库第 3 步 Web 本地实现

状态：已完成本地代码；未发布到 B，未执行数据库迁移
操作服务器：本地
完成内容：新增 Web “号码库”运营菜单，页面包含地级市字典、手机号码库、城市区号、运营商号码段规则四个 Tab。每个 Tab 接入 /number-library/* API，支持服务端查询入口、筛选、刷新、总数显示和批量 JSON 导入弹窗；导入成功后刷新当前 Tab。同步更新 V2 设计文档，将号码库菜单从三个 Tab 调整为四个 Tab，并补充第 3 步本地实施状态。
修改文件：apps/web/src/api.js、apps/web/src/App.jsx、SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件；继续使用 pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build、corepack pnpm@10.33.0 test
验证结果：typecheck 通过；lint 通过；workspace build 通过；第一次将 test 与 build 并行执行时 5 个依赖本地服务的 e2e beforeAll 因资源争用超时，随后单独重跑 corepack pnpm@10.33.0 test 通过，23 个测试文件、81 条测试全部通过。
回滚方式：恢复 apps/web/src/api.js、apps/web/src/App.jsx、SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md 本次改动即可；本次未连接服务器、未发布 B、未执行 MySQL migration、未写入 Redis、未重启服务，因此无远端回滚项。
未解决问题：号码库前端当前使用批量 JSON 导入，只适合小批验证和接口联调；真实 80 万号段仍需文件导入/后台任务/进度与失败明细。号码解析服务、Config Publisher Redis 快照、OpenSIPS/Lua 屏蔽地区跳转、CDR Worker 新字段入库、话单中心展示与 A/B/T 端到端验收仍未实施。
下一任务：建议第 4 步实现 Config Publisher/Redis 热路径快照前，先补大批量导入任务 Runbook 和文件导入接口，避免把 80 万号段通过普通 JSON 表单导入。

2026-06-24 11:07 - 需求修改/二期变更：号码库第 1、2 步本地实现

状态：已完成本地代码；未发布到 B，未执行数据库迁移
操作服务器：本地
完成内容：完成号码库第 1、2 步本地基线。Prisma Schema 和迁移新增 geo_cities、phone_number_segments、phone_area_codes、carrier_prefix_rules、vendor_gateway_blocked_regions，并在 raw_cdrs 预留被叫地级市、省份、运营商和号码类型快照字段。新增 NumberLibraryModule，提供城市、手机 7 位号段、固话区号、运营商前缀规则的分页查询与批量 upsert 导入 API，单批限制 1000 条，接入 RBAC 和审计。新增权限 number_library.view、number_library.manage 并写入 seed；更新 schema contract 和号码库 e2e 测试。
修改文件：prisma/schema.prisma、prisma/migrations/20260624095000_number_library/migration.sql、apps/api/src/modules/app.module.ts、apps/api/src/modules/number-library/number-library.module.ts、apps/api/src/modules/number-library/number-library.controller.ts、apps/api/src/modules/number-library/number-library.service.ts、apps/api/src/modules/number-library/number-library.repository.ts、apps/api/src/modules/number-library/number-library.e2e.spec.ts、packages/auth/src/index.ts、packages/database/src/schema-contract.spec.ts、prisma/seed.ts、SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件；继续使用 Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 prisma format、corepack pnpm@10.33.0 prisma:validate、corepack pnpm@10.33.0 prisma:generate、corepack pnpm@10.33.0 vitest run apps/api/src/modules/number-library/number-library.e2e.spec.ts packages/database/src/schema-contract.spec.ts、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 build
验证结果：Prisma format/validate/generate 通过；号码库 e2e 与 schema contract 共 8 条测试通过；typecheck 通过；lint 通过；全量 Vitest 23 个测试文件、81 条测试通过；workspace build 通过。
回滚方式：恢复上述本地文件改动即可；因为未连接服务器、未发布 B、未执行 MySQL migration、未导入真实数据，所以无远端回滚项。若后续发布到 B，执行迁移前必须先备份 B MySQL；回滚需恢复迁移前备份或执行经验证的反向迁移，并清理新增权限/seed 变更。
未解决问题：真实 80 万号段文件导入、导入任务进度/失败明细、号码解析服务、Config Publisher Redis 发布、OpenSIPS/Lua 屏蔽地区跳转、CDR Worker 入库新字段、话单中心展示与筛选、A/B/T 端到端验收仍未实施。
下一任务：建议第 3 步 Web “号码库”菜单和三个 Tab；或先实现第 4 步 Config Publisher/Redis 快照结构前的导入任务 Runbook。

2026-06-24 09:48 - 需求修改/二期变更：号码库与屏蔽地区路由需求评估

状态：已完成
操作服务器：本地
完成内容：评估新增“号码库”菜单及手机号码库、城市区号、运营商号码段规则三个 Tab 的影响范围；明确需要新增地级市字典 geo_cities，用于手机 7 位号段、固话区号、落地网关屏蔽地区和 CDR 快照统一引用；明确每通话单需要保存被叫地级市、省份、运营商和号码类型快照；明确落地网关屏蔽地区应在 OpenSIPS/Lua 热路径中跳过当前网关并尝试同一线路组下一落地网关。已将需求、数据模型建议、Redis 热路径结构、CDR 字段、路由规则、风险和 8 步实施拆分写入 SOFTSWITCH_PLATFORM_DESIGN_V2.md，文档版本升级为 V2.2。
修改文件：SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件。
执行的关键命令：rg 检查现有 Schema、CDR Stream、OpenSIPS Lua 和 Web 中的地区/运营商/屏蔽地区相关实现；文档更新后用 rg 校验 V2.2、号码库、geo_cities、phone_number_segments、carrier_prefix_rules、vendor_gateway_blocked_regions、NO_VENDOR_ROUTE_REGION_BLOCKED 等关键条目。
验证结果：本次为需求评估和 Markdown 文档更新，未运行 typecheck/lint/test/build；未连接服务器，未做数据库迁移、服务重启或数据导入。
回滚方式：恢复 SOFTSWITCH_PLATFORM_DESIGN_V2.md 和 IMPLEMENTATION_STATUS.md 本次文档改动即可；不涉及 B release、MySQL、Redis、OpenSIPS、RTPEngine、Worker 或 Web 发布回滚。
未解决问题：真实实施前仍需确认号码库数据来源、更新频率、导入格式、行政区划编码口径、运营商枚举口径、省级屏蔽是否需要、以及 80 万号段导入对 MySQL/Redis 内存和发布耗时的影响。
下一任务：如确认实施，建议从“数据建模与迁移 + 导入 Runbook”单独开工，不要与 OpenSIPS 热路径改造混在同一次发布。

2026-06-24 09:31 - 需求修改/二期变更：用户与角色删除

状态：已完成
操作服务器：本地、B
完成内容：用户管理新增红色“删除”按钮和自研确认弹窗，确认后调用 DELETE /api/v2/users/:id；角色与权限新增红色“删除”按钮和自研确认弹窗，内置角色前端禁用删除，后端同时保护内置角色并在角色仍有关联用户时拒绝删除。后端用户删除为软删除：禁用账号、写入 deletedAt、清理用户角色关联以释放角色用户数；角色删除为软删除：禁用角色并写入 deletedAt。两个删除接口均接入 RBAC users.manage/roles.manage 和审计日志。未改 Prisma Schema，未执行数据库迁移。
修改文件：apps/api/src/modules/users/users.controller.ts、apps/api/src/modules/users/users.service.ts、apps/api/src/modules/users/users.repository.ts、apps/api/src/modules/roles/roles.controller.ts、apps/api/src/modules/roles/roles.service.ts、apps/api/src/modules/roles/roles.repository.ts、apps/api/src/modules/security/security-rbac-audit.e2e.spec.ts、apps/api/src/modules/users-roles-delete.e2e.spec.ts、apps/web/src/App.jsx、apps/web/src/api.js、IMPLEMENTATION_STATUS.md；B 当前 release /opt/lisglosips/releases/s33-active-calls-20260623094000 中已覆盖 API/Web dist。
安装软件及固定版本：未安装新软件。
执行的关键命令：本地 corepack pnpm@10.33.0 vitest run apps/api/src/modules/users-roles-delete.e2e.spec.ts、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 build；B tar --no-same-owner -xzf 覆盖当前 release API/Web dist、systemctl restart lisglosips@api、nginx -t、systemctl reload nginx、curl http://127.0.0.1:3000/api/v2/health/ready。
验证结果：新增用户/角色删除 E2E 3 条通过；typecheck 通过；lint 通过；全量 Vitest 22 个测试文件、77 条测试通过；workspace build 通过。B lisglosips@api 与 nginx active，API ready 返回 config/database/redis 均 ok；服务日志确认已映射 DELETE /api/v2/users/:id 与 DELETE /api/v2/roles/:id；Web 首页 https://100.90.90.91/ 返回 200 并引用新构建资源。
回滚方式：B 已备份覆盖前 dist 到 /var/backups/lisglosips-s41-user-role-delete/20260624T092950/api-dist 与 /var/backups/lisglosips-s41-user-role-delete/20260624T092950/web-dist；如需回滚，将两目录恢复到 /opt/lisglosips/releases/s33-active-calls-20260623094000/apps/api/dist 与 /opt/lisglosips/releases/s33-active-calls-20260623094000/apps/web/dist，重启 lisglosips@api 并执行 nginx -t && systemctl reload nginx。本次无数据库 schema migration；若已通过新功能误删用户/角色，删除为软删除，需要在维护窗口受控恢复对应 deleted_at/status，用户还需按审计和业务确认恢复 user_roles 关联。
未解决问题：用户管理、角色与权限的新增/编辑/启停仍沿用旧的前端本地态实现，未纳入本次需求重构；未做 A/B/T SIP 端到端，因为本次只涉及 B API/Web 管理面，不影响 Redis 热路径、OpenSIPS、RTPEngine、Worker 或三机呼叫链路。
下一任务：等待下一个二期需求。

2026-06-23 22:07 - 需求修改/二期变更：S30 后需求写入 V2 设计文档

状态：已完成
操作服务器：本地
完成内容：将 S30 以后用户新增需求整理进 SOFTSWITCH_PLATFORM_DESIGN_V2.md，文档版本从 V2.0 调整为 V2.1，新增“25.5 S30 后二期需求变更”章节；同步更新 V2 范围表，纳入当前通话、受控删除、网关/线路组计数、人工充值记录语义、待设计菜单隐藏等内容；补充登录验证码、当前通话和强制挂断、删除/启停确认、充值与计费流水语义、动态路由和 CDR 补齐、前端交互、10 路虚拟呼叫测试工具、二期回归要求；修正 S27 描述中“待设计菜单继续保留标识”的旧表述。
修改文件：SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件。
执行关键命令：rg 检查 V2 文档关键章节和条目；git diff -- SOFTSWITCH_PLATFORM_DESIGN_V2.md --stat 复核文档差异。
验证结果：文档已包含 V2.1 状态、当前通话实施范围、待设计菜单隐藏说明、“25.5 S30 后二期需求变更”及 25.5.1-25.5.8 子章节；本次为纯 Markdown 文档更新，未运行 typecheck/lint/build。
回滚方式：恢复 SOFTSWITCH_PLATFORM_DESIGN_V2.md 和 IMPLEMENTATION_STATUS.md 本次文档改动即可；不涉及服务器、数据库、Redis、OpenSIPS、RTPEngine 或 Worker 回滚。
未解决问题：S40 10 路虚拟呼叫完整场景此前仍在 T 后台运行，本文档更新未等待其全程结束；若需确认最终结果，应继续查看 /tmp/lisglosips-s40-virtual-calls-20260623T215430.log。

2026-06-23 21:51 - 需求修改/二期变更：10 路虚拟呼叫测试工具与当前通话自动刷新

状态：已完成工具部署，完整 10 路场景已启动并运行中
操作服务器：A、B、T、本地
完成内容：当前通话页面新增默认开启的 5 秒自动刷新开关，保留手动刷新；T 新增 /opt/lisglosips-s40/lisglosips-s40-virtual-calls.py，可按 15 秒间隔发起 10 路虚拟呼叫，前 5 路先回 180 Ringing、45 秒后 200 OK、保持 600 秒后 BYE，后 5 路先回 180 Ringing、70 秒后 480 Temporarily Unavailable。脚本默认使用当前已打通策略的主叫 s36-1001、被叫 13800136036，并按 Call-ID 序号区分接通/不接通场景。首次完整场景暴露 A fr_inv_timeout=30 会在 45 秒接通前返回 408，已将 A OpenSIPS fr_inv_timeout 临时调为 95 并重启后重新启动场景。
修改文件：apps/web/src/App.jsx、infra/server-t/s40/lisglosips-s40-virtual-calls.py、infra/server-a/s28/opensips.cfg、IMPLEMENTATION_STATUS.md；B 当前 release /opt/lisglosips/releases/s33-active-calls-20260623094000 中已覆盖 apps/web/dist；T 已部署 /opt/lisglosips-s40；A 已就地修改 /etc/opensips/opensips.cfg。
安装软件及固定版本：未安装新软件；继续使用 Node.js v22.22.2、pnpm 10.33.0、Vite 5.4.21、T 既有 Python 3.12。
执行关键命令：本地 corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；B tar -xzf 覆盖 web dist、nginx -t、systemctl reload nginx、curl -sk https://127.0.0.1/；T python3 -m py_compile /opt/lisglosips-s40/lisglosips-s40-virtual-calls.py、短烟测 --total 1 --answer-ring 2 --hold 3、后台启动完整场景；A opensips -C -f /etc/opensips/opensips.cfg、systemctl restart opensips。
验证结果：本地 typecheck/lint/build 均通过；B nginx 配置测试通过且 active，首页 HTML 返回新资源 /assets/index-DwIXfg91.js 和 /assets/index-TA3aiKvG.css；T 脚本 Python 编译通过。短烟测先发现 50620 被旧 S28 UAS 占用且新号码无策略，已调整为临时停旧 UAS、固定主叫/被叫并按 Call-ID 分流；最终 1 路短烟测通过：收到 100 Giving it a try、180 Ringing、延迟后 200 OK、3 秒后 BYE 且 UAS 返回 200 OK。首次完整场景因 A fr_inv_timeout=30 导致 45 秒接通前被 A 返回 408，已停止并恢复旧 UAS；A 超时调为 95 后重新启动完整场景，PID 32120，日志 /tmp/lisglosips-s40-virtual-calls-20260623T215430.log，已验证第 1、2 路均在 45 秒后收到 200 OK 并进入 connected hold=600.0s。
回滚方式：B 前端回滚可从 /var/backups/lisglosips-s40-active-calls-autorefresh/20260623T214444/web-dist 恢复当前 release 的 apps/web/dist，再执行 nginx -t && systemctl reload nginx。A 超时回滚可从 /var/backups/lisglosips-s40-fr-inv-timeout/20260623T215330/opensips.cfg 恢复 /etc/opensips/opensips.cfg，再执行 opensips -C -f /etc/opensips/opensips.cfg && systemctl restart opensips。T 脚本回滚可删除 /opt/lisglosips-s40，或从 /var/backups/lisglosips-s40-virtual-calls/20260623T214907/lisglosips-s40 恢复上一版。若需提前停止完整场景：在 T 执行 sudo pkill -f /opt/lisglosips-s40/lisglosips-s40-virtual-calls.py，然后确认 100.93.185.30:50620 有旧 S28 UAS；若未恢复，执行 sudo nohup runuser -u nobody -- /usr/bin/python3 /opt/lisglosips-s28/lisglosips-s28-sip.py uas --host 100.93.185.30 --port 50620 >/tmp/lisglosips-s28-uas.log 2>&1 &。
未解决问题：完整 10 路场景仍在运行中，尚未等待约 12 分钟全程结束；测试会产生真实本地开发环境呼叫事件和少量计费/失败 CDR，使用的是现有 S36 测试客户网关/路由。当前通话页面观察地址为 https://100.90.90.91/。

2026-06-23 18:38 - 需求修改/二期变更：话单详情弹窗布局重排

状态：已完成
操作服务器：B、本地
完成内容：话单中心“查看详情”抽屉内部从单列 KeyValue 堆叠调整为主被叫概览、通话摘要、链路信息、时间轴和录音/信令操作分区；新增专用 cdr-detail 系列样式，移动端自动切为单列；补充本地 Icon 的 arrow 图标用于主叫到被叫方向展示。
修改文件：apps/web/src/App.jsx、apps/web/src/styles.css、IMPLEMENTATION_STATUS.md；B 当前 release /opt/lisglosips/releases/s33-active-calls-20260623094000 中已覆盖 apps/web/dist。
安装软件及固定版本：未安装新软件；继续使用 Node.js v22.22.2、pnpm 10.33.0、Vite 5.4.21。
执行关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build、B tar -xzf 覆盖 web dist、nginx -t、systemctl reload nginx、curl -sk https://127.0.0.1/。
验证结果：本地 typecheck/lint/build 均通过；B nginx 配置测试通过且 active；首页 HTML 返回新资源 /assets/index-CYrIkAAk.js 和 /assets/index-TA3aiKvG.css。
回滚方式：从 B /var/backups/lisglosips-s39-cdr-detail-layout/20260623T183751/web-dist 恢复当前 release 的 apps/web/dist，再执行 nginx -t && systemctl reload nginx；本地恢复 apps/web/src/App.jsx、apps/web/src/styles.css 的本次改动。
未解决问题：未做浏览器截图交互验证；本次为纯前端抽屉布局调整，不涉及 API、数据库、Redis 热路径、OpenSIPS、RTPEngine 或 Worker。

2026-06-23 18:29 - 需求修改/二期变更：列表列宽优化与隐藏待设计菜单

状态：已完成
操作服务器：B、本地
完成内容：增强 SimpleTable 支持可选列宽和单元格 class；客户管理、客户网关管理、充值记录、供应商管理、落地网关管理页面的 ID/名称类列已适当收窄，并对长文本使用省略号避免撑宽列表；左侧菜单渲染时过滤 pending 项，隐藏“费率与计费”“SIP 运维”“监控告警”“系统设置”等待设计菜单。
修改文件：apps/web/src/App.jsx、apps/web/src/styles.css、IMPLEMENTATION_STATUS.md；B 当前 release /opt/lisglosips/releases/s33-active-calls-20260623094000 中已覆盖 apps/web/dist。
安装软件及固定版本：未安装新软件；继续使用 Node.js v22.22.2、pnpm 10.33.0、Vite 5.4.21。
执行关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build、B tar -xzf 覆盖 web dist、nginx -t、systemctl reload nginx、curl -sk https://127.0.0.1/。
验证结果：本地 typecheck/lint/build 均通过；B nginx 配置测试通过且 active；首页 HTML 返回新资源 /assets/index-N60ySjGq.js 和 /assets/index-uhdBdVZH.css。
回滚方式：从 B /var/backups/lisglosips-s38-web-ui-layout/20260623T182343/web-dist 恢复当前 release 的 apps/web/dist，再执行 nginx -t && systemctl reload nginx；本地恢复 apps/web/src/App.jsx、apps/web/src/styles.css 的本次改动。
未解决问题：未做浏览器截图交互验证；本次为纯前端布局/菜单渲染调整，不涉及 API、数据库、Redis 热路径、OpenSIPS、RTPEngine 或 Worker。

2026-06-23 17:47 - 需求修改/二期变更：自研确认弹窗与删除按钮警示色

状态：已完成
操作服务器：B、本地
完成内容：新增通用 ConfirmDialog，按现有 Modal/UI 风格替换原生 window.confirm 和旧确认弹窗；当前通话强制挂断、客户/供应商/客户网关/落地网关/落地线路组删除、客户网关/落地网关启停、策略删除、抽检规则删除、重置密码确认均使用自研弹窗；所有删除按钮改为 danger 红色警示态，包括表格删除、编辑抽屉中的删除行按钮以及线路组移除网关按钮。
修改文件：apps/web/src/App.jsx、apps/web/src/styles.css、IMPLEMENTATION_STATUS.md；B 当前 release /opt/lisglosips/releases/s33-active-calls-20260623094000 中已覆盖 apps/web/dist。
安装软件及固定版本：未安装新软件；继续使用 Node.js v22.22.2、pnpm 10.33.0、Vite 5.4.21。
执行关键命令：rg 'window\.confirm' apps/web/src/App.jsx、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build、B tar -xzf 覆盖 web dist、nginx -t、systemctl reload nginx、curl -sk https://127.0.0.1/。
验证结果：本地 typecheck/lint/build 均通过；rg 'window\.confirm' apps/web/src/App.jsx 无匹配；B nginx 配置测试通过且 active；首页 HTML 返回新资源 /assets/index-CWnw3J5O.js 和 /assets/index-BuNsq8w9.css。
回滚方式：从 B /var/backups/lisglosips-s37-confirm-dialog-ui/20260623T094434/web-dist 恢复当前 release 的 apps/web/dist，再执行 nginx -t && systemctl reload nginx；本地恢复 apps/web/src/App.jsx、apps/web/src/styles.css 的本次改动。
未解决问题：未做浏览器交互截图验证；功能行为已通过构建和页面资源烟测。

2026-06-23 16:20 - 需求修改/二期变更：充值记录过滤、充值性能与新建链路通话测试

状态：已完成
操作服务器：A、B、T、本地
完成内容：客户话单消费不再写入 customer_recharges，CDR worker 仅写 raw/rated CDR 并扣客户余额；充值记录 API 过滤历史 worker-cdr/cdr:/CDR_CHARGE: 客户消费流水；Web 客户/供应商充值成功后改为局部更新余额与充值列表，不再触发全量 refreshApi()，避免供应商充值后长时间停留在“拉取API”。完整流程测试时发现 A 热路径仍硬编码成功 CDR 和落地网关，已新增 S28 Lua 动态选择线路组首个启用落地网关，并让 OpenSIPS 成功 CDR 从 dialog 变量写入动态 customer/gateway/policy/vendorGateway/lineGroup；补齐 B /etc/lisglosips/config-publisher.env 并启动 lisglosips@config-publisher；修复 CDR worker 对超大 config_version 写 MySQL INT 越界的问题。
修改文件：apps/worker-cdr/src/rating.ts、apps/worker-cdr/src/rating.spec.ts、apps/api/src/modules/recharges/recharges.repository.ts、apps/web/src/App.jsx、infra/server-a/s28/opensips.cfg、infra/server-a/s28/lisglosips_hotpath.lua、IMPLEMENTATION_STATUS.md；B 当前 release 的 apps/api/dist、apps/web/dist、apps/worker-cdr/dist 已覆盖部署；A /etc/opensips/opensips.cfg 与 /usr/local/lib/lisglosips/lisglosips_hotpath.lua 已更新；B 新增 /etc/lisglosips/config-publisher.env。
验证结果：本地 corepack pnpm@10.33.0 typecheck 通过；corepack pnpm@10.33.0 exec vitest run apps/worker-cdr/src/rating.spec.ts apps/api/src/modules/recharges/recharges.e2e.spec.ts --maxWorkers=1 通过；全量 corepack pnpm@10.33.0 exec vitest run --maxWorkers=1 21 个测试文件 74 条测试通过；最终 lint 与全 workspace build 通过。B API /api/v2/health/ready 正常；客户充值记录按测试客户查询仅 1 条人工充值，未出现 CDR 消费充值；供应商充值接口实测约 818ms，客户充值约 1063ms。A opensips -C 通过并 active；Redis active config 版本 1782201896870 下 auth:ip:100.93.185.30 命中新建 cgw_zz_s36_20260623160046。完整流程测试创建供应商、落地网关、落地线路组、客户、客户网关、策略、客户充值、供应商充值后，由 T 发起 s36-1001 -> 13800136036，当前通话 API 显示 callerIp=100.93.185.30、landingIp=100.93.185.30，强制挂断返回 HANGUP_IN_PROGRESS，随后当前通话列表清空；最终 CDR raw_66b73108dc1e485ab17c6ac52a9464c1 为 RATED，rated CDR customer_fee=0.012000、vendor_cost=0.012000，测试客户余额从 10.000000 扣为 9.988000。
回滚方式：B 应用回滚可从 /var/backups/lisglosips-s36-recharge-flow/20260623T074955 恢复 api-dist、web-dist、worker-cdr-dist 并重启 lisglosips@api、lisglosips@cdr-worker；worker 后续补丁可从 /var/backups/lisglosips-s36-worker-cdr-config-version/20260623T081403 恢复。A OpenSIPS 热路径回滚点包括 /var/backups/lisglosips-s36-hotpath/20260623T080010 和 /var/backups/lisglosips-s36-dialog-cdr/20260623T080956，恢复 /etc/opensips/opensips.cfg 后执行 opensips -C -f /etc/opensips/opensips.cfg 并重启 opensips；B config-publisher env 回滚点为 /var/backups/lisglosips-s36-config-publisher-env/20260623T080456。测试业务数据使用前缀 S36 Flow 20260623160046，如需清理，应按 API 软删除客户网关/策略、线路组、落地网关、客户和供应商，不直接删除充值/话单审计记录。
遗留问题：测试实体当前保留启用，T 源 IP 会命中新建测试客户网关；若后续要恢复 S28 原始测试路由，应软删除或停用该测试客户网关并等待 config-publisher 发布。两次早期测试呼叫因 A 成功 CDR 动态变量和 worker config_version 越界进入 stream:cdr_deadletter，未进入 raw/rated CDR，已作为本次排障证据保留。T 在测试中曾出现一次 SSH banner 超时和一次 ping 丢包，重试后恢复。

2026-06-23 15:36 - 需求修改/二期变更：列表计数、删除功能和启停确认

状态：已完成
操作服务器：B、本地
完成内容：供应商列表显示落地网关数；客户管理、供应商管理前端增加删除按钮和确认弹窗，后端沿用已有软删除并分别在客户网关数/落地网关数大于 0 时拒绝删除。客户网关、落地网关后端新增 DELETE 软删除接口并纳入审计；客户网关删除会同步软删该网关下的路由策略并发布配置 outbox；落地网关删除在仍被未删除落地线路组引用时拒绝，避免热配置断链。落地线路组 API 新增 customerGatewayCount，按正在使用该线路组的去重客户网关数统计；删除落地线路组时若该数大于 0 则拒绝。Web 客户网关、落地网关启用/禁用前增加确认弹窗；客户网关、落地网关、落地线路组页面增加删除按钮和确认弹窗，并接入真实 API 列表/操作。
修改文件：IMPLEMENTATION_STATUS.md、apps/api/src/modules/customer-gateways/customer-gateways.controller.ts、apps/api/src/modules/customer-gateways/customer-gateways.service.ts、apps/api/src/modules/customer-gateways/customer-gateways.repository.ts、apps/api/src/modules/customer-gateways/customer-gateways.e2e.spec.ts、apps/api/src/modules/vendor-gateways/vendor-gateways.controller.ts、apps/api/src/modules/vendor-gateways/vendor-gateways.service.ts、apps/api/src/modules/vendor-gateways/vendor-gateways.repository.ts、apps/api/src/modules/vendor-gateways/vendor-gateways.e2e.spec.ts、apps/api/src/modules/landing-line-groups/landing-line-groups.repository.ts、apps/api/src/modules/landing-line-groups/landing-line-groups.e2e.spec.ts、apps/web/src/api.js、apps/web/src/App.jsx；B 当前 release /opt/lisglosips/releases/s33-active-calls-20260623094000 中覆盖 API/Web dist。
安装软件及固定版本：未安装新软件；继续使用 B 既有 Node.js v22.22.2、pnpm 10.33.0、NestJS、Vite、Prisma、Nginx。
执行的关键命令：本地 corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build、corepack pnpm@10.33.0 exec vitest run apps/api/src/modules/customer-gateways/customer-gateways.e2e.spec.ts apps/api/src/modules/vendor-gateways/vendor-gateways.e2e.spec.ts apps/api/src/modules/landing-line-groups/landing-line-groups.e2e.spec.ts apps/api/src/modules/customers/customers.e2e.spec.ts --maxWorkers=1、corepack pnpm@10.33.0 exec vitest run apps/api/src/modules/vendors/vendors.e2e.spec.ts --maxWorkers=1；B tar -xzf 覆盖当前 release API/Web dist、systemctl restart lisglosips@api、nginx -t、systemctl reload nginx、curl http://127.0.0.1:3000/api/v2/health/ready
验证结果：typecheck、lint、build 均通过。相关 e2e 验证通过：客户、供应商、客户网关、落地网关、落地线路组；一次组合运行中 vendors.e2e 因 Nest 多模块启动超过 10 秒 hookTimeout 被跳过/失败，随后单独运行 vendors.e2e 3 条测试全部通过。最终全量 Vitest 单 worker 模式 21 个测试文件、74 条测试通过。B lisglosips@api 与 nginx active，API ready 返回 config/database/redis 均 ok。B 只读烟测通过：/vendors 返回 gatewayCount，/landing-line-groups 返回 customerGatewayCount；当前本地数据示例 ven_s28_t.gatewayCount=1、llg_s28_t.customerGatewayCount=1。
回滚方式：B 已备份覆盖前 dist 到 /var/backups/lisglosips-s35-delete-count-confirm/20260623T153500/api-dist 与 /var/backups/lisglosips-s35-delete-count-confirm/20260623T153500/web-dist；如需回滚，将两目录恢复到 /opt/lisglosips/releases/s33-active-calls-20260623094000/apps/api/dist 与 /opt/lisglosips/releases/s33-active-calls-20260623094000/apps/web/dist，重启 lisglosips@api 并 nginx -t && systemctl reload nginx。本次无数据库 schema migration；如已通过新功能执行业务删除，删除为软删除，需要按具体对象在维护窗口受控恢复 deleted_at/status 与相关 outbox。
未解决问题：落地网关删除目前在被落地线路组引用时会拒绝，比本次需求更保守，目的是避免线路组热配置引用已删除网关；如果后续希望“删除落地网关时自动从线路组移除”，需单独设计优先级重排和配置发布语义。
下一任务：继续等待下一项二期需求；阿里云迁移仍不要直接开始。

2026-06-23 15:12 - 需求修改/二期变更：当前通话增加呼叫方 IP 与落地 IP

状态：已完成
操作服务器：B、T、本地
完成内容：在当前通话 API 归一化结果中新增 callerIp 与 landingIp 字段；解析优先级为 SIP Contact、SDP c=IN IP4/IP6、SIP URI、bind addr 兜底。Web “当前通话 / 实时呼叫列表”新增“呼叫方 IP”和“落地 IP”两列。该变更不涉及数据库 schema、Redis 热路径、OpenSIPS 配置、RTPEngine 或 Worker。
修改文件：IMPLEMENTATION_STATUS.md、apps/api/src/modules/active-calls/active-calls.service.ts、apps/api/src/modules/active-calls/active-calls.service.spec.ts、apps/web/src/App.jsx；B 当前 release /opt/lisglosips/releases/s33-active-calls-20260623094000 中覆盖 API/Web dist。
安装软件及固定版本：未安装新软件；继续使用 B 既有 Node.js v22.22.2、pnpm 10.33.0、NestJS、Vite、Nginx。
执行的关键命令：本地 corepack pnpm@10.33.0 exec vitest run apps/api/src/modules/active-calls/active-calls.service.spec.ts --maxWorkers=1、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；B tar -xzf 覆盖当前 release API/Web dist、systemctl restart lisglosips@api、nginx -t、systemctl reload nginx、curl http://127.0.0.1:3000/api/v2/health/ready；T /opt/lisglosips-s28/lisglosips-s28-sip.py invite --timeout 20 --hold 60
验证结果：当前通话单测 5 条通过；typecheck、lint、build 均通过。B lisglosips@api 与 nginx active，API ready 返回 config/database/redis 均 ok。A/B/T 端到端验证：T 发起保持呼叫后，B API 查询到当前通话并返回 callerIp=100.93.185.30、landingIp=100.93.185.30；当前本地 T 同时模拟主叫与落地 UAS，因此两者相同符合测试拓扑。API 挂断返回 HANGUP_IN_PROGRESS，等待 OpenSIPS 删除延迟后当前通话列表清空。
回滚方式：B 已备份覆盖前 dist 到 /var/backups/lisglosips-s34-active-call-ips/20260623T150800/api-dist 与 /var/backups/lisglosips-s34-active-call-ips/20260623T150800/web-dist；如需回滚，将两目录恢复到 /opt/lisglosips/releases/s33-active-calls-20260623094000/apps/api/dist 与 /opt/lisglosips/releases/s33-active-calls-20260623094000/apps/web/dist，重启 lisglosips@api 并 nginx -t && systemctl reload nginx。无数据库、A/OpenSIPS、Redis、RTPEngine 回滚项。
未解决问题：真实生产落地网关若不返回 SIP Contact 或 SDP 连接地址，landingIp 会退回到可解析的 URI/bind 地址，可能显示为 OpenSIPS 本地地址；后续可在路由侧显式写入 dialog 变量以获得更精确的落地网关 IP。
下一任务：继续等待下一项二期需求；阿里云迁移仍不要直接开始。

2026-06-23 10:15 - 需求修改/二期变更：新增“当前通话”菜单与强制挂断

状态：已完成
操作服务器：A、B、T、本地
完成内容：新增 Web “业务 / 当前通话”菜单，可刷新查看 OpenSIPS 当前 Dialog 列表，展示主叫、被叫、Call-ID、状态、时长、联系方式，并提供确认后的“挂断”按钮。B API 新增 GET /api/v2/active-calls 与 POST /api/v2/active-calls/:id/hangup，使用新增权限 active_calls.view、active_calls.manage 和审计拦截器；超级管理员具备全部权限，技术运维具备查看/挂断，运营管理员仅查看。A 启用 OpenSIPS dialog.so 并在 INVITE 路径执行 create_dialog()；新增受限 SSH forced-command /usr/local/sbin/lisglosips-call-control，仅允许 dlg_list 与 dlg_end_dlg，MI HTTP 仍绑定本机 127.0.0.1:8888。B 新增专用 lisglosips 服务用户出站 SSH key 与 /etc/lisglosips/call-control/ssh_config，API 通过该受限通道访问 A；修复 AUTH_COOKIE_SECURE 和 ACTIVE_CALLS_SSH_HOST 空值导致的 B API 启动/调用兼容问题。
修改文件：IMPLEMENTATION_STATUS.md、apps/api/src/modules/active-calls/active-calls.controller.ts、apps/api/src/modules/active-calls/active-calls.module.ts、apps/api/src/modules/active-calls/active-calls.service.ts、apps/api/src/modules/active-calls/active-calls.service.spec.ts、apps/api/src/modules/active-calls/opensips-mi.client.ts、apps/api/src/modules/app.module.ts、apps/api/src/shared/config.ts、apps/web/src/App.jsx、apps/web/src/api.js、packages/auth/src/index.ts、prisma/seed.ts、infra/server-a/s28/opensips.cfg、infra/server-a/s32/lisglosips-call-control；A /etc/opensips/opensips.cfg、A /usr/local/sbin/lisglosips-call-control、B /etc/lisglosips/api.env、B /etc/lisglosips/call-control/*、B release /opt/lisglosips/releases/s33-active-calls-20260623094000
安装软件及固定版本：未安装新软件；使用 A 既有 OpenSIPS 3.4.11 dialog 模块、B 既有 Node.js v22.22.2、pnpm 10.33.0、NestJS、Vite、Prisma、MySQL、Redis、Nginx。
执行的关键命令：本地 corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 exec vitest run --maxWorkers=1、corepack pnpm@10.33.0 build；A opensips -C -f、systemctl restart opensips、systemctl is-active opensips rtpengine；B systemctl start lisglosips-backup.service、corepack pnpm@10.33.0 db:seed、systemctl restart lisglosips@api、nginx -t、systemctl reload nginx、curl http://127.0.0.1:3000/api/v2/health/ready；T /opt/lisglosips-s28/lisglosips-s28-sip.py invite --timeout 20 --hold 60
验证结果：本地 lint 通过；typecheck 通过；全量 Vitest 单 worker 模式 21 个测试文件、73 条测试通过；workspace build 通过。A OpenSIPS 配置语法检查通过并已重启，opensips、rtpengine active；B lisglosips@api、nginx、mysql、redis-server active，API ready 返回 config/database/redis 均 ok。未登录访问 /api/v2/active-calls 返回 401；登录态访问空闲列表返回 source=opensips-mi,total=0。A/B/T 端到端验收：T 发起保持呼叫后，B API 查询到 1 条当前通话；调用 B API 挂断返回 HANGUP_IN_PROGRESS，OpenSIPS Dialog 状态进入 5，等待删除延迟后 B API 当前通话列表清空。
回滚方式：B 应用回滚可将 /opt/lisglosips/current 切回上一 release /opt/lisglosips/releases/s32-captcha-admin-20260622124659，重启 lisglosips@api 并 reload Nginx；如需还原 B 环境变量，使用 /var/backups/lisglosips-s33-active-calls-b/20260623T014402Z/api.env。A 回滚可从 /var/backups/lisglosips-s33-active-calls/20260623T014315Z 恢复 /etc/opensips/opensips.cfg 后重启 opensips，并移除 /usr/local/sbin/lisglosips-call-control、lisglo-callctl 用户/authorized_keys 以及 B /etc/lisglosips/call-control 专用 key。数据库无 schema migration；新增权限/角色授权来自 seed，可保留，若需清理需维护窗口执行受控 SQL。B 发布前 MySQL/Redis 备份为 /data/backups/mysql/20260623T014114Z 与 /data/backups/redis/20260623T014114Z。
未解决问题：OpenSIPS HTTP MI 的 dlg_end_dlg 在实际终止 Dialog 时会返回 500 Operation failed，但 Dialog 会进入 state 5 并随后清空；API 已按“500 后复查消失或 state 5 则视为已受理”处理。当前通话列表依赖 OpenSIPS dialog 模块，只覆盖本地 KVM A 单节点；未来多 OpenSIPS 节点需按节点聚合。强制挂断会影响被选中的实时呼叫，操作已纳入 RBAC 与审计，生产迁移前需再次演练。
下一任务：继续等待下一项二期需求；阿里云迁移仍不要直接开始。

2026-06-22 14:20 - 需求修改/二期变更：修复登录验证码刷新后不显示

状态：已完成，等待用户浏览器复验
操作服务器：B、本地
完成内容：定位验证码接口返回的是 data:image/svg+xml;base64,... SVG 图片，而 B Nginx 安全头 Content-Security-Policy 未显式允许 img-src data:，浏览器会拦截验证码图片渲染，表现为“验证码刷新不出来”。已将仓库和 B 当前 Nginx 安全头更新为 default-src 'self'; img-src 'self' data:; base-uri 'self'; frame-ancestors 'none'; form-action 'self'; object-src 'none'，保留原有同源、禁止嵌入和禁止 object 的安全基线。
修改文件：IMPLEMENTATION_STATUS.md、infra/server-b/s05/nginx/lisglosips-security-headers.conf；B /etc/nginx/snippets/lisglosips-security-headers.conf
安装软件及固定版本：未安装新软件；继续使用 B 既有 Nginx 1.24.0-2ubuntu7.12 和当前 release /opt/lisglosips/releases/s32-captcha-admin-20260622124659
执行的关键命令：本地 corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 prisma:validate、corepack pnpm@10.33.0 exec vitest run --maxWorkers=1、corepack pnpm@10.33.0 build；B cp -a 备份 Nginx 安全头、nginx -t、systemctl reload nginx、curl -k -sI https://127.0.0.1/、curl http://127.0.0.1:3000/api/v2/auth/captcha
验证结果：本地 lint、typecheck、Prisma validate 均通过；全量 Vitest 单 worker 模式 20 个测试文件、69 条测试通过；workspace build 通过。B 当前 release 确认为 /opt/lisglosips/releases/s32-captcha-admin-20260622124659；nginx -t 通过并已 reload；HTTPS 首页响应头已返回 Content-Security-Policy: default-src 'self'; img-src 'self' data:; base-uri 'self'; frame-ancestors 'none'; form-action 'self'; object-src 'none'；GET http://127.0.0.1:3000/api/v2/auth/captcha 返回新的 captchaId、data:image/svg+xml;base64,... 图片和过期时间；B nginx、lisglosips@api、lisglosips@cdr-worker、lisglosips@recording-worker 均 active。本次未做 A/B/T SIP 呼叫链路，因为变更只涉及 B Web 安全头，不影响 Redis 热路径、OpenSIPS、RTPEngine、CDR 或录音链路。
回滚方式：B 已备份原安全头到 /var/backups/lisglosips-s32-captcha-csp/20260622T061944Z/lisglosips-security-headers.conf；如需回滚，恢复该文件到 /etc/nginx/snippets/lisglosips-security-headers.conf，执行 nginx -t 通过后 systemctl reload nginx。仓库侧回滚 infra/server-b/s05/nginx/lisglosips-security-headers.conf 的本次一行 CSP 修改即可。无数据库、Redis、服务 release、OpenSIPS 或 RTPEngine 回滚项。
未解决问题：尚未由用户在真实浏览器中点击验证码刷新并确认图片可见；验证码仍为 API 单进程内存存储，后续多 API 实例/生产高可用建议迁移到 Redis 或共享缓存。
下一任务：用户浏览器复验 B 登录页验证码刷新；继续等待下一项二期需求。

2026-06-22 12:54 - 需求修改/二期变更发布到 B：登录图形验证码与 admin 初始账号

状态：已完成，等待用户验收
操作服务器：B、本地
完成内容：在登录接口新增一次性图形验证码，GET /api/v2/auth/captcha 生成 5 位 SVG 验证码并只返回 captchaId、图片 data URL 和过期时间；POST /api/v2/auth/login 必须携带 captchaId 和 captchaCode，验证码错误返回 401 AUTH_CAPTCHA_INVALID，缺少登录字段继续返回统一认证失败以降低账号枚举风险。Web 登录页新增验证码图片、输入框和刷新按钮，登录失败后自动刷新验证码。B 数据库已新增/更新用户名 admin，启用状态，授予超级管理员角色，并按用户提供的初始口令写入 Argon2id 哈希；未在文档或命令输出中记录明文口令。发布为 B 新 release /opt/lisglosips/releases/s32-captcha-admin-20260622124659，/opt/lisglosips/current 已切换到该 release。
修改文件：IMPLEMENTATION_STATUS.md、apps/api/src/modules/auth/auth.controller.ts、apps/api/src/modules/auth/auth.module.ts、apps/api/src/modules/auth/captcha.service.ts、apps/api/src/modules/auth/auth.e2e.spec.ts、apps/web/src/App.jsx、apps/web/src/api.js、apps/web/src/styles.css；B 新 release 中覆盖 API/Web dist 与对应源码。延续上一轮登录防爆破相关文件：apps/api/src/modules/auth/auth.service.ts、apps/api/src/modules/auth/auth.service.spec.ts、apps/api/src/shared/config.ts。
安装软件及固定版本：未安装新软件；继续使用 B 既有 Node.js v22.22.2、pnpm 10.33.0、NestJS、Vite、Prisma、Nginx、Grafana 13.0.2、Prometheus 2.45.3。
执行的关键命令：本地 corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 prisma:validate、corepack pnpm@10.33.0 exec vitest run --maxWorkers=1、corepack pnpm@10.33.0 build、tar -czf 打包、scp 上传；B systemctl start lisglosips-backup.service、cp -a 创建新 release、tar --no-same-owner -xzf 覆盖产物、ln -sfn 切换 current、systemctl restart lisglosips@api、nginx -t、systemctl reload nginx、/tmp/lisglosips-release-preflight.sh；B 通过临时脚本按用户提供口令 upsert admin 用户并撤销旧会话。
验证结果：本地 lint、typecheck、Prisma validate、build 均通过；全量 Vitest 单 worker 模式 20 个测试文件、69 条测试通过，新增认证 e2e 覆盖 captcha 接口不泄露答案、无验证码登录被拒绝、携带正确验证码后可登录。B 发布前备份目录为 MySQL /data/backups/mysql/20260622T044834Z、Redis /data/backups/redis/20260622T044834Z，两者 SHA256SUMS 校验通过。B preflight 通过：MySQL、Redis、Nginx、API、CDR Worker、Recording Worker、Heplify、Prometheus、Grafana 均 active，API ready 返回 ok，Nginx 配置测试成功。GET http://127.0.0.1:3000/api/v2/auth/captcha 返回 captcha JSON 与 SVG data URL 且不含答案；使用错误验证码调用登录返回 401 AUTH_CAPTCHA_INVALID；https://127.0.0.1/ 返回新前端构建资产 index-B6ms7F5U.js 与 index-C60rDiFV.css。
回滚方式：如需回滚应用，按 docs/S30_RELEASE_BACKUP_RUNBOOK.md 将 B /opt/lisglosips/current 切回上一稳定 release /opt/lisglosips/releases/s31-auth-login-20260622115851 或原冻结 release /opt/lisglosips/releases/s28-v2-20260621220924，重启 lisglosips@api 并 reload Nginx。数据库只新增/更新 admin 用户密码哈希和会话撤销记录；如需回滚账号变更，可在维护窗口按 B 发布前 MySQL 备份 /data/backups/mysql/20260622T044834Z 恢复，或单独执行受控账号禁用/密码重置脚本，执行前需再次说明影响和回滚点。
未解决问题：尚未由用户在浏览器中完成真实登录验收；验证码当前为单 API 进程内存存储，适配当前 B 单实例开发环境，后续多 API 实例/生产高可用应迁移到 Redis 或共享缓存。登录防爆破仍为进程内存级节流，生产多实例同样建议升级为 Redis/网关级共享限流。本次未做 A/B/T SIP 呼叫链路，因为变更只涉及 Web/API 登录鉴权和 B 用户数据，不影响 Redis 热路径、OpenSIPS、RTPEngine、CDR 或录音链路。
下一任务：用户验收 B 登录页；继续等待下一项二期需求。

2026-06-22 12:04 - 需求修改/二期变更发布到 B：登录页与登录防爆破

状态：已完成，等待用户验收
操作服务器：B、本地
完成内容：将本地登录页与登录防爆破变更发布为 B 新 release /opt/lisglosips/releases/s31-auth-login-20260622115851，/opt/lisglosips/current 已切换到该 release。发布方式为复制上一 release /opt/lisglosips/releases/s28-v2-20260621220924 后覆盖本次 API/Web 构建产物和相关源码；未执行数据库迁移，未改 Redis 配置，未触碰 A/T、OpenSIPS 或 RTPEngine。发布前触发 B MySQL/Redis 备份并校验哈希。
修改文件：本地 IMPLEMENTATION_STATUS.md；B 新 release 中的 apps/api/dist/、apps/api/src/modules/auth/auth.service.ts、apps/api/src/modules/auth/auth.service.spec.ts、apps/api/src/shared/config.ts、apps/web/dist/、apps/web/src/App.jsx、apps/web/src/api.js、apps/web/src/styles.css
安装软件及固定版本：未安装新软件；继续使用 B 既有 Node.js v22.22.2、pnpm 10.33.0、NestJS、Vite、Prisma、Nginx、Grafana 13.0.2、Prometheus 2.45.3
执行的关键命令：本地 corepack pnpm@10.33.0 build、tar -czf 打包发布覆盖包、scp 上传；B systemctl start lisglosips-backup.service、cp -a 创建新 release、tar --no-same-owner -xzf 覆盖产物、ln -sfn 切换 current、systemctl restart lisglosips@api、nginx -t、systemctl reload nginx、/tmp/lisglosips-release-preflight.sh
验证结果：发布前备份目录为 MySQL /data/backups/mysql/20260622T040339Z、Redis /data/backups/redis/20260622T040339Z，两者 SHA256SUMS 校验通过。B preflight 通过：MySQL、Redis、Nginx、API、CDR Worker、Recording Worker、Heplify、Prometheus、Grafana 均 active，API ready 返回 ok，Nginx 配置测试成功。GET http://127.0.0.1:3000/api/v2/health/ready 返回 ok；未登录访问 /api/v2/dashboard/summary 返回 401 AUTH_REQUIRED；https://127.0.0.1/ 返回新前端构建资产 index-7KkZS1Fz.js 与 index-ChBVfysf.css。Grafana health http://127.0.0.1:3001/api/health 返回 database ok/version 13.0.2，Prometheus /-/ready 返回 ready。
回滚方式：B 应用可执行 sudo /tmp/lisglosips-release-preflight.sh 复核状态；如需回滚，按 docs/S30_RELEASE_BACKUP_RUNBOOK.md 将 /opt/lisglosips/current 切回 /opt/lisglosips/releases/s28-v2-20260621220924，重启 lisglosips@api 并 reload Nginx；数据库和 Redis 未变更，备份目录仅作为发布前恢复点保留。
未解决问题：尚未由用户在浏览器中完成真实登录验收；本次未做 A/B/T SIP 呼叫链路，因为变更只涉及 Web/API 登录鉴权，不影响 Redis 热路径、OpenSIPS、RTPEngine、CDR 或录音链路。后续多 API 实例/生产环境仍建议把登录节流升级为 Redis 或网关级共享限流。
下一任务：用户验收登录页面；继续等待下一项二期需求。

2026-06-22 11:53 - 需求修改/二期变更：登录页与登录防爆破

状态：已完成
操作服务器：本地
完成内容：完善 Web 登录闭环，打开应用时先尝试 /api/v2/auth/refresh 恢复会话，未认证时只显示登录页面；输入用户名和密码调用 /api/v2/auth/login，登录成功后保存 access token 并加载业务数据；顶部显示当前登录用户并支持退出，退出时调用 /api/v2/auth/logout、清理本地 token 和页面数据。后端在既有 Argon2id、用户失败次数和账号锁定基础上，新增内存级登录节流，按用户名与来源 IP 统计失败次数；即使用户名不存在，连续失败也会触发 429 AUTH_LOGIN_THROTTLED，避免撞库/爆破时泄露账号存在性。新增运行时配置 AUTH_LOGIN_THROTTLE_MAX_FAILURES 和 AUTH_LOGIN_THROTTLE_WINDOW_SECONDS。
修改文件：IMPLEMENTATION_STATUS.md、apps/web/src/App.jsx、apps/web/src/api.js、apps/web/src/styles.css、apps/api/src/shared/config.ts、apps/api/src/modules/auth/auth.service.ts、apps/api/src/modules/auth/auth.service.spec.ts
安装软件及固定版本：未安装新软件；继续使用 Node.js/pnpm、NestJS、Vite、Vitest、Prisma 既有版本。
执行的关键命令：本地 corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 exec vitest run apps/api/src/modules/auth/auth.service.spec.ts apps/api/src/modules/auth/auth.e2e.spec.ts、corepack pnpm@10.33.0 exec vitest run --maxWorkers=1、corepack pnpm@10.33.0 prisma:validate、corepack pnpm@10.33.0 build
验证结果：lint 通过；typecheck 通过；认证单测/e2e 6 条通过；全量 Vitest 使用 --maxWorkers=1 后 20 个测试文件、69 条测试全部通过；Prisma schema validate 通过；workspace build 通过。首次全量并行测试曾出现多个 Nest e2e beforeAll 超时，改为单 worker 后全部通过，判断为本地并行资源/初始化竞争导致的假失败。
回滚方式：恢复上述 7 个文件到本次修改前版本即可；无数据库 schema 变更、无服务器写操作、无 Redis/OpenSIPS/RTPEngine 配置变更。若已发布到 B，可按 docs/S30_RELEASE_BACKUP_RUNBOOK.md 使用上一 release 切回并重启 API/Web 相关服务。
未解决问题：本次只完成本地代码修改，尚未发布到 B 当前冻结 release，也未做浏览器视觉截图或 A/B/T 端到端验收；登录节流为单进程内存级，足以覆盖当前单 API 进程开发环境，后续多 API 实例或生产环境建议迁移到 Redis/网关级限流以跨进程共享计数。
下一任务：等待下一个二期需求；如需上线本变更，应按 S30 发布流程创建新 B release 并做 preflight/登录冒烟。

2026-06-22 10:35 - S30 备份、Runbook、灰度与上线完成

状态：已完成
操作服务器：A、B、T、本地
完成内容：完成 S30 本地 KVM 开发环境上线前冻结与演练。新增 S30 总控 Runbook、最终验收报告、B release preflight/rollback 脚本和 A OpenSIPS 配置恢复脚本；触发 B MySQL/Redis 新备份并完成隔离恢复演练；使用 T 发起灰度呼叫并核对 B raw CDR、rated CDR 和 READY 录音；实际运行 B preflight；A OpenSIPS 当前配置语法检查通过；三机关键服务最终复核 active。
修改文件：IMPLEMENTATION_STATUS.md、docs/S30_RELEASE_BACKUP_RUNBOOK.md、docs/S30_FINAL_ACCEPTANCE_REPORT.md、infra/server-b/s30/lisglosips-release-preflight.sh、infra/server-b/s30/lisglosips-release-rollback.sh、infra/server-a/s30/lisglosips-opensips-config-restore.sh
安装软件及固定版本：未安装新系统软件；继续使用 OpenSIPS 3.6.x、RTPEngine 11.5.1.18-1ubuntu1.2、Node.js v22.22.2、pnpm 10.33.0、Prisma 6.19.0、MySQL 8.0.46、Redis 7.0.15
执行的关键命令：B systemctl start lisglosips-backup.service、MySQL 备份恢复到临时库 lisglosips_s30_restore、Redis RDB 恢复到隔离 Unix socket 临时实例、bash -n 检查 S30 脚本、/tmp/lisglosips-release-preflight.sh preflight；A opensips -C -f /etc/opensips/opensips.cfg；T /opt/lisglosips-s28/lisglosips-s28-sip.py invite --timeout 12 --hold 3。所有 sudo/数据库/API secret 均从 .codex-private/ 或远端 env 读取并只在进程内使用，未写入文档。
验证结果：MySQL 备份 /data/backups/mysql/20260622T022811Z 的 all-databases.sql.gz、lisglosips.sql.gz、metadata.tsv 校验通过，临时库恢复计数 raw_cdrs=33、recordings=27、customer_recharges=34、users=2 后已删除；Redis 备份 /data/backups/redis/20260622T022812Z 的 dump.rdb、metadata.txt 校验通过，隔离实例核对 DBSIZE=51、stream:cdr_payload=54、cfg:active_version=s28-v1 后已关闭并清理。灰度 Call-ID s28-1782095548702-luppqjd4@lisglosips-t 收到 SIP 100/200/BYE 200，B 生成 raw raw_7a6356cc76974652aa30a9d7a350041b、rated rated_e0eb8cbe1b90454cb3cf2d9a3bbc9290、billSec=6、客户费用/供应商成本均 0.012000、录音 rec_5fdf599d679f493a83fc7a2d205a128a 为 READY 且 55758 bytes。B preflight 通过，A/B/T 关键服务最终 active，S30 文档/脚本未检出待补充或明文 secret。
回滚方式：B 应用按 docs/S30_RELEASE_BACKUP_RUNBOOK.md 使用 infra/server-b/s30/lisglosips-release-rollback.sh /opt/lisglosips/releases/<previous-release> 切回上一 release；A OpenSIPS 配置按 infra/server-a/s30/lisglosips-opensips-config-restore.sh <backup-opensips.cfg> 先语法检查再恢复；Redis 配置切回上一 cfg:active_version，不删除 Stream；数据库优先向前修复迁移，只有完整备份和维护窗口下才恢复数据。S30 产生的测试 CDR、录音和备份作为验收证据保留。
未解决问题：本地开发环境不是阿里云生产环境；正式迁移前必须重新完成 VPC/安全组、正式 DNS/TLS、独立数据盘、备份恢复、故障注入和端到端呼叫验收。S29 遗留 Redis 恢复后 OpenSIPS 热路径可能需要重启 opensips 的根因级修复仍需后续单独处理；真实多 A、多 B、高可用和完整生产路由不属于本地 S30 闭环。
下一任务：无；S00-S30 本地 V2 闭环完成，后续应按 S30 Runbook 进入阿里云迁移/生产化专项

2026-06-22 10:25 - S29 性能、故障与安全测试完成

状态：已完成
操作服务器：A、B、T、本地
完成内容：完成本地 KVM 开发环境内的 S29 小规模性能、故障与安全测试。5 路并发和 12 路短突发呼叫均完成 SIP 100/200/BYE 200、CDR、计费、录音 READY 入库；Recording Worker 停止期间的录音恢复、CDR Worker 停止期间的 Redis pending 恢复均通过；Redis 停止期间 A 正确返回 503 Redis Unavailable，恢复后发现 OpenSIPS 热路径连接不自动恢复，已通过重启 A opensips 做运行时恢复并复测成功；MySQL 停止期间发现 CDR 被 deadletter 的可恢复性缺陷，已修复并部署到 B 当前 release，复测 MySQL 恢复后 pending CDR 自动入库且无新增 deadletter；完成 API 未认证、RBAC 越权、录音播放保护、充值幂等重放和 SIP 非法来源探针。S29 报告已写入 docs/S29_PERFORMANCE_FAULT_SECURITY_REPORT.md。
修改文件：IMPLEMENTATION_STATUS.md、docs/S29_PERFORMANCE_FAULT_SECURITY_REPORT.md、infra/server-t/s28/lisglosips-s28-sip.py、packages/redis/src/cdr-stream.ts、packages/redis/src/cdr-stream.spec.ts、apps/worker-cdr/src/main.ts、apps/worker-cdr/src/rating.ts；T 的 /opt/lisglosips-s28/lisglosips-s28-sip.py；B 当前 release /opt/lisglosips/releases/s28-v2-20260621220924/apps/worker-cdr/ 与 /opt/lisglosips/releases/s28-v2-20260621220924/packages/redis/
安装软件及固定版本：未安装新系统软件；继续使用 OpenSIPS 3.6.x、RTPEngine 11.5.1.18-1ubuntu1.2、Node.js v22.22.2、pnpm 10.33.0、Prisma 6.19.0
执行的关键命令：本地 corepack pnpm@10.33.0 exec vitest run packages/redis/src/cdr-stream.spec.ts apps/worker-cdr/src/rating.spec.ts、corepack pnpm@10.33.0 --filter @lisglosips/redis build、corepack pnpm@10.33.0 --filter @lisglosips/worker-cdr build；T 多路 /opt/lisglosips-s28/lisglosips-s28-sip.py invite --timeout 10 --hold 1/3；B/A 使用 systemctl stop/start/restart 做受控故障注入和恢复；B 通过 API 与 Prisma 只读/小额写入探针核对 RBAC、录音播放保护和充值幂等。所有 sudo/数据库/API secret 均从 .codex-private/ 或远端 env 读取并只在进程内使用，未写入文档。
验证结果：5 路并发生成 5 条 raw CDR、5 条 rated CDR、5 条 READY 录音；12 路短突发生成 raws=12、rated=12、recordingsReady=12、totalDuration=72、录音大小 55758-56078 bytes；Recording Worker 恢复后补搬运录音；CDR Worker 恢复后 Redis pending=0、lag=0 并入库；MySQL 故障修复后复测 Call-ID s28-1782093477852-a8bqqohb@lisglosips-t 自动入库 raw/rated CDR，无新增 deadletter；API /api/v2/users 未认证返回 401 AUTH_REQUIRED，质检角色访问用户管理返回 403 RBAC_FORBIDDEN，录音播放未认证返回 401 AUTH_REQUIRED，伪造录音 ID 播放返回 404 RECORDING_NOT_READY；充值重放两次返回同一充值 ID rch_da0bba1c7b1d44428ab92d77a55e503d，数据库 customer_recharges.rows=1、idempotency_keys.rows=1，余额只增加 0.000001 一次；B 实际 Prometheus 服务 lisglosips-prometheus.service active 且 ready；A/B/T 关键服务复核 active。
回滚方式：T 可恢复 S29 前 /opt/lisglosips-s28/lisglosips-s28-sip.py 或继续使用修复后的动态端口脚本；B 可用本次部署前保留在 /tmp/s29-worker-cdr-backup-* 与 /tmp/s29-redis-backup-* 的备份恢复 worker-cdr 与 packages/redis 后重启 lisglosips@cdr-worker；A Redis 故障恢复只做过服务重启，无配置文件改动。S29 产生的测试 CDR、录音、充值、幂等键和测试用户作为审计证据保留，不直接删除；如需清理应单独说明影响与回滚点。
未解决问题：Redis 恢复后 A/OpenSIPS 热路径不会自动从 Redis Unavailable 恢复，当前运行时修复是重启 A opensips，根因级修复需继续排查 OpenSIPS Redis 连接池/重连策略；SIP 非法来源探针表现为无响应且未进入 OpenSIPS 日志，后续建议增加明确拒绝日志/指标；S29 期间 Tailscale 管理链路出现短时高延迟/丢包，记录为开发环境风险；真实多 A、多 B 和完整生产路由仍不在本任务范围。
下一任务：S30 - 备份、Runbook、灰度与上线，尚未开始

2026-06-22 09:32 - S28 三机端到端联调完成

状态：已完成
操作服务器：A、B、T、本地
完成内容：补齐 S28 剩余录音与质检闭环。T 呼叫脚本新增双向 PCMU RTP 发送，UAS 在 200 OK 后向 A/RTPEngine 回送 RTP，主叫侧在 ACK 后向应答 SDP 媒体地址发送 RTP；A 的 S28 OpenSIPS 路由启用 record-call=on，保持 INVITE/ACK/BYE 经原 A，仍绑定本机 RTPEngine；修正 A /dev/shm/voip_rec 历史 root-owned 日期目录权限；修复 A recording finalizer 过早搬运问题，跳过 0 字节、仍被打开或未稳定的录音文件；B Recording Worker 新增按 RTPEngine 文件名反解 Call-ID 的 fallback 关联逻辑，使录音可自动关联 raw_cdrs，从而让质检抽样按客户/线路组命中。新增 S28 质检测试用户 usr_s28_quality、抽检规则 qs_s28_e2e_20260622，并通过 API 保存最新录音质检记录。
修改文件：infra/server-t/s28/lisglosips-s28-sip.py、infra/server-a/s28/opensips.cfg、infra/server-a/s19/scripts/lisglosips-recording-finalize、apps/worker-recording/src/transfer.ts、apps/worker-recording/src/transfer.spec.ts、IMPLEMENTATION_STATUS.md；A 的 /etc/opensips/opensips.cfg、/usr/local/sbin/lisglosips-recording-finalize 和 /dev/shm/voip_rec 目录属主/权限；T 的 /opt/lisglosips-s28/lisglosips-s28-sip.py；B 当前 release /opt/lisglosips/releases/s28-v2-20260621220924/apps/worker-recording/ 的源码与 dist 产物
安装软件及固定版本：未安装新系统软件；继续使用 OpenSIPS 3.6.x、RTPEngine 11.5.1.18-1ubuntu1.2、Node.js v22.22.2、pnpm 10.33.0、Prisma 6.19.0
执行的关键命令：本地 corepack pnpm@10.33.0 exec vitest run apps/worker-recording/src/transfer.spec.ts、corepack pnpm@10.33.0 --filter @lisglosips/worker-recording build；A opensips -C -f /tmp/opensips-s28.rendered.cfg 后重启 opensips，更新 finalizer 后保持 timer active；T /opt/lisglosips-s28/lisglosips-s28-sip.py invite --timeout 10 --hold 3；B 替换 worker-recording 产物并重启 lisglosips@recording-worker，通过 MySQL 和 API 只读/写入测试核对。所有 sudo/数据库/API secret 均从 .codex-private/ 或远端 env 读取并只在进程内使用，未输出或写入明文密码。
验证结果：最终验收 Call-ID s28-1782091725991-ewqrpe7w@lisglosips-t；T 收到 100 Giving it a try、200 OK、BYE 200 OK；B raw_cdrs 生成 raw_aa6cbaf7758f41ea895a2889f558559d，duration_sec=6、rating_status=RATED；rated_cdrs 对应客户费用和供应商成本均为 0.012000、bill_sec=6；B recordings 生成 rec_24b56d60dfd14937ae2e4c09802a91be，自动关联该 raw CDR，status=READY、bytes=55758、SHA-256 前缀 e2cfaf8c7bbc6023；API /api/v2/health/ready 返回 ok，GET /api/v2/recordings/rec_24b56d60dfd14937ae2e4c09802a91be 返回 customer/lineGroup/callId/CDR 摘要，抽样规则 qs_s28_e2e_20260622 命中 selected=true，PUT /api/v2/recordings/:id/review 成功保存 qrev_9672ee20119049a1a56082c35dc42e0f，GET /play 返回 200、content-type: audio/wav 和内部 x-accel-redirect。A opensips、rtpengine-daemon、rtpengine-recording-daemon、lisglosips-recording-finalize.timer active；B lisglosips@api、lisglosips@cdr-worker、lisglosips@recording-worker、mysql、redis-server、heplify-server active；T lisglosips-s28-uas、opensips active。
回滚方式：T 回滚恢复或删除 /opt/lisglosips-s28/lisglosips-s28-sip.py，停止 lisglosips-s28-uas.service；A 回滚可用 /var/backups/lisglosips-s28/20260621T145920Z/opensips.cfg 恢复 /etc/opensips/opensips.cfg 并语法检查后重启 opensips，finalizer 可恢复 S24 备份 /var/backups/lisglosips-s24/20260621T121130Z/lisglosips-recording-finalize，但旧脚本会重现提前搬运风险；B 回滚可将 worker-recording 产物恢复到本次替换前的 release 版本或把 /opt/lisglosips/current 指回前一 release 后重启相关服务。测试 CDR、余额流水、录音和质检记录作为验收证据保留，不直接删除；如必须清理，应另开维护步骤并先说明影响与回滚点。
未解决问题：A 当前仍是 S28 单一测试落地端最小路由，不是完整多落地网关生产路由；录音 duration_sec 仍为 0，后续可在 Recording Worker 中读取 WAV 时长或由媒体侧补充；S28 调试期间存在一条 0 字节早期录音 rec_f9b1457861444d4ebbddc11adb208d13 作为问题证据保留；多 A 真实部署和多 B 高可用仍留给后续阶段。
下一任务：S29 - 性能、故障与安全测试

2026-06-21 23:06 - S28 三机端到端联调推进

状态：进行中
操作服务器：A、B、T、本地
完成内容：将 B 从 S05 placeholder 发布为完整 V2 release /opt/lisglosips/releases/s28-v2-20260621220924，/opt/lisglosips/current 已切换到该 release；执行业务库迁移，补齐 20260621093000_auth_sessions additive 迁移记录，权限/角色种子已落库；lisglosips@api 和 lisglosips@cdr-worker active，API /api/v2/health/live 与 /api/v2/health/ready 返回 ok；补齐 B 录音拉取 /etc/lisglosips/recording/ssh_config，lisglosips@recording-worker 已恢复 active。新增 S28 测试业务数据：客户 cus_s28_t、客户网关 cgw_s28_t_ip、供应商 ven_s28_t、落地网关 vgw_s28_t_uas、线路组 llg_s28_t 和策略 cgp_s28_t_default；Redis 热路径配置版本为 s28-v1。在 T 部署专用落地模拟服务 lisglosips-s28-uas.service，监听 100.93.185.30:50620，只终结呼叫不回送 A，避免循环。A 部署 S28 最小真实路由：Lua 热路径 allow 后执行 RTPEngine offer/answer、转发到 T 专用落地端、写成功 CDR 到 Redis Stream，并为 T 源 IP 的 ACK/BYE 添加 fallback，确保回到原 A 后转给 T 落地端。
修改文件：infra/server-t/s28/lisglosips-s28-sip.py、infra/server-a/s28/opensips.cfg、pnpm-lock.yaml、IMPLEMENTATION_STATUS.md；B 的 /opt/lisglosips/releases/s28-v2-20260621220924、/etc/lisglosips/api.env、/etc/lisglosips/cdr-worker.env、/etc/lisglosips/recording-worker.env、/etc/lisglosips/recording/ssh_config、/etc/systemd/system/lisglosips@recording-worker.service.d/10-s28-recording.conf；T 的 /opt/lisglosips-s28/lisglosips-s28-sip.py 和 /etc/systemd/system/lisglosips-s28-uas.service；A 的 /etc/opensips/opensips.cfg
安装软件及固定版本：未安装新系统软件；B 继续使用 Node.js v22.22.2、Corepack 0.34.6、pnpm 10.33.0、Prisma 6.19.0
执行的关键命令：本地 corepack pnpm@10.33.0 install --lockfile-only、corepack pnpm@10.33.0 build、corepack pnpm@10.33.0 prisma:validate、corepack pnpm@10.33.0 fetch；B 端离线 pnpm install --frozen-lockfile --offline --ignore-scripts、MySQL 迁移/种子、systemd restart/enable；A opensips -C -f /tmp/opensips-s28.rendered.cfg 后重启 opensips；T 启动 lisglosips-s28-uas.service。凭据均从 .codex-private/ 读取并通过 stdin/base64 参数传递，未写入文档或输出明文密码。
验证结果：最终候选呼叫 Call-ID s28-1782054233152-f4eiz799@lisglosips-t；T 收到 100 Giving it a try、200 OK，随后 BYE 返回 200 OK；A 日志显示 hotpath allow、成功 CDR XADD 1782054232944-0、ACK/BYE 均从 T 回到 A；RTPEngine session 最终回到 0；B MySQL raw_cdrs 生成 raw_2903404fa10b47a6a4b7968e3662cdd5，sip_code=200、hangup_reason=NORMAL_CLEARING、customer_id=cus_s28_t、vendor_gateway_id=vgw_s28_t_uas、duration_sec=6；rated_cdrs 生成客户费用/供应商成本 0.012000、计费秒数 6；客户 cus_s28_t 余额扣减到 99.928000（包含本次和前面 S28 调试成功 CDR）；HOMER hep_proto_1_call 可查到该 Call-ID 的 INVITE、ACK、BYE；B API ready ok，lisglosips@api、lisglosips@cdr-worker、lisglosips@recording-worker 均 active；T S28 UAS active。
回滚方式：B 回滚先停止 lisglosips@cdr-worker 和 lisglosips@recording-worker，将 /opt/lisglosips/current 指回备份记录中的 S05 placeholder release，并重启 lisglosips@api；B 迁移前备份位于 /var/backups/lisglosips-s28/20260621T140940Z，如需撤回数据库写入应走备份恢复或受控反向账务处理，不直接删除 CDR/余额流水。A 回滚使用 /var/backups/lisglosips-s28/20260621T145920Z/opensips.cfg 恢复 /etc/opensips/opensips.cfg，语法检查后重启 opensips。T 回滚停止并删除 lisglosips-s28-uas.service 和 /opt/lisglosips-s28。Redis 配置可将 cfg:active_version 切回 cfg:previous_version 或清理 s28-v1 测试 keys，清理前需确认没有后续测试依赖。
未解决问题：本次 T 脚本只做 SIP/SDP，不发送 RTP 音频包，因此 RTPEngine 未产生真实录音文件；Recording Worker 虽已 active，但尚未完成真实通话 .ready 文件搬运、recordings 入库和质检抽样/保存核对。S28 仍需补“RTP 音频生成 -> A 录音 ready -> B Recording Worker 入库 -> 质检接口核对”后才能标记已完成。当前 A 配置中的 S28 路由是单一测试落地端 fallback，不是完整多落地网关生产路由。
下一任务：继续 S28 - 三机端到端联调，补齐录音和质检闭环；不得进入 S29。

2026-06-21 21:47 - S28 三机端到端联调

状态：已阻塞
操作服务器：A、B、T；仅执行一次 S28 测试 INVITE 和只读核对，未修改服务器配置，未重启服务，未执行数据库迁移、数据删除或防火墙变更
完成内容：按 S28 目标先做三机链路探针。T 使用 S21 脚本向 A 100.90.90.90:15060 发起 IP 认证 INVITE，Call-ID 为 s21-invite-1782049439554-088rul75@lisglosips-t；A 返回 SIP/2.0 503 Config Missing；A OpenSIPS 日志确认热路径拒绝原因为 CONFIG_MISSING，并成功向 B Redis Stream 写入失败 CDR；B Redis Stream stream:cdr_payload 可按 Call-ID 查到该事件，字段包含 node_id=a1、opensips_instance=opensips-a1、ingress_a_ip=100.90.90.90、rtpengine_node=a1、sip_code=503、hangup_reason=CONFIG_MISSING；B HOMER hep_proto_1_call 最近记录的 sid 与 data_header.callid 均为该 Call-ID，data_header.method=INVITE，说明 HEP 信令镜像入库正常。
修改文件：IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件
执行的关键命令：T /opt/lisglosips-s21/s21-call-a-ip；A journalctl -u opensips --since '10 minutes ago' 按 Call-ID 查询；B redis-cli XREVRANGE stream:cdr_payload 按 Call-ID 查询；B PostgreSQL homer_data.hep_proto_1_call 只读查询；B 本机 API/数据库只读探针。所有凭据均从 .codex-private/ 读取并通过 stdin 使用，未输出明文密码。
验证结果：T->A SIP 输入、A->B Redis Stream 失败 CDR、A->B HOMER HEP 信令三段可按 Call-ID 串联；但未进入真实路由、媒体、录音、计费或质检闭环。B 当前 /api/v2/health/live 返回 HTTP 404，lisglosips 业务库表数为 0，说明 current release 仍不是完整 V2 API/Worker；A 当前 /etc/opensips/opensips.cfg 仍为 S20/S22 占位逻辑，配置缺失时返回 Config Missing，即便配置 allow 也会返回 Routing Not Ready，没有真实落地网关选择、RTPEngine offer/answer、t_relay 和对话内 ACK/BYE/re-INVITE 路由。
回滚方式：本次未修改服务器配置和数据库结构，无需服务回滚；产生的一条测试 INVITE、HOMER 记录和 Redis Stream 失败 CDR 作为联调证据保留，不做直接删除。若后续需要清理测试数据，应先单独说明影响和回滚点。
未解决问题：S28 阻塞在两个前置缺口：一是 B 需要受控发布完整 V2 API、Web 和 CDR/Recording Worker，并在空业务库上执行迁移/种子和健康检查；二是 A 需要新增真实呼叫路由配置，至少包含从 Redis 配置读取线路组/落地网关、供应商目标地址、RTPEngine offer/answer、t_relay、onreply/failure/dialog 内路由和成功/失败 CDR 事件。当前不能进入 S29。
下一任务：继续 S28 - 三机端到端联调，先解除上述阻塞；不得提前执行 S29。

2026-06-21 21:32 - S27 React Demo 接入真实 API

状态：已完成
操作服务器：本地；未连接 A/B/T，未执行服务器写操作、服务重启、数据库迁移或数据删除
完成内容：新增 Web API Client，默认使用 /api/v2，开发环境通过 Vite proxy 转发到本地 API 127.0.0.1:3000，可选从浏览器 localStorage 读取 lisglosips.accessToken 作为 Bearer Token，不写入或输出任何明文凭据；Dashboard 接入 dashboard/summary 和 dashboard/trends；客户、供应商、充值记录、用户、角色、操作日志接入真实列表 API；客户/供应商新增、编辑、充值调用真实 API 并在成功后重新拉取数据；页面新增统一加载、错误和空状态，未登录或无权限时显示鉴权提示；顶部状态从“纯前端 Mock”改为真实 API 状态。CDR、计费、SIP 运维、监控告警、系统设置仍保留为未完成业务页面/静态运维原型，等待对应后端查询接口或后续延期页面设计，不在本任务伪造真实数据。
修改文件：apps/web/src/api.js、apps/web/src/App.jsx、apps/web/src/styles.css、apps/web/vite.config.js、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件；继续使用 React 18.2.0、Vite 5.4.21、pnpm 10.33.0
执行的关键命令：corepack pnpm@10.33.0 --filter @lisglosips/web build、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build、本地启动 corepack pnpm@10.33.0 --filter @lisglosips/web dev
验证结果：Web 单包 build 通过；全 workspace typecheck、lint、build 均通过；本地 Vite 页面 http://127.0.0.1:5173/ 返回 HTTP 200。API 服务若未启动或未登录，前端会展示错误态而不是回退到静态运营数据。
回滚方式：删除 apps/web/src/api.js，恢复 apps/web/src/App.jsx 中本次 API 数据加载、真实接口操作、空状态和顶部 API 状态改动，恢复 apps/web/src/styles.css 的空状态样式和 apps/web/vite.config.js proxy 配置，重新执行 corepack pnpm@10.33.0 --filter @lisglosips/web build；S27 未修改远端服务或数据库，无远端数据需回滚。
未解决问题：B 当前 /opt/lisglosips/current 仍是 S05 placeholder release，本次未部署到 B 当前 Web/API 服务；前端尚无登录页，真实接口需要已有 Bearer Token 或同源 Cookie 才能返回业务数据；CDR 查询、计费页面、自研 SIP 运维、监控告警、系统设置仍缺少对应产品化后端页面接口或属于延期页面，S27 未提前实现。
下一任务：S28 - 三机端到端联调

2026-06-21 21:20 - S26 Dashboard 聚合

状态：已完成
操作服务器：本地；未连接 A/B/T，未执行服务器写操作、服务重启、数据库迁移或数据删除
完成内容：新增 DashboardModule，实现 GET /api/v2/dashboard/summary 和 GET /api/v2/dashboard/trends；接口统一要求 dashboard.view 权限；summary 按 Asia/Shanghai 今日窗口聚合 raw CDR、rated CDR、启用客户/网关、待质检数量、失败响应码和失败落地网关 Top 10；trends 支持 hours=1..168、bucketMinutes=5|15|60，按固定桶返回通话、接通率、时长、客户费用、供应商成本和毛利；实时在线通话和注册数当前返回 0 并标记 source: "not_configured"，等待后续接入 Redis/OpenSIPS 指标。未新增预聚合表，未做 worker-metrics，未进入 S27 前端接入。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/dashboard/、docs/DASHBOARD_AGGREGATION_RUNBOOK.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件；继续使用既有 NestJS/Fastify、Prisma 6.19.0、Vitest 4.0.14、TypeScript 5.9.3
执行的关键命令：corepack pnpm@10.33.0 exec vitest run apps/api/src/modules/dashboard/dashboard.service.spec.ts、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build
验证结果：S26 聚焦测试 1 个文件 4 条通过，覆盖上海自然日边界、接通率、趋势桶和参数校验；全 workspace typecheck、lint、build 均通过
回滚方式：从 AppModule 移除 DashboardModule，删除 apps/api/src/modules/dashboard/ 和 docs/DASHBOARD_AGGREGATION_RUNBOOK.md，重新执行 corepack pnpm@10.33.0 build；S26 未对远端数据库写入，无远端数据需清理
未解决问题：B 当前 /opt/lisglosips/current 仍是 S05 placeholder release，本次未部署到 B 当前 API 服务；Dashboard 设计要求的真正实时在线通话/注册数仍需后续接入 Redis/OpenSIPS 指标；24 小时趋势最终应由 worker-metrics 或 CDR Worker 增量写入预聚合表，本次只做时间窗口受限查询，避免扫描全量 CDR。
下一任务：S27 - React Demo 接入真实 API

2026-06-21 21:05 - S25 质检后端

状态：已完成
操作服务器：本地；未连接 A/B/T，未执行服务器写操作、服务重启、数据库迁移或数据删除
完成内容：新增 QualityModule，实现 GET/POST/PATCH/DELETE /api/v2/quality/rules 及规则启停，支持按客户、线路组、比例、生效时间和过期时间配置抽检规则；新增稳定抽样算法 sha256(rule_id:recording_id)，同一规则与录音重复查询结果稳定；扩展 RecordingsModule，实现 GET /api/v2/recordings、GET /api/v2/recordings/:id、PUT /api/v2/recordings/:id/review，返回录音 CDR 摘要、最新质检、历史质检、上下条导航和抽样命中信息；保存质检结果写入 quality_reviews，不覆盖历史；规则变更和质检保存均接入 AuditAction 元数据；权限使用 quality.view、quality.manage、recordings.play。未做 Dashboard 聚合，未扩展 S26 内容。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/quality/、apps/api/src/modules/recordings/recordings.controller.ts、apps/api/src/modules/recordings/recordings.repository.ts、apps/api/src/modules/recordings/recordings.service.ts、apps/api/src/modules/recordings/recordings.module.ts、apps/api/src/modules/recordings/recordings.service.spec.ts、docs/QUALITY_BACKEND_RUNBOOK.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新软件；继续使用既有 NestJS/Fastify、Prisma 6.19.0、Vitest 4.0.14、TypeScript 5.9.3
执行的关键命令：corepack pnpm@10.33.0 exec vitest run apps/api/src/modules/quality/sampling.spec.ts apps/api/src/modules/recordings/recordings.service.spec.ts、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build
验证结果：S25 聚焦测试 2 个文件 6 条通过，覆盖稳定抽样可重复、比例边界、录音列表抽样状态、保存质检输入校验和 S24 内部播放路径安全；全 workspace typecheck、lint、build 均通过
回滚方式：删除或恢复 apps/api/src/modules/quality/，将 apps/api/src/modules/recordings/ 恢复到 S24 版本，从 AppModule 移除 QualityModule，重新执行 corepack pnpm@10.33.0 build；S25 未对远端数据库写入，无远端数据需清理；若后续已运行 API 并产生 quality_reviews，不直接删除历史记录，应通过审计可见的更正记录或受控维护窗口处理
未解决问题：B 当前 /opt/lisglosips/current 仍是 S05 placeholder release，本次未部署到 B 当前 API 服务；真实录音和 raw CDR 关联仍依赖 S28 端到端闭环产生；Dashboard 的待质检数量、趋势和聚合指标留给 S26。
下一任务：S26 - Dashboard 聚合

2026-06-21 20:20 - S24 录音搬运与播放

状态：已完成
操作服务器：A、B、本地；T 未操作
完成内容：新增 Recording Worker 搬运服务，支持扫描 A /dev/shm/voip_rec/ready/**/*.ready、SSH 私网拉取、文件大小校验、SHA-256、B 端 .part-* 临时文件原子改名、写入 recordings 表、校验成功后才删除 A 源 .ready；新增 GET /api/v2/recordings/:id/play，要求 recordings.play 权限，状态必须为 READY，通过 X-Accel-Redirect 转发到 Nginx 内部 /_recordings/，不暴露真实 /data/recordings 路径；A 端 finalizer ready 目录改为 0770，使专用拉取用户可在校验后删除源文件；B 建立专用拉取 key 和 known_hosts；A 建立专用低权限用户 lisglo-rec-pull 并加入 rtpengine 组。未调整 SSH 管理端口，未禁止 SSH key 登录，未重启 OpenSIPS、RTPEngine、Nginx 或 API。
修改文件：apps/worker-recording/src/main.ts、apps/worker-recording/src/transfer.ts、apps/worker-recording/src/transfer.spec.ts、apps/worker-recording/package.json、apps/worker-recording/tsconfig.json、apps/api/src/modules/app.module.ts、apps/api/src/modules/recordings/、pnpm-lock.yaml、infra/server-a/s19/scripts/lisglosips-recording-finalize、docs/RECORDING_TRANSFER_PLAYBACK_RUNBOOK.md、IMPLEMENTATION_STATUS.md；A 的 /usr/local/sbin/lisglosips-recording-finalize、/var/lib/lisglo-rec-pull/.ssh/authorized_keys 和 /dev/shm/voip_rec/ready 权限；B 的 /etc/lisglosips/recording/ 和 /data/recordings/s24-smoke/s24-smoke.wav
安装软件及固定版本：未安装新软件；继续使用既有 OpenSSH、Node.js v22.22.2、pnpm 10.33.0、Nginx 1.24.0-2ubuntu7.12。新增系统用户 lisglo-rec-pull，未新增系统包。
执行的关键命令：本地 corepack pnpm@10.33.0 exec vitest run apps/worker-recording/src/transfer.spec.ts apps/api/src/modules/recordings/recordings.service.spec.ts、corepack pnpm@10.33.0 --filter @lisglosips/worker-recording build、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；A bash -n /usr/local/sbin/lisglosips-recording-finalize、创建 S24 测试 incoming 文件并运行 finalizer；B 使用 lisglo-recorder 通过专用 key 从 A 拉取、校验、落盘、删除测试源文件。sudo 凭据通过 .codex-private/ 读取并经 stdin 使用，未回显。
验证结果：本地 2 个测试文件 5 条测试通过，覆盖路径安全、.ready 转 storage key、复制/哈希/落盘/源删除、大小不匹配不删除源文件、API 内部路径穿越防护；worker-recording 单包 build、全 workspace typecheck、lint、build 均通过；A 测试文件从 incoming 进入 ready，B 私网拉取到 /data/recordings/s24-smoke/s24-smoke.wav，大小 31，属主 lisglo-recorder:lisglosips，SHA-256 为 c72dd3909a317ad55817435b7ed5a0db6947455ffc66e09a2dde787fe4a8c348，校验后 A 源 .ready 已删除；外部直接访问 https://127.0.0.1/_recordings/s24-smoke/s24-smoke.wav 返回 404，Nginx 内部录音 location 未暴露。
回滚方式：A 备份目录 /var/backups/lisglosips-s24/20260621T121130Z，可恢复 lisglosips-recording-finalize、删除 lisglo-rec-pull 用户并将 /dev/shm/voip_rec/ready 恢复 0750；B 备份目录 /var/backups/lisglosips-s24/20260621T121100Z，可删除 /etc/lisglosips/recording 和 /data/recordings/s24-smoke；代码回滚恢复本次新增/修改文件后重新 build。详见 docs/RECORDING_TRANSFER_PLAYBACK_RUNBOOK.md。
未解决问题：B 当前 /opt/lisglosips/current 仍是 S05 placeholder release，尚未切换完整 monorepo API/Worker release，因此本次未启用正式 lisglosips@recording-worker.service，API 播放入口完成代码与构建但未在 B 当前 release 对外提供；真实通话录音字段仍依赖后续 S28 端到端路由/媒体闭环产生。
下一任务：S25 - 质检后端

2026-06-21 20:02 - B sudo 凭据复验

状态：已完成
操作服务器：B、本地；仅执行只读 SSH 与 sudo 校验，未修改服务器配置、未重启服务、未执行数据库写入或数据删除
完成内容：读取 .codex-private/ 中 DPAPI 保存的 B 凭据且未回显密码；复验 B SSH Key 登录正常；确认 hector 属于 sudo 组；使用保存的 sudo 凭据执行 sudo -v 成功；使用 sudo 执行只读权限检查成功
修改文件：IMPLEMENTATION_STATUS.md
安装软件及固定版本：无
执行的关键命令：ssh -F .codex-private\ssh\config lisglosips-b ...；PowerShell Import-Clixml .codex-private\SERVER_CREDENTIALS.clixml 后通过 stdin 向远端 sudo -S 提供凭据，命令与输出均未包含明文密码
验证结果：B 返回主机名 YanZi，用户 hector 在 sudo 组；sudo -v 退出码为 0；只读 sudo 检查退出码为 0
回滚方式：无服务器变更无需回滚；如需撤销本地状态记录，恢复本文件本节和顶部阻塞说明
未解决问题：S13-S17 历史任务仍未补做 B 临时库冒烟；若后续补验会涉及数据库写入，应在执行前单独说明影响与回滚点
下一任务：S24 - 录音搬运与播放

2026-06-21 19:55 - S23 最小计费与余额扣减

状态：已完成
操作服务器：本地；未连接 A/B/T，未执行服务器写操作、服务重启、数据库迁移或数据删除
完成内容：在 worker-cdr 中接入最小计费服务，Redis Stream CDR 消费后写入 raw_cdrs、成功通话写入 rated_cdrs、按落地网关周期秒数和周期费率计算费用、扣减客户余额，并用负数 customer_recharges 记录不可变扣费流水；同一 event_id 或同一 raw_cdr_id 不重复扣费；失败 CDR、零时长 CDR、缺少客户或落地网关 ID 的 CDR 标记 SKIPPED 且不扣费。当前尚无客户侧费率表，S23 采用落地网关费率临时镜像为客户费用，供应商成本相同，毛利为 0，后续真实计费版本再扩展客户费率和利润计算。
修改文件：apps/worker-cdr/src/main.ts、apps/worker-cdr/src/billing.ts、apps/worker-cdr/src/rating.ts、apps/worker-cdr/src/rating.spec.ts、apps/worker-cdr/package.json、apps/worker-cdr/tsconfig.json、apps/worker-cdr/dist/、docs/CDR_MINIMAL_BILLING_RUNBOOK.md、IMPLEMENTATION_STATUS.md；本地因 pnpm install 受 registry DNS/metadata 影响，手工补齐 apps/worker-cdr/node_modules/@lisglosips/database 到 packages/database 的开发 junction
安装软件及固定版本：未安装新软件；继续使用既有 Node.js/pnpm、Prisma 6.19.0、Vitest 4.0.14、TypeScript 5.9.3
执行的关键命令：corepack pnpm@10.33.0 exec vitest run apps/worker-cdr/src/rating.spec.ts、corepack pnpm@10.33.0 --filter @lisglosips/worker-cdr build、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；尝试 corepack pnpm@10.33.0 install 与 install --offline 时被 npm registry DNS/本地 metadata 问题阻塞，未作为验收依据
验证结果：apps/worker-cdr/src/rating.spec.ts 3 条测试通过，覆盖周期计费、成功 CDR 扣费幂等、失败/零时长 CDR 不扣费；worker-cdr 单包 build 通过；全 workspace typecheck、lint、build 均通过
回滚方式：恢复 apps/worker-cdr/src/main.ts 到 S22 只记录 CDR 的版本，删除或恢复 S23 新增的 billing.ts、rating.ts、rating.spec.ts，恢复 apps/worker-cdr/package.json 和 tsconfig.json 后重新执行 corepack pnpm@10.33.0 build；S23 未执行真实数据库写入验证，无远端数据需要清理；若后续已运行 worker 并产生扣费，必须先停止 worker，再通过受控反向流水或备份恢复处理，不直接删除余额流水
未解决问题：B sudo 凭据仍不可用，本次未部署 B systemd worker、未对真实 B MySQL 执行写入式冒烟；当前最小计费暂时镜像落地网关费率为客户费用，客户费率表、利润规则、低余额拦截和 Dashboard 聚合留给后续任务；pnpm install 当前受 registry DNS/metadata 影响，后续若新增依赖需优先修复本地包管理器联网或缓存
下一任务：S24 - 录音搬运与播放

2026-06-21 19:34 - S22 CDR Redis Stream

状态：已完成
操作服务器：A、T、本地；B 仅通过 A 的 Redis AUTH proxy 写入 Redis Stream Consumer Group 元数据，未使用 B sudo，未改 B 服务
完成内容：新增 CDR Stream schema v1 和可靠消费库，支持 stream:cdr_payload、stream:cdr_deadletter、billing-workers Consumer Group、XREADGROUP、XACK、XAUTOCLAIM Pending 重领、死信写入和 lock:cdr:{event_id} 幂等占位；worker-cdr 从骨架改为 Redis Stream Worker，启动时确保 Consumer Group，循环先处理 Pending 再读取新消息，当前 handler 只接收/记录原始 CDR，不做计费和余额扣减；按多 A 后续演进预留 node_id、opensips_instance、ingress_a_ip、rtpengine_node 字段，当前单 A 值为 a1、opensips-a1、100.90.90.90、a1；升级 Server A OpenSIPS route[S20_CDR_XADD]，从 S20 冒烟 XADD 改为 S22 正式事件字段；在 Redis 创建 billing-workers Consumer Group。未调整 SSH 管理端口或密钥登录策略，未写入明文密码。
修改文件：packages/redis/src/index.ts、packages/redis/src/cdr-stream.ts、packages/redis/src/cdr-stream.spec.ts、apps/worker-cdr/src/main.ts、packages/redis/dist/、apps/worker-cdr/dist/、infra/server-a/s22/opensips/opensips.cfg、docs/CDR_REDIS_STREAM_RUNBOOK.md、SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md；A 的 /etc/opensips/opensips.cfg；Redis stream:cdr_payload Consumer Group billing-workers
安装软件及固定版本：未安装新系统软件；继续使用既有 Node.js/pnpm、OpenSIPS 3.6.7-1、Redis 7.0.15。新增代码复用既有 ioredis 5.8.2。
执行的关键命令：本地 corepack pnpm@10.33.0 exec vitest run packages/redis/src/cdr-stream.spec.ts、corepack pnpm@10.33.0 lint/typecheck/build；A opensips -C -f /etc/opensips/opensips.cfg、systemctl restart opensips；A 经本地 Redis proxy 执行 XGROUP CREATE stream:cdr_payload billing-workers 0 MKSTREAM、XINFO GROUPS、XREVRANGE；T 执行 /opt/lisglosips-s21/lisglosips-s21-sip.py invite --timeout 8。sudo 凭据通过 .codex-private/ 读取且未回显。
验证结果：Redis Stream 单元测试 6 条通过，覆盖发布/解析、Consumer Group 幂等创建、XREADGROUP/XACK、重复 event_id 幂等、死信、XAUTOCLAIM Pending 重领；lint、typecheck、全 workspace build 均通过；A OpenSIPS 配置语法检查通过并重启后 active；Redis XINFO GROUPS stream:cdr_payload 显示 billing-workers，pending 为 0；T 发 INVITE 后 A 返回 SIP/2.0 503 Config Missing，A 日志显示 CDR XADD 成功，Redis 最新事件包含 schema_version=1、idempotency_key、node_id=a1、opensips_instance=opensips-a1、ingress_a_ip=100.90.90.90、rtpengine_node=a1、sip_code=503、hangup_reason=CONFIG_MISSING。一次使用 S21 默认 3 秒超时的探针未收到响应，但 A 已写入 CDR；随后使用 8 秒超时复测收到预期 503 Config Missing。
回滚方式：A 备份目录为 /var/backups/lisglosips-s22/20260621T113157Z，恢复其中 opensips.cfg 后执行 opensips -C -f /etc/opensips/opensips.cfg 并重启 opensips；代码回滚恢复本次新增/修改的 Redis/worker 文件后重新 build；Redis Consumer Group 可保留，停止 worker 即可，不删除 stream:cdr_payload 数据。详见 docs/CDR_REDIS_STREAM_RUNBOOK.md。
未解决问题：S22 只完成原始 CDR Stream 契约和可靠消费基础，不写 MySQL raw/rated CDR、不计费、不扣余额，这些留给 S23；A 端当前仍未发布真实路由配置，因此测试 CDR 为 CONFIG_MISSING 失败事件；B sudo 凭据仍不可用，本次未执行 B 端服务部署或 systemd worker 验收；多 A 仅完成字段预留和 A1 默认值，真实 3A 部署留到单 A 闭环之后。
下一任务：S23 - 最小计费与余额扣减

2026-06-21 15:28 - S21 Server T 客户模拟配置

状态：已完成
操作服务器：T、本地；A 仅接收 T 发起的 SIP 探针，未写入；B 未操作
完成内容：在 Server T 建立 S21 客户模拟环境；新增测试域 s21.lisglosips.test；新增两套 SIP 注册测试账号 s21-reg-1001、s21-reg-1002，OpenSIPS 改为 HA1 鉴权，subscriber.password 为空且不保存 SIP 明文密码；新增两套 IP 认证测试条目 s21-ip-1001、s21-ip-1002 指向 T 100.93.185.30/32；部署 /opt/lisglosips-s21 自包含 SIP 脚本，支持注册成功、错误鉴权、向 A 发起 IP/SIP 模拟 INVITE、本地成功/忙/拒绝/超时场景和突发 CPS 探针；收敛 T 的 MI FIFO 权限为 0660，TLS 私钥权限为 0600。未调整 SSH 管理端口或密钥登录策略，未写入明文密码。
修改文件：T 的 /etc/opensips/opensips.cfg、OpenSIPS opensips 数据库 domain/subscriber/address/location 测试数据、/opt/lisglosips-s21/、/etc/lisglosips-s21/sip-accounts.env；本地 infra/server-t/s21/、docs/SERVER_T_CUSTOMER_SIMULATION_RUNBOOK.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；继续使用 T 既有 OpenSIPS 3.6.6、RTPEngine 11.5.1.18、MariaDB 10.11.14 和系统 Python 3。新增 SIP 测试脚本无第三方依赖。
执行的关键命令：mysqldump --single-transaction --routines --events opensips、opensips -C -f /etc/opensips/opensips.cfg、systemctl restart opensips、mysql --protocol=socket -uroot、python3 -m py_compile、/opt/lisglosips-s21/s21-register-*、s21-local-*、s21-call-a-*、s21-over-cps-a。sudo 凭据通过 .codex-private/ 读取且未回显。
验证结果：备份目录 /var/backups/lisglosips-s21/20260621T072316Z 已生成并含 OpenSIPS 配置和数据库 dump；OpenSIPS 配置语法检查通过，opensips.service active；s21-register-primary 和 s21-register-secondary 均先收到 401 Unauthorized challenge 后最终 200 OK，s21-register-wrong-ha1 最终 401 Unauthorized；location 表已有 s21-reg-1001、s21-reg-1002 注册位置；subscriber.password 长度为 0，ha1 长度为 32；本地脚本分别返回 200 OK、486 Busy Here、603 Decline 和 NO RESPONSE；从 T 到 A 的 s21-call-a-ip、s21-call-a-sip 与 5 次 s21-over-cps-a 均稳定输出 Call-ID 并收到 A 当前预期的 SIP/2.0 503 Config Missing；MI FIFO 为 660 opensips:opensips，TLS 私钥文件为 600 root:root。
回滚方式：停止 T 的 opensips，从 /var/backups/lisglosips-s21/20260621T072316Z/opensips 恢复 /etc/opensips，用该目录 opensips.sql 恢复 OpenSIPS 数据库，删除 /opt/lisglosips-s21 和 /etc/lisglosips-s21，执行 opensips -C -f /etc/opensips/opensips.cfg 后启动 opensips。详见 docs/SERVER_T_CUSTOMER_SIMULATION_RUNBOOK.md。
未解决问题：A 端尚未发布真实客户/路由配置，因此 T 到 A 的 INVITE 当前按 S20 逻辑返回 503 Config Missing，真实路由、双向媒体、正式 CDR 和扣费留给 S22/S28；T 的 RTPEngine 仍无内核加速，防火墙默认放行、Apache/rpcbind 暴露和克隆身份问题仍为历史风险，未在 S21 扩大处理。
下一任务：S22 - CDR Redis Stream

2026-06-21 15:05 - S20 Server A Redis 热路径与 HEP/指标

状态：已完成
操作服务器：A、B、T、本地
完成内容：在 Server A 部署 Redis 热路径 Lua 原子检查，基于 cfg:active_version 和版本化 cfg:v:{version}:* 配置读取客户、客户网关、IP 认证、策略与线路组；OpenSIPS INVITE 接入 Lua 热路径，配置缺失返回 503 Config Missing，Redis 不可用返回 503 Redis Unavailable，策略允许但路由未进入 S21/S28 前返回 503 Routing Not Ready；新增 CDR 冒烟 XADD 到 stream:cdr_payload；新增本地 Redis AUTH 代理，凭据通过 systemd encrypted credential 加载，OpenSIPS 只连接 127.0.0.1:6380；修正 HEP socket 为 100.90.90.90:9061 并发送至 B 100.90.90.91:9060；新增 OpenSIPS Prometheus script: 指标和 Node Exporter textfile 指标；新增 S20 nftables 表阻断非本地 Redis 代理和非既有连接访问 HEP socket；未调整 SSH 管理端口或密钥登录策略，未写入明文密码。
修改文件：A 的 /etc/opensips/opensips.cfg、/etc/opensips/lisglosips_hotpath.lua、/usr/local/sbin/lisglosips-redis-auth-proxy、/usr/local/sbin/lisglosips-redis-load-hotpath、/usr/local/sbin/lisglosips-opensips-preprocess、/usr/local/sbin/lisglosips-s20-metrics、/etc/systemd/system/lisglosips-redis-auth-proxy.service、/etc/systemd/system/lisglosips-redis-hotpath-load.service、/etc/systemd/system/opensips.service.d/20-lisglosips-s20.conf、/etc/systemd/system/lisglosips-s20-metrics.service、/etc/systemd/system/lisglosips-s20-metrics.timer、/etc/default/lisglosips-node-exporter、/etc/nftables.d/lisglosips-s20-observability.nft、/etc/systemd/system/lisglosips-a-firewall.service；本地 infra/server-a/s20/、docs/SERVER_A_REDIS_HEP_METRICS_RUNBOOK.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；继续使用 OpenSIPS 3.6.7-1、Redis Server B 既有 7.0.15、Node Exporter 1.7.0、RTPEngine 11.5.1.18-1ubuntu1.2。新增 systemd encrypted credential 文件 /etc/credstore.encrypted/lisglosips-redis-password.cred，未写明文凭据。
执行的关键命令：opensips -C -f /etc/opensips/opensips.cfg、systemctl daemon-reload/enable/restart/start/stop、nft -c/-f、curl http://127.0.0.1:8888/metrics、curl http://100.90.90.90:9100/metrics、从 T 发送 SIP INVITE，A/B Redis RESP 冒烟，A tcpdump 观察 HEP，B journalctl -u heplify-server 查询 HEP 统计。所有凭据均通过 .codex-private/ 读取并已避免回显。
验证结果：A systemctl is-system-running 为 running；opensips、lisglosips-redis-auth-proxy、lisglosips-s20-metrics.timer、lisglosips-node-exporter、lisglosips-a-firewall、rtpengine-daemon、rtpengine-recording-daemon 均 active，S20 新增服务均 enabled；lisglosips-redis-hotpath-load.service oneshot 结果为 success；监听端口为 100.90.90.90:15060/udp、100.90.90.90:9061/udp、127.0.0.1:6380/tcp、127.0.0.1:8888/tcp、100.90.90.90:9100/tcp；S20 nftables 表存在；A 到 B Redis PING/AUTH 通过；无配置版本时 T 发 INVITE 返回 SIP/2.0 503 Config Missing，OpenSIPS 记录热路径拒绝且 CDR XADD 成功；临时 Redis 冒烟配置下 T 发 INVITE 返回 SIP/2.0 503 Routing Not Ready，返回字段含配置版本、客户网关、策略和线路组，测试 Redis keys 与 CDR 事件已清理；短暂停止 Redis 代理后 T 发 INVITE 返回 SIP/2.0 503 Redis Unavailable，日志明确记录 Redis 热路径不可用和 CDR XADD 失败，代理与 Lua loader 随后恢复；OpenSIPS Prometheus 暴露 lisglosips_opensips_s20_*，B 可抓取 A Node Exporter textfile 指标 lisglosips_redis_proxy_up、录音 tmpfs、ready/part 文件数和 RTPEngine sessions；HEP 绑定修正后 A 侧抓包看到发往 B 9060/udp 的 HEP，B heplify 统计显示 HEP 收包且 Error 为 0，修正后 A 无新增 HEP 发送错误；S20 本地产物敏感扫描未发现明文凭据，命中的仅为 credential 名称或历史文档中的安全术语。
回滚方式：A 备份目录为 /var/backups/lisglosips-s20/20260621T061900Z，验证阶段的 OpenSIPS 配置副本位于该目录 post-verify/ 下；回滚时停止 S20 metrics timer 和 Redis AUTH proxy，从备份恢复 /etc/opensips/opensips.cfg、S20 systemd/drop-in、Node Exporter 默认文件和 nftables 文件，执行 opensips -C -f /etc/opensips/opensips.cfg 后重启 opensips、lisglosips-node-exporter、lisglosips-a-firewall，不删除 Redis Stream 历史数据。详细步骤见 docs/SERVER_A_REDIS_HEP_METRICS_RUNBOOK.md。
未解决问题：S20 只完成热路径检查、HEP 和指标，不实现真实落地路由、SIP 注册账号、双向媒体、正式 CDR 契约和计费；这些留给 S21/S22/S28。B sudo 凭据仍无法通过校验，本次 B 侧仅使用免 sudo 的只读 heplify 日志和已有服务凭据做验证；HOMER 数据库未稳定查到本次 OpenSIPS HEP Call-ID 行，但 heplify 已确认收包，后续 S28 端到端联调需继续核对 HOMER UI/库内 Call-ID。
下一任务：S21 - Server T 客户模拟配置

2026-06-21 14:00 - S19 Server A RTPEngine 与录音 tmpfs

状态：已完成
操作服务器：A、T、本地
完成内容：在 Server A 安装并固定 RTPEngine 11.5.1.18-1ubuntu1.2 及 kernel DKMS/recording 组件；加载 xt_RTPENGINE 内核模块，DKMS 已为 6.17.0-22-generic 与 6.17.0-35-generic 构建；配置 RTPEngine 媒体地址 100.90.90.90、RTP 30000-40000/udp、本地 NG/CLI/HTTP 控制口 127.0.0.1:2223/2224/2225；创建 /dev/shm/voip_rec 3 GiB tmpfs 与 spool/incoming/ready/failed/tmp 目录；部署录音 finalizer，按 incoming -> ready/*.part -> ready/*.ready 原子规则生成 ready 文件；新增 lisglosips-a-firewall.service 保障 S18/S19 nftables 表重启后自动加载；新增 OpenSIPS systemd drop-in 等待 Tailscale 地址后启动；覆盖 rtpengine-recording-daemon.service，移除包默认 NFS/rpcbind 依赖；停止并 mask S19 不使用的 rpcbind.service/socket。未调整 SSH 管理端口或密钥登录策略。
修改文件：A 的 /etc/rtpengine/rtpengine.conf、/etc/rtpengine/rtpengine-recording.conf、/etc/default/rtpengine-daemon、/etc/default/rtpengine-recording-daemon、/etc/fstab、/etc/nftables.d/lisglosips-s19-rtpengine.nft、/etc/systemd/system/lisglosips-a-firewall.service、/etc/systemd/system/opensips.service.d/10-lisglosips-wait-tailscale.conf、/etc/systemd/system/rtpengine-recording-daemon.service、/etc/systemd/system/lisglosips-recording-finalize.service、/etc/systemd/system/lisglosips-recording-finalize.timer、/etc/tmpfiles.d/lisglosips-voip-rec.conf、/usr/local/sbin/lisglosips-recording-finalize；本地 infra/server-a/s19/、docs/SERVER_A_RTPENGINE_RECORDING_RUNBOOK.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：rtpengine、rtpengine-daemon、rtpengine-recording-daemon、rtpengine-iptables、rtpengine-kernel-dkms、rtpengine-utils 均为 11.5.1.18-1ubuntu1.2 并已 apt-mark hold；安装匹配内核 headers。未新增明文凭据。
执行的关键命令：apt-get install、apt-mark hold、modprobe xt_RTPENGINE、dkms status、nft -c/-f、systemctl daemon-reload/enable/restart/reboot、systemd-tmpfiles --create、rtpengine-ctl -ip 127.0.0.1 -port 2224 list numsessions/interfaces、tcpdump、从 T 发送 RTP UDP 与 SIP OPTIONS/REGISTER 测试包。
验证结果：A 二次重启后 systemctl is-system-running 为 running 且 0 failed unit；opensips、rtpengine-daemon、rtpengine-recording-daemon、lisglosips-recording-finalize.timer、lisglosips-a-firewall.service、lisglosips-node-exporter.service 全部 active/enabled；/dev/shm/voip_rec 为 3.0 GiB tmpfs，子目录均为 rtpengine:rtpengine 0750；xt_RTPENGINE 已加载，DKMS 状态 installed；rtpengine-ctl 显示接口 100.90.90.90 和端口段 30000 - 40000；nftables S18/S19 表重启后存在；从 T 到 A 30000/udp、40000/udp 的 RTP 探针在 A tailscale0 抓包可见；从 T 发 SIP OPTIONS 返回 SIP/2.0 200 Keepalive，REGISTER 返回 SIP/2.0 401 Authentication Required 和 WWW-Authenticate；录音 finalizer 冒烟将测试 .wav 生成 ready/...wav.ready，权限 0640，无 .part 残留，测试文件已删除；本地 S19 产物敏感信息扫描未命中。
回滚方式：A 备份目录为 /var/backups/lisglosips-s19/20260621T054645Z；回滚时停止 rtpengine-recording-daemon、lisglosips-recording-finalize.timer、rtpengine-daemon，从备份恢复 /etc/rtpengine/、/etc/default/、/etc/fstab 等配置，删除 inet lisglosips_s19_rtpengine nftables 表，停用并删除 S19 systemd/tmpfiles/finalizer 文件，必要时 apt-mark unhold 后卸载 RTPEngine 包；详细步骤见 docs/SERVER_A_RTPENGINE_RECORDING_RUNBOOK.md。
未解决问题：S19 尚未把 OpenSIPS 呼叫路由接入 RTPEngine，真实双向音频、NAT 媒体锚定和完整通话录音需在 S20/S21/S28 完成；Tailscale APT 源在 A 上仍有 DNS 解析失败历史但当前 Tailscale 网络和服务运行正常；B sudo 凭据阻塞仍未解决，不影响本次 A 端 S19。
下一任务：S20 - Server A Redis 热路径与 HEP/指标

2026-06-21 13:29 - S18 Server A OpenSIPS 基线

状态：已完成
操作服务器：A、本地
完成内容：在 Server A 添加 OpenSIPS 官方 APT 源并安装固定 OpenSIPS 3.6.7-1；安装并 hold opensips、opensips-cli、opensips-auth-modules、opensips-redis-module、opensips-http-modules、opensips-json-module、opensips-restclient-module、opensips-prometheus-module、opensips-tlsmgm-module、opensips-tls-module、opensips-tls-openssl-module；部署 /etc/opensips/opensips.cfg，OpenSIPS 仅监听 100.90.90.90:15060/udp，HEP transport 占位监听 127.0.0.1:9061/udp，MI HTTP 仅监听 127.0.0.1:8888/tcp；加载 auth、pike、ratelimit、cachedb_redis、proto_hep、tracer、mi_http 等模块；实现 S18 保守路由基线：OPTIONS 返回 200 Keepalive，REGISTER 返回带 Digest challenge 的 401 Authentication Required，INVITE 在 S20/S21 前返回 503 Routing Not Ready，避免开放中继；新增 inet lisglosips_s18_opensips nftables 表，只允许 T 100.93.185.30 访问 A 的 UDP 15060，丢弃其他 15060 来源，并阻断非本地 MI HTTP；未调整 SSH 管理端口或密钥登录策略。
修改文件：A 的 /etc/apt/sources.list.d/opensips.list、/etc/apt/sources.list.d/opensips-cli.list、/etc/opensips/opensips.cfg、/etc/default/opensips、/etc/nftables.d/lisglosips-s18-opensips.nft；本地 infra/server-a/s18/、docs/SERVER_A_OPENSIPS_BASELINE_RUNBOOK.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：OpenSIPS 3.6.7-1；OpenSIPS CLI 0.4.0~20260522~570a9a9-1；所有 S18 OpenSIPS 包已 apt-mark hold。未新增明文凭据。
执行的关键命令：apt-get update、apt-get install、apt-mark hold、opensips -C -f /etc/opensips/opensips.cfg、systemctl enable --now/restart opensips、nft -c -f /etc/nftables.d/lisglosips-s18-opensips.nft、nft -f /etc/nftables.d/lisglosips-s18-opensips.nft、curl -X POST http://127.0.0.1:8888/mi、从 T 发送 SIP OPTIONS/REGISTER 测试包。
验证结果：A 系统状态 running；opensips.service active/enabled；OpenSIPS 配置语法检查通过；监听端口为 100.90.90.90:15060/udp、127.0.0.1:9061/udp、127.0.0.1:8888/tcp，S06 的 100.90.90.90:9100/tcp 保持；MI HTTP JSON-RPC version 返回 OpenSIPS (3.6.7 (x86_64/linux))；从 T 100.93.185.30 发往 A 15060/udp 的 SIP OPTIONS 返回 SIP/2.0 200 Keepalive；SIP REGISTER 返回 SIP/2.0 401 Authentication Required 且包含 WWW-Authenticate；nftables S18 表加载成功；本地 S18 产物敏感信息扫描未命中。
回滚方式：A 备份目录为 /var/backups/lisglosips-s18/20260621T051403Z；回滚时执行 systemctl stop opensips，从备份恢复 /etc/opensips/ 和 /etc/default/opensips，删除 inet lisglosips_s18_opensips nftables 表，必要时 apt-mark unhold 并卸载 S18 OpenSIPS 包；详细步骤见 docs/SERVER_A_OPENSIPS_BASELINE_RUNBOOK.md。
未解决问题：Tailscale APT 源在 A 上一度 DNS 解析失败，但 Tailscale 服务和当前连接未受影响；A 仍存在 S01 记录的本地 ens18 双地址/路由历史风险，S18 的 OpenSIPS 绑定 Tailscale 地址规避了 SIP 监听歧义；当前 HEP trace 已有目标配置但未查询 B 的 HOMER 入库，完整 HEP/Redis 热路径和指标留给 S20；RTPEngine、RTP 端口和录音 tmpfs 留给 S19。
下一任务：S19 - Server A RTPEngine 与录音 tmpfs

2026-06-21 13:06 - S17 落地线路组 API

状态：已完成
操作服务器：本地；B 未执行写操作
完成内容：新增 LandingLineGroupsModule，提供 GET /landing-line-groups、GET /landing-line-groups/:id、POST /landing-line-groups、PATCH /landing-line-groups/:id、POST /landing-line-groups/:id/enable、POST /landing-line-groups/:id/disable、DELETE /landing-line-groups/:id、POST /landing-line-groups/:id/items、PATCH /landing-line-groups/items/:itemId、DELETE /landing-line-groups/:id/items/:gatewayId、POST /landing-line-groups/:id/items/reorder；支持线路组启停、软删除、成员增删改、成员优先级重排、权重、成员并发上限和成员状态；返回 itemCount、enabledItemCount、concurrencyCapSum、gatewayConcurrencyLimitSum 和 policyCount，用于组内并发汇总与引用可见性；新增引用校验，成员只能引用未删除落地网关，软删除线路组前阻止仍被未删除客户网关策略引用的线路组删除；读操作绑定 line_groups.view，写操作绑定 line_groups.manage 和审计动作；线路组与成员变更写入 line_group_config Outbox，Config Publisher 扩展线路组快照并发布 cfg:v:{version}:line_group:* 与 line_group:*:items。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/landing-line-groups/、apps/worker-config-publisher/src/publisher.ts、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；未新增 npm 包；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test -- landing-line-groups、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build。
验证结果：typecheck 通过；S17 相关 Vitest 14 个测试文件 44 条测试通过，其中 landing-line-groups.e2e.spec.ts 覆盖线路组列表并发汇总、写权限拒绝、创建、成员新增/更新/删除、成员参数校验、优先级重排、启停、软删除和审计记录；全量 Vitest 14 个测试文件 44 条测试通过；lint 通过；workspace build 通过，包含 apps/worker-config-publisher 构建通过。
回滚方式：移除 LandingLineGroupsModule 导入并删除 apps/api/src/modules/landing-line-groups/；恢复 apps/worker-config-publisher/src/publisher.ts 中 S17 新增的 line_group_config Outbox 处理和线路组快照发布逻辑。S17 未新增数据库迁移，B 端未创建临时库、未改服务、未写 Redis 或 MySQL。
未解决问题：B 写入式临时库冒烟未执行，因为当前 B sudo 凭据仍无法通过校验，迁移账号也无权创建临时库；S17 不实现 OpenSIPS 呼叫路由或 Server A 配置，这些从 S18 开始。
下一任务：S18 - Server A OpenSIPS 基线

2026-06-21 11:57 - S16 落地网关 API

状态：已完成
操作服务器：本地；B 未执行写操作
完成内容：新增 VendorGatewaysModule，提供 GET /vendor-gateways、GET /vendor-gateways/:id、POST /vendor-gateways、PATCH /vendor-gateways/:id、POST /vendor-gateways/:id/enable、POST /vendor-gateways/:id/disable；支持供应商落地网关 IP、SIP_DIGEST、MIXED 三种认证模式，创建和更新时校验 host/port/transport、SIP 用户名与密码强度，并以 username:host:password 生成 HA1，API 响应只返回 hasSipCredential 不返回明文密码或 HA1；支持 CPS、并发上限、禁呼时段、编码优先级、主叫/被叫号码前缀转换、计费周期秒数和周期费率，响应补充按分钟折算的 minuteRate；写操作绑定 vendor_gateways.manage 和审计动作，读操作绑定 vendor_gateways.view；落地网关创建、更新、启停写入 vendor_gateway_config Outbox，Config Publisher 扩展供应商落地网关快照并发布到 Redis 版本化配置。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/vendor-gateways/、apps/worker-config-publisher/src/publisher.ts、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；未新增 npm 包；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test -- vendor-gateways、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build。
验证结果：typecheck 通过；S16 相关 Vitest 13 个测试文件 40 条测试通过，其中 vendor-gateways.e2e.spec.ts 覆盖列表脱敏、写权限拒绝、完整 SIP Digest 网关创建、审计敏感字段脱敏、切换 IP 模式清空 SIP 凭据、重复编码优先级校验和启停；全量 Vitest 13 个测试文件 40 条测试通过；lint 通过；workspace build 通过，包含 apps/worker-config-publisher 构建通过。
回滚方式：移除 VendorGatewaysModule 导入并删除 apps/api/src/modules/vendor-gateways/；恢复 apps/worker-config-publisher/src/publisher.ts 中 S16 新增的 vendor_gateway_config Outbox 处理和落地网关快照发布逻辑。S16 未新增数据库迁移，B 端未创建临时库、未改服务、未写 Redis 或 MySQL。
未解决问题：B 写入式临时库冒烟未执行，因为当前 B sudo 凭据仍无法通过校验，迁移账号也无权创建临时库；S16 不实现落地线路组成员、优先级重排或并发汇总，这些留给 S17。
下一任务：S17 - 落地线路组 API

2026-06-21 11:45 - S15 供应商管理 API

状态：已完成
操作服务器：本地；B 未执行写操作
完成内容：新增 VendorsModule，提供 GET /vendors、GET /vendors/:id、POST /vendors、PATCH /vendors/:id、POST /vendors/:id/enable、POST /vendors/:id/disable、DELETE /vendors/:id；供应商返回余额、授信额度、可用余额和落地网关数量；余额保持只读，供应商充值仍通过 S12 的不可变充值流水；支持联系人、电话、邮箱、结算方式、备注、授信额度和启停状态维护；软删除前阻止仍有关联未删除落地网关的供应商删除；读操作绑定 vendors.view，写操作绑定 vendors.manage 和审计动作。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/vendors/、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；未新增 npm 包；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test -- vendors、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build。
验证结果：typecheck 通过；S15 相关 Vitest 12 个测试文件 36 条测试通过；全量 Vitest 12 个测试文件 36 条测试通过，覆盖供应商余额/授信/网关数量读取、写权限拒绝、新增、编辑、启停、软删除和审计记录；lint 通过；workspace build 通过。
回滚方式：移除 VendorsModule 导入并删除 apps/api/src/modules/vendors/；S15 未新增数据库迁移。B 端未创建临时库、未改服务、未写 Redis 或 MySQL。
未解决问题：B 写入式临时库冒烟未执行，因为当前 B sudo 凭据仍无法通过校验，迁移账号也无权创建临时库；S15 不实现落地网关、费率、CPS/并发或号码转换，这些留给 S16。
下一任务：S16 - 落地网关 API

2026-06-21 11:39 - S14 客户网关策略与 Redis 配置发布

状态：已完成
操作服务器：本地；B 未执行写操作
完成内容：新增 CustomerGatewayPoliciesModule，提供 GET /customer-gateways/:id/policies、POST /customer-gateways/:id/policies、PATCH /customer-gateway-policies/:id、DELETE /customer-gateway-policies/:id、POST /customer-gateways/:id/policies/reorder；支持主叫/被叫 ANY、EQUALS、PREFIX 匹配，校验非 ANY 模式必须提供匹配值；支持显式优先级和自动追加优先级，重排时要求一次提交全部有效策略 ID 并用两阶段负优先级避免唯一索引冲突；客户网关创建、更新、启停以及策略创建、更新、删除、重排均在同一事务内写入 outbox_events，不直接双写 Redis；Config Publisher 从骨架升级为处理 customer_gateway_config Outbox 的 worker，生成完整 Redis 配置快照，写入 cfg:v:{version}:customer:*、customer_gateway:*、auth:ip:*、auth:sip:* 和策略列表，原子切换 cfg:active_version，并维护 cfg:previous_version 作为回滚点；新增 rollbackActiveConfig 函数用于切回上一版本。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/customer-gateways/customer-gateways.repository.ts、apps/api/src/modules/customer-gateway-policies/、apps/worker-config-publisher/src/main.ts、apps/worker-config-publisher/src/publisher.ts、apps/worker-config-publisher/package.json、apps/worker-config-publisher/tsconfig.json、packages/redis/src/index.ts、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；未新增需要联网下载的 npm 包；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0、ioredis 5.8.2（由 @lisglosips/redis 继续提供）。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test -- customer-gateway、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；曾尝试 corepack pnpm@10.33.0 install，因本机 DNS 无法解析 registry.npmjs.org 失败，随后移除新增联网依赖，最终无需更新锁文件。
验证结果：typecheck 通过；S14 相关 Vitest 11 个测试文件 33 条测试通过；全量 Vitest 11 个测试文件 33 条测试通过，覆盖策略列表、权限拒绝、策略创建/更新/重排/删除、审计记录和匹配值校验；lint 通过；workspace build 通过，包含 apps/worker-config-publisher 构建通过。
回滚方式：移除 CustomerGatewayPoliciesModule 导入并删除 apps/api/src/modules/customer-gateway-policies/；恢复 apps/api/src/modules/customer-gateways/customer-gateways.repository.ts 中的 Outbox 写入前版本；恢复 apps/worker-config-publisher/src/main.ts 为骨架并删除 publisher.ts；恢复 packages/redis/src/index.ts 的 S14 新增 Redis 常量和 helper。S14 未新增数据库迁移，B 端未创建临时库、未改服务、未写 Redis。
未解决问题：B 写入式临时库/Redis 冒烟未执行，因为当前 B sudo 凭据仍无法通过校验，迁移账号也无权创建临时库；Config Publisher 当前完成客户/客户网关/策略快照发布，落地网关、线路组成员和供应商侧热路径会随 S15-S17 数据模型 API 补齐后扩展到快照。
下一任务：S15 - 供应商管理 API

2026-06-21 11:28 - S13 客户网关 API

状态：已完成
操作服务器：本地；B 仅读取 SSH/Node/pnpm 状态并尝试临时库验收，未修改正式库或服务
完成内容：新增 CustomerGatewaysModule，提供 GET /customer-gateways、GET /customer-gateways/:id、POST /customer-gateways、PATCH /customer-gateways/:id、POST /customer-gateways/:id/enable、POST /customer-gateways/:id/disable；支持 IP、SIP_DIGEST、MIXED 三种认证模式；创建和更新时校验来源 IP、SIP 用户名、SIP 域和密码强度；SIP 注册密码仅用于生成 OpenSIPS Digest HA1，API 响应只返回 hasSipCredential，不返回 sipPassword 或 sipHa1；SIP 用户名或域名变更时要求同时提交新密码，避免旧 HA1 与新身份不匹配；所有写操作绑定 customer_gateways.manage 和审计动作，读操作绑定 customer_gateways.view；日志脱敏路径新增 sipHa1。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/customer-gateways/、packages/observability/src/index.ts、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；B 端执行只读 hostname && node --version && pnpm --version；尝试通过 SSH 隧道连接 B MySQL 并用 MYSQL_MIGRATE 创建 S13 临时库，因账号无 mysql 系统库访问权限返回 P1010；B sudo 凭据校验失败，未继续执行需要 sudo 的 MySQL 创建/清理命令。
验证结果：本地 typecheck 通过；Vitest 10 个测试文件 29 条测试通过，新增覆盖客户网关只读权限、写权限拒绝、IP 网关返回脱敏、SIP Digest 网关创建、审计敏感字段脱敏、SIP 身份变更强制新密码、切换 IP 模式清空 SIP 凭据、启停接口；lint 通过；workspace build 通过；B 的 Node v22.22.2 和 pnpm 10.33.0 只读确认通过；B 临时库冒烟未完成，未创建临时库，SSH 隧道、本地 S13 临时 SQL 和远端 /tmp/lisglosips-s13-create-*.sql 已清理。
回滚方式：移除 CustomerGatewaysModule 导入并删除 apps/api/src/modules/customer-gateways/；从 packages/observability/src/index.ts 移除 *.sipHa1 脱敏项；S13 未新增数据库迁移。B 端未创建临时库、未修改服务，仅使用短时 SSH 隧道和 /tmp 临时 SQL 文件，已清理。
未解决问题：S13 未执行 B 临时库冒烟，因为当前 .codex-private 中的 B sudo 凭据无法通过校验，MYSQL_MIGRATE 也无权在 mysql 系统库创建临时库；后续需要修复 B sudo 凭据或提供受控临时库创建账号。S13 不实现客户网关策略、Outbox 或 Redis 发布，这些留给 S14。
下一任务：S14 - 客户网关策略与 Redis 配置发布

2026-06-21 11:14 - S12 充值与不可变余额流水

状态：已完成
操作服务器：本地、B
完成内容：新增 RechargesModule，提供 POST /customers/:id/recharges、POST /vendors/:id/recharges 和 GET /recharges；客户和供应商充值在同一数据库事务内完成账户行锁定、余额读取、不可变充值流水写入、余额更新和幂等结果保存；重复相同幂等键返回原充值结果，不重复加余额；同一幂等键不同请求返回冲突；充值写操作绑定 recharges.manage 和审计动作，查询绑定 recharges.view；并发写冲突和唯一键竞争只对 Prisma P2034/P2002 做短退避重试。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/recharges/、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；B 端通过 SSH 隧道连接临时 MySQL 库执行 prisma migrate deploy、db:seed、prisma migrate status，并使用编译后的充值仓库执行客户/供应商充值、幂等重放、幂等冲突和并发充值冒烟。
验证结果：本地 typecheck 通过；Vitest 9 个测试文件 24 条测试通过，覆盖充值权限拒绝、客户充值、供应商充值、幂等重放、幂等冲突、流水查询和审计记录；lint 通过；workspace build 通过；B 临时空库 lisglosips_s12_verify_20260621111322 成功应用 S08/S09 共 2 个迁移，seed 执行成功，migrate status 显示 schema up to date；B 临时库验证客户充值前后余额、供应商充值前后余额、重复幂等不重复入账、幂等冲突拒绝、5 路并发客户充值后余额 15.000000、客户流水 6 条、供应商流水 1 条、成功幂等记录 7 条；B 残留检查确认无 S12 临时库、临时用户和 /tmp/lisglosips-s12-* 文件。
回滚方式：移除 RechargesModule 导入并删除 apps/api/src/modules/recharges/；S12 未新增数据库迁移。B 端仅创建临时库、临时用户和 SSH 隧道，已删除或关闭。
未解决问题：S12 只实现手工充值入账；CDR 扣费、余额扣减和扣费幂等留给 S22/S23；供应商管理 CRUD 仍按任务顺序留给 S15。
下一任务：S13 - 客户网关 API

2026-06-21 10:57 - S11 客户管理 API

状态：已完成
操作服务器：本地、B
完成内容：新增 CustomersModule，提供客户列表、详情、新增、编辑、启用、停用和软删除 API；返回余额、授信额度、最低余额、可用余额和启用网关数量；客户余额只读，避免绕过 S12 充值流水；所有写操作均绑定 customers.manage 和审计动作，读操作绑定 customers.view；软删除前阻止仍有关联启用网关的客户删除。
修改文件：apps/api/src/modules/app.module.ts、apps/api/src/modules/customers/、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；B 端通过 SSH 隧道连接临时 MySQL 库执行 prisma migrate deploy、db:seed、prisma migrate status 和客户 CRUD 冒烟脚本。
验证结果：本地 typecheck 通过；Vitest 8 个测试文件 21 条测试通过，覆盖客户读权限、写权限拒绝、新增、启停、软删除、余额/授信字段和审计记录；lint 通过；workspace build 通过；B 临时空库 lisglosips_s11_verify_20260621105537 成功应用 S08/S09 共 2 个迁移，seed 执行成功，migrate status 显示 schema up to date；B 临时库客户创建、状态更新、Decimal 精度、网关计数和软删除冒烟通过；B 残留检查确认无 S11 临时库、临时用户和 /tmp/lisglosips-s11-* 文件。
回滚方式：移除 CustomersModule 导入并删除 apps/api/src/modules/customers/；S11 未新增数据库迁移。B 端仅创建临时库、临时用户和 SSH 隧道，已删除或关闭。
未解决问题：S11 不实现充值入账和余额变更事务，余额仍只能通过后续 S12 不可变流水更新；客户网关数量当前依赖后续 S13 的网关数据。
下一任务：S12 - 充值与不可变余额流水

2026-06-21 10:46 - S10 用户、角色、权限与审计

状态：已完成
操作服务器：本地、B
完成内容：实现全局 Access Token 认证 Guard、RBAC Guard、@Public、@RequirePermissions 与当前用户注入；新增用户、角色、权限和审计日志查询 API；实现用户创建、资料更新、重置密码和角色权限维护；内置角色禁止改名、停用和变更权限；重置密码仅保存 Argon2id 哈希并要求下次改密；新增审计拦截器，按接口元数据记录 request_id、操作者、角色、IP、User-Agent、模块、动作、对象、成功/失败、错误码和脱敏后的 before/after 摘要。
修改文件：packages/auth/src/index.ts、packages/database/src/index.ts、apps/api/src/modules/app.module.ts、apps/api/src/modules/auth/auth.controller.ts、apps/api/src/modules/health/health.controller.ts、apps/api/src/modules/security/、apps/api/src/modules/audit/、apps/api/src/modules/audit-logs/、apps/api/src/modules/users/、apps/api/src/modules/roles/、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 build；B 端通过 SSH 隧道连接临时 MySQL 库执行 prisma migrate deploy、db:seed、prisma migrate status；B 端检查并清理 lisglosips_s10_verify_*、s10v_* 和 /tmp/lisglosips-s10-* 临时残留。
验证结果：本地 typecheck 通过；Vitest 7 个测试文件 18 条测试通过，覆盖未认证拒绝、越权拒绝、重置密码审计脱敏、内置角色保护和审计日志查询；lint 通过；workspace build 通过；B 临时空库 lisglosips_s10_verify_20260621104300 成功应用 S08/S09 共 2 个迁移，seed 执行成功，migrate status 显示 schema up to date；B 残留检查确认无 S10 临时库、临时用户和 /tmp/lisglosips-s10-* 文件。
回滚方式：恢复上述本地文件到 S10 前版本；S10 未新增数据库迁移，若需回滚只需移除新增模块导入和相关接口代码。B 端仅创建临时库、临时用户和 /tmp 临时文件，已删除。
未解决问题：S10 只完成后端安全与审计基础；后续业务 API 必须继续显式标注权限和审计动作，客户、充值、网关等业务模块从 S11 开始实现。
下一任务：S11 - 客户管理 API

2026-06-21 10:15 - S09 登录认证基础

状态：已完成
操作服务器：本地、B
完成内容：实现登录、刷新和退出接口；新增 Argon2id 密码哈希与校验，优先使用 Node 原生实现并在 Node 22 上回退到 vendored WASM；实现 HMAC access token、HttpOnly refresh cookie、refresh token SHA-256 摘要入库、会话撤销与轮换、失败计数和临时锁定；新增 Prisma user_sessions 模型和迁移；补充 Auth API、服务层、密码/Token 原语和 schema 合同测试。
修改文件：packages/auth/src/index.ts、packages/auth/src/index.spec.ts、packages/auth/vendor/argon2id/、apps/api/src/modules/auth/、apps/api/src/modules/database/、apps/api/src/modules/app.module.ts、apps/api/src/shared/config.ts、apps/api/tsconfig.json、apps/api/package.json、.env.example、eslint.config.mjs、prisma/schema.prisma、prisma/migrations/20260621093000_auth_sessions/migration.sql、packages/database/src/schema-contract.spec.ts、pnpm-lock.yaml、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；vendored npm 包 argon2id 1.0.1，MIT 许可证，WASM 哈希记录于 packages/auth/vendor/argon2id/UPSTREAM.md；继续使用 Node.js v22.22.2、Prisma 6.19.0、pnpm 10.33.0。
执行的关键命令：corepack pnpm@10.33.0 prisma:validate、prisma:generate、typecheck、test、lint、build；B 端通过临时 /tmp 包验证 Node 22 下 Argon2id WASM 哈希与校验；通过 SSH 隧道连接 B 的临时 MySQL 库执行 prisma migrate deploy 和 prisma migrate status。
验证结果：本地 Prisma schema validate 通过；Prisma Client 生成通过；typecheck 通过；Vitest 6 个测试文件 15 条测试通过，覆盖 Argon2id、Token、登录成功、失败锁定、refresh 轮换、旧 refresh 拒绝、logout 后拒绝和健康检查；lint 通过；workspace build 通过；B Node v22.22.2 上 Argon2id WASM 校验结果为正确值通过、随机值拒绝；B 临时空库 lisglosips_s09_verify_20260621101249 成功应用 S08 与 S09 共 2 个迁移，migrate status 显示 schema up to date；B 残留检查确认临时库、临时用户和 /tmp/lisglosips-s09-* 文件已清理。
回滚方式：恢复上述本地文件到 S09 前版本；删除 prisma/migrations/20260621093000_auth_sessions/ 并从 prisma/schema.prisma 移除 UserSession 关系和模型。B 端仅创建临时库、临时用户和 /tmp 临时文件，已删除。
未解决问题：生产 access token secret 必须由受控环境变量注入；当前 S09 只实现认证基础，RBAC Guard、内置角色保护、重置密码和审计拦截器留给 S10。
下一任务：S10 - 用户、角色、权限与审计

2026-06-21 09:28 - S08 数据库 Schema 与迁移

状态：已完成
操作服务器：本地、B
完成内容：实现 V2 第 10 章核心数据模型，包括客户、客户网关、策略、供应商、落地网关、线路组、充值、CDR、录音、质检、用户、角色、权限、审计、Outbox 和幂等键；生成初始化迁移；新增内置权限/角色 seed；补充数据库 Schema Runbook 和 schema 合同测试；迁移 Prisma seed 配置到 prisma.config.ts。
修改文件：prisma/schema.prisma、prisma/migrations/20260621090000_init_v2_schema/migration.sql、prisma/seed.ts、prisma.config.ts、package.json、packages/database/src/schema-contract.spec.ts、docs/DATABASE_SCHEMA_RUNBOOK.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未安装新系统软件；继续使用 Prisma 6.19.0、MySQL 8.0.46、pnpm 10.33.0。
执行的关键命令：prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script、corepack pnpm@10.33.0 prisma:generate、prisma:validate、typecheck、test、lint、build；通过 SSH 隧道连接 B 的临时 MySQL 库执行 prisma migrate deploy、prisma db seed、重复 seed、重复 migrate deploy、prisma migrate status；使用 mysqldump --no-tablespaces 做临时库备份恢复验证。
验证结果：本地 Prisma schema validate 通过；Prisma Client 生成通过；lint 通过；typecheck 通过；Vitest 3 个测试文件 6 条测试通过；workspace build 通过；B 上临时空库 lisglosips_s08_verify_20260621091537 成功应用 1 个迁移；seed 重复执行安全；重复 migrate deploy 显示无待迁移；migrate status 显示 schema up to date；备份恢复后计数为 permissions=22、roles=5、role_permissions=53、_prisma_migrations=1。
回滚方式：恢复上述本地文件到 S08 前版本；删除 prisma/migrations/20260621090000_init_v2_schema/。B 端仅创建临时库和临时用户，已删除 lisglosips_s08_verify_*、s08v_*、/tmp/lisglosips-s08-*.sh 和临时 dump 文件。
未解决问题：生产/准生产迁移仍需在正式发布窗口前做全量备份和恢复演练；本次只验证临时空库初始化、seed 幂等和 dump/restore。
下一任务：S09 - 登录认证基础

2026-06-21 08:55 - S07 V2 后端 Monorepo 骨架完成

状态：已完成
操作服务器：本地、B
完成内容：恢复 B 开机后完成 S07 的 B 端构建验收；补充 scripts/pnpm-run.mjs，让根脚本复用当前 pnpm 运行器，兼容本机 Corepack 调用和 B 上已安装的 /usr/bin/pnpm；在 package.json 中声明允许固定依赖的 pnpm build scripts，并加入 Linux x64 glibc optional dependency 支持，便于 B 端验证 Rollup/esbuild/Prisma。
修改文件：package.json、pnpm-lock.yaml、scripts/pnpm-run.mjs、IMPLEMENTATION_STATUS.md
安装软件及固定版本：未在 B 安装新系统软件；B 使用既有 Node.js v22.22.2、Corepack 0.34.6、pnpm 10.33.0。本地和 B 的项目依赖仍按 pnpm-lock.yaml 固定。
执行的关键命令：本地 corepack pnpm@10.33.0 lint/typecheck/test/prisma:validate/build；B /tmp/lisglosips-s07-20260621081708 中执行 pnpm install --frozen-lockfile、离线 store 安装、pnpm lint、pnpm typecheck、pnpm test、pnpm prisma:validate、pnpm build、临时 API node apps/api/dist/main.js 健康检查。
验证结果：本地 lint、typecheck、Vitest 2 个测试文件 3 条测试、Prisma schema validate、workspace build 全部通过；B 端 lint、typecheck、Vitest 2 个测试文件 3 条测试、Prisma schema validate、workspace build 全部通过；B 本机临时 API /api/v2/health/live 返回 ok、/api/v2/health/ready 返回 ok、/api/v2/openapi.json 返回 HTTP 200。
回滚方式：恢复本次新增/修改的 monorepo 文件；如需恢复旧前端结构，将 apps/web/src 移回根目录 src、apps/web/index.html 移回根目录，并恢复旧 package.json/package-lock.json。B 端仅使用 /tmp 临时目录和临时 pnpm store，已删除 /tmp/lisglosips-s07-*、/tmp/lisglosips-s07-src-*.zip、/tmp/lisglosips-s07-pnpm-store-v10.tar.gz、/tmp/rollup-linux-x64-gnu-4.62.2.tgz 及 API 冒烟临时文件。
未解决问题：B 到 npm registry 的 TLS 连接不稳定，在线安装多次 ECONNRESET；本次通过本地 pnpm store 临时上传完成 B 端构建验收。后续正式部署建议使用内网 npm 缓存、制品仓库或在 CI 产出完整 release artifact。
下一任务：S08 - 数据库 Schema 与迁移

2026-06-21 08:10 - S07 V2 后端 Monorepo 骨架

状态：已阻塞
操作服务器：本地；Server B 仅尝试临时源码包上传和只读 SSH 连通性检查，未确认远端执行
完成内容：将现有 React Demo 纳入 pnpm monorepo 的 apps/web；创建 apps/api NestJS + Fastify 后端骨架；创建 apps/worker-cdr、apps/worker-recording、apps/worker-config-publisher worker 入口；创建 packages/contracts、domain、database、redis、auth、observability 公共包；建立 Prisma MySQL schema 占位、结构化日志脱敏、配置校验、OpenAPI JSON/Swagger 入口、健康检查、Vitest/Supertest 测试和 lint/typecheck/build/ci 命令。
修改文件：package.json、pnpm-workspace.yaml、pnpm-lock.yaml、tsconfig.base.json、tsconfig.build.json、eslint.config.mjs、vitest.config.ts、.env.example、.gitignore、apps/、packages/、prisma/schema.prisma；原 src/ 和 index.html 已移动到 apps/web/。
安装软件及固定版本：本地通过 Corepack 使用 pnpm 10.33.0；关键依赖固定包括 NestJS 11.1.9、Fastify 5.6.2、Prisma 6.19.0、ioredis 5.8.2、pino 9.14.0、Vitest 4.0.14、TypeScript 5.9.3、Vite 5.4.21。
执行的关键命令：corepack pnpm@10.33.0 install、corepack pnpm@10.33.0 prisma:generate、corepack pnpm@10.33.0 lint、corepack pnpm@10.33.0 typecheck、corepack pnpm@10.33.0 test、corepack pnpm@10.33.0 prisma:validate、corepack pnpm@10.33.0 build、本地 API node apps/api/dist/main.js 冒烟检查。
验证结果：本地 lint 通过；typecheck 通过；Vitest 2 个测试文件 3 条测试通过；Prisma schema validate 通过；全 workspace build 通过；本地 API 冒烟 /api/v2/health/live 返回 ok、/api/v2/health/ready 返回 ok、/api/v2/openapi.json 返回 HTTP 200；测试和脚本只使用无密码占位连接串。
回滚方式：恢复本次新增/修改的 monorepo 文件；如需恢复旧前端结构，将 apps/web/src 移回根目录 src、apps/web/index.html 移回根目录，并恢复旧 package.json/package-lock.json。
未解决问题：未完成 B 端构建验收。本机到 100.90.90.91:22 SSH 超时；本机无 tailscale CLI；scp 曾尝试上传 /tmp/lisglosips-s07-src-20260621080628.zip，返回码为 0 但随后提示连接关闭，因 SSH 不通无法确认远端是否存在该临时文件，恢复连通后应检查并删除。
下一任务：恢复 Server B SSH/Tailscale 可达性后继续完成 S07 - V2 后端 Monorepo 骨架 的 B 端构建验收；不要进入 S08。

2026-06-21 00:20 - SSH 策略文档修订

状态：已完成
操作服务器：本地
完成内容：将 SSH 加固原则调整为“只调整 SSH 管理端口和允许来源，不禁止 SSH 密钥登录”；端口号统一使用 <SSH_ADMIN_PORT> 占位，待用户确认具体端口后再实施。
修改文件：SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md、docs/SSH_ACCESS_RUNBOOK.md、docs/LISGLOSIPS_DEPLOYMENT_GUIDE.md、docs/infra-check.md、docs/SERVER_B_BASELINE_RUNBOOK.md
安装软件及固定版本：无。
执行的关键命令：rg 文档复查。
验证结果：需求/部署文档中已无“仅 Key 登录”“禁用密码登录”作为强制策略的表述；历史盘点文件保留当时实际 TCP 22 快照，docs/infra-check.md 中历史验收项已标注后续迁移为 <SSH_ADMIN_PORT>。
回滚方式：恢复上述文档至本次修改前版本。
未解决问题：尚未确认 <SSH_ADMIN_PORT> 的具体端口号，未执行服务器侧 SSH 端口迁移。
下一任务：S07 - V2 后端 Monorepo 骨架

2026-06-20 23:20 - S06 Server B HOMER 与基础监控

状态：已完成
操作服务器：A、B、T、本地
完成内容：在 B 部署 PostgreSQL 16 HOMER 数据库、Heplify HEP 接收、Homer App、Prometheus、Grafana、MySQL/PostgreSQL/Redis/Node/Heplify exporters 和 Nginx 监控入口；在 A 部署 Node Exporter，并用独立 nftables 表限制仅 B 可抓取；重新签发开发证书，增加 grafana.lisglosips.local 与 homer.lisglosips.local；补充 S06 Runbook 和可重复部署脚本。
修改文件：B 的 /etc/homer/、/etc/lisglosips/secrets/、/etc/prometheus/、/etc/grafana/、/etc/nginx/sites-available/monitoring.conf、/etc/systemd/system/ S06 服务、/data/homer/postgresql；A 的 /etc/nftables.d/lisglosips-s06-exporter.nft、/etc/systemd/system/lisglosips-exporter-firewall.service、/etc/systemd/system/lisglosips-node-exporter.service；本地 infra/server-b/s06/、infra/server-a/s06/、docs/SERVER_B_HOMER_MONITORING_RUNBOOK.md、docs/LISGLOSIPS_DEPLOYMENT_GUIDE.md、.codex-private/SERVICE_CREDENTIALS.clixml。
安装软件及固定版本：PostgreSQL 16.14、Prometheus 2.45.3、Grafana 13.0.2、Node Exporter 1.7.0、MySQL Exporter 0.15.0、PostgreSQL Exporter 0.15.0、Redis Exporter 1.86.0；Heplify Server v1.60.2-0.20260512101233-c74dc3d216ac；Homer App v0.0.0-20251021161517-9b1336352aa0；Docker 29.1.3 与 Compose 2.40.3 已安装但禁用，不作为 S06 运行时。
执行的关键命令：apt-get install、Go install/build、psql、mysql、redis-cli、promtool check config/rules、nginx -t、systemctl daemon-reload/enable/restart/reboot、curl、nft -c/-f、HEPv3 UDP 测试脚本。
验证结果：B 重启后系统 running 且 0 failed unit；A 重启后系统 running 且 0 failed unit；B 的 PostgreSQL、MySQL、Redis、Nginx、Heplify、Homer、Grafana、Prometheus 和 4 个 exporter 全部 active；Prometheus 7 个 target 全部 up；A Node Exporter 仅监听 100.90.90.90:9100，B 抓取返回 200，T 访问超时；HEPv3 INVITE 从 A 发往 B 后写入 homer_data.hep_proto_1_call，方法和源/目标 IP 正确；Grafana HTTPS health 通过，已加载 Prometheus、HOMER PostgreSQL datasource 和 LisgloSIPS Infrastructure Overview dashboard；Homer HTTPS 返回 200；Homer/Grafana/MySQL Exporter 近 10 分钟无错误日志。
回滚方式：B 备份位于 /var/backups/lisglosips-s06/20260620T132440Z，A 备份位于 /var/backups/lisglosips-s06/20260620225517；停止 S06 服务、恢复配置、保留并单独备份 /data/homer/postgresql 后再处理数据目录；A 回滚只删除 inet lisglosips_s06 表和两个 S06 服务，不触碰 OpenSIPS/RTP。
未解决问题：外部对象存储下载被代理链路阻断，未继续采用 HOMER10 Docker 架构；当前 HOMER Web 是最小状态页，HOMER API、HEP 入库和 Grafana 可用，完整 HOMER UI 静态包待网络条件稳定后补；A 的 9100 保护只是 S06 局部规则，完整 A 防火墙留到 S18/S20。
下一任务：S07 - V2 后端 Monorepo 骨架

2026-06-20 20:44 - S05 Server B Node.js、Nginx 与 TLS 基线

状态：已完成
操作服务器：B、T、本地
完成内容：固定 Node.js 22 LTS、Corepack、pnpm 和 Nginx 版本；建立 /opt/lisglosips/releases 与原子 current 发布模型；部署受限 lisglosips@.service 模板和无依赖 API 健康占位服务；配置 Nginx 静态站点、API 代理、登录/API 限流、安全响应头、内部录音 Range 入口；签发仅供开发使用的私有 CA 证书；另建全项目独立部署指南。
修改文件：B 的 /etc/lisglosips/web-runtime-versions.env、/etc/lisglosips/api.env、/etc/lisglosips/pki/、/etc/nginx/ LisgloSIPS 配置、/etc/systemd/system/lisglosips@.service、/usr/local/sbin/lisglosips-issue-dev-cert 和 /opt/lisglosips/releases/s05-placeholder-20260620；本地 infra/server-b/s05/、docs/SERVER_B_WEB_RUNTIME_RUNBOOK.md、docs/LISGLOSIPS_DEPLOYMENT_GUIDE.md、.codex-private/tls/lisglosips-dev-ca.crt。
安装软件及固定版本：Node.js v22.22.2（包 22.22.2-1nodesource1）、Corepack 0.34.6、pnpm 10.33.0、Nginx 1.24.0-2ubuntu7.12；Node/Nginx 包已 hold，升级前必须复核安全公告与兼容性。
执行的关键命令：apt-get install、apt-mark hold、openssl、nginx -t、systemctl daemon-reload/enable/restart/reboot、curl、systemd-analyze security、sha256sum。
验证结果：内部和管理端 HTTPS 健康检查通过；证书链与 100.90.90.91 SAN 校验通过；仅 TLS 1.2/1.3；首页 HSTS/CSP/防嵌套等安全头完整；登录限流测试出现预期 429；/_recordings/ 外部访问为 404；应用只监听 127.0.0.1:3000，本地管理机和 T 均不能直连 3000，T 不能访问 443；systemd 安全评级为 OK；重启后 Nginx、API、MySQL、Redis 和备份 timer 正常，0 个 failed unit；11 个仓库配置与服务器文件哈希一致；文档敏感信息扫描通过。
回滚方式：切换 /opt/lisglosips/current 可回滚应用；S05 变更前备份位于 /var/backups/lisglosips-s05/20260620T123432Z，配置/证书/服务恢复步骤见 docs/SERVER_B_WEB_RUNTIME_RUNBOOK.md。
未解决问题：当前是开发私有 CA，迁移阿里云必须替换正式域名证书；80 已监听但仍由 nftables 拒绝，生产是否开放取决于 ACME 方案；NodeSource 在本地代理链路上偶发 TLS 握手中断，现有固定包和运行不受影响；当前 API 仅为 S05 健康占位服务，S07 替换。
下一任务：S06 - Server B HOMER 与基础监控

2026-06-20 20:22 - S04 Server B MySQL 与 Redis

状态：已完成
操作服务器：B、A、T、本地
完成内容：在 B 安装并固定 MySQL 8.0.46 与 Redis 7.0.15；建立 /data/mysql、/data/redis bind mount；完成 MySQL binlog、UTC、utf8mb4、慢查询和最小权限账号配置；完成 Redis Tailscale 私网绑定、ACL、AOF/RDB 和 noeviction 配置；建立 Tailscale 地址就绪依赖，消除 Redis 开机绑定竞态；配置每日 MySQL/Redis 自动备份及 14 天保留。
修改文件：B 的 /etc/mysql/mysql.conf.d/99-lisglosips.cnf、/etc/redis/redis-lisglosips.conf、/etc/redis/users.acl、/etc/fstab、相关 systemd unit/drop-in、备份脚本及 /etc/lisglosips/secrets/；本地 docs/SERVER_B_DATA_SERVICES_RUNBOOK.md、infra/server-b/s04/、.codex-private/SERVICE_CREDENTIALS.clixml。
安装软件及固定版本：MySQL 8.0.46-0ubuntu0.24.04.2；Redis 5:7.0.15-1ubuntu0.24.04.4；相关 MySQL/Redis 包已 apt-mark hold，升级前须先评估安全公告与兼容性。
执行的关键命令：apt-get install、apt-mark hold、mysql、mysqlcheck、redis-cli、redis-check-rdb、systemctl、findmnt、sha256sum、systemctl reboot。
验证结果：MySQL 仅监听本机，应用账号 DML 通过且 DDL 被拒；Redis 未认证访问被拒，应用账号读写通过且危险命令被拒，A 可通过 Tailscale 认证访问，T 到 3306/6379 被防火墙拒绝；MySQL 与 Redis 备份哈希通过，并分别完成隔离恢复和数据一致性验证；重启后 mount、服务、数据和 timer 均正常，Redis NRestarts=0，0 个 failed unit；11 个仓库配置与服务器文件 SHA-256 完全一致；仓库敏感信息、私密文件忽略规则和 ACL 检查通过。
回滚方式：变更前及迁移前数据保存在 B 的 /var/backups/lisglosips-s04/20260620195847；配置、数据目录和服务恢复步骤见 docs/SERVER_B_DATA_SERVICES_RUNBOOK.md。
未解决问题：开发阶段 /data 仍位于根盘，正式上云需改为独立数据盘；固定版本需要纳入安全补丁复核；Tailscale 首次直连协商偶尔产生短时延迟，稳态访问正常。
下一任务：S05 - Server B Node.js、Nginx 与 TLS 基线

2026-06-20 19:01 - S03 Server B 基础系统初始化

状态：已完成
操作服务器：B、本地
完成内容：升级 101 个系统包并启用 6.17.0-35 内核；安装基础工具；建立 chrony、nftables、fail2ban、sysstat；创建三个 LisgloSIPS 系统用户和 /data 目录基线；修复 NFS 为 Tailscale 就绪后的 automount；完成重启验收。
修改文件：B 的 /etc/fstab、/etc/nftables.conf、/etc/nftables.d/lisglosips.nft、/etc/chrony/chrony.conf、/etc/chrony/sources.d/lisglosips.sources、/etc/fail2ban/jail.d/lisglosips.local、/etc/tmpfiles.d/lisglosips.conf；本地 docs/SERVER_B_BASELINE_RUNBOOK.md、infra/server-b/s03/。
安装软件及固定版本：chrony 4.5-1ubuntu4.2、nftables 1.0.9-1ubuntu0.1、fail2ban 1.0.2-3ubuntu0.1；其余基础工具版本见 Runbook 和远端 post-change 包清单。
执行的关键命令：apt-get dist-upgrade/install、chronyc、nft、fail2ban-client、systemd-tmpfiles、findmnt、systemctl reboot。
验证结果：新内核启动；0 个 failed unit；无待升级包、无 reboot-required；chrony Stratum 3/Leap Normal；NFS automount 重启后可访问；fail2ban sshd jail active；nftables 重启后默认拒绝，开发机与 A 允许路径通过，T 到 B 的 22/443/6379/9060 被拒绝；远端配置与仓库副本哈希一致。
回滚方式：变更前备份 /var/backups/lisglosips-s03/20260620184404；防火墙可执行其中 rollback-firewall.sh；其余恢复方式见 Runbook。
未解决问题：开发阶段 /data 仍位于根盘；桌面/CUPS/Avahi/rpcbind 尚未精简但已被防火墙隔离；ens18 双地址/双默认路由和克隆 machine-id 仍待单独维护窗口处理。
下一任务：S04 - Server B MySQL 与 Redis

2026-06-20 18:37 - S02 网络与安全组验收

状态：已完成
操作服务器：A、B、T、本地
完成内容：确认本地开发服务器和 Tailscale 专网边界；采集六个方向稳态 RTT；验证 SIP、RTP、Web、HEP、Redis、监控与 SSH 网络路径；形成开发最小暴露矩阵和未来阿里云安全组清单。
修改文件：docs/infra-check.md、docs/inventory-A.md、docs/inventory-B.md、docs/inventory-summary.md、SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：无。
执行的关键命令：tailscale status/ping/netcheck、ping、Python 短时 TCP/UDP 监听与 ACK、SIP OPTIONS、ss、OpenSIPS/MariaDB 只读核验。
验证结果：A/B/T 六方向 0% 丢包，预热后平均 RTT 0.434-0.648 ms；1200 字节 DF 报文通过；T->A 15060/UDP 与 RTP 30000/40000 双向通过；A->T SIP 5060 返回合法 484；开发机->B 443、A->B 9060/6379、B->A 9100/22 通过；所有临时监听器均已退出。
回滚方式：未修改远端持久配置；短时监听器已自动退出，无需回滚。
未解决问题：主机防火墙尚未落地；Tailscale direct 路径曾短暂重新协商导致 SSH 超时；ens18 双地址/双默认路由仍存在；T 的权限与 RTPEngine 内核模块问题留待对应任务处理。
测试数据：T 的 sip_trace 新增 1 条 S02 OPTIONS 记录，acc 和 missed_calls 未增加。
下一任务：S03 - Server B 基础系统初始化

2026-06-20 18:00 - S01 三机只读资产盘点

状态：已完成
操作服务器：A、B、T、本地
完成内容：只读采集三机 OS、内核、CPU、内存、磁盘、网络、路由、时间、端口、服务、软件和防火墙；检查 T 的 OpenSIPS、RTPEngine、MariaDB、录音目录、配置结构与运行统计。
修改文件：docs/inventory-A.md、docs/inventory-B.md、docs/inventory-T.md、docs/inventory-summary.md、IMPLEMENTATION_STATUS.md
安装软件及固定版本：无。
执行的关键命令：hostnamectl、lscpu、lsblk、ip、ss、systemctl、ufw status、nft list ruleset、opensips -C、opensips-cli、rtpengine-ctl、MariaDB 只读查询。
验证结果：A/B/T SSH 复验通过；T 的 OpenSIPS、RTPEngine、录音守护进程、MariaDB、Apache 均 active；OpenSIPS 主配置哈希与盘点时一致；报告完整性及敏感信息扫描通过。
回滚方式：S01 未修改远端配置、数据或服务，无需回滚。
未解决问题：三机克隆身份相同；均有双 IPv4/双默认路由；UFW 未启用；B 的 NFS mount 失败；T 的 TLS 私钥为 0644、MI FIFO 为 0666、RTPEngine 无内核模块；当前 T 无注册账号和路由数据。
下一任务：S02 - 网络与安全组验收

2026-06-20 15:08 - S00 SSH 安全接入与凭据迁移

状态：已完成
操作服务器：A、B、T、本地
完成内容：生成项目专用 Ed25519 Key；三机安装公钥；发现并修复克隆服务器共享 SSH host key；轮换 hector 密码；建立严格 known_hosts 和 SSH 别名。后续 SSH 变更按最新要求只调整管理端口，不禁止 SSH 密钥登录。
修改文件：.codex-private/ssh/lisglosips_codex_ed25519、.codex-private/ssh/config、.codex-private/ssh/known_hosts、.codex-private/SERVER_CREDENTIALS.clixml、docs/SSH_ACCESS_RUNBOOK.md
安装软件及固定版本：本地私密目录安装 Paramiko 5.0.0，仅用于首次安全接入自动化。
验证结果：A/B/T 均通过 Key 新会话；sshd -t 通过；SSH 密钥登录保持开启；新 sudo 密码逐台验证通过。
回滚方式：见 docs/SSH_ACCESS_RUNBOOK.md，三台服务器 /var/backups/lisglosips-s00/ 保留轮换前和加固前备份。
未解决问题：尚未盘点三机软件、磁盘、服务和网络；容量参数与 RTP 端口段仍未确认。
下一任务：S01 - 三机只读资产盘点

2026-06-20 - 计划初始化

状态：已完成
操作服务器：本地
完成内容：建立 Codex 原子任务列表、服务器索引和跨会话交接规范。
修改文件：SOFTSWITCH_PLATFORM_DESIGN_V2.md、IMPLEMENTATION_STATUS.md、.gitignore、.codex-private/SERVER_ACCESS.md
验证结果：等待开始 S00。
未解决问题：尚未连接服务器；尚未确认容量参数和 RTP 端口段。
下一任务：S00 - SSH 安全接入与凭据迁移

164 KiB Raw Blame History Unescape Escape

LisgloSIPS V2 实施状态

当前状态

服务器索引

任务状态表

每次新会话的固定开场指令

单任务交接记录模板

交接记录

2026-06-24 11:41 - 需求修改/二期变更：号码库第 6、7 步本地实现

2026-06-24 11:31 - 需求修改/二期变更：号码库第 4、5 步本地实现

2026-06-24 11:15 - 需求修改/二期变更：号码库第 3 步 Web 本地实现

2026-06-24 11:07 - 需求修改/二期变更：号码库第 1、2 步本地实现

2026-06-24 09:48 - 需求修改/二期变更：号码库与屏蔽地区路由需求评估

2026-06-24 09:31 - 需求修改/二期变更：用户与角色删除

2026-06-23 22:07 - 需求修改/二期变更：S30 后需求写入 V2 设计文档

2026-06-23 21:51 - 需求修改/二期变更：10 路虚拟呼叫测试工具与当前通话自动刷新

2026-06-23 18:38 - 需求修改/二期变更：话单详情弹窗布局重排

2026-06-23 18:29 - 需求修改/二期变更：列表列宽优化与隐藏待设计菜单

2026-06-23 17:47 - 需求修改/二期变更：自研确认弹窗与删除按钮警示色

2026-06-23 16:20 - 需求修改/二期变更：充值记录过滤、充值性能与新建链路通话测试

2026-06-23 15:36 - 需求修改/二期变更：列表计数、删除功能和启停确认

2026-06-23 15:12 - 需求修改/二期变更：当前通话增加呼叫方 IP 与落地 IP

2026-06-23 10:15 - 需求修改/二期变更：新增“当前通话”菜单与强制挂断

2026-06-22 14:20 - 需求修改/二期变更：修复登录验证码刷新后不显示

2026-06-22 12:54 - 需求修改/二期变更发布到 B：登录图形验证码与 admin 初始账号

2026-06-22 12:04 - 需求修改/二期变更发布到 B：登录页与登录防爆破

2026-06-22 11:53 - 需求修改/二期变更：登录页与登录防爆破

2026-06-22 10:35 - S30 备份、Runbook、灰度与上线完成

2026-06-22 10:25 - S29 性能、故障与安全测试完成

2026-06-22 09:32 - S28 三机端到端联调完成

2026-06-21 23:06 - S28 三机端到端联调推进

2026-06-21 21:47 - S28 三机端到端联调

2026-06-21 21:32 - S27 React Demo 接入真实 API

2026-06-21 21:20 - S26 Dashboard 聚合

2026-06-21 21:05 - S25 质检后端

2026-06-21 20:20 - S24 录音搬运与播放

2026-06-21 20:02 - B sudo 凭据复验

2026-06-21 19:55 - S23 最小计费与余额扣减

2026-06-21 19:34 - S22 CDR Redis Stream

2026-06-21 15:28 - S21 Server T 客户模拟配置

2026-06-21 15:05 - S20 Server A Redis 热路径与 HEP/指标

2026-06-21 14:00 - S19 Server A RTPEngine 与录音 tmpfs

2026-06-21 13:29 - S18 Server A OpenSIPS 基线

2026-06-21 13:06 - S17 落地线路组 API

2026-06-21 11:57 - S16 落地网关 API

2026-06-21 11:45 - S15 供应商管理 API

2026-06-21 11:39 - S14 客户网关策略与 Redis 配置发布

2026-06-21 11:28 - S13 客户网关 API

2026-06-21 11:14 - S12 充值与不可变余额流水

2026-06-21 10:57 - S11 客户管理 API

2026-06-21 10:46 - S10 用户、角色、权限与审计

2026-06-21 10:15 - S09 登录认证基础

2026-06-21 09:28 - S08 数据库 Schema 与迁移

2026-06-21 08:55 - S07 V2 后端 Monorepo 骨架完成

2026-06-21 08:10 - S07 V2 后端 Monorepo 骨架

2026-06-21 00:20 - SSH 策略文档修订

2026-06-20 23:20 - S06 Server B HOMER 与基础监控

2026-06-20 20:44 - S05 Server B Node.js、Nginx 与 TLS 基线

2026-06-20 20:22 - S04 Server B MySQL 与 Redis

2026-06-20 19:01 - S03 Server B 基础系统初始化

2026-06-20 18:37 - S02 网络与安全组验收

2026-06-20 18:00 - S01 三机只读资产盘点

2026-06-20 15:08 - S00 SSH 安全接入与凭据迁移

2026-06-20 - 计划初始化

164 KiB

Raw Blame History