Files
junhong_cmp_fiber/docs/测试环境生产卡只读模式清理顺序.md
邹进 5cf67b98de
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m36s
feat: 网关只读资产改为数据表,只读资产只允许查询类调用
- 新增 tb_gateway_readonly_card(卡 ICCID / 设备 IMEI)与开关 JUNHONG_GATEWAY_READONLY_ENABLED,
  替换环境变量名单 JUNHONG_GATEWAY_READONLY_ICCIDS
- 只读资产只放行查卡状态、查实名、查流量、查设备信息、查设备槽位、同步设备状态;
  停机、复机、限速、实名认证链接与设备写操作在网关出口本地拦截;查表失败按拦截;不缓存
- 测试环境部署开启只读模式;新增技术方案与清理顺序文档

Change: add-gateway-readonly-prod-import

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 17:55:52 +09:00

2.5 KiB
Raw Blame History

测试环境生产卡只读模式清理顺序

项目 内容
日期 2026-10-29
范围 测试环境
对应机制 网关只读卡表 tb_gateway_readonly_card + 环境变量 JUNHONG_GATEWAY_READONLY_ENABLED

背景

为验证卡流量采集与扣减,把生产上"卡住"的卡导入测试环境。这些是真实用户的卡,测试环境只能查询,不能停复机。

  • 只读卡表 tb_gateway_readonly_card:存放导入卡的 ICCID 与导入设备的 IMEI(identifier 唯一索引)。
  • 环境变量 JUNHONG_GATEWAY_READONLY_ENABLED=true 时,网关每次写操作(停机、复机、限速、实名认证、设备指令)前按请求卡号查表:在表里就本地拦截、不发请求;查流量、卡状态、实名这三类查询不查表、直接放行。
  • 查表失败按拦截处理(宁可停复机失败,不放过真卡)。
  • 生产不配置该环境变量,代码不查表。

清理顺序(必须按顺序执行)

1. 先处理测试环境里的生产卡(保护仍在,安全)

  • 把表里这些卡在测试环境的 enable_polling 设为 false,或删除卡及其测试套餐、采集记录、日快照。
  • 确认这些卡已不在轮询队列中,也没有待执行的停复机指令。

顺序错误的后果:保护撤掉后这些卡仍在测试环境,一旦触发无套餐、套餐用完、套餐到期等停复机,会真实停掉用户的卡。

2. 关闭开关并重新部署

  • 部署脚本去掉 JUNHONG_GATEWAY_READONLY_ENABLED(或设为 false),重新部署 API 与 Worker。
  • 以 Gitea Actions 部署成功为准确认生效(不要用数据库连接建立时间判断,连接池每 5 分钟会重建连接)。

顺序错误的后果:开关开着就删表,查表报"表不存在"按失败处理,测试环境所有卡的写操作都会被拦截,直到关闭开关。

3. 删表

  • 新建一对迁移:up 执行 DROP TABLE tb_gateway_readonly_card,down 重建该表。
  • 不修改原建表迁移。

4. 清理代码(可选)

  • 删除写操作前的查表逻辑与开关配置。开关关闭时这段代码不生效,不删也不影响。

其他说明

  • 生产:不配置开关,不查表。若该版本发布到生产,建表迁移会建出空表,不影响功能,后续删表迁移随之执行即可。
  • 数据量:几万行(ICCID + 备注),删表瞬间完成,无锁表风险。
  • 留痕:拦截记录在日志、停复机记录与审计中,与该表无关,删表不影响已有记录。