GUIDE COMPLET

Construisez Votre Propre
Application Verticale

Guide étape par étape pour construire des applications IA verticales en santé, juridique, immobilier ou tout autre domaine en utilisant les 18 services du Stack Core. De zéro à la production.

Services Core

Phases

2-4sem

Délai

Ce que vous apprendrez

Configuration et Architecture

2-3 jours

Modèle de Données et Auth

3-4 jours

Intégration IA

4-5 jours

Construction du Frontend

4-5 jours

Fonctionnalités Avancées

Configuration et Architecture

2-3 jours · Mise en place des fondations et planification verticale

Nouveau sur Nexus CLI ?

Ce guide utilise abondamment Nexus CLI. Si vous ne l'avez pas encore installé ou souhaitez en savoir plus sur les 60+ commandes disponibles, les modèles et les fonctionnalités avancées, consultez la documentation CLI complète.

Voir la documentation CLI

1.1. Installer Nexus-Forge

Installez Nexus-Forge CLI qui fournit tous les outils de développement, la configuration Docker Compose et l'intégration Claude Desktop.

npm install -g @adverant/nexus-forge
forge --version  # Verify installation

Prérequis : Node.js 18+, Docker Desktop actif, 8 Go+ de RAM disponible

1.2. Créer Votre Projet Vertical

Choisissez un modèle vertical ou commencez à partir de zéro. Les modèles incluent des modèles de données, des routes API et des exemples de requêtes pour des secteurs spécifiques.

# 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

🏥

Modèle Santé

Patients, rendez-vous, EHR, conformité HIPAA

⚖️

Modèle Juridique

Dossiers, documents, clients, gestion des affaires

🏠

Modèle Immobilier

Annonces, locataires, baux, maintenance

⚡

Modèle Vierge

Partir de zéro avec le Stack Core uniquement

1.3. Comprendre les Services Core Disponibles

Les 18 services core sont automatiquement disponibles. Voici ce que chacun offre pour votre vertical :

Mémoire GraphRAG

Stocker les dossiers patients, les affaires juridiques, les données immobilières

Passerelle LLM MageAgent

Interfaces de chat, analyse de documents, résumés

Orchestration Multi-Agents

Workflows complexes, recherches multi-étapes

Intelligence Vidéo

Imagerie médicale, visites de propriétés, dépositions

Traitement de Documents

PDFs, scans, contrats, formulaires

Service Géospatial

Localisations de propriétés, zones de service, routage

Auth et RBAC

Espaces de travail multi-tenant, permissions utilisateur

API Gateway

Limitation de débit, répartition de charge, routage

Voir les 18 services core →

Modèle de Données et Authentification

3-4 jours · Définir vos structures de données et contrôle d'accès

2.1. Concevoir Votre Schéma GraphRAG

Définissez les types d'entités, les relations et les embeddings vectoriels pour votre vertical. GraphRAG fournit à la fois PostgreSQL (structuré) et Neo4j (graphe) pour le stockage.

// 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. Configurer l'Auth Multi-Tenant

Configurez les espaces de travail, rôles et permissions. Le service Auth gère automatiquement les tokens JWT, l'intégration SSO et l'isolation des espaces de travail.

// 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

Intégration IA

4-5 jours · Connecter les LLMs et construire des fonctionnalités intelligentes

3.1. Configurer les Modèles IA

Choisissez les modèles IA à utiliser pour différentes tâches. MageAgent donne accès à plus de 320 modèles d'OpenRouter, Anthropic et OpenAI avec routage intelligent pour réduire les coûts.

// 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. Construire des Workflows Multi-Agents

Créez des workflows où plusieurs agents IA collaborent. Exemple : workflow de diagnostic médical avec des agents d'analyse de symptômes, de recherche et de recommandation.

// 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

Construction du Frontend

4-5 jours · Créer l'interface utilisateur

Construisez votre frontend React/Next.js avec des composants préconstruits pour les interfaces de chat, les tableaux de données, les formulaires et les tableaux de bord. Le SDK TypeScript offre une sécurité de type complète.

Utiliser la bibliothèque de composants Forge UI (50+ composants préconstruits)
Implémenter le chat en temps réel avec le streaming WebSocket
Créer des tableaux de données avec scroll infini et filtres
Ajouter le téléchargement de fichiers avec l'intégration VideoAgent/FileProcessAgent
Construire des tableaux de bord avec graphiques et métriques

Fonctionnalités Avancées

3-4 jours · Ajouter des capacités spécialisées

Traitement Vidéo

Imagerie médicale, visites de propriétés, dépositions

Fonctionnalités Géospatiales

Cartes, routage, recherche par localisation

Intelligence Documentaire

OCR, extraction de formulaires, analyse de contrats

Notifications

Email, SMS, notifications push, webhooks

Tests et QA

2-3 jours · Assurer la qualité et la performance

Tests Unitaires

80%+

Vitest

Tests d'Intégration

Chemins critiques

Playwright

Tests de Charge

1000+ utilisateurs

Déploiement

1-2 jours · Mettre en production

$ 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

✓

Zéro downtime

1-1000+ utilisateurs

Auto-scaling

Intégré

Surveillance

Prêt à Construire ?

Installez Nexus-Forge et commencez à construire votre vertical dès aujourd'hui. Les 18 services core sont inclus.

Installer Nexus-Forge Voir le Stack Core

2-4sem

Délai de Construction

Services Core

550+

Points d'API

1M+

Utilisateurs Par App

Construisez Votre PropreApplication Verticale

Ce que vous apprendrez

Configuration et Architecture

Nouveau sur Nexus CLI ?

1.1. Installer Nexus-Forge

1.2. Créer Votre Projet Vertical

1.3. Comprendre les Services Core Disponibles

Modèle de Données et Authentification

2.1. Concevoir Votre Schéma GraphRAG

2.2. Configurer l'Auth Multi-Tenant

Intégration IA

3.1. Configurer les Modèles IA

3.2. Construire des Workflows Multi-Agents

Construction du Frontend

Fonctionnalités Avancées

Traitement Vidéo

Fonctionnalités Géospatiales

Intelligence Documentaire

Notifications

Tests et QA

Déploiement

Prêt à Construire ?

Construisez Votre Propre
Application Verticale