Banco de Dados

This is an old version of this page. You can view the most recent version or browse the history.

Modelo Conceitual do Banco de Dados

Introdução ao Cloud Firestore

Cloud Firestore é um banco de dados NoSQL em tempo real oferecido pelo Firebase. Diferente de bancos relacionais, ele organiza os dados em coleções e documentos, permitindo consultas flexíveis e escalabilidade automática.

Estrutura de Dados

Coleções: Contêm documentos relacionados a um mesmo contexto.

Documentos: Unidades individuais de armazenamento de dados (JSON-like).

Subcoleções: Coleções dentro de documentos para dados hierárquicos.

Campos: Propriedades dentro de um documento.

Estrutura do Banco de Dados do Projeto

User
{
 email (string) PK
 experience (number)
 lastLessonConcluded (number)
 level (number)
 money (number)
 notifications (boolean)
 pet (reference)
}

Pet
{
 id (string) PK
 name (string)
 color (string)
 type (string) *Enum "Gato" ou "Cachorro"
 purchasedItems(array)(map)
   item_id (reference)
   quantity (number)
 activeItems(map)(reference) *IDs dos itens comprados que estão ativos
   bed (string)
   food (string)
   toy (string)
   wc (string)
 wellBeing (map)
   clean (Datetime)
   fun (Datetime)
   hunger (Datetime)
   thirst (Datetime)
   sleep (Datetime)
}

Item 
{
 id (string) PK
 name (string)
 price (number)
 requiredLevel (number)
 category (string)
 image (string) *Link da imagem no bucket
}

Minigame
{
 id (string) PK
 givenMoney (number)
 name (string)
}

Lesson
{
 id (string) PK
 concluded (boolean)
 name (string)
 questions (array)(reference)
 givenExperience (number)
 given_money (number)
}

Question
{
 id (string) PK
 answers (array)(string)
 description (string) *Pergunta
 rightAnswer (number) *Index da resposta correta
}

Como Utilizar o Firestore no Código

Para acessar e manipular os dados no Firestore, utilizamos a SDK do Firebase para Typescript (no caso do projeto).

Instalação

npm install firebase

Configuração do Cloud Firestore

import { initializeApp } from "firebase/app";
import { getFirestore, doc, setDoc, getDoc, collection, addDoc } from "firebase/firestore";

const firebaseConfig = {
  apiKey: "SUA_API_KEY",
  authDomain: "SEU_DOMINIO.firebaseapp.com",
  projectId: "SEU_PROJECT_ID",
  storageBucket: "SEU_BUCKET.appspot.com",
  messagingSenderId: "SENDER_ID",
  appId: "SUA_APP_ID"
};

const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

Criar um Usuário

const createUser = async (email, money, level, experience, notifications) => {
  await setDoc(doc(db, "User", email), {
    money,
    level,
    experience,
    notifications
  });
};

Obter um Usuário

const getUser = async (email) => {
  const userRef = doc(db, "User", email);
  const userSnap = await getDoc(userRef); 

  if (userSnap.exists()) {
    console.log("Usuário encontrado:", userSnap.data());
  } else {
    console.log("Nenhum usuário encontrado.");
  }
};

Outra maneira

const usersCollection = db.collection("User");
const querySnapshot = await usersCollection
        .where("email", "==", email)
        .limit(1)
        .get();

 if (querySnapshot.exists()) {
    console.log("Usuário encontrado:", querySnapshot.data());
 }else{
    console.log("Nenhum usuário encontrado.");
 }