src/Shared/Infrastructure/Observability/JftReadonlyObservabilityLogger.php line 47

Open in your IDE?
  1. <?php
  3. declare(strict_types=1);
  5. namespace App\Shared\Infrastructure\Observability;
  7. use Symfony\Component\HttpKernel\Event\RequestEvent;
  8. use Throwable;
  10. /**
  11.  * FIX-260604-002 — Servicio auxiliar para promover [OBS-JFT-READONLY]
  12.  * de `error_log()` (sin sink visible en dev3 php-fpm 8.x) a Symfony Monolog
  13.  * via el {@see ObservabilityLogger} ya cableado al canal `expedion_audit`.
  14.  *
  15.  * Patron B (servicio auxiliar) elegido por HITL (2026-06-04): la DI directa
  16.  * en {@see \App\Shared\Infrastructure\Form\Type\JsonFieldType} no es trivial
  17.  * porque el guard `isEntityReadonlyByEstado()` es `static` (testabilidad sin
  18.  * DI). Resolvemos exponiendo el servicio via singleton-holder estatico
  19.  * inicializado por el container al boot del kernel.
  20.  *
  21.  * Bootstrap: la clase se etiqueta como `kernel.event_listener` en
  22.  * `kernel.request` (priority 256, mismo patron precedente del proyecto, p.ej.
  23.  * `ExpedienteHttpObservabilityListener`). Al construir el servicio, el
  24.  * container popula automaticamente {@see self::$instance}. El metodo
  25.  * `onKernelRequest` es no-op — solo sirve para forzar la instanciacion temprana.
  26.  *
  27.  * Si por alguna razon el container aun no ha booteado (p.ej. ejecucion CLI o
  28.  * test unitario sin kernel), {@see self::instance()} devuelve un fallback no-op
  29.  * que swallow logs en silencio — garantia FIX-260518-008: observabilidad NUNCA
  30.  * rompe el flujo principal.
  31.  */
  32. final class JftReadonlyObservabilityLogger
  33. {
  34.     private static ?self $instance = null;
  36.     public function __construct(private ?ObservabilityLogger $observabilityLogger = null)
  37.     {
  38.         // Auto-publica el singleton al construirse por el container.
  39.         self::$instance = $this;
  40.     }
  42.     /**
  43.      * Listener no-op. Forza al container a instanciar el servicio en
  44.      * `kernel.request` para que `self::$instance` quede poblado antes
  45.      * de cualquier render de formulario Sonata.
  46.      */
  47.     public function onKernelRequest(RequestEvent $event): void
  48.     {
  49.         // no-op intencional; el side-effect util es el constructor.
  50.     }
  52.     /**
  53.      * Devuelve el singleton activo. Si el container aun no lo ha instanciado
  54.      * (p.ej. test sin kernel boot, llamada muy temprana), devuelve un fallback
  55.      * no-op para no romper el flujo principal.
  56.      */
  57.     public static function instance(): self
  58.     {
  59.         if (self::$instance === null) {
  60.             // Fallback no-op: sin logger inyectado, logReadonlyDecision swallow.
  61.             self::$instance = new self(null);
  62.         }
  63.         return self::$instance;
  64.     }
  66.     /**
  67.      * Permite a tests AAA inyectar/limpiar el singleton explicitamente.
  68.      */
  69.     public static function setInstanceForTesting(?self $instance): void
  70.     {
  71.         self::$instance = $instance;
  72.     }
  74.     /**
  75.      * Emite el evento [OBS-JFT-READONLY] al canal Monolog `expedion_audit`
  76.      * via {@see ObservabilityLogger}. Si el observability logger no esta
  77.      * disponible (fallback no-op), swallow silencioso.
  78.      *
  79.      * @param array<string,mixed> $context
  80.      */
  81.     public function logReadonlyDecision(array $context): void
  82.     {
  83.         try {
  84.             if ($this->observabilityLogger !== null) {
  85.                 $this->observabilityLogger->event('[OBS-JFT-READONLY]', $context);
  86.             }
  87.         } catch (Throwable $e) {
  88.             // swallow — observabilidad NUNCA rompe el flujo principal.
  89.         }
  90.     }
  91. }