Real-Time Events
The Real-Time Events Feed powers the "What's Happening Now" experience — surfacing bars, beaches, festivals, and local gatherings in real time.
Overview
Events are ingested from:
- Local partner venues submitting via the Admin console
- External data sources processed by ingestion agents
- Manual curator entries via the Admin CMS
Key Concepts
| Concept | Description |
|---|---|
| Event | A scheduled or live activity at a location |
| Venue | The physical place hosting the event |
| Category | e.g. Music, Food & Drink, Cultural, Sports |
| Status | upcoming, live, ended |
Ingestion Pipeline
Events submitted via external sources (n8n, partner feeds) are staged for review before they appear in the public feed. Staged items are visible only inside the admin portal until a curator approves and promotes them.
| Stage | Visible to public? | Notes |
|---|---|---|
pending | No | Awaiting curator review |
approved | No | Approved but not yet promoted to a canon record |
merged | Yes | Promoted — a canonical Event record now exists |
rejected | No | Removed from the review queue |
Sources configured with approval_mode = auto skip the pending step — items are approved on submission, but a curator must still promote them to make them public.
See Admin Ingestion for the submission and review workflow details.
User Stories
- As a tourist, I want to see what events are happening near me right now.
- As a local, I want to browse upcoming events this weekend.
- As a venue owner, I want to submit my event and have it appear on the feed.
API
→ See Events API Reference for endpoint details.