# 📚 Exemples de données WTY - Verisav Warranty & Contracts Examples

Cette collection d'exemples RDF/Turtle démontre l'utilisation pratique du vocabulaire **Verisav WTY (Warranty & Contracts)** dans des scénarios réels.

## 🎯 Objectif

Ces exemples servent à :
- **Démontrer l'utilisation concrète** du vocabulaire WTY
- **Faciliter l'adoption** par les développeurs et assureurs
- **Documenter les cas d'usage** courants (garanties, contrats, évaluations)
- **Améliorer le référencement** via le Federated Learning Graph

## 📋 Exemples disponibles

### 1. Simple Warranty (`simple-warranty.ttl`)
**Cas d'usage :** Garantie étendue simple avec couverture et règles de paiement  
**Produit :** Ordinateur portable  
**Caractéristiques :**
- Garantie étendue 36 mois
- Définition de couverture (composants, types de défauts)
- Exclusions (dommages physiques, usure normale)
- Règles de paiement (100% couvert)
- Conditions d'utilisation

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

---

### 2. Maintenance Contract (`maintenance-contract.ttl`)
**Cas d'usage :** Contrat de maintenance avec limites  
**Produit :** Équipement industriel  
**Caractéristiques :**
- Contrat de maintenance annuel
- Couverture préventive et corrective
- Limite de nombre d'interventions (12 par an)
- Conditions d'installation

**Fichier :** [maintenance-contract.ttl](./maintenance-contract.ttl)

---

### 3. Claim Assessment (`claim-assessment.ttl`)
**Cas d'usage :** Évaluation automatisée de réclamation  
**Produit :** Lave-linge  
**Caractéristiques :**
- Évaluation de réclamation contre garantie
- Vérification de couverture
- Décision de paiement automatisée
- Génération de facture automatique

**Fichier :** [claim-assessment.ttl](./claim-assessment.ttl)

---

### 4. Warranty with Limits (`warranty-with-limits.ttl`)
**Cas d'usage :** Garantie avec limites financières et quantitatives  
**Produit :** Smartphone premium  
**Caractéristiques :**
- Garantie avec limite financière totale (2000€)
- Limite de nombre d'interventions (3 max)
- Exclusions (dommages cosmétiques)
- Règles de paiement avec limites

**Fichier :** [warranty-with-limits.ttl](./warranty-with-limits.ttl)

---

### 5. Demo Complete Warranty (`demo-complete-warranty.ttl`)
**Cas d'usage :** Scénario exhaustif avec toutes les fonctionnalités  
**Produit :** Véhicule électrique  
**Caractéristiques :**
- Garantie complète avec couverture détaillée
- Multiples exclusions
- Règles de paiement avec limites
- Conditions multiples
- Évaluation de réclamation
- Génération de facture automatique
- Intégration avec vocabulaire DPP (WorkOrder, Intervention)

**Fichier :** [demo-complete-warranty.ttl](./demo-complete-warranty.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 WTY : [https://ns.verisav.fr/wty](https://ns.verisav.fr/wty)
- Connaître le vocabulaire Verisav DPP : [https://ns.verisav.fr/dpp](https://ns.verisav.fr/dpp) (pour les exemples complets)
- Connaître le vocabulaire Verisav RMA : [https://ns.verisav.fr/rma](https://ns.verisav.fr/rma) (pour l'intégration)

### Comment utiliser

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

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

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

## 📖 Vocabulaire utilisé

### Classes principales
- `wty:Warranty` - Garantie étendue avec règles machine-readable
- `wty:Contract` - Contrat (maintenance, extension, assurance)
- `wty:Coverage` - Définition de couverture
- `wty:Exclusion` - Définition d'exclusions
- `wty:PaymentRule` - Règles de paiement
- `wty:Condition` - Conditions d'application
- `wty:Limit` - Limites (financières, quantitatives)
- `wty:ClaimAssessment` - Évaluation automatisée de réclamation
- `wty:Invoice` - Facture générée automatiquement

### Propriétés principales
- `wty:definesCoverage` - Lien vers couverture
- `wty:definesExclusions` - Lien vers exclusions
- `wty:definesPaymentRule` - Lien vers règles de paiement
- `wty:triggersAssessment` - Déclenche évaluation
- `wty:assessmentResult` - Résultat d'évaluation
- `wty:coveredAmount` - Montant couvert
- `wty:generatesInvoice` - Génère facture

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

## 🔗 Liens vers le vocabulaire

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

## ✅ Validation

Tous les exemples sont :
- ✅ Syntaxiquement valides (RDF/Turtle)
- ✅ Sémantiquement corrects (utilisent le vocabulaire WTY 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 WTY.

## 🤝 Contribution

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

## 📞 Support

- **Documentation :** [https://ns.verisav.fr/wty/](https://ns.verisav.fr/wty/)
- **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