fete/specs/007-view-event/quickstart.md

Quickstart: View Event Landing Page (007)

What this feature does

Adds a public event detail page at /events/:token. Guests open a shared link and see:

• Event title, date/time (with IANA timezone), description, location
• Count of confirmed attendees (no names)
• "Event has ended" state for expired events
• "Event not found" for invalid tokens
• Skeleton shimmer while loading

Prerequisites

• US-1 (Create Event) is implemented — Event entity, JPA persistence, POST endpoint exist.
• No RSVP model yet — attendee count returns 0 until RSVP feature is built.

Key changes

Backend

1. OpenAPI: Add GET /events/{token} endpoint + GetEventResponse schema. Add timezone field to CreateEventRequest, CreateEventResponse, and GetEventResponse.
2. Domain: Add timezone (String) to Event.java.
3. Persistence: Add timezone column to EventJpaEntity, Liquibase migration.
4. Use case: New GetEventUseCase (inbound port) + implementation in EventService.
5. Controller: EventController implements getEvent() — maps to GetEventResponse, computes expired and attendeeCount.

Frontend

1. API types: Regenerate schema.d.ts from updated OpenAPI spec.
2. EventDetailView.vue: New view component — fetches event by token, renders detail card.
3. Router: Replace EventStubView import at /events/:token with EventDetailView.
4. States: Loading (skeleton shimmer), loaded, expired, not-found, server-error (retry button).
5. Create form: Send timezone field (auto-detected via Intl.DateTimeFormat).

Testing

• Backend: Unit tests for GetEventUseCase, controller tests for GET endpoint (200, 404).
• Frontend: Unit tests for EventDetailView (all states).
• E2E: Playwright tests with MSW mocks for all states (loaded, expired, not-found, error).