Propuesta de
Desarrollo
Nexor 360
MVP: Sistema Multiagente de Preventa Técnica, Análisis Financiero y Monitoreo Estratégico
Confidencial1. Resumen Ejecutivo
Con base en el PRD v1.1, el Anexo General y el TDD v1.0 proporcionados por su equipo, Zulunity presenta la siguiente propuesta para la construcción del MVP de Nexor 360: un sistema multiagente de preventa técnica, análisis financiero y monitoreo estratégico de oportunidades.
Alcance de la propuesta
- Construcción completa del MVP en 6 semanas, con fases comprimidas y ejecución en paralelo.
- Implementación de los 4 agentes: Preventa, CFO, Orquestador y Radar.
- Desarrollo de la aplicación web (React/TypeScript) con interfaz de chat, carga de archivos y vistas por agente.
- Infraestructura cloud (AWS primario / GCP alternativa) con CI/CD, observabilidad y seguridad.
- Entregable final: sistema funcional validado contra golden paths, con métricas de éxito medidas (M1–M7).
Stack tecnológico
| Componente | Tecnología |
|---|---|
| Backend / API | Python 3.11+ / FastAPI / SQLAlchemy |
| Orquestación | LangGraph (state machine) |
| LLM | AWS Bedrock (Claude) / GCP Vertex AI |
| Parsing documental | AWS Textract / GCP Document AI |
| Base de datos | PostgreSQL (RDS / Aurora) |
| Frontend | React + TypeScript |
| Contenedores | ECS Fargate / Cloud Run / Docker Compose |
¿Por qué Zulunity?
- Socio tecnológico integral con experiencia en desarrollo de software, cloud/DevOps y Data & AI.
- Stack alineado al proyecto: React, Python, AWS/GCP, Docker, Terraform, Machine Learning.
- Equipo con experiencia en Mercado Libre, Liverpool, Walmart, Globant y Microsoft Azure.
- Entrega 2x más rápida que equipos tradicionales, hasta 40% menor costo con sistemas optimizados con IA.
- Comunicación directa con ingenieros, sin capas de gestión intermedias.
- Contratos formales, equipos multidisciplinarios y continuidad de proyecto garantizada.
2. Alcance y Entregables
A continuación se detalla lo que Zulunity se compromete a construir, las funcionalidades incluidas, las exclusiones y las dependencias que requieren participación del cliente.
2.1 Entregables por semana
| Semana | Fases | Entregables clave |
|---|---|---|
| 1 | Fundamentos + Orquestador | Monorepo, Docker Compose, esquemas JSON, catálogos, reglas. State machine, session_state, contratos, API básica. |
| 2 | Orquestador + Preventa (ingesta) | Pipeline de ingesta (PDF/Excel/CSV/imágenes), LLM NER, Intent Técnico JSON validado. |
| 3 | Preventa (BOM) + Inicio CFO | Motor de reglas, ensamblador de arquitectura, motor BOM. Flujo Preventa E2E completo. |
| 4 | CFO + Radar + Inicio Frontend | 70+ indicadores financieros, escenarios, flags. Scoring, riesgos, alertas. Scaffold React. |
| 5 | Frontend + Integración | Vistas por agente, vista consolidada, listado sesiones. Integración frontend ↔ backend. |
| 6 | Testing E2E + Demo | Golden paths ejecutados, métricas M1–M7 medidas. Demo funcional + documentación. |
2.2 Funcionalidades incluidas P0
| Agente | IDs | Resumen |
|---|---|---|
| Preventa | F-PRE-01 a F-PRE-16 | Ingesta multimodal, NER técnico, Intent Técnico, arquitectura preliminar, Golden BOM, warnings y flags. |
| CFO | F-CFO-01 a F-CFO-10 | Integración costos/precios, margen, ~70+ indicadores, escenarios Good/Better/Best, clasificación de riesgo, resumen ejecutivo. |
| Orquestador | F-ORC-01 a F-ORC-10 | Sesiones, transiciones de estado, routing entre agentes, versionado, trazabilidad, API de exposición. |
| Radar | F-RAD-01 a F-RAD-08 | Score de oportunidad, prioridad, señales de riesgo, alertas accionables, próximos pasos, tags de clasificación. |
| UX / Frontend | F-UX-01 a F-UX-04 | Chat de ingesta, carga de archivos, vistas por agente, vista consolidada de sesión. |
2.3 Funcionalidades deseables P1
Las siguientes funcionalidades se incluirán si la velocidad del equipo lo permite. No son bloqueantes para la entrega del MVP:
- Cuestionario de aclaración interactivo (F-PRE-17)
- Comparativa contra benchmarks históricos (F-CFO-11)
- Reintentos y re-ejecuciones controladas (F-ORC-11)
- Dashboard ejecutivo de pipeline con scores de Radar (F-UX-05)
- Generación de PDF exportable con la propuesta completa (F-UX-06)
2.4 Exclusiones explícitas (V1)
- Integración con CRM (Salesforce, HubSpot)
- Integración con ERPs
- Integración con APIs de distribuidores para pricing en tiempo real
- Soporte para más de 2 fabricantes
- Soporte para más de 3 verticales
- Modo multiusuario colaborativo en tiempo real
- Entrenamiento de modelos propios (fine-tuning de LLM)
- App móvil nativa
2.5 Dependencias del cliente
Para cumplir con el cronograma de 6 semanas, las siguientes dependencias deben estar resueltas antes del inicio del proyecto:
| ID | Dependencia | Responsable |
|---|---|---|
| D1 | Catálogo canónico de SKUs (50–100 SKUs de 1–2 fabricantes) | Equipo comercial |
| D2 | Reglas de compatibilidad y dependencias técnicas (20–30 reglas) | Ing. preventa senior |
| D3 | Modelo de precios, costos y descuentos | Equipo financiero |
| D4 | Librería de ~70+ indicadores financieros con fórmulas y umbrales | Product Owner + CFO |
| D5 | 3–5 escenarios de prueba end-to-end (golden paths) | Product Owner |
| D6 | Acceso a API de LLM con créditos suficientes (Bedrock / Vertex) | Infraestructura |
| D7 | Entorno de hosting cloud configurado | Infraestructura |
3. Enfoque Técnico
El diseño técnico se basa en el TDD v1.0 proporcionado, con una arquitectura por capas que separa claramente la experiencia de usuario, la lógica de orquestación, los agentes de negocio, la capa de IA y la lógica determinista.
3.1 Arquitectura por capas
3.2 Principio rector del sistema
"LLM para interpretar. Lógica determinista para validar, calcular y decidir."
El modelo de lenguaje se utiliza para interpretar lenguaje natural, extraer entidades y clasificar contexto. Las decisiones críticas — compatibilidad técnica, selección de SKUs, cálculo de cantidades, indicadores financieros y scoring de oportunidad — se ejecutan con lógica determinista, catálogos canónicos y reglas configurables.
3.3 Flujo de datos entre agentes
- Session Manager
- Agent Router
- Audit Trail
- Ingesta multimodal
- NER técnico
- Intent Técnico
- Ensamblador arquitectura
- Motor BOM
- Validación
- Integración costos
- Motor financiero (70+ ind.)
- Escenarios G/B/B
- Flags de riesgo
- Scoring (0-100)
- Detección de riesgos
- Alertas accionables
- Próximos pasos
3.4 Stack tecnológico
| Componente | Tecnología | Justificación |
|---|---|---|
| Backend / API | Python 3.11+ / FastAPI | Ecosistema maduro para IA, async nativo, tipado con Pydantic |
| Orquestación | LangGraph | State machine para agentes con checkpoints y ciclos |
| LLM | AWS Bedrock (Claude 3.5) | Serverless, pay-per-token, mejor modelo para extracción |
| Parsing documental | AWS Textract | Líder en extracción de tablas/formularios de PDFs |
| Base de datos | PostgreSQL (RDS/Aurora) | JSONB para payloads flexibles, transaccional |
| Object storage | AWS S3 | Archivos de entrada y artefactos |
| Frontend | React + TypeScript | Ecosistema amplio para UIs complejas |
| Observabilidad | OpenTelemetry + CloudWatch | Trazas distribuidas con correlación por session_id |
| Contenedores | ECS Fargate | Despliegue serverless sin gestión de cluster |
| ORM / Migraciones | SQLAlchemy + Alembic | Acceso a datos tipado y migraciones controladas |
3.5 Contratos entre agentes
Los agentes se comunican mediante contratos JSON validables con JSON Schema y Pydantic. Los contratos principales son:
3.6 Máquina de estados del Orquestador
3.7 Modelo de datos
Las entidades principales del sistema, según el TDD, incluyen:
- session / session_state — Estado del caso, inputs, referencias a outputs por etapa.
- technical_intent — Intent Técnico estructurado (JSON versionado).
- architecture_output / bom_output — Arquitectura por capas y Golden BOM.
- financial_result — Resumen, indicadores, escenarios y flags financieros.
- radar_output — Score, prioridad, riesgos, alertas y próximos pasos.
- catalog_sku — Catálogo canónico de productos con atributos y precios.
- technical_rule — Reglas de compatibilidad y dependencias técnicas.
- financial_indicator_config — Configuración parametrizada de indicadores.
3.8 Infraestructura y ambientes
| Ambiente | Configuración |
|---|---|
| Local / Dev | Docker Compose: PostgreSQL, Redis, servicios backend, frontend, mocks |
| QA / Staging | Cloud con recursos reducidos, servicios reales de IA y parsing |
| Producción | Alta disponibilidad básica, observabilidad completa, CI/CD |
El pipeline de CI/CD (GitHub Actions) incluye: lint, type checking (mypy), pruebas unitarias, validación de contratos JSON, build de imágenes Docker y deploy automatizado a staging.
4. Plan de Construcción y Cronograma
El proyecto se ejecuta en 6 semanas con sprints semanales y tracks paralelos. Este cronograma comprimido requiere que las dependencias del cliente (D1–D7) estén resueltas antes del inicio.
4.1 Diagrama de ejecución
4.2 Detalle semanal
| Sem | Tracks paralelos | Entregable clave | Criterio de aceptación |
|---|---|---|---|
| 1 | Setup + Orquestador: Monorepo, Docker, esquemas, catálogos, state machine | Orquestador funcional con stubs de agentes | Crear sesión → transicionar estado → consultar resultado |
| 2 | Preventa (ingesta) + Orquestador completo: Pipeline PDF/Excel/CSV, LLM NER, routing | Input → Intent Técnico JSON validado | 3 inputs de prueba generan Intent correcto |
| 3 | Preventa (BOM) + Inicio CFO: Motor reglas, ensamblador, motor BOM | Flujo Preventa E2E (input → BOM) | Golden paths de Preventa pasan validación |
| 4 | CFO + Radar + Frontend: 70+ indicadores, scoring, scaffold React | Flujo completo Preventa → CFO → Radar | Indicadores coherentes, score calculado |
| 5 | Frontend + Integración: Vistas por agente, deploy staging | App web conectada al backend | Usuario puede crear sesión y ver resultados |
| 6 | Testing E2E + Demo: Golden paths, métricas, tuning prompts | Demo funcional + documentación | M1–M7 medidas, 0 errores bloqueantes |
4.3 Hitos de validación
- Fin Semana 1: Orquestador funcional con stubs de agentes y contratos validados.
- Fin Semana 3: Flujo Preventa end-to-end operando con golden paths.
- Fin Semana 4: Flujo completo Preventa → CFO → Radar integrado.
- Fin Semana 6: Demo funcional con métricas M1–M7 medidas y documentación entregada.
4.4 Paralelismo requerido
- Backend y frontend en paralelo desde la semana 4.
- Agentes CFO y Radar en paralelo durante la semana 4.
- Las dependencias del cliente (catálogos, reglas, indicadores) deben estar listas antes de la semana 1.
5. Equipo y Metodología
5.1 Sobre Zulunity
Zulunity es un socio tecnológico integral especializado en desarrollo de software, cloud/DevOps y Data & AI. Nuestro equipo cuenta con ingenieros que han trabajado en empresas como Mercado Libre, Liverpool, Walmart, Globant y Microsoft Azure.
- Entrega 2x más rápida que equipos de ingeniería tradicionales.
- Hasta 40% menor costo gracias a sistemas optimizados con IA.
- Comunicación directa con los ingenieros del proyecto, sin capas intermedias.
- Contratos formales, equipos multidisciplinarios y continuidad de proyecto garantizada.
5.2 Composición del equipo
5.3 Metodología de trabajo
- Sprints semanales alineados al cronograma de 6 semanas.
- Golden paths como criterios de aceptación en cada fase.
- Revisiones semanales con el cliente para alinear avance y prioridades.
- CI/CD con quality gates: lint, type checking, tests unitarios, validación de contratos.
- Demos al cierre de cada fase para validar entregables.
5.4 Comunicación y transparencia
- Canal directo con ingenieros vía Slack o Teams.
- Reportes de avance semanales con métricas de progreso.
- Acceso al repositorio de código y tablero de proyecto (GitHub/Jira).
- Demos interactivas al cierre de cada semana/fase.
6. Calidad, Riesgos y Mitigación
6.1 Estrategia de calidad
Aplicamos un enfoque de calidad en cuatro dimensiones, alineado con las recomendaciones del Anexo General:
| Dimensión | Prácticas |
|---|---|
| Software | Pruebas unitarias, integración y E2E. Type checking (mypy). Linters. CI/CD con quality gates. Revisiones de código. |
| Sistema de IA | Golden paths con inputs/outputs esperados. Evaluación de extracción NER y calidad del Intent Técnico. Validación de coherencia del BOM. |
| Datos | Calidad de catálogos SKU. Cobertura de reglas técnicas. Integridad de precios/costos. Versionado de configuraciones. |
| Operativa | Error rate por agente. Tiempos end-to-end. Consumo de tokens y costo por sesión. Frecuencia de supuestos y warnings. |
6.2 Métricas de éxito del MVP
6.3 Requerimientos no funcionales clave
| Categoría | Requerimiento | Objetivo |
|---|---|---|
| Rendimiento | Tiempo end-to-end (Preventa → Radar) | ≤5 minutos |
| Rendimiento | Respuesta API del Orquestador | ≤500ms (p95) |
| Rendimiento | Motor financiero completo | ≤10 segundos |
| Escalabilidad | Sesiones concurrentes (MVP) | ≥10 sesiones |
| Disponibilidad | Uptime en horario laboral | 99% |
| Resiliencia | Circuit breakers entre agentes | Timeout configurable |
6.4 Riesgos principales y mitigación
| Riesgo | Prob. | Impacto | Mitigación |
|---|---|---|---|
| Alcance excesivo del MVP | Alta | Alto | Implementar por fases, priorizar P0, medir progreso semanal |
| Calidad insuficiente de catálogos y reglas | Alta | Crítico | Comenzar con catálogo mínimo viable (50 SKUs, 20 reglas) |
| Alucinaciones del LLM | Media | Alto | Toda decisión técnica pasa por lógica determinista post-LLM |
| Latencia del flujo E2E | Media | Medio | Optimizar prompts, streaming, paralelizar, cachear catálogos |
| Costos de API de LLM | Media | Medio | Monitorear tokens/sesión, optimizar prompts |
| Manejo de errores entre agentes | Media | Alto | Circuit breakers, checkpoints, estados de error explícitos |
| Dificultad de testing IA + reglas | Media | Medio | Golden paths con inputs/outputs esperados, métricas por agente |
6.5 Seguridad
- Autenticación: JWT/OIDC con validación en gateway.
- Cifrado: TLS en tránsito, AES-256 en reposo (DB + S3).
- Secretos: AWS Secrets Manager / Parameter Store.
- Aislamiento: Datos segregados por sesión, sin mezcla entre cuentas en prompts.
- IA: Sanitización de inputs, controles anti-prompt-injection, validación de outputs con reglas.
- Auditoría: Logs inmutables por session_id.
7. Inversión y Modelo de Cobro
Zulunity opera con un esquema híbrido de pago diseñado para alinear incentivos y ofrecer transparencia en cada etapa del proyecto.
7.1 Estructura de inversión
| Concepto | Monto | Momento de pago |
|---|---|---|
| Anticipo (30%) | $22,500 MXN | Al firmar contrato |
| Pago semanal 1 | $8,750 MXN | Fin de semana 1 |
| Pago semanal 2 | $8,750 MXN | Fin de semana 2 |
| Pago semanal 3 | $8,750 MXN | Fin de semana 3 |
| Pago semanal 4 | $8,750 MXN | Fin de semana 4 |
| Pago semanal 5 | $8,750 MXN | Fin de semana 5 |
| Pago semanal 6 | $8,750 MXN | Fin de semana 6 |
| Total del proyecto | $75,000 MXN |
El 70% restante ($52,500 MXN) se distribuye en 6 pagos semanales de $8,750 MXN cada uno, alineados con las entregas de cada sprint.
7.2 Costos de infraestructura cloud
Los costos de infraestructura cloud son a cargo del cliente y se estiman de forma referencial. Los principales rubros mensuales incluyen:
- API de LLM (AWS Bedrock / Vertex AI) — variable según volumen de tokens.
- Compute (ECS Fargate / Cloud Run) — escalable según uso.
- Base de datos (RDS PostgreSQL / Cloud SQL).
- Almacenamiento (S3 / Cloud Storage).
- CDN y hosting frontend (Amplify / Firebase).
7.3 Programa de referidos
Si el cliente refiere un prospecto que cierre contrato con Zulunity en los siguientes 6 meses, podrá elegir entre:
| Opción | Beneficio | Condiciones |
|---|---|---|
| Opción A: Crédito económico | 10–15% del valor de este proyecto como crédito | Aplicable a pagos pendientes o servicios futuros. Nunca como descuento anticipado. |
| Opción B: Soporte gratuito | 3 semanas de soporte gratuito | Por cada referido que cierre contrato con Zulunity. |
8. Soporte Post-Entrega y Continuidad
8.1 Soporte incluido sin costo adicional
Al terminar el proyecto, Zulunity ofrece 2 semanas de soporte sin costo adicional que cubren:
- Corrección de bugs detectados en producción.
- Ajustes menores de funcionalidad relacionados con lo entregado.
- Acompañamiento técnico para estabilización en producción.
| Aspecto | Detalle |
|---|---|
| Alcance | Bugs y ajustes sobre funcionalidad entregada. No incluye funcionalidades nuevas. |
| Canal | Mismo canal de comunicación del proyecto (Slack/Teams). |
| Horario | Horario laboral estándar (lunes a viernes). |
| Duración | 2 semanas a partir de la entrega final. |
8.2 Mantenimiento continuo
Después del período de soporte incluido, ofrecemos un plan de mantenimiento continuo a una tarifa de $2,500 MXN/semana ($10,000 MXN/mes) que incluye:
- Corrección de bugs y ajustes menores.
- Monitoreo de la plataforma.
- Soporte técnico dedicado.
- Actualizaciones de seguridad y dependencias.
Soporte incluido
- Sin costo adicional
- 2 semanas
- Bugs y ajustes sobre lo entregado
- Funcionalidades nuevas no incluidas
Mantenimiento continuo
- $2,500 MXN/semana
- Mensual renovable
- Bugs, ajustes, monitoreo, actualizaciones
- Funcionalidades nuevas: cotización por separado
9. Términos, Condiciones y Próximos Pasos
9.1 Validez de la propuesta
Esta propuesta tiene una validez de 30 días naturales a partir de la fecha de presentación. Después de este período, los términos y condiciones podrán ser revisados.
9.2 Supuestos del proyecto
Esta propuesta se basa en los siguientes supuestos. Si alguno resulta falso, el alcance, cronograma o inversión podrían verse afectados:
- Los catálogos de SKU se pueden obtener del equipo comercial del cliente.
- Los precios y costos base están disponibles para al menos 1 fabricante.
- Las reglas de compatibilidad técnica son conocidas y documentables.
- El equipo tiene acceso a una API de LLM (AWS Bedrock o GCP Vertex AI) con créditos suficientes.
- El dominio inicial es networking/infraestructura IT.
- La evaluación financiera opera sobre datos proporcionados por la empresa.
- Las dependencias D1–D7 se resuelven antes del inicio del proyecto.
9.3 Propiedad intelectual
El código fuente desarrollado específicamente para este proyecto será propiedad del cliente una vez completado el pago total. Las herramientas, frameworks y bibliotecas de código abierto utilizadas mantienen sus licencias originales. Los detalles específicos se definirán en el contrato de servicios.
9.4 Confidencialidad
Toda la información compartida entre las partes durante la evaluación de esta propuesta y la ejecución del proyecto se considera confidencial. Zulunity se compromete a no divulgar información del cliente a terceros sin autorización expresa por escrito.
9.5 Próximos pasos
- Revisión de esta propuesta — El cliente revisa el alcance, cronograma e inversión.
- Sesión de preguntas y alineación — Resolvemos dudas y ajustamos detalles.
- Confirmación de alcance y montos — Alineamos los términos finales.
- Firma de contrato — Formalizamos el acuerdo y procesamos el anticipo.
- Kick-off del proyecto — Iniciamos la semana 1 con el equipo asignado.
9.6 Información de contacto
Zulunity
kevin@zulunity.com
zulunity.com
Agradecemos la confianza depositada en Zulunity. Estamos listos para iniciar cuando usted lo decida.