FPV Viewer (f95zone-tools)

Resumo

O FPV Viewer é um componente local do projeto f95zone-tools, localizado em C:\Users\Yanbd\dev\f95zone-tools. Segundo o registro de execução de 2026-08-24, sua interface foi refatorada para servir dados por HTTP e acompanhar operações de scraping de forma progressiva.

Arquitetura registrada

  • fpv_viewer.bat: ponto de entrada com validação de prĆ©-requisitos, inicialização do servidor, abertura do navegador, limpeza de cache e verificação de arquivos.
  • scripts/fpv_viewer_server.py: servidor HTTP; cuida da migração do cache SQLite, validação de payloads, cabeƧalhos anti-cache e estado inicial da interface.
  • scripts/fpv_viewer_scraper.py: coleta HTTP com pool de conexƵes, tentativas de repetição, expressƵes regulares prĆ©-compiladas e tratamento de remoƧƵes/DMCA.
  • scripts/fpv_template.html: interface e filtros; recebe progresso por Server-Sent Events (SSE).
  • scripts/fpv_viewer.py: wrapper de compatibilidade para o servidor.

DecisƵes e cuidados operacionais

  • O cache SQLite deve preservar compatibilidade com dados anteriores por meio de migração automĆ”tica.
  • HTML, JSON e SSE usam cabeƧalhos anti-cache para reduzir a exibição de estado desatualizado no navegador.
  • A coleta aceita a opção threads; seu uso deve ser limitado conforme a capacidade do destino e os termos aplicĆ”veis.
  • DetecƧƵes de remoção ou DMCA sĆ£o sinais de indisponibilidade do conteĆŗdo, nĆ£o evidĆŖncia para tentar contornar controles de acesso.

Correção de carregamento e streaming (2026-10-12)

Um registro local de manutenção relata a correção de falhas que deixavam o viewer sem filtros pré-carregados e sem cards após uma coleta geral, apesar de o scraper obter resultados.

  • O estado inicial da interface deve ser injetado antes da execução do JavaScript da aplicação; a injeção ao fim do body fazia a aplicação inicializar categorias, redes e vĆ­deos como listas vazias.
  • A rota SSE de coleta geral deve encaminhar o callback de pĆ”gina ao scraper e emitir eventos page; o frontend monta cards a partir desses eventos, nĆ£o apenas do evento final done.
  • A inicialização do servidor deve chamar o carregamento de dados persistidos para restaurar resultados e avaliaƧƵes salvos.
  • O filtro de duração precisa comparar unidades equivalentes: a duração parseada estĆ” em segundos, enquanto a entrada do usuĆ”rio representa minutos.
  • Quando o estado embutido estiver vazio, a interface deve ter fallback por REST para restaurar os dados disponĆ­veis.

Esses itens são decisões de manutenção registradas, não uma garantia de que a instalação local continua em conformidade; revalidar o repositório antes de alterações futuras.

Normalização dos filtros de estúdio e rede (2026-10-12)

Um segundo registro local de manutenção descreve a correção do caso em que combinar uma tag com a rede Adult Time retornava zero resultados, embora a coleta encontrasse vídeos correspondentes. A causa principal foi a comparação direta entre slugs selecionados pela interface e nomes exibidos pelos dados: por exemplo, adult-time não coincidia com Adult Time.

  • ComparaƧƵes de estĆŗdios, redes e performers devem normalizar os dois lados antes de testar inclusĆ£o, tratando hĆ­fens, espaƧos e capitalização de forma equivalente.
  • Redes devem manter a classificação de network, e nĆ£o ser reduzidas a site, para que seus subcanais possam ser expandidos e filtrados.
  • A coleta paginada nĆ£o deve encerrar na primeira pĆ”gina sem resultados para uma tag; deve tolerar pĆ”ginas sem correspondĆŖncias antes de concluir que nĆ£o hĆ” resultados.
  • O resultado da coleta deve ser validado tanto no scraper quanto na filtragem do navegador, pois um resultado disponĆ­vel no backend pode ser removido silenciosamente pelo cliente.

O registro cita Adult Time e seu subcanal Pure Taboo apenas como caso de teste de classificação e normalização. Não registra acesso a conteúdo, credenciais nem mecanismo de contorno de controles.

Validação registrada

O relato de execução informa que py_compile foi aplicado aos três módulos Python, o JavaScript extraído do template passou em node --check, e o servidor foi testado localmente em http://127.0.0.1:8100 com endpoints de categorias, sites, perfis e subcanais de rede. Esta nota registra o resultado relatado; ela não substitui uma nova validação no repositório quando houver manutenção.

Documentação relacionada no projeto

  • docs/fpv_viewer_audit.md
  • docs/fpv_viewer_refactor_log.md
  • docs/fpv_viewer_maintenance.md

RelaƧƵes no vault

Fontes

  • Registro local de execução do knowledge-capture, lote batch-93b44b0e937c4448bf55292dee0d7afe.json, consultado em 2026-08-24.
  • Registro local de manutenção do knowledge-capture, lote batch-b1c1f7b8f5414288a2f0f7e906ee3611.json, consultado em 2026-10-12.
  • Registro local de manutenção do knowledge-capture, lote batch-cbe8d264eb3c428696685cd8b1f42d90.json, consultado em 2026-10-12.
  • Código e documentação local referenciados em C:\Users\Yanbd\dev\f95zone-tools (devem ser revalidados antes de decisƵes futuras).
  • Using server-sent events — MDN Web Docs, consultado em 2026-08-24 — referĆŖncia para a tecnologia SSE mencionada na arquitetura.
  • sqlite3 — DB-API 2.0 interface for SQLite databases — Python documentation, consultado em 2026-08-24 — referĆŖncia para o banco local mencionado no registro.