Wat we gaan bouwen
De app Klantenbeheer van begin tot eind — het eindresultaat, de onderdelen waaruit zij bestaat en de kaart van de etappes van de handleiding.
Deze handleiding bouwt, vanaf nul en zonder stappen over te slaan, de app Klantenbeheer — een CRM met accounts, contactpersonen en commerciële opportuniteiten. Het is dezelfde app die deze hele documentatie illustreert: elke figuur die u in de andere hoofdstukken ziet, komt uit haar.
Aan het einde van de handleiding hebt u een applicatie die draait op een eigen adres, met haar eigen aanmeldscherm, haar eigen gebruikers en haar eigen gegevens — klaar om gebruikt te worden door mensen die nog nooit van Keplin hebben gehoord.

De app in twee zinnen
Klantenbeheer beheert bedrijven (contas), de personen van die bedrijven (contactos) en de lopende deals met hen (oportunidades). Het commerciële team raadpleegt en bewerkt alles op vier schermen — een dashboard, een lijst met accounts, een accountfiche en een kanbanbord met opportuniteiten — en krijgt elke ochtend een automatische samenvatting van wat er nog gekwalificeerd moet worden.

Wat er klaar komt, etappe voor etappe
De handleiding is opgedeeld in zes etappes. Elke etappe is een pagina van dit hoofdstuk, en elke etappe eindigt met iets dat werkt — u kunt tussen twee etappes stoppen en later verder gaan.
| Etappe | Wat u bouwt | Wat u onderweg leert |
|---|---|---|
| De app aanmaken | De lege app, met naam, icoon en beschrijving. | De werkruimte: de boom in de zijbalk, de tabbladen en het Overzicht. |
| Het gegevensmodel | Een database van de app met 3 tabellen en 2 relaties. | Tabellen en kolommen aanmaken, tabellen naar het model importeren, entiteiten koppelen. |
| De schermen | De tabel-API's en de 4 schermen: dashboard met KPI's, tabel met accounts, accountfiche en kanban. | Datastores, widgets, gegevenskoppelingen, tabelacties, routeparameters. |
| Navigatie en thema | Het menu van de app, het logo en de kleuren van het merk. | De navigatie-editor per apparaat en de thema-editor. |
| Logica en automatisering | Een Python-script dat de nog te kwalificeren opportuniteiten telt en het team waarschuwt, ingepland voor de werkochtenden. | De scripteditor, uitvoeringen, en planningen met inhaalgedrag. |
| Publiceren en gebruiken | De gepubliceerde app, met de eerste gebruiker en de eerste aanmelding. | Versies, publicatie op hosts, gebruikers van de app en rollen. |
Het gegevensmodel in het kort
Drie tabellen volstaan voor een werkend CRM — en om bijna alles aan te raken wat het gegevensmodel van Keplin kan:
| Tabel | Wat zij bewaart | Koppelt aan |
|---|---|---|
contas |
De bedrijven: naam, btw-nummer, sector, stad, algemene contactgegevens. | — |
contactos |
De personen van elk bedrijf: naam, functie, e-mail, telefoon. | Elke contactpersoon hoort bij één account. |
oportunidades |
De deals: titel, waarde, fase (kanban) en verwachte sluitingsdatum. | Elke opportuniteit hoort bij één account. |
Het veld fase van de opportuniteiten is wat het kanbanbord leven geeft: elke
waarde is een kolom van het bord, en een kaart van kolom naar kolom slepen
slaat de nieuwe fase op in het record. De zes fasen van ons CRM zijn
prospecao, qualificacao, proposta, negociacao, fechada_ganha en
fechada_perdida.
Wat u nodig hebt voordat u begint
- Een account op het platform met het profiel beheerder of developer — als u zich nog niet hebt aangemeld, laat het hoofdstuk Eerste stappen zien hoe dat gaat.
- Verder niets. De database van de app wordt binnen de app zelf aangemaakt, in de loop van de handleiding — u hebt geen databaseserver, geen bestanden en geen externe inloggegevens nodig.
Nota
De namen die in de handleiding worden gebruikt — tabellen, velden, schermen, routes — zijn dezelfde als die op de figuren. Wijzigt u ze, pas dan de volgende stappen dienovereenkomstig aan: de handleiding verwijst altijd naar de oorspronkelijke namen.
Dica
Volg de etappes op volgorde. Elke etappe gaat uit van wat de vorige heeft achtergelaten — de schermen hebben de API's nodig, de API's hebben het model nodig, het model heeft de app nodig.
Klaar? Ga verder naar de volgende pagina — De app aanmaken.