ServicesService· workerDraft

Odosielací worker

Multiplex nad tromi odosielacími frontami — faktúry, MLS a statutárny SK TDD — plus e-mailové notifikácie a exporty; volá odosielaciu rolu Adaptéra, sám na drôt nesiaha.

Certificate Edit

Overview

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

Id: worker-send
Version: unversioned
Owners: TPSOFT
Hosting: self
Tags: workerpgmqsendstatutory
Stateless: not declared

Neighborhood

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

Full map

Supabase PostgresData store · postgres

Supabase StorageData store · object-store

Cieľ WORM exportu (súborový)Data store · filesystem

Oxalis Adaptér (rola sender)Service · backend

Odosielací workerService · worker

Flotila workerovSystem

worker-send (Dokploy Compose)Workload

React Flow

Interfaces

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

Messages subscribed3

Požiadavka na odoslanie faktúrysend-invoice-request Požiadavka na odoslanie MLSsend-mls-request Požiadavka na odoslanie SK TDDsend-tdd-request

Relations

Declared spec links and inverses derived from the graph.

Declared here

Writes todeclared3

Supabase Postgressupabase-postgresaccessreadWrite
Supabase Storagesupabase-storageaccessreadWrite
Cieľ WORM exportu (súborový)worm-export-storeaccessappendOnly

Callsdeclared1

Oxalis Adaptér (rola sender)oxalis-senderprotocolhttppaths/v1/outbound, /v1/outbound/{transmissionId}/status

Part ofdeclared1

Flotila workerovworker-fleet

Subscribes todeclared3

Derived from the graph

Run byderived1

worker-send (Dokploy Compose)worker-send-compose

Documentation

Markdown texts from services/worker-send/docs/ — edited via the CMS or git.

Tri fronty, jeden proces

pruhy-a-doruceni.md

Tri fronty, jeden proces

Odosielací worker odoberá z troch pgmq front naraz — faktúry, MLS a SK TDD — a navyše obsluhuje e-mailové notifikácie a exporty. MLS a TDD pruh zdieľajú jeden parametrizovaný modul; tretia ručne prepísaná kópia je v kóde výslovne zakázaná.

Doručenie aspoň raz, odoslanie práve raz

pgmq garantuje doručenie aspoň raz, takže worker musí počítať s tým, že tú istú správu dostane dvakrát — pri páde v polovici aj pri vypršaní viditeľnosti. To, že opakované doručenie nespôsobí druhý prenos na drôt, nie je predpoklad: je to dokázané, vrátane skutočného zabitia procesu proti živému Adaptéru, kde sa na vlastnom logu Access Pointu napočítala presne jedna výmena.

Poistkou je mint-once identifikátor prenosu plus duplicitná ochrana v Adaptéri, nie zámok vo worker-i.

Vypnutie s ohľadom na frontu

Pri zastavení worker prestane začínať nové správy a nezačatý zvyšok okamžite uvoľní späť do fronty namiesto toho, aby ho držal celé okno viditeľnosti. Nasadené hodnoty grace periódy sú pritom vedome nižšie než odvodený rozpočet na dobehnutie — je to známy, nezatvorený rozdiel v deploy/.

Tri fronty, jeden proces

Doručenie aspoň raz, odoslanie práve raz

Poistkou je mint-once identifikátor prenosu plus duplicitná ochrana v Adaptéri, nie zámok vo worker-i.

Vypnutie s ohľadom na frontu