Plataforma de descoberta e reprodução de filmes e séries

• Catálogo dinâmico via TMDB Discover API com filmes e séries em pt-BR
• Filtros por gênero (30+ gêneros para filmes, 20+ para séries), idioma e ordenação
• Ordenação por popularidade, data de lançamento, avaliação e ordem alfabética
• Pesquisa global com paleta de comandos (Ctrl+K / Cmd+K)
• Hero carousel rotativo com destaques: Trending, Lançamentos e Séries
• Linhas curadas: "Em alta agora", "Filmes Populares", "Séries para maratonar"
• Circuit breaker para falhas da API TMDB (3 falhas → pausa de 60s)
• Cache: trending 30min, detalhes 60min

• Reprodução HLS adaptativa com HLS.js e suporte a mpegts.js
• Troca de qualidade automática (por condição de rede) e manual
• Controles de velocidade: 0.75×, 1×, 1.25×, 1.5×, 2×
• Barra de progresso com seeking e expansão ao hover
• Controle de volume com slider (0–100%)
• Fullscreen com duplo clique
• Próximo episódio com contagem regressiva de 10s e card de preview
• Navegação entre episódios e temporadas
• Alertas de sinal fraco com downgrade automático de qualidade
• Persistência de preferências do player via localStorage

• Login com e-mail + senha e Google OAuth
• Cadastro com validação e envio de e-mail de confirmação
• Verificação via OTP (código 6 dígitos)
• Recuperação e redefinição de senha
• Reenvio de e-mail de confirmação
• Heartbeat de sessão (rastreamento de último acesso)
• Proteção de rotas via middleware (proxy)

• Favoritar/desfavoritar com atualização otimista (sem reload)
• Progresso de reprodução salvo por conteúdo e episódio
• Conclusão automática quando progresso ≥ 90% e posição ≥ 30s
• Histórico dos últimos 20 itens assistidos
• "Continuar assistindo" com posição e percentual preservados

• Overview: métricas em tempo real (usuários totais, ativos, uptime), gráficos de crescimento, favoritos e espectadores ao vivo
• Usuários: tabela paginada com busca, filtro por role, toggle ADMIN/USER, exclusão com confirmação e painel lateral de detalhes
• Sistema: health checks de PostgreSQL, Supabase Auth e TMDB API, modo manutenção, limpeza de cache e sessões
• Conteúdo: diagnóstico de erros do catálogo

• Sitemap dinâmico com os 24 principais filmes e séries
• robots.txt configurado (bloqueia /admin, /api, /play)
• Canonical, Open Graph e metadataBase por ambiente

RLS habilitado em todas as tabelas de usuário — cada usuário acessa apenas seus próprios dados.

• Row-Level Security (RLS) no PostgreSQL via Supabase Auth (auth.uid())
• Rate limiting em memória por IP com janela deslizante e varredura a cada 60s
• Middleware bloqueia acesso não autenticado a /admin e /collection/favorites
• Redireciona usuários autenticados para fora das páginas de login/cadastro

• Node.js 20+
• pnpm
• Projeto Supabase configurado
• Banco PostgreSQL acessível pelo Prisma

pnpm install
cp .env.example .env.local

Variáveis principais:

pnpm dev

Build de produção:

pnpm build
pnpm start

Os testes ficam colocalizados por módulo dentro de src/.

• *.test.ts / *.test.tsx — unitários e integração
• __e2e__/*.e2e.spec.ts — fluxos E2E

pnpm test
pnpm test:coverage
pnpm test:e2e

src/
├── app/               # rotas, páginas, route handlers e E2E
├── components/        # componentes compartilhados
├── features/          # módulos por domínio (auth)
├── hooks/             # hooks reutilizáveis
├── infrastructure/    # integrações externas, db e clients
├── service/           # serviços de domínio (catálogo, auth, TMDB)
├── shared/            # helpers, auth, mídia, testing e tipos comuns
└── store/             # estado global com Zustand

prisma/                # schema e migrações

• AUTH_REDIRECT_BASE_URL deve apontar para o domínio real em produção para canonical, open graph e redirects saírem corretos.
• O catálogo é carregado dinamicamente via TMDB Discover API; não há seed de conteúdo.
• IDs de conteúdo seguem o formato tmdb_movie_<id> e tmdb_tv_<id>.
• Os vídeos reproduzidos são de domínio público (Big Buck Bunny, Tears of Steel etc.) para fins de demonstração.

Vitor Firmino