# iotlcm-onelink-mock

OneLink 挡板服务 —— 基于《中移物联网物联卡能力开放调用参考文档 V26.01.1》实现的本地测试替身。

用于在没有真实运营商环境时，模拟中国移动 OneLink 的鉴权与卡查询接口，支撑联调、自测与 CI。

## 功能

- Go 后端，兼容 `/v5/ec/...` 和 `/ec/...` 两种路径。
- Vue3 管理台，管理多个 `appid/password`、SIM 卡基础信息、状态和固定流量参数。
- Token 有效期 3600 秒，支持 `refresh=0/1`。
- 不再连接 MySQL，也不再查询 `t_sim_card_info`。
- SIM 卡数据由后端一键生成，持久化到本地 SQLite 表 `mock_t_sim_card`。
- 月流量固定为 `18432 KB`，不再按时间自动增长。
- 支持按入库模板导出 Excel。

## 数据源

服务使用 SQLite 数据库作为唯一持久化数据源。默认数据库路径：

```text
data/onelink_mock.db
```

可以通过环境变量覆盖：

```text
BAFFLE_SQLITE_PATH=C:\sqlite\onelink_mock.db
```

后端通过 GoFrame SQLite 驱动直接访问数据库，不依赖本机安装 `sqlite3` 命令行工具。

Docker 镜像内会安装 `sqlite` 命令行工具。

## 一键生成

管理台顶部可输入生成数量，点击“一键生成”后追加新卡数据。

生成逻辑：

- 不删除旧卡。
- 不查询旧卡做重复对比。
- ICCID/MSISDN/IMSI/IMEI 与生成时间戳和序号相关，降低重复概率。
- 删除卡只在管理台删卡或业务删除逻辑触发时发生。

固定生成值：

```text
chanKey=channel_yd_mock
cardType=1
upPkgCode=CMIOT-SD-500M-24M-D01
suppliersCode=SUP_CMCC
insertToPlugEnabled=true
carrierTrafficCutoffEnabled=false
hasTestPeriod=true
testPeriodDays=30
hasSilentPeriod=false
silentPeriodDays=
silentPeriodLatestExpiryDate=
```

流量固定值：

```text
current_month_usage_kb=18432
monthly_usage_kb=18432
daily_usage_kb=614.4
pool_usage_bytes=18874368
growth_per_minute_kb=0
auto_growth_enabled=false
```

## Excel 导出

管理台点击“导出 Excel”会下载当前卡数据，表头顺序为：

```text
ICCID
MSISDN
IMSI
IMEI
通道编号
卡类型
上游套餐编码
供应商编码
上游激活时间
是否贴片转插拔
是否运营商达量断网
协议到期时间
是否有测试期
测试期天数
测试期最晚过期日期
是否有沉默期
沉默期天数
沉默期最晚过期日期
```

其中：

- `协议到期时间` 为激活日期后 1 年。
- `测试期最晚过期日期` 为激活日期后 30 天。
- `是否有沉默期=false` 时，沉默期天数和截止日期导出为空。

## 已实现接口

- `ec/get/token`
- `ec/query/sim-basic-info`
- `ec/query/sim-session`
- `ec/query/sim-status`
- `ec/query/sim-stop-reason`
- `ec/query/sim-frozen-state-info`
- `ec/query/sim-apn-session-info`
- `ec/query/sim-activated-features-info`
- `ec/query/sim-operating-status`
- `ec/query/sim-data-diagnosis`
- `ec/query/sim-imei`
- `ec/query/sim-data-usage-inpool`
- `ec/query/sim-data-usage`
- `ec/query/sim-data-usage-monthly/batch`
- `ec/query/sim-data-usage-daily/batch`
- `ec/query/apn-info`
- `ec/query/card-bind-status`
- `ec/query/on-off-status`
- `ec/query/region-limit-status`
- `ec/change/sim-status`
- `ec/operate/sim-apn-function`

Chan-compatible unified APIs (GET and POST):
- `GET|POST /sim/query/sim-basic-info`
- `GET|POST /sim/query/sim-session`
- `GET|POST /sim/query/sim-status`
- `GET|POST /sim/query/sim-status-batch`
- `GET|POST /sim/query/sim-card-bind-status`
- `GET|POST /sim/query/sim-device-status`
- `GET|POST /sim/query/sim-region-limit-status`
- `GET|POST /sim/query/sim-imei`
- `GET|POST /sim/query/sim-datausage`
- `GET|POST /sim/query/sim-datausage-monthly`
- `GET|POST /sim/query/sim-datausage-monthly-batch`
- `GET|POST /sim/query/sim-datausage-daily`
- `GET|POST /sim/query/sim-datausage-daily-batch`
- `GET|POST /sim/query/sim-apn-info`
- `GET|POST /sim/change/sim-status`
- `GET|POST /sim/change/sim-apn`

Chan requests use `simKeys` and `reqData`; responses are per-SIM arrays with
`code`, `message`, `simKey`, and `resData`. The chan endpoints reuse the same
SQLite SIM cards as the OneLink endpoints.

管理接口：

- `GET /api/state`
- `POST /api/generate`
- `GET /api/cards/export`
- `POST /api/appids`
- `POST /api/cards`
- `DELETE /api/cards`

## 环境变量

| 变量 | 必填 | 说明 |
| --- | --- | --- |
| `BAFFLE_ADDR` | 否 | 监听地址，默认 `:8080` |
| `BAFFLE_SQLITE_PATH` | 否 | SQLite 数据库路径，默认 `data/onelink_mock.db` |

## 本地启动

### 1. 启动后端

PowerShell：

```powershell
$env:BAFFLE_ADDR=":8080"
$env:BAFFLE_SQLITE_PATH="C:\sqlite\onelink_mock.db"
go run .
```

后端默认监听：

```text
http://127.0.0.1:8080
```

### 2. 启动前端

```powershell
cd frontend
pnpm install --frozen-lockfile
pnpm run dev
```

前端 dev server 默认监听：

```text
http://127.0.0.1:5173/
```

## Docker 启动

```powershell
docker compose up -d --build
```

访问地址：

```text
http://127.0.0.1:18080/onelink-mock/
```

停止：

```powershell
docker compose down
```

## 默认测试认证

```text
appid=demo_appid
password=demo_password
```

获取 Token：

```text
http://localhost:8080/v5/ec/get/token?appid=demo_appid&password=demo_password&transid=demo_appid2026070209300000000001
```

## Admin query APIs

```text
GET /api/cards?keyword=<msisdn-or-iccid-or-imsi>&page=1&pageSize=20
GET /api/orders?page=1&pageSize=20
```

Orders are persisted in the SQLite `mock_order` table and retain all nine fields after a service restart. Existing `mock_t_sim_card` data is preserved.

## 部署

本地开发用 `docker compose up -d --build` 即可（见上文「Docker 启动」）。若需要通过 Nginx 以子路径方式挂到已有站点，参考 [`docs/deploy.md`](./docs/deploy.md)。

## 相关项目

本服务是 [iotlcm](https://git.5iot.com/iotlcm-public) 物联网卡全生命周期管理平台的一部分，用于在没有真实运营商通道时提供可预期的上游替身。

## License

[Apache License 2.0](./LICENSE)