​
Visão Geral

Cloud Firestore é um banco de dados de nuvem NoSQL flexível e escalável que permite armazenar e sincronizar dados entre os usuários do seu aplicativo web em tempo real. Com a integração do Firebase do Golex, seu aplicativo se conectará automaticamente ao Firestore assim que estiver ativado, permitindo que você crie recursos poderosos orientados a dados com o mínimo de esforço.

Antes de Começar

Certifique-se de ter concluído o guia de Configuração do Firebase antes de ativar o Firestore.

​
Passo 1: Ative o Cloud Firestore no Console do Firebase

Para começar a usar o Firestore no seu aplicativo Golex, você precisa primeiro ativá-lo no Console do Firebase:

  1. Vá para o Console do Firebase
  2. Selecione seu projeto
  3. Na barra lateral esquerda, clique em Firestore Database
  4. Clique no botão Criar banco de dados

​
Escolha o Modo de Regras de Segurança

Você será solicitado a escolher seu modo de início das regras de segurança:

  1. Modo de produção: Nega todas as leituras e gravações por padrão. Isso é mais seguro, mas exige que você defina explicitamente as regras de segurança.
  2. Modo de teste: Permite todas as leituras e gravações de qualquer usuário por 30 dias. Isso é conveniente para o desenvolvimento, mas não é seguro para a produção.

Para iniciantes, você pode selecionar Modo de teste para começar rapidamente, mas lembre-se de atualizar suas regras de segurança antes de implantar na produção.

​
Escolha um Local para Seu Banco de Dados

Selecione um local geográfico para seu banco de dados Firestore. Considere escolher uma região próxima aos seus usuários-alvo para um melhor desempenho.

Clique em Ativar para criar seu banco de dados Firestore.

​
Passo 2: Conexão Automática ao Seu Aplicativo Golex

Depois que o Firestore estiver ativado em seu projeto do Firebase, seu aplicativo Golex detectará e se conectará automaticamente a ele quando você tiver conectado o Firebase ao seu aplicativo Golex corretamente.

Não há necessidade de configuração adicional — seu aplicativo está pronto para usar o Firestore para armazenamento de dados!

​
Passo 3: Usando o Firestore no Seu Aplicativo Golex

Golex facilita a implementação de recursos do Firestore em seu aplicativo usando o desenvolvimento orientado por prompts:

​
Adicionando Recursos do Firestore via Prompts

Exemplos de prompts:

  • “Crie um formulário que salve o feedback do usuário”
  • “Mostrar uma lista de produtos do banco de dados”
  • “Adicionar um recurso de bate-papo em tempo real usando o banco de dados”
  • “Criar uma página de perfil de usuário que exiba e atualize os dados do usuário”

Golex irá gerar os componentes e a lógica necessários para implementar esses recursos, com as chamadas apropriadas do Firestore já integradas.

​
Operações Comuns do Firestore

Golex pode ajudá-lo a implementar estas operações comuns do Firestore:

  • Criar: Adicionar novos documentos às coleções
  • Ler: Recuperar documentos únicos ou consultar coleções
  • Atualizar: Modificar documentos existentes
  • Excluir: Remover documentos das coleções
  • Atualizações em tempo real: Ouvir as alterações de dados em tempo real

​
Regras de Segurança

Com Golex, você pode facilmente definir regras de segurança granulares para proteger seus dados do Firestore. Em vez de configurar manualmente as regras no Console do Firebase, simplesmente diga ao Golex quais padrões de acesso você deseja, e ele irá gerar e implantar automaticamente as regras de segurança apropriadas.

Por exemplo, você pode especificar regras como:

  • Apenas usuários autenticados podem ler os dados
  • Os usuários só podem editar seus próprios dados de perfil
  • Os criadores de tarefas podem editar/excluir suas tarefas, enquanto outros só podem visualizá-las
  • Os usuários administradores têm acesso total a todas as coleções

​
Configurando Regras de Segurança com Golex

Simplesmente use linguagem natural para descrever seus requisitos de segurança:

“Eu quero que as tarefas só possam ser editadas por seu criador, mas legíveis por todos os usuários autenticados”

Golex irá automaticamente:

  1. Gerar as regras de segurança do Firestore apropriadas
  2. Implantá-las em seu projeto do Firebase
  3. Validar se as regras estão funcionando como esperado

Nota de Segurança Importante

Sempre especifique seus requisitos de segurança antes de implantar na produção. O modo de teste padrão permite acesso irrestrito e nunca deve ser usado em ambientes de produção.

​
Exemplo de Padrão de Segurança

Veja como você pode dizer ao Golex para configurar a segurança baseada em tarefas:

“Para minha coleção de tarefas:

  • Apenas usuários autenticados podem ler as tarefas
  • Apenas o criador da tarefa pode editar ou excluir suas tarefas
  • Os usuários podem criar novas tarefas
  • Cada tarefa deve ter um campo createdBy correspondendo ao ID do usuário”

Golex irá lidar com toda a geração e implantação de regras de segurança complexas automaticamente, garantindo que seus dados permaneçam seguros de acordo com suas especificações.