# mtaha-23/fast-connect architecture

> Architecture diagram of the GitHub repository mtaha-23/fast-connect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mtaha-23/fast-connect
- Repository: https://github.com/mtaha-23/fast-connect

## Overview

FASTConnect is a student portal combining account access, academic tools, shared learning resources, community posts, and campus discovery, with administration for users and content. The main user journey is sign-in, enter the dashboard, and use a feature such as course advising, practice tests, chat, or resources. Firebase provides authentication and data services; Cloudinary handles resource uploads. The README identifies Python dependencies for Batch Advisor, but the sampled material does not expose its request wiring, so that connection is left unverified. Several feature links are based on SOURCE INDEX references rather than inspected implementation.

Main entry points: [`app/dashboard/page.tsx`](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/page.tsx) (Student Dashboard), [`lib/firebase.ts`](https://github.com/mtaha-23/fast-connect/blob/main/lib/firebase.ts) (Firebase Setup), [`app/login/page.tsx`](https://github.com/mtaha-23/fast-connect/blob/main/app/login/page.tsx) (Login and Signup), [`lib/services/auth.service.ts`](https://github.com/mtaha-23/fast-connect/blob/main/lib/services/auth.service.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Shell"]
  node_landing["Public Site<br/>[page.tsx]"]
  node_authpages["Login and Signup<br/>[page.tsx]"]
  node_authforms["Auth Forms<br/>[login-form.tsx]"]
  node_dashboard["Student Dashboard<br/>[page.tsx]"]
end

subgraph group_learning["Academic Tools"]
  node_batchui["Batch Advisor<br/>[page.tsx]"]
  node_batchapi["Advisor API<br/>[route.ts]"]
  node_pythonadvisor["Python Advisor<br/>[process.py]"]
  node_testpractice["Test Practice<br/>[page.tsx]"]
  node_session["Test Sessions<br/>[test-session.ts]"]
  node_chatui["Chat Assistant<br/>[page.tsx]"]
  node_chatapi["Chat API<br/>[route.ts]"]
  node_rag["RAG Chat Server<br/>[server.py]"]
end

subgraph group_community["Community and Resources"]
  node_feed["Community Feed<br/>[page.tsx]"]
  node_postsapi["Posts API<br/>[route.ts]"]
  node_resourcesui["Resource Library<br/>[page.tsx]"]
  node_resourcesapi["Resources API<br/>[route.ts]"]
  node_resourceupload["Resource Upload<br/>[route.ts]"]
  node_tour["Campus Tour<br/>[page.tsx]"]
  node_tourapi["Tour Locations API<br/>[route.ts]"]
end

subgraph group_operations["Administration"]
  node_admin["Admin Console<br/>[page.tsx]"]
  node_adminposts["Post Management<br/>[page.tsx]"]
  node_adminresources["Resource Management<br/>[page.tsx]"]
  node_adminusers["User Management<br/>[page.tsx]"]
end

subgraph group_platform["Services and Data"]
  node_authservice["Authentication<br/>[auth.service.ts]"]
  node_firebase["Firebase Setup<br/>[firebase.ts]"]
  node_questionservice["Question Service"]
  node_postservice["Post Service<br/>[post.service.ts]"]
  node_resourceservice["Resource Service"]
  node_cloudinary["Cloudinary Storage<br/>[cloudinary.ts]"]
  node_analytics["Analytics Service"]
  node_firestore[("Firestore")]
end

node_visitor(("Visitor / Student"))

node_visitor -->|"opens"| node_landing
node_visitor -->|"signs in"| node_authpages
node_authpages -->|"renders"| node_authforms
node_authforms -->|"authenticates"| node_authservice
node_authservice -->|"gets clients"| node_firebase
node_authservice -->|"reads and writes"| node_firestore
node_authpages -.->|"enters"| node_dashboard
node_dashboard -.->|"opens"| node_batchui
node_batchui -.->|"requests advice"| node_batchapi
node_batchapi -.->|"invokes"| node_pythonadvisor
node_dashboard -.->|"opens"| node_testpractice
node_questionservice -->|"uses"| node_firebase
node_questionservice -->|"loads questions"| node_firestore
node_dashboard -.->|"opens"| node_chatui
node_chatui -.->|"sends messages"| node_chatapi
node_chatapi -.->|"forwards queries"| node_rag
node_dashboard -.->|"opens"| node_feed
node_postsapi -->|"delegates"| node_postservice
node_postservice -->|"uses"| node_firebase
node_dashboard -.->|"opens"| node_resourcesui
node_resourcesapi -->|"delegates"| node_resourceservice
node_resourceupload -->|"uploads files"| node_cloudinary
node_resourceservice -.->|"uses"| node_firebase
node_dashboard -.->|"opens"| node_tour
node_tour -.->|"loads locations"| node_tourapi
node_admin -->|"reads metrics"| node_firestore
node_adminposts -->|"manages posts"| node_postservice
node_adminresources -->|"logs events"| node_analytics
node_adminusers -.->|"manages users"| node_admin

click node_landing "https://github.com/mtaha-23/fast-connect/blob/main/app/page.tsx"
click node_authpages "https://github.com/mtaha-23/fast-connect/blob/main/app/login/page.tsx"
click node_authforms "https://github.com/mtaha-23/fast-connect/blob/main/components/login-form.tsx"
click node_authservice "https://github.com/mtaha-23/fast-connect/blob/main/lib/services/auth.service.ts"
click node_firebase "https://github.com/mtaha-23/fast-connect/blob/main/lib/firebase.ts"
click node_dashboard "https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/page.tsx"
click node_batchui "https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/batch-advisor/page.tsx"
click node_batchapi "https://github.com/mtaha-23/fast-connect/blob/main/app/api/batch-advisor/route.ts"
click node_pythonadvisor "https://github.com/mtaha-23/fast-connect/blob/main/python-backend/process.py"
click node_testpractice "https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/test-practice/page.tsx"
click node_questionservice "https://github.com/mtaha-23/fast-connect/blob/main/lib/services/question.service.ts"
click node_session "https://github.com/mtaha-23/fast-connect/blob/main/lib/server/test-session.ts"
click node_chatui "https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/chatbot/page.tsx"
click node_chatapi "https://github.com/mtaha-23/fast-connect/blob/main/app/api/chat/route.ts"
click node_rag "https://github.com/mtaha-23/fast-connect/blob/main/chatbot_files/server.py"
click node_feed "https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/feed/page.tsx"
click node_postsapi "https://github.com/mtaha-23/fast-connect/blob/main/app/api/posts/route.ts"
click node_postservice "https://github.com/mtaha-23/fast-connect/blob/main/lib/services/post.service.ts"
click node_resourcesui "https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/resources/page.tsx"
click node_resourcesapi "https://github.com/mtaha-23/fast-connect/blob/main/app/api/resources/route.ts"
click node_resourceupload "https://github.com/mtaha-23/fast-connect/blob/main/app/api/resources/upload/route.ts"
click node_resourceservice "https://github.com/mtaha-23/fast-connect/blob/main/lib/services/resource.service.ts"
click node_cloudinary "https://github.com/mtaha-23/fast-connect/blob/main/lib/cloudinary.ts"
click node_tour "https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/tour/page.tsx"
click node_tourapi "https://github.com/mtaha-23/fast-connect/blob/main/app/api/tour-locations/route.ts"
click node_admin "https://github.com/mtaha-23/fast-connect/blob/main/app/admin/page.tsx"
click node_adminposts "https://github.com/mtaha-23/fast-connect/blob/main/app/admin/posts/page.tsx"
click node_adminresources "https://github.com/mtaha-23/fast-connect/blob/main/app/admin/resources/page.tsx"
click node_adminusers "https://github.com/mtaha-23/fast-connect/blob/main/app/admin/users/page.tsx"
click node_analytics "https://github.com/mtaha-23/fast-connect/blob/main/lib/services/analytics.service.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_landing,node_authpages,node_authforms,node_dashboard toneBlue
class node_batchui,node_batchapi,node_pythonadvisor,node_testpractice,node_session,node_chatui,node_chatapi,node_rag toneAmber
class node_feed,node_postsapi,node_resourcesui,node_resourcesapi,node_resourceupload,node_tour,node_tourapi toneMint
class node_admin,node_adminposts,node_adminresources,node_adminusers toneRose
class node_authservice,node_firebase,node_questionservice,node_postservice,node_resourceservice,node_cloudinary,node_analytics,node_firestore,node_visitor toneIndigo
```

## Components

### Access and Shell

- [Public Site](https://github.com/mtaha-23/fast-connect/blob/main/app/page.tsx): `app/page.tsx`
- [Login and Signup](https://github.com/mtaha-23/fast-connect/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Auth Forms](https://github.com/mtaha-23/fast-connect/blob/main/components/login-form.tsx): `components/login-form.tsx`
- [Student Dashboard](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`

### Academic Tools

- [Batch Advisor](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/batch-advisor/page.tsx): `app/dashboard/batch-advisor/page.tsx`
- [Advisor API](https://github.com/mtaha-23/fast-connect/blob/main/app/api/batch-advisor/route.ts): `app/api/batch-advisor/route.ts`
- [Python Advisor](https://github.com/mtaha-23/fast-connect/blob/main/python-backend/process.py): `python-backend/process.py`
- [Test Practice](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/test-practice/page.tsx): `app/dashboard/test-practice/page.tsx`
- [Test Sessions](https://github.com/mtaha-23/fast-connect/blob/main/lib/server/test-session.ts): `lib/server/test-session.ts`
- [Chat Assistant](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/chatbot/page.tsx): `app/dashboard/chatbot/page.tsx`
- [Chat API](https://github.com/mtaha-23/fast-connect/blob/main/app/api/chat/route.ts): `app/api/chat/route.ts`
- [RAG Chat Server](https://github.com/mtaha-23/fast-connect/blob/main/chatbot_files/server.py): `chatbot_files/server.py`

### Community and Resources

- [Community Feed](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/feed/page.tsx): `app/dashboard/feed/page.tsx`
- [Posts API](https://github.com/mtaha-23/fast-connect/blob/main/app/api/posts/route.ts): `app/api/posts/route.ts`
- [Resource Library](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/resources/page.tsx): `app/dashboard/resources/page.tsx`
- [Resources API](https://github.com/mtaha-23/fast-connect/blob/main/app/api/resources/route.ts): `app/api/resources/route.ts`
- [Resource Upload](https://github.com/mtaha-23/fast-connect/blob/main/app/api/resources/upload/route.ts): `app/api/resources/upload/route.ts`
- [Campus Tour](https://github.com/mtaha-23/fast-connect/blob/main/app/dashboard/tour/page.tsx): `app/dashboard/tour/page.tsx`
- [Tour Locations API](https://github.com/mtaha-23/fast-connect/blob/main/app/api/tour-locations/route.ts): `app/api/tour-locations/route.ts`

### Administration

- [Admin Console](https://github.com/mtaha-23/fast-connect/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Post Management](https://github.com/mtaha-23/fast-connect/blob/main/app/admin/posts/page.tsx): `app/admin/posts/page.tsx`
- [Resource Management](https://github.com/mtaha-23/fast-connect/blob/main/app/admin/resources/page.tsx): `app/admin/resources/page.tsx`
- [User Management](https://github.com/mtaha-23/fast-connect/blob/main/app/admin/users/page.tsx): `app/admin/users/page.tsx`

### Services and Data

- [Authentication](https://github.com/mtaha-23/fast-connect/blob/main/lib/services/auth.service.ts): `lib/services/auth.service.ts`
- [Firebase Setup](https://github.com/mtaha-23/fast-connect/blob/main/lib/firebase.ts): `lib/firebase.ts`
- [Question Service](https://github.com/mtaha-23/fast-connect/blob/main/lib/services/question.service.ts): `lib/services/question.service.ts`
- [Post Service](https://github.com/mtaha-23/fast-connect/blob/main/lib/services/post.service.ts): `lib/services/post.service.ts`
- [Resource Service](https://github.com/mtaha-23/fast-connect/blob/main/lib/services/resource.service.ts): `lib/services/resource.service.ts`
- [Cloudinary Storage](https://github.com/mtaha-23/fast-connect/blob/main/lib/cloudinary.ts): `lib/cloudinary.ts`
- [Analytics Service](https://github.com/mtaha-23/fast-connect/blob/main/lib/services/analytics.service.ts): `lib/services/analytics.service.ts`
- **Firestore**

### Other components

- **Visitor / Student**

## Connections

- Visitor / Student → Public Site: opens (evidence: `app/page.tsx`)
- Visitor / Student → Login and Signup: signs in (evidence: `app/login/page.tsx`)
- Login and Signup → Auth Forms: renders (evidence: `app/login/page.tsx`)
- Auth Forms → Authentication: authenticates
- Authentication → Firebase Setup: gets clients (evidence: `lib/services/auth.service.ts`)
- Authentication → Firestore: reads and writes (evidence: `lib/services/auth.service.ts`)
- Login and Signup → Student Dashboard: enters
- Student Dashboard → Batch Advisor: opens
- Batch Advisor → Advisor API: requests advice
- Advisor API → Python Advisor: invokes
- Student Dashboard → Test Practice: opens
- Question Service → Firebase Setup: uses (evidence: `lib/services/question.service.ts`)
- Question Service → Firestore: loads questions (evidence: `lib/services/question.service.ts`)
- Student Dashboard → Chat Assistant: opens
- Chat Assistant → Chat API: sends messages
- Chat API → RAG Chat Server: forwards queries
- Student Dashboard → Community Feed: opens
- Posts API → Post Service: delegates (evidence: `app/api/posts/route.ts`)
- Post Service → Firebase Setup: uses (evidence: `lib/services/post.service.ts`)
- Student Dashboard → Resource Library: opens
- Resources API → Resource Service: delegates (evidence: `app/api/resources/route.ts`)
- Resource Upload → Cloudinary Storage: uploads files (evidence: `app/api/resources/upload/route.ts`)
- Resource Service → Firebase Setup: uses
- Student Dashboard → Campus Tour: opens
- Campus Tour → Tour Locations API: loads locations
- Admin Console → Firestore: reads metrics (evidence: `app/admin/page.tsx`)
- Post Management → Post Service: manages posts (evidence: `app/admin/posts/page.tsx`)
- Resource Management → Analytics Service: logs events (evidence: `app/admin/resources/page.tsx`)
- User Management → Admin Console: manages users
