notification_subscription


Description

{“what”:“A subscription that ties a notification to a schedule or event for delivery.”,“why”:“Without it, notifications have no defined delivery timing or event trigger.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.569611256+00:00”}

Columns

Column Type Size Nulls Auto Default Children Parents Comments
id int4 10 √ null

{“what”:“Unique integer identifier for the subscription row.”,“why”:“Needed as primary key for stable references and updates.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.703000477+00:00”}

notification_id int4 10 null
notification.id fk_notification_subscription_notification_id C

{“what”:“Foreign key to the notification being subscribed to.”,“why”:“Identifies which notification this subscription applies to; without it the subscription is meaningless.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.718206272+00:00”}

type varchar 64 null

{“what”:“Subscription kind, e.g. ‘cron’ or ‘event’, selecting the schedule field.”,“why”:“Determines whether cron_schedule or event_name is used; without it the subscription’s trigger is ambiguous.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.732411839+00:00”}

event_name varchar 64 √ null

{“what”:“Name of the event that triggers this subscription when type is ‘event’.”,“why”:“Without it, event-based subscriptions have no trigger condition.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.793249888+00:00”}

created_at timestamptz 35,6 null

{“what”:“Timestamp when the subscription was created, in UTC.”,“why”:“Enables audit and ordering of subscriptions; without it we cannot know when it was set up.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.814438691+00:00”}

cron_schedule varchar 128 √ null

{“what”:“Cron expression defining the recurring schedule when type is ‘cron’.”,“why”:“Without it, cron-based subscriptions have no schedule to execute on.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.925628509+00:00”}

ui_display_type varchar 32 √ null

{“what”:“UI presentation hint for the subscription, e.g. ‘banner’ or ‘email’.”,“why”:“Without it, the frontend cannot decide how to render the subscription’s notifications.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:09:41.947334262+00:00”}

Indexes

Constraint Name Type Sort Column(s)
notification_subscription_pkey Primary key Asc id
idx_notification_subscription_notification_id Performance Asc notification_id

Relationships