Download the PHP package codeheures-fr/scrutineer without Composer
On this page you can find all versions of the php package codeheures-fr/scrutineer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download codeheures-fr/scrutineer
More information about codeheures-fr/scrutineer
Files in codeheures-fr/scrutineer
Package scrutineer
Short Description Scrutineer — in-app manual acceptance testing console. Framework-agnostic, contract-driven (PHP back).
License MIT
Informations about the package scrutineer
Scrutineer — back Symfony
Scrutineer est une librairie bicéphale (back + front, pilotée par contrat) qui ajoute à votre application une console de recette manuelle : préconditions pré-seedées, scénarios joués depuis vos vrais écrans, résultats horodatés et historisés — sans coupler la lib à votre domaine.
Ce dépôt est le back — une implémentation de référence (bundle Symfony, PHP). Le front vit dans un dépôt à part : 👉 scrutineer-front (Web Component, sans build). Les deux se parlent uniquement via le contrat (OpenAPI + JSON Schema), qui vit côté front (scrutineer-front/contract) : le front est le consommateur invariant, ce back n'est qu'un back conforme au contrat (PHP aujourd'hui, un autre langage demain).
Conception & décisions techniques :
docs/technical-decisions.md.
Ce que fournit la lib / ce que vous câblez
| Fournit (la lib) | Vous câblez (l'hôte) |
|---|---|
surface HTTP (catalog / availability / reset / events / history / publish) |
les adaptateurs des ports |
| store d'historique par défaut (Doctrine, surchargeable) | où il vit (.env / config) |
console front <scrutineer-console> servie par le back |
un <script> + 1 appel d'init |
| orchestration reset + gating mode | vos scénarios + vos seeds |
| capture des mails de recette (optionnel) → boîte in-console scopée par poste | activer + recopier 1 header sur le mail |
La lib ne connaît pas votre domaine. Tout le métier vit derrière les ports.
Installation (back)
1. Installer le package
2. Enregistrer et configurer le bundle
3. Monter les routes sous un préfixe
4. Configurer security.yaml
Vos routes de recette (§3) montées, autorisez-les. Celles lues avant authentification (le catalogue sur
/login, la boîte mail pendant un login 2FA) passent en PUBLIC_ACCESS — la barrière reste SCRUTINEER_ENABLED
(403 si off), pas la session ; les mutations exigent un user connecté. access_control est first-match-wins
(règles publiques avant le fourre-tout) :
5. Implémenter les ports
3 requis (ScenarioSeeder, ScrutineerContextProvider, CatalogProvider) + 3 optionnels (ActorResolver,
HistoryStore — un défaut Doctrine existe —, TicketPublisher). Chaque port est une interface documentée dans
src/Port/ (signatures + docblocks) ; liez chaque interface à votre implémentation avec l'attribut
#[AsAlias(<Port>::class)] posé sur la classe (ou, si vous préférez, un alias dans config/services.yaml).
👉 Exemple complet et autonome — un domaine fictif « Acme Books » (en mémoire, données factices), les 6
ports câblés bout à bout + le wiring : example/.
6. Appliquer le schéma du journal
Le seul objet de schéma que la lib ajoute (sans FK, sans PII). Générez la migration dans votre propre
pipeline (elle respecte votre config doctrine_migrations) :
(Capture des mails activée → la même commande émet aussi la table scrutineer_captured_mail.)
7. (Optionnel) Capturer les mails d'un domaine
En recette prod-like (pas de serveur mail), les mails aux personas seedés (2FA, invitation, reset) n'ont pas de
boîte réelle → on les capture dans une boîte in-console (scopée par « poste ») au lieu de les envoyer. Nécessite
symfony/mailer.
1. Activer (config/packages/scrutineer.yaml, sous scrutineer:) :
2. Poser le jeton de poste sur le mail sortant — le seul contrat hôte. La lib lit puis strippe ce header au transport ; à vous de l'y mettre (sync, Messenger, workers… votre ressort) :
La console gagne alors un onglet « Boîte mail » ; le tag sha256(jeton) isole les recetteurs en // sur la même
persona. Routes /poste + /mails à exposer en public (cf. §4).
Le front (dépôt compagnon)
La console est un Web Component servi par ce back (GET <prefix>/console.js). Côté page, chargez le script et
posez l'élément — voir scrutineer-front pour les attributs
(base, lang, active, auth-token) et les cas même-origine / cross-origine.
Licence
MIT.
All versions of scrutineer with dependencies
doctrine/dbal Version ^3.6 || ^4.0
symfony/config Version ^7.1 || ^8.0
symfony/console Version ^7.1 || ^8.0
symfony/dependency-injection Version ^7.1 || ^8.0
symfony/http-foundation Version ^7.1 || ^8.0
symfony/http-kernel Version ^7.1 || ^8.0
symfony/routing Version ^7.1 || ^8.0
symfony/uid Version ^7.1 || ^8.0