# 📚 Exemples de données RMA - Verisav RMA / Ticketing Examples

Cette collection d'exemples RDF/Turtle démontre l'utilisation pratique du vocabulaire **Verisav RMA (Return Merchandise Authorization)** dans des scénarios réels.

## 🎯 Objectif

Ces exemples servent à :
- **Démontrer l'utilisation concrète** du vocabulaire RMA
- **Faciliter l'adoption** par les développeurs et e-commerçants
- **Documenter les cas d'usage** courants (retours, tickets, litiges)
- **Améliorer le référencement** via le Federated Learning Graph

## 📋 Exemples disponibles

### 1. Simple Return Refund (`simple-return-refund.ttl`)
**Cas d'usage :** Retour simple avec remboursement  
**Produit :** Article de mode (taille incorrecte)  
**Caractéristiques :**
- Demande de retour simple
- Raison : Article incorrect
- Résolution : Remboursement complet
- Approbation du retour

**Fichier :** [simple-return-refund.ttl](./simple-return-refund.ttl)

---

### 2. Ticket with Dispute (`ticket-with-dispute.ttl`)
**Cas d'usage :** Ticket de service avec litige et résolution  
**Produit :** Appareil électronique (arrivé cassé)  
**Caractéristiques :**
- Ticket de service créé
- Litige : Produit endommagé pendant l'expédition
- Résolution : Échange de produit
- Fil de conversation avec messages

**Fichier :** [ticket-with-dispute.ttl](./ticket-with-dispute.ttl)

---

### 3. Return with Shipping (`return-with-shipping.ttl`)
**Cas d'usage :** Retour avec étiquette d'expédition et suivi  
**Produit :** Électroménager défectueux  
**Caractéristiques :**
- Demande de retour
- Étiquette d'expédition générée
- Suivi de colis (tracking)
- Statut de suivi en temps réel

**Fichier :** [return-with-shipping.ttl](./return-with-shipping.ttl)

---

### 4. Service Ticket Complete (`service-ticket-complete.ttl`)
**Cas d'usage :** Ticket de service complet avec fil de conversation  
**Produit :** Ordinateur portable  
**Caractéristiques :**
- Ticket de service avec historique complet
- Multiple messages dans la conversation
- Retour organisé depuis le ticket
- Résolution : Réparation sous garantie

**Fichier :** [service-ticket-complete.ttl](./service-ticket-complete.ttl)

---

### 5. Demo Complete Scenario (`demo-complete-scenario.ttl`)
**Cas d'usage :** Scénario RMA exhaustif avec toutes les fonctionnalités  
**Produit :** Smartphone  
**Caractéristiques :**
- Ticket de service complet
- Litige détaillé
- Demande de retour
- Étiquette d'expédition et suivi
- Résolution avec ordre de travail
- Fil de conversation complet
- Intégration avec vocabulaire DPP (garantie, WorkOrder)

**Fichier :** [demo-complete-scenario.ttl](./demo-complete-scenario.ttl)

## 🔧 Utilisation

### Format
Tous les exemples sont en format **Turtle (.ttl)**, standard RDF lisible par l'humain.

### Prérequis
- Comprendre les bases du format RDF/Turtle
- Connaître le vocabulaire Verisav RMA : [https://ns.verisav.fr/rma](https://ns.verisav.fr/rma)
- Connaître le vocabulaire Verisav DPP : [https://ns.verisav.fr/dpp](https://ns.verisav.fr/dpp) (pour les exemples complets)

### Comment utiliser

1. **Télécharger un exemple** :
   ```bash
   curl https://www.verisav.fr/data/rma-examples/simple-return-refund.ttl
   ```

2. **Parser avec un outil RDF** :
   ```bash
   # Avec Apache Jena
   riot --validate simple-return-refund.ttl
   
   # Avec rdflib (Python)
   python -c "from rdflib import Graph; g = Graph(); g.parse('simple-return-refund.ttl', format='turtle'); print(len(g))"
   ```

3. **Adapter pour votre cas d'usage** :
   - Remplacez les URIs de base
   - Adaptez les propriétés à votre workflow RMA
   - Utilisez vos propres données

## 📖 Vocabulaire utilisé

### Classes principales
- `rma:ReturnRequest` - Demande de retour de marchandise
- `rma:Ticket` - Ticket de service client
- `rma:Dispute` - Litige ou réclamation
- `rma:Resolution` - Résolution proposée ou appliquée
- `rma:ShippingLabel` - Étiquette d'expédition
- `rma:Message` - Message dans un fil de conversation
- `rma:Approval` - Approbation d'une demande
- `rma:Tracking` - Suivi de colis

### Propriétés principales
- `rma:hasReturnRequest` - Lien vers demande de retour
- `rma:hasTicket` - Lien vers ticket
- `rma:hasDispute` - Lien vers litige
- `rma:hasResolution` - Lien vers résolution
- `rma:returnRequestNumber` - Numéro de RMA
- `rma:returnReason` - Raison du retour
- `rma:ticketStatus` - Statut du ticket
- `rma:trackingNumber` - Numéro de suivi

**Documentation complète :** [https://ns.verisav.fr/rma](https://ns.verisav.fr/rma)

## 🔗 Liens vers le vocabulaire

- **Namespace :** `https://ns.verisav.fr/rma#`
- **Documentation :** [https://ns.verisav.fr/rma/](https://ns.verisav.fr/rma/)
- **Turtle :** [https://ns.verisav.fr/rma/rma.ttl](https://ns.verisav.fr/rma/rma.ttl)
- **JSON-LD :** [https://ns.verisav.fr/rma/rma.jsonld](https://ns.verisav.fr/rma/rma.jsonld)

## ✅ Validation

Tous les exemples sont :
- ✅ Syntaxiquement valides (RDF/Turtle)
- ✅ Sémantiquement corrects (utilisent le vocabulaire RMA correctement)
- ✅ Complétés avec métadonnées Schema.org
- ✅ Multilingues (français/anglais)

## 📝 Licence

Ces exemples sont publiés sous [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/), la même licence que le vocabulaire RMA.

## 🤝 Contribution

Pour proposer de nouveaux exemples ou améliorer les existants :
1. Créez votre fichier `.ttl`
2. Respectez le format et le vocabulaire RMA
3. Ajoutez des commentaires en français et anglais
4. Proposez via une issue ou pull request

## 📞 Support

- **Documentation :** [https://ns.verisav.fr/rma/](https://ns.verisav.fr/rma/)
- **Site web :** [https://www.verisav.fr](https://www.verisav.fr)
- **Contact :** contact@verisav.fr

---

**Dernière mise à jour :** 2025-12-18  
**Version du vocabulaire :** 1.0.0