chore: 初始开源发布

iotlcm-upstream-chan：运营商上游通道适配服务（统一 /sim/* 协议）。 - 内联原私有依赖：yunze-public → internal/pub/（10 包 18 文件）， yunze-pb/pb → internal/pb/（9 文件）；Consul 注册改用官方 gogf/gf/contrib/registry/consul/v2（API 兼容） - Go module：yz-svr → git.5iot.com/iotlcm-public/iotlcm-upstream-chan - 修复 mingqian 包测试：实现重构后 `adapter.operations` 字段已移除，测试断言按当前实现语义重写（不改产品行为） - 凭据与内部标识脱敏：MySQL/Redis/Consul 凭据、私网与生产 IP、内网域名、真实手机号、注释里的真实 token/transid - 移除内部资产：CI 触发器、生产通道种子 SQL、真实凭据测试资源文档 - Dockerfile 改用公共基础镜像，移除写死的 registry 凭据 - 补 Apache-2.0 LICENSE，重写 README，LF 行尾 + .gitattributes
2026-10-22 15:42:29 +08:00
commit 96b1edff45
191 changed files with 30805 additions and 0 deletions
@@ -0,0 +1,82 @@
+package mingqian
+
+import (
+	"context"
+	"math"
+	"strings"
+
+	"git.5iot.com/iotlcm-public/iotlcm-upstream-chan/internal/consts"
+	"git.5iot.com/iotlcm-public/iotlcm-upstream-chan/internal/model"
+	"github.com/gogf/gf/v2/errors/gerror"
+)
+
+type PackageFlowOutput = []*model.SimBaseRes[model.SimPackageFlowItem]
+
+func (adapter *Adapter) QueryPackageFlow(ctx context.Context, input *model.SimDataUsageInput) (PackageFlowOutput, error) {
+	if input == nil {
+		return nil, gerror.New("mingqian: input required")
+	}
+	return query(ctx, adapter, input.SimKeys, packageUsagePath, 50, func(item card) (model.SimPackageFlowItem, error) {
+		if item.PackageTotal == nil || item.PackageUsage == nil || *item.PackageTotal < 0 || *item.PackageUsage < 0 {
+			return model.SimPackageFlowItem{}, gerror.New("mingqian: package total or cumulative usage missing or unknown")
+		}
+		var (
+			total     = float64(*item.PackageTotal)
+			used      = float64(*item.PackageUsage)
+			remaining = math.Max(total-used, 0)
+		)
+		return model.SimPackageFlowItem{TotalFlow: total, DataUsage: used, RemainingFlow: remaining}, nil
+	}), nil
+}
+
+func QueryChannelsPackageFlow(ctx context.Context, input *model.SimDataUsageInput, lookup func(string) (*model.SimCardChannelCache, bool)) (PackageFlowOutput, error) {
+	if input == nil || lookup == nil {
+		return nil, gerror.New("mingqian: input and channel lookup required")
+	}
+	var (
+		output = make(PackageFlowOutput, len(input.SimKeys))
+		groups = make(map[string][]int)
+	)
+	for index, key := range input.SimKeys {
+		output[index] = &model.SimBaseRes[model.SimPackageFlowItem]{SimKey: key, Code: consts.ApiStatusError, Message: "mingqian: explicit chanKey and ICCID or MSISDN required"}
+		if key == nil || strings.TrimSpace(key.ChanKey) == "" || identifier(key) == "" {
+			continue
+		}
+		channelKey := strings.TrimSpace(key.ChanKey)
+		groups[channelKey] = append(groups[channelKey], index)
+	}
+	for channelKey, indices := range groups {
+		var (
+			adapter *Adapter
+			message string
+		)
+		cached, ok := lookup(channelKey)
+		if !ok || cached == nil || cached.Instance == nil {
+			message = "mingqian: channel not instantiated"
+		} else {
+			adapter, ok = cached.Instance.(*Adapter)
+			if !ok || adapter == nil {
+				message = "mingqian: package flow endpoint only supports sim_mingqian_v3 channels"
+			}
+		}
+		if message != "" {
+			for _, index := range indices {
+				output[index].Message = message
+			}
+			continue
+		}
+		keys := make([]*model.SimKey, len(indices))
+		for position, index := range indices {
+			keys[position] = input.SimKeys[index]
+		}
+		results, err := adapter.QueryPackageFlow(ctx, &model.SimDataUsageInput{SimKeys: keys})
+		for position, index := range indices {
+			if err != nil {
+				output[index].Message = err.Error()
+			} else {
+				output[index] = results[position]
+			}
+		}
+	}
+	return output, nil
+}