docs : refonte du README (dev local seed/no-seed, seed recette/prod, BDD de test) #56

Merged
malio merged 3 commits from docs/refonte-readme into develop 2026-06-03 13:56:06 +00:00
Owner

Contexte

Le README de develop ne distinguait pas clairement les parcours de dev avec/sans données de seed, ni la base de test dédiée. Refonte pour une doc projet complète et fidèle au makefile actuel.

Contenu

  • Dev local avec / sans données de seed : make install (base vierge — schéma + RBAC structurel, aucun compte) vs make db-reset / make fixtures (comptes + données de démo). Explicite le piège : install ne charge pas les fixtures sur la base dev.
  • Création de compte sans seed : app:create-user … --admin.
  • Bases de données dev vs test : base _test dédiée et isolée (suffixe auto en APP_ENV=test), rôle détaillé de make test-db-setup (migrations, schema:update, column-comments, fixtures→sync→seed-rbac, index partiels uniques).
  • Tests : 3 suites (PHPUnit / Vitest / Playwright), prérequis et workflow E2E, règle d'or.
  • Seed RBAC recette / prod : app:seed-rbac (+ --with-demo-users --password), idempotent et non destructif, ordre de release.
  • Tableau des commandes make, sommaire, prérequis, correction du nom (Starseed) et des ports.

Changement docs uniquement, aucun code touché.

## Contexte Le README de `develop` ne distinguait pas clairement les parcours de dev avec/sans données de seed, ni la base de test dédiée. Refonte pour une doc projet complète et fidèle au `makefile` actuel. ## Contenu - **Dev local avec / sans données de seed** : `make install` (base vierge — schéma + RBAC structurel, aucun compte) vs `make db-reset` / `make fixtures` (comptes + données de démo). Explicite le piège : `install` ne charge pas les fixtures sur la base dev. - **Création de compte sans seed** : `app:create-user … --admin`. - **Bases de données dev vs test** : base `_test` dédiée et isolée (suffixe auto en `APP_ENV=test`), rôle détaillé de `make test-db-setup` (migrations, schema:update, column-comments, fixtures→sync→seed-rbac, index partiels uniques). - **Tests** : 3 suites (PHPUnit / Vitest / Playwright), prérequis et workflow E2E, règle d'or. - **Seed RBAC recette / prod** : `app:seed-rbac` (+ `--with-demo-users --password`), idempotent et non destructif, ordre de release. - Tableau des commandes `make`, sommaire, prérequis, correction du nom (Starseed) et des ports. Changement **docs uniquement**, aucun code touché.
matthieu added 1 commit 2026-06-03 13:47:53 +00:00
docs : refonte du README (dev local seed/no-seed, seed recette/prod, BDD de test)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Has been cancelled
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
27d6207e53
matthieu added the type/docs label 2026-06-03 13:48:18 +00:00
malio added 1 commit 2026-06-03 13:52:36 +00:00
Merge branch 'develop' into docs/refonte-readme
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 2m5s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Has been cancelled
721140f64c
malio added 1 commit 2026-06-03 13:55:07 +00:00
Merge branch 'develop' into docs/refonte-readme
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 1m47s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m17s
53ed9187a9
malio merged commit a72a5dd812 into develop 2026-06-03 13:56:06 +00:00
malio deleted branch docs/refonte-readme 2026-06-03 13:56:06 +00:00
Sign in to join this conversation.