Adecuación Curricular

Documentación detallada del módulo de Adecuaciones Curriculares para la gestión de adecuaciones dentro de contenidos de planificación en RedCollege.

Introducción

El módulo AdecuacionCurricularModule proporciona métodos para gestionar adecuaciones curriculares asociadas a contenidos dentro de las planificaciones educativas en el sistema RedCollege. Estas adecuaciones permiten personalizar el currículo para estudiantes con necesidades educativas especiales, adaptando objetivos, actividades y evaluaciones.

Métodos

obtenerAdecuacionesPorUnidad

Obtiene todas las adecuaciones curriculares asociadas a una unidad específica, con soporte para paginación y filtros.

Parámetros:

NombreTipoDescripciónRequerido
unidadIdnumberID de la unidad
pagenumberNúmero de página para paginaciónNo
nombrestringFiltro por nombre de estudianteNo
asignaturastringFiltro por asignaturaNo

Retorna:

  • Promise con un objeto IAdecuacionCurricularPaginated que contiene metadatos de paginación y un arreglo de adecuaciones

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const adecuaciones = await planificaciones.adecuacionCurricular.obtenerAdecuacionesPorUnidad(
  456,
  1,
  'Juan',
  'Matemáticas'
)

obtenerAdecuacionesPorContenidoId

Obtiene todas las adecuaciones curriculares asociadas a un contenido específico.

Parámetros:

NombreTipoDescripciónRequerido
idnumberID del contenido

Retorna:

  • Promise con un array de objetos IAdecuacionCurricular

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const adecuaciones = await planificaciones.adecuacionCurricular.obtenerAdecuacionesPorContenidoId(789)

obtenerAdecuacionPorId

Obtiene una adecuación curricular específica por su ID.

Parámetros:

NombreTipoDescripciónRequerido
idnumberID de la adecuación curricular

Retorna:

  • Promise con un objeto IAdecuacionCurricular con los detalles de la adecuación

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const adecuacion = await planificaciones.adecuacionCurricular.obtenerAdecuacionPorId(101)

crearNuevaAdecuacion

Crea una nueva adecuación curricular.

Parámetros:

NombreTipoDescripciónRequerido
dataIAdecuacionCurricularDatos de la adecuación a crear

Retorna:

  • Promise con un objeto IAdecuacionCurricular de la adecuación creada

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const nuevaAdecuacion = await planificaciones.adecuacionCurricular.crearNuevaAdecuacion({
  contenidoId: 789,
  actividad: 'Actividad adaptada para estudiantes con dificultades visuales',
  fechaInicio: luxon.DateTime.now(),
  fechaFin: luxon.DateTime.now().plus({ days: 7 }),
  estudiantes: [123, 124],
  asignaturas: [456],
  itemsCurriculares: []
  // Otros campos necesarios según la interfaz IAdecuacionCurricular
})

actualizarAdecuacion

Actualiza una adecuación curricular existente.

Parámetros:

NombreTipoDescripciónRequerido
idnumberID de la adecuación a actualizar
dataPartialDatos parciales para actualizar

Retorna:

  • Promise con un objeto IAdecuacionCurricular con los datos actualizados

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const adecuacionActualizada = await planificaciones.adecuacionCurricular.actualizarAdecuacion(
  101,
  {
    actividad: 'Actividad adaptada y revisada para estudiantes con dificultades visuales',
    fechaFin: luxon.DateTime.now().plus({ days: 10 }),
    estudiantes: [123, 124, 125]
  }
)

eliminarAdecuacion

Elimina una adecuación curricular existente.

Parámetros:

NombreTipoDescripciónRequerido
idnumberID de la adecuación a eliminar

Retorna:

  • Promise con un objeto IAdecuacionCurricular de la adecuación eliminada

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const adecuacionEliminada = await planificaciones.adecuacionCurricular.eliminarAdecuacion(101)

Consideraciones importantes

  • La mayoría de los métodos requieren autenticación previa en el sistema.
  • Las adecuaciones curriculares están asociadas a contenidos específicos dentro de una unidad.
  • Las fechas deben proporcionarse como objetos DateTime de Luxon en el formato adecuado.
  • Al crear o actualizar adecuaciones, se pueden especificar estudiantes y asignaturas mediante arrays de IDs.
  • Las adecuaciones pueden incluir ajustes a ítems curriculares específicos para personalizar el aprendizaje.

Errores comunes

  • 404 Not Found: La adecuación o recurso solicitado no existe
  • 403 Forbidden: El usuario no tiene permisos para acceder o modificar la adecuación
  • 400 Bad Request: Datos enviados incorrectos o incompletos
  • 500 Internal Server Error: Error en el servidor, intentar más tarde

Interfaces relacionadas

Las principales interfaces utilizadas por este módulo son:

  • IAdecuacionCurricular: Representa una adecuación curricular completa con todas sus relaciones
    • id: Identificador único de la adecuación
    • contenidoId: ID del contenido asociado
    • actividad: Descripción de la actividad adaptada
    • fechaInicio: Fecha de inicio de la adecuación
    • fechaFin: Fecha de finalización de la adecuación
    • createdAt: Fecha de creación
    • updatedAt: Fecha de última actualización
    • deletedAt: Fecha de eliminación (si aplica)
    • deletedBy: ID del usuario que eliminó la adecuación (si aplica)
    • asignaturas: Array de asignaturas relacionadas
    • estudiantes: Array de estudiantes a los que aplica la adecuación
    • contenido: Contenido al que está asociada la adecuación
    • itemsCurriculares: Ítems curriculares que han sido adaptados
  • IAdecuacionCurricularForm: Formato para crear o actualizar adecuaciones
  • IAdecuacionCurricularPaginated: Respuesta paginada de adecuaciones curriculares