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),属既有缺陷,本仓未引入亦未修复。
This commit is contained in:
MiFaZhan
2026-10-22 16:37:56 +08:00
commit 2bec257289
361 changed files with 71524 additions and 0 deletions
+459
View File
@@ -0,0 +1,459 @@
package simstatus
import (
"context"
"crypto/rand"
"crypto/sha256"
"encoding/hex"
"errors"
"fmt"
"strings"
"sync/atomic"
"time"
"github.com/gogf/gf/v2/frame/g"
"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/dao"
"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/model"
"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/model/entity"
queue "git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/queue/zset"
)
const FullSyncOperation = "sim_status_queue_full_sync"
// scopeSampleLimit bounds how many channel names are copied into run metadata.
const scopeSampleLimit = 10
// productionStats mirrors the monthly usage producer so both full-sync paths
// report a single comparable summary line. The status path previously had no
// producer summary at all, which made a scope change impossible to verify.
type productionStats struct {
pages int64
scanned int64
enqueued int64
skippedEmptyChan int64
skippedNoTemplate int64
skippedSyncDisabled int64
skippedOutOfScope int64
scopeChannels int
channels map[string]struct{}
}
func newProductionStats(scopeChannels int) productionStats {
return productionStats{channels: make(map[string]struct{}), scopeChannels: scopeChannels}
}
func (s *productionStats) log(ctx context.Context, status, runID, stage, reason string, startedAt time.Time, maxID int64, err error) {
message := fmt.Sprintf("event=sim_status_queue_producer status=%s runId=%s snapshotMaxId=%d pages=%d scanned=%d enqueued=%d skippedEmptyChan=%d skippedNoTemplate=%d skippedSyncDisabled=%d skippedOutOfScope=%d channelCount=%d scopeChannels=%d durationMs=%d", status, runID, maxID, s.pages, s.scanned, s.enqueued, s.skippedEmptyChan, s.skippedNoTemplate, s.skippedSyncDisabled, s.skippedOutOfScope, len(s.channels), s.scopeChannels, time.Since(startedAt).Milliseconds())
if s.scanned > 0 {
message += fmt.Sprintf(" cardsPerSec=%.2f", float64(s.scanned)/time.Since(startedAt).Seconds())
}
if stage != "" {
message += " stage=" + stage
}
if reason != "" {
message += " reason=" + reason
}
if err != nil {
message += fmt.Sprintf(" error=%q", err.Error())
}
switch status {
case "failed":
g.Log().Error(ctx, message)
case "skipped":
g.Log().Warning(ctx, message)
default:
g.Log().Info(ctx, message)
}
}
type Config struct {
PageSize int
RunLockKey string
RunLockTTL time.Duration
PollInterval time.Duration
GlobalHighWaterMark int64
}
func (c Config) withDefaults() Config {
if c.PageSize <= 0 {
c.PageSize = 1000
}
if c.RunLockKey == "" {
c.RunLockKey = "sim-status:producer:active"
}
if c.RunLockTTL <= 0 {
c.RunLockTTL = 5 * time.Minute
}
if c.PollInterval <= 0 {
c.PollInterval = time.Second
}
return c
}
type Card struct {
ID int64
ICCID string
MSISDN string
IMSI string
ChanKey string
TempKey string
Operator int
SyncEnabled bool
}
type Scanner interface {
SnapshotMaxID(context.Context) (int64, error)
Scan(context.Context, int64, int64, int) ([]Card, error)
}
type channelMetadata struct {
ChanKey string `orm:"chan_key"`
TempKey string `orm:"temp_key"`
Operator int `orm:"operator"`
SyncEnabled bool `orm:"sync_enabled"`
}
// DatabaseScanner uses keyset pagination so a large status run does not hold
// the entire card table in memory and does not degrade through OFFSET scans.
type DatabaseScanner struct {
metadata map[string]channelMetadata
}
func (s *DatabaseScanner) SnapshotMaxID(ctx context.Context) (int64, error) {
var card entity.TSimCardInfo
columns := dao.TSimCardInfo.Columns()
if err := dao.TSimCardInfo.Ctx(ctx).
Fields(columns.Id).
OrderDesc(columns.Id).
Limit(1).
Scan(&card); err != nil {
return 0, fmt.Errorf("read status snapshot max id: %w", err)
}
return card.Id, nil
}
func (s *DatabaseScanner) Scan(ctx context.Context, lastID, maxID int64, pageSize int) ([]Card, error) {
if maxID <= lastID {
return nil, nil
}
if s.metadata == nil {
var rows []channelMetadata
if err := g.DB().Model("t_sim_channels").Fields("chan_key,temp_key,sync_enabled,operator").Scan(&rows); err != nil {
return nil, fmt.Errorf("scan status channel metadata: %w", err)
}
s.metadata = make(map[string]channelMetadata, len(rows))
for _, row := range rows {
s.metadata[row.ChanKey] = row
}
}
columns := dao.TSimCardInfo.Columns()
var rows []entity.TSimCardInfo
if err := dao.TSimCardInfo.Ctx(ctx).
Fields(columns.Id, columns.Iccid, columns.Msisdn, columns.Imsi, columns.ChanKey).
WhereGT(columns.Id, lastID).
WhereLTE(columns.Id, maxID).
OrderAsc(columns.Id).
Limit(pageSize).
Scan(&rows); err != nil {
return nil, fmt.Errorf("scan status cards: %w", err)
}
cards := make([]Card, 0, len(rows))
for _, row := range rows {
if row.Id <= 0 || row.Iccid == "" || row.ChanKey == "" {
// Keep the page cursor moving even when a row cannot become a
// runnable task. The producer advances by the highest returned ID.
if row.Id > 0 {
cards = append(cards, Card{ID: row.Id})
}
continue
}
metadata := s.metadata[row.ChanKey]
cards = append(cards, Card{ID: row.Id, ICCID: row.Iccid, MSISDN: row.Msisdn, IMSI: row.Imsi, ChanKey: row.ChanKey, TempKey: metadata.TempKey, Operator: metadata.Operator, SyncEnabled: metadata.SyncEnabled})
}
return cards, nil
}
type Producer struct {
scanner Scanner
store *queue.Store
config Config
running atomic.Int32
owner string
}
var ErrAlreadyRunning = fmt.Errorf("sim status producer already running")
// ErrRunFinished is returned when a redelivered start message names a run that
// already reached a terminal state. The run must not be resurrected.
var ErrRunFinished = fmt.Errorf("sim status run already finished")
// runAlreadyFinished reports whether runID exists and has already completed.
// A missing run is not an error: the message may be the first delivery.
func (p *Producer) runAlreadyFinished(ctx context.Context, runID string) (bool, error) {
meta, err := p.store.GetRunMeta(ctx, runID)
if err != nil {
if strings.Contains(err.Error(), "not found") {
return false, nil
}
return false, err
}
return meta.Status == "completed" || meta.Status == "completed_with_failures", nil
}
func New(scanner Scanner, store *queue.Store, config Config) (*Producer, error) {
if scanner == nil || store == nil {
return nil, fmt.Errorf("sim status producer dependencies are incomplete")
}
return &Producer{scanner: scanner, store: store, config: config.withDefaults(), owner: newOwner()}, nil
}
func (p *Producer) Produce(ctx context.Context, message model.SimStatusQueueStartMessage) error {
startedAt := time.Now()
if message.RunID == "" {
return fmt.Errorf("status sync runId is empty")
}
operation := message.Operation
if operation == "" {
operation = FullSyncOperation
}
scope, err := model.NormalizeScope(message.Scope)
if err != nil {
failedStats := newProductionStats(0)
failedStats.log(ctx, "failed", message.RunID, "validate", "invalid_scope", startedAt, 0, err)
return err
}
stats := newProductionStats(scope.ChannelCount())
if !p.running.CompareAndSwap(0, 1) {
stats.log(ctx, "skipped", message.RunID, "precheck", "already_running", startedAt, 0, nil)
return ErrAlreadyRunning
}
defer p.running.Store(0)
// A redelivered start message must not resurrect a run that already
// finished; that would create a second producer pass over the same RunID.
if finished, checkErr := p.runAlreadyFinished(ctx, message.RunID); checkErr != nil {
stats.log(ctx, "failed", message.RunID, "run_state", "", startedAt, 0, checkErr)
return checkErr
} else if finished {
stats.log(ctx, "skipped", message.RunID, "run_state", "run_finished", startedAt, 0, nil)
return ErrRunFinished
}
acquired, err := p.store.AcquireLockOrTakeover(ctx, p.config.RunLockKey, p.owner, message.RunID, p.config.RunLockTTL)
if err != nil {
stats.log(ctx, "failed", message.RunID, "lock", "", startedAt, 0, err)
return err
}
if !acquired {
stats.log(ctx, "skipped", message.RunID, "lock", "already_running", startedAt, 0, nil)
return ErrAlreadyRunning
}
defer func() {
releaseCtx, cancel := context.WithTimeout(context.Background(), time.Second)
defer cancel()
_, _ = p.store.ReleaseLock(releaseCtx, p.config.RunLockKey, p.owner)
}()
if err := p.store.CreateRun(ctx, queue.RunMeta{
RunID: message.RunID,
Operation: operation,
Status: "producing",
CurrentRound: 1,
ScopeChannels: scope.ChannelCount(),
ScopeDigest: scopeDigest(scope),
ScopeChannelsSample: strings.Join(scope.ChannelSample(scopeSampleLimit), ","),
}); err != nil {
stats.log(ctx, "failed", message.RunID, "run_init", "", startedAt, 0, err)
return err
}
lockCtx, stopRenew := context.WithCancel(ctx)
renewErr := make(chan error, 1)
go p.renewLock(lockCtx, stopRenew, renewErr)
defer func() {
stopRenew()
select {
case <-renewErr:
default:
}
}()
maxID, err := p.scanner.SnapshotMaxID(ctx)
if err != nil {
stats.log(ctx, "failed", message.RunID, "snapshot", "", startedAt, 0, err)
return err
}
g.Log().Infof(ctx, "event=sim_status_queue_producer status=started runId=%s snapshotMaxId=%d scopeChannels=%d", message.RunID, maxID, scope.ChannelCount())
stage := "scan"
defer func() {
if err != nil {
stats.log(ctx, "failed", message.RunID, stage, "", startedAt, maxID, err)
return
}
stats.log(ctx, "completed", message.RunID, "", "", startedAt, maxID, nil)
}()
lastID := int64(0)
for lastID < maxID {
select {
case err := <-renewErr:
return err
default:
}
stage = "scan"
cards, scanErr := p.scanner.Scan(ctx, lastID, maxID, p.config.PageSize)
if scanErr != nil {
return scanErr
}
if len(cards) == 0 {
break
}
stats.pages++
stats.scanned += int64(len(cards))
groups := make(map[string][]queue.Task)
for _, card := range cards {
if card.ID > lastID {
lastID = card.ID
}
if card.ChanKey == "" {
stats.skippedEmptyChan++
continue
}
// Scope is applied before the template and sync_enabled checks so a
// partial run only reports on the channels it was asked for.
if !scope.Allows(card.ChanKey) {
stats.skippedOutOfScope++
continue
}
if card.TempKey == "" {
stats.skippedNoTemplate++
continue
}
if card.SyncEnabled {
// sync_enabled=1(否/不参与) → skip
stats.skippedSyncDisabled++
continue
}
stats.channels[card.ChanKey] = struct{}{}
task := queue.Task{TaskID: queue.StableTaskID(message.RunID, operation, card.ID), RunID: message.RunID, Operation: operation, ChanKey: card.ChanKey, TempKey: card.TempKey, Operator: card.Operator, CardID: card.ID, ICCID: card.ICCID, MSISDN: card.MSISDN, IMSI: card.IMSI}
groups[card.ChanKey] = append(groups[card.ChanKey], task)
}
for chanKey, tasks := range groups {
stage = "enqueue"
added, enqueueErr := p.store.EnqueueRunBatch(ctx, message.RunID, chanKey, tasks, time.Now())
if enqueueErr != nil {
return fmt.Errorf("enqueue status channel %s: %w", chanKey, enqueueErr)
}
stats.enqueued += int64(added)
}
stage = "capacity"
if err = p.waitForCapacity(ctx); err != nil {
return err
}
}
return p.store.MarkProducerDone(ctx, message.RunID)
}
// scopeDigest is a stable short fingerprint of the selected channels.
func scopeDigest(scope *model.SyncScope) string {
if scope == nil || len(scope.Channels) == 0 {
return ""
}
digest := sha256.Sum256([]byte(strings.Join(scope.Channels, "\n")))
return hex.EncodeToString(digest[:8])
}
func (p *Producer) renewLock(ctx context.Context, cancel context.CancelFunc, errors chan<- error) {
interval := p.config.RunLockTTL / 3
if interval <= 0 {
interval = time.Second
}
ticker := time.NewTicker(interval)
defer ticker.Stop()
for {
select {
case <-ctx.Done():
return
case <-ticker.C:
ok, err := p.store.RenewLock(ctx, p.config.RunLockKey, p.owner, p.config.RunLockTTL)
if err == nil && !ok {
err = ErrAlreadyRunning
}
if err != nil {
select {
case errors <- err:
default:
}
cancel()
return
}
}
}
}
func (p *Producer) waitForCapacity(ctx context.Context) error {
if p.config.GlobalHighWaterMark <= 0 {
return nil
}
for {
runs, err := p.store.ActiveRuns(ctx)
if err != nil {
return err
}
var total int64
for _, runID := range runs {
meta, sizeErr := p.store.GetRunMeta(ctx, runID)
if sizeErr != nil {
// The active index can list a run whose hash is already gone
// (expired, evicted, or cleaned by hand). Treat it as a stale
// index entry and drop it instead of failing the scan.
if errors.Is(sizeErr, queue.ErrRunNotFound) {
if _, removeErr := p.store.RedisClient().Do(ctx, "SREM", p.store.ActiveRunsKey(), runID); removeErr != nil {
return removeErr
}
g.Log().Warningf(ctx, "event=sim_status_queue_producer status=skipped stage=capacity reason=stale_index runId=%s", runID)
continue
}
return sizeErr
}
// ActiveCount includes leased tasks; do not count InflightCount twice.
total += meta.ActiveCount + meta.NextRoundCount
}
if total <= p.config.GlobalHighWaterMark {
return nil
}
select {
case <-ctx.Done():
return ctx.Err()
case <-time.After(p.config.PollInterval):
}
}
}
func (p *Producer) EnqueueCard(ctx context.Context, message model.SimStatusQueueTaskMessage) error {
if message.CardID <= 0 || message.ICCID == "" || message.ChanKey == "" || message.TempKey == "" {
return fmt.Errorf("invalid status sync task")
}
if message.RunID == "" {
message.RunID = "status-card-" + newOwner()
}
if message.Operation == "" {
message.Operation = "sim_status_queue_task"
}
if err := p.store.CreateRun(ctx, queue.RunMeta{
RunID: message.RunID,
Operation: message.Operation,
Status: "producing",
CurrentRound: 1,
}); err != nil {
return err
}
task := queue.Task{TaskID: queue.StableTaskID(message.RunID, message.Operation, message.CardID), RunID: message.RunID, Operation: message.Operation, ChanKey: message.ChanKey, TempKey: message.TempKey, Operator: message.Operator, CardID: message.CardID, ICCID: message.ICCID, MSISDN: message.MSISDN, IMSI: message.IMSI}
if _, err := p.store.EnqueueRunBatch(ctx, message.RunID, message.ChanKey, []queue.Task{task}, time.Now()); err != nil {
return err
}
return p.store.MarkProducerDone(ctx, message.RunID)
}
func newOwner() string {
var b [12]byte
if _, err := rand.Read(b[:]); err == nil {
return hex.EncodeToString(b[:])
}
return fmt.Sprintf("%d", time.Now().UnixNano())
}
@@ -0,0 +1,120 @@
package simstatus
import (
"context"
"errors"
"testing"
"time"
"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/model"
queue "git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/queue/zset"
"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/testutil"
)
type cardScanner struct{ cards []Card }
func (s cardScanner) SnapshotMaxID(context.Context) (int64, error) { return int64(len(s.cards)), nil }
func (s cardScanner) Scan(_ context.Context, last, max int64, limit int) ([]Card, error) {
end := last + int64(limit)
if end > max {
end = max
}
return s.cards[last:end], nil
}
func TestProducerUsesRunQueueForFullAndSingleCard(t *testing.T) {
redis := testutil.Redis(t)
ctx := context.Background()
store, err := queue.New(redis, "sim-status:")
if err != nil {
t.Fatal(err)
}
scanner := cardScanner{cards: []Card{
{ID: 1, ICCID: "a", ChanKey: "ch", TempKey: "sim_yd_v5"},
{ID: 2, ICCID: "b", ChanKey: "ch", TempKey: "sim_yd_v5", SyncEnabled: true},
{ID: 3, ICCID: "c", ChanKey: "ch"},
{ID: 4, ICCID: "d", ChanKey: "ch", TempKey: "sim_yd_v5"},
}}
producer, err := New(scanner, store, Config{PageSize: 1})
if err != nil {
t.Fatal(err)
}
for i := 0; i < 2; i++ {
if err = producer.Produce(ctx, model.SimStatusQueueStartMessage{RunID: "full"}); err != nil {
t.Fatal(err)
}
}
meta, err := store.GetRunMeta(ctx, "full")
if err != nil || !meta.ProducerDone || meta.ActiveCount != 2 || meta.Status != "running" {
t.Fatalf("full metadata=%+v err=%v", meta, err)
}
claims, err := store.ClaimRun(ctx, "full", "ch", time.Now(), time.Now().Add(time.Minute), 10)
if err != nil || len(claims) != 2 {
t.Fatalf("full claims=%+v err=%v", claims, err)
}
if n, err := store.Size(ctx, "ch"); err != nil || n != 0 {
t.Fatalf("legacy queue populated: %d %v", n, err)
}
message := model.SimStatusQueueTaskMessage{RunID: "single", CardID: 42, ICCID: "single", ChanKey: "ch", TempKey: "sim_yd_v5"}
for i := 0; i < 2; i++ {
if err = producer.EnqueueCard(ctx, message); err != nil {
t.Fatal(err)
}
}
meta, err = store.GetRunMeta(ctx, "single")
if err != nil || !meta.ProducerDone || meta.ActiveCount != 1 {
t.Fatalf("single metadata=%+v err=%v", meta, err)
}
claims, err = store.ClaimRun(ctx, "single", "ch", time.Now(), time.Now().Add(time.Minute), 10)
if err != nil || len(claims) != 1 {
t.Fatalf("single claims=%+v err=%v", claims, err)
}
if n, err := store.FinalizeRunTasks(ctx, claims, []queue.TaskOutcome{{Success: true}}, 1); err != nil || n != 1 {
t.Fatalf("single finalize: %d %v", n, err)
}
if ok, err := store.CompleteRunIfIdle(ctx, "single"); err != nil || !ok {
t.Fatalf("single complete: %v %v", ok, err)
}
if err = producer.EnqueueCard(ctx, message); err != nil {
t.Fatal(err)
}
meta, err = store.GetRunMeta(ctx, "single")
if err != nil || meta.Status != "completed" || meta.SuccessCount != 1 || meta.ActiveCount != 0 {
t.Fatalf("replayed single=%+v err=%v", meta, err)
}
}
func TestProducerBackpressureIncludesLeasedRunTasks(t *testing.T) {
redis := testutil.Redis(t)
store, _ := queue.New(redis, "sim-status:")
ctx := context.Background()
producer, err := New(cardScanner{}, store, Config{GlobalHighWaterMark: 1, PollInterval: time.Millisecond})
if err != nil {
t.Fatal(err)
}
if err = store.CreateRun(ctx, queue.RunMeta{RunID: "busy"}); err != nil {
t.Fatal(err)
}
tasks := []queue.Task{{RunID: "busy", TaskID: "1", ChanKey: "ch"}, {RunID: "busy", TaskID: "2", ChanKey: "ch"}}
if _, err = store.EnqueueRunBatch(ctx, "busy", "ch", tasks, time.Now()); err != nil {
t.Fatal(err)
}
claims, err := store.ClaimRun(ctx, "busy", "ch", time.Now(), time.Now().Add(time.Minute), 2)
if err != nil || len(claims) != 2 {
t.Fatalf("claim=%v err=%v", claims, err)
}
waitCtx, cancel := context.WithTimeout(ctx, 30*time.Millisecond)
defer cancel()
if err = producer.waitForCapacity(waitCtx); !errors.Is(err, context.DeadlineExceeded) {
t.Fatalf("did not wait on run backlog: %v", err)
}
if _, err = store.FinalizeRunTasks(ctx, claims[:1], []queue.TaskOutcome{{Success: true}}); err != nil {
t.Fatal(err)
}
// One remaining lease meets the watermark: InflightCount must not be added again.
waitCtx2, cancel2 := context.WithTimeout(ctx, time.Second)
defer cancel2()
if err = producer.waitForCapacity(waitCtx2); err != nil {
t.Fatalf("double-counted lease: %v", err)
}
}
+223
View File
@@ -0,0 +1,223 @@
package simstatus
import (
"context"
"errors"
"testing"
"time"
"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/model"
queue "git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/queue/zset"
"git.5iot.com/iotlcm-public/iotlcm-worker-svr/internal/testutil"
)
func newScopeTestProducer(t *testing.T, cards []Card) (*Producer, *queue.Store) {
t.Helper()
store, err := queue.New(testutil.Redis(t), "sim-status:")
if err != nil {
t.Fatal(err)
}
producer, err := New(cardScanner{cards: cards}, store, Config{PageSize: 10})
if err != nil {
t.Fatal(err)
}
return producer, store
}
func scopeMessage(runID string, channels ...string) model.SimStatusQueueStartMessage {
return model.SimStatusQueueStartMessage{
RunID: runID,
Scope: &model.SyncScope{Channels: channels},
}
}
func TestProduceScopeEnqueuesOnlySelectedChannels(t *testing.T) {
cards := []Card{
{ID: 1, ICCID: "a", ChanKey: "217", TempKey: "sim_yd_v5"},
{ID: 2, ICCID: "b", ChanKey: "173", TempKey: "sim_yd_v5"},
{ID: 3, ICCID: "c", ChanKey: "217", TempKey: "sim_yd_v5"},
{ID: 4, ICCID: "d", ChanKey: "189", TempKey: "sim_yd_v5"},
}
producer, store := newScopeTestProducer(t, cards)
ctx := context.Background()
if err := producer.Produce(ctx, scopeMessage("scoped", "217")); err != nil {
t.Fatal(err)
}
channels, err := store.RunChannels(ctx, "scoped")
if err != nil {
t.Fatal(err)
}
if len(channels) != 1 || channels[0] != "217" {
t.Fatalf("run channels = %v, want only 217", channels)
}
meta, err := store.GetRunMeta(ctx, "scoped")
if err != nil {
t.Fatal(err)
}
if meta.ScopeChannels != 1 {
t.Fatalf("scopeChannels = %d, want 1", meta.ScopeChannels)
}
if meta.ScopeDigest == "" {
t.Fatalf("scopeDigest must be recorded for a partial run")
}
if meta.ScopeChannelsSample != "217" {
t.Fatalf("scopeChannelsSample = %q, want 217", meta.ScopeChannelsSample)
}
}
func TestProduceFullScopeRecordsNoScopeMetadata(t *testing.T) {
cards := []Card{
{ID: 1, ICCID: "a", ChanKey: "217", TempKey: "sim_yd_v5"},
{ID: 2, ICCID: "b", ChanKey: "173", TempKey: "sim_yd_v5"},
}
producer, store := newScopeTestProducer(t, cards)
ctx := context.Background()
if err := producer.Produce(ctx, model.SimStatusQueueStartMessage{RunID: "full"}); err != nil {
t.Fatal(err)
}
meta, err := store.GetRunMeta(ctx, "full")
if err != nil {
t.Fatal(err)
}
if meta.ScopeChannels != 0 || meta.ScopeDigest != "" || meta.ScopeChannelsSample != "" {
t.Fatalf("full run must not record scope metadata: %+v", meta)
}
channels, err := store.RunChannels(ctx, "full")
if err != nil {
t.Fatal(err)
}
if len(channels) != 2 {
t.Fatalf("run channels = %v, want both channels", channels)
}
}
func TestProduceScopeCombinesWithSyncDisabledGuard(t *testing.T) {
cards := []Card{
{ID: 1, ICCID: "a", ChanKey: "217", TempKey: "sim_yd_v5"},
// Selected but excluded by the sync_enabled guard: scope must not
// override it, and the run must still complete cleanly.
{ID: 2, ICCID: "b", ChanKey: "173", TempKey: "sim_yd_v5", SyncEnabled: true},
{ID: 3, ICCID: "c", ChanKey: "189", TempKey: "sim_yd_v5"},
}
producer, store := newScopeTestProducer(t, cards)
ctx := context.Background()
if err := producer.Produce(ctx, scopeMessage("scoped", "173")); err != nil {
t.Fatal(err)
}
channels, err := store.RunChannels(ctx, "scoped")
if err != nil {
t.Fatal(err)
}
if len(channels) != 0 {
t.Fatalf("run channels = %v, want none (only selected channel is sync-disabled)", channels)
}
meta, err := store.GetRunMeta(ctx, "scoped")
if err != nil {
t.Fatal(err)
}
// The producer never enqueues work for a sync-disabled channel. The run is
// closed by the consumer's idle check, which is simulated here.
if !meta.ProducerDone || meta.ActiveCount != 0 || meta.EnqueuedCount != 0 {
t.Fatalf("empty scoped run metadata = %+v", meta)
}
if completed, err := store.CompleteRunIfIdle(ctx, "scoped"); err != nil || !completed {
t.Fatalf("empty scoped run must be closable: completed=%v err=%v", completed, err)
}
meta, err = store.GetRunMeta(ctx, "scoped")
if err != nil {
t.Fatal(err)
}
if meta.Status != "completed" {
t.Fatalf("status = %q, want completed", meta.Status)
}
}
func TestProduceScopeSelectingUnknownChannelProducesEmptyRun(t *testing.T) {
cards := []Card{
{ID: 1, ICCID: "a", ChanKey: "217", TempKey: "sim_yd_v5"},
}
producer, store := newScopeTestProducer(t, cards)
ctx := context.Background()
// An unknown channel is not an error; it simply matches no card.
if err := producer.Produce(ctx, scopeMessage("scoped", "does-not-exist")); err != nil {
t.Fatal(err)
}
meta, err := store.GetRunMeta(ctx, "scoped")
if err != nil {
t.Fatal(err)
}
if !meta.ProducerDone || meta.EnqueuedCount != 0 || meta.ActiveCount != 0 {
t.Fatalf("unknown-channel run metadata = %+v", meta)
}
if meta.ScopeChannels != 1 {
t.Fatalf("scopeChannels = %d, want the requested 1", meta.ScopeChannels)
}
if completed, err := store.CompleteRunIfIdle(ctx, "scoped"); err != nil || !completed {
t.Fatalf("unknown-channel run must be closable: completed=%v err=%v", completed, err)
}
}
func TestProduceRejectsInvalidScope(t *testing.T) {
producer, store := newScopeTestProducer(t, []Card{{ID: 1, ICCID: "a", ChanKey: "217", TempKey: "sim_yd_v5"}})
ctx := context.Background()
err := producer.Produce(ctx, scopeMessage("bad", "invalid/chan"))
if err == nil {
t.Fatal("expected invalid chanKey to be rejected")
}
// A rejected request must not leave a run behind.
if _, metaErr := store.GetRunMeta(ctx, "bad"); metaErr == nil {
t.Fatal("rejected scope created a run")
}
}
func TestProduceScopeDeduplicatesChannels(t *testing.T) {
producer, store := newScopeTestProducer(t, []Card{
{ID: 1, ICCID: "a", ChanKey: "217", TempKey: "sim_yd_v5"},
})
ctx := context.Background()
if err := producer.Produce(ctx, scopeMessage("scoped", "217", "217", "217")); err != nil {
t.Fatal(err)
}
meta, err := store.GetRunMeta(ctx, "scoped")
if err != nil {
t.Fatal(err)
}
if meta.ScopeChannels != 1 {
t.Fatalf("scopeChannels = %d, want 1 after deduplication", meta.ScopeChannels)
}
}
func TestProduceRejectsRedeliveryOfFinishedRun(t *testing.T) {
producer, store := newScopeTestProducer(t, []Card{
{ID: 1, ICCID: "a", ChanKey: "217", TempKey: "sim_yd_v5"},
})
ctx := context.Background()
if err := producer.Produce(ctx, model.SimStatusQueueStartMessage{RunID: "done"}); err != nil {
t.Fatal(err)
}
// Drain the queued work so the run reaches a terminal state.
claims, err := store.ClaimRun(ctx, "done", "217", time.Now(), time.Now().Add(time.Minute), 10)
if err != nil || len(claims) != 1 {
t.Fatalf("claims=%v err=%v", claims, err)
}
if _, err = store.FinalizeRunTasks(ctx, claims, []queue.TaskOutcome{{Success: true}}); err != nil {
t.Fatal(err)
}
if completed, err := store.CompleteRunIfIdle(ctx, "done"); err != nil || !completed {
t.Fatalf("complete run: completed=%v err=%v", completed, err)
}
// A redelivered start message must not resurrect the finished run.
err = producer.Produce(ctx, model.SimStatusQueueStartMessage{RunID: "done"})
if !errors.Is(err, ErrRunFinished) {
t.Fatalf("redelivery error = %v, want ErrRunFinished", err)
}
}