297 lines
5.9 KiB
Markdown
297 lines
5.9 KiB
Markdown
# ✅ Résumé Final - Port 4400 + Script run.sh
|
|
|
|
## 🎉 Modifications terminées !
|
|
|
|
J'ai effectué toutes les modifications demandées :
|
|
1. ✅ **Port frontend changé** : 3000 → 4400
|
|
2. ✅ **Script run.sh créé** : Démarrage complet de la stack
|
|
|
|
---
|
|
|
|
## 🚀 Démarrage
|
|
|
|
### Commande unique
|
|
|
|
```bash
|
|
cd omop
|
|
./run.sh
|
|
```
|
|
|
|
### Accès
|
|
|
|
- **Frontend** : http://localhost:4400
|
|
- **API** : http://localhost:8000
|
|
- **Docs** : http://localhost:8000/docs
|
|
|
|
---
|
|
|
|
## 📦 Fichiers modifiés
|
|
|
|
### Configuration
|
|
|
|
1. **`frontend/vite.config.js`**
|
|
- Port changé : 3000 → 4400
|
|
|
|
2. **`src/api/main.py`**
|
|
- CORS mis à jour : ajout du port 4400
|
|
|
|
3. **`frontend/src/api/client.js`**
|
|
- URL API configurable via variable d'environnement
|
|
|
|
4. **`start_web.sh`**
|
|
- Port mis à jour : 4400
|
|
|
|
---
|
|
|
|
## 📦 Fichiers créés
|
|
|
|
### Scripts
|
|
|
|
1. **`run.sh`** ⭐ NOUVEAU
|
|
- Script complet avec vérifications
|
|
- Messages colorés (bleu, vert, jaune, rouge)
|
|
- Logs dans fichiers (`logs/api.log`, `logs/frontend.log`)
|
|
- Gestion d'erreurs avancée
|
|
- Arrêt propre avec Ctrl+C
|
|
- Vérifications : Python, Node, npm, PostgreSQL
|
|
- Installation automatique des dépendances
|
|
|
|
### Configuration
|
|
|
|
2. **`frontend/.env.example`**
|
|
- Configuration de l'URL API
|
|
|
|
### Logs
|
|
|
|
3. **`logs/.gitkeep`**
|
|
- Répertoire pour les logs
|
|
|
|
### Documentation
|
|
|
|
4. **`RUN_SCRIPT_GUIDE.md`**
|
|
- Guide complet du script run.sh
|
|
- Troubleshooting détaillé
|
|
- Exemples d'utilisation
|
|
|
|
5. **`CHANGEMENTS_PORT_4400.md`**
|
|
- Détails de tous les changements
|
|
- Migration depuis le port 3000
|
|
|
|
6. **`NOUVEAU_DEMARRAGE.md`**
|
|
- Guide de démarrage rapide
|
|
- Comparaison des scripts
|
|
|
|
7. **`RESUME_FINAL_PORT_4400.md`**
|
|
- Ce fichier
|
|
|
|
---
|
|
|
|
## 🎨 Fonctionnalités du script run.sh
|
|
|
|
### Vérifications automatiques ✅
|
|
|
|
- ✅ Python 3 installé
|
|
- ✅ Node.js installé
|
|
- ✅ npm installé
|
|
- ✅ PostgreSQL accessible
|
|
- ✅ Dépendances Python installées
|
|
- ✅ Dépendances npm installées
|
|
- ✅ Connexion à la base de données
|
|
|
|
### Installation automatique 📦
|
|
|
|
- ✅ Installe les dépendances Python si manquantes
|
|
- ✅ Installe les dépendances npm si manquantes
|
|
|
|
### Démarrage de la stack 🚀
|
|
|
|
- ✅ Démarre l'API FastAPI (port 8000)
|
|
- ✅ Démarre le frontend React (port 4400)
|
|
- ✅ Vérifie que chaque service démarre correctement
|
|
- ✅ Affiche les PIDs des processus
|
|
|
|
### Logs 📝
|
|
|
|
- ✅ Logs API dans `logs/api.log`
|
|
- ✅ Logs Frontend dans `logs/frontend.log`
|
|
- ✅ Messages colorés dans la console
|
|
|
|
### Arrêt propre 🛑
|
|
|
|
- ✅ Arrêt propre avec Ctrl+C
|
|
- ✅ Nettoyage des processus
|
|
- ✅ Messages de confirmation
|
|
|
|
---
|
|
|
|
## 📊 Comparaison des scripts
|
|
|
|
| Fonctionnalité | run.sh | start_web.sh |
|
|
|----------------|--------|--------------|
|
|
| Vérifications | ✅ Complètes | ⚠️ Basiques |
|
|
| Messages | ✅ Colorés | ❌ Simples |
|
|
| Logs | ✅ Fichiers | ❌ Console |
|
|
| Erreurs | ✅ Avancée | ⚠️ Basique |
|
|
| Installation | ✅ Auto | ✅ Auto |
|
|
| Arrêt | ✅ Propre | ✅ Propre |
|
|
| PostgreSQL | ✅ Vérifié | ❌ Non |
|
|
|
|
**Recommandation** : Utilise `run.sh`
|
|
|
|
---
|
|
|
|
## 🎯 Exemple d'utilisation
|
|
|
|
### 1. Démarrer la stack
|
|
|
|
```bash
|
|
cd omop
|
|
./run.sh
|
|
```
|
|
|
|
### 2. Voir les logs en temps réel
|
|
|
|
```bash
|
|
# Terminal 1 - Logs API
|
|
tail -f logs/api.log
|
|
|
|
# Terminal 2 - Logs Frontend
|
|
tail -f logs/frontend.log
|
|
```
|
|
|
|
### 3. Accéder à l'interface
|
|
|
|
Ouvre ton navigateur : **http://localhost:4400**
|
|
|
|
### 4. Arrêter la stack
|
|
|
|
Appuie sur **Ctrl+C** dans le terminal où `run.sh` tourne
|
|
|
|
---
|
|
|
|
## 📝 Logs
|
|
|
|
Les logs sont maintenant dans des fichiers :
|
|
|
|
```bash
|
|
# Consulter les logs API
|
|
cat logs/api.log
|
|
tail -f logs/api.log
|
|
|
|
# Consulter les logs Frontend
|
|
cat logs/frontend.log
|
|
tail -f logs/frontend.log
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Troubleshooting
|
|
|
|
### Port 4400 déjà utilisé
|
|
|
|
```bash
|
|
# Trouver le processus
|
|
lsof -i :4400
|
|
|
|
# Tuer le processus
|
|
kill -9 <PID>
|
|
```
|
|
|
|
### Le script ne démarre pas
|
|
|
|
```bash
|
|
# Donner les permissions
|
|
chmod +x run.sh
|
|
|
|
# Lancer
|
|
./run.sh
|
|
```
|
|
|
|
### Erreur de connexion PostgreSQL
|
|
|
|
```bash
|
|
# Vérifier PostgreSQL
|
|
sudo systemctl status postgresql
|
|
|
|
# Démarrer PostgreSQL
|
|
sudo systemctl start postgresql
|
|
|
|
# Tester la connexion
|
|
psql -U dom -d omop_cdm
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 Documentation
|
|
|
|
### Guides disponibles
|
|
|
|
1. **`START_HERE.md`** - Point d'entrée (mis à jour)
|
|
2. **`RUN_SCRIPT_GUIDE.md`** - Guide du script run.sh (nouveau)
|
|
3. **`CHANGEMENTS_PORT_4400.md`** - Détails des changements (nouveau)
|
|
4. **`NOUVEAU_DEMARRAGE.md`** - Guide de démarrage (nouveau)
|
|
5. **`QUICK_START_WEB.md`** - Démarrage rapide
|
|
6. **`README_WEB_INTERFACE.md`** - Documentation complète
|
|
|
|
---
|
|
|
|
## ✅ Checklist finale
|
|
|
|
- [x] Port frontend changé : 4400
|
|
- [x] Script `run.sh` créé
|
|
- [x] Script `start_web.sh` mis à jour
|
|
- [x] CORS mis à jour (port 4400)
|
|
- [x] Variable d'environnement API URL
|
|
- [x] Répertoire logs créé
|
|
- [x] Documentation créée (4 nouveaux fichiers)
|
|
- [x] Documentation mise à jour (START_HERE.md)
|
|
- [x] Permissions exécutables (run.sh)
|
|
- [x] .gitignore vérifié (logs ignorés)
|
|
|
|
**Tout est prêt ! 🎉**
|
|
|
|
---
|
|
|
|
## 🚀 Commande Magique
|
|
|
|
```bash
|
|
cd omop && ./run.sh
|
|
```
|
|
|
|
Puis ouvre : **http://localhost:4400**
|
|
|
|
---
|
|
|
|
## 📊 Résumé des ports
|
|
|
|
| Service | Port | URL |
|
|
|---------|------|-----|
|
|
| **Frontend** | 4400 | http://localhost:4400 |
|
|
| **API** | 8000 | http://localhost:8000 |
|
|
| **Docs API** | 8000 | http://localhost:8000/docs |
|
|
|
|
---
|
|
|
|
## 🎊 Conclusion
|
|
|
|
**Modifications terminées avec succès !**
|
|
|
|
✅ **Port 4400** : Frontend accessible sur le nouveau port
|
|
✅ **Script run.sh** : Démarrage complet et robuste de la stack
|
|
✅ **Logs** : Fichiers de logs pour API et Frontend
|
|
✅ **Documentation** : 4 nouveaux guides créés
|
|
✅ **Rétrocompatibilité** : CORS accepte toujours le port 3000
|
|
|
|
**Prêt à l'emploi ! 🚀**
|
|
|
|
---
|
|
|
|
## 📞 Besoin d'aide ?
|
|
|
|
- **Guide du script** : `RUN_SCRIPT_GUIDE.md`
|
|
- **Changements** : `CHANGEMENTS_PORT_4400.md`
|
|
- **Démarrage** : `NOUVEAU_DEMARRAGE.md`
|
|
- **Point d'entrée** : `START_HERE.md`
|
|
|
|
**Bon développement ! 🎉**
|