Struct TuneMvActuationRow 

pub struct TuneMvActuationRow {

    pub id: i64,
    pub run_id: i64,
    pub sequence: i64,
    pub kind: MvActuationKind,
    pub commanded_at: DateTime<Utc>,
    pub target_mv: f32,
    pub previous_commanded_mv: Option<f32>,
    pub tolerance: f32,
    pub confirmation_due_at: DateTime<Utc>,
    pub last_checked_at: Option<DateTime<Utc>>,
    pub readback_mv: Option<f32>,
    pub readback_quality: Option<SampleQuality>,
    pub attempt_count: i64,
    pub status: MvActuationStatus,
    pub detail: Option<String>,
}

One row of tune_mv_actuations: durable evidence for an accepted OPC DA MV write.

These rows are separate from TuneSampleRow, whose MV remains the engine’s commanded series for trend/export compatibility. readback_mv and readback_quality are the most recent physical observation made by the verifier; attempt_count counts every persisted observation, including attempts where no numeric value or trustworthy quality could be obtained.

Fields

id: i64

run_id: i64

sequence: i64

Monotonic command order within one run. Unique together with run_id.

kind: MvActuationKind

commanded_at: DateTime<Utc>

UTC projection of the instant at which the driver accepted the MV write.

target_mv: f32

previous_commanded_mv: Option<f32>

tolerance: f32

Exact absolute target/readback tolerance applied to this command.

confirmation_due_at: DateTime<Utc>

Exact time at which the command must have terminal evidence under the active policy.

last_checked_at: Option<DateTime<Utc>>

readback_mv: Option<f32>

readback_quality: Option<SampleQuality>

attempt_count: i64

status: MvActuationStatus

detail: Option<String>

Operator-facing explanation, primarily for failed/unverified/superseded rows.

Implementations

impl TuneMvActuationRow

pub async fn insert_pending( pool: &SqlitePool, run_id: i64, new: NewTuneMvActuation, ) -> DbResult<TuneMvActuationRow>

Inserts one accepted command in MvActuationStatus::Pending state. Observation fields are empty and attempt_count is zero until Self::record_observation or Self::record_final_observation is called.

pub async fn record_observation( pool: &SqlitePool, id: i64, checked_at: DateTime<Utc>, readback_mv: Option<f32>, readback_quality: Option<SampleQuality>, ) -> DbResult<TuneMvActuationRow>

Records the latest verification attempt while leaving the command pending. Both observation values are optional so a caller can still persist that an attempted check produced no usable numeric value and/or no quality classification.

pub async fn record_final_observation( pool: &SqlitePool, id: i64, checked_at: DateTime<Utc>, readback_mv: Option<f32>, readback_quality: Option<SampleQuality>, status: MvActuationStatus, detail: Option<&str>, ) -> DbResult<TuneMvActuationRow>

Atomically records the final observation and terminal status. This is preferable to separate Self::record_observation and Self::finalize calls when one read conclusively confirms or rejects the target, because readers can never observe that final evidence while the row still misleadingly says pending.

pub async fn finalize( pool: &SqlitePool, id: i64, status: MvActuationStatus, detail: Option<&str>, ) -> DbResult<TuneMvActuationRow>

Finalizes a pending command without inventing an observation. Used for terminal paths such as interruption (Unverified) or deliberate handoff (Superseded).

pub async fn finalize_pending_for_run( pool: &SqlitePool, run_id: i64, status: MvActuationStatus, detail: Option<&str>, ) -> DbResult<u64>

Finalizes every still-pending command belonging to run_id, returning the number of rows changed. Already-terminal rows and rows for other runs are never modified. This is the terminal-path backstop that prevents a completed/failed/aborted run from retaining misleading pending audit records.

pub async fn list_for_run( pool: &SqlitePool, run_id: i64, ) -> DbResult<Vec<TuneMvActuationRow>>

Lists every accepted MV command for run_id in command-sequence order.

Trait Implementations

impl Clone for TuneMvActuationRow

fn clone(&self) -> TuneMvActuationRow

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TuneMvActuationRow

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for TuneMvActuationRow

fn eq(&self, other: &TuneMvActuationRow) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TuneMvActuationRow