Documentación¶

SECCIÓN 1 — GESTIÓN DE PROYECTO¶

1. ENUNCIADO DE ALCANCE DEL PROYECTO: SYSHUB¶

1.1. DESCRIPCIÓN GENERAL DEL PROYECTO¶

El presente documento establece las bases fundamentales, fronteras operativas y requerimientos técnicos para el diseño y construcción de Syshub. En términos sistémicos, Syshub se concibe como un ecosistema digital de aprendizaje continuo, orientado a la comunidad estudiantil y docente de la carrera de Ingeniería en Ciencias y Sistemas.

La naturaleza del sistema radica en operar como una plataforma web integral enfocada estrictamente en la gestión, preservación y distribución del conocimiento académico. El problema central que resuelve es la pérdida sistemática de información y experiencia académica debida a la transición semestral; un fenómeno en el cual los hallazgos valiosos, las resoluciones estructurales de proyectos y el aprendizaje práctico de los estudiantes desaparecen una vez concluye un ciclo académico. Syshub propone transformar este "montón" de archivos desconectados en un sistema donde el conocimiento colectivo surge como una propiedad emergente de la interacción humana.

El público objetivo primario de esta solución tecnológica incluye a los estudiantes activos —que actúan como productores y consumidores simultáneos de conocimiento—, así como a los auxiliares de cátedra y docentes, quienes operan como curadores y validadores de la calidad de dicho contenido.

1. 2. DEFINICIÓN DE ALCANCE (IN SCOPE)¶

El sistema Syshub abarcará exclusivamente la fase operativa detallada a continuación, estructurándose mediante un enfoque modular que garantiza la cohesión y alta disponibilidad del ecosistema formativo. El alcance funcional se delimita a cuatro módulos cardinales entrelazados:

A) Gestión de Identidad y Perfiles: El sistema proveerá la infraestructura necesaria para la autenticación y autorización segura. Contempla el registro de usuarios, inicio de sesión seguro, encriptación de credenciales y flujos de recuperación de contraseñas. Cada individuo contará con un perfil académico persistente capaz de rastrear su actividad dentro del ciclo de vida del ecosistema, consolidando su propio material guardado, publicaciones propias e interacciones en foros.

B) Repositorio de Proyectos y Tareas: Constituye el núcleo de almacenamiento estructurado del sistema. Permitirá a los estudiantes realizar la carga categorizada de proyectos técnicos y académicos. Cada carga incluirá metadatos técnicos extensivos, como la descripción del planteamiento, el conjunto de tecnologías utilizado (stack tecnológico), archivos adjuntos validables y etiquetas paramétricas de búsqueda. Además, habilitará la "curaduría por auxiliares", un mecanismo para identificar y destacar el material sobresaliente, asegurando su disponibilidad para las futuras cohortes.

C) Sección Social y Foros (Sys-Reddit): Para asegurar la emergencia del conocimiento colectivo, se implementará un componente altamente interactivo basado en foros de discusión anidados, similar en arquitectura a Reddit. Habilitará la creación de hilos, un sistema de blogs para publicaciones de formato largo elaboradas por autores verificados, así como un robusto motor de interacciones con comentarios moderables y un sistema de valoraciones (upvotes/downvotes) enfocado en dar prominencia orgánica al mejor contenido técnico.

D) Panel de Administración y Moderación: Corresponde a la capa de gobernanza del ecosistema. Permitirá controles de Alto Nivel para la administración de usuarios, asignación y revocación de roles (Estudiante, Auxiliar, Administrador, Moderador) e instrumentará un esquema de clasificación jerárquica guiado por el pensum de estudios y áreas transversales de ingeniería. Proveerá integraciones para revisar casos de abuso, contenido reportado y aplicar sanciones.

1.3. FUERA DEL ALCANCE (OUT OF SCOPE)¶

Para garantizar la viabilidad técnica y adherencia al ciclo temporal de vida del proyecto establecido para la Fase 1, se declaran explícitamente fuera de los límites del sistema los siguientes elementos:

No incluye el desarrollo de aplicaciones móviles nativas (Android / iOS). La entrega se restringirá estrictamente a una plataforma web responsiva.
No incluye sistemas de videoconferencia o streaming en tiempo real integrados dentro de la plataforma.
No incluye integraciones directas con sistemas externos institucionales, tales como portales de control académico o repositorios de asignación de notas oficiales de la facultad.
No se implementará ninguna pasarela de pagos, monetización, ni cobros por acceso a la documentación académica o foros.
No incluye chat en vivo ni un sistema de mensajería privada directa (Direct Messages) entre usuarios, con el fin de enfocar la comunicación al debate público en foros.
No aplica algoritmos de Inteligencia Artificial para la recomendación de proyectos, ni matching de contenidos predictivos automatizados (esto se reserva para iteraciones futuras).

1.4. REQUISITOS FUNCIONALES Y 5. CRITERIOS DE ACEPTACIÓN¶

A continuación, se formalizan las especificaciones del sistema utilizando un diseño de matriz que interconecta los Requisitos Funcionales y sus correspondientes Criterios de Aceptación por módulo.

MÓDULO A: Gestión de Identidad y Perfiles¶

ID	Descripción Funcional	Actor	Prioridad	Criterios de Aceptación (DADO / CUANDO / ENTONCES)
RF-A-001	El sistema debe permitir el registro de nuevos usuarios verificando unicidad de correo institucional.	Estudiante	Alta	DADO un usuario anónimo en la página de registro CUANDO ingresa un correo ya existente ENTONCES el sistema muestra un mensaje de "Correo ya registrado" y bloquea el envío. DADO datos válidos y correo único CUANDO envía el formulario ENTONCES se crea la cuenta en estado inactivo hasta validación.
RF-A-002	El sistema debe posibilitar el inicio libre de sesión con credenciales válidas generadas.	Estudiante, Auxiliar	Alta	DADO un usuario con cuenta activa CUANDO ingresa credenciales correctas ENTONCES se genera un token de sesión y se redirige al dashboard. DADO un usuario en el login CUANDO ingresa una contraseña incorrecta 3 veces ENTONCES se bloquea temporalmente el inicio de sesión.
RF-A-003	El sistema debe facilitar el flujo seguro de recuperación de contraseña olvidada.	Estudiante	Media	DADO un usuario que olvidó su acceso CUANDO solicita restablecimiento por correo ENTONCES el sistema envía un enlace de un solo uso con expiración. DADO que hizo clic en el enlace válido CUANDO asigna nueva contraseña ENTONCES la clave se actualiza y redirige al inicio.
RF-A-004	El sistema debe mostrar un perfil personal estructurado con el historial de actividad propio del usuario.	Estudiante	Media	DADO un usuario logueado adecuadamente CUANDO accede a la sección "Mi Perfil" ENTONCES se visualiza su información básica (carnet, semestre). DADO el acceso a la vista de perfil CUANDO navega por la ventana ENTONCES observa la lista de hilos creados y proyectos subidos.
RF-A-005	El sistema debe permitir guardar en "favoritos" contenido externo y catalogarlo.	Estudiante	Baja	DADO un usuario viendo un proyecto de otro estudiante CUANDO hace clic en "Guardar Material" ENTONCES el registro se asocia a su perfil personal. DADO que visita la zona "Mi Material" CUANDO selecciona revisar sus marcadores ENTONCES se listan todos los materiales que marcó.

MÓDULO B: Repositorio de Proyectos y Tareas¶

ID	Descripción Funcional	Actor	Prioridad	Criterios de Aceptación (DADO / CUANDO / ENTONCES)
RF-B-001	El sistema debe habilitar un formulario estructurado para la publicación de proyectos técnicos.	Estudiante	Alta	DADO un estudiante en la pantalla de carga CUANDO llena título, descripción técnica y stack tecnológico ENTONCES se procesa la información en base a metadatos. DADO el mismo estudiante CUANDO deja la descripción vacía y pulsa enviar ENTONCES surge una alerta indicando que es campo obligatorio.
RF-B-002	El sistema debe permitir el anexo de archivos cumpliendo restricciones de formato y peso.	Estudiante	Alta	DADO el módulo de adjuntos en un proyecto CUANDO el usuario sube un archivo > 50MB ENTONCES se rechaza la carga informando límite de tamaño. DADO el módulo de adjuntos CUANDO anexa archivos formatos .ZIP o .PDF permitidos ENTONCES los asocia a la base de datos del proyecto.
RF-B-003	El sistema debe admitir indexación del conocimiento usando etiquetas o "tags" temáticos.	Estudiante	Media	DADO el proceso de creación de proyecto CUANDO digita palabras clave como "Java" o "Grafos" ENTONCES las etiquetas se guardan relacionadas al proyecto. DADO un usuario en el explorador global CUANDO filtra mediante la etiqueta "Grafos" ENTONCES ve todos los proyectos con ese tag específico.
RF-B-004	El sistema debe proporcionar la interfaz de curaduría para marcar material destacado semestral.	Auxiliar	Alta	DADO un auxiliar visualizando el proyecto de un alumno CUANDO presiona el control de "Destacar Semestre" ENTONCES el proyecto obtiene la bandera de Curaduría Destacada. DADO que destacó el proyecto CUANDO se lista en búsquedas posteriores ENTONCES aparece visualmente priorizado para todos.
RF-B-005	El sistema debe registrar métricas de visibilidad simples por cada material subido.	Sistema	Baja	DADO un proyecto público abierto en pantalla CUANDO es visitado por un usuario logueado único ENTONCES el contador de visualizaciones incrementa en 1. DADO el autor observando su propio repositorio CUANDO revisa las tarjetas publicadas ENTONCES puede evaluar cuántas vistas ha recibido el recurso.

ID	Descripción Funcional	Actor	Prioridad	Criterios de Aceptación (DADO / CUANDO / ENTONCES)
RF-C-001	El sistema debe habilitar el inicio de hilos de discusión categorizados técnicamente.	Estudiante	Alta	DADO un estudiante que desea solventar una duda CUANDO selecciona "Crear Hilo" y elige la categoría "Bases de Datos" ENTONCES el hilo se crea clasificado correctamente. DADO el hilo recién configurado CUANDO se navega a la categoría "Bases de Datos" ENTONCES aparece disponible en la lista de debates recientes.
RF-C-002	El sistema debe facilitar respuestas anidadas sobre hilos existentes y blogs.	Estudiante, Auxiliar	Alta	DADO un hilo o publicación expuesta CUANDO un usuario presiona "Responder" y escribe contenido ENTONCES el comentario se adjunta secuencialmente al hilo. DADO un comentario ya trazado CUANDO alguien responde a ese preciso comentario ENTONCES la respuesta se anida visualmente con sangría.
RF-C-003	El sistema debe calcular y mostrar el prestigio organizando contenido por valoraciones orgánicas.	Estudiante	Alta	DADO un comentario útil CUANDO cinco estudiantes otorgan un "Upvote" ENTONCES la calificación global del comentario es +5. DADO un listado masivo de comentarios en un foro CUANDO es cargado en la web ENTONCES se ordenan descendentemente según su puntuación.
RF-C-004	El sistema debe posibilitar un entorno para artículos y guías profundas tipo "Blog".	Auxiliar	Media	DADO un usuario con permisos de escritura avanzada CUANDO despliega la redacción de artículo en formato rico ENTONCES puede incorporar jerarquía, código e imágenes. DADO el artículo expuesto CUANDO se publica ENTONCES aparece en una sección separada del foro normal.
RF-C-005	El sistema debe proveer una vía para reportar contenido no apropiado.	Estudiante	Baja	DADO un comportamiento hostil en un foro CUANDO un usuario selecciona "Reportar Infracción" ENTONCES el contenido exige una razón predefinida. DADO un reporte enviado con justificación CUANDO se consolida en la base ENTONCES levanta una bandera en el panel de revisión del moderador.

MÓDULO D: Panel de Administración y Moderación¶

ID	Descripción Funcional	Actor	Prioridad	Criterios de Aceptación (DADO / CUANDO / ENTONCES)
RF-D-001	El sistema debe facilitar la visualización, alteración y supresión de cuentas (CRUD).	Administrador	Alta	DADO un administrador operando el panel CUANDO busca por carnet a un individuo ENTONCES localiza todos los metadatos ligados al sujeto. DADO el perfil del individuo identificado CUANDO remueve un rol o cuenta ENTONCES la cuenta pierde totalmente acceso al instante.
RF-D-002	El sistema debe instrumentar la gestión global de roles y acreditaciones jerárquicas.	Administrador	Alta	DADO la cuenta básica de un estudiante logueada CUANDO el gerente le asigna el rol de "Auxiliar" ENTONCES el sistema le otorga acceso a curaduría de proyectos. DADO un auxiliar con período culminado CUANDO el administrador quita el rol ENTONCES revierte sus habilidades a nivel básico.
RF-D-003	El sistema debe gobernar la parametrización de pensum y asignaturas en tablas maestras.	Administrador	Media	DADO un cambio reciente implementado en la facultad CUANDO el administrador inserta el nuevo curso "Inteligencia Artificial 2" ENTONCES el curso aparece para todos al momento de etiquetar. DADO un curso obsoleto CUANDO se procede a su archivado sistémico ENTONCES ya no se admite subida de material nuevo bajo el mismo.
RF-D-004	El sistema debe contar con una bandeja procesadora de reclamos sociales (Moderación).	Moderador	Alta	DADO el acceso al panel central por un Moderador CUANDO verifica la cola de moderación pendiente ENTONCES ve la acumulación cronológica de conflictos reportados. DADO un hilo denunciado múltiples veces CUANDO el Moderador presiona "Eliminar contenido" ENTONCES desaparece definitivamente de la vista pública.
RF-D-005	El sistema debe autorizar bloqueos y suspensiones por vulnerar regulaciones.	Moderador, Admin	Media	DADO un estudiante que trasgredió los términos severamente CUANDO el moderador dicta un "Baneo de cuenta" ENTONCES se revoca inmediatamente cualquier token activo del usuario. DADO el mismo usuario baneado CUANDO intenta entrar nuevamente con sus credenciales intactas ENTONCES el sistema alerta "Acceso denegado: contacto con el soporte".