fix: integrate deepseek, resolve silent google api errors, fix google cloud keys

_bmad-output/planning-artifacts/marketing-brief.md

@@ -0,0 +1,267 @@
+# Brief Marketing — Office Translator
+
+**Auteur** : Mary (Business Analyst)
+**Date** : 2026-05-08
+**Statut** : Brouillon — à affiner avec Sepehr
+
+---
+
+## 1. Positionnement
+
+### 1.1 Énoncé de positionnement
+
+**Office Translator est le seul outil de traduction de documents qui combine préservation parfaite du formatage ET traduction IA contextuelle avec glossaires métier.**
+
+Pas seulement un traducteur. Un traducteur qui **comprend votre domaine** et vous rend un document **prêt à l'emploi**.
+
+### 1.2 Catégorie
+
+Traduction de documents professionnels — niche entre :
+- Les traducteurs génériques (Google Translate, DeepL) → bon marché mais pas de format
+- Les agences de traduction → qualité mais cher et lent
+- Les outils de localisation (Phrase, Crowdin) → complexes et B2B lourd
+
+**Notre sweet spot** : Professionnels et PME qui veulent de la qualité IA + du format préservé, sans l'overhead d'une agence.
+
+### 1.3 Taglines candidates
+
+| # | FR | EN | Ton |
+|---|---|---|---|
+| 1 | Traduisez vos documents. Gardez votre mise en page. | Translate your docs. Keep your layout. | Direct |
+| 2 | L'IA qui parle votre métier. | The AI that speaks your industry. | Différenciant |
+| 3 | Zéro retouche post-traduction. | Zero post-translation rework. | Bénéfice concret |
+| 4 | Vos documents, traduits par une IA qui comprend votre vocabulaire. | Your documents, translated by AI that knows your vocabulary. | Technique |
+
+**Recommandation** : #2 comme tagline secondaire (différenciant IA), #3 comme promesse principale (bénéfice concret).
+
+---
+
+## 2. Segments Cibles
+
+### 2.1 Segmentation primaire
+
+| Segment | Taille estimée | Pain point | Willingness to pay |
+|---|---|---|---|
+| **Ingénieurs CVC / HVAC** | Moyenne | Documents techniques mal traduits, termes spécifiques ignorés | Élevée (19-49€/mois) |
+| **Cabinets d'ingénierie multinationaux** | Grande | Contrats, rapports, spécifications en 3+ langues | Élevée (49€+ / mois) |
+| **Départements IT / DSI** | Grande | Documentation technique, wikis, procédures | Moyenne (9-19€/mois) |
+| **Cabinets juridiques internationaux** | Moyenne | Contrats multilingues, clauses précises | Élevée (19-49€/mois) |
+| **Professionnels de santé / pharma** | Moyenne | Protocoles, notices, rapports cliniques | Élevée (19-49€/mois) |
+| **Freelances traducteurs** | Grande | Gain de productivité sur le post-traduction | Faible (9€/mois) |
+
+### 2.2 Persona prioritaire #1 — L'ingénieur technique
+
+- **Qui** : Ahmed, 35 ans, ingénieur CVC dans un bureau d'études franco-anglophone
+- **Où** : Paris, Lyon, Casablanca, Dubaï
+- **Pain** : Reçoit des spécifications techniques en anglais, doit les partager en français. Google Translate traduit "batterie" par "battery" au lieu de "coil". Passe 2h à corriger la mise en page.
+- **Solution** : Glossaire HVAC intégré + IA contextuelle + format préservé
+- **Canal** : LinkedIn, forums techniques HVAC, Google "traduction document technique"
+
+### 2.3 Persona prioritaire #2 — La PME internationale
+
+- **Qui** : Sophie, 42 ans, directrice juridique dans une PME franco-allemande
+- **Où** : France, Allemagne, Suisse
+- **Pain** : Contrats en FR/DE/EN à maintenir. Chaque traduction = 3 jours avec agence externe à 0.12€/mot.
+- **Solution** : Traduction instantanée avec glossaire juridique + API pour automatiser
+- **Canal** : Google "traduction contrat juridique", LinkedIn B2B, partenaires chambers of commerce
+
+---
+
+## 3. Messages Clés
+
+### 3.1 Hiérarchie des messages
+
+```
+NIVEAU 1 — Promesse principale
+"Zéro retouche post-traduction"
+→ Le format est identique. Vous téléchargez, vous envoyez.
+
+NIVEAU 2 — Différenciateur IA
+"L'IA qui comprend votre vocabulaire métier"
+→ Glossaires personnalisés, contexte technique, vision sur images.
+
+NIVEAU 3 — Preuves
+- Comparaison avant/après (Google vs IA)
+- Démonstration interactive sur la landing
+- Témoignages clients
+
+NIVEAU 4 — Confiance
+- Fichiers supprimés après traitement
+- Pas de bait-and-switch sur les prix
+- Aperçu du document avant traduction
+```
+
+### 3.2 Messages par segment
+
+| Segment | Accroche | Bénéfice secondaire |
+|---|---|---|
+| Ingénieurs CVC | "CTA, batterie, groupe froid — votre glossaire, votre traduction" | Format Excel préservé : cellules fusionnées, formules, couleurs |
+| Juridique | "Contrats traduits en 30 secondes, pas 3 jours" | Clauses exactes, terminologie légale certifiée |
+| IT | "Documentation technique traduite à la volée" | API REST pour intégration CI/CD, webhooks |
+| Santé | "Protocoles cliniques multilingues sans erreur" | Glossaire médical intégré, conformité terminologique |
+
+---
+
+## 4. Canaux d'Acquisition
+
+### 4.1 Canaux digitaux (court terme)
+
+| Canal | Action | Budget estimé | ROI attendu |
+|---|---|---|---|
+| **SEO** | Pages dédiées "traduction [format] [langue]" | 0€ (temps) | Élevé, long terme |
+| **Google Ads** | Campagnes "traduction document", "translate xlsx" | 200-500€/mois | Moyen, immédiat |
+| **Product Hunt** | Lancement coordonné | 0€ | Fort en visibilité |
+| **Reddit** | Posts sur r/translator, r/hvac, r/sysadmin | 0€ | Moyen |
+| **LinkedIn** | Posts techniques + cas d'usage | 0€ (organique) | Moyen |
+| **Alternatives.to** | Listing sur les sites de comparaison | 0€ | Moyen |
+
+### 4.2 Contenu SEO — Pages à créer
+
+Ces pages capturent l'intention de recherche "long tail" à forte conversion :
+
+| URL cible | Titre SEO | Mot-clé principal |
+|---|---|---|
+| `/translate/xlsx-to-english` | Traduire un fichier Excel en anglais en gardant le format | traduire xlsx anglais |
+| `/translate/docx-french-english` | Traduction Word français-anglais — format préservé | traduction word français anglais |
+| `/translate/pptx-online` | Traduire PowerPoint en ligne gratuitement | traduire powerpoint en ligne |
+| `/translate/hvac-documents` | Traduction de documents techniques CVC/HVAC | traduction documents techniques |
+| `/translate/legal-documents` | Traduction de contrats et documents juridiques | traduction contrats juridiques |
+| `/translate/pdf-online` | Traduire un PDF en ligne en gardant la mise en page | traduire pdf en ligne |
+
+### 4.3 Partenariats (moyen terme)
+
+| Partenaire | Type | Action |
+|---|---|---|
+| Chambers of commerce franco-étrangères | Visibilité | Offrir des essais Pro aux membres |
+| Éditeurs de logiciels CVC (Danfoss, Carrier) | Intégration | Plugin/glossaire pré-intégré |
+| Écoles de traduction | Éducation | Licence académique gratuite |
+| Plateformes freelance (Upwork, Malt) | Distribution | Profil "outil recommandé" |
+
+---
+
+## 5. Stratégie de Contenu
+
+### 5.1 Blog — Sujets prioritaires
+
+| # | Titre | Segment | Funnel |
+|---|---|---|---|
+| 1 | "Pourquoi Google Translate ruine vos documents Excel" | Tous | Top of funnel |
+| 2 | "CTA, AHU ou Call To Action ? Comment l'IA traduit le jargon technique" | Ingénieurs | Top of funnel |
+| 3 | "Traduction automatique vs agence : le calcul qui tue" | PME | Milieu de funnel |
+| 4 | "Comment automatiser la traduction de 200 documents/mois avec notre API" | IT | Bottom of funnel |
+| 5 | "5 erreurs de traduction juridique qui coûtent cher" | Juridique | Top of funnel |
+| 6 | "DeepSeek V3 vs Claude 3.5 : quel modèle pour quelle traduction ?" | Tech-savvy | Milieu de funnel |
+
+### 5.2 Contenu vidéo
+
+| Contenu | Plateforme | Durée | Objectif |
+|---|---|---|---|
+| Démo 60 secondes — upload → download | YouTube, Landing | 60s | Conversion landing |
+| "Glossaire en action" — comparaison temps réel | YouTube | 3 min | Différenciation |
+| Tutoriel API pour développeurs | YouTube | 10 min | Adoption API |
+
+### 5.3 Comparaison concurrentielle (landing / blog)
+
+| vs | Notre avantage | Leur avantage |
+|---|---|---|
+| **Google Translate** | Format préservé, glossaires, IA contextuelle | Gratuit, connu |
+| **DeepL** | Glossaires personnalisés, multi-format (xlsx, pptx), API | Qualité brute supérieure sur certains couples |
+| **DocTranslator** | IA contextuelle, glossaires, vision sur images | Gratuit |
+| **Smartcat** | Simplicité d'usage, pas d'onboarding, pricing transparent | Features TMS avancées (TM, QA) |
+| **Traduction agence** | Instantané, 100x moins cher, API | Qualité humaine certifiée |
+
+---
+
+## 6. Stratégie Tarifaire — Positionnement Marketing
+
+### 6.1 Narratif pricing
+
+**Free** → "Essayez sans risque" (5 documents, Google Translate, format préservé)
+**Starter (9€)** → "Pour les professionnels réguliers" (50 documents, DeepL, plus de pages)
+**Pro (19€)** → "L'IA entre en jeu" (200 documents, IA contextuelle, glossaires, vision)
+**Business (49€)** → "Pour les équipes" (1000 documents, API, support priorisé)
+**Enterprise** → "Sur mesure"
+
+### 6.2 Levier de conversion principal
+
+Le chemin de conversion idéal :
+
+```
+Free user découvre l'IA (Phase 3 du CdC)
+→ 5 crédits IA gratuits
+→ Goûte à la qualité supérieure
+→ Crédits épuisés
+→ CTA "Continuez avec l'IA — Passez au plan Pro"
+→ Conversion à 19€/mois
+```
+
+### 6.3 Messaging upgrade
+
+| Moment | Message | CTA |
+|---|---|---|
+| Provider selector LLM verrouillé | "L'IA contextuelle traduit en comprenant votre domaine" | "Découvrir le plan Pro" |
+| Crédits IA épuisés | "Vous avez utilisé vos 5 essais IA ce mois-ci" | "Débloquer l'IA" |
+| Post-traduction (provider classic) | "Une traduction IA aurait compris 'batterie' = 'coil'" | "Essayer l'IA gratuitement" |
+| Dashboard, usage > 80% du quota | "Vous approchez de votre limite mensuelle" | "Voir les plans supérieurs" |
+
+---
+
+## 7. Calendrier Marketing Proposé
+
+### Semaine 1-2 : Fondations
+- [ ] Finaliser le CdC design/IA (document ci-joint)
+- [ ] Préparer les assets visuels (comparaison avant/après, captures d'écran)
+- [ ] Rédiger les 5 premiers articles blog
+- [ ] Créer les profils sur les sites de comparaison (AlternativeTo, etc.)
+
+### Semaine 3-4 : Lancement Landing
+- [ ] Déployer Phase 1 + 2 du CdC (i18n + section IA)
+- [ ] Mettre en ligne les pages SEO (translate/xlsx, translate/docx, etc.)
+- [ ] Soumettre le sitemap mis à jour à Google Search Console
+
+### Semaine 5-6 : Freemium IA
+- [ ] Déployer Phase 3 (freemium IA + mini-playground)
+- [ ] Lancer la campagne Google Ads sur mots-clés traduction
+- [ ] Préparer le lancement Product Hunt
+
+### Semaine 7-8 : Amplification
+- [ ] Lancement Product Hunt
+- [ ] Campagne LinkedIn organique (3 posts/semaine)
+- [ ] Publication des articles blog (1/semaine)
+- [ ] Suivi des métriques : trafic, conversion Free→Pro, coût d'acquisition
+
+### KPIs à suivre
+
+| Métrique | Outil | Fréquence |
+|---|---|---|
+| Trafic landing | Google Analytics | Hebdo |
+| Taux de conversion Free→Pro | Stripe + Dashboard | Hebdo |
+| Utilisation des crédits IA Free | Dashboard admin | Hebdo |
+| Position SEO mots-clés cibles | Google Search Console | Mensuel |
+| Coût par acquisition (ads) | Google Ads | Hebdo |
+| Net Promoter Score | Email survey | Trimestriel |
+
+---
+
+## 8. Budget Marketing Mensuel (Phase initiale)
+
+| Poste | Coût mensuel | Notes |
+|---|---|---|
+| Google Ads | 200-500€ | Mots-clés traduction, CPC 0.50-1.50€ |
+| Contenu (articles, vidéos) | 0€ (interne) | Temps Sepehr |
+| Outils (Analytics, Search Console) | 0€ | Gratuits |
+| Product Hunt launch | 0€ | Gratuit |
+| **Total** | **200-500€/mois** | Phase bootstrap |
+
+---
+
+## 9. Prochaines Étapes
+
+1. **Valider le CdC design/IA** — Prioriser les phases et lancer le développement
+2. **Affiner ce brief marketing** — Sélectionner les taglines, valider les personas
+3. **Préparer le contenu SEO** — Rédiger les pages translate/ et les premiers articles
+4. **Configurer le tracking** — Google Analytics + Search Console avant le lancement
+
+---
+
+*Ce brief est un document vivant — à affiner au fil des retours utilisateurs et des métriques.*