💙 Donation API

RESTful API for donation management, built with Spring Boot, applying layered architecture, DTO pattern, validation, and database persistence.

Features

• Create donation
• List donations
• Filter by type
• Update status
• Delete donation

Technologies

• Java 21
• Spring Boot
• Spring Data JPA
• PostgreSQL
• Maven

Architecture

The project follows a layered architecture:

Responsibilities:

• Controller
  • Handles HTTP requests/responses
• Service
  • Business rules and validations
• Repository
  • Database access using Spring Data JPA
• DTO
  • Controls data input/output

API Endpoints

Create Donation

POST /api/doacoes

Body: { "donorName": "José", "type": "FOODS", "value": 100 }

Get All Donations

GET /api/doacoes

Filter by Type

GET /api/doacoes?type=FOODS

Update Status

PUT /api/doacoes/{id}/status?status=RECEIVED

Delete Donation

DELETE /api/doacoes/{id}

Example Response

{ "id": "123", "donorName": "José", "value": 100, "type": "FOODS", "status": "PENDING", "date": "2026-04-29" }

How to Run

git clone ...
cd donation-api
mvn spring-boot:run

AUTHOR

José Maria