首页 / Java 平台（cloud-java） / sim SIM 卡
sim SIM 卡
eSIM profile、供应商同步、绑定回调、批任务、用量与告警。
外部供应商边界：本页描述平台内 SIM 领域职责；EIOTCLUB 等供应商的卡、套餐、IMEI 池、回调、CDR 和批量任务接入规则见SIM/eSIM 供应商接入契约。供应商 API 文档索引不能替代版本化字段契约与对账验证。
职责概览
SIM 模块 独立端口 48099，管理 eSIM/SIM 卡全生命周期：profile 档案、供应商与供应商订单、IMEI 池、绑定、回调、同步、批任务、用量（CDR）、订阅关联、告警策略与生命周期事件。
接口清单
| 分组 | Controller | 说明 |
|---|---|---|
| Profile | SimProfileController | SIM profile 档案管理 |
| 供应商 | SimProviderController、SimProviderOrderController、SimSyncController | 供应商、采购订单与数据同步 |
| 绑定 | SimBindingController、SimBindingReconcileController | 卡绑定设备与绑定对账 |
| 回调 | SimCallbackAdminController | 供应商回调处理（幂等） |
| 用量 | SimCdrController、SimDashboardController | CDR 用量与看板 |
| 告警 | SimAlertController、SimAlertPolicyController | SIM 告警与告警策略（阈值、升级） |
| 生命周期 | SimLifecycleEventController | 状态流转事件 |
| 批任务 | SimBatchTaskController | 批量操作任务（同步/绑定/激活） |
| 其他 | SimEuiccController、SimImeiPoolController、SimSubscriptionController、SimRuleConfigController、SimNotifyLogController、SimOperationController | eUICC、IMEI 池、订阅、规则、通知日志、运营 |
关键实现
- 供应商同步：
SimProviderSyncJob（@XxlJob）拉取供应商状态 →SimSyncController手动触发 - 回调处理：
SimCallbackProcessJob消费回调并幂等去重；失败进重试 - 批任务：
SimBatchTask承载批量操作，支持进度与重试 - 用量快照：CDR 消费生成用量快照，供告警与订阅关联
- 告警升级：
SimAlertPolicy定义阈值与升级动作，SimAlert落告警记录
供应商回调必须幂等：同一回调重复到达不得重复变更业务状态；回调验签失败只记录并告警，不直接修改业务行。
数据与维护注意
核心表：sim_*（31 张），覆盖 profile、供应商、订单、绑定、回调、CDR、告警、批任务、订阅与生命周期事件。
- SIM 状态以供应商同步结果 + 本地流转为准，两侧不一致时以对账任务修复。
- 卡密/ICCID/IMSI 等标识属敏感数据，日志脱敏。