chore: 初始开源发布

iotlcm-worker-svr：异步执行中枢（RabbitMQ 消费者 + 全量同步编排）。 - Go module：iotlcm-worker-svr → git.5iot.com/iotlcm-public/iotlcm-worker-svr（214 文件） - 凭据与内部标识脱敏：MySQL/Redis 凭据、私网与生产 IP、内网域名、库名 xiujie_admin → iotlcm、哨兵名占位 - 159 处真实手机号 → 合法 11 位编造号（保留号段与后 4 位，维持互异，不破坏「校验 MSISDN 格式」等测试断言） - 移除内部资产：CI 触发器、Jenkins 触发测试文档、预演门禁与镜像 digest 记录 - Dockerfile 改用公共基础镜像（golang:1.25-alpine → alpine:3.23），移除写死的 git 凭据 - README 重写（架构/全量同步模型/配置/已知失败），补 Apache-2.0 LICENSE，LF 行尾 + .gitattributes 已知：3 个测试包在源仓同一提交上同样失败（client/upstream、 service/allocate、service/inbound），属既有缺陷，本仓未引入亦未修复。
2026-10-22 16:37:56 +08:00
commit 2bec257289
361 changed files with 71524 additions and 0 deletions
@@ -0,0 +1,85 @@
+package contract_test
+
+import (
+	"testing"
+
+	"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/fullsync/contract"
+)
+
+// TestSyncKindForOperationCoversEveryChain pins the operation→kind mapping for
+// all five full-sync chains. A missing case makes the run invisible in the
+// admin monitor, because the catalog filters runs by SyncKind.
+func TestSyncKindForOperationCoversEveryChain(t *testing.T) {
+	cases := []struct {
+		operation string
+		want      contract.SyncKind
+	}{
+		{"current_month_usage_full_sync", contract.SyncKindTrafficUsage},
+		{"sim_status_queue_full_sync", contract.SyncKindSimStatus},
+		{"previous_day_usage_full_sync", contract.SyncKindTrafficUsageDaily},
+		{"previous_month_usage_full_sync", contract.SyncKindTrafficUsageMonthly},
+		{"imei_full_sync", contract.SyncKindImei},
+	}
+	for _, tc := range cases {
+		got := contract.SyncKindForOperation(tc.operation)
+		if got != tc.want {
+			t.Fatalf("SyncKindForOperation(%q) = %q, want %q", tc.operation, got, tc.want)
+		}
+		if !got.Valid() {
+			t.Fatalf("%q 应通过 Valid()", got)
+		}
+	}
+}
+
+// TestSyncKindForOperationRejectsUnknown 未知 operation 返回空 kind，
+// 由调用方决定是跳过还是报错。
+func TestSyncKindForOperationRejectsUnknown(t *testing.T) {
+	for _, operation := range []string{"", "unknown", "IMEI_FULL_SYNC"} {
+		got := contract.SyncKindForOperation(operation)
+		if got != "" {
+			t.Fatalf("SyncKindForOperation(%q) = %q, want empty", operation, got)
+		}
+		if got.Valid() {
+			t.Fatalf("空 kind 不应通过 Valid()")
+		}
+	}
+}
+
+// TestSyncKindValidRejectsUnknown 只有五个已注册的 kind 有效。
+func TestSyncKindValidRejectsUnknown(t *testing.T) {
+	valid := []contract.SyncKind{
+		contract.SyncKindTrafficUsage,
+		contract.SyncKindSimStatus,
+		contract.SyncKindTrafficUsageDaily,
+		contract.SyncKindTrafficUsageMonthly,
+		contract.SyncKindImei,
+	}
+	for _, kind := range valid {
+		if !kind.Valid() {
+			t.Fatalf("%q 应有效", kind)
+		}
+	}
+	invalid := []contract.SyncKind{"", "imei_full_sync", "IMEI", "traffic", "sim-status"}
+	for _, kind := range invalid {
+		if kind.Valid() {
+			t.Fatalf("%q 不应有效", kind)
+		}
+	}
+}
+
+// TestSyncKindValuesAreStable 枚举字符串是持久化契约（写入 Run 元数据、
+// 归档 JSON 与 admin 查询参数），不得随意改动。
+func TestSyncKindValuesAreStable(t *testing.T) {
+	cases := map[contract.SyncKind]string{
+		contract.SyncKindTrafficUsage:        "traffic_usage",
+		contract.SyncKindSimStatus:           "sim_status",
+		contract.SyncKindTrafficUsageDaily:   "traffic_usage_daily",
+		contract.SyncKindTrafficUsageMonthly: "traffic_usage_monthly",
+		contract.SyncKindImei:                "imei",
+	}
+	for kind, want := range cases {
+		if string(kind) != want {
+			t.Fatalf("kind = %q, want %q（持久化契约不得改动）", kind, want)
+		}
+	}
+}