Criar a app

Tudo no Keplin vive dentro de uma app: o modelo de dados, os ecrãs, as APIs, os scripts, o tema, os utilizadores. O primeiro passo do guia é, portanto, criar a app Gestão de Clientes — demora menos de um minuto — e perceber o espaço de trabalho que se abre a seguir, porque é lá que vais passar o resto do guia.

#Criar a app Gestão de Clientes

1. Na barra lateral da plataforma, clica em Nova app.
2. Abre-se o diálogo Nova app, com dois separadores: Criar de raiz e Importar pacote. Fica no Criar de raiz — importar serve para instalar uma app que alguém exportou, e não é o nosso caso.
3. No campo Nome, escreve Gestão de Clientes.
4. Repara na nota junto ao nome: o slug é derivado automaticamente do nome. O slug é o identificador da app nos endereços — para este nome fica gestao-clientes, e é por ele que a app vai responder em /app/gestao-clientes mais à frente no guia.
5. Em Descrição, escreve algo como CRM de contas, contactos e oportunidades. É opcional, mas aparece na lista de apps e na barra lateral — daqui a seis meses agradeces.
6. Em Ícone, escolhe um ícone a teu gosto — é o símbolo da app na lista e nos menus da plataforma.
7. Clica em Criar app.

A app é criada e abre de imediato no seu espaço de trabalho, com o separador Visão geral à frente.

#O espaço de trabalho de uma app

O espaço de trabalho é onde uma app se constrói: uma árvore à esquerda com tudo o que a app tem, e uma área de separadores à direita onde cada coisa se abre e edita. Vale a pena olhar para as peças antes de avançar:

Zona	O que faz
Barra lateral da app	A árvore de conteúdo da app. Muda conforme o painel escolhido em baixo.
Painéis UI, Código, Dados, Radar	Os quatro painéis da árvore: ecrãs e navegação (UI); APIs, scripts e agendamentos (Código); fontes de dados e modelo (Dados); actividade e erros (Radar).
Definições da app	O ícone de engrenagem junto aos painéis — abre as definições (geral, tema, utilizadores da app, permissões…).
Área de separadores	Cada tabela, ecrã, API ou script abre aqui num separador próprio. Podes ter vários abertos lado a lado.
Pesquisa	O campo Procurar em tudo… no topo da árvore encontra qualquer elemento da app pelo nome.

O separador Visão geral resume o estado da app: o Endpoint GraphQL público dela, e as contagens de APIs, Datasources e API Keys. Numa app acabada de criar está tudo a zeros — é o nosso ponto de partida.

Dois comportamentos do espaço de trabalho que convém saber desde já:

• Nada se perde por fechar separadores. Se um separador tiver alterações por gravar, a plataforma avisa (Alterações por gravar) e pergunta antes de fechar.
• Tudo o que gravares fica no histórico. Cada gravação é registada e reversível — o capítulo Versionamento explica como voltar atrás.

#Onde encontrar a app depois

A app fica na lista de apps da barra lateral da plataforma. Clica nela em qualquer altura para reabrir o espaço de trabalho, exactamente como o deixaste — os separadores abertos são recordados por app.

A app existe, mas está vazia. Próxima etapa: dar-lhe o modelo de dados.