feat: Implementação da Pokédex (Service Layer + UX Otimizado)

[allbertuu]

📝 Resumo do Pull Request

Este PR entrega a solução completa para o desafio da Pokédex, focando em uma arquitetura desacoplada e na experiência do usuário final. A implementação prioriza a separação de responsabilidades (Service Layer vs. UI) e a escalabilidade do código.

Nota sobre a Documentação: O README.md foi elaborado não apenas como uma especificação técnica, mas como um guia de Onboarding. O objetivo foi eliminar o esforço cognitivo da avaliação, melhorando a Reviewer Experience (RX). Acredito que comunicar o código é tão importante quanto escrevê-lo.

🏗️ Arquitetura e Decisões Técnicas

• Service Layer (src/services): Isolei a comunicação com a API e regras de negócio para garantir que a interface (View) não dependa diretamente da fonte de dados (Model).
• Smart Hooks + Context: A lógica de estado (loading, erros, filtros) foi abstraída em hooks customizados, deixando os componentes visuais focados apenas em renderização.
• UX Proativa: Tratamento de erros 404 como estados de interface (não falhas sistêmicas) e feedback visual imediato para o usuário.

🧠 Contexto e Filosofia de Desenvolvimento

Tratei este projeto como um curso do começo ao fim, e eu nunca, repito, nunca me arrependi de quando faço assim. Isso me permitiu explorar novos padrões que elevaram a complexidade e a qualidade da entrega. Ah, e foi feito com a organização e o pensamento sistêmico que aplico no meu dia a dia, ok?

Disclaimer Importante:
Reconheço que "Código Limpo" não é um ato individual, mas o resultado de uma cultura de revisão e refatoração constante. Um bom código é sobre o impacto na equipe. Por isso, embora este seja um teste, peço e valorizo feedbacks sinceros sobre o que pode ser melhorado. Por favor, eu adoraria ouvir!!

💡 Sugestão de Melhoria para o Repositório

Durante o desenvolvimento, notei que poderíamos beneficiar futuros candidatos ou colaboradores adicionando um arquivo CONTRIBUTING.md para padronizar a criação de PRs e diretrizes de commit.

✅ Checklist de Entrega

• Consumo de API com tipagem forte (TypeScript/Pokenode-ts)
• Roteamento e Navegação (TanStack Router)
• Tratamento de Erros e Feedback Visual
• Testes Unitários (Vitest)
• Documentação focada em DX/RX

---

Feito com carinho ❤️