Skip to content

Schéma : description du modèle de donnée (v1)

Jump to bottom
Raphael Odini edited this page Nov 25, 2020 · 1 revision

But de ce document

Présenter une première version du modèle de donnée générique : les champs clés ainsi que leur format.

  • Le nom des colonnes des fichier csv est flexible, il suffira ensuite de mapper le nom de la colonne avec le nom du champ générique ✅ le nom des colonnes passera surement en français pour plus de lisibilité
  • Des ajustement sont bien sûr possible après concertation lors des ateliers

Table des matières

Liste des champs clés

A fournir dans les fichiers csv

Liste des champs secondaires

A fournir optionnellement dans les fichiers csv

Détails des champs clés

nom du lieu

Nom actuel du champ Type de valeur Exemples de valeur
nom chaine de caractère libre - Médiathèque d'Oullins

type de lieu

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
type_lieu chaine de caractère, avec mapping - EPN
- msap
- Médiathèque 		UNE SEULE valeur possible
- Centre social
- Organisme de sécurité sociale (CAF, CPAM, CARSAT, MSA...)
- Tiers-lieu & coworking, FabLab
- Association
- Maison de quartier
- Point Information Médiation Multi Services (PIMMS)
- Maison de Service au Public (MSAP)
- Bibliothèque / Médiathèque
- Organisme de formations
- Pôle Emploi
- Commune (Ville, CCAS, Centre Culturel...)
- Intercommunalité (EPCI)
- Administration / Collectivité territoriale
- Département (UTPAS, MDS, MDSI, UTAS...)
- Préfecture, Sous-Préfecture
- Autre / Inconnu

adresse du lieu

Nom actuel du champ Type de valeur Exemples de valeur
- address_raw (champ pour l'adresse brut fournie dans le CSV) chaine de caractère, dans une ou plusieurs colonnes, avec post-processing - 25 rue Paul Persil 47120 DURAS (1 colonne)
- 2, Av. de la résistance, 47550, Boé (plusieurs colonnes)

⚙️ champs post-processing (obtenus grâce à l'API Adresse) : address_housenumber, address_street, address_postcode, address_citycode, address_city, address_departement_code, address_departement_name, address_region_name, latitude, longitude

contact : téléphone

Nom actuel du champ Type de valeur Exemples de valeur
- contact_telephone chaine de caractère avec post-processing 0123456789

⚙️ champ pre-processing. Exemple :

  • 01 23 45 67 89
  • 01.23.45.67.89
  • 01-23-45-67-89
  • 0123456789

⚙️ champ post-processing : contact_phone. chaine de caractères sans espaces. Exemple :

  • 0123456789

ℹ️ Il y a aussi un champ contact_telephone_details pour indiquer des détails en texte libre sur le téléphone (horaires, prix, ...). Exemple : (0,06 €/mn + prix appel) Un conseiller vous répond du lundi au vendredi de 9h à 16h00

contact : email

Nom actuel du champ Type de valeur Exemples de valeur
contact_email chaine de caractère au format email - [email protected]

contact : site web

Nom actuel du champ Type de valeur Exemples de valeur
contact_web chaine de caractère au format url - https://www.mairie-begles.fr/accueil-jeunesse/

horaires d'ouverture

Nom actuel du champ Type de valeur Exemples de valeur
- horaires_ouverture chaine de caractère, peut être fourni dans une ou plusieurs colonnes, avec post-processing pour le transformer au format OpenStreetMap

⚙️ champ pre-processing : une ou plusieurs colonnes. Exemples :

  • Du lundi au vendredi de 8h30 à 12h et de 14h à 17h30 (une colonne)
  • 9h - 18h, 14h00 à 18h30, 9h - 18h, fermé (plusieurs colonnes : Lundi, Mardi, ...)
  • Mo-Fr 09:00-19:00 (une colonne, directement au bon format)

⚙️ champ post-processing : horaires_ouverture (format de l'horaire au format OpenStreetMap, qui permet de générer facilement les horaires de la semaine, savoir si le lieu est ouvert maintenant, etc...). Exemples :

  • Mo-Fr 09:00-19:00
  • Mo-Th 08:00-18:00; Fr 10:00-18:00; Sa 08:30-12:30

ℹ️ Il y a aussi un champ opening_hours_details pour indiquer des détails en texte libre sur les horaires. Exemple : sur rendez-vous le Mardi

tarifs

Option 1

Si le lieu n'est pas 100% gratuit, l'indiquer dans le csv dans une colonne spécifique, avec les détails (texte libre).

Nom actuel du champ Type de valeur Exemples de valeur
gratuit vrai ou faux généré automatiquement
Option 1 :
- vrai si la colonne n'existe pas, est vide ou est égale à 'Gratuit'
- faux si la colonne n'est pas vide
Option 2 :
- vrai si la colonne est égale à Gratuit
- faux sinon
tarifs_details (si gratuit est faux) chaine de caractère libre - Gratuit pour les adhérents

Option 2

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
- tarifs chaine de caractère, multi-valeur, avec mapping - `` PLUSIEURS valeurs possibles
- Gratuit
- Adhérent
- Payant
- (autres ? 📝 à définir)

exemple ? voir Hinaura

services proposés

📝 à définir

Exemple de services :

Accès à un équipement informatique
Accompagnement aux démarches administratives en ligne
Acquisition de compétences numériques
Évaluation de compétences numériques
Pratiquer des activités récréatives numériques
Vente de matériel informatique
Stockage numérique sécurisé

Exemple d'équipements à disposition :

Ordinateur (fixe ou portable)
Réseau Wifi
Imprimante
Borne CAF
Scanner
Tablette
...

labels

📝 à définir

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
- labels chaine de caractère, multi-valeur, avec mapping - APTIC, Aidants Connect, Label départemental PLUSIEURS valeurs possibles
- France Services
- Aidants Connect
- APTIC
- Fabriques de Territoire
- (autres ? 📝 à définir)

ℹ️ Certaines valeurs, comme Tiers-lieux ou EPN, sont à mettre dans la colonne type

Détails des champs secondaires

description du lieu

Nom actuel du champ Type de valeur Exemples de valeur
description chaine de caractère libre - Une courte ou longue description du lieu

public cible

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
- public_cible chaine de caractère, multi-valeur, avec mapping - Droits des étrangers
- Personnes en situation de handicap, Personnes en recherche d'emploi 		PLUSIEURS valeurs possibles
- Tout public
- Allocataires
- Demandeurs d'emploi
- Étrangers
- Familles
- Jeunes
- Personnes en situation de handicap
- Séniors

ℹ️ Information au niveau du lieu. Le champs peut être différent à la maille service.

modalités d'accès

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
- modalites_acces chaine de caractère, multi-valeur, avec mapping - `` PLUSIEURS valeurs possibles
- Accès libre
- Sur inscription ou rendez-vous
- Public cible
- Adhérents

ℹ️ Information au niveau du lieu. Le champs peut être différent à la maille service.

modalités d'accompagnement

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
- modalites_accompagnement chaine de caractère, multi-valeur, avec mapping - `` PLUSIEURS valeurs possibles
- Individuel
- Collectif

ℹ️ Information au niveau du lieu. Le champs peut être différent à la maille service.

accessibilité

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
- accessibilite chaine de caractère, multi-valeur, avec mapping - `` PLUSIEURS valeurs possibles
- (📝 à définir)

siret

Nom actuel du champ Type de valeur Exemples de valeur
siret chaine de caractère libre - ``

statut

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
statut chaine de caractère, avec mapping - `` UNE SEULE valeur possible
- Public
- Privé
- Public-privé
- Autre / Inconnu

nature juridique

Nom actuel du champ Type de valeur Exemples de valeur Toutes les valeurs possibles actuellement
nature_juridique chaine de caractère, avec mapping - `` UNE SEULE valeur possible
- Association
- Collectivité locale ou territoriale
- Coopérative d'Activités et d'Entrepreneur·es (CAE)
- Établissement public de coopération intercommunale (EPCI)
- Établissement public à caractère industriel et commercial (EPIC)
- Établissement public à caractère scientifique, culturel et professionnel (EPSCP)
- Groupement d'intérêt public (GIP)
- Société par actions simplifiée (SAS)
- Société à responsabilité limitée (SARL)
- Société par actions simplifiée unipersonnelle (SASU)
- société coopérative d’intérêt collectif (SCIC)
- Société coopérative et participative (SCOP)
- Société publique locale (SPL)
- Autre / Inconnu

itinérant

Option 1

Si le lieu est itinérant, l'indiquer dans le csv dans une colonne spécifique, avec les détails (texte libre).

Nom actuel du champ Type de valeur Exemples de valeur
itinerant vrai ou faux généré automatiquement
- vrai si la colonne n'est pas vide
- faux si la colonne n'existe pas ou est vide
itinerant_details (si itinerant est vrai) chaine de caractère - ``

Option 2

Si le lieu est itinérant, indiquer oui ou les détails (texte libre).

|Nom actuel du champ|Type de valeur|Exemples de valeur| |-|-|-|-| |- itinerant|chaine de caractère|- ``
- oui
- `tous les Mardi dans un rayon de 15km`|

contact : page facebook

Nom actuel du champ Type de valeur Exemples de valeur
contact_facebook chaine de caractère au format url - https://www.facebook.com/lacali.jeunesse

ℹ️ Il y a aussi contact_twitter_url et contact_youtube_url. Vous avez un autre lien à rajouter ? dites-le nous !

nom de la structure porteuse

Nom actuel du champ Type de valeur Exemples de valeur
structure_porteuse chaine de caractère - ``

date de dernière mise à jour du lieu

Nom actuel du champ Type de valeur Exemples de valeur
last_updated date - 2020-08-30

Questions / réponses

chaine de caractère multi-valeur ?

Le champ peut contenir plusieurs valeur, séparés par une virgule ,

chaine de caractère avec mapping ?

Le champ doit rentrer dans une liste prédéfinie.

Il est possible de ne pas avoir exactement le même nom, pour cela un fichier de mapping sera disponible pour rattacher le nom à une des valeur de la liste.

Exemples :

  • type de lieu : Espace de coworking dans le csv --> mapping --> Tiers-lieu & coworking, FabLab dans la carto nationale

chaine de caractère dans une ou plusieurs colonnes ?

Exemples :

  • adresse du lieu dans une colonne : adresse du lieu dans le csv
  • adresse du lieu dans plusieurs colonnes : Adresse postale, Code postal et Ville dans le csv

chaine de caractère avec post-processing ?

Le champ va être ensuite processé par l'application, en utilisant un script ou une API externe, afin de récupérer d'avantage d'informations.

Exemples :

  • adresse du lieu :

Comment se passe l'import ?

  1. CSV du fournisseur de donnée
  2. Fichier de configuration pour mapper les colonnes du CSV avec les noms des champs définis dans la carto nationale
  3. Import

Questions en suspens

Si un lieu offre plusieurs services, comment avoir des public cibles/conditions d'accès/tarifs spécifiques au service ?

Exemple complet

  1. Fichier csv
Nom de la structure Typologie Adresse complète Téléphone horaires téléphone Courriel Site web Horaires d'ouverture de la structure Publics spécifiques Accès aux services Type d'accompagnement
Bibliothèque municipale de Castelculier bibliothèque 5 Avenue de la République 38000 Grenoble 0102030405 Seulement l'après-midi [email protected] https://societenumerique.gouv.fr/ du lundi au vendredi de 10h à 18h Tout public, Allocataires CAF inscriptions obligatoires Individuel, Collectif
  1. Fichier de mapping
champ du csv champ du modèle de donnée générique
Nom de la structure name
Typologie type
Adresse complète address_raw --> address fields
Téléphone contact_phone_raw --> contact_phone
horaires téléphone contact_phone_details
Courriel contact_email
Site web contact_website
Horaires d'ouverture de la structure opening_hours_raw --> opening_hours_osm_format
Publics spécifiques target_audience_raw --> target_audience
Accès aux services support_access
Type d'accompagnement support_mode

Aller plus loin

Voir aidants_connect_carto/apps/core/documentation/README.md

Clone this wiki locally