commit 9c36b714f1413a11a55a9979ee87f56f2d6e0528
Author: 230421 <230421@epvc.pt>
Date:   Tue May 5 17:10:26 2026 +0100

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..450d161
--- /dev/null
+++ b/README.md
@@ -0,0 +1,60 @@
+# ⚽ 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