AudiOhm/archives/docs/TEST_SUITE.md

🧪 Jeu de Tests AudiOhm

Date: 2026-01-19 Status: ✅ Tests fonctionnels

---

📋 Tests Automatisés

Tests Backend (backend/test_audiOhm.py)

cd /opt/audiOhm/backend
python3 test_audiOhm.py

Résultats:

• ✅ TEST 1: Connexion Base de Données - PASS
• ✅ TEST 2: Vérification des Tables - PASS
• ✅ TEST 3: Service YouTube (recherche) - PASS
• ✅ TEST 4: Service Musique (recherche) - PASS
• ✅ TEST 5: Téléchargement Audio YouTube - PASS (9.62 MB téléchargé)
• ⚠️ TEST 6: Stream URL - SKIP (méthode non utilisée)

Bilan: 5/5 tests essentiels passent

---

Tests Frontend/API (frontend/test_runner.sh)

bash /opt/audiOhm/frontend/test_runner.sh

Résultats:

• ✅ TEST 1: Vérification Serveur - PASS
• ✅ TEST 2: Authentification - PASS
• ✅ TEST 3: API Trending - PASS
• ✅ TEST 4: Recherche Musique - PASS
• ⏳ TEST 5: Endpoint Stream - Timeout normal (téléchargement long)

Bilan: 4/4 tests rapides passent

---

📝 Tests Manuels Requis

Une fois les tests auto passés, effectuez ces tests manuels dans le navigateur:

1. Interface Utilisateur

URL: http://localhost:8000

Actions:

• Page se charge correctement
• Écran de connexion affiché
• Design responsive (redimensionner fenêtre)
• Animations fluides

Identifiants:

• Email: admin@example.com
• Password: admin123

---

2. Authentification

Actions:

• Connexion réussie
• Accès à la page d'accueil
• Menu latéral visible
• Player visible en bas

---

3. Recherche Musique

Actions:

• Taper "music" dans la recherche rapide
• Appuyer sur Entrée
• Résultats s'affichent
• Spinner de chargement visible
• Nombre de résultats affiché
• Cover images visibles

---

4. Lecture Audio

Actions:

• Cliquer sur le bouton Play d'une piste
• Toast "Chargement de la piste..." apparaît
• Attendre 10-60 secondes (premier téléchargement)
• Toast "En lecture: [titre]" apparaît
• La musique démarre
• Player mis à jour (titre, artiste, cover)
• Bouton Play change en Pause

Note: Le premier téléchargement prend du temps! Les suivants sont instantanés (cache).

---

5. Contrôles du Player

Actions:

• Play/Pause fonctionne
• Barre de progression avance
• Clic sur la barre = seek fonctionne
• Volume + / - fonctionne
• Bouton Muet fonctionne
• Durée totale affichée
• Temps actuel affiché

---

6. Raccourcis Clavier

Actions:

• Space = Play/Pause
• → = Avancer 10s
• ← = Reculer 10s
• Shift + → = Piste suivante
• Shift + ← = Piste précédente
• ↑ = Volume +
• ↓ = Volume -
• M = Muet

---

7. Navigation

Actions:

• Cliquer sur "Bibliothèque"
• Page change sans rechargement
• Retour sur "Accueil"
• Menu mobile responsive (fenêtre < 768px)

---

8. Recherche Avancée

Actions:

• Aller dans la page "Rechercher"
• Taper un nom d'artiste connu
• Appuyer sur Entrée
• Résultats s'affichent
• Cliquer sur un résultat
• Lecture démarre

---

⚠️ Limitations Connues

Vidéos Non Supportées

Certaines vidéos YouTube ne peuvent pas être lues:

• Vidéos "Lyrics" (que des images, pas d'audio)
• Vidéos privées
• Vidéos avec restrictions géographiques
• Vidéos supprimées

Symptôme: Erreur 404 ou "Could not download audio"

Temps de Téléchargement

• Première écoute: 10-60 secondes (dépend de la durée vidéo)
• Écoutes suivantes: Instantané (fichier en cache)
• Vidéos longues (>1h): Peut prendre plusieurs minutes

Espace Disque

• Les fichiers MP3 sont stockés dans storage/audio/cache/
• Taille moyenne: ~5-10 MB par piste
• Nettoyer régulièrement: rm -rf storage/audio/cache/*.mp3

---

🔧 Dépannage

"Format error" / "NotSupportedError"

Cause: Video YouTube sans piste audio

Solution: Essayer une autre vidéo

"Could not download audio"

Cause:

• Vidéo privée/supprimée
• Restriction géographique
• Problème réseau

Solution: Essayer une autre vidéo

Timeout / Téléchargement très long

Cause:

• Vidéo très longue
• Connexion lente
• Serveur YouTube surchargé

Solution: Attendre ou essayer une vidéo plus courte

Musique qui s'arrête

Cause:

• URL YouTube expirée (URLs valables ~6 heures)
• Cache corrompu

Solution:

1. Supprimer le fichier du cache: rm storage/audio/cache/[ID].mp3
2. Re-cliquer sur la piste pour retélécharger

---

📊 Statistiques Tests

Catégorie	Tests	Passés	Échoués	Score
Backend	6	5	1	83%
Frontend/API	5	4	1	80%
Total	11	9	2	82%

Statut Global: ✅ FONCTIONNEL

Les 2 échecs sont:

1. Test stream URL (méthode non utilisée)
2. Timeout téléchargement (normal, comportement attendu)

---

🎯 Prochaines Améliorations

1. Barre de progression lors du téléchargement YouTube
2. Queue de téléchargement pour précharger les pistes
3. Indicateur de cache (icône "déjà téléchargé")
4. Mode hors ligne avec pistes locales
5. Qualité audio configurable (128/192/320 kbps)
6. Format alternatif (WebM plus léger)

---

📚 Documentation

• Backend tests: backend/test_audiOhm.py
• Frontend tests: frontend/test_runner.sh
• API docs: http://localhost:8000/docs (Swagger)
• Issue tracker: BUGFIX_SEARCH_PLAYBACK.md

---

Dernière mise à jour: 2026-01-19 Version: 1.0.0 Statut: ✅ Production Ready