# NoteToQuote — FAQ

## Général

**Q : Combien coûte chaque génération de devis ?**
R : Cela dépend de votre plan. Le coût réel en tokens Claude varie entre 0,006 € (notes courtes, pas de catalogue) et 0,10 € (notes longues + photos + catalogue complet). Le backend filtre automatiquement le catalogue aux 50 produits les plus pertinents pour réduire les coûts.

**Q : Mes données de chantier sont-elles conservées par Anthropic ?**
R : Non. Anthropic n'entraîne pas ses modèles sur les données API des clients professionnels. Les notes et photos transitent par le backend et ne sont pas stockées (seules les métadonnées — nb photos, nb lignes, durée — sont conservées en base).

**Q : Le module fonctionne-t-il hors ligne ?**
R : Non. La génération nécessite une connexion Internet vers `api.lautram.com` (ou votre propre backend).

**Q : Combien de photos puis-je envoyer par génération ?**
R : Maximum 10 photos, 10 MB chacune. Les formats supportés sont JPEG, PNG, WebP et GIF. Les photos sont encodées en base64 côté PHP avant envoi.

---

## Qualité des résultats

**Q : L'IA se trompe sur les prix. Comment corriger ?**
R : Les prix incorrects sont signalés en orange avec le badge "Incomplet" dans la prévisualisation. Corrigez-les directement dans le tableau avant de confirmer.

**Q : Comment améliorer la qualité des descriptions ?**
R : Activez l'option "Descriptions détaillées" (3 à 5 phrases au lieu d'une). Pour de meilleurs résultats, soyez précis dans vos notes : mentionnez les matériaux, les dimensions approximatives, l'état des surfaces.

**Q : Le module ne trouve pas de correspondance dans mon catalogue.**
R : Vérifiez que les produits sont bien marqués "En vente" dans Dolibarr. Le filtrage est basé sur les mots-clés — si vos références produits sont des codes internes sans description lisible, le matching sera limité. Enrichissez les libellés de vos produits dans Dolibarr.

**Q : Peut-on regénérer si le résultat ne convient pas ?**
R : Oui. Depuis la prévisualisation, cliquez "Modifier les paramètres" pour revenir au formulaire et relancer avec des notes plus détaillées.

---

## Technique

**Q : Combien de temps prend une génération ?**
R : Généralement entre 5 et 30 secondes selon la longueur des notes et le nombre de photos. La connexion reste ouverte pendant 120 secondes max.

**Q : La génération a échoué avec "Erreur IA — réponse non exploitable". Que faire ?**
R : Réessayez. Cela arrive rarement quand le modèle retourne un format imprévu. Si le problème persiste avec les mêmes notes, simplifiez-les ou retirez des photos.

**Q : Comment configurer les alertes quota ?**
R : Dans le backend, configurer `ALERT_WEBHOOK_URL` vers un endpoint Make/n8n/Zapier. Le backend enverra un JSON `{event, email, plan, usage_month, quota_month, pct}` à 80% et 100% du quota mensuel. Côté Make/n8n, vous pouvez ensuite envoyer un email avec ces données.

**Q : Comment consulter l'historique des générations ?**
R : Dans Dolibarr → Commercial → Propositions → **Historique** (sous-menu NoteToQuote). Chaque génération réussie est enregistrée avec date, utilisateur, durée et lien vers le devis créé.

**Q : Le module est-il compatible avec Dolibarr multi-société ?**
R : Oui. Le catalogue produits et les devis sont filtrés par `entity` (la société Dolibarr active).

---

## Facturation et licences

**Q : Ma clé de licence fonctionne-t-elle sur plusieurs instances Dolibarr ?**
R : Par défaut oui. Une restriction par IP peut être configurée côté backend si vous souhaitez limiter l'usage à une seule instance.

**Q : Le quota se remet-il à zéro automatiquement ?**
R : Oui, le 1er de chaque mois à minuit UTC.

**Q : Que se passe-t-il si j'atteins mon quota en cours de mois ?**
R : Les nouvelles générations retournent une erreur "Quota dépassé". Les devis déjà créés ne sont pas affectés. Contactez lautram.com pour augmenter le quota ou attendre le renouvellement mensuel.