chore(repo): initialize team collaboration repository
This commit is contained in:
@@ -0,0 +1,234 @@
|
||||
"""全部领域枚举。
|
||||
|
||||
放在包根、不依赖任何东西 —— models / engine / schemas / api 都从这里取，
|
||||
保证"状态"这个概念在全仓库只有一份定义。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
from enum import Enum
|
||||
|
||||
|
||||
class StrEnum(str, Enum):
|
||||
"""Python 3.9 没有 enum.StrEnum，自己来一个。"""
|
||||
|
||||
def __str__(self) -> str: # pragma: no cover - 只影响日志可读性
|
||||
return self.value
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- Run / Step
|
||||
|
||||
class RunState(StrEnum):
|
||||
QUEUED = "QUEUED" # 等资源
|
||||
PREFLIGHT = "PREFLIGHT" # 安全门禁 + 环境指纹冻结
|
||||
RUNNING = "RUNNING"
|
||||
RECOVERING = "RECOVERING" # 恢复阶梯进行中
|
||||
PAUSED = "PAUSED" # 人工暂停
|
||||
FROZEN = "FROZEN" # 冻结现场，停止一切覆盖性动作（终态）
|
||||
COMPLETED = "COMPLETED" # 终态
|
||||
ABORTED = "ABORTED" # 紧急停止（终态）
|
||||
REJECTED = "REJECTED" # 安全门禁拒绝（终态）
|
||||
|
||||
|
||||
class StepState(StrEnum):
|
||||
PENDING = "PENDING"
|
||||
DISPATCHED = "DISPATCHED" # 已租给 Agent，等确认接手
|
||||
RUNNING = "RUNNING"
|
||||
SUCCEEDED = "SUCCEEDED"
|
||||
FAILED = "FAILED"
|
||||
TIMED_OUT = "TIMED_OUT"
|
||||
SKIPPED = "SKIPPED"
|
||||
CANCELLED = "CANCELLED"
|
||||
|
||||
|
||||
class Verdict(StrEnum):
|
||||
PASS = "PASS"
|
||||
FAIL = "FAIL"
|
||||
INCONCLUSIVE = "INCONCLUSIVE" # 非幂等步骤中断后不自动重跑 → 需人工确认
|
||||
|
||||
|
||||
# ------------------------------------------------------------------ 恢复阶梯
|
||||
|
||||
class RecoveryLevel(StrEnum):
|
||||
"""方案 §7.2 的五级阶梯。顺序即升级顺序。"""
|
||||
|
||||
AGENT_SOFT = "L1_AGENT_SOFT" # Agent 优雅停止 / 软重启进程
|
||||
OS_REBOOT = "L2_OS_REBOOT" # OS 远程通道重启
|
||||
OOB_RESET = "L3_OOB_RESET" # 带外触发主板 Reset
|
||||
OOB_ATX_POWER = "L4_OOB_ATX_POWER" # 带外模拟 ATX 长按关机再开机
|
||||
OOB_AC_CYCLE = "L5_OOB_AC_CYCLE" # 整机 AC 断电 → 安全间隔 → 上电
|
||||
FREEZE = "FREEZE" # 冻结现场，不再自动恢复
|
||||
|
||||
@property
|
||||
def requires_oob(self) -> bool:
|
||||
return self in (
|
||||
RecoveryLevel.OOB_RESET,
|
||||
RecoveryLevel.OOB_ATX_POWER,
|
||||
RecoveryLevel.OOB_AC_CYCLE,
|
||||
)
|
||||
|
||||
|
||||
class RecoveryOutcome(StrEnum):
|
||||
RECOVERED = "RECOVERED"
|
||||
FAILED = "FAILED"
|
||||
ESCALATED = "ESCALATED"
|
||||
FROZEN = "FROZEN"
|
||||
|
||||
|
||||
class RecoveryTrigger(StrEnum):
|
||||
HEARTBEAT_LOST = "HEARTBEAT_LOST"
|
||||
STEP_TIMEOUT = "STEP_TIMEOUT"
|
||||
HOST_CRASH = "HOST_CRASH" # 蓝屏 / kernel panic
|
||||
DUT_NOT_ENUMERATED = "DUT_NOT_ENUMERATED"
|
||||
DATA_INTEGRITY = "DATA_INTEGRITY" # → 直接 FREEZE，不走阶梯
|
||||
MANUAL = "MANUAL"
|
||||
|
||||
|
||||
# -------------------------------------------------------------------- 资产
|
||||
|
||||
class HostStatus(StrEnum):
|
||||
ONLINE = "ONLINE"
|
||||
DEGRADED = "DEGRADED" # 心跳迟到但未判失联
|
||||
OFFLINE = "OFFLINE"
|
||||
UNKNOWN = "UNKNOWN"
|
||||
|
||||
|
||||
class DutStatus(StrEnum):
|
||||
IDLE = "IDLE"
|
||||
IN_USE = "IN_USE"
|
||||
QUARANTINED = "QUARANTINED" # 疑似坏盘，隔离待人工确认
|
||||
MISSING = "MISSING" # 探针找不到
|
||||
|
||||
|
||||
class PowerState(StrEnum):
|
||||
ON = "ON"
|
||||
OFF = "OFF"
|
||||
UNKNOWN = "UNKNOWN"
|
||||
|
||||
|
||||
class DangerLevel(StrEnum):
|
||||
NONE = "none"
|
||||
LOW = "low"
|
||||
HIGH = "high" # 需要审批记录
|
||||
|
||||
|
||||
# -------------------------------------------------------------------- 失败
|
||||
|
||||
class FailureClass(StrEnum):
|
||||
"""INFRA_FAILURE 必须与 DUT_DEFECT 分开统计 —— 见 domain-model.md。
|
||||
|
||||
把网络断了算成 SSD 缺陷，客户第一周就不信任这套系统。
|
||||
"""
|
||||
|
||||
DUT_DEFECT = "DUT_DEFECT"
|
||||
INFRA_FAILURE = "INFRA_FAILURE"
|
||||
SCRIPT_FAILURE = "SCRIPT_FAILURE"
|
||||
DATA_INTEGRITY = "DATA_INTEGRITY"
|
||||
UNKNOWN = "UNKNOWN"
|
||||
|
||||
|
||||
class IntegrityState(StrEnum):
|
||||
OK = "OK"
|
||||
MISMATCH = "MISMATCH"
|
||||
NOT_CHECKED = "NOT_CHECKED"
|
||||
|
||||
|
||||
# ------------------------------------------------------------- 事件（时间线）
|
||||
|
||||
class EventSource(StrEnum):
|
||||
CONTROL_PLANE = "control_plane"
|
||||
AGENT = "agent"
|
||||
OOB = "oob" # 带外通道 —— 主机死后唯一还在说话的
|
||||
HUMAN = "human"
|
||||
|
||||
|
||||
class Severity(StrEnum):
|
||||
DEBUG = "DEBUG"
|
||||
INFO = "INFO"
|
||||
WARNING = "WARNING"
|
||||
ERROR = "ERROR"
|
||||
CRITICAL = "CRITICAL"
|
||||
|
||||
|
||||
class EventKind(StrEnum):
|
||||
"""统一时间线的事件种类。
|
||||
|
||||
新增事件种类是常事；删除/改名不是 —— 历史事件已经落库，改名会让旧 Run 的
|
||||
时间线读不出来。只增不改。
|
||||
"""
|
||||
|
||||
# Run 生命周期
|
||||
RUN_CREATED = "RUN_CREATED"
|
||||
RUN_QUEUED = "RUN_QUEUED"
|
||||
RUN_PREFLIGHT_STARTED = "RUN_PREFLIGHT_STARTED"
|
||||
RUN_PREFLIGHT_PASSED = "RUN_PREFLIGHT_PASSED"
|
||||
RUN_REJECTED = "RUN_REJECTED"
|
||||
RUN_STARTED = "RUN_STARTED"
|
||||
RUN_PAUSED = "RUN_PAUSED"
|
||||
RUN_RESUMED = "RUN_RESUMED"
|
||||
RUN_COMPLETED = "RUN_COMPLETED"
|
||||
RUN_ABORTED = "RUN_ABORTED"
|
||||
RUN_FROZEN = "RUN_FROZEN"
|
||||
|
||||
# 循环与步骤
|
||||
LOOP_STARTED = "LOOP_STARTED"
|
||||
LOOP_COMPLETED = "LOOP_COMPLETED"
|
||||
STEP_DISPATCHED = "STEP_DISPATCHED"
|
||||
STEP_LEASE_RENEWED = "STEP_LEASE_RENEWED"
|
||||
STEP_LEASE_EXPIRED = "STEP_LEASE_EXPIRED"
|
||||
STEP_STARTED = "STEP_STARTED"
|
||||
STEP_OUTPUT = "STEP_OUTPUT"
|
||||
STEP_SUCCEEDED = "STEP_SUCCEEDED"
|
||||
STEP_FAILED = "STEP_FAILED"
|
||||
STEP_TIMED_OUT = "STEP_TIMED_OUT"
|
||||
STEP_RETRYING = "STEP_RETRYING"
|
||||
STEP_CANCELLED = "STEP_CANCELLED"
|
||||
|
||||
# 检查点
|
||||
CHECKPOINT_SAVED = "CHECKPOINT_SAVED"
|
||||
CHECKPOINT_RESUMED = "CHECKPOINT_RESUMED"
|
||||
|
||||
# 心跳与双通道观测
|
||||
HEARTBEAT_DEGRADED = "HEARTBEAT_DEGRADED"
|
||||
HEARTBEAT_LOST = "HEARTBEAT_LOST"
|
||||
HEARTBEAT_RECOVERED = "HEARTBEAT_RECOVERED"
|
||||
OOB_OBSERVATION = "OOB_OBSERVATION"
|
||||
OOB_POWER_STATE = "OOB_POWER_STATE"
|
||||
|
||||
# 恢复
|
||||
RECOVERY_STARTED = "RECOVERY_STARTED"
|
||||
RECOVERY_ESCALATED = "RECOVERY_ESCALATED"
|
||||
RECOVERY_SUCCEEDED = "RECOVERY_SUCCEEDED"
|
||||
RECOVERY_FAILED = "RECOVERY_FAILED"
|
||||
|
||||
# 设备与数据
|
||||
DUT_ENUMERATION_LOST = "DUT_ENUMERATION_LOST"
|
||||
DUT_ENUMERATION_RESTORED = "DUT_ENUMERATION_RESTORED"
|
||||
INTEGRITY_MISMATCH = "INTEGRITY_MISMATCH"
|
||||
|
||||
# 安全与资源
|
||||
SAFETY_APPROVED = "SAFETY_APPROVED"
|
||||
SAFETY_REJECTED = "SAFETY_REJECTED"
|
||||
LOCK_ACQUIRED = "LOCK_ACQUIRED"
|
||||
LOCK_RELEASED = "LOCK_RELEASED"
|
||||
|
||||
# 人与产物
|
||||
HUMAN_TOUCH = "HUMAN_TOUCH" # 每一次人工介入都记 —— UCR 的分母来源
|
||||
FAILURE_SIGNED = "FAILURE_SIGNED"
|
||||
EVIDENCE_BUNDLED = "EVIDENCE_BUNDLED"
|
||||
|
||||
|
||||
class StepType(StrEnum):
|
||||
COMMAND = "command"
|
||||
DEVICE_CHECK = "device_check"
|
||||
WAIT = "wait"
|
||||
LOOP = "loop"
|
||||
PRECHECK = "precheck"
|
||||
REPORT = "report"
|
||||
|
||||
|
||||
class OnFail(StrEnum):
|
||||
RETRY = "retry"
|
||||
FAIL_RUN = "fail_run"
|
||||
CONTINUE = "continue"
|
||||
FREEZE = "freeze"
|
||||
RECOVER = "recover"
|
||||
Reference in New Issue
Block a user