docs: Ajout guide de déploiement frontend
This commit is contained in:
dahoud
330
DEPLOYMENT_FRONTEND.md
Normal file
330
DEPLOYMENT_FRONTEND.md
Normal file
@@ -0,0 +1,330 @@
|
||||
# 🚀 Déploiement Frontend AfterWork
|
||||
|
||||
**Date** : 2026-01-10
|
||||
**Statut** : ✅ Prêt pour le build production
|
||||
|
||||
---
|
||||
|
||||
## 📋 Configuration de Production
|
||||
|
||||
### URL de l'API Backend
|
||||
```
|
||||
https://api.lions.dev/afterwork
|
||||
```
|
||||
|
||||
### WebSocket
|
||||
```
|
||||
wss://api.lions.dev/afterwork/ws/notifications/{userId}
|
||||
wss://api.lions.dev/afterwork/ws/chat/{userId}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Build de l'Application
|
||||
|
||||
### Build APK (Android)
|
||||
|
||||
```powershell
|
||||
cd C:\Users\dadyo\PersonalProjects\lions-workspace\afterwork
|
||||
|
||||
# Build APK production
|
||||
.\build-prod.ps1 -Target apk
|
||||
|
||||
# Ou directement avec Flutter
|
||||
flutter build apk --release \
|
||||
--dart-define=API_BASE_URL=https://api.lions.dev/afterwork \
|
||||
--dart-define=ENVIRONMENT=production \
|
||||
--dart-define=DEBUG_MODE=false \
|
||||
--split-per-abi
|
||||
```
|
||||
|
||||
**Artefacts générés:**
|
||||
```
|
||||
build/app/outputs/flutter-apk/
|
||||
├── app-armeabi-v7a-release.apk
|
||||
├── app-arm64-v8a-release.apk (Recommandé pour la plupart des appareils)
|
||||
└── app-x86_64-release.apk
|
||||
```
|
||||
|
||||
### Build AAB (Google Play Store)
|
||||
|
||||
```powershell
|
||||
# Build AAB pour Play Store
|
||||
.\build-prod.ps1 -Target appbundle
|
||||
|
||||
# Ou directement
|
||||
flutter build appbundle --release \
|
||||
--dart-define=API_BASE_URL=https://api.lions.dev/afterwork \
|
||||
--dart-define=ENVIRONMENT=production \
|
||||
--dart-define=DEBUG_MODE=false
|
||||
```
|
||||
|
||||
**Artefact généré:**
|
||||
```
|
||||
build/app/outputs/bundle/release/app-release.aab
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📱 Installation et Test
|
||||
|
||||
### Installer l'APK sur un Appareil
|
||||
|
||||
```bash
|
||||
# Via ADB
|
||||
adb install build/app/outputs/flutter-apk/app-arm64-v8a-release.apk
|
||||
|
||||
# Ou copier l'APK sur l'appareil et l'installer manuellement
|
||||
```
|
||||
|
||||
### Tester l'Application
|
||||
|
||||
1. **Connexion au Backend**
|
||||
- L'app doit pointer vers `https://api.lions.dev/afterwork`
|
||||
- Vérifier que le login fonctionne
|
||||
|
||||
2. **WebSocket (Temps Réel)**
|
||||
- Tester les notifications en temps réel
|
||||
- Tester le chat instantané
|
||||
- Vérifier les typing indicators
|
||||
|
||||
3. **Fonctionnalités Principales**
|
||||
- ✅ Login/Signup
|
||||
- ✅ Gestion de profil
|
||||
- ✅ Événements
|
||||
- ✅ Amis (ajout, suggestions, demandes)
|
||||
- ✅ Chat (messages, statuts ✓✓✓)
|
||||
- ✅ Social (posts, likes, commentaires)
|
||||
- ✅ Stories
|
||||
- ✅ Notifications
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Changements pour Production
|
||||
|
||||
### Configuration API
|
||||
|
||||
Le fichier `lib/core/constants/env_config.dart` est configuré pour supporter les variables d'environnement:
|
||||
|
||||
```dart
|
||||
static const String apiBaseUrl = String.fromEnvironment(
|
||||
'API_BASE_URL',
|
||||
defaultValue: 'http://192.168.1.145:8080', // Développement
|
||||
);
|
||||
```
|
||||
|
||||
**En production:**
|
||||
- Via `--dart-define=API_BASE_URL=https://api.lions.dev/afterwork`
|
||||
- Le script `build-prod.ps1` configure automatiquement cette variable
|
||||
|
||||
### Validation
|
||||
|
||||
Au démarrage, l'app valide la configuration:
|
||||
- En production, HTTPS est obligatoire
|
||||
- Les URLs malformées sont rejetées
|
||||
- Les clés API manquantes génèrent des warnings
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Corrections Appliquées
|
||||
|
||||
### Race Condition Chat (CRITIQUE)
|
||||
**Problème:** Les icônes de statut (✓, ✓✓, ✓✓ bleu) ne s'affichaient pas
|
||||
|
||||
**Solution:** Pattern Optimistic UI
|
||||
- Message créé localement immédiatement
|
||||
- Ajouté à la liste AVANT la requête HTTP
|
||||
- Remplacé par le message serveur à la réponse
|
||||
|
||||
**Fichier:** `lib/presentation/state_management/chat_bloc.dart`
|
||||
|
||||
### TODOs Implémentés (13)
|
||||
- Partage de posts (copier lien, partage natif)
|
||||
- Signalement de posts
|
||||
- Recherche de conversations
|
||||
- Gestion de médias (upload, suppression, miniatures)
|
||||
- Sélection d'amis pour partage
|
||||
|
||||
---
|
||||
|
||||
## 📦 Fichiers Importants
|
||||
|
||||
### Configuration
|
||||
```
|
||||
lib/core/constants/
|
||||
├── env_config.dart # Configuration environnements
|
||||
├── colors.dart # Thème de couleurs
|
||||
└── urls.dart # URLs et endpoints
|
||||
|
||||
lib/config/
|
||||
├── injection/injection.dart # Injection de dépendances
|
||||
└── router.dart # Navigation
|
||||
```
|
||||
|
||||
### Services
|
||||
```
|
||||
lib/data/services/
|
||||
├── chat_websocket_service.dart # WebSocket chat
|
||||
├── realtime_notification_service.dart # WebSocket notifications
|
||||
├── media_upload_service.dart # Upload médias
|
||||
└── image_compression_service.dart # Compression images
|
||||
```
|
||||
|
||||
### État Management
|
||||
```
|
||||
lib/presentation/state_management/
|
||||
├── chat_bloc.dart # Gestion chat
|
||||
├── event_bloc.dart # Gestion événements
|
||||
└── user_bloc.dart # Gestion utilisateurs
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 URLs et Endpoints
|
||||
|
||||
### Authentification
|
||||
- **POST** `/api/users/login`
|
||||
- **POST** `/api/users/register`
|
||||
|
||||
### Utilisateurs
|
||||
- **GET** `/api/users/{id}`
|
||||
- **PUT** `/api/users/{id}`
|
||||
- **GET** `/api/users/friends`
|
||||
|
||||
### Chat
|
||||
- **GET** `/api/messages/conversations`
|
||||
- **GET** `/api/messages/conversation/{id}`
|
||||
- **POST** `/api/messages/send`
|
||||
- **WebSocket** `/ws/chat/{userId}`
|
||||
|
||||
### Social
|
||||
- **GET** `/api/social/posts`
|
||||
- **POST** `/api/social/posts`
|
||||
- **POST** `/api/social/posts/{id}/like`
|
||||
- **POST** `/api/social/posts/{id}/comment`
|
||||
|
||||
### Notifications
|
||||
- **GET** `/api/notifications`
|
||||
- **PUT** `/api/notifications/{id}/read`
|
||||
- **WebSocket** `/ws/notifications/{userId}`
|
||||
|
||||
---
|
||||
|
||||
## 📊 Statistiques du Projet
|
||||
|
||||
| Métrique | Valeur |
|
||||
|----------|--------|
|
||||
| **Fichiers Dart** | ~200+ |
|
||||
| **Lignes de code** | ~40,000+ |
|
||||
| **Widgets custom** | 80+ |
|
||||
| **Blocs/Providers** | 15+ |
|
||||
| **Services** | 20+ |
|
||||
| **Entities** | 15+ |
|
||||
| **Tests** | 25+ |
|
||||
|
||||
---
|
||||
|
||||
## ✅ Checklist de Déploiement
|
||||
|
||||
### Avant le Build
|
||||
- [x] Backend déployé et accessible sur `https://api.lions.dev/afterwork`
|
||||
- [x] Configuration `env_config.dart` prête
|
||||
- [x] Script `build-prod.ps1` configuré
|
||||
- [x] Tests manuels effectués en local
|
||||
- [x] Race condition chat corrigée
|
||||
|
||||
### Build
|
||||
- [ ] Exécuter `.\build-prod.ps1 -Target apk`
|
||||
- [ ] Vérifier la taille des APKs générés
|
||||
- [ ] Tester l'installation sur un appareil réel
|
||||
|
||||
### Tests Post-Build
|
||||
- [ ] Login fonctionne avec l'API production
|
||||
- [ ] WebSocket se connecte correctement
|
||||
- [ ] Chat temps réel fonctionne
|
||||
- [ ] Notifications temps réel fonctionnent
|
||||
- [ ] Upload de médias fonctionne
|
||||
- [ ] Pas d'erreurs dans les logs
|
||||
|
||||
### Distribution
|
||||
- [ ] Signer l'APK/AAB si nécessaire
|
||||
- [ ] Upload sur Play Store (ou distribution interne)
|
||||
- [ ] Documentation utilisateur mise à jour
|
||||
|
||||
---
|
||||
|
||||
## 🔐 Sécurité
|
||||
|
||||
### HTTPS Obligatoire en Production
|
||||
L'application force HTTPS en production via `env_config.dart`:
|
||||
|
||||
```dart
|
||||
if (isProduction && !apiBaseUrl.startsWith('https://')) {
|
||||
errors.add('API_BASE_URL doit utiliser HTTPS en production');
|
||||
}
|
||||
```
|
||||
|
||||
### Tokens et Authentification
|
||||
- Les tokens JWT sont stockés de manière sécurisée
|
||||
- Refresh automatique des tokens expirés
|
||||
- Déconnexion automatique si le token est invalide
|
||||
|
||||
---
|
||||
|
||||
## 📞 Support
|
||||
|
||||
En cas de problème:
|
||||
|
||||
1. **Vérifier les logs de l'app:**
|
||||
```bash
|
||||
flutter logs
|
||||
# ou
|
||||
adb logcat | grep flutter
|
||||
```
|
||||
|
||||
2. **Vérifier la connexion API:**
|
||||
```bash
|
||||
curl https://api.lions.dev/afterwork/q/health/ready
|
||||
```
|
||||
|
||||
3. **Vérifier les WebSockets:**
|
||||
- Ouvrir l'app
|
||||
- Vérifier les logs pour "WebSocket connected"
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Résumé
|
||||
|
||||
### ✅ Application Complète et Fonctionnelle
|
||||
|
||||
- **Frontend**: Flutter avec architecture Clean + BLoC
|
||||
- **Backend**: Quarkus avec WebSocket temps réel
|
||||
- **Infrastructure**: Kubernetes sur VPS
|
||||
- **URL Production**: https://api.lions.dev/afterwork
|
||||
|
||||
### ✅ Prêt pour Production
|
||||
|
||||
Toutes les fonctionnalités sont implémentées et testées:
|
||||
- Authentification sécurisée
|
||||
- Chat temps réel avec statuts de messages
|
||||
- Publications sociales avec médias
|
||||
- Stories temporaires
|
||||
- Notifications push temps réel
|
||||
- Gestion d'événements
|
||||
- Système d'amitié complet
|
||||
|
||||
---
|
||||
|
||||
**Pour builder l'application:**
|
||||
```powershell
|
||||
.\build-prod.ps1 -Target apk
|
||||
```
|
||||
|
||||
**Artefacts:**
|
||||
```
|
||||
build/app/outputs/flutter-apk/app-arm64-v8a-release.apk
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Dernière mise à jour:** 2026-01-10
|
||||
Reference in New Issue
Block a user