# 🎵 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 !** 🎵