Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

64 Commits

Folders and files

Repository files navigation

⚙️ XtrackMachine – Sistema Central

Sistema Centralizado de Control para Aspiradoras Autónomas en Fresadoras

Java Maven MySQL TCP/IP FlatLaf License

🔗 Ecosistema del Proyecto

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)


📖 Descripción General

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).


📑 Tabla de Contenidos

  1. Características Principales
  2. Arquitectura del Sistema
  3. Requisitos Previos
  4. Instalación y Configuración
  5. Compilación y Ejecución
  6. Estructura de Base de Datos
  7. Stack Tecnológico y Herramientas
  8. Licencia

🚀 Características Principales

👥 Gestión de Control de Acceso (Usuarios)

  • 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.

🤖 Gestión de Hardware (Aspiradoras)

  • 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.

📡 Comunicación Bidireccional (TCP/IP)

  • 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.

🏗 Arquitectura del Sistema

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.

📋 Requisitos Previos

  • 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).

⚙️ Instalación y Configuración

1. Clonar el Repositorio

git clone https://github.com/Mad065/XtrackMachine.git
cd XtrackMachine

2. Configurar la Base de Datos

Importa el esquema y datos iniciales en tu servidor MySQL:

mysql -u root -p < src/SQL/XtrackMachine.sql

3. Configuración de Parámetros (config.properties)

El 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_password

Nota: También puedes sobrescribir las credenciales mediante variables de entorno del sistema: DB_URL, DB_USER y DB_PASSWORD.


🔨 Compilación y Ejecución

Opción A: Mediante Apache Maven (Terminal o CI/CD)

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

Opción B: Mediante IntelliJ IDEA

  1. Abrir la carpeta raíz en IntelliJ IDEA (File -> Open).
  2. El IDE detectará automáticamente la configuración del módulo (XtrackMachine.iml) o el archivo pom.xml.
  3. Asegurarse de tener seleccionado el SDK Java 21 en Project Structure -> Project SDK.
  4. Ejecutar la clase principal Main.XtrackMachine.

🗄 Estructura de Base de Datos

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)

🛠 Stack Tecnológico y Herramientas

  • 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

📄 Licencia

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages