> For the complete documentation index, see [llms.txt](https://trust.memori.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trust.memori.ai/plans-billing/architettura.md). # Architettura La piattaforma AIsuru è progettata secondo un'architettura modulare che separa chiaramente le responsabilità tra i diversi sottosistemi. Questa scelta architetturale garantisce indipendenza tra i componenti, facilità di aggiornamento, isolamento dei guasti e scalabilità orizzontale e verticale in base al carico. *** #### I componenti principali La piattaforma è composta da cinque blocchi funzionali principali: **1. Frontend (Dashboard + Widget)** Il frontend include la dashboard di gestione per autori e amministratori, il widget conversazionale embeddable (disponibile come componente web e componente React), l'app mobile (iOS e Android) e la VR App (Meta Quest). **2. Backend** Il backend gestisce l'autenticazione e l'autorizzazione degli utenti, la gestione degli asset multimediali, i job asincroni per importazioni e reportistica, e fornisce all'Engine i dettagli di tenant, utenti e abbonamenti. **3. Engine** Il cuore tecnologico della piattaforma. Gestisce il dialogo conversazionale, il sistema NLP proprietario (MemoriNLP) e l'integrazione con i modelli LLM esterni. Ogni sessione conversazionale è indipendente e mantenuta in memoria per la durata della sessione. **4. MCP Gateway** Componente proxy che gestisce le connessioni agli strumenti esterni tramite il protocollo MCP (Model Context Protocol). Supporta connessioni a database relazionali e documentali, Salesforce, Zapier, n8n, Make e server MCP custom. Ogni esecuzione è validata per sicurezza e tracciata per audit. Le credenziali di connessione non sono mai esposte nelle API pubbliche. **5. Billing** Sistema di gestione crediti, consumi, pagamenti e fatturazione per il modello SaaS. L'integrazione con Stripe garantisce che i dati completi delle carte di pagamento non vengano mai memorizzati da Memori. *** #### Infrastruttura cloud e data center Tutti i datacenter sono localizzati nell'Unione Europea. Nessun dato viene trasferito al di fuori dell'UE nell'ambito dell'infrastruttura Memori. *** #### Sicurezza delle comunicazioni * Tutte le comunicazioni client-server avvengono esclusivamente tramite **HTTPS/TLS** * Le comunicazioni interne tra i componenti principali sono crittografate * I file caricati su AWS S3 sono soggetti alla protezione dati AWS, inclusa **cifratura a riposo** * Ogni file caricato è automaticamente scansionato da **AWS GuardDuty** per il rilevamento di malware; i file infetti sono bloccati e non accessibili *** #### Controllo degli accessi * Autenticazione utenti tramite **magic link via email** * Token di sessione con **scadenza automatica** per inattività * **JWT** per login da sistemi esterni * Password degli account utente cifrate con **algoritmo crittografico sicuro** * Accesso agli Agenti configurabile a tre livelli: **Pubblico**, **Privato** (con password) o **Solo utenti autenticati** * Ruoli distinti: **Owner, Autore, Receiver, Admin** — ciascuno con perimetro di accesso definito * Accesso superadmin Memori limitato ai soli dati operativi di piattaforma; **nessun accesso alle conversazioni o ai contenuti degli Agenti** *** #### Deployment e aggiornamenti Gli aggiornamenti della piattaforma vengono rilasciati tramite **pipeline CI/CD automatizzate**. Per la maggior parte dei componenti viene adottata una strategia di **blue-green deployment**, che garantisce continuità del servizio durante i rilasci. L'ambiente di staging è mantenuto conforme a quello di produzione per test completi prima del deploy. {% hint style="warning" %} Per i modelli PaaS, Private Cloud e On-Premise sono disponibili architetture con maggiore isolamento. Contattare il [team tecnico](mailto:dev@memori.ai) per i dettagli specifici del proprio scenario. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://trust.memori.ai/plans-billing/architettura.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.