task_run

{“what”:“Surrogate key; unique integer per run.”,“why”:“Without it, runs cannot be referenced individually, breaking updates and joins.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:28.550424578+00:00”}

{“what”:“Categorizes the task kind; values are application-defined.”,“why”:“Without it, you cannot filter runs by task kind, so per-type monitoring and retries fail.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:28.622817507+00:00”}

{“what”:“Type of entity the run operates on; values are application-defined.”,“why”:“Without it, entity_id is meaningless, so you cannot link a run to its subject.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:28.849629902+00:00”}

{“what”:“Integer ID of the entity this run targets, paired with entity_type.”,“why”:“Without it, you cannot identify which specific entity the run processed, breaking per-entity history.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:28.968932005+00:00”}

{“what”:“Timestamp when the run started; timezone-aware.”,“why”:“Without it, run duration and ordering are unknown, so performance analysis fails.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:29.027171075+00:00”}

{“what”:“Timestamp when the run finished; null if still running or failed to end.”,“why”:“Without it, you cannot compute duration or detect stuck runs.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:29.049536397+00:00”}

{“what”:“State of the run; values are application-defined.”,“why”:“Without it, you cannot know if a run succeeded or failed, so error handling and retries are impossible.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:29.073970175+00:00”}

{“what”:“UUID of the process that executed the run; ‘unknown’ if not set.”,“why”:“Without it, you cannot correlate a run with a specific process instance, making distributed debugging hard.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:29.091323092+00:00”}

{“what”:“Timestamp of the last update to this run’s row.”,“why”:“Without it, you cannot detect stale or recently modified runs, so monitoring and cleanup fail.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:29.107102037+00:00”}