diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4e080a0..d60ed6a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,10 @@
 # Changelog
+## [0.26.0] - 2025-10-09
+### Added
+- Se han añadido nueva documentacion en swagger para facilitar la integracion de ogCore
+- Se ha añadido y completado el README y la documentacion funcional
+
+---
 ## [0.25.1] - 2025-10-01
 ### Fixed
 - Se han corregido varios errores con respecto a las tareas programadas.
diff --git a/README.md b/README.md
index 31e23ec..1a52c11 100644
--- a/README.md
+++ b/README.md
@@ -1,144 +1,1828 @@
-# ogCore project
+# ogCore - Documentación Técnica y Funcional
 
-## Descripción
+## Tabla de Contenidos
 
-ogCore es el servicio central de OpenGnsys, diseñado para proporcionar funcionalidades a través de una API RESTful. Esta herramienta utiliza tecnología PHP, aprovechando el framework Symfony y el ORM Doctrine para gestionar la base de datos.
-A continuación, se detallan los pasos necesarios para desplegar el proyecto en un entorno de desarrollo.
+1. [Introducción](#1-introducción)
+2. [Descripción del Proyecto](#2-descripción-del-proyecto)
+3. [Arquitectura del Sistema](#3-arquitectura-del-sistema)
+4. [Tecnologías Utilizadas](#4-tecnologías-utilizadas)
+5. [Requisitos del Sistema](#5-requisitos-del-sistema)
+6. [Instalación y Configuración](#6-instalación-y-configuración)
+7. [Modelo de Datos](#7-modelo-de-datos)
+8. [Componentes del Sistema](#8-componentes-del-sistema)
+9. [API RESTful](#9-api-restful)
+10. [Seguridad y Autenticación](#10-seguridad-y-autenticación)
+11. [Servicios Principales](#11-servicios-principales)
+12. [Comandos de Consola](#12-comandos-de-consola)
+13. [Migraciones de Datos](#13-migraciones-de-datos)
+14. [Testing](#14-testing)
+15. [Despliegue](#15-despliegue)
+16. [Mantenimiento y Operaciones](#16-mantenimiento-y-operaciones)
+17. [Integración con Otros Servicios](#17-integración-con-otros-servicios)
+18. [Roadmap y Changelog](#18-roadmap-y-changelog)
+19. [Contribución](#19-contribución)
+20. [Soporte y Contacto](#20-soporte-y-contacto)
 
-## Versiones y tecnologías utilizadas
+---
 
-- PHP 8.3
-- Symfony 6.4
-- Doctrine 2.19
-- API Platform 3.2
-- MariaDB 10.11
+## 1. Introducción
 
-## Requisitos
+**ogCore** es el servicio central de **OpenGnsys**, una plataforma de código abierto diseñada para la gestión centralizada de aulas de informática, laboratorios y entornos educativos. Este servicio proporciona una API RESTful robusta que permite administrar de manera eficiente clientes (equipos), imágenes de sistemas operativos, perfiles de hardware y software, tareas programadas, y mucho más.
 
-Antes de comenzar, asegúrate de tener los siguientes requisitos:
+### 1.1 Propósito del Sistema
 
-- Docker
-- Docker compose
+El propósito principal de ogCore es:
 
-## Instalación
+- **Centralizar la gestión** de equipos informáticos en entornos educativos y corporativos
+- **Automatizar el despliegue** de sistemas operativos e imágenes
+- **Gestionar inventarios** de hardware y software
+- **Programar y ejecutar tareas** de manera automática
+- **Proporcionar trazabilidad** de todas las operaciones realizadas
+- **Facilitar la migración** desde versiones anteriores de OpenGnsys
 
-### Desplegar contenedores
+### 1.2 Alcance
 
-Para que no haya conflictos entre los puertos, asegúrate de que no tienes ningún servicio corriendo en los puertos 8080 y 3306.
+ogCore gestiona:
+- Clientes (equipos físicos)
+- Imágenes de sistemas operativos
+- Repositorios de imágenes
+- Perfiles de hardware y software
+- Unidades organizativas (aulas, grupos)
+- Redes y subredes
+- Plantillas PXE
+- Menús de arranque
+- Comandos y tareas programadas
+- Trazas de ejecución
+- Calendarios remotos
+- Integración con sistemas externos (UDS, ogRepository, ogDhcp, ogBoot)
 
-```sh
+---
+
+## 2. Descripción del Proyecto
+
+### 2.1 ¿Qué es ogCore?
+
+ogCore es el núcleo central de OpenGnsys desarrollado con tecnologías modernas de PHP. Actúa como backend que expone una API RESTful completa, permitiendo la gestión de todos los aspectos relacionados con la administración de aulas informáticas.
+
+### 2.2 Características Principales
+
+- **API RESTful completa** con documentación Swagger/OpenAPI
+- **Autenticación JWT** con refresh tokens
+- **Arquitectura basada en eventos** con notificaciones en tiempo real (Mercure)
+- **Sistema de colas** para la ejecución de tareas programadas
+- **Integración con múltiples servicios** externos
+- **Migraciones automatizadas** desde OpenGnsys 1.1
+- **Versionado de imágenes** con integración Git
+- **Sistema de trazabilidad** completo
+- **Gestión de hardware** con inventario automático
+- **Despliegues masivos** de imágenes (unicast, multicast, torrent, p2p)
+- **Gestión de particiones** automática
+- **Sistema de validación** robusto
+
+### 2.3 Versión Actual
+
+- **Versión**: 0.5.0
+- **Estado**: En desarrollo activo
+- **Última actualización**: Octubre 2025
+
+---
+
+## 3. Arquitectura del Sistema
+
+### 3.1 Arquitectura General
+
+ogCore sigue una arquitectura de **microservicios** basada en el patrón **API-First**:
+
+```
++-------------------------------------------------------------+
+|                      Frontend (Web UI)                      |
++---------------------------+----------------------------------+
+                            |
+                            | HTTP/REST
+                            |
++---------------------------v---------------------------------+
+|                     ogCore API (Symfony)                    |
+|  +------------------------------------------------------+   |
+|  |  Controllers | States | DTOs | Validators | Filters |   |
+|  +------------------------------------------------------+   |
+|  +------------------------------------------------------+   |
+|  |              Business Logic (Services)               |   |
+|  +------------------------------------------------------+   |
+|  +------------------------------------------------------+   |
+|  |        Entities | Repositories | Doctrine ORM        |   |
+|  +------------------------------------------------------+   |
++---------------------------+----------------+----------------+
+                            |                |
+         +------------------v--+    +--------v--------+
+         |   MariaDB           |    |   Mercure       |
+         |   Database          |    |  (WebSocket)    |
+         +---------------------+    +-----------------+
+
++-------------------------------------------------------------+
+|              Servicios Externos Integrados                  |
++--------------+--------------+--------------+----------------+
+| ogRepository |   ogDhcp     |   ogBoot     |   UDS/Git      |
++--------------+--------------+--------------+----------------+
+```
+
+### 3.2 Capas de la Aplicación
+
+#### 3.2.1 Capa de Presentación (API)
+- **API Platform**: Framework para crear APIs REST
+- **Controllers**: Controladores personalizados (102 controladores)
+- **DTOs (Data Transfer Objects)**: 93 objetos de transferencia de datos
+- **OpenAPI/Swagger**: Documentación automática de la API
+
+#### 3.2.2 Capa de Negocio
+- **Services**: Lógica de negocio (13 servicios principales)
+- **Handlers**: Manejadores de eventos (2 handlers)
+- **EventSubscribers**: Suscriptores de eventos (8 suscriptores)
+- **Validators**: Validadores personalizados (18 validadores)
+
+#### 3.2.3 Capa de Datos
+- **Entities**: 35 entidades del modelo de datos
+- **Repositories**: 32 repositorios personalizados
+- **Doctrine ORM**: Mapeo objeto-relacional
+- **Migrations**: 85 migraciones de base de datos
+
+#### 3.2.4 Capa de Infraestructura
+- **Docker**: Contenedorización de servicios
+- **Nginx**: Servidor web reverse proxy
+- **PHP-FPM**: Procesador de PHP
+- **MariaDB**: Sistema de gestión de base de datos
+- **Mercure**: Sistema de notificaciones en tiempo real
+
+### 3.3 Patrones de Diseño Utilizados
+
+1. **Repository Pattern**: Para abstracción de acceso a datos
+2. **DTO Pattern**: Para transferencia de datos entre capas
+3. **Factory Pattern**: Para creación de entidades complejas
+4. **Event-Driven Architecture**: Para notificaciones y reactividad
+5. **State Pattern**: Para gestión de estados de procesamiento
+6. **Service Layer**: Para encapsulación de lógica de negocio
+
+---
+
+## 4. Tecnologías Utilizadas
+
+### 4.1 Backend
+
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| **PHP** | 8.3 | Lenguaje de programación principal |
+| **Symfony** | 6.4 | Framework web principal |
+| **Doctrine ORM** | 2.19 | Mapeo objeto-relacional |
+| **API Platform** | 3.2 | Creación de APIs REST |
+| **Lexik JWT** | 3.0 | Autenticación JWT |
+| **Gesdinet JWT Refresh Token** | 1.3 | Refresh tokens |
+| **Stof Doctrine Extensions** | 1.10 | Extensiones de Doctrine (timestampable, etc.) |
+| **Ramsey UUID** | 2.0 | Generación de UUIDs |
+
+### 4.2 Base de Datos
+
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| **MariaDB** | 10.11 | Sistema de gestión de base de datos |
+| **Doctrine DBAL** | 3.x | Capa de abstracción de base de datos |
+| **Doctrine Migrations** | 3.3 | Gestión de migraciones |
+
+### 4.3 Infraestructura
+
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| **Docker** | Latest | Contenedorización |
+| **Docker Compose** | Latest | Orquestación de contenedores |
+| **Nginx** | Latest | Servidor web / Reverse proxy |
+| **PHP-FPM** | 8.3 | Procesador FastCGI |
+| **Mercure** | 0.3.9 | Hub de notificaciones en tiempo real |
+
+### 4.4 Testing
+
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| **PHPUnit** | 9.5 | Framework de testing |
+| **Symfony PHPUnit Bridge** | 7.0 | Integración con Symfony |
+| **DAMA Doctrine Test Bundle** | 8.1 | Transacciones de prueba |
+| **Zenstruck Foundry** | 1.37 | Factories para testing |
+
+### 4.5 Desarrollo
+
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| **Symfony Maker Bundle** | 1.59 | Generación de código |
+| **Symfony Web Profiler** | 6.4 | Debugging y profiling |
+| **Monolog** | 3.x | Logging |
+| **PHPStan** | Latest | Análisis estático |
+
+---
+
+## 5. Requisitos del Sistema
+
+### 5.1 Requisitos de Hardware (Producción)
+
+- **CPU**: Mínimo 4 cores, recomendado 8+ cores
+- **RAM**: Mínimo 8GB, recomendado 16GB+
+- **Disco**: 
+  - Sistema: 20GB SSD
+  - Base de datos: 50GB+ SSD
+  - Logs: 10GB
+- **Red**: 1Gbps mínimo
+
+### 5.2 Requisitos de Software
+
+- **Sistema Operativo**: Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)
+- **Docker**: >= 20.10
+- **Docker Compose**: >= 2.0
+- **Git**: >= 2.25 (para gestión de código)
+
+### 5.3 Puertos Requeridos
+
+| Puerto | Servicio | Propósito |
+|--------|----------|-----------|
+| 8080 | Nginx/HTTP | API y documentación |
+| 3306 | MariaDB | Base de datos |
+| 9000 | PHP-FPM | Procesador PHP |
+| 3000 | Mercure | WebSocket/SSE |
+
+---
+
+## 6. Instalación y Configuración
+
+### 6.1 Instalación con Docker (Recomendado)
+
+#### 6.1.1 Clonar el Repositorio
+
+```bash
+git clone <url-del-repositorio> ogcore
+cd ogcore
+```
+
+#### 6.1.2 Verificar Puertos Disponibles
+
+Asegúrate de que los puertos 8080 y 3306 no estén en uso:
+
+```bash
+sudo lsof -i :8080
+sudo lsof -i :3306
+```
+
+#### 6.1.3 Desplegar Contenedores
+
+```bash
 docker compose up --build -d
 ```
 
-Comprobamos que se han levantado correctamente bien los 3 contenedores de la aplicación:
+#### 6.1.4 Verificar Contenedores
 
-```sh
+```bash
 docker ps
 ```
 
-Y deberiamos ver algo parecido a :
+Deberías ver tres contenedores activos:
+- `ogcore-nginx`
+- `ogcore-php`
+- `ogcore-database`
 
-- ogcore-nginx
-- ogcore-php
-- ogcore-database
+#### 6.1.5 Instalar Dependencias
 
-
-### Instalamos dependencias
-
-```sh
+```bash
 docker exec ogcore-php composer install
+```
+
+#### 6.1.6 Generar Claves JWT
+
+```bash
 docker exec ogcore-php php bin/console lexik:jwt:generate-keypair --overwrite
 ```
 
-Comprobamos, que el contenedor de Nginx, tiene el puerto 8080 levantado correctamente, asi que tan solo tendremos que
-acceder a la siguiente URL:
+#### 6.1.7 Inicializar Base de Datos
 
-```sh
-http://127.0.0.1:8080/docs
-```
-Si todo ha ido bien, deberiamos ver la documentación de la API de ogCore.
-
-Para poder actualizar la base de datos:
-
-Para inicializar la base de datos:
-
-```sh
+```bash
+# Ejecutar migraciones
 docker exec ogcore-php php bin/console doctrine:migrations:migrate --no-interaction
-```
 
-```sh
+# Cargar datos iniciales (fixtures)
 docker exec ogcore-php php bin/console doctrine:fixtures:load --no-interaction
-docker exec ogcore-php php bin/console app:load-default-user-groups #cargamos los grupos por defecto
-docker exec ogcore-php php bin/console app:load-default-commands #cargamos los commands por defecto
+
+# Cargar grupos de usuarios por defecto
+docker exec ogcore-php php bin/console app:load-default-user-groups
+
+# Cargar comandos por defecto
+docker exec ogcore-php php bin/console app:load-default-commands
 ```
 
-## UX Api Platform 
+#### 6.1.8 Acceder a la Aplicación
 
-Api Platform proporciona una interfaz de usuario para interactuar con la API de ogCore. Para acceder a la interfaz de usuario, accede a la siguiente URL:
+Abre tu navegador y accede a:
 
-```sh
+```
 http://127.0.0.1:8080/docs
 ```
 
-Para poder autenticarte, necesitas un token JWT. Para obtenerlo, accedemos al endpoint de autenticación "auth/login": 
+Deberías ver la documentación Swagger de la API de ogCore.
 
-![img.png](swagger-assets/img.png)
-![img.png](swagger-assets/img2.png)
-Obtenemos el token y lo introducimos en la interfaz de usuario de Api Platform de la siguiente manera:
+### 6.2 Configuración
 
-![img.png](swagger-assets/img3.png)
+#### 6.2.1 Variables de Entorno
 
-Ahora, ya podemos interactuar con la API de ogCore. Para comprobar que todo está correcto, podemos fijarnos en los headers de las llamadas Curl, y ver que el token JWT se ha introducido correctamente.
+El archivo `.env` contiene las variables de configuración principales:
 
-## Test
+```bash
+# Entorno
+APP_ENV=dev
+APP_SECRET=<tu-secreto>
 
-Para ejecutar los test, ejecutamos el siguiente comando:
+# Base de datos
+DATABASE_URL="mysql://user:password@ogcore-database:3306/ogcore"
 
-```sh
-docker compose exec php bin/phpunit    
+# JWT
+JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
+JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
+JWT_PASSPHRASE=<tu-passphrase>
+
+# Mercure
+MERCURE_URL=http://mercure:3000/.well-known/mercure
+MERCURE_PUBLIC_URL=http://127.0.0.1:8080/.well-known/mercure
+MERCURE_JWT_SECRET=<tu-secreto-mercure>
+
+# Servicios externos
+REMOTE_PC_URL=<url-uds>
+REMOTE_PC_AUTH_LOGIN=<login>
+REMOTE_PC_AUTH_USERNAME=<username>
+REMOTE_PC_AUTH_PASSWORD=<password>
+
+# SSL/TLS
+SSL_ENABLED=false
 ```
 
-## Reiniciar base de datos
+#### 6.2.2 Configuración de CORS
 
-Es posible que en momentos de desarrollo, sea necesario volver a cargar la base de datos y actualizar los esquemas de la misma, para ello, ejecutamos el siguiente comando:
+Edita `config/packages/nelmio_cors.yaml` para configurar CORS según tus necesidades.
 
-```sh
-docker exec ogcore-php php bin/console doctrine:database:drop --force
-docker exec ogcore-php php bin/console doctrine:database:create
+#### 6.2.3 Configuración de API Platform
+
+La configuración de API Platform se encuentra en `config/packages/api_platform.yaml`.
+
+### 6.3 Instalación en Producción
+
+Para entornos de producción, utiliza el archivo `docker-compose-deploy.yml`:
+
+```bash
+docker compose -f docker-compose-deploy.yml up -d
 ```
 
-## Migraciones de datos
+Asegúrate de:
+- Cambiar todas las contraseñas por defecto
+- Configurar SSL/TLS
+- Configurar backups automáticos de base de datos
+- Configurar monitoreo y alertas
+- Revisar los límites de recursos de Docker
 
-Para poder migrar los datos desde la base de datos "antigua", previamente necesitamos poder tener un esquema de base de datos con un dump de OpenGnsys. Es decir:
+---
 
-    - Creamos una base de datos temporal simulando una insancia de OpenGnsys 1.1. La solicitaremos al equipo de desarrollo de las universidades
-    - Necesitaremos un dump de la base de datos de OpenGnsys 1.1.
+## 7. Modelo de Datos
 
-Mediante doctrine, creamos la base de datos temporal:
+### 7.1 Diagrama de Entidades
 
-```sh
+El sistema cuenta con 35 entidades principales agrupadas en los siguientes dominios:
+
+### 7.2 Entidades Principales
+
+#### 7.2.1 Client (Cliente)
+
+Representa un equipo físico en el sistema.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre del cliente
+- `serialNumber`: Número de serie
+- `mac`: Dirección MAC (única)
+- `ip`: Dirección IP (única)
+- `status`: Estado del cliente (active, inactive, busy, windows, linux, etc.)
+- `netiface`: Interfaz de red
+- `netDriver`: Driver de red
+- `validation`: Estado de validación
+- `maintenance`: Modo mantenimiento
+- `position`: Posición en el aula (x, y)
+- `firmwareType`: Tipo de firmware (BIOS/UEFI)
+- `agentJobId`: ID del trabajo del agente en ejecución
+- `pxeSync`: Sincronización PXE
+- `token`: Token de autenticación del cliente
+
+**Relaciones:**
+- `organizationalUnit`: Pertenece a una unidad organizativa (aula/grupo)
+- `partitions`: Tiene múltiples particiones
+- `menu`: Menú de arranque asignado
+- `hardwareProfile`: Perfil de hardware asociado
+- `template`: Plantilla PXE asignada
+- `repository`: Repositorio de imágenes
+- `subnet`: Subred a la que pertenece
+- `ogLive`: Imagen Live asignada
+
+#### 7.2.2 OrganizationalUnit (Unidad Organizativa)
+
+Representa aulas o grupos de equipos.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre de la unidad
+- `description`: Descripción
+- `type`: Tipo (aula, grupo, etc.)
+
+**Relaciones:**
+- `parent`: Unidad organizativa padre (jerarquía)
+- `children`: Unidades hijas
+- `clients`: Clientes pertenecientes
+- `networkSettings`: Configuración de red heredable
+- `remoteCalendar`: Calendario remoto asociado
+
+#### 7.2.3 Image (Imagen)
+
+Representa una imagen de sistema operativo.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre de la imagen
+- `description`: Descripción
+- `type`: Tipo de imagen
+- `size`: Tamaño en bytes
+- `partition`: Partición de origen
+- `status`: Estado (creating, success, failed, etc.)
+- `isGlobal`: Imagen global compartida
+- `isVirtual`: Imagen virtual
+- `version`: Versión de la imagen
+
+**Relaciones:**
+- `operativeSystem`: Sistema operativo
+- `softwareProfile`: Perfil de software
+- `repositories`: Repositorios que contienen la imagen
+- `originClient`: Cliente origen de la imagen
+
+#### 7.2.4 Command (Comando)
+
+Comandos ejecutables en el sistema.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre del comando
+- `description`: Descripción
+- `script`: Script a ejecutar
+
+**Relaciones:**
+- `commandGroups`: Grupos de comandos a los que pertenece
+
+#### 7.2.5 CommandTask (Tarea de Comando)
+
+Tarea programada para ejecutar comandos.
+
+**Campos principales:**
+- `id`: UUID único
+- `datetime`: Fecha y hora de ejecución
+- `parameters`: Parámetros de ejecución
+- `status`: Estado de la tarea
+
+**Relaciones:**
+- `commands`: Comandos a ejecutar
+- `commandGroups`: Grupos de comandos
+- `clients`: Clientes objetivo
+- `schedule`: Programación recurrente
+
+#### 7.2.6 Trace (Traza)
+
+Registro de ejecución de comandos.
+
+**Campos principales:**
+- `id`: UUID único
+- `command`: Nombre del comando ejecutado
+- `input`: Parámetros de entrada
+- `output`: Resultado de ejecución
+- `status`: Estado (pending, processing, success, failed, cancelled)
+- `executedAt`: Fecha de ejecución
+- `finishedAt`: Fecha de finalización
+- `cancelled`: Indica si fue cancelada
+- `jobId`: ID del trabajo en el agente
+
+**Relaciones:**
+- `client`: Cliente donde se ejecutó
+
+#### 7.2.7 HardwareProfile (Perfil de Hardware)
+
+Inventario de hardware de un cliente.
+
+**Campos principales:**
+- `id`: UUID único
+- `cpu`: Información de CPU
+- `ram`: Memoria RAM
+- `storage`: Almacenamiento
+- `networkCards`: Tarjetas de red
+
+**Relaciones:**
+- `client`: Cliente asociado
+- `hardwareTypes`: Tipos de hardware detectados
+
+#### 7.2.8 SoftwareProfile (Perfil de Software)
+
+Software instalado en una imagen.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre del perfil
+
+**Relaciones:**
+- `software`: Software incluido
+- `images`: Imágenes que usan este perfil
+
+#### 7.2.9 ImageRepository (Repositorio de Imágenes)
+
+Servidor de almacenamiento de imágenes.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre del repositorio (único)
+- `ip`: Dirección IP o DNS (único)
+- `port`: Puerto
+- `sshPort`: Puerto SSH
+- `sshUser`: Usuario SSH
+- `apiKey`: Clave API
+- `status`: Estado del repositorio
+
+**Relaciones:**
+- `images`: Imágenes almacenadas
+
+#### 7.2.10 Subnet (Subred)
+
+Configuración de red.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre de la subred
+- `cidr`: Notación CIDR
+- `gateway`: Puerta de enlace
+- `dns`: Servidores DNS
+- `dhcpStart`: Inicio rango DHCP
+- `dhcpEnd`: Fin rango DHCP
+
+**Relaciones:**
+- `clients`: Clientes en la subred
+
+#### 7.2.11 Partition (Partición)
+
+Partición de disco de un cliente.
+
+**Campos principales:**
+- `id`: UUID único
+- `partitionNumber`: Número de partición
+- `partitionType`: Tipo de partición
+- `partitionSize`: Tamaño
+- `partitionCode`: Código de partición
+- `usedSize`: Tamaño usado
+- `filesystem`: Sistema de archivos
+
+**Relaciones:**
+- `client`: Cliente propietario
+- `image`: Imagen desplegada
+- `operativeSystem`: Sistema operativo instalado
+
+#### 7.2.12 PxeTemplate (Plantilla PXE)
+
+Plantilla de arranque PXE.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre de la plantilla
+- `content`: Contenido de la plantilla
+- `default`: Plantilla por defecto
+
+**Relaciones:**
+- `clients`: Clientes que usan la plantilla
+
+#### 7.2.13 RemoteCalendar (Calendario Remoto)
+
+Integración con sistemas de reservas remotas.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre del calendario
+- `url`: URL del servicio
+- `available`: Disponibilidad
+
+**Relaciones:**
+- `organizationalUnits`: Unidades organizativas asociadas
+- `rules`: Reglas del calendario
+
+#### 7.2.14 User (Usuario)
+
+Usuario del sistema.
+
+**Campos principales:**
+- `id`: UUID único
+- `username`: Nombre de usuario (único)
+- `password`: Contraseña (hasheada)
+- `email`: Correo electrónico
+- `roles`: Roles del usuario
+
+**Relaciones:**
+- `userGroups`: Grupos de usuarios
+- `view`: Vista preferida
+
+#### 7.2.15 GitRepository (Repositorio Git)
+
+Repositorio Git para versionado de imágenes.
+
+**Campos principales:**
+- `id`: UUID único
+- `name`: Nombre del repositorio
+- `url`: URL del repositorio
+- `branch`: Rama
+- `credentials`: Credenciales de acceso
+
+### 7.3 Índices y Optimizaciones
+
+La base de datos está optimizada con índices en:
+- Campos de búsqueda frecuente (status, updatedAt)
+- Campos únicos (IP, MAC, username)
+- Claves foráneas
+- Índices compuestos para consultas complejas
+
+---
+
+## 8. Componentes del Sistema
+
+### 8.1 Controllers (Controladores)
+
+El sistema cuenta con **102 controladores** organizados por dominio:
+
+#### Controladores principales:
+- **ClientController**: Gestión de clientes
+- **ImageController**: Gestión de imágenes
+- **OrganizationalUnitController**: Gestión de unidades organizativas
+- **CommandController**: Gestión de comandos
+- **TraceController**: Gestión de trazas
+- **UserController**: Gestión de usuarios
+- **SubnetController**: Gestión de subredes
+- **RepositoryController**: Gestión de repositorios
+
+### 8.2 States (Procesadores de Estado)
+
+Los States implementan el patrón State de API Platform:
+
+#### States principales (55 procesadores):
+- **Providers**: Obtención de datos
+- **Processors**: Procesamiento de escritura
+- **Custom States**: Lógica personalizada
+
+### 8.3 DTOs (Data Transfer Objects)
+
+**93 DTOs** para transferencia de datos:
+
+#### Tipos de DTOs:
+- **Input DTOs**: Para recepción de datos
+- **Output DTOs**: Para envío de datos
+- **Transformation DTOs**: Para transformaciones
+
+### 8.4 Validators (Validadores)
+
+**18 validadores personalizados** para:
+- Validación de IPs y MACs
+- Validación de rangos DHCP
+- Validación de particiones
+- Validación de imágenes
+- Validación de comandos
+- Validación de usuarios
+
+### 8.5 EventSubscribers (Suscriptores de Eventos)
+
+**8 suscriptores** para:
+- Publicación en Mercure al cambiar estados
+- Limpieza de recursos
+- Validaciones pre/post persistencia
+- Logging de eventos
+
+### 8.6 Factories (Fábricas)
+
+**24 factories** para testing con Foundry:
+- Creación de entidades para tests
+- Datos de prueba realistas
+- Estados predefinidos
+
+---
+
+## 9. API RESTful
+
+### 9.1 Documentación
+
+La API está completamente documentada con **OpenAPI 3.0** y accesible en:
+
+```
+http://127.0.0.1:8080/docs
+```
+
+### 9.2 Formato de Respuestas
+
+#### Formato estándar (JSON-LD):
+
+```json
+{
+  "@context": "/contexts/Client",
+  "@id": "/clients/123e4567-e89b-12d3-a456-426614174000",
+  "@type": "Client",
+  "id": "123e4567-e89b-12d3-a456-426614174000",
+  "name": "PC-01",
+  "mac": "00:11:22:33:44:55",
+  "ip": "192.168.1.100",
+  "status": "active"
+}
+```
+
+#### Formato alternativo (JSON):
+
+```json
+{
+  "id": "123e4567-e89b-12d3-a456-426614174000",
+  "name": "PC-01",
+  "mac": "00:11:22:33:44:55",
+  "ip": "192.168.1.100",
+  "status": "active"
+}
+```
+
+### 9.3 Paginación
+
+Todas las colecciones soportan paginación:
+
+```
+GET /clients?page=1&itemsPerPage=30
+```
+
+Respuesta:
+
+```json
+{
+  "@context": "/contexts/Client",
+  "@id": "/clients",
+  "@type": "hydra:Collection",
+  "hydra:member": [...],
+  "hydra:totalItems": 150,
+  "hydra:view": {
+    "@id": "/clients?page=1",
+    "@type": "hydra:PartialCollectionView",
+    "hydra:first": "/clients?page=1",
+    "hydra:last": "/clients?page=5",
+    "hydra:next": "/clients?page=2"
+  }
+}
+```
+
+### 9.4 Filtrado
+
+Soporta filtros avanzados:
+
+```
+GET /clients?status=active
+GET /clients?organizationalUnit.name=Aula1
+GET /traces?client.id=123&status=pending
+```
+
+### 9.5 Ordenamiento
+
+```
+GET /clients?order[name]=asc
+GET /traces?order[createdAt]=desc
+```
+
+### 9.6 Endpoints Principales
+
+#### 9.6.1 Autenticación
+
+```
+POST /auth/login
+POST /auth/refresh
+```
+
+#### 9.6.2 Clientes
+
+```
+GET    /clients
+POST   /clients
+GET    /clients/{id}
+PUT    /clients/{id}
+PATCH  /clients/{id}
+DELETE /clients/{id}
+POST   /clients/batch
+POST   /clients/{id}/power-on
+POST   /clients/{id}/power-off
+POST   /clients/{id}/reboot
+```
+
+#### 9.6.3 Imágenes
+
+```
+GET    /images
+POST   /images
+GET    /images/{id}
+PUT    /images/{id}
+DELETE /images/{id}
+POST   /images/{id}/deploy
+POST   /images/{id}/create
+POST   /images/{id}/backup
+```
+
+#### 9.6.4 Comandos y Tareas
+
+```
+GET    /commands
+POST   /commands
+GET    /command-tasks
+POST   /command-tasks
+PUT    /command-tasks/{id}
+DELETE /command-tasks/{id}
+```
+
+#### 9.6.5 Trazas
+
+```
+GET    /traces
+GET    /traces/{id}
+PUT    /traces/{id}
+PATCH  /traces/{id}/complete
+PATCH  /traces/{id}/cancel
+```
+
+### 9.7 Códigos de Estado HTTP
+
+| Código | Significado |
+|--------|-------------|
+| 200 | OK - Operación exitosa |
+| 201 | Created - Recurso creado |
+| 204 | No Content - Eliminación exitosa |
+| 400 | Bad Request - Datos inválidos |
+| 401 | Unauthorized - No autenticado |
+| 403 | Forbidden - Sin permisos |
+| 404 | Not Found - Recurso no encontrado |
+| 409 | Conflict - Conflicto (cliente ocupado, constraint violation) |
+| 422 | Unprocessable Entity - Validación fallida |
+| 500 | Internal Server Error - Error del servidor |
+
+---
+
+## 10. Seguridad y Autenticación
+
+### 10.1 Sistema de Autenticación JWT
+
+ogCore utiliza **JSON Web Tokens (JWT)** para autenticación:
+
+#### 10.1.1 Obtener Token
+
+```bash
+POST /auth/login
+Content-Type: application/json
+
+{
+  "username": "admin",
+  "password": "password"
+}
+```
+
+Respuesta:
+
+```json
+{
+  "token": "eyJ0eXAiOiJKV1QiLCJhbGc...",
+  "refresh_token": "def50200a54b7b..."
+}
+```
+
+#### 10.1.2 Usar Token
+
+Incluir el token en el header `Authorization`:
+
+```bash
+GET /clients
+Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGc...
+```
+
+#### 10.1.3 Refresh Token
+
+```bash
+POST /auth/refresh
+Content-Type: application/json
+
+{
+  "refresh_token": "def50200a54b7b..."
+}
+```
+
+### 10.2 Control de Acceso
+
+#### Rutas Públicas:
+- `/auth/login`
+- `/auth/refresh`
+- `/docs`
+- `/opengnsys/rest/*` (webhooks)
+- `/og-repository/webhook`
+- `/menu-browser`
+
+#### Rutas Protegidas:
+- Todo lo demás requiere `IS_AUTHENTICATED_FULLY`
+
+### 10.3 Roles de Usuario
+
+Los roles se gestionan en la entidad `User`:
+
+```php
+$user->setRoles(['ROLE_USER']);
+$user->setRoles(['ROLE_ADMIN']);
+```
+
+### 10.4 Seguridad de Contraseñas
+
+- Hashing con **bcrypt** automático
+- Validación de fortaleza
+- Cambio de contraseña seguro
+
+### 10.5 CORS (Cross-Origin Resource Sharing)
+
+Configurado en `nelmio_cors.yaml` para permitir acceso desde frontend.
+
+### 10.6 SSL/TLS
+
+Para producción, habilitar SSL:
+
+```bash
+SSL_ENABLED=true
+```
+
+Configurar certificados en `/certs/`.
+
+---
+
+## 11. Servicios Principales
+
+### 11.1 CreatePartitionService
+
+**Propósito**: Crear y actualizar particiones de clientes.
+
+**Funcionalidad**:
+- Recibe información de particiones del agente
+- Crea/actualiza particiones en base de datos
+- Detecta tipo de firmware (BIOS/UEFI)
+- Calcula códigos de partición
+
+### 11.2 CreateTraceService
+
+**Propósito**: Crear trazas de ejecución para tareas programadas.
+
+**Funcionalidad**:
+- Genera trazas para cada combinación cliente-comando
+- Gestiona comandos agrupados
+- Establece estado inicial y fecha de ejecución
+
+### 11.3 ChangeClientNetworkSettingsService
+
+**Propósito**: Cambiar configuración de red de clientes.
+
+**Funcionalidad**:
+- Actualiza subnet, IP, configuración de red
+- Sincroniza con servicios externos (DHCP)
+
+### 11.4 ExternalGitRepositoryService
+
+**Propósito**: Gestión de repositorios Git para imágenes.
+
+**Funcionalidad**:
+- Backup de imágenes a Git
+- Versionado de imágenes
+- Sincronización con repositorios remotos
+
+### 11.5 StatusService (OgBoot/OgDhcp/OgRepository)
+
+**Propósito**: Verificar estado de servicios externos.
+
+**Funcionalidad**:
+- Health checks de servicios
+- Manejo de errores de conexión
+- Logging de estado
+
+### 11.6 UDSClient
+
+**Propósito**: Integración con UDS (Universal Desktop Services).
+
+**Funcionalidad**:
+- Autenticación con UDS
+- Obtención de service pools
+- Cálculo de asientos disponibles
+- Gestión de calendarios remotos
+
+### 11.7 Trace/CreateService
+
+**Propósito**: Servicio especializado para creación de trazas.
+
+**Funcionalidad**:
+- Validación de parámetros de entrada
+- Creación de trazas individuales o masivas
+
+### 11.8 Utils/GetPartitionCodeService
+
+**Propósito**: Obtener código de partición según tipo y filesystem.
+
+### 11.9 Utils/SimplifyOgLiveFilenameService
+
+**Propósito**: Simplificar nombres de archivos OgLive para mostrar al usuario.
+
+### 11.10 Utils/GetIpAddressAndNetmaskFromCIDRService
+
+**Propósito**: Convertir notación CIDR a IP y máscara de red.
+
+---
+
+## 12. Comandos de Consola
+
+ogCore incluye **18 comandos de consola** para tareas administrativas:
+
+### 12.1 Comandos de Inicialización
+
+#### 12.1.1 Cargar Grupos de Usuario por Defecto
+
+```bash
+php bin/console app:load-default-user-groups
+```
+
+Crea los grupos de usuarios predeterminados del sistema.
+
+#### 12.1.2 Cargar Comandos por Defecto
+
+```bash
+php bin/console app:load-default-commands
+```
+
+Carga los comandos básicos del sistema.
+
+#### 12.1.3 Cargar Usuario Admin
+
+```bash
+php bin/console app:load-default-user-admin
+```
+
+Crea el usuario administrador por defecto.
+
+#### 12.1.4 Cargar Menú por Defecto
+
+```bash
+php bin/console app:load-default-menu
+```
+
+Carga menús de arranque predeterminados.
+
+#### 12.1.5 Cargar Tipos de Hardware
+
+```bash
+php bin/console app:load-hardware-types
+```
+
+Inicializa la tabla de tipos de hardware.
+
+#### 12.1.6 Cargar Unidad Organizativa por Defecto
+
+```bash
+php bin/console app:load-organizational-unit-default
+```
+
+Crea la unidad organizativa raíz.
+
+### 12.2 Comandos de Operación
+
+#### 12.2.1 Verificar Disponibilidad de Clientes
+
+```bash
+php bin/console app:check-client-availability
+```
+
+**Ejecución**: Cada 1 minuto (cron)
+
+Verifica el estado de conectividad de los clientes y actualiza su estado si no responden en un tiempo determinado.
+
+#### 12.2.2 Ejecutar Trazas Pendientes
+
+```bash
+php bin/console app:execute-pending-traces
+```
+
+**Ejecución**: Cada 1 minuto (cron)
+
+Procesa las trazas en estado `PENDING` y las ejecuta en los clientes correspondientes.
+
+#### 12.2.3 Ejecutar Tareas Programadas
+
+```bash
+php bin/console app:run-scheduled-command-tasks
+```
+
+**Ejecución**: Cada 1 minuto (cron)
+
+Ejecuta tareas programadas que han llegado a su hora de ejecución.
+
+### 12.3 Comandos de Migración
+
+Comandos para migrar datos desde OpenGnsys 1.1:
+
+#### 12.3.1 Migrar Unidades Organizativas
+
+```bash
+php bin/console opengnsys:migration:organizational-unit
+```
+
+#### 12.3.2 Migrar Perfiles de Hardware
+
+```bash
+php bin/console opengnsys:migration:hardware-profile
+```
+
+#### 12.3.3 Migrar Clientes
+
+```bash
+php bin/console opengnsys:migration:clients
+```
+
+#### 12.3.4 Migrar Sistemas Operativos
+
+```bash
+php bin/console opengnsys:migration:os
+```
+
+#### 12.3.5 Migrar Imágenes
+
+```bash
+php bin/console opengnsys:migration:image
+```
+
+#### 12.3.6 Migrar Perfiles de Software
+
+```bash
+php bin/console opengnsys:migration:software-profile
+```
+
+#### 12.3.7 Migrar Particiones de Clientes
+
+```bash
+php bin/console opengnsys:migration:partition-client
+```
+
+### 12.4 Comandos de Desarrollo
+
+#### 12.4.1 Crear Repositorios de Imágenes
+
+```bash
+php bin/console app:create-image-repositories
+```
+
+Crea repositorios de imágenes para desarrollo/testing.
+
+#### 12.4.2 Cargar Trazas de Ejemplo
+
+```bash
+php bin/console app:charge-example-trace
+```
+
+Carga trazas de ejemplo para testing.
+
+### 12.5 Configuración de Cron
+
+Agregar al crontab:
+
+```bash
+* * * * * docker exec ogcore-php php bin/console app:check-client-availability
+* * * * * docker exec ogcore-php php bin/console app:execute-pending-traces
+* * * * * docker exec ogcore-php php bin/console app:run-scheduled-command-tasks
+```
+
+---
+
+## 13. Migraciones de Datos
+
+### 13.1 Sistema de Migraciones de Doctrine
+
+ogCore utiliza Doctrine Migrations para gestionar cambios en el esquema de base de datos.
+
+#### 13.1.1 Crear una Migración
+
+```bash
+docker exec ogcore-php php bin/console make:migration
+```
+
+#### 13.1.2 Ejecutar Migraciones
+
+```bash
+docker exec ogcore-php php bin/console doctrine:migrations:migrate
+```
+
+#### 13.1.3 Ver Estado de Migraciones
+
+```bash
+docker exec ogcore-php php bin/console doctrine:migrations:status
+```
+
+#### 13.1.4 Revertir Migración
+
+```bash
+docker exec ogcore-php php bin/console doctrine:migrations:migrate prev
+```
+
+### 13.2 Migración desde OpenGnsys 1.1
+
+Para migrar datos desde una instalación de OpenGnsys 1.1:
+
+#### 13.2.1 Crear Base de Datos Temporal
+
+```bash
 docker exec ogcore-php php bin/console doctrine:database:create --connection=og_1
 ```
 
-![img.png](swagger-assets/img_bbdd.png)
+#### 13.2.2 Cargar Dump de OpenGnsys 1.1
 
-Aqui podemos ver como tenemos las 2 bases de datos. OgCore es la actual, donde estamos desarrollando, y ogcore_old_og es la base de datos temporal que acabamos de crear.
-
-Aqui vendria el paso de cargar el dump en dicha base de datos, ya que contiene informacion sensible, no se aloja en el repositorio, por eso tendremos que solicitarla al equipo correspondiente.
-Una vez tengamos la base de datos cargada, podremos ejecutar las migraciones de datos:
-
-```sh
---- Migraciones de OpenGnsys.  ---
-docker exec ogcore-php php bin/console opengnsys:migration:organizational-unit #cargamos las unidades organizativas
-docker exec ogcore-php php bin/console opengnsys:migration:hardware-profile #cargamos los perfiles de hardware
-docker exec ogcore-php php bin/console opengnsys:migration:clients #cargamos los clientes
-docker exec ogcore-php php bin/console opengnsys:migration:os #cargamos los sistemas operativos
-docker exec ogcore-php php bin/console opengnsys:migration:image #cargamos las imagenes
-docker exec ogcore-php php bin/console opengnsys:migration:software-profile #cargamos los software profiles
+```bash
+docker exec -i ogcore-database mysql -u user -p ogcore_old_og < dump_og_1.1.sql
 ```
 
-## Objetos de interés
+#### 13.2.3 Ejecutar Migraciones
 
-Se ha incluido un .zip con las colecciones de de API de ogCore para poder trabajar, hacer pruebas, y demás en Postman. Para importarlos, tan solo tendremos que ir a la pestaña de importar, y seleccionar el archivo .zip.
+Ejecutar los comandos de migración en orden:
 
-Visualizar [coleccion Postman](swagger-assets/ogCore.postman_collection.zip)
+```bash
+docker exec ogcore-php php bin/console opengnsys:migration:organizational-unit
+docker exec ogcore-php php bin/console opengnsys:migration:hardware-profile
+docker exec ogcore-php php bin/console opengnsys:migration:clients
+docker exec ogcore-php php bin/console opengnsys:migration:os
+docker exec ogcore-php php bin/console opengnsys:migration:image
+docker exec ogcore-php php bin/console opengnsys:migration:software-profile
+```
+
+### 13.3 Backup y Restauración
+
+#### 13.3.1 Backup de Base de Datos
+
+```bash
+docker exec ogcore-database mysqldump -u user -p ogcore > backup_$(date +%Y%m%d).sql
+```
+
+#### 13.3.2 Restaurar Base de Datos
+
+```bash
+docker exec -i ogcore-database mysql -u user -p ogcore < backup_20251008.sql
+```
+
+---
+
+## 14. Testing
+
+### 14.1 Framework de Testing
+
+ogCore utiliza **PHPUnit** con integración de Symfony y Doctrine.
+
+### 14.2 Ejecutar Tests
+
+#### 14.2.1 Todos los Tests
+
+```bash
+docker compose exec php bin/phpunit
+```
+
+#### 14.2.2 Tests Específicos
+
+```bash
+docker compose exec php bin/phpunit tests/Functional/ClientTest.php
+```
+
+#### 14.2.3 Tests con Coverage
+
+```bash
+docker compose exec php bin/phpunit --coverage-html coverage/
+```
+
+### 14.3 Tipos de Tests
+
+#### 14.3.1 Tests Funcionales
+
+Ubicación: `tests/Functional/`
+
+20 archivos de tests funcionales que prueban:
+- Endpoints de API
+- Flujos completos
+- Integraciones
+
+Ejemplo:
+
+```php
+public function testCreateClient(): void
+{
+    $client = static::createClient();
+    $client->request('POST', '/clients', [
+        'json' => [
+            'name' => 'Test Client',
+            'mac' => '00:11:22:33:44:55',
+            'ip' => '192.168.1.100'
+        ]
+    ]);
+    
+    $this->assertResponseStatusCodeSame(201);
+}
+```
+
+### 14.4 Factories para Testing
+
+Se utilizan **Zenstruck Foundry** factories (24 factories) para crear datos de prueba:
+
+```php
+ClientFactory::createOne([
+    'name' => 'Test PC',
+    'status' => 'active'
+]);
+```
+
+### 14.5 Base de Datos de Testing
+
+Los tests utilizan **DAMA Doctrine Test Bundle** para:
+- Ejecutar cada test en una transacción
+- Rollback automático después de cada test
+- Aislamiento completo entre tests
+
+---
+
+## 15. Despliegue
+
+### 15.1 Despliegue con Docker Compose
+
+#### 15.1.1 Desarrollo
+
+```bash
+docker compose up -d
+```
+
+#### 15.1.2 Producción
+
+```bash
+docker compose -f docker-compose-deploy.yml up -d
+```
+
+### 15.2 Despliegue con Jenkins
+
+El proyecto incluye **Jenkinsfile** para CI/CD.
+
+#### Pipeline stages:
+1. **Checkout**: Clonar repositorio
+2. **Build**: Construir imagen Docker
+3. **Test**: Ejecutar tests
+4. **Package**: Crear paquete Debian
+5. **Deploy**: Desplegar en servidor
+
+### 15.3 Paquete Debian
+
+El proyecto puede empaquetarse como `.deb`:
+
+```bash
+./package.sh
+```
+
+Estructura del paquete en `debian/`:
+- Control files
+- Postinst/preinst scripts
+- Systemd service file
+- Configuración
+
+### 15.4 Configuración de Producción
+
+#### 15.4.1 Variables de Entorno
+
+Crear `.env.local` con configuración de producción:
+
+```bash
+APP_ENV=prod
+APP_DEBUG=0
+DATABASE_URL="mysql://user:pass@localhost:3306/ogcore"
+# ... más configuración
+```
+
+#### 15.4.2 Optimizaciones
+
+```bash
+# Limpiar caché
+docker exec ogcore-php php bin/console cache:clear --env=prod
+
+# Calentar caché
+docker exec ogcore-php php bin/console cache:warmup --env=prod
+
+# Optimizar autoloader
+docker exec ogcore-php composer dump-autoload --optimize --classmap-authoritative
+```
+
+### 15.5 Monitoreo
+
+#### 15.5.1 Logs
+
+Logs ubicados en `var/log/`:
+- `dev.log` / `prod.log`: Logs de aplicación
+- `nginx/access.log`: Accesos a nginx
+- `nginx/error.log`: Errores de nginx
+
+#### 15.5.2 Syslog
+
+Los logs también se envían a syslog para centralización.
+
+### 15.6 Escalabilidad
+
+Para escalar horizontalmente:
+
+1. **Base de datos**: Usar MariaDB con replicación master-slave
+2. **PHP**: Aumentar réplicas de contenedor PHP
+3. **Load Balancer**: Usar nginx como balanceador de carga
+4. **Caché**: Implementar Redis para sesiones y caché
+5. **Mercure**: Escalar hub de Mercure
+
+---
+
+## 16. Mantenimiento y Operaciones
+
+### 16.1 Reiniciar Base de Datos
+
+```bash
+docker exec ogcore-php php bin/console doctrine:database:drop --force
+docker exec ogcore-php php bin/console doctrine:database:create
+docker exec ogcore-php php bin/console doctrine:migrations:migrate --no-interaction
+docker exec ogcore-php php bin/console doctrine:fixtures:load --no-interaction
+```
+
+### 16.2 Limpiar Caché
+
+```bash
+docker exec ogcore-php php bin/console cache:clear
+docker exec ogcore-php php bin/console cache:warmup
+```
+
+### 16.3 Actualizar Dependencias
+
+```bash
+docker exec ogcore-php composer update
+```
+
+### 16.4 Regenerar Claves JWT
+
+```bash
+docker exec ogcore-php php bin/console lexik:jwt:generate-keypair --overwrite
+```
+
+### 16.5 Backups Automáticos
+
+Script ejemplo para backup automático:
+
+```bash
+#!/bin/bash
+DATE=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR="/backups"
+
+# Backup de base de datos
+docker exec ogcore-database mysqldump -u user -p password ogcore > $BACKUP_DIR/db_$DATE.sql
+
+# Backup de archivos
+tar -czf $BACKUP_DIR/files_$DATE.tar.gz /var/www/html/ogcore/var
+
+# Limpiar backups antiguos (>30 días)
+find $BACKUP_DIR -name "*.sql" -mtime +30 -delete
+find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete
+```
+
+### 16.6 Monitoreo de Salud
+
+#### Health Check Endpoint
+
+```bash
+GET /health
+```
+
+#### Verificar Estado de Servicios
+
+```bash
+# PHP
+docker exec ogcore-php php -v
+
+# Nginx
+docker exec ogcore-nginx nginx -t
+
+# MariaDB
+docker exec ogcore-database mysqladmin -u user -p status
+```
+
+### 16.7 Rotación de Logs
+
+Configurar logrotate:
+
+```bash
+/var/www/html/ogcore/var/log/*.log {
+    daily
+    rotate 14
+    compress
+    delaycompress
+    notifempty
+    create 0640 www-data www-data
+    sharedscripts
+}
+```
+
+---
+
+## 17. Integración con Otros Servicios
+
+### 17.1 ogRepository
+
+**Propósito**: Gestión de repositorios de imágenes.
+
+**Endpoints integrados**:
+- Crear imagen
+- Desplegar imagen
+- Backup imagen
+- Eliminar imagen
+- Convertir a imagen virtual
+- Importar imagen externa
+- Verificar integridad
+- Imagen global
+
+**Webhook**: `/og-repository/webhook`
+
+### 17.2 ogDhcp
+
+**Propósito**: Gestión de DHCP dinámico.
+
+**Funcionalidades**:
+- Agregar clientes a DHCP
+- Eliminar clientes de DHCP
+- Actualizar configuración
+- Gestión de subredes
+
+### 17.3 ogBoot
+
+**Propósito**: Gestión de archivos de arranque PXE.
+
+**Funcionalidades**:
+- Crear archivos de arranque
+- Actualizar plantillas PXE
+- Eliminar configuraciones
+- Sincronización de menús
+
+### 17.4 ogAgent
+
+**Propósito**: Agente instalado en clientes para ejecutar comandos.
+
+**Operaciones**:
+- Power on/off/reboot
+- Crear/desplegar imágenes
+- Particionar discos
+- Ejecutar scripts
+- Obtener inventario hardware
+- Verificar tamaño de particiones
+- Kill jobs
+
+### 17.5 UDS (Universal Desktop Services)
+
+**Propósito**: Integración con sistema de escritorios remotos.
+
+**Funcionalidades**:
+- Autenticación
+- Obtener service pools
+- Calcular disponibilidad
+- Gestión de reservas
+
+### 17.6 Git (Versionado de Imágenes)
+
+**Propósito**: Versionado de imágenes con Git.
+
+**Funcionalidades**:
+- Backup a repositorio Git
+- Versionado automático
+- Recuperación de versiones
+- Sincronización
+
+### 17.7 Mercure (Notificaciones en Tiempo Real)
+
+**Propósito**: Notificaciones push en tiempo real.
+
+**Eventos publicados**:
+- Cambio de estado de clientes
+- Actualización de trazas
+- Cambios en comandos
+- Alertas y notificaciones
+
+**Suscripción del cliente**:
+
+```javascript
+const eventSource = new EventSource('http://localhost:8080/.well-known/mercure?topic=/clients/{id}');
+eventSource.onmessage = event => {
+    const data = JSON.parse(event.data);
+    console.log('Client updated:', data);
+};
+```
+
+---
+
+## 18. Roadmap y Changelog
+
+### 18.1 Versión Actual: 0.5.0
+
+### 18.2 Últimas Características (v0.25.1 - Octubre 2025)
+
+- **Tareas programadas**: Sistema completo de colas y scheduling
+- **Inventario hardware**: Obtención automática de inventario
+- **Clonado de imágenes**: Mejoras en el servicio de clonado
+- **Repositorios Git**: Backup y gestión de repositorios
+- **Particionado**: Integración con agente para scripts de particionado
+- **Gestión de trazas**: Marcar como completadas, cancelación
+- **Estados de cliente**: Nuevo estado "enviado" para Windows/Linux
+- **Validación de particiones**: Comprobación de tamaños
+- **Imagen versionada**: Sistema de versionado de imágenes
+- **Calendario remoto**: Integración con UDS
+- **Mercure**: Notificaciones en tiempo real
+- **Despliegue multicast**: Modos torrent y UDPCAST
+
+### 18.3 Próximas Características (Roadmap)
+
+#### v0.6.0 (Q4 2025)
+- [ ] Dashboard de administración mejorado
+- [ ] Reportes y estadísticas avanzadas
+- [ ] API GraphQL complementaria
+- [ ] Mejoras en rendimiento de queries
+
+#### v0.7.0 (Q1 2026)
+- [ ] Soporte para múltiples lenguajes (i18n completo)
+- [ ] Sistema de plugins
+- [ ] Mejoras en clustering
+- [ ] API de webhooks salientes
+
+#### v1.0.0 (Q2 2026)
+- [ ] Versión estable de producción
+- [ ] Documentación completa de API
+- [ ] Guías de migración finalizadas
+- [ ] Certificación de seguridad
+
+### 18.4 Changelog Resumido
+
+Ver `CHANGELOG.md` para el historial completo de cambios.
+
+**Versiones destacadas**:
+
+- **0.25.1** (2025-10-01): Correcciones en tareas programadas
+- **0.25.0** (2025-09-23): Inventario hardware
+- **0.24.0** (2025-09-09): Servicio de eliminación de repositorios Git
+- **0.23.0** (2025-09-08): Backups a repositorios Git
+- **0.20.0** (2025-08-25): Sistema de colas y tareas
+- **0.15.0** (2025-06-26): Integración ogGit y sistema de cola
+- **0.14.0** (2025-06-02): Mover equipos, imagen cache, inicio sesión
+- **0.13.0** (2025-05-20): Comunicación TLS con agente
+- **0.12.0** (2025-05-13): Tareas programadas, integración ogGit
+- **0.11.0** (2025-04-11): Versionado de imágenes, ejecución de scripts
+- **0.10.0** (2025-03-25): Imagen virtual, importar imágenes
+- **0.9.0** (2025-03-04): Mercure, notificaciones en tiempo real
+- **0.8.0** (2025-01-10): Imagen global, jerarquía de aulas
+- **0.7.3** (2025-01-03): Multiselección, import/export, torrent/udpcast
+
+---
+
+## 19. Contribución
+
+### 19.1 Guía de Contribución
+
+Para contribuir al proyecto:
+
+1. **Fork** el repositorio
+2. Crea una **rama** para tu feature: `git checkout -b feature/nueva-funcionalidad`
+3. **Commit** tus cambios: `git commit -am 'Añade nueva funcionalidad'`
+4. **Push** a la rama: `git push origin feature/nueva-funcionalidad`
+5. Crea un **Pull Request**
+
+### 19.2 Estándares de Código
+
+- Seguir **PSR-12** para PHP
+- Usar **Type Hints** en PHP 8.3
+- Documentar con **PHPDoc**
+- Tests para nuevas funcionalidades
+- Commits descriptivos en español
+
+### 19.3 Proceso de Revisión
+
+1. CI/CD ejecuta tests automáticamente
+2. Revisión de código por maintainers
+3. Aprobación requerida antes de merge
+4. Merge a rama develop
+5. Release periódicos a main
+
+### 19.4 Reportar Bugs
+
+Usar el sistema de Issues del repositorio:
+
+**Template de Bug**:
+```
+**Descripción del bug**
+Descripción clara y concisa del bug.
+
+**Pasos para reproducir**
+1. Ir a '...'
+2. Hacer clic en '...'
+3. Ver error
+
+**Comportamiento esperado**
+Lo que esperabas que sucediera.
+
+**Screenshots**
+Si aplica, añadir screenshots.
+
+**Entorno**
+- OS: [ej. Ubuntu 22.04]
+- Versión: [ej. 0.5.0]
+- Browser: [ej. Firefox 118]
+```
+
+---
+
+## 20. Soporte y Contacto
+
+### 20.1 Documentación Adicional
+
+- **API Docs**: http://localhost:8080/docs
+- **Postman Collection**: `swagger-assets/ogCore.postman_collection.zip`
+- **Diagramas**: `swagger-assets/img_bbdd.png`
+
+### 20.2 Recursos
+
+- **Repositorio**: [URL del repositorio]
+- **Wiki**: [URL de la wiki]
+- **Issues**: [URL de issues]
+
+### 20.3 Equipo de Desarrollo
+
+Proyecto desarrollado por el equipo de OpenGnsys en colaboración con universidades participantes.
+
+### 20.4 Licencia
+
+Proyecto propietario. Ver archivo `LICENSE` para más información.
+
+---
+
+## Apéndices
+
+### Apéndice A: Glosario de Términos
+
+- **Cliente**: Equipo físico gestionado por el sistema
+- **Imagen**: Copia bit a bit de una partición de disco
+- **Traza**: Registro de ejecución de un comando
+- **Unidad Organizativa**: Agrupación lógica de clientes (aula, grupo)
+- **PXE**: Preboot Execution Environment, arranque por red
+- **ogLive**: Imagen Live de arranque de OpenGnsys
+- **Partición**: División lógica de un disco duro
+- **Repositorio**: Servidor de almacenamiento de imágenes
+
+### Apéndice B: Puertos y Servicios
+
+| Puerto | Servicio | Protocolo | Descripción |
+|--------|----------|-----------|-------------|
+| 8080 | nginx | HTTP | API y docs |
+| 3306 | MariaDB | MySQL | Base de datos |
+| 9000 | PHP-FPM | FastCGI | Procesador PHP |
+| 3000 | Mercure | HTTP/SSE | Notificaciones |
+
+### Apéndice C: Estructura de Directorios
+
+```
+ogcore/
+|-- bin/              # Ejecutables (console, phpunit)
+|-- config/           # Configuración de Symfony
+|   |-- api_platform/ # Configuración de entidades API
+|   |-- packages/     # Configuración de bundles
+|   +-- routes/       # Rutas
+|-- migrations/       # Migraciones de base de datos
+|-- public/           # Punto de entrada web
+|-- src/              # Código fuente
+|   |-- Command/      # Comandos de consola
+|   |-- Controller/   # Controladores
+|   |-- Dto/          # Data Transfer Objects
+|   |-- Entity/       # Entidades Doctrine
+|   |-- EventListener/# Event Listeners
+|   |-- EventSubscriber/ # Event Subscribers
+|   |-- Factory/      # Factories para testing
+|   |-- Filter/       # Filtros de API Platform
+|   |-- Repository/   # Repositorios Doctrine
+|   |-- Security/     # Seguridad y autenticación
+|   |-- Service/      # Servicios de negocio
+|   |-- State/        # States de API Platform
+|   +-- Validator/    # Validadores personalizados
+|-- tests/            # Tests
+|-- translations/     # Traducciones
+|-- var/              # Archivos variables (cache, logs)
++-- vendor/           # Dependencias
+
+```
+
+### Apéndice D: Variables de Entorno Completas
+
+Ver archivo `.env` para todas las variables de entorno disponibles.
+
+---
+
+**Fecha de actualización**: Octubre 2025  
+**Versión del documento**: 1.0  
+**Mantenedor**: Equipo OpenGnsys
diff --git a/config/packages/api_platform.yaml b/config/packages/api_platform.yaml
index b957e6a..c86b079 100644
--- a/config/packages/api_platform.yaml
+++ b/config/packages/api_platform.yaml
@@ -1,7 +1,7 @@
 api_platform:
     title: 'OgCore Api'
     description: 'Api Documentation for OgCore'
-    version: 0.5.0
+    version: 1.0.0
     path_segment_name_generator: api_platform.path_segment_name_generator.dash
     defaults:
         pagination_client_items_per_page: true
diff --git a/ogCore_Documentacion_Tecnica.html b/ogCore_Documentacion_Tecnica.html
new file mode 100644
index 0000000..6ccf54d
--- /dev/null
+++ b/ogCore_Documentacion_Tecnica.html
@@ -0,0 +1,2451 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="pandoc" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
+  <meta name="author" content="Equipo OpenGnsys" />
+  <title>ogCore - Documentación Técnica y Funcional</title>
+  <style>
+    code{white-space: pre-wrap;}
+    span.smallcaps{font-variant: small-caps;}
+    div.columns{display: flex; gap: min(4vw, 1.5em);}
+    div.column{flex: auto; overflow-x: auto;}
+    div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
+    /* The extra [class] is a hack that increases specificity enough to
+       override a similar rule in reveal.js */
+    ul.task-list[class]{list-style: none;}
+    ul.task-list li input[type="checkbox"] {
+      font-size: inherit;
+      width: 0.8em;
+      margin: 0 0.8em 0.2em -1.6em;
+      vertical-align: middle;
+    }
+    .display.math{display: block; text-align: center; margin: 0.5rem auto;}
+    /* CSS for syntax highlighting */
+    pre > code.sourceCode { white-space: pre; position: relative; }
+    pre > code.sourceCode > span { line-height: 1.25; }
+    pre > code.sourceCode > span:empty { height: 1.2em; }
+    .sourceCode { overflow: visible; }
+    code.sourceCode > span { color: inherit; text-decoration: inherit; }
+    div.sourceCode { margin: 1em 0; }
+    pre.sourceCode { margin: 0; }
+    @media screen {
+    div.sourceCode { overflow: auto; }
+    }
+    @media print {
+    pre > code.sourceCode { white-space: pre-wrap; }
+    pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
+    }
+    pre.numberSource code
+      { counter-reset: source-line 0; }
+    pre.numberSource code > span
+      { position: relative; left: -4em; counter-increment: source-line; }
+    pre.numberSource code > span > a:first-child::before
+      { content: counter(source-line);
+        position: relative; left: -1em; text-align: right; vertical-align: baseline;
+        border: none; display: inline-block;
+        -webkit-touch-callout: none; -webkit-user-select: none;
+        -khtml-user-select: none; -moz-user-select: none;
+        -ms-user-select: none; user-select: none;
+        padding: 0 4px; width: 4em;
+        color: #aaaaaa;
+      }
+    pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa;  padding-left: 4px; }
+    div.sourceCode
+      {   }
+    @media screen {
+    pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
+    }
+    code span.al { color: #ff0000; font-weight: bold; } /* Alert */
+    code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
+    code span.at { color: #7d9029; } /* Attribute */
+    code span.bn { color: #40a070; } /* BaseN */
+    code span.bu { color: #008000; } /* BuiltIn */
+    code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
+    code span.ch { color: #4070a0; } /* Char */
+    code span.cn { color: #880000; } /* Constant */
+    code span.co { color: #60a0b0; font-style: italic; } /* Comment */
+    code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
+    code span.do { color: #ba2121; font-style: italic; } /* Documentation */
+    code span.dt { color: #902000; } /* DataType */
+    code span.dv { color: #40a070; } /* DecVal */
+    code span.er { color: #ff0000; font-weight: bold; } /* Error */
+    code span.ex { } /* Extension */
+    code span.fl { color: #40a070; } /* Float */
+    code span.fu { color: #06287e; } /* Function */
+    code span.im { color: #008000; font-weight: bold; } /* Import */
+    code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
+    code span.kw { color: #007020; font-weight: bold; } /* Keyword */
+    code span.op { color: #666666; } /* Operator */
+    code span.ot { color: #007020; } /* Other */
+    code span.pp { color: #bc7a00; } /* Preprocessor */
+    code span.sc { color: #4070a0; } /* SpecialChar */
+    code span.ss { color: #bb6688; } /* SpecialString */
+    code span.st { color: #4070a0; } /* String */
+    code span.va { color: #19177c; } /* Variable */
+    code span.vs { color: #4070a0; } /* VerbatimString */
+    code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
+  </style>
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/5.1.0/github-markdown.min.css" />
+</head>
+<body>
+<header id="title-block-header">
+<h1 class="title">ogCore - Documentación Técnica y Funcional</h1>
+<p class="author">Equipo OpenGnsys</p>
+<p class="date">Octubre 2025</p>
+</header>
+<nav id="TOC" role="doc-toc">
+<ul>
+<li><a href="#ogcore---documentación-técnica-y-funcional"
+id="toc-ogcore---documentación-técnica-y-funcional"><span
+class="toc-section-number">1</span> ogCore - Documentación Técnica y
+Funcional</a>
+<ul>
+<li><a href="#tabla-de-contenidos" id="toc-tabla-de-contenidos"><span
+class="toc-section-number">1.1</span> Tabla de Contenidos</a></li>
+<li><a href="#introducción" id="toc-introducción"><span
+class="toc-section-number">1.2</span> 1. Introducción</a>
+<ul>
+<li><a href="#propósito-del-sistema"
+id="toc-propósito-del-sistema"><span
+class="toc-section-number">1.2.1</span> 1.1 Propósito del
+Sistema</a></li>
+<li><a href="#alcance" id="toc-alcance"><span
+class="toc-section-number">1.2.2</span> 1.2 Alcance</a></li>
+</ul></li>
+<li><a href="#descripción-del-proyecto"
+id="toc-descripción-del-proyecto"><span
+class="toc-section-number">1.3</span> 2. Descripción del Proyecto</a>
+<ul>
+<li><a href="#qué-es-ogcore" id="toc-qué-es-ogcore"><span
+class="toc-section-number">1.3.1</span> 2.1 ¿Qué es ogCore?</a></li>
+<li><a href="#características-principales"
+id="toc-características-principales"><span
+class="toc-section-number">1.3.2</span> 2.2 Características
+Principales</a></li>
+<li><a href="#versión-actual" id="toc-versión-actual"><span
+class="toc-section-number">1.3.3</span> 2.3 Versión Actual</a></li>
+</ul></li>
+<li><a href="#arquitectura-del-sistema"
+id="toc-arquitectura-del-sistema"><span
+class="toc-section-number">1.4</span> 3. Arquitectura del Sistema</a>
+<ul>
+<li><a href="#arquitectura-general" id="toc-arquitectura-general"><span
+class="toc-section-number">1.4.1</span> 3.1 Arquitectura
+General</a></li>
+<li><a href="#capas-de-la-aplicación"
+id="toc-capas-de-la-aplicación"><span
+class="toc-section-number">1.4.2</span> 3.2 Capas de la
+Aplicación</a></li>
+<li><a href="#patrones-de-diseño-utilizados"
+id="toc-patrones-de-diseño-utilizados"><span
+class="toc-section-number">1.4.3</span> 3.3 Patrones de Diseño
+Utilizados</a></li>
+</ul></li>
+<li><a href="#tecnologías-utilizadas"
+id="toc-tecnologías-utilizadas"><span
+class="toc-section-number">1.5</span> 4. Tecnologías Utilizadas</a>
+<ul>
+<li><a href="#backend" id="toc-backend"><span
+class="toc-section-number">1.5.1</span> 4.1 Backend</a></li>
+<li><a href="#base-de-datos" id="toc-base-de-datos"><span
+class="toc-section-number">1.5.2</span> 4.2 Base de Datos</a></li>
+<li><a href="#infraestructura" id="toc-infraestructura"><span
+class="toc-section-number">1.5.3</span> 4.3 Infraestructura</a></li>
+<li><a href="#testing" id="toc-testing"><span
+class="toc-section-number">1.5.4</span> 4.4 Testing</a></li>
+<li><a href="#desarrollo" id="toc-desarrollo"><span
+class="toc-section-number">1.5.5</span> 4.5 Desarrollo</a></li>
+</ul></li>
+<li><a href="#requisitos-del-sistema"
+id="toc-requisitos-del-sistema"><span
+class="toc-section-number">1.6</span> 5. Requisitos del Sistema</a>
+<ul>
+<li><a href="#requisitos-de-hardware-producción"
+id="toc-requisitos-de-hardware-producción"><span
+class="toc-section-number">1.6.1</span> 5.1 Requisitos de Hardware
+(Producción)</a></li>
+<li><a href="#requisitos-de-software"
+id="toc-requisitos-de-software"><span
+class="toc-section-number">1.6.2</span> 5.2 Requisitos de
+Software</a></li>
+<li><a href="#puertos-requeridos" id="toc-puertos-requeridos"><span
+class="toc-section-number">1.6.3</span> 5.3 Puertos Requeridos</a></li>
+</ul></li>
+<li><a href="#instalación-y-configuración"
+id="toc-instalación-y-configuración"><span
+class="toc-section-number">1.7</span> 6. Instalación y Configuración</a>
+<ul>
+<li><a href="#instalación-con-docker-recomendado"
+id="toc-instalación-con-docker-recomendado"><span
+class="toc-section-number">1.7.1</span> 6.1 Instalación con Docker
+(Recomendado)</a></li>
+<li><a href="#configuración" id="toc-configuración"><span
+class="toc-section-number">1.7.2</span> 6.2 Configuración</a></li>
+<li><a href="#instalación-en-producción"
+id="toc-instalación-en-producción"><span
+class="toc-section-number">1.7.3</span> 6.3 Instalación en
+Producción</a></li>
+</ul></li>
+<li><a href="#modelo-de-datos" id="toc-modelo-de-datos"><span
+class="toc-section-number">1.8</span> 7. Modelo de Datos</a>
+<ul>
+<li><a href="#diagrama-de-entidades"
+id="toc-diagrama-de-entidades"><span
+class="toc-section-number">1.8.1</span> 7.1 Diagrama de
+Entidades</a></li>
+<li><a href="#entidades-principales"
+id="toc-entidades-principales"><span
+class="toc-section-number">1.8.2</span> 7.2 Entidades
+Principales</a></li>
+<li><a href="#índices-y-optimizaciones"
+id="toc-índices-y-optimizaciones"><span
+class="toc-section-number">1.8.3</span> 7.3 Índices y
+Optimizaciones</a></li>
+</ul></li>
+<li><a href="#componentes-del-sistema"
+id="toc-componentes-del-sistema"><span
+class="toc-section-number">1.9</span> 8. Componentes del Sistema</a>
+<ul>
+<li><a href="#controllers-controladores"
+id="toc-controllers-controladores"><span
+class="toc-section-number">1.9.1</span> 8.1 Controllers
+(Controladores)</a></li>
+<li><a href="#states-procesadores-de-estado"
+id="toc-states-procesadores-de-estado"><span
+class="toc-section-number">1.9.2</span> 8.2 States (Procesadores de
+Estado)</a></li>
+<li><a href="#dtos-data-transfer-objects"
+id="toc-dtos-data-transfer-objects"><span
+class="toc-section-number">1.9.3</span> 8.3 DTOs (Data Transfer
+Objects)</a></li>
+<li><a href="#validators-validadores"
+id="toc-validators-validadores"><span
+class="toc-section-number">1.9.4</span> 8.4 Validators
+(Validadores)</a></li>
+<li><a href="#eventsubscribers-suscriptores-de-eventos"
+id="toc-eventsubscribers-suscriptores-de-eventos"><span
+class="toc-section-number">1.9.5</span> 8.5 EventSubscribers
+(Suscriptores de Eventos)</a></li>
+<li><a href="#factories-fábricas" id="toc-factories-fábricas"><span
+class="toc-section-number">1.9.6</span> 8.6 Factories
+(Fábricas)</a></li>
+</ul></li>
+<li><a href="#api-restful" id="toc-api-restful"><span
+class="toc-section-number">1.10</span> 9. API RESTful</a>
+<ul>
+<li><a href="#documentación" id="toc-documentación"><span
+class="toc-section-number">1.10.1</span> 9.1 Documentación</a></li>
+<li><a href="#formato-de-respuestas"
+id="toc-formato-de-respuestas"><span
+class="toc-section-number">1.10.2</span> 9.2 Formato de
+Respuestas</a></li>
+<li><a href="#paginación" id="toc-paginación"><span
+class="toc-section-number">1.10.3</span> 9.3 Paginación</a></li>
+<li><a href="#filtrado" id="toc-filtrado"><span
+class="toc-section-number">1.10.4</span> 9.4 Filtrado</a></li>
+<li><a href="#ordenamiento" id="toc-ordenamiento"><span
+class="toc-section-number">1.10.5</span> 9.5 Ordenamiento</a></li>
+<li><a href="#endpoints-principales"
+id="toc-endpoints-principales"><span
+class="toc-section-number">1.10.6</span> 9.6 Endpoints
+Principales</a></li>
+<li><a href="#códigos-de-estado-http"
+id="toc-códigos-de-estado-http"><span
+class="toc-section-number">1.10.7</span> 9.7 Códigos de Estado
+HTTP</a></li>
+</ul></li>
+<li><a href="#seguridad-y-autenticación"
+id="toc-seguridad-y-autenticación"><span
+class="toc-section-number">1.11</span> 10. Seguridad y Autenticación</a>
+<ul>
+<li><a href="#sistema-de-autenticación-jwt"
+id="toc-sistema-de-autenticación-jwt"><span
+class="toc-section-number">1.11.1</span> 10.1 Sistema de Autenticación
+JWT</a></li>
+<li><a href="#control-de-acceso" id="toc-control-de-acceso"><span
+class="toc-section-number">1.11.2</span> 10.2 Control de Acceso</a></li>
+<li><a href="#roles-de-usuario" id="toc-roles-de-usuario"><span
+class="toc-section-number">1.11.3</span> 10.3 Roles de Usuario</a></li>
+<li><a href="#seguridad-de-contraseñas"
+id="toc-seguridad-de-contraseñas"><span
+class="toc-section-number">1.11.4</span> 10.4 Seguridad de
+Contraseñas</a></li>
+<li><a href="#cors-cross-origin-resource-sharing"
+id="toc-cors-cross-origin-resource-sharing"><span
+class="toc-section-number">1.11.5</span> 10.5 CORS (Cross-Origin
+Resource Sharing)</a></li>
+<li><a href="#ssltls" id="toc-ssltls"><span
+class="toc-section-number">1.11.6</span> 10.6 SSL/TLS</a></li>
+</ul></li>
+<li><a href="#servicios-principales"
+id="toc-servicios-principales"><span
+class="toc-section-number">1.12</span> 11. Servicios Principales</a>
+<ul>
+<li><a href="#createpartitionservice"
+id="toc-createpartitionservice"><span
+class="toc-section-number">1.12.1</span> 11.1
+CreatePartitionService</a></li>
+<li><a href="#createtraceservice" id="toc-createtraceservice"><span
+class="toc-section-number">1.12.2</span> 11.2
+CreateTraceService</a></li>
+<li><a href="#changeclientnetworksettingsservice"
+id="toc-changeclientnetworksettingsservice"><span
+class="toc-section-number">1.12.3</span> 11.3
+ChangeClientNetworkSettingsService</a></li>
+<li><a href="#externalgitrepositoryservice"
+id="toc-externalgitrepositoryservice"><span
+class="toc-section-number">1.12.4</span> 11.4
+ExternalGitRepositoryService</a></li>
+<li><a href="#statusservice-ogbootogdhcpogrepository"
+id="toc-statusservice-ogbootogdhcpogrepository"><span
+class="toc-section-number">1.12.5</span> 11.5 StatusService
+(OgBoot/OgDhcp/OgRepository)</a></li>
+<li><a href="#udsclient" id="toc-udsclient"><span
+class="toc-section-number">1.12.6</span> 11.6 UDSClient</a></li>
+<li><a href="#tracecreateservice" id="toc-tracecreateservice"><span
+class="toc-section-number">1.12.7</span> 11.7
+Trace/CreateService</a></li>
+<li><a href="#utilsgetpartitioncodeservice"
+id="toc-utilsgetpartitioncodeservice"><span
+class="toc-section-number">1.12.8</span> 11.8
+Utils/GetPartitionCodeService</a></li>
+<li><a href="#utilssimplifyoglivefilenameservice"
+id="toc-utilssimplifyoglivefilenameservice"><span
+class="toc-section-number">1.12.9</span> 11.9
+Utils/SimplifyOgLiveFilenameService</a></li>
+<li><a href="#utilsgetipaddressandnetmaskfromcidrservice"
+id="toc-utilsgetipaddressandnetmaskfromcidrservice"><span
+class="toc-section-number">1.12.10</span> 11.10
+Utils/GetIpAddressAndNetmaskFromCIDRService</a></li>
+</ul></li>
+<li><a href="#comandos-de-consola" id="toc-comandos-de-consola"><span
+class="toc-section-number">1.13</span> 12. Comandos de Consola</a>
+<ul>
+<li><a href="#comandos-de-inicialización"
+id="toc-comandos-de-inicialización"><span
+class="toc-section-number">1.13.1</span> 12.1 Comandos de
+Inicialización</a></li>
+<li><a href="#comandos-de-operación"
+id="toc-comandos-de-operación"><span
+class="toc-section-number">1.13.2</span> 12.2 Comandos de
+Operación</a></li>
+<li><a href="#comandos-de-migración"
+id="toc-comandos-de-migración"><span
+class="toc-section-number">1.13.3</span> 12.3 Comandos de
+Migración</a></li>
+<li><a href="#comandos-de-desarrollo"
+id="toc-comandos-de-desarrollo"><span
+class="toc-section-number">1.13.4</span> 12.4 Comandos de
+Desarrollo</a></li>
+<li><a href="#configuración-de-cron"
+id="toc-configuración-de-cron"><span
+class="toc-section-number">1.13.5</span> 12.5 Configuración de
+Cron</a></li>
+</ul></li>
+<li><a href="#migraciones-de-datos" id="toc-migraciones-de-datos"><span
+class="toc-section-number">1.14</span> 13. Migraciones de Datos</a>
+<ul>
+<li><a href="#sistema-de-migraciones-de-doctrine"
+id="toc-sistema-de-migraciones-de-doctrine"><span
+class="toc-section-number">1.14.1</span> 13.1 Sistema de Migraciones de
+Doctrine</a></li>
+<li><a href="#migración-desde-opengnsys-1.1"
+id="toc-migración-desde-opengnsys-1.1"><span
+class="toc-section-number">1.14.2</span> 13.2 Migración desde OpenGnsys
+1.1</a></li>
+<li><a href="#backup-y-restauración"
+id="toc-backup-y-restauración"><span
+class="toc-section-number">1.14.3</span> 13.3 Backup y
+Restauración</a></li>
+</ul></li>
+<li><a href="#testing-1" id="toc-testing-1"><span
+class="toc-section-number">1.15</span> 14. Testing</a>
+<ul>
+<li><a href="#framework-de-testing" id="toc-framework-de-testing"><span
+class="toc-section-number">1.15.1</span> 14.1 Framework de
+Testing</a></li>
+<li><a href="#ejecutar-tests" id="toc-ejecutar-tests"><span
+class="toc-section-number">1.15.2</span> 14.2 Ejecutar Tests</a></li>
+<li><a href="#tipos-de-tests" id="toc-tipos-de-tests"><span
+class="toc-section-number">1.15.3</span> 14.3 Tipos de Tests</a></li>
+<li><a href="#factories-para-testing"
+id="toc-factories-para-testing"><span
+class="toc-section-number">1.15.4</span> 14.4 Factories para
+Testing</a></li>
+<li><a href="#base-de-datos-de-testing"
+id="toc-base-de-datos-de-testing"><span
+class="toc-section-number">1.15.5</span> 14.5 Base de Datos de
+Testing</a></li>
+</ul></li>
+<li><a href="#despliegue" id="toc-despliegue"><span
+class="toc-section-number">1.16</span> 15. Despliegue</a>
+<ul>
+<li><a href="#despliegue-con-docker-compose"
+id="toc-despliegue-con-docker-compose"><span
+class="toc-section-number">1.16.1</span> 15.1 Despliegue con Docker
+Compose</a></li>
+<li><a href="#despliegue-con-jenkins"
+id="toc-despliegue-con-jenkins"><span
+class="toc-section-number">1.16.2</span> 15.2 Despliegue con
+Jenkins</a></li>
+<li><a href="#paquete-debian" id="toc-paquete-debian"><span
+class="toc-section-number">1.16.3</span> 15.3 Paquete Debian</a></li>
+<li><a href="#configuración-de-producción"
+id="toc-configuración-de-producción"><span
+class="toc-section-number">1.16.4</span> 15.4 Configuración de
+Producción</a></li>
+<li><a href="#monitoreo" id="toc-monitoreo"><span
+class="toc-section-number">1.16.5</span> 15.5 Monitoreo</a></li>
+<li><a href="#escalabilidad" id="toc-escalabilidad"><span
+class="toc-section-number">1.16.6</span> 15.6 Escalabilidad</a></li>
+</ul></li>
+<li><a href="#mantenimiento-y-operaciones"
+id="toc-mantenimiento-y-operaciones"><span
+class="toc-section-number">1.17</span> 16. Mantenimiento y
+Operaciones</a>
+<ul>
+<li><a href="#reiniciar-base-de-datos"
+id="toc-reiniciar-base-de-datos"><span
+class="toc-section-number">1.17.1</span> 16.1 Reiniciar Base de
+Datos</a></li>
+<li><a href="#limpiar-caché" id="toc-limpiar-caché"><span
+class="toc-section-number">1.17.2</span> 16.2 Limpiar Caché</a></li>
+<li><a href="#actualizar-dependencias"
+id="toc-actualizar-dependencias"><span
+class="toc-section-number">1.17.3</span> 16.3 Actualizar
+Dependencias</a></li>
+<li><a href="#regenerar-claves-jwt" id="toc-regenerar-claves-jwt"><span
+class="toc-section-number">1.17.4</span> 16.4 Regenerar Claves
+JWT</a></li>
+<li><a href="#backups-automáticos" id="toc-backups-automáticos"><span
+class="toc-section-number">1.17.5</span> 16.5 Backups
+Automáticos</a></li>
+<li><a href="#monitoreo-de-salud" id="toc-monitoreo-de-salud"><span
+class="toc-section-number">1.17.6</span> 16.6 Monitoreo de
+Salud</a></li>
+<li><a href="#rotación-de-logs" id="toc-rotación-de-logs"><span
+class="toc-section-number">1.17.7</span> 16.7 Rotación de Logs</a></li>
+</ul></li>
+<li><a href="#integración-con-otros-servicios"
+id="toc-integración-con-otros-servicios"><span
+class="toc-section-number">1.18</span> 17. Integración con Otros
+Servicios</a>
+<ul>
+<li><a href="#ogrepository" id="toc-ogrepository"><span
+class="toc-section-number">1.18.1</span> 17.1 ogRepository</a></li>
+<li><a href="#ogdhcp" id="toc-ogdhcp"><span
+class="toc-section-number">1.18.2</span> 17.2 ogDhcp</a></li>
+<li><a href="#ogboot" id="toc-ogboot"><span
+class="toc-section-number">1.18.3</span> 17.3 ogBoot</a></li>
+<li><a href="#ogagent" id="toc-ogagent"><span
+class="toc-section-number">1.18.4</span> 17.4 ogAgent</a></li>
+<li><a href="#uds-universal-desktop-services"
+id="toc-uds-universal-desktop-services"><span
+class="toc-section-number">1.18.5</span> 17.5 UDS (Universal Desktop
+Services)</a></li>
+<li><a href="#git-versionado-de-imágenes"
+id="toc-git-versionado-de-imágenes"><span
+class="toc-section-number">1.18.6</span> 17.6 Git (Versionado de
+Imágenes)</a></li>
+<li><a href="#mercure-notificaciones-en-tiempo-real"
+id="toc-mercure-notificaciones-en-tiempo-real"><span
+class="toc-section-number">1.18.7</span> 17.7 Mercure (Notificaciones en
+Tiempo Real)</a></li>
+</ul></li>
+<li><a href="#roadmap-y-changelog" id="toc-roadmap-y-changelog"><span
+class="toc-section-number">1.19</span> 18. Roadmap y Changelog</a>
+<ul>
+<li><a href="#versión-actual-0.5.0" id="toc-versión-actual-0.5.0"><span
+class="toc-section-number">1.19.1</span> 18.1 Versión Actual:
+0.5.0</a></li>
+<li><a href="#últimas-características-v0.25.1---octubre-2025"
+id="toc-últimas-características-v0.25.1---octubre-2025"><span
+class="toc-section-number">1.19.2</span> 18.2 Últimas Características
+(v0.25.1 - Octubre 2025)</a></li>
+<li><a href="#próximas-características-roadmap"
+id="toc-próximas-características-roadmap"><span
+class="toc-section-number">1.19.3</span> 18.3 Próximas Características
+(Roadmap)</a></li>
+<li><a href="#changelog-resumido" id="toc-changelog-resumido"><span
+class="toc-section-number">1.19.4</span> 18.4 Changelog
+Resumido</a></li>
+</ul></li>
+<li><a href="#contribución" id="toc-contribución"><span
+class="toc-section-number">1.20</span> 19. Contribución</a>
+<ul>
+<li><a href="#guía-de-contribución" id="toc-guía-de-contribución"><span
+class="toc-section-number">1.20.1</span> 19.1 Guía de
+Contribución</a></li>
+<li><a href="#estándares-de-código" id="toc-estándares-de-código"><span
+class="toc-section-number">1.20.2</span> 19.2 Estándares de
+Código</a></li>
+<li><a href="#proceso-de-revisión" id="toc-proceso-de-revisión"><span
+class="toc-section-number">1.20.3</span> 19.3 Proceso de
+Revisión</a></li>
+<li><a href="#reportar-bugs" id="toc-reportar-bugs"><span
+class="toc-section-number">1.20.4</span> 19.4 Reportar Bugs</a></li>
+</ul></li>
+<li><a href="#soporte-y-contacto" id="toc-soporte-y-contacto"><span
+class="toc-section-number">1.21</span> 20. Soporte y Contacto</a>
+<ul>
+<li><a href="#documentación-adicional"
+id="toc-documentación-adicional"><span
+class="toc-section-number">1.21.1</span> 20.1 Documentación
+Adicional</a></li>
+<li><a href="#recursos" id="toc-recursos"><span
+class="toc-section-number">1.21.2</span> 20.2 Recursos</a></li>
+<li><a href="#equipo-de-desarrollo" id="toc-equipo-de-desarrollo"><span
+class="toc-section-number">1.21.3</span> 20.3 Equipo de
+Desarrollo</a></li>
+<li><a href="#licencia" id="toc-licencia"><span
+class="toc-section-number">1.21.4</span> 20.4 Licencia</a></li>
+</ul></li>
+<li><a href="#apéndices" id="toc-apéndices"><span
+class="toc-section-number">1.22</span> Apéndices</a>
+<ul>
+<li><a href="#apéndice-a-glosario-de-términos"
+id="toc-apéndice-a-glosario-de-términos"><span
+class="toc-section-number">1.22.1</span> Apéndice A: Glosario de
+Términos</a></li>
+<li><a href="#apéndice-b-puertos-y-servicios"
+id="toc-apéndice-b-puertos-y-servicios"><span
+class="toc-section-number">1.22.2</span> Apéndice B: Puertos y
+Servicios</a></li>
+<li><a href="#apéndice-c-estructura-de-directorios"
+id="toc-apéndice-c-estructura-de-directorios"><span
+class="toc-section-number">1.22.3</span> Apéndice C: Estructura de
+Directorios</a></li>
+<li><a href="#apéndice-d-variables-de-entorno-completas"
+id="toc-apéndice-d-variables-de-entorno-completas"><span
+class="toc-section-number">1.22.4</span> Apéndice D: Variables de
+Entorno Completas</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+<h1 data-number="1"
+id="ogcore---documentación-técnica-y-funcional"><span
+class="header-section-number">1</span> ogCore - Documentación Técnica y
+Funcional</h1>
+<h2 data-number="1.1" id="tabla-de-contenidos"><span
+class="header-section-number">1.1</span> Tabla de Contenidos</h2>
+<ol type="1">
+<li><a href="#1-introducción">Introducción</a></li>
+<li><a href="#2-descripción-del-proyecto">Descripción del
+Proyecto</a></li>
+<li><a href="#3-arquitectura-del-sistema">Arquitectura del
+Sistema</a></li>
+<li><a href="#4-tecnologías-utilizadas">Tecnologías Utilizadas</a></li>
+<li><a href="#5-requisitos-del-sistema">Requisitos del Sistema</a></li>
+<li><a href="#6-instalación-y-configuración">Instalación y
+Configuración</a></li>
+<li><a href="#7-modelo-de-datos">Modelo de Datos</a></li>
+<li><a href="#8-componentes-del-sistema">Componentes del
+Sistema</a></li>
+<li><a href="#9-api-restful">API RESTful</a></li>
+<li><a href="#10-seguridad-y-autenticación">Seguridad y
+Autenticación</a></li>
+<li><a href="#11-servicios-principales">Servicios Principales</a></li>
+<li><a href="#12-comandos-de-consola">Comandos de Consola</a></li>
+<li><a href="#13-migraciones-de-datos">Migraciones de Datos</a></li>
+<li><a href="#14-testing">Testing</a></li>
+<li><a href="#15-despliegue">Despliegue</a></li>
+<li><a href="#16-mantenimiento-y-operaciones">Mantenimiento y
+Operaciones</a></li>
+<li><a href="#17-integración-con-otros-servicios">Integración con Otros
+Servicios</a></li>
+<li><a href="#18-roadmap-y-changelog">Roadmap y Changelog</a></li>
+<li><a href="#19-contribución">Contribución</a></li>
+<li><a href="#20-soporte-y-contacto">Soporte y Contacto</a></li>
+</ol>
+<hr />
+<h2 data-number="1.2" id="introducción"><span
+class="header-section-number">1.2</span> 1. Introducción</h2>
+<p><strong>ogCore</strong> es el servicio central de
+<strong>OpenGnsys</strong>, una plataforma de código abierto diseñada
+para la gestión centralizada de aulas de informática, laboratorios y
+entornos educativos. Este servicio proporciona una API RESTful robusta
+que permite administrar de manera eficiente clientes (equipos), imágenes
+de sistemas operativos, perfiles de hardware y software, tareas
+programadas, y mucho más.</p>
+<h3 data-number="1.2.1" id="propósito-del-sistema"><span
+class="header-section-number">1.2.1</span> 1.1 Propósito del
+Sistema</h3>
+<p>El propósito principal de ogCore es:</p>
+<ul>
+<li><strong>Centralizar la gestión</strong> de equipos informáticos en
+entornos educativos y corporativos</li>
+<li><strong>Automatizar el despliegue</strong> de sistemas operativos e
+imágenes</li>
+<li><strong>Gestionar inventarios</strong> de hardware y software</li>
+<li><strong>Programar y ejecutar tareas</strong> de manera
+automática</li>
+<li><strong>Proporcionar trazabilidad</strong> de todas las operaciones
+realizadas</li>
+<li><strong>Facilitar la migración</strong> desde versiones anteriores
+de OpenGnsys</li>
+</ul>
+<h3 data-number="1.2.2" id="alcance"><span
+class="header-section-number">1.2.2</span> 1.2 Alcance</h3>
+<p>ogCore gestiona: - Clientes (equipos físicos) - Imágenes de sistemas
+operativos - Repositorios de imágenes - Perfiles de hardware y software
+- Unidades organizativas (aulas, grupos) - Redes y subredes - Plantillas
+PXE - Menús de arranque - Comandos y tareas programadas - Trazas de
+ejecución - Calendarios remotos - Integración con sistemas externos
+(UDS, ogRepository, ogDhcp, ogBoot)</p>
+<hr />
+<h2 data-number="1.3" id="descripción-del-proyecto"><span
+class="header-section-number">1.3</span> 2. Descripción del
+Proyecto</h2>
+<h3 data-number="1.3.1" id="qué-es-ogcore"><span
+class="header-section-number">1.3.1</span> 2.1 ¿Qué es ogCore?</h3>
+<p>ogCore es el núcleo central de OpenGnsys desarrollado con tecnologías
+modernas de PHP. Actúa como backend que expone una API RESTful completa,
+permitiendo la gestión de todos los aspectos relacionados con la
+administración de aulas informáticas.</p>
+<h3 data-number="1.3.2" id="características-principales"><span
+class="header-section-number">1.3.2</span> 2.2 Características
+Principales</h3>
+<ul>
+<li><strong>API RESTful completa</strong> con documentación
+Swagger/OpenAPI</li>
+<li><strong>Autenticación JWT</strong> con refresh tokens</li>
+<li><strong>Arquitectura basada en eventos</strong> con notificaciones
+en tiempo real (Mercure)</li>
+<li><strong>Sistema de colas</strong> para la ejecución de tareas
+programadas</li>
+<li><strong>Integración con múltiples servicios</strong> externos</li>
+<li><strong>Migraciones automatizadas</strong> desde OpenGnsys 1.1</li>
+<li><strong>Versionado de imágenes</strong> con integración Git</li>
+<li><strong>Sistema de trazabilidad</strong> completo</li>
+<li><strong>Gestión de hardware</strong> con inventario automático</li>
+<li><strong>Despliegues masivos</strong> de imágenes (unicast,
+multicast, torrent, p2p)</li>
+<li><strong>Gestión de particiones</strong> automática</li>
+<li><strong>Sistema de validación</strong> robusto</li>
+</ul>
+<h3 data-number="1.3.3" id="versión-actual"><span
+class="header-section-number">1.3.3</span> 2.3 Versión Actual</h3>
+<ul>
+<li><strong>Versión</strong>: 0.5.0</li>
+<li><strong>Estado</strong>: En desarrollo activo</li>
+<li><strong>Última actualización</strong>: Octubre 2025</li>
+</ul>
+<hr />
+<h2 data-number="1.4" id="arquitectura-del-sistema"><span
+class="header-section-number">1.4</span> 3. Arquitectura del
+Sistema</h2>
+<h3 data-number="1.4.1" id="arquitectura-general"><span
+class="header-section-number">1.4.1</span> 3.1 Arquitectura General</h3>
+<p>ogCore sigue una arquitectura de <strong>microservicios</strong>
+basada en el patrón <strong>API-First</strong>:</p>
+<pre><code>┌─────────────────────────────────────────────────────────────┐
+│                      Frontend (Web UI)                       │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         │ HTTP/REST
+                         │
+┌────────────────────────▼────────────────────────────────────┐
+│                     ogCore API (Symfony)                     │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │  Controllers │ States │ DTOs │ Validators │ Filters  │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │              Business Logic (Services)                │   │
+│  └──────────────────────────────────────────────────────┘   │
+│  ┌──────────────────────────────────────────────────────┐   │
+│  │        Entities │ Repositories │ Doctrine ORM         │   │
+│  └──────────────────────────────────────────────────────┘   │
+└────────────────────┬───────────────┬───────────────────────┘
+                     │               │
+         ┌───────────▼──┐    ┌──────▼──────┐
+         │   MariaDB    │    │   Mercure   │
+         │   Database   │    │  (WebSocket)│
+         └──────────────┘    └─────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│              Servicios Externos Integrados                   │
+├──────────────┬──────────────┬──────────────┬────────────────┤
+│  ogRepository│   ogDhcp     │   ogBoot     │   UDS/Git      │
+└──────────────┴──────────────┴──────────────┴────────────────┘</code></pre>
+<h3 data-number="1.4.2" id="capas-de-la-aplicación"><span
+class="header-section-number">1.4.2</span> 3.2 Capas de la
+Aplicación</h3>
+<h4 data-number="1.4.2.1" id="capa-de-presentación-api"><span
+class="header-section-number">1.4.2.1</span> 3.2.1 Capa de Presentación
+(API)</h4>
+<ul>
+<li><strong>API Platform</strong>: Framework para crear APIs REST</li>
+<li><strong>Controllers</strong>: Controladores personalizados (102
+controladores)</li>
+<li><strong>DTOs (Data Transfer Objects)</strong>: 93 objetos de
+transferencia de datos</li>
+<li><strong>OpenAPI/Swagger</strong>: Documentación automática de la
+API</li>
+</ul>
+<h4 data-number="1.4.2.2" id="capa-de-negocio"><span
+class="header-section-number">1.4.2.2</span> 3.2.2 Capa de Negocio</h4>
+<ul>
+<li><strong>Services</strong>: Lógica de negocio (13 servicios
+principales)</li>
+<li><strong>Handlers</strong>: Manejadores de eventos (2 handlers)</li>
+<li><strong>EventSubscribers</strong>: Suscriptores de eventos (8
+suscriptores)</li>
+<li><strong>Validators</strong>: Validadores personalizados (18
+validadores)</li>
+</ul>
+<h4 data-number="1.4.2.3" id="capa-de-datos"><span
+class="header-section-number">1.4.2.3</span> 3.2.3 Capa de Datos</h4>
+<ul>
+<li><strong>Entities</strong>: 35 entidades del modelo de datos</li>
+<li><strong>Repositories</strong>: 32 repositorios personalizados</li>
+<li><strong>Doctrine ORM</strong>: Mapeo objeto-relacional</li>
+<li><strong>Migrations</strong>: 85 migraciones de base de datos</li>
+</ul>
+<h4 data-number="1.4.2.4" id="capa-de-infraestructura"><span
+class="header-section-number">1.4.2.4</span> 3.2.4 Capa de
+Infraestructura</h4>
+<ul>
+<li><strong>Docker</strong>: Contenedorización de servicios</li>
+<li><strong>Nginx</strong>: Servidor web reverse proxy</li>
+<li><strong>PHP-FPM</strong>: Procesador de PHP</li>
+<li><strong>MariaDB</strong>: Sistema de gestión de base de datos</li>
+<li><strong>Mercure</strong>: Sistema de notificaciones en tiempo
+real</li>
+</ul>
+<h3 data-number="1.4.3" id="patrones-de-diseño-utilizados"><span
+class="header-section-number">1.4.3</span> 3.3 Patrones de Diseño
+Utilizados</h3>
+<ol type="1">
+<li><strong>Repository Pattern</strong>: Para abstracción de acceso a
+datos</li>
+<li><strong>DTO Pattern</strong>: Para transferencia de datos entre
+capas</li>
+<li><strong>Factory Pattern</strong>: Para creación de entidades
+complejas</li>
+<li><strong>Event-Driven Architecture</strong>: Para notificaciones y
+reactividad</li>
+<li><strong>State Pattern</strong>: Para gestión de estados de
+procesamiento</li>
+<li><strong>Service Layer</strong>: Para encapsulación de lógica de
+negocio</li>
+</ol>
+<hr />
+<h2 data-number="1.5" id="tecnologías-utilizadas"><span
+class="header-section-number">1.5</span> 4. Tecnologías Utilizadas</h2>
+<h3 data-number="1.5.1" id="backend"><span
+class="header-section-number">1.5.1</span> 4.1 Backend</h3>
+<table>
+<colgroup>
+<col style="width: 37%" />
+<col style="width: 28%" />
+<col style="width: 34%" />
+</colgroup>
+<thead>
+<tr class="header">
+<th>Tecnología</th>
+<th>Versión</th>
+<th>Propósito</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td><strong>PHP</strong></td>
+<td>8.3</td>
+<td>Lenguaje de programación principal</td>
+</tr>
+<tr class="even">
+<td><strong>Symfony</strong></td>
+<td>6.4</td>
+<td>Framework web principal</td>
+</tr>
+<tr class="odd">
+<td><strong>Doctrine ORM</strong></td>
+<td>2.19</td>
+<td>Mapeo objeto-relacional</td>
+</tr>
+<tr class="even">
+<td><strong>API Platform</strong></td>
+<td>3.2</td>
+<td>Creación de APIs REST</td>
+</tr>
+<tr class="odd">
+<td><strong>Lexik JWT</strong></td>
+<td>3.0</td>
+<td>Autenticación JWT</td>
+</tr>
+<tr class="even">
+<td><strong>Gesdinet JWT Refresh Token</strong></td>
+<td>1.3</td>
+<td>Refresh tokens</td>
+</tr>
+<tr class="odd">
+<td><strong>Stof Doctrine Extensions</strong></td>
+<td>1.10</td>
+<td>Extensiones de Doctrine (timestampable, etc.)</td>
+</tr>
+<tr class="even">
+<td><strong>Ramsey UUID</strong></td>
+<td>2.0</td>
+<td>Generación de UUIDs</td>
+</tr>
+</tbody>
+</table>
+<h3 data-number="1.5.2" id="base-de-datos"><span
+class="header-section-number">1.5.2</span> 4.2 Base de Datos</h3>
+<table>
+<thead>
+<tr class="header">
+<th>Tecnología</th>
+<th>Versión</th>
+<th>Propósito</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td><strong>MariaDB</strong></td>
+<td>10.11</td>
+<td>Sistema de gestión de base de datos</td>
+</tr>
+<tr class="even">
+<td><strong>Doctrine DBAL</strong></td>
+<td>3.x</td>
+<td>Capa de abstracción de base de datos</td>
+</tr>
+<tr class="odd">
+<td><strong>Doctrine Migrations</strong></td>
+<td>3.3</td>
+<td>Gestión de migraciones</td>
+</tr>
+</tbody>
+</table>
+<h3 data-number="1.5.3" id="infraestructura"><span
+class="header-section-number">1.5.3</span> 4.3 Infraestructura</h3>
+<table>
+<thead>
+<tr class="header">
+<th>Tecnología</th>
+<th>Versión</th>
+<th>Propósito</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td><strong>Docker</strong></td>
+<td>Latest</td>
+<td>Contenedorización</td>
+</tr>
+<tr class="even">
+<td><strong>Docker Compose</strong></td>
+<td>Latest</td>
+<td>Orquestación de contenedores</td>
+</tr>
+<tr class="odd">
+<td><strong>Nginx</strong></td>
+<td>Latest</td>
+<td>Servidor web / Reverse proxy</td>
+</tr>
+<tr class="even">
+<td><strong>PHP-FPM</strong></td>
+<td>8.3</td>
+<td>Procesador FastCGI</td>
+</tr>
+<tr class="odd">
+<td><strong>Mercure</strong></td>
+<td>0.3.9</td>
+<td>Hub de notificaciones en tiempo real</td>
+</tr>
+</tbody>
+</table>
+<h3 data-number="1.5.4" id="testing"><span
+class="header-section-number">1.5.4</span> 4.4 Testing</h3>
+<table>
+<thead>
+<tr class="header">
+<th>Tecnología</th>
+<th>Versión</th>
+<th>Propósito</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td><strong>PHPUnit</strong></td>
+<td>9.5</td>
+<td>Framework de testing</td>
+</tr>
+<tr class="even">
+<td><strong>Symfony PHPUnit Bridge</strong></td>
+<td>7.0</td>
+<td>Integración con Symfony</td>
+</tr>
+<tr class="odd">
+<td><strong>DAMA Doctrine Test Bundle</strong></td>
+<td>8.1</td>
+<td>Transacciones de prueba</td>
+</tr>
+<tr class="even">
+<td><strong>Zenstruck Foundry</strong></td>
+<td>1.37</td>
+<td>Factories para testing</td>
+</tr>
+</tbody>
+</table>
+<h3 data-number="1.5.5" id="desarrollo"><span
+class="header-section-number">1.5.5</span> 4.5 Desarrollo</h3>
+<table>
+<thead>
+<tr class="header">
+<th>Tecnología</th>
+<th>Versión</th>
+<th>Propósito</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td><strong>Symfony Maker Bundle</strong></td>
+<td>1.59</td>
+<td>Generación de código</td>
+</tr>
+<tr class="even">
+<td><strong>Symfony Web Profiler</strong></td>
+<td>6.4</td>
+<td>Debugging y profiling</td>
+</tr>
+<tr class="odd">
+<td><strong>Monolog</strong></td>
+<td>3.x</td>
+<td>Logging</td>
+</tr>
+<tr class="even">
+<td><strong>PHPStan</strong></td>
+<td>Latest</td>
+<td>Análisis estático</td>
+</tr>
+</tbody>
+</table>
+<hr />
+<h2 data-number="1.6" id="requisitos-del-sistema"><span
+class="header-section-number">1.6</span> 5. Requisitos del Sistema</h2>
+<h3 data-number="1.6.1" id="requisitos-de-hardware-producción"><span
+class="header-section-number">1.6.1</span> 5.1 Requisitos de Hardware
+(Producción)</h3>
+<ul>
+<li><strong>CPU</strong>: Mínimo 4 cores, recomendado 8+ cores</li>
+<li><strong>RAM</strong>: Mínimo 8GB, recomendado 16GB+</li>
+<li><strong>Disco</strong>:
+<ul>
+<li>Sistema: 20GB SSD</li>
+<li>Base de datos: 50GB+ SSD</li>
+<li>Logs: 10GB</li>
+</ul></li>
+<li><strong>Red</strong>: 1Gbps mínimo</li>
+</ul>
+<h3 data-number="1.6.2" id="requisitos-de-software"><span
+class="header-section-number">1.6.2</span> 5.2 Requisitos de
+Software</h3>
+<ul>
+<li><strong>Sistema Operativo</strong>: Linux (Ubuntu 20.04+, Debian
+11+, CentOS 8+)</li>
+<li><strong>Docker</strong>: &gt;= 20.10</li>
+<li><strong>Docker Compose</strong>: &gt;= 2.0</li>
+<li><strong>Git</strong>: &gt;= 2.25 (para gestión de código)</li>
+</ul>
+<h3 data-number="1.6.3" id="puertos-requeridos"><span
+class="header-section-number">1.6.3</span> 5.3 Puertos Requeridos</h3>
+<table>
+<thead>
+<tr class="header">
+<th>Puerto</th>
+<th>Servicio</th>
+<th>Propósito</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td>8080</td>
+<td>Nginx/HTTP</td>
+<td>API y documentación</td>
+</tr>
+<tr class="even">
+<td>3306</td>
+<td>MariaDB</td>
+<td>Base de datos</td>
+</tr>
+<tr class="odd">
+<td>9000</td>
+<td>PHP-FPM</td>
+<td>Procesador PHP</td>
+</tr>
+<tr class="even">
+<td>3000</td>
+<td>Mercure</td>
+<td>WebSocket/SSE</td>
+</tr>
+</tbody>
+</table>
+<hr />
+<h2 data-number="1.7" id="instalación-y-configuración"><span
+class="header-section-number">1.7</span> 6. Instalación y
+Configuración</h2>
+<h3 data-number="1.7.1" id="instalación-con-docker-recomendado"><span
+class="header-section-number">1.7.1</span> 6.1 Instalación con Docker
+(Recomendado)</h3>
+<h4 data-number="1.7.1.1" id="clonar-el-repositorio"><span
+class="header-section-number">1.7.1.1</span> 6.1.1 Clonar el
+Repositorio</h4>
+<div class="sourceCode" id="cb2"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="fu">git</span> clone <span class="op">&lt;</span>url-del-repositorio<span class="op">&gt;</span> ogcore</span>
+<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a><span class="bu">cd</span> ogcore</span></code></pre></div>
+<h4 data-number="1.7.1.2" id="verificar-puertos-disponibles"><span
+class="header-section-number">1.7.1.2</span> 6.1.2 Verificar Puertos
+Disponibles</h4>
+<p>Asegúrate de que los puertos 8080 y 3306 no estén en uso:</p>
+<div class="sourceCode" id="cb3"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> lsof <span class="at">-i</span> :8080</span>
+<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> lsof <span class="at">-i</span> :3306</span></code></pre></div>
+<h4 data-number="1.7.1.3" id="desplegar-contenedores"><span
+class="header-section-number">1.7.1.3</span> 6.1.3 Desplegar
+Contenedores</h4>
+<div class="sourceCode" id="cb4"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> compose up <span class="at">--build</span> <span class="at">-d</span></span></code></pre></div>
+<h4 data-number="1.7.1.4" id="verificar-contenedores"><span
+class="header-section-number">1.7.1.4</span> 6.1.4 Verificar
+Contenedores</h4>
+<div class="sourceCode" id="cb5"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> ps</span></code></pre></div>
+<p>Deberías ver tres contenedores activos: - <code>ogcore-nginx</code> -
+<code>ogcore-php</code> - <code>ogcore-database</code></p>
+<h4 data-number="1.7.1.5" id="instalar-dependencias"><span
+class="header-section-number">1.7.1.5</span> 6.1.5 Instalar
+Dependencias</h4>
+<div class="sourceCode" id="cb6"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php composer install</span></code></pre></div>
+<h4 data-number="1.7.1.6" id="generar-claves-jwt"><span
+class="header-section-number">1.7.1.6</span> 6.1.6 Generar Claves
+JWT</h4>
+<div class="sourceCode" id="cb7"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console lexik:jwt:generate-keypair <span class="at">--overwrite</span></span></code></pre></div>
+<h4 data-number="1.7.1.7" id="inicializar-base-de-datos"><span
+class="header-section-number">1.7.1.7</span> 6.1.7 Inicializar Base de
+Datos</h4>
+<div class="sourceCode" id="cb8"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Ejecutar migraciones</span></span>
+<span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:migrations:migrate <span class="at">--no-interaction</span></span>
+<span id="cb8-3"><a href="#cb8-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb8-4"><a href="#cb8-4" aria-hidden="true" tabindex="-1"></a><span class="co"># Cargar datos iniciales (fixtures)</span></span>
+<span id="cb8-5"><a href="#cb8-5" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:fixtures:load <span class="at">--no-interaction</span></span>
+<span id="cb8-6"><a href="#cb8-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb8-7"><a href="#cb8-7" aria-hidden="true" tabindex="-1"></a><span class="co"># Cargar grupos de usuarios por defecto</span></span>
+<span id="cb8-8"><a href="#cb8-8" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console app:load-default-user-groups</span>
+<span id="cb8-9"><a href="#cb8-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb8-10"><a href="#cb8-10" aria-hidden="true" tabindex="-1"></a><span class="co"># Cargar comandos por defecto</span></span>
+<span id="cb8-11"><a href="#cb8-11" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console app:load-default-commands</span></code></pre></div>
+<h4 data-number="1.7.1.8" id="acceder-a-la-aplicación"><span
+class="header-section-number">1.7.1.8</span> 6.1.8 Acceder a la
+Aplicación</h4>
+<p>Abre tu navegador y accede a:</p>
+<pre><code>http://127.0.0.1:8080/docs</code></pre>
+<p>Deberías ver la documentación Swagger de la API de ogCore.</p>
+<h3 data-number="1.7.2" id="configuración"><span
+class="header-section-number">1.7.2</span> 6.2 Configuración</h3>
+<h4 data-number="1.7.2.1" id="variables-de-entorno"><span
+class="header-section-number">1.7.2.1</span> 6.2.1 Variables de
+Entorno</h4>
+<p>El archivo <code>.env</code> contiene las variables de configuración
+principales:</p>
+<div class="sourceCode" id="cb10"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Entorno</span></span>
+<span id="cb10-2"><a href="#cb10-2" aria-hidden="true" tabindex="-1"></a><span class="va">APP_ENV</span><span class="op">=</span>dev</span>
+<span id="cb10-3"><a href="#cb10-3" aria-hidden="true" tabindex="-1"></a><span class="va">APP_SECRET</span><span class="op">=&lt;</span>tu-secreto<span class="op">&gt;</span></span>
+<span id="cb10-4"><a href="#cb10-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb10-5"><a href="#cb10-5" aria-hidden="true" tabindex="-1"></a><span class="co"># Base de datos</span></span>
+<span id="cb10-6"><a href="#cb10-6" aria-hidden="true" tabindex="-1"></a><span class="va">DATABASE_URL</span><span class="op">=</span><span class="st">&quot;mysql://user:password@ogcore-database:3306/ogcore&quot;</span></span>
+<span id="cb10-7"><a href="#cb10-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb10-8"><a href="#cb10-8" aria-hidden="true" tabindex="-1"></a><span class="co"># JWT</span></span>
+<span id="cb10-9"><a href="#cb10-9" aria-hidden="true" tabindex="-1"></a><span class="va">JWT_SECRET_KEY</span><span class="op">=</span>%kernel.project_dir%/config/jwt/private.pem</span>
+<span id="cb10-10"><a href="#cb10-10" aria-hidden="true" tabindex="-1"></a><span class="va">JWT_PUBLIC_KEY</span><span class="op">=</span>%kernel.project_dir%/config/jwt/public.pem</span>
+<span id="cb10-11"><a href="#cb10-11" aria-hidden="true" tabindex="-1"></a><span class="va">JWT_PASSPHRASE</span><span class="op">=&lt;</span>tu-passphrase<span class="op">&gt;</span></span>
+<span id="cb10-12"><a href="#cb10-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb10-13"><a href="#cb10-13" aria-hidden="true" tabindex="-1"></a><span class="co"># Mercure</span></span>
+<span id="cb10-14"><a href="#cb10-14" aria-hidden="true" tabindex="-1"></a><span class="va">MERCURE_URL</span><span class="op">=</span>http://mercure:3000/.well-known/mercure</span>
+<span id="cb10-15"><a href="#cb10-15" aria-hidden="true" tabindex="-1"></a><span class="va">MERCURE_PUBLIC_URL</span><span class="op">=</span>http://127.0.0.1:8080/.well-known/mercure</span>
+<span id="cb10-16"><a href="#cb10-16" aria-hidden="true" tabindex="-1"></a><span class="va">MERCURE_JWT_SECRET</span><span class="op">=&lt;</span>tu-secreto-mercure<span class="op">&gt;</span></span>
+<span id="cb10-17"><a href="#cb10-17" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb10-18"><a href="#cb10-18" aria-hidden="true" tabindex="-1"></a><span class="co"># Servicios externos</span></span>
+<span id="cb10-19"><a href="#cb10-19" aria-hidden="true" tabindex="-1"></a><span class="va">REMOTE_PC_URL</span><span class="op">=&lt;</span>url-uds<span class="op">&gt;</span></span>
+<span id="cb10-20"><a href="#cb10-20" aria-hidden="true" tabindex="-1"></a><span class="va">REMOTE_PC_AUTH_LOGIN</span><span class="op">=&lt;</span>login<span class="op">&gt;</span></span>
+<span id="cb10-21"><a href="#cb10-21" aria-hidden="true" tabindex="-1"></a><span class="va">REMOTE_PC_AUTH_USERNAME</span><span class="op">=&lt;</span>username<span class="op">&gt;</span></span>
+<span id="cb10-22"><a href="#cb10-22" aria-hidden="true" tabindex="-1"></a><span class="va">REMOTE_PC_AUTH_PASSWORD</span><span class="op">=&lt;</span>password<span class="op">&gt;</span></span>
+<span id="cb10-23"><a href="#cb10-23" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb10-24"><a href="#cb10-24" aria-hidden="true" tabindex="-1"></a><span class="co"># SSL/TLS</span></span>
+<span id="cb10-25"><a href="#cb10-25" aria-hidden="true" tabindex="-1"></a><span class="va">SSL_ENABLED</span><span class="op">=</span>false</span></code></pre></div>
+<h4 data-number="1.7.2.2" id="configuración-de-cors"><span
+class="header-section-number">1.7.2.2</span> 6.2.2 Configuración de
+CORS</h4>
+<p>Edita <code>config/packages/nelmio_cors.yaml</code> para configurar
+CORS según tus necesidades.</p>
+<h4 data-number="1.7.2.3" id="configuración-de-api-platform"><span
+class="header-section-number">1.7.2.3</span> 6.2.3 Configuración de API
+Platform</h4>
+<p>La configuración de API Platform se encuentra en
+<code>config/packages/api_platform.yaml</code>.</p>
+<h3 data-number="1.7.3" id="instalación-en-producción"><span
+class="header-section-number">1.7.3</span> 6.3 Instalación en
+Producción</h3>
+<p>Para entornos de producción, utiliza el archivo
+<code>docker-compose-deploy.yml</code>:</p>
+<div class="sourceCode" id="cb11"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> compose <span class="at">-f</span> docker-compose-deploy.yml up <span class="at">-d</span></span></code></pre></div>
+<p>Asegúrate de: - Cambiar todas las contraseñas por defecto -
+Configurar SSL/TLS - Configurar backups automáticos de base de datos -
+Configurar monitoreo y alertas - Revisar los límites de recursos de
+Docker</p>
+<hr />
+<h2 data-number="1.8" id="modelo-de-datos"><span
+class="header-section-number">1.8</span> 7. Modelo de Datos</h2>
+<h3 data-number="1.8.1" id="diagrama-de-entidades"><span
+class="header-section-number">1.8.1</span> 7.1 Diagrama de
+Entidades</h3>
+<p>El sistema cuenta con 35 entidades principales agrupadas en los
+siguientes dominios:</p>
+<h3 data-number="1.8.2" id="entidades-principales"><span
+class="header-section-number">1.8.2</span> 7.2 Entidades
+Principales</h3>
+<h4 data-number="1.8.2.1" id="client-cliente"><span
+class="header-section-number">1.8.2.1</span> 7.2.1 Client (Cliente)</h4>
+<p>Representa un equipo físico en el sistema.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre del cliente - <code>serialNumber</code>:
+Número de serie - <code>mac</code>: Dirección MAC (única) -
+<code>ip</code>: Dirección IP (única) - <code>status</code>: Estado del
+cliente (active, inactive, busy, windows, linux, etc.) -
+<code>netiface</code>: Interfaz de red - <code>netDriver</code>: Driver
+de red - <code>validation</code>: Estado de validación -
+<code>maintenance</code>: Modo mantenimiento - <code>position</code>:
+Posición en el aula (x, y) - <code>firmwareType</code>: Tipo de firmware
+(BIOS/UEFI) - <code>agentJobId</code>: ID del trabajo del agente en
+ejecución - <code>pxeSync</code>: Sincronización PXE -
+<code>token</code>: Token de autenticación del cliente</p>
+<p><strong>Relaciones:</strong> - <code>organizationalUnit</code>:
+Pertenece a una unidad organizativa (aula/grupo) -
+<code>partitions</code>: Tiene múltiples particiones -
+<code>menu</code>: Menú de arranque asignado -
+<code>hardwareProfile</code>: Perfil de hardware asociado -
+<code>template</code>: Plantilla PXE asignada - <code>repository</code>:
+Repositorio de imágenes - <code>subnet</code>: Subred a la que pertenece
+- <code>ogLive</code>: Imagen Live asignada</p>
+<h4 data-number="1.8.2.2"
+id="organizationalunit-unidad-organizativa"><span
+class="header-section-number">1.8.2.2</span> 7.2.2 OrganizationalUnit
+(Unidad Organizativa)</h4>
+<p>Representa aulas o grupos de equipos.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre de la unidad - <code>description</code>:
+Descripción - <code>type</code>: Tipo (aula, grupo, etc.)</p>
+<p><strong>Relaciones:</strong> - <code>parent</code>: Unidad
+organizativa padre (jerarquía) - <code>children</code>: Unidades hijas -
+<code>clients</code>: Clientes pertenecientes -
+<code>networkSettings</code>: Configuración de red heredable -
+<code>remoteCalendar</code>: Calendario remoto asociado</p>
+<h4 data-number="1.8.2.3" id="image-imagen"><span
+class="header-section-number">1.8.2.3</span> 7.2.3 Image (Imagen)</h4>
+<p>Representa una imagen de sistema operativo.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre de la imagen - <code>description</code>:
+Descripción - <code>type</code>: Tipo de imagen - <code>size</code>:
+Tamaño en bytes - <code>partition</code>: Partición de origen -
+<code>status</code>: Estado (creating, success, failed, etc.) -
+<code>isGlobal</code>: Imagen global compartida -
+<code>isVirtual</code>: Imagen virtual - <code>version</code>: Versión
+de la imagen</p>
+<p><strong>Relaciones:</strong> - <code>operativeSystem</code>: Sistema
+operativo - <code>softwareProfile</code>: Perfil de software -
+<code>repositories</code>: Repositorios que contienen la imagen -
+<code>originClient</code>: Cliente origen de la imagen</p>
+<h4 data-number="1.8.2.4" id="command-comando"><span
+class="header-section-number">1.8.2.4</span> 7.2.4 Command
+(Comando)</h4>
+<p>Comandos ejecutables en el sistema.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre del comando - <code>description</code>:
+Descripción - <code>script</code>: Script a ejecutar</p>
+<p><strong>Relaciones:</strong> - <code>commandGroups</code>: Grupos de
+comandos a los que pertenece</p>
+<h4 data-number="1.8.2.5" id="commandtask-tarea-de-comando"><span
+class="header-section-number">1.8.2.5</span> 7.2.5 CommandTask (Tarea de
+Comando)</h4>
+<p>Tarea programada para ejecutar comandos.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>datetime</code>: Fecha y hora de ejecución -
+<code>parameters</code>: Parámetros de ejecución - <code>status</code>:
+Estado de la tarea</p>
+<p><strong>Relaciones:</strong> - <code>commands</code>: Comandos a
+ejecutar - <code>commandGroups</code>: Grupos de comandos -
+<code>clients</code>: Clientes objetivo - <code>schedule</code>:
+Programación recurrente</p>
+<h4 data-number="1.8.2.6" id="trace-traza"><span
+class="header-section-number">1.8.2.6</span> 7.2.6 Trace (Traza)</h4>
+<p>Registro de ejecución de comandos.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>command</code>: Nombre del comando ejecutado - <code>input</code>:
+Parámetros de entrada - <code>output</code>: Resultado de ejecución -
+<code>status</code>: Estado (pending, processing, success, failed,
+cancelled) - <code>executedAt</code>: Fecha de ejecución -
+<code>finishedAt</code>: Fecha de finalización - <code>cancelled</code>:
+Indica si fue cancelada - <code>jobId</code>: ID del trabajo en el
+agente</p>
+<p><strong>Relaciones:</strong> - <code>client</code>: Cliente donde se
+ejecutó</p>
+<h4 data-number="1.8.2.7" id="hardwareprofile-perfil-de-hardware"><span
+class="header-section-number">1.8.2.7</span> 7.2.7 HardwareProfile
+(Perfil de Hardware)</h4>
+<p>Inventario de hardware de un cliente.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>cpu</code>: Información de CPU - <code>ram</code>: Memoria RAM -
+<code>storage</code>: Almacenamiento - <code>networkCards</code>:
+Tarjetas de red</p>
+<p><strong>Relaciones:</strong> - <code>client</code>: Cliente asociado
+- <code>hardwareTypes</code>: Tipos de hardware detectados</p>
+<h4 data-number="1.8.2.8" id="softwareprofile-perfil-de-software"><span
+class="header-section-number">1.8.2.8</span> 7.2.8 SoftwareProfile
+(Perfil de Software)</h4>
+<p>Software instalado en una imagen.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre del perfil</p>
+<p><strong>Relaciones:</strong> - <code>software</code>: Software
+incluido - <code>images</code>: Imágenes que usan este perfil</p>
+<h4 data-number="1.8.2.9"
+id="imagerepository-repositorio-de-imágenes"><span
+class="header-section-number">1.8.2.9</span> 7.2.9 ImageRepository
+(Repositorio de Imágenes)</h4>
+<p>Servidor de almacenamiento de imágenes.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre del repositorio (único) - <code>ip</code>:
+Dirección IP o DNS (único) - <code>port</code>: Puerto -
+<code>sshPort</code>: Puerto SSH - <code>sshUser</code>: Usuario SSH -
+<code>apiKey</code>: Clave API - <code>status</code>: Estado del
+repositorio</p>
+<p><strong>Relaciones:</strong> - <code>images</code>: Imágenes
+almacenadas</p>
+<h4 data-number="1.8.2.10" id="subnet-subred"><span
+class="header-section-number">1.8.2.10</span> 7.2.10 Subnet
+(Subred)</h4>
+<p>Configuración de red.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre de la subred - <code>cidr</code>: Notación
+CIDR - <code>gateway</code>: Puerta de enlace - <code>dns</code>:
+Servidores DNS - <code>dhcpStart</code>: Inicio rango DHCP -
+<code>dhcpEnd</code>: Fin rango DHCP</p>
+<p><strong>Relaciones:</strong> - <code>clients</code>: Clientes en la
+subred</p>
+<h4 data-number="1.8.2.11" id="partition-partición"><span
+class="header-section-number">1.8.2.11</span> 7.2.11 Partition
+(Partición)</h4>
+<p>Partición de disco de un cliente.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>partitionNumber</code>: Número de partición -
+<code>partitionType</code>: Tipo de partición -
+<code>partitionSize</code>: Tamaño - <code>partitionCode</code>: Código
+de partición - <code>usedSize</code>: Tamaño usado -
+<code>filesystem</code>: Sistema de archivos</p>
+<p><strong>Relaciones:</strong> - <code>client</code>: Cliente
+propietario - <code>image</code>: Imagen desplegada -
+<code>operativeSystem</code>: Sistema operativo instalado</p>
+<h4 data-number="1.8.2.12" id="pxetemplate-plantilla-pxe"><span
+class="header-section-number">1.8.2.12</span> 7.2.12 PxeTemplate
+(Plantilla PXE)</h4>
+<p>Plantilla de arranque PXE.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre de la plantilla - <code>content</code>:
+Contenido de la plantilla - <code>default</code>: Plantilla por
+defecto</p>
+<p><strong>Relaciones:</strong> - <code>clients</code>: Clientes que
+usan la plantilla</p>
+<h4 data-number="1.8.2.13" id="remotecalendar-calendario-remoto"><span
+class="header-section-number">1.8.2.13</span> 7.2.13 RemoteCalendar
+(Calendario Remoto)</h4>
+<p>Integración con sistemas de reservas remotas.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre del calendario - <code>url</code>: URL del
+servicio - <code>available</code>: Disponibilidad</p>
+<p><strong>Relaciones:</strong> - <code>organizationalUnits</code>:
+Unidades organizativas asociadas - <code>rules</code>: Reglas del
+calendario</p>
+<h4 data-number="1.8.2.14" id="user-usuario"><span
+class="header-section-number">1.8.2.14</span> 7.2.14 User (Usuario)</h4>
+<p>Usuario del sistema.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>username</code>: Nombre de usuario (único) -
+<code>password</code>: Contraseña (hasheada) - <code>email</code>:
+Correo electrónico - <code>roles</code>: Roles del usuario</p>
+<p><strong>Relaciones:</strong> - <code>userGroups</code>: Grupos de
+usuarios - <code>view</code>: Vista preferida</p>
+<h4 data-number="1.8.2.15" id="gitrepository-repositorio-git"><span
+class="header-section-number">1.8.2.15</span> 7.2.15 GitRepository
+(Repositorio Git)</h4>
+<p>Repositorio Git para versionado de imágenes.</p>
+<p><strong>Campos principales:</strong> - <code>id</code>: UUID único -
+<code>name</code>: Nombre del repositorio - <code>url</code>: URL del
+repositorio - <code>branch</code>: Rama - <code>credentials</code>:
+Credenciales de acceso</p>
+<h3 data-number="1.8.3" id="índices-y-optimizaciones"><span
+class="header-section-number">1.8.3</span> 7.3 Índices y
+Optimizaciones</h3>
+<p>La base de datos está optimizada con índices en: - Campos de búsqueda
+frecuente (status, updatedAt) - Campos únicos (IP, MAC, username) -
+Claves foráneas - Índices compuestos para consultas complejas</p>
+<hr />
+<h2 data-number="1.9" id="componentes-del-sistema"><span
+class="header-section-number">1.9</span> 8. Componentes del Sistema</h2>
+<h3 data-number="1.9.1" id="controllers-controladores"><span
+class="header-section-number">1.9.1</span> 8.1 Controllers
+(Controladores)</h3>
+<p>El sistema cuenta con <strong>102 controladores</strong> organizados
+por dominio:</p>
+<h4 data-number="1.9.1.1" id="controladores-principales"><span
+class="header-section-number">1.9.1.1</span> Controladores
+principales:</h4>
+<ul>
+<li><strong>ClientController</strong>: Gestión de clientes</li>
+<li><strong>ImageController</strong>: Gestión de imágenes</li>
+<li><strong>OrganizationalUnitController</strong>: Gestión de unidades
+organizativas</li>
+<li><strong>CommandController</strong>: Gestión de comandos</li>
+<li><strong>TraceController</strong>: Gestión de trazas</li>
+<li><strong>UserController</strong>: Gestión de usuarios</li>
+<li><strong>SubnetController</strong>: Gestión de subredes</li>
+<li><strong>RepositoryController</strong>: Gestión de repositorios</li>
+</ul>
+<h3 data-number="1.9.2" id="states-procesadores-de-estado"><span
+class="header-section-number">1.9.2</span> 8.2 States (Procesadores de
+Estado)</h3>
+<p>Los States implementan el patrón State de API Platform:</p>
+<h4 data-number="1.9.2.1" id="states-principales-55-procesadores"><span
+class="header-section-number">1.9.2.1</span> States principales (55
+procesadores):</h4>
+<ul>
+<li><strong>Providers</strong>: Obtención de datos</li>
+<li><strong>Processors</strong>: Procesamiento de escritura</li>
+<li><strong>Custom States</strong>: Lógica personalizada</li>
+</ul>
+<h3 data-number="1.9.3" id="dtos-data-transfer-objects"><span
+class="header-section-number">1.9.3</span> 8.3 DTOs (Data Transfer
+Objects)</h3>
+<p><strong>93 DTOs</strong> para transferencia de datos:</p>
+<h4 data-number="1.9.3.1" id="tipos-de-dtos"><span
+class="header-section-number">1.9.3.1</span> Tipos de DTOs:</h4>
+<ul>
+<li><strong>Input DTOs</strong>: Para recepción de datos</li>
+<li><strong>Output DTOs</strong>: Para envío de datos</li>
+<li><strong>Transformation DTOs</strong>: Para transformaciones</li>
+</ul>
+<h3 data-number="1.9.4" id="validators-validadores"><span
+class="header-section-number">1.9.4</span> 8.4 Validators
+(Validadores)</h3>
+<p><strong>18 validadores personalizados</strong> para: - Validación de
+IPs y MACs - Validación de rangos DHCP - Validación de particiones -
+Validación de imágenes - Validación de comandos - Validación de
+usuarios</p>
+<h3 data-number="1.9.5"
+id="eventsubscribers-suscriptores-de-eventos"><span
+class="header-section-number">1.9.5</span> 8.5 EventSubscribers
+(Suscriptores de Eventos)</h3>
+<p><strong>8 suscriptores</strong> para: - Publicación en Mercure al
+cambiar estados - Limpieza de recursos - Validaciones pre/post
+persistencia - Logging de eventos</p>
+<h3 data-number="1.9.6" id="factories-fábricas"><span
+class="header-section-number">1.9.6</span> 8.6 Factories (Fábricas)</h3>
+<p><strong>24 factories</strong> para testing con Foundry: - Creación de
+entidades para tests - Datos de prueba realistas - Estados
+predefinidos</p>
+<hr />
+<h2 data-number="1.10" id="api-restful"><span
+class="header-section-number">1.10</span> 9. API RESTful</h2>
+<h3 data-number="1.10.1" id="documentación"><span
+class="header-section-number">1.10.1</span> 9.1 Documentación</h3>
+<p>La API está completamente documentada con <strong>OpenAPI
+3.0</strong> y accesible en:</p>
+<pre><code>http://127.0.0.1:8080/docs</code></pre>
+<h3 data-number="1.10.2" id="formato-de-respuestas"><span
+class="header-section-number">1.10.2</span> 9.2 Formato de
+Respuestas</h3>
+<h4 data-number="1.10.2.1" id="formato-estándar-json-ld"><span
+class="header-section-number">1.10.2.1</span> Formato estándar
+(JSON-LD):</h4>
+<div class="sourceCode" id="cb13"><pre
+class="sourceCode json"><code class="sourceCode json"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true" tabindex="-1"></a><span class="fu">{</span></span>
+<span id="cb13-2"><a href="#cb13-2" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;@context&quot;</span><span class="fu">:</span> <span class="st">&quot;/contexts/Client&quot;</span><span class="fu">,</span></span>
+<span id="cb13-3"><a href="#cb13-3" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;@id&quot;</span><span class="fu">:</span> <span class="st">&quot;/clients/123e4567-e89b-12d3-a456-426614174000&quot;</span><span class="fu">,</span></span>
+<span id="cb13-4"><a href="#cb13-4" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;@type&quot;</span><span class="fu">:</span> <span class="st">&quot;Client&quot;</span><span class="fu">,</span></span>
+<span id="cb13-5"><a href="#cb13-5" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;id&quot;</span><span class="fu">:</span> <span class="st">&quot;123e4567-e89b-12d3-a456-426614174000&quot;</span><span class="fu">,</span></span>
+<span id="cb13-6"><a href="#cb13-6" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;PC-01&quot;</span><span class="fu">,</span></span>
+<span id="cb13-7"><a href="#cb13-7" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;mac&quot;</span><span class="fu">:</span> <span class="st">&quot;00:11:22:33:44:55&quot;</span><span class="fu">,</span></span>
+<span id="cb13-8"><a href="#cb13-8" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;ip&quot;</span><span class="fu">:</span> <span class="st">&quot;192.168.1.100&quot;</span><span class="fu">,</span></span>
+<span id="cb13-9"><a href="#cb13-9" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;status&quot;</span><span class="fu">:</span> <span class="st">&quot;active&quot;</span></span>
+<span id="cb13-10"><a href="#cb13-10" aria-hidden="true" tabindex="-1"></a><span class="fu">}</span></span></code></pre></div>
+<h4 data-number="1.10.2.2" id="formato-alternativo-json"><span
+class="header-section-number">1.10.2.2</span> Formato alternativo
+(JSON):</h4>
+<div class="sourceCode" id="cb14"><pre
+class="sourceCode json"><code class="sourceCode json"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true" tabindex="-1"></a><span class="fu">{</span></span>
+<span id="cb14-2"><a href="#cb14-2" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;id&quot;</span><span class="fu">:</span> <span class="st">&quot;123e4567-e89b-12d3-a456-426614174000&quot;</span><span class="fu">,</span></span>
+<span id="cb14-3"><a href="#cb14-3" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;PC-01&quot;</span><span class="fu">,</span></span>
+<span id="cb14-4"><a href="#cb14-4" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;mac&quot;</span><span class="fu">:</span> <span class="st">&quot;00:11:22:33:44:55&quot;</span><span class="fu">,</span></span>
+<span id="cb14-5"><a href="#cb14-5" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;ip&quot;</span><span class="fu">:</span> <span class="st">&quot;192.168.1.100&quot;</span><span class="fu">,</span></span>
+<span id="cb14-6"><a href="#cb14-6" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;status&quot;</span><span class="fu">:</span> <span class="st">&quot;active&quot;</span></span>
+<span id="cb14-7"><a href="#cb14-7" aria-hidden="true" tabindex="-1"></a><span class="fu">}</span></span></code></pre></div>
+<h3 data-number="1.10.3" id="paginación"><span
+class="header-section-number">1.10.3</span> 9.3 Paginación</h3>
+<p>Todas las colecciones soportan paginación:</p>
+<pre><code>GET /clients?page=1&amp;itemsPerPage=30</code></pre>
+<p>Respuesta:</p>
+<div class="sourceCode" id="cb16"><pre
+class="sourceCode json"><code class="sourceCode json"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a><span class="fu">{</span></span>
+<span id="cb16-2"><a href="#cb16-2" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;@context&quot;</span><span class="fu">:</span> <span class="st">&quot;/contexts/Client&quot;</span><span class="fu">,</span></span>
+<span id="cb16-3"><a href="#cb16-3" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;@id&quot;</span><span class="fu">:</span> <span class="st">&quot;/clients&quot;</span><span class="fu">,</span></span>
+<span id="cb16-4"><a href="#cb16-4" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;@type&quot;</span><span class="fu">:</span> <span class="st">&quot;hydra:Collection&quot;</span><span class="fu">,</span></span>
+<span id="cb16-5"><a href="#cb16-5" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;hydra:member&quot;</span><span class="fu">:</span> <span class="ot">[</span><span class="er">...</span><span class="ot">]</span><span class="fu">,</span></span>
+<span id="cb16-6"><a href="#cb16-6" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;hydra:totalItems&quot;</span><span class="fu">:</span> <span class="dv">150</span><span class="fu">,</span></span>
+<span id="cb16-7"><a href="#cb16-7" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;hydra:view&quot;</span><span class="fu">:</span> <span class="fu">{</span></span>
+<span id="cb16-8"><a href="#cb16-8" aria-hidden="true" tabindex="-1"></a>    <span class="dt">&quot;@id&quot;</span><span class="fu">:</span> <span class="st">&quot;/clients?page=1&quot;</span><span class="fu">,</span></span>
+<span id="cb16-9"><a href="#cb16-9" aria-hidden="true" tabindex="-1"></a>    <span class="dt">&quot;@type&quot;</span><span class="fu">:</span> <span class="st">&quot;hydra:PartialCollectionView&quot;</span><span class="fu">,</span></span>
+<span id="cb16-10"><a href="#cb16-10" aria-hidden="true" tabindex="-1"></a>    <span class="dt">&quot;hydra:first&quot;</span><span class="fu">:</span> <span class="st">&quot;/clients?page=1&quot;</span><span class="fu">,</span></span>
+<span id="cb16-11"><a href="#cb16-11" aria-hidden="true" tabindex="-1"></a>    <span class="dt">&quot;hydra:last&quot;</span><span class="fu">:</span> <span class="st">&quot;/clients?page=5&quot;</span><span class="fu">,</span></span>
+<span id="cb16-12"><a href="#cb16-12" aria-hidden="true" tabindex="-1"></a>    <span class="dt">&quot;hydra:next&quot;</span><span class="fu">:</span> <span class="st">&quot;/clients?page=2&quot;</span></span>
+<span id="cb16-13"><a href="#cb16-13" aria-hidden="true" tabindex="-1"></a>  <span class="fu">}</span></span>
+<span id="cb16-14"><a href="#cb16-14" aria-hidden="true" tabindex="-1"></a><span class="fu">}</span></span></code></pre></div>
+<h3 data-number="1.10.4" id="filtrado"><span
+class="header-section-number">1.10.4</span> 9.4 Filtrado</h3>
+<p>Soporta filtros avanzados:</p>
+<pre><code>GET /clients?status=active
+GET /clients?organizationalUnit.name=Aula1
+GET /traces?client.id=123&amp;status=pending</code></pre>
+<h3 data-number="1.10.5" id="ordenamiento"><span
+class="header-section-number">1.10.5</span> 9.5 Ordenamiento</h3>
+<pre><code>GET /clients?order[name]=asc
+GET /traces?order[createdAt]=desc</code></pre>
+<h3 data-number="1.10.6" id="endpoints-principales"><span
+class="header-section-number">1.10.6</span> 9.6 Endpoints
+Principales</h3>
+<h4 data-number="1.10.6.1" id="autenticación"><span
+class="header-section-number">1.10.6.1</span> 9.6.1 Autenticación</h4>
+<pre><code>POST /auth/login
+POST /auth/refresh</code></pre>
+<h4 data-number="1.10.6.2" id="clientes"><span
+class="header-section-number">1.10.6.2</span> 9.6.2 Clientes</h4>
+<pre><code>GET    /clients
+POST   /clients
+GET    /clients/{id}
+PUT    /clients/{id}
+PATCH  /clients/{id}
+DELETE /clients/{id}
+POST   /clients/batch
+POST   /clients/{id}/power-on
+POST   /clients/{id}/power-off
+POST   /clients/{id}/reboot</code></pre>
+<h4 data-number="1.10.6.3" id="imágenes"><span
+class="header-section-number">1.10.6.3</span> 9.6.3 Imágenes</h4>
+<pre><code>GET    /images
+POST   /images
+GET    /images/{id}
+PUT    /images/{id}
+DELETE /images/{id}
+POST   /images/{id}/deploy
+POST   /images/{id}/create
+POST   /images/{id}/backup</code></pre>
+<h4 data-number="1.10.6.4" id="comandos-y-tareas"><span
+class="header-section-number">1.10.6.4</span> 9.6.4 Comandos y
+Tareas</h4>
+<pre><code>GET    /commands
+POST   /commands
+GET    /command-tasks
+POST   /command-tasks
+PUT    /command-tasks/{id}
+DELETE /command-tasks/{id}</code></pre>
+<h4 data-number="1.10.6.5" id="trazas"><span
+class="header-section-number">1.10.6.5</span> 9.6.5 Trazas</h4>
+<pre><code>GET    /traces
+GET    /traces/{id}
+PUT    /traces/{id}
+PATCH  /traces/{id}/complete
+PATCH  /traces/{id}/cancel</code></pre>
+<h3 data-number="1.10.7" id="códigos-de-estado-http"><span
+class="header-section-number">1.10.7</span> 9.7 Códigos de Estado
+HTTP</h3>
+<table>
+<thead>
+<tr class="header">
+<th>Código</th>
+<th>Significado</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td>200</td>
+<td>OK - Operación exitosa</td>
+</tr>
+<tr class="even">
+<td>201</td>
+<td>Created - Recurso creado</td>
+</tr>
+<tr class="odd">
+<td>204</td>
+<td>No Content - Eliminación exitosa</td>
+</tr>
+<tr class="even">
+<td>400</td>
+<td>Bad Request - Datos inválidos</td>
+</tr>
+<tr class="odd">
+<td>401</td>
+<td>Unauthorized - No autenticado</td>
+</tr>
+<tr class="even">
+<td>403</td>
+<td>Forbidden - Sin permisos</td>
+</tr>
+<tr class="odd">
+<td>404</td>
+<td>Not Found - Recurso no encontrado</td>
+</tr>
+<tr class="even">
+<td>409</td>
+<td>Conflict - Conflicto (cliente ocupado, constraint violation)</td>
+</tr>
+<tr class="odd">
+<td>422</td>
+<td>Unprocessable Entity - Validación fallida</td>
+</tr>
+<tr class="even">
+<td>500</td>
+<td>Internal Server Error - Error del servidor</td>
+</tr>
+</tbody>
+</table>
+<hr />
+<h2 data-number="1.11" id="seguridad-y-autenticación"><span
+class="header-section-number">1.11</span> 10. Seguridad y
+Autenticación</h2>
+<h3 data-number="1.11.1" id="sistema-de-autenticación-jwt"><span
+class="header-section-number">1.11.1</span> 10.1 Sistema de
+Autenticación JWT</h3>
+<p>ogCore utiliza <strong>JSON Web Tokens (JWT)</strong> para
+autenticación:</p>
+<h4 data-number="1.11.1.1" id="obtener-token"><span
+class="header-section-number">1.11.1.1</span> 10.1.1 Obtener Token</h4>
+<div class="sourceCode" id="cb24"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb24-1"><a href="#cb24-1" aria-hidden="true" tabindex="-1"></a><span class="ex">POST</span> /auth/login</span>
+<span id="cb24-2"><a href="#cb24-2" aria-hidden="true" tabindex="-1"></a><span class="ex">Content-Type:</span> application/json</span>
+<span id="cb24-3"><a href="#cb24-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb24-4"><a href="#cb24-4" aria-hidden="true" tabindex="-1"></a><span class="kw">{</span></span>
+<span id="cb24-5"><a href="#cb24-5" aria-hidden="true" tabindex="-1"></a>  <span class="st">&quot;username&quot;</span><span class="ex">:</span> <span class="st">&quot;admin&quot;</span>,</span>
+<span id="cb24-6"><a href="#cb24-6" aria-hidden="true" tabindex="-1"></a>  <span class="st">&quot;password&quot;</span><span class="ex">:</span> <span class="st">&quot;password&quot;</span></span>
+<span id="cb24-7"><a href="#cb24-7" aria-hidden="true" tabindex="-1"></a><span class="kw">}</span></span></code></pre></div>
+<p>Respuesta:</p>
+<div class="sourceCode" id="cb25"><pre
+class="sourceCode json"><code class="sourceCode json"><span id="cb25-1"><a href="#cb25-1" aria-hidden="true" tabindex="-1"></a><span class="fu">{</span></span>
+<span id="cb25-2"><a href="#cb25-2" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;token&quot;</span><span class="fu">:</span> <span class="st">&quot;eyJ0eXAiOiJKV1QiLCJhbGc...&quot;</span><span class="fu">,</span></span>
+<span id="cb25-3"><a href="#cb25-3" aria-hidden="true" tabindex="-1"></a>  <span class="dt">&quot;refresh_token&quot;</span><span class="fu">:</span> <span class="st">&quot;def50200a54b7b...&quot;</span></span>
+<span id="cb25-4"><a href="#cb25-4" aria-hidden="true" tabindex="-1"></a><span class="fu">}</span></span></code></pre></div>
+<h4 data-number="1.11.1.2" id="usar-token"><span
+class="header-section-number">1.11.1.2</span> 10.1.2 Usar Token</h4>
+<p>Incluir el token en el header <code>Authorization</code>:</p>
+<div class="sourceCode" id="cb26"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb26-1"><a href="#cb26-1" aria-hidden="true" tabindex="-1"></a><span class="ex">GET</span> /clients</span>
+<span id="cb26-2"><a href="#cb26-2" aria-hidden="true" tabindex="-1"></a><span class="ex">Authorization:</span> Bearer eyJ0eXAiOiJKV1QiLCJhbGc...</span></code></pre></div>
+<h4 data-number="1.11.1.3" id="refresh-token"><span
+class="header-section-number">1.11.1.3</span> 10.1.3 Refresh Token</h4>
+<div class="sourceCode" id="cb27"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb27-1"><a href="#cb27-1" aria-hidden="true" tabindex="-1"></a><span class="ex">POST</span> /auth/refresh</span>
+<span id="cb27-2"><a href="#cb27-2" aria-hidden="true" tabindex="-1"></a><span class="ex">Content-Type:</span> application/json</span>
+<span id="cb27-3"><a href="#cb27-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb27-4"><a href="#cb27-4" aria-hidden="true" tabindex="-1"></a><span class="kw">{</span></span>
+<span id="cb27-5"><a href="#cb27-5" aria-hidden="true" tabindex="-1"></a>  <span class="st">&quot;refresh_token&quot;</span><span class="ex">:</span> <span class="st">&quot;def50200a54b7b...&quot;</span></span>
+<span id="cb27-6"><a href="#cb27-6" aria-hidden="true" tabindex="-1"></a><span class="kw">}</span></span></code></pre></div>
+<h3 data-number="1.11.2" id="control-de-acceso"><span
+class="header-section-number">1.11.2</span> 10.2 Control de Acceso</h3>
+<h4 data-number="1.11.2.1" id="rutas-públicas"><span
+class="header-section-number">1.11.2.1</span> Rutas Públicas:</h4>
+<ul>
+<li><code>/auth/login</code></li>
+<li><code>/auth/refresh</code></li>
+<li><code>/docs</code></li>
+<li><code>/opengnsys/rest/*</code> (webhooks)</li>
+<li><code>/og-repository/webhook</code></li>
+<li><code>/menu-browser</code></li>
+</ul>
+<h4 data-number="1.11.2.2" id="rutas-protegidas"><span
+class="header-section-number">1.11.2.2</span> Rutas Protegidas:</h4>
+<ul>
+<li>Todo lo demás requiere <code>IS_AUTHENTICATED_FULLY</code></li>
+</ul>
+<h3 data-number="1.11.3" id="roles-de-usuario"><span
+class="header-section-number">1.11.3</span> 10.3 Roles de Usuario</h3>
+<p>Los roles se gestionan en la entidad <code>User</code>:</p>
+<div class="sourceCode" id="cb28"><pre
+class="sourceCode php"><code class="sourceCode php"><span id="cb28-1"><a href="#cb28-1" aria-hidden="true" tabindex="-1"></a><span class="va">$user</span>-&gt;setRoles([<span class="st">&#39;ROLE_USER&#39;</span>])<span class="ot">;</span></span>
+<span id="cb28-2"><a href="#cb28-2" aria-hidden="true" tabindex="-1"></a><span class="va">$user</span>-&gt;setRoles([<span class="st">&#39;ROLE_ADMIN&#39;</span>])<span class="ot">;</span></span></code></pre></div>
+<h3 data-number="1.11.4" id="seguridad-de-contraseñas"><span
+class="header-section-number">1.11.4</span> 10.4 Seguridad de
+Contraseñas</h3>
+<ul>
+<li>Hashing con <strong>bcrypt</strong> automático</li>
+<li>Validación de fortaleza</li>
+<li>Cambio de contraseña seguro</li>
+</ul>
+<h3 data-number="1.11.5" id="cors-cross-origin-resource-sharing"><span
+class="header-section-number">1.11.5</span> 10.5 CORS (Cross-Origin
+Resource Sharing)</h3>
+<p>Configurado en <code>nelmio_cors.yaml</code> para permitir acceso
+desde frontend.</p>
+<h3 data-number="1.11.6" id="ssltls"><span
+class="header-section-number">1.11.6</span> 10.6 SSL/TLS</h3>
+<p>Para producción, habilitar SSL:</p>
+<div class="sourceCode" id="cb29"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb29-1"><a href="#cb29-1" aria-hidden="true" tabindex="-1"></a><span class="va">SSL_ENABLED</span><span class="op">=</span>true</span></code></pre></div>
+<p>Configurar certificados en <code>/certs/</code>.</p>
+<hr />
+<h2 data-number="1.12" id="servicios-principales"><span
+class="header-section-number">1.12</span> 11. Servicios Principales</h2>
+<h3 data-number="1.12.1" id="createpartitionservice"><span
+class="header-section-number">1.12.1</span> 11.1
+CreatePartitionService</h3>
+<p><strong>Propósito</strong>: Crear y actualizar particiones de
+clientes.</p>
+<p><strong>Funcionalidad</strong>: - Recibe información de particiones
+del agente - Crea/actualiza particiones en base de datos - Detecta tipo
+de firmware (BIOS/UEFI) - Calcula códigos de partición</p>
+<h3 data-number="1.12.2" id="createtraceservice"><span
+class="header-section-number">1.12.2</span> 11.2 CreateTraceService</h3>
+<p><strong>Propósito</strong>: Crear trazas de ejecución para tareas
+programadas.</p>
+<p><strong>Funcionalidad</strong>: - Genera trazas para cada combinación
+cliente-comando - Gestiona comandos agrupados - Establece estado inicial
+y fecha de ejecución</p>
+<h3 data-number="1.12.3" id="changeclientnetworksettingsservice"><span
+class="header-section-number">1.12.3</span> 11.3
+ChangeClientNetworkSettingsService</h3>
+<p><strong>Propósito</strong>: Cambiar configuración de red de
+clientes.</p>
+<p><strong>Funcionalidad</strong>: - Actualiza subnet, IP, configuración
+de red - Sincroniza con servicios externos (DHCP)</p>
+<h3 data-number="1.12.4" id="externalgitrepositoryservice"><span
+class="header-section-number">1.12.4</span> 11.4
+ExternalGitRepositoryService</h3>
+<p><strong>Propósito</strong>: Gestión de repositorios Git para
+imágenes.</p>
+<p><strong>Funcionalidad</strong>: - Backup de imágenes a Git -
+Versionado de imágenes - Sincronización con repositorios remotos</p>
+<h3 data-number="1.12.5"
+id="statusservice-ogbootogdhcpogrepository"><span
+class="header-section-number">1.12.5</span> 11.5 StatusService
+(OgBoot/OgDhcp/OgRepository)</h3>
+<p><strong>Propósito</strong>: Verificar estado de servicios
+externos.</p>
+<p><strong>Funcionalidad</strong>: - Health checks de servicios - Manejo
+de errores de conexión - Logging de estado</p>
+<h3 data-number="1.12.6" id="udsclient"><span
+class="header-section-number">1.12.6</span> 11.6 UDSClient</h3>
+<p><strong>Propósito</strong>: Integración con UDS (Universal Desktop
+Services).</p>
+<p><strong>Funcionalidad</strong>: - Autenticación con UDS - Obtención
+de service pools - Cálculo de asientos disponibles - Gestión de
+calendarios remotos</p>
+<h3 data-number="1.12.7" id="tracecreateservice"><span
+class="header-section-number">1.12.7</span> 11.7
+Trace/CreateService</h3>
+<p><strong>Propósito</strong>: Servicio especializado para creación de
+trazas.</p>
+<p><strong>Funcionalidad</strong>: - Validación de parámetros de entrada
+- Creación de trazas individuales o masivas</p>
+<h3 data-number="1.12.8" id="utilsgetpartitioncodeservice"><span
+class="header-section-number">1.12.8</span> 11.8
+Utils/GetPartitionCodeService</h3>
+<p><strong>Propósito</strong>: Obtener código de partición según tipo y
+filesystem.</p>
+<h3 data-number="1.12.9" id="utilssimplifyoglivefilenameservice"><span
+class="header-section-number">1.12.9</span> 11.9
+Utils/SimplifyOgLiveFilenameService</h3>
+<p><strong>Propósito</strong>: Simplificar nombres de archivos OgLive
+para mostrar al usuario.</p>
+<h3 data-number="1.12.10"
+id="utilsgetipaddressandnetmaskfromcidrservice"><span
+class="header-section-number">1.12.10</span> 11.10
+Utils/GetIpAddressAndNetmaskFromCIDRService</h3>
+<p><strong>Propósito</strong>: Convertir notación CIDR a IP y máscara de
+red.</p>
+<hr />
+<h2 data-number="1.13" id="comandos-de-consola"><span
+class="header-section-number">1.13</span> 12. Comandos de Consola</h2>
+<p>ogCore incluye <strong>18 comandos de consola</strong> para tareas
+administrativas:</p>
+<h3 data-number="1.13.1" id="comandos-de-inicialización"><span
+class="header-section-number">1.13.1</span> 12.1 Comandos de
+Inicialización</h3>
+<h4 data-number="1.13.1.1"
+id="cargar-grupos-de-usuario-por-defecto"><span
+class="header-section-number">1.13.1.1</span> 12.1.1 Cargar Grupos de
+Usuario por Defecto</h4>
+<div class="sourceCode" id="cb30"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb30-1"><a href="#cb30-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:load-default-user-groups</span></code></pre></div>
+<p>Crea los grupos de usuarios predeterminados del sistema.</p>
+<h4 data-number="1.13.1.2" id="cargar-comandos-por-defecto"><span
+class="header-section-number">1.13.1.2</span> 12.1.2 Cargar Comandos por
+Defecto</h4>
+<div class="sourceCode" id="cb31"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb31-1"><a href="#cb31-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:load-default-commands</span></code></pre></div>
+<p>Carga los comandos básicos del sistema.</p>
+<h4 data-number="1.13.1.3" id="cargar-usuario-admin"><span
+class="header-section-number">1.13.1.3</span> 12.1.3 Cargar Usuario
+Admin</h4>
+<div class="sourceCode" id="cb32"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb32-1"><a href="#cb32-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:load-default-user-admin</span></code></pre></div>
+<p>Crea el usuario administrador por defecto.</p>
+<h4 data-number="1.13.1.4" id="cargar-menú-por-defecto"><span
+class="header-section-number">1.13.1.4</span> 12.1.4 Cargar Menú por
+Defecto</h4>
+<div class="sourceCode" id="cb33"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb33-1"><a href="#cb33-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:load-default-menu</span></code></pre></div>
+<p>Carga menús de arranque predeterminados.</p>
+<h4 data-number="1.13.1.5" id="cargar-tipos-de-hardware"><span
+class="header-section-number">1.13.1.5</span> 12.1.5 Cargar Tipos de
+Hardware</h4>
+<div class="sourceCode" id="cb34"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb34-1"><a href="#cb34-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:load-hardware-types</span></code></pre></div>
+<p>Inicializa la tabla de tipos de hardware.</p>
+<h4 data-number="1.13.1.6"
+id="cargar-unidad-organizativa-por-defecto"><span
+class="header-section-number">1.13.1.6</span> 12.1.6 Cargar Unidad
+Organizativa por Defecto</h4>
+<div class="sourceCode" id="cb35"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb35-1"><a href="#cb35-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:load-organizational-unit-default</span></code></pre></div>
+<p>Crea la unidad organizativa raíz.</p>
+<h3 data-number="1.13.2" id="comandos-de-operación"><span
+class="header-section-number">1.13.2</span> 12.2 Comandos de
+Operación</h3>
+<h4 data-number="1.13.2.1"
+id="verificar-disponibilidad-de-clientes"><span
+class="header-section-number">1.13.2.1</span> 12.2.1 Verificar
+Disponibilidad de Clientes</h4>
+<div class="sourceCode" id="cb36"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb36-1"><a href="#cb36-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:check-client-availability</span></code></pre></div>
+<p><strong>Ejecución</strong>: Cada 1 minuto (cron)</p>
+<p>Verifica el estado de conectividad de los clientes y actualiza su
+estado si no responden en un tiempo determinado.</p>
+<h4 data-number="1.13.2.2" id="ejecutar-trazas-pendientes"><span
+class="header-section-number">1.13.2.2</span> 12.2.2 Ejecutar Trazas
+Pendientes</h4>
+<div class="sourceCode" id="cb37"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb37-1"><a href="#cb37-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:execute-pending-traces</span></code></pre></div>
+<p><strong>Ejecución</strong>: Cada 1 minuto (cron)</p>
+<p>Procesa las trazas en estado <code>PENDING</code> y las ejecuta en
+los clientes correspondientes.</p>
+<h4 data-number="1.13.2.3" id="ejecutar-tareas-programadas"><span
+class="header-section-number">1.13.2.3</span> 12.2.3 Ejecutar Tareas
+Programadas</h4>
+<div class="sourceCode" id="cb38"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb38-1"><a href="#cb38-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:run-scheduled-command-tasks</span></code></pre></div>
+<p><strong>Ejecución</strong>: Cada 1 minuto (cron)</p>
+<p>Ejecuta tareas programadas que han llegado a su hora de
+ejecución.</p>
+<h3 data-number="1.13.3" id="comandos-de-migración"><span
+class="header-section-number">1.13.3</span> 12.3 Comandos de
+Migración</h3>
+<p>Comandos para migrar datos desde OpenGnsys 1.1:</p>
+<h4 data-number="1.13.3.1" id="migrar-unidades-organizativas"><span
+class="header-section-number">1.13.3.1</span> 12.3.1 Migrar Unidades
+Organizativas</h4>
+<div class="sourceCode" id="cb39"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb39-1"><a href="#cb39-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console opengnsys:migration:organizational-unit</span></code></pre></div>
+<h4 data-number="1.13.3.2" id="migrar-perfiles-de-hardware"><span
+class="header-section-number">1.13.3.2</span> 12.3.2 Migrar Perfiles de
+Hardware</h4>
+<div class="sourceCode" id="cb40"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb40-1"><a href="#cb40-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console opengnsys:migration:hardware-profile</span></code></pre></div>
+<h4 data-number="1.13.3.3" id="migrar-clientes"><span
+class="header-section-number">1.13.3.3</span> 12.3.3 Migrar
+Clientes</h4>
+<div class="sourceCode" id="cb41"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb41-1"><a href="#cb41-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console opengnsys:migration:clients</span></code></pre></div>
+<h4 data-number="1.13.3.4" id="migrar-sistemas-operativos"><span
+class="header-section-number">1.13.3.4</span> 12.3.4 Migrar Sistemas
+Operativos</h4>
+<div class="sourceCode" id="cb42"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb42-1"><a href="#cb42-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console opengnsys:migration:os</span></code></pre></div>
+<h4 data-number="1.13.3.5" id="migrar-imágenes"><span
+class="header-section-number">1.13.3.5</span> 12.3.5 Migrar
+Imágenes</h4>
+<div class="sourceCode" id="cb43"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb43-1"><a href="#cb43-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console opengnsys:migration:image</span></code></pre></div>
+<h4 data-number="1.13.3.6" id="migrar-perfiles-de-software"><span
+class="header-section-number">1.13.3.6</span> 12.3.6 Migrar Perfiles de
+Software</h4>
+<div class="sourceCode" id="cb44"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb44-1"><a href="#cb44-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console opengnsys:migration:software-profile</span></code></pre></div>
+<h4 data-number="1.13.3.7" id="migrar-particiones-de-clientes"><span
+class="header-section-number">1.13.3.7</span> 12.3.7 Migrar Particiones
+de Clientes</h4>
+<div class="sourceCode" id="cb45"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb45-1"><a href="#cb45-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console opengnsys:migration:partition-client</span></code></pre></div>
+<h3 data-number="1.13.4" id="comandos-de-desarrollo"><span
+class="header-section-number">1.13.4</span> 12.4 Comandos de
+Desarrollo</h3>
+<h4 data-number="1.13.4.1" id="crear-repositorios-de-imágenes"><span
+class="header-section-number">1.13.4.1</span> 12.4.1 Crear Repositorios
+de Imágenes</h4>
+<div class="sourceCode" id="cb46"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb46-1"><a href="#cb46-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:create-image-repositories</span></code></pre></div>
+<p>Crea repositorios de imágenes para desarrollo/testing.</p>
+<h4 data-number="1.13.4.2" id="cargar-trazas-de-ejemplo"><span
+class="header-section-number">1.13.4.2</span> 12.4.2 Cargar Trazas de
+Ejemplo</h4>
+<div class="sourceCode" id="cb47"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb47-1"><a href="#cb47-1" aria-hidden="true" tabindex="-1"></a><span class="ex">php</span> bin/console app:charge-example-trace</span></code></pre></div>
+<p>Carga trazas de ejemplo para testing.</p>
+<h3 data-number="1.13.5" id="configuración-de-cron"><span
+class="header-section-number">1.13.5</span> 12.5 Configuración de
+Cron</h3>
+<p>Agregar al crontab:</p>
+<div class="sourceCode" id="cb48"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb48-1"><a href="#cb48-1" aria-hidden="true" tabindex="-1"></a><span class="ex">*</span> <span class="pp">*</span> <span class="pp">*</span> <span class="pp">*</span> <span class="pp">*</span> docker exec ogcore-php php bin/console app:check-client-availability</span>
+<span id="cb48-2"><a href="#cb48-2" aria-hidden="true" tabindex="-1"></a><span class="ex">*</span> <span class="pp">*</span> <span class="pp">*</span> <span class="pp">*</span> <span class="pp">*</span> docker exec ogcore-php php bin/console app:execute-pending-traces</span>
+<span id="cb48-3"><a href="#cb48-3" aria-hidden="true" tabindex="-1"></a><span class="ex">*</span> <span class="pp">*</span> <span class="pp">*</span> <span class="pp">*</span> <span class="pp">*</span> docker exec ogcore-php php bin/console app:run-scheduled-command-tasks</span></code></pre></div>
+<hr />
+<h2 data-number="1.14" id="migraciones-de-datos"><span
+class="header-section-number">1.14</span> 13. Migraciones de Datos</h2>
+<h3 data-number="1.14.1" id="sistema-de-migraciones-de-doctrine"><span
+class="header-section-number">1.14.1</span> 13.1 Sistema de Migraciones
+de Doctrine</h3>
+<p>ogCore utiliza Doctrine Migrations para gestionar cambios en el
+esquema de base de datos.</p>
+<h4 data-number="1.14.1.1" id="crear-una-migración"><span
+class="header-section-number">1.14.1.1</span> 13.1.1 Crear una
+Migración</h4>
+<div class="sourceCode" id="cb49"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb49-1"><a href="#cb49-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console make:migration</span></code></pre></div>
+<h4 data-number="1.14.1.2" id="ejecutar-migraciones"><span
+class="header-section-number">1.14.1.2</span> 13.1.2 Ejecutar
+Migraciones</h4>
+<div class="sourceCode" id="cb50"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb50-1"><a href="#cb50-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:migrations:migrate</span></code></pre></div>
+<h4 data-number="1.14.1.3" id="ver-estado-de-migraciones"><span
+class="header-section-number">1.14.1.3</span> 13.1.3 Ver Estado de
+Migraciones</h4>
+<div class="sourceCode" id="cb51"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb51-1"><a href="#cb51-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:migrations:status</span></code></pre></div>
+<h4 data-number="1.14.1.4" id="revertir-migración"><span
+class="header-section-number">1.14.1.4</span> 13.1.4 Revertir
+Migración</h4>
+<div class="sourceCode" id="cb52"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb52-1"><a href="#cb52-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:migrations:migrate prev</span></code></pre></div>
+<h3 data-number="1.14.2" id="migración-desde-opengnsys-1.1"><span
+class="header-section-number">1.14.2</span> 13.2 Migración desde
+OpenGnsys 1.1</h3>
+<p>Para migrar datos desde una instalación de OpenGnsys 1.1:</p>
+<h4 data-number="1.14.2.1" id="crear-base-de-datos-temporal"><span
+class="header-section-number">1.14.2.1</span> 13.2.1 Crear Base de Datos
+Temporal</h4>
+<div class="sourceCode" id="cb53"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb53-1"><a href="#cb53-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:database:create <span class="at">--connection</span><span class="op">=</span>og_1</span></code></pre></div>
+<h4 data-number="1.14.2.2" id="cargar-dump-de-opengnsys-1.1"><span
+class="header-section-number">1.14.2.2</span> 13.2.2 Cargar Dump de
+OpenGnsys 1.1</h4>
+<div class="sourceCode" id="cb54"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb54-1"><a href="#cb54-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec <span class="at">-i</span> ogcore-database mysql <span class="at">-u</span> user <span class="at">-p</span> ogcore_old_og <span class="op">&lt;</span> dump_og_1.1.sql</span></code></pre></div>
+<h4 data-number="1.14.2.3" id="ejecutar-migraciones-1"><span
+class="header-section-number">1.14.2.3</span> 13.2.3 Ejecutar
+Migraciones</h4>
+<p>Ejecutar los comandos de migración en orden:</p>
+<div class="sourceCode" id="cb55"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb55-1"><a href="#cb55-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console opengnsys:migration:organizational-unit</span>
+<span id="cb55-2"><a href="#cb55-2" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console opengnsys:migration:hardware-profile</span>
+<span id="cb55-3"><a href="#cb55-3" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console opengnsys:migration:clients</span>
+<span id="cb55-4"><a href="#cb55-4" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console opengnsys:migration:os</span>
+<span id="cb55-5"><a href="#cb55-5" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console opengnsys:migration:image</span>
+<span id="cb55-6"><a href="#cb55-6" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console opengnsys:migration:software-profile</span></code></pre></div>
+<h3 data-number="1.14.3" id="backup-y-restauración"><span
+class="header-section-number">1.14.3</span> 13.3 Backup y
+Restauración</h3>
+<h4 data-number="1.14.3.1" id="backup-de-base-de-datos"><span
+class="header-section-number">1.14.3.1</span> 13.3.1 Backup de Base de
+Datos</h4>
+<div class="sourceCode" id="cb56"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb56-1"><a href="#cb56-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-database mysqldump <span class="at">-u</span> user <span class="at">-p</span> ogcore <span class="op">&gt;</span> backup_<span class="va">$(</span><span class="fu">date</span> +%Y%m%d<span class="va">)</span>.sql</span></code></pre></div>
+<h4 data-number="1.14.3.2" id="restaurar-base-de-datos"><span
+class="header-section-number">1.14.3.2</span> 13.3.2 Restaurar Base de
+Datos</h4>
+<div class="sourceCode" id="cb57"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb57-1"><a href="#cb57-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec <span class="at">-i</span> ogcore-database mysql <span class="at">-u</span> user <span class="at">-p</span> ogcore <span class="op">&lt;</span> backup_20251008.sql</span></code></pre></div>
+<hr />
+<h2 data-number="1.15" id="testing-1"><span
+class="header-section-number">1.15</span> 14. Testing</h2>
+<h3 data-number="1.15.1" id="framework-de-testing"><span
+class="header-section-number">1.15.1</span> 14.1 Framework de
+Testing</h3>
+<p>ogCore utiliza <strong>PHPUnit</strong> con integración de Symfony y
+Doctrine.</p>
+<h3 data-number="1.15.2" id="ejecutar-tests"><span
+class="header-section-number">1.15.2</span> 14.2 Ejecutar Tests</h3>
+<h4 data-number="1.15.2.1" id="todos-los-tests"><span
+class="header-section-number">1.15.2.1</span> 14.2.1 Todos los
+Tests</h4>
+<div class="sourceCode" id="cb58"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb58-1"><a href="#cb58-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> compose exec php bin/phpunit</span></code></pre></div>
+<h4 data-number="1.15.2.2" id="tests-específicos"><span
+class="header-section-number">1.15.2.2</span> 14.2.2 Tests
+Específicos</h4>
+<div class="sourceCode" id="cb59"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb59-1"><a href="#cb59-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> compose exec php bin/phpunit tests/Functional/ClientTest.php</span></code></pre></div>
+<h4 data-number="1.15.2.3" id="tests-con-coverage"><span
+class="header-section-number">1.15.2.3</span> 14.2.3 Tests con
+Coverage</h4>
+<div class="sourceCode" id="cb60"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb60-1"><a href="#cb60-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> compose exec php bin/phpunit <span class="at">--coverage-html</span> coverage/</span></code></pre></div>
+<h3 data-number="1.15.3" id="tipos-de-tests"><span
+class="header-section-number">1.15.3</span> 14.3 Tipos de Tests</h3>
+<h4 data-number="1.15.3.1" id="tests-funcionales"><span
+class="header-section-number">1.15.3.1</span> 14.3.1 Tests
+Funcionales</h4>
+<p>Ubicación: <code>tests/Functional/</code></p>
+<p>20 archivos de tests funcionales que prueban: - Endpoints de API -
+Flujos completos - Integraciones</p>
+<p>Ejemplo:</p>
+<div class="sourceCode" id="cb61"><pre
+class="sourceCode php"><code class="sourceCode php"><span id="cb61-1"><a href="#cb61-1" aria-hidden="true" tabindex="-1"></a><span class="kw">public</span> <span class="kw">function</span> testCreateClient()<span class="ot">:</span> <span class="dt">void</span></span>
+<span id="cb61-2"><a href="#cb61-2" aria-hidden="true" tabindex="-1"></a>{</span>
+<span id="cb61-3"><a href="#cb61-3" aria-hidden="true" tabindex="-1"></a>    <span class="va">$client</span> <span class="op">=</span> <span class="kw">static</span>::createClient()<span class="ot">;</span></span>
+<span id="cb61-4"><a href="#cb61-4" aria-hidden="true" tabindex="-1"></a>    <span class="va">$client</span>-&gt;request(<span class="st">&#39;POST&#39;</span><span class="ot">,</span> <span class="st">&#39;/clients&#39;</span><span class="ot">,</span> [</span>
+<span id="cb61-5"><a href="#cb61-5" aria-hidden="true" tabindex="-1"></a>        <span class="st">&#39;json&#39;</span> =&gt; [</span>
+<span id="cb61-6"><a href="#cb61-6" aria-hidden="true" tabindex="-1"></a>            <span class="st">&#39;name&#39;</span> =&gt; <span class="st">&#39;Test Client&#39;</span><span class="ot">,</span></span>
+<span id="cb61-7"><a href="#cb61-7" aria-hidden="true" tabindex="-1"></a>            <span class="st">&#39;mac&#39;</span> =&gt; <span class="st">&#39;00:11:22:33:44:55&#39;</span><span class="ot">,</span></span>
+<span id="cb61-8"><a href="#cb61-8" aria-hidden="true" tabindex="-1"></a>            <span class="st">&#39;ip&#39;</span> =&gt; <span class="st">&#39;192.168.1.100&#39;</span></span>
+<span id="cb61-9"><a href="#cb61-9" aria-hidden="true" tabindex="-1"></a>        ]</span>
+<span id="cb61-10"><a href="#cb61-10" aria-hidden="true" tabindex="-1"></a>    ])<span class="ot">;</span></span>
+<span id="cb61-11"><a href="#cb61-11" aria-hidden="true" tabindex="-1"></a>    </span>
+<span id="cb61-12"><a href="#cb61-12" aria-hidden="true" tabindex="-1"></a>    <span class="va">$this</span>-&gt;assertResponseStatusCodeSame(<span class="dv">201</span>)<span class="ot">;</span></span>
+<span id="cb61-13"><a href="#cb61-13" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
+<h3 data-number="1.15.4" id="factories-para-testing"><span
+class="header-section-number">1.15.4</span> 14.4 Factories para
+Testing</h3>
+<p>Se utilizan <strong>Zenstruck Foundry</strong> factories (24
+factories) para crear datos de prueba:</p>
+<div class="sourceCode" id="cb62"><pre
+class="sourceCode php"><code class="sourceCode php"><span id="cb62-1"><a href="#cb62-1" aria-hidden="true" tabindex="-1"></a><span class="cn">C</span>lientFactory::createOne([</span>
+<span id="cb62-2"><a href="#cb62-2" aria-hidden="true" tabindex="-1"></a>    <span class="st">&#39;name&#39;</span> =&gt; <span class="st">&#39;Test PC&#39;</span><span class="ot">,</span></span>
+<span id="cb62-3"><a href="#cb62-3" aria-hidden="true" tabindex="-1"></a>    <span class="st">&#39;status&#39;</span> =&gt; <span class="st">&#39;active&#39;</span></span>
+<span id="cb62-4"><a href="#cb62-4" aria-hidden="true" tabindex="-1"></a>])<span class="ot">;</span></span></code></pre></div>
+<h3 data-number="1.15.5" id="base-de-datos-de-testing"><span
+class="header-section-number">1.15.5</span> 14.5 Base de Datos de
+Testing</h3>
+<p>Los tests utilizan <strong>DAMA Doctrine Test Bundle</strong> para: -
+Ejecutar cada test en una transacción - Rollback automático después de
+cada test - Aislamiento completo entre tests</p>
+<hr />
+<h2 data-number="1.16" id="despliegue"><span
+class="header-section-number">1.16</span> 15. Despliegue</h2>
+<h3 data-number="1.16.1" id="despliegue-con-docker-compose"><span
+class="header-section-number">1.16.1</span> 15.1 Despliegue con Docker
+Compose</h3>
+<h4 data-number="1.16.1.1" id="desarrollo-1"><span
+class="header-section-number">1.16.1.1</span> 15.1.1 Desarrollo</h4>
+<div class="sourceCode" id="cb63"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb63-1"><a href="#cb63-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> compose up <span class="at">-d</span></span></code></pre></div>
+<h4 data-number="1.16.1.2" id="producción"><span
+class="header-section-number">1.16.1.2</span> 15.1.2 Producción</h4>
+<div class="sourceCode" id="cb64"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb64-1"><a href="#cb64-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> compose <span class="at">-f</span> docker-compose-deploy.yml up <span class="at">-d</span></span></code></pre></div>
+<h3 data-number="1.16.2" id="despliegue-con-jenkins"><span
+class="header-section-number">1.16.2</span> 15.2 Despliegue con
+Jenkins</h3>
+<p>El proyecto incluye <strong>Jenkinsfile</strong> para CI/CD.</p>
+<h4 data-number="1.16.2.1" id="pipeline-stages"><span
+class="header-section-number">1.16.2.1</span> Pipeline stages:</h4>
+<ol type="1">
+<li><strong>Checkout</strong>: Clonar repositorio</li>
+<li><strong>Build</strong>: Construir imagen Docker</li>
+<li><strong>Test</strong>: Ejecutar tests</li>
+<li><strong>Package</strong>: Crear paquete Debian</li>
+<li><strong>Deploy</strong>: Desplegar en servidor</li>
+</ol>
+<h3 data-number="1.16.3" id="paquete-debian"><span
+class="header-section-number">1.16.3</span> 15.3 Paquete Debian</h3>
+<p>El proyecto puede empaquetarse como <code>.deb</code>:</p>
+<div class="sourceCode" id="cb65"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb65-1"><a href="#cb65-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./package.sh</span></span></code></pre></div>
+<p>Estructura del paquete en <code>debian/</code>: - Control files -
+Postinst/preinst scripts - Systemd service file - Configuración</p>
+<h3 data-number="1.16.4" id="configuración-de-producción"><span
+class="header-section-number">1.16.4</span> 15.4 Configuración de
+Producción</h3>
+<h4 data-number="1.16.4.1" id="variables-de-entorno-1"><span
+class="header-section-number">1.16.4.1</span> 15.4.1 Variables de
+Entorno</h4>
+<p>Crear <code>.env.local</code> con configuración de producción:</p>
+<div class="sourceCode" id="cb66"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb66-1"><a href="#cb66-1" aria-hidden="true" tabindex="-1"></a><span class="va">APP_ENV</span><span class="op">=</span>prod</span>
+<span id="cb66-2"><a href="#cb66-2" aria-hidden="true" tabindex="-1"></a><span class="va">APP_DEBUG</span><span class="op">=</span>0</span>
+<span id="cb66-3"><a href="#cb66-3" aria-hidden="true" tabindex="-1"></a><span class="va">DATABASE_URL</span><span class="op">=</span><span class="st">&quot;mysql://user:pass@localhost:3306/ogcore&quot;</span></span>
+<span id="cb66-4"><a href="#cb66-4" aria-hidden="true" tabindex="-1"></a><span class="co"># ... más configuración</span></span></code></pre></div>
+<h4 data-number="1.16.4.2" id="optimizaciones"><span
+class="header-section-number">1.16.4.2</span> 15.4.2 Optimizaciones</h4>
+<div class="sourceCode" id="cb67"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb67-1"><a href="#cb67-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Limpiar caché</span></span>
+<span id="cb67-2"><a href="#cb67-2" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console cache:clear <span class="at">--env</span><span class="op">=</span>prod</span>
+<span id="cb67-3"><a href="#cb67-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb67-4"><a href="#cb67-4" aria-hidden="true" tabindex="-1"></a><span class="co"># Calentar caché</span></span>
+<span id="cb67-5"><a href="#cb67-5" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console cache:warmup <span class="at">--env</span><span class="op">=</span>prod</span>
+<span id="cb67-6"><a href="#cb67-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb67-7"><a href="#cb67-7" aria-hidden="true" tabindex="-1"></a><span class="co"># Optimizar autoloader</span></span>
+<span id="cb67-8"><a href="#cb67-8" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php composer dump-autoload <span class="at">--optimize</span> <span class="at">--classmap-authoritative</span></span></code></pre></div>
+<h3 data-number="1.16.5" id="monitoreo"><span
+class="header-section-number">1.16.5</span> 15.5 Monitoreo</h3>
+<h4 data-number="1.16.5.1" id="logs"><span
+class="header-section-number">1.16.5.1</span> 15.5.1 Logs</h4>
+<p>Logs ubicados en <code>var/log/</code>: - <code>dev.log</code> /
+<code>prod.log</code>: Logs de aplicación -
+<code>nginx/access.log</code>: Accesos a nginx -
+<code>nginx/error.log</code>: Errores de nginx</p>
+<h4 data-number="1.16.5.2" id="syslog"><span
+class="header-section-number">1.16.5.2</span> 15.5.2 Syslog</h4>
+<p>Los logs también se envían a syslog para centralización.</p>
+<h3 data-number="1.16.6" id="escalabilidad"><span
+class="header-section-number">1.16.6</span> 15.6 Escalabilidad</h3>
+<p>Para escalar horizontalmente:</p>
+<ol type="1">
+<li><strong>Base de datos</strong>: Usar MariaDB con replicación
+master-slave</li>
+<li><strong>PHP</strong>: Aumentar réplicas de contenedor PHP</li>
+<li><strong>Load Balancer</strong>: Usar nginx como balanceador de
+carga</li>
+<li><strong>Caché</strong>: Implementar Redis para sesiones y caché</li>
+<li><strong>Mercure</strong>: Escalar hub de Mercure</li>
+</ol>
+<hr />
+<h2 data-number="1.17" id="mantenimiento-y-operaciones"><span
+class="header-section-number">1.17</span> 16. Mantenimiento y
+Operaciones</h2>
+<h3 data-number="1.17.1" id="reiniciar-base-de-datos"><span
+class="header-section-number">1.17.1</span> 16.1 Reiniciar Base de
+Datos</h3>
+<div class="sourceCode" id="cb68"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb68-1"><a href="#cb68-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:database:drop <span class="at">--force</span></span>
+<span id="cb68-2"><a href="#cb68-2" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:database:create</span>
+<span id="cb68-3"><a href="#cb68-3" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:migrations:migrate <span class="at">--no-interaction</span></span>
+<span id="cb68-4"><a href="#cb68-4" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console doctrine:fixtures:load <span class="at">--no-interaction</span></span></code></pre></div>
+<h3 data-number="1.17.2" id="limpiar-caché"><span
+class="header-section-number">1.17.2</span> 16.2 Limpiar Caché</h3>
+<div class="sourceCode" id="cb69"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb69-1"><a href="#cb69-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console cache:clear</span>
+<span id="cb69-2"><a href="#cb69-2" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console cache:warmup</span></code></pre></div>
+<h3 data-number="1.17.3" id="actualizar-dependencias"><span
+class="header-section-number">1.17.3</span> 16.3 Actualizar
+Dependencias</h3>
+<div class="sourceCode" id="cb70"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb70-1"><a href="#cb70-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php composer update</span></code></pre></div>
+<h3 data-number="1.17.4" id="regenerar-claves-jwt"><span
+class="header-section-number">1.17.4</span> 16.4 Regenerar Claves
+JWT</h3>
+<div class="sourceCode" id="cb71"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb71-1"><a href="#cb71-1" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php bin/console lexik:jwt:generate-keypair <span class="at">--overwrite</span></span></code></pre></div>
+<h3 data-number="1.17.5" id="backups-automáticos"><span
+class="header-section-number">1.17.5</span> 16.5 Backups
+Automáticos</h3>
+<p>Script ejemplo para backup automático:</p>
+<div class="sourceCode" id="cb72"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb72-1"><a href="#cb72-1" aria-hidden="true" tabindex="-1"></a><span class="co">#!/bin/bash</span></span>
+<span id="cb72-2"><a href="#cb72-2" aria-hidden="true" tabindex="-1"></a><span class="va">DATE</span><span class="op">=</span><span class="va">$(</span><span class="fu">date</span> +%Y%m%d_%H%M%S<span class="va">)</span></span>
+<span id="cb72-3"><a href="#cb72-3" aria-hidden="true" tabindex="-1"></a><span class="va">BACKUP_DIR</span><span class="op">=</span><span class="st">&quot;/backups&quot;</span></span>
+<span id="cb72-4"><a href="#cb72-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb72-5"><a href="#cb72-5" aria-hidden="true" tabindex="-1"></a><span class="co"># Backup de base de datos</span></span>
+<span id="cb72-6"><a href="#cb72-6" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-database mysqldump <span class="at">-u</span> user <span class="at">-p</span> password ogcore <span class="op">&gt;</span> <span class="va">$BACKUP_DIR</span>/db_<span class="va">$DATE</span>.sql</span>
+<span id="cb72-7"><a href="#cb72-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb72-8"><a href="#cb72-8" aria-hidden="true" tabindex="-1"></a><span class="co"># Backup de archivos</span></span>
+<span id="cb72-9"><a href="#cb72-9" aria-hidden="true" tabindex="-1"></a><span class="fu">tar</span> <span class="at">-czf</span> <span class="va">$BACKUP_DIR</span>/files_<span class="va">$DATE</span>.tar.gz /var/www/html/ogcore/var</span>
+<span id="cb72-10"><a href="#cb72-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb72-11"><a href="#cb72-11" aria-hidden="true" tabindex="-1"></a><span class="co"># Limpiar backups antiguos (&gt;30 días)</span></span>
+<span id="cb72-12"><a href="#cb72-12" aria-hidden="true" tabindex="-1"></a><span class="fu">find</span> <span class="va">$BACKUP_DIR</span> <span class="at">-name</span> <span class="st">&quot;*.sql&quot;</span> <span class="at">-mtime</span> +30 <span class="at">-delete</span></span>
+<span id="cb72-13"><a href="#cb72-13" aria-hidden="true" tabindex="-1"></a><span class="fu">find</span> <span class="va">$BACKUP_DIR</span> <span class="at">-name</span> <span class="st">&quot;*.tar.gz&quot;</span> <span class="at">-mtime</span> +30 <span class="at">-delete</span></span></code></pre></div>
+<h3 data-number="1.17.6" id="monitoreo-de-salud"><span
+class="header-section-number">1.17.6</span> 16.6 Monitoreo de Salud</h3>
+<h4 data-number="1.17.6.1" id="health-check-endpoint"><span
+class="header-section-number">1.17.6.1</span> Health Check Endpoint</h4>
+<div class="sourceCode" id="cb73"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb73-1"><a href="#cb73-1" aria-hidden="true" tabindex="-1"></a><span class="ex">GET</span> /health</span></code></pre></div>
+<h4 data-number="1.17.6.2" id="verificar-estado-de-servicios"><span
+class="header-section-number">1.17.6.2</span> Verificar Estado de
+Servicios</h4>
+<div class="sourceCode" id="cb74"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb74-1"><a href="#cb74-1" aria-hidden="true" tabindex="-1"></a><span class="co"># PHP</span></span>
+<span id="cb74-2"><a href="#cb74-2" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-php php <span class="at">-v</span></span>
+<span id="cb74-3"><a href="#cb74-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb74-4"><a href="#cb74-4" aria-hidden="true" tabindex="-1"></a><span class="co"># Nginx</span></span>
+<span id="cb74-5"><a href="#cb74-5" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-nginx nginx <span class="at">-t</span></span>
+<span id="cb74-6"><a href="#cb74-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb74-7"><a href="#cb74-7" aria-hidden="true" tabindex="-1"></a><span class="co"># MariaDB</span></span>
+<span id="cb74-8"><a href="#cb74-8" aria-hidden="true" tabindex="-1"></a><span class="ex">docker</span> exec ogcore-database mysqladmin <span class="at">-u</span> user <span class="at">-p</span> status</span></code></pre></div>
+<h3 data-number="1.17.7" id="rotación-de-logs"><span
+class="header-section-number">1.17.7</span> 16.7 Rotación de Logs</h3>
+<p>Configurar logrotate:</p>
+<div class="sourceCode" id="cb75"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb75-1"><a href="#cb75-1" aria-hidden="true" tabindex="-1"></a><span class="ex">/var/www/html/ogcore/var/log/*.log</span> {</span>
+<span id="cb75-2"><a href="#cb75-2" aria-hidden="true" tabindex="-1"></a>    <span class="ex">daily</span></span>
+<span id="cb75-3"><a href="#cb75-3" aria-hidden="true" tabindex="-1"></a>    <span class="ex">rotate</span> 14</span>
+<span id="cb75-4"><a href="#cb75-4" aria-hidden="true" tabindex="-1"></a>    <span class="ex">compress</span></span>
+<span id="cb75-5"><a href="#cb75-5" aria-hidden="true" tabindex="-1"></a>    <span class="ex">delaycompress</span></span>
+<span id="cb75-6"><a href="#cb75-6" aria-hidden="true" tabindex="-1"></a>    <span class="ex">notifempty</span></span>
+<span id="cb75-7"><a href="#cb75-7" aria-hidden="true" tabindex="-1"></a>    <span class="ex">create</span> 0640 www-data www-data</span>
+<span id="cb75-8"><a href="#cb75-8" aria-hidden="true" tabindex="-1"></a>    <span class="ex">sharedscripts</span></span>
+<span id="cb75-9"><a href="#cb75-9" aria-hidden="true" tabindex="-1"></a><span class="er">}</span></span></code></pre></div>
+<hr />
+<h2 data-number="1.18" id="integración-con-otros-servicios"><span
+class="header-section-number">1.18</span> 17. Integración con Otros
+Servicios</h2>
+<h3 data-number="1.18.1" id="ogrepository"><span
+class="header-section-number">1.18.1</span> 17.1 ogRepository</h3>
+<p><strong>Propósito</strong>: Gestión de repositorios de imágenes.</p>
+<p><strong>Endpoints integrados</strong>: - Crear imagen - Desplegar
+imagen - Backup imagen - Eliminar imagen - Convertir a imagen virtual -
+Importar imagen externa - Verificar integridad - Imagen global</p>
+<p><strong>Webhook</strong>: <code>/og-repository/webhook</code></p>
+<h3 data-number="1.18.2" id="ogdhcp"><span
+class="header-section-number">1.18.2</span> 17.2 ogDhcp</h3>
+<p><strong>Propósito</strong>: Gestión de DHCP dinámico.</p>
+<p><strong>Funcionalidades</strong>: - Agregar clientes a DHCP -
+Eliminar clientes de DHCP - Actualizar configuración - Gestión de
+subredes</p>
+<h3 data-number="1.18.3" id="ogboot"><span
+class="header-section-number">1.18.3</span> 17.3 ogBoot</h3>
+<p><strong>Propósito</strong>: Gestión de archivos de arranque PXE.</p>
+<p><strong>Funcionalidades</strong>: - Crear archivos de arranque -
+Actualizar plantillas PXE - Eliminar configuraciones - Sincronización de
+menús</p>
+<h3 data-number="1.18.4" id="ogagent"><span
+class="header-section-number">1.18.4</span> 17.4 ogAgent</h3>
+<p><strong>Propósito</strong>: Agente instalado en clientes para
+ejecutar comandos.</p>
+<p><strong>Operaciones</strong>: - Power on/off/reboot - Crear/desplegar
+imágenes - Particionar discos - Ejecutar scripts - Obtener inventario
+hardware - Verificar tamaño de particiones - Kill jobs</p>
+<h3 data-number="1.18.5" id="uds-universal-desktop-services"><span
+class="header-section-number">1.18.5</span> 17.5 UDS (Universal Desktop
+Services)</h3>
+<p><strong>Propósito</strong>: Integración con sistema de escritorios
+remotos.</p>
+<p><strong>Funcionalidades</strong>: - Autenticación - Obtener service
+pools - Calcular disponibilidad - Gestión de reservas</p>
+<h3 data-number="1.18.6" id="git-versionado-de-imágenes"><span
+class="header-section-number">1.18.6</span> 17.6 Git (Versionado de
+Imágenes)</h3>
+<p><strong>Propósito</strong>: Versionado de imágenes con Git.</p>
+<p><strong>Funcionalidades</strong>: - Backup a repositorio Git -
+Versionado automático - Recuperación de versiones - Sincronización</p>
+<h3 data-number="1.18.7"
+id="mercure-notificaciones-en-tiempo-real"><span
+class="header-section-number">1.18.7</span> 17.7 Mercure (Notificaciones
+en Tiempo Real)</h3>
+<p><strong>Propósito</strong>: Notificaciones push en tiempo real.</p>
+<p><strong>Eventos publicados</strong>: - Cambio de estado de clientes -
+Actualización de trazas - Cambios en comandos - Alertas y
+notificaciones</p>
+<p><strong>Suscripción del cliente</strong>:</p>
+<div class="sourceCode" id="cb76"><pre
+class="sourceCode javascript"><code class="sourceCode javascript"><span id="cb76-1"><a href="#cb76-1" aria-hidden="true" tabindex="-1"></a><span class="kw">const</span> eventSource <span class="op">=</span> <span class="kw">new</span> <span class="bu">EventSource</span>(<span class="st">&#39;http://localhost:8080/.well-known/mercure?topic=/clients/{id}&#39;</span>)<span class="op">;</span></span>
+<span id="cb76-2"><a href="#cb76-2" aria-hidden="true" tabindex="-1"></a>eventSource<span class="op">.</span><span class="at">onmessage</span> <span class="op">=</span> <span class="bu">event</span> <span class="kw">=&gt;</span> {</span>
+<span id="cb76-3"><a href="#cb76-3" aria-hidden="true" tabindex="-1"></a>    <span class="kw">const</span> data <span class="op">=</span> <span class="bu">JSON</span><span class="op">.</span><span class="fu">parse</span>(<span class="bu">event</span><span class="op">.</span><span class="at">data</span>)<span class="op">;</span></span>
+<span id="cb76-4"><a href="#cb76-4" aria-hidden="true" tabindex="-1"></a>    <span class="bu">console</span><span class="op">.</span><span class="fu">log</span>(<span class="st">&#39;Client updated:&#39;</span><span class="op">,</span> data)<span class="op">;</span></span>
+<span id="cb76-5"><a href="#cb76-5" aria-hidden="true" tabindex="-1"></a>}<span class="op">;</span></span></code></pre></div>
+<hr />
+<h2 data-number="1.19" id="roadmap-y-changelog"><span
+class="header-section-number">1.19</span> 18. Roadmap y Changelog</h2>
+<h3 data-number="1.19.1" id="versión-actual-0.5.0"><span
+class="header-section-number">1.19.1</span> 18.1 Versión Actual:
+0.5.0</h3>
+<h3 data-number="1.19.2"
+id="últimas-características-v0.25.1---octubre-2025"><span
+class="header-section-number">1.19.2</span> 18.2 Últimas Características
+(v0.25.1 - Octubre 2025)</h3>
+<ul>
+<li><strong>Tareas programadas</strong>: Sistema completo de colas y
+scheduling</li>
+<li><strong>Inventario hardware</strong>: Obtención automática de
+inventario</li>
+<li><strong>Clonado de imágenes</strong>: Mejoras en el servicio de
+clonado</li>
+<li><strong>Repositorios Git</strong>: Backup y gestión de
+repositorios</li>
+<li><strong>Particionado</strong>: Integración con agente para scripts
+de particionado</li>
+<li><strong>Gestión de trazas</strong>: Marcar como completadas,
+cancelación</li>
+<li><strong>Estados de cliente</strong>: Nuevo estado “enviado” para
+Windows/Linux</li>
+<li><strong>Validación de particiones</strong>: Comprobación de
+tamaños</li>
+<li><strong>Imagen versionada</strong>: Sistema de versionado de
+imágenes</li>
+<li><strong>Calendario remoto</strong>: Integración con UDS</li>
+<li><strong>Mercure</strong>: Notificaciones en tiempo real</li>
+<li><strong>Despliegue multicast</strong>: Modos torrent y UDPCAST</li>
+</ul>
+<h3 data-number="1.19.3" id="próximas-características-roadmap"><span
+class="header-section-number">1.19.3</span> 18.3 Próximas
+Características (Roadmap)</h3>
+<h4 data-number="1.19.3.1" id="v0.6.0-q4-2025"><span
+class="header-section-number">1.19.3.1</span> v0.6.0 (Q4 2025)</h4>
+<ul class="task-list">
+<li><label><input type="checkbox" />Dashboard de administración
+mejorado</label></li>
+<li><label><input type="checkbox" />Reportes y estadísticas
+avanzadas</label></li>
+<li><label><input type="checkbox" />API GraphQL
+complementaria</label></li>
+<li><label><input type="checkbox" />Mejoras en rendimiento de
+queries</label></li>
+</ul>
+<h4 data-number="1.19.3.2" id="v0.7.0-q1-2026"><span
+class="header-section-number">1.19.3.2</span> v0.7.0 (Q1 2026)</h4>
+<ul class="task-list">
+<li><label><input type="checkbox" />Soporte para múltiples lenguajes
+(i18n completo)</label></li>
+<li><label><input type="checkbox" />Sistema de plugins</label></li>
+<li><label><input type="checkbox" />Mejoras en clustering</label></li>
+<li><label><input type="checkbox" />API de webhooks
+salientes</label></li>
+</ul>
+<h4 data-number="1.19.3.3" id="v1.0.0-q2-2026"><span
+class="header-section-number">1.19.3.3</span> v1.0.0 (Q2 2026)</h4>
+<ul class="task-list">
+<li><label><input type="checkbox" />Versión estable de
+producción</label></li>
+<li><label><input type="checkbox" />Documentación completa de
+API</label></li>
+<li><label><input type="checkbox" />Guías de migración
+finalizadas</label></li>
+<li><label><input type="checkbox" />Certificación de
+seguridad</label></li>
+</ul>
+<h3 data-number="1.19.4" id="changelog-resumido"><span
+class="header-section-number">1.19.4</span> 18.4 Changelog Resumido</h3>
+<p>Ver <code>CHANGELOG.md</code> para el historial completo de
+cambios.</p>
+<p><strong>Versiones destacadas</strong>:</p>
+<ul>
+<li><strong>0.25.1</strong> (2025-10-01): Correcciones en tareas
+programadas</li>
+<li><strong>0.25.0</strong> (2025-09-23): Inventario hardware</li>
+<li><strong>0.24.0</strong> (2025-09-09): Servicio de eliminación de
+repositorios Git</li>
+<li><strong>0.23.0</strong> (2025-09-08): Backups a repositorios
+Git</li>
+<li><strong>0.20.0</strong> (2025-08-25): Sistema de colas y tareas</li>
+<li><strong>0.15.0</strong> (2025-06-26): Integración ogGit y sistema de
+cola</li>
+<li><strong>0.14.0</strong> (2025-06-02): Mover equipos, imagen cache,
+inicio sesión</li>
+<li><strong>0.13.0</strong> (2025-05-20): Comunicación TLS con
+agente</li>
+<li><strong>0.12.0</strong> (2025-05-13): Tareas programadas,
+integración ogGit</li>
+<li><strong>0.11.0</strong> (2025-04-11): Versionado de imágenes,
+ejecución de scripts</li>
+<li><strong>0.10.0</strong> (2025-03-25): Imagen virtual, importar
+imágenes</li>
+<li><strong>0.9.0</strong> (2025-03-04): Mercure, notificaciones en
+tiempo real</li>
+<li><strong>0.8.0</strong> (2025-01-10): Imagen global, jerarquía de
+aulas</li>
+<li><strong>0.7.3</strong> (2025-01-03): Multiselección, import/export,
+torrent/udpcast</li>
+</ul>
+<hr />
+<h2 data-number="1.20" id="contribución"><span
+class="header-section-number">1.20</span> 19. Contribución</h2>
+<h3 data-number="1.20.1" id="guía-de-contribución"><span
+class="header-section-number">1.20.1</span> 19.1 Guía de
+Contribución</h3>
+<p>Para contribuir al proyecto:</p>
+<ol type="1">
+<li><strong>Fork</strong> el repositorio</li>
+<li>Crea una <strong>rama</strong> para tu feature:
+<code>git checkout -b feature/nueva-funcionalidad</code></li>
+<li><strong>Commit</strong> tus cambios:
+<code>git commit -am 'Añade nueva funcionalidad'</code></li>
+<li><strong>Push</strong> a la rama:
+<code>git push origin feature/nueva-funcionalidad</code></li>
+<li>Crea un <strong>Pull Request</strong></li>
+</ol>
+<h3 data-number="1.20.2" id="estándares-de-código"><span
+class="header-section-number">1.20.2</span> 19.2 Estándares de
+Código</h3>
+<ul>
+<li>Seguir <strong>PSR-12</strong> para PHP</li>
+<li>Usar <strong>Type Hints</strong> en PHP 8.3</li>
+<li>Documentar con <strong>PHPDoc</strong></li>
+<li>Tests para nuevas funcionalidades</li>
+<li>Commits descriptivos en español</li>
+</ul>
+<h3 data-number="1.20.3" id="proceso-de-revisión"><span
+class="header-section-number">1.20.3</span> 19.3 Proceso de
+Revisión</h3>
+<ol type="1">
+<li>CI/CD ejecuta tests automáticamente</li>
+<li>Revisión de código por maintainers</li>
+<li>Aprobación requerida antes de merge</li>
+<li>Merge a rama develop</li>
+<li>Release periódicos a main</li>
+</ol>
+<h3 data-number="1.20.4" id="reportar-bugs"><span
+class="header-section-number">1.20.4</span> 19.4 Reportar Bugs</h3>
+<p>Usar el sistema de Issues del repositorio:</p>
+<p><strong>Template de Bug</strong>:</p>
+<pre><code>**Descripción del bug**
+Descripción clara y concisa del bug.
+
+**Pasos para reproducir**
+1. Ir a &#39;...&#39;
+2. Hacer clic en &#39;...&#39;
+3. Ver error
+
+**Comportamiento esperado**
+Lo que esperabas que sucediera.
+
+**Screenshots**
+Si aplica, añadir screenshots.
+
+**Entorno**
+- OS: [ej. Ubuntu 22.04]
+- Versión: [ej. 0.5.0]
+- Browser: [ej. Firefox 118]</code></pre>
+<hr />
+<h2 data-number="1.21" id="soporte-y-contacto"><span
+class="header-section-number">1.21</span> 20. Soporte y Contacto</h2>
+<h3 data-number="1.21.1" id="documentación-adicional"><span
+class="header-section-number">1.21.1</span> 20.1 Documentación
+Adicional</h3>
+<ul>
+<li><strong>API Docs</strong>: http://localhost:8080/docs</li>
+<li><strong>Postman Collection</strong>:
+<code>swagger-assets/ogCore.postman_collection.zip</code></li>
+<li><strong>Diagramas</strong>:
+<code>swagger-assets/img_bbdd.png</code></li>
+</ul>
+<h3 data-number="1.21.2" id="recursos"><span
+class="header-section-number">1.21.2</span> 20.2 Recursos</h3>
+<ul>
+<li><strong>Repositorio</strong>: [URL del repositorio]</li>
+<li><strong>Wiki</strong>: [URL de la wiki]</li>
+<li><strong>Issues</strong>: [URL de issues]</li>
+</ul>
+<h3 data-number="1.21.3" id="equipo-de-desarrollo"><span
+class="header-section-number">1.21.3</span> 20.3 Equipo de
+Desarrollo</h3>
+<p>Proyecto desarrollado por el equipo de OpenGnsys en colaboración con
+universidades participantes.</p>
+<h3 data-number="1.21.4" id="licencia"><span
+class="header-section-number">1.21.4</span> 20.4 Licencia</h3>
+<p>Proyecto propietario. Ver archivo <code>LICENSE</code> para más
+información.</p>
+<hr />
+<h2 data-number="1.22" id="apéndices"><span
+class="header-section-number">1.22</span> Apéndices</h2>
+<h3 data-number="1.22.1" id="apéndice-a-glosario-de-términos"><span
+class="header-section-number">1.22.1</span> Apéndice A: Glosario de
+Términos</h3>
+<ul>
+<li><strong>Cliente</strong>: Equipo físico gestionado por el
+sistema</li>
+<li><strong>Imagen</strong>: Copia bit a bit de una partición de
+disco</li>
+<li><strong>Traza</strong>: Registro de ejecución de un comando</li>
+<li><strong>Unidad Organizativa</strong>: Agrupación lógica de clientes
+(aula, grupo)</li>
+<li><strong>PXE</strong>: Preboot Execution Environment, arranque por
+red</li>
+<li><strong>ogLive</strong>: Imagen Live de arranque de OpenGnsys</li>
+<li><strong>Partición</strong>: División lógica de un disco duro</li>
+<li><strong>Repositorio</strong>: Servidor de almacenamiento de
+imágenes</li>
+</ul>
+<h3 data-number="1.22.2" id="apéndice-b-puertos-y-servicios"><span
+class="header-section-number">1.22.2</span> Apéndice B: Puertos y
+Servicios</h3>
+<table>
+<thead>
+<tr class="header">
+<th>Puerto</th>
+<th>Servicio</th>
+<th>Protocolo</th>
+<th>Descripción</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td>8080</td>
+<td>nginx</td>
+<td>HTTP</td>
+<td>API y docs</td>
+</tr>
+<tr class="even">
+<td>3306</td>
+<td>MariaDB</td>
+<td>MySQL</td>
+<td>Base de datos</td>
+</tr>
+<tr class="odd">
+<td>9000</td>
+<td>PHP-FPM</td>
+<td>FastCGI</td>
+<td>Procesador PHP</td>
+</tr>
+<tr class="even">
+<td>3000</td>
+<td>Mercure</td>
+<td>HTTP/SSE</td>
+<td>Notificaciones</td>
+</tr>
+</tbody>
+</table>
+<h3 data-number="1.22.3" id="apéndice-c-estructura-de-directorios"><span
+class="header-section-number">1.22.3</span> Apéndice C: Estructura de
+Directorios</h3>
+<pre><code>ogcore/
+├── bin/              # Ejecutables (console, phpunit)
+├── config/           # Configuración de Symfony
+│   ├── api_platform/ # Configuración de entidades API
+│   ├── packages/     # Configuración de bundles
+│   └── routes/       # Rutas
+├── migrations/       # Migraciones de base de datos
+├── public/           # Punto de entrada web
+├── src/              # Código fuente
+│   ├── Command/      # Comandos de consola
+│   ├── Controller/   # Controladores
+│   ├── Dto/          # Data Transfer Objects
+│   ├── Entity/       # Entidades Doctrine
+│   ├── EventListener/# Event Listeners
+│   ├── EventSubscriber/ # Event Subscribers
+│   ├── Factory/      # Factories para testing
+│   ├── Filter/       # Filtros de API Platform
+│   ├── Repository/   # Repositorios Doctrine
+│   ├── Security/     # Seguridad y autenticación
+│   ├── Service/      # Servicios de negocio
+│   ├── State/        # States de API Platform
+│   └── Validator/    # Validadores personalizados
+├── tests/            # Tests
+├── translations/     # Traducciones
+├── var/              # Archivos variables (cache, logs)
+└── vendor/           # Dependencias
+</code></pre>
+<h3 data-number="1.22.4"
+id="apéndice-d-variables-de-entorno-completas"><span
+class="header-section-number">1.22.4</span> Apéndice D: Variables de
+Entorno Completas</h3>
+<p>Ver archivo <code>.env</code> para todas las variables de entorno
+disponibles.</p>
+<hr />
+<p><strong>Fecha de actualización</strong>: Octubre 2025<br />
+<strong>Versión del documento</strong>: 1.0<br />
+<strong>Mantenedor</strong>: Equipo OpenGnsys</p>
+</body>
+</html>
diff --git a/ogCore_Documentacion_Tecnica.pdf b/ogCore_Documentacion_Tecnica.pdf
new file mode 100644
index 0000000..a3c6a00
Binary files /dev/null and b/ogCore_Documentacion_Tecnica.pdf differ
diff --git a/src/Controller/OgBoot/PxeBootFile/PostAction.php b/src/Controller/OgBoot/PxeBootFile/PostAction.php
index 97c5575..1c172b9 100644
--- a/src/Controller/OgBoot/PxeBootFile/PostAction.php
+++ b/src/Controller/OgBoot/PxeBootFile/PostAction.php
@@ -3,11 +3,8 @@
 namespace App\Controller\OgBoot\PxeBootFile;
 
 use App\Controller\OgBoot\AbstractOgBootController;
-use App\Dto\Input\PxeTemplateSyncClientInput;
 use App\Entity\Client;
 use App\Entity\PxeTemplate;
-use Doctrine\ORM\EntityManagerInterface;
-use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\HttpKernel\Attribute\AsController;
@@ -15,7 +12,6 @@ use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\RedirectionExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\ServerExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
-use Symfony\Contracts\HttpClient\HttpClientInterface;
 
 #[AsController]
 class PostAction extends AbstractOgBootController
diff --git a/src/Dto/Input/BackupImageInput.php b/src/Dto/Input/BackupImageInput.php
index 32542ee..b269163 100644
--- a/src/Dto/Input/BackupImageInput.php
+++ b/src/Dto/Input/BackupImageInput.php
@@ -3,22 +3,21 @@
 namespace App\Dto\Input;
 
 use ApiPlatform\Metadata\ApiProperty;
-use App\Dto\Output\ClientOutput;
-use App\Dto\Output\ImageOutput;
-use App\Dto\Output\PartitionOutput;
-use App\Validator\Constraints\ClientsHaveSamePartitionCount;
-use App\Validator\Constraints\OrganizationalUnitMulticastMode;
-use App\Validator\Constraints\OrganizationalUnitMulticastPort;
-use App\Validator\Constraints\OrganizationalUnitP2PMode;
 use Symfony\Component\Serializer\Annotation\Groups;
 
 final class BackupImageInput
 {
     #[Groups(['image-image-repository:write'])]
-    #[ApiProperty(description: 'The repository ip', example: "")]
+    #[ApiProperty(
+        description: 'La IP del repositorio de destino',
+        example: '192.168.1.100'
+    )]
     public ?string $repoIp = null;
 
     #[Groups(['image-image-repository:write'])]
-    #[ApiProperty(description: 'The remote path', example: "")]
+    #[ApiProperty(
+        description: 'La ruta remota donde guardar el backup',
+        example: '/backups/images/'
+    )]
     public ?string $remotePath = null;
 }
\ No newline at end of file
diff --git a/src/Dto/Input/BootClientsInput.php b/src/Dto/Input/BootClientsInput.php
index a430967..7defc7d 100644
--- a/src/Dto/Input/BootClientsInput.php
+++ b/src/Dto/Input/BootClientsInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\ClientOutput;
 use App\Dto\Output\PartitionOutput;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -12,10 +13,17 @@ final class BootClientsInput
      * @var ClientOutput[]
      */
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'Los clientes a arrancar',
+        example: []
+    )]
     public array $clients = [];
 
-
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'La partición desde la que arrancar',
+        example: null
+    )]
     public ?PartitionOutput $partition = null;
 }
 
diff --git a/src/Dto/Input/CancelMultipleTracesInput.php b/src/Dto/Input/CancelMultipleTracesInput.php
index 825d804..c252370 100644
--- a/src/Dto/Input/CancelMultipleTracesInput.php
+++ b/src/Dto/Input/CancelMultipleTracesInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\TraceOutput;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
@@ -13,5 +14,9 @@ final class CancelMultipleTracesInput
      */
     #[Assert\NotNull]
     #[Groups(['trace:write'])]
+    #[ApiProperty(
+        description: 'Las trazas a cancelar',
+        example: []
+    )]
     public array $traces = [];
 }
diff --git a/src/Dto/Input/ChangeOrganizationalUnitInput.php b/src/Dto/Input/ChangeOrganizationalUnitInput.php
index 922e66b..0addc49 100644
--- a/src/Dto/Input/ChangeOrganizationalUnitInput.php
+++ b/src/Dto/Input/ChangeOrganizationalUnitInput.php
@@ -2,9 +2,9 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\ClientOutput;
 use App\Dto\Output\OrganizationalUnitOutput;
-use App\Entity\Client;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
 
@@ -15,9 +15,17 @@ final class ChangeOrganizationalUnitInput
      */
     #[Assert\GreaterThan(1)]
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'Los clientes a mover (mínimo 2)',
+        example: []
+    )]
     public ?array $clients = [];
 
     #[Assert\NotNull]
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'La nueva unidad organizativa de destino',
+        example: null
+    )]
     public ?OrganizationalUnitOutput $organizationalUnit = null;
 }
\ No newline at end of file
diff --git a/src/Dto/Input/CheckPartitionSizesInput.php b/src/Dto/Input/CheckPartitionSizesInput.php
index f2fd184..88a3919 100644
--- a/src/Dto/Input/CheckPartitionSizesInput.php
+++ b/src/Dto/Input/CheckPartitionSizesInput.php
@@ -2,7 +2,7 @@
 
 namespace App\Dto\Input;
 
-use App\Dto\Output\ClientOutput;
+use ApiPlatform\Metadata\ApiProperty;
 use Symfony\Component\Serializer\Annotation\Groups;
 
 final class CheckPartitionSizesInput
@@ -11,6 +11,10 @@ final class CheckPartitionSizesInput
      * @var PartitionInput[]
      */
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'Las particiones a verificar',
+        example: []
+    )]
     public array $partitions = [];
 
 }
diff --git a/src/Dto/Input/ClientInput.php b/src/Dto/Input/ClientInput.php
index f8cdac7..feb3a26 100644
--- a/src/Dto/Input/ClientInput.php
+++ b/src/Dto/Input/ClientInput.php
@@ -44,7 +44,7 @@ final class ClientInput
         description: 'El driver de red del cliente',
         example: 'e1000e'
     )]
-    public ?string $netDriver = null;
+    public ?string $netDriver = 'generic';
 
     #[Groups(['client:write'])]
     #[ApiProperty(
@@ -85,13 +85,7 @@ final class ClientInput
     #[ApiProperty(
         description: 'La plantilla PXE del cliente'
     )]
-    public ?PxeTemplateOutput $pxeTemplate = null;
-
-    #[Groups(['client:write'])]
-    #[ApiProperty(
-        description: 'El perfil de hardware del cliente'
-    )]
-    public ?HardwareProfileOutput $hardwareProfile = null;
+    public ?PxeTemplateOutput $pxeTemplate = null;  
 
     #[Groups(['client:write'])]
     #[ApiProperty(
@@ -146,10 +140,6 @@ final class ClientInput
             $this->pxeTemplate = new PxeTemplateOutput($client->getTemplate());
         }
 
-        if ($client->getHardwareProfile()) {
-            $this->hardwareProfile = new HardwareProfileOutput($client->getHardwareProfile());
-        }
-
         if ($client->getRepository()) {
             $this->repository = new ImageRepositoryOutput($client->getRepository());
         }
@@ -163,7 +153,6 @@ final class ClientInput
 
         $menu = $this->menu?->getEntity() ?? $client->getOrganizationalUnit()?->getNetworkSettings()?->getMenu();
         $ogLive = $this->ogLive?->getEntity() ?? $client->getOrganizationalUnit()?->getNetworkSettings()?->getOgLive();
-        $hardwareProfile = $this->hardwareProfile?->getEntity() ?? $client->getOrganizationalUnit()?->getNetworkSettings()?->getHardwareProfile();
         $repository = $this->repository?->getEntity() ?? $client->getOrganizationalUnit()?->getNetworkSettings()?->getRepository();
         $template = $this->pxeTemplate?->getEntity() ?? $client->getOrganizationalUnit()?->getNetworkSettings()?->getPxeTemplate();
 
@@ -176,7 +165,6 @@ final class ClientInput
         $client->setIp($this->ip);
         $client->setMenu($menu);
         $client->setOgLive($ogLive);
-        $client->setHardwareProfile($hardwareProfile);
         $client->setRepository($repository);
         $client->setTemplate($template);
         $client->setPosition($this->position);
diff --git a/src/Dto/Input/CommandExecuteInput.php b/src/Dto/Input/CommandExecuteInput.php
index eb21710..4f71b31 100644
--- a/src/Dto/Input/CommandExecuteInput.php
+++ b/src/Dto/Input/CommandExecuteInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\ClientOutput;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
@@ -13,13 +14,24 @@ final class CommandExecuteInput
      */
     #[Assert\NotNull]
     #[Groups(['command:write'])]
+    #[ApiProperty(
+        description: 'Los clientes donde ejecutar el comando',
+        example: []
+    )]
     public array $clients = [];
 
-
     #[Assert\NotNull]
     #[Groups(['command:write'])]
+    #[ApiProperty(
+        description: 'El script a ejecutar',
+        example: 'echo "Hello World"'
+    )]
     public string $script = '';
 
     #[Groups(['command:write'])]
+    #[ApiProperty(
+        description: 'Si encolar la ejecución del comando',
+        example: false
+    )]
     public bool $queue = false;
 }
\ No newline at end of file
diff --git a/src/Dto/Input/CommandGroupAddCommandsInput.php b/src/Dto/Input/CommandGroupAddCommandsInput.php
index 2b14a7b..0cc9964 100644
--- a/src/Dto/Input/CommandGroupAddCommandsInput.php
+++ b/src/Dto/Input/CommandGroupAddCommandsInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\CommandOutput;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
@@ -13,5 +14,9 @@ final class CommandGroupAddCommandsInput
      */
     #[Assert\NotNull]
     #[Groups(['command-group:write'])]
+    #[ApiProperty(
+        description: 'Los comandos a añadir al grupo',
+        example: []
+    )]
     public array $commands = [];
 }
\ No newline at end of file
diff --git a/src/Dto/Input/CommandGroupExecuteInput.php b/src/Dto/Input/CommandGroupExecuteInput.php
index 19dd317..17aca16 100644
--- a/src/Dto/Input/CommandGroupExecuteInput.php
+++ b/src/Dto/Input/CommandGroupExecuteInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\ClientOutput;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
@@ -13,5 +14,9 @@ final class CommandGroupExecuteInput
      */
     #[Assert\NotNull]
     #[Groups(['command-group:write'])]
+    #[ApiProperty(
+        description: 'Los clientes donde ejecutar el grupo de comandos',
+        example: []
+    )]
     public array $clients = [];
 }
\ No newline at end of file
diff --git a/src/Dto/Input/CommandTaskScheduleInput.php b/src/Dto/Input/CommandTaskScheduleInput.php
index afb0fde..5802b88 100644
--- a/src/Dto/Input/CommandTaskScheduleInput.php
+++ b/src/Dto/Input/CommandTaskScheduleInput.php
@@ -2,29 +2,53 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\CommandTaskOutput;
-use App\Dto\Output\CommandTaskScheduleOutput;
 use App\Entity\CommandTaskSchedule;
 use Symfony\Component\Serializer\Annotation\Groups;
 
 final class CommandTaskScheduleInput
 {
     #[Groups(['command-task-schedule:write'])]
+    #[ApiProperty(
+        description: 'La tarea de comando a programar',
+        example: null
+    )]
     public ?CommandTaskOutput $commandTask = null;
 
     #[Groups(['command-task-schedule:write'])]
+    #[ApiProperty(
+        description: 'El tipo de recurrencia de la programación',
+        example: 'daily'
+    )]
     public ?string $recurrenceType = null;
 
     #[Groups(['command-task-schedule:write'])]
+    #[ApiProperty(
+        description: 'La fecha de ejecución de la tarea',
+        example: '2024-01-15T00:00:00+00:00'
+    )]
     public ?\DateTimeInterface $executionDate = null;
 
     #[Groups(['command-task-schedule:write'])]
+    #[ApiProperty(
+        description: 'La hora de ejecución de la tarea',
+        example: '2024-01-15T09:00:00+00:00'
+    )]
     public ?\DateTimeInterface $executionTime = null;
 
     #[Groups(['command-task-schedule:write'])]
+    #[ApiProperty(
+        description: 'Los detalles de la recurrencia',
+        example: ['interval' => 1, 'days' => ['monday', 'wednesday', 'friday']]
+    )]
     public ?array $recurrenceDetails = null;
 
     #[Groups(['command-task-schedule:write'])]
+    #[ApiProperty(
+        description: 'Si la programación está habilitada',
+        example: true
+    )]
     public ?bool $enabled = null;
 
     public function __construct(?CommandTaskSchedule $commandTaskSchedule = null)
diff --git a/src/Dto/Input/CommandTaskScriptInput.php b/src/Dto/Input/CommandTaskScriptInput.php
index 8eb8583..d46f001 100644
--- a/src/Dto/Input/CommandTaskScriptInput.php
+++ b/src/Dto/Input/CommandTaskScriptInput.php
@@ -2,27 +2,46 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\CommandTaskOutput;
-use App\Dto\Output\CommandTaskScheduleOutput;
-use App\Entity\CommandTaskSchedule;
 use App\Entity\CommandTaskScript;
 use Symfony\Component\Serializer\Annotation\Groups;
 
 final class CommandTaskScriptInput
 {
     #[Groups(['command-task-script:write'])]
+    #[ApiProperty(
+        description: 'El contenido del script',
+        example: '#!/bin/bash\necho "Hello World"'
+    )]
     public ?string $content = null;
 
     #[Groups(['command-task-script:write'])]
+    #[ApiProperty(
+        description: 'El tipo de script',
+        example: 'bash'
+    )]
     public ?string $type = null;
 
     #[Groups(['command-task-script:write'])]
+    #[ApiProperty(
+        description: 'Los parámetros del script',
+        example: ['param1' => 'value1', 'param2' => 'value2']
+    )]
     public ?array $parameters = null;
 
     #[Groups(['command-task-script:write'])]
+    #[ApiProperty(
+        description: 'La tarea de comando asociada',
+        example: null
+    )]
     public ?CommandTaskOutput $commandTask = null;
 
     #[Groups(['command-task-script:write'])]
+    #[ApiProperty(
+        description: 'El orden de ejecución del script',
+        example: 1
+    )]
     public ?int $order = null;
 
     public function __construct(?CommandTaskScript $commandTaskScript = null)
diff --git a/src/Dto/Input/ConvertImageToVirtualInput.php b/src/Dto/Input/ConvertImageToVirtualInput.php
index d1d0e84..c86f598 100644
--- a/src/Dto/Input/ConvertImageToVirtualInput.php
+++ b/src/Dto/Input/ConvertImageToVirtualInput.php
@@ -2,8 +2,7 @@
 
 namespace App\Dto\Input;
 
-use App\Dto\Output\ImageOutput;
-use App\Dto\Output\ImageRepositoryOutput;
+use ApiPlatform\Metadata\ApiProperty;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
 
@@ -11,5 +10,9 @@ class ConvertImageToVirtualInput
 {
     #[Assert\NotNull]
     #[Groups(['image-image-repository:write'])]
+    #[ApiProperty(
+        description: 'La extensión del archivo virtual a generar',
+        example: 'qcow2'
+    )]
     public ?string $extension = '';
 }
\ No newline at end of file
diff --git a/src/Dto/Input/ExportImportImageRepositoryInput.php b/src/Dto/Input/ExportImportImageRepositoryInput.php
index 690500b..f115da4 100644
--- a/src/Dto/Input/ExportImportImageRepositoryInput.php
+++ b/src/Dto/Input/ExportImportImageRepositoryInput.php
@@ -2,8 +2,8 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\ImageOutput;
-use App\Dto\Output\ImageRepositoryOutput;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
 
@@ -14,5 +14,9 @@ class ExportImportImageRepositoryInput
      */
     #[Assert\NotNull]
     #[Groups(['repository:write'])]
+    #[ApiProperty(
+        description: 'Las imágenes a exportar o importar',
+        example: []
+    )]
     public array $images = [];
 }
\ No newline at end of file
diff --git a/src/Dto/Input/GetPartitionScriptDataInput.php b/src/Dto/Input/GetPartitionScriptDataInput.php
index 14347bc..456e85d 100644
--- a/src/Dto/Input/GetPartitionScriptDataInput.php
+++ b/src/Dto/Input/GetPartitionScriptDataInput.php
@@ -2,7 +2,8 @@
 
 namespace App\Dto\Input;
 
-use App\Dto\Output\ClientOutput;
+use ApiPlatform\Metadata\ApiProperty;
+use App\Dto\Input\PartitionInput;
 use Symfony\Component\Serializer\Annotation\Groups;
 
 final class GetPartitionScriptDataInput
@@ -11,6 +12,10 @@ final class GetPartitionScriptDataInput
      * @var PartitionInput[]
      */
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'Las particiones para obtener datos del script',
+        example: []
+    )]
     public array $partitions = [];
 
 }
diff --git a/src/Dto/Input/MultipleClientsInput.php b/src/Dto/Input/MultipleClientsInput.php
index f47e203..3eca31d 100644
--- a/src/Dto/Input/MultipleClientsInput.php
+++ b/src/Dto/Input/MultipleClientsInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\ClientOutput;
 use Symfony\Component\Serializer\Annotation\Groups;
 
@@ -11,9 +12,17 @@ final class MultipleClientsInput
      * @var ClientOutput[]
      */
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'Los clientes para la operación múltiple',
+        example: []
+    )]
     public array $clients = [];
 
     #[Groups(['client:write'])]
+    #[ApiProperty(
+        description: 'Si encolar la operación',
+        example: false
+    )]
     public bool $queue = false;
 }
 
diff --git a/src/Dto/Input/NetworkSettingsInput.php b/src/Dto/Input/NetworkSettingsInput.php
index add2df6..161aa2e 100644
--- a/src/Dto/Input/NetworkSettingsInput.php
+++ b/src/Dto/Input/NetworkSettingsInput.php
@@ -8,8 +8,6 @@ use App\Dto\Output\ImageRepositoryOutput;
 use App\Dto\Output\MenuOutput;
 use App\Dto\Output\OgLiveOutput;
 use App\Dto\Output\PxeTemplateOutput;
-use App\Entity\HardwareProfile;
-use App\Entity\Menu;
 use App\Entity\NetworkSettings;
 use App\Validator\Constraints\OrganizationalUnitMulticastMode;
 use App\Validator\Constraints\OrganizationalUnitMulticastPort;
@@ -20,71 +18,146 @@ use Symfony\Component\Validator\Constraints as Assert;
 class NetworkSettingsInput
 {
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El servidor siguiente (next server) para PXE',
+        example: '192.168.1.1'
+    )]
     public ?string $nextServer = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El nombre del archivo de arranque',
+        example: 'pxelinux.0'
+    )]
     public ?string $bootFileName = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El servidor proxy',
+        example: 'http://proxy.example.com:8080'
+    )]
     public ?string $proxy = null;
 
     #[Assert\Ip(message: 'validators.network_settings.ip_address.invalid')]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El servidor DNS',
+        example: '8.8.8.8'
+    )]
     public ?string $dns = null;
 
     #[Assert\Ip(message: 'validators.network_settings.ip_address.invalid')]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La máscara de red',
+        example: '255.255.255.0'
+    )]
     public ?string $netmask = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La puerta de enlace (router)',
+        example: '192.168.1.1'
+    )]
     public ?string $router = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El servidor NTP',
+        example: 'pool.ntp.org'
+    )]
     public ?string $ntp = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La interfaz de red',
+        example: 'eth0'
+    )]
     public ?string $netiface = null;
 
     #[OrganizationalUnitP2PMode]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El modo P2P para despliegues torrent',
+        example: 'seed'
+    )]
     public ?string $p2pMode = null;
 
     #[Assert\GreaterThan(0, message: 'validators.network_settings.p2p_time.invalid')]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El tiempo P2P en segundos',
+        example: 3600
+    )]
     public ?int $p2pTime = null;
 
     #[Assert\Ip(message: 'validators.network_settings.ip_address.invalid')]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La dirección IP de multicast',
+        example: '239.255.255.250'
+    )]
     public ?string $mcastIp = null;
 
     #[Assert\GreaterThan(0, message: 'validators.network_settings.mcast_speed.invalid')]
     #[Groups(['organizational-write:write'])]
+    #[ApiProperty(
+        description: 'La velocidad de multicast en Mbps',
+        example: 100
+    )]
     public ?int $mcastSpeed = null;
 
     #[OrganizationalUnitMulticastPort]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El puerto de multicast',
+        example: 8000
+    )]
     public ?int $mcastPort = null;
 
     #[OrganizationalUnitMulticastMode]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El modo de multicast',
+        example: 'full'
+    )]
     public ?string $mcastMode = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El menú de la configuración de red'
+    )]
     public ?MenuOutput $menu = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El perfil de hardware de la configuración de red'
+    )]
     public ?HardwareProfileOutput $hardwareProfile = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La configuración OgLive de la configuración de red'
+    )]
     public ?OgLiveOutput $ogLive = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El repositorio de imágenes de la configuración de red'
+    )]
     public ?ImageRepositoryOutput $repository = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La plantilla PXE de la configuración de red'
+    )]
     public ?PxeTemplateOutput $pxeTemplate = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La ruta de ogshare',
+        example: '/var/ogshare'
+    )]
     public ?string $ogshare = null;
 
     public function __construct(?NetworkSettings $networkSettings = null)
diff --git a/src/Dto/Input/OperativeSystemInput.php b/src/Dto/Input/OperativeSystemInput.php
index 8ebac93..23e90a5 100644
--- a/src/Dto/Input/OperativeSystemInput.php
+++ b/src/Dto/Input/OperativeSystemInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Entity\OperativeSystem;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
@@ -10,6 +11,10 @@ class OperativeSystemInput
 {
     #[Assert\NotBlank(message: 'validators.operative_system.name.not_blank')]
     #[Groups(['operative-system:write'])]
+    #[ApiProperty(
+        description: 'El nombre del sistema operativo',
+        example: 'Ubuntu 20.04 LTS'
+    )]
     public ?string $name = null;
 
     public function __construct(?OperativeSystem $operativeSystem = null)
diff --git a/src/Dto/Input/OrganizationalUnitInput.php b/src/Dto/Input/OrganizationalUnitInput.php
index 64b8930..d0d3bf6 100644
--- a/src/Dto/Input/OrganizationalUnitInput.php
+++ b/src/Dto/Input/OrganizationalUnitInput.php
@@ -6,9 +6,6 @@ use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\OrganizationalUnitOutput;
 use App\Dto\Output\RemoteCalendarOutput;
 use App\Entity\OrganizationalUnit;
-use App\Validator\Constraints\OrganizationalUnitMulticastMode;
-use App\Validator\Constraints\OrganizationalUnitMulticastPort;
-use App\Validator\Constraints\OrganizationalUnitP2PMode;
 use App\Validator\Constraints\OrganizationalUnitParent;
 use App\Validator\Constraints\OrganizationalUnitType;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -19,45 +16,95 @@ class OrganizationalUnitInput
 {
     #[Assert\NotBlank(message: 'validators.organizational_unit.name.not_blank')]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El nombre de la unidad organizativa',
+        example: 'Aula 1'
+    )]
     public ?string $name = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La unidad organizativa padre',
+        example: null
+    )]
     public ?OrganizationalUnitOutput $parent = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La descripción de la unidad organizativa',
+        example: 'Aula de informática principal'
+    )]
     public ?string $description = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La ubicación de la unidad organizativa',
+        example: 'Planta baja, edificio A'
+    )]
     public ?string $location = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'Si tiene proyector',
+        example: true
+    )]
     public ?bool $projector = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'Si tiene pizarra digital',
+        example: false
+    )]
     public ?bool $board = null;
 
     #[Assert\GreaterThan(0)]
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'La capacidad de la unidad organizativa',
+        example: 30
+    )]
     public ?int $capacity = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'Comentarios adicionales',
+        example: 'Aula equipada con ordenadores de última generación'
+    )]
     public ?string $comments = null;
 
     #[Groups(['organizational-unit:write'])]
     #[OrganizationalUnitType]
+    #[ApiProperty(
+        description: 'El tipo de unidad organizativa',
+        example: 'aula'
+    )]
     public ?string $type = null;
 
     #[Groups(['organizational-unit:write'])]
     #[Assert\Valid()]
+    #[ApiProperty(
+        description: 'La configuración de red de la unidad organizativa'
+    )]
     public ?NetworkSettingsInput $networkSettings = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'El calendario remoto de la unidad organizativa'
+    )]
     public ?RemoteCalendarOutput $remoteCalendar = null;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'Si es un PC remoto',
+        example: false
+    )]
     public ?bool $remotePc = false;
 
     #[Groups(['organizational-unit:write'])]
+    #[ApiProperty(
+        description: 'Si excluir cambios del padre',
+        example: false
+    )]
     public ?bool $excludeParentChanges = null;
 
     public function __construct(?OrganizationalUnit $organizationalUnit = null)
diff --git a/src/Dto/Input/PartitionInput.php b/src/Dto/Input/PartitionInput.php
index 5942a3b..8c5d5c2 100644
--- a/src/Dto/Input/PartitionInput.php
+++ b/src/Dto/Input/PartitionInput.php
@@ -3,12 +3,8 @@
 namespace App\Dto\Input;
 
 use ApiPlatform\Metadata\ApiProperty;
-use App\Dto\Output\ClientOutput;
 use App\Dto\Output\ImageOutput;
 use App\Dto\Output\OperativeSystemOutput;
-use App\Dto\Output\OrganizationalUnitOutput;
-use App\Entity\HardwareProfile;
-use App\Entity\Menu;
 use App\Entity\Partition;
 use Ramsey\Uuid\UuidInterface;
 use Symfony\Component\Serializer\Annotation\Groups;
diff --git a/src/Dto/Input/SubnetAddHostInput.php b/src/Dto/Input/SubnetAddHostInput.php
index d903357..7cff517 100644
--- a/src/Dto/Input/SubnetAddHostInput.php
+++ b/src/Dto/Input/SubnetAddHostInput.php
@@ -4,9 +4,6 @@ namespace App\Dto\Input;
 
 use ApiPlatform\Metadata\ApiProperty;
 use App\Dto\Output\ClientOutput;
-use App\Dto\Output\PxeTemplateOutput;
-use App\Dto\Output\SubnetOutput;
-use App\Entity\PxeBootFile;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
 
@@ -17,5 +14,9 @@ final class SubnetAddHostInput
      */
     #[Assert\NotNull]
     #[Groups(['subnet:write'])]
+    #[ApiProperty(
+        description: 'Los clientes a añadir a la subred',
+        example: []
+    )]
     public ?array $clients = [];
 }
\ No newline at end of file
diff --git a/src/Dto/Input/TransferGlobalImageInput.php b/src/Dto/Input/TransferGlobalImageInput.php
index 7193d13..7341644 100644
--- a/src/Dto/Input/TransferGlobalImageInput.php
+++ b/src/Dto/Input/TransferGlobalImageInput.php
@@ -3,7 +3,7 @@
 namespace App\Dto\Input;
 
 use App\Dto\Output\ImageOutput;
-use App\Dto\Output\ImageRepositoryOutput;
+use ApiPlatform\Metadata\ApiProperty;
 use Symfony\Component\Serializer\Annotation\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
 
@@ -14,5 +14,9 @@ class TransferGlobalImageInput
      */
     #[Assert\NotNull]
     #[Groups(['image-image-repository:write'])]
+    #[ApiProperty(
+        description: 'Los repositorios de destino para transferir la imagen global',
+        example: []
+    )]
     public array $repositories = [];
 }
\ No newline at end of file
diff --git a/src/Dto/Input/UserGroupInput.php b/src/Dto/Input/UserGroupInput.php
index 918e1ef..1dabc19 100644
--- a/src/Dto/Input/UserGroupInput.php
+++ b/src/Dto/Input/UserGroupInput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Input;
 
+use ApiPlatform\Metadata\ApiProperty;
 use App\Entity\UserGroup;
 use App\Validator\Constraints\UserGroupsValidPermission;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -11,14 +12,26 @@ final class UserGroupInput
 {
     #[Assert\NotBlank]
     #[Groups(['user-group:write'])]
+    #[ApiProperty(
+        description: 'El nombre del grupo de usuario',
+        example: 'Administradores'
+    )]
     public ?string $name = null;
 
     #[Groups(['user-group:write'])]
     #[UserGroupsValidPermission]
+    #[ApiProperty(
+        description: 'Los permisos del grupo de usuario',
+        example: ['ROLE_ADMIN', 'ROLE_USER_MANAGEMENT']
+    )]
     public ?array $permissions = [];
 
     #[Assert\NotNull]
     #[Groups(['user-group:write'])]
+    #[ApiProperty(
+        description: 'Si el grupo está habilitado',
+        example: true
+    )]
     public ?bool $enabled = false;
 
     public function __construct(?UserGroup $userGroupGroup = null)
diff --git a/src/Dto/Input/UserInput.php b/src/Dto/Input/UserInput.php
index aea6947..c524e2b 100644
--- a/src/Dto/Input/UserInput.php
+++ b/src/Dto/Input/UserInput.php
@@ -15,47 +15,85 @@ final class UserInput
 {
     #[Assert\NotBlank]
     #[Groups('user:write')]
+    #[ApiProperty(
+        description: 'El nombre de usuario',
+        example: 'admin'
+    )]
     public ?string $username = null;
 
     /**
      * @var OrganizationalUnitOutput[]
      */
     #[Groups('user:write')]
-    #[ApiProperty(readableLink: false,  writableLink: false)]
+    #[ApiProperty(
+        description: 'Las unidades organizativas permitidas para el usuario',
+        example: [],
+        readableLink: false,  
+        writableLink: false
+    )]
     public array $allowedOrganizationalUnits = [];
 
     #[Assert\NotBlank(groups: ['user:post'])]
     #[Assert\Length(min: 8, groups: ['user:write', 'user:post'])]
     #[Groups('user:write')]
+    #[ApiProperty(
+        description: 'La contraseña del usuario (mínimo 8 caracteres)',
+        example: 'password123'
+    )]
     public ?string $password = null;
 
     #[Groups('user:write')]
+    #[ApiProperty(
+        description: 'La vista por defecto de grupos para el usuario',
+        example: 'grid'
+    )]
     public ?string $groupsView = null;
 
     #[Assert\NotNull]
     #[Groups('user:write')]
+    #[ApiProperty(
+        description: 'Si el usuario está habilitado',
+        example: true
+    )]
     public ?bool $enabled = true;
 
     /**
      * @var UserGroupOutput[]
      */
     #[Groups('user:write')]
-    #[ApiProperty(readableLink: false,  writableLink: false)]
+    #[ApiProperty(
+        description: 'Los grupos de usuario asignados',
+        example: [],
+        readableLink: false,  
+        writableLink: false
+    )]
     public array $userGroups = [];
 
     #[Assert\NotBlank(groups: ['user:reset-password'])]
     #[Groups('user:reset-password')]
+    #[ApiProperty(
+        description: 'La contraseña actual del usuario',
+        example: 'currentpass123'
+    )]
     public ?string $currentPassword = null;
 
     #[Assert\NotBlank(groups: ['user:reset-password'])]
     #[Assert\Length(min: 8, groups: ['user:reset-password'])]
     #[Groups('user:reset-password')]
+    #[ApiProperty(
+        description: 'La nueva contraseña del usuario (mínimo 8 caracteres)',
+        example: 'newpass123'
+    )]
     public ?string $newPassword = null;
 
     #[Assert\NotBlank(groups: ['user:reset-password'])]
     #[Assert\Length(min: 8, groups: ['user:reset-password'])]
     #[Assert\Expression(expression: 'this.newPassword === this.repeatNewPassword', message: 'This value should be the same as the new password', groups: ['user:reset-password'])]
     #[Groups('user:reset-password')]
+    #[ApiProperty(
+        description: 'Repetir la nueva contraseña para confirmación',
+        example: 'newpass123'
+    )]
     public ?string $repeatNewPassword = null;
 
     public function __construct(?User $user = null)
diff --git a/src/Dto/Input/WoLInput.php b/src/Dto/Input/WoLInput.php
index 82d36ca..7ec82e6 100644
--- a/src/Dto/Input/WoLInput.php
+++ b/src/Dto/Input/WoLInput.php
@@ -12,6 +12,9 @@ class WoLInput
      * @var ClientOutput[]|null
      */
     #[Groups(['repository:write'])]
-    #[ApiProperty(description: 'The client to wol')]
+    #[ApiProperty(
+        description: 'Los clientes para Wake on LAN',
+        example: []
+    )]
     public ?array $clients = null;
 }
\ No newline at end of file
diff --git a/src/Dto/Output/ClientOutput.php b/src/Dto/Output/ClientOutput.php
index bc7ca50..a9d1b9b 100644
--- a/src/Dto/Output/ClientOutput.php
+++ b/src/Dto/Output/ClientOutput.php
@@ -14,70 +14,150 @@ final class ClientOutput extends AbstractOutput
     CONST string TYPE = 'client';
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read', 'hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'El nombre del cliente',
+        example: 'PC-Aula-01'
+    )]
     public string $name;
 
     #[Groups(['client:read', 'organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'El tipo de entidad',
+        example: 'client'
+    )]
     public string $type = self::TYPE;
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read', 'hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'La dirección IP del cliente',
+        example: '192.168.1.100'
+    )]
     public ?string $ip = '';
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read', 'hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'La dirección MAC del cliente',
+        example: '00:1A:2B:3C:4D:5E'
+    )]
     public ?string $mac = '';
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'El tipo de firmware (BIOS/UEFI)',
+        example: 'UEFI'
+    )]
     public ?string $firmwareType = '';
 
     #[Groups(['client:read', 'organizational-unit:read', 'trace:read'])]
+    #[ApiProperty(
+        description: 'El número de serie del cliente',
+        example: 'SN123456789'
+    )]
     public ?string $serialNumber = '';
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'La interfaz de red',
+        example: 'eth0'
+    )]
     public ?string $netiface = '';
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'El controlador de red',
+        example: 'e1000'
+    )]
     public ?string $netDriver = '';
 
     #[Groups(['client:read'])]
-    #[ApiProperty(readableLink: true)]
+    #[ApiProperty(
+        description: 'La unidad organizativa a la que pertenece el cliente',
+        readableLink: true
+    )]
     public ?OrganizationalUnitOutput $organizationalUnit = null;
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'Las particiones del disco del cliente',
+        example: []
+    )]
     public array $partitions = [];
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'El menú de arranque asignado al cliente',
+        example: null
+    )]
     public ?MenuOutput $menu = null;
 
     #[Groups(['client:read'])]
-    #[ApiProperty(readableLink: true )]
+    #[ApiProperty(
+        description: 'El repositorio de imágenes asignado al cliente',
+        readableLink: true
+    )]
     public ?ImageRepositoryOutput $repository = null;
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read'])]
-    #[ApiProperty(readableLink: true )]
+    #[ApiProperty(
+        description: 'La plantilla PXE asignada al cliente',
+        readableLink: true
+    )]
     public ?PxeTemplateOutput $pxeTemplate = null;
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read'])]
-    #[ApiProperty(readableLink: true )]
+    #[ApiProperty(
+        description: 'La imagen OGLive asignada al cliente',
+        readableLink: true
+    )]
     public ?OgLiveOutput $ogLive = null;
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read'])]
+    #[ApiProperty(
+        description: 'La subred del cliente en formato CIDR',
+        example: '192.168.1.0/24'
+    )]
     public ?string $subnet = null;
 
     #[Groups(['client:read', 'organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'La posición del cliente en la interfaz gráfica',
+        example: ['x' => 100, 'y' => 200]
+    )]
     public ?array $position = ['x' => 0, 'y' => 0];
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read'])]
+    #[ApiProperty(
+        description: 'El estado actual del cliente',
+        example: 'online'
+    )]
     public ?string $status = '';
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del cliente',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     #[Groups(['client:read', 'organizational-unit:read', 'pxe-template:read', 'trace:read', 'subnet:read'])]
+    #[ApiProperty(
+        description: 'Indica si el cliente está en modo mantenimiento',
+        example: false
+    )]
     public ?bool $maintenance = false;
 
     #[Groups(['client:read'])]
+    #[ApiProperty(
+        description: 'Indica si la configuración PXE está sincronizada',
+        example: true
+    )]
     public ?bool $pxeSync = false;
 
     public function __construct(Client $client)
diff --git a/src/Dto/Output/CommandGroupOutput.php b/src/Dto/Output/CommandGroupOutput.php
index 617bf79..cf47375 100644
--- a/src/Dto/Output/CommandGroupOutput.php
+++ b/src/Dto/Output/CommandGroupOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\Command;
 use App\Entity\CommandGroup;
@@ -11,15 +12,31 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class CommandGroupOutput extends AbstractOutput
 {
     #[Groups(['command-group:read', 'command-task:read'])]
+    #[ApiProperty(
+        description: 'El nombre del grupo de comandos',
+        example: 'Comandos de sistema'
+    )]
     public string $name;
 
     #[Groups(['command-group:read', 'command-task:read'])]
+    #[ApiProperty(
+        description: 'Los comandos incluidos en el grupo',
+        example: []
+    )]
     public array $commands = [];
 
     #[Groups(['command-group:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del grupo de comandos',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['command-group:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(CommandGroup $commandGroup)
diff --git a/src/Dto/Output/CommandOutput.php b/src/Dto/Output/CommandOutput.php
index 0622b70..0832c78 100644
--- a/src/Dto/Output/CommandOutput.php
+++ b/src/Dto/Output/CommandOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\Command;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,27 +11,59 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class CommandOutput extends AbstractOutput
 {
     #[Groups(['command:read', 'command-group:read', 'command-task:read', 'trace:read'])]
+    #[ApiProperty(
+        description: 'El nombre del comando',
+        example: 'Reiniciar sistema'
+    )]
     public string $name;
 
     #[Groups(['command:read', 'command-group:read', 'command-task:read', 'trace:read'])]
+    #[ApiProperty(
+        description: 'El script del comando',
+        example: 'reboot'
+    )]
     public ?string $script = '';
 
     #[Groups(['command:read'])]
+    #[ApiProperty(
+        description: 'Indica si el comando es de solo lectura',
+        example: false
+    )]
     public ?bool $readOnly = false;
 
     #[Groups(['command:read'])]
+    #[ApiProperty(
+        description: 'Indica si el comando está habilitado',
+        example: true
+    )]
     public ?bool $enabled = true;
 
     #[Groups(['command:read'])]
+    #[ApiProperty(
+        description: 'Indica si el comando acepta parámetros',
+        example: true
+    )]
     public ?bool $parameters = true;
 
     #[Groups(['command:read'])]
+    #[ApiProperty(
+        description: 'Comentarios sobre el comando',
+        example: 'Reinicia el equipo de forma controlada'
+    )]
     public ?string $comments = '';
 
     #[Groups(['command:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del comando',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['command:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(Command $command)
diff --git a/src/Dto/Output/CommandTaskOutput.php b/src/Dto/Output/CommandTaskOutput.php
index c6be84f..eb04d38 100644
--- a/src/Dto/Output/CommandTaskOutput.php
+++ b/src/Dto/Output/CommandTaskOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\Client;
 use App\Entity\Command;
@@ -13,30 +14,66 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class CommandTaskOutput extends AbstractOutput
 {
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'El nombre de la tarea de comando',
+        example: 'Actualización nocturna'
+    )]
     public ?string $name = null;
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'Los clientes asignados a la tarea',
+        example: []
+    )]
     public array $clients = [];
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'La unidad organizativa asociada a la tarea',
+        example: null
+    )]
     public ?OrganizationalUnitOutput $organizationalUnit = null;
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'Fecha de la última ejecución',
+        example: '2024-01-15T02:00:00+00:00'
+    )]
     public ?\DateTimeInterface $lastExecution = null;
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'Fecha de la próxima ejecución programada',
+        example: '2024-01-16T02:00:00+00:00'
+    )]
     public ?\DateTimeInterface $nextExecution = null;
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'Notas adicionales sobre la tarea',
+        example: 'Ejecutar fuera del horario escolar'
+    )]
     public ?string $notes = null;
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'El alcance de la tarea',
+        example: 'clients'
+    )]
     public ?string $scope = null;
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la tarea',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['command-task:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
 
diff --git a/src/Dto/Output/CommandTaskScheduleOutput.php b/src/Dto/Output/CommandTaskScheduleOutput.php
index 45dcd02..6860aee 100644
--- a/src/Dto/Output/CommandTaskScheduleOutput.php
+++ b/src/Dto/Output/CommandTaskScheduleOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\CommandTaskSchedule;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,18 +11,38 @@ use Symfony\Component\Serializer\Annotation\Groups;
 class CommandTaskScheduleOutput extends AbstractOutput
 {
     #[Groups(['command-task-schedule:read'])]
+    #[ApiProperty(
+        description: 'El tipo de recurrencia de la programación',
+        example: 'weekly'
+    )]
     public ?string $recurrenceType = null;
 
     #[Groups(['command-task-schedule:read'])]
+    #[ApiProperty(
+        description: 'La fecha de ejecución programada',
+        example: '2024-01-20T00:00:00+00:00'
+    )]
     public ?\DateTimeInterface $executionDate = null;
 
     #[Groups(['command-task-schedule:read'])]
+    #[ApiProperty(
+        description: 'La hora de ejecución programada',
+        example: '2024-01-15T02:00:00+00:00'
+    )]
     public ?\DateTimeInterface $executionTime = null;
 
     #[Groups(['command-task-schedule:read'])]
+    #[ApiProperty(
+        description: 'Los detalles de la recurrencia',
+        example: ['days' => ['monday', 'wednesday', 'friday']]
+    )]
     public ?array $recurrenceDetails = null;
 
     #[Groups(['command-task-schedule:read'])]
+    #[ApiProperty(
+        description: 'Indica si la programación está habilitada',
+        example: true
+    )]
     public ?bool $enabled = null;
 
     public function __construct(?CommandTaskSchedule $commandTaskSchedule = null)
diff --git a/src/Dto/Output/CommandTaskScriptOutput.php b/src/Dto/Output/CommandTaskScriptOutput.php
index 1354ffc..ce6274d 100644
--- a/src/Dto/Output/CommandTaskScriptOutput.php
+++ b/src/Dto/Output/CommandTaskScriptOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\CommandTaskSchedule;
 use App\Entity\CommandTaskScript;
@@ -11,18 +12,38 @@ use Symfony\Component\Serializer\Annotation\Groups;
 class CommandTaskScriptOutput extends AbstractOutput
 {
     #[Groups(['command-task-script:read'])]
+    #[ApiProperty(
+        description: 'El contenido del script',
+        example: '#!/bin/bash\necho "Hello World"'
+    )]
     public ?string $content = null;
 
     #[Groups(['command-task-script:read'])]
+    #[ApiProperty(
+        description: 'El tipo de script',
+        example: 'bash'
+    )]
     public ?string $type = null;
 
     #[Groups(['command-task-script:read'])]
+    #[ApiProperty(
+        description: 'Los parámetros del script',
+        example: []
+    )]
     public ?array $parameters = null;
 
     #[Groups(['command-task-script:read'])]
+    #[ApiProperty(
+        description: 'La tarea de comando asociada',
+        example: null
+    )]
     public ?CommandTaskOutput $commandTaskOutput = null;
 
     #[Groups(['command-task-script:read'])]
+    #[ApiProperty(
+        description: 'El orden de ejecución del script',
+        example: 1
+    )]
     public ?int $order = null;
 
     public function __construct(?CommandTaskScript $commandTaskScript = null)
diff --git a/src/Dto/Output/GitRepositoryOutput.php b/src/Dto/Output/GitRepositoryOutput.php
index 9040e0f..3c65e96 100644
--- a/src/Dto/Output/GitRepositoryOutput.php
+++ b/src/Dto/Output/GitRepositoryOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\GitRepository;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -22,6 +23,10 @@ final class GitRepositoryOutput
      * )
      */
     #[Groups(['git-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'El UUID del repositorio Git',
+        example: '123e4567-e89b-12d3-a456-426614174000'
+    )]
     public string $uuid = '';
 
     /**
@@ -31,6 +36,10 @@ final class GitRepositoryOutput
      * )
      */
     #[Groups(['git-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'El ID del repositorio Git',
+        example: 1
+    )]
     public int $id = 0;
 
     /**
@@ -40,6 +49,10 @@ final class GitRepositoryOutput
      * )
      */
     #[Groups(['git-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'El nombre del repositorio Git',
+        example: 'mi-repositorio'
+    )]
     public string $name = '';
 
     /**
@@ -49,6 +62,10 @@ final class GitRepositoryOutput
      * )
      */
     #[Groups(['git-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'La descripción del repositorio',
+        example: 'Repositorio para el proyecto principal'
+    )]
     public ?string $description = '';
 
     /**
@@ -58,6 +75,10 @@ final class GitRepositoryOutput
      * )
      */
     #[Groups(['git-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'El servidor donde se encuentra el repositorio',
+        example: null
+    )]
     public ?ImageRepositoryOutput $repository = null;
 
     /**
@@ -67,6 +88,10 @@ final class GitRepositoryOutput
      * )
      */
     #[Groups(['git-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del repositorio',
+        example: '2024-01-01T00:00:00+00:00'
+    )]
     public ?\DateTime $createdAt = null;
 
     /**
@@ -76,6 +101,10 @@ final class GitRepositoryOutput
      * )
      */
     #[Groups(['git-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(GitRepository $gitRepository, array $context = [])
diff --git a/src/Dto/Output/HardwareOutput.php b/src/Dto/Output/HardwareOutput.php
index 3823f33..39a1d80 100644
--- a/src/Dto/Output/HardwareOutput.php
+++ b/src/Dto/Output/HardwareOutput.php
@@ -11,19 +11,38 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class HardwareOutput extends AbstractOutput
 {
     #[Groups(['hardware:read', 'hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'El nombre del componente de hardware',
+        example: 'Intel Core i7-9700K'
+    )]
     public string $name;
 
     #[Groups(['hardware:read'])]
+    #[ApiProperty(
+        description: 'La descripción del componente de hardware',
+        example: 'Procesador de 8 núcleos a 3.6GHz'
+    )]
     public ?string $description = '';
 
     #[Groups(['hardware:read'])]
-    #[ApiProperty(readableLink: true)]
+    #[ApiProperty(
+        description: 'El tipo de hardware',
+        readableLink: true
+    )]
     public ?HardwareTypeOutput $type = null;
 
     #[Groups(['hardware:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del componente de hardware',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['hardware:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(Hardware $hardware)
diff --git a/src/Dto/Output/HardwareProfileOutput.php b/src/Dto/Output/HardwareProfileOutput.php
index 22b73f3..93a3b55 100644
--- a/src/Dto/Output/HardwareProfileOutput.php
+++ b/src/Dto/Output/HardwareProfileOutput.php
@@ -12,21 +12,45 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class HardwareProfileOutput extends AbstractOutput
 {
     #[Groups(['hardware-profile:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'La descripción del perfil de hardware',
+        example: 'Perfil de hardware estándar para aula de informática'
+    )]
     public ?string $description = '';
 
     #[Groups(['hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'Comentarios adicionales sobre el perfil',
+        example: 'Configuración actualizada en enero 2024'
+    )]
     public ?string $comments = '';
 
     #[Groups(['hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'El cliente asociado a este perfil de hardware',
+        example: null
+    )]
     public ?ClientOutput $client = null;
 
     #[Groups(['hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'La colección de componentes de hardware',
+        example: []
+    )]
     public ?array $hardwareCollection = [];
 
     #[Groups(['hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del perfil de hardware',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['hardware-profile:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(HardwareProfile $hardwareProfile)
diff --git a/src/Dto/Output/HardwareTypeOutput.php b/src/Dto/Output/HardwareTypeOutput.php
index 9606d3a..023be56 100644
--- a/src/Dto/Output/HardwareTypeOutput.php
+++ b/src/Dto/Output/HardwareTypeOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\HardwareType;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,15 +11,31 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class HardwareTypeOutput extends AbstractOutput
 {
     #[Groups(['hardware-type:read', 'hardware:read'])]
+    #[ApiProperty(
+        description: 'El nombre del tipo de hardware',
+        example: 'Tarjeta de red'
+    )]
     public string $name;
 
     #[Groups(['hardware-type:read', 'hardware:read'])]
+    #[ApiProperty(
+        description: 'La descripción del tipo de hardware',
+        example: 'Dispositivo de red Ethernet'
+    )]
     public ?string $description = null;
 
     #[Groups(['hardware-type:read', 'hardware:read'])]
+    #[ApiProperty(
+        description: 'El código del tipo de hardware',
+        example: 'NET'
+    )]
     public ?string $code = null;
 
     #[Groups(['hardware-type:read', 'hardware:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del tipo de hardware',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     public function __construct(HardwareType $hardwareType)
diff --git a/src/Dto/Output/ImageImageRepositoryOutput.php b/src/Dto/Output/ImageImageRepositoryOutput.php
index c23ce24..d4cf4e9 100644
--- a/src/Dto/Output/ImageImageRepositoryOutput.php
+++ b/src/Dto/Output/ImageImageRepositoryOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\ImageImageRepository;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,36 +11,80 @@ use Symfony\Component\Serializer\Annotation\Groups;
 class ImageImageRepositoryOutput extends AbstractOutput
 {
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'La imagen asociada',
+        example: null
+    )]
     public ?ImageOutput $image = null;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'El repositorio donde está almacenada la imagen',
+        example: null
+    )]
     public ?ImageRepositoryOutput $imageRepository = null;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'El estado de la imagen en el repositorio',
+        example: 'synchronized'
+    )]
     public string $status;
 
     #[Groups(['image-image-repository:read', 'image:read', 'partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El nombre de la imagen',
+        example: 'Windows10-v1'
+    )]
     public string $name;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'La suma de verificación completa de la imagen',
+        example: 'a1b2c3d4e5f6...'
+    )]
     public ?string $imageFullsum = null;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'Información sobre las particiones de la imagen',
+        example: []
+    )]
     public ?array $partitionInfo = null;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'El tamaño de los datos en bytes',
+        example: '10737418240'
+    )]
     public ?string $datasize = null;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'La descripción de la imagen',
+        example: 'Imagen base de Windows 10 actualizado'
+    )]
     public ?string $description = null;
 
     #[Groups(['image:read', 'image-image-repository:read'])]
+    #[ApiProperty(
+        description: 'La versión de la imagen',
+        example: 1
+    )]
     public ?int $version = null;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la relación imagen-repositorio',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['image-image-repository:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(ImageImageRepository $imageImageRepository, array $context = [])
diff --git a/src/Dto/Output/ImageOutput.php b/src/Dto/Output/ImageOutput.php
index a5cf26f..9e857fc 100644
--- a/src/Dto/Output/ImageOutput.php
+++ b/src/Dto/Output/ImageOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\Image;
 use App\Entity\ImageImageRepository;
@@ -13,35 +14,76 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class ImageOutput extends AbstractOutput
 {
     #[Groups(['image:read', 'image-image-repository:read', 'git-image-repository:read'])]
+    #[ApiProperty(
+        description: 'El nombre de la imagen',
+        example: 'Windows 10 Pro'
+    )]
     public ?string $name = '';
+
     #[Groups(['image:read', 'image-image-repository:read'])]
+    #[ApiProperty(
+        description: 'Indica si es una imagen de PC remoto',
+        example: false
+    )]
     public ?bool $remotePc = null;
 
     #[Groups(['image:read', 'image-image-repository:read'])]
+    #[ApiProperty(
+        description: 'Indica si la imagen es global',
+        example: true
+    )]
     public ?bool $isGlobal = null;
 
     #[Groups(['image:read', 'image-image-repository:read'])]
+    #[ApiProperty(
+        description: 'El tipo de imagen',
+        example: 'basic'
+    )]
     public ?string $type = '';
 
     #[Groups(['image:read'])]
+    #[ApiProperty(
+        description: 'El perfil de software asociado a la imagen',
+        example: null
+    )]
     public ?SoftwareProfileOutput $softwareProfile = null;
 
     /**
      * @var ImageRepositoryOutput[]|null
      */
     #[Groups(['image:read'])]
+    #[ApiProperty(
+        description: 'Los repositorios donde está almacenada la imagen',
+        example: []
+    )]
     public ?array $imageRepositories = [];
 
     #[Groups(['image:read'])]
+    #[ApiProperty(
+        description: 'Información sobre las particiones de la imagen',
+        example: []
+    )]
     public ?array $partitionInfo = null;
 
     #[Groups(['image:read', 'image-image-repository:read'])]
+    #[ApiProperty(
+        description: 'La versión de la imagen',
+        example: 1
+    )]
     public ?int $version = null;
 
     #[Groups(['image:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la imagen',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['image:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(Image $image)
diff --git a/src/Dto/Output/ImageRepositoryOutput.php b/src/Dto/Output/ImageRepositoryOutput.php
index 44445b6..876919c 100644
--- a/src/Dto/Output/ImageRepositoryOutput.php
+++ b/src/Dto/Output/ImageRepositoryOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\ImageRepository;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,24 +11,52 @@ use Symfony\Component\Serializer\Annotation\Groups;
 class ImageRepositoryOutput extends AbstractOutput
 {
     #[Groups(['repository:read', 'image:read', 'client:read', "organizational-unit:read", "image-image-repository:read"])]
+    #[ApiProperty(
+        description: 'El nombre del repositorio de imágenes',
+        example: 'Repositorio Principal'
+    )]
     public ?string $name = '';
 
     #[Groups(['repository:read'])]
+    #[ApiProperty(
+        description: 'La dirección IP del servidor del repositorio',
+        example: '192.168.1.50'
+    )]
     public ?string $ip = '';
 
     #[Groups(['repository:read'])]
+    #[ApiProperty(
+        description: 'Comentarios sobre el repositorio',
+        example: 'Servidor principal de almacenamiento de imágenes'
+    )]
     public ?string $comments = '';
 
     #[Groups(['repository:read'])]
+    #[ApiProperty(
+        description: 'El puerto SSH del servidor',
+        example: '22'
+    )]
     public ?string $sshPort = '';
 
     #[Groups(['repository:read'])]
+    #[ApiProperty(
+        description: 'El usuario SSH para acceder al repositorio',
+        example: 'opengnsys'
+    )]
     public ?string $user = '';
 
     #[Groups(['repository:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del repositorio',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['repository:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(ImageRepository $imageRepository, bool $status = true)
diff --git a/src/Dto/Output/MenuOutput.php b/src/Dto/Output/MenuOutput.php
index 1a81def..661c766 100644
--- a/src/Dto/Output/MenuOutput.php
+++ b/src/Dto/Output/MenuOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\HardwareProfile;
 use App\Entity\Menu;
@@ -11,27 +12,59 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class MenuOutput extends AbstractOutput
 {
     #[Groups(['menu:read', 'organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'El nombre del menú de arranque',
+        example: 'Menú Principal'
+    )]
     public string $name;
 
     #[Groups(['menu:read'])]
+    #[ApiProperty(
+        description: 'La resolución del menú',
+        example: '1024x768'
+    )]
     public string $resolution;
 
     #[Groups(['menu:read'])]
+    #[ApiProperty(
+        description: 'Comentarios sobre el menú',
+        example: 'Menú de arranque predeterminado para todas las aulas'
+    )]
     public ?string $comments = null;
 
     #[Groups(['menu:read'])]
+    #[ApiProperty(
+        description: 'URL pública del menú',
+        example: 'https://example.com/menu/public'
+    )]
     public ?string $publicUrl = null;
 
     #[Groups(['menu:read'])]
+    #[ApiProperty(
+        description: 'URL privada del menú',
+        example: 'https://example.com/menu/private'
+    )]
     public ?string $privateUrl = null;
 
     #[Groups(['menu:read'])]
+    #[ApiProperty(
+        description: 'Indica si es el menú predeterminado',
+        example: true
+    )]
     public ?bool $isDefault = false;
 
     #[Groups(['menu:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del menú',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['menu:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(Menu $menu)
diff --git a/src/Dto/Output/NetworkSettingsOutput.php b/src/Dto/Output/NetworkSettingsOutput.php
index 329cede..d433c8f 100644
--- a/src/Dto/Output/NetworkSettingsOutput.php
+++ b/src/Dto/Output/NetworkSettingsOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\NetworkSettings;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,69 +11,157 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class NetworkSettingsOutput extends AbstractOutput
 {
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La dirección del servidor TFTP siguiente',
+        example: '192.168.1.10'
+    )]
     public ?string $nextServer = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'El nombre del archivo de arranque',
+        example: 'pxelinux.0'
+    )]
     public ?string $bootFileName = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La dirección del servidor proxy',
+        example: 'http://proxy.example.com:8080'
+    )]
     public ?string $proxy = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La dirección del servidor DNS',
+        example: '8.8.8.8'
+    )]
     public ?string $dns = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La máscara de subred',
+        example: '255.255.255.0'
+    )]
     public ?string $netmask = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La dirección del router/gateway',
+        example: '192.168.1.1'
+    )]
     public ?string $router = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La dirección del servidor NTP',
+        example: 'time.google.com'
+    )]
     public ?string $ntp = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La interfaz de red',
+        example: 'eth0'
+    )]
     public ?string $netiface = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'El modo de transferencia punto a punto',
+        example: 'full'
+    )]
     public ?string $p2pMode = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'Tiempo de transferencia P2P en segundos',
+        example: 300
+    )]
     public ?int $p2pTime = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La dirección IP multicast',
+        example: '239.194.2.11'
+    )]
     public ?string $mcastIp = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La velocidad multicast en Mbps',
+        example: 100
+    )]
     public ?int $mcastSpeed = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'El puerto multicast',
+        example: 9000
+    )]
     public ?int $mcastPort = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'El modo multicast',
+        example: 'full-duplex'
+    )]
     public ?string $mcastMode = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'El menú de arranque configurado',
+        example: null
+    )]
     public ?MenuOutput $menu = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'El perfil de hardware configurado',
+        example: null
+    )]
     public ?HardwareProfileOutput $hardwareProfile = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La imagen OGLive configurada',
+        example: null
+    )]
     public ?OgLiveOutput $ogLive = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'El repositorio de imágenes configurado',
+        example: null
+    )]
     public ?ImageRepositoryOutput $repository = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La plantilla PXE configurada',
+        example: null
+    )]
     public ?PxeTemplateOutput $pxeTemplate = null;
 
     #[Groups(['network-settings:read', "organizational-unit:read", "client:read"])]
+    #[ApiProperty(
+        description: 'La ruta compartida de OGAgent',
+        example: '/opt/opengnsys/ogshare'
+    )]
     public ?string $ogshare = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la configuración de red',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(NetworkSettings $networkSettings)
diff --git a/src/Dto/Output/OgLiveOutput.php b/src/Dto/Output/OgLiveOutput.php
index 44f0b53..04e846d 100644
--- a/src/Dto/Output/OgLiveOutput.php
+++ b/src/Dto/Output/OgLiveOutput.php
@@ -11,48 +11,108 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class OgLiveOutput extends AbstractOutput
 {
     #[Groups(['og-live:read', 'client:read', "organizational-unit:read"])]
+    #[ApiProperty(
+        description: 'El nombre de la imagen OGLive',
+        example: 'ogLive-5.2.0'
+    )]
     public ?string $name = '';
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'Indica si la imagen está sincronizada',
+        example: true
+    )]
     public ?bool $synchronized = false;
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'Indica si la imagen está instalada',
+        example: true
+    )]
     public ?bool $installed = false;
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'Indica si es la imagen OGLive predeterminada',
+        example: true
+    )]
     public ?bool $isDefault = false;
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'URL de descarga de la imagen',
+        example: 'https://opengnsys.es/svn/branches/version1.1/installer/ogLive-5.2.0-r6374.iso'
+    )]
     public ?string $downloadUrl = '';
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'El estado de la imagen',
+        example: 'synchronized'
+    )]
     public ?string $status = '';
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'Suma de verificación de la imagen',
+        example: 'a1b2c3d4e5f6...'
+    )]
     public ?string $checksum = '';
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'La distribución de Linux',
+        example: 'Ubuntu'
+    )]
     public ?string $distribution = '';
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'La revisión de la imagen',
+        example: 'r6374'
+    )]
     public ?string $revision = '';
 
     #[Groups(['og-live:read', 'client:read', "organizational-unit:read"])]
+    #[ApiProperty(
+        description: 'El nombre del archivo de la imagen',
+        example: 'ogLive-5.2.0-r6374.iso'
+    )]
     public ?string $filename = null;
 
     #[Groups(['og-live:read', 'client:read', "organizational-unit:read"])]
+    #[ApiProperty(
+        description: 'La versión del kernel',
+        example: '5.4.0-42-generic'
+    )]
     public ?string $kernel = '';
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'La arquitectura del sistema',
+        example: 'amd64'
+    )]
     public ?string $architecture = '';
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del registro',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['og-live:read', 'client:read', "organizational-unit:read"])]
+    #[ApiProperty(
+        description: 'Fecha de la imagen',
+        example: '2024-01-10T00:00:00+00:00'
+    )]
     public ?\DateTimeInterface $date;
 
     #[Groups(['og-live:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(OgLive $ogLive)
diff --git a/src/Dto/Output/OperativeSystemOutput.php b/src/Dto/Output/OperativeSystemOutput.php
index fac3ef1..7cd46bb 100644
--- a/src/Dto/Output/OperativeSystemOutput.php
+++ b/src/Dto/Output/OperativeSystemOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\OperativeSystem;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,12 +11,24 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class OperativeSystemOutput extends AbstractOutput
 {
     #[Groups(['operative-system:read', 'partition:read', 'software-profile:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El nombre del sistema operativo',
+        example: 'Windows 10 Pro'
+    )]
     public string $name;
 
     #[Groups(['operative-system:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del sistema operativo',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['operative-system:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(OperativeSystem $operativeSystem)
diff --git a/src/Dto/Output/OrganizationalUnitOutput.php b/src/Dto/Output/OrganizationalUnitOutput.php
index d3705bd..290f0ad 100644
--- a/src/Dto/Output/OrganizationalUnitOutput.php
+++ b/src/Dto/Output/OrganizationalUnitOutput.php
@@ -12,59 +12,129 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class OrganizationalUnitOutput extends AbstractOutput
 {
     #[Groups(['organizational-unit:read', "client:read", "user:read", 'organizational-unit:read:collection:short', 'software-profile:read', 'command-task:read'])]
+    #[ApiProperty(
+        description: 'El nombre de la unidad organizativa',
+        example: 'Aula 1'
+    )]
     public string $name;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Comentarios adicionales',
+        example: 'Aula de informática equipada con 30 equipos'
+    )]
     public ?string $comments = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'La descripción de la unidad organizativa',
+        example: 'Aula de informática principal'
+    )]
     public ?string $description = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'La ubicación física',
+        example: 'Planta baja, edificio A'
+    )]
     public ?string $location = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Indica si tiene proyector',
+        example: true
+    )]
     public ?bool $projector = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Indica si tiene pizarra digital',
+        example: false
+    )]
     public ?bool $board = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'La capacidad de la unidad organizativa',
+        example: 30
+    )]
     public ?int $capacity = null;
 
     #[Groups(['organizational-unit:read', "client:read"])]
+    #[ApiProperty(
+        description: 'El tipo de unidad organizativa',
+        example: 'aula'
+    )]
     public string $type;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'La unidad organizativa padre',
+        example: null
+    )]
     public ?self $parent = null;
 
     #[Groups(['organizational-unit:read', 'client:read', 'organizational-unit:read:collection:short'])]
+    #[ApiProperty(
+        description: 'La ruta completa de la unidad organizativa',
+        example: '/Edificio A/Planta Baja/Aula 1'
+    )]
     public string $path;
 
     #[Groups(['organizational-unit:read', "client:read"])]
-    #[ApiProperty(readableLink: true)]
+    #[ApiProperty(
+        description: 'La configuración de red de la unidad organizativa',
+        readableLink: true
+    )]
     public ?NetworkSettingsOutput $networkSettings = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Las unidades organizativas hijas',
+        example: []
+    )]
     public array $children = [];
 
     #[Groups(['organizational-unit:read', "client:read"])]
-    #[ApiProperty(readableLink: true)]
+    #[ApiProperty(
+        description: 'El calendario remoto asociado',
+        readableLink: true
+    )]
     public ?RemoteCalendarOutput $remoteCalendar = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Indica si es un PC remoto',
+        example: false
+    )]
     public ?bool $remotePc = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Indica si está disponible según el calendario',
+        example: true
+    )]
     public ?bool $available = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Indica si excluye cambios del padre',
+        example: false
+    )]
     public ?bool $excludeParentChanges = null;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la unidad organizativa',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(OrganizationalUnit $organizationalUnit, array $context = [])
diff --git a/src/Dto/Output/PartitionOutput.php b/src/Dto/Output/PartitionOutput.php
index 394abcb..76e55e2 100644
--- a/src/Dto/Output/PartitionOutput.php
+++ b/src/Dto/Output/PartitionOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\ImageImageRepository;
 use App\Entity\Partition;
@@ -11,30 +12,66 @@ use Symfony\Component\Serializer\Annotation\Groups;
 class PartitionOutput extends AbstractOutput
 {
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El número del disco',
+        example: 1
+    )]
     public ?int $diskNumber = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El número de la partición',
+        example: 1
+    )]
     public ?int $partitionNumber = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El código del tipo de partición',
+        example: '83'
+    )]
     public ?string $partitionCode = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El tamaño de la partición en MB',
+        example: 51200
+    )]
     public ?int $size = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El contenido de la caché',
+        example: 'system'
+    )]
     public ?string $cacheContent = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El sistema de archivos',
+        example: 'ext4'
+    )]
     public ?string $filesystem = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El sistema operativo instalado en la partición',
+        example: null
+    )]
     public ?OperativeSystemOutput $operativeSystem = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'La imagen asociada a la partición',
+        example: null
+    )]
     public ?ImageImageRepositoryOutput $image = null;
 
     #[Groups(['partition:read', 'client:read'])]
+    #[ApiProperty(
+        description: 'El porcentaje de uso de memoria',
+        example: 45
+    )]
     public ?int $memoryUsage = null;
 
     public function __construct(Partition $partition)
diff --git a/src/Dto/Output/PxeTemplateOutput.php b/src/Dto/Output/PxeTemplateOutput.php
index f625215..87c3578 100644
--- a/src/Dto/Output/PxeTemplateOutput.php
+++ b/src/Dto/Output/PxeTemplateOutput.php
@@ -12,24 +12,52 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class PxeTemplateOutput extends AbstractOutput
 {
     #[Groups(['pxe-template:read', 'client:read', 'organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'El nombre de la plantilla PXE',
+        example: 'Plantilla BIOS'
+    )]
     public string $name;
 
     #[Groups(['pxe-template:read'])]
+    #[ApiProperty(
+        description: 'Indica si la plantilla está sincronizada',
+        example: true
+    )]
     public ?bool $synchronized = null;
 
     #[Groups(['pxe-template:read'])]
+    #[ApiProperty(
+        description: 'El contenido de la plantilla PXE',
+        example: 'DEFAULT ogLive\nPROMPT 0\nTIMEOUT 0...'
+    )]
     public ?string $templateContent = '';
 
     #[Groups(['pxe-template:read'])]
+    #[ApiProperty(
+        description: 'Indica si es la plantilla predeterminada',
+        example: true
+    )]
     public ?bool $isDefault = null;
 
     #[Groups(['pxe-template:read'])]
+    #[ApiProperty(
+        description: 'El número de clientes que usan esta plantilla',
+        example: 15
+    )]
     public ?int $clientsLength = 0;
 
     #[Groups(['pxe-template:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la plantilla',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['pxe-template:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(PxeTemplate $pxeTemplate)
diff --git a/src/Dto/Output/RemoteCalendarOutput.php b/src/Dto/Output/RemoteCalendarOutput.php
index b079f8a..52d80b7 100644
--- a/src/Dto/Output/RemoteCalendarOutput.php
+++ b/src/Dto/Output/RemoteCalendarOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\RemoteCalendar;
 use App\Entity\RemoteCalendarRule;
@@ -11,15 +12,27 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class RemoteCalendarOutput extends AbstractOutput
 {
     #[Groups(['remote-calendar:read', 'organizational-unit:read'])]
+    #[ApiProperty(
+        description: 'El nombre del calendario remoto',
+        example: 'Horario Escolar'
+    )]
     public ?string $name = null;
 
     /**
      * @var RemoteCalendarRuleOutput[]
      */
     #[Groups(['remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Las reglas del calendario remoto',
+        example: []
+    )]
     public array $remoteCalendarRules = [];
 
     #[Groups(['remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del calendario',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public ?\DateTimeInterface $createdAt = null;
 
     public function __construct(RemoteCalendar $remoteCalendar)
diff --git a/src/Dto/Output/RemoteCalendarRuleOutput.php b/src/Dto/Output/RemoteCalendarRuleOutput.php
index 9617599..894498e 100644
--- a/src/Dto/Output/RemoteCalendarRuleOutput.php
+++ b/src/Dto/Output/RemoteCalendarRuleOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\RemoteCalendarRule;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,24 +11,52 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class RemoteCalendarRuleOutput extends AbstractOutput
 {
     #[Groups(['remote-calendar-rule:read', 'remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Los días de la semana ocupados',
+        example: ['monday', 'wednesday', 'friday']
+    )]
     public ?array $busyWeekDays = null;
 
     #[Groups(['remote-calendar-rule:read', 'remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Hora de inicio del periodo ocupado',
+        example: '08:00'
+    )]
     public ?string $busyFromHour =  null;
 
     #[Groups(['remote-calendar-rule:read', 'remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Hora de fin del periodo ocupado',
+        example: '14:00'
+    )]
     public ?string $busyToHour = null;
 
     #[Groups(['remote-calendar-rule:read', 'remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Indica si está disponible para acceso remoto',
+        example: true
+    )]
     public ?bool $isRemoteAvailable = false;
 
     #[Groups(['remote-calendar-rule:read', 'remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Fecha desde la que está disponible',
+        example: '2024-01-15T00:00:00+00:00'
+    )]
     public ?\DateTimeInterface $availableFromDate = null;
 
     #[Groups(['remote-calendar-rule:read', 'remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'Fecha hasta la que está disponible',
+        example: '2024-06-30T23:59:59+00:00'
+    )]
     public ?\DateTimeInterface $availableToDate = null;
 
     #[Groups(['remote-calendar-rule:read', 'remote-calendar:read'])]
+    #[ApiProperty(
+        description: 'El motivo de la disponibilidad',
+        example: 'Periodo lectivo'
+    )]
     public ?string $availableReason = null;
 
     public function __construct(RemoteCalendarRule $remoteCalendarRule)
diff --git a/src/Dto/Output/SoftwareOutput.php b/src/Dto/Output/SoftwareOutput.php
index 20da642..cf84134 100644
--- a/src/Dto/Output/SoftwareOutput.php
+++ b/src/Dto/Output/SoftwareOutput.php
@@ -11,18 +11,38 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class SoftwareOutput extends AbstractOutput
 {
     #[Groups(['software:read', 'software-profile:read'])]
+    #[ApiProperty(
+        description: 'El nombre del software',
+        example: 'Microsoft Office 2019'
+    )]
     public string $name;
 
     #[Groups(['software:read'])]
+    #[ApiProperty(
+        description: 'La descripción del software',
+        example: 'Suite de oficina completa'
+    )]
     public ?string $description = '';
 
     #[Groups(['software:read', 'software-profile:read'])]
+    #[ApiProperty(
+        description: 'El tipo de software',
+        example: 'productivity'
+    )]
     public ?string $type = '';
 
     #[Groups(['software:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del software',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['software:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(Software $software)
diff --git a/src/Dto/Output/SoftwareProfileOutput.php b/src/Dto/Output/SoftwareProfileOutput.php
index 1b2f423..b3945bf 100644
--- a/src/Dto/Output/SoftwareProfileOutput.php
+++ b/src/Dto/Output/SoftwareProfileOutput.php
@@ -12,24 +12,52 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class SoftwareProfileOutput extends AbstractOutput
 {
     #[Groups(['software-profile:read', 'image:read'])]
+    #[ApiProperty(
+        description: 'La descripción del perfil de software',
+        example: 'Perfil estándar para aula de informática'
+    )]
     public ?string $description = '';
 
     #[Groups(['software-profile:read'])]
+    #[ApiProperty(
+        description: 'Comentarios adicionales sobre el perfil',
+        example: 'Incluye software educativo básico'
+    )]
     public ?string $comments = '';
 
     #[Groups(['software-profile:read'])]
+    #[ApiProperty(
+        description: 'La unidad organizativa asociada',
+        example: null
+    )]
     public ?OrganizationalUnitOutput $organizationalUnit = null;
 
     #[Groups(['software-profile:read'])]
+    #[ApiProperty(
+        description: 'El sistema operativo base del perfil',
+        example: null
+    )]
     public ?OperativeSystemOutput $operativeSystem = null;
 
     #[Groups(['software-profile:item:get'])]
+    #[ApiProperty(
+        description: 'La colección de software incluido en el perfil',
+        example: []
+    )]
     public ?array $softwareCollection = [];
 
     #[Groups(['software-profile:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del perfil de software',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['software-profile:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(SoftwareProfile $softwareProfile)
diff --git a/src/Dto/Output/SubnetOutput.php b/src/Dto/Output/SubnetOutput.php
index 672e6d1..7ac8868 100644
--- a/src/Dto/Output/SubnetOutput.php
+++ b/src/Dto/Output/SubnetOutput.php
@@ -13,36 +13,80 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class SubnetOutput extends AbstractOutput
 {
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'El nombre de la subred',
+        example: 'Subred Principal'
+    )]
     public string $name;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'La máscara de subred',
+        example: '255.255.255.0'
+    )]
     public string $netmask;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'La dirección IP de la subred',
+        example: '192.168.1.0'
+    )]
     public string $ipAddress;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'La dirección del servidor TFTP siguiente',
+        example: '192.168.1.10'
+    )]
     public ?string $nextServer = null;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'El nombre del archivo de arranque',
+        example: 'pxelinux.0'
+    )]
     public ?string $bootFileName = null;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'La dirección del router/gateway',
+        example: '192.168.1.1'
+    )]
     public ?string $router = null;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'La dirección del servidor DNS',
+        example: '8.8.8.8'
+    )]
     public ?string $dns = null;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'Indica si la subred está sincronizada',
+        example: true
+    )]
     public ?bool $synchronized = false;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'El ID del servidor DHCP',
+        example: 1
+    )]
     public ?int $serverId;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la subred',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['subnet:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(Subnet $subnet)
diff --git a/src/Dto/Output/TraceOutput.php b/src/Dto/Output/TraceOutput.php
index 94bd188..21f3214 100644
--- a/src/Dto/Output/TraceOutput.php
+++ b/src/Dto/Output/TraceOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\Menu;
 use App\Entity\Trace;
@@ -11,36 +12,80 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class TraceOutput extends AbstractOutput
 {
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'El comando ejecutado',
+        example: 'Reiniciar sistema'
+    )]
     public ?string $command;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'El cliente sobre el que se ejecutó el comando',
+        example: null
+    )]
     public ?ClientOutput $client = null;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'El estado de la traza',
+        example: 'completed'
+    )]
     public string $status;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'El ID del trabajo asociado',
+        example: 'job-12345'
+    )]
     public ?string $jobId = null;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'Fecha de ejecución del comando',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public ?\DateTimeInterface $executedAt = null;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'La salida del comando ejecutado',
+        example: 'Sistema reiniciado correctamente'
+    )]
     public ?string $output = null;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'Los parámetros de entrada del comando',
+        example: []
+    )]
     public ?array $input = null;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'Fecha de finalización del comando',
+        example: '2024-01-15T10:31:00+00:00'
+    )]
     public ?\DateTimeInterface $finishedAt = null;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'El progreso de ejecución (0.0 a 1.0)',
+        example: 1.0
+    )]
     public ?float $progress = null;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación de la traza',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['trace:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(Trace $trace)
diff --git a/src/Dto/Output/UserGroupOutput.php b/src/Dto/Output/UserGroupOutput.php
index 3892d4b..22e0a81 100644
--- a/src/Dto/Output/UserGroupOutput.php
+++ b/src/Dto/Output/UserGroupOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\User;
 use App\Entity\UserGroup;
@@ -11,18 +12,38 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class UserGroupOutput extends AbstractOutput
 {
     #[Groups(['user-group:read', 'user:read'])]
+    #[ApiProperty(
+        description: 'El nombre del grupo de usuarios',
+        example: 'Administradores'
+    )]
     public string $name;
 
     #[Groups(['user-group:read'])]
+    #[ApiProperty(
+        description: 'Los permisos asignados al grupo',
+        example: ['clients.read', 'clients.write', 'images.read']
+    )]
     public array $permissions;
 
     #[Groups(['user-group:read'])]
+    #[ApiProperty(
+        description: 'Indica si el grupo está habilitado',
+        example: true
+    )]
     public bool $enabled;
 
     #[Groups(['user-group:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del grupo de usuarios',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['user-group:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(UserGroup $userGroup)
diff --git a/src/Dto/Output/UserOutput.php b/src/Dto/Output/UserOutput.php
index afa038f..c67c8fc 100644
--- a/src/Dto/Output/UserOutput.php
+++ b/src/Dto/Output/UserOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\OrganizationalUnit;
 use App\Entity\User;
@@ -12,24 +13,59 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class UserOutput extends AbstractOutput
 {
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'El nombre de usuario',
+        example: 'admin'
+    )]
     public string $username;
 
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'Los roles asignados al usuario',
+        example: ['ROLE_USER', 'ROLE_ADMIN']
+    )]
     public array $roles;
 
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'Indica si el usuario está habilitado',
+        example: true
+    )]
     public bool $enabled;
+
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'Las unidades organizativas permitidas para el usuario',
+        example: []
+    )]
     public array $allowedOrganizationalUnits;
+
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'Los grupos de usuario asignados',
+        example: []
+    )]
     public array $userGroups;
+
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'La vista por defecto de grupos para el usuario',
+        example: 'card'
+    )]
     public ?string $groupsView = 'card';
 
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'Fecha de creación del usuario',
+        example: '2024-01-15T10:30:00+00:00'
+    )]
     public \DateTime $createdAt;
 
     #[Groups(['user:read'])]
+    #[ApiProperty(
+        description: 'Usuario que creó este registro',
+        example: 'admin'
+    )]
     public ?string $createdBy = null;
 
     public function __construct(User $user)
diff --git a/src/Dto/Output/ViewOutput.php b/src/Dto/Output/ViewOutput.php
index e2f17bb..d8a9837 100644
--- a/src/Dto/Output/ViewOutput.php
+++ b/src/Dto/Output/ViewOutput.php
@@ -2,6 +2,7 @@
 
 namespace App\Dto\Output;
 
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Get;
 use App\Entity\View;
 use Symfony\Component\Serializer\Annotation\Groups;
@@ -10,12 +11,24 @@ use Symfony\Component\Serializer\Annotation\Groups;
 final class ViewOutput extends AbstractOutput
 {
     #[Groups(['view:read'])]
+    #[ApiProperty(
+        description: 'El nombre de la vista',
+        example: 'Mi Vista Personalizada'
+    )]
     public string $name;
 
     #[Groups(['view:read'])]
+    #[ApiProperty(
+        description: 'Indica si es una vista favorita',
+        example: true
+    )]
     public bool $favorite;
 
     #[Groups(['view:read'])]
+    #[ApiProperty(
+        description: 'Los filtros aplicados en la vista',
+        example: []
+    )]
     public ?array $filters = null;
 
     public function __construct(View $view)
diff --git a/src/Factory/ClientFactory.php b/src/Factory/ClientFactory.php
index b8f4b89..902955c 100644
--- a/src/Factory/ClientFactory.php
+++ b/src/Factory/ClientFactory.php
@@ -3,6 +3,7 @@
 namespace App\Factory;
 
 use App\Entity\Client;
+use App\Model\OrganizationalUnitTypes;
 use Zenstruck\Foundry\ModelFactory;
 use Zenstruck\Foundry\Persistence\PersistentProxyObjectFactory;
 
@@ -33,6 +34,7 @@ final class ClientFactory extends ModelFactory
             'name' => self::faker()->text(255),
             'updatedAt' => self::faker()->dateTime(),
             'maintenance' => self::faker()->boolean(),
+            'organizationalUnit' => OrganizationalUnitFactory::createOne(['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT])->_save(),
         ];
     }
 
diff --git a/src/Factory/HardwareProfileFactory.php b/src/Factory/HardwareProfileFactory.php
index fe3148b..13021dc 100644
--- a/src/Factory/HardwareProfileFactory.php
+++ b/src/Factory/HardwareProfileFactory.php
@@ -38,7 +38,7 @@ final class HardwareProfileFactory extends ModelFactory
             'createdAt' => self::faker()->dateTime(),
             'updatedAt' => self::faker()->dateTime(),
             'description' => self::faker()->text(255),
-            'organizationalUnit' => OrganizationalUnitFactory::createOne(['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT])->_save(),
+            'client' => ClientFactory::new(),
         ];
     }
 
diff --git a/tests/Functional/ClientTest.php b/tests/Functional/ClientTest.php
index c09b047..20efdda 100644
--- a/tests/Functional/ClientTest.php
+++ b/tests/Functional/ClientTest.php
@@ -3,17 +3,10 @@
 namespace Functional;
 
 use App\Entity\Client;
-use App\Entity\HardwareProfile;
-use App\Entity\HardwareType;
 use App\Entity\OrganizationalUnit;
-use App\Entity\User;
-use App\Entity\UserGroup;
 use App\Factory\ClientFactory;
-use App\Factory\HardwareProfileFactory;
-use App\Factory\HardwareTypeFactory;
 use App\Factory\OrganizationalUnitFactory;
 use App\Factory\UserFactory;
-use App\Factory\UserGroupFactory;
 use App\Model\OrganizationalUnitTypes;
 use App\Model\UserGroupPermissions;
 use Symfony\Component\HttpFoundation\Response;
@@ -29,7 +22,6 @@ class ClientTest extends AbstractTest
     CONST string CLIENT_CREATE = 'test-client-create';
     CONST string CLIENT_UPDATE = 'test-client-update';
     CONST string CLIENT_DELETE = 'test-client-delete';
-    const string HW_PROFILE = 'HW Test';
 
     /**
      * @throws RedirectionExceptionInterface
@@ -71,13 +63,9 @@ class ClientTest extends AbstractTest
         OrganizationalUnitFactory::createOne(['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT]);
         $ouIri = $this->findIriBy(OrganizationalUnit::class, ['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT]);
 
-        HardwareProfileFactory::createOne(['description' => self::HW_PROFILE]);
-        $hpIri = $this->findIriBy(HardwareProfile::class, ['description' => self::HW_PROFILE]);
-
         $this->createClientWithCredentials()->request('POST', '/clients',['json' => [
             'name' => self::CLIENT_CREATE,
             'organizationalUnit' => $ouIri,
-            'hardwareProfile' => $hpIri,
             'serialNumber' => '123abc',
         ]]);
 
@@ -103,9 +91,8 @@ class ClientTest extends AbstractTest
         UserFactory::createOne(['username' => self::USER_ADMIN, 'roles'=> [UserGroupPermissions::ROLE_SUPER_ADMIN]]);
 
         $ou = OrganizationalUnitFactory::createOne(['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT]);
-        $hp = HardwareProfileFactory::createOne(['description' => self::HW_PROFILE]);
 
-        ClientFactory::createOne(['name' => self::CLIENT_UPDATE, 'serialNumber' => '123abc', 'organizationalUnit' => $ou, 'hardwareProfile' => $hp]);
+        ClientFactory::createOne(['name' => self::CLIENT_UPDATE, 'serialNumber' => '123abc', 'organizationalUnit' => $ou]);
         $iri = $this->findIriBy(Client::class, ['name' => self::CLIENT_UPDATE]);
 
         $this->createClientWithCredentials()->request('PUT', $iri, ['json' => [
@@ -133,9 +120,8 @@ class ClientTest extends AbstractTest
         UserFactory::createOne(['username' => self::USER_ADMIN, 'roles'=> [UserGroupPermissions::ROLE_SUPER_ADMIN]]);
 
         $ou = OrganizationalUnitFactory::createOne(['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT]);
-        $hp = HardwareProfileFactory::createOne(['description' => self::HW_PROFILE]);
 
-        ClientFactory::createOne(['name' => self::CLIENT_DELETE, 'serialNumber' => '123abc', 'organizationalUnit' => $ou, 'hardwareProfile' => $hp]);
+        ClientFactory::createOne(['name' => self::CLIENT_DELETE, 'serialNumber' => '123abc', 'organizationalUnit' => $ou]);
         $iri = $this->findIriBy(Client::class, ['name' => self::CLIENT_DELETE]);
 
         $this->createClientWithCredentials()->request('DELETE', $iri);
diff --git a/tests/Functional/HardwareProfileTest.php b/tests/Functional/HardwareProfileTest.php
index 6d710b8..c4833aa 100644
--- a/tests/Functional/HardwareProfileTest.php
+++ b/tests/Functional/HardwareProfileTest.php
@@ -3,12 +3,11 @@
 namespace Functional;
 
 
+use App\Entity\Client;
 use App\Entity\HardwareProfile;
-use App\Entity\OrganizationalUnit;
+use App\Factory\ClientFactory;
 use App\Factory\HardwareProfileFactory;
-use App\Factory\OrganizationalUnitFactory;
 use App\Factory\UserFactory;
-use App\Model\OrganizationalUnitTypes;
 use App\Model\UserGroupPermissions;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
@@ -59,12 +58,12 @@ class HardwareProfileTest extends AbstractTest
     {
         UserFactory::createOne(['username' => self::USER_ADMIN, 'roles'=> [UserGroupPermissions::ROLE_SUPER_ADMIN]]);
 
-        OrganizationalUnitFactory::createOne(['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT]);
-        $ouIri = $this->findIriBy(OrganizationalUnit::class, ['type' => OrganizationalUnitTypes::ORGANIZATIONAL_UNIT]);
+        ClientFactory::createOne(['name' => 'test-client']);
+        $clientIri = $this->findIriBy(Client::class, ['name' => 'test-client']);
 
         $this->createClientWithCredentials()->request('POST', '/hardware-profiles',['json' => [
             'description' => self::HW_PROFILE_CREATE,
-            'organizationalUnit' => $ouIri
+            'client' => $clientIri
         ]]);
 
         $this->assertResponseStatusCodeSame(201);
diff --git a/tests/Functional/ImageRepositoryTest.php b/tests/Functional/ImageRepositoryTest.php
index da616c6..0bdce48 100644
--- a/tests/Functional/ImageRepositoryTest.php
+++ b/tests/Functional/ImageRepositoryTest.php
@@ -2,19 +2,9 @@
 
 namespace Functional;
 
-use App\Entity\Client;
-use App\Entity\HardwareProfile;
 use App\Entity\ImageRepository;
-use App\Entity\Menu;
-use App\Entity\OrganizationalUnit;
-use App\Entity\User;
-use App\Factory\ClientFactory;
-use App\Factory\HardwareProfileFactory;
 use App\Factory\ImageRepositoryFactory;
-use App\Factory\MenuFactory;
-use App\Factory\OrganizationalUnitFactory;
 use App\Factory\UserFactory;
-use App\Model\OrganizationalUnitTypes;
 use App\Model\UserGroupPermissions;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
diff --git a/tests/Functional/MenuTest.php b/tests/Functional/MenuTest.php
index ffdd305..8154c56 100644
--- a/tests/Functional/MenuTest.php
+++ b/tests/Functional/MenuTest.php
@@ -2,17 +2,9 @@
 
 namespace Functional;
 
-use App\Entity\Client;
-use App\Entity\HardwareProfile;
 use App\Entity\Menu;
-use App\Entity\OrganizationalUnit;
-use App\Entity\User;
-use App\Factory\ClientFactory;
-use App\Factory\HardwareProfileFactory;
 use App\Factory\MenuFactory;
-use App\Factory\OrganizationalUnitFactory;
 use App\Factory\UserFactory;
-use App\Model\OrganizationalUnitTypes;
 use App\Model\UserGroupPermissions;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
diff --git a/tests/Functional/OgLiveTest.php b/tests/Functional/OgLiveTest.php
index 883b9a1..01e9834 100644
--- a/tests/Functional/OgLiveTest.php
+++ b/tests/Functional/OgLiveTest.php
@@ -2,11 +2,7 @@
 
 namespace Functional;
 
-use App\Entity\Client;
-use App\Entity\HardwareProfile;
 use App\Entity\OgLive;
-use App\Entity\User;
-use App\Factory\HardwareProfileFactory;
 use App\Factory\OgLiveFactory;
 use App\Factory\UserFactory;
 use App\Model\OgLiveStatus;
diff --git a/tests/Functional/PartitionTest.php b/tests/Functional/PartitionTest.php
index 859bba0..4168a8c 100644
--- a/tests/Functional/PartitionTest.php
+++ b/tests/Functional/PartitionTest.php
@@ -2,20 +2,9 @@
 
 namespace Functional;
 
-use App\Entity\Client;
-use App\Entity\Image;
-use App\Entity\Menu;
-use App\Entity\OperativeSystem;
 use App\Entity\Partition;
-use App\Factory\ClientFactory;
-use App\Factory\HardwareProfileFactory;
-use App\Factory\ImageFactory;
-use App\Factory\MenuFactory;
-use App\Factory\OperativeSystemFactory;
-use App\Factory\OrganizationalUnitFactory;
 use App\Factory\PartitionFactory;
 use App\Factory\UserFactory;
-use App\Model\OrganizationalUnitTypes;
 use App\Model\UserGroupPermissions;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
@@ -27,9 +16,6 @@ use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
 class PartitionTest extends AbstractTest
 {
     CONST string USER_ADMIN = 'ogadmin';
-    CONST string CLIENT_CREATE = 'test-client-create';
-
-    const string HW_PROFILE = 'HW Test';
 
     /**
      * @throws RedirectionExceptionInterface
diff --git a/tests/Functional/ViewTest.php b/tests/Functional/ViewTest.php
index 5a0b016..ccdd769 100644
--- a/tests/Functional/ViewTest.php
+++ b/tests/Functional/ViewTest.php
@@ -3,14 +3,9 @@
 namespace Functional;
 
 
-use App\Entity\HardwareProfile;
-use App\Entity\OrganizationalUnit;
 use App\Entity\View;
-use App\Factory\HardwareProfileFactory;
-use App\Factory\OrganizationalUnitFactory;
 use App\Factory\UserFactory;
 use App\Factory\ViewFactory;
-use App\Model\OrganizationalUnitTypes;
 use App\Model\UserGroupPermissions;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;