Schéma des structures d'insertion

GitHub - betagouv/data-inclusion-schema
GitHub
Le schéma est versionné dans ce dépôt
Exemple d'une donnée de structure dans le schéma
1
[
2
    {
3
        "id": "c3d15659-8de9-4fd6-b283-04d50f6ace57",
4
        "siret": "60487647500499",
5
        "rna": "W123456789",
6
        "nom": "MOBILETTE",
7
        "commune": "Robinboeuf CEDEX",
8
        "code_postal": "09891",
9
        "code_insee": "09890",
10
        "adresse": "RUE DE LECLERCQ",
11
        "date_maj": "2022-04-28T16:53:11Z",
12
        "complement_adresse": "HOTEL DE VILLE",
13
        "longitude": 7.848133,
14
        "latitude": 48.7703,
15
        "typologie": "ASSO",
16
        "telephone": "0102030405",
17
        "courriel": "[email protected]",
18
        "site_web": "https://www.asso-gonzalez.net/",
19
        "presentation_resume": "L’association Mobilette propose des solutions de déplacement aux personnes pour qui la non mobilité est un frein à l’insertion professionnelle : - connaissance de l'offre de transport du territoire - accès à un véhicule 2 ou 4 roues - transport solidaire - accès au permis",
20
        "presentation_detail": "",
21
        "source": "solidagregateur",
22
        "structure_parente": "7713e292-abd1-42fc-b1f0-071b7e7a2f61",
23
        "lien_source": "https://solidagregateur.fr/structures/c3d15659-8de9-4fd6-b283-04d50f6ace57",
24
        "horaires_ouverture": "Mo-Fr 10:00-20:00 \"sur rendez-vous\"; PH off"
25
    }
26
]
Copied!
Format de fichier
encodage : utf-8
Champs présents
id
obligatoire : oui
type : chaîne de caractères
description : Ce champs renseigne un identifiant pour la structure dans le jeu de donnée considéré. La valeur de ce champs est relative à l'endroit où la donnée est stockée (sa valeur peut être différente d'une base à l'autre).
exemples : 
dans une base A où les structures sont identifiées par un slug, l'identifiant de la structure S pourrait être structure-s-paris-1
dans une base B où les structures sont identifiées par un uuid, l'identifiant de la structure S (qui est la même structure que dans la base A) pourrait être c96d4cd8-afa6-4f66-ad2a-f76a60173b38
siret
obligatoire : non
type : chaîne de caractères respectant le motif ^\d{14}$
description : Ce champs contient le code SIRET de la structure, issu de la base SIRENE des entreprises et récupérable via annuaire-entreprises.data.gouv.fr.
Le siret est essentiel pour permettre de concilier les données provenant de bases de données différentes. Sans données pivots (siret ou rna), impossible de regrouper les données documentant les mêmes structures et de rechercher, pour une structure donnée, toutes les données disponibles dans data.inclusion.
rna
obigatoire : non
type : chaîne de caractères respectant le motif ^W\d{9}$
description : Ce champs contient le numéro RNA (Répertoire National des Associations cf) de la structure.
nom
obligatoire : oui
type : chaîne de caractères
description : Ce champs contient le nom de la structure.
commune
obligatoire : oui
type : chaîne de caractères
description : Ce champs contient le nom de la commune rattachée à l'adresse de la structure.
code_postal
obligatoire : oui
type : chaine de caractères respectant le motif ^\d{5}$
description : Ce champs contient le code postale rattaché à l'adresse de la structure.
code_insee
obligatoire : oui
type : chaîne de caractères respectant le motif ^\d[A-B0-9_]\d{3}$
description : Ce champs contient le code officiel géographique de la commune rattachée à l'adresse de la structure.
adresse
obligatoire : oui
type : chaîne de caractères
description : Ce champs contient les éléments de l'adresse de la structure relatifs à la voie. Typiquement, <numero_voie> <indice_de_repetition> <type_voie> <libelle_voie>.
exemple : 12 BIS RUE DE LECLERCQ
complement_adresse
obligatoire : non
type : chaîne de caractères
description : Ce champs contient des éléments permettant de préciser l'adresse et la situation exactes de la structure, afin d'en permettre l'accès aux usagers. Cela peut être un numéro d'appartement, un étage, un lieu-dit, etc.
longitude
obligatoire : non
type : nombre décimal (float)
description : Ce champs contient la longitude de la structure, dans le système WGS84 (GPS), typiquement issue du géocodage de son adresse et pouvant servir à la localiser.
latitude
obligatoire : non
type : nombre décimal (float)
description : Ce champs contient la latitude de la structure, dans le système WGS84 (GPS), typiquement issue du géocodage de son adresse et pouvant servir à la localiser.
typologie
obligatoire : non
type : chaîne de caractères
description : La valeur de ce champs indique le type de la structure : CCAS, ASSO, COMMUNE, etc. . Les valeurs possibles sont restreintes au vocabulaire décrivant les types de structures :
Les valeurs
Typologies de structure
telephone
obligatoire : non
type : chaîne de caractères
description : Ce champs contient un numéro de téléphone de la structure consacré à rentrer en contact avec elle.
Le format n'est pas encore spécifié.
courriel
obligatoire : non
type : chaîne de caractères
description : Ce champs contient une adresse email de la structure consacrée à rentrer en contact avec elle.
site_web
obligatoire : non
type : chaîne de caractères
description : Ce champs contient une URL vers le site internet de la structure.
presentation_resume
obligatoire : non
type : chaîne de caractères limitée à 280 caractères
description : Ce champs contient une courte description de la structure.
presentation_detail
obligatoire : non
type : chaîne de caractères
description : Ce champs contient une courte description de la structure, pouvant également servir à préciser son lieu ou son activité.
source
obligatoire : non
type : chaîne de caractères
description : La valeur de ce champs détaille l'acteur à l'origine de la donnée considérée.
structure_parente
obligatoire : non
type : chaîne de caractères
description : Ce champs est utilisé pour une antenne et contient l'identifiant de la structure parente, dans la base de la source. 
exemple : 
la source=toto a dans sa base de données : 
une première structure (identifiée structure-mère-foo)
une antenne associée à cette première structure (identifiée structure-antenne-bar )
la représentation attendue pour ces 2 structures est la suivante:
1
[
2
    {
3
        "id": "structure-mère-foo",
4
        "source": "toto",
5
        ...
6
    },
7
    {
8
        "id": "structure-antenne-bar",
9
        "source": "toto",
10
        "structure_parente": "structure-mère-foo",
11
        ...
12
    }
13
]        "structure_parente": 
Copied!
date_maj
obligatoire : oui
type : chaîne de caractères, au format ISO 8601.
description : Ce champs contient la date, et optionellement l'heure, à laquelle la donnée considérée a été mise à jour.
exemple:
2022-04-28 : sans l'heure
2022-04-28T16:53:11Z : avec l'heure
lien_source
obligatoire : non
type : chaîne de caractères
description : Ce champs contient une URL vers le site de la source. Il s'agit d'un lien vers la structure pouvant être utilisé afin de rediriger un utilisateur vers la source.
horaires_ouverture
obligatoire : non
type : chaîne de caractères
description : Ce champs contient les horaires d'ouverture. Le format recommandé (mais non obligatoire) est le format OSM opening_hours (OSM : OpenStreetMap).
Outil d'aide à la saisie : https://projets.pavie.info/yohours/​