Data-Insight

Guide Utilisateur - Agrégateur de données narratif

FP2E / Sèmè City

Introduction

Data-Insight est un système intelligent d'agrégation et d'analyse de données pour les centres LTA et UEVP. Il transforme vos fichiers Excel et CSV en une base de connaissances interrogeable, générant des rapports narratifs en français.

Fonctionnalités principales

Sécurité des données : Toutes les données sensibles (noms, emails, téléphones) sont automatiquement anonymisées avant traitement.

Démarrage rapide

1
Accédez à l'application

Ouvrez https://datainsight.srv1164291.hstgr.cloud dans votre navigateur.

2
Importez vos données

Utilisez l'endpoint /api/ingest pour charger vos fichiers Excel ou CSV.

3
Posez vos questions

Interrogez la base via /api/query avec vos questions en français.

4
Obtenez vos rapports

Recevez des réponses narratives prêtes à être intégrées dans vos Aide-Mémoire.

Importer des données

Formats supportés

FormatExtensionNotes
Microsoft Excel.xlsx, .xlsRecommandé
CSV.csvUTF-8 encodé

Structure recommandée

Vos fichiers doivent contenir des en-têtes de colonnes clairs :

| Centre | Période | Indicateur | Valeur | Commentaire |
|--------|---------|------------|--------|-------------|
| LTA-1  | 2024-Q1 | Inscrits   | 150    | Hausse 10%  |
| UEVP-2 | 2024-Q1 | Diplômés   | 45     | Objectif OK |

Via l'API

curl -X POST https://datainsight.srv1164291.hstgr.cloud/api/ingest \
  -F "file=@donnees_lta.xlsx" \
  -F "collection=lta_2024"
Important : Les fichiers volumineux (>10MB) peuvent prendre quelques minutes à traiter.

Interroger la base

Exemples de questions

Via l'API

curl -X POST https://datainsight.srv1164291.hstgr.cloud/api/query \
  -H "Content-Type: application/json" \
  -d '{"question": "Résumé des performances Q1 2024"}'

Réponse type

{
  "answer": "Au premier trimestre 2024, les centres LTA ont enregistré
             une progression de 12% des inscriptions...",
  "sources": ["donnees_lta.xlsx", "rapport_q1.csv"]
}

Génération de rapports

Data-Insight génère des rapports narratifs structurés, prêts à être intégrés dans vos documents Aide-Mémoire.

Format de sortie

Contenu type d'un rapport

# Rapport de synthèse - Q1 2024

> Généré le 15/01/2025

## Synthèse générale

Les centres de formation ont enregistré une activité
soutenue au premier trimestre 2024...

## Indicateurs clés

- Inscriptions totales : 1,250 (+8%)
- Taux de complétion : 78%
- Satisfaction moyenne : 4.2/5

## Recommandations

1. Renforcer l'accompagnement du centre LTA-3
2. Étendre le programme pilote UEVP...

Référence API

Endpoint Méthode Description
/health GET Vérifie l'état du service
/api/ingest POST Importe un fichier Excel/CSV
/api/query POST Interroge la base de connaissances
/api/collections GET Liste les collections disponibles
/api/stats GET Statistiques de la base
/docs GET Documentation Swagger interactive
Documentation interactive : Accédez à Swagger UI pour tester les endpoints directement.

Questions fréquentes

Mes données sont-elles sécurisées ?

Oui. Les données sont stockées localement sur le serveur. Les informations personnelles (noms, emails, téléphones) sont automatiquement anonymisées avant tout traitement par l'IA.

Quels types de fichiers puis-je importer ?

Excel (.xlsx, .xls) et CSV (.csv). Les fichiers doivent être encodés en UTF-8 pour les CSV.

Combien de temps prend l'import ?

Quelques secondes pour les petits fichiers (<1000 lignes), jusqu'à quelques minutes pour les fichiers volumineux.

Puis-je supprimer des données ?

Oui, contactez l'administrateur pour supprimer une collection spécifique.

L'IA a-t-elle accès aux données brutes ?

Non. L'IA (Gemini) ne reçoit que des extraits anonymisés pertinents pour répondre à votre question. Aucune donnée nominative n'est transmise.