Estimado(a) usuario(a), es un placer y honor compartir este nuevo proyecto enfocado en la administración integral de reservas y activos informáticos para la Facultad de Informática y Ciencias Aplicadas (FICA - UTEC). Agradezco mucho la visita a este repositorio. Antes de iniciar, usted debe realizar algunas configuraciones iniciales para el buen funcionamiento de este proyecto en su servidor local o en la nube. A continuación, se detallarán los cambios que usted debe realizar en el código fuente de la aplicación.
1) Configuración de conexión PDO (Base de Datos): Este proyecto ha sido trabajado utilizando objetos de conexión seguros (PDO). Para que el sistema acceda a tus datos, por favor ubique y edite el siguiente archivo crítico: Modelo/conexion.php; allí usted podrá ubicar las variables principales del servidor y realizar el pertinente ajuste con las credenciales de su motor local (por defecto `localhost` y usuario `root` sin contraseña).
2) Configuración de la API de Twilio (Notificaciones SMS): Este proyecto cuenta con el envío automático de notificaciones vía red móvil. Su función principal es alertar sobre la creación, modificación, y aprobación de solicitudes de reservas por parte de los docentes. Por lo cual, para evitar errores de latencia HTTP, por favor ubique los archivos controladores e invierta las variables correspondientes a su Account SID, Auth Token y número de teléfono emisor aprobados por Twilio. Para información más detallada, consulte la documentación oficial de Twilio. Usted es libre de comentar o ignorar esta funcionalidad si no cuenta con una llave API vigente.
3) Base de Datos: Si por alguna razón al momento de importar la base de datos a su servidor existen errores o alertas de advertencia, quiere decir que la base se importó de manera parcial. Le sugerimos usar herramientas especializadas para bases con lógicas transaccionales fuertes en su interior, como el propio motor MySQL Workbench.
Se ha blindado el código contra inyecciones e integraciones erróneas. Si usted instala el proyecto en producción pero no ingresa parámetros válidos en los constructores de Twilio, el sistema intentará forzar los comunicados a través de `file_get_contents` y podría ocasionar demoras al confirmar nuevas reservaciones. LOS USUARIOS QUE CLONEN O DESCARGUEN ESTE REPOSITORIO DEBEN ASIGNAR SU PROPIO TOKEN API EN LAS VARIABLES DE ENTORNO. EL TOKEN ORIGINAL FUE REMOVIDO EXPRESAMENTE POR SEGURIDAD.
Se recomienda encarecidamente el uso del SGBD MySQL Workbench; de esta manera, la importación de todos los datos —junto con sus rutinas asociadas— se realizará de mejor forma que usando phpMyAdmin convencional. Para ello debe seguir estos pasos:
- Primero cree el esquema de la base de datos. Se recomienda estrictamente el nombre control_laboratorios_utec, ya que es la denominación parametrizada en la aplicación.
- Importe el script SQL que contiene las 18 tablas estructurales del sistema.
- Ejecute e importe las instrucciones para las 86 Vistas que generan los reportes y DataTables de la solución.
- Ejecute e importe las instrucciones para los 175 Procedimientos Almacenados. (Vital, pues el 100% de la lógica reside aquí).
- Active la variable global Event Scheduler en MySQL y ejecute las instrucciones para los 3 Eventos Automáticos / Jobs del sistema.
Siguiendo los pasos anteriores, ʕ•́ᴥ•̀ʔっ usted ya tiene todo listo para ejecutar este proyecto en su servidor. A continuación se detallarán aspectos técnicos.
¿Qué es el Control de Laboratorios FICA? Es una aplicación institucional web moderna que simula y reemplaza un intrincado proceso físico universitario. Usted puede llevar trazabilidad de cada sala especializada (Equipos, Componentes e Instalaciones). Además de ser un centro neurálgico donde los Docentes solicitan reservas con justificaciones, bloqueando cruces de horarios y controlando el cupo estudiantil antes de su aprobación unificada. El sistema clasifica de forma hermética el acceso en tres tipos de roles: Coordinador General, Administrador de Laboratorios y Docentes.
Este sistema, a nivel de código y base de datos, se encuentra distribuido de la siguiente manera:
- Arquitectura de Base de Datos (MySQL):
- 18 Tablas transaccionales.
- 175 Procedimientos Almacenados delegando la lógica.
- 86 Vistas para gráficos e interactividad JSON.
- 3 Disparadores temporales y de mantenimiento (Events).
- Arquitectura Web (Front y Back):
- Backend robusto bajo PHP 8.2+ y el patrón Modelo Vista Controlador (MVC).
- Ausencia total de código SQL dentro de la aplicación. Todas las interacciones llaman exclusivamente a subrutinas seguras.
- Frontend enriquecido usando plantillas Bootstrap.
- Manipulación asincrónica utilizando AJAX y Javascript Vanilla / jQuery.
- Registar automáticamente y mantener a nuevos Profesores y Administradores.
- Visualización de métricas avanzadas (Dashboard) usando Chart.js para contabilizar el rendimiento, daños de equipos y laboratorios operables.
- Aceptar, posponer o descartar peticiones de reservaciones horarias lanzadas por los docentes con un solo click.
- Configurar avisos masivos hacia el personal.
- Consultar y exportar bitácoras formales o actas padronizadas de equipos a formato PDF y de Cálculo (Excel).
- Monitorear la cuota y disponibilidad de cada centro tecnológico (Por ejemplo: LAB 15 - Edificio Francisco Morazán).
- Gestión de Mantenimientos:
▪ Levantar observaciones críticas de estado de equipos.
▪ Catalogar un PC o estación como en reparación por el administrador, quitándolo de la capacidad operativa instalada. - Notificación centralizada e instantánea vía sistema o dispositivo telefónico cada vez que el calendario sufre una mutación radical.
Si deseas navegar bajo la demostración nativa de este software, asegúrate de clonar este repositorio usando Git Clone a tu entorno local XAMPP (`htdocs`). Los de acceso a emplear por un usuario Coordinador base son:
Usuario: daniel.rivera
Contraseña: lorem12345
Para la realización de este proyecto, se ha utilizado el siguiente ecosistema de herramientas formales:
1. Renderización Dinámica: Bootstrap 5 FrameWork Central
2. Notificaciones y Telecomunicaciones Integradas: API Twilio
3. Lógica Transaccional: MySQL Enterprise Workbench
4. Tabulaciones Avanzadas: JQuery DataTables Plugin
** PROYECTO LIBERADO CON FINES EDUCATIVOS Y NO COMERCIALES **