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

package com.gzzn.omms.msgexchange.domain

/**
 * ACMA-8 数据模型 / PROC_STATE 状态机（docs/flight-state.md §3.2：每消息一行，
 * 处理状态与重试结果；兼作快照重放判定 §5.1）。
 */
enum class ProcStatus { PENDING, FAILED, SUCCEEDED, SKIPPED, DEAD }

/** §9 错误分类：PROTOCOL = 整包拒绝（归属日不符等），不重试交人工。 */
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；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(),
) {
    val isTerminal: Boolean
        get() = state == ProcStatus.SUCCEEDED || state == ProcStatus.SKIPPED || state == ProcStatus.DEAD

    /** 终态皆可归档；PENDING/FAILED 不迁。 */
    val archivable: Boolean get() = isTerminal
}