Manual

src/
  ├── sql/                       # Scripts SQL
  │   ├── bbdd.sql               # Estructura de la base de datos
  │   └── datos.sql              # Datos de prueba iniciales
  ├── tests/                     # Pruebas automatizadas (PHPUnit)
  │   ├── unit/                  # Pruebas unitarias
  │   ├── functional/            # Pruebas funcionales
  │   ├── integration/           # Pruebas de integración
  │   └── user/                  # Casos de prueba UAT
  └── www/                       # Aplicación web
      ├── .htaccess              # Configuración Apache
      ├── config.php             # Configuración global
      ├── index.php              # Front Controller (router)
      ├── controladores/         # Controladores MVC (9 archivos)
      ├── modelos/               # Modelos de datos (8 archivos)
      ├── vistas/                # Vistas PHP
      ├── css/                   # Hojas de estilo
      └── js/                    # Scripts JavaScript (11 archivos)

$ruta = $_GET['ruta'] ?? 'login';
$accion = $_POST['accion'] ?? ($_GET['accion'] ?? null);

// Verificar cambio de contraseña obligatorio
if (ControladorAutenticacion::autenticado() && 
    ($_SESSION['password_temporal'] ?? false) && 
    $ruta !== 'cambiar_password' && $ruta !== 'logout') {
    header('Location: index.php?ruta=cambiar_password');
    exit;
}

switch ($ruta) {
    case 'login':        // Autenticación
    case 'logout':       // Cierre de sesión
    case 'cambiar_password':  // Cambio de contraseña
    case 'dashboard':    // Panel principal (según rol)
    case 'perfil':       // Perfil de usuario
    case 'partidos':     // CRUD partidos (admin)
    case 'mis_partidos': // Partidos del árbitro
    case 'usuarios':     // CRUD usuarios (admin)
    case 'arbitros':     // Gestión árbitros (admin)
    case 'lista_arbitros': // Listado compañeros (árbitro)
    case 'licencias':    // CRUD licencias (admin)
    case 'liquidaciones': // Gestión liquidaciones (admin)
    case 'mis_liquidaciones': // Liquidaciones (árbitro)
    case 'disponibilidad_arbitros': // Consulta disponibilidad (admin)
    case 'disponibilidad': // Registrar disponibilidad (árbitro)
    case 'api':          // Endpoints AJAX
    case 'unauthorized': // Acceso denegado
    default:             // 404
}

class ModeloBase {
    protected PDO $conexion;

    public function __construct() {
        $this->conexion = $this->crearConexion();
    }

    protected function crearConexion(): PDO {
        $dsn = 'mysql:host=' . BD_HOST . ';dbname=' . BD_NOMBRE . ';charset=utf8mb4';
        return new PDO($dsn, BD_USUARIO, BD_PASSWORD, [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES => false,
        ]);
    }
}

class ControladorPartido {
    private ModeloPartido $modeloPartido;

    public function __construct() {
        $this->modeloPartido = new ModeloPartido();
        if (!ControladorAutenticacion::autenticado()) {
            header('Location: index.php');
            exit;
        }
    }

    public function crear(): void {
        $datos = $this->sanearDatos($_POST);
        if ($this->validarDatos($datos)) {
            $this->modeloPartido->crear($datos);
            $_SESSION['flash'] = ['mensaje' => 'Partido creado correctamente.', 'exito' => true];
        } else {
            $_SESSION['flash'] = ['mensaje' => 'Datos inválidos.', 'exito' => false];
        }
        header('Location: index.php?ruta=partidos');
        exit;
    }

    private function sanearDatos(array $d): array {
        $limpios = [];
        foreach ($d as $k => $v) {
            $limpios[$k] = is_string($v) ? trim(htmlspecialchars($v, ENT_QUOTES, 'UTF-8')) : $v;
        }
        // Unificar fecha + hora
        if (isset($d['fecha_dia'], $d['fecha_hora'])) {
            $limpios['fecha'] = $d['fecha_dia'] . ' ' . $d['fecha_hora'] . ':00';
        }
        return $limpios;
    }

    private function validarDatos(array $datos): bool {
        $requeridos = ['equipo_local', 'equipo_visitante', 'categoria_id', 'fecha', 'pabellon_nombre'];
        foreach ($requeridos as $campo) {
            if (empty($datos[$campo])) return false;
        }
        return strcasecmp($datos['equipo_local'], $datos['equipo_visitante']) !== 0;
    }
}

match ($accion) {
    'crear' => $controlador->crear(),
    'actualizar' => $controlador->actualizar(),
    'eliminar' => $controlador->eliminar(),
    'editar' => $controlador->editar(),
    'form' => $controlador->formularioCrear(),
    'obtener' => $controlador->obtenerPartido(),
    default => $controlador->listado()
};

/**
 * Abre un modal por su ID
 * @param {string} id - ID del modal a abrir
 */
function abrirModal(id) {
    document.getElementById(id).classList.add('activo');
}

/**
 * Cierra un modal por su ID
 * @param {string} id - ID del modal a cerrar
 */
function cerrarModal(id) {
    document.getElementById(id).classList.remove('activo');
}

// Cerrar modales con Escape
document.addEventListener('keydown', function(e) {
    if (e.key === 'Escape') {
        document.querySelectorAll('.modal.activo').forEach(function(modal) {
            modal.classList.remove('activo');
        });
    }
});

public function iniciarSesion(): void {
    $usuario = trim($_POST['usuario'] ?? '');
    $password = $_POST['password'] ?? '';
    
    $registro = $this->modeloUsuario->obtenerPorUsuario($usuario);
    if ($registro && password_verify($password, $registro['password'])) {
        $_SESSION['usuario_id'] = $registro['id'];
        $_SESSION['usuario_nombre'] = $registro['usuario'];
        $_SESSION['tipo_usuario'] = $registro['tipo_usuario'];
        $_SESSION['password_temporal'] = (bool)($registro['password_temporal'] ?? false);
        
        if ($_SESSION['password_temporal']) {
            header('Location: index.php?ruta=cambiar_password');
        } else {
            header('Location: index.php?ruta=dashboard');
        }
        exit;
    }
    $this->redirigirConMensaje('Usuario o contraseña incorrectos.', false);
}

// En index.php, antes de cada ruta sensible
if (($_SESSION['tipo_usuario'] ?? '') !== 'administrador') {
    header('Location: index.php');
    exit;
}

case 'api':
    header('Content-Type: application/json; charset=utf-8');
    $recurso = $_GET['recurso'] ?? '';
    
    switch ($recurso) {
        case 'disponibilidad_fecha':
            // Obtener árbitros disponibles por fecha
            $modelo = new ModeloDisponibilidad();
            $disponibles = $modelo->obtenerDisponiblesPorFecha($fecha);
            echo json_encode(['success' => true, 'data' => $disponibles]);
            break;
            
        case 'estadisticas_arbitro':
            // Estadísticas de un árbitro
            $modelo = new ModeloArbitro();
            $stats = $modelo->obtenerEstadisticas($arbitroId);
            echo json_encode(['success' => true, 'data' => $stats]);
            break;
    }
    exit;

-- Añadir en src/sql/bbdd.sql
CREATE TABLE nueva_entidad (
    id INT AUTO_INCREMENT PRIMARY KEY,
    nombre VARCHAR(100) NOT NULL,
    activo TINYINT(1) DEFAULT 1,
    fecha_creacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

// src/www/modelos/modelo_nueva_entidad.php
<?php
require_once __DIR__ . '/modelo_base.php';

/**
 * ModeloNuevaEntidad: operaciones CRUD.
 * @package Modelos
 */
class ModeloNuevaEntidad extends ModeloBase {
    public function listarTodos(): array {
        return $this->conexion->query('SELECT * FROM nueva_entidad WHERE activo = 1')->fetchAll();
    }

    public function crear(array $datos): int {
        $stmt = $this->conexion->prepare('INSERT INTO nueva_entidad (nombre) VALUES (:nombre)');
        $stmt->execute([':nombre' => $datos['nombre']]);
        return (int)$this->conexion->lastInsertId();
    }
}

// src/www/controladores/controlador_nueva_entidad.php
<?php
require_once __DIR__ . '/../modelos/modelo_nueva_entidad.php';

/**
 * ControladorNuevaEntidad: orquestación CRUD.
 * @package Controladores
 */
class ControladorNuevaEntidad {
    private ModeloNuevaEntidad $modelo;

    public function __construct() {
        $this->modelo = new ModeloNuevaEntidad();
    }

    public function listado(): void {
        $items = $this->modelo->listarTodos();
        $flash = $_SESSION['flash'] ?? null;
        unset($_SESSION['flash']);
        require __DIR__ . '/../vistas/nueva_entidad_listado.php';
    }

    public function crear(): void {
        // Validar, insertar, flash, redirect
    }
}

<!-- src/www/vistas/nueva_entidad_listado.php -->
<?php require __DIR__ . '/parciales/header.php'; ?>
<main>
    <h1>Nueva Entidad</h1>
    <!-- Contenido -->
</main>
<?php require __DIR__ . '/parciales/footer.php'; ?>

// Añadir en index.php
case 'nueva_entidad':
    if (($_SESSION['tipo_usuario'] ?? '') !== 'administrador') {
        header('Location: index.php'); exit;
    }
    $ctrl = new ControladorNuevaEntidad();
    match ($accion) {
        'crear' => $ctrl->crear(),
        default => $ctrl->listado()
    };
    break;

src/tests/
├── bootstrap.php        # Configuración de PHPUnit
├── phpunit.xml          # Configuración XML
├── unit/                # Pruebas unitarias
│   ├── TestCase.php     # Clase base
│   └── modelos/         # Pruebas de modelos
├── functional/          # Pruebas funcionales
│   └── controladores/   # Pruebas de controladores
├── integration/         # Pruebas de integración
│   └── FlujoCompletoTest.php
└── user/                # Casos de prueba UAT
    ├── CHECKLIST_PRUEBAS.md
    └── PRUEBAS_USUARIO_UAT.md

cd src/tests
composer install
composer test           # Todas las pruebas
composer test:unit      # Solo unitarias
composer test:coverage  # Con cobertura

// config.php
define('APP_DEPURACION', false);  // TRUE en desarrollo

set_error_handler(function ($errno, $errstr, $errfile, $errline) {
    if (!APP_DEPURACION) {
        error_log("[ERROR] $errstr en $errfile:$errline");
        return true;
    }
    return false;
});

set_exception_handler(function ($ex) {
    error_log('[EXCEPCIÓN] ' . $ex->getMessage());
    if (APP_DEPURACION) {
        echo '<pre>' . htmlspecialchars($ex->getMessage()) . '</pre>';
    } else {
        echo MSJ_ERROR_GENERAL;
    }
});

error_log('[INFO] Usuario ' . $id . ' ha iniciado sesión');
error_log('[WARNING] Intento de acceso no autorizado');
error_log('[ERROR] Fallo en consulta: ' . $e->getMessage());

URL: http://localhost/Sprint-3/src/www/
Ruta física: C:\xampp\htdocs\Sprint-3\src\www\

// config.php
define('APP_DEPURACION', false);
define('BD_HOST', '127.0.0.1');
define('BD_NOMBRE', 'intra_vb');
define('BD_USUARIO', 'root');
define('BD_PASSWORD', '');