Skip to content
This repository was archived by the owner on Mar 14, 2026. It is now read-only.

andreluisrabelo/bg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎲 Board Game Collection

Sistema completo de gerenciamento de coleção de jogos de tabuleiro desenvolvido em PHP e MySQL, com interface estilo Netflix.

PHP MySQL License

📋 Sobre o Projeto

Este é um sistema web completo para organizar e gerenciar sua coleção de jogos de tabuleiro. Ideal para colecionadores que possuem muitos jogos e precisam de uma forma visual e eficiente de organizá-los.

✨ Principais Funcionalidades

  • 🎮 Gerenciamento Completo de Jogos: Cadastre jogos base, expansões e acessórios com fotos, descrições e avaliações
  • 📍 Sistema de Localização: Organize por cômodos, armários e gavetas
  • 🧼 Controle de Manutenção: Gerencie limpeza de mofo, troca de sílica gel e cloreto de cálcio
  • 🔍 Filtros Avançados: Filtre por modo solo, 2 jogadores, tipo (euro/ameri), avaliação e mais
  • 📋 Listas Personalizadas: Crie suas próprias listas (top 10, para jogar, recomendações, etc.)
  • 🌐 Sistema de Traduções: Gerencie traduções de cartas com imagens e textos, com opção de impressão
  • 🎯 Registro de Partidas: Acompanhe seu histórico de partidas com estatísticas
  • 💰 Controle de Vendas: Gerencie jogos à venda e mantenha histórico de vendidos
  • 📱 Interface Responsiva: Design estilo Netflix, funciona em desktop, tablet e smartphone

🖼️ Visual

O sistema possui uma interface moderna inspirada na Netflix, com:

  • Cards visuais dos jogos com fotos
  • Dashboard com estatísticas da coleção
  • Seções horizontais por categoria
  • Design escuro e confortável para os olhos
  • Layout totalmente responsivo

📦 Requisitos

  • PHP 7.4 ou superior
  • MySQL 5.7 ou superior
  • Servidor web (Apache, Nginx, etc.)
  • Extensões PHP: PDO, PDO_MySQL, GD, FileInfo

🚀 Instalação Rápida

  1. Clone o repositório

    git clone https://github.com/seu-usuario/bg.git
  2. Importe o banco de dados

    • Crie um banco de dados MySQL
    • Importe o arquivo database/schema.sql
  3. Configure a conexão

    • Edite app/config/database.php
    • Configure suas credenciais do MySQL
  4. Configure permissões

    chmod -R 755 app/uploads/
  5. Acesse o sistema

    http://localhost/app/
    

📖 Guia completo: Veja INSTALL.md para instruções detalhadas

📚 Documentação

🎯 Casos de Uso

Este sistema é perfeito para você se:

  • ✅ Possui mais de 50 jogos e quer organizar melhor
  • ✅ Tem jogos espalhados pela casa e não sabe onde estão
  • ✅ Precisa controlar umidade e fazer manutenção regular
  • ✅ Tem jogos em inglês e quer gerenciar traduções
  • ✅ Quer ter controle de jogos jogados vs não jogados
  • ✅ Precisa gerenciar vendas de jogos
  • ✅ Quer criar listas personalizadas (top 10, favoritos, etc.)
  • ✅ Gosta de registrar partidas e ver estatísticas

🗂️ Estrutura do Projeto

bg/
├── app/                    # Aplicação principal
│   ├── config/            # Configurações
│   ├── includes/          # Cabeçalho e rodapé
│   ├── assets/            # CSS e JavaScript
│   ├── uploads/           # Arquivos enviados
│   ├── index.php          # Dashboard
│   ├── jogos.php          # Gerenciar jogos
│   ├── listas.php         # Listas personalizadas
│   ├── traducoes.php      # Sistema de traduções
│   ├── partidas.php       # Registro de partidas
│   ├── localizacao.php    # Gerenciar localização
│   └── manutencao.php     # Controle de manutenção
├── database/              # Schema do banco de dados
│   └── schema.sql
├── INSTALL.md             # Guia de instalação
├── README_FUNCIONALIDADES.md  # Documentação completa
└── README.md              # Este arquivo

🛠️ Tecnologias Utilizadas

  • Backend: PHP 7.4+ com PDO
  • Banco de Dados: MySQL 5.7+
  • Frontend: HTML5, CSS3, JavaScript (Vanilla)
  • Design: CSS Grid, Flexbox, Estilo Netflix
  • Upload: Sistema seguro de upload de imagens e arquivos

🔒 Segurança

  • Proteção contra SQL Injection (prepared statements)
  • Validação de tipos de arquivo no upload
  • Sanitização de inputs
  • Limite de tamanho de arquivo (5MB)

📈 Funcionalidades Futuras

Sugestões para próximas versões:

  • Sistema de usuários e autenticação
  • Integração com API do BoardGameGeek
  • Exportar dados para Excel/PDF
  • Gráficos e estatísticas avançadas
  • Sistema de empréstimo de jogos
  • Wishlist de jogos para comprar
  • App mobile nativo

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para:

  1. Fazer fork do projeto
  2. Criar uma branch para sua feature (git checkout -b feature/NovaFuncionalidade)
  3. Commit suas mudanças (git commit -m 'Adiciona nova funcionalidade')
  4. Push para a branch (git push origin feature/NovaFuncionalidade)
  5. Abrir um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👤 Autor

Desenvolvido com ❤️ para a comunidade de board gamers.

🙏 Agradecimentos

  • Inspirado na necessidade real de organizar uma grande coleção de jogos de tabuleiro
  • Design baseado na interface do Netflix
  • Comunidade de board gamers brasileira

⭐ Se este projeto foi útil para você, considere dar uma estrela!

🎲 Boas jogatinas e boa organização!

About

App Web para controle de jogos de tabuleiros

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors