# ccarrott/campuscare architecture

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

- Interactive diagram: https://gitdiagram.com/ccarrott/campuscare
- Repository: https://github.com/ccarrott/campuscare

## Overview

Campus Care is a university health-services platform that triages student needs through self-care guidance and symptom tracking, then supports nurse consultations and clinical escalation. Students check symptoms, use the campus health map, and book consultations; nurses manage availability and care; administrators manage accounts, reviews, exports, and operational trends. The diagram preserves those major capabilities and the server-side domain modules. Some subsystems are represented from README descriptions and the source index rather than sampled implementation; those links are documented or omitted where wiring is not evidenced.

Main entry points: [`src/modules/appointments/appointments.controller.js`](https://github.com/ccarrott/campuscare/blob/main/src/modules/appointments/appointments.controller.js) (Appointment booking), [`src/app.js`](https://github.com/ccarrott/campuscare/blob/main/src/app.js) (Express application), [`src/modules/auth/auth.controller.js`](https://github.com/ccarrott/campuscare/blob/main/src/modules/auth/auth.controller.js) (Authentication), [`src/modules/availability/availability.controller.js`](https://github.com/ccarrott/campuscare/blob/main/src/modules/availability/availability.controller.js) (Nurse availability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry and access"]
  node_express["Express application<br/>[app.js]"]
  node_access["Role and record access<br/>[authorize.js]"]
  node_authentication["Authentication<br/>[auth.controller.js]"]
  node_database[("MySQL database<br/>[database.js]")]
end

subgraph group_care["Student care"]
  node_profile["Profiles"]
  node_symptoms["Symptom triage"]
  node_escalation["Clinical escalation<br/>[escalation.js]"]
  node_heatmap["Campus health map"]
end

subgraph group_consult["Consultations"]
  node_booking["Appointment booking"]
  node_availability["Nurse availability"]
  node_video["Video room service<br/>[room.service.js]"]
  node_ratings["Ratings and reviews"]
  node_nurse_care["Nurse care dashboard"]
  node_notifications["Appointment reminders"]
end

subgraph group_operations["Clinic operations"]
  node_trends["Health trends"]
  node_staff["Public nurse profiles"]
  node_admin["Account administration"]
  node_exports["CSV export"]
end

node_student(("Student"))
node_nurse_actor(("Nurse"))
node_admin_actor(("Administrator"))

node_student -->|"signs in"| node_authentication
node_nurse_actor -->|"signs in"| node_authentication
node_admin_actor -->|"signs in"| node_authentication
node_express -->|"mounts routes"| node_authentication
node_express -->|"applies access"| node_access
node_express -->|"routes requests"| node_booking
node_express -->|"routes requests"| node_heatmap
node_student -->|"logs symptoms"| node_symptoms
node_symptoms -->|"evaluates risk"| node_escalation
node_student -->|"explores activity"| node_heatmap
node_student -->|"books consultations"| node_booking
node_booking -->|"checks slots"| node_availability
node_booking -->|"provisions rooms"| node_video
node_student -->|"rates care"| node_ratings
node_nurse_actor -->|"sets availability"| node_availability
node_nurse_actor -->|"manages appointments"| node_nurse_care
node_nurse_care -->|"manages rooms"| node_video
node_student -->|"receives reminders"| node_notifications
node_admin_actor -->|"manages accounts"| node_admin
node_admin_actor -->|"moderates reviews"| node_ratings
node_admin_actor -->|"reviews analytics"| node_trends
node_admin_actor -->|"exports reports"| node_exports
node_student -->|"manages profile"| node_profile
node_student -->|"views nurses"| node_staff
node_booking -->|"reads and writes"| node_database
node_availability -->|"reads and writes"| node_database
node_trends -.->|"queries aggregates"| node_database

click node_express "https://github.com/ccarrott/campuscare/blob/main/src/app.js"
click node_access "https://github.com/ccarrott/campuscare/blob/main/src/middleware/authorize.js"
click node_authentication "https://github.com/ccarrott/campuscare/blob/main/src/modules/auth/auth.controller.js"
click node_profile "https://github.com/ccarrott/campuscare/blob/main/src/modules/profile/profile.controller.js"
click node_symptoms "https://github.com/ccarrott/campuscare/blob/main/src/modules/symptoms/symptoms.controller.js"
click node_escalation "https://github.com/ccarrott/campuscare/blob/main/src/modules/symptoms/escalation.js"
click node_heatmap "https://github.com/ccarrott/campuscare/blob/main/src/modules/trends/trends.controller.js"
click node_trends "https://github.com/ccarrott/campuscare/blob/main/src/modules/trends/trends.controller.js"
click node_booking "https://github.com/ccarrott/campuscare/blob/main/src/modules/appointments/appointments.controller.js"
click node_availability "https://github.com/ccarrott/campuscare/blob/main/src/modules/availability/availability.controller.js"
click node_video "https://github.com/ccarrott/campuscare/blob/main/src/modules/appointments/room.service.js"
click node_ratings "https://github.com/ccarrott/campuscare/blob/main/src/modules/reviews/reviews.controller.js"
click node_nurse_care "https://github.com/ccarrott/campuscare/blob/main/src/modules/nurse/nurse.controller.js"
click node_staff "https://github.com/ccarrott/campuscare/blob/main/src/modules/staff/staff.controller.js"
click node_admin "https://github.com/ccarrott/campuscare/blob/main/src/modules/admin/admin.controller.js"
click node_exports "https://github.com/ccarrott/campuscare/blob/main/src/modules/export/export.controller.js"
click node_notifications "https://github.com/ccarrott/campuscare/blob/main/src/modules/notifications/notifications.controller.js"
click node_database "https://github.com/ccarrott/campuscare/blob/main/src/config/database.js"

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_express,node_access,node_authentication,node_database toneBlue
class node_profile,node_symptoms,node_escalation,node_heatmap toneAmber
class node_booking,node_availability,node_video,node_ratings,node_nurse_care,node_notifications toneMint
class node_trends,node_staff,node_admin,node_exports toneRose
class node_student,node_nurse_actor,node_admin_actor toneIndigo
```

## Components

### Web entry and access

- [Express application](https://github.com/ccarrott/campuscare/blob/main/src/app.js): `src/app.js`
- [Role and record access](https://github.com/ccarrott/campuscare/blob/main/src/middleware/authorize.js): `src/middleware/authorize.js`
- [Authentication](https://github.com/ccarrott/campuscare/blob/main/src/modules/auth/auth.controller.js): `src/modules/auth/auth.controller.js`
- [MySQL database](https://github.com/ccarrott/campuscare/blob/main/src/config/database.js): `src/config/database.js`

### Student care

- [Profiles](https://github.com/ccarrott/campuscare/blob/main/src/modules/profile/profile.controller.js): `src/modules/profile/profile.controller.js`
- [Symptom triage](https://github.com/ccarrott/campuscare/blob/main/src/modules/symptoms/symptoms.controller.js): `src/modules/symptoms/symptoms.controller.js`
- [Clinical escalation](https://github.com/ccarrott/campuscare/blob/main/src/modules/symptoms/escalation.js): `src/modules/symptoms/escalation.js`
- [Campus health map](https://github.com/ccarrott/campuscare/blob/main/src/modules/trends/trends.controller.js): `src/modules/trends/trends.controller.js`

### Consultations

- [Appointment booking](https://github.com/ccarrott/campuscare/blob/main/src/modules/appointments/appointments.controller.js): `src/modules/appointments/appointments.controller.js`
- [Nurse availability](https://github.com/ccarrott/campuscare/blob/main/src/modules/availability/availability.controller.js): `src/modules/availability/availability.controller.js`
- [Video room service](https://github.com/ccarrott/campuscare/blob/main/src/modules/appointments/room.service.js): `src/modules/appointments/room.service.js`
- [Ratings and reviews](https://github.com/ccarrott/campuscare/blob/main/src/modules/reviews/reviews.controller.js): `src/modules/reviews/reviews.controller.js`
- [Nurse care dashboard](https://github.com/ccarrott/campuscare/blob/main/src/modules/nurse/nurse.controller.js): `src/modules/nurse/nurse.controller.js`
- [Appointment reminders](https://github.com/ccarrott/campuscare/blob/main/src/modules/notifications/notifications.controller.js): `src/modules/notifications/notifications.controller.js`

### Clinic operations

- [Health trends](https://github.com/ccarrott/campuscare/blob/main/src/modules/trends/trends.controller.js): `src/modules/trends/trends.controller.js`
- [Public nurse profiles](https://github.com/ccarrott/campuscare/blob/main/src/modules/staff/staff.controller.js): `src/modules/staff/staff.controller.js`
- [Account administration](https://github.com/ccarrott/campuscare/blob/main/src/modules/admin/admin.controller.js): `src/modules/admin/admin.controller.js`
- [CSV export](https://github.com/ccarrott/campuscare/blob/main/src/modules/export/export.controller.js): `src/modules/export/export.controller.js`

### Other components

- **Student**
- **Nurse**
- **Administrator**

## Connections

- Student → Authentication: signs in
- Nurse → Authentication: signs in
- Administrator → Authentication: signs in
- Express application → Authentication: mounts routes (evidence: `src/app.js`)
- Express application → Role and record access: applies access (evidence: `src/app.js`)
- Express application → Appointment booking: routes requests (evidence: `src/app.js`)
- Express application → Campus health map: routes requests (evidence: `src/app.js`)
- Student → Symptom triage: logs symptoms
- Symptom triage → Clinical escalation: evaluates risk (evidence: `src/modules/symptoms/symptoms.controller.js`)
- Student → Campus health map: explores activity
- Student → Appointment booking: books consultations
- Appointment booking → Nurse availability: checks slots (evidence: `src/modules/appointments/appointments.controller.js`)
- Appointment booking → Video room service: provisions rooms (evidence: `src/modules/appointments/appointments.controller.js`)
- Student → Ratings and reviews: rates care
- Nurse → Nurse availability: sets availability
- Nurse → Nurse care dashboard: manages appointments
- Nurse care dashboard → Video room service: manages rooms (evidence: `src/modules/nurse/nurse.controller.js`)
- Student → Appointment reminders: receives reminders
- Administrator → Account administration: manages accounts
- Administrator → Ratings and reviews: moderates reviews
- Administrator → Health trends: reviews analytics
- Administrator → CSV export: exports reports
- Student → Profiles: manages profile
- Student → Public nurse profiles: views nurses
- Appointment booking → MySQL database: reads and writes
- Nurse availability → MySQL database: reads and writes
- Health trends → MySQL database: queries aggregates
