O que vamos construir
A app Gestão de Clientes de ponta a ponta — o resultado final, as peças que a compõem e o mapa das etapas do guia.
Este guia constrói, do zero e sem saltar passos, a app Gestão de Clientes — um CRM com contas, contactos e oportunidades de negócio. É a mesma app que ilustra toda esta documentação: cada figura que vires nos outros capítulos vem dela.
No fim do guia tens uma aplicação a funcionar num endereço próprio, com o seu ecrã de login, os seus utilizadores e os seus dados — pronta a ser usada por quem nunca ouviu falar do Keplin.
A app em duas frases
A Gestão de Clientes gere empresas (contas), as pessoas dessas empresas (contactos) e os negócios em curso com elas (oportunidades). A equipa comercial consulta e edita tudo em quatro ecrãs — um dashboard, uma lista de contas, uma ficha de conta e um quadro kanban de oportunidades — e recebe todas as manhãs um resumo automático do que está por qualificar.
O que fica feito, etapa a etapa
O guia está partido em seis etapas. Cada uma é uma página deste capítulo, e cada uma termina com algo a funcionar — podes parar entre etapas e retomar mais tarde.
| Etapa | O que constróis | O que aprendes pelo caminho |
|---|---|---|
| Criar a app | A app vazia, com nome, ícone e descrição. | O espaço de trabalho: a árvore lateral, os separadores e a Visão geral. |
| O modelo de dados | Uma base de dados da app com 3 tabelas e 2 relações. | Criar tabelas e colunas, importar tabelas para o modelo, ligar entidades. |
| Os ecrãs | As APIs de tabela e os 4 ecrãs: dashboard com KPIs, tabela de contas, ficha de conta e kanban. | Datastores, widgets, ligações a dados, acções de tabela, parâmetros de rota. |
| Navegação e tema | O menu da app, o logo e as cores da marca. | O editor de navegação por dispositivo e o editor de tema. |
| Lógica e automação | Um script Python que conta oportunidades por qualificar e avisa a equipa, agendado para as manhãs úteis. | O editor de scripts, execuções, e agendamentos com recuperação. |
| Publicar e usar | A app publicada, com o primeiro utilizador e o primeiro login. | Versões, publicação em hosts, utilizadores da app e roles. |
O modelo de dados em resumo
Três tabelas chegam para um CRM funcional — e para tocar em quase tudo o que o modelo de dados do Keplin sabe fazer:
| Tabela | O que guarda | Liga-se a |
|---|---|---|
contas |
As empresas: nome, NIF, sector, cidade, contactos gerais. | — |
contactos |
As pessoas de cada empresa: nome, cargo, email, telemóvel. | Cada contacto pertence a uma conta. |
oportunidades |
Os negócios: título, valor, fase (kanban) e data prevista de fecho. | Cada oportunidade pertence a uma conta. |
O campo fase das oportunidades é o que dá vida ao quadro kanban: cada
valor é uma coluna do quadro, e arrastar um cartão de coluna para coluna
grava a nova fase no registo. As seis fases do nosso CRM são
prospecao, qualificacao, proposta, negociacao, fechada_ganha e
fechada_perdida.
O que precisas antes de começar
- Uma conta na plataforma com perfil de administrador ou developer — se ainda não entraste, o capítulo Primeiros passos mostra como.
- Nada mais. A base de dados da app é criada dentro da própria app, no decorrer do guia — não precisas de servidor de base de dados, de ficheiros, nem de credenciais externas.
Nota
Os nomes usados no guia — tabelas, campos, ecrãs, rotas — são os mesmos das figuras. Se os alterares, adapta os passos seguintes em conformidade: o guia refere-se sempre aos nomes originais.
Dica
Segue as etapas pela ordem. Cada uma assume o que a anterior deixou feito — os ecrãs precisam das APIs, as APIs precisam do modelo, o modelo precisa da app.
Pronto? Segue para a página seguinte — Criar a app.