# 11. Roadmap de Desenvolvimento

## Visão Geral das Fases

```
Fase 1 — MVP          Fase 2 — Doações      Fase 3 — IA           Fase 4 — Escala
[Meses 1–3]           [Meses 4–5]           [Meses 6–7]           [Mês 8+]
     │                     │                     │                     │
     ▼                     ▼                     ▼                     ▼
Adopção completa ──► Doações completas ──► Funcionalidades ──► App móvel
Auth + Reservas       Stripe + Ração        de IA + comunidade    Escalabilidade
Canis base            Brinquedos            Match inteligente     Internacionalização
```

---

## Fase 1 — MVP (Meses 1–3)

**Objectivo:** plataforma funcional de adopção de ponta a ponta

| Funcionalidade | Prioridade | Estimativa | Dependências |
|---|---|---|---|
| Configuração do projecto (Next.js, Prisma, Supabase, CI/CD) | Crítica | 2 dias | — |
| Esquema da base de dados + migrações iniciais | Crítica | 3 dias | Config |
| Autenticação: registo, login, recuperação de palavra-passe | Crítica | 1 semana | DB |
| Validação de idade +18 (servidor) e verificação de email | Crítica | 2 dias | Auth |
| CRUD de canis (painel de registo de canis) | Alta | 3 dias | DB, Auth |
| Upload e gestão de imagens de animais (Supabase Storage) | Alta | 2 dias | DB |
| CRUD de animais pelos canis | Crítica | 1 semana | DB, Auth |
| Página inicial com listagem de animais (SSR) | Crítica | 1 semana | DB |
| Sistema de filtros (distrito, espécie, raça, sexo, esterilizado) | Alta | 1 semana | Listagem |
| Ficha detalhada do animal com galeria | Alta | 3 dias | Listagem |
| Perfil do canil com horários de funcionamento | Alta | 3 dias | CRUD Canis |
| Sistema de reserva com calendário | Crítica | 1,5 semanas | Auth, Animals |
| Email de confirmação de reserva (react-email + Resend) | Crítica | 3 dias | Reservas |
| Área de conta: histórico de adopções e definições | Média | 4 dias | Auth |
| Menu lateral + modo escuro/claro | Média | 3 dias | — |
| Deploy inicial na Vercel + domínio petlink.pt | Alta | 1 dia | Tudo acima |
| **Total Fase 1** | | **~10 semanas** | |

---

## Fase 2 — Doações (Meses 4–5)

**Objectivo:** fluxos de doação completos com pagamentos reais

| Funcionalidade | Prioridade | Estimativa | Dependências |
|---|---|---|---|
| Integração Stripe (PaymentIntent, Payment Element) | Crítica | 1,5 semanas | Fase 1 |
| Suporte MBWay via Stripe Payment Element | Alta | 3 dias | Stripe |
| Fluxo de doação monetária (escolha de canil + pagamento) | Crítica | 1 semana | Stripe |
| Webhook Stripe (confirmação e recibo) | Crítica | 2 dias | Stripe |
| Fluxo de doação de ração (selector + logística) | Alta | 1 semana | DB |
| Fluxo de doação de brinquedos | Alta | 3 dias | Ração |
| Sistema de necessidades actuais dos canis | Alta | 3 dias | Canis |
| Email de recibo de doação | Alta | 2 dias | Resend |
| Histórico de doações na área de conta | Média | 2 dias | DB |
| Painel dos canis: ver doações recebidas | Média | 3 dias | DB |
| **Total Fase 2** | | **~7 semanas** | |

---

## Fase 3 — IA e Comunidade (Meses 6–7)

**Objectivo:** diferenciação com IA e funcionalidades de comunidade

| Funcionalidade | Prioridade | Estimativa | Dependências |
|---|---|---|---|
| Match inteligente com Claude API | Alta | 1,5 semanas | Fase 2 |
| Chatbot de suporte Paws (streaming) | Média | 1 semana | Anthropic API |
| Geração automática de descrições de animais | Média | 3 dias | Anthropic API |
| Perfis pós-adopção (utilizadores partilham actualizações) | Média | 1 semana | Fase 1 |
| Destaque de animais urgentes na homepage | Alta | 2 dias | DB |
| Sistema de notificações por email (novos animais, urgências) | Média | 1 semana | Resend |
| Registo de voluntários para canis | Baixa | 4 dias | Auth |
| Avaliações de canis por utilizadores (após adopção) | Baixa | 1 semana | Reservas |
| **Total Fase 3** | | **~7 semanas** | |

---

## Fase 4 — Escala (Mês 8+)

**Objectivo:** crescimento, optimização e expansão

| Funcionalidade | Prioridade |
|---|---|
| App móvel com React Native (partilha de lógica com a web) | Alta |
| Relatórios fiscais automáticos para doações dedutíveis em IRS | Média |
| Dashboard analítico para administração (métricas, funis, tendências) | Alta |
| API pública para integração com associações e municípios | Média |
| Suporte multilingue (espanhol e inglês) | Média |
| Campanha de adopção sazonal (Natal, Verão) com destaque especial | Média |
| Programa de parceiros (pet shops, veterinários) | Baixa |
| Expansão a Espanha e mercados ibéricos | Baixa |

---

## Critérios de Sucesso por Fase

| Fase | KPI Principal | Meta |
|---|---|---|
| Fase 1 — MVP | Reservas de adopção efectuadas | ≥ 50 no primeiro mês após lançamento |
| Fase 2 — Doações | Volume de doações processadas | ≥ 500€/mês aos 2 meses |
| Fase 3 — IA | Taxa de adopção via match inteligente | ≥ 30% das adopções com match activado |
| Fase 4 — Escala | Animais adoptados acumulados | ≥ 1.000 adopções nos primeiros 12 meses |

---

## Riscos e Mitigações

| Risco | Probabilidade | Impacto | Mitigação |
|---|---|---|---|
| Baixa adesão de canis ao registo na plataforma | Média | Alto | Onboarding simplificado + contacto directo com associações parceiras |
| Problemas de pagamento com Stripe/MBWay | Baixa | Alto | Ambiente de teste extenso antes do lançamento; fallback para transferência bancária |
| Custos da API Anthropic superiores ao previsto | Média | Médio | Rate limiting, cache de resultados, funcionalidades de IA como opt-in |
| Violação de dados (segurança) | Baixa | Alto | Auditorias de segurança periódicas, seguir OWASP Top 10, responsible disclosure program |
| Não conformidade com RGPD | Baixa | Alto | Revisão jurídica antes do lançamento, DPA com todos os processadores |