How donathaniel/qr-technovation-uv works
Sistema web para administrar temporadas, estudiantes, equipos y asistencia estudiantil mediante QR, con roles diferenciados y actualizaciones en tiempo real. El flujo principal es iniciar sesión y elegir temporada, escanear el QR, registrar entrada o salida y consultar el panel o informe. El backend persiste los registros y aplica lógica de asistencia; además, el producto incluye importación, asistencia de mentores, protección de datos sensibles y notificaciones por correo. El mapa refleja relaciones visibles en excerpts, referencias del índice y README; algunos enlaces de rutas y tiempo real no se pudieron verificar en código.
Main entry points: App.tsx Rutas de la app · api.ts Cliente API · data-source.js Acceso a datos · studentController.js Lógica estudiantes
Components 30
Aplicación web
- Rutas de la app
frontend/src/App.tsx - Cliente API
frontend/src/services/api.ts - Escáner QR
frontend/src/components/QrScanner.tsx - Actualización tiempo real
frontend/src/hooks/useSocket.ts
Acceso y temporadas
- Sesión y temporada
frontend/src/context/AuthContext.tsx - Servicio de acceso
frontend/src/services/auth.ts - Gestión temporadas
frontend/src/pages/SeasonsPage.tsx - Acceso por temporada
backend/src/utils/seasonAccess.js
Gestión y asistencia
- Gestión estudiantes
frontend/src/pages/StudentsPage.tsx - Gestión equipos
frontend/src/pages/TeamsPage.tsx - Panel e informes
frontend/src/pages/AttendanceReportPage.tsx - Fechas de asistencia
frontend/src/pages/DatesPage.tsx - Importación estudiantes
frontend/src/pages/StudentImportPage.tsx - Asistencia mentores
frontend/src/pages/MentorAttendancePage.tsx - Asistencia de equipo
frontend/src/pages/MyTeamAttendancePage.tsx - Registro de asistencia
backend/src/controllers/attendanceController.js - Lógica estudiantes
backend/src/controllers/studentController.js - Lógica equipos
backend/src/controllers/teamController.js - Carga de estudiantes
backend/src/controllers/studentImportController.js - Registro mentores
backend/src/controllers/mentorAttendanceController.js - Generación QR
backend/src/services/qrService.js
Servicios y persistencia
- Servidor HTTP
backend/src/main.js - Rutas API
backend/src/routes/auth.js - Acceso a datos
backend/src/database/data-source.js - Protección de datos
backend/src/services/sensitiveDataService.js
Notificaciones
- Cola y auditoría email
backend/src/services/emailQueueService.js - Entrega de correo
backend/src/services/emailService.js
Other components
- Mentor o coordinador
- Proveedor de correo
- Canal Socket.io
Connections 38
- Mentor o coordinador → Rutas de la app: usa
README.md - Rutas de la app → Sesión y temporada: provee sesión
frontend/src/App.tsx - Rutas de la app → Gestión estudiantes: dirige a
frontend/src/App.tsx - Rutas de la app → Gestión equipos: dirige a
frontend/src/App.tsx - Rutas de la app → Panel e informes: dirige a
frontend/src/App.tsx - Rutas de la app → Gestión temporadas: dirige a
frontend/src/App.tsx - Rutas de la app → Fechas de asistencia: dirige a
frontend/src/App.tsx - Rutas de la app → Asistencia mentores: dirige a
frontend/src/App.tsx - Sesión y temporada → Servicio de acceso: invoca
frontend/src/context/AuthContext.tsx - Gestión estudiantes → Cliente API: consulta
frontend/src/pages/StudentsPage.tsx - Gestión equipos → Cliente API: consulta
frontend/src/pages/TeamsPage.tsx - Panel e informes → Cliente API: consulta
frontend/src/pages/AttendanceReportPage.tsx - Panel e informes → Actualización tiempo real: suscribe
frontend/src/pages/AttendanceReportPage.tsx - Escáner QR → Cliente API: envía registro
frontend/src/components/QrScanner.tsx - Importación estudiantes → Cliente API: envía carga
- Asistencia de equipo → Cliente API: consulta
- Cliente API → Servidor HTTP: solicita API
- Servidor HTTP → Rutas API: monta rutas
backend/src/main.js - Servidor HTTP → Acceso a datos: inicializa
backend/src/main.js - Servidor HTTP → Cola y auditoría email: inicia worker
backend/src/main.js - Rutas API → Registro de asistencia: despacha
- Registro de asistencia → Acceso a datos: lee y escribe
backend/src/controllers/attendanceController.js - Registro de asistencia → Protección de datos: protege datos
backend/src/controllers/attendanceController.js - Lógica estudiantes → Acceso a datos: lee y escribe
backend/src/controllers/studentController.js - Lógica estudiantes → Generación QR: genera QR
backend/src/controllers/studentController.js - Lógica estudiantes → Cola y auditoría email: encola correo
backend/src/controllers/studentController.js - Lógica estudiantes → Protección de datos: protege datos
backend/src/controllers/studentController.js - Carga de estudiantes → Acceso a datos: lee y escribe
backend/src/controllers/studentImportController.js - Carga de estudiantes → Protección de datos: protege datos
backend/src/controllers/studentImportController.js - Lógica equipos → Acceso a datos: lee y escribe
backend/src/controllers/teamController.js - Lógica equipos → Acceso por temporada: valida acceso
backend/src/controllers/teamController.js - Registro mentores → Acceso a datos: lee y escribe
backend/src/controllers/mentorAttendanceController.js - Registro mentores → Acceso por temporada: valida acceso
backend/src/controllers/mentorAttendanceController.js - Registro mentores → Protección de datos: protege datos
backend/src/controllers/mentorAttendanceController.js - Cola y auditoría email → Acceso a datos: registra trabajos
backend/src/services/emailQueueService.js - Cola y auditoría email → Entrega de correo: entrega correo
backend/src/services/emailQueueService.js - Entrega de correo → Proveedor de correo: envía mensaje
backend/src/services/emailService.js - Actualización tiempo real → Canal Socket.io: recibe eventos