Bem-vindo ao projeto VdcScore. Este sistema é composto por duas componentes principais projetadas para extrair, processar e apresentar dados do Campeonato Inter Freguesias de Vila do Conde (AFAVCD).

Objetivo do Projeto

Fornecer uma aplicação móvel interativa e moderna aos utilizadores finais, permitindo-lhes visualizar toda a informação sobre clubes, jogos, classificações e jogadores em tempo real. A App Android não possui uma backend tradicional (API REST), mas sim uma arquitetura orientada a eventos usando Firebase Realtime Database. Os dados no Firebase são mantidos sempre atualizados por um Scraper Java, que corre autonomamente para ler dados oficiais do website/API da associação de futebol.

Componentes do Sistema

VdcScore App (Android): Uma aplicação nativa Android (VdcScore_Project/VdcScore) desenhada para consumidores finais. Inclui autenticação (Firebase Auth) e lê dados diretamente do Firebase Database.
Scraper (Java): Uma aplicação Java isolada (VdcScore_Project/scrapper) que funciona como um worker. Extrai (scrapes) dados e envia as atualizações para o Firebase.

Como Navegar na Documentação

Para suportar o desenvolvimento contínuo (seja por humanos ou por Agentes de Inteligência Artificial), criámos um conjunto de documentos detalhados na pasta docs/. Recomendamos ler pela seguinte ordem:

Dicas para IA / LLMs

Contexto: Quando assumires este projeto, verifica primeiro o ficheiro 05_PROGRESSO_E_ESTADO_ATUAL.md para entender onde a equipa parou e quais são os próximos passos.
Base de Dados: O schema não deve ser alterado à toa num dos projetos sem alinhar com o outro. Ambos partilham o mesmo design estrutural do Firebase. Ver 04_SCHEMA_BASE_DADOS.md.