ServicesService· backendDraft

Oxalis Adaptér (rola bridge)

Prijímacia a monitorovacia polovica Adaptéra — preberá doručené správy od AS4 Access Pointu, drží ich v custody žurnáli a posiela ich webhookom do portálu.

Certificate Edit

Overview

Envelope identity and kind-specific facts from the entity's spec.

Id: oxalis-bridge
Version: unversioned
Owners: TPSOFT
Hosting: self
Tags: javaspring-bootinboundmonitoring
Stateless: not declared

Neighborhood

This entity and its direct relation partners, as on the operational map.

Full map

Adaptér — prijímacie a monitorovacie APIAPI · rest

Prijímací žurnál AdaptéraData store · filesystem

Súborový stav Access PointuData store · filesystem

Interné API (dôveryhodný prijímač)Service · backend

Oxalis Adaptér (rola bridge)Service · backend

Portál (webová vrstva)Service · frontend

Oxalis AS4 rovinaSystem

Webhook doručenej správyWebhook

oxalis-bridge (Dokploy Compose)Workload

React Flow

Interfaces

This service's contract surface — what it serves, what it calls, and what it puts on the wire.

APIs exposed2

Adaptér — prijímacie a monitorovacie APIadapter-bridge-api Webhook doručenej správyinbound-delivery-webhook

Messages subscribed2

Prijatá faktúrainbound-invoice Prichádzajúce MLSmls-inbound

Relations

Declared spec links and inverses derived from the graph.

Declared here

Writes todeclared1

Prijímací žurnál Adaptéraadapter-inbound-journalaccessreadWrite

Reads fromdeclared1

Súborový stav Access Pointuoxalis-ap-storeaccessread

Exposesdeclared2

Part ofdeclared1

Oxalis AS4 rovinaoxalis-system

Subscribes todeclared2

Derived from the graph

Called byderived2

Interné API (dôveryhodný prijímač)api-internalprotocolhttppaths/v1/inbound/{transmissionId}/payload, /v1/inbound/{transmissionId}/receipt
Portál (webová vrstva)portal-webprotocolhttppaths/v1/oxalis/status, /v1/oxalis/logs, /v1/admin/inbound/poisoned, /v1/admin/outbound/stuck

Run byderived1

oxalis-bridge (Dokploy Compose)oxalis-bridge-compose

Documentation

Markdown texts from services/oxalis-bridge/docs/ — edited via the CMS or git.

Custody prijatej správy

custody.md

Custody prijatej správy

Bridge musí správu urobiť trvanlivou skôr, než ju potvrdí Access Pointu. Preto zapisuje do adresárového žurnálu na pomenovanom zväzku a až potom odpovedá. Ak proces medzitým spadne, správa sa po štarte dohľadá a dokončí.

⚠️ Ak premenná s cestou k žurnálu nie je nastavená, Adaptér nespadne — len zaloguje varovanie a použije dočasný adresár. Custody potom pád procesu neprežije. To je konfiguračná pasca, nie chyba kódu, a stojí za kontrolu pri každom nasadení.

Prečo sa nesmie oddeliť od Access Pointu

Bridge číta dva adresáre Access Pointu — karanténny staging a jeho logback súbor — cez pripojenia iba na čítanie. Sú to pomenované zväzky, nie sieťové volania, takže obe služby musia bežať na tom istom hostiteľovi. V katalógu sú to dve služby a jeden systém; hranicou nasadenia je systém.

Fail-closed mapovanie na nájomníka

Prichádzajúca správa nesie iba identifikátor účastníka. Mapovanie na nájomníka musí skončiť práve jedným aktívnym nájomníkom, inak ide správa do karantény. Nikdy sa nehádá — nesprávne priradenie znamená, že klient vidí faktúru cudzej firmy, čo je bezpečnostný incident podľa NIS2, nie kozmetická chyba.

Custody prijatej správy

Prečo sa nesmie oddeliť od Access Pointu

Fail-closed mapovanie na nájomníka