Komunikacja między modułami

Moduły w Orbito są od siebie fizycznie odizolowane – każdy działa w osobnym kontenerze Docker i nie ma bezpośredniego dostępu do kodu ani pamięci innego modułu. Cała komunikacja między modułami przechodzi przez serwer Orbito, który pełni rolę brokera.

Platforma oferuje dwa uzupełniające się mechanizmy komunikacji.

Dwa modele komunikacji

Core.callModule – wywołanie bezpośrednie

Wywołanie konkretnej metody w konkretnym module. Wywołujący zna identyfikator docelowego modułu i czeka na wynik.

const result = await Core.callModule('core/orders', 'status.search', { orderId });

Użyteczne gdy:

• wywołujący potrzebuje danych od konkretnego modułu,
• zależność między modułami jest świadoma i celowa,
• potrzebna jest odpowiedź synchroniczna.

Hooki – wywołanie rozgłoszeniowe

Platforma wywołuje wszystkie moduły, które zarejestrowały obsługę danego zdarzenia. Wywołujący nie wie (i nie musi wiedzieć), które moduły odpowiedzą.

// Wywołanie – moduł core/orders pyta o dostępnych przewoźników
const carriers = await Core.execHook('core.shipping.getCarrier', { order });

// Obsługa – moduł integracji z DPD odpowiada na hook
Core.registerHook('core.shipping.getCarrier', async ({ order }) => {
  return { carrierId: 'dpd', label: 'DPD', price: 9.99 };
});

Użyteczne gdy:

• rdzeń systemu chce zebrać dane od wszystkich zainstalowanych integracji,
• liczba modułów odpowiadających nie jest z góry znana,
• chcesz umożliwić rozszerzanie zachowania systemu bez modyfikacji istniejących modułów.

Kiedy użyć callModule, a kiedy hooków?