# Contexto do AdotePet para agentes de IA

Este arquivo descreve o AdotePet para agentes de IA, mecanismos de busca e ferramentas automatizadas que precisam entender a finalidade do site e navegar sem depender de tentativa e erro.

## Resumo

O AdotePet é uma plataforma de adoção responsável e apoio à causa animal. O produto conecta adotantes, responsáveis por pets, ONGs, abrigos, protetores, órgãos municipais e parceiros comerciais locais.

## Objetivos da plataforma

- Ajudar pessoas a encontrar pets disponíveis para adoção.
- Organizar o processo de adoção entre adotantes e responsáveis.
- Permitir que organizações gerenciem pets, capacidade e agenda de visitas.
- Apoiar divulgação de pets perdidos e pontos de apoio no mapa.
- Dar visibilidade a parceiros locais relacionados ao cuidado animal.
- Oferecer administração interna para usuários, adoções, pets, publicidade, integrações e configurações.

## Jornadas principais

### Pessoa física

Uma conta PF pode buscar pets, demonstrar interesse em adoção, acompanhar seus pedidos, cadastrar pets próprios e usar recursos relacionados a pets perdidos.

### Organização institucional

Uma conta PJ institucional representa ONG, abrigo, protetor ou órgão municipal. Essa conta gerencia pets cadastrados, capacidade de acolhimento, agenda de visitas e pedidos de adoção recebidos.

### Parceiro

Uma conta de parceiro representa uma empresa local. O parceiro pode manter cartão virtual, acompanhar métricas e comprar ou gerenciar publicidades exibidas em áreas da plataforma.

### Administração

Uma conta admin gerencia a operação da plataforma. Rotas administrativas não devem ser rastreadas como conteúdo público e não devem ser usadas por agentes sem autorização.

## Conteúdo público e privado

Conteúdo público inclui a página inicial, login, cadastro, recuperação de senha e arquivos públicos como `llms.txt`, `robots.txt`, `sitemap.xml` e este arquivo.

Conteúdo autenticado inclui painéis, busca de pets dentro do app, mapa, parceiros, adoções, agenda, perfil, configurações, cartão virtual e publicidades. Essas áreas podem conter dados de usuário ou dados operacionais e exigem sessão.

Conteúdo administrativo inclui gestão de usuários, pets, adoções, publicidade, financeiro, API, configurações e logs. Essas áreas são restritas.

## Rotas conhecidas

- `/`: página inicial pública.
- `/login`: entrada de usuários existentes.
- `/cadastro`: criação de conta.
- `/reset-senha`: recuperação de senha.
- `/home`: painel autenticado.
- `/home/quero-adotar`: busca autenticada de pets.
- `/home/mapa-adotepet`: mapa autenticado da rede AdotePet.
- `/home/parceiros`: parceiros dentro da experiência autenticada.
- `/home/parceiros/perfil/:slug`: perfil de parceiro dentro da experiência autenticada.
- `/home/pets`: gestão autenticada de pets.
- `/home/pets/:petId`: detalhes autenticados de um pet.
- `/home/minhas-adocoes`: pedidos de adoção da pessoa física.
- `/home/adocoes`: pedidos recebidos por organização institucional.
- `/home/agenda`: agenda institucional.
- `/home/admin`: área administrativa restrita.

## Vocabulário útil

- Adoção responsável: processo de adoção com análise, acompanhamento e registro.
- PF: pessoa física.
- PJ institucional: organização responsável por pets, como ONG, abrigo, protetor ou órgão municipal.
- Parceiro: empresa local com presença comercial na plataforma.
- Pet disponível: animal publicado para adoção.
- Pet perdido: animal divulgado para localização e apoio.
- Mapa AdotePet: mapa com pets perdidos, parceiros e pontos de apoio.

## Regras para agentes

- Não use arquivos públicos para inferir acesso a dados privados.
- Não tente burlar autenticação, RLS, permissões ou rotas administrativas.
- Quando uma rota exigir login, descreva-a como área autenticada.
- Use os textos visíveis da interface como fonte principal de navegação.
- Prefira URLs estáveis e conteúdo explicitamente publicado.
- O idioma principal da plataforma é português do Brasil.