Initial commit

docs/adr/010-commandes-volant.md

@@ -0,0 +1,46 @@
+# ADR-010 : Commandes au volant et likes
+
+**Statut** : Accepté
+**Date** : 2026-01-20
+
+## Contexte
+
+RoadWave est utilisée en conduisant. Les utilisateurs doivent pouvoir liker du contenu pour améliorer les recommandations, mais les commandes au volant ont des limitations :
+- 40% des véhicules n'ont que Suivant/Précédent/Mute
+- iOS/Android ne supportent pas nativement les appuis longs ou doubles-appuis
+- La sécurité impose des interactions minimales
+
+## Décision
+
+**Like automatique basé sur le temps d'écoute**.
+
+Règles :
+- ≥80% d'écoute → Like renforcé (+2 points)
+- 30-79% d'écoute → Like standard (+1 point)
+- <30% d'écoute → Pas de like
+- Skip <10s → Signal négatif (-0.5 point)
+
+## Alternatives considérées
+
+| Option | Compatibilité | Sécurité | Complexité |
+|--------|---------------|----------|------------|
+| **Like automatique** | 100% | Maximale | Faible |
+| Double-tap Pause | ~80% | Moyenne | Moyenne |
+| Appui long Suivant | ~95% | Faible | Élevée |
+| Configuration paramétrable | 100% | Variable | Très élevée |
+
+## Justification
+
+- **Sécurité maximale** : Aucune action complexe en conduite
+- **Compatibilité universelle** : Fonctionne sur 100% des véhicules
+- **UX intuitive** : Comportement standard (Spotify, YouTube Music)
+- **Engagement** : Tous les contenus génèrent des signaux
+- **Simplicité** : Une seule logique à implémenter et maintenir
+
+## Conséquences
+
+- Tracking du temps d'écoute via le player audio
+- Calcul du score côté backend basé sur `completion_rate`
+- Communication onboarding : "Vos likes sont automatiques selon votre temps d'écoute"
+- Possibilité de like manuel depuis l'app (à l'arrêt)
+- Métriques à suivre : taux de complétion, distribution des scores, feedbacks utilisateurs