PocketDB 🎴

Base de dados para cartas de Pokémon TCG usando Prisma e Next.js.

📋 Sumário

• 🚀 Como Começar
  • Pré-requisitos
  • Instalação
  • Configuração do Banco de Dados
• 📂 Estrutura do Projeto
• 👥 Contribuição
• 📄 Licença

🚀 Como Começar

Pré-requisitos

• Node.js (versão 14 ou superior)
• npm ou yarn para gerenciamento de pacotes
• PostgreSQL

🛠️ Instalação

1. Clone o repositório:

   git clone https://github.com/diogofelizardo/PocketDB.git
   cd PocketDB

2. Instale as dependências:

   npm install
   # ou
   yarn install

3. Configure a variável de ambiente do banco de dados: No arquivo .env, adicione a seguinte linha (substitua os valores de acordo com o seu banco de dados):

   DATABASE_URL="postgresql://user:password@localhost:5432/pocketdb?schema=public"

4. Configuração do Prisma:

   • Gere os arquivos do Prisma:

     npx prisma generate

   • Execute as migrações para criar as tabelas no banco de dados:

     npx prisma db push

5. Popule o banco de dados com dados iniciais:

   npm run seed

📂 Estrutura do Projeto

PocketDB/
├── prisma/
│   ├── schema.prisma       # Esquema do banco de dados
│   ├── migrations/         # Histórico de migrações do banco de dados
│   ├── seed.ts             # Script para popular o banco de dados
│   ├── data/
│   │   └── pokemon-data.ts # Dados de exemplo para popular o banco
│   └── types/
│       └── seed-types.ts   # Definições de tipos para dados de seed
├── app/                    # Diretório principal da aplicação Next.js
│   └── api/                # Rotas da API
├── components/             # Componentes React reutilizáveis
├── lib/                    # Bibliotecas e utilidades
├── public/                 # Arquivos estáticos
│   └── images/             # Imagens do projeto
├── .env                    # Variáveis de ambiente
├── .env.example            # Exemplo de variáveis de ambiente
├── .gitignore              # Arquivos ignorados pelo Git
├── package.json            # Dependências e scripts do projeto
├── tsconfig.json           # Configuração do TypeScript
└── README.md               # Documentação do projeto

📁 Descrição dos Diretórios Principais

• prisma/: Contém toda a configuração e schemas do Prisma ORM
• app/: Componentes e lógica principal do Next.js
• components/: Componentes React reutilizáveis
• lib/: Funções e configurações compartilhadas
• public/: Arquivos estáticos acessíveis publicamente

👥 Contribuição

1. Crie uma branch para sua feature:

   git checkout -b feature/AmazingFeature

2. Faça commit das suas mudanças:

   git commit -m 'Add: nova feature incrível'

3. Envie para o repositório remoto:

   git push origin feature/AmazingFeature

4. Abra um Pull Request na branch principal.

🎯 Funcionalidades Planejadas

Prioridade Alta

• Sistema de Autenticação

  • Login com email/senha
  • Login social (Google, Discord)
  • Perfil do usuário
  • Recuperação de senha

• Gerenciamento de Coleção

  • Adicionar cartas à coleção pessoal
  • Marcar cartas como "Quero" ou "Tenho para troca"
  • Registrar múltiplas cópias

• Expansão do Banco de Dados

  • Adicionar mais sets de cartas
  • Incluir informações detalhadas de cada carta (ataques, habilidades, etc)
  • Sistema de versionamento para diferentes impressões da mesma carta

Prioridade Média

• Sistema de Torneios

  • Criação e gerenciamento de torneios
  • Diferentes formatos (Swiss, Eliminação simples, etc)
  • Sistema de pontuação
  • Histórico de partidas
  • Ranking de jogadores

• Construtor de Decks

  • Interface drag-and-drop para montagem
  • Validação de regras do formato
  • Compartilhamento de decks
  • Exportação/Importação de decks

• Sistema de Trocas

  • Listagem de cartas disponíveis para troca
  • Sistema de mensagens entre usuários
  • Avaliações de trocas realizadas
  • Histórico de trocas

Prioridade Baixa

• Recursos da Comunidade

  • Fórum de discussão
  • Reviews de cartas
  • Guias e estratégias
  • Sistema de comentários

• Análise de Preços

  • Histórico de preços
  • Integração com marketplaces
  • Alertas de preço
  • Tendências do mercado

• Recursos Avançados

  • API pública para desenvolvedores
  • Aplicativo mobile
  • Suporte a múltiplos idiomas
  • Tema escuro/claro

Melhorias Técnicas

• Otimizações

  • Cache de imagens
  • Lazy loading
  • Paginação infinita
  • Melhorias de SEO

• Infraestrutura

  • CI/CD
  • Testes automatizados
  • Monitoramento de erros
  • Backup automático

🤝 Como Contribuir

Se você deseja contribuir com alguma dessas funcionalidades:

1. Verifique as Issues para ver se a funcionalidade já está sendo desenvolvida
2. Crie uma nova issue descrevendo a funcionalidade que você quer implementar
3. Faça um fork do projeto
4. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
5. Implemente suas mudanças
6. Faça commit das alterações (git commit -m 'Add: nova funcionalidade incrível')
7. Push para a branch (git push origin feature/AmazingFeature)
8. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a GNU General Public License v3.0 - veja o arquivo LICENSE para detalhes.