# daniiela5/plataforma-asesorias architecture

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

- Interactive diagram: https://gitdiagram.com/daniiela5/plataforma-asesorias
- Repository: https://github.com/daniiela5/plataforma-asesorias

## Overview

Plataforma web para coordinar asesorías entre alumnos y profesores. El flujo principal es descubrir asesorías, inscribirse con validación de cupo y consultar las inscripciones; profesores publican y administran sesiones. También hay autenticación, gestión de materias y usuarios, y notificaciones. El mapa combina extractos de servicios y frontend con capacidades descritas en el README; varias rutas y detalles de implementación no fueron muestreados, por lo que sus enlaces se omiten o se marcan sin evidencia.

Main entry points: [`backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java`](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java) (Gestión asesorías), [`frontend/src/App.jsx`](https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/App.jsx) (Rutas SPA), [`backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java`](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java) (Inscripción y cupos), [`backend/src/main/java/com/asesorias/usuario/UsuarioRepository.java`](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/usuario/UsuarioRepository.java) (Usuarios y roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Aplicación web"]
  node_webapp["Rutas SPA<br/>[App.jsx]"]
  node_session["Sesión cliente<br/>[AuthContext.jsx]"]
  node_catalogui["Catálogo asesorías"]
  node_myadvisories["Mis asesorías<br/>[MisAsesorias.jsx]"]
  node_teacherpanel["Panel profesor<br/>[PanelProfesor.jsx]"]
end

subgraph group_identity["Identidad y usuarios"]
  node_authservice["Autenticación<br/>[AuthService.java]"]
  node_jwt["Emisión JWT<br/>[JwtService.java]"]
  node_userservice["Gestión usuarios"]
  node_userstore[("Usuarios y roles")]
end

subgraph group_catalog["Oferta académica"]
  node_advisoryservice["Gestión asesorías"]
  node_advisorystore[("Asesorías")]
  node_subjectservice["Gestión materias"]
  node_subjectstore[("Materias")]
end

subgraph group_enrollment["Inscripciones y avisos"]
  node_enrollmentservice["Inscripción y cupos"]
  node_enrollmentstore[("Inscripciones")]
  node_notification["Notificaciones"]
end

subgraph group_platform["Persistencia y servicios"]
  node_email["Correo<br/>[CorreoService.java]"]
  node_postgres[("PostgreSQL")]
end

node_student(("Alumno"))
node_professor(("Profesor"))
node_admin(("Administrador"))

node_student -->|"usa"| node_webapp
node_professor -->|"usa"| node_webapp
node_admin -->|"usa"| node_webapp
node_webapp -->|"provee sesión"| node_session
node_webapp -->|"ruta a"| node_catalogui
node_webapp -->|"ruta a"| node_myadvisories
node_webapp -->|"ruta a"| node_teacherpanel
node_session -.->|"solicita autenticación"| node_authservice
node_catalogui -.->|"consulta catálogo"| node_advisoryservice
node_myadvisories -.->|"consulta inscripciones"| node_enrollmentservice
node_teacherpanel -.->|"gestiona sesiones"| node_advisoryservice
node_teacherpanel -.->|"gestiona inscritos"| node_enrollmentservice
node_authservice -->|"lee y guarda"| node_userstore
node_authservice -->|"emite token"| node_jwt
node_authservice -->|"envía correo"| node_email
node_userservice -->|"lee y guarda"| node_userstore
node_advisoryservice -->|"consulta y guarda"| node_advisorystore
node_advisoryservice -->|"cuenta inscritos"| node_enrollmentstore
node_advisoryservice -->|"busca materia"| node_subjectstore
node_advisoryservice -->|"busca profesor"| node_userstore
node_advisoryservice -->|"avisa cancelación"| node_notification
node_subjectservice -->|"lee y guarda"| node_subjectstore
node_subjectservice -->|"asigna materias"| node_userstore
node_enrollmentservice -->|"valida asesoría"| node_advisorystore
node_enrollmentservice -->|"busca alumno"| node_userstore
node_enrollmentservice -->|"valida y modifica"| node_enrollmentstore
node_enrollmentservice -->|"notifica cambios"| node_notification
node_userstore -.->|"persiste datos"| node_postgres
node_advisorystore -.->|"persiste datos"| node_postgres
node_subjectstore -.->|"persiste datos"| node_postgres
node_enrollmentstore -.->|"persiste datos"| node_postgres

click node_webapp "https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/App.jsx"
click node_session "https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/context/AuthContext.jsx"
click node_catalogui "https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/pages/CatalogoAsesorias.jsx"
click node_myadvisories "https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/pages/MisAsesorias.jsx"
click node_teacherpanel "https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/pages/PanelProfesor.jsx"
click node_authservice "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/auth/AuthService.java"
click node_jwt "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/auth/JwtService.java"
click node_userservice "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/usuario/UsuarioService.java"
click node_userstore "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/usuario/UsuarioRepository.java"
click node_advisoryservice "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java"
click node_advisorystore "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/asesoria/AsesoriaRepository.java"
click node_subjectservice "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/materia/MateriaService.java"
click node_subjectstore "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/materia/MateriaRepository.java"
click node_enrollmentservice "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java"
click node_enrollmentstore "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/inscripcion/InscripcionRepository.java"
click node_notification "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/notificacion/NotificacionService.java"
click node_email "https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/correo/CorreoService.java"

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_session,node_catalogui,node_myadvisories,node_teacherpanel toneBlue
class node_authservice,node_jwt,node_userservice,node_userstore toneAmber
class node_advisoryservice,node_advisorystore,node_subjectservice,node_subjectstore toneMint
class node_enrollmentservice,node_enrollmentstore,node_notification toneRose
class node_email,node_postgres,node_student,node_professor,node_admin toneIndigo
```

## Components

### Aplicación web

- [Rutas SPA](https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sesión cliente](https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Catálogo asesorías](https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/pages/CatalogoAsesorias.jsx): `frontend/src/pages/CatalogoAsesorias.jsx`
- [Mis asesorías](https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/pages/MisAsesorias.jsx): `frontend/src/pages/MisAsesorias.jsx`
- [Panel profesor](https://github.com/daniiela5/plataforma-asesorias/blob/main/frontend/src/pages/PanelProfesor.jsx): `frontend/src/pages/PanelProfesor.jsx`

### Identidad y usuarios

- [Autenticación](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/auth/AuthService.java): `backend/src/main/java/com/asesorias/auth/AuthService.java`
- [Emisión JWT](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/auth/JwtService.java): `backend/src/main/java/com/asesorias/auth/JwtService.java`
- [Gestión usuarios](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/usuario/UsuarioService.java): `backend/src/main/java/com/asesorias/usuario/UsuarioService.java`
- [Usuarios y roles](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/usuario/UsuarioRepository.java): `backend/src/main/java/com/asesorias/usuario/UsuarioRepository.java`

### Oferta académica

- [Gestión asesorías](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java): `backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java`
- [Asesorías](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/asesoria/AsesoriaRepository.java): `backend/src/main/java/com/asesorias/asesoria/AsesoriaRepository.java`
- [Gestión materias](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/materia/MateriaService.java): `backend/src/main/java/com/asesorias/materia/MateriaService.java`
- [Materias](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/materia/MateriaRepository.java): `backend/src/main/java/com/asesorias/materia/MateriaRepository.java`

### Inscripciones y avisos

- [Inscripción y cupos](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java): `backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java`
- [Inscripciones](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/inscripcion/InscripcionRepository.java): `backend/src/main/java/com/asesorias/inscripcion/InscripcionRepository.java`
- [Notificaciones](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/notificacion/NotificacionService.java): `backend/src/main/java/com/asesorias/notificacion/NotificacionService.java`

### Persistencia y servicios

- [Correo](https://github.com/daniiela5/plataforma-asesorias/blob/main/backend/src/main/java/com/asesorias/correo/CorreoService.java): `backend/src/main/java/com/asesorias/correo/CorreoService.java`
- **PostgreSQL**

### Other components

- **Alumno**
- **Profesor**
- **Administrador**

## Connections

- Alumno → Rutas SPA: usa (evidence: `README.md`)
- Profesor → Rutas SPA: usa (evidence: `README.md`)
- Administrador → Rutas SPA: usa (evidence: `README.md`)
- Rutas SPA → Sesión cliente: provee sesión (evidence: `frontend/src/main.jsx`)
- Rutas SPA → Catálogo asesorías: ruta a (evidence: `frontend/src/App.jsx`)
- Rutas SPA → Mis asesorías: ruta a (evidence: `frontend/src/App.jsx`)
- Rutas SPA → Panel profesor: ruta a (evidence: `frontend/src/App.jsx`)
- Sesión cliente → Autenticación: solicita autenticación
- Catálogo asesorías → Gestión asesorías: consulta catálogo
- Mis asesorías → Inscripción y cupos: consulta inscripciones
- Panel profesor → Gestión asesorías: gestiona sesiones
- Panel profesor → Inscripción y cupos: gestiona inscritos
- Autenticación → Usuarios y roles: lee y guarda (evidence: `backend/src/main/java/com/asesorias/auth/AuthService.java`)
- Autenticación → Emisión JWT: emite token (evidence: `backend/src/main/java/com/asesorias/auth/AuthService.java`)
- Autenticación → Correo: envía correo (evidence: `backend/src/main/java/com/asesorias/auth/AuthService.java`)
- Gestión usuarios → Usuarios y roles: lee y guarda (evidence: `backend/src/main/java/com/asesorias/usuario/UsuarioService.java`)
- Gestión asesorías → Asesorías: consulta y guarda (evidence: `backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java`)
- Gestión asesorías → Inscripciones: cuenta inscritos (evidence: `backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java`)
- Gestión asesorías → Materias: busca materia (evidence: `backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java`)
- Gestión asesorías → Usuarios y roles: busca profesor (evidence: `backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java`)
- Gestión asesorías → Notificaciones: avisa cancelación (evidence: `backend/src/main/java/com/asesorias/asesoria/AsesoriaService.java`)
- Gestión materias → Materias: lee y guarda (evidence: `backend/src/main/java/com/asesorias/materia/MateriaService.java`)
- Gestión materias → Usuarios y roles: asigna materias (evidence: `backend/src/main/java/com/asesorias/materia/MateriaService.java`)
- Inscripción y cupos → Asesorías: valida asesoría (evidence: `backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java`)
- Inscripción y cupos → Usuarios y roles: busca alumno (evidence: `backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java`)
- Inscripción y cupos → Inscripciones: valida y modifica (evidence: `backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java`)
- Inscripción y cupos → Notificaciones: notifica cambios (evidence: `backend/src/main/java/com/asesorias/inscripcion/InscripcionService.java`)
- Usuarios y roles → PostgreSQL: persiste datos
- Asesorías → PostgreSQL: persiste datos
- Materias → PostgreSQL: persiste datos
- Inscripciones → PostgreSQL: persiste datos
