# Assistant IA Omni

> Posez vos questions sur la fréquentation, les réservations, les produits et les clients de votre établissement.

## Pour qui ? [#pour-qui-]

Pour toi, chef d'entreprise, manager de salle, ou responsable marketing qui veut :

- 📊 Des analyses en temps réel sans se prendre la tête
- ⏱️ Gagner du temps sur les tâches répétitives
- 🎯 Prendre de meilleures décisions basées sur des données

## L'objectif [#lobjectif]

Omni est ton **collègue numérique** qui connaît tout de ton restaurant. Pose-lui n'importe quelle question sur tes données, il te répond avec des chiffres clairs et des jolis graphiques !

---

## Avant de commencer [#avant-de-commencer]

Rien de spécial ! Tu dois juste être connecté à ton tableau de bord Menyu. C'est tout ! 🎉

---

## Comment accéder à Omni [#comment-accéder-à-omni]

**Point d'entrée :** `/dashboard/ai` (clique sur "AI" dans le menu latéral)

Ou plus simple : clique sur l'icône 🤖 dans la barre latérale de ton tableau de bord.

---

## Ton premier échange avec Omni [#ton-premier-échange-avec-omni]

### L'écran d'accueil [#lécran-daccueil]

Quand tu arrives pour la première fois, tu vois :

- Un grand champ de texte avec le logo Menyu
- Des **boutons de suggestions** pour t'inspirer
- Un sélecteur de modèle IA (Omni ou Omni 2.0)

### Les suggestions prêtes à l'emploi 🚀 [#les-suggestions-prêtes-à-lemploi-]

Pas d'inspiration ? Clique sur l'une de ces suggestions :

| Suggestion                        | Ce que Omni va te montrer                           |
| --------------------------------- | --------------------------------------------------- |
| **Trafic cette semaine** 📈       | Combien de personnes ont consulté ton menu          |
| **Visiteurs en temps réel** 👀    | Qui est en train de regarder ton menu RIGHT NOW     |
| **Occupation à venir** 📅         | Les réservations des 7 prochains jours              |
| **Réservations d'aujourd'hui** 🪑 | Ton planning de tables pour aujourd'hui             |
| **Plats populaires** 🍕           | Vos stars du menu (ceux que tout le monde commande) |
| **Structure du menu** 📋          | Une analyse de ton menu (catégories, prix, etc.)    |
| **Panier moyen** 🛒               | Combien dépense en moyenne chaque client            |
| **Paniers abandonnés** 🚨         | Les commandes commencées mais pas finalisées        |

> 💡 **Astuce pro**  
> Même si tu cliques sur une suggestion, tu peux modifier la question avant d'envoyer ! C'est juste un point de départ.

---

## Comment lui parler [#comment-lui-parler]

### Écris-lui comme à un pote [#écris-lui-comme-à-un-pote]

Omni comprend le langage naturel. Pas besoin de formules compliquées !

**✅ Ce qui marche :**

- "Montre-moi mon chiffre d'affaires de la semaine dernière"
- "Quels sont les plats les moins commandés ?"
- "Compare le trafic entre lundi et samedi"
- "Donne-moi les réservations pour ce soir"

**❌ Ce qui est inutile :**

- Des requêtes SQL (Omni n'est pas une base de données brute !)
- Du langage trop technique
- Des abréviations incompréhensibles

### La zone de texte magique 💬 [#la-zone-de-texte-magique-]

En bas de l'écran de chat, tu trouves :

1. **Le champ de saisie** - Tape ta question ici
2. **Le bouton micro** 🎤 - Maintenez pour parler (au lieu d'écrire)
3. **Le bouton envoyer** ➤ - Ou appuie sur Entrée

> ⌨️ **Raccourcis clavier**
>
> - **Entrée** = Envoyer le message
> - **Shift + Entrée** = Aller à la ligne (si tu veux faire un message long)

---

## Les super-pouvoirs d'Omni [#les-super-pouvoirs-domni]

### 1. Les cartes de statistiques 📊 [#1-les-cartes-de-statistiques-]

Quand tu demandes des chiffres, Omni te montre des **cartes joliment designées** avec :

- Le chiffre clé en grand
- Une icône représentative
- Une tendance (en hausse 📈 ou en baisse 📉)
- Une petite description

**Exemple :** "Quel est mon panier moyen ?"
→ Omni affiche une carte avec le montant, une flèche verte si ça monte, et la comparaison avec la semaine dernière.

### 2. Les tableaux interactifs 📋 [#2-les-tableaux-interactifs-]

Pour les listes (réservations, commandes, clients...), Omni génère des tableaux :

- Triables (clique sur les en-têtes)
- Scrollables si c'est long
- Avec des couleurs pour bien visualiser

### 3. Le mode Push-to-Talk 🎤 [#3-le-mode-push-to-talk-]

T'es en train de courir entre les tables ? Pas le temps d'écrire ?

1. **Maintenez le bouton micro** en bas à gauche
2. **Parlez** clairement
3. **Relâchez** - Omni transcrit ta voix et envoie la question

> ⚠️ **Vérifie toujours**  
> La reconnaissance vocale fait parfois des erreurs. Relis ta question avant d'envoyer !

---

## Gérer tes conversations [#gérer-tes-conversations]

### L'historique 🕐 [#lhistorique-]

Omni garde en mémoire tous tes échanges. Pour y accéder :

1. Clique sur **"Historique"** en bas à gauche du chat
2. Une fenêtre s'ouvre avec toutes tes conversations passées
3. Clique sur celle que tu veux reprendre

**Ce que tu vois dans l'historique :**

- Le titre de la conversation (généré auto ou modifié par toi)
- La date de dernière modification
- Une icône ✨ si le titre a été généré par l'IA

### Renommer une conversation 📝 [#renommer-une-conversation-]

Par défaut, Omni donne un titre automatique à chaque conversation. Mais tu peux le changer :

1. Survole le titre dans l'historique
2. Clique sur le crayon ✏️
3. Tape ton nouveau titre
4. Valide avec Entrée ou le bouton ✅

### Nouvelle conversation 🆕 [#nouvelle-conversation-]

Pour partir de zéro (sans l'historique précédent) :

- Clique sur le bouton **"Nouveau"** en haut à droite du chat
- Ou recharge la page `/dashboard/ai`

> 💡 **Pourquoi faire ?**  
> Chaque conversation garde le contexte. Si tu poses une question sur les ventes, puis une autre sur les réservations, Omni comprend que ce sont des sujets liés. Pour repartir à zéro, crée une nouvelle conversation.

---

## Choisir ton modèle IA 🧠 [#choisir-ton-modèle-ia-]

Omni propose deux versions :

| Modèle       | Quand l'utiliser                                              |
| ------------ | ------------------------------------------------------------- |
| **Omni**     | Le standard, rapide et efficace pour la plupart des questions |
| **Omni 2.0** | Encore plus intelligent pour les analyses complexes           |

**Comment changer :**

1. Clique sur le sélecteur en bas à gauche (à côté du micro)
2. Choisis "Omni" ou "Omni 2.0"
3. C'est tout ! Le changement est instantané

---

## Ce que Omni peut faire pour toi [#ce-que-omni-peut-faire-pour-toi]

### 📈 Analytics & Trafic [#-analytics--trafic]

- "Combien de visiteurs aujourd'hui ?"
- "Quelle est l'heure de pointe sur mon menu ?"
- "Compare le trafic de cette semaine avec la semaine dernière"

### 🛒 Commandes & Ventes [#-commandes--ventes]

- "Quel est mon chiffre d'affaires du mois ?"
- "Montre-moi les commandes en attente"
- "Quels sont mes plats les plus rentables ?"

### 📅 Réservations [#-réservations]

- "Combien de tables ce soir ?"
- "Quels sont mes créneaux les plus demandés ?"
- "Montre-moi les annulations de la semaine"

### 🍽️ Menu & Produits [#️-menu--produits]

- "Analyse mes prix par rapport à la concurrence"
- "Quels produits ne se vendent pas ?"
- "Propose-moi des suggestions pour compléter mon menu"

### 👥 Clients [#-clients]

- "Qui sont mes clients les plus fidèles ?"
- "Montre-moi les nouveaux clients du mois"
- "Quelle est la satisfaction moyenne ?"

---

## Si ça bloque [#si-ça-bloque]

### "Omni ne répond pas" [#omni-ne-répond-pas]

**Solution :**

1. Vérifie ta connexion internet
2. Rafraîchis la page
3. Si ça persiste, crée une nouvelle conversation

### "La réponse est bizarre" [#la-réponse-est-bizarre]

**Solution :**

- Reformule ta question plus simplement
- Donne plus de contexte (dates, catégories...)
- Essaye le modèle Omni 2.0 pour plus de précision

### "Le micro ne marche pas" [#le-micro-ne-marche-pas]

**Vérifie :**

- Que ton navigateur a l'autorisation d'utiliser le micro
- Que tu maintiens bien le bouton pendant que tu parles
- Que tu parles assez fort et clairement

### "Je ne trouve pas une conversation" [#je-ne-trouve-pas-une-conversation]

**Solution :**

- L'historique affiche les 20 dernières conversations
- Scrolle vers le bas pour charger plus d'anciennes
- Utilise la barre de recherche (si disponible)

---

## Temps attendu [#temps-attendu]

| Action                   | Temps          |
| ------------------------ | -------------- |
| Réponse simple (texte)   | 2-5 secondes   |
| Génération de graphiques | 5-10 secondes  |
| Analyse complexe         | 10-20 secondes |
| Transcription vocale     | 1-3 secondes   |

> 💡 **Patience !**  
> Si Omni met plus de 30 secondes, c'est qu'il réfléchit très fort ou qu'il y a un problème. N'hésite pas à arrêter et recommencer.

---

## Schéma du flow [#schéma-du-flow]

```mermaid
flowchart TD
    A[Accès via /dashboard/ai] --> B{Première visite ?}
    B -->|Oui| C[Écran avec suggestions]
    B -->|Non| D[Reprend la conversation]

    C --> E[Clique sur une suggestion<br/>OU écris ta question]
    D --> E

    E --> F{Utilises-tu le micro ?}
    F -->|Oui| G[Maintenez le bouton<br/>Parlez<br/>Relâchez]
    F -->|Non| H[Tape ta question]

    G --> I[Transcription vocale]
    H --> J[Appuie sur Entrée]
    I --> K[Omni analyse...]
    J --> K

    K --> L{Réponse type}
    L -->|Texte| M[Réponse écrite]
    L -->|Stats| N[Carte de statistiques]
    L -->|Liste| O[Tableau interactif]
    L -->|Erreur| P[Message d'erreur<br/>avec explication]

    M --> Q{Besoin de suite ?}
    N --> Q
    O --> Q
    P --> Q

    Q -->|Oui| E
    Q -->|Non| R[Nouvelle conversation<br/>OU Historique]

    style C fill:#94E0CF,stroke:#059669
    style K fill:#F57802,stroke:#EA580C
    style P fill:#EC002D,stroke:#B91C1C,color:#fff
```

---

## Améliorations à venir 🚀 [#améliorations-à-venir-]

Ce qu'on prépare pour Omni :

- 📧 **Envoi de rapports** par email automatique
- 📱 **Notifications** quand un seuil est atteint
- 🎯 **Prédictions** ("Tu devrais avoir X clients demain")
- 🔗 **Intégrations** avec d'autres outils (Google Sheets, etc.)

---

## Questions fréquentes [#questions-fréquentes]

**Q : Est-ce que mes données sont sécurisées ?**
R : Oui ! Omni utilise tes données uniquement pour te répondre. Rien n'est partagé.

**Q : Puis-je exporter les réponses ?**
R : Pour l'instant, tu peux faire des captures d'écran. L'export PDF/Excel arrive bientôt !

**Q : Omni peut-il modifier mes données ?**
R : Non, Omni est en mode "lecture seule". Il ne peut que consulter, jamais modifier.

**Q : Que faire si je ne comprends pas une réponse ?**
R : Demande-lui de reformuler plus simplement ! Exemple : "Explique-moi comme si j'avais 10 ans"

---

## Besoin d'aide ? [#besoin-daide-]

Notre équipe est là pour toi :

- 💬 Chat en direct depuis le tableau de bord
- 📧 Email : support@menyu.club
- 📚 Centre d'aide complet

**Amuse-toi bien avec Omni !** 🎉

---

## Images à venir 📸 [#images-à-venir-]

- TODO: Capture de l'écran d'accueil Omni avec les suggestions
- TODO: Capture d'une conversation en cours avec une carte de stats
- TODO: Capture du tableau de réservations généré par Omni
- TODO: Capture de l'historique des conversations
- TODO: Capture du sélecteur de modèle Omni / Omni 2.0


