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 Subjects (Materias) module provides a simple catalog of courses that can be assigned grades. A subject has a single field — its name — making the form minimal and fast to use. The list is sorted alphabetically so you can scan it without scrolling through unsorted entries. Like the Students module, the form title changes between Crear Materia and Editar Materia depending on whether you are creating a new subject or modifying an existing one.

Subject data fields

nombre
string
required
Subject name. This is the only field. The list is sorted alphabetically by this value.

How to create a subject

1

Open the Subjects section

Navigate to the Subjects section of the application. The form appears above the subject list with the title Crear Materia.
2

Enter the subject name

Type the subject name into the Nombre de la materia field.
If you submit with an empty name, a modal dialog appears with the message “El nombre de la materia es obligatorio”. Click Cerrar to dismiss it, then enter a name before submitting again.
3

Save the record

Click Guardar. The form sends a POST /materias request. On success, the input clears and the list refreshes with the new subject inserted in alphabetical order.

How to edit a subject

Click Editar next to any subject in the list. The form pre-populates with the subject’s current name and the title changes to Editar Materia. Update the name and click Guardar. The form sends a PUT /materias/:id request and the list refreshes.

Deleting a subject

You cannot delete a subject that has grades registered against it. Attempting to do so displays an error modal: “La materia tiene notas registradas en el sistema, elimínelas primero para proceder con la eliminación de la materia.” Remove all related grades first (see Grades), then delete the subject.
Click Eliminar next to the subject you want to remove. If no grades reference the subject, the delete succeeds and the list refreshes. If grades exist, the error modal is displayed and the subject remains.

API reference

MethodEndpointDescription
GET/materiasFetch all subjects. The response array is sorted client-side by nombre.
POST/materiasCreate a new subject. Body: { nombre }.
PUT/materias/:idUpdate a subject’s name by ID. Body: { nombre }.
DELETE/materias/:idDelete a subject by ID. Returns an error if grades are associated with it.
The base URL is set via the REACT_APP_API_URL environment variable. See Environment configuration for details.

Students

Manage student records linked to grade entries.

Grades

Record grades that connect students and subjects.

Build docs developers (and LLMs) love