Saltar al contenido principal

Gaia_Services

Descripción General​

El módulo Gaia_Services proporciona servicios centrales y utilitarios para el ecosistema Gaia en Magento 2. Incluye funcionalidades de logging, gestión de cookies, tareas programadas masivas y servicios de integración con sistemas externos como Kustomer y Algolia.

Features​

Sistema de Logging Personalizado​

  • Descripción: Implementa un sistema de logging personalizado para servicios Gaia con handlers específicos.
  • Tipo de modificación: Modelos de logging personalizados.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Model/Logger/Handler.php
    • Model/Logger/Logger.php
  • Notas importantes:
    • Proporciona logging centralizado para todos los servicios Gaia.

Gestión de Cookies Personalizada​

  • Descripción: Extiende la gestión de cookies de Magento con funcionalidades personalizadas.
  • Tipo de modificación: Override de manager de cookies.
  • Archivos del core afectados: Reemplaza Magento\Framework\Stdlib\Cookie\PhpCookieManager.
  • Archivos del módulo:
    • Model/Cookies/PhpCookieManager.php
  • Notas importantes:
    • Permite lógica personalizada en la gestión de cookies.

Tareas Programadas Masivas​

  • Descripción: Proporciona múltiples tareas cron para mantenimiento y sincronización de datos.
  • Tipo de modificación: Tareas cron personalizadas.
  • Archivos del core afectados: No modifica archivos core.
  • Archivos del módulo:
    • Cron/AlgoliaReindex.php - Reindexación de Algolia
    • Cron/CouponGaiano.php - Gestión de cupones
    • Cron/MigrateCustomers.php - Migración masiva de clientes
    • Cron/Fix404Configurable.php - Corrección de productos configurables
    • Cron/CreateVariantsFlats.php - Creación de variantes planas
  • Notas importantes:
    • Incluye tareas críticas para mantenimiento y migración de datos.

Integración con Sistemas Externos​

  • Descripción: Proporciona servicios para integración con Kustomer, Algolia y otros sistemas.
  • Tipo de modificación: Modelos de integración personalizados.
  • Archivos del core afectados: No modifica archivos core.
  • Archivos del módulo:
    • Model/Kustomer/
    • Model/Gaiagrouped/
  • Notas importantes:
    • Facilita la integración con servicios externos.

Configuración de Seguridad​

  • Descripción: Define políticas de seguridad de contenido (CSP) para servicios Gaia.
  • Tipo de modificación: Configuración de seguridad.
  • Archivos del core afectados: No modifica archivos core.
  • Archivos del módulo:
    • etc/csp_whitelist.xml
  • Notas importantes:
    • Permite conexiones seguras con servicios externos.

Overrides, Observers y Plugins Importantes​

Preferences (Overrides)​

  • Magento\Framework\Stdlib\Cookie\PhpCookieManager → Gaia\Services\Model\Cookies\PhpCookieManager
    • Descripción: Personaliza la gestión de cookies para servicios Gaia.

Configuraciones de Inyección de Dependencias​

  • Gaia\Services\Model\Logger\Handler
    • Descripción: Configura el handler de logging para servicios Gaia.
  • Gaia\Services\Model\Logger\Logger
    • Descripción: Configura el logger principal con nombre "gaiaServices".

CLI Commands​

Este módulo no define comandos CLI personalizados, pero incluye múltiples tareas cron que pueden ejecutarse manualmente.

APIs​

No expone endpoints REST o GraphQL propios, pero proporciona servicios internos para otros módulos Gaia.

Consideraciones para Mantenimiento​

  • El módulo es fundamental para el ecosistema Gaia y no debe desactivarse sin revisar dependencias.
  • Las tareas cron incluyen procesos críticos de migración y mantenimiento.
  • El override de cookies puede afectar la funcionalidad de otros módulos.
  • Los logs personalizados requieren monitoreo para detectar problemas.
  • Revisar la configuración CSP si se agregan nuevos servicios externos.
  • Las tareas de migración masiva pueden ser intensivas en recursos.