Runners of Rome / API Route Atlas

Flow and Data Map

Dedicated operational view for endpoint journeys, role-specific flows, and storage impact. Every step includes explicit side effects.

Route handlers

30

Mutation routes

21

Tracked models

11

End-user journey

Discover Event + Register

Find available events, submit registration, and receive follow-up signals.

Highlight side effects:
  1. 01GET/api/v1/events

    Load visible event list

    Returns ready/hidden events and current actor registration snapshot.

    Side effects

    • DB readReads Event rows filtered by membership tier and date window.
    • DB readReads Registration rows for my status per event.

    Models touched

  2. 02POST/api/v1/events/[eventId]/registrations

    Submit self registration

    Validates eligibility, assigns status (pending/accepted/waiting_list), and persists request.

    Side effects

    • DB writeCreates or updates Registration with chosen pace and source=self.
    • DB writeOptionally updates User.defaultPaceCode from request payload.
    • NotificationWhen pending, creates requester + reviewer UserNotification records.
    • Job enqueueQueues CAMPAIGN_DISPATCH for already-sent campaigns that include future registrants.
    • Audit logWrites registration_self_created into AuditLog.
    • IdempotencyStores IdempotencyRecord for scope register-self:event:user.

    Models touched

  3. 03GET/api/v1/me/notifications?status=unread

    Pull unread notifications

    Fetches notification feed and unread badge count for the current actor.

    Side effects

    • DB readReads paginated UserNotification rows.
    • DB readCounts unread UserNotification rows.