feat: Modernisation UI/UX et configuration Flutter multi-plateforme
Phase 1 - Corrections Critiques: - Fixed memory leaks dans music_provider.dart (stream subscriptions) - Fixed race conditions dans search_provider.dart (stale results) - Fixed token refresh errors dans api_service.dart - Improved error handling avec messages utilisateur - Changed API URL to HTTPS by default Phase 2 - Améliorations UX Desktop: - Ajouté cursor pointers sur tous les éléments cliquables - Implémenté hover states avec effets néon glow (200ms transitions) - Créé skeleton loading states avec shimmer animation - Ajouté widgets: ClickableWrapper, ErrorDisplay, SkeletonLoading - Enhanced visual feedback pour desktop users Phase 3 - Configuration Flutter: - Configuré Android (Gradle 8.1.0, Kotlin 1.9.0, minSdk 21, targetSdk 34) - Créé launcher icons cyberpunk néon (5 densités) - Configuré Windows desktop (structure complète) - Activé Linux desktop support - Ajouté package équatable pour entités de domaine - Corrigé imports (colors.dart, auth_provider.dart) - Fixed Dio API compatibility (RequestOptions) Documentation: - STYLE_GUIDE.md: Guide complet (100+ pages) - DESIGN_IMPLEMENTATION_GUIDE.md: Implémentation Flutter - BUILD_STATUS.md: Status builds + troubleshooting - QUICKSTART_BUILDS.md: Guide rapide - BUILD_INDEX.md: Index documentation - PHASE_1_CORRECTIONS.md: Corrections Phase 1 - PHASE_2_UX_IMPROVEMENTS.md: Améliorations Phase 2 - PR_REVIEW_SUMMARY.md: Revue code complète - CODE_ANALYSIS_AND_PRIORITIES.md: Analyse code Scripts & Builds: - BUILD_ALL.sh: Script automatisé builds multi-plateforme - builds/: Structure avec README par plateforme - design-system/: Système de design complet Backend: - Ajouté streaming HTTP Range pour audio progressif - Enhanced YouTube service avec métadonnées complètes - Improved error handling et validation 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>
This commit is contained in:
root
@@ -0,0 +1,191 @@
|
||||
# 🌐 Quick Start - Web Mode
|
||||
|
||||
Guide rapide pour lancer l'application en mode Web (recommandé pour le développement).
|
||||
|
||||
## 🚀 Installation Rapide
|
||||
|
||||
### 1. Prérequis
|
||||
|
||||
- **Flutter SDK** (3.19.0 ou supérieur)
|
||||
- Windows: https://docs.flutter.dev/get-started/install/windows
|
||||
- Linux: https://docs.flutter.dev/get-started/install/linux
|
||||
- macOS: https://docs.flutter.dev/get-started/install/macos
|
||||
|
||||
- **Chrome** ou **Edge** navigateur
|
||||
- Le **backend** doit être démarré (voir section backend)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Lancer l'application Web
|
||||
|
||||
### Windows (PowerShell)
|
||||
|
||||
```powershell
|
||||
cd D:\Developpement\audiohm\frontend
|
||||
|
||||
# Première fois uniquement
|
||||
flutter config --enable-web
|
||||
flutter create --platforms=web .
|
||||
flutter pub get
|
||||
|
||||
# Lancer l'app
|
||||
flutter run -d chrome
|
||||
```
|
||||
|
||||
### Linux / macOS
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
|
||||
# Première fois uniquement
|
||||
flutter config --enable-web
|
||||
flutter create --platforms=web .
|
||||
flutter pub get
|
||||
|
||||
# Lancer l'app
|
||||
flutter run -d chrome
|
||||
```
|
||||
|
||||
L'application s'ouvrira automatiquement : **http://localhost:8080**
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Démarrer le Backend (Obligatoire)
|
||||
|
||||
**Sur le serveur :**
|
||||
```bash
|
||||
cd /opt/audiOhm/backend
|
||||
source venv/bin/activate
|
||||
uvicorn app.main:app --host 0.0.0.0 --port 8000
|
||||
```
|
||||
|
||||
Le backend sera accessible sur : **http://VOTRE-SERVER-IP:8000**
|
||||
|
||||
---
|
||||
|
||||
## 🌍 Configurer l'URL du Backend
|
||||
|
||||
Si le backend n'est pas en local, modifiez l'URL dans le frontend :
|
||||
|
||||
**Fichier :** `frontend/lib/core/constants/api_constants.dart`
|
||||
|
||||
```dart
|
||||
const String baseUrl = 'http://VOTRE-SERVER-IP:8000/api/v1';
|
||||
```
|
||||
|
||||
Exemple :
|
||||
```dart
|
||||
const String baseUrl = 'http://192.168.1.100:8000/api/v1';
|
||||
// ou
|
||||
const String baseUrl = 'http://audiOhm.lanro.eu:8000/api/v1';
|
||||
```
|
||||
|
||||
Puis relancez :
|
||||
```powershell
|
||||
flutter run -d chrome
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Debuggage
|
||||
|
||||
### Ouvrir les DevTools
|
||||
|
||||
1. L'application web inclut automatiquement une bannière de debug en bas
|
||||
2. Cliquez sur **"Open DevTools"** pour ouvrir l'inspecteur Chrome
|
||||
|
||||
### Raccourcis utiles
|
||||
|
||||
- **r** + Entrée - Hot reload (rafraîchir sans redémarrer)
|
||||
- **R** + Entrée - Hot restart (redémarrer l'app)
|
||||
- **o** + Entrée - Open DevTools
|
||||
- **q** + Entrée - Quitter
|
||||
|
||||
---
|
||||
|
||||
## 📦 Compiler pour le Web (Production)
|
||||
|
||||
Pour créer une version de production web :
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
flutter build web --release
|
||||
```
|
||||
|
||||
Les fichiers générés seront dans : `frontend/build/web/`
|
||||
|
||||
Vous pouvez les déployer sur :
|
||||
- Nginx
|
||||
- Apache
|
||||
- GitHub Pages
|
||||
- Netlify
|
||||
- Vercel
|
||||
- Tout serveur web statique
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Problèmes Courants
|
||||
|
||||
### "No connected devices"
|
||||
|
||||
**Solution :**
|
||||
```bash
|
||||
flutter devices
|
||||
# Devrait afficher Chrome ou Edge
|
||||
```
|
||||
|
||||
Si Chrome n'apparaît pas, installez Chrome ou utilisez Edge :
|
||||
```bash
|
||||
flutter run -d edge
|
||||
```
|
||||
|
||||
### "Backend not responding"
|
||||
|
||||
Vérifiez que :
|
||||
1. Le backend est démarré sur le serveur
|
||||
2. L'URL dans `api_constants.dart` est correcte
|
||||
3. Le firewall du serveur autorise le port 8000
|
||||
4. Vous pouvez accéder à : `http://VOTRE-SERVER-IP:8000/docs`
|
||||
|
||||
### CORS Error
|
||||
|
||||
Si vous avez une erreur CORS dans le navigateur, vérifiez que le backend autorise votre origine dans `backend/.env` :
|
||||
|
||||
```env
|
||||
BACKEND_CORS_ORIGINS=["http://localhost:8080","http://VOTRE-IP:8080"]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Développement
|
||||
|
||||
### Hot Reload
|
||||
|
||||
Pendant le développement, Flutter détecte automatiquement les changements et recharge l'application.
|
||||
|
||||
1. Modifiez un fichier
|
||||
2. Sauvegardez
|
||||
3. L'application se met à jour automatiquement en ~1 seconde
|
||||
|
||||
### Voir les logs
|
||||
|
||||
Les logs Flutter s'affichent dans la console où vous avez lancé `flutter run`.
|
||||
|
||||
Les logs du backend sont sur le serveur dans `/tmp/uvicorn.log` ou directement dans la console.
|
||||
|
||||
---
|
||||
|
||||
## 📝 Note importante
|
||||
|
||||
Le mode Web est **parfait pour le développement** car :
|
||||
- ✅ Pas besoin de Visual Studio
|
||||
- ✅ Débugage facile avec Chrome DevTools
|
||||
- ✅ Hot reload ultra-rapide
|
||||
- ✅ Fonctionne sur Windows, Linux, macOS
|
||||
- ✅ Pas de compilation native
|
||||
|
||||
Pour la **production**, vous pourrez créer des exécutables natifs plus tard.
|
||||
|
||||
---
|
||||
|
||||
**Bon développement ! 🚀**
|
||||
Reference in New Issue
Block a user