Ce que nous allons construire

Ce guide construit, de zéro et sans sauter d'étapes, l'app Gestion de Clients — un CRM avec des comptes, des contacts et des opportunités commerciales. C'est la même app qui illustre toute cette documentation : chaque figure que vous verrez dans les autres chapitres vient d'elle.

À la fin du guide, vous avez une application qui fonctionne à une adresse qui lui est propre, avec son écran de connexion, ses utilisateurs et ses données — prête à être utilisée par des gens qui n'ont jamais entendu parler de Keplin.

#L'app en deux phrases

La Gestion de Clients gère des entreprises (contas), les personnes de ces entreprises (contactos) et les affaires en cours avec elles (oportunidades). L'équipe commerciale consulte et modifie tout dans quatre écrans — un tableau de bord, une liste de comptes, une fiche de compte et un tableau kanban d'opportunités — et reçoit chaque matin un résumé automatique de ce qui reste à qualifier.

#Ce qui est fait, étape par étape

Le guide est découpé en six étapes. Chacune est une page de ce chapitre, et chacune se termine par quelque chose qui fonctionne — vous pouvez vous arrêter entre deux étapes et reprendre plus tard.

Étape	Ce que vous construisez	Ce que vous apprenez en chemin
Créer l'app	L'app vide, avec un nom, une icône et une description.	L'espace de travail : l'arborescence latérale, les onglets et la Vue d'ensemble.
Le modèle de données	Une base de données de l'app avec 3 tables et 2 relations.	Créer des tables et des colonnes, importer des tables au modèle, relier des entités.
Les écrans	Les APIs de table et les 4 écrans : tableau de bord avec KPIs, table de comptes, fiche de compte et kanban.	Datastores, widgets, liaisons de données, actions de table, paramètres de route.
Navigation et thème	Le menu de l'app, le logo et les couleurs de la marque.	L'éditeur de navigation par appareil et l'éditeur de thème.
Logique et automatisation	Un script Python qui compte les opportunités à qualifier et prévient l'équipe, planifié pour les matins ouvrés.	L'éditeur de scripts, les exécutions, et les planifications avec rattrapage.
Publier et utiliser	L'app publiée, avec le premier utilisateur et la première connexion.	Versions, publication sur des hôtes, utilisateurs de l'app et rôles.

#Le modèle de données en résumé

Trois tables suffisent pour un CRM fonctionnel — et pour toucher à presque tout ce que le modèle de données de Keplin sait faire :

Table	Ce qu'elle garde	Se relie à
contas	Les entreprises : nom, numéro fiscal, secteur, ville, contacts généraux.	—
contactos	Les personnes de chaque entreprise : nom, fonction, e-mail, portable.	Chaque contact appartient à un compte.
oportunidades	Les affaires : titre, montant, phase (kanban) et date de clôture prévue.	Chaque opportunité appartient à un compte.

Le champ fase des opportunités est ce qui donne vie au tableau kanban : chaque valeur est une colonne du tableau, et faire glisser une carte d'une colonne à l'autre enregistre la nouvelle phase dans l'enregistrement. Les six phases de notre CRM sont prospecao, qualificacao, proposta, negociacao, fechada_ganha et fechada_perdida.

#Ce qu'il vous faut avant de commencer

1. Un compte sur la plateforme avec un profil administrateur ou developer — si vous ne vous êtes pas encore connecté, le chapitre Premiers pas montre comment faire.
2. Rien d'autre. La base de données de l'app est créée à l'intérieur de l'app elle-même, au fil du guide — vous n'avez besoin ni de serveur de base de données, ni de fichiers, ni d'identifiants externes.

Prêt ? Passez à la page suivante — Créer l'app.