Home
🌟 Bienvenido/a a la Wiki Oficial de SISINFO
Este repositorio centraliza toda la documentación técnica y funcional del sistema de gestión académica.
- 📖 Resumen del Proyecto
- 💻 Tecnologías principales
- 🎯 Requisitos y Alcance
- 🧱 Arquitectura del Sistema
- 🎨 UI/UX y Diseño Visual
- 🔐 Autenticación y Roles
- 🧩 Estructura del Proyecto
- 🔌 API y Backend
- 🧪 Pruebas y Calidad
- ⚙️ Instalación y Despliegue
- 📊 Métricas y Cobertura
- 📚 Bibliografía y Referencias
SISINFO es una aplicación web moderna para la gestión académica en el Departamento de Ingeniería de Sistemas. Permite a usuarios administrativos y académicos realizar gestiones como:
- Aplicaciones a tesis de grado
- Gestión de asistencias graduadas
- Publicación de ofertas de salones
- Visualización y administración de proyectos
- Frontend: Next.js, shadcn, Tailwind CSS, Zustand, TanStack Query
- Backend: NestJS, TypeORM, Docker
- Monorepo: Turborepo
- CRUD de proyectos, tesis, usuarios y aplicaciones.
- Visualización de asistencias y postulación.
- Sistema de roles: administrador, coordinador, estudiante, profesor y estudiante de maestría.
- Seguridad en endpoints y rutas protegidas.
- Accesibilidad mínima AA.
- Alta cohesión y bajo acoplamiento en módulos.
- Uso interno académico.
- Posibilidad de expansión a otros departamentos.
La interfaz de usuario de SISINFO ha sido diseñada para ser intuitiva, accesible y eficiente. Se prioriza una experiencia de usuario fluida, que permita realizar las tareas de forma rápida y sencilla.
- Prototipos Figma: Visualización interactiva de las interfaces, permitiendo pruebas de usabilidad.
El diseño de la experiencia de usuario de SISINFO se basa en garantizar la eficiencia, claridad y facilidad de uso. Las decisiones de diseño se toman con base en los siguientes principios:
- Claridad: La navegación y las funcionalidades son claras y directas.
- Accesibilidad: El sistema es accesible para personas con discapacidad, asegurando un alto nivel de contraste y opciones de navegación por teclado.
- Consistencia: Las interacciones, colores y elementos gráficos siguen patrones coherentes en todas las pantallas.
- Feedback: El sistema proporciona retroalimentación inmediata sobre las acciones del usuario, como confirmaciones de acciones exitosas o errores.
- Manejo de estados: Uso de Zustand para manejar el estado global de la aplicación y proporcionar una experiencia fluida entre las interacciones del usuario.
- Cargar/mostrar datos dinámicamente: TanStack Query permite que los datos se gestionen y sincronicen de manera eficiente con el servidor, sin recargar la página.
| Elemento | Enlace | Estado |
|---|---|---|
| Historias de Usuario | 📝 Historias de Usuario | En Progreso |
| Prototipos Figma | 🔗 Figma |
Los prototipos interactivos permiten ver cómo será la experiencia del usuario al interactuar con el sistema. Los prototipos fueron creados en Figma para reflejar con exactitud la estructura de las interfaces, navegación y comportamiento de la aplicación.
| Sección | Descripción | Estado |
|---|---|---|
| 📖 Historias de Usuario | Requisitos funcionales priorizados | 🚧 En Progreso |
| 📐 Wireframes UI/UX | Diseños interactivos de interfaces | 🚧 En Progreso |
| 🧩 Diagrama UML | Modelo UML | 🚧 En Progreso |
| 🏗️ Arquitectura del Sistema | Diagrama de componentes | 🚧 En Progreso |
| Sección | Descripción | Estado |
|---|---|---|
| 🧩 Carpetas del monorepo | Organización del monorepo | 🚧 En Progreso |
| 📖 Carpetas del Frontend | Organización del front-end | 🚧 En Progreso |
| 📐 Backend | Documentación de carpetas y end-points del back-end | 🚧 En Progreso |
Para generar la documentación del código de SISINFO (incluyendo entidades, controladores, servicios, dependencias y más), se puede usar el siguiente comando de Compodoc:
npx @compodoc/compodoc -p tsconfig.json -s