Sistema Centralizado de Control para Aspiradoras Autónomas en Fresadoras
Este repositorio contiene el Software de Control Central (Desktop App). Para acceder al código fuente que se ejecuta en los microcontroladores de las aspiradoras, visita el repositorio del hardware: 👉 XtrackMachine-ESP32 (Firmware)
XtrackMachine es una solución de software basada en principios de programación orientada a objetos, diseñada para la gestión y control en tiempo real de aspiradoras autónomas utilizadas en entornos de fresado.
El sistema optimiza la administración de estos dispositivos a través de una interfaz gráfica moderna, permitiendo realizar operaciones CRUD completas sobre usuarios y equipos. Su núcleo de red, basado en sockets TCP/IP, garantiza una comunicación bidireccional estable, segura y de baja latencia con el hardware (ESP32).
- Características Principales
- Arquitectura del Sistema
- Requisitos Previos
- Instalación y Configuración
- Compilación y Ejecución
- Estructura de Base de Datos
- Stack Tecnológico y Herramientas
- Licencia
- Autenticación Segura: Validación robusta de credenciales y prevención de accesos no autorizados con retroalimentación visual inmediata.
- Administración CRUD: Creación, lectura, actualización y eliminación de perfiles de usuario.
- Control de Privilegios: Diferenciación de accesos según el rol de usuario.
- Registro y Asignación: Alta de dispositivos mediante IP e ID, y vinculación directa a máquinas fresadoras específicas.
- Telemetría en Tiempo Real: Monitorización de estados operativos (En uso, Limpio, Error, Error de conexión, Desconocido).
- Administración CRUD: Modificación dinámica de parámetros de red (IP), estado y asignación de maquinaria.
- Control Remoto: Envío de comandos de ejecución y cambio de estado directamente al microcontrolador.
- Detección de Red Dinámica: Identificación automática de Gateway, Broadcast y Máscara de subred en macOS, Linux y Windows.
- Manejo de Excepciones de Red: Detección automática de pérdida de paquetes y actualización de estado ante fallos de conexión o timeouts.
El proyecto está estructurado bajo el patrón de diseño MVC (Modelo-Vista-Controlador):
- 📦 Modelo (
SQL/,Network/): Gestiona la lógica de negocio, conexiones a la base de datos MySQL y la capa de transporte TCP/IP mediante Sockets. - 🖥 Vista (
Main/*.form): Interfaz gráfica interactiva desarrollada con Java Swing y estilizada mediante FlatLaf Dark. - ⚙️ Controlador (
Main/): Clases controladoras (XtrackMachine,MainFrame,Principal,Manage,Edit,Register,Search,Settings) que procesan eventos y coordinan vistas y modelos.
- Java Development Kit (JDK): Versión 21 o superior.
- MySQL Server: Versión 8.0 o superior en ejecución (puerto por defecto
3306). - Apache Maven: Versión 3.9+ (opcional si se utiliza IntelliJ IDEA).
git clone https://github.com/Mad065/XtrackMachine.git
cd XtrackMachineImporta el esquema y datos iniciales en tu servidor MySQL:
mysql -u root -p < src/SQL/XtrackMachine.sqlEl archivo de configuración se encuentra en src/Main/config.properties:
# Red y Polling
interval=3
delay=0
gateway=192.168.1.1
broadcast=192.168.1.255
mask=255.255.255.0
# Base de Datos
db.url=jdbc:mysql://127.0.0.1:3306/xtrackmachine
db.user=root
db.password=tu_passwordNota: También puedes sobrescribir las credenciales mediante variables de entorno del sistema:
DB_URL,DB_USERyDB_PASSWORD.
Para compilar y empaquetar un JAR ejecutable con todas las dependencias embebidas:
# Compilar y empaquetar
mvn clean package
# Ejecutar el Fat JAR generado
java -jar target/xtrackmachine-1.0.0-jar-with-dependencies.jar- Abrir la carpeta raíz en IntelliJ IDEA (
File -> Open). - El IDE detectará automáticamente la configuración del módulo (
XtrackMachine.iml) o el archivopom.xml. - Asegurarse de tener seleccionado el SDK Java 21 en
Project Structure -> Project SDK. - Ejecutar la clase principal
Main.XtrackMachine.
Motor relacional: MySQL
Usuario(id [PK], nombre, contrasena, tipo_id [FK])Tipo(id [PK], nombre)Aspiradora(id [PK], ip, maquina_id [FK], encendido, estado_id [FK])Estado(id [PK], nombre)Maquina(id [PK], nombre)
- Lenguaje: Java 21
- Gestor de Dependencias / Build: Apache Maven
- Framework UI: Java Swing + FlatLaf 3.5.4
- Driver JDBC: MySQL Connector/J 9.1.0
- Protocolo de Red:
java.net.Socket/ServerSocket(TCP/IP) - CI/CD: GitHub Actions
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para obtener más detalles.
Aviso de responsabilidad: El software y firmware se proporcionan "tal cual", sin garantías sobre su desempeño directo con maquinaria física o fresadoras en entornos de producción.