Desarrollo de Sistema Web para Digitalización de Procesos de Evaluación y Reportes

Se requiere el desarrollo de un sistema web para digitalizar y centralizar el proceso actual de evaluación y generación de reportes, que actualmente se gestiona mediante un archivo Excel con preguntas, matriz de captura, fórmulas y macros. El objetivo principal de esta Etapa 1 (MVP) es reducir el trabajo manual en la captura de respuestas y la generación de informes, así como centralizar toda la información en una base de datos.

### 1. Contexto y objetivo del sistema
El proceso actual se basa en un archivo Excel que contiene preguntas, matriz de captura, fórmulas y macros. El cálculo/scoring se realiza en Excel y luego se genera manualmente un PDF con los resultados. La Etapa 1 digitaliza la captura y centraliza datos, manteniendo el cálculo en Excel.
Objetivos principales (Etapa 1)
Reducir trabajo manual al capturar respuestas y al generar reportes.
Centralizar encuestas, evaluados, respuestas y resultados en una base de datos.
Permitir exportar CSV para alimentar el Excel actual.
Generar PDF bajo demanda basado en un código/resultado proveniente del Excel.
Dejar el diseño preparado para multi-empresa en Etapa 2.
### 2. Alcance y límites
Incluido en Etapa 1 (MVP)
Una empresa operativa: "General".
Roles: Super Admin y Admin General.
Administración de encuestas, preguntas y catálogo de opciones.
Administración de evaluados (nombre, email).
Captura de evaluaciones por admin (modo entrevista), sin guardar avance.
Exportación CSV por evaluación con texto de opción.
Registro manual del código/resultado generado por Excel.
Administración de códigos (aprox. 20) y contenido asociado para el reporte.
Configuración manual de 2–3 gráficas de barras por código (hasta 10 barras cada una).
Generación de PDF bajo demanda (QuestPDF), con tablas simples y gráficas de barras.
Auditoría básica: logs técnicos y metadatos.
UI rápida y simple, tema genérico tipo Bootstrap, responsive básico.
Ambiente único: producción.
Fuera de alcance en Etapa 1
Multi-empresa funcional (onboarding y operación por tenant).
Suscripciones, pagos y facturación.
Portal de empleados para responder autónomamente.
Motor de reglas/scoring en la web (migración de fórmulas y VBA).
Guardado de PDFs en blob con retención.
Plantillas avanzadas por bloques o DOCX.
Migración de datos históricos desde Excel.
Reportes adicionales o dashboards.
### 3. Supuestos validados (Etapa 1)
Encuestas: 10–30 preguntas, selección única, todas requeridas, flujo lineal.
Opciones de respuesta: catálogo fijo reutilizable por empresa.
Export CSV: se exporta el texto de la opción seleccionada.
Código Excel: se captura manualmente en la plataforma; es único por evaluación; formato sugerido gen-xxx; puede corregirse registrando quién y cuándo.
Por código, típicamente: 10–20 subpersonalidades, 10–20 características, 10–20 recomendaciones.
PDF: simple pero claro, idioma español, incluye folio legible y numeración Página X de Y.
PDF no se almacena, se regenera bajo demanda usando datos guardados.
Gráficas: barras simples (sin ejes complejos), orientación horizontal recomendada.
### 4. Roles y permisos
R-1. Super Admin
Acceso total a la plataforma.
Puede ver y dar soporte, administrar catálogos y configuración.
Puede asignar roles a usuarios.
R-2. Admin General
Configura encuestas, preguntas y catálogo de opciones.
Crea evaluados y captura evaluaciones en nombre del evaluado.
Administra códigos y contenido asociado.
Genera csv y pdf por evaluación.
### 5. Flujos principales (Etapa 1)
WF-1. Captura de evaluación
Crear evaluado (nombre, email).
Seleccionar encuesta (previamente creada).
Responder 10–30 preguntas (selección única).
Guardar evaluación.
Editar evaluación solo si NO existe código Excel registrado.
Descargar CSV.
Registrar código/resultado del Excel.
Generar PDF bajo demanda y descargar.