Closevibe Wiki — Documentación Interna
AI Sales Infrastructure for eCommerce — Documentación técnica completa del monorepo Closevibe.
¿Qué es Closevibe?
Closevibe es una infraestructura de ventas con IA para eCommerce — no un chatbot, no un CRM, sino una capa de revenue que conecta conversaciones con resultados de negocio (ventas reales).
Tesis central: Cada conversación es una oportunidad de venta. Closevibe convierte cada interacción en un lead estructurado dentro de un pipeline visual, automatiza el follow-up con IA bajo reglas de confianza configurables, y hace visible el ROI dentro del producto.
Estructura del Monorepo
| Paquete | Puerto | Stack | Descripción |
|---|---|---|---|
closevibe-backend/ | 3000 | Express + TypeScript + Prisma + PostgreSQL + Redis | API REST principal, 125+ endpoints |
closevibe-frontend/ | 5174 | React 18 + Vite + Tailwind + Mantine | SPA legacy + Backoffice admin |
closevibe-dash/ | 3000 | Next.js + TypeScript | Dashboard nuevo (reemplaza legacy) |
closevibe-videos/ | 3200 | Express + Remotion + Playwright + FFmpeg | Microservicio de generación de video |
closevibe-site-template/ | 3180 | Next.js 15 + React 19 + Tailwind v4 | Template de marketing site |
closevibe-wiki/ | 3300 | Next.js 14 + Nextra 2 | Esta documentación |
Las 7 Capas Funcionales
┌─────────────────────────────────────────────────────┐
│ 7. Analytics & Reporting Layer │
├─────────────────────────────────────────────────────┤
│ 6. Lifecycle & Recovery Engine │
├─────────────────────────────────────────────────────┤
│ 5. CRM Layer (eCommerce only) │
├─────────────────────────────────────────────────────┤
│ 4. Chatbot Response Engine │
├─────────────────────────────────────────────────────┤
│ 3. AI Sales Brain (Intent + Retrieval + Scoring) │
├─────────────────────────────────────────────────────┤
│ 2. Commerce Knowledge Layer (Scraping / API Sync) │
├─────────────────────────────────────────────────────┤
│ 1. Conversation & Channel Layer (Multi-channel) │
└─────────────────────────────────────────────────────┘- Conversation & Channel — Unifica Web widget, WhatsApp, Instagram, Messenger, Email, SMS. Normaliza payloads, persiste conversaciones, resuelve identidad de lead.
- Commerce Knowledge — MVP 1: scraping estructurado (PDP detection, extracción de productos). MVP 2: sync vía APIs de plataforma.
- AI Sales Brain — Clasificación de intent, retrieval jerárquico (datos estructurados → RAG → fallback seguro), scoring de confianza.
- Chatbot Response Engine — Formatea y envía respuestas por canal, registra links con
link_idpara tracking, soporta human handoff. - CRM Layer — Pipeline Kanban (New → Engaged → High Intent → Link Sent → Follow-up Pending → Re-engage → Converted → Lost), lead cards, timeline completo.
- Lifecycle & Recovery — Follow-ups autónomos basados en inactividad + alto intent. MVP 1: follow-up por señales. MVP 2: cart recovery real.
- Analytics & Reporting — Leads, links enviados, follow-ups, movimientos de pipeline, conversiones marcadas.
Dos Tipos de Cliente
| Tipo A — Custom Sites (MVP 1) | Tipo B — Plataformas (MVP 2) | |
|---|---|---|
| Target | WordPress/WooCommerce sin API, Webflow, CMS custom | Shopify, PrestaShop (con APIs) |
| Data | Scraping commerce-grade | Sync vía API/webhooks |
| Recovery | Purchase follow-up por señales conversacionales | Cart recovery real con eventos |
| Links | Confidence media (scraped) | Confidence alta (API) |
Modo B2B (Feature Flags)
Para tenants B2B: Solo capa de chatbot. IA responde y dirige hacia una acción (ej. booking Calendly). CRM pipeline, recovery y dashboards de revenue se ocultan via feature flags.
Navegación Rápida
🏗️ Arquitectura🔌 Backend API🤖 Pipeline IA📊 CRM & Pipeline📡 Canales🕷️ Scraping Engine🖥️ Frontend🔧 Backoffice🎬 Video Service🌐 Site Template📚 Wiki
Glosario Interno
| Término | Definición |
|---|---|
| Purchase follow-up | Follow-up basado en intent/señales conversacionales, sin evento real de carrito (MVP 1) |
| Cart recovery | Recovery disparado por evento real de checkout/abandono con links dinámicos (MVP 2) |
| Intent score | Intent de compra derivado del contenido de la conversación |
| Conversion probability % | Probabilidad estimada de compra mostrada en CRM |
| Link confidence | Confianza interna en la validez/estabilidad de un link (alta para plataformas, media para scraped) |
| Commerce-grade scraping | Scraping que detecta PDPs con alta precisión, extrae datos estructurados de producto |
| Tenant | Negocio (business) en el sistema multi-tenant |
| Business context | Middleware que resuelve el tenant actual en cada request |