Skip Cloud, banco de dados e login

Entenda o backend que todo projeto do Skip recebe por padrão, onde ver e editar os dados, quem pode acessá-los e como funcionam login, automações, segredos e logs.

Gravação do builder do Skip: o botão Skip Cloud abre o painel do backend sobre o preview, a coleção time_entries é aberta e as abas Campos, Regras e Dados mostram os campos com tipo e obrigatoriedade, as regras por operação e os quatro registros de exemplo.

Do botão à tabela: abra o Skip Cloud, escolha uma coleção e percorra Campos, Regras e Dados para conferir o que o agente criou.

O que é e quando entra

Ao gerar o primeiro pedido, o Skip avisa que todos os projetos começam com o Skip Cloud como banco de dados padrão, para que os dados fiquem salvos desde o início; quem prefere Supabase escolhe isso no chat antes do primeiro pedido. O recurso está em beta e pode apresentar instabilidades, segundo o próprio aviso.

Na prática, isso significa que os cadastros feitos no app durante os testes são registros reais no backend do projeto. O agente cria as coleções e os dados de exemplo na primeira execução (no projeto de exemplo desta documentação, cinco coleções: usuários, clientes, projetos, pessoas e lançamentos de horas) e, quando há login, um usuário inicial cujas credenciais aparecem no chat.

O painel do Skip Cloud

Painel Skip Cloud aberto sobre o preview do builder, com o estado Ativo, a URL do backend, a barra lateral de seções à esquerda e a lista de cinco coleções: users, clients, projects, people e time_entries.

O painel: 1 o botão Skip Cloud na barra superior, 2 a barra lateral com as nove seções e 3 a lista de coleções, com a quantidade de registros de cada uma.

Na barra superior do builder, clique no botão com o ícone do Skip Cloud. O painel abre sobre o preview com o estado (Ativo), um botão para copiar a URL do backend e uma barra lateral com nove seções.

No projeto de exemplo, o agente criou cinco coleções a partir de um único pedido: users, clients, projects, people e time_entries. O número ao lado de cada uma é a quantidade de registros.

Coleções

Seção Coleções do Skip Cloud com a lista users, clients, projects, people e time_entries e a quantidade de registros de cada uma.

A lista de coleções do projeto de exemplo, com o contador de registros; clique numa delas para abrir Dados, Campos e Regras.

Cada coleção é uma tabela. A lista mostra o nome e a quantidade de registros, com busca e o botão Nova coleção. Ao abrir uma coleção, três abas:

  • Dados: os registros em tabela, com contador, filtro, Novo (criar um registro à mão) e Importar (trazer dados de fora). Ao lado do nome da coleção ficam os botões de editar e excluir a coleção.
  • Campos: nome, tipo e obrigatoriedade de cada campo (por exemplo, name do tipo texto, obrigatório; created e updated do tipo data automática), o botão Adicionar campo e os campos do sistema, como o id.
  • Regras: quem pode acessar os registros, em cinco operações (List, View, Create, Update, Delete). Cada uma tem uma expressão e um botão Bloquear. A expressão que o agente usa por padrão libera apenas usuários autenticados. Salve só depois de entender o efeito: uma regra errada esconde dados do próprio app ou os expõe a quem não deveria ver.
Migrações

Seção Migrações do Skip Cloud com duas migrações concluídas, 0001_create_collections e 0002_seed_data, cada uma com data e hora, e o botão Rollback no alto.

Duas migrações no projeto de exemplo: a que criou as coleções e a que inseriu os dados. Rollback fica no alto, à direita.

O histórico das mudanças de estrutura do banco, em ordem, com data e hora e um sinal de sucesso em cada uma. No projeto de exemplo, a primeira criou as coleções e a segunda inseriu os dados de exemplo. O botão Rollback desfaz migrações; não use sem conversar com o agente sobre a consequência para as telas que dependem daquela estrutura.

APIs e Gatilhos

Seção APIs e Gatilhos do Skip Cloud vazia, com a mensagem Sem APIs nem gatilhos.

Vazia num projeto novo; os itens aparecem quando o agente cria algo que roda no servidor.

Endpoints e gatilhos do projeto. Um projeto recém-criado mostra "Sem APIs nem gatilhos"; é aqui que aparecem os que o agente criar quando você pedir integrações ou regras que rodam no servidor.

Automação

Seção Automação do Skip Cloud vazia, com a mensagem Nenhuma automação, o botão Criar automação e Nova automação no alto.

Nenhuma automação ainda; Nova automação e Criar automação abrem a mesma gaveta.

Rotinas que rodam sozinhas no backend. Enquanto não há nenhuma, a seção mostra "Nenhuma automação" e dois caminhos: Nova automação e Criar automação, que abre a criação com ajuda; o texto também sugere descrever no chat o que você quer automatizar.

Autenticação (OAuth)

Seção Autenticação do Skip Cloud, aba Login Providers, com Email e senha marcado como padrão e ligado, e Google, Microsoft, Facebook, GitHub, Slack e Custom 1 abaixo, cada um com a seta para expandir.

Email e senha vem ligado; os provedores sociais e corporativos ficam abaixo, cada um com a própria configuração.

A aba Login Providers lista as formas de entrar no app: Email e senha (padrão, ligado) e provedores sociais e corporativos que podem ser configurados: Google, Microsoft, Facebook, GitHub, Slack e um provedor personalizado, os dois últimos via OIDC. Cada provedor tem uma seta para expandir a própria configuração.

E-mails Transacionais

Seção E-mails Transacionais do Skip Cloud com os modelos Confirmação de cadastro, Reset de senha, Mudança de e-mail e OTP, e a aba Configurações de SMTP.

Os quatro modelos que o app envia sozinho e, ao lado, a aba de SMTP para usar o seu servidor.

Os modelos dos e-mails que o app envia sozinho: Confirmação de cadastro, Reset de senha, Mudança de e-mail e OTP (código de uso único), cada um com o texto editável, e a aba Configurações de SMTP para usar o seu próprio servidor de envio.

Segredos

Seção Segredos do Skip Cloud com os campos Chave e Valor no alto e cinco segredos do sistema listados com cadeado e a etiqueta sistema, valores ocultos.

Os segredos do sistema vêm com cadeado e valor oculto; os seus entram pelos campos Chave e Valor.

Chaves e valores que o app usa no servidor sem expor no código: você informa Chave e Valor e adiciona. O Skip já inclui alguns segredos do sistema, marcados com cadeado e a etiqueta sistema, com os valores ocultos. É aqui que entra uma chave de API de um serviço externo, nunca no chat.

Agentes

Seção Agentes do Skip Cloud vazia, com a mensagem Nenhum agente criado e o botão Criar agente.

Nenhum agente num projeto novo; Criar agente abre o formulário Novo agente.

Agentes de IA que vivem dentro do app, com instruções, ferramentas e memória próprias. Um projeto novo mostra "Nenhum agente criado" e o botão Criar agente.

Logs

Seção Logs do Skip Cloud com dois filtros e uma requisição GET /api/cron-settings com resposta 200 em 0,87 ms.

Cada linha é uma chamada do app ao backend: método, caminho, código, duração e hora.

As requisições que o app fez ao backend: método, coleção, caminho, código de resposta, duração em milissegundos e hora, com dois filtros. Use para confirmar se uma tela está buscando os dados certos e se alguma chamada está falhando.

Confira o banco depois de cada versão

  1. Veja se a estrutura pedida existe

    Abra Coleções e confira se as tabelas e os campos que você pediu foram criados. Um campo que falta aqui não vai aparecer em tela nenhuma.

    Coleção time_entries aberta na aba Campos do Skip Cloud: person, client e project do tipo relation, date, hours e description obrigatórios, created e updated como autodate, e o botão Adicionar campo.

    Conferindo a estrutura: 1 as coleções que o pedido gerou, 2 a aba Campos e 3 a lista de campos com tipo e obrigatoriedade. Hora, data e descrição estão lá; se faltasse um, a tela não teria onde gravar.

  2. Teste um cadastro pelo app

    No preview, cadastre um registro e volte à aba Dados da coleção. Se o registro apareceu, a tela está gravando no banco; se não apareceu, o app pode estar mostrando dados fixos no código.

    Coleção time_entries na aba Dados: contador de 4 registros, filtro, botão Novo e a tabela com os lançamentos de exemplo, cada um com pessoa, cliente, projeto, data, horas e descrição.

    Conferindo a gravação: 1 a aba Dados, 2 o contador de registros, que precisa subir depois do cadastro pelo app, e 3 Novo, para criar um registro à mão quando quiser testar a tela com um caso específico.

  3. Leia as regras antes de convidar alguém

    Em Regras, veja quem pode listar, ver, criar, alterar e excluir cada coleção. Para um sistema interno, o mínimo é exigir usuário autenticado em todas as operações.

    Coleção time_entries na aba Regras: as cinco operações List, View, Create, Update e Delete, cada uma com a expressão @request.auth.id != '' e um botão Bloquear, e o botão Salvar no alto.

    Conferindo o acesso: 1 a aba Regras, 2 a expressão de cada operação, aqui exigindo usuário autenticado, e 3 Bloquear, que fecha a operação para todo mundo. Nada muda sem Salvar.

  4. Traga os dados reais só no fim

    Use Importar na coleção certa quando o fluxo já estiver validado com dados fictícios e você tiver autorização para os dados reais.

    Coleção time_entries no Skip Cloud com o nome da coleção no alto, o botão Importar à direita e o contador de 4 registros de exemplo na aba Dados.

    Trazendo dados: 1 o nome da coleção de destino, 2 Importar, que traz registros de fora, e 3 o contador, para conferir quantos entraram. Antes disso, os quatro registros fictícios já bastam para validar as telas.

Na prática, esse é o pedido que cria banco e login de uma vez:

Crie a autenticação e as tabelas necessárias; em seguida integre o
banco com a aplicação, substituindo os dados mocados.

O que conferir

  • Credenciais iniciais: troque a senha do usuário que o agente criou e não a repita em outro lugar (Cuidados com dados e chaves).
  • Supabase em vez do Skip Cloud: a escolha é feita no chat antes do primeiro pedido; a conta do Supabase é conectada em Gerenciar organização > Integrações (Organização, membros e convites).
  • Requisições que falham: cruze Logs com o Bug Scanner para achar a chamada e a mensagem de erro antes de pedir a correção (Inspetor de Build e Bug Scanner).