Skip to content

Comptabilité : boîte à justificatifs pour les reçus sans écriture - #99

Merged
flocom merged 1 commit into
mainfrom
claude/boite-justificatifs
Oct 13, 2026
Merged

flocom merged 1 commit into
mainfrom
claude/boite-justificatifs

Conversation

@flocom

@flocom flocom commented Oct 13, 2026

Copy link
Copy Markdown
Owner

Pourquoi

Un reçu arrive souvent avant l'écriture qu'il justifie (dépense qui passera sur le relevé du mois, saisie différée). Il n'y avait nulle part où le déposer en attendant : il fallait le garder ailleurs, puis le retrouver au moment de saisir.

Ce que ça fait

  • Onglet « Justificatifs » dans Comptabilité : dépôt par glisser-déposer ou sélection (PDF, JPG, PNG, WebP ; jusqu'à 20 à la fois, chacun sous UPLOAD_MAX_BYTES), aperçu, montant / date / description facultatifs, suppression.
  • Association depuis le reçu (écritures sans justificatif, les plus proches d'abord — même montant, date voisine, mots communs — marquées « Correspond ») ou depuis l'écriture (« Associer un reçu », desktop et mobile). Le reçu devient attachmentUrl et quitte la boîte.
  • Règles : jamais de remplacement d'un justificatif existant (409) ; une écriture validée peut recevoir celui qui lui manque, sans toucher à son updatedAt (date de validation du FEC).
  • Pas de perte : un brouillon justifié supprimé, dont l'import est annulé ou qui est rattaché à une écriture existante rend son justificatif — transféré à l'écriture cible si elle n'en a pas, sinon remis dans la boîte (libellé, montant, date du brouillon).
  • Bandeau « N reçus attendent leur écriture » dans l'onglet Écritures ; pendingReceiptCount dans la synthèse ; outils MCP list_accounting_receipts et attach_accounting_receipt.
  • Audit : accounting.receipt.create|update|delete|attach|restore (seuls les champs réellement modifiés, avec avant/après).

Technique

  • Table accounting_receipts — migration 0040_boite_justificatifs (drizzle-kit generate).
  • src/lib/accounting/receipts.ts (pur : types, classement), src/lib/services/accounting-receipts.ts, routes /api/accounting/receipts (GET, POST multipart, PATCH, DELETE, /[id]/attach), admin uniquement.
  • src/middleware.ts : multipart accepté à l'adresse exacte du dépôt (origine prouvée comme pour /api/uploads) ; PATCH/DELETE/attach restent en JSON.
  • next.config.mjs : experimental.middlewareClientMaxBodySize: "25mb" — Next tronquait à 10 Mo tout corps passant par le middleware, ce qui faisait échouer en 500 les reçus (et /api/uploads) de 10 à 15 Mo.
  • uploads-references.ts : les reçus en attente sont dans la liste témoin du nettoyage des orphelins.

Vérifications

Sur une base Postgres locale avec toutes les migrations et l'app lancée :

  • dépôt multipart OK ; faux PDF → 415 ; CSV → 415 ; requête sans origine → 403 ; sans session → 401 ; reçu de 12 Mo → 201
  • modification + 409 sur version périmée ; association à une écriture validée → OK et updated_at inchangé ; 2e reçu sur la même écriture → 409 ; reçu disparu → 404
  • suppression d'un reçu → fichier effacé du disque ; justificatif associé toujours lisible
  • suppression d'un brouillon justifié → le reçu revient dans la boîte avec libellé, montant et date
  • dans le navigateur (mobile) : dépôt affiché, édition du montant et de la date, « Correspond » sur la bonne écriture, association dans les deux sens, bandeau singulier/pluriel, aucune erreur console
  • tsc --noEmit, eslint, relecture indépendante (concurrence, verrous, CSRF, purge des orphelins, migration)
  • non testé en réel : le transfert du justificatif lors d'un rattachement d'opération importée (vérifié à la lecture et au typage)

🤖 Generated with Claude Code

Un ticket de caisse arrive souvent avant l'écriture qu'il justifie : la
dépense passera sur le relevé du mois, importé plus tard, ou sera saisie
quand le trésorier aura le temps. Un nouvel onglet « Justificatifs »
accueille ces reçus (PDF ou photo, glisser-déposer, plusieurs à la fois),
avec un montant, une date et une description facultatifs qui aident à
retrouver l'écriture.

Le reçu s'associe ensuite à son écriture, saisie à la main ou importée,
depuis la boîte (les écritures du même montant et d'une date voisine
d'abord, marquées « Correspond ») ou depuis la liste des écritures
(« Associer un reçu »). Il devient alors son justificatif et quitte la
boîte. Une écriture qui a déjà un justificatif est refusée ; une écriture
validée peut recevoir celui qui lui manque, sans que sa date de
validation, reprise dans le FEC, ne bouge.

Un brouillon justifié qui disparaît (suppression, annulation d'import,
rattachement à une écriture déjà saisie) ne perd plus son justificatif :
il suit l'opération vers l'écriture choisie si elle n'en a pas, sinon il
revient dans la boîte. Les reçus en attente sont protégés du nettoyage
des orphelins ; chaque dépôt, modification, association et suppression
est consigné au journal.

Table accounting_receipts (migration 0040), routes
/api/accounting/receipts, outils MCP list_accounting_receipts et
attach_accounting_receipt. Le middleware accepte le multipart à l'adresse
exacte du dépôt, et Next ne tronque plus à 10 Mo le corps des requêtes
(middlewareClientMaxBodySize), ce qui faisait échouer les envois de 10 à
15 Mo.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@flocom
flocom merged commit e8e5f9e into main Oct 13, 2026
2 checks passed
@flocom
flocom deleted the claude/boite-justificatifs branch October 13, 2026 08:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant