ODOO/README.md

# TP4-5 : ERP Odoo pour Covoit'Ouest

Projet de mise en place d'un ERP Odoo pour une start-up de covoiturage régional.

## 🎯 Objectifs

- ✅ Installer et configurer Odoo 17 avec Docker
- ✅ Cartographier les processus métier d'une start-up de covoiturage
- ✅ Configurer les modules Odoo pour répondre aux besoins métier
- ✅ Mettre en place un CRM pour l'acquisition de conducteurs
- ✅ Définir les indicateurs clés pour le tableau de bord Direction

## 📁 Structure du Projet

```
/GIT/ODOO/
├── 📄 compterendu.md                      # Compte-rendu complet du TP ⭐
├── 📄 docker-compose.yml                  # Configuration Docker
├── 📄 .env                                # Variables d'environnement
├── 📂 config/
│   └── odoo.conf                         # Configuration Odoo
├── 📂 addons/                            # Modules personnalisés (vide)
├── 📂 docs/
│   ├── installation.md                   # Guide d'installation détaillé
│   ├── cartographie_covoit_ouest.md     # Cartographie fonctionnelle & applicative
│   ├── tableau_de_bord_direction.md     # Guide tableau de bord & KPI
│   └── deploy.md                        # Procédure de déploiement
├── 📄 create_users.py                    # Script création utilisateurs
├── 📄 exercice3_configuration_metier.py  # Script exercice 3
└── 📄 exercice4_crm.py                   # Script exercice 4
```

## 🚀 Démarrage Rapide

### Prérequis
- Docker & Docker Compose installés
- Port 8069 disponible

### Installation

1. **Démarrer les conteneurs**
   ```bash
   cd /GIT/ODOO
   docker-compose up -d
   ```

2. **Corriger les permissions (Important!)**
   ```bash
   sudo chown -R 101:101 config addons
   ```

3. **Créer la base de données**
   ```bash
   docker exec odoo_app odoo -d covoiturage_db -i base --stop-after-init --without-demo=all
   docker restart odoo_app
   ```

4. **Installer les modules**
   ```bash
   docker exec odoo_app odoo -d covoiturage_db -i crm,sale_management,account,hr --stop-after-init
   docker restart odoo_app
   ```

5. **Créer les utilisateurs**
   ```bash
   python3 create_users.py
   ```

6. **Accéder à Odoo**
   ```
   URL: http://localhost:8069
   Base de données: covoiturage_db
   Utilisateur: admin
   Mot de passe: admin
   ```

## 👥 Utilisateurs Créés

| Utilisateur | Login | Mot de passe | Rôle |
|-------------|-------|--------------|------|
| Administrateur | admin | admin | Administration complète |
| Gestionnaire Trajets | gestionnaire.trajets | trajets123 | Gestion commerciale |
| Gestionnaire Finance | gestionnaire.finance | finance123 | Gestion comptable |

## 📊 Données de Démonstration

Le système contient les données suivantes:

- **3 contacts**: Jean Dupont (conducteur), Marie Martin (passager), Pierre Durand (prospect)
- **1 trajet**: La Rochelle → Nantes (15€)
- **1 réservation**: Commande confirmée (Marie Martin)
- **1 lead CRM**: Prospect conducteur (Pierre Durand) - Gagné
- **1 activité support**: Ticket "Retard de trajet" - Résolu

## 📖 Documentation

### Documents Principaux

1. **[compterendu.md](compterendu.md)** ⭐
   - Compte-rendu complet du TP
   - Résultats de tous les exercices
   - Analyse et recommandations
   - **À lire en priorité**

2. **[docs/installation.md](docs/installation.md)**
   - Guide d'installation pas à pas
   - Résolution des problèmes courants
   - Commandes Docker utiles

3. **[docs/cartographie_covoit_ouest.md](docs/cartographie_covoit_ouest.md)**
   - Processus métier de Covoit'Ouest
   - Mapping avec les modules Odoo
   - Architecture applicative

4. **[docs/tableau_de_bord_direction.md](docs/tableau_de_bord_direction.md)**
   - Indicateurs clés (KPI)
   - Configuration du tableau de bord
   - Exemples de graphiques

## 🧪 Scripts Python

### create_users.py
Crée les 3 utilisateurs Odoo via l'API XML-RPC.

```bash
python3 create_users.py
```

### exercice3_configuration_metier.py
Exercice 3: Configuration métier
- Crée les contacts (conducteur, passager)
- Crée le trajet "La Rochelle → Nantes"
- Simule une réservation (devis → commande)
- Enregistre un paiement

```bash
python3 exercice3_configuration_metier.py
```

### exercice4_crm.py
Exercice 4: CRM et suivi
- Crée un prospect conducteur
- Simule le pipeline CRM
- Convertit le prospect en client actif
- Crée un ticket de support

```bash
python3 exercice4_crm.py
```

## 📈 Modules Odoo Installés

- **Base** (base): Module de base Odoo
- **CRM** (crm): Gestion de la relation client
- **Ventes** (sale_management): Gestion des devis et commandes
- **Facturation** (account): Comptabilité et facturation
- **Ressources Humaines** (hr): Gestion des employés

## 🎓 Exercices Réalisés

### Exercice 1: Installation et Configuration ✅
- Installation Docker d'Odoo 17
- Configuration de PostgreSQL
- Résolution du problème de permission
- Création de la base de données
- Installation des modules de base
- Création des utilisateurs métiers

### Exercice 2: Cartographie Fonctionnelle ✅
- Identification des processus métier
- Mapping avec les modules Odoo
- Documentation complète
- Architecture applicative

### Exercice 3: Configuration Métier ✅
- Création de contacts (conducteur, passager)
- Création du trajet comme produit/service
- Simulation d'une réservation (devis → commande)
- Enregistrement d'un paiement

### Exercice 4: CRM et Suivi ✅
- Pipeline prospect conducteur
- Qualification et conversion
- Création d'un ticket de support
- Résolution et suivi

### Exercice 5: Tableau de Bord ✅
- Définition des KPI
- Documentation pour créer le tableau de bord
- Recommandations de graphiques
- Exemples de requêtes SQL

## 🔧 Commandes Utiles

### Docker
```bash
# Démarrer
docker-compose up -d

# Arrêter
docker-compose down

# Logs
docker logs odoo_app -f

# Redémarrer
docker restart odoo_app
```

### Odoo
```bash
# Créer une base de données
docker exec odoo_app odoo -d <db_name> -i base --stop-after-init

# Installer un module
docker exec odoo_app odoo -d <db_name> -i <module_name> --stop-after-init

# Mettre à jour un module
docker exec odoo_app odoo -d <db_name> -u <module_name> --stop-after-init
```

### PostgreSQL
```bash
# Lister les bases
docker exec odoo_db psql -U odoo -c "\l"

# Sauvegarde
docker exec odoo_db pg_dump -U odoo covoiturage_db > backup.sql

# Restauration
cat backup.sql | docker exec -i odoo_db psql -U odoo -d covoiturage_db
```

## 🎯 Résultats

### Couverture Fonctionnelle: ~85%

| Processus | Couverture | Module Odoo |
|-----------|-----------|-------------|
| Gestion utilisateurs | 90% | Contacts + CRM |
| Gestion trajets | 80% | Produits + Ventes |
| Réservations | 85% | Commandes |
| Facturation | 95% | Account |
| CRM | 85% | CRM |
| Support client | 70% | Activités |
| RH | 100% | HR |

### Points Forts ✅
- Installation et configuration réussies
- Processus métier bien modélisés
- Scripts d'automatisation fonctionnels
- Documentation complète

### Limitations ⚠️
- Certaines méthodes API ont changé dans Odoo 17
- Module Helpdesk non installé (Community Edition)
- Nécessite des développements spécifiques pour le matching passagers/conducteurs

## 🚀 Prochaines Étapes

### Court Terme (1-3 mois)
- Migrer toutes les données existantes
- Former l'équipe à Odoo
- Utiliser en production

### Moyen Terme (3-6 mois)
- Développer un module covoiturage personnalisé
- Intégrer des API externes (Maps, Paiement)
- Créer des tableaux de bord avancés

### Long Terme (6-12 mois)
- Développer une application mobile
- Implémenter un algorithme de matching
- Business Intelligence et analyses prédictives

## 📚 Ressources

- **Documentation Odoo**: https://www.odoo.com/fr_FR/page/docs
- **Tutoriels**: https://www.odoo.com/fr_FR/slides/all
- **GitHub Odoo**: https://github.com/odoo/odoo
- **Communauté**: https://www.odoo.com/fr_FR/forum

## 🤝 Support

Pour toute question sur ce projet:
1. Consulter le [compte-rendu complet](compterendu.md)
2. Vérifier la [documentation d'installation](docs/installation.md)
3. Consulter la section "Difficultés Rencontrées" du compte-rendu

## 📝 License

Ce projet est réalisé dans le cadre d'un TP universitaire.

---

**Réalisé pour le TP4-5 - ERP ODOO**
**La Rochelle Université - 2025**