# mohammadkhizer/campus_hub_v2 architecture

> Architecture diagram of the GitHub repository mohammadkhizer/campus_hub_v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mohammadkhizer/campus_hub_v2
- Repository: https://github.com/mohammadkhizer/campus_hub_v2

## Overview

Campus Hub is a role-based institutional LMS: users authenticate, reach role-specific dashboards, and use learning, assessment, and governance features that operate on MongoDB-backed records. The README documents student course discovery and timed, one-attempt assessments, teacher course and assessment management, and administrator/superadmin oversight. Source-index references and excerpts support several action-to-model and auth-to-session links; other feature wiring is represented only where the README documents it, since many routes and actions were not sampled.

Main entry points: [`src/app/actions/auth.ts`](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/auth.ts) (Authentication actions), [`src/app/actions/courses.ts`](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/courses.ts) (Course operations), [`src/app/login/page.tsx`](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/login/page.tsx) (Sign-in & signup), [`src/app/dashboard/page.tsx`](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/dashboard/page.tsx) (Role dashboards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_auth_ui["Sign-in &amp; signup<br/>[page.tsx]"]
  node_auth_actions["Authentication actions<br/>[auth.ts]"]
  node_auth_context["Session context<br/>[auth-context.tsx]"]
  node_role_dashboards["Role dashboards<br/>[page.tsx]"]
  node_profile_ops["Profile management<br/>[profile.ts]"]
end

subgraph group_learning["Learning &amp; assessment"]
  node_course_actions["Course operations<br/>[courses.ts]"]
  node_course_ui["Course discovery &amp; control<br/>[page.tsx]"]
  node_quiz_actions["Quiz operations<br/>[quizzes.ts]"]
  node_quiz_ui["Quiz attempts &amp; review<br/>[page.tsx]"]
  node_ai_flows["AI learning tools<br/>[student-ai.ts]"]
end

subgraph group_governance["Institutional governance"]
  node_classroom_actions["Classroom operations<br/>[classrooms.ts]"]
  node_admin_ops["Administrator operations<br/>[page.tsx]"]
  node_superadmin_ops["Platform governance<br/>[superadmin.ts]"]
  node_student_services["Student services<br/>[student.ts]"]
end

subgraph group_platform["Shared platform services"]
  node_action_factory["Action security wrapper<br/>[action-factory.ts]"]
  node_middleware["Traffic protection<br/>[middleware.ts]"]
  node_db_connection["Database connection<br/>[mongoose.ts]"]
  node_logger["Structured logging<br/>[logger.ts]"]
end

subgraph group_data["Persistent domain data"]
  node_course_model[("Course records<br/>[Course.ts]")]
  node_quiz_model[("Quiz records<br/>[Quiz.ts]")]
  node_attempt_model[("Attempt records<br/>[Attempt.ts]")]
  node_user_model[("User records<br/>[User.ts]")]
  node_classroom_model[("Classroom records<br/>[Classroom.ts]")]
end

node_student(("Student"))
node_teacher(("Teacher"))
node_administrator(("Administrator"))
node_superadmin(("Super admin"))
node_mongo[("MongoDB")]
node_gemini["Google GenAI"]

node_student -->|"signs in"| node_auth_ui
node_teacher -->|"signs in"| node_auth_ui
node_administrator -->|"signs in"| node_auth_ui
node_superadmin -->|"signs in"| node_auth_ui
node_auth_ui -.->|"authenticates through"| node_auth_actions
node_auth_context -->|"fetches session"| node_auth_actions
node_auth_actions -->|"reads users"| node_user_model
node_auth_actions -->|"connects database"| node_db_connection
node_auth_actions -->|"wraps protected actions"| node_action_factory
node_auth_context -.->|"provides session to"| node_role_dashboards
node_student -->|"views progress"| node_role_dashboards
node_teacher -->|"opens teaching tools"| node_role_dashboards
node_administrator -->|"opens oversight"| node_role_dashboards
node_superadmin -->|"opens governance"| node_role_dashboards
node_student -->|"discovers courses"| node_course_ui
node_teacher -->|"manages courses"| node_course_ui
node_course_ui -.->|"requests course operations"| node_course_actions
node_course_actions -->|"checks session"| node_auth_actions
node_course_actions -->|"reads and writes"| node_course_model
node_course_actions -->|"reads classrooms"| node_classroom_model
node_student -->|"takes timed quizzes"| node_quiz_ui
node_teacher -->|"creates assessments"| node_quiz_ui
node_quiz_ui -.->|"submits attempts"| node_quiz_actions
node_quiz_actions -->|"reads quizzes"| node_quiz_model
node_quiz_actions -->|"records attempts"| node_attempt_model
node_quiz_actions -->|"checks session"| node_auth_actions
node_teacher -.->|"uses AI assistance"| node_ai_flows
node_student -.->|"uses learning assistance"| node_ai_flows
node_ai_flows -.->|"generates content"| node_gemini
node_administrator -->|"governs institution"| node_admin_ops
node_admin_ops -->|"establishes courses"| node_course_actions
node_admin_ops -->|"manages classrooms"| node_classroom_actions
node_classroom_actions -->|"reads and writes"| node_classroom_model
node_superadmin -->|"governs platform"| node_superadmin_ops
node_superadmin_ops -.->|"manages roles"| node_user_model
node_superadmin -.->|"oversees student services"| node_student_services
node_student -->|"updates profile"| node_profile_ops
node_action_factory -->|"connects database"| node_db_connection
node_action_factory -->|"loads session"| node_auth_actions
node_action_factory -->|"logs failures"| node_logger
node_middleware -->|"limits incoming traffic"| node_mongo
node_db_connection -->|"connects"| node_mongo

click node_auth_ui "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/login/page.tsx"
click node_auth_actions "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/auth.ts"
click node_auth_context "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/context/auth-context.tsx"
click node_role_dashboards "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/dashboard/page.tsx"
click node_course_actions "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/courses.ts"
click node_course_ui "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/courses/%5Bid%5D/page.tsx"
click node_quiz_actions "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/quizzes.ts"
click node_quiz_ui "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/quizzes/%5Bid%5D/page.tsx"
click node_ai_flows "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/ai/flows/student-ai.ts"
click node_classroom_actions "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/classrooms.ts"
click node_admin_ops "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/admin/dashboard/page.tsx"
click node_superadmin_ops "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/superadmin.ts"
click node_student_services "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/student.ts"
click node_profile_ops "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/profile.ts"
click node_action_factory "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/lib/action-factory.ts"
click node_middleware "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/middleware.ts"
click node_db_connection "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/lib/mongoose.ts"
click node_logger "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/lib/logger.ts"
click node_course_model "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Course.ts"
click node_quiz_model "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Quiz.ts"
click node_attempt_model "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Attempt.ts"
click node_user_model "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/User.ts"
click node_classroom_model "https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Classroom.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_auth_ui,node_auth_actions,node_auth_context,node_role_dashboards,node_profile_ops toneBlue
class node_course_actions,node_course_ui,node_quiz_actions,node_quiz_ui,node_ai_flows,node_mongo toneAmber
class node_classroom_actions,node_admin_ops,node_superadmin_ops,node_student_services toneMint
class node_action_factory,node_middleware,node_db_connection,node_logger toneRose
class node_course_model,node_quiz_model,node_attempt_model,node_user_model,node_classroom_model,node_student,node_teacher,node_administrator,node_superadmin,node_gemini toneIndigo
```

## Components

### Identity & access

- [Sign-in & signup](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Authentication actions](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/auth.ts): `src/app/actions/auth.ts`
- [Session context](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/context/auth-context.tsx): `src/context/auth-context.tsx`
- [Role dashboards](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Profile management](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/profile.ts): `src/app/actions/profile.ts`

### Learning & assessment

- [Course operations](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/courses.ts): `src/app/actions/courses.ts`
- [Course discovery & control](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/courses/%5Bid%5D/page.tsx): `src/app/courses/[id]/page.tsx`
- [Quiz operations](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/quizzes.ts): `src/app/actions/quizzes.ts`
- [Quiz attempts & review](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/quizzes/%5Bid%5D/page.tsx): `src/app/quizzes/[id]/page.tsx`
- [AI learning tools](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/ai/flows/student-ai.ts): `src/ai/flows/student-ai.ts`

### Institutional governance

- [Classroom operations](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/classrooms.ts): `src/app/actions/classrooms.ts`
- [Administrator operations](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/admin/dashboard/page.tsx): `src/app/admin/dashboard/page.tsx`
- [Platform governance](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/superadmin.ts): `src/app/actions/superadmin.ts`
- [Student services](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/app/actions/student.ts): `src/app/actions/student.ts`

### Shared platform services

- [Action security wrapper](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/lib/action-factory.ts): `src/lib/action-factory.ts`
- [Traffic protection](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/middleware.ts): `src/middleware.ts`
- [Database connection](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/lib/mongoose.ts): `src/lib/mongoose.ts`
- [Structured logging](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/lib/logger.ts): `src/lib/logger.ts`

### Persistent domain data

- [Course records](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Course.ts): `src/models/Course.ts`
- [Quiz records](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Quiz.ts): `src/models/Quiz.ts`
- [Attempt records](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Attempt.ts): `src/models/Attempt.ts`
- [User records](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/User.ts): `src/models/User.ts`
- [Classroom records](https://github.com/mohammadkhizer/campus_hub_v2/blob/main/src/models/Classroom.ts): `src/models/Classroom.ts`

### Other components

- **Student**
- **Teacher**
- **Administrator**
- **Super admin**
- **MongoDB**
- **Google GenAI**

## Connections

- Student → Sign-in & signup: signs in
- Teacher → Sign-in & signup: signs in
- Administrator → Sign-in & signup: signs in
- Super admin → Sign-in & signup: signs in
- Sign-in & signup → Authentication actions: authenticates through
- Session context → Authentication actions: fetches session (evidence: `src/context/auth-context.tsx`)
- Authentication actions → User records: reads users (evidence: `src/app/actions/auth.ts`)
- Authentication actions → Database connection: connects database (evidence: `src/app/actions/auth.ts`)
- Authentication actions → Action security wrapper: wraps protected actions (evidence: `src/app/actions/auth.ts`)
- Session context → Role dashboards: provides session to
- Student → Role dashboards: views progress
- Teacher → Role dashboards: opens teaching tools
- Administrator → Role dashboards: opens oversight
- Super admin → Role dashboards: opens governance
- Student → Course discovery & control: discovers courses
- Teacher → Course discovery & control: manages courses
- Course discovery & control → Course operations: requests course operations
- Course operations → Authentication actions: checks session (evidence: `src/app/actions/courses.ts`)
- Course operations → Course records: reads and writes (evidence: `src/app/actions/courses.ts`)
- Course operations → Classroom records: reads classrooms (evidence: `src/app/actions/courses.ts`)
- Student → Quiz attempts & review: takes timed quizzes
- Teacher → Quiz attempts & review: creates assessments
- Quiz attempts & review → Quiz operations: submits attempts
- Quiz operations → Quiz records: reads quizzes (evidence: `src/app/actions/quizzes.ts`)
- Quiz operations → Attempt records: records attempts (evidence: `src/app/actions/quizzes.ts`)
- Quiz operations → Authentication actions: checks session (evidence: `src/app/actions/quizzes.ts`)
- Teacher → AI learning tools: uses AI assistance
- Student → AI learning tools: uses learning assistance
- AI learning tools → Google GenAI: generates content
- Administrator → Administrator operations: governs institution
- Administrator operations → Course operations: establishes courses (evidence: `src/app/admin/dashboard/page.tsx`)
- Administrator operations → Classroom operations: manages classrooms (evidence: `src/app/admin/dashboard/page.tsx`)
- Classroom operations → Classroom records: reads and writes (evidence: `src/app/actions/classrooms.ts`)
- Super admin → Platform governance: governs platform
- Platform governance → User records: manages roles
- Super admin → Student services: oversees student services
- Student → Profile management: updates profile
- Action security wrapper → Database connection: connects database (evidence: `src/lib/action-factory.ts`)
- Action security wrapper → Authentication actions: loads session (evidence: `src/lib/action-factory.ts`)
- Action security wrapper → Structured logging: logs failures (evidence: `src/lib/action-factory.ts`)
- Traffic protection → MongoDB: limits incoming traffic
- Database connection → MongoDB: connects
