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

package com.gzzn.omms.msgexchange.domain

/**
 * ACMA-8 数据模型 / PROC_STATE 状态机（六迁移表）。
 */
enum class ProcStatus { PENDING, FAILED, SUCCEEDED, SKIPPED, DEAD }

enum class ErrorClass { MALFORMED, CODEC_ERROR, EXHAUSTED, INFRA, UNSUPPORTED }

data class ProcState(
    val cminmsgsId: Long,
    val state: ProcStatus,
    val identityKey: String? = null,     // decode 后首次绑定；FAILED 重试不重绑（I3）
    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

    /** 终态皆可归档（矩阵 #12：SUCCEEDED ∪ SKIPPED ∪ DEAD）；PENDING/FAILED 不迁。 */
    val archivable: Boolean get() = isTerminal
}