Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/KingPsychopath/oooc-fete-finder/llms.txt

Use this file to discover all available pages before exploring further.

The admin console is split into focused modules for efficient event management. This guide covers the standard workflows you’ll use daily.

​
Admin areas

The admin panel provides five main areas accessible at /admin:
  • Overview (/admin) - Quick launch dashboard and system status
  • Operations (/admin/operations) - Runtime status, data store controls, session management, and recovery
  • Content (/admin/content) - Event sheet editor, submission moderation, and banner settings
  • Placements (/admin/placements) - Paid orders queue and spotlight/promoted scheduling
  • Insights (/admin/insights) - Engagement analytics and audience exports

​
Standard publish flow

This is your primary workflow for updating live events.
1

Open the Content area

Navigate to /admin/content to access the Event Sheet Editor
2

Update events

Edit event data in the spreadsheet interface. Changes autosave to Postgres every 850ms
3

Review submissions (if needed)

Check the Event Submissions section for new community-submitted events awaiting moderation
4

Update banner (optional)

Modify the sliding banner settings if you need to highlight announcements
5

Create a safety snapshot

Switch to /admin/operations and create a backup using Backup Now in Event Store Controls
6

Publish changes

Click Save and Revalidate Homepage to push your changes live
7

Verify deployment

Check the Live Runtime Snapshot to confirm your changes are reflected on the live site
The Event Sheet Editor autosaves changes to Postgres, but homepage revalidation only happens when you click Save and Revalidate Homepage. This separation prevents accidental publishes.

​
Placements flow

Manage paid promotions and spotlight features for partner events.
1

Open Placements

Navigate to /admin/placements to access the placement scheduler
2

Review paid orders

Check the Paid Orders Queue for new partner promotion requests
3

Fulfill orders

Use the Spotlight & Promoted Scheduler to assign events to paid placement slots
4

Confirm scheduling

Verify queue status and timing in the scheduler timeline
5

Share partner stats (optional)

Generate and share engagement stats links with partners when needed
Spotlight placements have a concurrent slot limit (default: 3 events), while Promoted placements support unlimited concurrent listings.

​
Insights flow

Track event engagement and export audience segments.
1

Open Insights dashboard

Navigate to /admin/insights to view analytics
2

Review engagement metrics

Use Event Engagement Stats to inspect:
  • Views (click events)
  • Outbound clicks (outbound_click to event URLs)
  • Calendar saves (calendar_sync interactions)
3

Analyze discovery patterns

Review top events, discovery metrics, and conversion rates
4

Export segments

Download audience CSV segments filtered by genre preferences, search behavior, or filter usage
“Saved this” in the admin interface refers to calendar sync interactions tracked as aggregate engagement signals, not a user-visible personal saved events list.

​
Rollback flow

Revert to a previous version if something goes wrong.
1

Open Operations

Navigate to /admin/operations immediately
2

Select backup

Choose Latest Backup or a specific snapshot from Recent Backups
3

Restore data

Click the restore button to revert the event data store
4

Revalidate

Run Save and Revalidate Homepage to push the restored data live
5

Confirm restoration

Check the Live Runtime Snapshot to verify the rollback succeeded

​
Health checks

Use these endpoints to verify system status: 
GET /api/admin/health
GET /api/admin/data-store/status
GET /api/admin/postgres/kv
GET /api/admin/tokens/sessions
These endpoints provide real-time status for:
  • Admin service health
  • Data store connectivity
  • Postgres key-value store
  • Active admin sessions

​
Common issues

​
Save succeeds but site looks stale

Run Save and Revalidate Homepage again and verify the runtime source shows your latest changes.

​
Spotlight/promoted schedule not applying

Verify event keys match exactly in both the Event Sheet Editor and the placement queue. Check queue status in the Placements area.

​
Analytics panel empty

Confirm Postgres connectivity in Operations and verify track routes are reachable from the client.

​
Submission endpoint closed

Check Event Submissions settings in the Content area. Toggle the submission endpoint status if needed.

​
Best practices

  • Always create backups before major content updates
  • Test placements in upcoming slots before activating now
  • Review spam signals on submissions before accepting
  • Export segments regularly to track audience growth
  • Monitor conversion rates to optimize event selection and placement timing

Build docs developers (and LLMs) love

Get started for freeTalk to us