Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JuanSebax85/backend-prueba-fullstack/llms.txt

Use this file to discover all available pages before exploring further.

Backend Prueba Fullstack is a RESTful API built with Spring Boot 3 and PostgreSQL that provides full CRUD management for an academic domain — students (alumnos), subjects (materias), and grades (notas). The service runs entirely within Docker, requiring no local Java or database installation to get started.

Quickstart

Get the API running locally in minutes using Docker Compose

API Reference

Explore all endpoints for students, subjects, and grades

Configuration

Learn how to configure environment variables and database settings

Docker Guide

Understand the Docker setup, services, and deployment workflow

What this API provides

The API exposes three resources with full create, read, update, and delete operations:
  • Alumnos — Student records with name, email, and date of birth
  • Materias — Academic subjects with a name, code, and credit count
  • Notas — Grade entries linking a student to a subject with a numeric value

Students

GET /alumnos · POST /alumnos · PUT /alumnos/{id} · DELETE /alumnos/{id}

Subjects

GET /materias · POST /materias · PUT /materias/{id} · DELETE /materias/{id}

Grades

GET /notas · POST /notas · PUT /notas/{id} · DELETE /notas/{id}

Getting started

1

Clone the repository

git clone https://github.com/JuanSebax85/backend-prueba-fullstack.git
cd backend-prueba-fullstack
2

Start the database

docker compose up -d db
3

Restore the database backup

docker cp backup.dump postgres_db:/backup.dump
docker exec -it postgres_db psql -U postgres -d prueba -f /backup.dump
4

Start the backend

docker compose up --build backend
The API is now available at http://localhost:8080.
The API listens on port 8080 by default. See the Quickstart for a full walkthrough including your first API calls.

Build docs developers (and LLMs) love