AZ Media

O que ele é dono

O AZ Collections divide responsabilidades entre serviços, e cada dado tem um único dono. Quem é dono decide, guarda e avisa os outros — os demais mantêm cópias apenas para ler.

O mapa em uma tela

Duas características do desenho explicam quase tudo o que vem a seguir: o arquivo não passa pelo servidor e os serviços não se chamam diretamente — eles trocam mensagens por uma fila, o que permite que um fique fora do ar sem derrubar o outro.

Fluxo 1 · Envio de imagem

PENDING → UNDER_REVIEW → READY ou REJECTED

1. Aplicativo → AZ Media Pedido de autorização

   O aplicativo informa a finalidade da imagem, o tipo do arquivo e o tamanho. A finalidade é o que define as regras: uma foto de perfil e uma imagem de produto têm limites diferentes.

2. AZ Media Validação e reserva

   O serviço recusa tipo não permitido e tamanho acima do limite antes de qualquer arquivo trafegar. Garante que o autor exista na cópia local de usuários, grava o registro em PENDING e devolve uma URL de envio assinada, com validade curta.

3. Aplicativo → Cloudflare R2 Envio do arquivo

   O aplicativo envia os bytes diretamente para o R2, sem passar pelo servidor. Isso poupa banda e memória, e é o motivo de uma falha aqui não aparecer em nenhum registro do servidor — o tráfego acontece entre o aparelho e a Cloudflare.

4. Aplicativo → AZ Media Confirmação

   Concluído o envio, o aplicativo avisa. Com a moderação desligada, a imagem vai direto para READY. Com ela ligada, fica em UNDER_REVIEW e uma mensagem de pedido de análise entra na fila.

5. AZ Media (consumindo a própria fila) Análise e veredito

   A imagem passa pelas duas camadas de IA descritas adiante. Aprovada, vira READY; reprovada, REJECTED, com o motivo registrado. Nos dois casos, o resultado é publicado na fila para o servidor principal.

Imagens aceitam JPEG, PNG e WebP; vídeos aceitam MP4, QuickTime e WebM.

Fluxo 2 · Envio de vídeo

O vídeo segue o mesmo início, mas com uma diferença importante: o AZ Media não sabe quando o vídeo ficou pronto. Quem avisa é a Cloudflare, depois de converter o arquivo.

PENDING → PROCESSING → UNDER_REVIEW → READY ou REJECTED / FAILED

1. Aplicativo → AZ Media → Cloudflare Stream Reserva e envio

   Igual à imagem, mas o destino é o Stream, que aceita arquivos de até 512 MB e cuida da conversão para os formatos de reprodução.

2. Cloudflare Stream → AZ Media Aviso de conclusão

   O Stream chama o AZ Media de volta conforme o processamento avança. Enquanto não está pronto, o vídeo fica em PROCESSING. Só vira pronto quando o aviso traz, ao mesmo tempo, a confirmação de conclusão e o endereço de reprodução.

3. AZ Media Verificação de duração

   A duração é conferida a partir do que a Cloudflare informa, não do que o aplicativo declarou — o número declarado pelo cliente é justamente o que alguém mal-intencionado controlaria. Vídeo acima do teto vai para FAILED, com o motivo registrado.

4. AZ Media Moderação sobre as capas

   A análise de vídeo não examina o arquivo inteiro: usa as miniaturas geradas pelo Stream, cinco por padrão. Cada miniatura passa pelas duas camadas, como se fosse uma imagem. Qualquer uma reprovada reprova o vídeo.

A cópia de usuários

O AZ Media precisa saber o nome e o avatar de quem publicou para montar a tela do AZ Play, e precisa saber quem segue quem para a aba “Seguindo”. Nada disso é dele — pertence ao servidor principal. Em vez de perguntar a cada abertura de tela, ele mantém uma cópia local, atualizada por eventos.

Como a cópia se mantém

As duas sincronizações têm filas separadas, e isso é deliberado: uma falha ao gravar o grafo de seguidores não pode atrasar ou descartar o nome e o avatar de um usuário, que é o que toda tela exibe.

A conversa com o servidor principal

Os dois serviços nunca se chamam diretamente. Toda comunicação passa por uma fila de mensagens, com um endereço único por assunto. Quem publica não sabe quem escuta, e quem escuta não precisa que o outro esteja no ar naquele instante.

O que o AZ Media escuta

O que o AZ Media anuncia

Mensagens que falham repetidamente vão para uma fila de mensagens problemáticas, em vez de bloquear a fila principal. E cada evento processado fica registrado, de modo que receber a mesma mensagem duas vezes não produz efeito duplicado.

A filtragem por IA

Toda mídia enviada passa por uma análise automática antes de aparecer para alguém. O objetivo é barrar pornografia, violência explícita, drogas e armas — e o que a análise reprova nunca chega ao feed.

São duas camadas, com a mesma lógica de um filtro grosso seguido de um fino: uma análise barata resolve os casos evidentes, e só a zona de dúvida sobe para uma análise mais cara, que entende contexto.

Como calibrar

Combinações úteis:

• Tudo passa pela segunda camada: limite inferior em 0 e superior em 1. Nada é decidido localmente — mas a primeira camada continua rodando, como explicado abaixo.
• Só a primeira camada: os dois limites iguais, por exemplo ambos em 0,5. A zona de dúvida desaparece e nada é enviado para fora.
• Auditar antes de valer: manter a moderação desligada e observar os registros num ambiente de teste, calibrando as faixas com conteúdo real.

Onde cada camada roda — e por que isso importa

As duas camadas fazem trabalhos diferentes e, hoje, rodam em lugares diferentes:

O que seria um classificador hospedado

A saída natural para o custo da camada 1 seria mantê-la, mas fora do servidor: em vez de carregar os modelos na própria memória, chamar um classificador hospedado — um modelo de classificação de imagem que roda na infraestrutura de um provedor, do mesmo jeito que a camada 2 já faz.

O funcionamento é o mesmo da camada atual: envia-se a imagem e recebe-se de volta uma lista de rótulos com pontuação de confiança. A diferença está apenas em onde a conta é feita — e o preço é irrisório: cerca de 0,23 unidade de consumo por imagem, contra 5 a 12 do modelo de visão. Com a cota diária gratuita seria possível classificar dezenas de milhares de imagens sem custo.

Restam, portanto, três caminhos com cobertura completa: manter a filtragem no servidor com os ajustes de contenção; movê-la para um contêiner sob demanda, que executa o mesmo modelo fora da máquina; ou contratar um serviço especializado em moderação de imagem, cujo produto é exatamente esta função. A comparação entre eles, com números, está na análise de infraestrutura.

Armazenamento e retenção

Exclusão em duas etapas

Apagar mídia é feito em dois tempos, e isso é proposital — dá margem para desfazer engano e para atender pedido de suporte.

1. Marcação

   Ao receber o aviso de exclusão, a mídia é marcada como removida e some do aplicativo. O arquivo continua onde está.

2. Exclusão definitiva

   Uma rotina diária, às 03:00, apaga em definitivo o que foi marcado há mais tempo que o período de retenção — o arquivo na Cloudflare e o registro no banco. É a única rotina agendada do serviço, e ela apaga de verdade: vale conhecer antes de mexer no horário ou no prazo.

Autenticação

O AZ Media não emite credencial nenhuma. Quem autentica é o servidor principal: ele assina o token, e o AZ Media apenas confere a assinatura com a mesma chave, sem precisar consultá-lo.