Sistema de Gestión de Productos con Kiosco

Este proyecto es una aplicación de escritorio Java para la gestión de productos, desarrollada con JavaFX y MySQL/MariaDB.

Requisitos Previos

• Java Development Kit (JDK): Versión 21 o superior (Requerido por JavaFX 21).
• JavaFX: Biblioteca gráfica versión 21 (recomendada) compatible con tu JDK. Descárgala desde https://gluonhq.com/products/javafx/.
• Apache NetBeans: IDE recomendado.
• Base de Datos: MySQL o MariaDB Server.
• Driver: mysql-connector-j (Compatible con ambos motores).

Configuración de la Base de Datos

1. Asegúrate de tener el servidor de base de datos corriendo en el puerto 3306.

2. Crea una base de datos vacía llamada kiosco_db.

3. Configuración de Credenciales:

   • Navega a la carpeta src/.
   • Busca el archivo database.properties.example.
   • Renómbralo (o haz una copia) a database.properties.
   • Edita el nuevo archivo database.properties con tus credenciales locales:

   db.url=jdbc:mysql://localhost:3306/kiosco_db?serverTimezone=America/Argentina/Buenos_Aires
   db.user=root
   db.password=TU_CLAVE_REAL

Instalación y Ejecución

• Clonar/Abrir: Abre el proyecto en NetBeans.
• Librerías: Verifica que el jar mysql-connector-j-X.X.X.jar esté añadido en las librerías del proyecto.
• Compilar: Realiza un "Clean and Build" del proyecto.
• Ejecutar: Ejecuta la clase principal SistemaGestionProductos.java.

Capturas de Pantalla

Vista Principal	Gestión de Inventario

Historial de Ventas

Estructura del Proyecto

El código fuente se encuentra en la carpeta src y sigue la siguiente estructura de paquetes:

src/
├── database.properties : Archivo de configuración de la base de datos (Ignorado por Git).
├── database.properties.example : Plantilla de configuración.
└── sistemagestionproductos/
    ├── SistemaGestionProductos.java : Clase principal (Main entry point).
    ├── controllers/ : Controladores de JavaFX.
    ├── exceptions/ : Excepciones personalizadas.
    ├── models/ : Lógica de negocio y entidades.
    │   ├── SistemaProductosManejador.java
    │   ├── entities/ : Clases del modelo de dominio.
    │   ├── interfaces/ : Interfaces del sistema.
    │   └── repositorios/ : Acceso a datos (DAO/Repositories).
    ├── utils/
    │   ├── ConexionMySQL.java : Gestión de la conexión a la BD.
    │   └── InicializadorBaseDatos.java : Inicialización de tablas.
    └── views/ : Archivos FXML y recursos visuales.
        ├── css/ : Hojas de estilo.
        ├── MainLayout.fxml
        ├── ProductosView.fxml
        ├── ReportesView.fxml
        ├── VentasView.fxml
        └── formularioView.fxml

Licencia

Este proyecto está bajo la Licencia MIT - mira el archivo LICENSE para más detalles.