REPOSITORY OVERVIEWLive repository statistics
★ 1Stars
⑂ 0Forks
◯ 0Open issues
◉ 1Watchers
49/100
OPENREPOHUB HEALTH SIGNALMixed signals
A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
72 Community adoption25% weight
0 Maintenance state20% weight
100 License clarity10% weight
0 Project information10% weight
35 This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview
EntregaFinalSeminario # Sistema de Gestión de Donaciones e Inventario 🚚📦
Proyecto Final - Seminario de Lenguajes (Lic. en Sistemas - UNRN)
Este es un sistema integral de gestión logística desarrollado en Java y MySQL para optimizar el ciclo completo de recepción, procesamiento y distribución de donaciones de una organización sin fines de lucro.
🔄 Flujo Operativo del Sistema (End-to-End)
El software rompe con el esquema tradicional de ABMs simples, implementando un motor de procesos de negocio dividido en cuatro etapas clave:
- Captación y Registros Básicos: Gestión centralizada de actores maestros (Donantes, Voluntarios, Beneficiarios y Vehículos con control de capacidad de carga).
- Logística de Recolección (Entradas): Registro de pedidos de donación que se transforman en Órdenes de Retiro. Cuenta con un sistema granular de seguimiento de múltiples visitas para manejar reintentos o estados intermedios (
PENDIENTE, EN_EJECUCIÓN, COMPLETADO).
- Procesamiento de Inventario: Lógica avanzada que permite transformar categorías generales de recolección en artículos específicos con stock propio (ej: de "Ropa" a "5 Remeras" y "5 Pantalones"), impactando en tiempo real en el Inventario Centralizado.
- Logística de Distribución (Salidas): Generación de Órdenes de Entrega asignadas a voluntarios y beneficiarios (priorizados según situación socioeconómica), descontando automáticamente del stock y registrando cada movimiento.
🛠️ Stack Tecnológico y Arquitectura
El proyecto fue estructurado bajo el patrón arquitectónico MVC (Modelo-Vista-Controlador) separado estrictamente en capas para asegurar la escalabilidad:
- Backend / Lógica de Negocio: Separación analítica utilizando patrones DAO (Data Access Object) mediante interfaces y DTOs (Data Transfer Objects) para el desacople de datos.
- Persistencia e Integridad: Implementación de consultas nativas mediante JDBC, gestionando manualmente las Transacciones SQL para asegurar la atomicidad de las operaciones complejas en la base de datos.
- Frontend / GUI: Interfaz gráfica de usuario moderna desarrollada íntegramente con Java Swing y manejo de eventos dinámicos.
- Base de Datos: Modelo relacional diseñado y gestionado en MySQL Workbench.
🚀 Cómo ejecutar el proyecto
- Clona este repositorio en la rama principal:
proyecto-finalizado-v1.
- Importa el script SQL provisto en la sección de documentación para levantar la base de datos en tu servidor MySQL local.
- Configura las credenciales de conexión en la capa de persistencia (
PersistenceApi.java).
- Ejecuta la clase principal para iniciar el Menú del Sistema.
Desarrollado como parte de la formación académica en la Universidad Nacional de Río Negro.