# abdullah2036/scinvites architecture

> Architecture diagram of the GitHub repository abdullah2036/scinvites, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abdullah2036/scinvites
- Repository: https://github.com/abdullah2036/scinvites

## Overview

SCinvites is a Science Club digital-invitation platform. Owners manage events, templates, settings, approvals and analytics; leaders request access and invitation batches; guests open links, RSVP and download calendar files. The graph follows those product stages and includes the server domain layer. Some routes and subsystems are unsampled, so their documented capabilities are shown without speculative implementation-level links.

Main entry points: [`app/studio/DashboardClient.tsx`](https://github.com/abdullah2036/scinvites/blob/main/app/studio/DashboardClient.tsx) (Studio screens), [`app/api/events/route.ts`](https://github.com/abdullah2036/scinvites/blob/main/app/api/events/route.ts) (Studio APIs), [`lib/server/sessions.ts`](https://github.com/abdullah2036/scinvites/blob/main/lib/server/sessions.ts) (Sessions), [`lib/server/db.ts`](https://github.com/abdullah2036/scinvites/blob/main/lib/server/db.ts) (Application database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Guest invitations"]
  node_guest_page["Public invitation page<br/>[page.tsx]"]
  node_guest_client["Guest interaction<br/>[GuestClient.tsx]"]
  node_invitation_view["Invitation rendering<br/>[Invitation.tsx]"]
  node_guest_api["Open, RSVP, calendar<br/>[route.ts]"]
end

subgraph group_studio["Owner studio"]
  node_studio_ui["Studio screens"]
  node_studio_api["Studio APIs<br/>[route.ts]"]
  node_templates_api["Template APIs<br/>[route.ts]"]
  node_invitations_api["Invitation management API<br/>[route.ts]"]
  node_analytics_api["Owner analytics API<br/>[route.ts]"]
end

subgraph group_leaders["Leader workflow"]
  node_leader_ui["Leader workspace<br/>[LeaderClient.tsx]"]
  node_leader_access["Leader access API<br/>[route.ts]"]
  node_request_api["Batch request APIs<br/>[route.ts]"]
end

subgraph group_domain["Invitation services"]
  node_guest_services["Guest invitation services<br/>[guest.ts]"]
  node_events["Event management<br/>[events.ts]"]
  node_templates["Template management<br/>[templates.ts]"]
  node_invitations["Invitation creation<br/>[invitations.ts]"]
  node_leader_auth["Leader authentication<br/>[leader-auth.ts]"]
  node_requests["Request approval<br/>[requests.ts]"]
  node_analytics["Analytics<br/>[analytics.ts]"]
  node_calendar["Calendar files<br/>[ics.ts]"]
end

subgraph group_platform["Shared platform"]
  node_sessions["Sessions<br/>[sessions.ts]"]
  node_http["HTTP handling<br/>[http.ts]"]
  node_schemas["Input validation<br/>[schemas.ts]"]
  node_database[("Application database<br/>[db.ts]")]
  node_email["Email notifications<br/>[email.ts]"]
  node_artwork[("Artwork storage<br/>[storage.ts]")]
end

node_guest(("Guest visitor"))
node_owner(("Club owner"))
node_leader(("Club leader"))

node_guest -->|"opens link"| node_guest_page
node_guest_page -->|"renders"| node_guest_client
node_guest_client -->|"renders"| node_invitation_view
node_invitation_view -.->|"records open or RSVP"| node_guest_api
node_guest_api -.->|"handles guest actions"| node_guest_services
node_guest_services -.->|"provides calendar files"| node_calendar
node_owner -->|"manages platform"| node_studio_ui
node_studio_ui -.->|"loads event data"| node_studio_api
node_studio_api -->|"uses handlers"| node_http
node_studio_api -->|"checks owner session"| node_sessions
node_studio_api -->|"manages events"| node_events
node_studio_api -->|"validates input"| node_schemas
node_studio_ui -.->|"manages templates"| node_templates_api
node_templates_api -->|"manages templates"| node_templates
node_templates_api -->|"checks session"| node_sessions
node_templates_api -->|"validates input"| node_schemas
node_studio_ui -.->|"creates invitations"| node_invitations_api
node_invitations_api -->|"manages invitations"| node_invitations
node_invitations_api -->|"checks session"| node_sessions
node_invitations_api -->|"validates input"| node_schemas
node_leader -->|"requests access"| node_leader_access
node_leader_access -.->|"checks access"| node_leader_auth
node_leader -->|"uses workspace"| node_leader_ui
node_leader_ui -.->|"submits batch"| node_request_api
node_request_api -->|"creates requests"| node_requests
node_request_api -->|"validates input"| node_schemas
node_owner -->|"decides requests"| node_request_api
node_requests -->|"checks availability"| node_templates
node_requests -->|"sends notifications"| node_email
node_owner -->|"views analytics"| node_analytics_api
node_analytics_api -->|"loads analytics"| node_analytics
node_analytics_api -->|"checks session"| node_sessions
node_sessions -->|"reads and writes sessions"| node_database
node_events -.->|"persists events"| node_database
node_templates -->|"persists templates"| node_database
node_invitations -.->|"persists invitations"| node_database
node_analytics -.->|"queries metrics"| node_database
node_guest_api -.->|"uses handlers"| node_http
node_guest_api -.->|"serves public links"| node_invitations
node_studio_ui -.->|"uploads artwork"| node_artwork

click node_guest_page "https://github.com/abdullah2036/scinvites/blob/main/app/i/%5Bslug%5D/page.tsx"
click node_guest_client "https://github.com/abdullah2036/scinvites/blob/main/app/i/%5Bslug%5D/GuestClient.tsx"
click node_invitation_view "https://github.com/abdullah2036/scinvites/blob/main/components/invitation/Invitation.tsx"
click node_guest_api "https://github.com/abdullah2036/scinvites/blob/main/app/api/i/%5Bslug%5D/route.ts"
click node_guest_services "https://github.com/abdullah2036/scinvites/blob/main/lib/server/guest.ts"
click node_studio_ui "https://github.com/abdullah2036/scinvites/blob/main/app/studio/DashboardClient.tsx"
click node_studio_api "https://github.com/abdullah2036/scinvites/blob/main/app/api/events/route.ts"
click node_events "https://github.com/abdullah2036/scinvites/blob/main/lib/server/events.ts"
click node_templates_api "https://github.com/abdullah2036/scinvites/blob/main/app/api/templates/route.ts"
click node_templates "https://github.com/abdullah2036/scinvites/blob/main/lib/server/templates.ts"
click node_invitations_api "https://github.com/abdullah2036/scinvites/blob/main/app/api/invitations/route.ts"
click node_invitations "https://github.com/abdullah2036/scinvites/blob/main/lib/server/invitations.ts"
click node_leader_ui "https://github.com/abdullah2036/scinvites/blob/main/app/leader/LeaderClient.tsx"
click node_leader_access "https://github.com/abdullah2036/scinvites/blob/main/app/api/leaders/request/route.ts"
click node_leader_auth "https://github.com/abdullah2036/scinvites/blob/main/lib/server/leader-auth.ts"
click node_request_api "https://github.com/abdullah2036/scinvites/blob/main/app/api/requests/route.ts"
click node_requests "https://github.com/abdullah2036/scinvites/blob/main/lib/server/requests.ts"
click node_analytics_api "https://github.com/abdullah2036/scinvites/blob/main/app/api/analytics/route.ts"
click node_analytics "https://github.com/abdullah2036/scinvites/blob/main/lib/server/analytics.ts"
click node_sessions "https://github.com/abdullah2036/scinvites/blob/main/lib/server/sessions.ts"
click node_http "https://github.com/abdullah2036/scinvites/blob/main/lib/server/http.ts"
click node_schemas "https://github.com/abdullah2036/scinvites/blob/main/lib/shared/schemas.ts"
click node_database "https://github.com/abdullah2036/scinvites/blob/main/lib/server/db.ts"
click node_email "https://github.com/abdullah2036/scinvites/blob/main/lib/server/email.ts"
click node_artwork "https://github.com/abdullah2036/scinvites/blob/main/lib/server/storage.ts"
click node_calendar "https://github.com/abdullah2036/scinvites/blob/main/lib/server/ics.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_guest_page,node_guest_client,node_invitation_view,node_guest_api toneBlue
class node_studio_ui,node_studio_api,node_templates_api,node_invitations_api,node_analytics_api toneAmber
class node_leader_ui,node_leader_access,node_request_api toneMint
class node_guest_services,node_events,node_templates,node_invitations,node_leader_auth,node_requests,node_analytics,node_calendar toneRose
class node_sessions,node_http,node_schemas,node_database,node_email,node_artwork,node_guest,node_owner,node_leader toneIndigo
```

## Components

### Guest invitations

- [Public invitation page](https://github.com/abdullah2036/scinvites/blob/main/app/i/%5Bslug%5D/page.tsx): `app/i/[slug]/page.tsx`
- [Guest interaction](https://github.com/abdullah2036/scinvites/blob/main/app/i/%5Bslug%5D/GuestClient.tsx): `app/i/[slug]/GuestClient.tsx`
- [Invitation rendering](https://github.com/abdullah2036/scinvites/blob/main/components/invitation/Invitation.tsx): `components/invitation/Invitation.tsx`
- [Open, RSVP, calendar](https://github.com/abdullah2036/scinvites/blob/main/app/api/i/%5Bslug%5D/route.ts): `app/api/i/[slug]/route.ts`

### Owner studio

- [Studio screens](https://github.com/abdullah2036/scinvites/blob/main/app/studio/DashboardClient.tsx): `app/studio/DashboardClient.tsx`
- [Studio APIs](https://github.com/abdullah2036/scinvites/blob/main/app/api/events/route.ts): `app/api/events/route.ts`
- [Template APIs](https://github.com/abdullah2036/scinvites/blob/main/app/api/templates/route.ts): `app/api/templates/route.ts`
- [Invitation management API](https://github.com/abdullah2036/scinvites/blob/main/app/api/invitations/route.ts): `app/api/invitations/route.ts`
- [Owner analytics API](https://github.com/abdullah2036/scinvites/blob/main/app/api/analytics/route.ts): `app/api/analytics/route.ts`

### Leader workflow

- [Leader workspace](https://github.com/abdullah2036/scinvites/blob/main/app/leader/LeaderClient.tsx): `app/leader/LeaderClient.tsx`
- [Leader access API](https://github.com/abdullah2036/scinvites/blob/main/app/api/leaders/request/route.ts): `app/api/leaders/request/route.ts`
- [Batch request APIs](https://github.com/abdullah2036/scinvites/blob/main/app/api/requests/route.ts): `app/api/requests/route.ts`

### Invitation services

- [Guest invitation services](https://github.com/abdullah2036/scinvites/blob/main/lib/server/guest.ts): `lib/server/guest.ts`
- [Event management](https://github.com/abdullah2036/scinvites/blob/main/lib/server/events.ts): `lib/server/events.ts`
- [Template management](https://github.com/abdullah2036/scinvites/blob/main/lib/server/templates.ts): `lib/server/templates.ts`
- [Invitation creation](https://github.com/abdullah2036/scinvites/blob/main/lib/server/invitations.ts): `lib/server/invitations.ts`
- [Leader authentication](https://github.com/abdullah2036/scinvites/blob/main/lib/server/leader-auth.ts): `lib/server/leader-auth.ts`
- [Request approval](https://github.com/abdullah2036/scinvites/blob/main/lib/server/requests.ts): `lib/server/requests.ts`
- [Analytics](https://github.com/abdullah2036/scinvites/blob/main/lib/server/analytics.ts): `lib/server/analytics.ts`
- [Calendar files](https://github.com/abdullah2036/scinvites/blob/main/lib/server/ics.ts): `lib/server/ics.ts`

### Shared platform

- [Sessions](https://github.com/abdullah2036/scinvites/blob/main/lib/server/sessions.ts): `lib/server/sessions.ts`
- [HTTP handling](https://github.com/abdullah2036/scinvites/blob/main/lib/server/http.ts): `lib/server/http.ts`
- [Input validation](https://github.com/abdullah2036/scinvites/blob/main/lib/shared/schemas.ts): `lib/shared/schemas.ts`
- [Application database](https://github.com/abdullah2036/scinvites/blob/main/lib/server/db.ts): `lib/server/db.ts`
- [Email notifications](https://github.com/abdullah2036/scinvites/blob/main/lib/server/email.ts): `lib/server/email.ts`
- [Artwork storage](https://github.com/abdullah2036/scinvites/blob/main/lib/server/storage.ts): `lib/server/storage.ts`

### Other components

- **Guest visitor**
- **Club owner**
- **Club leader**

## Connections

- Guest visitor → Public invitation page: opens link
- Public invitation page → Guest interaction: renders (evidence: `app/i/[slug]/page.tsx`)
- Guest interaction → Invitation rendering: renders (evidence: `app/i/[slug]/GuestClient.tsx`)
- Invitation rendering → Open, RSVP, calendar: records open or RSVP
- Open, RSVP, calendar → Guest invitation services: handles guest actions
- Guest invitation services → Calendar files: provides calendar files
- Club owner → Studio screens: manages platform
- Studio screens → Studio APIs: loads event data
- Studio APIs → HTTP handling: uses handlers (evidence: `app/api/events/route.ts`)
- Studio APIs → Sessions: checks owner session (evidence: `app/api/events/route.ts`)
- Studio APIs → Event management: manages events (evidence: `app/api/events/route.ts`)
- Studio APIs → Input validation: validates input (evidence: `app/api/events/route.ts`)
- Studio screens → Template APIs: manages templates
- Template APIs → Template management: manages templates (evidence: `app/api/templates/route.ts`)
- Template APIs → Sessions: checks session (evidence: `app/api/templates/route.ts`)
- Template APIs → Input validation: validates input (evidence: `app/api/templates/route.ts`)
- Studio screens → Invitation management API: creates invitations
- Invitation management API → Invitation creation: manages invitations (evidence: `app/api/invitations/route.ts`)
- Invitation management API → Sessions: checks session (evidence: `app/api/invitations/route.ts`)
- Invitation management API → Input validation: validates input (evidence: `app/api/invitations/route.ts`)
- Club leader → Leader access API: requests access
- Leader access API → Leader authentication: checks access
- Club leader → Leader workspace: uses workspace
- Leader workspace → Batch request APIs: submits batch
- Batch request APIs → Request approval: creates requests (evidence: `app/api/requests/route.ts`)
- Batch request APIs → Input validation: validates input (evidence: `app/api/requests/route.ts`)
- Club owner → Batch request APIs: decides requests
- Request approval → Template management: checks availability (evidence: `lib/server/requests.ts`)
- Request approval → Email notifications: sends notifications (evidence: `lib/server/requests.ts`)
- Club owner → Owner analytics API: views analytics
- Owner analytics API → Analytics: loads analytics (evidence: `app/api/analytics/route.ts`)
- Owner analytics API → Sessions: checks session (evidence: `app/api/analytics/route.ts`)
- Sessions → Application database: reads and writes sessions (evidence: `lib/server/sessions.ts`)
- Event management → Application database: persists events
- Template management → Application database: persists templates (evidence: `lib/server/templates.ts`)
- Invitation creation → Application database: persists invitations
- Analytics → Application database: queries metrics
- Open, RSVP, calendar → HTTP handling: uses handlers
- Open, RSVP, calendar → Invitation creation: serves public links
- Studio screens → Artwork storage: uploads artwork
