# shcoide/prithvi2026 architecture

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

- Interactive diagram: https://gitdiagram.com/shcoide/prithvi2026
- Repository: https://github.com/shcoide/prithvi2026

## Overview

Prithvi 2026 is an event-registration and attendance platform. Participants browse events, verify email, submit registration and payment evidence, then view their registrations; organizers review participants, manage event registrations and attendance, and export data. The graph groups the user-facing experience, participant lifecycle, organizer operations, and shared services/data. Some links rely on README-described behavior because the corresponding route implementations were not sampled; those edges cite the README.

Main entry points: [`lib/db.ts`](https://github.com/shcoide/prithvi2026/blob/main/lib/db.ts) (Data access), [`app/api/auth/register/route.ts`](https://github.com/shcoide/prithvi2026/blob/main/app/api/auth/register/route.ts) (Account registration), [`app/event-register/EventRegisterForm.tsx`](https://github.com/shcoide/prithvi2026/blob/main/app/event-register/EventRegisterForm.tsx) (Event registration form), [`app/addmin/page.tsx`](https://github.com/shcoide/prithvi2026/blob/main/app/addmin/page.tsx) (Admin panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Public Experience"]
  node_public_site["Public pages"]
  node_event_catalog["Event catalog<br/>[page.tsx]"]
end

subgraph group_participant["Participant Lifecycle"]
  node_auth_context["Session context<br/>[AuthContext.tsx]"]
  node_auth_api["Participant auth"]
  node_otp["Email OTP<br/>[otp.ts]"]
  node_registration_api["Account registration<br/>[route.ts]"]
  node_event_form["Event registration form"]
  node_event_api["Event registration API<br/>[route.ts]"]
  node_profile["Profile dashboard<br/>[page.tsx]"]
  node_my_registrations["My registrations API<br/>[route.ts]"]
end

subgraph group_operations["Organizer Operations"]
  node_admin_ui["Admin panel<br/>[page.tsx]"]
  node_admin_auth["Admin authentication<br/>[adminAuth.ts]"]
  node_admin_routes["Admin operations APIs"]
  node_attendance["QR attendance<br/>[page.tsx]"]
  node_exports["Registration exports<br/>[route.ts]"]
  node_attendance_export["Attendance export<br/>[route.ts]"]
end

subgraph group_shared["Shared Services"]
  node_event_config["Event rules<br/>[eventsConfig.ts]"]
  node_email["Email service<br/>[email.ts]"]
  node_upload_api["Upload configuration<br/>[core.ts]"]
  node_db_helpers["Data access<br/>[db.ts]"]
  node_mongodb["MongoDB connection<br/>[mongodb.ts]"]
  node_sheets["Sheets sync<br/>[sheets.ts]"]
end

node_participant(("Participant"))
node_upload_service["Uploadthing"]
node_database[("MongoDB Atlas")]
node_google_sheets[("Google Sheets")]

node_participant -->|"browses"| node_public_site
node_public_site -->|"opens"| node_event_catalog
node_event_catalog -->|"reads events"| node_event_config
node_event_catalog -->|"routes to register"| node_event_form
node_auth_context -->|"checks session"| node_auth_api
node_participant -->|"signs in"| node_auth_api
node_auth_api -.->|"verifies email"| node_otp
node_otp -.->|"sends code"| node_email
node_participant -->|"creates account"| node_registration_api
node_registration_api -->|"creates user"| node_db_helpers
node_registration_api -->|"mirrors registration"| node_sheets
node_registration_api -->|"sends confirmation"| node_email
node_participant -->|"uploads screenshot"| node_upload_service
node_upload_service -->|"returns screenshot URL"| node_registration_api
node_upload_api -.->|"configures uploads"| node_upload_service
node_event_form -->|"reads session"| node_auth_context
node_event_form -->|"reads event rules"| node_event_config
node_event_form -.->|"submits team"| node_event_api
node_event_api -->|"validates and saves"| node_db_helpers
node_profile -.->|"loads registrations"| node_my_registrations
node_my_registrations -->|"reads user data"| node_db_helpers
node_participant -->|"organizes event"| node_admin_ui
node_admin_ui -.->|"authenticates admin"| node_admin_auth
node_admin_ui -->|"manages participants"| node_admin_routes
node_admin_ui -->|"scans QR codes"| node_attendance
node_attendance -.->|"marks attendance"| node_admin_routes
node_admin_routes -.->|"updates records"| node_db_helpers
node_exports -->|"checks admin cookie"| node_admin_auth
node_exports -->|"reads registrations"| node_db_helpers
node_attendance_export -->|"checks admin cookie"| node_admin_auth
node_attendance_export -->|"reads attendance"| node_db_helpers
node_db_helpers -->|"connects through"| node_mongodb
node_mongodb -.->|"persists records"| node_database
node_sheets -.->|"syncs rows"| node_google_sheets

click node_public_site "https://github.com/shcoide/prithvi2026/tree/main/app"
click node_event_catalog "https://github.com/shcoide/prithvi2026/blob/main/app/events/page.tsx"
click node_event_config "https://github.com/shcoide/prithvi2026/blob/main/lib/eventsConfig.ts"
click node_auth_context "https://github.com/shcoide/prithvi2026/blob/main/app/components/AuthContext.tsx"
click node_auth_api "https://github.com/shcoide/prithvi2026/tree/main/app/api/auth"
click node_otp "https://github.com/shcoide/prithvi2026/blob/main/lib/otp.ts"
click node_email "https://github.com/shcoide/prithvi2026/blob/main/lib/email.ts"
click node_registration_api "https://github.com/shcoide/prithvi2026/blob/main/app/api/auth/register/route.ts"
click node_event_form "https://github.com/shcoide/prithvi2026/blob/main/app/event-register/EventRegisterForm.tsx"
click node_event_api "https://github.com/shcoide/prithvi2026/blob/main/app/api/event-register/route.ts"
click node_profile "https://github.com/shcoide/prithvi2026/blob/main/app/profile/page.tsx"
click node_my_registrations "https://github.com/shcoide/prithvi2026/blob/main/app/api/my-registrations/route.ts"
click node_upload_api "https://github.com/shcoide/prithvi2026/blob/main/app/api/uploadthing/core.ts"
click node_admin_ui "https://github.com/shcoide/prithvi2026/blob/main/app/addmin/page.tsx"
click node_admin_auth "https://github.com/shcoide/prithvi2026/blob/main/app/api/addmin/adminAuth.ts"
click node_admin_routes "https://github.com/shcoide/prithvi2026/tree/main/app/api/addmin"
click node_attendance "https://github.com/shcoide/prithvi2026/blob/main/app/addmin/page.tsx"
click node_exports "https://github.com/shcoide/prithvi2026/blob/main/app/api/addmin/export/route.ts"
click node_attendance_export "https://github.com/shcoide/prithvi2026/blob/main/app/api/addmin/attendance-export/route.ts"
click node_db_helpers "https://github.com/shcoide/prithvi2026/blob/main/lib/db.ts"
click node_mongodb "https://github.com/shcoide/prithvi2026/blob/main/lib/mongodb.ts"
click node_sheets "https://github.com/shcoide/prithvi2026/blob/main/lib/sheets.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_public_site,node_event_catalog toneBlue
class node_auth_context,node_auth_api,node_otp,node_registration_api,node_event_form,node_event_api,node_profile,node_my_registrations,node_database,node_google_sheets toneAmber
class node_admin_ui,node_admin_auth,node_admin_routes,node_attendance,node_exports,node_attendance_export toneMint
class node_event_config,node_email,node_upload_api,node_db_helpers,node_mongodb,node_sheets toneRose
class node_participant,node_upload_service toneIndigo
```

## Components

### Public Experience

- [Public pages](https://github.com/shcoide/prithvi2026/tree/main/app): `app`
- [Event catalog](https://github.com/shcoide/prithvi2026/blob/main/app/events/page.tsx): `app/events/page.tsx`

### Participant Lifecycle

- [Session context](https://github.com/shcoide/prithvi2026/blob/main/app/components/AuthContext.tsx): `app/components/AuthContext.tsx`
- [Participant auth](https://github.com/shcoide/prithvi2026/tree/main/app/api/auth): `app/api/auth`
- [Email OTP](https://github.com/shcoide/prithvi2026/blob/main/lib/otp.ts): `lib/otp.ts`
- [Account registration](https://github.com/shcoide/prithvi2026/blob/main/app/api/auth/register/route.ts): `app/api/auth/register/route.ts`
- [Event registration form](https://github.com/shcoide/prithvi2026/blob/main/app/event-register/EventRegisterForm.tsx): `app/event-register/EventRegisterForm.tsx`
- [Event registration API](https://github.com/shcoide/prithvi2026/blob/main/app/api/event-register/route.ts): `app/api/event-register/route.ts`
- [Profile dashboard](https://github.com/shcoide/prithvi2026/blob/main/app/profile/page.tsx): `app/profile/page.tsx`
- [My registrations API](https://github.com/shcoide/prithvi2026/blob/main/app/api/my-registrations/route.ts): `app/api/my-registrations/route.ts`

### Organizer Operations

- [Admin panel](https://github.com/shcoide/prithvi2026/blob/main/app/addmin/page.tsx): `app/addmin/page.tsx`
- [Admin authentication](https://github.com/shcoide/prithvi2026/blob/main/app/api/addmin/adminAuth.ts): `app/api/addmin/adminAuth.ts`
- [Admin operations APIs](https://github.com/shcoide/prithvi2026/tree/main/app/api/addmin): `app/api/addmin`
- [QR attendance](https://github.com/shcoide/prithvi2026/blob/main/app/addmin/page.tsx): `app/addmin/page.tsx`
- [Registration exports](https://github.com/shcoide/prithvi2026/blob/main/app/api/addmin/export/route.ts): `app/api/addmin/export/route.ts`
- [Attendance export](https://github.com/shcoide/prithvi2026/blob/main/app/api/addmin/attendance-export/route.ts): `app/api/addmin/attendance-export/route.ts`

### Shared Services

- [Event rules](https://github.com/shcoide/prithvi2026/blob/main/lib/eventsConfig.ts): `lib/eventsConfig.ts`
- [Email service](https://github.com/shcoide/prithvi2026/blob/main/lib/email.ts): `lib/email.ts`
- [Upload configuration](https://github.com/shcoide/prithvi2026/blob/main/app/api/uploadthing/core.ts): `app/api/uploadthing/core.ts`
- [Data access](https://github.com/shcoide/prithvi2026/blob/main/lib/db.ts): `lib/db.ts`
- [MongoDB connection](https://github.com/shcoide/prithvi2026/blob/main/lib/mongodb.ts): `lib/mongodb.ts`
- [Sheets sync](https://github.com/shcoide/prithvi2026/blob/main/lib/sheets.ts): `lib/sheets.ts`

### Other components

- **Participant**
- **Uploadthing**
- **MongoDB Atlas**
- **Google Sheets**

## Connections

- Participant → Public pages: browses (evidence: `README.md`)
- Public pages → Event catalog: opens (evidence: `README.md`)
- Event catalog → Event rules: reads events (evidence: `app/events/page.tsx`)
- Event catalog → Event registration form: routes to register (evidence: `app/events/page.tsx`)
- Session context → Participant auth: checks session (evidence: `app/components/AuthContext.tsx`)
- Participant → Participant auth: signs in (evidence: `README.md`)
- Participant auth → Email OTP: verifies email (evidence: `README.md`)
- Email OTP → Email service: sends code (evidence: `README.md`)
- Participant → Account registration: creates account (evidence: `app/api/auth/register/route.ts`)
- Account registration → Data access: creates user (evidence: `app/api/auth/register/route.ts`)
- Account registration → Sheets sync: mirrors registration (evidence: `app/api/auth/register/route.ts`)
- Account registration → Email service: sends confirmation (evidence: `app/api/auth/register/route.ts`)
- Participant → Uploadthing: uploads screenshot (evidence: `README.md`)
- Uploadthing → Account registration: returns screenshot URL (evidence: `README.md`)
- Upload configuration → Uploadthing: configures uploads
- Event registration form → Session context: reads session (evidence: `app/event-register/EventRegisterForm.tsx`)
- Event registration form → Event rules: reads event rules (evidence: `app/event-register/EventRegisterForm.tsx`)
- Event registration form → Event registration API: submits team (evidence: `README.md`)
- Event registration API → Data access: validates and saves (evidence: `app/api/event-register/route.ts`)
- Profile dashboard → My registrations API: loads registrations (evidence: `README.md`)
- My registrations API → Data access: reads user data (evidence: `app/api/my-registrations/route.ts`)
- Participant → Admin panel: organizes event (evidence: `README.md`)
- Admin panel → Admin authentication: authenticates admin (evidence: `README.md`)
- Admin panel → Admin operations APIs: manages participants (evidence: `app/addmin/page.tsx`)
- Admin panel → QR attendance: scans QR codes (evidence: `README.md`)
- QR attendance → Admin operations APIs: marks attendance (evidence: `README.md`)
- Admin operations APIs → Data access: updates records (evidence: `README.md`)
- Registration exports → Admin authentication: checks admin cookie (evidence: `app/api/addmin/export/route.ts`)
- Registration exports → Data access: reads registrations (evidence: `app/api/addmin/export/route.ts`)
- Attendance export → Admin authentication: checks admin cookie (evidence: `app/api/addmin/attendance-export/route.ts`)
- Attendance export → Data access: reads attendance (evidence: `app/api/addmin/attendance-export/route.ts`)
- Data access → MongoDB connection: connects through (evidence: `lib/db.ts`)
- MongoDB connection → MongoDB Atlas: persists records (evidence: `README.md`)
- Sheets sync → Google Sheets: syncs rows (evidence: `README.md`)
