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 已说明。

server/internal/logic/iot/simcardbatch/cancel/parser.go

@@ -0,0 +1,91 @@
+package cancel
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"strings"
+
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/batchimport"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/batchinput/excel"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/batchinput/text"
+
+	"github.com/gogf/gf/v2/errors/gerror"
+)
+
+func ParseExcelFileRows(ctx context.Context, filePath string) ([]batchimport.Row, error) {
+	parsed, err := excel.ParseFile(ctx, filePath, excel.ParseOptions{RequiredHeaders: []string{"ICCID"}})
+	if err != nil {
+		return nil, err
+	}
+	rows := make([]batchimport.Row, 0, len(parsed))
+	for _, item := range parsed {
+		rows = append(rows, &Row{
+			RowNo:  item.RowNo,
+			Iccid:  excel.Field(item, "ICCID"),
+			Msisdn: excel.Field(item, "MSISDN"),
+			Imsi:   excel.Field(item, "IMSI"),
+		})
+	}
+	return rows, nil
+}
+
+func ParseInputRows(ctx context.Context, input string) ([]batchimport.Row, error) {
+	lines, err := text.ParseWhitespaceFields(ctx, input)
+	if err != nil {
+		if errors.Is(err, text.ErrEmptyInput) {
+			return nil, gerror.New("批量输入内容不能为空")
+		}
+		return nil, err
+	}
+	rows := make([]batchimport.Row, 0, len(lines))
+	for _, line := range lines {
+		row := &Row{RowNo: line.RowNo}
+		switch len(line.Fields) {
+		case 1:
+			row.Iccid = line.Fields[0]
+		case 3:
+			row.Iccid = line.Fields[0]
+			row.Msisdn = line.Fields[1]
+			row.Imsi = line.Fields[2]
+		default:
+			row.AddErrorReason("格式错误，应为 ICCID 或 ICCID MSISDN IMSI")
+		}
+		rows = append(rows, row)
+	}
+	return rows, nil
+}
+
+func validateBasicRows(rows []batchimport.Row) error {
+	firstByIccid := make(map[string]*Row, len(rows))
+	issues := make([]string, 0)
+	for _, item := range rows {
+		row, ok := item.(*Row)
+		if !ok || row == nil {
+			return gerror.New("销户批次行类型错误")
+		}
+		row.Iccid = strings.TrimSpace(row.Iccid)
+		row.Msisdn = strings.TrimSpace(row.Msisdn)
+		row.Imsi = strings.TrimSpace(row.Imsi)
+		if row.Reason != "" {
+			issues = append(issues, fmt.Sprintf("第%d行：%s", row.RowNo, row.Reason))
+			continue
+		}
+		if row.Iccid == "" {
+			row.AddErrorReason("ICCID不能为空")
+			issues = append(issues, fmt.Sprintf("第%d行：ICCID不能为空", row.RowNo))
+			continue
+		}
+		if first, exists := firstByIccid[row.Iccid]; exists {
+			row.AddErrorReason(fmt.Sprintf("ICCID与第%d行重复", first.RowNo))
+			first.AddErrorReason("ICCID重复")
+			issues = append(issues, fmt.Sprintf("第%d行：ICCID与第%d行重复", row.RowNo, first.RowNo))
+			continue
+		}
+		firstByIccid[row.Iccid] = row
+	}
+	if len(issues) > 0 {
+		return gerror.New("销户批次基础格式校验失败：" + strings.Join(issues, "；"))
+	}
+	return nil
+}

server/internal/logic/iot/simcardbatch/cancel/processor.go

@@ -0,0 +1,77 @@
+package cancel
+
+import (
+	"context"
+	"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/model"
+
+	"github.com/gogf/gf/v2/database/gdb"
+	"github.com/gogf/gf/v2/encoding/gjson"
+	"github.com/gogf/gf/v2/errors/gerror"
+	"github.com/gogf/gf/v2/frame/g"
+)
+
+type Processor struct{}
+
+func NewProcessor() *Processor {
+	return &Processor{}
+}
+
+func (p *Processor) Config() batchimport.ProcessorConfig {
+	return batchimport.ProcessorConfig{
+		Code:            "sim_card_cancel",
+		BatchType:       consts.BatchTypeCancel,
+		BatchNoPrefix:   consts.BatchNoPrefixCancel,
+		TaskName:        consts.ResourceBatchDownloadTaskSimCardCancel,
+		ExportScene:     consts.ResourceExportSceneCancel,
+		ImportDir:       consts.SimCardCancelSubDirImportExcel,
+		ResultDir:       consts.SimCardCancelSubDirResultExcel,
+		MaxFileSize:     consts.SimCardCancelMaxFileSize,
+		TemplateHeaders: []string{"ICCID", "MSISDN", "IMSI"},
+		RequiredHeaders: []string{"ICCID"},
+	}
+}
+
+func (p *Processor) ParseRows(ctx context.Context, filePath string) ([]batchimport.Row, error) {
+	return ParseExcelFileRows(ctx, filePath)
+}
+
+func (p *Processor) ValidateRows(_ context.Context, rows []batchimport.Row) error {
+	return validateBasicRows(rows)
+}
+
+func (p *Processor) Execute(context.Context, gdb.TX, *batchimport.SubmitRequest, []batchimport.Row) error {
+	return gerror.New("销户批次只能由异步执行器执行")
+}
+
+func (p *Processor) BuildBatchInfo(_ context.Context, req batchimport.SubmitRequest, result *batchimport.Result, importOss *model.SysOssSaveContentModel, resultOss *model.SysOssSaveContentModel, downloadID int64) *gjson.Json {
+	info := g.Map{
+		"operation":            "cancel",
+		"mode":                 "internal",
+		"requiresStopped":      true,
+		"targetBossCardStatus": consts.V3ApiSimBossCardStatusCanceled,
+		"resultFile": g.Map{
+			"status": "pending",
+		},
+	}
+	if options, ok := req.BizParams.(*SubmitOptions); ok && options != nil {
+		if remark := strings.TrimSpace(options.Remark); remark != "" {
+			info["remark"] = remark
+		}
+	}
+	if result != nil && result.ImportFileOssId > 0 {
+		info["importFileOssId"] = result.ImportFileOssId
+	} else if importOss != nil && importOss.OssId > 0 {
+		info["importFileOssId"] = importOss.OssId
+	}
+	if resultOss != nil {
+		info["resultFileOssId"] = resultOss.OssId
+	}
+	if downloadID > 0 {
+		info["resultDownloadId"] = downloadID
+	}
+	return gjson.New(info)
+}

server/internal/logic/iot/simcardbatch/cancel/submitter.go

@@ -0,0 +1,141 @@
+package cancel
+
+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/dao"
+	"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/library/rabbitmq"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/xgorm/handler"
+
+	"github.com/gogf/gf/v2/errors/gerror"
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/net/ghttp"
+)
+
+type Submitter struct{}
+
+func NewSubmitter() *Submitter {
+	return &Submitter{}
+}
+
+func (s *Submitter) SubmitExcel(ctx context.Context, file *ghttp.UploadFile, remark string) (*SubmitResult, error) {
+	processor := NewProcessor()
+	req := batchimport.SubmitRequest{
+		SourceChannel: batchmetadata.Console,
+		ExecutionMode: batchmetadata.Bulk,
+		File:          file,
+		BizParams:     &SubmitOptions{Remark: strings.TrimSpace(remark)},
+		SourceType:    consts.BatchSourceTypeFile,
+		Operator:      currentOperator(ctx),
+	}
+	result, err := batchimport.CreatePendingUpload(ctx, req, processor, batchimport.PendingOptions{
+		PrepareRows: s.prepareAuthorizedRows,
+	})
+	if err != nil {
+		return nil, err
+	}
+	s.publish(ctx, result)
+	return pendingSubmitResult(result), nil
+}
+
+func (s *Submitter) SubmitInput(ctx context.Context, input, remark string) (*SubmitResult, error) {
+	rows, err := ParseInputRows(ctx, input)
+	if err != nil {
+		return nil, err
+	}
+	processor := NewProcessor()
+	req := batchimport.SubmitRequest{
+		SourceChannel: batchmetadata.Console,
+		ExecutionMode: batchmetadata.Bulk,
+		BizParams:     &SubmitOptions{Remark: strings.TrimSpace(remark)},
+		SourceType:    consts.BatchSourceTypeBatchInput,
+		Operator:      currentOperator(ctx),
+	}
+	result, err := batchimport.CreatePendingRows(ctx, req, processor, rows, batchimport.PendingOptions{
+		PrepareRows: s.prepareAuthorizedRows,
+	})
+	if err != nil {
+		return nil, err
+	}
+	s.publish(ctx, result)
+	return pendingSubmitResult(result), nil
+}
+
+func (s *Submitter) publish(ctx context.Context, result *batchimport.Result) {
+	if result == nil || strings.TrimSpace(result.BatchNo) == "" {
+		return
+	}
+	if err := publishBatchExecute(ctx, batchimport.Message{
+		BatchNo:   result.BatchNo,
+		BatchType: result.BatchType,
+	}); err != nil {
+		g.Log().Errorf(ctx, "cancel batch async publish failed, batchNo=%s, batchType=%d, tenantId=%s, error=%+v",
+			result.BatchNo, result.BatchType, contexts.GetTenantId(ctx), err)
+	}
+}
+
+var publishBatchExecute = func(ctx context.Context, msg batchimport.Message) error {
+	return rabbitmq.Publish(ctx, consts.QueueBatchExecute, msg)
+}
+
+func (s *Submitter) prepareAuthorizedRows(ctx context.Context, rows []batchimport.Row) error {
+	cardRows := make([]*Row, 0, len(rows))
+	iccids := make([]string, 0, len(rows))
+	for _, item := range rows {
+		row, ok := item.(*Row)
+		if !ok || row == nil {
+			return gerror.New("销户批次行类型错误")
+		}
+		cardRows = append(cardRows, row)
+		if row.Iccid != "" {
+			iccids = append(iccids, row.Iccid)
+		}
+	}
+	if len(iccids) == 0 {
+		return nil
+	}
+
+	var visible []struct {
+		Iccid string `orm:"iccid"`
+	}
+	columns := dao.TSimCardInfo.Columns()
+	err := handler.Model(dao.TSimCardInfo.Ctx(ctx), &handler.Option{FilterTenant: true, FilterAuth: true}).
+		Fields(columns.Iccid, columns.TenantId, columns.DeptId, columns.CreatedDept, columns.CreatedBy).
+		WhereIn(columns.Iccid, iccids).
+		Scan(&visible)
+	if err != nil {
+		return gerror.Wrap(err, "计算SIM卡数据权限失败")
+	}
+	authorized := make(map[string]struct{}, len(visible))
+	for _, card := range visible {
+		authorized[strings.TrimSpace(card.Iccid)] = struct{}{}
+	}
+	for _, row := range cardRows {
+		_, row.Authorized = authorized[row.Iccid]
+	}
+	return nil
+}
+
+func currentOperator(ctx context.Context) batchimport.OperatorContext {
+	return batchimport.OperatorContext{
+		TenantId: contexts.GetTenantId(ctx),
+		DeptId:   contexts.GetDeptId(ctx),
+		UserId:   contexts.GetUserId(ctx),
+	}
+}
+
+func pendingSubmitResult(result *batchimport.Result) *SubmitResult {
+	res := &SubmitResult{BatchAsyncStatus: consts.BatchAsyncStatusPending}
+	if result == nil {
+		return res
+	}
+	res.BatchNo = result.BatchNo
+	res.BatchType = result.BatchType
+	res.Total = result.TotalRows
+	return res
+}

server/internal/logic/iot/simcardbatch/cancel/types.go

@@ -0,0 +1,81 @@
+package cancel
+
+import (
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/batchimport"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/model/entity"
+
+	"github.com/gogf/gf/v2/encoding/gjson"
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/os/gtime"
+)
+
+type Row struct {
+	DetailID     int64
+	RowNo        int
+	Iccid        string
+	Msisdn       string
+	Imsi         string
+	Authorized   bool
+	Reason       string
+	StatusBefore int
+}
+
+func (r *Row) GetRowNo() int {
+	if r == nil {
+		return 0
+	}
+	return r.RowNo
+}
+
+func (r *Row) GetItemID() string {
+	if r == nil {
+		return ""
+	}
+	return r.Iccid
+}
+
+func (r *Row) GetErrorReasons() []string {
+	if r == nil || r.Reason == "" {
+		return nil
+	}
+	return []string{r.Reason}
+}
+
+func (r *Row) AddErrorReason(reason string) {
+	if r == nil || r.Reason != "" || reason == "" {
+		return
+	}
+	r.Reason = reason
+}
+
+func (r *Row) Snapshot() *gjson.Json {
+	if r == nil {
+		return gjson.New(g.Map{})
+	}
+	return gjson.New(g.Map{
+		"ICCID":        r.Iccid,
+		"MSISDN":       r.Msisdn,
+		"IMSI":         r.Imsi,
+		"authorized":   r.Authorized,
+		"statusBefore": r.StatusBefore,
+	})
+}
+
+type SubmitOptions struct {
+	Remark string
+}
+
+type SubmitResult struct {
+	BatchNo          string
+	BatchType        int
+	BatchAsyncStatus int
+	Total            int
+}
+
+type Task struct {
+	Batch     *entity.BatchMain
+	Rows      []*Row
+	Operator  batchimport.OperatorContext
+	Remark    string
+	StartTime *gtime.Time
+}