App-Estado-Nutricional-Untels / backend-estado-nutricional

Backend estado nutricional
0 stars 0 forks source link

Controlador Informe por grupo IMC #34

Closed Jibaru closed 3 years ago

Jibaru commented 3 years ago

Genera un reporte detallado para un grupo IMC específico.

Path /api/alumnos/imc/reporte
Método GET
Descripción Devuelve un reporte para el grupo IMC especificado
Acceso Todos
Parámetros del Path -
Parámetros de consulta Obligatorio:
categoriaIMC: cadena (DELGADEZ_GRADO_III, DELGADEZ_GRADO_II,DELGADEZ_GRADO_I,NORMAL,SOBREPESO,OBESIDAD_GRADO_I,OBESIDAD_GRADO_II,OBESIDAD_GRADO_III)
mes: numero de mes (min 1, max 12)
anio: año (min: 2000)
Cuerpo de consulta -
Cabecera Token: bearer
Respuestas 200: Ok
40x: Error en la consulta
Jibaru commented 3 years ago

La respuesta debe verse así:

{
  "ok": true,
  "mensaje": "Caracteristicas por grupo IMC",
  "datos": {
    "categoriaIMC": "DELGADEZ_GRADO_III",
    "mes": 3,
    "anio": 2019,
    "totalAlumnos": 10,
    "porcentajeAlumnos": 0.2,
    "sexo": {
      "masculino": {
        "porcentaje": 0.3,
        "totalAlumnos": 3
      },
      "femenino": {
        "porcentaje": 0.7,
        "totalAlumnos": 7
      }
    },
    "estres": {
      "leve": {
        "porcentaje": 0.5,
        "totalAlumnos": 5
      },
      "moderado": {
        "porcentaje": 0,
        "totalAlumnos": 0
      },
      "severo": {
        "porcentaje": 0.5,
        "totalAlumnos": 5
      }
    },
    "rendimientoAcademico": {
      "pesimo": {
        "porcentaje": 0.1,
        "totalAlumnos": 1
      },
      "malo": {
        "porcentaje": 0.1,
        "totalAlumnos": 1
      },
      "normal": {
        "porcentaje": 0.5,
        "totalAlumnos": 5
      },
      "bueno": {
        "porcentaje": 0,
        "totalAlumnos": 0
      },
      "excelente": {
        "porcentaje": 0.3,
        "totalAlumnos": 3
      }
    },
    "edadPromedio": 18,
    "actividadFisicaPromedio": 5.1,
    "mensajeClasificacion": "El 2% de los estudiantes se encuentra clasificado en el grupo con DELGADEZ GRADO III y se caracteriza por ser 30% Masculino y 70% Femenino, edad promedio 18, horas de actividad física promedio 5.1; 50% con estrés LEVE, 0% con estrés MODERADO y 50% con estrés SEVERO; 10% con rendimiento académico PESIMO, 10% con rendimiento académico MALO, 50% con rendimiento académico NORMAL, 0% con rendimiento académico BUENO, 30% con rendimiento académico EXCELENTE; siendo un total de 10 alumnos que conforman este grupo."
  }
}
Jibaru commented 3 years ago

status: 200 respuesta:

{
    "ok": true,
    "datos": {
        "categoriaIMC": "DELGADEZ_GRADO_I",
        "mes": 11,
        "anio": 2019,
        "totalAlumnos": 1,
        "porcentajeAlumnos": 0.1,
        "edadPromedio": 23,
        "actividadFisicaPromedio": 3.0,
        "sexo": {
            "femenino": {
                "porcentaje": 1.0,
                "totalAlumnos": 1
            },
            "masculino": {
                "porcentaje": 0.0,
                "totalAlumnos": 0
            }
        },
        "estres": {
            "Severo": {
                "porcentaje": 0.0,
                "totalAlumnos": 0
            },
            "Moderado": {
                "porcentaje": 1.0,
                "totalAlumnos": 1
            },
            "Leve": {
                "porcentaje": 0.0,
                "totalAlumnos": 0
            }
        },
        "rendimientoAcademico": {
            "Malo": {
                "porcentaje": 0.0,
                "totalAlumnos": 0
            },
            "Excelente": {
                "porcentaje": 0.0,
                "totalAlumnos": 0
            },
            "Pesimo": {
                "porcentaje": 0.0,
                "totalAlumnos": 0
            },
            "Bueno": {
                "porcentaje": 1.0,
                "totalAlumnos": 1
            },
            "Normal": {
                "porcentaje": 0.0,
                "totalAlumnos": 0
            }
        },
        "mensajeClasificacion": "El 0.1% de los estudiantes se encuentra clasificado en el grupo con DELGADEZ_GRADO_I y se caracteriza por ser 0.0% Masculino y 1.0% Femenino, edad promedio 23, horas de actividad física promedio 3.0; 0.0% con estrés Severo, 1.0% con estrés Moderado, 0.0% con estrés Leve, 0.0% con rendimiento académico Malo, 0.0% con rendimiento académico Excelente, 0.0% con rendimiento académico Pesimo, 1.0% con rendimiento académico Bueno, 0.0% con rendimiento académico Normal, siendo un total de 1 que conforman este grupo"
    },
    "mensaje": "Reporte por grupo IMC mes y año"
}