Struct JobDto 

pub struct JobDto {

    pub uuid: String,
    pub kind: String,
    pub status: String,
    pub progress_current: i32,
    pub progress_total: Option<i32>,
    pub message: String,
    pub actor: String,
    pub result: Option<Value>,
    pub created_at: String,
    pub updated_at: String,
    pub duration_seconds: i64,
    pub seconds_since_update: i64,
    pub health: String,
}

A job as exposed over the API/UI (uuid handle, no internal serial id).

Fields

uuid: String

External handle.

kind: String

Operation kind.

status: String

Lifecycle status.

progress_current: i32

Units of work completed.

progress_total: Option<i32>

Total units, when known.

message: String

Current step, or the error on failure.

actor: String

Who started it.

result: Option<Value>

Terminal result payload.

created_at: String

Created timestamp.

updated_at: String

Last-updated timestamp.

duration_seconds: i64

Seconds of activity (updated_at - created_at): a finished job’s total runtime, or a running one’s time from start to its last progress update — observability on duration.

seconds_since_update: i64

Seconds since the last progress update (now - updated_at), measured against the DB clock. For a running job this is its heartbeat age: it keeps climbing while the job makes no progress, so a large value flags a stalled job (the W-4 residual — a hung body Rust cannot force-cancel — surfaced transparently rather than auto-killed). Terminal jobs report their age-since-completion. 0 when the DB clock is unavailable (degrade to “no age”, never bogus).

health: String

Normalized health derived from status: ok (succeeded), failed, interrupted, pending (queued), or running — the at-a-glance state for the fleet-wide pending check.

Implementations

impl JobDto

pub fn at(job: Job, now: Option<NaiveDateTime>) -> Self

Builds the DTO, computing the heartbeat age (seconds_since_update) against now — the DB clock from jobs::db_now. None (probe failed, or a just-spawned job where the age is trivially ~0) yields seconds_since_update = 0.

Trait Implementations

impl Debug for JobDto

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

Formats the value using the given formatter.

impl From<Job> for JobDto

fn from(job: Job) -> Self

Used by the spawn-return paths, where the job was created moments ago so its heartbeat age is trivially ~0; the polling list/get handlers use JobDto::at with the live DB clock instead.

impl JsonSchema for JobDto

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for JobDto

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.