# Adendo de países, regiões, climas e depósitos

O arquivo [`regioes-por-clima.csv`](regioes-por-clima.csv) é uma **fotografia datada** do jogo oficial. A [tabela interativa](regioes.html) começa com essa fotografia e tenta consultar a API **no navegador do leitor** ao abrir. Ela guarda o resultado no armazenamento local por **30 minutos**, evita uma nova tentativa por **5 minutos** e volta à fotografia incorporada se a consulta falhar. Nenhum servidor do Projeto Alexandria consulta a API em nome do leitor. Cada linha traz uma região, país original, controlador atual, clima, recursos que **podem** gerar depósitos nesse clima e, quando houver, depósito ativo com seu bônus observado e prazo. A página informa o instante e a origem dos dados exibidos.

**Como ler os bônus:** `bonus_possivel_deposito_novo_pct` é a faixa de **20% a 40%** para depósitos descobertos desde a [v0.25.5](https://warera.io/en/articles/v0-25-5-4a2c5d). Ela **não** promete que haja depósito na região. Depósitos anteriores podem conservar outro valor. `bonus_deposito_ativo_pct` é o número informado pela ficha da região no momento da coleta; vazio significa que a API não mostrava depósito ativo. Esses campos tratam **apenas do bônus de depósito**. Especialização nacional, ética partidária, recursos estratégicos e outros modificadores exigem leitura separada da empresa ou do país.

**Fontes públicas:** [`region.getRegionsObject`](https://api2.warera.io/trpc/region.getRegionsObject?input=%7B%7D), `country.getAllCountries` e [`gameConfig.getGameConfig`](https://api2.warera.io/trpc/gameConfig.getGameConfig?input=%7B%7D). O recurso elegível de cada clima vem de `items[*].isDeposit` e `items[*].climates`; o depósito ativo e seu bônus vêm da própria região. Os nomes portugueses dos itens são rótulos editoriais do manual. Países e regiões são lidos a cada execução, sem uma lista fixa de IDs.

**Imagens da tabela:** os produtos usam os PNGs do jogo guardados em `assets/produtos`; os climas usam os SVGs editoriais de `assets/icones`. As bandeiras SVG em `assets/bandeiras` vêm de [Flagpedia/FlagCDN](https://flagpedia.net/download/api), cujo conjunto se baseia em arquivos do Wikimedia Commons. O código `uk` do War Era usa a bandeira `gb` dessa coleção. Se aparecer um país novo antes de atualizar a edição, a página tenta carregar sua bandeira diretamente do CDN.

Para atualizar após uma mudança do mapa ou antes de publicar uma nova edição:

```powershell
python manual/dados/atualizar_regioes.py
```

O script substitui o CSV somente depois de obter e validar os dados, acrescenta bandeiras locais de países novos e recria `regioes.html`. **O botão de download oferece o CSV da edição**, não a consulta temporária feita pelo navegador. A atualização do manual continua editorial: mudanças de regras ou novos climas/recursos devem ser conferidos na nota oficial e nos capítulos correspondentes. Controle territorial, depósitos e percentuais podem mudar entre consultas.