ADR-050 : Opt-in QR Code `forge-mvc-qrcode`¶

Statut¶

Acceptée

S'inscrit dans ADR-004 (périmètre du core minimal) et ADR-008-bis / ADR-016 (modèle opt-in) : une brique générique mais non essentielle relève d'un paquet optionnel, pas du cœur.

Contexte¶

La génération de QR Codes est un besoin fréquent dans des applications variées : badges, tickets, liens rapides, inventaire matériel, accès à une activité pédagogique, lien vers un QCM, usages futurs avec MFA ou Forge Design.

Cette brique échoue volontairement au test de légitimité d'ADR-004 : « si je retire cette fonction du core, une application Forge basique tourne-t-elle encore ? » → oui.
Le QR Code n'est pas une primitive du framework.
Il ne doit pas entrer dans Forge Core, ni devenir une dépendance obligatoire du cœur.

Décision¶

Créer l'opt-in forge-mvc-qrcode, découplé du core, avec une API minimale et explicite :

QrCode.from_text(text) puis to_png() (octets PNG) et to_svg() (texte SVG) ;
QrCodeResponse.from_text(text, fmt="png"|"svg") qui renvoie une core.http.Response servable depuis un contrôleur ;
QrCodeError pour les entrées invalides (texte vide, format inconnu).

La règle de dépendance est unidirectionnelle :

Forge Core ne sait rien des QR Codes.
forge-mvc-qrcode fournit une API simple.
L'application décide ce qu'elle encode.

Bibliothèque retenue¶

segno : génération de QR Codes en pur Python, sans dépendance (pas de Pillow), écriture PNG et SVG natives, licence BSD, maintenue.
Déclarée uniquement dans le pyproject.toml du paquet, jamais dans le cœur.

Conséquences¶

Le cœur reste autonome : aucun import de forge_mvc_qrcode, segno absent de ses dépendances (verrouillé par un test).
Le paquet suit les conventions opt-in : py.typed, # pyright: strict, smoke test, doc embarquée (ADR-038) agrégée par le plugin monorepo.

Hors périmètre de ce socle¶

Commande CLI forge qrcode:*, stockage dans storage/, génération PDF, scanner de QR Code, logique métier (badge, ticket, inventaire), intégration MFA/TOTP ou Forge Design.
Ces sujets relèvent de tickets ultérieurs.

ADR-050 : Opt-in QR Code forge-mvc-qrcode¶