馃

Sistema de captura del Formato 911 para Coordinaci贸n General de Vinculaci贸n y Cooperaci贸n Acad茅mica

Resumen

La SEP solicita en septiembre a todos los niveles educativos en M茅xico datos sobre su infraestructura, empleados y alumnos mediante el formato 911.

Para esto el departamento administrativo de UABC propone el proyecto911, sistema software que sistematiza y automatiza los esfuerzos de la generaci贸n de reportes del formato 911 para la Coordinaci贸n General de Vinculaci贸n y Cooperaci贸n Acad茅mica por lo que nuestros alcance ellos lo determinan.

Este proyecto se encamarca en la visi贸n universitaria:

UABC

Misi贸n y Visi贸n

Pol铆tica institucional

Cultura digital

Infraestructura, equipamiento y seguridad

Gobernanza universitaria, transparencia y rendici贸n de cuentas

Acceso

Los sistemas solo funcionan dentro de la red universitaria. En caso de que se quiera accesar desde afuera, debe usarse una VPN.

http://148.231.211.41:3001/

Enlaces de inter茅s

https://www.f911.sep.gob.mx

https://github.com/sanchezcarlosjr/proyecto911
Examples
Set plantuml:{filename} as a fence information. filename is used as the file name of generated diagrams. In the following case, md-sample-sequence.svg is created. filename is required. @startuml actor Foo1 boundary Foo2 control Foo3 entity Foo4 database Foo5 collections Foo6 Foo1 -> Foo2 : To boundary Foo1 -> Foo3 : To control Foo1 -> Foo4 : To entity Foo1 -> Foo5 : To database Foo1 -> Foo6 : To collections @enduml @startuml can be omitted.
https://sanchezcarlosjr.github.io/proyecto911/

Palabras clave

RUP, SEP, formato 911

Introducci贸n

Antecedentes

Procedimiento de captura de datos (actual):

https://portal.ucol.mx/content/micrositios/186/file/procedimientos/02_captura_911_ES.PDF

https://planeacion.uan.mx/wp-content/uploads/2021/09/Presentacion-formato-911-Nivel-Superior.pdf

https://indicadores.uabc.mx/indicadores/AcercaDe/downloadfile

https://planeacion.uan.mx/wp-content/uploads/2021/09/ESCUELA-911.9-1.pdf

https://planeacion.uan.mx/wp-content/uploads/2021/09/INFRAESTRUCTURA-911-9I-2.pdf

Estad铆stica Educativa del Formato 911. Estad铆stica de Educaci贸n Inicial, Especial, B谩sica, Media Superior, Superior y Capacitaci贸n para el Trabajo 2017-2018, (Fin de cursos)
La informaci贸n estad铆stica de los alumnos se captura por grado, sexo, Existencia y promovidos, dependiendo del nivel educativo; as铆 como discapacidades, migraci贸n, y grupos por grado.
https://www.inegi.org.mx/rnm/index.php/catalog/539

https://www.planeacion.sep.gob.mx/principalescifras/

http://www.dgei.unam.mx/hwp/metodologia/

https://dgesui.ses.sep.gob.mx/sep.subsidioentransparencia.mx/2021/subsidio-ordinario/universidad/UABC

http://transparencia.uabc.mx/Estad_e_Indic/IndicadoresCalidad/20082009/DES/DESCsDeportes.pdf

http://transparencia.uabc.mx/Estad_e_Indic/IndicadoresCalidad/2006/Programa/PrgCsEducacionHumanidades.pdf

Documentos organizacionales de gesti贸n de proyectos

Caso de proyecto organizacional (Proyectos anteriores, proyectos parecidos internos/externos/,鈥).

Plan de gesti贸n de beneficios del proyecto.

Objetivos del proyecto

Identificar una propuesta de valor para generar un Sistema de Internacionalizaci贸n 贸ptimo, que permita desarrollar m贸dulos de informaci贸n que agilicen las funciones del capital humano, reduzcan tiempos de captura y reportes institucionales.

Aunque la Oficina de Planeaci贸n y Desarrollo Institucional est谩 realizando un sistema parecido, nosotros nos concentraremos en terminar los requerimientos anteriores y cumpliremos con lo pedido para nuestro principal cliente que es la maestra Judith (v茅ase el riesgo asociadoPoca o ninguna colaboraci贸n de sistemas/departamentos inform谩ticos debido a que no somos un proyecto institucional.).

En este orden de ideas nuestro principal prop贸sito es volver funcional el dise帽o anterior y agregar nuevos requerimientos por parte del PPVC para el Coordinaci贸n General de Vinculaci贸n y Cooperaci贸n Acad茅mica.

Modelo de dominio

classDiagram
    class Modulo {
        listar(consulta)
        editar(id)
        crear()
        eliminar(id)
    }
    Modulo <-- MovilidadAcademicaDeEntrada
    Modulo <-- MovilidadAcademicaDeSalida
    Modulo <-- IntercambioEstudiantilDeSalida
    Modulo <-- IntercambioEstudiantilDeEntrada
    Modulo <-- Convenios

Requisitos

Mockups. Gu铆a de estilos gr谩ficos. Layout. Tema.

Componentes

Logo

Colores

Aqu铆 listaremos como deben ser los colores y el conjunto de componentes reutilizables.

{
    type: 'light',
    primary: {
        main: '#00723F',
    },
    secondary: {
        light: '#DD971A',
        main: '#DD971A',
        dark: '#DD971A',
        contrastText: '#fff',
    },
    error: {
        main: '#af3c0b',
    },
    warning: {
        main: '#AF870B',
    },
    info: {
        main: '#20419A',
    },
    background: {
        default: '#fcfcfe',
    }
}
typography: {
        fontFamily: '"Noto Sans", "Monserrat", Arial, sans-serif',
}

Layouts

Inicio de sesi贸n

Lista

Crear

Editar

Men煤 de usuario

An谩lisis y dise帽o

Como los m贸dulos son iguales en cuanto a funcionalidad pero no en cuanto informaci贸n presentamos un esquema genera por las funcionalidades de cada m贸dulo.

Como en general existen varios componentes y estrictamente no seguimos el paradigma orientado a objetos, mostramos la secuencia de una interacci贸n desde el usuario.

Listar

sequenceDiagram
    ModuloLista->>ModuloLista: Renderiza columnas /modulo
    ModuloLista->>ModuloIndice:  Authorization: Bearer [JWT TOKEN] /api/modulo
    ModuloIndice->>ModuloIndice: Verificar credenciales 
    ModuloIndice->>MongoDB: Listar todos los miembros del modulo
    MongoDB--)ModuloLista:  Miembros [{"id": "...", ...}, ...]

Buscar

sequenceDiagram
    ModuloLista->>ModuloLista: Renderiza columnas /modulo/?filter{q="..."}
    ModuloLista->>ModuloIndice:  Authorization: GET Bearer [JWT TOKEN] /api/modulo/?filter{q="..."}
    ModuloIndice->>ModuloIndice: Verificar credenciales 
    ModuloIndice->>MongoDB: Listar todos los miembros del modulo que cumplen q
    MongoDB--)ModuloLista:  Miembros [{"id": "...", ...}, ...]

Crear

sequenceDiagram
    ModuloCrear->>ModuloCrear: Renderiza campos /modulo/crear
    ModuloCrear->>ModuloIndice: POST Authorization: Bearer [JWT TOKEN] /api/modulo/ body={..campos}
    ModuloIndice->>ModuloIndice: Verificar credenciales 
    ModuloIndice->>MongoDB: Crear
    MongoDB--)ModuloCrear:  Mensaje de creaci贸n exitosa

Editar

sequenceDiagram
    ModuloEditar->>ModuloEditar: Renderiza campos /modulo/editar/:id
    ModuloEditar->>ModuloIndice: PUT Authorization: Bearer [JWT TOKEN] /modulo/:id body={..campos}
    ModuloIndice->>ModuloIndice: Verificar credenciales 
    ModuloIndice->>MongoDB: Edici贸n de registro :id
    MongoDB--)ModuloEditar:  Mensaje de edici贸n exitosa

Eliminaci贸n

sequenceDiagram
    BotonEliminacion->>ModuloIndice: DELETE Authorization: Bearer [JWT TOKEN] /modulo/:id
    ModuloIndice->>ModuloIndice: Verificar credenciales 
    ModuloIndice->>MongoDB: Eliminaci贸n de registro :id
    MongoDB--)ModuloEditar:  Mensaje de eliminaci贸n exitosa

Construcci贸n

Ecosistema (conjunto de tecnolog铆as, procesos, 鈥 usados)

Para instalar el proyecto debe usarse docker. En caso de que se necesite usar la CimaAPI, debe configurarse y usarse en toda interacci贸n la VPN proporcionada por la UABC.

https://sanchezcarlosjr.github.io/proyecto911/ecosistema

Flujo de trabajo

Git workflow

Nuestra pol铆tica es Git Flow.

Mantegamos lo simple:

Referencias

https://www.youtube.com/watch?v=M_3VeKPFi5U&ab_channel=CodelyTV-Redescubrelaprogramaci贸n

Pruebas

Pruebas de integraci贸n

Usando Cypress probamos la funcionalidad del sistema de manera autom谩tica.

Pruebas de aceptaci贸n

Con la Coordinaci贸n y la maestra Judith con clientes finales, probamos manualmente que el sistema cumpliera las expectativas.

Despliegue

Para este tema recomendamos leer:

Gesti贸n

Gesti贸n

Generaci贸n/NombrePeriodo de trabajoD铆as para concluir el proyecto
2022-2 Admnistraci贸n de proyectos-4

Planificaci贸n

Riesgos

Legales

Contratos

Patentes

Licencia

Confidencialidad

T茅rminos de uso

Presupuesto y costos

Sobre los miembros del equipo. Relaci贸n trabajadores y personas.

NombreTrabajador
Edgar Rodriguez AntillonSysadmin. Encargado de la infraestructura.
Omar Alonso Del Rio PeraltaL铆der del proyecto 鈥淐apa de presentaci贸n鈥 y desarrollador de la misma.
Carlo Alfredo Pano FloresDesarrollador 鈥淐apa de presentaci贸n鈥.
Francisco Javier Huerta SilvaDesarrollador de 鈥淐apa de presentaci贸n鈥.
Carlos Eduardo S谩nchez TorresL铆der del proyecto 鈥淐apa de datos y de dominio鈥, coordinador de ambos equipos y arquitecto.
Jos茅 Andr茅s Herrera HiralesDesarrollador de 鈥淐apa de de datos y de dominio鈥.
Jorge Garcia SerranoDesarrollador de 鈥淐apa de de datos y de dominio鈥.
Miguel Angel Martinez AlonsoDesarrollador de 鈥淐apa de de datos y de dominio鈥.

Gu铆as de estilo y acuerdos de equipo

La documentaci贸n se escribe en espa帽ol, se supone le铆da

Para mantener una comunicaci贸n interna fluida, usaremos el espa帽ol.

El c贸digo se escribe en ingl茅s

Para mantener el est谩ndar internacional, usaremos el ingl茅s.

Usaremos un repositorio propio: bifurcaci贸n (fork) del proyecto anterior

Porque el equipo anterior est谩 trabajando en sus propios proyectos, es dif铆cil su colaboraci贸n en la continuidad del proyecto, por lo que hemos decidido bifurcar el proyecto anterior.

https://github.com/sanchezcarlosjr/proyecto911

Nuestro proceso de desarrollo de software es RUP

El proceso de desarrollo de software que se adapta a nuestras necesidades es RUP; este fue elegido porque no tenemos todo el conjunto de suposiciones de los procesos 谩giles (reuniones todos los d铆as, un cliente disponible, control de los riesgos derivados de los miembros del equipo, los miembros del equipo no manejan pruebas automatizadas, por lo que, mucho menos TDD, ni pensar en que una arquitectura emerja sola) y algunos integrantes opinan que los 谩giles poseen demasiada vaguedad.

RUP no es Waterfall.

Comunicaci贸n

Requisitos no funcionales impl铆citos

Seguimos la gu铆a de estilos de la UABC [1].

La interfaz gr谩fica est谩 pensada en espa帽ol, aunque no se descarta la puerta para otros idiomas.

Sobre tecnolog铆as y el trabajo en equipo

Los miembros del equipo aceptan el conjunto de tecnolog铆as descritas en Ecosistema (conjunto de tecnolog铆as, procesos, 鈥 usados).

Pero de ello no se sigue que sepan usarlas.

Como advertencia para nosotros y futuros desarrolladores del proyecto, est谩 documentaci贸n no pretende ser un tutorial o explicaci贸n de sistemas o librer铆as externas o subyacentes, suponemos la especializaci贸n y el aprendizaje individual como eje central m谩s que el logro del proyecto, por manifestarse en un contexto educativo y no productivo.

En un trabajo 芦real禄, los requisitos y el proceso de contrataci贸n son una barrera de entrada en cu谩nto a las habilidades en tecnolog铆as y conocimientos, adem谩s suelen filtrar a futuros compa帽eros problem谩ticos: t煤 y tus compa帽eros no cuentan con estas condiciones, por lo que es un gran riesgo para el proyecto, de esto se sigue el aumento de la probabilidad de no entrega.

Advertencia para futuros desarrolladores o equipos

En la medida de la posible usa estos documentos y nuestro esquema de trabajo.

隆No dudes en pedir los permisos para continuar el proyecto!

Glosario y abreviaturas

SEP. Secretar铆a de educaci贸n p煤blica. https://www.gob.mx/sep

Manual de usuario

https://docs.google.com/document/d/1fBOpZWyohavjpiooqlXq7T-Wbbmm-m9d_7z7UfN5SM8/edit

Minutas

Drive con grabaciones y otros documentos.

https://drive.google.com/drive/folders/1VeyB60mcBGjmFAQ3Dpc_BIisJiWXkoBM?usp=sharing

Referencias

[1] http://iide.ens.uabc.mx/documentos/academicos/normatividad/manual_de_identidad_grafica_UABC_etapa_1.pdf