# ⚽ 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