# cyberclutch146/talkies-web architecture

> Architecture diagram of the GitHub repository cyberclutch146/talkies-web, 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/cyberclutch146/talkies-web
- Repository: https://github.com/cyberclutch146/talkies-web

## Overview

RCC Talkies is RCCIIT’s student journalism and media website. Visitors browse campus stories, events, members, and magazine issues; prospective members submit recruitment applications, and Agomoni participants submit event entries. Admin workflows manage applications and content, while APIs persist records and handle uploads. The graph preserves documented editorial, publication, recruitment, Agomoni, and admin capabilities; sampled route excerpts provide stronger evidence for some data paths than others, so unsampled subsystem links are omitted.

Main entry points: [`src/app/agomoni/actions.ts`](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/agomoni/actions.ts) (Participation action), [`src/lib/prisma.ts`](https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/prisma.ts) (Prisma database), [`src/app/page.tsx`](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/page.tsx) (Homepage and stories), [`src/app/magazine/page.tsx`](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/magazine/page.tsx) (Magazine catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_home["Homepage and stories<br/>[page.tsx]"]
  node_events["Event archive<br/>[page.tsx]"]
  node_magazines["Magazine catalog<br/>[page.tsx]"]
  node_reader["Magazine reader<br/>[page.tsx]"]
  node_members["Team profiles<br/>[page.tsx]"]
  node_contact["Contact page<br/>[page.tsx]"]
  node_home_ui["Homepage features<br/>[AboutCollege.tsx]"]
  node_instagram_ui["Instagram feed<br/>[InstagramFeed.tsx]"]
  node_flipbook["Flipbook viewer<br/>[FlipbookReader.tsx]"]
end

subgraph group_recruit["Recruitment"]
  node_join["Recruitment landing<br/>[page.tsx]"]
  node_positions["Role definitions<br/>[positions.ts]"]
  node_application_form["Application forms<br/>[page.tsx]"]
  node_application_route["Application endpoint<br/>[route.ts]"]
  node_app_validation["Application validation<br/>[application.ts]"]
end

subgraph group_agomoni["Agomoni event"]
  node_agomoni_page["Agomoni experience<br/>[page.tsx]"]
  node_chapters["Chapter experience"]
  node_paper["Interactive paper effect<br/>[PaperCrumple.tsx]"]
  node_participation["Participation form"]
  node_agomoni_actions["Participation action<br/>[actions.ts]"]
  node_agomoni_validation["Participation validation<br/>[agomoni.ts]"]
end

subgraph group_admin["Admin operations"]
  node_application_admin["Recruitment admin<br/>[page.tsx]"]
  node_export_utils["Application export<br/>[exportUtils.ts]"]
  node_agomoni_admin["Agomoni admin<br/>[page.tsx]"]
end

subgraph group_backend["Data and services"]
  node_api_magazines["Magazine API<br/>[route.ts]"]
  node_api_instagram["Instagram API<br/>[route.ts]"]
  node_api_inbox["Inbox API<br/>[route.ts]"]
  node_database[("Prisma database<br/>[prisma.ts]")]
  node_blob["Vercel Blob"]
  node_firebase["Firebase<br/>[firebase.ts]"]
  node_sheets["Google Sheets<br/>[google-sheets.ts]"]
end

node_visitor(("Site visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"browses"| node_home
node_visitor -->|"browses"| node_events
node_visitor -->|"browses"| node_magazines
node_visitor -->|"browses"| node_members
node_visitor -->|"visits"| node_contact
node_home -->|"renders"| node_home_ui
node_home -->|"renders"| node_instagram_ui
node_magazines -.->|"loads issues"| node_api_magazines
node_visitor -->|"opens issue"| node_reader
node_reader -.->|"renders"| node_flipbook
node_visitor -->|"explores roles"| node_join
node_join -->|"uses role list"| node_positions
node_visitor -->|"submits"| node_application_form
node_application_form -->|"posts application"| node_application_route
node_application_route -->|"validates with"| node_app_validation
node_app_validation -->|"checks roles"| node_positions
node_application_route -->|"creates record"| node_database
node_admin_user -->|"manages applicants"| node_application_admin
node_application_admin -->|"exports data"| node_export_utils
node_visitor -->|"experiences event"| node_agomoni_page
node_agomoni_page -.->|"presents chapters"| node_chapters
node_chapters -->|"uses effect"| node_paper
node_visitor -->|"submits entry"| node_participation
node_participation -->|"validates with"| node_agomoni_validation
node_participation -->|"calls action"| node_agomoni_actions
node_agomoni_actions -->|"validates with"| node_agomoni_validation
node_agomoni_actions -->|"uses service"| node_firebase
node_agomoni_actions -->|"uses service"| node_sheets
node_admin_user -.->|"manages entries"| node_agomoni_admin
node_magazines -.->|"requests issues"| node_api_magazines
node_api_magazines -->|"reads and writes"| node_database
node_instagram_ui -.->|"loads posts"| node_api_instagram
node_api_instagram -->|"reads and writes"| node_database
node_api_instagram -->|"uploads images"| node_blob
node_admin_user -.->|"manages messages"| node_api_inbox
node_api_inbox -->|"reads and updates"| node_database

click node_home "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/page.tsx"
click node_events "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/events/page.tsx"
click node_magazines "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/magazine/page.tsx"
click node_reader "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/magazine/%5Bid%5D/page.tsx"
click node_members "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/members/page.tsx"
click node_contact "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/contact/page.tsx"
click node_home_ui "https://github.com/cyberclutch146/talkies-web/blob/main/src/components/AboutCollege.tsx"
click node_instagram_ui "https://github.com/cyberclutch146/talkies-web/blob/main/src/components/InstagramFeed.tsx"
click node_flipbook "https://github.com/cyberclutch146/talkies-web/blob/main/src/components/FlipbookReader.tsx"
click node_join "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/join/page.tsx"
click node_positions "https://github.com/cyberclutch146/talkies-web/blob/main/src/data/positions.ts"
click node_application_form "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/join/leads/page.tsx"
click node_application_route "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/apply/route.ts"
click node_app_validation "https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/validations/application.ts"
click node_application_admin "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/admin/recruitment/page.tsx"
click node_export_utils "https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/exportUtils.ts"
click node_agomoni_page "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/agomoni/page.tsx"
click node_chapters "https://github.com/cyberclutch146/talkies-web/blob/main/src/components/agomoni/AgomoniChapters.tsx"
click node_paper "https://github.com/cyberclutch146/talkies-web/blob/main/src/components/agomoni/PaperCrumple.tsx"
click node_participation "https://github.com/cyberclutch146/talkies-web/blob/main/src/components/agomoni/ParticipationForm.tsx"
click node_agomoni_actions "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/agomoni/actions.ts"
click node_agomoni_validation "https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/validations/agomoni.ts"
click node_agomoni_admin "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/admin/agomoni/page.tsx"
click node_api_magazines "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/magazines/route.ts"
click node_api_instagram "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/instagram/route.ts"
click node_api_inbox "https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/inbox/route.ts"
click node_database "https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/prisma.ts"
click node_firebase "https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/firebase.ts"
click node_sheets "https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/google-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_home,node_events,node_magazines,node_reader,node_members,node_contact,node_home_ui,node_instagram_ui,node_flipbook toneBlue
class node_join,node_positions,node_application_form,node_application_route,node_app_validation toneAmber
class node_agomoni_page,node_chapters,node_paper,node_participation,node_agomoni_actions,node_agomoni_validation toneMint
class node_application_admin,node_export_utils,node_agomoni_admin toneRose
class node_api_magazines,node_api_instagram,node_api_inbox,node_database,node_blob,node_firebase,node_sheets,node_visitor,node_admin_user toneIndigo
```

## Components

### Public site

- [Homepage and stories](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Event archive](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/events/page.tsx): `src/app/events/page.tsx`
- [Magazine catalog](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/magazine/page.tsx): `src/app/magazine/page.tsx`
- [Magazine reader](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/magazine/%5Bid%5D/page.tsx): `src/app/magazine/[id]/page.tsx`
- [Team profiles](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/members/page.tsx): `src/app/members/page.tsx`
- [Contact page](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/contact/page.tsx): `src/app/contact/page.tsx`
- [Homepage features](https://github.com/cyberclutch146/talkies-web/blob/main/src/components/AboutCollege.tsx): `src/components/AboutCollege.tsx`
- [Instagram feed](https://github.com/cyberclutch146/talkies-web/blob/main/src/components/InstagramFeed.tsx): `src/components/InstagramFeed.tsx`
- [Flipbook viewer](https://github.com/cyberclutch146/talkies-web/blob/main/src/components/FlipbookReader.tsx): `src/components/FlipbookReader.tsx`

### Recruitment

- [Recruitment landing](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/join/page.tsx): `src/app/join/page.tsx`
- [Role definitions](https://github.com/cyberclutch146/talkies-web/blob/main/src/data/positions.ts): `src/data/positions.ts`
- [Application forms](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/join/leads/page.tsx): `src/app/join/leads/page.tsx`
- [Application endpoint](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/apply/route.ts): `src/app/api/apply/route.ts`
- [Application validation](https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/validations/application.ts): `src/lib/validations/application.ts`

### Agomoni event

- [Agomoni experience](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/agomoni/page.tsx): `src/app/agomoni/page.tsx`
- [Chapter experience](https://github.com/cyberclutch146/talkies-web/blob/main/src/components/agomoni/AgomoniChapters.tsx): `src/components/agomoni/AgomoniChapters.tsx`
- [Interactive paper effect](https://github.com/cyberclutch146/talkies-web/blob/main/src/components/agomoni/PaperCrumple.tsx): `src/components/agomoni/PaperCrumple.tsx`
- [Participation form](https://github.com/cyberclutch146/talkies-web/blob/main/src/components/agomoni/ParticipationForm.tsx): `src/components/agomoni/ParticipationForm.tsx`
- [Participation action](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/agomoni/actions.ts): `src/app/agomoni/actions.ts`
- [Participation validation](https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/validations/agomoni.ts): `src/lib/validations/agomoni.ts`

### Admin operations

- [Recruitment admin](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/admin/recruitment/page.tsx): `src/app/admin/recruitment/page.tsx`
- [Application export](https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/exportUtils.ts): `src/lib/exportUtils.ts`
- [Agomoni admin](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/admin/agomoni/page.tsx): `src/app/admin/agomoni/page.tsx`

### Data and services

- [Magazine API](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/magazines/route.ts): `src/app/api/magazines/route.ts`
- [Instagram API](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/instagram/route.ts): `src/app/api/instagram/route.ts`
- [Inbox API](https://github.com/cyberclutch146/talkies-web/blob/main/src/app/api/inbox/route.ts): `src/app/api/inbox/route.ts`
- [Prisma database](https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- **Vercel Blob**
- [Firebase](https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- [Google Sheets](https://github.com/cyberclutch146/talkies-web/blob/main/src/lib/google-sheets.ts): `src/lib/google-sheets.ts`

### Other components

- **Site visitor**
- **Administrator**

## Connections

- Site visitor → Homepage and stories: browses
- Site visitor → Event archive: browses
- Site visitor → Magazine catalog: browses
- Site visitor → Team profiles: browses
- Site visitor → Contact page: visits
- Homepage and stories → Homepage features: renders (evidence: `src/app/page.tsx`)
- Homepage and stories → Instagram feed: renders (evidence: `src/app/page.tsx`)
- Magazine catalog → Magazine API: loads issues
- Site visitor → Magazine reader: opens issue
- Magazine reader → Flipbook viewer: renders
- Site visitor → Recruitment landing: explores roles
- Recruitment landing → Role definitions: uses role list (evidence: `src/data/positions.ts`)
- Site visitor → Application forms: submits
- Application forms → Application endpoint: posts application
- Application endpoint → Application validation: validates with (evidence: `src/app/api/apply/route.ts`)
- Application validation → Role definitions: checks roles (evidence: `src/lib/validations/application.ts`)
- Application endpoint → Prisma database: creates record (evidence: `src/app/api/apply/route.ts`)
- Administrator → Recruitment admin: manages applicants
- Recruitment admin → Application export: exports data (evidence: `src/app/admin/recruitment/page.tsx`)
- Site visitor → Agomoni experience: experiences event
- Agomoni experience → Chapter experience: presents chapters
- Chapter experience → Interactive paper effect: uses effect (evidence: `src/components/agomoni/AgomoniChapters.tsx`)
- Site visitor → Participation form: submits entry
- Participation form → Participation validation: validates with (evidence: `src/components/agomoni/ParticipationForm.tsx`)
- Participation form → Participation action: calls action (evidence: `src/components/agomoni/ParticipationForm.tsx`)
- Participation action → Participation validation: validates with (evidence: `src/app/agomoni/actions.ts`)
- Participation action → Firebase: uses service (evidence: `src/app/agomoni/actions.ts`)
- Participation action → Google Sheets: uses service (evidence: `src/app/agomoni/actions.ts`)
- Administrator → Agomoni admin: manages entries
- Magazine catalog → Magazine API: requests issues
- Magazine API → Prisma database: reads and writes (evidence: `src/app/api/magazines/route.ts`)
- Instagram feed → Instagram API: loads posts
- Instagram API → Prisma database: reads and writes (evidence: `src/app/api/instagram/route.ts`)
- Instagram API → Vercel Blob: uploads images (evidence: `src/app/api/instagram/route.ts`)
- Administrator → Inbox API: manages messages
- Inbox API → Prisma database: reads and updates (evidence: `src/app/api/inbox/route.ts`)
