blessed_moon@estúdio
estúdio: Blessed Moon Studio
fundador: Benito Pedro Xavier · Estúdio solo
atuação: Estratégia · Design · Engenharia
stack: Next.js · Tailwind · WebGL
cena: Lua ASCII · 5 quadros-chave
fontes: Space Grotesk / JetBrains Mono
destaque: #ff6a1f
som: sem som
estado: pronto
B / S / MCASE_20 / 26

— Projeto 20

Reelcast

Um upload, várias qualidades de vídeo e um player que se adapta à conexão

Todos os projetos
reelcast.capture● verificado
Reelcast reproduzindo um clipe de teste gerado em 720p, com qualidade Auto selecionada e as versões 720p, 480p e 360p listadas abaixo

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 problema01

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.

A abordagem02

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.

O resultado03

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.

Formulário de upload do Reelcast com título, descrição e seleção de arquivo de vídeo01 / 04
Formulário de upload do Reelcast com título, descrição e seleção de arquivo de vídeo
Status de um vídeo enviado, passando por upload, fila, processamento e pronto sem recarregar a página02 / 04
Status de um vídeo enviado, passando por upload, fila, processamento e pronto sem recarregar a página
Catálogo do Reelcast com um vídeo pronto e sua miniatura gerada03 / 04
Catálogo do Reelcast com um vídeo pronto e sua miniatura gerada
O mesmo clipe gerado sendo reproduzido com a qualidade selecionada manualmente em 360p04 / 04
O mesmo clipe gerado sendo reproduzido com a qualidade selecionada manualmente em 360p

— 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.

01

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.

02

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.

03

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.

04

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.

05

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.

Next.jsNestJSGoffmpeghls.jsBullMQ / RedisPostgreSQLS3 / MinIO
reelcast.sysdiagrama do sistema

fonte / um upload

1 arquivo → 3 versões

720p · 480p · 360p (sem ampliar)

segmentos

4s · quadros-chave alinhados

●alinhados para trocar de qualidade

player / garantias

upload direto · fora da API[x]
BullMQ · novas tentativas[x]
hls.js · adapta à conexão[x]
bitrate ±15% · faixa de vídeo[x]
ao vivo · DASH · DRM[ ]
upload → fila → Go/ffmpeg → HLS → play
Interface

Next.js + hls.js

Catálogo, uploads diretos, consulta de status e reprodução adaptativa.

API

API NestJS

Armazena metadados, emite URLs de upload e enfileira tarefas de transcodificação.

Queue

Redis + BullMQ

Novas tentativas, espera progressiva e recuperação de tarefas travadas fora do caminho da requisição HTTP.

Consumidor da fila

Camada TypeScript de bloqueio da tarefa

Mantém o bloqueio do BullMQ e inicia o transcodificador Go como processo filho.

Transcodificador

Go + ffmpeg

Analisa a fonte, codifica as versões HLS, envia o resultado e atualiza o status do vídeo.

Armazenamento + banco

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

01

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.

02

Níveis de qualidade alinhados

Quadros-chave forçados mantêm os limites dos segmentos de quatro segundos consistentes entre as versões.

03

Uploads sem bloqueio

Uploads pré-assinados enviam o arquivo diretamente ao armazenamento, sem passar pela API.

04

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

01

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.

02

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.

03

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óximo projetoApuração 2026

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