# prrix999/student-management-system architecture

> Architecture diagram of the GitHub repository prrix999/student-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/prrix999/student-management-system
- Repository: https://github.com/prrix999/student-management-system

## Overview

This is a single-file terminal student-management application. Users choose menu actions to register or find records, maintain contact details and scores, and view individual or class performance output. The main script owns the menu, validations, domain operations, and report calculations; it reads and writes persistent JSON records. The README documents these capabilities, but omitted source excerpts do not show all menu dispatches or persistence calls, so those connections are left out rather than inferred.

Main entry points: [`student_management_system.py`](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py) (Menu workflow), [`students_record.json`](https://github.com/prrix999/student-management-system/blob/main/students_record.json) (JSON records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Terminal application"]
  node_menu["Menu workflow"]
  node_validation["Input validation"]
end

subgraph group_records["Student records"]
  node_registration["Student registration"]
  node_record_view["Browse and search"]
  node_details["Details maintenance"]
  node_deletion["Student deletion"]
  node_json_store[("JSON records")]
end

subgraph group_performance["Score reporting"]
  node_scores["Score entry and updates"]
  node_individual_report["Individual report"]
  node_class_stats["Class statistics"]
end

node_user(("User"))

node_user -->|"chooses actions"| node_menu
node_menu -.->|"registers student"| node_registration
node_menu -.->|"views or searches"| node_record_view
node_menu -.->|"updates details"| node_details
node_menu -.->|"deletes student"| node_deletion
node_menu -->|"manages scores"| node_scores
node_menu -.->|"requests report"| node_individual_report
node_menu -.->|"requests statistics"| node_class_stats
node_registration -.->|"validates fields"| node_validation
node_scores -.->|"validates scores"| node_validation
node_registration -.->|"persists records"| node_json_store
node_scores -->|"writes scores"| node_json_store
node_record_view -.->|"reads records"| node_json_store
node_details -.->|"saves changes"| node_json_store
node_deletion -->|"saves deletion"| node_json_store
node_individual_report -.->|"uses scores"| node_scores
node_class_stats -.->|"aggregates scores"| node_scores

click node_menu "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_validation "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_registration "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_record_view "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_details "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_deletion "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_scores "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_individual_report "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_class_stats "https://github.com/prrix999/student-management-system/blob/main/student_management_system.py"
click node_json_store "https://github.com/prrix999/student-management-system/blob/main/students_record.json"

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_menu,node_validation,node_user toneBlue
class node_registration,node_record_view,node_details,node_deletion,node_json_store toneAmber
class node_scores,node_individual_report,node_class_stats toneMint
```

## Components

### Terminal application

- [Menu workflow](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`
- [Input validation](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`

### Student records

- [Student registration](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`
- [Browse and search](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`
- [Details maintenance](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`
- [Student deletion](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`
- [JSON records](https://github.com/prrix999/student-management-system/blob/main/students_record.json): `students_record.json`

### Score reporting

- [Score entry and updates](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`
- [Individual report](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`
- [Class statistics](https://github.com/prrix999/student-management-system/blob/main/student_management_system.py): `student_management_system.py`

### Other components

- **User**

## Connections

- User → Menu workflow: chooses actions (evidence: `README.md`)
- Menu workflow → Student registration: registers student (evidence: `student_management_system.py`)
- Menu workflow → Browse and search: views or searches (evidence: `student_management_system.py`)
- Menu workflow → Details maintenance: updates details (evidence: `student_management_system.py`)
- Menu workflow → Student deletion: deletes student (evidence: `student_management_system.py`)
- Menu workflow → Score entry and updates: manages scores (evidence: `student_management_system.py`)
- Menu workflow → Individual report: requests report (evidence: `student_management_system.py`)
- Menu workflow → Class statistics: requests statistics (evidence: `student_management_system.py`)
- Student registration → Input validation: validates fields (evidence: `student_management_system.py`)
- Score entry and updates → Input validation: validates scores (evidence: `student_management_system.py`)
- Student registration → JSON records: persists records
- Score entry and updates → JSON records: writes scores (evidence: `student_management_system.py`)
- Browse and search → JSON records: reads records
- Details maintenance → JSON records: saves changes
- Student deletion → JSON records: saves deletion (evidence: `student_management_system.py`)
- Individual report → Score entry and updates: uses scores (evidence: `student_management_system.py`)
- Class statistics → Score entry and updates: aggregates scores (evidence: `student_management_system.py`)
