L'obiettivo
SHIFT>_CRM è un sistema CRM per aziende di qualsiasi settore con un'installazione separata per ogni cliente.
I CRM universali vanno bene un po' per tutti, ma per nessuno fino in fondo. Sono pensati per un'azienda "media", quindi ogni attività deve piegare i propri processi a una logica altrui, sopportare funzioni inutili e rinunciare a quelle che le servono, mentre i dati di tutti i clienti sono conservati da un unico fornitore. L'obiettivo del progetto era creare un CRM che funzioni esattamente come funziona l'attività di una specifica azienda. Ogni azienda riceve una propria copia indipendente su un server separato, con il proprio database e il proprio indirizzo, configurata attorno ai suoi processi: collaboratori, permessi di accesso, fasi del lavoro con i clienti, anagrafiche, campi personalizzati e perfino i termini a cui il team è abituato. Così l'azienda ottiene un sistema con cui nessun grande CRM universale può competere, perché nessuno è stato creato per lei.
Nel CRM si svolge tutto il lavoro con i clienti: una scheda cliente con più referenti, commenti e file, il cambio di stato direttamente nella scheda, pagamenti in diverse valute, una pipeline di vendita, promemoria e notifiche. Le statistiche mostrano il quadro sia per i clienti sia per ogni collaboratore: trattative, conversione, pagamenti, chiamate e attività scadute. Le richieste dal sito web e da Facebook Lead Ads diventano automaticamente nuovi clienti e le richieste ripetute vengono riconosciute. Il telefono integrato permette di fare e ricevere chiamate direttamente nel browser, e ogni conversazione finisce nella cronologia del cliente. Per comunicare all'interno del team c'è un messenger con chat private, messaggi vocali, risposte ai messaggi e consegna istantanea.
Una parte a sé del sistema è l'intelligenza artificiale. L'assistente IA risponde alle domande dei commerciali sul database, per esempio chi conviene chiamare oggi, vedendo solo i dati a cui il collaboratore ha accesso e senza modificare nulla da solo. L'azienda può usare un proprio modello Qwen sul suo server oppure collegare ChatGPT, Claude, Gemini e DeepSeek tramite chiave API; l'amministratore sceglie il servizio principale e decide chi può usare quale. La descrizione dell'azienda per l'IA si può caricare da un file Word o PDF, e in modalità apprendimento l'IA raccoglie da sola note generali sull'azienda senza conservare i dati personali dei clienti. Ogni notte l'IA analizza i cambiamenti sui clienti e per le sei del mattino prepara un piano della giornata per ogni collaboratore. I commenti si possono dettare a voce e vengono trasformati automaticamente in testo.
Particolare attenzione è stata dedicata alla sicurezza. Le password sono salvate come hash Argon2id, le sessioni in cookie protetti, ed è disponibile l'autenticazione a due fattori tramite app di autenticazione. I permessi vengono verificati dal server, i dati sono protetti anche dalla sicurezza a livello di riga nel database e ogni azione viene registrata in un log di audit non modificabile. Sono previsti il logout automatico per inattività e il logout giornaliero di tutti i collaboratori a un orario stabilito, le chiavi dei servizi esterni sono cifrate, i backup vengono creati automaticamente e anch'essi cifrati, e il sito funziona solo in HTTPS. L'interfaccia è tradotta in 11 lingue, con diversi temi di colore e una versione demo con un'azienda fittizia per le presentazioni ai clienti.
Il progetto è scritto interamente in TypeScript. L'interfaccia è realizzata con React 19 e React Router su un design system proprietario, il server con Node.js e Fastify su database PostgreSQL, con query tramite Kysely e validazione dei dati con Zod. Gli aggiornamenti in tempo reale arrivano tramite Server-Sent Events e il meccanismo di notifiche di PostgreSQL, mentre la telefonia funziona con WebRTC e JsSIP ed è stata testata con Asterisk. Per l'IA vengono utilizzati l'API di OpenAI, l'SDK di Anthropic e Ollama. Il sistema viene installato su un VPS Ubuntu con Docker Compose, e Caddy emette automaticamente i certificati HTTPS. Gli scenari principali sono coperti da test automatici.
Il risultato è un prodotto a cui il cliente non deve adattarsi: un CRM con telefonia, messenger e assistente IA, che funziona sul server del cliente e, fin dal primo giorno, è organizzato come la sua attività.
