# mishranimesh/campusos architecture

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

## Overview

This is a CampusOS campus-operations dashboard prototype: users navigate operational views, inspect decisions and scenarios, and review academic, staffing, facilities, and related campus information. The sampled code shows a React app routing to page modules, with shared navigation, UI, toast feedback, and mock data; it does not show a backend or persistent store. Domain pages are retained from the source tree, but their internal behavior and several route details were not sampled.

Main entry points: [`src/App.tsx`](https://github.com/mishranimesh/campusos/blob/main/src/App.tsx) (Application router), [`src/components/layout`](https://github.com/mishranimesh/campusos/tree/main/src/components/layout) (Navigation and search), [`src/data/mockData.ts`](https://github.com/mishranimesh/campusos/blob/main/src/data/mockData.ts) (Mock campus data), [`src/components/ui`](https://github.com/mishranimesh/campusos/tree/main/src/components/ui) (UI components)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_shell["Application router<br/>[App.tsx]"]
  node_dashboard["Operations dashboard<br/>[Dashboard.tsx]"]
  node_agents["Agent monitoring<br/>[AgentsOverview.tsx]"]
  node_reports["Reports<br/>[Reports.tsx]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
  node_mockdata["Mock campus data<br/>[mockData.ts]"]
end

subgraph group_decision["Decision Operations"]
  node_decision_center["Decision center<br/>[DecisionCenter.tsx]"]
  node_workspace["Decision workspace"]
  node_history["Decision history"]
  node_simulator["What-if simulator"]
end

subgraph group_campus["Campus Operations"]
  node_academic["Academic operations<br/>[AcademicModule.tsx]"]
  node_faculty["Faculty operations<br/>[FacultyModule.tsx]"]
  node_timetable["Timetable operations"]
  node_infrastructure["Infrastructure operations"]
  node_examinations["Examinations operations"]
  node_placements["Placements operations"]
  node_communications["Campus communications"]
end

subgraph group_shared["Shared Interface"]
  node_navigation["Navigation and search"]
  node_ui["UI components"]
  node_toasts["Toast feedback<br/>[ToastContext.tsx]"]
end

node_operator(("Campus operator"))

node_operator -->|"opens app"| node_entry
node_entry -->|"renders"| node_shell
node_shell -->|"renders"| node_navigation
node_shell -->|"provides"| node_toasts
node_shell -->|"routes to"| node_dashboard
node_shell -->|"routes to"| node_decision_center
node_shell -->|"routes to"| node_workspace
node_shell -->|"routes to"| node_simulator
node_shell -->|"routes to"| node_agents
node_shell -->|"routes to"| node_academic
node_shell -->|"routes to"| node_faculty
node_shell -->|"routes to"| node_timetable
node_shell -->|"routes to"| node_infrastructure
node_shell -.->|"routes to"| node_examinations
node_shell -->|"routes to"| node_placements
node_shell -->|"routes to"| node_communications
node_shell -->|"routes to"| node_reports
node_shell -->|"routes to"| node_history
node_shell -->|"routes to"| node_settings
node_navigation -->|"searches"| node_mockdata
node_dashboard -->|"reads"| node_mockdata
node_decision_center -->|"reads"| node_mockdata
node_simulator -->|"reads"| node_mockdata
node_dashboard -->|"renders"| node_ui
node_decision_center -->|"renders"| node_ui
node_simulator -->|"renders"| node_ui
node_navigation -->|"renders"| node_ui
node_navigation -->|"uses"| node_toasts

click node_entry "https://github.com/mishranimesh/campusos/blob/main/src/main.tsx"
click node_shell "https://github.com/mishranimesh/campusos/blob/main/src/App.tsx"
click node_dashboard "https://github.com/mishranimesh/campusos/blob/main/src/pages/Dashboard.tsx"
click node_agents "https://github.com/mishranimesh/campusos/blob/main/src/pages/AgentsOverview.tsx"
click node_reports "https://github.com/mishranimesh/campusos/blob/main/src/pages/Reports.tsx"
click node_settings "https://github.com/mishranimesh/campusos/blob/main/src/pages/SettingsPage.tsx"
click node_decision_center "https://github.com/mishranimesh/campusos/blob/main/src/pages/DecisionCenter.tsx"
click node_workspace "https://github.com/mishranimesh/campusos/blob/main/src/pages/DecisionWorkspace.tsx"
click node_history "https://github.com/mishranimesh/campusos/blob/main/src/pages/DecisionHistory.tsx"
click node_simulator "https://github.com/mishranimesh/campusos/blob/main/src/pages/WhatIfSimulator.tsx"
click node_academic "https://github.com/mishranimesh/campusos/blob/main/src/pages/AcademicModule.tsx"
click node_faculty "https://github.com/mishranimesh/campusos/blob/main/src/pages/FacultyModule.tsx"
click node_timetable "https://github.com/mishranimesh/campusos/blob/main/src/pages/TimetableModule.tsx"
click node_infrastructure "https://github.com/mishranimesh/campusos/blob/main/src/pages/InfrastructureModule.tsx"
click node_examinations "https://github.com/mishranimesh/campusos/blob/main/src/pages/ExaminationsModule.tsx"
click node_placements "https://github.com/mishranimesh/campusos/blob/main/src/pages/PlacementsModule.tsx"
click node_communications "https://github.com/mishranimesh/campusos/blob/main/src/pages/CommunicationsModule.tsx"
click node_mockdata "https://github.com/mishranimesh/campusos/blob/main/src/data/mockData.ts"
click node_navigation "https://github.com/mishranimesh/campusos/tree/main/src/components/layout"
click node_ui "https://github.com/mishranimesh/campusos/tree/main/src/components/ui"
click node_toasts "https://github.com/mishranimesh/campusos/blob/main/src/components/ui/ToastContext.tsx"

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_entry,node_shell,node_dashboard,node_agents,node_reports,node_settings,node_mockdata toneBlue
class node_decision_center,node_workspace,node_history,node_simulator toneAmber
class node_academic,node_faculty,node_timetable,node_infrastructure,node_examinations,node_placements,node_communications toneMint
class node_navigation,node_ui,node_toasts toneRose
class node_operator toneIndigo
```

## Components

### Application Shell

- [React entry](https://github.com/mishranimesh/campusos/blob/main/src/main.tsx): `src/main.tsx`
- [Application router](https://github.com/mishranimesh/campusos/blob/main/src/App.tsx): `src/App.tsx`
- [Operations dashboard](https://github.com/mishranimesh/campusos/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Agent monitoring](https://github.com/mishranimesh/campusos/blob/main/src/pages/AgentsOverview.tsx): `src/pages/AgentsOverview.tsx`
- [Reports](https://github.com/mishranimesh/campusos/blob/main/src/pages/Reports.tsx): `src/pages/Reports.tsx`
- [Settings](https://github.com/mishranimesh/campusos/blob/main/src/pages/SettingsPage.tsx): `src/pages/SettingsPage.tsx`
- [Mock campus data](https://github.com/mishranimesh/campusos/blob/main/src/data/mockData.ts): `src/data/mockData.ts`

### Decision Operations

- [Decision center](https://github.com/mishranimesh/campusos/blob/main/src/pages/DecisionCenter.tsx): `src/pages/DecisionCenter.tsx`
- [Decision workspace](https://github.com/mishranimesh/campusos/blob/main/src/pages/DecisionWorkspace.tsx): `src/pages/DecisionWorkspace.tsx`
- [Decision history](https://github.com/mishranimesh/campusos/blob/main/src/pages/DecisionHistory.tsx): `src/pages/DecisionHistory.tsx`
- [What-if simulator](https://github.com/mishranimesh/campusos/blob/main/src/pages/WhatIfSimulator.tsx): `src/pages/WhatIfSimulator.tsx`

### Campus Operations

- [Academic operations](https://github.com/mishranimesh/campusos/blob/main/src/pages/AcademicModule.tsx): `src/pages/AcademicModule.tsx`
- [Faculty operations](https://github.com/mishranimesh/campusos/blob/main/src/pages/FacultyModule.tsx): `src/pages/FacultyModule.tsx`
- [Timetable operations](https://github.com/mishranimesh/campusos/blob/main/src/pages/TimetableModule.tsx): `src/pages/TimetableModule.tsx`
- [Infrastructure operations](https://github.com/mishranimesh/campusos/blob/main/src/pages/InfrastructureModule.tsx): `src/pages/InfrastructureModule.tsx`
- [Examinations operations](https://github.com/mishranimesh/campusos/blob/main/src/pages/ExaminationsModule.tsx): `src/pages/ExaminationsModule.tsx`
- [Placements operations](https://github.com/mishranimesh/campusos/blob/main/src/pages/PlacementsModule.tsx): `src/pages/PlacementsModule.tsx`
- [Campus communications](https://github.com/mishranimesh/campusos/blob/main/src/pages/CommunicationsModule.tsx): `src/pages/CommunicationsModule.tsx`

### Shared Interface

- [Navigation and search](https://github.com/mishranimesh/campusos/tree/main/src/components/layout): `src/components/layout`
- [UI components](https://github.com/mishranimesh/campusos/tree/main/src/components/ui): `src/components/ui`
- [Toast feedback](https://github.com/mishranimesh/campusos/blob/main/src/components/ui/ToastContext.tsx): `src/components/ui/ToastContext.tsx`

### Other components

- **Campus operator**

## Connections

- Campus operator → React entry: opens app (evidence: `src/main.tsx`)
- React entry → Application router: renders (evidence: `src/main.tsx`)
- Application router → Navigation and search: renders (evidence: `src/App.tsx`)
- Application router → Toast feedback: provides (evidence: `src/App.tsx`)
- Application router → Operations dashboard: routes to (evidence: `src/App.tsx`)
- Application router → Decision center: routes to (evidence: `src/App.tsx`)
- Application router → Decision workspace: routes to (evidence: `src/App.tsx`)
- Application router → What-if simulator: routes to (evidence: `src/App.tsx`)
- Application router → Agent monitoring: routes to (evidence: `src/App.tsx`)
- Application router → Academic operations: routes to (evidence: `src/App.tsx`)
- Application router → Faculty operations: routes to (evidence: `src/App.tsx`)
- Application router → Timetable operations: routes to (evidence: `src/App.tsx`)
- Application router → Infrastructure operations: routes to (evidence: `src/App.tsx`)
- Application router → Examinations operations: routes to (evidence: `src/App.tsx`)
- Application router → Placements operations: routes to (evidence: `src/App.tsx`)
- Application router → Campus communications: routes to (evidence: `src/App.tsx`)
- Application router → Reports: routes to (evidence: `src/App.tsx`)
- Application router → Decision history: routes to (evidence: `src/App.tsx`)
- Application router → Settings: routes to (evidence: `src/App.tsx`)
- Navigation and search → Mock campus data: searches (evidence: `src/components/layout/CommandPalette.tsx`)
- Operations dashboard → Mock campus data: reads (evidence: `src/pages/Dashboard.tsx`)
- Decision center → Mock campus data: reads (evidence: `src/pages/DecisionCenter.tsx`)
- What-if simulator → Mock campus data: reads (evidence: `src/pages/WhatIfSimulator.tsx`)
- Operations dashboard → UI components: renders (evidence: `src/pages/Dashboard.tsx`)
- Decision center → UI components: renders (evidence: `src/pages/DecisionCenter.tsx`)
- What-if simulator → UI components: renders (evidence: `src/pages/WhatIfSimulator.tsx`)
- Navigation and search → UI components: renders (evidence: `src/components/layout/CommandPalette.tsx`)
- Navigation and search → Toast feedback: uses (evidence: `src/components/layout/Sidebar.tsx`)
