# 🐾 PetLink — Documentação do Projecto

**Plataforma de Adopção e Doação Animal**  
Prova de Aptidão Profissional (PAP) — Ano Lectivo 2024/2025

---

## Índice

| # | Documento | Conteúdo |
|---|---|---|
| 01 | [Visão Geral](./01-visao-geral.md) | Problema, solução, público-alvo, proposta de valor, modelo de negócio |
| 02 | [Requisitos](./02-requisitos.md) | Requisitos funcionais e não-funcionais, restrições |
| 03 | [Arquitectura](./03-arquitectura.md) | Diagrama de arquitectura, camadas, fluxos de dados, decisões técnicas |
| 04 | [Base de Dados](./04-base-de-dados.md) | ERD, descrição das entidades, esquema Prisma completo, estratégia de indexação |
| 05 | [Fluxos de Utilizador](./05-fluxos-utilizador.md) | User stories, fluxos detalhados de adopção, doação e navegação |
| 06 | [Stack Tecnológica](./06-stack-tecnologica.md) | Todas as tecnologias com versões, funções e justificações |
| 07 | [Segurança](./07-seguranca.md) | Autenticação, autorização, RGPD, conformidade de pagamentos |
| 08 | [Inteligência Artificial](./08-ia.md) | Casos de uso, agente de match, chatbot, system prompts, mecanismos de contexto |
| 09 | [Estrutura do Projecto](./09-estrutura-projecto.md) | Árvore de directórios completa, convenções de nomenclatura |
| 10 | [Orientações de Desenvolvimento](./10-orientacoes-desenvolvimento.md) | Setup, convenções de código, Git, testes, performance, acessibilidade |
| 11 | [Roadmap](./11-roadmap.md) | 4 fases de desenvolvimento com estimativas, KPIs e gestão de riscos |
| 12 | [Glossário](./12-glossario.md) | Definição de todos os termos técnicos e acrónimos usados |

---

## Resumo Técnico

| Aspecto | Escolha |
|---|---|
| **Framework** | Next.js 14+ (App Router, SSR) |
| **Linguagem** | TypeScript 5+ |
| **Base de Dados** | PostgreSQL via Supabase + Prisma ORM |
| **Autenticação** | NextAuth.js com verificação de +18 anos |
| **Pagamentos** | Stripe (Cartão + MBWay) |
| **Email** | Resend + react-email |
| **IA** | Anthropic Claude API (match + chatbot) |
| **Hosting** | Vercel + Cloudflare CDN |
| **Estilos** | Tailwind CSS + shadcn/ui |

---

*Documentação gerada para a PAP 2024/2025*