# sravan99k/novo-wellness architecture

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

- Interactive diagram: https://gitdiagram.com/sravan99k/novo-wellness
- Repository: https://github.com/sravan99k/novo-wellness

## Overview

This is a multi-role school wellbeing and student-support platform. Students use assessments and wellness tools, while teachers and school, organization, and platform administrators manage learners, review risk signals, and configure assessments and features. The route map and sampled code establish the main entry points, authentication, and some data access. Many listed features have no source excerpts, so their internal wiring is left unspecified; the README is empty.

Main entry points: [`src/App.tsx`](https://github.com/sravan99k/novo-wellness/blob/main/src/App.tsx) (Role-based app), [`src/hooks/useAuth.tsx`](https://github.com/sravan99k/novo-wellness/blob/main/src/hooks/useAuth.tsx) (Authentication), [`src/components/AssessmentForm.tsx`](https://github.com/sravan99k/novo-wellness/blob/main/src/components/AssessmentForm.tsx) (Assessment experience), [`src/lib/apiClient.ts`](https://github.com/sravan99k/novo-wellness/blob/main/src/lib/apiClient.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application access"]
  node_app["Role-based app<br/>[App.tsx]"]
  node_auth["Authentication<br/>[useAuth.tsx]"]
  node_api["API client<br/>[apiClient.ts]"]
  node_identity["Microsoft identity"]
end

subgraph group_student["Student wellbeing"]
  node_student_dashboard["Student dashboard"]
  node_wellness["Wellness tools<br/>[WellnessLayout.tsx]"]
  node_wellness_data["Wellness data<br/>[wellnessService.js]"]
end

subgraph group_assessment["Assessment and support"]
  node_assessment_form["Assessment experience<br/>[AssessmentForm.tsx]"]
  node_assessment_services["Assessment services"]
  node_flag_engine["Risk flag rules<br/>[flagEngine.ts]"]
  node_student_results["Assessment results"]
end

subgraph group_school["School operations"]
  node_teacher_dashboard["Teacher dashboard"]
  node_teacher_data["Teacher data access"]
  node_alerts["Student alerts<br/>[index.tsx]"]
  node_school_ops["School management"]
  node_org_ops["Organization management"]
end

subgraph group_admin["Platform administration"]
  node_admin_assessments["Assessment configuration"]
  node_deployment["Assessment deployment"]
  node_feature_admin["Feature management"]
  node_notifications["Notifications"]
end

node_student_actor(("Student"))
node_teacher_actor(("Teacher"))
node_school_actor(("School staff"))
node_admin_actor(("Platform admin"))
node_firestore[("Firebase Firestore")]
node_backend["Platform API"]

node_student_actor -->|"opens"| node_app
node_teacher_actor -->|"opens"| node_app
node_school_actor -->|"opens"| node_app
node_admin_actor -->|"opens"| node_app
node_app -->|"provides access"| node_auth
node_auth -->|"authenticates"| node_identity
node_auth -->|"fetches profile"| node_api
node_api -->|"requests data"| node_backend
node_app -->|"routes to"| node_student_dashboard
node_app -->|"routes to"| node_assessment_form
node_app -->|"routes to"| node_wellness
node_app -->|"routes to"| node_teacher_dashboard
node_app -->|"routes to"| node_school_ops
node_app -->|"routes to"| node_org_ops
node_app -->|"routes to"| node_admin_assessments
node_app -->|"routes to"| node_feature_admin
node_app -->|"routes to"| node_notifications
node_assessment_form -.->|"assessment wiring unclear"| node_assessment_services
node_assessment_services -.->|"scoring wiring unclear"| node_flag_engine
node_assessment_form -.->|"results wiring unclear"| node_student_results
node_wellness -.->|"data wiring unclear"| node_wellness_data
node_teacher_dashboard -.->|"loads teacher data"| node_teacher_data
node_teacher_data -->|"reads records"| node_firestore
node_alerts -->|"fetches alerts"| node_api
node_deployment -.->|"configuration wiring unclear"| node_admin_assessments

click node_app "https://github.com/sravan99k/novo-wellness/blob/main/src/App.tsx"
click node_auth "https://github.com/sravan99k/novo-wellness/blob/main/src/hooks/useAuth.tsx"
click node_api "https://github.com/sravan99k/novo-wellness/blob/main/src/lib/apiClient.ts"
click node_student_dashboard "https://github.com/sravan99k/novo-wellness/blob/main/src/student/pages/StudentDashboard.tsx"
click node_assessment_form "https://github.com/sravan99k/novo-wellness/blob/main/src/components/AssessmentForm.tsx"
click node_assessment_services "https://github.com/sravan99k/novo-wellness/blob/main/src/services/assessmentService.js"
click node_flag_engine "https://github.com/sravan99k/novo-wellness/blob/main/src/services/flagEngine.ts"
click node_student_results "https://github.com/sravan99k/novo-wellness/blob/main/src/components/student-dashboard/assessment-components/AssessmentResults.tsx"
click node_wellness "https://github.com/sravan99k/novo-wellness/blob/main/src/student/pages/wellness/WellnessLayout.tsx"
click node_wellness_data "https://github.com/sravan99k/novo-wellness/blob/main/src/services/wellness/wellnessService.js"
click node_teacher_dashboard "https://github.com/sravan99k/novo-wellness/blob/main/src/teacher/pages/TeacherDashboard.tsx"
click node_teacher_data "https://github.com/sravan99k/novo-wellness/blob/main/src/services/data-services/teacherDataService.ts"
click node_alerts "https://github.com/sravan99k/novo-wellness/blob/main/src/alerts/index.tsx"
click node_school_ops "https://github.com/sravan99k/novo-wellness/blob/main/src/school/pages/UnifiedManagementPage.tsx"
click node_org_ops "https://github.com/sravan99k/novo-wellness/blob/main/src/organization/pages/OrganizationDashboard.tsx"
click node_admin_assessments "https://github.com/sravan99k/novo-wellness/blob/main/src/admin/pages/assessment-config/AssessmentConfigHub.tsx"
click node_deployment "https://github.com/sravan99k/novo-wellness/blob/main/src/admin/services/UnifiedDeploymentService.tsx"
click node_feature_admin "https://github.com/sravan99k/novo-wellness/blob/main/src/admin/pages/feature-management/FeatureManagementHub.tsx"
click node_notifications "https://github.com/sravan99k/novo-wellness/blob/main/src/admin/pages/notifications/NotificationHub.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_app,node_auth,node_api,node_identity toneBlue
class node_student_dashboard,node_wellness,node_wellness_data,node_firestore toneAmber
class node_assessment_form,node_assessment_services,node_flag_engine,node_student_results,node_backend toneMint
class node_teacher_dashboard,node_teacher_data,node_alerts,node_school_ops,node_org_ops toneRose
class node_admin_assessments,node_deployment,node_feature_admin,node_notifications,node_student_actor,node_teacher_actor,node_school_actor,node_admin_actor toneIndigo
```

## Components

### Application access

- [Role-based app](https://github.com/sravan99k/novo-wellness/blob/main/src/App.tsx): `src/App.tsx`
- [Authentication](https://github.com/sravan99k/novo-wellness/blob/main/src/hooks/useAuth.tsx): `src/hooks/useAuth.tsx`
- [API client](https://github.com/sravan99k/novo-wellness/blob/main/src/lib/apiClient.ts): `src/lib/apiClient.ts`
- **Microsoft identity**

### Student wellbeing

- [Student dashboard](https://github.com/sravan99k/novo-wellness/blob/main/src/student/pages/StudentDashboard.tsx): `src/student/pages/StudentDashboard.tsx`
- [Wellness tools](https://github.com/sravan99k/novo-wellness/blob/main/src/student/pages/wellness/WellnessLayout.tsx): `src/student/pages/wellness/WellnessLayout.tsx`
- [Wellness data](https://github.com/sravan99k/novo-wellness/blob/main/src/services/wellness/wellnessService.js): `src/services/wellness/wellnessService.js`

### Assessment and support

- [Assessment experience](https://github.com/sravan99k/novo-wellness/blob/main/src/components/AssessmentForm.tsx): `src/components/AssessmentForm.tsx`
- [Assessment services](https://github.com/sravan99k/novo-wellness/blob/main/src/services/assessmentService.js): `src/services/assessmentService.js`
- [Risk flag rules](https://github.com/sravan99k/novo-wellness/blob/main/src/services/flagEngine.ts): `src/services/flagEngine.ts`
- [Assessment results](https://github.com/sravan99k/novo-wellness/blob/main/src/components/student-dashboard/assessment-components/AssessmentResults.tsx): `src/components/student-dashboard/assessment-components/AssessmentResults.tsx`

### School operations

- [Teacher dashboard](https://github.com/sravan99k/novo-wellness/blob/main/src/teacher/pages/TeacherDashboard.tsx): `src/teacher/pages/TeacherDashboard.tsx`
- [Teacher data access](https://github.com/sravan99k/novo-wellness/blob/main/src/services/data-services/teacherDataService.ts): `src/services/data-services/teacherDataService.ts`
- [Student alerts](https://github.com/sravan99k/novo-wellness/blob/main/src/alerts/index.tsx): `src/alerts/index.tsx`
- [School management](https://github.com/sravan99k/novo-wellness/blob/main/src/school/pages/UnifiedManagementPage.tsx): `src/school/pages/UnifiedManagementPage.tsx`
- [Organization management](https://github.com/sravan99k/novo-wellness/blob/main/src/organization/pages/OrganizationDashboard.tsx): `src/organization/pages/OrganizationDashboard.tsx`

### Platform administration

- [Assessment configuration](https://github.com/sravan99k/novo-wellness/blob/main/src/admin/pages/assessment-config/AssessmentConfigHub.tsx): `src/admin/pages/assessment-config/AssessmentConfigHub.tsx`
- [Assessment deployment](https://github.com/sravan99k/novo-wellness/blob/main/src/admin/services/UnifiedDeploymentService.tsx): `src/admin/services/UnifiedDeploymentService.tsx`
- [Feature management](https://github.com/sravan99k/novo-wellness/blob/main/src/admin/pages/feature-management/FeatureManagementHub.tsx): `src/admin/pages/feature-management/FeatureManagementHub.tsx`
- [Notifications](https://github.com/sravan99k/novo-wellness/blob/main/src/admin/pages/notifications/NotificationHub.tsx): `src/admin/pages/notifications/NotificationHub.tsx`

### Other components

- **Student**
- **Teacher**
- **School staff**
- **Platform admin**
- **Firebase Firestore**
- **Platform API**

## Connections

- Student → Role-based app: opens
- Teacher → Role-based app: opens
- School staff → Role-based app: opens
- Platform admin → Role-based app: opens
- Role-based app → Authentication: provides access
- Authentication → Microsoft identity: authenticates
- Authentication → API client: fetches profile
- API client → Platform API: requests data
- Role-based app → Student dashboard: routes to
- Role-based app → Assessment experience: routes to
- Role-based app → Wellness tools: routes to
- Role-based app → Teacher dashboard: routes to
- Role-based app → School management: routes to
- Role-based app → Organization management: routes to
- Role-based app → Assessment configuration: routes to
- Role-based app → Feature management: routes to
- Role-based app → Notifications: routes to
- Assessment experience → Assessment services: assessment wiring unclear
- Assessment services → Risk flag rules: scoring wiring unclear
- Assessment experience → Assessment results: results wiring unclear
- Wellness tools → Wellness data: data wiring unclear
- Teacher dashboard → Teacher data access: loads teacher data
- Teacher data access → Firebase Firestore: reads records
- Student alerts → API client: fetches alerts
- Assessment deployment → Assessment configuration: configuration wiring unclear
