spec(v4): R4-P0-3 — 5 example downloadable personas (docs-only)

[Davincc77]

Résumé

Inscrit R4-P0-3 (ROAD-TO-V4-GA §R4-P0-3) : 5 profils d'exemple téléchargeables sous examples/v4/personas/, couvrant exactement la matrice de personas inscrite au backlog v4 :

#	Fichier	Persona	Langue	Domaine	Facette preview
1	01-eleve-terminale-fr.klickd	Élève de Terminale (FR / Luxembourg)	fr	education	—
2	02-chef-projet-pme-fr.klickd	Chef de projet PME	fr	work	—
3	03-fullstack-developer-en.klickd	Full-stack developer	en	work	reversibility / blast_radius (RFC-002 v2-additive)
4	04-createur-media-fr.klickd	Créateur·rice média	fr	creator	media.klickd (RFC-001 v1)
5	05-rpg-gamer-en.klickd	RPG gamer	en	gaming	gaming.klickd baseline (R4-P1-4, registry-based)

Chaque fichier embarque un bloc _example_metadata qui rappelle explicitement :

• non_normative: true
• contains_real_pii: false
• contains_secrets: false
• test_passphrase_if_encrypted: "klickd-example-only" (passphrase publique de test, jamais un secret réel)

Forme livrée : JSON lisible (encrypted: false), conforme à la convention déjà utilisée par examples/student_fr.klickd, examples/professional_en.klickd, examples/family_plan.klickd, examples/v4-preview/minimal.klickd. La forme chiffrée reste reproductible localement via save_klickd.py — la README détaille la procédure.

Périmètre

Docs-only. Ce PR :

• n'ajoute aucun nouveau schéma ;
• ne modifie aucun vector (tests/vectors_v40_preview.json inchangé) ;
• ne touche pas aux SDKs Python ni @klickd/core ;
• ne déclenche aucune release : pas de tag, pas de latest npm/PyPI, pas de DOI Zenodo, pas de bump de version SDK ;
• n'implémente pas R4-P0-4 (politique de dépréciation V4) — c'est la prochaine track.

Fichiers modifiés

• examples/v4/personas/01-eleve-terminale-fr.klickd (nouveau)
• examples/v4/personas/02-chef-projet-pme-fr.klickd (nouveau)
• examples/v4/personas/03-fullstack-developer-en.klickd (nouveau)
• examples/v4/personas/04-createur-media-fr.klickd (nouveau)
• examples/v4/personas/05-rpg-gamer-en.klickd (nouveau)
• examples/v4/personas/README.md (nouveau)
• docs/roadmap/ROAD-TO-V4-GA.md (ajout d'une ligne Statut: sous R4-P0-3 pointant vers le nouveau dossier)
• SPEC.md (ajout d'un pointeur non-normatif vers le dossier depuis §33.5)

Conformité DoD R4-P0-3

Critère	Statut
5 fichiers correspondant à la matrice de personas du backlog	✅
Chaque fichier porte preview: "v4.0.0-preview.1" + payload_schema_version	✅
Aucune donnée personnelle réelle, aucun secret, aucun token	✅
Passphrase publique de test documentée (klickd-example-only)	✅
Validation contre le schéma permissif v4-preview (schemas/ et schema/)	✅
Validation stricte v4 + round-trip SDK	⏳ différé à P0-2 / P0-6 / SDK alignment (dépendances inscrites au backlog)

Test plan

• python3 -c "import json, pathlib, jsonschema; ..." valide les 5 personas contre schemas/klickd-payload-v4-preview.schema.json → 5/5 OK.
• Idem contre schema/klickd-v4-preview.schema.json (forme unifiée) → 5/5 OK.
• grep sécurité (secret / token / api_key / password / email patterns) → aucune occurrence dans les fichiers persona.
• Les commandes Python / Node de validation sont reproductibles depuis la README (§4) — copier-coller direct.
• Validation stricte v4 (P0-2/P0-6) — différée : les vectors stricts v4 et le schéma strict v4 n'existent pas encore (ordre des dépendances).

Garde-fous anti-pattern

• A5 — Spec-first sans exemples : levé pour R4-P0-3 ; les 5 personas couvrent toute la matrice de domaines/profils référencée par R4-P0-1.
• A4 — Inflation schéma : aucun nouveau champ introduit. Les sections preview utilisées (verification_gates, media_profile, gaming_profile, …) sont déjà documentées par RFC-001 v1 / RFC-002 v1 / R4-P1-4.

Prochaine étape

R4-P0-4 — Politique de dépréciation V4 formelle (docs/spec/DEPRECATION_POLICY_V4.md).

🤖 Generated with Claude Code