Skip to content

Repository files navigation

🖥️ DeviceAssign-Hub: Gestión y Asignación de Equipos (Dark Edition)

PHP MariaDB Docker Bootstrap License

Una aplicación web moderna e intuitiva diseñada para centralizar y automatizar los procesos de asignación, control de inventario y mantenimiento de equipos computacionales (hardware) para funcionarios de instituciones educativas u organizaciones.

Este repositorio cuenta con un tema oscuro premium renovado en tonos grises, tipografías refinadas y una arquitectura completamente integrada con Docker Compose para un despliegue en un solo paso.


✨ Características Principales

  • 📦 Gestión de Inventario: Control total sobre especificaciones de hardware (CPU, RAM, GPU, Disco Duro, Periféricos, Sede).
  • 🔌 Asignaciones Dinámicas: Módulo interactivo para asociar equipos a funcionarios y programas académicos con rangos de fechas definidos.
  • 🛠️ Control de Mantenciones: Historial de reparaciones, diagnósticos técnicos y reincorporaciones de equipos al inventario disponible.
  • 📊 Historial Completo: Registro histórico inmutable de asignaciones y mantenimientos previos para trazabilidad de activos.
  • 🎨 Interfaz de Alta Gama: Interfaz rediseñada con tema oscuro, efectos glassmórficos, transiciones y notificaciones SweetAlert2 dinámicas.

🛠️ Stack Tecnológico

  • Servidor Web: Apache 2.4 (ejecutado bajo contenedor PHP)
  • Backend: PHP 7.4 (extensión mysqli)
  • Base de Datos: MariaDB 10.5 / MySQL 5.7 (compatible con arquitecturas Apple Silicon ARM64 y AMD64)
  • Frontend: Bootstrap 5, jQuery 3.3, DataTables (tablas dinámicas de datos) y SweetAlert2 (cuadros de diálogo interactivos)
  • Despliegue: Docker & Docker Compose

🚀 Guía de Inicio Rápido (Recomendada con Docker)

La forma más rápida de ejecutar el proyecto localmente sin preocuparse por instalar dependencias locales es utilizando Docker Compose.

Requisitos Previos

  • Tener instalado Docker y que el servicio de Docker esté activo.

Instrucciones de Despliegue

  1. Clonar el Repositorio:

    git clone https://github.com/tu-usuario/asignaciones-equipos.git
    cd asignaciones-equipos
  2. Crear archivo de entorno PHP: Crea un archivo llamado env.php dentro del directorio src/ con el siguiente contenido:

    <?php
    $HOST = "db";
    $USER = "root";
    $PASSWORD = "root";
    $BD = "asignaciones";
    ?>
  3. Iniciar los Contenedores: Ejecuta el siguiente comando en la raíz del proyecto para descargar las imágenes, construir el contenedor web e importar la base de datos de manera automatizada:

    docker compose up -d
  4. Acceder a la Aplicación: Una vez iniciados los servicios, abre tu navegador e ingresa a: 👉 http://localhost:8080


🔑 Credenciales por Defecto (Acceso)

Para ingresar a la plataforma desde la interfaz de inicio de sesión:

  • Correo Electrónico: Cualquier correo válido (ejemplo: admin@ubiobio.cl o user@empresa.com)
  • Contraseña: Cualquier texto o contraseña no vacía.
  • Sede: Selecciona Concepción o Chillán en el menú desplegable.

📂 Estructura del Proyecto

├── Dockerfile                  # Configuración de la imagen de servidor PHP+Apache
├── docker-compose.yml          # Orquestación de contenedores (Web + Base de datos)
├── Script_Asignaciones.sql     # Esquema DDL y datos semilla de la base de datos
├── LICENSE                     # Licencia del proyecto (MIT)
├── README.md                   # Documentación del proyecto
└── src/                        # Código fuente
    ├── config/                 # Conexión a la BD (database.php)
    ├── css/                    # Hojas de estilo (incluye dark-theme.css)
    ├── controller/             # Controladores en JavaScript (AJAX + vistas)
    ├── routes/                 # Endpoints y consultas MySQL en PHP
    ├── views/                  # Vistas HTML/PHP divididas en módulos
    └── assets/                 # Recursos multimedia, logos e imágenes

📄 Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para obtener más información.

About

Sistema web moderno desarrollado con PHP, MariaDB y Docker para el control de inventario, asignación dinámica y mantenimiento de equipos computacionales y activos de hardware.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages