Vad vi ska bygga
Appen Kundhantering från början till slut — slutresultatet, delarna den består av och kartan över guidens etapper.
Den här guiden bygger, från grunden och utan att hoppa över några steg, appen Kundhantering — ett CRM med konton, kontakter och affärsmöjligheter. Det är samma app som illustrerar hela den här dokumentationen: varje figur du ser i de andra kapitlen kommer från den.
I slutet av guiden har du en applikation som kör på en egen adress, med sin inloggningsskärm, sina användare och sina data — redo att användas av någon som aldrig har hört talas om Keplin.

Appen i två meningar
Kundhantering hanterar företag (contas), personerna på de företagen (contactos) och de pågående affärerna med dem (oportunidades). Säljteamet läser och redigerar allt på fyra skärmar — en dashboard, en lista över konton, en kontodetaljvy och en kanban-tavla med affärsmöjligheter — och får varje morgon en automatisk sammanfattning av det som ännu inte är kvalificerat.

Vad som blir klart, etapp för etapp
Guiden är uppdelad i sex etapper. Var och en är en sida i det här kapitlet, och var och en slutar med något som fungerar — du kan stanna mellan etapperna och ta upp tråden senare.
| Etapp | Vad du bygger | Vad du lär dig på vägen |
|---|---|---|
| Skapa appen | Den tomma appen, med namn, ikon och beskrivning. | Arbetsytan: sidoträdet, flikarna och Översikt. |
| Datamodellen | En databas i appen med 3 tabeller och 2 relationer. | Att skapa tabeller och kolumner, importera tabeller till modellen, koppla ihop entiteter. |
| Skärmarna | Tabell-API:erna och de 4 skärmarna: dashboard med KPI:er, kontotabell, kontodetaljvy och kanban. | Datastores, widgetar, datakopplingar, tabellåtgärder, ruttparametrar. |
| Navigering och tema | Appens meny, logotypen och varumärkets färger. | Navigeringseditorn per enhet och temaeditorn. |
| Logik och automatisering | Ett Python-skript som räknar okvalificerade affärsmöjligheter och meddelar teamet, schemalagt till vardagsmorgnarna. | Skripteditorn, körningarna, och scheman som tar igen missade körningar. |
| Publicera och använda | Den publicerade appen, med den första användaren och den första inloggningen. | Versioner, publicering på hostar, appens användare och roller. |
Datamodellen i korthet
Tre tabeller räcker för ett fungerande CRM — och för att röra vid nästan allt som Keplins datamodell kan göra:
| Tabell | Vad den lagrar | Kopplas till |
|---|---|---|
contas |
Företagen: namn, organisationsnummer, bransch, stad, allmänna kontaktuppgifter. | — |
contactos |
Personerna på varje företag: namn, befattning, e-post, mobil. | Varje kontakt tillhör ett konto. |
oportunidades |
Affärerna: titel, värde, fas (kanban) och förväntat avslutsdatum. | Varje affärsmöjlighet tillhör ett konto. |
Fältet fase på affärsmöjligheterna är det som ger kanban-tavlan liv: varje
värde är en kolumn på tavlan, och att dra ett kort från kolumn till kolumn
sparar den nya fasen på posten. De sex faserna i vårt CRM är prospecao,
qualificacao, proposta, negociacao, fechada_ganha och
fechada_perdida.
Vad du behöver innan du börjar
- Ett konto på plattformen med profilen administratör eller developer — om du inte har loggat in ännu visar kapitlet Första stegen hur.
- Inget mer. Appens databas skapas inuti själva appen under guidens gång — du behöver ingen databasserver, inga filer och inga externa autentiseringsuppgifter.
Nota
Namnen som används i guiden — tabeller, fält, skärmar, rutter — är desamma som i figurerna. Om du ändrar dem, anpassa de följande stegen därefter: guiden hänvisar alltid till originalnamnen.
Dica
Följ etapperna i ordning. Var och en förutsätter det som den föregående lämnade färdigt — skärmarna behöver API:erna, API:erna behöver modellen, modellen behöver appen.
Klar? Gå vidare till nästa sida — Skapa appen.