Przewodnik po Open MercatoPrzewodnik redakcyjny · nie jest oficjalną dokumentacją
Menu
GitHubEN

Rodzina pojęć 04 · zachowanie infrastruktury

Usługi runtime Open Mercato i granice providerów

Wyszukiwanie, cache, kolejki, harmonogramy, webhooki i storage są odrębnymi usługami runtime. Część może działać lokalnie, natomiast full-text, vector, kolejka rozproszona, cache Redis lub storage providera wymagają osobnej infrastruktury i konfiguracji. Abstrakcje wspierają wymienność, ale nie przypisują odpowiedzialności za monitoring, ponowienia, kopie, dane dostępowe ani recovery.

Wymienność jest mechanizmem podstawienia, a nie gwarancją dostępności lub disaster recovery.

Migawka źródeł:

ae856df1ecfc · sekcje ARCHITECTURE.md: 17, 18, 19, 20

Odpowiedź bezpośrednia

Pozycja w systemie

Ta rodzina znajduje się poniżej modułów i zdarzeń, gdzie praca aplikacji staje się wpisami cache, dokumentami wyszukiwania, zadaniami kolejki, harmonogramami, wywołaniami wychodzącymi, adapterami przychodzącymi albo obiektami storage.

Odpowiedzialność usług runtime

Przyspieszenie odczytu, praca asynchroniczna, praca cykliczna, dostarczanie zewnętrzne i trwałość obiektów to osobne kontrakty z osobnymi właścicielami.

Odpowiedzialność usług runtimePrzyspieszenie odczytu, praca asynchroniczna, praca cykliczna, dostarczanie zewnętrzne i trwałość obiektów to osobne kontrakty z osobnymi właścicielami.
01

SearchService koordynuje zarejestrowane strategie tokenowe, pełnotekstowe i wektorowe oraz odfiltrowuje niedostępne strategie w runtime.

infrastructure-package

02

CacheService jest abstrakcją opartą na strategii; bezpieczne klucze tenantowe i unieważnianie pozostają odpowiedzialnością aplikacji.

infrastructure-package

03

Strategia kolejki wybiera dostarczanie lokalne albo asynchroniczne; ponawiane workery muszą być idempotentne, a restart procesów należy do operacji.

infrastructure-package

04

Harmonogramy cykliczne, podpisane webhooki i storage obiektowy korzystają z osobnych usług lub pakietów providerów z własnymi granicami awarii i danych dostępowych.

infrastructure-package

Jeden cykl integracji zewnętrznej

Przebieg oddziela decyzję o systemie referencyjnym od weryfikacji adaptera, wykonania asynchronicznego i uzgodnienia.

  1. Wdrożenie definiuje, który system jest właścicielem każdego identyfikatora i przejścia stanu.

    documented-conventionprovider-addon

  2. Adapter providera albo trasa weryfikuje kontrakt zewnętrzny i dane dostępowe.

    product-factprovider-addon

  3. Kolejki lub harmonogramy izolują pracę ponawialną i cykliczną.

    product-factprovider-addon

  4. Potwierdzenie, deduplikacja, uzgodnienie i recovery po awarii pozostają obowiązkami wdrożenia.

    documented-conventionprovider-addon

Wybór usługi i konsekwencja operacyjna

Wybór usługi i konsekwencja operacyjna
MechanizmWniosek redakcyjnyOgraniczenieWłaściciel decyzji
SearchService koordynuje zarejestrowane strategie tokenowe, pełnotekstowe i wektorowe oraz odfiltrowuje niedostępne strategie w runtime.Traktuj jako kontrakt w zakresie „infrastructure-package” i osobno potwierdź dopasowanie do projektu.Ten element jest opcjonalny lub wymaga osobnej konfiguracji, dlatego nie należy przedstawiać go jako zawsze włączonego.Operator platformy i właściciel integracji
CacheService jest abstrakcją opartą na strategii; bezpieczne klucze tenantowe i unieważnianie pozostają odpowiedzialnością aplikacji.Traktuj jako kontrakt w zakresie „infrastructure-package” i osobno potwierdź dopasowanie do projektu.Sam mechanizm nie dowodzi wydajności, bezpieczeństwa, dostępności, zgodności ani gotowości produkcyjnej konkretnego wdrożenia.Operator platformy i właściciel integracji
Strategia kolejki wybiera dostarczanie lokalne albo asynchroniczne; ponawiane workery muszą być idempotentne, a restart procesów należy do operacji.Traktuj jako kontrakt w zakresie „infrastructure-package” i osobno potwierdź dopasowanie do projektu.Ten element jest opcjonalny lub wymaga osobnej konfiguracji, dlatego nie należy przedstawiać go jako zawsze włączonego.Operator platformy i właściciel integracji
Harmonogramy cykliczne, podpisane webhooki i storage obiektowy korzystają z osobnych usług lub pakietów providerów z własnymi granicami awarii i danych dostępowych.Traktuj jako kontrakt w zakresie „infrastructure-package” i osobno potwierdź dopasowanie do projektu.Ten element jest opcjonalny lub wymaga osobnej konfiguracji, dlatego nie należy przedstawiać go jako zawsze włączonego.Operator platformy i właściciel integracji

Footguns i tryby awarii

Strategia kolejki wybiera dostarczanie lokalne albo asynchroniczne; ponawiane workery muszą być idempotentne, a restart procesów należy do operacji.

Ten element jest opcjonalny lub wymaga osobnej konfiguracji, dlatego nie należy przedstawiać go jako zawsze włączonego.

Sprawdź przypięte źródło

Harmonogramy cykliczne, podpisane webhooki i storage obiektowy korzystają z osobnych usług lub pakietów providerów z własnymi granicami awarii i danych dostępowych.

Ten element jest opcjonalny lub wymaga osobnej konfiguracji, dlatego nie należy przedstawiać go jako zawsze włączonego.

Sprawdź przypięte źródło
Źródła i metoda · 8 rekordów dowodowych

Każdy fakt, węzeł, połączenie i krok przebiegu ma stabilny identyfikator, klasę twierdzenia, lokalizator źródła, zakres, ograniczenie oraz przypiętą wersję. Lokalny skrypt sprawdza istnienie każdego pliku i lokalizatora oraz pokrycie sekcji 1–33 dokładnie raz.

  • SearchService koordynuje zarejestrowane strategie tokenowe, pełnotekstowe i wektorowe oraz odfiltrowuje niedostępne strategie w runtime.

    ID
    section-17-search
    Klasa
    product-fact
    Zakres
    infrastructure-package
    Źródło
    packages/search/src/service.ts · export class SearchService

  • CacheService jest abstrakcją opartą na strategii; bezpieczne klucze tenantowe i unieważnianie pozostają odpowiedzialnością aplikacji.

    ID
    section-18-cache
    Klasa
    product-fact
    Zakres
    infrastructure-package
    Źródło
    packages/cache/src/service.ts · export class CacheService

  • Strategia kolejki wybiera dostarczanie lokalne albo asynchroniczne; ponawiane workery muszą być idempotentne, a restart procesów należy do operacji.

    ID
    section-19-queue
    Klasa
    product-fact
    Zakres
    infrastructure-package
    Źródło
    packages/queue/src/factory.ts · export function resolveQueueStrategy

  • Harmonogramy cykliczne, podpisane webhooki i storage obiektowy korzystają z osobnych usług lub pakietów providerów z własnymi granicami awarii i danych dostępowych.

    ID
    section-20-runtime-providers
    Klasa
    product-fact
    Zakres
    infrastructure-package

  • Wdrożenie definiuje, który system jest właścicielem każdego identyfikatora i przejścia stanu.

    ID
    flow-integration-authority
    Klasa
    documented-convention
    Zakres
    provider-addon
    Źródło
    ARCHITECTURE.md · ### Webhooks

  • Adapter providera albo trasa weryfikuje kontrakt zewnętrzny i dane dostępowe.

    ID
    flow-integration-adapter
    Klasa
    product-fact
    Zakres
    provider-addon
    Źródło
    packages/webhooks/src/modules/webhooks/lib/adapter-registry.ts · export interface WebhookEndpointAdapter

  • Kolejki lub harmonogramy izolują pracę ponawialną i cykliczną.

    ID
    flow-integration-async
    Klasa
    product-fact
    Zakres
    provider-addon

  • Potwierdzenie, deduplikacja, uzgodnienie i recovery po awarii pozostają obowiązkami wdrożenia.

    ID
    flow-integration-reconcile
    Klasa
    documented-convention
    Zakres
    provider-addon
    Źródło
    ARCHITECTURE.md · Workers and subscribers MUST be idempotent.