2.1 KiB
Burst Events
A report with at least three occurrences is a Burst Event. event_kind, is_burst, bangs_per_15_minutes, and burst_intensity are derived properties on both PendingEvent and Event; they are never stored separately. One or two occurrences are ordinary reports.
captured_at is the reported occurrence time for a manual report. PendingEvent created_at is its actual submission time; approval copies that value into Event submitted_at, while Event approved_at remains the approval time. Older Events have an unknown submitted_at because their original submission time cannot be reconstructed. occurrence_time_approximate records uncertainty about the reported time. No individual bang times are inferred from an aggregate report.
observation_duration_minutes holds a window only when the reporter explicitly accepts an estimate, or when a future source provides a measured window. observation_duration_kind distinguishes estimated from measured; a blank kind or duration means intensity is unavailable. The quick form suggests 15 minutes and asks the reporter to accept that estimate. Existing records migrate with an unknown duration, preserving their counts without inventing an intensity.
The normalised rate is occurrences × 15 / observation_duration_minutes. Provisional presentation bands live in fireworks_detect/bursts.py: light below 5, moderate from 5 to below 10, intense from 10 per 15 minutes. This describes frequency, not loudness. The map event JSON exposes the count, event kind, duration, duration kind, rate, intensity, and approximate-time flag for future timeline work. No timeline is rendered in this pass.
Quick reports remain Pending until moderated. The browser can enhance the form, while the POST endpoint also accepts an ordinary server-rendered form submission with no microphone, classifier, or JavaScript. A reporter can correct the count and estimated duration before moderation through a session-scoped receipt form; each correction creates a ManualReportRevision. Corrections do not change the original occurrence or submission time.