Skip to main content

Documentation Index

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

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

The Students (Alumnos) module lets you maintain a full registry of students. Each record stores personal and contact information, and the list is always sorted alphabetically by last name so you can locate any student at a glance. All create and update operations go through a single shared form that adapts its title and behavior based on whether a record is being created or edited.

​
Student data fields

​
nombre
string
required
Student’s first name.
​
apellido
string
required
Student’s last name. The list is sorted alphabetically by this field.
​
email
string
required
Student’s email address.
​
fechaNacimiento
string
required
Student’s date of birth in YYYY-MM-DD format, entered with a date picker.

​
How to create a student

1

Open the Students section

Navigate to the Students section of the application. The form is displayed above the student list with the title Crear Alumno.
2

Fill in all fields

Enter the student’s first name (Nombre), last name (Apellido), email (Email), and date of birth (Fecha de Nacimiento). All four fields are required.
If you submit the form with any field empty, a modal dialog will appear with the message “Todos los campos son obligatorios”. Dismiss it by clicking Cerrar and complete the missing fields.
3

Save the record

Click Guardar. The form sends a POST /alumnos request with the student data. On success, the form clears and the list refreshes with the new student inserted in alphabetical order by last name.

​
How to edit a student

Click Editar next to any student in the list. The form pre-populates with that student’s data and its title changes to Editar Alumno. Make your changes and click Guardar. The form sends a PUT /alumnos/:id request and the list refreshes.

​
Deleting a student

You cannot delete a student who has grades registered in the system. Attempting to do so will display an error modal: “El alumno tiene notas registradas en el sistema, elimínelas primero para proceder con la eliminación del alumno.” Delete all grades for the student first (see Grades), then return here to delete the student record.
Click Eliminar next to the student you want to remove. If the deletion succeeds, the list refreshes immediately. If the backend rejects the request because grades exist, the error modal is shown instead.

​
API reference

MethodEndpointDescription
GET/alumnosFetch all students. The response array is sorted client-side by apellido.
POST/alumnosCreate a new student. Body: { nombre, apellido, email, fechaNacimiento }.
PUT/alumnos/:idUpdate an existing student by ID. Body: same fields as POST.
DELETE/alumnos/:idDelete a student by ID. Returns an error if the student has associated grades.
The base URL is configured via the REACT_APP_API_URL environment variable. See Environment configuration for details.

Subjects

Manage the subjects that students are graded in.

Grades

Record and manage grade entries that link students to subjects.

Build docs developers (and LLMs) love

Get started for freeTalk to us