Banco de dados
Como funciona seu banco de dados
Quando você pede à IA para construir seu aplicativo, ela cria um banco de dados dedicado para armazenar seus dados — sejam postagens de blog, perfis de usuário, catálogos de produtos ou qualquer outra informação que seu aplicativo precise. Este banco de dados é completamente isolado de outros projetos e configurado automaticamente com recursos de segurança e rastreamento.
Seu banco de dados é replicado globalmente, proporcionando armazenamento de dados rápido e confiável com backups automáticos. A IA gerencia todos os detalhes técnicos: criação de tabelas, estabelecimento de relacionamentos entre dados, configuração de regras de segurança e garantia de que tudo funcione perfeitamente em conjunto.
O que você obtém automaticamente:
- Isolamento completo - Seus dados são separados de todos os outros projetos
- Backups automáticos - Os dados são continuamente copiados e protegidos
- Aplicação de segurança - O controle de acesso é aplicado automaticamente a cada consulta
- Trilhas de auditoria - Todas as alterações são rastreadas com carimbos de data/hora e informações do usuário
- Desempenho rápido — O banco de dados distribui seus dados globalmente para baixa latência
- Ferramentas de administração visual - Navegue, pesquise, edite e exporte seus dados por meio da IU
Rastreamento Automático de Dados
Cada tabela que a IA cria automaticamente inclui quatro colunas especiais que fornecem segurança, trilhas de auditoria e integridade de dados sem que você precise pensar nelas:
_row_id - Identificador Único
Cada registro recebe um ID exclusivo que nunca muda. A IA usa isso para vincular dados relacionados (como conectar postagens de blog a seus autores) e para atualizar registros específicos. Você não precisa criar suas próprias colunas de ID — o sistema trata disso automaticamente.
_created_by - Rastreamento de usuários
Cada vez que um usuário cria um registro, o sistema carimba-o automaticamente com seu ID de usuário. Isso permite recursos como “mostrar apenas minhas postagens” ou “somente o autor pode editar isto”. A IA usa isso para regras de segurança para garantir que os usuários só possam acessar ou modificar seus próprios dados quando apropriado.
_created_at - Data de Criação
Registra quando os dados foram criados, armazenados como um carimbo de data/hora. Isso permite que você classifique primeiro os mais recentes, mostre os rótulos "postados há 2 dias" ou filtre as atividades recentes. O carimbo de data/hora é definido automaticamente e nunca muda.
_updated_at - Última modificação
Atualizado automaticamente sempre que um registro é alterado. Isso é útil para mostrar informações da "última edição", implementar estratégias de armazenamento em cache ou rastrear atividades recentes. O sistema lida com isso de forma totalmente automática — você nunca precisa atualizá-lo manualmente.
Excluindo dados
Quando os dados são excluídos, os registros são removidos permanentemente do banco de dados — não há desfazer integrado. Se você está prestes a fazer uma alteração arriscada, como uma exclusão em massa ou uma grande reestruturação, primeiro tire um snapshot da sua conta; restaurar um snapshot é a forma de recuperar dados excluídos.
Como a IA cria e atualiza seu banco de dados
Quando você informa à IA que tipo de dados seu aplicativo precisa, ela cria as tabelas de banco de dados apropriadas nos bastidores. Esse processo utiliza um sistema de migração que rastreia cada alteração na estrutura do seu banco de dados, possibilitando atualizar, reverter ou entender o que mudou ao longo do tempo.
O que acontece automaticamente:
Quando você pede algo como “crie um blog onde os usuários possam escrever postagens”, a IA:
- Projeta a estrutura da tabela - Determina quais campos são necessários (título, conteúdo, data de publicação, etc.)
- Adiciona as colunas de rastreamento - Inclui
_row_id,_created_by,_created_ate_updated_at - Cria índices de desempenho — Adiciona índices de banco de dados para que as consultas sejam executadas rapidamente
- Configura relacionamentos - Vincula tabelas (como conectar postagens a autores)
- Aplica as alterações - Cria a tabela em seu banco de dados
- Configura a segurança - Configura regras de controle de acesso (abordadas abaixo)
- Registra a alteração - Salva um registro do que foi criado para fins de auditoria e reversão
Relacionamentos de dados:
A IA gerencia automaticamente os relacionamentos entre seus dados. Por exemplo:
- Um para muitos: cada usuário pode ter muitas postagens no blog
- Muitos para muitos: cada postagem pode ter muitas tags, e cada tag pode ser aplicada a muitas postagens
- Campos obrigatórios: Endereços de e-mail que devem existir
- Valores exclusivos: nomes de usuário que não podem ser duplicados
- Regras de validação: Preços que não podem ser negativos
Tudo isso é configurado automaticamente quando você descreve o que seu aplicativo precisa fazer.
Segurança Automática e Controle de Acesso
Seus dados são protegidos automaticamente pela segurança em nível de linha (RLS) — um sistema que controla exatamente quem pode ver e modificar cada dado. Quando você descreve seu aplicativo para a IA, ela define regras de segurança apropriadas com base no que você está construindo.
Por exemplo, se você disser “os usuários devem ver apenas suas próprias notas”, a IA configura regras garantindo que cada usuário possa acessar apenas os registros que criou. Se você disser “tornar as postagens do blog públicas, mas editáveis apenas pelo autor”, isso será configurado automaticamente. A segurança é aplicada no nível do banco de dados, o que significa que não há como contorná-la — mesmo que alguém tente acessar a API diretamente.
Tipos de regras de segurança
A IA pode configurar nove tipos diferentes de regras de segurança, que podem ser combinadas para criar um controle de acesso sofisticado:
1. Acesso Público
Qualquer pessoa pode visualizar esses dados, mesmo sem fazer login. Perfeito para conteúdo de marketing, catálogos de produtos, postagens públicas em blogs ou seções de perguntas frequentes.
2. Usuários autenticados
Somente usuários logados podem acessar os dados. Ideal para conteúdo gerado pelo usuário, recursos da comunidade, painéis internos ou qualquer conteúdo destinado apenas a membros.
3. Somente proprietário
Somente a pessoa que criou um registro pode vê-lo ou modificá-lo. Perfeito para notas pessoais, documentos privados, preferências do usuário, carrinhos de compras ou quaisquer dados que devam ser totalmente privados de cada usuário.
4. Mesma organização
Os usuários podem acessar dados de sua própria organização, mas não de outras organizações. Ótimo para documentos de equipe, anúncios de toda a empresa, dados de projetos compartilhados ou recursos de departamento. Cada organização vê apenas seus próprios dados.
5. Organização Primária
Acesso restrito aos usuários da sua equipe interna (a organização principal), não aos clientes do seu aplicativo. Isso é útil para configuração do sistema, painéis de administração, gerenciamento de cobrança, sinalizadores de recursos, análises internas ou registros de auditoria que somente você deve ver.
Contexto da plataforma: quando os clientes se inscrevem no seu aplicativo, eles obtêm suas próprias organizações. Esta regra garante que eles não possam acessar seus dados administrativos internos.
6. O usuário tem atributo
Acesso baseado em atributos específicos do usuário, como estar no grupo “admin”. Usado para tabelas somente de administrador, conteúdo baseado em função, sinalizadores de recursos ou acesso beta.
7. Registro tem valor
Acesso baseado em um valor de campo específico no próprio registro. Por exemplo, mostre apenas registros onde status = "published". Ótimo para conteúdo publicado versus rascunho, dados ativos versus arquivados ou workflows de aprovação.
8. Correspondência de campo
Combine os atributos do usuário com os campos de registro. Por exemplo, os usuários só podem ver registros onde o department do registro corresponde ao seu department. Perfeito para acesso baseado em departamento, filtragem baseada em localização, gerenciamento de território ou segmentação personalizada.
9. Bloquear todo o acesso
Impede completamente uma operação. Útil para evitar exclusões em tabelas de auditoria, criar dados de referência somente leitura, implementar logs somente anexados ou garantir que determinados registros nunca possam ser modificados.
Como as regras são aplicadas
As regras de segurança podem ser definidas separadamente para cada tipo de operação de banco de dados:
- Leitura de dados (SELECT) - Quem pode visualizar registros
- Criando dados (INSERT) - Quem pode adicionar novos registros
- Atualizando dados (UPDATE) - Quem pode modificar registros existentes
- Excluindo dados (DELETE) - Quem pode remover registros
A IA pode combinar múltiplas regras com lógica OR. Por exemplo, "os registros podem ser visualizados pelo proprietário OU por qualquer pessoa na mesma organização" oferece acesso flexível, mantendo a segurança.
Exemplos do mundo real
Aplicativo de tarefas pessoais: A IA configura regras “Somente Proprietário” para que cada usuário veja apenas suas próprias tarefas. Ao criar uma tarefa, somente você poderá vê-la, editá-la ou excluí-la.
Blog da empresa: As postagens publicadas são “Públicas” para leitura, mas apenas usuários “Autenticados” (sua equipe) podem criar novas postagens, e apenas o “Proprietário” (autor da postagem) pode editá-las ou excluí-las.
SaaS multilocatário: A IA usa regras de “Mesma Organização” para que os usuários da Empresa A não possam ver os dados da Empresa B. Sua equipe interna usa regras da "Organização Primária" para acessar recursos administrativos que os clientes não deveriam ver.
Recursos do Departamento: As regras de "correspondência de campo" garantem que os representantes de vendas vejam apenas materiais de vendas, a engenharia veja documentos de engenharia, etc., com base nos atributos do departamento automaticamente.
Acessando seus dados
Você pode trabalhar com seu banco de dados de três maneiras:
1. Interface administrativa
A interface visual de administração permite navegar, pesquisar, editar e exportar seus dados por meio de uma interface semelhante a uma planilha. Você pode filtrar dados, classificar colunas, editar registros in-line e exportar para CSV ou JSON. A interface gera automaticamente formulários com base na estrutura da sua tabela, valida os dados de acordo com as suas regras e trata dos relacionamentos entre as tabelas.
2. Do seu aplicativo
Seu aplicativo frontend pode consultar o banco de dados diretamente por meio de uma API REST que a IA configura automaticamente. A API usa sintaxe compatível com PostgREST, que é um padrão amplamente adotado para APIs de banco de dados. Todas as regras de segurança que você configurou são aplicadas automaticamente — os usuários só podem acessar os dados que deveriam ver.
3. Através de Edge Functions
Edge Functions (código do lado do servidor) pode acessar seu banco de dados com potência total, respeitando as regras de segurança. A IA cria essas funções quando você precisa implementar lógica de negócios complexa, integrar-se a serviços externos ou realizar operações que não deveriam ser executadas no navegador.
Melhores práticas
✅ Deixe a IA cuidar da estrutura - Descreva o que você precisa e deixe a IA criar as tabelas. Não se preocupe com detalhes técnicos do banco de dados.
✅ Use nomes descritivos - Ao falar com a IA, use nomes claros para seus dados (como “postagem no blog” em vez de “item” ou “coisa”).
✅ Aproveite os recursos automáticos - A IA configura relacionamentos, validação e segurança automaticamente. Confie nesses sistemas em vez de tentar construir o seu próprio.
❌ Não substitua os padrões - As colunas de ID automáticas e os carimbos de data/hora existem por bons motivos. Deixe-os trabalhar.
❌ Não ignore a segurança - Sempre descreva quem deve poder ver e modificar seus dados ao criar novos recursos.
Documentação relacionada: