Donaton

Important

Plataforma de gestión de donaciones basada en una arquitectura de microservicios.

---

Descripción

Donatón es una plataforma diseñada para facilitar la gestión y distribución de donaciones, conectando usuarios, organizaciones y centros de acopio mediante una arquitectura basada en microservicios.

La solución está compuesta por:

• Un frontend desarrollado con React y TypeScript.
• Un Backend For Frontend (BFF).
• Un API Gateway para centralizar el acceso a los servicios.
• Microservicios independientes encargados de autenticación, donaciones, necesidades y logística.

---

Tecnologías

• Java 21
• Spring Boot
• Spring Cloud Gateway
• OpenFeign
• JWT
• React
• TypeScript
• Docker Compose
• Maven

---

Arquitectura

Componente	Descripción
Microservicios	Servicios principales del sistema.
BFF	Backend orientado al frontend.
Frontend	Aplicación web para usuarios y administradores.

---

Flujo General

                Frontend
                    │
                    ▼
                  BFF
                    │
                    ▼
                API Gateway
                    │
     ┌──────────────┼──────────────┼──────────────┐
     │              │              │              │
     ▼              ▼              ▼              ▼
   Auth         Donation        Logistics       Needs

Puesta en Marcha

Levantar todos los servicios

docker compose up --build

Detener los servicios

docker compose down

---

Estructura del Proyecto

.
├── frontend/
├── bff/
├── microservicios/
│   ├── auth/
│   ├── donation/
│   ├── gateway/
│   ├── logistics/
│   └── needs/
└── docker-compose.yml

---

Documentación

Cada componente dispone de su propia documentación, incluyendo:

• Descripción del servicio.
• Endpoints disponibles.
• Roles y permisos.
• Ejemplos de solicitudes y respuestas.
• Configuración y ejecución.

Tip

Consulta los README de cada componente para obtener información detallada sobre su funcionamiento.