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 Grades (Notas) module ties students and subjects together with a numeric score. Rather than asking you to type IDs, the form fetches the full lists of students and subjects from the API on load and presents them as dropdown menus. Students appear sorted alphabetically by last name so you can find the right person quickly. There is no deletion guard on grades — you can remove any entry directly, which also unblocks the deletion of the related student or subject.

​
Grade data fields

​
alumnoId
number
required
ID of the student. Selected from a dropdown populated by GET /alumnos, sorted by apellido.
​
materiaId
number
required
ID of the subject. Selected from a dropdown populated by GET /materias.
​
valor
number
required
Numeric grade value. The input uses step="0.1", allowing decimal scores such as 7.5 or 10.0.

​
How to record a grade

1

Open the Grades section

Navigate to the Grades section. On mount, the form fetches /alumnos and /materias to populate the two dropdowns. Wait for both dropdowns to load before submitting.
2

Select a student

Choose a student from the Seleccionar alumno dropdown. Students are listed as “Apellido Nombre”, sorted alphabetically by last name.
3

Select a subject

Choose a subject from the Seleccionar materia dropdown.
4

Enter the grade value

Type a numeric value in the Nota field. Decimal values with one decimal place are supported (e.g., 8.5).
5

Save the grade

Click Guardar Nota. The form submits the payload below and the list refreshes on success.

​
Request payload

The form does not send flat IDs. It wraps the student and subject references in nested objects to match the backend’s expected structure: 
{
  "id": null,
  "valor": 8.5,
  "alumno": {
    "id": 3
  },
  "materia": {
    "id": 1
  }
}
When editing an existing grade, id contains the grade’s numeric identifier. When creating a new grade, id is null.

​
How to edit a grade

Click Editar next to any grade in the list. The form pre-populates the student dropdown, subject dropdown, and valor field with the existing values. Update the fields you want to change and click Guardar Nota. The form sends a PUT /notas/:id request with the same nested payload structure shown above.

​
Deleting a grade

Click Eliminar next to the grade you want to remove. The delete is immediate — there is no confirmation dialog or guard. The form sends a DELETE /notas/:id request and the list refreshes on success.
Deleting a grade is the required first step before you can delete the student or subject it references. See Students and Subjects for details on their deletion guards.

​
API reference

MethodEndpointDescription
GET/notasFetch all grades. The response is sorted client-side by alumnoApellido.
POST/notasCreate a new grade. Body: nested payload with alumno.id, materia.id, and valor.
PUT/notas/:idUpdate an existing grade by ID. Body: same nested payload including the grade id.
DELETE/notas/:idDelete a grade by ID. No guard — succeeds unconditionally.
The base URL is configured via the REACT_APP_API_URL environment variable. See Environment configuration for details.

Students

Manage the student records referenced by grade entries.

Subjects

Manage the subjects that grades are recorded against.

Build docs developers (and LLMs) love

Get started for freeTalk to us