# gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system architecture

> Architecture diagram of the GitHub repository gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system
- Repository: https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system

## Overview

Campus Pulse is a campus feedback portal: students authenticate, submit feedback about courses, events, or facilities, and view their submission history; administrators review anonymized feedback, summary metrics, and sentiment visualizations. Submission handling validates and stores feedback, then classifies it; an admin or author can request analysis again. The graph preserves the indexed UI, domain, and Supabase modules. Evidence is limited to the README and sampled excerpts, so unsampled signup, classification internals, and other wiring are not asserted.

Main entry points: [`app/admin/page.tsx`](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/admin/page.tsx) (Admin dashboard), [`lib/supabase/admin.ts`](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/supabase/admin.ts) (Admin database client), [`app/api/feedback/route.ts`](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/feedback/route.ts) (Feedback endpoint), [`lib/auth.ts`](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/auth.ts) (Auth helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_login_page["Login page<br/>[page.tsx]"]
  node_signup_page["Signup page<br/>[page.tsx]"]
  node_feedback_page["Submission page<br/>[page.tsx]"]
  node_feedback_form["Feedback form<br/>[FeedbackForm.tsx]"]
  node_history_page["Submission history<br/>[page.tsx]"]
  node_admin_page["Admin dashboard<br/>[page.tsx]"]
  node_summary_cards["Summary cards<br/>[SummaryCards.tsx]"]
  node_sentiment_chart["Sentiment chart<br/>[SentimentChart.tsx]"]
  node_sentiment_badge["Sentiment badge<br/>[SentimentBadge.tsx]"]
  node_logout["Logout control<br/>[LogoutButton.tsx]"]
  node_theme["Theme toggle<br/>[ThemeToggle.tsx]"]
end

subgraph group_routes["API routes"]
  node_auth_login["Login endpoint<br/>[route.ts]"]
  node_auth_signup["Signup endpoint<br/>[route.ts]"]
  node_auth_logout["Logout endpoint<br/>[route.ts]"]
  node_feedback_api["Feedback endpoint<br/>[route.ts]"]
  node_analyze_api["Analysis endpoint<br/>[route.ts]"]
  node_admin_feedback_api["Admin feedback endpoint<br/>[route.ts]"]
  node_admin_summary_api["Admin summary endpoint<br/>[route.ts]"]
end

subgraph group_domain["Domain logic"]
  node_auth_logic["Auth helpers<br/>[auth.ts]"]
  node_validation["Input validation<br/>[validation.ts]"]
  node_targets["Feedback targets<br/>[targets.ts]"]
  node_classifier["Sentiment classifier<br/>[classify.ts]"]
  node_db_types["Feedback data types<br/>[database.ts]"]
end

subgraph group_data["Data access"]
  node_admin_client["Admin database client<br/>[admin.ts]"]
  node_server_client["Server Supabase client<br/>[server.ts]"]
  node_browser_client["Browser Supabase client<br/>[client.ts]"]
  node_supabase_store[("Supabase data store<br/>[schema.sql]")]
end

node_student(("Student"))
node_admin(("Administrator"))
node_gemini["Google Gemini"]

node_student -->|"opens"| node_login_page
node_student -->|"opens"| node_signup_page
node_login_page -.->|"submits credentials"| node_auth_login
node_signup_page -.->|"submits registration"| node_auth_signup
node_student -->|"opens"| node_feedback_page
node_feedback_page -->|"renders"| node_feedback_form
node_feedback_page -->|"requires authentication"| node_auth_logic
node_student -->|"opens"| node_history_page
node_history_page -->|"fetches history"| node_feedback_api
node_admin -->|"opens"| node_admin_page
node_admin_page -->|"fetches totals"| node_admin_summary_api
node_admin_page -->|"fetches feedback"| node_admin_feedback_api
node_admin_page -->|"renders"| node_summary_cards
node_admin_page -->|"renders"| node_sentiment_chart
node_admin_page -->|"renders"| node_sentiment_badge
node_history_page -->|"renders"| node_sentiment_badge
node_feedback_api -->|"checks user"| node_auth_logic
node_feedback_api -->|"validates submission"| node_validation
node_feedback_api -->|"queries and writes"| node_admin_client
node_feedback_api -->|"classifies feedback"| node_classifier
node_analyze_api -->|"checks permissions"| node_auth_logic
node_analyze_api -->|"reads and updates"| node_admin_client
node_analyze_api -->|"classifies feedback"| node_classifier
node_admin_feedback_api -->|"checks admin"| node_auth_logic
node_admin_feedback_api -->|"reads feedback"| node_admin_client
node_admin_summary_api -->|"checks admin"| node_auth_logic
node_admin_summary_api -->|"reads feedback"| node_admin_client
node_auth_login -->|"validates credentials"| node_validation
node_auth_login -->|"signs in"| node_server_client
node_auth_login -->|"loads profile"| node_admin_client
node_auth_logout -->|"uses session client"| node_server_client
node_server_client -->|"uses URL helper"| node_browser_client
node_admin_client -.->|"accesses data"| node_supabase_store
node_classifier -.->|"classifies with"| node_gemini

click node_login_page "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/(auth)/login/page.tsx"
click node_signup_page "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/(auth)/signup/page.tsx"
click node_feedback_page "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/feedback/page.tsx"
click node_feedback_form "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/FeedbackForm.tsx"
click node_history_page "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/feedback/history/page.tsx"
click node_admin_page "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/admin/page.tsx"
click node_summary_cards "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/SummaryCards.tsx"
click node_sentiment_chart "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/SentimentChart.tsx"
click node_sentiment_badge "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/SentimentBadge.tsx"
click node_logout "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/LogoutButton.tsx"
click node_theme "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/ThemeToggle.tsx"
click node_auth_login "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/auth/login/route.ts"
click node_auth_signup "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/auth/signup/route.ts"
click node_auth_logout "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/auth/logout/route.ts"
click node_feedback_api "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/feedback/route.ts"
click node_analyze_api "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/feedback/%5Bid%5D/analyze/route.ts"
click node_admin_feedback_api "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/admin/feedback/route.ts"
click node_admin_summary_api "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/admin/summary/route.ts"
click node_auth_logic "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/auth.ts"
click node_validation "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/validation.ts"
click node_targets "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/targets.ts"
click node_classifier "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/ai/classify.ts"
click node_db_types "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/types/database.ts"
click node_admin_client "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/supabase/admin.ts"
click node_server_client "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/supabase/server.ts"
click node_browser_client "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/supabase/client.ts"
click node_supabase_store "https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/supabase/schema.sql"

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_login_page,node_signup_page,node_feedback_page,node_feedback_form,node_history_page,node_admin_page,node_summary_cards,node_sentiment_chart,node_sentiment_badge,node_logout,node_theme toneBlue
class node_auth_login,node_auth_signup,node_auth_logout,node_feedback_api,node_analyze_api,node_admin_feedback_api,node_admin_summary_api toneAmber
class node_auth_logic,node_validation,node_targets,node_classifier,node_db_types toneMint
class node_admin_client,node_server_client,node_browser_client,node_supabase_store toneRose
class node_student,node_admin,node_gemini toneIndigo
```

## Components

### User experience

- [Login page](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/(auth)/login/page.tsx): `app/(auth)/login/page.tsx`
- [Signup page](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/(auth)/signup/page.tsx): `app/(auth)/signup/page.tsx`
- [Submission page](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/feedback/page.tsx): `app/feedback/page.tsx`
- [Feedback form](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/FeedbackForm.tsx): `components/FeedbackForm.tsx`
- [Submission history](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/feedback/history/page.tsx): `app/feedback/history/page.tsx`
- [Admin dashboard](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Summary cards](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/SummaryCards.tsx): `components/SummaryCards.tsx`
- [Sentiment chart](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/SentimentChart.tsx): `components/SentimentChart.tsx`
- [Sentiment badge](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/SentimentBadge.tsx): `components/SentimentBadge.tsx`
- [Logout control](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/LogoutButton.tsx): `components/LogoutButton.tsx`
- [Theme toggle](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/components/ThemeToggle.tsx): `components/ThemeToggle.tsx`

### API routes

- [Login endpoint](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/auth/login/route.ts): `app/api/auth/login/route.ts`
- [Signup endpoint](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/auth/signup/route.ts): `app/api/auth/signup/route.ts`
- [Logout endpoint](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/auth/logout/route.ts): `app/api/auth/logout/route.ts`
- [Feedback endpoint](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/feedback/route.ts): `app/api/feedback/route.ts`
- [Analysis endpoint](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/feedback/%5Bid%5D/analyze/route.ts): `app/api/feedback/[id]/analyze/route.ts`
- [Admin feedback endpoint](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/admin/feedback/route.ts): `app/api/admin/feedback/route.ts`
- [Admin summary endpoint](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/app/api/admin/summary/route.ts): `app/api/admin/summary/route.ts`

### Domain logic

- [Auth helpers](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/auth.ts): `lib/auth.ts`
- [Input validation](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/validation.ts): `lib/validation.ts`
- [Feedback targets](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/targets.ts): `lib/targets.ts`
- [Sentiment classifier](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/ai/classify.ts): `lib/ai/classify.ts`
- [Feedback data types](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/types/database.ts): `types/database.ts`

### Data access

- [Admin database client](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/supabase/admin.ts): `lib/supabase/admin.ts`
- [Server Supabase client](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Browser Supabase client](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`
- [Supabase data store](https://github.com/gokkul-ks/hackthecloud-cloud-based-campus-feedback-sentiment-analysis-system/blob/main/supabase/schema.sql): `supabase/schema.sql`

### Other components

- **Student**
- **Administrator**
- **Google Gemini**

## Connections

- Student → Login page: opens
- Student → Signup page: opens
- Login page → Login endpoint: submits credentials
- Signup page → Signup endpoint: submits registration
- Student → Submission page: opens (evidence: `app/feedback/page.tsx`)
- Submission page → Feedback form: renders (evidence: `app/feedback/page.tsx`)
- Submission page → Auth helpers: requires authentication (evidence: `app/feedback/page.tsx`)
- Student → Submission history: opens (evidence: `app/feedback/history/page.tsx`)
- Submission history → Feedback endpoint: fetches history (evidence: `app/feedback/history/page.tsx`)
- Administrator → Admin dashboard: opens (evidence: `app/admin/page.tsx`)
- Admin dashboard → Admin summary endpoint: fetches totals (evidence: `app/admin/page.tsx`)
- Admin dashboard → Admin feedback endpoint: fetches feedback (evidence: `app/admin/page.tsx`)
- Admin dashboard → Summary cards: renders (evidence: `app/admin/page.tsx`)
- Admin dashboard → Sentiment chart: renders (evidence: `app/admin/page.tsx`)
- Admin dashboard → Sentiment badge: renders (evidence: `app/admin/page.tsx`)
- Submission history → Sentiment badge: renders (evidence: `app/feedback/history/page.tsx`)
- Feedback endpoint → Auth helpers: checks user (evidence: `app/api/feedback/route.ts`)
- Feedback endpoint → Input validation: validates submission (evidence: `app/api/feedback/route.ts`)
- Feedback endpoint → Admin database client: queries and writes (evidence: `app/api/feedback/route.ts`)
- Feedback endpoint → Sentiment classifier: classifies feedback (evidence: `app/api/feedback/route.ts`)
- Analysis endpoint → Auth helpers: checks permissions (evidence: `app/api/feedback/[id]/analyze/route.ts`)
- Analysis endpoint → Admin database client: reads and updates (evidence: `app/api/feedback/[id]/analyze/route.ts`)
- Analysis endpoint → Sentiment classifier: classifies feedback (evidence: `app/api/feedback/[id]/analyze/route.ts`)
- Admin feedback endpoint → Auth helpers: checks admin (evidence: `app/api/admin/feedback/route.ts`)
- Admin feedback endpoint → Admin database client: reads feedback (evidence: `app/api/admin/feedback/route.ts`)
- Admin summary endpoint → Auth helpers: checks admin (evidence: `app/api/admin/summary/route.ts`)
- Admin summary endpoint → Admin database client: reads feedback (evidence: `app/api/admin/summary/route.ts`)
- Login endpoint → Input validation: validates credentials (evidence: `app/api/auth/login/route.ts`)
- Login endpoint → Server Supabase client: signs in (evidence: `app/api/auth/login/route.ts`)
- Login endpoint → Admin database client: loads profile (evidence: `app/api/auth/login/route.ts`)
- Logout endpoint → Server Supabase client: uses session client (evidence: `app/api/auth/logout/route.ts`)
- Server Supabase client → Browser Supabase client: uses URL helper (evidence: `lib/supabase/server.ts`)
- Admin database client → Supabase data store: accesses data
- Sentiment classifier → Google Gemini: classifies with
