🎧 Audissey

Documentação Completa da Plataforma

Getting Started

Índice de Documentação

Índice completo de toda a documentação

Apresentação aos Stakeholders

Visão de negócio, funcionalidades, vantagens competitivas e roadmap

API & Data Overview

Endpoints, schemas, fluxos de dados e estrutura das APIs (API + Worker)

README Principal

Setup, configuração e quick start do projeto

Guia completo do ambiente Docker

Azure Infrastructure Setup

Comandos completos para setup de MongoDB Atlas, Redis, Container Registry e monitoring

Azure Key Vault Setup

Gestão segura de segredos com Azure Key Vault

Git Workflow & Políticas

Branching strategy, proteções, PR workflow e conventional commits

Azure DevOps Branch Policies

Guia passo-a-passo para configurar proteções de branch no Azure DevOps

Infrastructure & Information Flow

Diagrama completo: pipelines CI/CD, mobile apps, backend, Azure infra e fluxos de dados

Modelo de Negócio

Segmentos, proposta de valor, receitas, pipeline de conteúdo, ML/AI e modelo de dados

Server Architecture

Módulos NestJS, endpoints, middleware pipeline, autenticação, Worker e schemas MongoDB

ML Service Setup

Python ML service com FastAPI, testes, linting e CI pipeline

Docker Images Build & Publish

Sistema automatizado de build, versionamento e publicação no ACR

Ambientes e Deployment

Setup de ambientes isolados (dev/staging/prod) com pipelines e approvals

Container Apps Setup

Referência completa do CAE North Europe — workers, networking, DNS, identities e comandos

Configuração de links de documentação no Swagger

Seed de Rádios

Seed rápido e completo de rádios portuguesas

Seed de Podcasts

Seed rápido e completo de podcasts portugueses

Funcionalidades

Implementação de Podcasts

Gestão de podcasts e episódios

Sincronização de Episódios

Atualização automática via Podcast Index API

Programas de Rádio

Implementação de programas de rádio gravados

Sincronização de Rádios

Ingestão automática via Radio Browser API

Stream Fallback

Teste e fallback automático de streams

Implementação ICY Metadata

Sistema de extração de metadata Shoutcast

SSE Now-Playing Architecture

Server-Sent Events para now-playing em tempo real (backend + Flutter)

Radio Schedules & EPG

Sistema completo de programação de rádios

EPG via Padrões ICY

Sistema completo de EPG baseado em análise de padrões ICY históricos (Fases 1-4)

Validação EPG IPTV/M3U Extended

Análise de viabilidade de playlists M3U públicas (iptv-org) como fonte de streams e EPG

Descoberta Automática de Podcasts

Sistema de descoberta diária de novos podcasts

API Documentation

API de Listagem de Rádios

Endpoint público de rádios com filtros

API "Agora a Tocar"

Metadata ICY em tempo real dos streams

API de Submissão de Programação

Rádios podem submeter sua própria grade de programação

API de Highlights da Homepage

Conteúdo em destaque: rádios, podcasts e programas no ar

Debug da Ordenação por Idioma

debugRanking: parcelas da pontuação de cada sugestão (só administradores)

API de Pesquisa Unificada

Pesquisa simultânea em rádios, podcasts e episódios

Scripts & Tools

Scripts & Automação

Documentação de todos os scripts disponíveis

Sistema de Alertas

Monitorização de disponibilidade com notificações por email

Dashboard de Monitorização de Ingestão

Sistema de monitorização de sincronizações com status, métricas e health

Admin Data Ops (Quality + Audit)

Rádio 360º, quality (programs/schedules) com guardrails e Audit Log

Content Features para IA/ML

Normalização de metadados e features para machine learning e recomendações

Normalização de Géneros

Sistema de normalização de géneros e categorias com 38 géneros e ~300+ variantes

Normalização de Géneros

Sistema de normalização e categorização automática de géneros musicais

Especificações Técnicas

Taxonomia de Eventos

Sistema completo de tracking e analytics

Health & Logging

Application Insights, correlation IDs e sistema de logs

Azure Security Review (AZQR)

Relatório de findings e plano de remediação (AZQR)

MongoDB Query Best Practices

Regras obrigatórias e padrões para evitar queries lentas e consumo excessivo de recursos

MongoDB Mongoose Query Optimization Guide

Developer guide: mandatory query rules, code examples, and PR checklist for MongoDB

Ideal Architecture — Event-Driven Now-Playing

North-star CQRS architecture: Service Bus, separate read/write paths, real-time push via SignalR

Go Collector — Alternativa ao Radio Collector

Implementação standalone em Go do pipeline now-playing: 2 250 LOC, 9.8 MB, 7.5× menos memória

📘 API Reference (Swagger) 💚 Health Check