Vision App Maker se integrează cu alte sisteme în două direcții. Apelează sisteme externe prin plugin-uri și expune API-uri pe care sistemele externe le pot apela. Tot traficul clienților intră prin API Gateway, care îl direcționează către serviciile backend.
Straturi și componente
Platforma este organizată pe trei straturi, fiecare cu un rol definit. Clienții nu apelează niciodată direct serviciile backend.
| Strat | Componente | Rol |
|---|---|---|
| Client (front-end) | Portaluri interne și externe (React), aplicații de infochioșc (React), aplicația mobilă (React Native), browsere web | Interfața utilizator și logica de UI; apelează API-urile publicate de API Gateway |
| API Gateway | App Maker Gateway (.NET Core) | Punct unic de intrare; publică API-urile publice folosite de clienți și API-urile interne pentru gestionarea conținutului |
| Servicii (back-end) | App Maker Engine (.NET Core) și alte microservicii sau servicii monolitice | Logica de business, accesul la baze de date, procesarea datelor și gestionarea evenimentelor |
App Factory Studio, interfața de configurare, stochează configurația aplicațiilor într-o bază de date de configurare. App Maker Engine citește această configurație și o execută. Fiecare domeniu își păstrează datele de business în propria bază de date de business.
Protocoale de comunicație
Platforma folosește un tip de protocol pentru traficul clienților și altul pentru comunicarea dintre servicii.
| Conexiune | Protocol | Caracteristici |
|---|---|---|
| Clienți către API Gateway | REST peste HTTP, printr-un ingress controller sau reverse proxy | API-uri standard, accesibile din browser; date JSON sau XML; caching HTTP nativ; TLS pentru criptare și autentificare; suport în API Gateway-uri și load balancere |
| API Gateway către App Maker Engine și între microservicii | gRPC peste HTTP/2 | Serializare binară compactă; multiplexare și latență redusă; apeluri sincrone și asincrone; consum de bandă și CPU mai mic decât la apelurile bazate pe JSON |
Stratul gRPC suportă patru tipuri de apeluri:
- request-response: clientul trimite o cerere și primește un răspuns;
- server streaming: o cerere, mai multe răspunsuri;
- client streaming: mai multe cereri, un singur răspuns;
- streaming bidirecțional: clientul și serverul trimit date în mod continuu.
API-urile gRPC se pot modifica fără a rupe compatibilitatea. Se integrează cu OAuth 2.0 și rulează sub Kubernetes sau alte orchestratoare.
Rolul API Gateway
API Gateway este punctul central de intrare pentru toate cererile externe. Verifică fiecare cerere și o transmite microserviciului corect. Funcțiile sale sunt:
- rutarea către serviciul corect, cu load balancing;
- agregarea răspunsurilor: un singur răspuns către client, construit din mai multe servicii;
- autentificare și autorizare: validarea token-ului sau a cookie-ului înainte ca cererea să ajungă în backend;
- single sign-on pentru acces unificat;
- rate limiting și throttling;
- caching de răspunsuri, pentru a reduce încărcarea backend-ului;
- logging pentru cereri și răspunsuri, pentru audit, depanare și metrici;
- transformarea cererilor și a răspunsurilor: date, headere, căi și formate;
- reguli CORS între front-end și backend;
- terminare SSL, IP whitelisting, validarea datelor de intrare și protecție DDoS.
Cum se conectează sistemele externe
Spre exterior: plugin-uri
App Maker accesează sistemele terțe prin plugin-uri, numite și conectori. Configuratorii le definesc în App Factory Studio și le folosesc în reguli de business, interfețe și orice pas al fluxurilor de lucru. Operațiile documentate includ:
- prelucrarea documentelor PDF: marcaj (watermark), cod de bare și cod QR, semnare, etichete;
- lucrul cu fișiere în locații din rețea sau în depozitul de documente, cu seturi de metadate;
- arhivarea fișierelor, cu politică de arhivare configurabilă;
- e-mail: trimiterea mesajelor și citirea lor, cu destinatarii, subiectul, corpul și atașamentele separate;
- apeluri de servicii HTTP și apeluri RPC (Remote Procedure Call);
- interogări, scrieri și execuții de query-uri în baze de date;
- integrarea cu tablete de semnătură (signature pad).
Stratul de integrare este modular. Vision poate dezvolta conectori noi pentru sisteme specifice, pe care configuratorii îi folosesc apoi din interfața vizuală.
Spre interior: API-uri
Sistemele externe apelează App Maker prin API-urile publicate de API Gateway. API-urile de uz general inițiază și încarcă instanțe de proces, citesc și setează parametri, schimbă stări din fluxuri și rulează reguli configurate. Administratorii pot publica și endpoint-uri REST proprii și tool-uri MCP, fiecare rulând o regulă configurată.
Amplasarea în rețea
Componentele cu acces extern pot fi amplasate într-un DMZ. Ele comunică cu rețeaua internă doar prin servicii securizate, în spatele unui reverse proxy. Portalul extern nu permite accesul direct la baza de date.
Toate componentele rulează ca containere compatibile cu OCI și Docker. Pot fi orchestrate cu Kubernetes sau OpenShift.
