README

Este paquete proporciona una serie de utilidades y servicios para acelerar el desarrollo de aplicaciones Symfony en el ecosistema Develia.

Características principales

• Controladores Base:

  • ApiController: Clase base para controladores de API.
  • RestController: Implementación básica para controladores REST con métodos GET, POST, PUT y DELETE mapeados automáticamente.
  • BaseCrudController: Facilitador para operaciones CRUD estándar.

• Servicios de Gestión:

  • SettingsManager: Interfaz y servicio para gestionar configuraciones dinámicas (con soporte para base de datos y caché).
  • DatabaseLogger: Logger compatible con PSR-3 que persiste los registros en la base de datos (tablas log_entry y log_entry_meta).
  • OpenAiService: Integración simplificada con la API de OpenAI.
  • JsonSchemaGenerator: Genera JSON Schema a partir de clases PHP (para Structured Outputs de OpenAI).
  • YouTrackService: Cliente de la API REST de YouTrack (incidencias, comentarios, usuarios y roles). Configurable con las variables de entorno YOUTRACK_BASE_URL, YOUTRACK_TOKEN y YOUTRACK_PROJECT_ID. Al crear usuarios la contraseña es obligatoria (YouTrack la exige) y, en YouTrack Cloud, deleteUser() no está disponible: usar banUser(). getIssues() y getUsers() aceptan una consulta opcional para filtrar en el servidor (reporter: <login>, login o nombre del usuario…). Los roles se gestionan en Hub (getRoles(), findRole(), getUserRoles(), assignUserRole()), que identifica a los usuarios por su ringId y sólo permite conceder roles sobre proyectos registrados en Hub; para el resto, usar el proyecto global (HUB_GLOBAL_PROJECT_ID, valor por defecto).
  • SlackNotifier: Envía notificaciones a Slack mediante un Incoming Webhook. Configurable con la variable de entorno SLACK_WEBHOOK_URL.
  • TransactionManager: Utilidad para envolver ejecuciones en transacciones de base de datos.
  • LockManager: Gestión de bloqueos (locks) para evitar condiciones de carrera.

• Seguridad:

  • StaticApiKeyAuthenticator: Autenticador sencillo mediante una clave API estática enviada en las cabeceras.

• Extensiones Twig:

  • DateExtension: Filtros adicionales para el manejo de fechas en plantillas.

• Utilidades:

  • Helpers para manejo de anotaciones, rutas y respuestas XML.

Requisitos

• PHP 8.1 o superior.
• Symfony 5.4 / 6.0 o superior.
• Dependencia de develia/commons.

Instalación

Instala el paquete vía Composer:

composer require develia/symfony

Asegúrate de registrar el bundle en tu archivo config/bundles.php si no se hace automáticamente:

return [
    // ...
    Develia\Symfony\DeveliaBundle::class => ['all' => true],
];

Configuración

Puedes configurar los servicios en tus archivos de configuración de Symfony (ej. config/packages/develia.yaml). Consulta los servicios disponibles en el contenedor de servicios de Symfony.

Licencia

Propiedad de Antonio Gil Espinosa. Todos los derechos reservados.