MyBuddy 🐾

O HUB completo do ecossistema pet local

MyBuddy é uma plataforma web que centraliza adoção, serviços, eventos e marketplace pet em um único lugar - conectando adotantes, ONGs, protetores, pet shops e clínicas veterinárias.

---

O Problema que Resolvemos

ONGs e protetores lutam por visibilidade em redes sociais desordenadas. Adotantes se perdem em buscas ineficientes. Tutores não encontram serviços locais confiáveis. O MyBuddy conecta todas essas pontas em um único ecossistema.

---

Funcionalidades

Módulo	Descrição
🐶 Portal de Adoção	Vitrine de animais com perfis detalhados e filtros por espécie, porte e localização
📅 Feiras de Adoção	Cadastro e divulgação de eventos locais por ONGs e protetores
🗺️ Guia de Serviços	Diretório geolocalizado de pet shops e clínicas veterinárias
🏪 Marketplace	Compra e venda de produtos e serviços pet com pagamento integrado
💰 Doações	Canal direto de apoio financeiro para ONGs e protetores cadastrados
🔐 Autenticação	Login federado via Keycloak com perfis para adotante, ONG e pet shop

---

Setup do Ambiente

Pré-requisitos

• Docker e Docker Compose instalados
• Portas disponíveis: 80, 8080, 8081, 5432, 27017

Subindo o ambiente completo

# 1. Clone o repositório
git clone https://github.com/EderHenriq/MyBuddy.git
cd MyBuddy

# 2. Configure as variáveis de ambiente
cp .env.example .env
# Edite o .env com suas configurações

# 3. Suba todos os serviços
docker compose up --build

Aguarde todos os containers ficarem (healthy). A ordem de subida é garantida automaticamente:

PostgreSQL + MongoDB → Keycloak → Backend → Frontend

Serviços disponíveis

Serviço	URL
Frontend Angular	http://localhost
Backend API	http://localhost:8081
Keycloak Admin	http://localhost:8080
Health Check	http://localhost:8081/actuator/health

Comandos úteis

# Ver status dos containers
docker compose ps

# Ver logs de um serviço
docker logs mybuddy-backend --tail 50

# Parar todos os serviços
docker compose down

# Parar e remover volumes (reset completo)
docker compose down -v

Observações

• O realm mybuddy do Keycloak é importado automaticamente na primeira subida via docker/keycloak/realm-export.json
• O banco keycloak é criado automaticamente via docker/init-db.sql
• Dados do PostgreSQL e MongoDB persistem entre reinicializações via volumes Docker

---

Stack Tecnológica

Backend

Banco de Dados

Frontend Web

Mobile

Pagamentos & Infra

MongoDB é o banco principal da plataforma (adoção, usuários, eventos, serviços). PostgreSQL é utilizado especificamente no módulo Marketplace, dado o modelo relacional de produtos, pedidos e transações financeiras.

---

Estrutura do Repositório

MyBuddy/
├── backend/                 # Java 21 + Spring Boot 3 + Keycloak + Maven
├── frontend/                # Angular 21 (SSR)
├── mobile/                  # Flutter 3.41+
├── legacy-web/              # Frontend legado HTML/CSS/JS
├── docs/
│   ├── academico/           # Documentação acadêmica
│   └── tecnico/             # Documentação técnica e roadmap
├── docker/                  # Configurações Docker
├── .github/                 # CI/CD, templates
└── docker-compose.yml       # Ambiente completo

---

👥 Time

Nome	RA
Eder Henrique Pontes	24534211-2
Julia Cardoso	24503170-2
Davi Cassoli Lira	24042075-2
Daniel Godinho	24383624-2

Projeto de Software — UniCesumar, Maringá-PR, 2026.

---