În execuție, Vision App Maker este un set de componente decuplate, organizate pe trei straturi: clienții front-end, API Gateway și serviciile back-end. Configurarea realizată în App Factory Studio este stocată într-o bază de date de configurare și executată de App Maker Engine.
Straturile, pe scurt
| Strat | Componente | Tehnologie |
|---|---|---|
| Interfață (UI) | Portaluri interne și externe, aplicații de infochioșc, aplicația mobilă | React; React Native pentru aplicația mobilă |
| API Gateway | App Maker Gateway, în spatele unui ingress sau reverse proxy | .NET Core |
| Servicii | App Maker Engine și alte microservicii sau componente distribuite | .NET Core |
| Configurare | App Factory Studio și back-end-ul App Factory | Angular, .NET Core |
| Cache | Cache distribuit, partajat de replicile platformei | Redis |
| Date | Baza de date de configurare Factory și bazele de date de business | Microsoft SQL Server |
| Stație de lucru | Vision Desktop Experience | Aplicație desktop WPF |
Clienții front-end
Clienții front-end se ocupă exclusiv de interfața utilizator și de logica UI. Aceștia apelează API-urile expuse de API Gateway. Mai multe instanțe de portal și de infochioșc pot folosi același gateway, astfel încât logica de business este reutilizată.
- Portal intern: toate funcționalitățile configurate, plus funcționalitățile standard de administrare, securitate și management de conținut. Pentru aceste funcționalități standard este necesar cel puțin un portal intern.
- Portal extern: funcționalitățile configurate pentru cetățeni, clienți sau parteneri. Nu are acces direct la baza de date.
- Infochioșc: aplicație React cu acces la perifericele locale, precum camere și porturi locale.
- Aplicația mobilă: prezintă orice funcționalitate configurată în platformă.
Portalurile sunt dezvoltate în React. Acestea oferă:
- componente modulare, cu separarea interfeței, logicii și datelor, și un design system;
- gestionarea token-urilor sau cookie-urilor, verificarea rolurilor și permisiunilor în interfață, autentificare SSO și OAuth2 prin API Gateway sau printr-un furnizor extern de identitate;
- rutare dinamică fără reîncărcarea completă a paginii, route guards pe roluri, lazy loading și code splitting pe rută;
- bibliotecile Material UI și Bootstrap 5, afișare responsivă mobile-first și teme dinamice (dark, light, personalizate);
- schimbarea limbii în timpul lucrului și meniuri afișate în funcție de permisiuni;
- hărți interactive cu markere, forme, trasee și tile-uri de la furnizori de hărți precum OpenStreetMap.
Toate componentele rulează în Microsoft Edge, Mozilla Firefox și Google Chrome. Semnarea cu certificat pe token și scanerele conectate local necesită Vision Desktop Experience.
API Gateway
App Maker Gateway este punctul unic de intrare pentru cererile clienților. Direcționează fiecare cerere către serviciul potrivit și oferă o interfață unificată pentru toate serviciile.
- rutare cu load balancing și agregarea răspunsurilor de la mai multe servicii;
- autentificare și autorizare prin token-uri sau cookie-uri, cu single sign-on;
- rate limiting, throttling, caching și transformarea cererilor sau răspunsurilor;
- gestionarea CORS, terminare SSL, IP whitelisting, validarea datelor de intrare și protecție DDoS;
- logging pentru cereri și răspunsuri, pentru audit, depanare și metrici.
Serviciile back-end
Stratul de servicii conține microservicii și servicii monolitice care implementează logica de business. Acestea accesează bazele de date, procesează date, gestionează evenimente și expun propriile API-uri. Suportă persistența datelor și stocarea coordonatelor geospațiale.
App Maker Engine execută aplicațiile configurate. Citește configurația din baza de date de configurare Factory și citește și scrie datele de business. Servicii suplimentare acoperă autentificarea, procesarea fișierelor și integrările externe, în funcție de proiect. Diagramele de arhitectură includ și un serviciu IoT appliance dezvoltat în .NET Core.
Un cache distribuit bazat pe Redis este partajat de replicile platformei.
Comunicarea între componente
| Traseu | Protocol | Caracteristici |
|---|---|---|
| De la clienți la API Gateway | REST peste HTTP | JSON sau XML, caching nativ, suport în gateway-uri și load balancere, TLS |
| De la API Gateway la servicii și între servicii | gRPC peste HTTP/2 | Serializare binară compactă, multiplexare, apeluri sincrone și asincrone, apeluri simple și de tip streaming, compatibil cu Kubernetes |
Componenta de configurare și bazele de date
App Factory Studio este componenta integrată de administrare și configurare. Configuratorii o folosesc din browser pentru a defini modele de date, reguli, interfețe și fluxuri de lucru, fără să scrie cod. Rezultatul se publică în oricare dintre componentele front-end.
Platforma folosește două tipuri de baze de date:
- baza de date de configurare Factory, care păstrează configurația tuturor domeniilor de aplicații;
- bazele de date de business, care stochează datele specifice aplicațiilor din fiecare domeniu.
Vision Desktop Experience
Vision Desktop Experience este o aplicație WPF care completează portalurile web pe stația de lucru. Oferă portalului acces la resursele locale.
- certificate digitale stocate pe token, pentru semnarea documentelor;
- tablete de semnătură, pentru semnătura olografă;
- scanere și multifuncționale conectate local, prin TWAIN și PDFsharp;
- sertare și alte periferice de infochioșc.
Aplicația păstrează local profiluri de semnare. Fiecare profil asociază adresa unui portal, un cont din portal și un certificat instalat pe stație.
