From 335511147365ded2256991c584a57987c46b8c02 Mon Sep 17 00:00:00 2001
From: Baptiste LAFOURCADE <baptiste.lafourcade@gmail.com>
Date: Tue, 28 Jul 2026 20:34:28 +0200
Subject: [PATCH] feat(update): self-service flow to update member info after
 emission

Adds the missing "modify my info" path alongside create (certification) and
delete (removal). A signed badge encodes only handle + dates + status, so
name/LinkedIn/photo/description are directory-only: an update never re-signs,
regenerates the record with github/role/status_index preserved, and emission
reproduces a byte-identical credential. certified_on (add-commit date) and the
proof link stay stable. Empty field = unchanged.

- Issue Form update-request.yml (all fields optional) + update-* labels
- update-pr.yml workflow: requires an existing record, reuses status_index,
  gates the photo step on a photo actually provided, moderation shows a
  before -> after diff
- lib/update-request.mjs (pure) reusing the certification validators, which are
  now exported; toMemberYaml passes role + renewed_on through so no field is lost
- round-trip byte-identical test proves the credential is untouched by an update
- ARCHITECTURE.md: update sequence + instant-text / lagged-photo note

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PC9TRnYr5AXe7GmBmHjkBy
---
 .github/ISSUE_TEMPLATE/update-request.yml     |  59 ++++++
 .github/scripts/lib/certification-request.mjs |  27 ++-
 .github/scripts/lib/update-request.mjs        | 121 +++++++++++
 .github/scripts/lib/update-request.test.mjs   | 110 ++++++++++
 .github/scripts/read-update-request.mjs       |  56 +++++
 .github/workflows/update-pr.yml               | 200 ++++++++++++++++++
 docs/ARCHITECTURE.md                          |  25 +++
 7 files changed, 587 insertions(+), 11 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/update-request.yml
 create mode 100644 .github/scripts/lib/update-request.mjs
 create mode 100644 .github/scripts/lib/update-request.test.mjs
 create mode 100644 .github/scripts/read-update-request.mjs
 create mode 100644 .github/workflows/update-pr.yml

diff --git a/.github/ISSUE_TEMPLATE/update-request.yml b/.github/ISSUE_TEMPLATE/update-request.yml
new file mode 100644
index 0000000..166058c
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/update-request.yml
@@ -0,0 +1,59 @@
+name: Mettre à jour mes informations
+description: Modifier votre nom, photo, profil LinkedIn, site ou description dans l'annuaire des certifiés.
+title: "[Certifié] Mise à jour de mes informations"
+labels: ["update-request"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Modifiez uniquement ce que vous voulez changer. **Un champ laissé vide reste inchangé.**
+
+        Votre identité est le compte GitHub avec lequel vous ouvrez cette demande ; elle n'est pas modifiable ici. Votre badge et sa date de certification ne changent pas : seule votre fiche d'annuaire est mise à jour. Un mainteneur relit la modification avant publication.
+  - type: input
+    id: name
+    attributes:
+      label: Nom complet
+      description: Laissez vide pour garder le nom actuel.
+      placeholder: Prénom Nom
+    validations:
+      required: false
+  - type: input
+    id: linkedin
+    attributes:
+      label: Profil LinkedIn
+      description: L'adresse complète de votre profil LinkedIn. Laissez vide pour garder l'actuel.
+      placeholder: https://www.linkedin.com/in/votre-profil
+    validations:
+      required: false
+  - type: input
+    id: website
+    attributes:
+      label: Site web
+      description: Votre site personnel. Laissez vide pour garder l'actuel.
+      placeholder: https://votre-site.fr
+    validations:
+      required: false
+  - type: input
+    id: description
+    attributes:
+      label: Description
+      description: Une phrase de présentation. Laissez vide pour garder l'actuelle.
+      placeholder: "Développeur passionné d'IA appliquée au dev."
+    validations:
+      required: false
+  - type: textarea
+    id: photo
+    attributes:
+      label: Photo
+      description: Glissez une nouvelle photo pour remplacer l'actuelle. Laissez vide pour la garder.
+    validations:
+      required: false
+  - type: checkboxes
+    id: consent
+    attributes:
+      label: Exactitude et publication
+      options:
+        - label: Je contrôle ce compte GitHub et les informations que je fournis sont exactes.
+          required: true
+        - label: J'accepte que ces informations mises à jour soient publiées dans l'annuaire public.
+          required: true
diff --git a/.github/scripts/lib/certification-request.mjs b/.github/scripts/lib/certification-request.mjs
index a939552..38f1ef4 100644
--- a/.github/scripts/lib/certification-request.mjs
+++ b/.github/scripts/lib/certification-request.mjs
@@ -5,12 +5,12 @@ import { clean, parseIssueFormBody } from './issue-form.mjs';
 import { extractImageUrl } from './photo-url.mjs';
 import { recordPathFor, photoPathFor } from './member-paths.mjs';
 
-const NO_RESPONSE = '_No response_';
+export const NO_RESPONSE = '_No response_';
 
-const LIMIT = Object.freeze({ name: 120, linkedin: 200, website: 200, description: 280 });
+export const LIMIT = Object.freeze({ name: 120, linkedin: 200, website: 200, description: 280 });
 
 // Le heading d'un champ Issue Form = son `label`, rendu en `### <label>`.
-const HEADING = Object.freeze({
+export const HEADING = Object.freeze({
   name: 'nom complet',
   linkedin: 'profil linkedin',
   website: 'site web',
@@ -23,24 +23,24 @@ const GITHUB_HANDLE_RE = /^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,37}[a-zA-Z0-9])?$/;
 /** Erreur de validation d'une demande : message destiné au demandeur. */
 export class RequestError extends Error {}
 
-const omitNoResponse = (value) => (value === NO_RESPONSE ? '' : value);
+export const omitNoResponse = (value) => (value === NO_RESPONSE ? '' : value);
 
-function requireSingleLine(value, field) {
+export function requireSingleLine(value, field) {
   if (value.includes('\n')) throw new RequestError(`${field} doit tenir sur une ligne`);
   return value;
 }
 
-function requireUnderLimit(value, field, max) {
+export function requireUnderLimit(value, field, max) {
   if (value.length > max) throw new RequestError(`${field} dépasse ${max} caractères`);
   return value;
 }
 
-function isHttpsUrl(value) {
+export function isHttpsUrl(value) {
   try { return new URL(value).protocol === 'https:'; } catch { return false; }
 }
 
 /** Scalaire YAML sûr : double-quote via JSON (échappe guillemets, backslash, etc.). */
-const yamlScalar = (value) => JSON.stringify(String(value));
+export const yamlScalar = (value) => JSON.stringify(String(value));
 
 /** Valide le handle GitHub (issu de l'auteur de l'issue, pas d'un champ saisi). */
 export function parseHandle(login) {
@@ -90,12 +90,16 @@ export function parseDescription(fields) {
   return requireUnderLimit(value, 'Description', LIMIT.description);
 }
 
-/** Sérialise l'enregistrement du membre en YAML plat, valeurs échappées. */
-export function toMemberYaml({ handle, name, linkedin, website, description, statusIndex }) {
+/**
+ * Sérialise l'enregistrement du membre en YAML plat, valeurs échappées.
+ * `role` et `renewedOn` sont conservés tels quels (indispensable pour une
+ * mise à jour, qui régénère la fiche sans devoir en perdre un champ).
+ */
+export function toMemberYaml({ handle, name, linkedin, website, description, statusIndex, role = 'certifie', renewedOn }) {
   if (!Number.isInteger(statusIndex) || statusIndex < 0) throw new RequestError('statusIndex requis');
   const lines = [
     `github: ${yamlScalar(handle)}`,
-    `role: "certifie"`,
+    `role: ${yamlScalar(role)}`,
     `name: ${yamlScalar(name)}`,
     `linkedin: ${yamlScalar(linkedin)}`,
     `photo: ${yamlScalar(photoPathFor(handle))}`, // objet Git LFS (#16), normalisé à l'intake (#21)
@@ -103,6 +107,7 @@ export function toMemberYaml({ handle, name, linkedin, website, description, sta
   ];
   if (website) lines.push(`website: ${yamlScalar(website)}`);
   if (description) lines.push(`description: ${yamlScalar(description)}`);
+  if (renewedOn) lines.push(`renewed_on: ${yamlScalar(renewedOn)}`); // #27 : prime sur certified_on
   return lines.join('\n') + '\n';
 }
 
diff --git a/.github/scripts/lib/update-request.mjs b/.github/scripts/lib/update-request.mjs
new file mode 100644
index 0000000..69be965
--- /dev/null
+++ b/.github/scripts/lib/update-request.mjs
@@ -0,0 +1,121 @@
+// Construit la fiche mise à jour d'un membre à partir d'une issue de mise à jour.
+// Identité = auteur de l'issue (compte GitHub), jamais un champ saisi (CT-3).
+// Fonctions pures : ni lecture d'event, ni écriture de fichier.
+//
+// Un badge signé n'encode QUE le handle + les dates + le statut ; nom, LinkedIn,
+// photo et description vivent dans l'annuaire seul. Une mise à jour ne re-signe
+// donc rien : elle régénère la fiche (mêmes github/role/status_index) et l'emit
+// reproduit un credential byte-identique. Un champ laissé vide = inchangé.
+import { parseIssueFormBody, clean } from './issue-form.mjs';
+import { extractImageUrl } from './photo-url.mjs';
+import { parseMemberYaml } from './credential.mjs';
+import { recordPathFor, photoPathFor } from './member-paths.mjs';
+import {
+  HEADING, LIMIT, RequestError, omitNoResponse,
+  requireSingleLine, requireUnderLimit, isHttpsUrl, parseHandle, toMemberYaml,
+} from './certification-request.mjs';
+
+/** Valeur d'un champ du formulaire, vidée du placeholder « _No response_ ». */
+const field = (fields, key) => omitNoResponse(clean(fields[key] ?? ''));
+
+/** Nom : si fourni, une ligne non vide sous la limite ; sinon on garde l'existant. */
+function updateName(fields, current) {
+  const value = field(fields, HEADING.name);
+  if (!value) return current;
+  const name = requireUnderLimit(requireSingleLine(value, 'Nom'), 'Nom', LIMIT.name);
+  if (!name) return current;
+  return name;
+}
+
+/** LinkedIn : si fourni, URL https linkedin.com sous la limite ; sinon inchangé. */
+function updateLinkedin(fields, current) {
+  const value = field(fields, HEADING.linkedin);
+  if (!value) return current;
+  requireUnderLimit(requireSingleLine(value, 'LinkedIn'), 'LinkedIn', LIMIT.linkedin);
+  if (!isHttpsUrl(value) || !/linkedin\.com/i.test(value)) {
+    throw new RequestError('LinkedIn doit être une URL https linkedin.com');
+  }
+  return value;
+}
+
+/** Site : si fourni, URL https sous la limite ; sinon inchangé. */
+function updateWebsite(fields, current) {
+  const value = field(fields, HEADING.website);
+  if (!value) return current;
+  requireUnderLimit(requireSingleLine(value, 'Site'), 'Site', LIMIT.website);
+  if (!isHttpsUrl(value)) throw new RequestError('Site doit être une URL https');
+  return value;
+}
+
+/** Description : si fournie, une ligne sous la limite ; sinon inchangée. */
+function updateDescription(fields, current) {
+  const value = field(fields, HEADING.description);
+  if (!value) return current;
+  return requireUnderLimit(requireSingleLine(value, 'Description'), 'Description', LIMIT.description);
+}
+
+/**
+ * Transforme une issue de mise à jour + la fiche existante en fiche régénérée.
+ * @param {object} issue         objet event.issue (auteur = membre)
+ * @param {string} existingYaml  contenu actuel de data/members/<handle>/record.yml
+ * Lève RequestError si un champ fourni est invalide.
+ */
+export function buildMemberUpdate(issue, existingYaml) {
+  const handle = parseHandle(issue?.user?.login);
+  const current = parseMemberYaml(existingYaml);
+
+  const statusIndex = Number(current.status_index);
+  if (!Number.isInteger(statusIndex) || statusIndex < 0) {
+    throw new RequestError(`status_index invalide dans la fiche de @${handle}`);
+  }
+
+  const fields = parseIssueFormBody(issue?.body || '');
+  const before = {
+    name: current.name ?? '',
+    linkedin: current.linkedin ?? '',
+    website: current.website ?? '',
+    description: current.description ?? '',
+  };
+  const after = {
+    name: updateName(fields, before.name),
+    linkedin: updateLinkedin(fields, before.linkedin),
+    website: updateWebsite(fields, before.website),
+    description: updateDescription(fields, before.description),
+  };
+
+  // Photo : ne change que si une image est déposée dans le champ.
+  const photoUrl = extractImageUrl(field(fields, HEADING.photo)) || '';
+
+  const changed =
+    photoUrl !== '' ||
+    after.name !== before.name ||
+    after.linkedin !== before.linkedin ||
+    after.website !== before.website ||
+    after.description !== before.description;
+
+  const yaml = toMemberYaml({
+    handle,
+    name: after.name,
+    linkedin: after.linkedin,
+    website: after.website,
+    description: after.description,
+    statusIndex,
+    role: current.role || 'certifie',        // préservé (niveau 2 « habilite » à venir, #8)
+    renewedOn: current.renewed_on,           // préservé : sinon la date d'émission dériverait (#27)
+  });
+
+  return {
+    handle,
+    ...after,
+    before,
+    changed,
+    statusIndex,
+    photoUrl,
+    photoChanged: photoUrl !== '',
+    photoPath: photoPathFor(handle),
+    issueNumber: issue.number,
+    path: recordPathFor(handle),
+    branch: `maj/${handle}-${issue.number}`,
+    yaml,
+  };
+}
diff --git a/.github/scripts/lib/update-request.test.mjs b/.github/scripts/lib/update-request.test.mjs
new file mode 100644
index 0000000..c740dc0
--- /dev/null
+++ b/.github/scripts/lib/update-request.test.mjs
@@ -0,0 +1,110 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { RequestError, toMemberYaml } from './certification-request.mjs';
+import { parseMemberYaml } from './credential.mjs';
+import { buildMemberUpdate } from './update-request.mjs';
+
+const PHOTO_MD = '![moi](https://github.com/user-attachments/assets/abc)';
+
+// Fiche existante, écrite dans la forme canonique (comme l'intake la produit).
+function existingRecord(overrides = {}) {
+  return toMemberYaml({
+    handle: 'jdupont',
+    name: 'Jean Dupont',
+    linkedin: 'https://www.linkedin.com/in/jd',
+    website: '',
+    description: '',
+    statusIndex: 5,
+    ...overrides,
+  });
+}
+
+// Corps d'issue de mise à jour : chaque champ non fourni = « _No response_ » (inchangé).
+function issueBody({ name, linkedin, website, description, photo } = {}) {
+  return [
+    `### Nom complet\n\n${name || '_No response_'}`,
+    `### Profil LinkedIn\n\n${linkedin || '_No response_'}`,
+    `### Site web\n\n${website || '_No response_'}`,
+    `### Description\n\n${description || '_No response_'}`,
+    `### Photo\n\n${photo || '_No response_'}`,
+  ].join('\n\n');
+}
+
+function issue(body = {}, overrides = {}) {
+  return { number: 12, user: { login: 'jdupont' }, body: issueBody(body), ...overrides };
+}
+
+describe('buildMemberUpdate — champs', () => {
+  it('met à jour uniquement le champ fourni, garde les autres', () => {
+    const u = buildMemberUpdate(issue({ description: 'Nouvelle bio.' }), existingRecord());
+    assert.equal(u.description, 'Nouvelle bio.');
+    assert.equal(u.name, 'Jean Dupont');       // inchangé
+    assert.equal(u.linkedin, 'https://www.linkedin.com/in/jd');
+    assert.equal(u.changed, true);
+    assert.equal(u.photoChanged, false);
+  });
+
+  it('un formulaire entièrement vide ne change rien (changed=false)', () => {
+    const u = buildMemberUpdate(issue({}), existingRecord({ description: 'Bio' }));
+    assert.equal(u.changed, false);
+    assert.equal(u.name, 'Jean Dupont');
+    assert.equal(u.description, 'Bio');
+  });
+
+  it('détecte une nouvelle photo', () => {
+    const u = buildMemberUpdate(issue({ photo: PHOTO_MD }), existingRecord());
+    assert.equal(u.photoChanged, true);
+    assert.equal(u.photoUrl, 'https://github.com/user-attachments/assets/abc');
+    assert.equal(u.changed, true);
+  });
+
+  it('rejette un LinkedIn non https/linkedin', () => {
+    assert.throws(() => buildMemberUpdate(issue({ linkedin: 'http://x.com' }), existingRecord()), RequestError);
+  });
+
+  it('rejette un site non https', () => {
+    assert.throws(() => buildMemberUpdate(issue({ website: 'ftp://x' }), existingRecord()), RequestError);
+  });
+
+  it('expose le diff avant/après', () => {
+    const u = buildMemberUpdate(issue({ name: 'Jeanne Dupont' }), existingRecord());
+    assert.equal(u.before.name, 'Jean Dupont');
+    assert.equal(u.name, 'Jeanne Dupont');
+  });
+});
+
+describe('buildMemberUpdate — invariants de préservation', () => {
+  it('préserve status_index et role', () => {
+    const u = buildMemberUpdate(issue({ name: 'X' }), existingRecord({ role: 'habilite', statusIndex: 9 }));
+    assert.equal(u.statusIndex, 9);
+    assert.match(u.yaml, /status_index: 9/);
+    assert.match(u.yaml, /role: "habilite"/);
+  });
+
+  it('la branche est dérivée du handle + numéro d’issue', () => {
+    const u = buildMemberUpdate(issue({ name: 'X' }), existingRecord());
+    assert.equal(u.branch, 'maj/jdupont-12');
+    assert.equal(u.path, 'data/members/jdupont/record.yml');
+  });
+
+  // Trap #2 (advisor) : la régénération ne doit perdre AUCUN champ. Round-trip
+  // byte-identical d'une fiche complète prouve que credential et date d'émission
+  // (qui dépendent de handle + status_index + certified_on) restent intacts.
+  it('round-trip byte-identical d’une fiche complète (dont renewed_on)', () => {
+    const full = toMemberYaml({
+      handle: 'jdupont',
+      name: 'Jean Dupont',
+      linkedin: 'https://www.linkedin.com/in/jd',
+      website: 'https://jd.fr',
+      description: 'Bio complète.',
+      statusIndex: 5,
+      role: 'certifie',
+      renewedOn: '2027-01-01T00:00:00Z',
+    });
+    // Formulaire vide -> régénération pure de l'existant.
+    const u = buildMemberUpdate(issue({}), full);
+    assert.equal(u.yaml, full);
+    // Et la fiche reparse à l'identique.
+    assert.deepEqual(parseMemberYaml(u.yaml), parseMemberYaml(full));
+  });
+});
diff --git a/.github/scripts/read-update-request.mjs b/.github/scripts/read-update-request.mjs
new file mode 100644
index 0000000..8860c58
--- /dev/null
+++ b/.github/scripts/read-update-request.mjs
@@ -0,0 +1,56 @@
+// Couche I/O : lit l'event GitHub + la fiche existante, construit la fiche mise à
+// jour via la lib, écrit les sorties du workflow. Toute la logique est dans lib/.
+//
+// Sorties : has_record=false si l'auteur n'a pas de fiche (rien à mettre à jour).
+// Sinon has_record=true + les champs de la fiche régénérée (dont un diff avant/après).
+import { readFileSync, existsSync, appendFileSync } from 'node:fs';
+import { parseHandle } from './lib/certification-request.mjs';
+import { buildMemberUpdate } from './lib/update-request.mjs';
+import { recordPathFor } from './lib/member-paths.mjs';
+
+function out(key, value) {
+  appendFileSync(process.env.GITHUB_OUTPUT, `${key}=${value}\n`);
+}
+
+function writeOutputs(update) {
+  const scalars = {
+    has_record: 'true',
+    changed: String(update.changed),
+    github: update.handle,
+    name: update.name,
+    linkedin: update.linkedin,
+    website: update.website,
+    description: update.description,
+    before_name: update.before.name,
+    before_linkedin: update.before.linkedin,
+    before_website: update.before.website,
+    before_description: update.before.description,
+    path: update.path,
+    branch: update.branch,
+    issue_number: update.issueNumber,
+    photo_changed: String(update.photoChanged),
+    photo_url: update.photoUrl,
+    photo_path: update.photoPath,
+  };
+  for (const [key, value] of Object.entries(scalars)) out(key, value);
+  // Contenu YAML multi-ligne via délimiteur.
+  appendFileSync(process.env.GITHUB_OUTPUT, `record<<__YAML__\n${update.yaml}__YAML__\n`);
+}
+
+function main() {
+  const event = JSON.parse(readFileSync(process.env.GITHUB_EVENT_PATH, 'utf8'));
+  const handle = parseHandle(event.issue?.user?.login);
+  const recordPath = recordPathFor(handle);
+
+  if (!existsSync(recordPath)) {
+    out('has_record', 'false');
+    console.log(`Aucune fiche pour @${handle} — rien à mettre à jour.`);
+    return;
+  }
+
+  const update = buildMemberUpdate(event.issue, readFileSync(recordPath, 'utf8'));
+  writeOutputs(update);
+  console.log(`Mise à jour prête : ${update.path} (changé=${update.changed}, photo=${update.photoChanged})`);
+}
+
+main();
diff --git a/.github/workflows/update-pr.yml b/.github/workflows/update-pr.yml
new file mode 100644
index 0000000..ae4ffaf
--- /dev/null
+++ b/.github/workflows/update-pr.yml
@@ -0,0 +1,200 @@
+# Intake : une issue de mise à jour -> PR qui régénère la fiche du membre (nom,
+# LinkedIn, site, description, photo). Le badge signé n'encode que le handle + les
+# dates + le statut : une mise à jour ne re-signe rien, elle rafraîchit l'annuaire.
+# status_index, role et la date de certification sont préservés (fiche éditée, pas
+# ré-ajoutée). Le job agit sous l'App bot intake, pas GITHUB_TOKEN (checks non bloqués).
+name: PR de mise à jour des informations
+
+on:
+  issues:
+    types: [opened, labeled]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: update-pr-${{ github.event.issue.number }}
+  cancel-in-progress: false
+
+jobs:
+  create-pr:
+    # Le label `update-request` est posé côté serveur par l'Issue Form. Retirer le
+    # label arrête ce workflow. `update-retry` (triage-only) rejoue un échec.
+    if: >-
+      github.event.issue.state == 'open'
+      && contains(github.event.issue.labels.*.name, 'update-request')
+      && (github.event.action != 'labeled' || github.event.label.name == 'update-retry')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/create-github-app-token@d72941d797fd3113feb6b93fd0dec494b13a2547 # v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.INTAKE_BOT_APP_ID }}
+          private-key: ${{ secrets.INTAKE_BOT_APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        with:
+          node-version: "20"
+
+      - name: Lire la demande de mise à jour
+        id: request
+        continue-on-error: true
+        env:
+          GITHUB_EVENT_PATH: ${{ github.event_path }}
+        run: node .github/scripts/read-update-request.mjs
+
+      - name: Signaler une demande invalide
+        if: steps.request.outcome == 'failure'
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          ISSUE_NUMBER: ${{ github.event.issue.number }}
+        run: |
+          gh issue comment "$ISSUE_NUMBER" --body "Votre mise à jour n'a pas pu être traitée. Vérifiez les champs remplis (LinkedIn/Site doivent être des URLs https) et ouvrez une nouvelle demande : modifier cette issue ne relance pas le traitement, qui ne réagit qu'aux issues nouvellement ouvertes."
+          gh issue edit "$ISSUE_NUMBER" --add-label "update-needs-fix" || true
+          gh issue close "$ISSUE_NUMBER" --reason "not planned"
+          exit 1
+
+      - name: Arrêter si aucune fiche à mettre à jour
+        if: steps.request.outcome == 'success' && steps.request.outputs.has_record == 'false'
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          ISSUE_NUMBER: ${{ github.event.issue.number }}
+          HANDLE: ${{ github.event.issue.user.login }}
+        run: |
+          gh issue comment "$ISSUE_NUMBER" --body "@$HANDLE n'a pas de fiche dans le registre — inscrivez-vous d'abord (formulaire « S'inscrire au registre des certifiés »)."
+          gh issue close "$ISSUE_NUMBER" --reason "not planned"
+
+      - name: Arrêter si rien n'a changé
+        if: steps.request.outcome == 'success' && steps.request.outputs.has_record == 'true' && steps.request.outputs.changed == 'false'
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          ISSUE_NUMBER: ${{ github.event.issue.number }}
+        run: |
+          gh issue comment "$ISSUE_NUMBER" --body "Aucune modification détectée : tous les champs étaient vides. Ouvrez une nouvelle demande en remplissant ce que vous voulez changer."
+          gh issue close "$ISSUE_NUMBER" --reason "not planned"
+
+      - name: Arrêter si une PR de mise à jour existe déjà
+        id: existing-pr
+        if: steps.request.outcome == 'success' && steps.request.outputs.has_record == 'true' && steps.request.outputs.changed == 'true'
+        env:
+          BRANCH_PREFIX: maj/${{ steps.request.outputs.github }}-
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          GITHUB_HANDLE: ${{ steps.request.outputs.github }}
+          ISSUE_NUMBER: ${{ steps.request.outputs.issue_number }}
+        run: |
+          pr_url="$(gh pr list --state open --json url,headRefName \
+            --jq '[.[] | select(.headRefName | startswith(env.BRANCH_PREFIX))] | .[0].url // ""')"
+          echo "url=$pr_url" >> "$GITHUB_OUTPUT"
+          if [ -n "$pr_url" ]; then
+            gh issue comment "$ISSUE_NUMBER" --body "Une PR de mise à jour est déjà ouverte pour @$GITHUB_HANDLE : $pr_url"
+            gh issue close "$ISSUE_NUMBER" --reason "not planned"
+          fi
+
+      - name: Écrire la fiche mise à jour
+        if: steps.existing-pr.conclusion == 'success' && steps.existing-pr.outputs.url == ''
+        env:
+          MEMBER_PATH: ${{ steps.request.outputs.path }}
+          RECORD: ${{ steps.request.outputs.record }}
+        run: printf '%s' "$RECORD" > "$MEMBER_PATH"
+
+      - name: Installer les dépendances des scripts
+        if: steps.existing-pr.conclusion == 'success' && steps.existing-pr.outputs.url == '' && steps.request.outputs.photo_changed == 'true'
+        run: cd .github/scripts && npm ci
+
+      - name: Traiter la nouvelle photo (WebP + strip EXIF + LFS)
+        if: steps.existing-pr.conclusion == 'success' && steps.existing-pr.outputs.url == '' && steps.request.outputs.photo_changed == 'true'
+        env:
+          PHOTO_URL: ${{ steps.request.outputs.photo_url }}
+          PHOTO_PATH: ${{ steps.request.outputs.photo_path }}
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+        run: node .github/scripts/process-photo.mjs
+
+      - name: Committer et ouvrir la PR
+        id: pull-request
+        if: steps.existing-pr.conclusion == 'success' && steps.existing-pr.outputs.url == ''
+        env:
+          BRANCH: ${{ steps.request.outputs.branch }}
+          DISPLAY_NAME: ${{ steps.request.outputs.name }}
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          GITHUB_HANDLE: ${{ steps.request.outputs.github }}
+          MEMBER_PATH: ${{ steps.request.outputs.path }}
+          PHOTO_PATH: ${{ steps.request.outputs.photo_path }}
+          PHOTO_CHANGED: ${{ steps.request.outputs.photo_changed }}
+        run: |
+          git config user.name "aidd-badges-intake-bot"
+          git config user.email "actions@github.com"
+          git switch -c "$BRANCH"
+          git add "$MEMBER_PATH"
+          if [ "$PHOTO_CHANGED" = "true" ]; then git add "$PHOTO_PATH"; fi   # photo en pointeur LFS (#16)
+          git commit -m "Mise à jour du registre : $GITHUB_HANDLE"
+          git push -u origin "$BRANCH"
+          pr_url="$(gh pr create \
+            --title "Mise à jour : $DISPLAY_NAME (@$GITHUB_HANDLE)" \
+            --body "PR de mise à jour générée depuis le formulaire pour @$GITHUB_HANDLE. La date de certification, le status_index et le badge signé sont inchangés : seule la fiche d'annuaire est rafraîchie. Relire puis merger si accepté." \
+            --head "$BRANCH" --base main)"
+          echo "url=$pr_url" >> "$GITHUB_OUTPUT"
+
+      - name: Commentaire de modération (avant -> après)
+        if: steps.pull-request.outputs.url != ''
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          PR_URL: ${{ steps.pull-request.outputs.url }}
+          BRANCH: ${{ steps.request.outputs.branch }}
+          GITHUB_HANDLE: ${{ steps.request.outputs.github }}
+          PHOTO_CHANGED: ${{ steps.request.outputs.photo_changed }}
+          PHOTO_PATH: ${{ steps.request.outputs.photo_path }}
+          B_NAME: ${{ steps.request.outputs.before_name }}
+          B_LINKEDIN: ${{ steps.request.outputs.before_linkedin }}
+          B_WEBSITE: ${{ steps.request.outputs.before_website }}
+          B_DESCRIPTION: ${{ steps.request.outputs.before_description }}
+          A_NAME: ${{ steps.request.outputs.name }}
+          A_LINKEDIN: ${{ steps.request.outputs.linkedin }}
+          A_WEBSITE: ${{ steps.request.outputs.website }}
+          A_DESCRIPTION: ${{ steps.request.outputs.description }}
+        run: |
+          row() { # champ | avant | après ; marque -> si différent
+            local label="$1" before="$2" after="$3"
+            local mark=""; [ "$before" != "$after" ] && mark=" ⟵ modifié"
+            echo "| ${label} | ${before:-—} | **${after:-—}**${mark} |"
+          }
+          {
+            echo "## À modérer avant publication"
+            echo ""
+            echo "Mise à jour de la fiche de @${GITHUB_HANDLE}. Badge et date de certification inchangés."
+            echo ""
+            echo "| Champ | Avant | Après |"
+            echo "|---|---|---|"
+            row "Nom" "$B_NAME" "$A_NAME"
+            row "LinkedIn" "$B_LINKEDIN" "$A_LINKEDIN"
+            row "Site" "$B_WEBSITE" "$A_WEBSITE"
+            row "Description" "$B_DESCRIPTION" "$A_DESCRIPTION"
+            echo ""
+            if [ "$PHOTO_CHANGED" = "true" ]; then
+              photo_media="https://media.githubusercontent.com/media/${GITHUB_REPOSITORY}/${BRANCH}/${PHOTO_PATH}"
+              echo "Nouvelle photo (normalisée WebP, EXIF retiré) :"
+              echo ""
+              echo "![Nouvelle photo de @${GITHUB_HANDLE}](${photo_media})"
+            else
+              echo "_Photo inchangée._"
+            fi
+            echo ""
+            echo "### Checklist"
+            echo "- [ ] Modifications cohérentes et sûres (pas de rename/photo abusifs)"
+            echo "- [ ] Liens valides"
+          } > /tmp/moderation.md
+          gh pr comment "$PR_URL" --body-file /tmp/moderation.md
+
+      - name: Fermer l'issue de mise à jour
+        if: steps.pull-request.outputs.url != ''
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          ISSUE_NUMBER: ${{ steps.request.outputs.issue_number }}
+          PR_URL: ${{ steps.pull-request.outputs.url }}
+        run: |
+          gh issue comment "$ISSUE_NUMBER" --body "PR de mise à jour créée : $PR_URL"
+          gh issue edit "$ISSUE_NUMBER" --add-label "update-pr-created" || true
+          gh issue close "$ISSUE_NUMBER" --reason completed
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 06df5c4..36fd213 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -79,6 +79,31 @@ sequenceDiagram
   CI->>Pages: status list révoque, annuaire retire, photo supprimée
 ```
 
+## Mise à jour des informations
+
+Le badge signé n'encode que le handle, les dates et le statut — nom, LinkedIn, photo et
+description vivent dans l'annuaire seul. Une mise à jour **ne re-signe donc rien** : elle
+régénère la fiche (mêmes `github`, `role`, `status_index`) et l'émission reproduit un
+credential byte-identique. La date de certification (`certified_on` = commit d'**ajout**
+de la fiche) et le lien de preuve restent stables. Un champ laissé vide = inchangé.
+
+```mermaid
+sequenceDiagram
+  participant M as Membre
+  participant B as Bot
+  participant R as Mainteneur
+  participant CI as CI
+  M->>B: Issue Form (mise à jour)
+  B->>B: régénère record.yml (status_index/role/date préservés)
+  B->>R: PR de mise à jour (diff avant → après)
+  R->>CI: merge
+  CI->>Pages: annuaire rafraîchi, credential réémis identique
+```
+
+> Instantanéité : le texte de l'annuaire (`directory.json`) est lu en `no-store` → visible
+> aussitôt. Une **photo** remplacée garde la même URL Pages : cache CDN (~10 min) + cache
+> navigateur peuvent servir l'ancienne un moment.
+
 ## Données d'un membre
 
 `data/members/<handle>/record.yml` (fiche) + `photo.webp` (objet Git LFS). L'effacement