Manual

​

Requisitos del sistema

• Sistema operativo: Windows 10/11
• Servidor web y PHP: XAMPP 8.x (PHP 8.0 o superior). Recomendado PHP 8.2+
• Base de datos: MySQL 8.x (incluido en XAMPP)
• Extensiones PHP activas:
  • pdo_mysql
  • mbstring
• Navegador web moderno (Edge, Chrome, Firefox)

​

Estructura del proyecto (extracto)

src/
   sql/
      bbdd.sql          # Estructura BBDD
      datos.sql         # Datos iniciales (usuarios, categorías, árbitros)
   tests/              # Tests unitarios, integración y funcionales
   www/
      config.php        # Configuración de app y BD
      index.php         # Punto de entrada / enrutador simple MVC
      controladores/    # Controladores (autenticación, partidos, etc.)
      modelos/          # Modelos (PDO + consultas)
      vistas/           # Vistas (HTML/PHP sin lógica de negocio)
      css/              # Estilos globales
      js/               # Scripts globales
docs/                 # Documentación del proyecto

​

Paso 1 — Instalar/arrancar XAMPP

1. Instala XAMPP 8.x desde el sitio oficial.
2. Abre el Panel de Control de XAMPP y pulsa:
   • Start en Apache
   • Start en MySQL
3. Verifica que no haya conflictos de puertos (Apache en 80/443, MySQL en 3306).

​

Paso 2 — Copiar el código fuente

1. Copia la carpeta del proyecto en:
   • C:\\xampp\\htdocs\\
2. Comprueba que existan los archivos indicados en la estructura.

​

Paso 3 — Crear y poblar la base de datos

1. Abre phpMyAdmin: http://localhost/phpmyadmin/.
2. Crea la base de datos (si no existe): intra_vb con cotejamiento utf8mb4_unicode_ci.
3. Importa, en este orden, los ficheros SQL desde src/sql/:
   • bbdd.sql (estructura)
   • datos.sql (datos mínimos, usuarios y catálogos)

​

Paso 4 — Configurar la aplicación

• BD_HOST (por defecto 127.0.0.1)
• BD_NOMBRE (por defecto intra_vb)
• BD_USUARIO (por defecto root en XAMPP)
• BD_PASSWORD (por defecto vacío en XAMPP)
• APP_DEPURACION: true en desarrollo, false en producción

​

Paso 5 — Acceder a la aplicación

1. En tu navegador, abre: http://localhost/src/www/
2. Verás la pantalla de inicio de sesión.
3. Usuarios de ejemplo (tras importar datos.sql):
   • Administrador: usuario admin, contraseña 123contra
   • Árbitros: arbitro1, arbitro2, arbitro3 (contraseña 123contra)

​

Paso 6 — Verificación rápida

• Iniciar sesión como administrador → Acceso a Dashboard
• Navegar a Partidos → Listado con datos de prueba
• Crear/Editar/Eliminar partido → Confirmación por mensajes “flash”

​

Seguridad y producción

• Cambia las contraseñas de los usuarios de ejemplo.
• Restringe el acceso a phpMyAdmin desde redes no confiables.
• Realiza backups periódicos de la base de datos intra_vb.

​

Problemas comunes y soluciones

• Apache no arranca: libera el puerto 80/443 o reconfigura Apache.
• MySQL no arranca: verifica el puerto 3306 o archivos de datos corruptos.
• Error de conexión a BD: revisa BD_USUARIO, BD_PASSWORD, BD_NOMBRE en config.php.
• Página en blanco o errores: activa APP_DEPURACION = true en desarrollo y revisa el error_log de PHP.
• Falta pdo_mysql: habilita la extensión en php.ini de XAMPP.

​

Desinstalación

1. Borra la carpeta C:\\xampp\\htdocs\\src.
2. Elimina la base de datos intra_vb desde phpMyAdmin.