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

package com.gzzn.omms.msgexchange.domain

import java.time.Instant

/**
 * 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）。
 *
 * 回填事实（message-lifecycle.md §5.2/§11）与处理事实同体同行：终态与回填意图
 * 由同一条 UPDATE 落下，因此不存在"业务已提交、回填待办未记"的崩溃窗口。
 */
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: Instant? = null,
    val errorClass: ErrorClass? = null,
    val lastError: String? = null,
    /** 信箱 CMINMSGS_DATE_RECEIVED：§5.2 超期补写的 R 判据与 OPS-2「最老未处理信龄」锚点。 */
    val receivedAt: Instant? = null,
    /** 非空 = 已确认信箱行持有处理标记（回填完成）。 */
    val backfillAt: Instant? = null,
    /** 非空 = 待回填；终态事务内登记为 now，失败按退避推后。 */
    val backfillNextAt: Instant? = null,
    val backfillAttempts: Int = 0,
    val backfillError: String? = null,
    val updatedAt: Instant = Instant.now(),
)