# codewizardmx0-lgtm/school-quality-system architecture

> Architecture diagram of the GitHub repository codewizardmx0-lgtm/school-quality-system, 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/codewizardmx0-lgtm/school-quality-system
- Repository: https://github.com/codewizardmx0-lgtm/school-quality-system

## Overview

This is a school-quality evaluation system: school evaluators assess standards and indicators, attach evidence, submit evaluations for review, and use results to drive improvement plans and reporting. Central ministry users manage cycles and standards; administrators manage users and schools. The graph reflects the Laravel API, React client, and documented capabilities. Some subsystems are represented at directory level because their source was not sampled; links without direct evidence are omitted.

Main entry points: [`school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php`](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php) (Evaluator operations), [`school-eval-api/app/Models/Evaluation.php`](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/Evaluation.php) (Evaluation records), [`school-eval-web/src/features/evaluation/api/evaluatorApi.ts`](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/features/evaluation/api/evaluatorApi.ts) (API client), [`school-eval-api/app/Models/EvaluationResult.php`](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/EvaluationResult.php) (Indicator results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["React application<br/>[App.tsx]"]
  node_evalui["Evaluation workspace"]
  node_evidenceui["Evidence repository"]
  node_reviewui["Review hub"]
  node_apiweb["API client<br/>[evaluatorApi.ts]"]
end

subgraph group_api["API and access"]
  node_apiserver["Laravel API<br/>[api.php]"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_admin["Admin management"]
  node_notifications["Notifications"]
end

subgraph group_assessment["Evaluation workflow"]
  node_evaluation["Evaluation operations"]
  node_evaluatorapi["Evaluator operations"]
  node_evaluationstate[("Evaluation records<br/>[Evaluation.php]")]
  node_resultstate[("Indicator results")]
  node_evidencestate[("Evidence links<br/>[EvidenceLink.php]")]
end

subgraph group_improvement["Improvement and reporting"]
  node_improvement["Improvement plans"]
  node_plansstate[("Plan and action records")]
  node_actionstate[("Improvement actions")]
  node_analytics["Reports and analytics"]
  node_exports["Report exports"]
end

subgraph group_reference["Standards and cycles"]
  node_cycle[("Evaluation cycles")]
  node_standards[("Standards versions")]
  node_indicator[("Indicator rubric<br/>[Indicator.php]")]
  node_schoolmetrics["School profile context"]
end

node_actor(("System users"))

node_actor -->|"uses"| node_webapp
node_webapp -.->|"shows"| node_evalui
node_evalui -->|"requests data"| node_apiweb
node_evidenceui -->|"requests evidence"| node_apiweb
node_reviewui -->|"requests review data"| node_apiweb
node_apiweb -.->|"calls API"| node_apiserver
node_apiserver -.->|"routes requests"| node_auth
node_actor -.->|"manages accounts"| node_admin
node_evaluation -->|"reads and updates"| node_evaluationstate
node_evaluation -->|"reads and updates"| node_resultstate
node_evaluatorapi -->|"uses"| node_evaluationstate
node_evaluatorapi -->|"uses"| node_resultstate
node_evaluatorapi -->|"uses"| node_evidencestate
node_evaluatorapi -->|"uses"| node_cycle
node_evaluationstate -->|"has results"| node_resultstate
node_evaluationstate -->|"has evidence links"| node_evidencestate
node_resultstate -.->|"scores indicator"| node_indicator
node_cycle -->|"references version"| node_standards
node_actor -.->|"manages plans"| node_improvement
node_improvement -->|"creates and updates"| node_plansstate
node_plansstate -->|"has actions"| node_actionstate
node_actor -.->|"reviews reports"| node_analytics
node_analytics -.->|"generates reports"| node_exports
node_actor -.->|"receives updates"| node_notifications

click node_webapp "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/App.tsx"
click node_evalui "https://github.com/codewizardmx0-lgtm/school-quality-system/tree/main/school-eval-web/src/features/evaluation/components"
click node_evidenceui "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/features/evaluation/components/evidences/EvidencesRepository.tsx"
click node_reviewui "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/features/evaluation/components/audit-hub/AuditReviewHubPage.tsx"
click node_apiweb "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/features/evaluation/api/evaluatorApi.ts"
click node_apiserver "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/routes/api.php"
click node_auth "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/AuthController.php"
click node_admin "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/AdminController.php"
click node_evaluation "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/EvaluationController.php"
click node_evaluatorapi "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php"
click node_evaluationstate "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/Evaluation.php"
click node_resultstate "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/EvaluationResult.php"
click node_evidencestate "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/EvidenceLink.php"
click node_cycle "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/EvaluationCycle.php"
click node_standards "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/StandardVersion.php"
click node_indicator "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/Indicator.php"
click node_schoolmetrics "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Services/SchoolMetricsService.php"
click node_improvement "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/ImprovementPlanController.php"
click node_plansstate "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/ImprovementPlan.php"
click node_actionstate "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/ImprovementAction.php"
click node_analytics "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Services/ReportsAnalyticsService.php"
click node_exports "https://github.com/codewizardmx0-lgtm/school-quality-system/tree/main/school-eval-api/app/Exports"
click node_notifications "https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Services/NotificationService.php"

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_webapp,node_evalui,node_evidenceui,node_reviewui,node_apiweb,node_actor toneBlue
class node_apiserver,node_auth,node_admin,node_notifications toneAmber
class node_evaluation,node_evaluatorapi,node_evaluationstate,node_resultstate,node_evidencestate toneMint
class node_improvement,node_plansstate,node_actionstate,node_analytics,node_exports toneRose
class node_cycle,node_standards,node_indicator,node_schoolmetrics toneIndigo
```

## Components

### Web application

- [React application](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/App.tsx): `school-eval-web/src/App.tsx`
- [Evaluation workspace](https://github.com/codewizardmx0-lgtm/school-quality-system/tree/main/school-eval-web/src/features/evaluation/components): `school-eval-web/src/features/evaluation/components`
- [Evidence repository](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/features/evaluation/components/evidences/EvidencesRepository.tsx): `school-eval-web/src/features/evaluation/components/evidences/EvidencesRepository.tsx`
- [Review hub](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/features/evaluation/components/audit-hub/AuditReviewHubPage.tsx): `school-eval-web/src/features/evaluation/components/audit-hub/AuditReviewHubPage.tsx`
- [API client](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-web/src/features/evaluation/api/evaluatorApi.ts): `school-eval-web/src/features/evaluation/api/evaluatorApi.ts`

### API and access

- [Laravel API](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/routes/api.php): `school-eval-api/routes/api.php`
- [Authentication](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/AuthController.php): `school-eval-api/app/Http/Controllers/Api/V1/AuthController.php`
- [Admin management](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/AdminController.php): `school-eval-api/app/Http/Controllers/Api/V1/AdminController.php`
- [Notifications](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Services/NotificationService.php): `school-eval-api/app/Services/NotificationService.php`

### Evaluation workflow

- [Evaluation operations](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/EvaluationController.php): `school-eval-api/app/Http/Controllers/Api/V1/EvaluationController.php`
- [Evaluator operations](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php): `school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php`
- [Evaluation records](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/Evaluation.php): `school-eval-api/app/Models/Evaluation.php`
- [Indicator results](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/EvaluationResult.php): `school-eval-api/app/Models/EvaluationResult.php`
- [Evidence links](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/EvidenceLink.php): `school-eval-api/app/Models/EvidenceLink.php`

### Improvement and reporting

- [Improvement plans](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Http/Controllers/Api/V1/ImprovementPlanController.php): `school-eval-api/app/Http/Controllers/Api/V1/ImprovementPlanController.php`
- [Plan and action records](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/ImprovementPlan.php): `school-eval-api/app/Models/ImprovementPlan.php`
- [Improvement actions](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/ImprovementAction.php): `school-eval-api/app/Models/ImprovementAction.php`
- [Reports and analytics](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Services/ReportsAnalyticsService.php): `school-eval-api/app/Services/ReportsAnalyticsService.php`
- [Report exports](https://github.com/codewizardmx0-lgtm/school-quality-system/tree/main/school-eval-api/app/Exports): `school-eval-api/app/Exports`

### Standards and cycles

- [Evaluation cycles](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/EvaluationCycle.php): `school-eval-api/app/Models/EvaluationCycle.php`
- [Standards versions](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/StandardVersion.php): `school-eval-api/app/Models/StandardVersion.php`
- [Indicator rubric](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Models/Indicator.php): `school-eval-api/app/Models/Indicator.php`
- [School profile context](https://github.com/codewizardmx0-lgtm/school-quality-system/blob/main/school-eval-api/app/Services/SchoolMetricsService.php): `school-eval-api/app/Services/SchoolMetricsService.php`

### Other components

- **System users**

## Connections

- System users → React application: uses (evidence: `README.md`)
- React application → Evaluation workspace: shows
- Evaluation workspace → API client: requests data (evidence: `school-eval-web/src/features/evaluation/components/evidences/EvidencesRepository.tsx`)
- Evidence repository → API client: requests evidence (evidence: `school-eval-web/src/features/evaluation/components/evidences/EvidencesRepository.tsx`)
- Review hub → API client: requests review data (evidence: `school-eval-web/src/features/evaluation/components/audit-hub/AuditReviewHubPage.tsx`)
- API client → Laravel API: calls API
- Laravel API → Authentication: routes requests (evidence: `school-eval-api/routes/api.php`)
- System users → Admin management: manages accounts (evidence: `README.md`)
- Evaluation operations → Evaluation records: reads and updates (evidence: `school-eval-api/app/Http/Controllers/Api/V1/EvaluationController.php`)
- Evaluation operations → Indicator results: reads and updates (evidence: `school-eval-api/app/Http/Controllers/Api/V1/EvaluationController.php`)
- Evaluator operations → Evaluation records: uses (evidence: `school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php`)
- Evaluator operations → Indicator results: uses (evidence: `school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php`)
- Evaluator operations → Evidence links: uses (evidence: `school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php`)
- Evaluator operations → Evaluation cycles: uses (evidence: `school-eval-api/app/Http/Controllers/Api/V1/EvaluatorApiController.php`)
- Evaluation records → Indicator results: has results (evidence: `school-eval-api/app/Models/Evaluation.php`)
- Evaluation records → Evidence links: has evidence links (evidence: `school-eval-api/app/Models/Evaluation.php`)
- Indicator results → Indicator rubric: scores indicator (evidence: `school-eval-api/app/Models/Indicator.php`)
- Evaluation cycles → Standards versions: references version (evidence: `school-eval-api/app/Models/EvaluationCycle.php`)
- System users → Improvement plans: manages plans (evidence: `README.md`)
- Improvement plans → Plan and action records: creates and updates (evidence: `school-eval-api/app/Http/Controllers/Api/V1/ImprovementPlanController.php`)
- Plan and action records → Improvement actions: has actions (evidence: `school-eval-api/app/Models/ImprovementPlan.php`)
- System users → Reports and analytics: reviews reports (evidence: `README.md`)
- Reports and analytics → Report exports: generates reports (evidence: `README.md`)
- System users → Notifications: receives updates (evidence: `README.md`)
