Banco Alimentos is a Spring Boot REST API that powers the operational backbone of a food bank — tracking every donation from the moment a donor submits it through confirmation, product line items, dispatch to institutions, and invoice generation. The system is secured with JWT authentication and a fine-grained, role-based permission model.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/alvarezlautaro/BancoAlimentos/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Make your first authenticated API call in minutes
API Reference
Explore all endpoints for donations, donors, products, and more
Authentication
Learn how JWT tokens and role-based permissions work
Data Model
Understand entities, relationships, and enumerations
What Banco Alimentos manages
Donations
Full lifecycle from PENDIENTE to CONFIRMADA with line items
Donors
Company donors tracked by CUIT with audit history
Products
Food catalog with 16 categories and 10 units of measure
Institutions
Recipient institutions with payment status and type filters
Remitos
Dispatch notes linking donations to institutions
Invoices
Auto-generated invoices from confirmed donations
Getting started
Run the API
Clone the repository and start the stack with Docker Compose — the API and MySQL database start together. See the Deployment guide for details.
Obtain a JWT token
Call
POST /api/auth/login with a username and password to receive a Bearer token. Default credentials are seeded on first startup.Authorize your requests
Include the token in every subsequent request:
Authorization: Bearer <token>. See Authentication overview for the full flow.Explore the API
Browse the API Reference tab to see all endpoints, request/response schemas, and required permissions.