Documentation Index
Fetch the complete documentation index at: https://mintlify.com/andrespaul123/micole-flutter/llms.txt
Use this file to discover all available pages before exploring further.
The agenda feature lets teachers post structured items — tarea (homework), examen (exam), or any custom type — for a specific class assignment. Each agenda item can carry a description, a due date, and one or more attached files. Teachers can also inspect which students have submitted work and review each submission in detail.
Data Models
Agenda
Represents a single agenda item posted to a class.
| Field | Type | Description |
|---|
id | int? | Unique identifier |
titulo | String | Title of the agenda item |
descripcion | String? | Optional detailed description |
tipo | String | Category: tarea, examen, or other value |
fechaEntrega | String? | ISO-8601 due date (fecha_entrega in JSON) |
materia | String? | Subject name (read-only, returned by API) |
profesor | String? | Teacher name (read-only, returned by API) |
curso | String? | Course name (read-only, returned by API) |
paralelo | String? | Section name (read-only, returned by API) |
archivos | List<AgendaArchivo> | Attached files |
AgendaArchivo
Represents a file attached to an agenda item.
| Field | Type | Description |
|---|
id | int? | Unique identifier |
nombreOriginal | String | Original filename (nombre_original in JSON) |
url | String | Fully-resolved download URL |
EntregasResponse
Top-level wrapper returned when fetching student submissions for an agenda item.
| Field | Type | Description |
|---|
tipo | String | Agenda item type (mirrors Agenda.tipo) |
titulo | String | Agenda item title |
entregas | List<EntregaEstudiante> | Per-student submission summary |
EntregaEstudiante inside the list contains:
| Field | Type | Description |
|---|
estudianteId | int | Student ID |
nombre | String | Student full name |
codigo | String? | Student code |
estado | String | entregado or pendiente |
entregaId | int? | Submission ID (present only when estado == "entregado") |
fechaEntrega | String? | Submission timestamp |
EntregaDetalleProfesor
Full submission detail as seen by the teacher, including attached files.
| Field | Type | Description |
|---|
id | int | Submission ID |
estudianteId | int | Student ID |
nombreEstudiante | String | Student full name |
codigoEstudiante | String? | Student code |
comentario | String? | Comment left by the student |
estado | String | entregado or pendiente |
fechaEntrega | String? | Submission timestamp |
archivos | List<ArchivoEntrega> | Files uploaded by the student |
ArchivoEntrega has id, nombreOriginal, and url.
API Reference — AgendaRepository
List agenda items
Future<List<Agenda>> getAgenda({
required int periodoId,
required int asignacionId,
})
/periodos/:periodoId/asignaciones/:asignacionId/agenda
Returns all agenda items for the class within the given period.
Get a single agenda item
Future<Agenda> getAgendaDetalle(int id)
/agenda/:id
Returns full detail for one agenda item, including its archivos list.
Create an agenda item
Future<Agenda> crearAgenda({
required int periodoId,
required int asignacionId,
required String titulo,
required String descripcion,
required String tipo,
String? fechaEntrega,
})
/periodos/:periodoId/asignaciones/:asignacionId/agenda
Request body:
{
"titulo": "Ejercicios de álgebra",
"descripcion": "Resolver los ejercicios del capítulo 3",
"tipo": "tarea",
"fecha_entrega": "2025-02-28"
}
Agenda object (inside a data wrapper from the server).
Update an agenda item
Future<void> actualizarAgenda({
required int agendaId,
required String titulo,
required String descripcion,
required String tipo,
String? fechaEntrega,
})
/agenda/:agendaId
Same body shape as crearAgenda.
Delete an agenda item
Future<void> eliminarAgenda(int agendaId)
/agenda/:agendaId
Upload files to an agenda item
Future<void> subirArchivos({
required int agendaId,
required List<PlatformFile> archivos,
})
/agenda/:agendaId/subir-archivo — multipart/form-data
Each file is sent as a archivos[] field. Multiple files can be uploaded in a single request.
File selection uses the file_picker Flutter package. The picked PlatformFile.bytes are read directly into memory and sent as MultipartFile.fromBytes, so no temporary path on disk is required. This works on both web and mobile targets.
Delete an attached file
Future<void> eliminarArchivo(int archivoId)
/agenda-archivos/:archivoId
Replace an attached file
Future<void> reemplazarArchivo({
required int archivoId,
required PlatformFile archivo,
})
/agenda-archivos/:archivoId/reemplazar — multipart/form-data
Sends the new file in a single archivo field. The server swaps the stored file in place while keeping the same archivoId.
Get student submissions for an item
Future<EntregasResponse> getEntregas(int agendaId)
/agenda/:agendaId/entregas
Returns an EntregasResponse with the full student list and their submission status for that agenda item.
Get full detail of a single submission
Future<EntregaDetalleProfesor> getDetalleEntrega(int entregaId)
/entregas/:entregaId
Returns the teacher’s detailed view of one student submission, including any files the student uploaded.
Routes
| Route | Description |
|---|
/mis-clases/:periodoId/:cursoId/:paraleloId/:asignacionId/agendas | List of all agenda items for the class |
/mis-clases/:periodoId/:cursoId/:paraleloId/:asignacionId/agendas/create | Form to create a new agenda item |
/mis-clases/:periodoId/:cursoId/:paraleloId/:asignacionId/agendas/:agendaId | Detail view for a single agenda item |
/agendas/:agendaId/entregas | Submission tracker for a specific agenda item |
/agendas/:agendaId/entregas/:entregaId | Teacher’s detailed view of a single student submission |
