DepositDirect
Una piattaforma digitale per garanzie sui depositi cauzionali. Gli inquilini ricevono un certificato anziché congelare migliaia di euro su un conto bancario. Verifica dell'identità, pagamenti Stripe, generazione di PDF e oltre 25 lingue, supportati da microservizi basati su eventi.
Torna alle referenze8
Microservizi
2
App frontend
25+
Lingue
8+
Servizi Docker
Panoramica del progetto
DepositDirect si è rivolto a noi con un'idea semplice ma efficace: perché congelare migliaia di euro su un conto bancario quando una garanzia può servire allo stesso scopo? Aveva bisogno di una piattaforma che digitalizzasse l'intero processo, dal calcolo alla verifica dell'identità e del merito creditizio fino al certificato finale.
La complessità si celava dietro l'idea semplice: requisiti normativi in ogni fase, integrazione con Schufa, pagamenti sicuri e certificati PDF conformi alla legge in oltre 25 lingue. Tutto doveva risultare semplice per l'utente finale quanto un ordine online.
I depositi cauzionali tradizionali vincolano migliaia di euro per anni su conti bancari. DepositDirect aveva bisogno di una piattaforma che sostituisse i fondi bancari congelati con certificati di garanzia digitali, gestendo al contempo verifica dell'identità, controlli del credito, pagamenti e certificati PDF conformi alla legge in oltre 25 lingue.
Abbiamo progettato un'architettura di microservizi basata su eventi con 8 servizi Go che comunicano tramite ConnectRPC e NATS. Un frontend Nuxt 3 accompagna il cliente dal calcolo del deposito cauzionale alla verifica dell'identità fino alla generazione del certificato. Stripe gestisce tutti i pagamenti, mentre Supabase si occupa dell'autenticazione.
Una piattaforma pronta per la produzione con 8 microservizi, integrazione Stripe, verifiche del merito creditizio Schufa e generazione automatizzata di certificati PDF. Due applicazioni frontend servono inquilini e amministratori in oltre 25 lingue per i mercati europei.
Piattaforma
La piattaforma è composta da due applicazioni connesse, supportate dallo stesso backend di microservizi Go. Ogni app serve un diverso gruppo di utenti con funzionalità su misura.
L'applicazione orientata agli inquilini, in cui gli utenti calcolano i costi della garanzia per il deposito cauzionale, completano la verifica dell'identità, gestiscono i pagamenti Stripe e ricevono il proprio certificato di garanzia digitale. Supporta oltre 25 lingue con localizzazione completa.
Dashboard di gestione interna per il team DepositDirect, per amministrare contratti, verificare le identità, gestire i casi di assistenza e monitorare i ricavi in tutti i mercati.
Identità del brand
Per DepositDirect abbiamo sviluppato un'identità di brand che comunica fiducia, semplicità e affidabilità finanziaria. Le calde tonalità ambrate segnalano vicinanza senza rinunciare alla serietà richiesta da un prodotto finanziario.
Il logo DepositDirect è un wordmark moderno con forme delle lettere chiare e geometriche. La tipografia distintiva comunica stabilità e fiducia, mentre il colore d'accento ambrato trasmette calore e accessibilità. Funziona su sfondi chiari e scuri.
Il design system si basa su calde tonalità ambrate come colore d'accento principale, completate da bianchi puliti e grigi neutri per gli sfondi. I componenti shadcn garantiscono un'interfaccia coerente e accessibile. La palette cromatica trasmette affidabilità finanziaria, mantenendo al contempo un carattere amichevole e moderno.
Dark Mode
Light Mode
Primary
#316C97
Headline
Aa
PT Serif · Bold · 700
Buttons
Secondary
#D85C2B
Body
Aa
Mona Sans · Regular · 400
Line Weights
1px · Accent
2px · Divider
4px · Section
Icons
Dark
#0A3752
Components
Kautionszertifikat #4821
modernice ha trasformato la nostra visione di depositi cauzionali semplici in una piattaforma robusta e scalabile. L'architettura Event Sourcing ci offre una tracciabilità completa, essenziale nel settore finanziario.
Architettura tecnica
Il backend si basa su 8 microservizi Go con il framework Event Sourcing modernice/goes. Gli eventi di dominio sono l'unica fonte di verità, archiviati in MongoDB, comunicati tramite ConnectRPC (gRPC+HTTP) e distribuiti via NATS Event Bus.
Il backend è composto da 8 microservizi specializzati: API Gateway, gestione contratti, fatturazione, notifiche, generazione PDF, autenticazione, verifiche del merito creditizio Schufa e uno strumento CLI. Ogni servizio possiede il proprio contesto delimitato con event store dedicato.
Gli eventi di dominio costituiscono l'unica fonte di verità: ogni modifica contrattuale, evento di pagamento e risultato di verifica viene persistito come evento immutabile in MongoDB e distribuito tramite NATS a tutti i servizi interessati. Ciò fornisce audit trail completi, indispensabili per la conformità finanziaria.
La comunicazione tra servizi avviene tramite ConnectRPC, che genera endpoint sia gRPC sia HTTP/JSON da un'unica definizione Protocol Buffers. Ciò consente una comunicazione type-safe tra i servizi e, allo stesso tempo, una semplice integrazione con il frontend.
2 app Nuxt 3
Applicazione clienti e dashboard amministrativa con Nuxt 3, Tailwind CSS e shadcn. Pinia per la gestione dello stato, Stripe.js per i flussi di pagamento, oltre 25 lingue tramite Nuxt i18n.
Go + ConnectRPC
Servizio API centrale per autenticazione, routing delle richieste e comunicazione con il frontend tramite endpoint ConnectRPC con supporto gRPC e HTTP/JSON.
8 contesti delimitati
Servizi event-sourced per contratti, fatturazione, notifiche e generazione di PDF. MongoDB come event store, NATS per la distribuzione degli eventi.
Docker Swarm + GCP
Orchestrazione dei container con Docker Swarm. Traefik per routing e TLS, Doppler per i segreti, Google Cloud per l'hosting.
Stack tecnologico
Funzionalità della piattaforma
Certificati digitali di garanzia per il deposito cauzionale che sostituiscono i fondi tradizionalmente congelati in banca. Gli inquilini preservano la liquidità, mentre i proprietari ricevono la stessa sicurezza.
Flusso integrato di verifica dell'identità per garantire la conformità normativa. Caricamento documenti, convalida e approvazione con audit trail completo.
Integrazione Stripe per pagamenti ricorrenti e una tantum, con elaborazione webhook, fatturazione automatizzata e monitoraggio dello stato dei pagamenti.
Creazione automatizzata di certificati di garanzia per depositi cauzionali conformi alla legge come documenti PDF, pronti per proprietari e amministratori immobiliari.
Integrazione Schufa per valutazioni automatizzate del merito creditizio durante il processo di richiesta, consentendo una valutazione immediata del rischio e il processo decisionale.
Workflow e-mail automatizzati per conferme contrattuali, promemoria di pagamento, invio dei certificati e aggiornamenti di stato lungo l'intero ciclo di vita del cliente.
Interfaccia amministrativa centrale per l'amministrazione dei contratti, la verifica delle identità, il supporto clienti e il monitoraggio dei ricavi con accesso basato sui ruoli.
Calcolatore interattivo che consente agli inquilini di visualizzare immediatamente il costo di una garanzia per il deposito cauzionale rispetto a un deposito bancario tradizionale, con prezzi trasparenti.
Servizi forniti
Dettagli tecnici e decisioni chiave alla base del progetto DepositDirect
I prodotti finanziari richiedono una tracciabilità completa. L'Event Sourcing memorizza ogni modifica di stato come evento immutabile, offrendo audit trail integrati, supporto alla conformità normativa e la possibilità di ricostruire lo stato di qualsiasi contratto in ogni momento.
ConnectRPC genera, da un'unica definizione Protocol Buffers, endpoint sia gRPC sia HTTP/JSON. Ciò significa che i servizi comunicano internamente tramite l'efficiente gRPC, mentre il frontend può utilizzare richieste HTTP standard, senza un gateway REST separato.
Il microservizio Schufa dedicato elabora in modo asincrono le richieste di verifica del merito creditizio. Quando un inquilino richiede una garanzia per il deposito cauzionale, il servizio interroga Schufa, elabora la risposta ed emette eventi di dominio che attivano il workflow di approvazione o rifiuto.
Supabase offre un servizio di autenticazione gestito con supporto integrato per e-mail/password, login social e token JWT. Questo ha ridotto significativamente i tempi di sviluppo dei flussi di autenticazione, garantendo al contempo sicurezza di livello enterprise fin da subito.
Un microservizio PDF dedicato genera certificati di garanzia conformi alla legge. I template vengono compilati con i dati contrattuali e preparati sia per la distribuzione digitale sia per la stampa fisica.
Il frontend utilizza Nuxt i18n con routing basato sulle locale e rilevamento automatico della lingua del browser. I file di traduzione vengono mantenuti per oltre 25 lingue e anche la generazione dei certificati supporta output multilingue per i mercati internazionali.
Stai costruendo un prodotto digitale con pagamenti, verifica dell'identità o tante lingue? Allora conosciamo gli ostacoli. Parliamo del tuo progetto prima che ti costino tempo.