Saltar al contenido principal

Gaia_Sales

Descripción General​

El módulo Gaia_Sales personaliza y extiende la funcionalidad del módulo de ventas de Magento 2. Incluye modificaciones en el procesamiento de órdenes, gestión de items de orden y servicios relacionados con ventas, además de integrar con sistemas de mensajería para procesamiento asíncrono.

Features​

Procesamiento Personalizado de Órdenes​

  • Descripción: Personaliza el comportamiento después de crear una orden.
  • Tipo de modificación: Observer y plugins.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Observer/Orderplaceafter.php
    • Plugin/Model/Service/OrderService.php
  • Notas importantes:
    • Se ejecuta después de crear una orden para procesamiento adicional.

Gestión Personalizada de Items de Orden​

  • Descripción: Extiende la funcionalidad de gestión de items de orden.
  • Tipo de modificación: Plugin.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Plugin/Model/Order/ItemRepository.php
  • Notas importantes:
    • Permite lógica personalizada en la gestión de items de orden.

Repositorio de Órdenes Personalizado​

  • Descripción: Personaliza el comportamiento del repositorio de órdenes.
  • Tipo de modificación: Plugin.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Plugin/Model/OrderRepository.php
  • Notas importantes:
    • Permite lógica personalizada en operaciones CRUD de órdenes.

Integración con Sistema de Mensajería​

  • Descripción: Integra con RabbitMQ para procesamiento asíncrono de ventas.
  • Tipo de modificación: Configuración de mensajería.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • etc/queue_consumer.xml
    • etc/queue_topology.xml
    • etc/communication.xml
  • Notas importantes:
    • Permite procesamiento asíncrono de operaciones de ventas.

APIs REST Personalizadas​

  • Descripción: Expone endpoints REST personalizados para operaciones de ventas.
  • Tipo de modificación: APIs REST.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • etc/webapi_rest/
  • Notas importantes:
    • Proporciona endpoints para integración con sistemas externos.

Overrides, Observers y Plugins Importantes​

Observers​

  • sales_order_place_after → Gaia\Sales\Observer\Orderplaceafter
    • Descripción: Se ejecuta después de crear una orden para procesamiento adicional.

Plugins​

  • Magento\Sales\Model\OrderRepository
    • Descripción: Personaliza operaciones CRUD del repositorio de órdenes.
  • Magento\Sales\Model\Order\ItemRepository
    • Descripción: Personaliza la gestión de items de orden.
  • Magento\Sales\Model\Service\OrderService
    • Descripción: Personaliza el servicio de órdenes.

CLI Commands​

Este módulo no define comandos CLI personalizados.

APIs​

Expone endpoints REST personalizados para operaciones de ventas a través de la configuración en etc/webapi_rest/.

Consideraciones para Mantenimiento​

  • El módulo es crítico para el procesamiento de ventas y no debe desactivarse sin revisar dependencias.
  • Los plugins pueden afectar el comportamiento estándar de ventas de Magento.
  • El observer se ejecuta en cada creación de orden, por lo que debe ser eficiente.
  • La integración con RabbitMQ requiere que el sistema de mensajería esté configurado correctamente.
  • Los endpoints REST pueden ser utilizados por sistemas externos.
  • Revisar compatibilidad con actualizaciones del módulo de ventas de Magento.