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 |