Che cosa costruiremo

Questa guida costruisce, da zero e senza saltare passaggi, l'app Gestione Clienti — un CRM con account, contatti e opportunità di business. È la stessa app che illustra tutta questa documentazione: ogni figura che vedrai negli altri capitoli viene da lì.

Alla fine della guida hai un'applicazione che funziona su un indirizzo proprio, con la sua schermata di login, i suoi utenti e i suoi dati — pronta per essere usata da chi non ha mai sentito parlare di Keplin.

#L'app in due frasi

La Gestione Clienti gestisce le aziende (contas), le persone di quelle aziende (contactos) e gli affari in corso con loro (oportunidades). Il team commerciale consulta e modifica tutto in quattro schermate — una dashboard, un elenco di account, una scheda account e una bacheca kanban di opportunità — e riceve ogni mattina un riepilogo automatico di ciò che è da qualificare.

#Che cosa resta fatto, tappa dopo tappa

La guida è divisa in sei tappe. Ognuna è una pagina di questo capitolo, e ognuna finisce con qualcosa che funziona — puoi fermarti fra una tappa e l'altra e riprendere più tardi.

Tappa	Che cosa costruisci	Che cosa impari lungo il cammino
Creare l'app	L'app vuota, con nome, icona e descrizione.	Lo spazio di lavoro: l'albero laterale, le schede e la Panoramica.
Il modello dei dati	Un database dell'app con 3 tabelle e 2 relazioni.	Creare tabelle e colonne, importare tabelle nel modello, collegare entità.
Le schermate	Le API di tabella e le 4 schermate: dashboard con KPI, tabella degli account, scheda account e kanban.	Datastore, widget, collegamenti ai dati, azioni di tabella, parametri di percorso.
Navigazione e tema	Il menu dell'app, il logo e i colori del marchio.	L'editor di navigazione per dispositivo e l'editor del tema.
Logica e automazione	Uno script Python che conta le opportunità da qualificare e avvisa il team, pianificato per le mattine lavorative.	L'editor di script, le esecuzioni, e le pianificazioni con recupero.
Pubblicare e usare	L'app pubblicata, con il primo utente e il primo login.	Versioni, pubblicazione su host, utenti dell'app e ruoli.

#Il modello dei dati in sintesi

Tre tabelle bastano per un CRM funzionante — e per toccare quasi tutto quello che il modello dei dati di Keplin sa fare:

Tabella	Che cosa conserva	Si collega a
contas	Le aziende: nome, partita IVA, settore, città, contatti generali.	—
contactos	Le persone di ogni azienda: nome, ruolo, email, cellulare.	Ogni contatto appartiene a un account.
oportunidades	Gli affari: titolo, valore, fase (kanban) e data prevista di chiusura.	Ogni opportunità appartiene a un account.

Il campo fase delle opportunità è quello che dà vita alla bacheca kanban: ogni valore è una colonna della bacheca, e trascinare un cartoncino da una colonna all'altra salva la nuova fase nel record. Le sei fasi del nostro CRM sono prospecao, qualificacao, proposta, negociacao, fechada_ganha e fechada_perdida.

#Che cosa ti serve prima di cominciare

1. Un account nella piattaforma con profilo di amministratore o developer — se non sei ancora entrato, il capitolo Primi passi mostra come.
2. Nient'altro. Il database dell'app viene creato dentro l'app stessa, nel corso della guida — non ti serve un server di database, né file, né credenziali esterne.

Pronto? Passa alla pagina successiva — Creare l'app.