msgexchange-v2/src/main/kotlin/com/gzzn/omms/msgexchange/domain/ProcState.kt

package com.gzzn.omms.msgexchange.domain

/**
 * PROC_STATE 处理伴生状态（docs/design.md §2.1/§2.3）：每消息一行，
 * MSG_ID = 信箱 ID 主键防重复入队；IDENTITY_KEY 唯一约束防业务重复；
 * 处理状态机与错误分类同设计文档 §2.3。SUCCEEDED 终态兼作 SCHD 快照
 * 重放判定（docs/flight-state.md §4 步骤 / design.md §4.1）。
 */
enum class ProcStatus { PENDING, FAILED, SUCCEEDED, SKIPPED, DEAD }

/** 错误分类（design.md §2.3）：MALFORMED/PROTOCOL 直接 DEAD 不重试；其余退避重试。 */
enum class ErrorClass { MALFORMED, PROTOCOL, CODEC_ERROR, EXHAUSTED, INFRA, UNSUPPORTED }

data class ProcState(
    val msgId: Long,
    val state: ProcStatus,
    val identityKey: String? = null,     // SNDR|TYPE|STYP|SEQN（design.md §2.2）；decode 后首次绑定，FAILED 重试不重绑
    val attempts: Int = 0,
    val nextAttemptAt: java.time.Instant? = null,
    val errorClass: ErrorClass? = null,
    val lastError: String? = null,
    val updatedAt: java.time.Instant = java.time.Instant.now(),
)