275 lines
5.5 KiB
Markdown
275 lines
5.5 KiB
Markdown
# 🚀 COMMENCE ICI - Interface Web OMOP Pipeline
|
|
|
|
## Bienvenue ! 👋
|
|
|
|
Tu as maintenant une **interface web complète** pour gérer ton pipeline OMOP CDM 5.4.
|
|
|
|
---
|
|
|
|
## ⚡ Démarrage Ultra-Rapide (2 minutes)
|
|
|
|
### 1. Installe les dépendances
|
|
|
|
```bash
|
|
cd omop
|
|
|
|
# Backend
|
|
pip install -r requirements-api.txt
|
|
|
|
# Frontend
|
|
cd frontend
|
|
npm install
|
|
cd ..
|
|
```
|
|
|
|
### 2. Lance l'interface
|
|
|
|
**Option 1 - Script complet (recommandé)** :
|
|
```bash
|
|
./run.sh
|
|
```
|
|
|
|
**Option 2 - Script simple** :
|
|
```bash
|
|
./start_web.sh
|
|
```
|
|
|
|
### 3. Ouvre ton navigateur
|
|
|
|
**http://localhost:4400**
|
|
|
|
**C'est tout ! 🎉**
|
|
|
|
---
|
|
|
|
## 📚 Documentation
|
|
|
|
### Tu veux...
|
|
|
|
**Juste démarrer ?**
|
|
→ Tu es au bon endroit ! Suis les 3 étapes ci-dessus.
|
|
|
|
**Comprendre ce qui a été créé ?**
|
|
→ Lis [`INTERFACE_WEB_COMPLETE.md`](INTERFACE_WEB_COMPLETE.md)
|
|
|
|
**Voir à quoi ça ressemble ?**
|
|
→ Lis [`INTERFACE_PREVIEW.md`](INTERFACE_PREVIEW.md)
|
|
|
|
**Comprendre l'architecture ?**
|
|
→ Lis [`README_WEB_INTERFACE.md`](README_WEB_INTERFACE.md)
|
|
|
|
**Voir les fonctionnalités détaillées ?**
|
|
→ Lis [`INTERFACE_FEATURES.md`](INTERFACE_FEATURES.md)
|
|
|
|
**Naviguer dans toute la doc ?**
|
|
→ Lis [`DOCUMENTATION_INDEX.md`](DOCUMENTATION_INDEX.md)
|
|
|
|
---
|
|
|
|
## 🎨 Ce que tu peux faire
|
|
|
|
### 📊 Dashboard
|
|
- Voir les statistiques en temps réel
|
|
- Nombre de patients, visites, conditions
|
|
- Historique des exécutions ETL
|
|
|
|
### ⚙️ ETL Manager
|
|
- Lancer des pipelines ETL
|
|
- Configurer les paramètres
|
|
- Suivre les jobs en cours
|
|
|
|
### 🗄️ Schema Manager
|
|
- Créer les schémas (OMOP, Staging, Audit)
|
|
- Valider les schémas
|
|
- Voir l'état des tables
|
|
|
|
### ✅ Validation
|
|
- Lancer la validation des données
|
|
- Voir les codes non mappés
|
|
- Consulter les erreurs
|
|
|
|
### 📝 Logs
|
|
- Consulter les logs système
|
|
- Filtrer par niveau
|
|
- Voir les erreurs de validation
|
|
|
|
---
|
|
|
|
## 🎯 Premier Scénario
|
|
|
|
### Lancer ton premier pipeline ETL
|
|
|
|
1. **Ouvre l'interface** : http://localhost:4400
|
|
|
|
2. **Va dans "Schema Manager"** (menu gauche)
|
|
- Clique sur "Créer tous les schémas"
|
|
- Attends la confirmation
|
|
|
|
3. **Va dans "ETL Manager"** (menu gauche)
|
|
- Source : `staging.raw_patients`
|
|
- Cible : `person`
|
|
- Clique sur "🚀 Lancer le pipeline"
|
|
|
|
4. **Suis la progression**
|
|
- Le job apparaît dans "Jobs en cours"
|
|
- La progression s'affiche en temps réel
|
|
|
|
5. **Vois les résultats**
|
|
- Retourne au "Dashboard"
|
|
- Les statistiques sont mises à jour
|
|
- Tu vois les nouveaux patients dans OMOP
|
|
|
|
**Félicitations ! Tu as lancé ton premier pipeline ETL ! 🎊**
|
|
|
|
---
|
|
|
|
## 🔧 Troubleshooting
|
|
|
|
### Le script ne démarre pas
|
|
|
|
**Problème** : `./start_web.sh: Permission denied`
|
|
|
|
**Solution** :
|
|
```bash
|
|
chmod +x start_web.sh
|
|
./start_web.sh
|
|
```
|
|
|
|
### Port déjà utilisé
|
|
|
|
**Problème** : `Port 8000 already in use`
|
|
|
|
**Solution** :
|
|
```bash
|
|
# Trouver le processus
|
|
lsof -i :8000
|
|
|
|
# Tuer le processus
|
|
kill -9 <PID>
|
|
```
|
|
|
|
### Erreur de connexion à la base
|
|
|
|
**Problème** : `Connection refused`
|
|
|
|
**Solution** :
|
|
- Vérifie que PostgreSQL est démarré
|
|
- Vérifie les credentials dans `config.yaml`
|
|
- Teste la connexion : `psql -U dom -d omop_cdm`
|
|
|
|
### npm install échoue
|
|
|
|
**Problème** : `npm ERR!`
|
|
|
|
**Solution** :
|
|
```bash
|
|
cd frontend
|
|
rm -rf node_modules package-lock.json
|
|
npm install
|
|
```
|
|
|
|
---
|
|
|
|
## 📞 Besoin d'aide ?
|
|
|
|
### Documentation complète
|
|
- [`QUICK_START_WEB.md`](QUICK_START_WEB.md) - Guide détaillé
|
|
- [`README_WEB_INTERFACE.md`](README_WEB_INTERFACE.md) - Documentation API
|
|
- [`DOCUMENTATION_INDEX.md`](DOCUMENTATION_INDEX.md) - Index complet
|
|
|
|
### API Documentation
|
|
- **Swagger** : http://localhost:8000/docs (après démarrage)
|
|
|
|
### Code source
|
|
- **Backend** : `src/api/`
|
|
- **Frontend** : `frontend/src/`
|
|
|
|
---
|
|
|
|
## ✨ Fonctionnalités Clés
|
|
|
|
✅ **Interface moderne** - Design professionnel et intuitif
|
|
✅ **Temps réel** - Refresh automatique des données
|
|
✅ **Complet** - Toutes les fonctionnalités ETL
|
|
✅ **Documenté** - Documentation exhaustive
|
|
✅ **Prêt à l'emploi** - Fonctionne immédiatement
|
|
|
|
---
|
|
|
|
## 🎓 Prochaines Étapes
|
|
|
|
### Niveau 1 : Découverte (15 min)
|
|
1. Lance l'interface
|
|
2. Explore les 5 pages
|
|
3. Regarde les statistiques
|
|
|
|
### Niveau 2 : Utilisation (30 min)
|
|
1. Crée les schémas
|
|
2. Lance un pipeline ETL
|
|
3. Consulte les logs
|
|
|
|
### Niveau 3 : Maîtrise (1h)
|
|
1. Lis la documentation complète
|
|
2. Comprends l'architecture
|
|
3. Personnalise l'interface
|
|
|
|
---
|
|
|
|
## 📦 Ce qui a été créé
|
|
|
|
**Backend** : 5 routers, 17 endpoints API
|
|
**Frontend** : 5 pages, navigation moderne
|
|
**Documentation** : 8 fichiers complets
|
|
**Scripts** : Démarrage automatique
|
|
|
|
**Total** : 32 fichiers, ~2500 lignes de code
|
|
|
|
---
|
|
|
|
## 🚀 Commande Magique
|
|
|
|
**Option 1 - Script complet (recommandé)** :
|
|
```bash
|
|
cd omop && ./run.sh
|
|
```
|
|
|
|
**Option 2 - Script simple** :
|
|
```bash
|
|
cd omop && ./start_web.sh
|
|
```
|
|
|
|
Puis ouvre : **http://localhost:4400**
|
|
|
|
**C'est parti ! 🎉**
|
|
|
|
---
|
|
|
|
## 💡 Astuce
|
|
|
|
Garde cette page ouverte pendant que tu explores l'interface.
|
|
Tu peux y revenir à tout moment pour te rappeler des commandes.
|
|
|
|
---
|
|
|
|
## 🎊 Félicitations !
|
|
|
|
Tu as maintenant une interface web professionnelle pour gérer ton pipeline OMOP !
|
|
|
|
**Bon développement ! 🚀**
|
|
|
|
---
|
|
|
|
## 📋 Checklist de Démarrage
|
|
|
|
- [ ] Installer les dépendances backend (`pip install -r requirements-api.txt`)
|
|
- [ ] Installer les dépendances frontend (`cd frontend && npm install`)
|
|
- [ ] Lancer l'interface (`./start_web.sh`)
|
|
- [ ] Ouvrir http://localhost:3000
|
|
- [ ] Explorer le Dashboard
|
|
- [ ] Créer les schémas (Schema Manager)
|
|
- [ ] Lancer un pipeline ETL (ETL Manager)
|
|
- [ ] Consulter les logs (Logs)
|
|
- [ ] Lire la documentation complète
|
|
|
|
**Coche les cases au fur et à mesure ! ✓**
|