====== 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.