Streaming adaptativo é simples de usar e mais difícil de construir. Este projeto percorre o caminho completo: do arquivo enviado aos segmentos de vídeo alinhados, às tarefas confiáveis em segundo plano e ao player que muda de qualidade durante a reprodução.
— Projeto 20
Reelcast
Um upload, várias qualidades de vídeo e um player que se adapta à conexão

visão geral do projeto
Uma plataforma de vídeo sob demanda que transforma um arquivo enviado em um stream HLS adaptativo. Go e ffmpeg geram as versões; um player hls.js escolhe a qualidade que a conexão consegue manter.
resultado entregue
Upload, transcodificação, catálogo e reprodução funcionam localmente com PostgreSQL, Redis e MinIO. Os testes documentados do worker cobrem alinhamento dos segmentos, bitrate de vídeo dentro de ±15% da meta e nova tentativa após encerrar um worker. As capturas mostram um clipe de teste gerado de 75 segundos, com reprodução em Auto e em 360p selecionado manualmente.
- Atuação
- Arquitetura e desenvolvimento solo
- Período
- 2026 — estudo de streaming executado localmente
- Ano
- 2026
- Equipe
- Solo
O navegador envia o arquivo diretamente ao armazenamento por uma URL pré-assinada. O NestJS registra os metadados e enfileira uma tarefa no BullMQ. Um consumidor TypeScript mantém o bloqueio da tarefa enquanto um processo Go executa ffprobe e ffmpeg, gerando as versões HLS e a miniatura. Quadros-chave a cada quatro segundos alinham as versões para permitir a troca pelo hls.js.
Upload, transcodificação, catálogo e reprodução funcionam localmente com PostgreSQL, Redis e MinIO. Os testes documentados do worker cobrem alinhamento dos segmentos, bitrate de vídeo dentro de ±15% da meta e nova tentativa após encerrar um worker. As capturas mostram um clipe de teste gerado de 75 segundos, com reprodução em Auto e em 360p selecionado manualmente.
— O produto em uso
O produto de verdade
Capturas verificadas da interface real do projeto, com os diferentes estados e páginas apresentados abaixo.




— Processo de entrega
Da necessidade da operação ao sistema entregue
O trabalho segue os riscos do projeto. Regras do negócio e estados de falha vêm antes do acabamento da interface; a automação chega antes da entrega.
Manter o fluxo focado
Um fluxo de produto: enviar a fonte, gerar as versões e reproduzir o resultado. O editor e as ferramentas gerais de processamento pertencem ao projeto separado Plexus.
Definir a fronteira entre serviços
A mensagem da fila carrega videoId e sourceKey. Registros compartilhados de vídeos e versões conectam os serviços TypeScript ao worker Go.
Alinhar os segmentos
Gerar todas as versões em uma execução do ffmpeg, forçar um quadro-chave a cada quatro segundos e tratar vídeos sem faixa de áudio.
Mostrar o progresso sem recarregar
Após o upload direto, uma requisição de conclusão enfileira a tarefa. O navegador consulta o status até o player estar pronto.
Testar o caminho de falha
A suíte do worker encerra o processo Go durante a codificação e verifica se o BullMQ tenta novamente até concluir a tarefa.
— Arquitetura do sistema
Limites claros, responsabilidades explícitas
Cada camada tem uma função e um contrato bem definido. Isso permite substituir serviços externos e testar o comportamento do produto.
fonte / um upload
1 arquivo → 3 versões
720p · 480p · 360p (sem ampliar)
segmentos
4s · quadros-chave alinhados
player / garantias
Next.js + hls.js
Catálogo, uploads diretos, consulta de status e reprodução adaptativa.
API NestJS
Armazena metadados, emite URLs de upload e enfileira tarefas de transcodificação.
Redis + BullMQ
Novas tentativas, espera progressiva e recuperação de tarefas travadas fora do caminho da requisição HTTP.
Camada TypeScript de bloqueio da tarefa
Mantém o bloqueio do BullMQ e inicia o transcodificador Go como processo filho.
Go + ffmpeg
Analisa a fonte, codifica as versões HLS, envia o resultado e atualiza o status do vídeo.
Armazenamento de objetos + PostgreSQL
O MinIO serve manifestos, segmentos e miniaturas localmente. O Drizzle gerencia os registros de vídeos e versões no PostgreSQL.
— O que foi entregue
O que o produto faz
Reprodução com bitrate adaptativo
O hls.js escolhe a versão de acordo com a conexão; o seletor de qualidade também permite verificar a reprodução manualmente.
Níveis de qualidade alinhados
Quadros-chave forçados mantêm os limites dos segmentos de quatro segundos consistentes entre as versões.
Uploads sem bloqueio
Uploads pré-assinados enviam o arquivo diretamente ao armazenamento, sem passar pela API.
Tarefas recuperáveis em segundo plano
O BullMQ repete tarefas interrompidas, sem depender de uma única requisição HTTP longa.
— Desafios de engenharia
Desafios resolvidos
Os limites dos segmentos afetam a reprodução
Quadros-chave naturais produziram segmentos desiguais de 4,8s e 3,2s. Forçar quadros-chave a cada quatro segundos alinhou os limites entre as versões.
Medir a faixa de vídeo
Áudio e sobrecarga do MPEG-TS fizeram 360p parecer 19% acima da meta de bitrate. Analisar apenas os pacotes de vídeo separou a precisão do encoder da sobrecarga do empacotamento.
Separar os bloqueios da fila do processamento de mídia
Um consumidor TypeScript pequeno mantém as garantias de entrega do BullMQ enquanto Go cuida da codificação intensiva em CPU.
links verificados do projeto
próxima conversa
Precisa de um sistema pensado assim?
Traga o desafio da operação. Vamos transformá-lo em um briefing claro e um próximo passo viável.
Começar um projeto