Assets V2
Arquitetura e fluxo
Componentes reais do assets-handler na criação e verificação de assets
Fluxo resumido
- Cliente envia
POST {{BASE_URL}}/assets/createcomurle flagsneed*. - A URL é validada e sanitizada (
url-sanitizer). - Se
needCheckExisting, o repositório tenta localizar asset pela URL (findByUrlinterno). - Se
needCheckUrl, roda MediaHealthChecker (HEAD / range, cache). - createAsset no repositório classifica o tipo de URL (MinIO, Kutt, externa) e grava em
public.assets. - Opcionalmente Kutt cria
short_url; opcionalmente descrição de mídia via helpers e fila RabbitMQ quando configurado. - Resposta JSON com
created/alreadyExists/data(ehealthCheckse aplicável).
Componentes principais
- PostgreSQL (
public.assets) - Encurtador Kutt (variável
TOLKY_KUTT_API_KEY) - Armazenamento MinIO quando uploads/cópias são usados pelos fluxos de serviço
- RabbitMQ para filas opcionais (
queueMode, consumer de inserção quando habilitado) - MediaHealthChecker para checagem de links
Integrações como análise LLM de mídia são acopladas via needMediaDescription e workers; não há dependência de um arquivo mediaAnalysisV3.js neste microserviço.