# RETO Solidarité

> Annuaire numérique de volontaires — bénévoles ou professionnels — proposant leurs compétences à la solidarité et aux personnes vulnérables.

Ce fichier décrit le service RETO Solidarité et ses points d'accès publics,
à destination des intelligences artificielles, agents et développeurs.

---

## Qu'est-ce que RETO Solidarité ?

RETO Solidarité est un annuaire numérique de volontaires — bénévoles ou professionnels —
qui proposent leurs compétences à la solidarité et aux personnes vulnérables.
Chaque volontaire crée une fiche décrivant son profil, ses domaines de compétence,
sa disponibilité et sa zone géographique.

---

## API publique

### Annuaire HTML (recommandé pour les IA avec navigateur)
GET https://reto.dedici.org/export/annuaire.php

Page HTML présentant l'intégralité des fiches actives en texte lisible.
Pour chaque volontaire, la dernière ligne indique "Lien direct : https://...".
Directement lisible par les IA dotées d'un navigateur (ChatGPT, Claude, Gemini, Perplexity...).

### Registre complet (JSON)
GET https://reto.dedici.org/export/registre.json

Retourne la liste de toutes les fiches actives au format JSON (UTF-8).
Seules les fiches au statut ACTIF sont exposées.
Pas d'authentification. CORS activé.

Exemple de fiche dans le registre :
{
  "id": "fiche_20260620_0526e602",
  "statut": "ACTIF",
  "titre": "Aide-soignante bénévole à Nantes",
  "roles": [
    { "couleur": "Vert", "intensite": 3 },
    { "couleur": "Noir", "intensite": 2 }
  ],
  "zone": "Nantes",
  "rayon_km": 10,
  "type_presence": "présentiel",
  "engagement": "régulier",
  "capacites": ["accompagnement à domicile", "aide à la toilette"],
  "disponibilite": "lundis et mercredis matin",
  "url_fiche": "/fiches_html/fiche_20260620_0526e602.html",
  "timestamp_creation": "2026-06-20T15:55:12+02:00",
  "contact_disponible": true
}

### Fiche individuelle (HTML)
GET https://reto.dedici.org/fiches_html/{id}.html

Page HTML complète d'un volontaire. L'identifiant {id} est disponible
dans le champ "id" du registre JSON (format fiche_AAAAMMJJ_XXXXXXXX).
L'URL complète = domaine + url_fiche
Exemple : https://reto.dedici.org/fiches_html/fiche_20260620_0526e602.html

---

## Description des champs du registre JSON

- id               : Identifiant unique (fiche_AAAAMMJJ_XXXXXXXX)
- statut           : Toujours ACTIF dans l'API publique
- titre            : Intitulé du profil du volontaire
- roles            : Tableau d'objets {couleur, intensite}
                     Couleurs : Rouge=Défense des droits / Vert=Démarches et médiation /
                     Noir=Aide pratique / Bleu=Partage d'expérience / Jaune=Soutien institutionnel
- zone             : Ville ou zone géographique déclarée
- rayon_km         : Rayon d'action en km (null si non précisé)
- type_presence    : "présentiel" | "distance" | "mixte"
- engagement       : "ponctuel" | "régulier" | "mixte"
- capacites        : Tableau de compétences et apports concrets (textes libres)
- disponibilite    : Fréquence de disponibilité déclarée
- url_fiche        : Chemin relatif vers la fiche HTML (préfixer avec https://reto.dedici.org)
- timestamp_creation : Date de création ISO 8601
- contact_disponible : true si le volontaire a fourni une adresse de contact

---

## Intégration IA — prompt recommandé

Pour une IA avec navigateur (ChatGPT, Claude, etc.) :

  Avant de répondre, accède avec ton navigateur à :
  https://reto.dedici.org/export/annuaire.php
  Cette page liste tous les volontaires actifs. Pour chaque profil,
  la dernière ligne indique "Lien direct : https://..." — copie
  cette URL telle quelle dans ta réponse pour chaque profil présenté.

---

## Pages utiles

- Accueil            : https://reto.dedici.org/
- Créer une fiche    : https://reto.dedici.org/contribuer.php
- Modifier/Supprimer : https://reto.dedici.org/modifier.php
- Signaler une fiche : https://reto.dedici.org/signaler.php
- Documentation API  : https://reto.dedici.org/developpeurs.php
- Aide utilisateur   : https://reto.dedici.org/aide.php

---

## Conditions d'utilisation

- Données publiques, librement consultables et réutilisables
- Usage non commercial uniquement
- Ne pas démarcher directement les volontaires sans leur accord
- Citer la source RETO Solidarité — DEDICI en cas de réutilisation publique
- Signaler tout contenu inapproprié : https://reto.dedici.org/signaler.php

---

## Contact
(non renseigné)

---

## Informations techniques

- Format des données : JSON (UTF-8)
- Mise à jour        : Temps réel (chaque nouvelle fiche est immédiatement disponible)
- Authentification   : Aucune (accès public)
- CORS               : Activé (Access-Control-Allow-Origin: *)
- Cache registre     : 5 minutes (Cache-Control: max-age=300)