Skip to content

Sprint_0

Jump to bottom
Juan Andrés Young Hoyos edited this page Aug 4, 2026 · 11 revisions

Sección 1: Generalidades del Proyecto

1.1 Descripción del problema y su solución software

Problema: En el centro de capacitación, la validación de vigencia de certificados, el agendamiento de citas y la resolución de dudas frecuentes se realizan de forma manual. Esto genera tiempos de espera prolongados, sobrecarga al personal administrativo y dificulta a empleadores y contratistas verificar rápidamente si un trabajador es apto para laborar.

Solución: Desarrollo de un chatbot inteligente y automatizado, integrado con la base de datos institucional, que permite a los usuarios consultar vigencias por número de cédula y resolver preguntas frecuentes, operando 24/7 y escalando a un humano solo cuando es estrictamente necesario.

1.2 Personas y roles del proyecto

Foto Nombre Correo Institucional Rol
📸 Sebastian Andres Medina Cabezas samedinac@eafit.edu.co Backend developer
image Juan Andrés Young Hoyos jayoungh@eafit.edu.co Full-Stack Developer
📸 Daniel Urbano Viana Polo duvianap@eafit.edu.co Tester
📸 Diego Mesa dmesao1@eafit.edu.co Front-end/software architect

1.3 Público objetivo y contexto

  • Trabajadores: Personas que interactúan con el bot para consultar el estado de su certificado y agendar cursos de reentrenamiento.
  • Empleadores/Contratistas: Empresas que consultan el sistema usando la cédula de un tercero para validar la autenticidad de los certificados antes de una contratación.
  • Personal Administrativo (Asis Altura): Usuarios que reciben los casos escalados y administran la base de datos centralizada.
  • Sistemas que interactúan: El chatbot (frontend web), el backend de procesamiento de lenguaje/lógica, y la base de datos SQL/NoSQL que almacena las vigencias.

Diagrama de Contexto:

graph TD
    T[Trabajador<br/>Consulta y agenda citas]
    E[Empleador / Contratista<br/>Valida certificados]
    P[Personal administrativo<br/>Atiende casos escalados]
    D[(Base de datos institucional<br/>Certificados y citas)]
    C{{Chatbot Asis Altura<br/>Web 24/7}}

    T -->|Consulta vigencia / agenda| C
    E -->|Valida certificado por cédula| C
    C -->|Escala conversación| P
    C -->|Consulta / actualiza datos| D
    D -->|Retorna estado y fecha| C

    style C fill:#7F77DD,stroke:#3C3489,color:#fff
    style T fill:#378ADD,stroke:#185FA5,color:#fff
    style E fill:#378ADD,stroke:#185FA5,color:#fff
    style P fill:#1D9E75,stroke:#0F6E56,color:#fff
    style D fill:#888780,stroke:#5F5E5A,color:#fff
Loading

1.4 Descripción del proceso de interacción

  1. El usuario (Trabajador/Empleador) ingresa a la web de Asis Altura y abre el widget del chatbot.
  2. El sistema despliega un menú de opciones (Validar Certificado, Agendar Cita, FAQ, Hablar con asesor).
  3. Si selecciona Validar Certificado, el bot solicita la cédula. El sistema consulta la base de datos y retorna la fecha de vigencia.
  4. Si la consulta es compleja, el sistema transfiere el chat al Personal Administrativo.

1.5 Glosario de términos

  • Trabajo en alturas: Toda labor que se realiza a más de 1.50 metros sobre un nivel inferior.
  • Certificado de vigencia: Documento que avala que el trabajador aprobó el curso de alturas y está apto por un periodo determinado.
  • Reentrenamiento: Curso periódico obligatorio para renovar el certificado de alturas.
  • Escalamiento (Handoff): Acción del chatbot de transferir la conversación a un asesor humano.

Sección 2: Determinación de necesidades

2.1 Requisitos Funcionales principales

A partir del análisis de las necesidades del centro de alturas, se extraen los siguientes requerimientos core:

  1. El sistema debe permitir consultar la vigencia de un certificado ingresando un número de cédula.
  2. El sistema debe gestionar el agendamiento de citas mostrando fechas y horarios disponibles.
  3. El sistema debe registrar nuevos usuarios capturando sus datos básicos.
  4. El sistema debe permitir el escalamiento de la conversación a un asesor humano.

Documentación del proceso de Elicitación

  • Técnica usada: Entrevistas no estructuradas y análisis de requerimientos en audio suministrado por el cliente.
  • Participantes: Equipo de desarrollo y representante de Asis Altura.
  • Fecha: [Ingresa la fecha de la reunión].
  • Evidencias: [Enlace a transcripción del audio o minutas de la reunión].

2.2 Análisis de la competencia

Aplicación / Solución Empresa que la ofrece Costo Aproximado Factor Diferenciador de nuestra propuesta
Zendesk Answer Bot Zendesk Desde $55 USD/mes Nuestra solución está hecha a la medida del dominio de certificados de alturas, sin sobrecostos de licencias genéricas.
ManyChat (Integrado a DB) ManyChat Desde $15 USD/mes + Dev Acceso directo y optimizado a la base de datos de Asis sin depender de integraciones complejas de terceros (como Zapier).
Chatbots Genéricos (Dialogflow) Google Pago por uso Enfoque nativo en la validación por cédula de contratistas, con flujos predefinidos para la normativa local.

Sección 3: User Story Mapping y Backlog del Producto

3.1 Story Mapping

El diseño visual de nuestras historias de usuario, priorizadas por el viaje del usuario (Descubrimiento -> Consulta -> Agendamiento -> Soporte).

Enlace al Story Mapping: [Link a Miro / Canva] (Inserta imagen del tablero aquí)

3.2 Backlog del Producto

El backlog completo (mínimo 20 historias agrupadas en épicas) está alojado en nuestra herramienta de gestión.

Enlace al Tablero de Gestión (Jira/Trello/GitHub Projects): [Link al Backlog]

3.3 Sprint 1 Planning

Historias de usuario comprometidas para la primera iteración (Fase de configuración y validación pública).

HU-01: Consulta pública de certificados

  • Descripción: Como contratista, quiero ingresar una cédula en el bot para verificar si un trabajador tiene su certificado de alturas vigente.
  • Tareas:
    • Diseñar el modelo de datos para certificados.
    • Crear endpoint de consulta por cédula.
    • Implementar el flujo de validación en el chatbot.
  • Criterios de Aceptación: El bot debe solicitar cédula; si existe, devuelve estado y fecha; si no, arroja mensaje de error amigable.
  • Estimación de esfuerzo: 5 Story Points.
  • Responsable: Sebastian Medina.

(Añade aquí las demás historias del Sprint 1, como la configuración del repositorio, despliegue del widget básico, etc.)

Diseño de la Arquitectura

4.1 Alcance del MVP

El Producto Mínimo Viable (MVP) abarcará el despliegue del chatbot como un widget en entorno web, conectado a una base de datos propia que contendrá información simulada (o real) de usuarios y vigencias. No incluirá, en esta fase inicial, integraciones complejas con pasarelas de pago o despliegue en WhatsApp API, enfocándose estrictamente en consulta, agendamiento y handoff.

4.2 Dimensiones del sistema y Requisitos no funcionales

  • Usuarios concurrentes esperados: 50 - 100 usuarios diarios (Empleadores y trabajadores).
  • Tiempos de respuesta: < 2 segundos para consultas de base de datos (vigencias).
  • Seguridad: Los datos sensibles de los trabajadores (historial médico o notas) no serán expuestos; la validación por cédula solo arrojará un estado binario (Vigente/Vencido) y fecha de expiración.
  • Disponibilidad: 99.9% de Uptime esperado para el servicio de consulta.

4.3 Modelado del dominio

Principales entidades del sistema:

  1. Usuario/Trabajador: Posee datos personales y está vinculado a certificados.
  2. Certificado: Tiene fecha de emisión, vigencia, tipo de curso (avanzado, reentrenamiento) y estado.
  3. Cita/Agendamiento: Relaciona un usuario con un curso y una fecha disponible.

Diagrama de Entidad Relación / Clases: (Inserta aquí tu diagrama de base de datos o clases)

4.4 Descripción de los componentes

  • Frontend (Widget del Chatbot): Interfaz gráfica desarrollada en [React/HTML-JS] donde el usuario interactúa.
  • Motor NLP / Controlador de flujos: Componente que procesa las intenciones del usuario (ej. [Node.js / Python / Dialogflow]).
  • Backend API: Expone los endpoints de consulta de vigencia y agendamiento.
  • Base de Datos: Almacena la información transaccional (ej. [PostgreSQL / MongoDB]).

4.5 Diagrama de componentes del sistema

Diagrama de Arquitectura: (Inserta el diagrama de componentes o arquitectura en la nube aquí)

Justificación: Se propone una arquitectura cliente-servidor basada en microservicios o monolito modular (según su elección), garantizando que el chatbot frontend esté desacoplado de la base de datos, lo que permite escalabilidad futura si se decide integrar canales móviles.

Diseño de Interfaces (Mockups)

5.1 Prototipo Dinámico

En esta sección se presentan los diseños de las interfaces con las que interactuará el usuario final, enfocadas en la ventana de chat y su adaptación a dispositivos móviles y escritorio.

Enlace al Prototipo Interactivo (Figma/Adobe XD): [Link a Figma]

Vistas Principales:

  1. Vista de Bienvenida: Menú de opciones (Validar, Agendar, FAQ).
  2. Flujo de Consulta: Input de cédula y tarjeta de respuesta con la vigencia.
  3. Flujo de Agendamiento: Selección de fecha (Date picker dentro del chat) y confirmación.
  4. Vista del Asesor: Panel (Dashboard) administrativo donde el empleado de Asis Altura ve los chats escalados.

(Inserta imágenes representativas de las pantallas aquí)

5.2 Prueba de prototipo

  • Fecha de la sesión de prueba: [Ingresa la fecha]
  • Participantes: [Nombre del cliente/profesor] y equipo de desarrollo.
  • Casos de prueba iniciales:
    • Navegar por el menú principal.
    • Simular el ingreso de una cédula válida.
    • Iniciar el proceso de agendamiento.
  • Resultados y Aceptación: [Indicar el feedback recibido: "El cliente aprobó la paleta de colores y el flujo, solicitó que el botón de agendar sea más visible..."].

Bibliografía

https://es.venngage.com/blog/diagrama-de-contexto/

Clone this wiki locally