Table des matières
Sprint 13 — Optimisation, IA & Automatisation
Objectif du Sprint
Introduire les premières capacités d'intelligence artificielle et d'automatisation avancée afin d'améliorer :
- La productivité des gestionnaires
- La qualité des données
- La rapidité de traitement
- L'expérience client
- L'aide à la décision
À l'issue du Sprint 13 :
- Des recommandations sont générées automatiquement
- Les prévisions sont enrichies par l'IA
- Les documents sont analysés automatiquement
- Les équipes disposent d'un assistant conversationnel interne
- Les tâches répétitives sont automatisées
Ce sprint inaugure la première couche d'intelligence métier de la plateforme.
Principes d'architecture IA
Objectif
L'IA n'est pas utilisée pour prendre des décisions à la place des utilisateurs.
Elle fournit :
- Suggestions
- Classements
- Résumés
- Recommandations
- Détections d'anomalies
La décision finale reste humaine.
Périmètre
Modules concernés
AutomationModule RecommendationModule AiAssistantModule ForecastingModule DocumentAnalysisModule KnowledgeBaseModule
Architecture cible
Utilisateurs ↓ API IA ↓ Orchestrateur IA ├── LLM ├── Moteur RAG ├── Analyse documentaire ├── Recommandations └── Automatisations ↓ Base métier CRM Réservations Contrats Paiements Reporting
User Stories
US-1301 : Générer une description de bien
En tant que gestionnaire
Je souhaite générer automatiquement une description
Afin d'accélérer la création d'annonces.
Endpoint
POST /ai/properties/generate-description
Données
Type bien Surface Ville Équipements Capacité
Résultat
Titre optimisé Description courte Description détaillée
US-1302 : Générer des suggestions SEO
Objectif
Améliorer la visibilité des annonces.
Suggestions
Titre Mots-clés Meta description Balises SEO
Recommandations
US-1303 : Recommander des biens
Utilisation
Sur le Front Office.
Critères
Historique client Préférences Localisation Capacité Budget
Endpoint
GET /recommendations/properties
US-1304 : Recommander des actions commerciales
Exemple
Prospect inactif ↓ Relance recommandée
Assistant IA
US-1305 : Assistant Back Office
Objectif
Répondre aux questions métier.
Exemple
"Quels sont les biens les moins occupés ?" "Quels propriétaires ont généré le plus de revenus ?" "Quelles réservations nécessitent une action ?"
Endpoint
POST /ai/chat
US-1306 : Recherche documentaire
Sources
Contrats Factures Réservations CRM Documentation interne
Technologie
RAG (Vector Search)
Analyse documentaire
US-1307 : Analyser un document
Types
Pièce identité Passeport Facture Contrat Justificatif domicile
Fonctionnalités
OCR Extraction données Validation
Endpoint
POST /ai/document-analysis
US-1308 : Vérifier la cohérence d'un dossier
Exemple
Nom contrat = Nom pièce identité
Prévisions avancées
US-1309 : Prévision de revenus
Objectif
Améliorer le module Reporting.
Sources
Historique Occupation Saisonnalité Tarification
Endpoint
GET /forecasting/revenue
US-1310 : Prévision d'occupation
Horizon
30 jours 90 jours 12 mois
Automatisation
US-1311 : Automatiser les relances
Cas
Contrat non signé Paiement en retard Document manquant
Workflow
Détection ↓ Notification ↓ Relance ↓ Suivi
US-1312 : Génération automatique de tâches
Exemple
Réservation créée ↓ Créer tâche Check-In
US-1313 : Résumé automatique
Exemple
Historique client ↓ Résumé IA
Base de connaissances
US-1314 : Indexer la documentation
Sources
Wiki Contrats Procédures FAQ
Objectif
Permettre les réponses contextuelles.
Architecture Backend
src/modules/ai ├── assistant │ ├── recommendations │ ├── forecasting │ ├── automations │ ├── document-analysis │ └── knowledge-base
Domain Services
AiAssistantService RecommendationService ForecastingService AutomationService DocumentAnalysisService KnowledgeBaseService
Modèle Prisma
AiConversation
model AiConversation {
id String @id @default(uuid())
userId String
title String?
createdAt DateTime @default(now())
}
AiMessage
model AiMessage {
id String @id @default(uuid())
conversationId String
role String
content String
createdAt DateTime
}
KnowledgeDocument
model KnowledgeDocument {
id String @id @default(uuid())
title String
sourceType String
embeddingId String?
}
AutomationRule
model AutomationRule {
id String @id @default(uuid())
code String
active Boolean
}
Intégrations IA
LLM
Options compatibles :
OpenAI Azure OpenAI Anthropic Mistral
OCR
Tesseract AWS Textract Google Vision
Recherche vectorielle
PostgreSQL pgvector ou Qdrant ou Weaviate
Événements métier
DocumentAnalyzed
DocumentAnalyzed
RecommendationGenerated
RecommendationGenerated
AutomationTriggered
AutomationTriggered
Sécurité IA
Restrictions
L'assistant IA :
- Respecte les permissions RBAC
- Ne voit que les données autorisées
- Journalise toutes les requêtes
- N'accède jamais aux secrets techniques
Audit
Toutes les interactions IA sont historisées :
Utilisateur Question Réponse Date Contexte utilisé
Swagger
Tags
AI Recommendations Forecasting Automations DocumentAnalysis
Volume API
Environ :
20 endpoints
Frontend
Pages
/assistant /recommendations /forecasts /automations /knowledge-base
Composants
AiChat RecommendationPanel ForecastChart AutomationBuilder DocumentAnalyzer
Tests
Unitaires
RecommendationService ForecastingService AutomationService DocumentAnalysisService
Intégration
Document Upload ↓ Analyse ↓ Extraction ↓ Validation
E2E
Question assistant ↓ Recherche RAG ↓ Réponse contextualisée ↓ Historisation
Définition de terminé
Le Sprint 13 est terminé lorsque :
- Assistant IA opérationnel
- Recommandations opérationnelles
- Prévisions enrichies opérationnelles
- Analyse documentaire opérationnelle
- Automatisations opérationnelles
- Base documentaire indexée
- Swagger à jour
- Tests verts
- CI verte
Livrables
- AiAssistantModule
- RecommendationModule
- ForecastingModule
- AutomationModule
- DocumentAnalysisModule
- KnowledgeBaseModule
- DTO
- Swagger
- Tests
- Migrations Prisma
Bilan Release 2.3
À l'issue du Sprint 13 :
- Plateforme SaaS multi-agence
- CRM intégré
- Reporting avancé
- Automatisations métier
- Intelligence artificielle embarquée
La plateforme entre dans une phase de différenciation concurrentielle forte.
Sprint suivant
Sprint 14 — API Publique & Écosystème
Objectif :
Ouvrir la plateforme aux partenaires et aux intégrations externes.
Modules concernés :
PublicApiModule PartnerModule WebhookModule ApiKeysModule MarketplaceModule
Fonctionnalités :
- API publique sécurisée
- Gestion des partenaires
- Webhooks
- Clés API
- Intégrations externes
- Marketplace de connecteurs
À l'issue du Sprint 14, la plateforme deviendra extensible et intégrable dans un écosystème tiers.