Skip to content

Latest commit

 

History

History
61 lines (41 loc) · 2.77 KB

Services-responsibilities.md

File metadata and controls

61 lines (41 loc) · 2.77 KB

In the future, we plan to have a lot of repositories (potentially in different languages) that will be responsible only for one service (one task).

However now, we have a lot of responsibilities inside one repository which simplify development workflow but causes a lot of mess with understanding responsibility segregation.

This document provides generic rules and explanation about different services within existing repositories

Communication rules

  • Basically, we can't have a direct (on code level) call from one service (repository) to another
  • Communication between different services should be done over network protocol (REST/gRPC)

Diagram

This simplified diagram highlights the main "parts" of Storefront Application (GraphQL Server and Storefront API) and responsibilities between them

image

Responsibilities

Export API.

Source: https://github.com/magento/commerce-data-export/tree/main
Provide API to Export entities from Magento to any subscribed consumer
Implement 2 different strategies:

  • Push strategy (used by PRex): push changes to remote end-point called Injection Service
  • Pull strategy (used by Storefront Application): use Event Notification approach to send an event with entity id to Message Bus. Message broker do back request to obtain actual data from Backoffice

By fact contract of Export API is described in et_schema.xml

Message Broker.

Source: https://github.com/magento/storefront-message-broker
Connect Backoffice and Storefront application.

Responsibilities:

  • do callback request (REST) for actual data to Export API
  • map Export API format to Storefront API format
  • write data (gRPC) to Storefront API

Storefront Application.

Source: https://github.com/magento/catalog-storefront/tree/develop/app/code/Magento/CatalogStorefront
Provides Read/Write API
Responsibilities:

  • provide Read API for specific attributes, scope
  • store data in efficient way in own databases

Legacy approach (historical notes)

GQL Extension for Backoffice

Source: Magento/CatalogStorefrontGraphQl , Magento/StorefrontGraphQl
Override Magento GraphQL Resolvers to make request to Storefront
Note: should be replaced with GraphQL server written on NodeJS
Responsibilities:

  • override Magento GQL resolvers
  • map GQL Query to Request acceptable for Storefront APP
  • proxy request to original Magento GQL Resolver for fields deprecated in GQL schema