## ADDED Requirements ### Requirement: 网关只读资产表 系统 SHALL 提供网关只读资产表,每行保存一个网关请求卡号(卡为 ICCID,设备为 IMEI,统一大写)及其类型、来源、备注与写入时间,卡号唯一。表中的资产即"只读资产"。系统 MUST NOT 在迁移中写入只读资产数据;数据只由测试环境的导入脚本写入。 #### Scenario: 同一卡号重复写入 - **WHEN** 导入脚本对已存在的卡号再次写入 - **THEN** 只读表中该卡号仍只有一行 #### Scenario: 卡号大小写 - **WHEN** 网关请求卡号为小写,表中保存的是大写 - **THEN** 系统视为同一只读资产 ### Requirement: 只读模式开关 系统 SHALL 通过环境变量 `JUNHONG_GATEWAY_READONLY_ENABLED` 控制只读模式:为 `true` 时按只读表限制网关调用;未配置或为 `false` 时 MUST NOT 查询只读表,所有网关调用行为与本变更前一致。系统 MUST NOT 再读取 `JUNHONG_GATEWAY_READONLY_ICCIDS`。API 与全部 Worker 进程 MUST 使用一致的取值。 #### Scenario: 生产未配置 - **WHEN** 环境未配置 `JUNHONG_GATEWAY_READONLY_ENABLED` - **THEN** 网关调用不查只读表,停机、复机等照常发出 #### Scenario: 旧名单变量不再生效 - **WHEN** 环境只配置了 `JUNHONG_GATEWAY_READONLY_ICCIDS`,未开启只读模式 - **THEN** 系统不按该名单拦截任何调用 ### Requirement: 只读资产只允许查询类调用 只读模式开启时,对只读资产系统 SHALL 只允许查询类网关调用:查卡状态(`/flow-card/status`)、查实名(`/flow-card/realName`)、查流量(`/flow-card/flow`)、查设备信息(`/device/info`)、查设备槽位(`/device/slot-info`)、同步设备状态(`/device/sync-info`),这些调用 MUST NOT 查只读表。其余网关调用(包括停机、复机、限速、实名认证链接,以及设备切卡、恢复出厂、重启、WiFi 配置、模式切换)在请求卡号命中只读表时,系统 MUST 在本地拦截、MUST NOT 向网关发送请求,并返回明确失败(不是结果未知),同时记录拦截日志。拦截 MUST 在网关客户端统一出口实现,覆盖自动停复机、人工停复机、套餐激活与到期、订单、退款、通道阈值、限速与设备操作等全部入口;业务流程 MUST NOT 为此改变。被拦截的停复机按现有失败处理记录与重试,本地卡状态不改变。 #### Scenario: 只读卡触发自动停机 - **WHEN** 只读卡在测试环境因无套餐或流量用完触发自动停机 - **THEN** 系统不向网关发送停机请求,记录停机失败与拦截日志,卡的本地网络状态不变 #### Scenario: 只读卡查流量 - **WHEN** 轮询对只读卡查询流量 - **THEN** 请求照常发往网关,不查只读表 #### Scenario: 只读设备重启 - **WHEN** 管理员对只读设备执行重启 - **THEN** 系统不向网关发送请求并返回失败 #### Scenario: 只读设备查实时状态 - **WHEN** 后台查看只读设备详情,读取设备信息与同步状态 - **THEN** 请求照常发往网关,不查只读表 #### Scenario: 非只读卡停机 - **WHEN** 只读模式开启,对不在只读表中的卡发起停机 - **THEN** 请求照常发往网关 ### Requirement: 查表失败按拦截处理 只读模式开启时,非查询类网关调用在查询只读表失败(包括超时、连接错误与表不存在)时,系统 MUST 按拦截处理:不发送请求、返回明确失败并记录日志。系统 MUST NOT 缓存只读表;只读表写入后,下一次调用即按新数据判断。 #### Scenario: 只读表查询超时 - **WHEN** 只读模式开启,停机前查询只读表超时 - **THEN** 系统不发送停机请求并返回失败 #### Scenario: 新写入的只读卡立即生效 - **WHEN** 只读表刚写入某卡号,随即对该卡发起复机 - **THEN** 系统拦截该复机请求