Vocabulaire MANA, version 1

Les quelques termes que schema.org ne couvre pas, et dont l’API publique MANA a besoin. Espace de noms : https://mana.bzh/vocabulaire/v1/

Ce vocabulaire est une extension, pas un remplacement. Chaque entité publiée par MANA porte d’abord un type schema.org standard (Event, Organization, Place) ; ces termes-ci se rattachent par additionalType et par des propriétés préfixées. Une machine qui ne les connaît pas lit quand même l’essentiel — c’est tout l’intérêt de ne rien inventer dans l’espace de schema.org lui-même.

Types

MissionRelayee: Une mission de bénévolat ou de volontariat qui n’appartient pas à MANA : elle vient du réseau public API Engagement. Sa propriété url pointe la source, et la candidature s’y fait. Étend Event.
AssociationDeclaree: Une association déclarée en préfecture, telle que le Répertoire National des Associations la connaît. Toujours identifiée par son numéro RNA. Située à sa commune, jamais à son adresse déclarée — celle-ci est le plus souvent le domicile privé de son président. Étend Organization.
Commune: Une commune française, identifiée par son code INSEE. C’est la granularité géographique maximale de tout ce que MANA publie. Étend Place.

Propriétés

Terme	Portée	Sens
`natureEngagement`	MissionRelayee	Bénévolat, ou forme de volontariat (service civique, sapeur-pompier volontaire, réserve opérationnelle…).
`domaine`	MissionRelayee	Domaine d’action : santé, environnement, sport, éducation, culture-loisirs, solidarité-insertion…
`ouvertAuxMineurs`	MissionRelayee	La mission accepte les moins de 18 ans.
`accessibleMobiliteReduite`	MissionRelayee	La mission est praticable en mobilité réduite.
`activites`	MissionRelayee	Les gestes concrets attendus, tels que l’organisateur les décrit.
`departement`	AssociationDeclaree	Code du département de la commune de déclaration.
`relayeDepuis`	MissionRelayee	L’organisation qui publie réellement la mission (JeVeuxAider, Service Civique…). La candidature se fait chez elle.
`indexePar`	toutes	Qui a indexé cet enregistrement — MANA. À ne pas confondre avec qui l’a produit.
`source`	AssociationDeclaree	Le jeu de données d’origine, ici le Répertoire National des Associations sur data.gouv.fr.
`pageSuivante`	ItemList	L’adresse complète de la page suivante, ou absente s’il n’y en a pas.
`licence`	ItemList	La licence des données de la collection.
`contratVersion`	toutes	Version du contrat de données qui a produit la réponse.
`dateDeRetrait`	réponse 410	Le jour où la ressource a cessé d’être proposée.

Pourquoi ces termes ne sont pas des termes schema.org

Le vocabulaire de schema.org a été contrôlé terme à terme le 26 août 2026, en téléchargeant schemaorg-current-https.jsonld (1 003 types, 1 676 propriétés). Trois constats en découlent, et ils expliquent la forme de cette page :

isBasedOn, provider, sdPublisher et sdLicense existent, mais leur domainIncludes est CreativeWork. Un Event et une Organization n’en sont pas. Les employer là n’aurait pas déclenché d’erreur de validation — cela aurait simplement dit quelque chose que le vocabulaire ne dit pas. D’où relayeDepuis et indexePar ici, et sameAs (domainIncludes: Thing) pour l’adresse à la source.
query-input n’existe pas dans schema.org : c’est une convention de Google pour la boîte de recherche des liens de site. Elle n’apparaît donc nulle part dans ce que MANA publie.
Tout le reste — Event, Organization, Place, PostalAddress, ItemList, duration, eventAttendanceMode, maximumAttendeeCapacity… — a été vérifié comme existant et employé dans son domaine.

Ce qui n’existe pas ici, et n’existera pas

Aucun terme ne décrit une personne. MANA ne publie ni profil, ni contact, ni coordonnée de domicile, ni compteur de contribution — pas de solde, pas de score, pas de classement. Ce n’est pas un manque à combler dans une version future : c’est la forme du contrat.

Versions

Ajouter un terme est un changement mineur : la version 1 reste la version 1, et rien ne casse. Retirer un terme ou changer son sens est un changement majeur : il ouvre une /vocabulaire/v2/, et la v1 reste servie au moins six mois en parallèle.