🎧 radinho.online
Streaming de música profissional — minimal, glass, elegante, rápido.
O que é o radinho.online
O radinho.online (aura + aural) é uma plataforma de streaming de música completa e auto-hospedável: você envia seus arquivos de áudio, um pipeline FFmpeg transcodifica tudo para HLS adaptativo, e um player de nível profissional entrega a experiência — crossfade, gapless, equalizador e ReplayGain — em uma interface deep black + glass com um único verde exclusivo.
Web na edge (Vercel) + API em servidor próprio (Docker) = custo mínimo, controle total do áudio.
Features
- 🎚️ Player pro: crossfade e reprodução gapless (dual Howl + Web Audio), EQ de 10 bandas, ReplayGain (normalização para −14 LUFS), velocidade 0.5×–2×, visualizador de espectro, letras sincronizadas
- ⬆️ Uploads com pipeline FFmpeg: ffprobe + validação por magic bytes → análise de loudness (LUFS/true peak) → ladder HLS AAC 96/160/320 kbps → waveform (1024 picos) → capas WebP em 3 tamanhos — tudo em fila durável (BullMQ + Redis)
- 📡 HLS adaptativo com URLs assinadas (HMAC, curta duração) e cache de segmentos no nginx
- 📱 PWA + Android (APK): instalável, shell offline, cache de capas, Media Session API (controles do SO), atalhos de teclado e empacotamento nativo com Capacitor
- 👥 Social: seguir usuários/artistas, feed de atividade, comentários em faixas, listen-together em tempo real (socket.io)
- 🔎 Busca instantânea com autocomplete, home personalizada, recomendações (daily mix, discover, moods, track radio)
- 📚 Biblioteca completa: playlists colaborativas com reordenação, curtidas, histórico ("continue ouvindo"), podcasts e rádios
- 🛡️ Admin: métricas, moderação de usuários/uploads, fila de jobs, audit log
- 🔐 Auth via Firebase (Google/Apple/GitHub/email/anônimo) — nenhuma senha armazenada na API
Stack
| Camada | Tecnologia |
|---|
| Web | React 19 · Vite · TypeScript · Tailwind · TanStack Query · Zustand · Framer Motion · Howler/Web Audio · vite-plugin-pwa |
| API | Node 22 · Express 5 · Prisma · Zod · socket.io · BullMQ · pino · OpenAPI 3.1 (Swagger em /api/docs) |
| Dados | PostgreSQL 16 · Redis 7 |
| Áudio | FFmpeg (HLS AAC 96/160/320, loudnorm, waveform) · sharp (capas WebP) |
| Auth | Firebase Auth (web SDK + firebase-admin) |
| Storage | Cloudflare R2 (S3) · Supabase Storage · disco local (dev) — via interface StorageProvider |
| Infra | Docker Compose · nginx · PM2 (alternativa bare-metal) · GitHub Actions · Vercel |
| Contrato | @radinho/shared — schemas Zod + DTOs compartilhados entre web e api |
Arquitetura
flowchart LR
subgraph Edge
W["apps/web · SPA React<br/>(Vercel)"]
end
subgraph Servidor["Servidor Linux (Docker Compose)"]
N["nginx :80/:443<br/>rate limit · cache HLS"]
A["api :4000<br/>Express 5 · socket.io /ws"]
K["worker<br/>BullMQ · FFmpeg"]
P[("PostgreSQL 16")]
R[("Redis 7")]
end
S[("Storage<br/>R2 / S3 / Supabase")]
F["Firebase Auth"]
W -- "REST /api/v1 · WS /ws" --> N
N --> A
A --> P
A --> R
K --> P
R <--> K
A --> S
K --> S
W -.tokens.-> F
A -.verifica ID token.-> F
Decisões e regras completas em docs/ARCHITECTURE.md · design system em docs/DESIGN.md.
Estrutura de pastas
radinho/
├── apps/
│ ├── web/ # SPA React 19 + Vite (Vercel)
│ └── api/ # Node 22 + Express 5 + Prisma (Docker/PM2 no servidor)
├── packages/
│ └── shared/ # @radinho/shared — schemas Zod, DTOs, constantes
├── infra/
│ ├── docker/ # docker-compose.dev.yml (deps locais) · docker-compose.prod.yml (stack completa)
│ ├── nginx/ # reverse proxy de produção (rate limit, WS, cache HLS, TLS)
│ ├── pm2/ # ecosystem.config.cjs (deploy bare-metal alternativo)
│ └── scripts/ # setup-server.sh · deploy-api.sh · backup-db.sh · *.ps1 (Windows)
├── docs/ # ARCHITECTURE · DESIGN · DEPLOY · CONTRIBUTING
└── .github/ # CI + deploys (Actions), templates de PR/issue
Começando
Pré-requisitos
- Node.js 22 (
.nvmrc) e pnpm 10 (corepack enable resolve)
- Docker (para Postgres + Redis locais) — ou PostgreSQL 16 e Redis 7 nativos
- FFmpeg no PATH (pipeline de áudio;
winget install ffmpeg / brew install ffmpeg)
- Um projeto Firebase (gratuito) para autenticação
Passo a passo
# 1. Dependências
pnpm install
# 2. Postgres + Redis locais (projeto docker: radinho-dev)
docker compose -f infra/docker/docker-compose.dev.yml up -d
# 3. Variáveis de ambiente (edite com suas credenciais Firebase)
cp .env.example apps/api/.env # bloco "API"
cp .env.example apps/web/.env.local # bloco "WEB" (VITE_*)
# 4. Banco: migrations + seed
pnpm db:migrate
pnpm db:seed
# 5. Sobe web + api em paralelo
pnpm dev
Sem Docker? Suba Postgres/Redis nativos com o mesmo usuário/senha/banco (aurial/aurial/aurial) e os mesmos ports — o .env.example já aponta para eles.
Scripts
| Comando | Ação |
|---|
pnpm dev | web + api em modo dev (paralelo) |
pnpm dev:web / pnpm dev:api | apenas um dos apps |
pnpm build | build de todos os pacotes |
pnpm lint / pnpm lint:fix | ESLint |
pnpm format / pnpm format:check | Prettier |
pnpm typecheck | tsc --noEmit em todos os pacotes |
pnpm test / pnpm test:coverage | Vitest em todos os pacotes |
pnpm e2e | Playwright (web) |
pnpm --filter @radinho/web android:apk | build web + sync Capacitor + APK debug |
pnpm db:generate / db:migrate / db:seed | Prisma |
APK Android (app nativo)
Pré-requisitos locais:
- JDK 21 (
JAVA_HOME configurado)
- Android SDK (
ANDROID_HOME ou local.properties em apps/web/android)
pnpm --filter @radinho/web android:apk
APK gerado em apps/web/android/app/build/outputs/apk/debug/app-debug.apk.
Testes
- Unitários (Vitest): services da API com repositórios mockados, componentes web com Testing Library, schemas do shared —
pnpm test
- E2E (Playwright): smoke da SPA (carrega, navega, player monta) —
pnpm e2e
- CI: todo push/PR para
main roda install → build shared → prisma generate → lint → typecheck → test → build (.github/workflows/ci.yml)
Deploy
Resumo (guia completo em docs/DEPLOY.md):
Roadmap
Licença
Proprietária — todos os direitos reservados. Uso, cópia ou distribuição apenas com autorização expressa. Este repositório não aceita contribuições externas sem convite (veja docs/CONTRIBUTING.md).
