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

2026-11-02 13:28:03 +08:00
parent 6de2e503cc 96f0f4eacd
commit 2923c78755
422 changed files with 80993 additions and 0 deletions
@@ -0,0 +1,46 @@
+package contract
+
+import "time"
+
+const ArchiveSchemaVersion = 1
+
+// ArchiveReceipt identifies a durably published archive object. Path is a
+// storage-owned reference, never a client-supplied destination. Checksum is
+// lowercase hex SHA-256 of the final stored bytes; version is the schema.
+type ArchiveReceipt struct {
+	Version    int       `json:"version"`
+	Path       string    `json:"path"`
+	Checksum   string    `json:"checksum"`
+	ArchivedAt time.Time `json:"archivedAt"`
+}
+
+func (r ArchiveReceipt) Validate() error {
+	if r.Version < 1 || r.Path == "" || r.ArchivedAt.IsZero() || len(r.Checksum) != 64 {
+		return invalid("incomplete archive receipt")
+	}
+	for _, c := range r.Checksum {
+		if !((c >= '0' && c <= '9') || (c >= 'a' && c <= 'f')) {
+			return invalid("archive checksum must be lowercase SHA-256 hex")
+		}
+	}
+	return nil
+}
+
+// RunArchive is summary-only: never embed per-card task/failure records.
+type RunArchive struct {
+	Version int          `json:"version"`
+	Run     RunMeta      `json:"run"`
+	Rounds  []RoundStats `json:"rounds"`
+}
+
+// ArchiveWork.Version is an opaque concurrency token for registration; it is
+// distinct from the archive schema version. Work discovery must survive restarts.
+type ArchiveWork struct {
+	RunID   string `json:"runId"`
+	Version string `json:"-"`
+}
+
+type ArchiveWorkPage struct {
+	Items      []ArchiveWork `json:"items"`
+	NextCursor Cursor        `json:"nextCursor"`
+}