root
801e6a050b
- Documentation archivée et réorganisée - Backend: Ajout tests, migrations, library service, rate limiting - Frontend: Suppression Flutter, focus sur interface web HTML/JS - Tailwind CSS ajouté pour le style - Améliorations UX et corrections bugs Generated with [Claude Code](https://claude.com/claude-code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
236 lines
4.1 KiB
Markdown
236 lines
4.1 KiB
Markdown
# 🎵 AudiOhm - Guide de Démarrage Rapide
|
|
|
|
## 🚀 Démarrage Rapide (3 Options)
|
|
|
|
### Option 1: Web (Le Plus Simple)
|
|
|
|
**Avantages:**
|
|
- Aucune installation requise
|
|
- Lance dans le navigateur
|
|
- Idéal pour tester rapidement
|
|
|
|
```bash
|
|
# Dans le dossier frontend
|
|
cd /opt/audiOhm/frontend
|
|
flutter run -d chrome
|
|
```
|
|
|
|
L'application s'ouvrira automatiquement dans Chrome.
|
|
|
|
---
|
|
|
|
### Option 2: Mode Développement
|
|
|
|
#### Web (Recommandé)
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter run -d chrome
|
|
```
|
|
|
|
#### Android (Émulateur requis)
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter run -d android
|
|
```
|
|
|
|
#### Windows Desktop
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter run -d windows
|
|
```
|
|
|
|
---
|
|
|
|
### Option 3: Script Automatisé
|
|
|
|
```bash
|
|
# Lancer le backend ET le frontend web ensemble
|
|
cd /opt/audiOhm
|
|
./START_WEB.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 📦 Builds de Production
|
|
|
|
### Android APK
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter build apk --release
|
|
|
|
# L'APK sera dans: build/app/outputs/flutter-apk/app-release.apk
|
|
```
|
|
|
|
**Installation:**
|
|
1. Transférer l'APK sur l'appareil
|
|
2. Activer "Sources inconnues"
|
|
3. Ouvrir l'APK pour installer
|
|
|
|
### Windows EXE
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter build windows --release
|
|
|
|
# L'EXE sera dans: build/windows/runner/Release/audiOhm.exe
|
|
```
|
|
|
|
### Web
|
|
|
|
```bash
|
|
cd /opt/audiOhm/frontend
|
|
flutter build web --release
|
|
|
|
# Les fichiers seront dans: build/web/
|
|
```
|
|
|
|
**Déploiement:**
|
|
```bash
|
|
# Servir avec un serveur web simple
|
|
cd build/web
|
|
python3 -m http.server 8080
|
|
|
|
# Ou avec nginx
|
|
cp -r build/web/* /var/www/html/
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Configuration API
|
|
|
|
### Développement Local
|
|
|
|
```bash
|
|
# Override de l'URL API pour localhost
|
|
flutter run -d chrome --dart-define=API_BASE_URL=http://localhost:8000/api/v1
|
|
```
|
|
|
|
### Production
|
|
|
|
L'URL est configurée dans `lib/core/constants/api_constants.dart`:
|
|
- **Par défaut:** `https://api.audiOhm.com/api/v1`
|
|
- **WebSocket:** `wss://api.audiOhm.com`
|
|
|
|
---
|
|
|
|
## 🎨 Fonctionnalités à Tester
|
|
|
|
### ✅ Phase 1 & 2 Corrections
|
|
|
|
1. **Hover States** - Survoler les cards (desktop)
|
|
- Border cyan néon au hover
|
|
- Glow néon subtil
|
|
- Transition 200ms
|
|
|
|
2. **Cursor Pointer** - Elements cliquables
|
|
- Curseur main sur toutes les cards
|
|
- Feedback immédiat
|
|
|
|
3. **Skeleton Loading** - Chargement
|
|
- Shimmer animation pendant le chargement
|
|
- Changez `isLoading = true` dans `mobile_home_page.dart` pour tester
|
|
|
|
4. **Gestion d'Erreurs** - Messages user-friendly
|
|
- Erreurs affichées avec bouton Retry
|
|
- Messages d'erreur clairs
|
|
|
|
5. **HTTPS** - Communications sécurisées
|
|
- Toutes les requêtes API utilisent HTTPS
|
|
- Certificat SSL validé
|
|
|
|
---
|
|
|
|
## 🧪 Tests Manuels
|
|
|
|
### Test 1: Navigation
|
|
|
|
1. Lancer l'application
|
|
2. Naviguer entre Home, Search, Library, Settings
|
|
3. Vérifier que les transitions sont fluides
|
|
|
|
### Test 2: Audio
|
|
|
|
1. Cliquer sur un morceau
|
|
2. Vérifier que la lecture démarre
|
|
3. Tester play/pause/skip
|
|
4. Vérifier que le mini player fonctionne
|
|
|
|
### Test 3: Recherche
|
|
|
|
1. Aller dans l'onglet Search
|
|
2. Taper une requête
|
|
3. Vérifier les résultats
|
|
4. Cliquer sur un résultat
|
|
|
|
### Test 4: Erreurs
|
|
|
|
1. Mettre le backend offline
|
|
2. Essayer de jouer un morceau
|
|
3. Vérifier que l'erreur s'affiche
|
|
4. Relancer le backend
|
|
5. Tester le bouton Retry
|
|
|
|
---
|
|
|
|
## 🐛 Problèmes Communs
|
|
|
|
### Flutter non trouvé
|
|
|
|
```bash
|
|
# Vérifier que Flutter est dans le PATH
|
|
which flutter
|
|
|
|
# Ou utiliser le chemin complet
|
|
/opt/flutter/bin/flutter --version
|
|
```
|
|
|
|
### Gradle errors
|
|
|
|
```bash
|
|
# Nettoyer gradle
|
|
cd frontend
|
|
rm -rf build .gradle
|
|
flutter clean
|
|
flutter pub get
|
|
```
|
|
|
|
### Port 8000 déjà utilisé
|
|
|
|
```bash
|
|
# Trouver et tuer le processus
|
|
lsof -ti:8000
|
|
kill -9 [PID]
|
|
|
|
# Ou utiliser un autre port
|
|
flutter run -d chrome --dart-define=API_BASE_URL=http://localhost:8001/api/v1
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 Documentation
|
|
|
|
- **Guide Complet:** `STYLE_GUIDE.md`
|
|
- **Référence Rapide:** `QUICK_REFERENCE.md`
|
|
- **Instructions Build:** `BUILD_INSTRUCTIONS.md`
|
|
- **Index Docs:** `DOCS_INDEX.md`
|
|
|
|
---
|
|
|
|
## 🎯 Checklist Avant Release
|
|
|
|
- [ ] Tous les tests passent
|
|
- [ ] Android APK se compile
|
|
- [ ] Windows EXE se compile
|
|
- [ ] Web build fonctionne
|
|
- [ ] Pas d'erreurs console
|
|
- [ ] Performance acceptable
|
|
- [] Accessibilité vérifiée
|
|
|
|
---
|
|
|
|
**Bonne découverte d'AudiOhm !** 🎵
|