System architecture: MVC layers and technology stack

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/LuisAMoralesA/tallerIngles-UAEMEcatepec/llms.txt

Use this file to discover all available pages before exploring further.

​

Capas del sistema

​

Vista (JSP)

• login/ — Formularios de inicio de sesión para los tres roles (administrador, profesor, alumno)
• principal/ — Menús de bienvenida por rol, punto de entrada tras autenticarse
• listas/ — Tablas de consulta de alumnos, profesores, administradores, grupos y documentos
• add/ — Formularios para agregar nuevos registros al sistema
• update/ — Formularios de actualización de información personal y credenciales
• calificaciones/ — Asignación y visualización de calificaciones parciales y promedios
• pagos/ — Seguimiento de pagos individuales y calendario de mensualidades
• menuLateral/ — Componentes de menú lateral incluidos por cada vista principal
• sweetAlert/ — Ventanas emergentes de resultado (éxito, error, advertencia, correcto)

​

Controlador (Servlets)

1. Reciben peticiones HTTP GET o POST desde los formularios JSP
2. Extraen y validan los parámetros del request
3. Invocan los métodos correspondientes de la clase BaseDatos
4. Escriben atributos en el HttpSession o en el HttpServletRequest
5. Redirigen al JSP de resultado apropiado (éxito, error o lista actualizada)

​

Modelo (JDBC)

• BaseDatos (controller/BaseDatos.java) — clase central que implementa todas las operaciones CRUD. Abre una nueva conexión JDBC para cada operación usando DriverManager.getConnection() con el driver com.mysql.cj.jdbc.Driver (mysql-connector-j 8.3.0). Todas las consultas usan PreparedStatement para evitar inyección SQL.
• POJOs de tabla (model/Tables/) — clases Java simples que representan cada tabla de la base de datos: Students, Teachers, Admin_school, Grupos, Grade, Category, Report, Payment, Payment_status, Pay_simbology, Users.
• Objetos de consulta (model/Consultas/) — clases que representan los resultados de JOINs multi-tabla, usados cuando las vistas necesitan mostrar datos combinados: ConsultaAlumnos, ConsultaTeacher, ConsultasAdmin, ConsultaGrupos, ConsultaBitacorasAlumnos, ConsultaBitacorasProfesores, ConsultaCalificaciones, ConsultaPagos.

​

Tecnologías

​

Estructura de paquetes

src/main/java/
├── controller/
│   ├── BaseDatos.java          # CRUD principal contra MySQL
│   ├── Constantes.java         # URLs, rutas y constantes globales
│   ├── Reportes.java           # Generación de PDF con JasperReports
│   ├── Respaldo.java           # Exportación Excel/SQL
│   ├── SHA256.java             # Hash de contraseñas
│   ├── servlet/                # Servlets Jakarta EE (@WebServlet)
│   └── struct/                 # Interfaces de contrato
├── model/
│   ├── Tables/                 # POJOs representando tablas de BD
│   └── Consultas/              # Objetos para resultados de JOIN
└── uaemex/mx/tallerdeinglesuaem/
    ├── JakartaRestConfiguration.java
    └── resources/
        └── JakartaEE10Resource.java
src/main/webapp/
├── WEB-INF/
│   └── web.xml                 # Configuración de sesión (30 min)
├── css/                        # Hojas de estilo por vista
├── js/                         # Scripts: login, alertas, pagos
├── Images/                     # Logos, fotos, iconos
├── reports/                    # Plantillas JasperReports (.jasper/.jrxml)
├── view/                       # JSPs organizados por función
└── index.html                  # Página principal pública

​

Flujo de una solicitud

1. El usuario envía un formulario en una vista JSP (por ejemplo, el formulario de inscripción de un nuevo alumno).
2. El navegador realiza un POST o GET a la URL del servlet correspondiente (por ejemplo, /tallerDeInglesUAEM/addStudent).
3. El servlet lee los parámetros del request con request.getParameter(), valida los datos y construye los objetos de modelo necesarios.
4. BaseDatos ejecuta un PreparedStatement contra MySQL 8, devolviendo un resultado o confirmando la operación.
5. El servlet establece atributos en la sesión (HttpSession) o en el request (HttpServletRequest) y redirige con response.sendRedirect() o hace forward() al JSP de destino.
6. El JSP renderiza la respuesta utilizando los atributos inyectados, presentando los datos en tablas interactivas de DataTables sobre un layout Bootstrap.