01 — Plano do Projeto

Objetivo

Criar um website de administração que sirva de backend para uma aplicação de liga de futebol. A aplicação cliente já está desenvolvida e lê dados em tempo real da Firebase. Este dashboard é o único ponto de escrita.

Problema a Resolver

A aplicação cliente mostra dados em tempo real mas não tem interface de edição. É necessário um painel de administração que permita:

Atualizar resultados durante os jogos (em tempo real)
Gerir toda a estrutura da liga (clubes, jogadores, jornadas)
Manter estatísticas atualizadas automaticamente

Âmbito do Projeto

In Scope

Dashboard de administração web (SPA)
Autenticação segura (apenas administradores)
CRUD completo de jogos, clubes, jogadores
Atualização de resultados em tempo real (live)
Gestão de jornadas e classificação
Estatísticas automáticas (calculadas a partir dos resultados)
Interface responsiva (desktop-first, mas funcional em tablet)

Out of Scope

Aplicação cliente (já existe)
API REST separada (Firebase é o backend direto)
App móvel de administração
Sistema de utilizadores múltiplos com permissões granulares (v1)

Fases de Desenvolvimento

Fase 0 — Planeamento e Design (ATUAL)

Definição de requisitos
Stack tecnológica
Arquitetura do sistema
Design system
Firebase schema
Mockup interativo
Review e aprovação

Fase 1 — Setup e Fundação

Estimativa: 1-2 sessões

Inicializar projeto Vite + React + TypeScript
Configurar Firebase SDK
Configurar React Router
Implementar autenticação Firebase Auth
Layout base (sidebar + header + content area)
Design system (cores, tipografia, componentes base)

Fase 2 — Módulo de Jogos (Core)

Estimativa: 2-3 sessões

Listagem de jogos por jornada
Criação de jogo
Live Score Editor — atualização em tempo real
Finalizar jogo (resultado final)
Histórico de jogos

Fase 3 — Módulo de Gestão

Estimativa: 2 sessões

CRUD de Clubes
CRUD de Jogadores (com clube associado)
Gestão de Jornadas
Classificação (calculada automaticamente)

Fase 4 — Estatísticas e Extras