Troubleshooting

1) "Buscando imagens..." some, mas imagens nao aparecem

Sinais

• requests de /caroulsel/media/{token}/thumb sem sucesso;
• cards ficam com skeleton por muito tempo.

Verificacoes

1. Inspecionar Network para /caroulsel/data e /caroulsel/media/*/thumb.
2. Confirmar status HTTP (200/404/422).
3. Conferir se tokens existem no payload e no cache de sessao.

Causas comuns

• mismatch de contexto sessao/usuario entre data e media;
• token expirado;
• base64 invalido para decode/resize.

2) Titulo mostra 10, mas aparecem 4

Explicacao

• titulo pode vir de configuracao (HOME_GALLERY_PHOTO_QTY);
• retorno real depende dos dados elegiveis (FOTO_HAS = 1, filtros, etc.).

Como corrigir

• alinhar limit do EntryPoint ao parametro;
• decidir se titulo deve ser:
  • quantidade real (count($itens)), ou
  • texto neutro (Ultimas fotos).

3) Skeleton sobre imagem carregada

Sinais

• imagem ja carregou, mas overlay ainda visivel.

Causas comuns

• conflito de CSS (display com !important);
• uso de v-show com estilo forcando exibicao.

Solucao aplicada

• usar v-if no skeleton por item;
• evitar display: block !important na classe base do skeleton.

4) Aparecem 10 placeholders no inicio e depois menos itens

Explicacao

• placeholders fixos antes da resposta criam expectativa errada.

Solucao de UX

• usar loader central unico na fase inicial;
• renderizar grid somente apos retorno real da API.