diff --git a/README.md b/README.md index b42b3bb..3989235 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,100 @@ -# bairrao +# Sistema de Gerenciamento do Campeonato Brasileiro +Este sistema permite gerenciar a tabela do Campeonato Brasileiro, cadastrar jogos e lançar resultados de partidas. + +## 📋 Funcionalidades + +- **Visualização da Tabela**: Exibe a classificação dos times com estatísticas completas (pontos, jogos, vitórias, empates, derrotas, gols, aproveitamento) +- **Busca e Ordenação**: Permite buscar times e ordenar a tabela por diferentes critérios +- **Cadastro de Jogos**: Interface para cadastrar novos jogos com data, horário e rodada +- **Lançamento de Resultados**: Sistema para registrar os resultados das partidas +- **Histórico de Jogos**: Visualização dos jogos por rodada com navegação entre rodadas +- **Autenticação**: Proteção por senha para operações administrativas + +## 🗃️ Estrutura do Banco de Dados + +### Tabela `times` +Armazena as estatísticas e informações dos times: +- `id`: Identificador único (auto incremento) +- `nome`: Nome do time +- `pontos`, `jogos`, `vitorias`, `empates`, `derrotas`: Estatísticas do campeonato +- `gols_pro`, `gols_contra`, `saldo_gols`: Estatísticas de gols +- `aproveitamento`: Percentual de aproveitamento +- `ultimos_jogos`: Histórico dos últimos resultados (V, E, D) + +### Tabela `historico_jogos` +Armazena o histórico de todos os jogos: +- `id`: Identificador único (auto incremento) +- `time_casa`, `time_visitante`: Times participantes +- `gols_casa`, `gols_visitante`: Resultado do jogo (NULL se não realizado) +- `data_jogo`: Data e hora do jogo +- `rodada`: Número da rodada +- Restrições: Impede jogos entre o mesmo time + +## 🚀 Como Usar + +### Pré-requisitos +- Servidor web com PHP +- Banco de dados MySQL +- Extensão MySQLi habilitada no PHP + +### Instalação +1. Importe o arquivo `banco.sql` no seu MySQL para criar as tabelas +2. Configure a conexão com o banco no arquivo `controller.php`: + ```php + $conn = new mysqli("localhost", "username", "password", "database_name"); + ``` +3. Defina a senha de administração no mesmo arquivo: + ```php + define('ADMIN_PASSWORD', 'sua_senha_aqui'); + ``` +4. Coloque os escudos dos times na pasta `escudos/` no formato PNG (nome do arquivo deve corresponder ao nome do time sem caracteres especiais) + +### Navegação +- **Página Principal**: `index.php` - Exibe a tabela e jogos da rodada +- **Cadastrar Jogo**: `cadastro.php` - Interface para adicionar novos jogos +- **Lançar Resultado**: `lancar.php` - Interface para registrar resultados + +## 🔐 Segurança + +- Operações administrativas exigem senha (definida em `ADMIN_PASSWORD`) +- Validação de dados em ambos front-end e back-end +- Proteção contra SQL injection usando `real_escape_string` +- Verificação para evitar times iguais em uma partida + +## 🎨 Personalização + +### Escudos dos Times +Os escudos devem ser colocados na pasta `escudos/` com os nomes correspondentes aos times, sem caracteres especiais e em minúsculas. Exemplo: +- palmeiras.png +- flamengo.png +- fluminense.png + +### Estilização +O arquivo `estilo.css` contém todos os estilos do sistema, incluindo: +- Design responsivo para mobile e desktop +- Cores temáticas do campeonato brasileiro +- Animações e transições suaves + +## ⚙️ Funcionalidades Técnicas + +### No Back-end (`controller.php`) +- Exibição e ordenação da tabela +- Gerenciamento de jogos e resultados +- Atualização automática de estatísticas +- Validação de dados e autenticação + +### No Front-end +- Interface responsiva e intuitiva +- Validação em tempo real +- Navegação por rodadas +- Busca e filtros + +## 📞 Suporte + +Para problemas ou dúvidas, verifique: +1. Conexão com o banco de dados +2. Permissões de arquivo na pasta `escudos/` +3. Configuração do PHP (MySQLi habilitado) + +Este sistema oferece uma solução completa para gerenciamento e acompanhamento de campeonatos de futebol com interface amigável e funcionalidades robustas. \ No newline at end of file