chore: 初始开源发布

iotlcm-openapi:对外 OpenAPI 网关(V3 接口 + 旧版兼容接口)。

- Go module:iotlcm-openapi → git.5iot.com/iotlcm-public/iotlcm-openapi(178 文件)
- 凭据与地址脱敏:JWT signingKey、MySQL DSN、Redis 口令、
  RabbitMQ DSN 全部改为 ${*} 占位;私网 IP → 文档地址段
- 7 处真实手机号 → 合法 11 位编造号
- 启动 banner 统一 IOTLCM 方块字 + 社区惯例署名
- 移除内部资产:CI 触发器
- Dockerfile 改用公共基础镜像,移除 GOPRIVATE 内网设置
- README 重写(原为 GoFrame 模板占位文案),补 Apache-2.0 LICENSE,
  LF 行尾 + .gitattributes
This commit is contained in:
MiFaZhan
2026-10-23 14:15:47 +08:00
commit 88dfe5c640
482 changed files with 34475 additions and 0 deletions
+11
View File
@@ -0,0 +1,11 @@
package common
import (
"git.5iot.com/iotlcm-public/iotlcm-openapi/api/common"
)
type ControllerV1 struct{}
func NewV1() common.ICommonV1 {
return &ControllerV1{}
}
+114
View File
@@ -0,0 +1,114 @@
package common
import (
"context"
"github.com/gogf/gf/v2/errors/gerror"
"github.com/gogf/gf/v2/frame/g"
v1 "git.5iot.com/iotlcm-public/iotlcm-openapi/api/common/v1"
"git.5iot.com/iotlcm-public/iotlcm-openapi/internal/model"
"git.5iot.com/iotlcm-public/iotlcm-openapi/internal/service"
)
func (c *ControllerV1) Renew(ctx context.Context, req *v1.RenewReq) (res *v1.RenewRes, err error) {
output, err := service.Common().SubmitRenew(ctx, &req.CommonRenewParam)
if err != nil {
return nil, err
}
return &v1.RenewRes{CommonRenewRes: *output}, nil
}
func (c *ControllerV1) TrafficCutoffConfig(ctx context.Context, req *v1.TrafficCutoffConfigReq) (res *v1.TrafficCutoffConfigRes, err error) {
if req == nil {
return nil, gerror.New("请求参数不能为空")
}
req.CommonTrafficCutoffConfigParam.IdempotencyKey = g.RequestFromCtx(ctx).Header.Get("Idempotency-Key")
output, err := service.Common().SubmitTrafficCutoffConfig(ctx, &req.CommonTrafficCutoffConfigParam)
if err != nil {
return nil, err
}
return &v1.TrafficCutoffConfigRes{CommonTrafficCutoffConfigRes: *output}, nil
}
func (c *ControllerV1) SimSubscribe(ctx context.Context, req *v1.SimSubscribeReq) (res *v1.SingleRenewRes, err error) {
if req == nil {
return nil, gerror.New("请求参数不能为空")
}
output, err := service.Common().SubmitSingleRenew(ctx, model.CommonRenewCard{
Iccid: req.Iccid,
Msisdn: req.Msisdn,
Imsi: req.Imsi,
PackageId: req.PackageId,
}, req.AppId, req.PackageId, req.Remark, req.Validity)
if err != nil {
return &v1.SingleRenewRes{CommonSingleRenewRes: model.CommonSingleRenewRes{
OrderId: "0",
OrderSn: "",
Iccid: req.Iccid,
Status: "failed",
ErrorCode: "RENEW_FAILED",
ErrorMessage: err.Error(),
}}, nil
}
return &v1.SingleRenewRes{CommonSingleRenewRes: *output}, nil
}
func (c *ControllerV1) BatchSimSubscribe(ctx context.Context, req *v1.BatchSimSubscribeReq) (res *v1.RenewRes, err error) {
if req == nil {
return nil, gerror.New("请求参数不能为空")
}
output, err := service.Common().SubmitBatchRenew(ctx, req.AppId, req.Cards, req.Iccid, req.PackageId, req.Remark, req.Validity)
if err != nil {
return nil, err
}
return &v1.RenewRes{CommonRenewRes: *output}, nil
}
func (c *ControllerV1) SimTrafficCutoff(ctx context.Context, req *v1.SimTrafficCutoffReq) (res *v1.SingleTrafficCutoffRes, err error) {
if req == nil {
return nil, gerror.New("请求参数不能为空")
}
output, err := service.Common().SubmitSingleTrafficCutoffConfig(ctx, &req.CommonTrafficCutoffSingleParam)
if err != nil {
threshold := req.TrafficCutoffThreshold
if req.TrafficCutoffStatus == 0 {
threshold = 0
}
return &v1.SingleTrafficCutoffRes{CommonSingleTrafficCutoffRes: model.CommonSingleTrafficCutoffRes{
Success: false,
Iccid: req.Iccid,
Msisdn: req.Msisdn,
Imsi: req.Imsi,
TrafficCutoffStatus: req.TrafficCutoffStatus,
TrafficCutoffThreshold: threshold,
TrafficCutoffThresholdUnit: "MB",
Message: err.Error(),
ErrorCode: "TRAFFIC_CUTOFF_FAILED",
}}, nil
}
return &v1.SingleTrafficCutoffRes{CommonSingleTrafficCutoffRes: *output}, nil
}
func (c *ControllerV1) BatchSimTrafficCutoff(ctx context.Context, req *v1.BatchSimTrafficCutoffReq) (res *v1.TrafficCutoffConfigRes, err error) {
if req == nil {
return nil, gerror.New("请求参数不能为空")
}
req.CommonTrafficCutoffConfigParam.IdempotencyKey = g.RequestFromCtx(ctx).Header.Get("Idempotency-Key")
output, err := service.Common().SubmitTrafficCutoffConfig(ctx, &req.CommonTrafficCutoffConfigParam)
if err != nil {
return nil, err
}
return &v1.TrafficCutoffConfigRes{CommonTrafficCutoffConfigRes: *output}, nil
}
func trafficCutoffStatusName(status int) string {
switch status {
case 1:
return "已开启"
case 2:
return "已关闭"
default:
return "删除"
}
}
+5
View File
@@ -0,0 +1,5 @@
// =================================================================================
// This is auto-generated by GoFrame CLI tool only once. Fill this file as you wish.
// =================================================================================
package old_api
@@ -0,0 +1,13 @@
// =================================================================================
// This is auto-generated by GoFrame CLI tool only once. Fill this file as you wish.
// =================================================================================
package old_api
import "git.5iot.com/iotlcm-public/iotlcm-openapi/api/old_api"
type ControllerV1 struct{}
func NewV1() old_api.IOldApiV1 {
return &ControllerV1{}
}
+69
View File
@@ -0,0 +1,69 @@
package old_api
import (
"context"
v1 "git.5iot.com/iotlcm-public/iotlcm-openapi/api/old_api/v1"
"git.5iot.com/iotlcm-public/iotlcm-openapi/internal/service"
)
func (c *ControllerV1) CardInfo(ctx context.Context, req *v1.CardInfoReq) (res *v1.CardInfoRes, err error) {
simCardInfoOutput, err := service.OldApiQuery().QuerySimCard(ctx, &req.SimCardInfoInput)
if err != nil {
return nil, err
}
res = &v1.CardInfoRes{SimCardInfoOutput: *simCardInfoOutput}
return res, nil
}
func (c *ControllerV1) SimDataUsage(ctx context.Context, req *v1.SimDataUsageReq) (res *v1.SimDataUsageRes, err error) {
simDataUsageOutput, err := service.OldApiQuery().QuerySimDataUsage(ctx, &req.SimDataUsageOldInput)
if err != nil {
return nil, err
}
res = &v1.SimDataUsageRes{
SimDataUsageOldOutput: *simDataUsageOutput,
}
return res, nil
}
func (c *ControllerV1) SimDataUsageMonthly(ctx context.Context, req *v1.SimDataUsageMonthlyReq) (res *v1.SimDataUsageMonthlyRes, err error) {
simDataUsageMonthlyOutput, err := service.OldApiQuery().QuerySimDataUsageMonthly(ctx, &req.SimDataUsageMonthlyOldInput)
if err != nil {
return nil, err
}
res = &v1.SimDataUsageMonthlyRes{
SimDataUsageMonthlyOldOutput: *simDataUsageMonthlyOutput,
}
return res, nil
}
func (c *ControllerV1) SimStatus(ctx context.Context, req *v1.SimStatusReq) (res *v1.SimStatusRes, err error) {
simStatusOutput, err := service.OldApiQuery().QuerySimStatus(ctx, &req.SimStatusOldInput)
if err != nil {
return nil, err
}
res = &v1.SimStatusRes{
SimStatusOldOutput: *simStatusOutput,
}
return res, nil
}
func (c *ControllerV1) SimSession(ctx context.Context, req *v1.SimSessionReq) (res *v1.SimSessionRes, err error) {
simSessionOutput, err := service.OldApiQuery().QuerySimSession(ctx, &req.SimStatusOnlineOldInput)
if err != nil {
return nil, err
}
res = &v1.SimSessionRes{
SimStatusOnlineOldOutput: *simSessionOutput,
}
return res, nil
}
func (c *ControllerV1) SimCardInfoList(ctx context.Context, req *v1.SimCardInfoListReq) (res *v1.SimCardInfoListRes, err error) {
simCardInfoListOutput, err := service.OldApiQuery().QueryCardInfoList(ctx, &req.QueryCardInfoListInput)
if err != nil {
return nil, err
}
return &simCardInfoListOutput, nil
}
+5
View File
@@ -0,0 +1,5 @@
// =================================================================================
// This is auto-generated by GoFrame CLI tool only once. Fill this file as you wish.
// =================================================================================
package query
+15
View File
@@ -0,0 +1,15 @@
// =================================================================================
// This is auto-generated by GoFrame CLI tool only once. Fill this file as you wish.
// =================================================================================
package query
import (
"git.5iot.com/iotlcm-public/iotlcm-openapi/api/query"
)
type ControllerV1 struct{}
func NewV1() query.IQueryV1 {
return &ControllerV1{}
}
+93
View File
@@ -0,0 +1,93 @@
package query
import (
"context"
v1 "git.5iot.com/iotlcm-public/iotlcm-openapi/api/query/v1"
"git.5iot.com/iotlcm-public/iotlcm-openapi/internal/service"
)
func (c *ControllerV1) QuerySimInfo(ctx context.Context, req *v1.QuerySimInfoReq) (res *v1.QuerySimInfoRes, err error) {
output, err := service.QuerySim().QuerySimInfo(ctx, &req.QuerySimInput)
if err != nil {
return nil, err
}
res = &v1.QuerySimInfoRes{QuerySimInfoOutput: *output}
return res, nil
}
func (c *ControllerV1) QuerySimLimit(ctx context.Context, req *v1.QuerySimLimitReq) (res *v1.QuerySimLimitRes, err error) {
output, err := service.QuerySim().QuerySimLimit(ctx, &req.QuerySimInput)
if err != nil {
return res, err
}
res = &v1.QuerySimLimitRes{QuerySimLimitOutput: *output}
return res, nil
}
func (c *ControllerV1) QuerySimImei(ctx context.Context, req *v1.QuerySimImeiReq) (res *v1.QuerySimImeiRes, err error) {
output, err := service.QuerySim().QuerySimImei(ctx, &req.QuerySimInput)
if err != nil {
return nil, err
}
res = &v1.QuerySimImeiRes{QuerySimImeiOutput: *output}
return res, nil
}
func (c *ControllerV1) QuerySimUsage(ctx context.Context, req *v1.QuerySimUsageReq) (res *v1.QuerySimUsageRes, err error) {
output, err := service.QuerySim().QuerySimUsage(ctx, &req.QuerySimInput)
if err != nil {
return nil, err
}
res = &v1.QuerySimUsageRes{QuerySimUsageOutput: *output}
return res, nil
}
func (c *ControllerV1) QuerySimStatus(ctx context.Context, req *v1.QuerySimStatusReq) (res *v1.QuerySimStatusRes, err error) {
output, err := service.QuerySim().QuerySimStatus(ctx, &req.QuerySimInput)
if err != nil {
return nil, err
}
res = &v1.QuerySimStatusRes{QuerySimCardStatusOutput: *output}
return res, nil
}
func (c *ControllerV1) QueryTrafficCutoffConfig(ctx context.Context, req *v1.QueryTrafficCutoffConfigReq) (res *v1.QueryTrafficCutoffConfigRes, err error) {
output, err := service.QuerySim().QueryTrafficCutoffConfig(ctx, &req.QueryTrafficCutoffConfigParam)
if err != nil {
return nil, err
}
return &v1.QueryTrafficCutoffConfigRes{QueryTrafficCutoffConfigOutput: *output}, nil
}
func (c *ControllerV1) QueryBatchStatus(ctx context.Context, req *v1.QueryBatchStatusReq) (res *v1.QueryBatchStatusRes, err error) {
output, err := service.QuerySim().QueryBatchStatus(ctx, &req.QueryBatchStatusParam)
if err != nil {
return nil, err
}
return &v1.QueryBatchStatusRes{QueryBatchStatusOutput: *output}, nil
}
func (c *ControllerV1) QuerySimStatusBatch(ctx context.Context, req *v1.QuerySimStatusBatchReq) (res *v1.QuerySimStatusBatchRes, err error) {
output, err := service.QuerySim().QuerySimStatusBatch(ctx, &req.QuerySimStatusBatchParam)
if err != nil {
return nil, err
}
return &v1.QuerySimStatusBatchRes{QuerySimStatusBatchOutput: *output}, nil
}
func (c *ControllerV1) QuerySimUsageBatch(ctx context.Context, req *v1.QuerySimUsageBatchReq) (res *v1.QuerySimUsageBatchRes, err error) {
output, err := service.QuerySim().QuerySimUsageBatch(ctx, &req.QuerySimUsageBatchParam)
if err != nil {
return nil, err
}
return &v1.QuerySimUsageBatchRes{QuerySimUsageBatchOutput: *output}, nil
}
func (c *ControllerV1) QuerySimImeiBatch(ctx context.Context, req *v1.QuerySimImeiBatchReq) (res *v1.QuerySimImeiBatchRes, err error) {
output, err := service.QuerySim().QuerySimImeiBatch(ctx, &req.QuerySimImeiBatchParam)
if err != nil {
return nil, err
}
return &v1.QuerySimImeiBatchRes{QuerySimImeiBatchOutput: *output}, nil
}
+26
View File
@@ -0,0 +1,26 @@
package query
import (
"context"
v1 "git.5iot.com/iotlcm-public/iotlcm-openapi/api/query/v1"
"git.5iot.com/iotlcm-public/iotlcm-openapi/internal/service"
)
func (c *ControllerV1) Token(ctx context.Context, req *v1.TokenReq) (res *v1.TokenRes, err error) {
out, err := service.QueryToken().Token(ctx, req.TokenInputApi)
if err != nil {
return nil, err
}
res = &v1.TokenRes{TokenOutputApi: out}
return res, nil
}
func (c *ControllerV1) OperatorToken(ctx context.Context, req *v1.OperatorTokenReq) (res *v1.OperatorTokenRes, err error) {
out, err := service.QueryToken().OperatorTokenWithAuth(ctx, req.OperatorTokenInput)
if err != nil {
return nil, err
}
res = &v1.OperatorTokenRes{OperatorTokenOutput: out}
return res, nil
}