chore: 初始开源发布

iotlcm-admin-svr：管理后台服务。 - Go module：iotlcm → git.5iot.com/iotlcm-public/iotlcm-admin-svr（729 文件） - 凭据与地址脱敏：JWT signingKey（含代码里的 MustGet 默认值）、 MySQL DSN、Redis 口令、告警邮件发件人邮箱全部改为占位；私网 IP → 文档地址段；库名 xiujie_admin → iotlcm - 真实手机号/邮箱 → 合法 11 位编造号 / example.com - 移除内部资产：CI 触发器、过时 DDL（sql/db_iotlcm.sql）、私有依赖 go get 行、明文 registry 登录口令 - 启动 banner 统一 IOTLCM 方块字 + 社区惯例署名 - Dockerfile 改用公共基础镜像 - 拼错的 RADEME.md → README.md，README 重写 - 需要真实数据库的用例改为可用 IOTLCM_TEST_WITH_DB=1 显式启用 - 补 Apache-2.0 LICENSE，LF 行尾 + .gitattributes 数据库 schema 不随本仓发布（生产 DDL 已过时），README 已说明。
2026-10-23 14:46:05 +08:00
commit 59eb34976a
1132 changed files with 138197 additions and 0 deletions
@@ -0,0 +1,158 @@
+package iot
+
+import (
+	"context"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/batchmetadata"
+	"strings"
+
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/consts"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/batchimport"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/contexts"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/logic/iot/simcardbatch/renew"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/model"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/service"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/utility/iot_excelize"
+
+	"github.com/gogf/gf/v2/database/gdb"
+	"github.com/gogf/gf/v2/errors/gerror"
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/net/ghttp"
+	"github.com/xuri/excelize/v2"
+)
+
+func (s *sIotTSimCardRenew) DownloadExcelTemplate(ctx context.Context) error {
+	f := excelize.NewFile()
+	defer func() { _ = f.Close() }()
+
+	headers := renew.ExcelTemplateHeaders()
+	if err := f.SetSheetRow("Sheet1", "A1", &headers); err != nil {
+		return err
+	}
+	widths := map[string]float64{
+		"A": 22,
+		"B": 20,
+		"C": 20,
+		"D": 18,
+		"E": 18,
+	}
+	for column, width := range widths {
+		if err := f.SetColWidth("Sheet1", column, column, width); err != nil {
+			return err
+		}
+	}
+	if err := iot_excelize.ApplyHeaderColumnsTextStyle(f); err != nil {
+		return err
+	}
+
+	return iot_excelize.WriteHTTP(ctx, f, "sim_card_renew_template")
+}
+
+// SubmitExcel creates an asynchronous renew prepare batch. The worker performs
+// database validation, including the six-month expiry window and latest pending
+// subscription selection. The formal renew batch is created after confirmation.
+func (s *sIotTSimCardRenew) SubmitExcel(ctx context.Context, in *model.TSimCardRenewExcelSubmitParam) (*model.TSimCardRenewExcelSubmitRes, error) {
+	if in == nil {
+		in = &model.TSimCardRenewExcelSubmitParam{}
+	}
+
+	file, err := s.getRenewUploadFile(ctx)
+	if err != nil {
+		return nil, err
+	}
+
+	excelProcessor := renew.NewPrepareExcelProcessor()
+	req := batchimport.SubmitRequest{
+		SourceChannel: batchmetadata.Console,
+		ExecutionMode: batchmetadata.Bulk,
+		File:          file,
+		SourceType:    consts.BatchSourceTypeFile,
+		Operator:      currentOperator(ctx),
+		BeforeSave: func(ctx context.Context, tx gdb.TX, request *batchimport.SubmitRequest, rows []batchimport.Row) error {
+			opts := excelProcessor.ExcelSubmitOptions()
+			if opts == nil {
+				if reason := firstRenewExcelRowReason(rows); reason != "" {
+					return gerror.New(reason)
+				}
+				return gerror.New("续费年限不能为空")
+			}
+			isTop, _, err := service.AgentDept().IsTopDept(ctx)
+			if err != nil {
+				return gerror.Wrap(err, "校验续费付款方式失败")
+			}
+			paymentMode, err := normalizeRenewPaymentMode(opts.PaymentMode, isTop)
+			if err != nil {
+				return err
+			}
+			opts.PaymentMode = paymentMode
+
+			request.BizParams = opts.ToBatchSubmitParam()
+			return nil
+		},
+	}
+
+	result, err := batchimport.CreatePendingUpload(ctx, req, excelProcessor, batchimport.PendingOptions{
+		PrepareRows: func(ctx context.Context, rows []batchimport.Row) error {
+			if len(rows) == 0 {
+				return nil
+			}
+			return excelProcessor.ValidateRows(ctx, rows)
+		},
+	})
+	if err != nil {
+		return nil, err
+	}
+
+	res := renewExcelSubmitResult(result)
+	if result.ImportStatus == consts.ImportStatusSuccess {
+		publishPendingExecute(ctx, result.BatchNo, consts.BatchTypePrepare, contexts.GetTenantId(ctx))
+	}
+	return res, nil
+}
+
+func (s *sIotTSimCardRenew) getRenewUploadFile(ctx context.Context) (*ghttp.UploadFile, error) {
+	r := g.RequestFromCtx(ctx)
+	if r == nil {
+		return nil, gerror.New("current context is not an HTTP request")
+	}
+	file := r.GetUploadFile("file")
+	if file == nil {
+		return nil, gerror.New("please select upload file")
+	}
+	return file, nil
+}
+
+func renewExcelSubmitResult(result *batchimport.Result) *model.TSimCardRenewExcelSubmitRes {
+	if result == nil {
+		return &model.TSimCardRenewExcelSubmitRes{}
+	}
+	res := &model.TSimCardRenewExcelSubmitRes{
+		BatchNo:          result.BatchNo,
+		BatchType:        result.BatchType,
+		TargetBatchType:  consts.BatchTypeRenew,
+		Status:           result.ImportStatus,
+		BatchAsyncStatus: consts.BatchAsyncStatusPending,
+		RunResult:        consts.BatchRunResultPending,
+		Total:            result.TotalRows,
+		ResultDownloadId: result.ResultDownloadId,
+		ResultFileOssId:  result.ResultFileOssId,
+		FailReason:       result.FailReason,
+	}
+	if result.ImportStatus != consts.ImportStatusSuccess {
+		res.BatchAsyncStatus = consts.BatchAsyncStatusFailed
+		res.RunResult = consts.BatchRunResultFailed
+	}
+	return res
+}
+
+func firstRenewExcelRowReason(rows []batchimport.Row) string {
+	for _, item := range rows {
+		row, ok := item.(*renew.Row)
+		if !ok || row == nil {
+			continue
+		}
+		if reason := strings.TrimSpace(row.Reason); reason != "" {
+			return reason
+		}
+	}
+	return ""
+}