arcodangeandClaude Opus 5
a11ec634ea
Un exercice OUVERT n'a d'engagement envers personne : aucun compte déposé, aucune liasse, aucun FEC remis. Tant qu'il en va ainsi, une erreur de MODÉLISATION se corrige mieux en rejouant depuis les pièces qu'en la contournant — la piste d'audit fiable demande que l'écriture reflète sa pièce, et rejouer resserre ce lien là où une rustine le distend. extractExercise.ts ne fait que LIRE. Il produit la description ordonnée des faits : tiers, factures client et fournisseur avec leurs lignes et règlements, et l'intégralité des mouvements bancaires. Les mouvements bancaires sont le RÉFÉRENT : Qonto et Wise sont hors de Dolibarr, on ne peut pas les réécrire. Le test d'acceptation d'un rejeu est donc qu'ils soient retrouvés au centime et à la date. La ligne de partage entre ce qui se rejoue et ce qui est figé n'est pas technique mais juridique : est figé tout ce qu'un tiers détient — facture client ENVOYÉE, dépôt au greffe, déclaration transmise — et tout exercice clos. Les factures client sont donc extraites avec delivered:true : un rejeu les reproduit à l'identique, il ne les recalcule pas. Les exclusions sont DÉCLARATIVES ET MOTIVÉES, jamais codées en dur : un auditeur doit lire pourquoi une référence manque sans avoir à le deviner. Deux pièces sont écartées — FAC001-CL00001, dont la référence était malformée par un défaut de masque, et l'avoir qui l'annulait. L'opérateur a établi qu'elle n'a jamais quitté la société : KissMetrics a été facturé via Wise en février, et le document qu'il détient référence FAC001-CL0001001. L'avoir ne documentait donc qu'un faux pas interne. La séquence FAC reste continue (FAC001 à FAC008), la réémission portant elle aussi FAC001 — rien à renuméroter. Deux constats que l'extraction met au jour : - 20 des 37 mouvements bancaires portent un libellé Dolibarr générique (« SupplierInvoicePayment », « CustomerInvoicePayment ») qui traverse le grand livre tel quel et y est illisible pour un repreneur comme pour un inspecteur ; - FAF2025001 (OVH, 7,30 EUR) est datée du 24/10/2025, trois mois avant l'immatriculation, et NE FIGURE PAS à l'annexe 1 des statuts qui recense les actes accomplis pour le compte de la société en formation. Une dépense antérieure à l'existence de la société ne peut être supportée par elle que si elle est reprise par cet état ou ratifiée ensuite. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
fleet/profile/ — fiscal profile, compliance calendar, ADC register
The machine-readable business-rules surface the fleet reads (T10 TVA preparation, T03 VAT ventilation, T11 calendar & reminders): prompts stay thin and rule-free (fleet/README.md); the rules live here, dated and justified. Shipped by erp#54 per the PRD document surface and ADC framework.
Layout
| File | Role |
|---|---|
fiscal.yaml |
fiscal profile: entity, VAT position, rules — regime, VAT treatments, bookkeeping methods |
fiscal.schema.json |
JSON Schema for fiscal.yaml |
calendar.yaml |
compliance calendar: dated obligations the T11 reminder loop (erp#60) reads |
calendar.schema.json |
JSON Schema for calendar.yaml |
scripts/validate.py |
stdlib-only validator: schema + referential integrity (rule → ADC) |
decisions/ |
the ADC register (accounting decision records): adc-template.md + adc-NNN-<slug>.md |
The rule contract
Every fiscal.yaml rule carries:
effective_from/effective_until— dated validity (nulluntil = in force until superseded);decision: adc-NNN— the record indecisions/that justifies it.
So the chain écriture → règle → ADC → base légale resolves in four hops,
identically every time (PRD compliance § ADC rule 2, challenge C6). Dates in
both YAML files cite their source anchor as an inline comment (PRD <leaf> § <anchor>, verified against factory origin/main).
The ADC register (decisions/)
MADR-lite + accounting fields — see adc-template.md.
Frontmatter is machine-parsed (id, status, decided, effective dates,
supersedes/superseded_by); the body carries Context (fait générateur),
Decision, Base légale & doctrine, Alternatives rejected, Consequences,
QA & validation, References.
Status flow: Proposed → Accepted → Superseded-by-NNN, with four rules (PRD compliance § ADC):
- Immutable once Accepted (merged on main) — supersede, never edit (permanence des méthodes, PCG art. 121-5).
- Every fiscal.yaml rule cites its ADC — enforced by
scripts/validate.py, which also refuses a rule citing a non-Accepted record. - The annexe writes itself at close from the records Accepted and in force during the exercice.
- Proposed ADCs are the expert-comptable agenda. Agents draft, the operator Accepts — never the reverse.
Seed state: adc-001…005 are Accepted as formalizations of decisions the operator already made in practice (their sanity read is the erp#54 human gate — pre-merge amendments are draft edits, not supersedes); adc-006/adc-007 are Proposed stubs (retainer currency → erp#53; capital path → erp#51).
Validation
python3 fleet/profile/scripts/validate.py
Stdlib-only (no PyYAML, no jsonschema — runs anywhere, CI-able). It checks:
both YAML files against their schemas; every rule's decision resolves to
exactly one existing, Accepted ADC; unique ids; effective_from <= effective_until; calendar entries carry exactly one of due|recurrence
(unless pending-definition/conditional); ADC frontmatter/section hygiene.
Exit 0 = pass; warnings list what awaits operator verification
(month-precision dates, estimated entries).
To stay parseable, both YAML files are written in a strict subset: block
maps/lists, single-line scalars, one-line [flow] lists of scalars,
comments — no anchors, no multi-line scalars, no nested flow.
Calendar date precision: YYYY-MM-DD = exact; YYYY-MM = month window — the
source gives no day; verify on the authority's notice, never invent one.
Mutation policy
Changes arrive as PRs only — the T12 regulatory watch proposes a diff (what changed, source links, effective dates); a human reviews and merges (PRD task-inventory § T11 guardrail: "the calendar file is reviewed like code"; § T12: "the watch proposes, the human adopts"). Calendar entries sourced from mail content are human-confirmed (mail is untrusted input). No agent edits these files directly. A rule change moves its ADC in the same PR (supersede, never edit), and a schema change moves the validator with it — the repo-wide same-change freshness rule.
Facts not corroborated by the PRD
Flagged here honestly (and inline where used) — the PRD wins on conflict; these await operator/expert verification:
- SIREN 999657455 — from erp#54 + agent memory
arcodange-tva-fiscal; no PRD leaf states it. - Exact incorporation day — PRD says "mid-January 2026" only; rules use a
conservative
2026-01-01exercice-start bound. - July 2026 acompte exact day — PRD gives the month only (T10 trigger).
- CFE exact day + creation-year exoneration / initial 1447-C declaration — PRD says "December" only; the rest is to verify with the SIE.
- CA3 July/October/January windows — only the April window is PRD-anchored (roadmap, 2027-04-20); the others come from the erp#54 issue text.
- TVA credit amount (~223–267 EUR) — ERP reads (skill + memory); the PRD only says "in TVA credit — verify, don't assume".
- URSSAF échéancier cadence/nature — one known debit (2026-05-22, 493.00 EUR, erp#57); the PRD's "payroll dormant" assumption is under revisit in erp#57.
- BOI-BIC-CHG-20-30-10 tolerance cite (adc-003) and CCA formalities (adc-005) — general doctrine, queued for the expert-comptable.