61 lines
2.1 KiB
Markdown
61 lines
2.1 KiB
Markdown
# ⚽ Football League Admin — Documentação Principal
|
|
|
|
> Backend web dashboard para gestão em tempo real de uma liga de futebol com sincronização Firebase.
|
|
|
|
---
|
|
|
|
## Índice
|
|
|
|
1. [Visão Geral](#visão-geral)
|
|
2. [Documentos do Projeto](#documentos-do-projeto)
|
|
3. [Início Rápido para Novas Sessões](#início-rápido-para-novas-sessões)
|
|
4. [Estado Atual](#estado-atual)
|
|
|
|
---
|
|
|
|
## Visão Geral
|
|
|
|
Este website é o **painel de administração** de uma aplicação de liga de futebol. A aplicação cliente (já desenvolvida) lê dados em tempo real da Firebase Firestore. Este dashboard serve para:
|
|
|
|
- Inserir e atualizar resultados de jogos em tempo real
|
|
- Gerir clubes, jogadores e estatísticas
|
|
- Controlar a liga (jornadas, classificação, artilheiros)
|
|
- Publicar notícias e destaques
|
|
|
|
**A aplicação cliente não tem edição — apenas leitura. Este site é o único ponto de escrita na Firebase.**
|
|
|
|
---
|
|
|
|
## Documentos do Projeto
|
|
|
|
| Ficheiro | Descrição |
|
|
|---|---|
|
|
| `docs/01-project-plan.md` | Plano completo, objetivos, fases |
|
|
| `docs/02-tech-stack.md` | Stack tecnológica detalhada com justificação |
|
|
| `docs/03-architecture.md` | Arquitetura do sistema, Firebase schema |
|
|
| `docs/04-design-system.md` | Design system, cores, tipografia, componentes |
|
|
| `docs/05-features.md` | Funcionalidades detalhadas por módulo |
|
|
| `docs/06-agent-handoff.md` | Guia de handoff entre sessões de desenvolvimento |
|
|
| `docs/07-progress-tracker.md` | Tracker de progresso e status |
|
|
| `docs/08-firebase-schema.md` | Schema completo da Firebase Firestore |
|
|
| `mockup/index.html` | Mockup interativo do dashboard |
|
|
|
|
---
|
|
|
|
## Início Rápido para Novas Sessões
|
|
|
|
**Se és um agente que está a retomar o trabalho, lê nesta ordem:**
|
|
|
|
1. `docs/07-progress-tracker.md` — ver o que está feito e o que falta
|
|
2. `docs/06-agent-handoff.md` — contexto e instruções de handoff
|
|
3. `docs/03-architecture.md` — estrutura do projeto
|
|
4. O ficheiro específico do módulo em que vais trabalhar
|
|
|
|
---
|
|
|
|
## Estado Atual
|
|
|
|
**Fase:** Planeamento / Documentação
|
|
**Próximo passo:** Setup inicial do projeto (Vite + React + Firebase)
|
|
**Última atualização:** Documentação criada
|