Sari la conținutul principal
Începe un proiect
RawBotics Works · Capability C—04 INTEROPERABILITATE CONTROLATĂ

04  Capabilități

Systems Integration

Sisteme diferite. Un flux comun de informație și acțiune.

Proiectăm arhitecturi de integrare care conectează aplicații, date, servicii și procese fără să transforme ecosistemul digital într-o rețea fragilă de dependențe.

APP ERP CRM DOCUMENTS IDENTITY EXTERNAL API INTEGRATION LAYER GATEWAY AUTH MAPPING TRANSFORM ROUTING EVENTS OBSERVABILITY DATA AI WORKFLOW FIG. 00 — CONNECTED SYSTEM LANDSCAPE

01  Coupling

Două sisteme conectate nu înseamnă încă o arhitectură de integrare.

Pe măsură ce numărul de aplicații crește, conexiunile directe devin greu de controlat, observat și schimbat.

O integrare punctuală rezolvă o nevoie imediată. Zece integrări punctuale creează o topologie pe care nimeni nu o mai poate descrie complet — și pe care nimeni nu o mai poate modifica fără risc.

  • 01Point-to-point coupling. Fiecare sistem cunoaște direct formatul, adresa și disponibilitatea celuilalt.
  • 02Logică duplicată. Aceeași transformare este rescrisă în trei locuri și corectată doar în două.
  • 03Dependențe ascunse. Un câmp redenumit într-un sistem oprește un flux despre care nimeni nu știa.
  • 04Date inconsistente. Aceeași entitate există în versiuni diferite, fără o sursă de adevăr declarată.
  • 05Integrări fragile. Fără retry, idempotency sau stare vizibilă, o eroare temporară devine pierdere de date.
  • 06Risc operațional. Schimbările se amână, pentru că impactul lor real nu poate fi estimat.
INTEGRATION LAYER ERP CRM DOCS DATA APP API 6 SISTEME · 15 CONEXIUNI DIRECTE 6 SISTEME · 6 CONEXIUNI CĂTRE UN SINGUR STRAT
FIG. 01 — Topologie directă vs. topologie rutată n(n−1)/2 → n

02  Arhitectură

Integrarea are nevoie de un strat propriu de arhitectură.

Nu un set de conectori, ci un loc unde traficul dintre sisteme este primit, autentificat, validat, tradus, rutat și observat — o singură dată, pentru toate.

SOURCE SYSTEMS ERP · CRM APLICAȚII INTERNE SERVICII EXTERNE INTEGRATION LAYER UN SINGUR LOC DE CONTROL API GATEWAYintrare unică AUTHidentitate și scopes MAPPINGschema → schema TRANSFORMATIONformat și unități ROUTINGcine primește ce EVENTSpublish / subscribe VALIDATIONcontract respectat OBSERVABILITYstare și traseu CONTROL · POLICY · SECRETS · RATE LIMITS DATA PLATFORM AI SYSTEMS WORKFLOW TARGET SYSTEMS
FIG. 02 — Stratul de integrare Sursă → strat → destinație

Stratul nu înlocuiește sistemele. Le izolează unele de altele: fiecare aplicație vorbește cu o interfață stabilă, nu cu implementarea vecinului. Când un sistem se schimbă, schimbarea se oprește la marginea stratului.

Dimensionarea contează. Un strat de integrare poate fi un set de servicii proprii, o platformă de integrare existentă sau o combinație — decizia se ia din volum, latență, cerințe de securitate și din echipa care îl va opera.

03  Contracte

Un API bun este un contract între sisteme.

Nu descrie doar ce returnează. Descrie ce garantează: forma răspunsului, comportamentul la eroare, limitele și ce se întâmplă când se schimbă.

CONTRACT — SCHEMA · VERSIONING · AUTH · ERRORS · RATE LIMITS · COMPATIBILITATE REQUEST AUTH VALIDATION SERVICE RESPONSE 401 · UNAUTHORIZED 422 · SCHEMA 429 · RATE LIMIT 200 · OK VERSIUNE ACTIVĂ v2 v1 · DEPRECATED COMPATIBILITATE PĂSTRATĂ PÂNĂ LA RETRAGEREA ANUNȚATĂ
FIG. 03 — Traseul unei cereri și stările contractului Request → Auth → Validation → Service → Response
  • 01Interfețe stabile. Consumatorii nu ar trebui să se adapteze la fiecare refactorizare internă.
  • 02Versionare explicită. O schimbare care rupe contractul primește o versiune, nu o notă în changelog.
  • 03Scheme declarate. Forma datelor este verificabilă automat, nu dedusă din exemple.
  • 04Erori previzibile. Coduri și mesaje consecvente, pe care un client le poate trata programatic.
  • 05Limite declarate. Rate limits și cote comunicate în răspuns, nu descoperite în producție.
  • 06Documentație vie. Generată din contract, deci imposibil de rămas în urmă față de implementare.

04  Semantică

Sistemele nu vorbesc întotdeauna aceeași limbă.

Același client are trei nume de câmp, două formate de dată și o singură definiție corectă. Modelul canonic este locul unde se decide care este aceea.

SYSTEM A — SCHEMA customer_id cname addr_line1 vat_no created CANONICAL MODEL id name address taxId createdAt SYSTEM B — SCHEMA PartnerID PartnerName BillingAddress TaxCode RegisteredOn fx fx MAPPING TRANSFORMATION fx · TVA: „RO12345678” → prefix ISO + cifre validate fx · dată: „2026-03-14T09:12Z” → format local, fus orar explicit
FIG. 04 — Schema A → model canonic → schema B Mapping ≠ transformation
  • 01Schema mapping. Corespondența dintre câmpuri, declarată o singură dată și versionată.
  • 02Transformation. Format, unități, coduri, fusuri orare — reguli explicite, nu convenții orale.
  • 03Normalizare. Aceeași entitate arată la fel indiferent din ce sistem a intrat.
  • 04Enrichment. Completarea controlată din surse de referință, cu proveniență păstrată.
  • 05Validare. Ce nu respectă contractul este oprit devreme, nu descoperit trei sisteme mai târziu.
  • 06Data contracts. Producătorul și consumatorul se înțeleg asupra formei, nu doar asupra conexiunii.

05  Consistență

Sincronizarea nu înseamnă doar mutarea datelor. Înseamnă menținerea consistenței.

Două sisteme care scriu aceeași entitate vor ajunge, la un moment dat, să nu fie de acord. Arhitectura decide dinainte cine câștigă și ce se întâmplă cu restul.

  • 01Source of truth. Pentru fiecare entitate, un singur sistem decide. Restul consumă.
  • 02One-way sync. Predictibil, ușor de depanat, suficient în majoritatea cazurilor.
  • 03Bidirectional sync. Necesar uneori, dar cere reguli de conflict scrise înainte de prima linie de cod.
  • 04Timestamps și versiuni. Fără ele, „ultima modificare” este o presupunere.
  • 05Reconciliere. O verificare periodică între surse, cu diferențele raportate, nu ascunse.
  • 06Idempotency. Același mesaj livrat de două ori produce același rezultat, o singură dată.

Unde arhitectura nu susține propagarea imediată, spunem asta explicit: consistența este eventuală, iar intervalul este o decizie asumată, nu un accident.

SYSTEM A version 12 10:04:22 SYSTEM B version 11 10:02:07 CONSISTENCY source of truth version compare conflict rules idempotency key REZULTAT A → v12 acceptată ca stare curentă B → actualizat la v12, scrierea veche marcată ca superseded CONSISTENȚĂ EVENTUALĂ · INTERVAL DECLARAT · DIFERENȚE RAPORTATE
FIG. 05 — Rezolvarea unui conflict de versiune

06  Evenimente

Unele sisteme trebuie să reacționeze la evenimente, nu să se interogheze constant.

Când ceva s-a întâmplat, sistemul spune asta o dată. Cine are nevoie ascultă — și poate fi adăugat mai târziu, fără să modifice sursa.

EVENT comandă.confirmată BUS / QUEUE publish · subscribe ordonare · replay NOTIFICARE CLIENTconsumator independent PROCESARE DOCUMENTconsumator independent SINCRONIZARE ERPconsumator independent RETRY ×3 DEAD-LETTER QUEUE
FIG. 06 — Un eveniment, mai mulți consumatori Asincron · retry · replay · DLQ

Modelul event-driven schimbă cuplarea: producătorul nu mai știe cine consumă. În schimb, cere disciplină în altă parte — ordonare, deduplicare, reprocesare și stări de eșec vizibile. Este o decizie de arhitectură, nu o preferință de stil.

Explorează Automation & Orchestration

07  Legacy

Modernizarea nu cere întotdeauna înlocuirea imediată a sistemului vechi.

Un strat de integrare poate expune controlat ce știe sistemul vechi să facă, astfel încât aplicațiile noi să nu depindă de interfața lui.

LEGACY CORE interfețe proprietare reguli de business date istorice schimbare costisitoare ADAPTER FACADE contract stabil traducere izolare SERVICIU NOU APLICAȚIE WEB AI / AUTOMATION MIGRARE GRADUALĂ — CAPABILITĂȚILE SE MUTĂ UNA CÂTE UNA, ÎN SPATELE ACELUIAȘI CONTRACT
FIG. 07 — Legacy izolat prin adapter
  • 01Expunere controlată. Capabilitățile utile ale sistemului vechi devin interfețe moderne, fără rescriere.
  • 02Izolare. Aplicațiile noi depind de contract, nu de particularitățile sistemului din spate.
  • 03Migrare graduală. Funcționalitățile pot fi mutate una câte una, cu posibilitate de revenire.
  • 04Cuplare redusă. Retragerea sistemului vechi devine o schimbare în spatele adapterului, nu în tot ecosistemul.

Nu orice sistem legacy poate fi integrat elegant. Unele nu expun nicio interfață utilizabilă, altele au constrângeri de licențiere sau de performanță care schimbă complet abordarea. Evaluarea se face pe sistemul real, înainte de a promite un traseu.

08  Identitate

Conectarea sistemelor include și identitatea utilizatorului.

Dacă fiecare integrare își aduce propriul mecanism de acces, permisiunile devin imposibil de auditat. Identitatea trebuie să circule odată cu cererea.

IDENTITY identity provider · SSO utilizator sau serviciu roluri atribuite TOKEN / POLICY scopes: read:orders expirare · audiență least privilege ERP — CITIRE DOCUMENTE — CITIRE / SCRIERE FINANCIAR — ACCES REFUZAT SERVICE-TO-SERVICE: FIECARE SERVICIU ARE PROPRIA IDENTITATE, NU O CHEIE COMUNĂ FIECARE ACCES ESTE ÎNREGISTRAT — CINE, CE, CÂND, PRIN CE RUTĂ
FIG. 08 — Identitate → token → acces Scoped access

Authentication stabilește cine face cererea. Authorization stabilește ce are voie să facă. Separarea lor este ceea ce permite ca un singur login să deschidă mai multe sisteme fără să deschidă tot ce conțin.

Nu formulăm garanții de conformitate sau certificări. Descriem mecanismele — SSO, identity providers, roluri, scopes, autentificare între servicii — și le implementăm potrivit cerințelor reale ale organizației.

09  AI

AI-ul devine operațional când poate accesa controlat sistemele potrivite.

Un model fără acces la context rămâne o demonstrație. Un model cu acces necontrolat devine un risc. Între cele două stă un strat de integrare cu permisiuni explicite.

AI SYSTEM agent · copilot · retrieval PERMISSION BOUNDARY ce are voie · pe ce date · cu ce efect APIs TOOLS BAZE DE DATE KNOWLEDGE WORKFLOW ACTIONS CITIRE ≠ SCRIERE · ACȚIUNILE CU EFECT REAL TREC PRIN CONFIRMARE EXPLICITĂ FIECARE APEL ESTE ÎNREGISTRAT ȘI POATE FI RECONSTITUIT
FIG. 09 — AI în interiorul unei granițe de permisiuni
  • 01APIs. Sistemul AI consumă aceleași contracte ca orice alt client — nu un acces privilegiat, paralel.
  • 02Tools. Fiecare acțiune disponibilă este declarată, cu parametri validați și efect cunoscut.
  • 03Date și cunoaștere. Accesul este restrâns la ce are dreptul să vadă utilizatorul care a inițiat cererea.
  • 04Acțiuni de workflow. Efectele reale — o comandă, o aprobare, o scriere — trec prin aceleași reguli ca orice integrare.

Diferența dintre un asistent util și un sistem în care se poate avea încredere este stratul care decide ce poate atinge și ce lasă în urmă ca urmă auditabilă.

Explorează AI Systems & Agents

10  Produs

Un produs digital enterprise este definit și de ceea ce poate conecta.

Integrarea nu este o fază de final. Este o constrângere de arhitectură care schimbă modelul de date, modelul de securitate și felul în care produsul evoluează.

PRODUS DIGITAL arhitectură · date · securitate IDENTITATE DATE API PUBLIC EVENIMENTE SERVICII INTERNE DEPENDENȚE EXTERNE INTEGRĂRI VIITOARE
FIG. 10 — Porturile unui produs Ce expune · ce consumă · ce va conecta

Un produs proiectat fără porturi declarate ajunge, în al doilea an, să primească integrări lipite pe lateral: acces direct la baza de date, exporturi manuale, joburi care citesc fișiere. Costul nu apare la prima integrare, ci la a cincea.

Explorează Digital Product Engineering

11  Reziliență

Integrarea trebuie să funcționeze și atunci când unul dintre sisteme nu funcționează.

Indisponibilitatea nu este o excepție rară. Este o stare normală, care apare periodic în orice ecosistem cu mai mult de două sisteme.

SOURCE INTEGRATION TARGET SYSTEM indisponibil TIMEOUT CIRCUIT BREAKER deschis QUEUE păstrate în ordine RETRY · BACKOFF EXPONENȚIAL TARGET SYSTEM revenit IDEMPOTENCY — REPROCESAREA ACELUIAȘI MESAJ NU DUPLICĂ EFECTUL PARTIAL FAILURE — CE A REUȘIT RĂMÂNE, CE A EȘUAT ESTE IZOLAT ȘI VIZIBIL FALLBACK — UNDE EXISTĂ O ALTERNATIVĂ ACCEPTABILĂ, EA ESTE DECLARATĂ EXPLICIT
FIG. 11 — Eșec izolat, flux recuperat Timeout · retry · circuit breaker · queue

Niciun sistem distribuit nu este perfect. Ce se poate proiecta este comportamentul la eșec: ce se pierde, ce se amână, ce se reia automat și ce ajunge în fața unui om.

12  Observability

Dacă datele se opresc între două sisteme, trebuie să știm unde.

O tranzacție care traversează patru sisteme are nevoie de un singur identificator care o urmărește prin toate. Altfel, depanarea devine arheologie.

CORRELATION ID · 8f2c-41a9-77de API GATEWAY 42 ms · OK MAPPING · VALIDATION 18 ms · OK EVENT QUEUE 6 ms · PUBLICAT ERP CONNECTOR RETRY 2/3 AICI S-A OPRIT — STARE VIZIBILĂ, NU PIERDUTĂ TRACES · LOGS · MESSAGE STATE · LATENȚĂ · SUCCES / EȘEC
FIG. 12 — O tranzacție, patru sisteme, un singur traseu Trace · state · latency

Observability nu înseamnă mai multe log-uri. Înseamnă că starea fiecărui mesaj este interogabilă: unde este, de câte ori a fost încercat, ce a returnat ultimul sistem și cine a fost afectat.

Alertele sunt utile doar dacă separă ce necesită intervenție de ce se rezolvă singur. Un flux care se reia automat nu trebuie să trezească pe nimeni; un flux blocat de trei ore, da.

13  Securitate

Fiecare integrare deschide o cale. Fiecare cale trebuie controlată.

O integrare este, tehnic, o ușă între două sisteme. Numărul de uși crește odată cu ecosistemul — iar fiecare are nevoie de aceleași răspunsuri: cine intră, cu ce drepturi, pentru cât timp și cu ce urmă lăsată în urmă.

01

Authentication & authorization

Fiecare apel are o identitate verificabilă și un set de drepturi, inclusiv între servicii. Nicio integrare nu rulează cu „acces total pentru că e internă”.

02

Scopes și least privilege

Un token pentru citirea comenzilor nu deschide și modulul financiar. Drepturile sunt cât de restrânse permite cazul de utilizare.

03

Secrets management

Chei, certificate și credențiale stau într-un depozit dedicat, cu rotire, nu în fișiere de configurare sau în cod.

04

Criptare în tranzit

Traficul între sisteme este criptat, inclusiv în rețele considerate interne.

05

Validare la intrare

Datele primite din orice sursă sunt tratate ca nesigure până la validare — inclusiv cele care vin de la un sistem partener.

06

Auditabilitate

Cine a accesat ce, când și prin ce rută rămâne înregistrat într-o formă care poate fi interogată ulterior.

Descriem mecanisme tehnice, nu certificări. Cerințele de conformitate se stabilesc împreună cu organizația și cu specialiștii ei, iar arhitectura se proiectează pentru a le susține.

14  Date

Integrarea conectează sisteme. Arhitectura datelor decide ce circulă între ele.

Un flux tehnic corect care transportă date fără definiție comună nu rezolvă nimic — mută doar ambiguitatea mai departe.

  • 01Scheme. Forma datelor este declarată și versionată, la fel ca interfața care le transportă.
  • 02Source of truth. Pentru fiecare entitate se declară sistemul care deține adevărul.
  • 03Transformări. Regulile de conversie sunt cod versionat, nu configurări editate manual în producție.
  • 04Consistență semantică. „Client activ” înseamnă același lucru în CRM, în ERP și în raport.
  • 05Ownership. Fiecare set de date are un proprietar care decide asupra schimbărilor de structură.
  • 06Calitatea datelor. Verificată la intrare, nu descoperită în raportul de la final de lună.

Explorează Data & Intelligence

15  Scalare

Integrarea trebuie să poată crește odată cu sistemul.

Un strat de integrare care funcționează la o mie de mesaje pe zi și cedează la o sută de mii nu este o arhitectură — este o etapă.

  • 01API scaling. Instanțe care se multiplică sub sarcină, în spatele aceluiași contract.
  • 02Queues. Absorb vârfurile în loc să le propage către sistemele din spate.
  • 03Event infrastructure. Dimensionată pentru volum, retenție și reprocesare, nu doar pentru livrare.
  • 04Service boundaries. Ce se scalează independent este separat din start, nu extras sub presiune.
  • 05Deployment. Schimbările intră controlat, cu posibilitate de revenire rapidă.
  • 06Performanță. Latența este măsurată pe traseul complet, nu doar în interiorul unui serviciu.

Explorează Cloud & Software Architecture

VOLUM API INSTANCES QUEUE DEPTH VÂRFUL ESTE ABSORBIT, NU PROPAGAT CONSUMERS SCALARE PROPRIE SCALARE PROPRIE SISTEM DIN SPATE — RITM PROPRIU
FIG. 13 — Creșterea volumului și punctele de absorbție

16  Transformare

Din conexiuni fragile în arhitectură controlată.

Aceleași sisteme, același volum de trafic, aceleași echipe. Ce se schimbă este locul în care traficul trece și felul în care poate fi observat.

ERP CRM DOCUMENTS IDENTITY EXT. API INTEGRATION LAYER CONTRACTS ROUTING TRANSFORMATION EVENTS SECURITY OBSERVABILITY APP DATA AI WORKFLOW STARE: DEPENDENȚE DIRECTE, TRASEU NECUNOSCUT STARE: RUTE CONTROLATE, TRASEU VIZIBIL
FIG. 14 — Aceleași sisteme, altă topologie Rețeaua din Hero, rezolvată
Înainte Conexiuni directe
  • Legături point-to-point între fiecare pereche de sisteme
  • Transformări duplicate, întreținute separat
  • Dependențe pe care nimeni nu le poate enumera complet
  • Autentificare inconsecventă, de la caz la caz
  • Stări de eșec necunoscute până când cineva reclamă
  • Reconciliere manuală, la final de lună
După Arhitectură de integrare
  • Un strat de integrare cu responsabilități declarate
  • Contracte versionate între producători și consumatori
  • Rutare explicită: se știe cine primește ce și de ce
  • Transformări definite o singură dată, în cod versionat
  • Evenimente pentru fluxurile care trebuie să reacționeze
  • Granițe de securitate uniforme pe toate integrările
  • Observability: starea fiecărui mesaj este interogabilă
  • Comportament la eșec proiectat, nu descoperit

17  Semnale

Când Systems Integration devine critică.

Rareori apare ca cerere directă. Apare ca simptom — în timpul pierdut, în datele care nu se potrivesc și în proiectele care se blochează la ultimul pas.

S—01

Organizația operează mai multe aplicații care nu comunică

Fiecare departament are instrumentul lui, iar legătura dintre ele este un om cu un export.

S—02

Aceeași informație este introdusă în mai multe locuri

Dubla introducere nu costă doar timp; produce versiuni diferite ale aceleiași realități.

S—03

Produsele noi trebuie să consume date din sisteme existente

Dezvoltarea se oprește la întrebarea „de unde luăm datele și în ce formă”.

S—04

Procesele trec prin mai multe platforme

Un flux care traversează patru sisteme are patru locuri în care se poate opri fără ca cineva să afle.

S—05

Există sisteme legacy care nu pot fi înlocuite imediat

Nu pot fi scoase, dar nici lăsate să dicteze arhitectura următorilor ani.

S—06

AI sau automation trebuie conectate la aplicații reale

Fără acces controlat la sistemele operaționale, rămân demonstrații.

S—07

Lipsa sincronizării produce diferențe de stare

Două sisteme răspund diferit la aceeași întrebare, iar decizia se ia pe cel deschis primul.

S—08

Erorile dintre sisteme sunt greu de urmărit

Când ceva nu ajunge la destinație, investigația începe cu „cine are acces la log-uri”.

18  Sistem

Integrarea este țesutul dintre capabilități.

Celelalte capabilități produc valoare separat. Integrarea este cea care le face să funcționeze ca un singur sistem.

DATA CLOUD EXPERIENCE PRODUCT AI AUTOMATION SYSTEMS INTEGRATION
FIG. 15 — Poziția capabilității în sistem

20  Convergență

Systems APIs Events Data Identity Transformation Observability Control
UN SINGUR SISTEM OPERAȚIONAL

Connected enterprise system

Sistemele creează valoare reală atunci când pot comunica — controlat, previzibil și într-o formă care rămâne valabilă și după următoarea schimbare.

Contact

Ai sisteme care trebuie să funcționeze ca unul singur?

Putem proiecta stratul de integrare care conectează aplicațiile, datele și procesele fără să adauge încă un nivel de fragilitate.