Documentação & Manual Técnico

Motor 100% Server-Side (PHP CLI + SQLite WAL Relacional): A aplicação corre autonomamente em background (WampServer / LiteSpeed / PHP CLI). Todos os ficheiros e a base de dados encontram-se centralizados e protegidos em webroot/data, com proteções rigorosas Anti-SSRF, CSP estrita e tokens Anti-CSRF.

⚡ 1. Arquitetura Desacoplada (Daemon CLI), SSE e Base de Dados SQLite WAL

O Drakkarious Turbo M3U Scanner separa a interface visual do processamento pesado. Todo o pipeline assíncrono corre no servidor e sincroniza através de transações atómicas em SQLite WAL, transmissão Server-Sent Events (SSE) e ficheiros de exportação em data/:

1. Motor Daemon CLI (scanner_daemon.php)

Corre autonomamente em background no servidor. Lê a fila paginada na tabela scanner_queue, executa o motor curl_multi + FFmpeg e grava o estado, os índices de desduplicação e os logs em tempo real em data/scanner_storage.sqlite (modo WAL).

2. Painel Web via SSE & Smart Resume

O navegador recebe atualizações de estado e novos logs através de uma ligação contínua Server-Sent Events (SSE) (?action=sse_state com fallback automático), reduzindo a sobrecarga HTTP. Podes fechar o browser em segurança ou retomar sessões de 500.000+ linhas sem perder o progresso.

3. Arranque Seguro proc_open & Lock Exclusivo

Ao clicar em "Iniciar Daemon CLI", o backend lança e gere os processos externos via proc_open com bypass_shell sem bloquear o servidor web, enquanto data/daemon.lock garante uma única instância ativa e tokens Anti-CSRF protegem os endpoints.

4. Side Portal Scanner & Cache Relacional SQLite

Testa até 5 User-Agents alternativos, resgata servidores offline via cache relacional diferencial (tabelas portal_verified, portal_candidates, portal_dns_cache e portal_portless) e, exclusivamente para os links válidos, consulta 8 motores de Reverse IP / Passive DNS (Shodan, AlienVault OTX, HackerTarget, RapidDNS, ThreatMiner, Mnemonic, URLScan, RIPE).

5. Validação via Xtream Player API

Consulta antecipadamente o endpoint /player_api.php para obter a data exata de expiração (exp_date) e o limite de conexões, descartando de imediato contas expiradas e preservando estatutos "ILIMITADO".

6. Captura Direta & Descodificação CUDA/NVDEC

Executa o FFmpeg no contexto isolado do PHP CLI (sem timeouts do servidor web), capturando amostras HLS/TS com proteção contra falsos-positivos e gerando miniaturas com aceleração GPU (CUDA/NVDEC/D3D11VA).

🖥️ 2. Guia de Operação no WampServer / CLI & Auto-Testes

Iniciar via Interface Web

Basta carregar um ficheiro ou colar os links e clicar em Iniciar Daemon CLI. O backend reconstrói e indexa a fila paginada em data/scanner_storage.sqlite (tabela scanner_queue), lança o processo CLI em background e entra automaticamente em modo de monitorização SSE em tempo real.

Iniciar Manualmente via Linha de Comandos (Opcional)

Se preferires acompanhar o progresso diretamente numa janela de terminal do servidor, abre a consola na pasta do projeto e executa:
php scanner_daemon.php (ou php scanner_daemon.php --help para ver as opções de linha de comandos).

Suite Integrada de Auto-Testes Unitários (Self-Test)

Para validar a integridade do motor (regras Anti-SSRF IPv4/IPv6, isolamento de porta em origens HTTP, parser M3U, desduplicação tripla, alinhamento MPEG-TS e cache SQLite), executa via CLI:
php scanner_daemon.php --self-test (ou php scanner_daemon.php -t --json) ou acede ao endpoint protegido ?action=self_test.

🎛️ 3. Guia Detalhado de Campos, Segurança e Filtros

1. Encurtamento Exclusivo em Links Válidos, APIs Externas e Segurança TLS

🚀 4. Hot-Reload, Exportação e Reprodutor Multimédia