Jak jsme postavili integrační datovou platformu pro Finanční správu.

Dodali jsme integrační datovou platformu IDR jako centrální hub pro výměnu dat mezi Finanční správou, ČSSZ a zdravotními pojišťovnami. Jádrem řešení je Java a Spring Boot na aplikační vrstvě a WSO2 jako enterprise service bus, který orchestruje toky a transformace zpráv mezi institucemi. Platforma podporuje synchronní i asynchronní integrace s definovanými SLA pro každý kanál a obsahuje robustní error handling pro komplexní státní infrastrukturu, kde výpadek jedné strany nesmí ohrozit ostatní toky. Implementovali jsme automated software packaging a deployment pipeline nad Dockerem a Ansible, což výrazně snížilo riziko deployment chyb v citlivém prostředí. Pro každou integraci jsme připravili kontraktní dokumentaci, schémata zpráv a verzování, aby bylo možné připojovat další instituce bez zásahu do jádra. Zavedli jsme audit trail nad všemi datovými výměnami v souladu s požadavky GFŘ a procesy ISO 27001 — každá zpráva má unikátní traceability ID a kompletní historii zpracování. Bezpečnostní vrstva pokrývá certifikátovou autentizaci, šifrovanou komunikaci a kontrolovaný přístup ke správě platformy. Z naší strany pracoval tech lead a tým integračních inženýrů, koordinaci na straně hlavního dodavatele řídil O2 IT Services a směrem k zákazníkovi GFŘ. Součástí předání byla detailní provozní dokumentace, runbooky pro typické incidenty a zaškolení provozního týmu pro běžnou údržbu i nasazování nových integrací.

Projekt jsme zahájili v roce 2020 fází architektonického návrhu a Proof of Concept nad WSO2, kde jsme ověřili, že platforma zvládne objem a profil zpráv mezi Finanční správou a partnerskými institucemi. Realizace probíhá iterativně po jednotlivých integračních kanálech — pro každou novou instituci nebo typ datové výměny prochází vývoj fází specifikace, vývoje, integračního testování s druhou stranou a kontrolovaného nasazení do produkce. Hlavní překážkou bylo zvládnutí komplexity WSO2 v kombinaci se specifickými požadavky státního prostředí — některé chování ESB jsme museli rozšířit vlastními moduly a v jednom integračním okruhu jsme po prvních produkčních dnech provedli refactor error handlingu, protože původní strategie nezvládala specifické chybové stavy partnerské instituce. Druhým opakujícím se tématem byla koordinace release oken s několika státními institucemi, která vyžaduje plánování v řádu týdnů a precizní rollback plány. Automated packaging přes Docker a Ansible se ukázal jako klíčový — díky němu jsme dokázali podstatně snížit chyby při nasazení a urychlit reakci na změnové požadavky. Platforma od roku 2020 trvale běží v produkci a Etyka v ní dodnes podílí na rozvoji a podpoře dalších integrací; každá rozšíření probíhá v rámci procesů ISO 27001 a kontrolovaných deployment plánů.