feat(erp): annoter un objet figé — la date URSSAF portée par une pièce jointe (#90)

Co-authored-by: Gabriel Radureau <[email protected]>
2026-08-13 23:58:03 +02:00
parent 480888937f
commit 7c7d41cda7
3 changed files with 207 additions and 0 deletions
@@ -0,0 +1,129 @@
+/*
+  Écrit la note publique d'un objet Dolibarr, par l'onglet Notes.
+
+  POURQUOI CE CHEMIN EXISTE. Certains objets ne sont plus modifiables sur ce
+  déploiement : toute soumission du formulaire d'édition d'une charge sociale
+  échoue sur `ERROR 42601: multiple assignments to same column "fk_user_modif"`
+  (erp#87). La NOTE, elle, passe par `update_note()` — un UPDATE ciblé, une seule
+  affectation — et **échappe au bug**. Vérifié en sandbox le 2026-08-13.
+
+  D'où la doctrine, posée par l'opérateur : quand une donnée fautive est déjà en
+  production et qu'elle n'a pas d'incidence insurmontable sur l'exercice, on ne
+  force pas la correction — **on annote l'objet**. Le registre reste
+  append-only, la vérité est portée par la pièce et par la note, et l'écriture
+  n'est pas maquillée.
+
+  Deux pièges :
+    - le lien d'édition de la note est un `a.editfielda`, VISIBLE AU SURVOL
+      seulement : le cliquer expire. On lit son href — il porte le token de
+      session — et on y navigue directement ;
+    - la note s'écrase. Le script refuse d'écrire par-dessus une note existante
+      différente, sauf --force : personne ne doit perdre une annotation
+      antérieure sans l'avoir voulu.
+
+  Usage :
+    deno run -A test/annotateObject.ts --module compta/sociales --id 1 \
+      --note "…" [--force] [--dry-run]
+*/
+import "load_dotenv";
+import { chromium } from "playwright";
+import login from "./scripts/login.ts";
+import { assertSandbox } from "./scripts/guard.ts";
+
+const argv = Deno.args;
+const pick = (f: string, d = "") => (argv.includes(f) ? argv[argv.indexOf(f) + 1] : d);
+
+const mod = pick("--module", "compta/sociales");   // chemin du module Dolibarr
+const id = pick("--id");
+const note = pick("--note");
+const force = argv.includes("--force");
+const dryRun = argv.includes("--dry-run");
+
+if (!id || !note) {
+  console.error("--id et --note sont requis");
+  Deno.exit(2);
+}
+
+const dolibarrAddress = assertSandbox();
+console.log(`cible  : ${dolibarrAddress}`);
+console.log(`objet  : /${mod}/note.php?id=${id}`);
+console.log(`note   : ${note.slice(0, 120)}${note.length > 120 ? "…" : ""}`);
+if (dryRun) {
+  console.log("\n--dry-run : rien n'est soumis.");
+  Deno.exit(0);
+}
+
+const browser = await chromium.launch({ headless: true });
+const context = await browser.newContext({ locale: "fr-FR" });
+const page = await context.newPage();
+
+const normalise = (s: string) => s.replace(/\s+/g, " ").trim();
+
+try {
+  await login.doAdminLogin({
+    page,
+    dolibarrAddress,
+    adminCredentials: {
+      username: Deno.env.get("DOLI_ADMIN_LOGIN") || "undefined",
+      password: Deno.env.get("DOLI_ADMIN_PASSWORD") || "undefined",
+    },
+  });
+
+  const notePage = `${dolibarrAddress}/${mod}/note.php?id=${id}`;
+  await page.goto(notePage);
+  if (!page.url().includes("note.php")) {
+    console.error(`objet introuvable — ${notePage} a redirigé vers ${page.url()}`);
+    Deno.exit(1);
+  }
+
+  const before = normalise(await page.locator("body").innerText());
+  if (before.includes(normalise(note).slice(0, 60))) {
+    console.log("note déjà présente à l'identique, rien à faire.");
+    Deno.exit(0);
+  }
+
+  // Le lien d'édition porte le token de session ; on le lit plutôt que de le
+  // cliquer, car il n'est rendu visible qu'au survol.
+  const href = await page.locator('a[href*="action=editnote_public"]').first()
+    .getAttribute("href").catch(() => null);
+  if (!href) {
+    console.error("aucun lien d'édition de note public — droits insuffisants, ou module sans note.");
+    Deno.exit(1);
+  }
+  await page.goto(dolibarrAddress + href);
+
+  const area = page.locator("form textarea").first();
+  if (!(await area.count())) {
+    console.error("pas de zone de saisie sur la page d'édition.");
+    Deno.exit(1);
+  }
+  const existing = normalise(await area.inputValue());
+  if (existing && !force) {
+    console.error(`une note différente existe déjà — refus d'écraser sans --force :\n   ${existing.slice(0, 200)}`);
+    Deno.exit(1);
+  }
+
+  await area.fill(note);
+  await Promise.all([
+    page.waitForNavigation({ waitUntil: "networkidle" }).catch(() => null),
+    page.locator('input[type="submit"]').first().click(),
+  ]);
+
+  const after = normalise(await page.locator("body").innerText());
+  const dup = after.match(/multiple assignments to same column '?"?(\w+)/);
+  if (dup) {
+    console.error(`\nBLOQUÉ — le bug amont touche aussi ce chemin (colonne ${dup[1]}). Voir erp#87.`);
+    Deno.exit(1);
+  }
+  // Relire la page de note plutôt que de croire la page de retour.
+  await page.goto(notePage);
+  const check = normalise(await page.locator("body").innerText());
+  if (!check.includes(normalise(note).slice(0, 60))) {
+    console.error("\nNON ENREGISTRÉE — la note n'apparaît pas après relecture.");
+    Deno.exit(1);
+  }
+  console.log("\nnote enregistrée et relue sur l'objet.");
+} finally {
+  await context.close();
+  await browser.close();
+}