[ERP-75] Versionner symfony.lock (#36)
Auto Tag Develop / tag (push) Successful in 7s

## Problème

`symfony.lock` (registre des recipes Flex appliquées) n'était ni tracké, ni présent. Conséquence : chaque `composer require` rejouait **toutes** les recipes → pollution répétée de `.env`, `config/bundles.php`, `docker-compose.yml` et recréation de scaffolding parasite (`src/Entity/`, `src/Controller/`, `src/Repository/`...). `composer recipes` listait toutes les recipes en `recipe not installed`.

## Fix

- Génération de `symfony.lock` via `composer recipes:install --force` (20 recipes enregistrées avec leurs refs).
- Aucune pollution embarquée : seuls `symfony.lock` (nouveau) et une ligne de doc dans `CLAUDE.md` (règle n°14) sont committés. `composer.json`/`composer.lock` inchangés.
- Doc : `symfony.lock` est désormais documenté comme versionné (ne jamais le `.gitignore`).

## Validation

- `composer recipes` liste désormais toutes les recipes comme **installées** (plus aucun `not installed`).
- Test témoin : `composer require --dev fakerphp/faker` ne touche QUE `composer.json`/`composer.lock` (+ le paquet), **zéro re-scaffolding global**. Test annulé ensuite (état restauré à l'identique).
- Pre-commit : eslint + 322 tests PHPUnit OK.

> Reviewer souhaité : Tristan · merge en squash.

---------

Co-authored-by: Matthieu <contact@malio.fr>
Reviewed-on: #36
Co-authored-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr>
Co-committed-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr>
This commit was merged in pull request #36.
This commit is contained in:
2026-06-01 12:47:23 +00:00
committed by admin malio
parent a25ddac466
commit ddf874a4e1
2 changed files with 257 additions and 0 deletions
+1
View File
@@ -26,6 +26,7 @@ Doc humaine : @README.md — Spec audit : @doc/audit-log.md
11. **Migrations d'initialisation au namespace racine** `DoctrineMigrations` dans `migrations/` (setup user, RBAC, seed de base). Les migrations modulaires (`src/Module/*/Infrastructure/Doctrine/Migrations/`) sont reservees aux evolutions post-schema (ajout de colonnes, index) — cf. @.claude/rules/architecture.md pour la raison.
12. **Toujours documenter chaque colonne BDD via `COMMENT ON COLUMN`** dans la migration qui la cree ou la modifie. Description en francais, courte (≤ 200 caracteres), explique la semantique metier + contraintes implicites (unicite partielle, FK importante, lien RG). Garde-fou : `tests/Architecture/ColumnsHaveSqlCommentTest` echoue si une colonne `public` n'a pas de description (`col_description IS NULL`). Details et exemples : @.claude/rules/backend.md § Migrations Doctrine.
13. **Toujours paginer toute collection exposee par l'API.** Aucun retour de collection complete (pas de provider qui retourne un array brut). Standard pose dans `config/packages/api_platform.yaml` : 10 items par defaut, max 50, le client peut basculer entre 10/25/50 et peut envoyer `?pagination=false` pour alimenter un select. Garde-fou : `tests/Architecture/CollectionsArePaginatedTest` echoue si une `GetCollection` desactive la pagination sans whitelist. Details et exemples : @.claude/rules/backend.md § Pagination.
14. **`symfony.lock` est versionne** (au meme titre que `composer.lock`) — ne JAMAIS le `.gitignore`. C'est le registre des recipes Flex appliquees : sans lui, chaque `composer require` rejoue toutes les recipes et repollue `.env`, `config/bundles.php`, `docker-compose.yml` et recree du scaffolding parasite (`src/Entity/`, `src/Controller/`...). Le regenerer si besoin via `composer recipes:install --force`.
## Conventions
@.claude/rules/architecture.md