# Fontes externas

Este documento descreve as fontes consumidas em tempo de execução. Listas de
origem **nunca** são apresentadas como trabalho original deste projeto.

## 1. trackerslist

- Repositório: <https://github.com/ngosang/trackerslist>
- Licença: GPLv2 (apenas consumo de dados publicados; nenhum código GPLv2)
- Arquivos:
  - Principal: `https://raw.githubusercontent.com/ngosang/trackerslist/master/trackers_all.txt`
  - Marcador “best”: `https://raw.githubusercontent.com/ngosang/trackerslist/master/trackers_best.txt`
- Formato: uma URL por linha, frequentemente com linha em branco entre entradas
- Papel no sistema: seed de endpoints públicos; `trackers_best.txt` só marca
  `is_best_at_source`

## 2. newTrackon

- Repositório: <https://github.com/CorralPeltzer/newTrackon>
- Licença: MIT
- API:
  - Principal: `https://newtrackon.com/api/all`
  - Enrichment: `/api/stable`, `/api/live` (e rotas auxiliares se necessário)
- Formato: texto plano, URLs separadas por linhas em branco
- Papel: seed e marcadores `is_stable_at_source` / `is_live_at_source`
- Classificações da origem **não substituem** medições próprias

## 3. jokepool710/Torrent-_Trackers

- Repositório: <https://github.com/jokepool710/Torrent-_Trackers>
- Licença: MIT (© J0KEP00L, 2025)
- Arquivo consumido:
  - `https://raw.githubusercontent.com/jokepool710/Torrent-_Trackers/main/trackers_all.txt`
- Formato: uma URL por linha
- Papel: seed independente de endpoints públicos. Os arquivos por protocolo
  (`trackers_udp`, `trackers_http_https`, `trackers_ws_wss`) são subconjuntos do
  agregado e **não** são consumidos.

## 4. XIU2/TrackersListCollection

- Repositório: <https://github.com/XIU2/TrackersListCollection>
- Licença: GPL-3.0 (apenas consumo de dados publicados; nenhum código GPL-3.0)
- Arquivos:
  - Principal: `https://raw.githubusercontent.com/XIU2/TrackersListCollection/master/all.txt`
  - Marcador “best”: `https://raw.githubusercontent.com/XIU2/TrackersListCollection/master/best.txt`
- Formato: URLs separadas por linhas em branco
- Papel: seed agregado de vários upstreams; `best.txt` só marca
  `is_best_at_source`. Por ser agregador, há sobreposição esperada com as demais
  fontes — a deduplicação por URL canônica evita contagem dupla e a medição
  permanece própria e independente.

## 5. Fontes avaliadas e não adotadas

- **weibone/trackers_list** (GPL-2.0): publica o mesmo conjunto de arquivos que a
  ngosang e se comporta como espelho diário; não adiciona endpoints novos.

## 6. Distinção obrigatória

| Tipo de dado | Origem | Significado |
|---|---|---|
| Proveniência / best / stable / live | Fontes externas | Metadado de ingestão |
| Status, latência, uptime, score | Medições locais | Resultado próprio |

## 7. Política de falha

Se uma origem estiver indisponível ou retornar conteúdo inválido/vazio, os dados
anteriores são preservados. Uma resposta vazia **nunca** é interpretada como
ordem para apagar o inventário.