41 lines
2.0 KiB
Markdown
41 lines
2.0 KiB
Markdown
# TASK METADATA
|
|
|
|
- **Target Files:**
|
|
- `server/db.ts`
|
|
- `server/main.ts`
|
|
- `ui/components/EventJoinPage.tsx`
|
|
- `ui/components/EventSplashPage.tsx`
|
|
- `server/main.test.ts`
|
|
- **Core Objective:** Implement Multi-Claim Event Passes with short vanity URLs (`/e/:slug`), universal PIN join portal (`/join`), and CLI environment 1-liner (`/join/:slug?format=env`).
|
|
- **Dependencies:** `server/db.ts`, `server/auth-session.ts`
|
|
- **Additional Important Notes:** Provisions isolated guest seats (`guest_<slug>_<index>`) with individual sessions.
|
|
|
|
---
|
|
|
|
### 1. Architectural Considerations & Risks
|
|
|
|
- **Concurrency & Seat Limits:**
|
|
- Ensure atomicity when incrementing `seats_claimed` on `event_passes` so events with strict seat limits (e.g. 50 seats) do not oversubscribe.
|
|
- **Multi-Channel Accessibility:**
|
|
- Support web browser UI (`/e/:slug`, `/join`), JSON API (`POST /api/join`), and CLI environment output (`GET /join/:slug?format=env`).
|
|
- **Session Isolation:**
|
|
- Each attendee gets their own dedicated guest session and UUID, preventing state collision in shared sandbox apps.
|
|
|
|
---
|
|
|
|
### 2. Proposed Implementation
|
|
|
|
1. **Database Schema (`server/db.ts`):**
|
|
- Create `event_passes` table with columns: `id`, `slug`, `pin_code`, `name`, `app_id`, `role`, `max_seats`, `seats_claimed`, `lifespan_hours`, `created_by`, `is_active`, `expires_at`, `created_at`.
|
|
2. **API Endpoints (`server/main.ts`):**
|
|
- `POST /api/events`: Create a new event pass.
|
|
- `GET /e/:slug`: Web landing splash with "Enter Workshop" button.
|
|
- `GET /join`: Universal PIN / code entry page.
|
|
- `POST /api/join`: Redeems code or PIN, creates isolated guest user and session, sets cookie or returns JSON.
|
|
- `GET /join/:slug`: Returns CLI 1-liner (`export AUTH_YES_TOKEN="..."` when `?format=env`).
|
|
3. **SSR UI Components:**
|
|
- `ui/components/EventJoinPage.tsx`
|
|
- `ui/components/EventSplashPage.tsx`
|
|
4. **Automated Tests (`server/main.test.ts`):**
|
|
- Test event creation, PIN redemption, seat limit capping, and CLI output format.
|