betagouv/data-inclusion-schema

Schéma de l'offre d'insertion

Ce dépôt contient le schéma de l'offre d'insertion. Il est issu de la collaboration d'acteurs de l'insertion.

Contexte

La démarche a été initiée par l'équipe Dora, portée le GIP Plateforme de l'inclusion.

Il a été constaté l'existence d'une multitude de portails en ligne ou simulateurs, mais pas de langage commun pour décrire l’offre d’insertion et peu de partage des informations. La diffusion des aides et des dispositifs en est diminuée. Des informations sur les aides ou dispositifs deviennent obsolètes. Les efforts de saisie et de développement sont multipliés.

Ce schéma a été créé avec la collaboration des acteurs de l'insertion afin d'harmoniser les données et de permettre l'intéropérabilité entre les différents acteurs et leurs outils.

Le schéma

Le schéma définit les structures de l'insertion et devraient à terme inclure les services proposés par ces structures. Il comprend les informations essentielles permettant de décrire l'offre d'insertion et la réutilisation par les acteurs de l'insertion.

Le schéma est pour le moment formalisé dans le format JSON schema. Nous veillions néanmoins à maintenir la possibilité de représenter les données au format csv.

La documentation détaillée du schéma est disponible ici.

Consolidation

data.inclusion réalise une consolidation et publie la base consolidée, aux formats json et csv, sur data.gouv.fr.

Aide à la saisie

Les structures qui partagent leurs données via l'outil Dora sont incluses par défaut dans la base consolidée.

Contribuer

Nous organisons des ateliers régulièrement pour définir et améliorer le schéma de données. Vous pouvez librement participer aux prochains ateliers en vous inscrivant ici.

Vous pouvez également créer un nouveau ticket sur le dépôt ouvert du schéma pour proposer une modification ou une amélioration ou poser une question.

data-inclusion-schema's Issues

Support des "antennes"

Les structures ont un champ booléen antenne. Mais qu'est-ce qu'une antenne ?

• antenne géographique : un guichet de CAF : horaires, adresse

  • même offre de service
  • mêmes personnes, contacts
  • lieux différents
  • partage l'offre de service et les personnes avec d'autres antennes sur d'autres lieux qui ensemble forment une structure

• départements dans une même organisation qui ont des activités différentes : e.g. même établissement (SIRET), mais besoin de distinguer

  • lieu identique (en général)
  • personnes différentes
  • offre de service différente

• Emmaüs a un seul SIRET dans un département

  • personnes contacts différentes
  • lieux différents
  • offre de service différente

Structure :

• mêmes personnes
• lieux différents
• même offre de service

Convertir les deux JSON schema en deux Table Schema ?

Le format CSV est :

• plus simple à consommer
• mieux géré par schemas.data.gouv.fr
• plus simple à intégrer à Grist

cc @vmttn

Définir un titre pour chaque champ du schéma

Le JSON Schema est généré via pydantic à partir des modèles python. Par défaut, pydantic crée automatiquement un titre (title) à partir du nom du champ sur le modèle. Le titre généré n'est pas très adapté à notre cas d'usage (absence d'accent, d'apostrophe, etc.).

Il est possible d'override cette valeur par champ en utilisant pydantic.Field(title="...").

Rendre optionnel le champs `code_insee`

Constat

Le code_insee est une donnée essentielle pour renseigner les structures et les lieux, plus fiable que le code postal (plusieurs communes par code postal, plusieurs codes postaux pour une même commune). Sa présence facilite l'analyse statistique et la représentation cartographique de la donnée. Renseigner le code insee lors de la saisie garantie la cohérence et la qualité de l'information.

Compte tenu:

1. difficulté, signalée par nos partenaires de la mediation numérique (et d'autres), à d'adapter leur saisie afin de récupérer le code_insee
2. possibilité d'automatiser l'enrichissement de cette information par géocodage de masse
3. nécessité, pour les partenaires manitenant des bases importantes, de recourir à ce géocodage de masse

Proposition

Rendre le champ code_insee optionnel, en insistant sur l'importance de le renseigner à la saisie. La plateforme data.inclusion pourra enrichir, par géocodage, les données dont le code insee n'est pas renseigné, en prenant en compte néanmoins l'absence de code insee issue de la saisie dans ses indicateurs de qualité de données.

Ressources

• https://guides.etalab.gouv.fr/apis-geo/1-api-adresse.html#qu-est-ce-que-le-geocodage

Support des array de strings contrôlées dans TableSchema

Avec @vmttn nous avions une question concernant la possibilité dans TableSchema de contrôler les valeurs (enum) dans une liste de valeurs (array). Et bien apparemment c'est possible 🎉

• frictionlessdata/framework#759
• https://git.opendatafrance.net/validata/validata-core/-/issues/18