# piyush-lingwal/aws-website architecture

> Architecture diagram of the GitHub repository piyush-lingwal/aws-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/piyush-lingwal/aws-website
- Repository: https://github.com/piyush-lingwal/aws-website

## Overview

AWS Student Builder Group’s site combines public community pages with operational tools. The clearest end-to-end workflow is attendance submission: a student checks in, the API records attendance and creates a certificate, and the result can be verified publicly. Separate branches cover registration, event and team administration, and the media portal/gallery. The README documents these product capabilities, while sampled source confirms key attendance, certificate-rendering, recruitment, and Supabase relationships; unsampled route wiring is therefore shown only where documented.

Main entry points: [`app/(light)`](https://github.com/piyush-lingwal/aws-website/tree/main/app/(light)) (Public pages), [`app/api/attendance/route.ts`](https://github.com/piyush-lingwal/aws-website/blob/main/app/api/attendance/route.ts) (Attendance and issuance), [`app/(light)/register/page.tsx`](https://github.com/piyush-lingwal/aws-website/blob/main/app/(light)/register/page.tsx) (Registration form), [`app/api/register/route.ts`](https://github.com/piyush-lingwal/aws-website/blob/main/app/api/register/route.ts) (Application intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_public_pages["Public pages"]
  node_events_ui["Events and learning"]
  node_team_ui["Team directory"]
  node_gallery_ui["Event gallery"]
end

subgraph group_participation["Participation and awards"]
  node_registration["Registration form<br/>[page.tsx]"]
  node_recruitment_api["Recruitment status<br/>[route.ts]"]
  node_register_api["Application intake<br/>[route.ts]"]
  node_attendance_ui["Attendance check-in<br/>[page.tsx]"]
  node_attendance_api["Attendance and issuance<br/>[route.ts]"]
  node_certificate_render["Certificate rendering<br/>[pdf-generator.ts]"]
  node_certificate_view["Certificate preview"]
  node_verification["Public verification<br/>[page.tsx]"]
end

subgraph group_operations["Admin operations"]
  node_admin_ui["Staff dashboard<br/>[page.tsx]"]
  node_admin_events["Event administration<br/>[route.ts]"]
  node_admin_awards["Award management<br/>[route.ts]"]
end

subgraph group_media["Media portal"]
  node_media_portal["Media portal"]
  node_media_upload["Media upload flow<br/>[client-upload.ts]"]
  node_media_api["Media endpoints"]
  node_media_storage["Media storage adapter"]
  node_media_gallery_data["Gallery data<br/>[public-data.ts]"]
end

subgraph group_shared["Shared services"]
  node_supabase[("Supabase")]
  node_email["Email delivery<br/>[index.ts]"]
end

node_visitor(("Visitor / student"))

node_visitor -->|"browses"| node_public_pages
node_public_pages -->|"presents"| node_events_ui
node_public_pages -->|"presents"| node_team_ui
node_public_pages -->|"presents"| node_gallery_ui
node_visitor -->|"applies through"| node_registration
node_registration -->|"fetches status"| node_recruitment_api
node_registration -->|"submits application"| node_register_api
node_register_api -->|"stores application"| node_supabase
node_register_api -->|"sends confirmation"| node_email
node_visitor -->|"checks in"| node_attendance_ui
node_attendance_ui -->|"submits attendance"| node_attendance_api
node_attendance_api -->|"reads and writes"| node_supabase
node_attendance_api -->|"generates PDF"| node_certificate_render
node_attendance_api -->|"issues certificate"| node_certificate_view
node_visitor -->|"verifies certificate"| node_verification
node_verification -->|"reads certificate"| node_supabase
node_certificate_view -->|"renders preview"| node_certificate_render
node_visitor -->|"staff operates"| node_admin_ui
node_admin_ui -->|"manages events"| node_admin_events
node_admin_ui -->|"manages performers"| node_admin_awards
node_admin_events -->|"reads and writes"| node_supabase
node_admin_awards -->|"reads and writes"| node_supabase
node_visitor -->|"media team signs in"| node_media_portal
node_media_portal -->|"uploads media"| node_media_upload
node_media_upload -.->|"uses upload endpoints"| node_media_api
node_media_api -.->|"stores media"| node_media_storage
node_media_storage -->|"reads and writes objects"| node_supabase
node_gallery_ui -->|"displays event media"| node_media_gallery_data
node_media_gallery_data -.->|"reads media records"| node_supabase

click node_public_pages "https://github.com/piyush-lingwal/aws-website/tree/main/app/(light)"
click node_events_ui "https://github.com/piyush-lingwal/aws-website/tree/main/components/features/events"
click node_team_ui "https://github.com/piyush-lingwal/aws-website/tree/main/components/features/team"
click node_gallery_ui "https://github.com/piyush-lingwal/aws-website/tree/main/components/features/gallery"
click node_registration "https://github.com/piyush-lingwal/aws-website/blob/main/app/(light)/register/page.tsx"
click node_recruitment_api "https://github.com/piyush-lingwal/aws-website/blob/main/app/api/recruitment-status/route.ts"
click node_register_api "https://github.com/piyush-lingwal/aws-website/blob/main/app/api/register/route.ts"
click node_attendance_ui "https://github.com/piyush-lingwal/aws-website/blob/main/app/(light)/attendance/page.tsx"
click node_attendance_api "https://github.com/piyush-lingwal/aws-website/blob/main/app/api/attendance/route.ts"
click node_certificate_render "https://github.com/piyush-lingwal/aws-website/blob/main/lib/certificates/pdf-generator.ts"
click node_certificate_view "https://github.com/piyush-lingwal/aws-website/blob/main/components/certificates/CertificatePreview.tsx"
click node_verification "https://github.com/piyush-lingwal/aws-website/blob/main/app/(light)/verify/%5BcertificateId%5D/page.tsx"
click node_admin_ui "https://github.com/piyush-lingwal/aws-website/blob/main/app/admin/page.tsx"
click node_admin_events "https://github.com/piyush-lingwal/aws-website/blob/main/app/api/admin/events/route.ts"
click node_admin_awards "https://github.com/piyush-lingwal/aws-website/blob/main/app/api/admin/top-performers/route.ts"
click node_media_portal "https://github.com/piyush-lingwal/aws-website/tree/main/app/(light)/media/(portal)"
click node_media_upload "https://github.com/piyush-lingwal/aws-website/blob/main/lib/media/client-upload.ts"
click node_media_api "https://github.com/piyush-lingwal/aws-website/tree/main/app/api/media"
click node_media_storage "https://github.com/piyush-lingwal/aws-website/blob/main/lib/storage/supabase-storage.ts"
click node_media_gallery_data "https://github.com/piyush-lingwal/aws-website/blob/main/lib/media/public-data.ts"
click node_email "https://github.com/piyush-lingwal/aws-website/blob/main/lib/email/index.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_pages,node_events_ui,node_team_ui,node_gallery_ui toneBlue
class node_registration,node_recruitment_api,node_register_api,node_attendance_ui,node_attendance_api,node_certificate_render,node_certificate_view,node_verification toneAmber
class node_admin_ui,node_admin_events,node_admin_awards toneMint
class node_media_portal,node_media_upload,node_media_api,node_media_storage,node_media_gallery_data toneRose
class node_supabase,node_email,node_visitor toneIndigo
```

## Components

### Public site

- [Public pages](https://github.com/piyush-lingwal/aws-website/tree/main/app/(light)): `app/(light)`
- [Events and learning](https://github.com/piyush-lingwal/aws-website/tree/main/components/features/events): `components/features/events`
- [Team directory](https://github.com/piyush-lingwal/aws-website/tree/main/components/features/team): `components/features/team`
- [Event gallery](https://github.com/piyush-lingwal/aws-website/tree/main/components/features/gallery): `components/features/gallery`

### Participation and awards

- [Registration form](https://github.com/piyush-lingwal/aws-website/blob/main/app/(light)/register/page.tsx): `app/(light)/register/page.tsx`
- [Recruitment status](https://github.com/piyush-lingwal/aws-website/blob/main/app/api/recruitment-status/route.ts): `app/api/recruitment-status/route.ts`
- [Application intake](https://github.com/piyush-lingwal/aws-website/blob/main/app/api/register/route.ts): `app/api/register/route.ts`
- [Attendance check-in](https://github.com/piyush-lingwal/aws-website/blob/main/app/(light)/attendance/page.tsx): `app/(light)/attendance/page.tsx`
- [Attendance and issuance](https://github.com/piyush-lingwal/aws-website/blob/main/app/api/attendance/route.ts): `app/api/attendance/route.ts`
- [Certificate rendering](https://github.com/piyush-lingwal/aws-website/blob/main/lib/certificates/pdf-generator.ts): `lib/certificates/pdf-generator.ts`
- [Certificate preview](https://github.com/piyush-lingwal/aws-website/blob/main/components/certificates/CertificatePreview.tsx): `components/certificates/CertificatePreview.tsx`
- [Public verification](https://github.com/piyush-lingwal/aws-website/blob/main/app/(light)/verify/%5BcertificateId%5D/page.tsx): `app/(light)/verify/[certificateId]/page.tsx`

### Admin operations

- [Staff dashboard](https://github.com/piyush-lingwal/aws-website/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Event administration](https://github.com/piyush-lingwal/aws-website/blob/main/app/api/admin/events/route.ts): `app/api/admin/events/route.ts`
- [Award management](https://github.com/piyush-lingwal/aws-website/blob/main/app/api/admin/top-performers/route.ts): `app/api/admin/top-performers/route.ts`

### Media portal

- [Media portal](https://github.com/piyush-lingwal/aws-website/tree/main/app/(light)/media/(portal)): `app/(light)/media/(portal)`
- [Media upload flow](https://github.com/piyush-lingwal/aws-website/blob/main/lib/media/client-upload.ts): `lib/media/client-upload.ts`
- [Media endpoints](https://github.com/piyush-lingwal/aws-website/tree/main/app/api/media): `app/api/media`
- [Media storage adapter](https://github.com/piyush-lingwal/aws-website/blob/main/lib/storage/supabase-storage.ts): `lib/storage/supabase-storage.ts`
- [Gallery data](https://github.com/piyush-lingwal/aws-website/blob/main/lib/media/public-data.ts): `lib/media/public-data.ts`

### Shared services

- **Supabase**
- [Email delivery](https://github.com/piyush-lingwal/aws-website/blob/main/lib/email/index.ts): `lib/email/index.ts`

### Other components

- **Visitor / student**

## Connections

- Visitor / student → Public pages: browses
- Public pages → Events and learning: presents
- Public pages → Team directory: presents
- Public pages → Event gallery: presents
- Visitor / student → Registration form: applies through
- Registration form → Recruitment status: fetches status
- Registration form → Application intake: submits application
- Application intake → Supabase: stores application (evidence: `app/api/register/route.ts`)
- Application intake → Email delivery: sends confirmation (evidence: `app/api/register/route.ts`)
- Visitor / student → Attendance check-in: checks in
- Attendance check-in → Attendance and issuance: submits attendance
- Attendance and issuance → Supabase: reads and writes (evidence: `app/api/attendance/route.ts`)
- Attendance and issuance → Certificate rendering: generates PDF (evidence: `app/api/attendance/route.ts`)
- Attendance and issuance → Certificate preview: issues certificate
- Visitor / student → Public verification: verifies certificate
- Public verification → Supabase: reads certificate (evidence: `app/(light)/verify/[certificateId]/page.tsx`)
- Certificate preview → Certificate rendering: renders preview (evidence: `components/certificates/CertificatePreview.tsx`)
- Visitor / student → Staff dashboard: staff operates
- Staff dashboard → Event administration: manages events (evidence: `app/admin/page.tsx`)
- Staff dashboard → Award management: manages performers (evidence: `app/admin/page.tsx`)
- Event administration → Supabase: reads and writes (evidence: `app/api/admin/events/route.ts`)
- Award management → Supabase: reads and writes (evidence: `app/api/admin/top-performers/route.ts`)
- Visitor / student → Media portal: media team signs in
- Media portal → Media upload flow: uploads media
- Media upload flow → Media endpoints: uses upload endpoints
- Media endpoints → Media storage adapter: stores media
- Media storage adapter → Supabase: reads and writes objects (evidence: `lib/storage/supabase-storage.ts`)
- Event gallery → Gallery data: displays event media
- Gallery data → Supabase: reads media records
