Descripción General de Funcionalidades

1. Resumen Ejecutivo

La plataforma Algesta evolucionó desde un sistema básico de captura de órdenes por WhatsApp (S1-S2) a una plataforma integral de gestión de mantenimiento con subastas de marketplace, gestión de proveedores, seguimiento del ciclo de vida de activos, cotizaciones, aprobaciones multinivel, KPIs e integraciones externas (S3-S8). La plataforma sirve a tres actores principales: clientes (vía WhatsApp), agentes de Algesta (vía dashboard React) y proveedores externos (vía portal de proveedores y marketplace). Construida sobre una arquitectura de microservicios (Órdenes, Proveedores, Notificaciones) con NestJS y un dashboard React, Algesta maneja el ciclo de vida completo de mantenimiento desde la solicitud inicial hasta la selección en marketplace, ejecución, aprobación y cierre, con total auditabilidad y seguimiento de SLA.

2. Métricas de Completitud de Funcionalidades

Métrica	Valor
Total de Funcionalidades	7 áreas principales
Estado de Completitud	✅ 70% Completo, 🟡 25% En Progreso, 🔴 5% Pendiente
Distribución de Sprints	S1 (UX), S2 (WhatsApp), S3 (Proveedores), S4 (Marketplace), S5 (Post-Subasta), S6 (Reportes), S7 (Activos/KPIs), S8 (Finalización)
Total de Historias de Usuario	~80+ a través de todos los Sprints
Cobertura de Pruebas	Evidencia de notas de pruebas de S2-S8

3. Navegación de Áreas de Funcionalidades

Área de Funcionalidad	Descripción	Sprint(s)	Estado	Link del Documento
Ciclo de Vida de Gestión de Órdenes	Flujo completo de orden desde creación hasta cierre con más de 15 estados	S1-S8	✅ Completo	`order-management.md`
Sistema de Marketplace y Subastas	Subasta inversa con ofertas anónimas, selección de proveedores	S4-S8	✅ Completo	`marketplace-auctions.md`
Gestión de Proveedores	Registro, validación de documentos, elegibilidad, seguimiento de rendimiento	S3-S8	✅ Completo	`provider-management.md`
Gestión y Ciclo de Vida de Activos	HV de activos con reconocimiento de serial vía IA, historial, seguimiento de estado	S6-S8	🟡 En Progreso	`asset-management.md`
Flujos de Trabajo de Cotización y Aprobación	Cotizaciones itemizadas, aprobaciones multinivel, inflación	S5-S8	✅ Completo	`quotation-workflows.md`
Reportes y KPIs	4 KPIs operacionales, seguimiento de SLA, dashboards de rendimiento	S7-S8	✅ Completo	`reporting-kpis.md`
Integraciones de Sistemas Externos	DocuSign, Asana, Qsystems, Azure Blob, Jelou WhatsApp	S2-S8	✅ Completo	`external-integrations.md`

4. Mapeo de Sprint a Funcionalidad

Sprint	Enfoque	Funcionalidades Entregadas
Sprint 1	Diseño UX	Diseño UX para todos los módulos (órdenes, marketplace, proveedores, activos, clientes, KPIs)
Sprint 2	Integración WhatsApp	Captura de órdenes vía WhatsApp, integración bot Jelou, notificaciones
Sprint 3	Gestión de Proveedores	Registro de proveedores, carga de documentos, validación, elegibilidad
Sprint 4	Lanzamiento Marketplace	Publicación de subastas, ofertas anónimas, selección de proveedores
Sprint 5	Flujos Post-Subasta	Reportes, firma electrónica, pólizas, anticipos
Sprint 6	Visitas Técnicas y Reportes	Visita técnica, reportes de ejecución, cotizaciones itemizadas
Sprint 7	Activos y KPIs	HV de activos, reconocimiento de serial, dashboard de KPI, términos y condiciones
Sprint 8	Finalización	Notificaciones, mejoras de marketplace, acceso a activos, inflación de cotización

5. Decisiones Arquitectónicas Clave

Basadas en análisis completo de sesiones de mesa de trabajo de Sprint y análisis de backlog:

Serial vía Foto (IA/OCR) vs Códigos QR - Elegido por costo y viabilidad operacional; evita logística de etiquetas QR físicas
Cotización Itemizada (no total global) - Requerida para trazabilidad del cliente y protección de ventaja competitiva
HV de Activos Liviano (no integración heredada) - Evitando complejidad de más de 500 campos del sistema heredado
Marketplace Obligatorio para Todos los Servicios - Sin asignación directa excepto interno; asegura competencia y precios
Términos y Condiciones como Paso Obligatorio del Flujo - Cumplimiento legal antes de la ejecución de la orden
KPIs vía Actualización de API (no webhooks en tiempo real) - Simplicidad y estabilidad sobre complejidad en tiempo real
WhatsApp como Canal Operacional Central - Alineado con preferencias de clientes y hábitos existentes
Historial Transaccional Basado en Estados - Auditabilidad completa para cumplimiento y depuración

6. Resumen de Historias de Usuario

Categoría	Cantidad
Total de Historias de Usuario	~80+
Por Actor	Cliente (~15), Agente (~35), Proveedor (~20), Sistema (~10)
Por Sprint	S1 (7), S2 (10), S3 (12), S4 (15), S5 (18), S6 (20), S7 (20), S8 (15+)
Completitud	70% Hecho, 30% En Progreso

7. Cobertura de Pruebas

Evidencia de unified_Pruebas_notes.md:

Sprint	Enfoque de Pruebas	Estado
Sprint 2	Integración de WhatsApp validada	✅ Completo
Sprint 3	Carga y validación de documentos probada	✅ Completo
Sprint 4	Publicación de marketplace y flujos de subasta verificados (Historia 16544)	✅ Completo
Sprint 5	Integración de firma electrónica probada	✅ Completo
Sprint 6	Seguimiento de estado de firma validado	✅ Completo
Sprint 7	Automatización de HV de activos probada (Historia 16016)	✅ Completo
Sprint 8	Acceso al ciclo de vida de activos verificado (Historia 17988)	✅ Completo
Historia 16502	Gestión de solicitudes probada	✅ Completo

8. Evidencia de Implementación

Microservicios (NestJS)

Microservicio de Órdenes (algesta-ms-orders-nestjs):

20+ comandos (crear orden, asignar técnico, publicar en marketplace, aprobar cotización, etc.)
15+ consultas (listar órdenes, obtener detalles de orden, historial de orden, contadores, etc.)
Entidades: Order, OrderHistory, Asset, AssetHistory
Gestión de estados con historial transaccional

Microservicio de Proveedores (algesta-ms-provider-nestjs):

Registro de proveedores, gestión de documentos
Participación en subastas y envío de ofertas
Programación de visitas técnicas
Seguimiento de rendimiento

Microservicio de Notificaciones (algesta-ms-notifications-nestjs):

Notificaciones multicanal (email, WhatsApp)
Recordatorios y notificaciones programadas
Notificaciones de aprobación de cotizaciones

Frontend (React)

Dashboard (algesta-dashboard-react):

11 módulos de funcionalidades: órdenes, marketplace, proveedores, activos, clientes, subastas, KPIs, reportes, notificaciones, usuarios, configuración
50+ componentes con hooks e integración API
Control de acceso basado en roles
Actualizaciones de estado en tiempo real

Bot de WhatsApp (Jelou)

Integración del Bot (algesta-agent/jelou):

7 habilidades: registro, creación de órdenes, seguimiento, generación de PDF, actualizaciones de estado, confirmación de ejecución, notificaciones
Comunicación bidireccional con gateway
Captura y carga de fotos

9. Brechas Conocidas y Trabajo Futuro

Basado en Completo_backlog_analysis.md:

🟧 Bugs Críticos

Estabilización de flujos de WhatsApp de extremo a extremo
Automatización de confirmación de fecha de ejecución
Bugs en flujo de inflación de cotización
Casos límite en seguimiento de estado de firma electrónica
Problemas de persistencia de campos HV

🟨 Mejoras Esenciales MVP

Historial completo de HV y exportación a PDF
Automatización de confirmación de ejecución vía WhatsApp
Refinamientos en cálculo de KPI
UX de marketplace (marcado de mejor oferta, filtros, vista de tarjetas)
Ajustes de roles (solicitante, aprobador 1, aprobador 2)

🟩 Operaciones Post-MVP

Integración contable
Usuarios autorizados por cliente
Reportes avanzados de KPI (por ubicación, categoría, proveedor)
Reentrenamiento de modelo IA para reconocimiento de serial
Notificaciones push

🟦 Backlog Futuro

Automatización de mantenimiento preventivo
Modos de asignación automática (por afinidad, zona, especialidad)
Integración completa con SystemQ
App móvil para reemplazar WhatsApp

10. Referencias Cruzadas

Requisitos y Documentación de Resumen

Resumen Ejecutivo - Estado del proyecto de alto nivel, métricas y hallazgos clave
Requisitos de Negocio - Contexto de negocio, objetivos y decisiones estratégicas
Requisitos Funcionales - Requisitos funcionales detallados mapeados a funcionalidades
Requisitos No Funcionales - Requisitos de rendimiento, seguridad y operacionales

Documentación de Arquitectura

Descripción General de Microservicios Backend
Descripción General del Dashboard Frontend
Integración de Jelou WhatsApp
Diagramas de Flujo de Datos:
- Flujo de Datos de Creación de Orden
- Flujo de Datos de Todos los Procesos
Diagramas de Componentes:
Arquitectura de Despliegue

Documentación de Sprints

Documentación de Sprints 1-8 (ver docs/Sprint_1.md hasta Sprint_8.md en el repositorio del proyecto)

Pruebas y Análisis

Notas Unificadas de Pruebas (ver test/unified_Pruebas_notes.md en el repositorio del proyecto)
Análisis Completo del Backlog (ver docs/Completo_backlog_analysis.md en el repositorio del proyecto)
Contexto (ver docs/context.md en el repositorio del proyecto)

11. Inicio Rápido por Rol

🎯 Product Owners

Leer: Resumen Ejecutivo, Métricas de Completitud de Funcionalidades, Brechas Conocidas

👨‍💻 Desarrolladores

Leer: Evidencia de Implementación, referencia cruzada a documentos de Arquitectura, examinar archivos de funcionalidades específicas

🧪 Ingenieros QA

Leer: Cobertura de Pruebas, revisar criterios de aceptación en documentos de funcionalidades, validar contra notas de pruebas

📊 Analistas de Negocio

Leer: Resumen de Historias de Usuario, Mapeo de Sprint a Funcionalidad, Decisiones Arquitectónicas

🎩 Interesados

Leer: Resumen Ejecutivo, Navegación de Áreas de Funcionalidades, Métricas de Completitud

12. Navegación

Documentación Detallada de Funcionalidades:

Última Actualización: 2025-11-20 | Próxima Revisión: Trimestral