Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Luisanchez0/modulo_Horario/llms.txt

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

Teachers (docentes) are the central resource in Módulo Horario. Every schedule entry ties one teacher to a subject, a classroom, and a time slot. Getting teacher records set up correctly — especially their shift and availability — directly affects the quality of the schedules the generator produces.

​
Teacher fields

When creating or editing a teacher, the following fields are available:
FieldRequiredDescription
nombreYesFull name of the teacher, displayed throughout the schedule views.
correoYesEmail address used for login. Must be unique across all teachers.
passwordYes (on create)Login password. Optional when editing an existing teacher.
roleYesEither DOCENTE (read-only access) or ADMIN (full management access).
turnoYesShift preference: MATUTINO (07:00–14:00), VESPERTINO (15:00–22:00), or AMBOS.
matriculaNoOptional staff ID or employee number.
estadoYesWhether the teacher account is active (Activo) or inactive (Inactivo).
Each teacher’s email (correo) must be unique. Attempting to create a second teacher with the same email address returns a validation error.

​
Roles explained

Módulo Horario has two roles:

DOCENTE

Can view the schedule calendar and filter entries by teacher, subject, classroom, or period. Cannot create, edit, or delete any records.

ADMIN

Full access to create, edit, and delete teachers, subjects, classrooms, periods, and schedule entries. Required to trigger automatic generation.

​
Creating a teacher from the UI

1

Navigate to the Docentes page

Open the Docentes section from the main menu. You must be logged in as ADMIN to see the creation form.
2

Fill in the teacher details

Enter the teacher’s name, email, and password. Select their role and shift from the dropdowns. Optionally provide a matricula.
3

Click Crear docente

The new teacher appears immediately in the teachers table. Their email and shift are shown alongside their name.

​
Editing a teacher

Click Editar next to any teacher in the table. The form pre-fills with the teacher’s current data. The password field is optional during edits — leave it blank to keep the existing password. Click Actualizar to save changes.

​
Deleting a teacher

Click Eliminar next to the teacher you want to remove. A confirmation modal appears before the record is deleted.

​
Setting teacher availability

Availability blocks define the days and time windows when a teacher can be scheduled. The generator reads these blocks and only places the teacher in slots that fall within them.
1

Identify the teacher's available days and times

Decide which days and hours the teacher can teach. For example: Monday 08:00–12:00 and Wednesday 08:00–12:00.
2

Create availability blocks via the API

Post each block to the availability endpoint, providing the teacher’s ID, day, and time window:
curl -X POST http://localhost:8004/disponibilidades \
  -H "Content-Type: application/json" \
  -d '{
    "docente_id": 1,
    "dia": "LUNES",
    "hora_inicio": "08:00",
    "hora_fin": "12:00"
  }'
Repeat this for each available day.
3

Verify the blocks are saved

Retrieve the availability for a teacher to confirm the blocks were saved:
curl http://localhost:8004/disponibilidades/docente/1
Set each teacher’s shift (turno) before generating schedules. If a teacher is MATUTINO but their availability blocks span afternoon hours, the generator will still enforce the morning-only constraint and may leave some subjects unassigned. Aligning the shift and availability blocks avoids this.

​
Default availability behavior

If a teacher has no availability blocks configured, the generator treats them as available for the entire requested workday on all selected days. This is a convenient fallback for initial setup, but explicit availability blocks give you more control over the output.

Build docs developers (and LLMs) love

Get started for freeTalk to us