first commit

This commit is contained in:
2026-05-04 09:43:36 +01:00
commit dfae1b5335
37 changed files with 10343 additions and 0 deletions

58
docs/01-visao-geral.md Normal file
View File

@@ -0,0 +1,58 @@
# 1. Visão Geral do Projecto
## 1.1 Identificação do Problema
Em Portugal, estima-se que existam mais de 300 mil animais em canis e associações de protecção animal, enfrentando condições precárias e longos períodos de espera por adopção. A falta de uma plataforma centralizada, acessível e moderna dificulta tanto o processo de adopção como a coordenação de doações de bens essenciais como ração, brinquedos e apoio financeiro.
Os canis dependem maioritariamente de redes sociais e contacto telefónico para gerir adopções e receber doações, o que resulta em processos ineficientes, informação desactualizada e barreiras significativas para potenciais adoptantes e doadores.
---
## 1.2 A Solução — PawLink
**PawLink** é uma plataforma web que centraliza a adopção de animais e a gestão de doações para canis em todo o território português. A plataforma conecta potenciais adoptantes, doadores e canis numa interface intuitiva, segura e moderna.
**Missão:** Reduzir o número de animais em canis portugueses através da tecnologia, tornando a adopção responsável e a doação de bens o caminho mais fácil e natural.
---
## 1.3 Público-Alvo
| Segmento | Perfil | Necessidade Principal |
|---|---|---|
| Adoptante | Adulto(a) +18 anos, residente em Portugal | Encontrar animal compatível próximo da sua localidade |
| Doador | Pessoa física ou empresa | Contribuir financeiramente ou com bens para canis |
| Canil / Associação | Instituição de protecção animal | Gerir animais, reservas e doações recebidas |
| Administrador | Equipa PawLink | Supervisionar toda a plataforma e garantir qualidade |
---
## 1.4 Proposta de Valor
- **Para adoptantes:** descoberta fácil de animais por localidade, espécie, raça e características, com reserva online e confirmação por email
- **Para doadores:** fluxo simplificado de doação monetária, ração ou brinquedos, com opção de entrega em casa ou no canil
- **Para canis:** painel de gestão de animais, reservas e doações, com visibilidade das necessidades actuais
- **Para a sociedade:** redução do número de animais em canis e aumento das adopções responsáveis
---
## 1.5 Modelo de Negócio
A plataforma opera como serviço público sem fins lucrativos na fase inicial, sustentado por:
1. Percentagem simbólica (12%) sobre doações monetárias processadas para manutenção da plataforma
2. Parcerias com marcas de alimentação e acessórios para animais (patrocínios éticos)
3. Candidatura a fundos europeus de bem-estar animal e digitalização do terceiro sector
---
## 1.6 Funcionalidades Principais (Resumo)
| Área | Funcionalidade |
|---|---|
| Conta | Registo, login, recuperação de palavra-passe, verificação de idade +18 |
| Adopção | Listagem de animais, filtros, ficha do animal, reserva com email de confirmação |
| Doação | Monetária (Stripe/MBWay), ração e brinquedos com opção de recolha em casa |
| Canis | Perfil público com horários, painel de gestão privado |
| IA | Match inteligente, chatbot de suporte, recomendações personalizadas |
| UI | Modo claro/escuro, menu lateral, design mobile-first |