📝 Système de Devis et Avenants - Guide Complet

✅ Ce qui a été installé

🎯 Fonctionnalités ajoutées

Votre système dispose maintenant de 2 nouveaux modules :

1. 📝 Devis - Créer et gérer des devis clients
2. 📋 Avenants - Créer et gérer des avenants aux contrats

---

📊 Base de données

Tables créées :

1. quotes (Devis)

```sql

• id : Identifiant unique
• quote_number : Numéro du devis (ex: DEV20251025001)
• client_id : Client concerné
• quote_date : Date du devis
• valid_until : Date de validité
• status : Statut (draft, sent, accepted, rejected, expired)
• subtotal, tax_rate, tax_amount, total : Montants
• notes : Notes internes
• terms : Conditions générales
• signature : Signature électronique

```

2. quote_items (Lignes de devis)

```sql

• id : Identifiant unique
• quote_id : Devis parent
• description : Description de la ligne
• quantity : Quantité
• unit_price : Prix unitaire
• total : Total de la ligne

```

3. amendments (Avenants)

```sql

• id : Identifiant unique
• amendment_number : Numéro de l'avenant (ex: AVE20251025001)
• original_contract_number : N° du contrat original
• client_id : Client concerné
• amendment_date : Date de l'avenant
• effective_date : Date d'effet
• status : Statut (draft, pending, approved, rejected)
• amendment_type : Type (modification, addition, termination, extension)
• description : Description des changements
• old_value : Ancienne valeur
• new_value : Nouvelle valeur
• reason : Raison du changement
• signature : Signature électronique

```

---

🔐 Permissions

Les permissions ont été ajoutées pour les 3 rôles :

| Action | 👑 Admin | 💼 Gestionnaire | 👁️ Lecteur |

|--------|----------|-----------------|-------------|

| Voir devis | ✅ | ✅ | ✅ |

| Créer devis | ✅ | ✅ | ❌ |

| Modifier devis | ✅ | ✅ | ❌ |

| Supprimer devis | ✅ | ✅ | ❌ |

| Voir avenants | ✅ | ✅ | ✅ |

| Créer avenants | ✅ | ✅ | ❌ |

| Modifier avenants | ✅ | ✅ | ❌ |

| Supprimer avenants | ✅ | ✅ | ❌ |

---

🎨 Navigation

Le menu principal a été mis à jour :

```

┌────────────────────────────────────────┐

│ 📊 Tableau de bord │

│ 📄 Factures │

│ 📝 Devis ← NOUVEAU ! │

│ 📋 Avenants ← NOUVEAU ! │

│ 👥 Clients │

│ 📦 Produits │

│ 👤 Utilisateurs │

└────────────────────────────────────────┘

```

---

🚀 Installation

Étape 1 : Uploadez les fichiers modifiés

Uploadez ces fichiers sur votre serveur :

1. ✅ pages/admin/config-db.php
2. ✅ pages/admin/check-permissions.php
3. ✅ pages/admin/header.php
4. ✅ pages/admin/add-quotes-amendments-tables.php

Étape 2 : Exécutez le script de migration

Allez sur cette URL :

```

https://www.web.proinfo83.fr/admin/add-quotes-amendments-tables.php

```

Vous verrez :

```

✅ Table 'quotes' créée avec succès !

✅ Table 'quote_items' créée avec succès !

✅ Table 'amendments' créée avec succès !

```

Étape 3 : Vérifiez le menu

1. Allez sur votre tableau de bord
2. Vous devriez voir les nouveaux liens :

- 📝 Devis

- 📋 Avenants

---

📋 Prochaines étapes

Pages à créer (en développement) :

Pour les DEVIS :

• [ ] quotes.php - Liste des devis
• [ ] edit-quote.php - Créer/Modifier un devis
• [ ] view-quote.php - Visualiser/Imprimer un devis

Pour les AVENANTS :

• [ ] amendments.php - Liste des avenants
• [ ] edit-amendment.php - Créer/Modifier un avenant
• [ ] view-amendment.php - Visualiser/Imprimer un avenant

---

🎯 Fonctionnalités prévues

Devis :

Création :

• ✅ Numérotation automatique (DEV20251025001)
• ✅ Sélection du client
• ✅ Ajout de lignes (description, quantité, prix)
• ✅ Calcul automatique des totaux
• ✅ Date de validité
• ✅ Signature électronique

Gestion :

• ✅ Statuts : Brouillon, Envoyé, Accepté, Refusé, Expiré
• ✅ Recherche et filtres
• ✅ Conversion en facture
• ✅ Envoi par email
• ✅ Export PDF

Avenants :

Création :

• ✅ Numérotation automatique (AVE20251025001)
• ✅ Lien avec contrat original
• ✅ Sélection du client
• ✅ Type d'avenant (Modification, Ajout, Résiliation, Prolongation)
• ✅ Description des changements
• ✅ Ancienne/Nouvelle valeur
• ✅ Raison du changement
• ✅ Signature électronique

Gestion :

• ✅ Statuts : Brouillon, En attente, Approuvé, Refusé
• ✅ Recherche et filtres
• ✅ Historique des modifications
• ✅ Export PDF

---

📝 Format de numérotation

Devis :

```

DEV + AAAAMMJJ + NNN

Exemple : DEV20251025001

```

Avenants :

```

AVE + AAAAMMJJ + NNN

Exemple : AVE20251025001

```

---

🎨 Design

Les pages suivront le même design que les factures :

• ✅ Thème Proinfo83 (bleu #0ea5e9 + violet #8b5cf6)
• ✅ Responsive (mobile, tablette, desktop)
• ✅ Signature électronique au doigt/stylet
• ✅ Impression/PDF optimisé

---

🔄 Workflow typique

Pour un DEVIS :

1. Créer un devis (Statut: Brouillon)
2. Envoyer au client (Statut: Envoyé)
3. Client accepte → Convertir en facture
4. Client refuse → Marquer comme refusé
5. Date expirée → Statut automatique: Expiré

Pour un AVENANT :

1. Créer un avenant (Statut: Brouillon)
2. Soumettre pour approbation (Statut: En attente)
3. Approuver (Statut: Approuvé)
4. Ou refuser (Statut: Refusé)

---

📊 Statistiques

Le tableau de bord affichera :

• 📝 Nombre de devis en cours
• ✅ Taux d'acceptation des devis
• 📋 Nombre d'avenants en attente
• 💰 Montant total des devis acceptés

---

🆘 Support

Si les liens n'apparaissent pas :

1. Vérifiez que header.php est bien uploadé
2. Videz le cache de votre navigateur (Ctrl+F5)
3. Déconnectez-vous et reconnectez-vous

Si vous n'avez pas accès :

1. Vérifiez votre rôle (doit être Admin ou Gestionnaire)
2. Exécutez fix-admin-role.php si nécessaire

---

📁 Fichiers modifiés

| Fichier | Modifications |

|---------|--------------|

| config-db.php | ✅ Ajout des 3 tables |

| check-permissions.php | ✅ Ajout des permissions |

| header.php | ✅ Ajout des liens menu |

| add-quotes-amendments-tables.php | ✨ Nouveau script |

---

🎉 Statut actuel

✅ Base de données : Prête

✅ Permissions : Configurées

✅ Navigation : Mise à jour

⏳ Pages : En développement

---

Les fondations sont en place ! Les pages de gestion arrivent bientôt... 🚀