CRM personale per freelance — Gestione di clienti, progetti, attività e analytics

Era necessario progettare un modello che colleghi clienti, progetti, attività, tracciamento del tempo e tariffe, in modo che i dati siano correttamente aggregati a tutti i livelli senza duplicazioni.

• Progettazione delle entità: Cliente → Progetto → Attività → Registrazione tempo → Calcolo costo.
• Definizione delle relazioni e delle regole di comportamento a cascata.
• Inclusione della flessibilità sulle tariffe (oraria, fissa, per progetto).
• Implementazione di migrazioni e indici in PostgreSQL.

Bisognava tracciare comodamente il tempo sulle attività e calcolare automaticamente il costo del lavoro svolto, senza calcoli manuali né errori.

• Implementazione del tracciamento del tempo collegato a un'attività e a una data.
• Calcolo automatico del costo basato sulla tariffa e sul tempo impiegato.
• Ricalcolo in caso di modifica della tariffa o del tempo.
• Spostamento dei ricalcoli pesanti in task asincroni tramite RabbitMQ.

Gli importi per il lavoro dovevano essere disponibili a più livelli: per attività, per progetto, per cliente. Un cliente può avere più progetti e un progetto molte attività.

• Implementazione dell'aggregazione dei dati a livello di attività, progetto e cliente.
• Ricalcolo degli aggregati in caso di modifiche (tempo, tariffe, stati).
• Caching degli aggregati in Redis per una consegna rapida.
• Garanzia della coerenza dei dati tra i livelli.

L'analytics richiedeva una dashboard visiva con grafici e diagrammi che mostrasse i dati giornalieri: quali attività sono state svolte, con quali progetti e clienti e quanto è stato guadagnato al giorno, alla settimana o al mese.

• Implementazione delle aggregazioni backend per intervalli temporali (giorno/settimana/mese).
• Costruzione del frontend su Vue con grafici e diagrammi.
• Aggiunta di filtri per clienti, progetti e periodi.
• Ottimizzazione delle query e caching degli aggregati pesanti.

I lead dovevano essere gestiti con attributi (freddo/caldo, fonte, ecc.) e bisognava analizzare quanti lead sono stati acquisiti, i loro stati e quanti sono stati convertiti in clienti.

• Implementazione di un CRUD per i lead con attributi flessibili.
• Aggiunta di stati e fonti di acquisizione.
• Implementazione della conversione lead → cliente.
• Costruzione di una scheda dedicata all'analytics dei lead nella dashboard.

Le posizioni dovevano essere gestite con stati e fonti e bisognava analizzare la pertinenza delle posizioni rispetto alle mie competenze e il successo nei colloqui.

• Implementazione di un CRUD per le posizioni con stati e fonti.
• Aggiunta del tracciamento delle fasi: candidatura → colloquio → risultato.
• Costruzione di una scheda dedicata all'analytics delle posizioni nella dashboard.
• Aggiunta di analytics sui canali di ricerca e sul successo nei colloqui.

I ricalcoli degli aggregati, gli aggiornamenti dell'analytics e i calcoli dei costi sono operazioni pesanti che non possono essere eseguite in modo sincrono nel ciclo HTTP senza perdere reattività.

• Progettazione di code di eventi per modifiche di tempo, tariffe e stati.
• Implementazione di worker con Symfony Messenger + RabbitMQ.
• Aggiunta di policy di retry, dead-letter queue e monitoring.
• Garanzia dell'idempotenza degli handler.

La ricerca rapida su clienti, progetti, attività, lead e posizioni, insieme a un'analytics flessibile, richiedeva un motore di ricerca specializzato invece di query SQL pesanti.

• Configurazione degli indici ElasticSearch per le entità chiave.
• Implementazione della sincronizzazione dei dati tramite eventi RabbitMQ.
• Aggiunta di query di ricerca con filtri e aggregazioni.
• Ottimizzazione di mapping e reindicizzazione.

La dashboard e gli aggregati per clienti, progetti e attività sono dati richiesti frequentemente, costosi da ricalcolare ogni volta.

• Introduzione del caching dei dati caldi e degli aggregati in Redis.
• Configurazione dell'invalidazione della cache tramite eventi (modifiche di tempo, tariffe, stati).
• Utilizzo di Redis per sessioni e lock distribuiti.
• Aggiunta di monitoring hit/miss e tempi di risposta.

Per l'analytics e la risoluzione delle controversie, tutte le modifiche su clienti, progetti, attività, lead e posizioni dovevano essere tracciabili.

• Progettazione di uno schema di audit log collegato a entità, utente e azione.
• Implementazione della scrittura asincrona dell'audit tramite RabbitMQ.
• Aggiunta di strumenti di ricerca ed export degli audit log (ElasticSearch).
• Garanzia dell'immutabilità dei record.

Il CRM viene utilizzato quotidianamente e i guasti a code, indicizzazione o cache sono critici per il tracciamento del tempo e i ricavi.

• Configurazione della raccolta di metriche su RabbitMQ, Redis, ElasticSearch e PostgreSQL.
• Implementazione di alert su anomalie (crescita della DLQ, ritardi di indicizzazione, errori dei worker).
• Aggiunta di dashboard per monitorare lo stato del sistema.
• Integrazione del logging delle operazioni critiche.