chore: 并入 iotlcm-worker-svr 历史到 worker-svr/（原提交 96f0f4e）

worker-svr/internal/fullsync/contract/status.go

@@ -0,0 +1,137 @@
+package contract
+
+type RunStatus string
+
+const (
+	RunProducing             RunStatus = "producing"
+	RunRunning               RunStatus = "running"
+	RunCompleted             RunStatus = "completed"
+	RunCompletedWithFailures RunStatus = "completed_with_failures"
+)
+
+func (s RunStatus) Valid() bool {
+	return s == RunProducing || s == RunRunning || s.Terminal()
+}
+
+func (s RunStatus) Terminal() bool { return s == RunCompleted || s == RunCompletedWithFailures }
+
+type SyncType string
+
+const (
+	SyncNormal SyncType = "normal"
+	SyncReplay SyncType = "replay"
+)
+
+func (s SyncType) Valid() bool { return s == SyncNormal || s == SyncReplay }
+
+type SyncKind string
+
+const (
+	SyncKindTrafficUsage        SyncKind = "traffic_usage"
+	SyncKindSimStatus           SyncKind = "sim_status"
+	SyncKindTrafficUsageDaily   SyncKind = "traffic_usage_daily"
+	SyncKindTrafficUsageMonthly SyncKind = "traffic_usage_monthly"
+	SyncKindImei                SyncKind = "imei"
+)
+
+func (s SyncKind) Valid() bool {
+	return s == SyncKindTrafficUsage || s == SyncKindSimStatus || s == SyncKindTrafficUsageDaily || s == SyncKindTrafficUsageMonthly || s == SyncKindImei
+}
+
+func SyncKindForOperation(operation string) SyncKind {
+	switch operation {
+	case "current_month_usage_full_sync":
+		return SyncKindTrafficUsage
+	case "sim_status_queue_full_sync":
+		return SyncKindSimStatus
+	case "previous_day_usage_full_sync":
+		return SyncKindTrafficUsageDaily
+	case "previous_month_usage_full_sync":
+		return SyncKindTrafficUsageMonthly
+	case "imei_full_sync":
+		return SyncKindImei
+	default:
+		return ""
+	}
+}
+
+type ArchiveStatus string
+
+const (
+	ArchiveDisabled   ArchiveStatus = "disabled"
+	ArchivePending    ArchiveStatus = "pending"
+	ArchiveProcessing ArchiveStatus = "processing"
+	ArchiveSucceeded  ArchiveStatus = "succeeded"
+	ArchiveFailed     ArchiveStatus = "failed"
+)
+
+func (s ArchiveStatus) Valid() bool {
+	switch s {
+	case ArchiveDisabled, ArchivePending, ArchiveProcessing, ArchiveSucceeded, ArchiveFailed:
+		return true
+	}
+	return false
+}
+
+// ReplayDisposition describes a source run, not an individual replay action.
+type ReplayDisposition string
+
+const (
+	ReplayNone           ReplayDisposition = "none"
+	ReplayPending        ReplayDisposition = "pending"
+	ReplayProcessing     ReplayDisposition = "processing"
+	ReplayCompleted      ReplayDisposition = "completed"
+	ReplayNeedsAttention ReplayDisposition = "needs_attention"
+)
+
+func (s ReplayDisposition) Valid() bool {
+	switch s {
+	case ReplayNone, ReplayPending, ReplayProcessing, ReplayCompleted, ReplayNeedsAttention:
+		return true
+	}
+	return false
+}
+
+type ActionStatus string
+
+const (
+	ActionAccepted       ActionStatus = "accepted"
+	ActionProcessing     ActionStatus = "processing"
+	ActionCleanupPending ActionStatus = "cleanup_pending"
+	ActionReceiptPending ActionStatus = "receipt_pending"
+	ActionCompleted      ActionStatus = "completed"
+	ActionNeedsAttention ActionStatus = "needs_attention"
+)
+
+func (s ActionStatus) Valid() bool {
+	switch s {
+	case ActionAccepted, ActionProcessing, ActionCleanupPending, ActionReceiptPending, ActionCompleted, ActionNeedsAttention:
+		return true
+	}
+	return false
+}
+
+// Terminal means automatic work has stopped; needs_attention may be resumed
+// only by an explicit recovery policy, never by assuming it succeeded.
+func (s ActionStatus) Terminal() bool { return s == ActionCompleted || s == ActionNeedsAttention }
+
+type RunSource string
+
+const (
+	SourceLive    RunSource = "live"
+	SourceArchive RunSource = "archive"
+)
+
+func (s RunSource) Valid() bool { return s == SourceLive || s == SourceArchive }
+
+// These values are already persisted by the queue protocol.
+const (
+	TaskQueued              = "queued"
+	TaskClaimed             = "claimed"
+	TaskWaitingNextRound    = "waiting_next_round"
+	TaskSucceeded           = "succeeded"
+	TaskCovered             = "covered"
+	TaskFailedPendingReview = "failed_pending_review"
+	TaskChannelBlocked      = "channel_blocked"
+	ReviewPending           = "pending"
+)