TrashBin

# TrashBin - Manuel Utilisateur

## Qu'est-ce que TrashBin ?

TrashBin est une **corbeille** pour Dolibarr, comme celle que vous avez sur votre ordinateur. Lorsque vous supprimez un élément par erreur (un client, un produit, une facture...), au lieu de le perdre définitivement, il est placé dans la corbeille. Vous pouvez ensuite le restaurer facilement.

---

## 📋 Accéder à la corbeille

1. Dans le menu principal de Dolibarr, cliquez sur **"TrashBin"** (icône poubelle)
2. Vous accédez à la liste de tous les éléments supprimés

---

## 👁️ Consulter la liste des éléments supprimés

La liste affiche :
- **Type** : Le type d'élément (Tiers, Produit, Facture, etc.)
- **Référence** : Le nom ou numéro de l'élément
- **Date de suppression** : Quand l'élément a été supprimé
- **Supprimé par** : Qui a supprimé l'élément

### Rechercher un élément

Utilisez le champ de recherche en haut de la page pour trouver rapidement un élément par sa référence ou son nom.

---

## ♻️ Restaurer un élément

### Restaurer un seul élément

1. Dans la liste, cliquez sur la **référence** de l'élément que vous voulez restaurer
2. Sur la page de détail, cliquez sur le bouton **"Restaurer"**
3. Une confirmation s'affiche : l'élément est de nouveau disponible dans Dolibarr

> **💡 Astuce** : Les éléments sont restaurés avec toutes leurs informations (coordonnées, prix, lignes de facture, contacts associés, etc.)

---

## 🗑️ Supprimer définitivement

Si vous êtes sûr de ne plus avoir besoin d'un élément, vous pouvez le supprimer définitivement de la corbeille.

### Supprimer un élément définitivement

1. Cliquez sur la référence de l'élément
2. Cliquez sur le bouton **"Supprimer définitivement"**
3. ⚠️ **Attention** : Cette action est irréversible ! L'élément sera perdu pour toujours.

### Vider toute la corbeille

1. En haut de la liste, cliquez sur **"Vider la corbeille"**
2. Confirmez l'action
3. ⚠️ **Attention** : Tous les éléments de la corbeille seront définitivement supprimés !

### Vider une sélection

1. Cochez les cases des éléments à supprimer définitivement
2. Cliquez sur **"Purger la sélection"**
3. Confirmez : les éléments cochés seront supprimés définitivement

---

## 🔍 Voir les détails d'un élément

Cliquez sur la référence d'un élément pour voir sa fiche détaillée.

### Bouton "Voir le JSON"

Ce bouton permet d'afficher toutes les informations techniques de l'élément sous forme de données. C'est utile pour :
- Vérifier qu'un élément contient bien toutes les informations avant de le restaurer
- Partager les détails avec le support technique en cas de problème

Cliquez sur **"Masquer le JSON"** pour refermer ces informations.

---

## ⚙️ Configuration (pour les administrateurs)

### Accéder à la configuration

1. Allez dans **Accueil → Configuration → Modules/Applications**
2. Trouvez le module **TrashBin** dans la liste
3. Cliquez sur l'icône **engrenage** (⚙️) à droite du module

### Purge automatique

Vous pouvez configurer une **purge automatique** pour nettoyer automatiquement la corbeille.

- **Délai de purge automatique (jours)** : Nombre de jours pendant lesquels les éléments sont conservés dans la corbeille
  - Exemple : Si vous mettez **30**, les éléments supprimés depuis plus de 30 jours seront automatiquement effacés de la corbeille
  - Mettez **0** pour désactiver la purge automatique (les éléments restent indéfiniment)

**Recommandation** : 
- Pour une petite structure : **90 jours** (3 mois)
- Pour une grande structure : **30 jours** (1 mois)

La purge se déclenche automatiquement chaque fois que quelqu'un ouvre la page de la corbeille.

---

## ❓ Questions fréquentes

### Tous mes éléments supprimés vont-ils dans la corbeille ?

Oui, TrashBin capture automatiquement la suppression de tous les types d'éléments :
- Tiers (clients/fournisseurs)
- Contacts
- Produits et services
- Factures
- Devis
- Commandes
- Projets
- Interventions
- Etc.

### Puis-je restaurer un élément supprimé il y a plusieurs mois ?

Oui, tant que l'élément est encore dans la corbeille. Si une purge automatique est configurée, vérifiez le délai de conservation.

### Les fichiers joints sont-ils conservés ?

Les informations de l'élément sont conservées. Les documents liés peuvent nécessiter une attention particulière selon le contexte de suppression.

### Que se passe-t-il si je restaure un client supprimé ?

Le client est restauré avec :
- Toutes ses coordonnées
- Ses contacts associés
- Ses catégories
- Ses champs personnalisés
- Toutes ses informations
- Les documents
- Les images
- Les extrafields

### Puis-je restaurer une facture avec toutes ses lignes ?

Oui, les factures sont restaurées avec toutes leurs lignes, montants, et détails.

---

## 🆘 Besoin d'aide ?

Si vous avez supprimé un élément important par erreur :

1. **Ne paniquez pas** 😊
2. Allez dans **TrashBin**
3. Recherchez l'élément par son nom ou sa référence
4. Cliquez dessus pour vérifier que c'est bien le bon
5. Cliquez sur **"Restaurer"**

Si vous ne trouvez pas l'élément dans la corbeille, contactez votre administrateur système : il pourra vérifier si une purge automatique a été activée.

---

## 🔐 Permissions

Votre administrateur peut définir qui peut :
- **Lire la corbeille** : Voir la liste des éléments supprimés
- **Restaurer des objets** : Remettre des éléments dans Dolibarr
- **Purger des objets** : Supprimer définitivement de la corbeille
- **Administrer la corbeille** : Accéder à la configuration

Si vous n'avez pas accès à certaines fonctions, contactez votre administrateur.

---

**Module TrashBin - Version 1.0.0**  
*Développé par Goldoweb SL*  
*Support : goldoweb@gmail.com*