Doctrine posée par l'opérateur le 13/08 : si une donnée fautive est déjà en production et sans incidence insurmontable sur l'exercice, on ne force pas la correction — on annote l'objet. Le registre reste append-only et l'écriture n'est pas maquillée. La règle est juste, son canal habituel est fermé ici : sur ce déploiement, AUCUNE écriture sur une charge sociale n'aboutit — ni la date, ni le montant, NI MÊME LA NOTE PUBLIQUE. Toutes passent par le même UPDATE et échouent sur « multiple assignments to same column fk_user_modif » (erp#87). Ce qui fonctionne est un autre chemin : attacher un document, le téléversement n'étant pas un UPDATE sur l'objet. La charge n°1 (URSSAF 1re échéance, 493 EUR) porte désormais deux pièces : l'appel de cotisations officiel, et une note de correction expliquant que le 22/05 est la date du PRÉLÈVEMENT quand l'échéance officielle est le 05/05 — 17 jours de retard, écart resté dans le même mois et le même exercice. annotateObject.ts écrit la note publique d'un objet et REFUSE explicitement quand le bug la bloque. Ce garde-fou vient d'un faux positif qui a bien failli passer : la page de retour de Dolibarr ré-affiche le texte soumis, si bien qu'un contrôle « le texte est là » réussit sur un enregistrement qui n'a jamais eu lieu. J'ai d'abord conclu que le chemin des notes échappait au bug — il ne lui échappe pas. Relire l'objet, jamais la page de retour. Le script reste utile sur les objets non affectés par erp#87. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
ERP
CLI — bin/arcodange
Read-only operational CLI for the Arcodange Dolibarr at erp.arcodange.lab. One entry point, subcommands per domain:
bin/arcodange ping # Dolibarr version + liveness
bin/arcodange whoami # confirm auth as ai_agent
bin/arcodange invoice list # KissMetrics invoices with payment state
bin/arcodange invoice audit 12 # JSON facts + PDF mandatory-mention audit
bin/arcodange payments state # per-invoice TTC vs payments reconciliation
bin/arcodange payments timeline --year 2026 # cash receipts with cumulative balance
bin/arcodange tva summary # CA3-ready collectée − déductible per month
bin/arcodange thirdparty audit-all # completeness audit, country-aware
bin/arcodange templates inspect 1 # recurring template health (frequency, next fire, …)
bin/arcodange snapshot --out /tmp/erp.json # full state dump with content_hash
bin/arcodange help # full command tree
Read-only by design. The underlying API key (ai_agent) has no write permissions; corrections go through the Dolibarr UI.
Credentials. Reads .claude/skills/dolibarr/.env (mode 600, gitignored). Setup instructions: .claude/skills/dolibarr/README.md.
Source of behaviour. Each subcommand delegates to a script under .claude/skills/<skill>/scripts/. The skills' SKILL.md files document the business logic and are also discoverable by Claude Code via skill triggers.
Dolibarr
Premiers démarrages
Si l'application log au démarrage l'erreur suivante:
Importing custom SQL from update_table_ownership.sql ...
sed: couldn't open temporary file /var/www/scripts/before-starting.d/sedwHcRlQ: Read-only file system
Il faudra prendre la main du shell du pod et executer:
kubectl exec -n erp `kubectl get pod -n erp -l app.kubernetes.io/name=erp -o=name` -c erp -- sh -c 'PGPASSWORD=${DOLI_DB_PASSWORD} psql -U ${DOLI_DB_USER} -h ${DOLI_DB_HOST} -p ${DOLI_DB_HOST_PORT} ${DOLI_DB_NAME} \
-f /var/www/scripts/before-starting.d/update_table_ownership.sql'
Sous peine de ne plus avoir les droits de consulter la base de données une fois les crédentials mis à jour par vault. Dans ce cas executer la commande mais avec les credentials d'admin postgres.