Resumen
Resumen ejecutivo con estado de un vistazo, principales logros, brechas y riesgos, y evolución de Sprints para stakeholders y gerencia
Documentación de la Plataforma Algesta
Documentación técnica completa para la plataforma de gestión de mantenimiento Algesta con integración WhatsApp, subastas de marketplace y reconocimiento de serial impulsado por IA
Descripción General
Algesta es una plataforma integral de gestión de mantenimiento que digitaliza el ciclo de vida completo de las órdenes de mantenimiento de edificios. La plataforma conecta tres actores clave:
- Clientes envían solicitudes de servicio vía WhatsApp utilizando un bot conversacional impulsado por IA (Jelou)
- Agentes de Algesta gestionan órdenes, coordinan proveedores y supervisan operaciones vía un dashboard web React 19
- Proveedores externos participan en un sistema de subastas de marketplace, envían cotizaciones y ejecutan trabajo de mantenimiento
Capacidades Clave
- Integración WhatsApp Impulsada por IA - Captura completa de órdenes vía IA conversacional con clasificación de servicio GPT-4 y reconocimiento de serial de activos basado en OCR
- Sistema de Subastas de Marketplace - Subastas inversas con ofertas anónimas, selección de proveedores y validación de elegibilidad
- Gestión de Órdenes - 15+ estados de orden con seguimiento completo del ciclo de vida desde creación hasta cierre
- Gestión de Activos - Creación automática de hoja de vida (HV) de activos con extracción de número de serial por OCR desde fotos
- Sistema de Cotización Itemizada - Aprobaciones multinivel con inflación de agente y transparencia para el cliente
- KPIs Operacionales - Dashboards en tiempo real rastreando cumplimiento de SLA, tiempo de completitud de orden y rendimiento de proveedores
- Notificaciones Multicanal - Email (SendGrid), WhatsApp (Jelou) y soporte futuro de notificaciones push
Stack Tecnológico
- Backend: NestJS 11, Clean Architecture, CQRS, patrones Event-Driven
- Frontend: React 19, Bulletproof React, TanStack Query 5, Zustand 5
- Bases de datos: MongoDB (3 bases de datos separadas para órdenes, proveedores, notificaciones)
- Mensajería: Redis (desarrollo), Apache Kafka (producción)
- Infraestructura: Contenedores Docker en Azure con CI/CD vía Azure Pipelines
- AI/ML: GPT-4/GPT-4o para clasificación de servicios y reconocimiento de serial basado en OCR
- Integraciones: SendGrid, Jelou WhatsApp, Asana, DocuSign (diseñado), Azure Blob Storage
Búsqueda Rápida
/
Inicio Rápido por Audiencia
Secciones de Documentación
Requisitos
Requisitos de negocio, 80+ requisitos funcionales y 50+ requisitos no funcionales con trazabilidad completa
Arquitectura
Arquitectura de microservicios, diagramas C4, ADRs, diseño frontend/backend e integración Jelou WhatsApp
Funcionalidades
7 áreas de funcionalidades: gestión de órdenes, subastas de marketplace, gestión de proveedores, activos, cotizaciones, KPIs e integraciones
Guías
Configuración de desarrollo local, estrategias de pruebas, procedimientos de despliegue y guías de solución de problemas
Operaciones
Infraestructura como código, pipelines CI/CD, operaciones Kubernetes, monitoreo, seguridad y respuesta a incidentes
Estado del Proyecto
70%
Completitud General
Activo En Progreso - Actualmente en desarrollo 8
Sprints Completados
S1-S8 Completo - Completamente implementado y verificado 53+
Páginas de Documentación
Migradas Completo - Completamente implementado y verificado 7
Microservicios
Desplegados Completo - Completamente implementado y verificado Logros de la Plataforma
Completo
Marketplace completamente funcional con subasta inversa, ofertas anónimas y selección de proveedores
Completo
Captura de órdenes impulsada por IA vía WhatsApp con clasificación de servicio GPT-4 y reconocimiento de serial por OCR
Completo
Sistema de cotización itemizada con aprobaciones multinivel y transparencia para el cliente
Completo
Gestión del ciclo de vida de activos con creación automática de historial y seguimiento de mantenimiento
Completo
KPIs operacionales con dashboards en tiempo real y monitoreo de cumplimiento de SLA
Completo
Arquitectura moderna de microservicios con Clean Architecture, CQRS y patrones event-driven
Completo
Documentación completa cubriendo requisitos, arquitectura, guías y operaciones
Participa
Esta documentación se actualiza continuamente a medida que evoluciona la plataforma. El wiki fue migrado exitosamente de markdown a Astro Starlight con transformación de frontmatter, ajustes de enlaces y preservación de todos los diagramas Mermaid y referencias cruzadas.
Última Actualización: 2025-11-20 Migración de Documentación: Completa (53 archivos migrados del wiki original) Próxima Revisión: Después de la finalización de la fase de garantía (Q1 2026)