GUÍA COMPLETA

Construye tu Propia
Aplicación Vertical

Guía paso a paso para construir aplicaciones de IA verticales para salud, legal, propiedades o cualquier industria usando los 18 servicios del Stack Core. De cero a producción.

18
Servicios Core
7
Fases
2-4sem
Cronograma
1

Configuración y Arquitectura

2-3 días · Configuración base y planificación vertical

¿Nuevo en Nexus CLI?

Esta guía usa extensivamente Nexus CLI. Si aún no lo has instalado o quieres conocer todos los más de 60 comandos disponibles, plantillas y funciones avanzadas, consulta la documentación completa del CLI.

Ver Documentación del CLI

1.1. Instalar Nexus-Forge

Instala el CLI de Nexus-Forge que proporciona todas las herramientas de desarrollo, configuración de Docker Compose e integración con Claude Desktop.

npm install -g @adverant/nexus-forge
forge --version  # Verify installation
Requisitos previos: Node.js 18+, Docker Desktop en ejecución, 8GB+ de RAM disponible

1.2. Crear tu Proyecto Vertical

Elige una plantilla vertical o empieza en blanco. Las plantillas incluyen modelos de datos, rutas API y consultas de ejemplo para industrias específicas.

# Interactive setup
forge create my-vertical

# Or specify a template
forge create healthcare-crm --template healthcare
forge create legal-research --template legal
forge create property-mgmt --template property

# Or start completely blank
forge create custom-vertical --template blank
🏥
Plantilla de Salud
Pacientes, citas, EHR, cumplimiento HIPAA
⚖️
Plantilla Legal
Casos, documentos, clientes, gestión de asuntos
🏠
Plantilla de Propiedades
Listados, inquilinos, arrendamientos, mantenimiento
Plantilla en Blanco
Empieza desde cero solo con el Stack Core

1.3. Comprender los Servicios Core Disponibles

Los 18 servicios core están disponibles automáticamente. Esto es lo que cada uno proporciona para tu vertical:

brain ai
Memoria GraphRAG
Almacenar registros de pacientes, expedientes legales, datos de propiedades
target
Gateway LLM MageAgent
Interfaces de chat, análisis de documentos, resúmenes
robot arm
Orquestación Multi-Agente
Flujos de trabajo complejos, investigación multi-paso
video camera
Inteligencia de Video
Imágenes médicas, recorridos de propiedades, deposiciones
document file
Procesamiento de Documentos
PDFs, escaneos, contratos, formularios
map fold
Servicio Geoespacial
Ubicaciones de propiedades, áreas de servicio, rutas
shield lock
Auth y RBAC
Espacios de trabajo multi-tenant, permisos de usuario
lightning bolt
API Gateway
Limitación de velocidad, balanceo de carga, enrutamiento
2

Modelo de Datos y Autenticación

3-4 días · Define tus estructuras de datos y control de acceso

2.1. Diseñar tu Esquema GraphRAG

Define tipos de entidades, relaciones y embeddings vectoriales para tu vertical. GraphRAG proporciona almacenamiento tanto PostgreSQL (estructurado) como Neo4j (grafo).

// src/schema/entities.ts
export const HealthcareSchema = {
  entities: {
    Patient: {
      properties: ['name', 'dateOfBirth', 'medicalHistory'],
      embeddings: ['medicalHistory', 'symptoms'],
      relationships: ['HAS_APPOINTMENT', 'HAS_DIAGNOSIS']
    },
    Appointment: {
      properties: ['datetime', 'status', 'notes'],
      embeddings: ['notes', 'diagnosis'],
      relationships: ['WITH_PATIENT', 'WITH_DOCTOR']
    }
  }
}

// Forge automatically creates:
// - PostgreSQL tables
// - Neo4j nodes/relationships
// - Qdrant vector collections
// - VoyageAI embedding pipelines

2.2. Configurar Auth Multi-Tenant

Configura espacios de trabajo, roles y permisos. El servicio Auth maneja tokens JWT, integración SSO y aislamiento de espacios de trabajo automáticamente.

// src/config/auth.ts
export const authConfig = {
  workspaces: {
    enabled: true,
    isolation: 'strict'  // Each workspace = separate data
  },
  roles: {
    admin: ['read', 'write', 'delete', 'manage_users'],
    doctor: ['read', 'write', 'view_patients'],
    nurse: ['read', 'write_limited'],
    patient: ['read_own']
  },
  sso: {
    providers: ['google', 'okta', 'auth0']
  }
}

// Forge generates:
// - Login/signup API routes
// - JWT middleware
// - RBAC enforcement
// - Workspace switching UI
3

Integración de IA

4-5 días · Conecta LLMs y construye funciones inteligentes

3.1. Configurar Modelos de IA

Elige qué modelos de IA usar para diferentes tareas. MageAgent proporciona acceso a más de 320 modelos de OpenRouter, Anthropic y OpenAI con enrutamiento inteligente para ahorrar costos.

// src/config/ai.ts
export const aiConfig = {
  chat: {
    model: 'anthropic/claude-opus-4.6',
    fallback: 'openai/gpt-4o'
  },
  analysis: {
    model: 'anthropic/claude-opus-4',
    temperature: 0.1
  },
  summarization: {
    model: 'anthropic/claude-haiku-4', // Faster, cheaper
    maxTokens: 1000
  },
  routing: {
    enabled: true,  // Intelligent cost optimization
    costSavings: '45-60%'
  }
}

3.2. Construir Flujos de Trabajo Multi-Agente

Crea flujos de trabajo donde múltiples agentes de IA colaboran. Ejemplo: flujo de diagnóstico médico con agentes de análisis de síntomas, investigación y recomendaciones.

// src/workflows/diagnosis.ts
export const diagnosisWorkflow = {
  name: 'Medical Diagnosis Assistant',
  agents: [
    {
      id: 'symptom-analyzer',
      model: 'claude-opus-4',
      task: 'Analyze patient symptoms and medical history',
      tools: ['graphrag_query', 'vector_search']
    },
    {
      id: 'research-agent',
      model: 'gpt-4o',
      task: 'Research similar cases in medical literature',
      tools: ['web_search', 'document_fetch']
    },
    {
      id: 'recommendation-agent',
      model: 'claude-opus-4-6-20260206',
      task: 'Generate treatment recommendations',
      tools: ['graphrag_query', 'guideline_lookup']
    }
  ],
  orchestration: 'parallel',  // Run simultaneously
  synthesis: true  // Combine results into final output
}

// Frontend shows real-time progress per agent
4

Construcción del Frontend

4-5 días · Crea la interfaz de usuario

Construye tu frontend React/Next.js con componentes pre-construidos para interfaces de chat, tablas de datos, formularios y paneles. El SDK TypeScript proporciona seguridad de tipos completa.

  • Usa la biblioteca de componentes Forge UI (50+ componentes pre-construidos)
  • Implementa chat en tiempo real con streaming WebSocket
  • Crea tablas de datos con scroll infinito y filtros
  • Añade carga de archivos con integración VideoAgent/FileProcessAgent
  • Construye paneles con gráficos y métricas
5

Funciones Avanzadas

3-4 días · Añade capacidades especializadas

Procesamiento de Video

Imágenes médicas, recorridos de propiedades, deposiciones

Funciones Geoespaciales

Mapas, rutas, búsqueda basada en ubicación

Inteligencia de Documentos

OCR, extracción de formularios, análisis de contratos

Notificaciones

Email, SMS, notificaciones push, webhooks

6

Pruebas y QA

2-3 días · Asegura calidad y rendimiento

Pruebas Unitarias
80%+
Vitest
Pruebas de Integración
Rutas críticas
Playwright
Pruebas de Carga
1000+ usuarios
k6
7

Despliegue

1-2 días · Envía a producción

$ forge deploy --environment production

✓ Running pre-deployment checks...
✓ Building Docker images...
✓ Pushing to registry...
✓ Updating Kubernetes...
✓ Running smoke tests...
✓ Health checks passing...

🎉 Deployed to: https://my-vertical.adverant.cloud
📊 Dashboard: https://my-vertical.adverant.cloud/admin
📈 Metrics: https://metrics.adverant.cloud/my-vertical
Sin tiempo de inactividad
1-1000+ usuarios
Auto-escalado
Integrado
Monitoreo

¿Listo para Construir?

Instala Nexus-Forge y comienza a construir tu vertical hoy. Los 18 servicios core incluidos.

2-4sem
Tiempo de Construcción
18
Servicios Core
550+
Endpoints API
1M+
Usuarios por App