# ayas-kumar-das/campuspulse-ai architecture

> Architecture diagram of the GitHub repository ayas-kumar-das/campuspulse-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayas-kumar-das/campuspulse-ai
- Repository: https://github.com/ayas-kumar-das/campuspulse-ai

## Overview

CampusPulse AI is a Next.js campus-opportunity website. Students browse profile-personalized notices, assess eligibility and impact, then follow action plans and schedule deadlines; staff can turn notice text into reviewed feed entries. The graph preserves the documented calendar, assistant, email, resume, analytics and focus capabilities. Edges are limited to relationships visible in excerpts, the source index, or README; some UI-to-route wiring and unsampled feature internals are not shown.

Main entry points: [`components/campus-app.tsx`](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/campus-app.tsx) (Campus workspace), [`app/api/analyze/route.ts`](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/app/api/analyze/route.ts) (Analyze endpoint), [`lib/intelligence.ts`](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/intelligence.ts) (Impact and action engine), [`lib/data.ts`](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/data.ts) (Notice and eligibility data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Campus experience"]
  node_app_shell["Campus workspace<br/>[campus-app.tsx]"]
  node_mail["College inbox<br/>[college-mail.tsx]"]
  node_assistant["Decision assistant"]
  node_opportunity_ui["Opportunity details"]
  node_intelligence_ui["Planning panels"]
  node_resume_ui["Resume controls<br/>[resume-upload.tsx]"]
end

subgraph group_opportunities["Opportunity intelligence"]
end

subgraph group_notice_ops["Notice operations"]
  node_notice_admin["Notice studio<br/>[notice-admin.tsx]"]
  node_notice_analyzer["Notice review"]
  node_analyze_api["Analyze endpoint<br/>[route.ts]"]
  node_extractor["Notice extraction<br/>[analyzer.ts]"]
end

subgraph group_integrations["AI and local integrations"]
  node_query_api["Query endpoint<br/>[route.ts]"]
  node_ai_service["Structured AI<br/>[server-ai.ts]"]
  node_resume_store[("Resume storage<br/>[resume-store.ts]")]
  node_gemini{{"Gemini API"}}
  node_browser_state[("Browser-local state")]
  node_calendar_services{{"Calendar services"}}
end

subgraph group_domain["Domain logic"]
  node_data_rules["Notice and eligibility data<br/>[data.ts]"]
  node_decision_engine["Impact and action engine<br/>[intelligence.ts]"]
  node_query_logic["Assistant matching<br/>[query.ts]"]
  node_calendar["Calendar reminders<br/>[data.ts]"]
end

node_student(("Student"))
node_staff(("Notice staff"))

node_student -->|"uses"| node_app_shell
node_staff -->|"uses"| node_app_shell
node_app_shell -->|"renders"| node_opportunity_ui
node_app_shell -->|"renders"| node_notice_admin
node_app_shell -->|"renders"| node_intelligence_ui
node_app_shell -->|"renders"| node_resume_ui
node_app_shell -->|"renders"| node_mail
node_app_shell -->|"renders"| node_assistant
node_app_shell -->|"loads notices"| node_data_rules
node_app_shell -->|"loads resume"| node_resume_store
node_opportunity_ui -->|"uses eligibility"| node_data_rules
node_opportunity_ui -->|"shows impact"| node_decision_engine
node_intelligence_ui -->|"computes plans"| node_decision_engine
node_assistant -->|"matches question"| node_query_logic
node_assistant -->|"requests explanation"| node_query_api
node_query_logic -->|"ranks opportunities"| node_decision_engine
node_query_logic -->|"checks eligibility"| node_data_rules
node_notice_admin -.->|"opens analysis"| node_notice_analyzer
node_notice_admin -->|"publishes notices"| node_browser_state
node_notice_analyzer -.->|"submits text"| node_analyze_api
node_notice_analyzer -->|"builds notice"| node_extractor
node_analyze_api -->|"extracts fields"| node_extractor
node_analyze_api -->|"requests extraction"| node_ai_service
node_mail -.->|"analyzes email"| node_analyze_api
node_mail -->|"converts result"| node_extractor
node_ai_service -.->|"generates output"| node_gemini
node_query_api -->|"requests response"| node_ai_service
node_resume_ui -->|"saves files"| node_resume_store
node_app_shell -->|"creates reminders"| node_calendar
node_calendar -->|"opens event"| node_calendar_services
node_decision_engine -->|"checks rules"| node_data_rules

click node_app_shell "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/campus-app.tsx"
click node_mail "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/college-mail.tsx"
click node_assistant "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/decision-assistant.tsx"
click node_opportunity_ui "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/opportunity-card.tsx"
click node_intelligence_ui "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/intelligence-panels.tsx"
click node_resume_ui "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/resume-upload.tsx"
click node_notice_admin "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/notice-admin.tsx"
click node_notice_analyzer "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/notice-analyzer.tsx"
click node_analyze_api "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/app/api/analyze/route.ts"
click node_extractor "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/analyzer.ts"
click node_query_api "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/app/api/query/route.ts"
click node_ai_service "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/server-ai.ts"
click node_resume_store "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/resume-store.ts"
click node_data_rules "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/data.ts"
click node_decision_engine "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/intelligence.ts"
click node_query_logic "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/query.ts"
click node_calendar "https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/data.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_app_shell,node_mail,node_assistant,node_opportunity_ui,node_intelligence_ui,node_resume_ui toneBlue
class node_notice_admin,node_notice_analyzer,node_analyze_api,node_extractor toneMint
class node_query_api,node_ai_service,node_resume_store,node_gemini,node_browser_state,node_calendar_services toneRose
class node_data_rules,node_decision_engine,node_query_logic,node_calendar,node_student,node_staff toneIndigo
```

## Components

### Campus experience

- [Campus workspace](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/campus-app.tsx): `components/campus-app.tsx`
- [College inbox](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/college-mail.tsx): `components/college-mail.tsx`
- [Decision assistant](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/decision-assistant.tsx): `components/decision-assistant.tsx`
- [Opportunity details](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/opportunity-card.tsx): `components/opportunity-card.tsx`
- [Planning panels](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/intelligence-panels.tsx): `components/intelligence-panels.tsx`
- [Resume controls](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/resume-upload.tsx): `components/resume-upload.tsx`

### Notice operations

- [Notice studio](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/notice-admin.tsx): `components/notice-admin.tsx`
- [Notice review](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/components/notice-analyzer.tsx): `components/notice-analyzer.tsx`
- [Analyze endpoint](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/app/api/analyze/route.ts): `app/api/analyze/route.ts`
- [Notice extraction](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/analyzer.ts): `lib/analyzer.ts`

### AI and local integrations

- [Query endpoint](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/app/api/query/route.ts): `app/api/query/route.ts`
- [Structured AI](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/server-ai.ts): `lib/server-ai.ts`
- [Resume storage](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/resume-store.ts): `lib/resume-store.ts`
- **Gemini API**
- **Browser-local state**
- **Calendar services**

### Domain logic

- [Notice and eligibility data](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/data.ts): `lib/data.ts`
- [Impact and action engine](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/intelligence.ts): `lib/intelligence.ts`
- [Assistant matching](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/query.ts): `lib/query.ts`
- [Calendar reminders](https://github.com/ayas-kumar-das/campuspulse-ai/blob/master/lib/data.ts): `lib/data.ts`

### Other components

- **Student**
- **Notice staff**

## Connections

- Student → Campus workspace: uses (evidence: `README.md`)
- Notice staff → Campus workspace: uses (evidence: `README.md`)
- Campus workspace → Opportunity details: renders (evidence: `components/campus-app.tsx`)
- Campus workspace → Notice studio: renders (evidence: `components/campus-app.tsx`)
- Campus workspace → Planning panels: renders (evidence: `components/campus-app.tsx`)
- Campus workspace → Resume controls: renders (evidence: `components/campus-app.tsx`)
- Campus workspace → College inbox: renders (evidence: `components/campus-app.tsx`)
- Campus workspace → Decision assistant: renders (evidence: `components/campus-app.tsx`)
- Campus workspace → Notice and eligibility data: loads notices (evidence: `components/campus-app.tsx`)
- Campus workspace → Resume storage: loads resume (evidence: `components/campus-app.tsx`)
- Opportunity details → Notice and eligibility data: uses eligibility (evidence: `components/opportunity-card.tsx`)
- Opportunity details → Impact and action engine: shows impact (evidence: `components/opportunity-card.tsx`)
- Planning panels → Impact and action engine: computes plans (evidence: `components/intelligence-panels.tsx`)
- Decision assistant → Assistant matching: matches question (evidence: `components/decision-assistant.tsx`)
- Decision assistant → Query endpoint: requests explanation (evidence: `README.md`)
- Assistant matching → Impact and action engine: ranks opportunities (evidence: `lib/query.ts`)
- Assistant matching → Notice and eligibility data: checks eligibility (evidence: `lib/query.ts`)
- Notice studio → Notice review: opens analysis
- Notice studio → Browser-local state: publishes notices (evidence: `README.md`)
- Notice review → Analyze endpoint: submits text
- Notice review → Notice extraction: builds notice (evidence: `components/notice-analyzer.tsx`)
- Analyze endpoint → Notice extraction: extracts fields (evidence: `app/api/analyze/route.ts`)
- Analyze endpoint → Structured AI: requests extraction (evidence: `app/api/analyze/route.ts`)
- College inbox → Analyze endpoint: analyzes email
- College inbox → Notice extraction: converts result (evidence: `components/college-mail.tsx`)
- Structured AI → Gemini API: generates output (evidence: `lib/server-ai.ts`)
- Query endpoint → Structured AI: requests response (evidence: `app/api/query/route.ts`)
- Resume controls → Resume storage: saves files (evidence: `components/resume-upload.tsx`)
- Campus workspace → Calendar reminders: creates reminders (evidence: `README.md`)
- Calendar reminders → Calendar services: opens event (evidence: `README.md`)
- Impact and action engine → Notice and eligibility data: checks rules (evidence: `lib/intelligence.ts`)
