Sprint_0

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 de Asis Alturas S.A.S, 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
	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

1.4 Descripción del proceso de interacción

El usuario (Trabajador/Empleador) ingresa a la web de Asis Altura y abre el widget del chatbot.
El sistema despliega un menú de opciones (Validar Certificado, Agendar Cita, FAQ, Hablar con asesor).
Si selecciona Validar Certificado, el bot solicita la cédula. El sistema consulta la base de datos y retorna la fecha de vigencia.
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:

El sistema debe permitir consultar la vigencia de un certificado ingresando un número de cédula.
El sistema debe gestionar el agendamiento de citas mostrando fechas y horarios disponibles.
El sistema debe registrar nuevos usuarios capturando sus datos básicos.
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: [Miercoles 5 de Agosto].
Evidencias: Evidencia de reunion .

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/backlog del producto

Historias de usuario, priorizadas por el viaje del usuario (Descubrimiento -> Consulta -> Agendamiento -> Soporte).

Kanban: https://github.com/users/Sebaxdenc/projects/4

3.3 Sprint 1 Planning

Historias de usuario comprometidas para la primera iteración (además de compromiso para que todo lo demás sea en inglés y dejar de usar el español para mejor estandarización del repo y documentos).

HU-01: Revisión de los dos tipos de vencimiento

Descripción: Como contratista, quiero ingresar una cédula en el bot para verificar si un trabajador tiene su certificado de alturas vigente y que pueda darme y diferenciar los dos tipos de vencimiento de mis certificados.
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.

HU-02: Lectura/scaneo del QR del ceritificado

Descripción: Como usuario, quiero poder leer/scanear el QR que tienen los ceritificados para verificar si ese certificado sigue vijentte (va de la mano con HU-01 para los tipos de vencimiento).
Tareas:
- Diseñar la lectura y estructura de los datos .
- Crear endpoint de consulta por estructura de lectura del Qr.
- Implementar el flujo de validación del QR.
Criterios de Aceptación: El bot debe dar la opcion de scaneo del QR, si existe dar la posibilidad y usar la camara(por el momento solo usar la camara o de ser más sencillo que suba l imagen) en caso de poder hacer y si no dar un error de no poder acceder a esta funcion de que intente de otra manera o con la cedula.
Estimación de esfuerzo: 5 Story Points.
Responsable: Juan Andrés Young Hoyos.

HU-03: Descargar certificados

Descripción: Como usuario, quiero poder descargar el certificado (el descargar solo es unica y exclusivamente descargar el certificado)
Tareas:
- Diseñar sistema de descarga.
- Crear endpoint de consulta que le sirva a la descarga(PDF probablemente).
- Implementar el flujo de validacion del PDF(que solo sean los datos exactos que tenemos sin cambio alguno).
Criterios de Aceptación: El bot debe dar la opcion de descargar el certificado y debe ser exacto a la información de la base de datos sin alteracion/modificación alguna.
Estimación de esfuerzo: 5 Story Points.
Responsable: Juan Andrés Young Hoyos.

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:

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

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: Todavía en revisión e investigacion con el cliente para que sea más a corde a lo que tienen ellos y ser lo más fiel y cercano posible.

4.5 Diagrama de componentes del sistema

Se propone una arquitectura cliente-servidor basada en microservicios, garantizando que el chatbot frontend esté desacoplado de la base de datos, lo que permite escalabilidad futura si se decide integrar canales móviles.