★ README ★ | Desafio | O que é Pokémon | Arquitetura | Banco de Dados | Instalação

Sobre o PokéApp

Este é um case de desafio técnico desenvolvido para o processo seletivo da ipe.digital, para a vaga de Laravel Pleno.

Objetivo

Demonstrar domínio do Laravel + Blade, consumindo uma API pública do PokéAPI, oferecendo um administrador básico com três perfis de acesso e funcionalidades:

• Viewer: Apenas visualiza dados já importados da PokéAPI.
• Editor: Importa, sincroniza e favorita Pokémons da PokéAPI.
• Admin: Gerencia os usuários, permissões, registros e também favorita Pokémons da PokéAPI.

API pública PokéAPI

Se trata de um banco de dados técnico e gratuito que centraliza praticamente todas as informações da franquia Pokémon. Será usada como fonte de informações para importação e sincronização com nossa base de dados.

Link da documentação: https://pokeapi.co/docs/v2

Instalando o Projeto

Este projeto utiliza Docker Compose para execução local e deploy.

• Pré-requisitos: OrbStack ou Docker Desktop, Git, Node e NPM

1. Clone o repositório em uma pasta vazia

git clone https://github.com/anarkaike/pokeapi-app-junio.git .

2. Setup Automatizado

Limpe todos os caches, gere a chave, link storage, rode todas as migrations e seeds, execute a instalação do npm e compilação do vite com um único comando:

npm run docker:dev:install

Após os passos, acesse http://localhost

Para mais detalhes, ver documentação detalhada da instalação.

Para produção, utilize o docker-compose.prod.yaml, configure corretamente as variáveis de ambiente no seu servidor.

Credenciais de Acesso

Ao instalar o projeto, utilize as credenciais abaixo para logar em cada um dos perfíls de acesso.

PERFIL	EMAIL	SENHA	PERMISSÕES
Admin	[email protected]	Senh@123	Acesso Total
Editor	[email protected]	Senh@123	Importações, sincronizações e favoritar
Viewer	[email protected]	Senh@123	Somente leitura

Principais Definições Técnicas do Desafio

• Cache: Implementado via Redis para evitar rate-limit da PokéAPI.
• Segurança: Uso de Laravel Policies para isolamento de ações por perfil.
• Jobs/Commands: Sincronização em background para não travar a UI.

Documentação

Navegue pela documentação, para mais detalhes:

• Requisitos do Desafio
• O que é Pokémon?
• Arquitetura e Camada de Service
• Modelagem do Banco de Dados
• Instalação detalhada

Telas do Sistema

Início

Login

Cadastro

Pokémons

Usuários

Meu Perfil

Licença

Esta aplicação de desafio é um software de código aberto licenciado sob a licença MIT.

---

★ README ★ | Desafio | O que é Pokémon | Arquitetura | Banco de Dados | Instalação