# romainsimon/paperasse architecture

> Architecture diagram of the GitHub repository romainsimon/paperasse, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/romainsimon/paperasse
- Repository: https://github.com/romainsimon/paperasse

## Overview

Paperasse is a toolkit of Markdown skills that turns a compatible AI agent into a specialist for French administrative and financial work. The principal documented business workflow runs from ongoing bookkeeping through year-end closing, audit, and tax-control simulation. Separate skills cover personal taxation, notarial matters, and condominium management. Shared scripts generate accounting outputs and compliant invoices, while Qonto and Stripe connectors fetch financial data. The graph reflects documented workflows and sampled code; unsampled skill internals are represented by their exact SKILL.md paths, without assuming links between them.

Main entry points: [`comptable/SKILL.md`](https://github.com/romainsimon/paperasse/blob/master/comptable/SKILL.md) (Accountant skill), [`commissaire-aux-comptes/SKILL.md`](https://github.com/romainsimon/paperasse/blob/master/commissaire-aux-comptes/SKILL.md) (Audit skill), [`controleur-fiscal/SKILL.md`](https://github.com/romainsimon/paperasse/blob/master/controleur-fiscal/SKILL.md) (Tax-control skill), [`integrations/qonto/fetch.js`](https://github.com/romainsimon/paperasse/blob/master/integrations/qonto/fetch.js) (Qonto connector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_business["Business accounting"]
  node_comptable["Accountant skill<br/>[SKILL.md]"]
  node_cac["Audit skill<br/>[SKILL.md]"]
  node_controle["Tax-control skill<br/>[SKILL.md]"]
  node_journal[("Journal entries")]
  node_calc["Accounting calculations<br/>[calc.js]"]
  node_statements["Financial statements"]
  node_fec["FEC export<br/>[generate-fec.js]"]
  node_pdfs["PDF generation<br/>[generate-pdfs.js]"]
  node_billing_skill["Billing expertise<br/>[SKILL.md]"]
end

subgraph group_billing["Billing tools"]
  node_facturx["Factur-X generation"]
  node_invoice_validation["Invoice validation"]
  node_stripe_import["Stripe invoice import"]
  node_qonto["Qonto connector<br/>[fetch.js]"]
  node_stripe["Stripe connector<br/>[fetch.js]"]
end

subgraph group_personal["Personal and legal"]
  node_fiscaliste["Personal tax skill<br/>[SKILL.md]"]
  node_ir_calc["Income tax calculator<br/>[calc_ir.py]"]
  node_notaire["Notary skill<br/>[SKILL.md]"]
  node_notary_data["Notary open-data fetcher"]
end

subgraph group_property["Property management"]
  node_syndic["Condominium skill<br/>[SKILL.md]"]
end

node_agent(("AI agent"))
node_bank_service["Qonto service"]
node_payment_service["Stripe service"]

node_agent -->|"uses skill"| node_comptable
node_agent -->|"uses skill"| node_cac
node_agent -->|"uses skill"| node_controle
node_agent -->|"uses skill"| node_fiscaliste
node_agent -->|"uses skill"| node_notaire
node_agent -->|"uses skill"| node_syndic
node_comptable -->|"then audits"| node_cac
node_cac -->|"then simulates control"| node_controle
node_comptable -->|"uses calculations"| node_calc
node_comptable -->|"generates statements"| node_statements
node_comptable -->|"generates FEC"| node_fec
node_comptable -->|"generates PDFs"| node_pdfs
node_comptable -->|"generates invoices"| node_facturx
node_comptable -->|"validates invoices"| node_invoice_validation
node_qonto -->|"fetches transactions"| node_bank_service
node_stripe -->|"fetches payments"| node_payment_service
node_agent -->|"calculates income tax"| node_ir_calc
node_agent -->|"fetches open data"| node_notary_data

click node_comptable "https://github.com/romainsimon/paperasse/blob/master/comptable/SKILL.md"
click node_cac "https://github.com/romainsimon/paperasse/blob/master/commissaire-aux-comptes/SKILL.md"
click node_controle "https://github.com/romainsimon/paperasse/blob/master/controleur-fiscal/SKILL.md"
click node_journal "https://github.com/romainsimon/paperasse/blob/master/data/journal-entries.json"
click node_calc "https://github.com/romainsimon/paperasse/blob/master/scripts/calc.js"
click node_statements "https://github.com/romainsimon/paperasse/blob/master/scripts/generate-statements.js"
click node_fec "https://github.com/romainsimon/paperasse/blob/master/scripts/generate-fec.js"
click node_pdfs "https://github.com/romainsimon/paperasse/blob/master/scripts/generate-pdfs.js"
click node_billing_skill "https://github.com/romainsimon/paperasse/blob/master/comptable/SKILL.md"
click node_facturx "https://github.com/romainsimon/paperasse/blob/master/scripts/generate-facturx.js"
click node_invoice_validation "https://github.com/romainsimon/paperasse/blob/master/scripts/validate-facture.js"
click node_stripe_import "https://github.com/romainsimon/paperasse/blob/master/scripts/import-stripe-invoices.js"
click node_qonto "https://github.com/romainsimon/paperasse/blob/master/integrations/qonto/fetch.js"
click node_stripe "https://github.com/romainsimon/paperasse/blob/master/integrations/stripe/fetch.js"
click node_fiscaliste "https://github.com/romainsimon/paperasse/blob/master/fiscaliste/SKILL.md"
click node_ir_calc "https://github.com/romainsimon/paperasse/blob/master/fiscaliste/scripts/calc_ir.py"
click node_notaire "https://github.com/romainsimon/paperasse/blob/master/notaire/SKILL.md"
click node_notary_data "https://github.com/romainsimon/paperasse/blob/master/scripts/fetch_notaire_data.py"
click node_syndic "https://github.com/romainsimon/paperasse/blob/master/syndic/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_comptable,node_cac,node_controle,node_journal,node_calc,node_statements,node_fec,node_pdfs,node_billing_skill toneBlue
class node_facturx,node_invoice_validation,node_stripe_import,node_qonto,node_stripe toneAmber
class node_fiscaliste,node_ir_calc,node_notaire,node_notary_data toneMint
class node_syndic toneRose
class node_agent,node_bank_service,node_payment_service toneIndigo
```

## Components

### Business accounting

- [Accountant skill](https://github.com/romainsimon/paperasse/blob/master/comptable/SKILL.md): `comptable/SKILL.md`
- [Audit skill](https://github.com/romainsimon/paperasse/blob/master/commissaire-aux-comptes/SKILL.md): `commissaire-aux-comptes/SKILL.md`
- [Tax-control skill](https://github.com/romainsimon/paperasse/blob/master/controleur-fiscal/SKILL.md): `controleur-fiscal/SKILL.md`
- [Journal entries](https://github.com/romainsimon/paperasse/blob/master/data/journal-entries.json): `data/journal-entries.json`
- [Accounting calculations](https://github.com/romainsimon/paperasse/blob/master/scripts/calc.js): `scripts/calc.js`
- [Financial statements](https://github.com/romainsimon/paperasse/blob/master/scripts/generate-statements.js): `scripts/generate-statements.js`
- [FEC export](https://github.com/romainsimon/paperasse/blob/master/scripts/generate-fec.js): `scripts/generate-fec.js`
- [PDF generation](https://github.com/romainsimon/paperasse/blob/master/scripts/generate-pdfs.js): `scripts/generate-pdfs.js`
- [Billing expertise](https://github.com/romainsimon/paperasse/blob/master/comptable/SKILL.md): `comptable/SKILL.md`

### Billing tools

- [Factur-X generation](https://github.com/romainsimon/paperasse/blob/master/scripts/generate-facturx.js): `scripts/generate-facturx.js`
- [Invoice validation](https://github.com/romainsimon/paperasse/blob/master/scripts/validate-facture.js): `scripts/validate-facture.js`
- [Stripe invoice import](https://github.com/romainsimon/paperasse/blob/master/scripts/import-stripe-invoices.js): `scripts/import-stripe-invoices.js`
- [Qonto connector](https://github.com/romainsimon/paperasse/blob/master/integrations/qonto/fetch.js): `integrations/qonto/fetch.js`
- [Stripe connector](https://github.com/romainsimon/paperasse/blob/master/integrations/stripe/fetch.js): `integrations/stripe/fetch.js`

### Personal and legal

- [Personal tax skill](https://github.com/romainsimon/paperasse/blob/master/fiscaliste/SKILL.md): `fiscaliste/SKILL.md`
- [Income tax calculator](https://github.com/romainsimon/paperasse/blob/master/fiscaliste/scripts/calc_ir.py): `fiscaliste/scripts/calc_ir.py`
- [Notary skill](https://github.com/romainsimon/paperasse/blob/master/notaire/SKILL.md): `notaire/SKILL.md`
- [Notary open-data fetcher](https://github.com/romainsimon/paperasse/blob/master/scripts/fetch_notaire_data.py): `scripts/fetch_notaire_data.py`

### Property management

- [Condominium skill](https://github.com/romainsimon/paperasse/blob/master/syndic/SKILL.md): `syndic/SKILL.md`

### Other components

- **AI agent**
- **Qonto service**
- **Stripe service**

## Connections

- AI agent → Accountant skill: uses skill (evidence: `README.md`)
- AI agent → Audit skill: uses skill (evidence: `README.md`)
- AI agent → Tax-control skill: uses skill (evidence: `README.md`)
- AI agent → Personal tax skill: uses skill (evidence: `README.md`)
- AI agent → Notary skill: uses skill (evidence: `README.md`)
- AI agent → Condominium skill: uses skill (evidence: `README.md`)
- Accountant skill → Audit skill: then audits (evidence: `README.md`)
- Audit skill → Tax-control skill: then simulates control (evidence: `README.md`)
- Accountant skill → Accounting calculations: uses calculations (evidence: `README.md`)
- Accountant skill → Financial statements: generates statements (evidence: `README.md`)
- Accountant skill → FEC export: generates FEC (evidence: `README.md`)
- Accountant skill → PDF generation: generates PDFs (evidence: `README.md`)
- Accountant skill → Factur-X generation: generates invoices (evidence: `README.md`)
- Accountant skill → Invoice validation: validates invoices (evidence: `README.md`)
- Qonto connector → Qonto service: fetches transactions (evidence: `integrations/qonto/fetch.js`)
- Stripe connector → Stripe service: fetches payments (evidence: `integrations/stripe/fetch.js`)
- AI agent → Income tax calculator: calculates income tax (evidence: `fiscaliste/scripts/calc_ir.py`)
- AI agent → Notary open-data fetcher: fetches open data (evidence: `scripts/fetch_notaire_data.py`)
