Espace développeur

Architecture, modèle de domaine, patterns financiers et conventions de code. Lecture conseillée dans l'ordre pour un nouvel arrivant : les conventions n'ont de sens qu'après avoir vu le domaine et les invariants financiers.

Stack

PHP 8.4 · Symfony 7.2 → 7.4 LTS

Persistence

Doctrine ORM 2.14 (DBAL 3.x, pas 4.x)

DB

MariaDB (prod) · SQLite in-memory (tests)

Front

Twig · Bootstrap 5.2 · Webpack Encore

Tests

PHPUnit 9.5+ (en montée vers 10)

Qualité

PHPStan · PHP-CS-Fixer · GrumPHP

Fondations

1. 01 Architecture Couches, services, flux de requête, dépendances.
2. 02 Bounded contexts 7 contextes métier (Compte, Flux, SSA, SEPA, HelloAsso, PayZen, BOffice) et leurs frontières.
3. 03 Modèle de domaine Entités-clés (Account, Flux, Operation, SepaMandate, SolidoumeParameter), invariants, STI.
4. 04 Schéma BDD 100 entités, relations, clés étrangères, conventions de nommage.
5. 05 Conventions & règles dures Doctrine attributes, libsodium, atomicité financière, Sonata 4.x, JS/CSS hors Twig.

Cœur financier

6. 06 Invariants financiers 22 invariants vérifiés par bin/ai-workflows/financial/check-invariants.php.
7. 07 Cryptographie libsodium uniquement (Ed25519, Curve25519, BLAKE2b), hash chaining des flux.
8. 08 SSA — caisses & redistribution Entités Solidoume*, stratégies, atomicité, commande mensuelle.
9. 09 Webhooks HelloAsso & PayZen Idempotence via helloassoid, validation signature, mapping Flux.

Stack & outillage

10. 10 API Platform 3.x 21 ressources, authentification ApiKeyAuthenticator (header API-AUTH-TOKEN).
11. 11 Sonata Admin 4.x 46 Admin classes, breaking changes 3.x→4.x, mocks & tests d'intégration.
12. 12 Frontend — Twig & Webpack 5 entries Encore, vanilla JS ES2020+, jamais d'inline.
13. 13 Migrations Doctrine Compat MariaDB / SQLite, idempotence, plan up/down réversible.
14. 14 Montée Symfony 7.4 LTS Plan d'upgrade par étapes, fenêtres interdites SEPA/SSA, rollback.

Qualité, tests & gouvernance

15. 15 Tests & qualité PHPUnit ciblé, SQLite in-memory, patterns de mock, TDD, invariants financiers.
16. 16 Workflows IA & agents 41 agents Claude spécialisés, scripts bin/ai-workflows/ (financial, security, sepa).
17. 17 ADR — Décisions d'architecture 27 ADRs (18 acceptés, 5 proposés, 4 superseded), template, carte des références.
18. 18 Doc auto-générée 290 classes documentées (services, entities, repositories, admins, commands) — non éditable.