Skip to content

Instantly share code, notes, and snippets.

@sabman
Last active July 20, 2026 11:34
Show Gist options
  • Select an option

  • Save sabman/e7a876f62c088875455fc2e81b431b20 to your computer and use it in GitHub Desktop.

Select an option

Save sabman/e7a876f62c088875455fc2e81b431b20 to your computer and use it in GitHub Desktop.
Senegal workshop agenda - Mon 20 Jul 2026 (simple run of show)

Atelier Sénégal - ordre du jour simple (lun. 20 juil.)

Horaire : 14:00-16:30 Dakar
OpenTalk : https://meet.opentalk.eu/room/60fb1399-1fb0-49dd-8af5-45b19acaa730?invite=dda1a71a-762c-4df7-93b3-6d1b170a1886
Questionnaire : https://kyc20-data-lineage-production.up.railway.app/


Ordre du jour

Durée Bloc Message clé
10 min Présentations Savoir qui est dans la salle ; consentement enregistrement ; une attente pour aujourd'hui
5 min Cadrage — toutes les villes, toutes les années Cela aide tout le monde, partout, dans la durée - pas seulement Ziguinchor aujourd'hui
5 min Démo Kblock Les données cartographiques existantes peuvent soutenir de vraies décisions, combinées aux données de la fédération
25 min Questionnaire en ligne Documenter ce que vous avez et ce que vous prévoyez - on demande, on n'impose pas
5 min Pause (après le questionnaire) Faire le lien entre ce que vous avez entendu et la suite
15 min Cas d'usage au tableau Nommer de vrais problèmes du terrain - pas des fonctionnalités ou de la technologie
15 min Relier questionnaire et cas d'usage Chaque cas d'usage prioritaire a besoin de données derrière - ou d'un manque assumé
10 min Pause (avant les personas) Reprendre son souffle avant le travail d'empathie
15 min Personas Une bonne persona est quelqu'un qu'on peut se représenter : nom, métier, objectif, frustration, besoin en données
30 min User stories par persona Une histoire concrète par rôle, liée aux données du questionnaire
ClĂ´ture Conclusion Relire ce qu'on a convenu - pas de nouveaux sujets

10 min - Présentations

Message clé : Tout le monde sait qui est dans la salle et pourquoi on est là avant d'ouvrir le questionnaire.

Avant de parler : lancer l'enregistrement (voir checklist). Coller les liens OpenTalk et questionnaire dans le chat.

Dire une fois (enregistrement) : on enregistre pour partager les notes avec celles et ceux qui n'ont pas pu venir. Si quelqu'un s'y oppose, le dire maintenant.

Facilitateurs (30 secondes chacun) : prénom, rôle, organisation.

Tour de table (~30-45 secondes par personne) :

  • PrĂ©nom et rĂ´le
  • Organisation ou Ă©quipe (UrbaSEN, fĂ©dĂ©ration, SDI, etc.)
  • Une phrase : qu'est-ce qui rendrait la session utile pour vous aujourd'hui ?

Restez léger — pas de long discours. Noter noms et rôles pour le bloc personas plus tard.

Une phrase sur la session : aujourd'hui on documente les données de Ziguinchor dans le questionnaire et on clarifie qui utilisera la plateforme et pour quoi. Pas besoin de jargon technique.

« Bonjour à toutes et à tous. On enregistre la session — si quelqu'un a une objection, dites-le maintenant.
Chacun·e se présente : prénom, rôle, organisation, et en une phrase ce qui vous aiderait aujourd'hui. »


5 min - Cadrage (toutes les villes, toutes les années)

Message clé : La valeur de ce projet concerne toutes les villes du programme et plusieurs années - incluez les données que vous avez déjà, pas seulement ce que ce projet va collecter.

Aujourd'hui on travaille sur Ziguinchor, mais la plateforme est pensée pour les sept villes du programme. Elle doit aussi accueillir des données de différentes années - une vieille carte ou un ancien relevé compte autant qu'une collecte récente. En documentant ce que vous avez et ce que vous prévoyez, vous aidez votre ville et le réseau. Le questionnaire ne concerne pas seulement ce projet : incluez tout ce que votre fédération détient déjà depuis des années.


5 min - Démo Kblock

Message clé : Cette démo montre ce qui est possible quand les couches cartographiques servent des décisions locales - c'est une motivation, pas le produit final.

Montrer Kblock comme exemple concret d'une bonne utilisation des données de carte. OpenStreetMap est une entrée parmi d'autres ; l'idée est de transformer des couches existantes en quelque chose d'utile pour des décisions locales (par exemple voir des motifs bloc par bloc). Dire clairement que c'est une démo de motivation, pas le produit final. OpenStreetMap seul ne suffit pas - il est plus fort combiné aux données de la fédération : limites de quartier, relevés terrain, etc. Après la démo, demander : quelle couche avez-vous déjà, laquelle manque, et qui dans votre équipe s'en occupe ?


25 min - Questionnaire en ligne

Message clé : Le questionnaire est une photo partagée de vos données - on note ce qui existe, ce qui est prévu, et qui est responsable, seulement quand vous êtes prêts à le dire.

Parcourir le questionnaire lineage ensemble. Chacun se connecte, choisit le Sénégal, et remplit ce qu'il connaît - pas besoin de tout finir aujourd'hui. Pour chaque jeu de données : existe aujourd'hui ? prévu ? non applicable ? Si quelque chose manque, demander avec douceur s'ils prévoient de le collecter, à quelle échéance (même approximative), dans quel projet, et qui serait responsable - seulement s'ils sont prêts à répondre. Noter à confirmer quand ils ne sont pas sûrs. Corriger les lignes erronées ou exemples copiés-collés (par exemple sur OpenStreetMap). Les vols de drone n'étaient pas autorisés à Ziguinchor pour des raisons d'ordre public ; une cartographie au niveau de la rue a été proposée comme alternative - si confirmé, l'ajouter comme possible nouveau type de données.


5 min - Pause (après le questionnaire)

Message clé : Utiliser cette pause pour transformer les réponses du questionnaire en matière utile pour le tableau - ne pas enchaîner à froid.

Mettre la session en pause. Dire que vous revenez dans cinq minutes.

Pour vous (interne) : noter ce qui a été rempli, ce qui manque, qui est responsable de quoi, les surprises ou blocages. Ces notes serviront pour les cas d'usage et les personas - en lien avec ce que vous avez vraiment entendu.

« On fait une pause de cinq minutes. On reprend dans un instant pour la partie tableau blanc. »


15 min - Cas d'usage au tableau

Message clé : Un bon cas d'usage part d'un problème concret ce mois-ci - pas d'un souhait pour un meilleur système.

Demander quels problèmes la plateforme ville doit aider à résoudre : préparer une réunion avec la mairie, montrer les manques de services sur une carte, relier un récit à un lieu, exporter des chiffres pour un rapport. Écrire 4 à 6 cas d'usage sur des post-its. Ne pas débattre de la technologie. Retenir les 2 ou 3 les plus urgents pour la première version.


15 min - Relier le questionnaire aux cas d'usage

Message clé : Si un cas d'usage ne pointe pas vers des données que vous avez ou prévoyez de collecter, il reste un souhait - marquer le manque honnêtement.

Tracer des liens sur le tableau entre chaque cas d'usage prioritaire et les jeux de données du questionnaire qui le soutiennent. Pas de données derrière le cas d'usage : marquer le trou. Des données sans cas d'usage : noter disponible mais peu utilisé ou usage à clarifier. Chaque cas d'usage important doit pointer vers des données existantes, prévues, ou un manque assumé.


10 min - Pause (avant les personas)

Message clé : Le travail sur les personas demande de l'empathie - reprendre souffle et relire vos notes avant de décrire les utilisateurs.

Pause avant le bloc personas. Relire rapidement questionnaire et cas d'usage pour que les exemples au tableau reflètent Ziguinchor, pas un modèle générique.

« Petite pause avant la partie personas - on reprend dans dix minutes. »


15 min - Personas

Message clé : Une bonne persona est quelqu'un qu'on peut se représenter - si vous ne pouvez pas nommer son métier, son objectif et sa frustration, c'est encore trop vague.

Nommer les personnes qui utiliseront vraiment la plateforme ou décideront de ce que les autres voient. Éviter les étiquettes floues comme communauté ou gouvernement - les reformuler de façon concrète. Viser jusqu'à cinq rôles pour la première version.

Checklist d'une bonne persona :

  • Un nom ou un rĂ´le clair (pas « la communautĂ© »)
  • Qui elle est et ce qu'elle fait au quotidien
  • Un objectif et une motivation (pourquoi c'est important pour elle)
  • Un besoin urgent et une frustration aujourd'hui
  • Quelles donnĂ©es elle utilise et quel accès il lui faut
  • Ă€ quoi ressemble la rĂ©ussite pour elle

Exemple de persona (modèle au tableau - le groupe adapte ou remplace) :

Aminata Diallo - animatrice communautaire, UrbaSEN Ziguinchor

Qui elle est Aminata a 34 ans. Elle travaille avec des groupes d'épargne dans deux quartiers de Ziguinchor. Ce n'est pas une experte en cartographie ; elle utilise un téléphone et parfois un ordinateur au bureau UrbaSEN.
Au quotidien Visite les quartiers, accompagne les enquêteurs, prépare les membres de la fédération pour les réunions avec la mairie, transforme les résultats d'enquête en cartes simples et points de discussion.
Objectif Éviter que des habitants perdent leur logement sans preuves. Faire écouter la mairie avec des cartes datées et des chiffres, pas seulement des récits.
Motivation Le quartier de sa tante a été déguerpie sans préavis. Elle ne veut pas que cela se reproduise sans que la fédération puisse montrer qui habite où et quels services existent.
Besoin urgent Avant la prochaine réunion au conseil dans six semaines : une carte avec les limites du quartier, le nombre de ménages et les points d'eau - tout à la même date, facile à montrer sur une tablette.
Frustration aujourd'hui Les données sont éparpillées - dossier Drive de quelqu'un, notes papier, ancien fichier sur un seul ordinateur. Elle passe des jours à recopier des chiffres dans des diapositives au lieu d'organiser.
Données dont elle a besoin Limites de quartier, enquête ménages, infrastructure (eau, toilettes), photos ou récits liés aux lieux.
Accès dont elle a besoin Lire et exporter pour les réunions ; elle ne charge pas les enquêtes brutes elle-même - elle passe par le gestionnaire des données.
Réussite pour elle Elle ouvre la plateforme sur son téléphone, choisit son quartier, et a une carte et un résumé qu'elle peut présenter à la mairie en toute confiance.
Vie privée Les noms de ménage et numéros de téléphone ne doivent pas apparaître sur ce que le public ou le conseil voit sans accord explicite.

Demander au groupe : Qui dans votre équipe ressemble à Aminata - ou est différent ? Donnez-lui un nom, un métier, un objectif, une frustration.


30 min - User stories par persona

Message clé : Une bonne user story nomme une action sur la plateforme et un résultat concret sur le terrain - et pointe vers des données documentées dans le questionnaire.

Pour chaque persona prioritaire, écrire une user story en langage simple : En tant que [rôle], je veux [faire quelque chose sur la plateforme], afin de [résultat dans le travail réel]. Une histoire par rôle suffit dans la salle. Optionnel : reformuler une histoire en Étant donné / Quand / Alors si le groupe le souhaite. Garder le lien avec les données du questionnaire - si l'histoire a besoin de données qui n'existent pas, noter le manque plutôt que de faire comme si elles étaient là.

Exemples Ă  mettre au tableau (Ă  adapter avec le groupe) :

1. Régularisation

En tant qu' organisatrice de la fédération préparant un dossier de régularisation, je veux rassembler limites de quartier, totaux de ménages agrégés, couverture des structures et manques de services dans un dossier cartographique daté, afin de montrer à la municipalité quels îlots informels répondent aux critères de reconnaissance formelle sans exposer les noms des résidents.

Utilise : limites, enquête ménages (agrégats), infrastructure, KYC.TV en option

2. Quand la carte officielle ne correspond pas à la réalité

En tant qu' organisatrice communautaire comme Aminata, je veux comparer notre limite de quartier vérifiée par la communauté avec la carte administrative sur un seul écran, avec les totaux de ménages rattachés, afin de montrer aux autorités locales où les habitants vivent vraiment quand la carte officielle les laisse de côté ou trace mal la limite.

Utilise : limites (communauté vs officiel), totaux ménages agrégés

3. Plaidoyer qui respecte la vie privée

En tant que responsable de programme / contrôleur des données, je veux garder les couches complètes d'enquête ménages en interne et publier seulement totaux agrégés et cartes approuvés par la fédération, afin d' utiliser les mêmes données en négociation et en plaidoyer public sans que noms ou numéros de téléphone apparaissent sur le web ouvert.

Utilise : enquête ménages (souvent données personnelles), règles de publication

Si une histoire a besoin de données qui n'existent pas encore, noter le manque plutôt que de faire comme si elles étaient prêtes.


Conclusion

Message clé : Terminer avec clarté - ce qu'on a capturé, ce qui reste ouvert, et comment suivre si les participants le souhaitent.

Relire ce qui a été noté : cas d'usage principaux, données qui les soutiennent, personas retenues, une histoire chacune, manques et points à confirmer. Mentionner brièvement qui décide des règles de publication (contrôleur des données vs gestionnaire au quotidien) si le temps le permet - le détail viendra plus tard. Proposer un groupe WhatsApp pour ceux qui veulent continuer le questionnaire ou clarifier des noms après la session (nom suggéré : KYC 2.0 Sénégal - suivi données). Confirmer un court résumé écrit sous 48 heures. Remercier et arrêter l'enregistrement.


Rappel de ton (facilitateurs)

Demander ; ne pas imposer. Noter les plans seulement quand les participants les partagent. Les données personnelles ne vont pas sur la carte publique par conception - noter les cas sensibles pour une discussion de gouvernance ultérieure.

Senegal workshop — simple agenda (Mon 20 Jul)

When: 14:00-16:30 Dakar
OpenTalk: https://meet.opentalk.eu/room/60fb1399-1fb0-49dd-8af5-45b19acaa730?invite=dda1a71a-762c-4df7-93b3-6d1b170a1886
Survey: https://kyc20-data-lineage-production.up.railway.app/


Agenda

Time Block Key point
10 min Introductions Know who is in the room; recording consent; one hope for today
5 min Framing — all cities, all years This helps everyone, everywhere, over time — not only Ziguinchor today
5 min Kblock demo Existing map data can support real decisions when combined with federation data
25 min Data survey online Document what you have and what you plan — we ask, we do not assign
5 min Break (after survey) Pause and connect the next blocks to what you actually heard
15 min Use cases on whiteboard Name real problems in real work — not features or technology
15 min Connect survey to use cases Every priority use case needs data behind it — or an honest gap
10 min Break (before personas) Reset before empathy work — review notes from survey and use cases
15 min Personas A good persona is someone you can picture: name, job, goal, frustration, data need
30 min Persona user stories One concrete story per role, tied to data from the survey
Close Conclusion Read back what we agreed — no new topics

10 min — Introductions

Key point: Everyone knows who is in the room and why we are here before we open the survey.

Before you speak: start recording (see checklist). Paste the OpenTalk and survey links in chat.

Say once (recording): we are recording so we can share notes with anyone who could not join. If anyone objects, say so now.

Facilitators (30 seconds each): name, role, organisation.

Round-robin (~30-45 seconds each person):

  • Name and role
  • Organisation or team (UrbaSEN, federation, SDI, etc.)
  • One sentence: what would make today's session useful for you?

Keep it light — no long speeches. Note names and roles for the persona block later.

One line on the session: today we document Ziguinchor data in the survey and agree who will use the platform and for what. No technical jargon required.

« Bonjour à toutes et à tous. On enregistre la session — si quelqu'un a une objection, dites-le maintenant.
Chacun·e se présente : prénom, rôle, organisation, et en une phrase ce qui vous aiderait aujourd'hui. »


5 min — Framing (all cities, all years)

Key point: The value of this project is for all programme cities and across years — include data you already hold, not only what this project will collect.

Today we focus on Ziguinchor, but the platform is meant to help all seven programme cities. It should also hold data from different years — old maps and surveys matter as much as new ones. When you document what you have and what you plan, you are helping your city and the wider network. The survey is not only about data from this project; include anything your federation already holds from earlier work.


5 min — Kblock demo

Key point: This demo shows what is possible when map layers are used for local decisions — it is motivation, not the final product.

Show Kblock as a real example of what good use of map data can look like. OpenStreetMap is one input; the point is turning existing map layers into something useful for local decisions (for example seeing patterns block by block). Say clearly this is a motivation demo, not the final product. OpenStreetMap on its own is not enough — it works best when combined with federation data such as settlement boundaries and field surveys. After the demo, ask: which layer do you already have, which is missing, and who in your team looks after it?


25 min — Data survey online

Key point: The survey is a shared picture of your data landscape — we capture what exists, what is planned, and who is responsible, only when you are ready to say.

Walk through the lineage survey together. People sign in, pick Senegal, and fill what they know — they do not need to finish everything today. For each dataset: does it exist now, is it planned, or not applicable? If something is missing, ask gently whether they plan to collect it, roughly when, under which project, and who would be responsible — only if they are ready to answer. Note to confirm where they are unsure. Fix any wrong or placeholder rows (for example copied example text on OpenStreetMap). Drone flights were not allowed in Ziguinchor for law-and-order reasons; street-level mapping was discussed as an alternative — if they confirm, add it as a possible new dataset type.


5 min — Break (after survey)

Key point: Use this pause to turn survey answers into useful input for the whiteboard — not to start the next block cold.

Pause the session. Tell participants you will be back in five minutes.

For you (internal): use this time to gather lessons from the survey block — what was filled, what is still missing, who owns what, any surprises or blockers. Jot quick notes before moving to the whiteboard so use cases and personas connect to what you actually heard, not what you assumed.

« On fait une pause de cinq minutes. On reprend dans un instant pour la partie tableau blanc. »


15 min — Use cases on the whiteboard

Key point: A good use case starts with a problem someone faces this month — not a wish for a better system.

Ask what problems the city platform must help with in real life: preparing for a meeting with the mairie, showing service gaps on a map, linking a story to a place, exporting numbers for a report. Write 4-6 use cases as short sticky notes. Do not debate technology. Pick the 2-3 that feel most urgent for Release 1.


15 min — Connect survey data to use cases

Key point: If a use case cannot point to data you have or plan to collect, it stays a wish — mark the gap honestly.

Draw lines on the whiteboard from each priority use case to the datasets in the survey that support it. If a use case has no data behind it, mark the gap — do not treat it as ready to build. If survey data has no use case yet, note it as available but unused or purpose unclear. This step stops wishlists: every important use case should point to data you have, plan to collect, or honestly lack.


10 min — Break (before personas)

Key point: Persona work needs empathy — take a breath and review what you learned before asking people to describe users.

Pause again before the persona block. Use the time to skim your survey and use-case notes so the examples you put on the board reflect Ziguinchor, not a generic template.

« Petite pause avant la partie personas — on reprend dans dix minutes. »


15 min — Personas

Key point: A good persona is someone you can picture — if you cannot name their job, goal, and frustration, it is still too vague.

Name the people who will actually use the platform or decide what others see. Avoid vague labels like community or government — rename into something concrete. Aim for up to five roles for the first release.

Checklist for a good persona:

  • A name or clear role label (not "the community")
  • Who they are and what they do day to day
  • One goal and one motivation (why they care)
  • One urgent need and one frustration today
  • What data they rely on and what access they need
  • What success looks like for them

Example persona (put on the board as a template — then ask the group to adapt or replace):

Aminata Diallo — community organiser, UrbaSEN Ziguinchor

Who she is Aminata is 34. She works with savings groups in two settlements in Ziguinchor. She is not a GIS expert; she uses a phone and sometimes a laptop at the UrbaSEN office.
What she does day to day Visits settlements, supports enumerators, prepares federation members for meetings with the city authority, and turns survey results into simple maps and talking points.
Goal Keep residents from losing their homes without evidence. Get the mairie to listen with dated maps and counts, not only stories.
Motivation Her aunt's settlement was cleared without warning. She does not want that to happen again without the federation being able to show who lives where and what services exist.
Urgent need Before the next council meeting in six weeks: one map with settlement boundaries, household counts, and water points — all from the same date, easy to show on a tablet.
Frustration today Data sits in different places — someone's Drive folder, paper notes, an old shapefile on one laptop. She spends days copying numbers into slides instead of organising.
Data she relies on Settlement boundaries, household enumeration, infrastructure (water, toilets), photos or stories linked to places.
Access she needs Read and export for meetings; she does not upload raw surveys herself — she asks the data manager.
What success looks like She opens the platform on her phone, picks her settlement, and has a map and summary she trusts enough to take into the mairie office.
Privacy concern Household names and phone numbers must not appear on anything the public or the council sees without explicit approval.

Ask the group: Who in your team is like Aminata — or different? Give them a name, a job, one goal, and one frustration.


30 min — Persona user stories

Key point: A good user story names one action on the platform and one outcome in real work — and points to data you documented in the survey.

For each priority persona, write one user story in plain language: As a [role], I want to [do something on the platform], so that [outcome in real work]. One story per role is enough in the room. Optionally rewrite one story in Given / When / Then form if the group finds it helpful. Keep stories tied to data you documented in the survey — if the story needs data that does not exist, note that as a gap rather than pretending it is there.

Examples to put on the board (adapt with the group):

1. Regularization

As a federation organiser preparing a regularization case, I want to pull together settlement boundaries, aggregated household counts, structure coverage, and service gaps on one dated map pack, so I can show the municipality which informal blocks meet the criteria for formal recognition without exposing resident names.

Uses: boundaries, enumeration (aggregates), infrastructure, optional KYC.TV

2. When official maps disagree with reality

As a community organiser like Aminata, I want to compare our community-verified settlement boundary with the government ward map on one screen, with household counts attached, so I can show local officials where people actually live when the official map leaves them off or draws the line wrong.

Uses: boundaries (community vs official), enumeration aggregates

3. Advocacy that respects privacy

As a programme lead / data controller, I want to keep full household survey layers internal and publish only aggregated counts and maps the federation approves, so I can use the same data in negotiations and public advocacy without names or phone numbers appearing on the open web.

Uses: enumeration (often contains personal data), publish rules

If a story needs data that does not exist yet, note it as a gap rather than pretending it is ready.


Conclusion

Key point: End with clarity — what we captured, what is still open, and how people can follow up if they want to.

Read back what you captured: main use cases, which data supports them, top personas, one story each, gaps and to confirm items. Mention who decides publish rules (controller vs day-to-day data manager) only at a high level if time allows — full rules come later. Offer a WhatsApp group for anyone who wants to continue the survey or clarify names after the session (suggested name: KYC 2.0 Sénégal - suivi données). Confirm you will send a short written summary within 48 hours. Thank people and stop the recording.


Tone reminder (facilitators)

Ask; do not assign. Capture plans only when participants share them. Personal data does not go on the public map by design — note sensitive cases for later governance discussion.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment