Comment contribuer à la plateforme Unlock My Data

Ajouter ou mettre à jour une fiche

Ce guide explique comment ajouter une nouvelle fiche, ou mettre à jour une fiche existante, en utilisant l'interface Web de GitHub et la branche update-contributing(si vous êtes bénévole de l'association et que nous vous avons ajouté à l'équipe). Sinon, il faut passer par le système de fork/pull request.

📺Tutoriel vidéo explicatif

Accompagnement étape par étape - version texte ci-dessous :

🎥 Voir le tutoriel sur YouTube

1. Comprendre le fichier fiche d'entreprise

Structure des champs JSON

Voici la liste complète des champs disponibles dans les fichiers de fiche entreprise :

name

Nom de l'entreprise.

logo

URL du logo de l'entreprise.

nationality

Nationalité de l'entreprise (ex. : Américaine).

country_name

Pays où se trouve le siège de l'entreprise.

country_code

Code pays ISO (ex. : us).

belongs_to_group

Booléen : l'entreprise appartient-elle à un groupe ? (true ou false)

group_name

Nom du groupe parent, si applicable.

permissions
Permissions d'accès aux données demandées ou accordées.
NE PAS METTRE À JOUR MANUELLEMENT / SCRIPT D'AUTOMATISATION EXISTANT
contact_mail_export

Adresse email pour les demandes d'export de données.

easy_access_data

Infos concernant un accès facilité aux données, si existant.

need_id_card

Booléen : une carte d'identité est-elle requise pour les demandes ?

details_required_documents

Détails sur les documents nécessaires pour l'accès aux données.

data_access_via_postal

Booléen : l'accès aux données est-il possible par courrier postal ?

data_access_via_form

Booléen : l'accès aux données est-il possible via un formulaire en ligne ?

data_access_type

Détails sur le type d'accès aux données (si non couvert ci-dessus).

data_access_via_email

Booléen : l'accès aux données est-il possible par email ?

response_format

Format de la réponse (fichier, zip, PDF, etc.).

url_export

URL pour demander l'export de vos données.

example_data_export

Tableau d'objets (voir par exemple carrefour.json) liste d'éléments contenant url, type, description et date.

example_form_export

Tableau d'objets (voir par exemple carrefour.json) liste d'éléments contenant url, type, description et date.

message_exchange

Tableau d'objets (voir par exemple carrefour.json) liste d'éléments contenant url, type, description et date.

address_export

Adresse physique pour demander vos données.

response_delay

Délai de réponse habituel (ex. : Instantané).

sanctioned_by_cnil

Booléen : l'entreprise a-t-elle été sanctionnée par la CNIL ?

sanction_details

Détails et références aux sanctions de la CNIL.

data_transfer_policy

Booléen : l'entreprise a-t-elle une politique de transfert de données ?

privacy_policy_quote

Citation pertinente de la politique de confidentialité.

transfer_destination_countries

Liste des pays vers lesquels les données peuvent être transférées.

outside_eu_storage

Les données personnelles sont-elles stockées hors UE ?

comments

Commentaires supplémentaires.

tosdr

URL local pour accéder aux données de tosdr.

exodus

URL local pour accéder aux données d'exodus.

created_at

Date de création de la fiche.

created_by

Auteur de la fiche.

updated_at

Date de la dernière mise à jour.

updated_by

Auteur de la dernière mise à jour.

app

(Objet optionnel) Détails de l'application (principale) - sinon, il faut créer une nouvelle fiche :

{ "name": "...", "link": "..." }

2. Modifier une fiche existante

1. Rendez-vous sur le dépôt sur GitHub

Ouvrez le dépôt puis sélectionnez la branche update-contributinggrâce au sélecteur de branches.

Branches GitHub

2. Naviguez dans le dossier des fiches

Rendez-vous dans public/data/manual/.

3. Trouvez et sélectionnez le fichier

Cliquez sur le fichier JSON à modifier (par exemple, amazon.json).

4. Modifiez le fichier

Cliquez sur l'icône crayon (✏️) ("Modifier ce fichier").

Modifier le fichier

Appliquez vos modifications en suivant les explications du tableau ci-dessus concernant les champs.

5. Vérifiez les modifications

Cliquez sur le bouton "Preview changes" pour consulter un aperçu de vos modifications.

Preview des modifications

6. Enregistrez les modifications (commit)

  • Appuyez sur le bouton "Commit changes".
  • Ajoutez un message de commit bref et descriptif (ex. : "Mise à jour de l'email de contact Amazon").
  • Vérifiez que "Valider directement sur la branche update-contributing" est sélectionné.
  • Cliquez sur "Commit changes".
Sauvegarder le fichier

3. Ajouter une nouvelle fiche entreprise

1. Rendez-vous dans le dossier public/data/manual/

A retrouver sur la branche update-contributing.

2. Créez un nouveau fichier

  • Cliquez sur le bouton "Add file" › "Create new file".
  • Nommez votre fichier [nomentreprise].json (tout en minuscules, ex. : newcompany.json).

3. Utilisez le modèle de fiche

Copiez-collez ce modèle dans votre nouveau fichier et remplissez les champs :

{
  "name": "",
  "logo": "",
  "nationality": "",
  "country_name": "",
  "country_code": "",
  "belongs_to_group": false,
  "group_name": "",
  "permissions": "",
  "contact_mail_export": "",
  "easy_access_data": "",
  "need_id_card": false,
  "details_required_documents": "",
  "data_access_via_postal": false,
  "data_access_via_form": false,
  "data_access_type": "",
  "data_access_via_email": false,
  "response_format": "",
  "example_data_export": [],
  "example_form_export": [],
  "message_exchange": [],
  "address_export": "",
  "response_delay": "",
  "sanctioned_by_cnil": false,
  "sanction_details": "",
  "data_transfer_policy": false,
  "privacy_policy_quote": "",
  "transfer_destination_countries": "",
  "outside_eu_storage": "",
  "comments": "",
  "tosdr": "",
  "exodus": "",
  "created_at": "",
  "created_by": "",
  "updated_at": "",
  "updated_by": "",
  "app": {
    "name": "",
    "link": ""
  }
}

Remplissez chaque champ aussi complètement que possible.

4. Validez le nouveau fichier (commit)

Comme précédemment, ajoutez un message de commit descriptif et validez directement sur la brancheupdate-contributing.

5. Mettez à jour le fichier slugs.json

  • Rendez-vous dans public/data/manual/slugs.json.
  • Ajoutez le slug (nom du fichier sans .json) de votre nouvelle entreprise à la liste ou à l'objet, selon le format.
  • Validez votre modification.

4. Étapes finales

  • Une fois vos modifications effectuées, vous pouvez créer une Pull Request de la branche update-contributing vers la branche principale (main).
  • Rédigez un résumé indiquant ce que vous avez mis à jour ou ajouté, pour faciliter la revue.

🙏 Merci pour votre contribution !

Votre aide est précieuse pour aider la communauté à reprendre le contrôle de ses données personnelles. Chaque fiche ajoutée ou mise à jour contribue à un Internet plus transparent et respectueux de la vie privée.