MiFaZhan
2bec257289
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），属既有缺陷，本仓未引入亦未修复。
130 lines
4.4 KiB
Go
130 lines
4.4 KiB
Go
package contract
|
|
|
|
import (
|
|
"time"
|
|
"unicode/utf8"
|
|
)
|
|
|
|
// Cursor is an opaque repository-issued continuation token. Clients must not
|
|
// parse, increment, or reuse it for another run/filter. Empty starts a scan;
|
|
// an empty nextCursor ends it. An empty page with a cursor is not end-of-scan.
|
|
// Repositories validate token contents and query binding with ErrInvalidArgument.
|
|
type Cursor string
|
|
|
|
const (
|
|
DefaultPageLimit = 100
|
|
MaxPageLimit = 500
|
|
)
|
|
|
|
type PageRequest struct {
|
|
Cursor Cursor `json:"cursor,omitempty"`
|
|
Limit int `json:"limit,omitempty"`
|
|
}
|
|
|
|
// Normalized must be called at both HTTP and repository boundaries. Limits
|
|
// outside the bounds are rejected, not silently truncated.
|
|
func (p PageRequest) Normalized() (PageRequest, error) {
|
|
if p.Limit == 0 {
|
|
p.Limit = DefaultPageLimit
|
|
}
|
|
if p.Limit < 1 || p.Limit > MaxPageLimit {
|
|
return PageRequest{}, invalid("limit must be between 1 and %d", MaxPageLimit)
|
|
}
|
|
return p, nil
|
|
}
|
|
|
|
// Failure is the bounded public projection, not the replay payload. Legacy
|
|
// free-form failureType/message fields remain available in FailureRecord.
|
|
type Failure struct {
|
|
TaskID string `json:"taskId"`
|
|
CardID int64 `json:"cardId"`
|
|
ErrorCategory ErrorCategory `json:"errorCategory"`
|
|
ErrorMessage string `json:"errorMessage"`
|
|
FailedAt time.Time `json:"failedAt"`
|
|
Round int `json:"round"`
|
|
}
|
|
|
|
func (f Failure) Validate() error {
|
|
if f.TaskID == "" || f.Round < 0 || len(f.ErrorMessage) > MaxErrorMessageBytes || !utf8.ValidString(f.ErrorMessage) {
|
|
return invalid("invalid failure summary")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
type FailurePage struct {
|
|
Items []Failure `json:"items"`
|
|
NextCursor Cursor `json:"nextCursor"`
|
|
}
|
|
|
|
// FailureRecord preserves the existing persisted payload without changing
|
|
// review semantics or discarding fields needed to reconstruct replay tasks.
|
|
type FailureRecord struct {
|
|
Version int `json:"version"`
|
|
TaskID string `json:"taskId"`
|
|
OriginalRunID string `json:"originalRunId"`
|
|
LatestRunID string `json:"latestRunId"`
|
|
QueryMonth string `json:"queryMonth"`
|
|
Operation string `json:"operation"`
|
|
CardID int64 `json:"cardId"`
|
|
ICCID string `json:"iccid"`
|
|
MSISDN string `json:"msisdn"`
|
|
IMSI string `json:"imsi"`
|
|
ChanKey string `json:"chanKey"`
|
|
TempKey string `json:"tempKey"`
|
|
// PackageCode is additive; older failure records decode it as empty.
|
|
PackageCode string `json:"packageCode,omitempty"`
|
|
Carrier string `json:"carrier"`
|
|
FailureType string `json:"failureType"`
|
|
Round int `json:"round"`
|
|
Attempts int `json:"attempts"`
|
|
Code int `json:"code"`
|
|
ErrCode string `json:"errCode"`
|
|
Message string `json:"message"`
|
|
ReviewStatus string `json:"reviewStatus"`
|
|
ReviewRemark string `json:"reviewRemark"`
|
|
ReviewedBy string `json:"reviewedBy"`
|
|
ReviewedAt string `json:"reviewedAt"`
|
|
RetryCycle int `json:"retryCycle"`
|
|
ReplayRunID string `json:"replayRunId"`
|
|
FirstFailedAt time.Time `json:"firstFailedAt"`
|
|
LastFailedAt time.Time `json:"lastFailedAt"`
|
|
}
|
|
|
|
func (f FailureRecord) Summary() Failure {
|
|
return Failure{
|
|
TaskID: f.TaskID, CardID: f.CardID, ErrorCategory: NormalizeErrorCategory(f.FailureType),
|
|
ErrorMessage: BoundedErrorMessage(f.Message), FailedAt: f.LastFailedAt, Round: f.Round,
|
|
}
|
|
}
|
|
|
|
// FailureEntry carries an opaque version for conditional source cleanup. It
|
|
// must identify the precise record read, not just its reusable task ID.
|
|
type FailureEntry struct {
|
|
Record FailureRecord `json:"record"`
|
|
Version string `json:"-"`
|
|
}
|
|
|
|
type FailureRecordPage struct {
|
|
Items []FailureEntry `json:"items"`
|
|
NextCursor Cursor `json:"nextCursor"`
|
|
}
|
|
|
|
// Task keeps the existing queue member serialization. The scheduling score
|
|
// must never be part of the JSON member or producer retries lose idempotency.
|
|
type Task struct {
|
|
TaskID string `json:"taskId"`
|
|
RunID string `json:"runId"`
|
|
Operation string `json:"operation"`
|
|
QueryMonth string `json:"queryMonth"`
|
|
ChanKey string `json:"chanKey"`
|
|
TempKey string `json:"tempKey"`
|
|
Operator int `json:"operator,omitempty"`
|
|
CardID int64 `json:"cardId"`
|
|
ICCID string `json:"iccid"`
|
|
MSISDN string `json:"msisdn"`
|
|
IMSI string `json:"imsi"`
|
|
// PackageCode is additive; older members decode it as empty.
|
|
PackageCode string `json:"packageCode,omitempty"`
|
|
NextExecuteAt int64 `json:"-"`
|
|
}
|