# kevinrcorrales/sistemamatriculas architecture

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

## Overview

Sistema de matrículas universitarias: estudiantes y personal administrativo acceden al portal, que consulta o modifica datos académicos y devuelve vistas de matrícula, notas, recibos y análisis institucional. React organiza el acceso y las vistas; su cliente API comunica con FastAPI, que sirve el portal y opera sobre MariaDB. La app Electron documentada carga el mismo portal. Los enlaces de integración se apoyan en el README; las relaciones entre módulos del frontend, en los imports o llamadas mostrados. No se inspeccionaron todas las rutas del backend.

Main entry points: [`web/src/App.jsx`](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/App.jsx) (Enrutador portal), [`web/src/api.js`](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/api.js) (Cliente API), [`servidor.py`](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/servidor.py) (API FastAPI), [`web/src/vistas/Login.jsx`](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Login.jsx) (Acceso)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal web"]
  node_app["Enrutador portal<br/>[App.jsx]"]
  node_login["Acceso<br/>[Login.jsx]"]
  node_sesion["Sesión<br/>[sesion.jsx]"]
  node_datos["Contexto datos<br/>[contexto.jsx]"]
  node_apiweb["Cliente API<br/>[api.js]"]
  node_layout["Navegación<br/>[Layout.jsx]"]
  node_ui["Componentes UI<br/>[ui.jsx]"]
  node_validaciones["Reglas de entrada<br/>[validaciones.js]"]
  node_hooks["Carga y formularios<br/>[hooks.js]"]
end

subgraph group_academico["Gestión académica"]
  node_facultades["Facultades<br/>[Facultades.jsx]"]
  node_carreras["Carreras<br/>[Carreras.jsx]"]
  node_estudiantes["Estudiantes<br/>[Estudiantes.jsx]"]
  node_materias["Materias<br/>[Materias.jsx]"]
  node_matricula["Matrícula<br/>[Matricula.jsx]"]
  node_notas["Notas<br/>[Notas.jsx]"]
end

subgraph group_analitica["Consultas e informes"]
  node_recibos["Recibos<br/>[Recibos.jsx]"]
  node_dashboard["Dashboard institucional<br/>[Dashboard.jsx]"]
  node_dashestudiante["Panel estudiante"]
  node_ranking["Ranking<br/>[Ranking.jsx]"]
end

subgraph group_backend["API y persistencia"]
  node_servidor["API FastAPI<br/>[servidor.py]"]
  node_reglas["Reglas heredadas<br/>[sistema.py]"]
  node_mariadb[("MariaDB universidad<br/>[universidad.sql]")]
end

subgraph group_escritorio["Cliente escritorio"]
  node_electron["Ventana Electron<br/>[main.js]"]
end

node_personas(("Usuarios"))
node_servicio(("Servicio remoto"))

node_personas -->|"abre portal"| node_app
node_app -->|"muestra acceso"| node_login
node_app -->|"consulta sesión"| node_sesion
node_app -->|"provee contexto"| node_datos
node_app -->|"presenta navegación"| node_layout
node_app -->|"enruta a"| node_facultades
node_app -->|"enruta a"| node_carreras
node_app -->|"enruta a"| node_estudiantes
node_app -->|"enruta a"| node_materias
node_app -->|"enruta a"| node_matricula
node_app -->|"enruta a"| node_notas
node_app -->|"enruta a"| node_recibos
node_app -->|"enruta a"| node_dashboard
node_app -->|"enruta a"| node_dashestudiante
node_app -->|"enruta a"| node_ranking
node_login -->|"solicita acceso"| node_apiweb
node_sesion -->|"verifica sesión"| node_apiweb
node_datos -->|"carga catálogos"| node_apiweb
node_facultades -->|"consulta y modifica"| node_apiweb
node_carreras -->|"consulta y modifica"| node_apiweb
node_estudiantes -->|"consulta y modifica"| node_apiweb
node_materias -->|"consulta y modifica"| node_apiweb
node_matricula -->|"gestiona matrículas"| node_apiweb
node_notas -->|"consulta y guarda"| node_apiweb
node_recibos -->|"solicita recibos"| node_apiweb
node_dashboard -->|"solicita indicadores"| node_apiweb
node_dashestudiante -->|"solicita panel"| node_apiweb
node_ranking -->|"solicita ranking"| node_apiweb
node_apiweb -->|"envía peticiones REST"| node_servidor
node_servidor -->|"lee y escribe"| node_mariadb
node_servidor -->|"reutiliza reglas"| node_reglas
node_electron -->|"carga portal"| node_servicio
node_servicio -->|"sirve API y portal"| node_servidor

click node_app "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/App.jsx"
click node_login "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Login.jsx"
click node_sesion "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/sesion.jsx"
click node_datos "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/contexto.jsx"
click node_apiweb "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/api.js"
click node_layout "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/componentes/Layout.jsx"
click node_ui "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/componentes/ui.jsx"
click node_validaciones "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/validaciones.js"
click node_hooks "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/hooks.js"
click node_facultades "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Facultades.jsx"
click node_carreras "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Carreras.jsx"
click node_estudiantes "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Estudiantes.jsx"
click node_materias "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Materias.jsx"
click node_matricula "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Matricula.jsx"
click node_notas "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Notas.jsx"
click node_recibos "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Recibos.jsx"
click node_dashboard "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Dashboard.jsx"
click node_dashestudiante "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/DashboardEstudiante.jsx"
click node_ranking "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Ranking.jsx"
click node_servidor "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/servidor.py"
click node_reglas "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/sistema.py"
click node_mariadb "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/universidad.sql"
click node_electron "https://github.com/kevinrcorrales/sistemamatriculas/blob/main/escritorio/main.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_app,node_login,node_sesion,node_datos,node_apiweb,node_layout,node_ui,node_validaciones,node_hooks toneBlue
class node_facultades,node_carreras,node_estudiantes,node_materias,node_matricula,node_notas toneAmber
class node_recibos,node_dashboard,node_dashestudiante,node_ranking toneMint
class node_servidor,node_reglas,node_mariadb toneRose
class node_electron,node_personas,node_servicio toneIndigo
```

## Components

### Portal web

- [Enrutador portal](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/App.jsx): `web/src/App.jsx`
- [Acceso](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Login.jsx): `web/src/vistas/Login.jsx`
- [Sesión](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/sesion.jsx): `web/src/sesion.jsx`
- [Contexto datos](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/contexto.jsx): `web/src/contexto.jsx`
- [Cliente API](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/api.js): `web/src/api.js`
- [Navegación](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/componentes/Layout.jsx): `web/src/componentes/Layout.jsx`
- [Componentes UI](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/componentes/ui.jsx): `web/src/componentes/ui.jsx`
- [Reglas de entrada](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/validaciones.js): `web/src/validaciones.js`
- [Carga y formularios](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/hooks.js): `web/src/hooks.js`

### Gestión académica

- [Facultades](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Facultades.jsx): `web/src/vistas/Facultades.jsx`
- [Carreras](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Carreras.jsx): `web/src/vistas/Carreras.jsx`
- [Estudiantes](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Estudiantes.jsx): `web/src/vistas/Estudiantes.jsx`
- [Materias](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Materias.jsx): `web/src/vistas/Materias.jsx`
- [Matrícula](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Matricula.jsx): `web/src/vistas/Matricula.jsx`
- [Notas](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Notas.jsx): `web/src/vistas/Notas.jsx`

### Consultas e informes

- [Recibos](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Recibos.jsx): `web/src/vistas/Recibos.jsx`
- [Dashboard institucional](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Dashboard.jsx): `web/src/vistas/Dashboard.jsx`
- [Panel estudiante](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/DashboardEstudiante.jsx): `web/src/vistas/DashboardEstudiante.jsx`
- [Ranking](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/web/src/vistas/Ranking.jsx): `web/src/vistas/Ranking.jsx`

### API y persistencia

- [API FastAPI](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/servidor.py): `servidor.py`
- [Reglas heredadas](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/sistema.py): `sistema.py`
- [MariaDB universidad](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/universidad.sql): `universidad.sql`

### Cliente escritorio

- [Ventana Electron](https://github.com/kevinrcorrales/sistemamatriculas/blob/main/escritorio/main.js): `escritorio/main.js`

### Other components

- **Usuarios**
- **Servicio remoto**

## Connections

- Usuarios → Enrutador portal: abre portal (evidence: `README.md`)
- Enrutador portal → Acceso: muestra acceso (evidence: `web/src/App.jsx`)
- Enrutador portal → Sesión: consulta sesión (evidence: `web/src/App.jsx`)
- Enrutador portal → Contexto datos: provee contexto (evidence: `web/src/App.jsx`)
- Enrutador portal → Navegación: presenta navegación (evidence: `web/src/App.jsx`)
- Enrutador portal → Facultades: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Carreras: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Estudiantes: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Materias: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Matrícula: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Notas: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Recibos: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Dashboard institucional: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Panel estudiante: enruta a (evidence: `web/src/App.jsx`)
- Enrutador portal → Ranking: enruta a (evidence: `web/src/App.jsx`)
- Acceso → Cliente API: solicita acceso (evidence: `web/src/vistas/Login.jsx`)
- Sesión → Cliente API: verifica sesión (evidence: `web/src/sesion.jsx`)
- Contexto datos → Cliente API: carga catálogos (evidence: `web/src/contexto.jsx`)
- Facultades → Cliente API: consulta y modifica (evidence: `web/src/vistas/Facultades.jsx`)
- Carreras → Cliente API: consulta y modifica (evidence: `web/src/vistas/Carreras.jsx`)
- Estudiantes → Cliente API: consulta y modifica (evidence: `web/src/vistas/Estudiantes.jsx`)
- Materias → Cliente API: consulta y modifica (evidence: `web/src/vistas/Materias.jsx`)
- Matrícula → Cliente API: gestiona matrículas (evidence: `web/src/vistas/Matricula.jsx`)
- Notas → Cliente API: consulta y guarda (evidence: `web/src/vistas/Notas.jsx`)
- Recibos → Cliente API: solicita recibos (evidence: `web/src/vistas/Recibos.jsx`)
- Dashboard institucional → Cliente API: solicita indicadores (evidence: `web/src/vistas/Dashboard.jsx`)
- Panel estudiante → Cliente API: solicita panel (evidence: `web/src/vistas/DashboardEstudiante.jsx`)
- Ranking → Cliente API: solicita ranking (evidence: `web/src/vistas/Ranking.jsx`)
- Cliente API → API FastAPI: envía peticiones REST (evidence: `README.md`)
- API FastAPI → MariaDB universidad: lee y escribe (evidence: `README.md`)
- API FastAPI → Reglas heredadas: reutiliza reglas (evidence: `README.md`)
- Ventana Electron → Servicio remoto: carga portal (evidence: `README.md`)
- Servicio remoto → API FastAPI: sirve API y portal (evidence: `README.md`)
