placement_flags


Description

{“what”:“A proposed category change for an item identified by source_path and device, with confidence and resolution status.”,“why”:“Tracks proposed category moves so they can be reviewed, approved, and applied; without it, proposed changes are unknown and cannot be acted on.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.089123565+00:00”}

Columns

Column Type Size Nulls Auto Default Children Parents Comments
id int8 19 √ null

{“what”:“Unique numeric ID for this flag; primary key.”,“why”:“Without it, rows cannot be uniquely referenced for updates or joins.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.119872641+00:00”}

source_path text 2147483647 null

{“what”:“Full path of the item being flagged, e.g., /data/file.txt.”,“why”:“Identifies which item the flag applies to; without it, the flag cannot be associated with a specific file or object.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.132758038+00:00”}

device text 2147483647 null

{“what”:“Device or host name where the source_path resides.”,“why”:“Disambiguates items with the same path on different devices; without it, the source is ambiguous.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.149386866+00:00”}

current_category text 2147483647 null

{“what”:“Category the item currently belongs to, e.g., ‘documents’.”,“why”:“Provides the baseline for the proposed change; without it, the change cannot be evaluated.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.160762240+00:00”}

proposed_category text 2147483647 null

{“what”:“Category the item is proposed to move to.”,“why”:“Defines the target category; without it, the intended change is unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.170270929+00:00”}

proposed_destination text 2147483647 null

{“what”:“Full path or location where the item would be moved to.”,“why”:“Specifies the concrete move target; without it, the move cannot be executed.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.182839400+00:00”}

confidence float8 17,17 null

{“what”:“Probability (0-1) that the proposed category is correct.”,“why”:“Used to prioritize or filter flags; without it, all flags are equally weighted and low-confidence moves cannot be identified.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.194035777+00:00”}

reason text 2147483647 ''::text

{“what”:“Free-text explanation for the proposed change, empty if none.”,“why”:“Provides context for reviewers; without it, the rationale for the flag is unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.209738604+00:00”}

status text 2147483647 'pending'::text

{“what”:“Workflow state, e.g., ‘pending’, ‘approved’, ‘rejected’.”,“why”:“Tracks whether the flag is awaiting action or resolved; without it, unresolved flags cannot be distinguished from processed ones.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.221782701+00:00”}

created_at timestamptz 35,6 now()

{“what”:“Timestamp with time zone when the flag was created.”,“why”:“Records when the proposal was made; without it, the age of flags cannot be determined for prioritization.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.245266285+00:00”}

resolved_at timestamptz 35,6 √ null

{“what”:“Timestamp with time zone when the flag was resolved, null if pending.”,“why”:“Indicates when the flag was processed; without it, resolution time and pending duration are unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:13:13.265140158+00:00”}

Indexes

Constraint Name Type Sort Column(s)
placement_flags_pkey Primary key Asc id
idx_flags_device Performance Asc device
idx_flags_status Performance Asc status
placement_flags_source_path_device_key Must be unique Asc/Asc source_path + device

Relationships