docs/27-les-cles/20-catalogue-cles.md —
ce document se lit aussi dans le dépôt, sans serveur.
Catalogue clés
Où : Gestion → Catalogue clés.
À quoi ça sert
Le catalogue des clés proposées aux professionnels : leur prix pro, et pour chacune ce que le fabricant exige avant d'en tailler une copie.
Deux questions, dans cet ordre
Une fiche ne pose que deux questions, et la seconde dépend de la première.
1. La clé est-elle brevetée ?
Non — il n'y a pas de carte de propriété, donc rien à réclamer. Le numéro de la clé suffit, et l'écran n'affiche rien d'autre.
Oui — la question suivante se pose.
2. Le fabricant impose-t-il la carte ?
C'est le seul véritable embranchement du métier. La carte porte un code unique propre au cylindre, différent de celui de la clé.
| Carte obligatoire | Ce que le pro fournit |
|---|---|
| Non | avec sa carte, la photo de la carte ; sans sa carte, les pièces cochées sur la fiche — identité, domicile, attestation de la marque |
| Oui | la photo de la carte, et rien d'autre. Sans elle la clé ne se fait pas : le cylindre est à changer |
Quand la carte est obligatoire, les trois justificatifs ne s'affichent même pas. Ce n'est pas un oubli : sans le code de la carte, aucune pièce au monde ne permet de tailler la clé. Les réclamer serait faire remplir un dossier pour un refus.
« Brevetée » et « Reproductible sans carte » étaient deux cases séparées. Elles disaient la même chose en sens inverse, et rien n'empêchait de les cocher ensemble avec « Carte obligatoire » — un état que le métier ne connaît pas, et dont plus personne ne savait dire laquelle des trois gouvernait. La seconde a disparu de l'écran le 09/10/2026. Elle reste en base, déduite de « Carte obligatoire » dont elle est l'inverse, et plus aucune décision ne la lit.
L'état du catalogue aujourd'hui
migrations/058_catalogue_cles_carte_non_obligatoire.sql a posé toutes les clés en : brevetée, carte non imposée, et les trois justificatifs exigés à sa place. C'est la règle de la quasi-totalité du catalogue.
Un serrurier peut donc commander n'importe quelle clé sans sa carte, en fournissant pièce d'identité, justificatif de domicile et attestation de la marque. Les exceptions — les clés où le fabricant exige vraiment la carte — se règlent ensuite une par une.
La migration 057 avait posé l'inverse : « carte obligatoire » partout. C'était une erreur de lecture du métier. Ce réglage interdit la commande à qui n'a pas sa carte, et rend les trois justificatifs inatteignables. 058 la corrige, qu'elle ait tourné ou non.
Ce catalogue est appliqué, pas consulté
C'est lui que l'application Pro applique, ligne par ligne, quand un professionnel commande.
Une règle changée ici change immédiatement ce que l'application exige d'un serrurier. Un « brevetée » retiré par mégarde, et la clé se reproduit sur son seul numéro.
C'est la raison pour laquelle l'écriture est réservée aux administrateurs.
Le supplément carte manquante
Quand le professionnel n'a pas la carte, un supplément s'applique. Ce n'est pas un rabais caché dans le prix : c'est une ligne de commande à part entière, sur un produit WooCommerce dédié, visible sur la facture.
Il suit la même règle que le reste : pas de brevet, pas de supplément. Il n'y a pas de carte à manquer sur une clé libre, donc rien à facturer — même si un montant est saisi sur la fiche.
Synchroniser Woo, et le badge « à sync »
Le catalogue est tenu dans Darsy ; les clés existent aussi dans la boutique. Le bouton Synchroniser Woo parcourt toutes les fiches, retrouve chacune dans WooCommerce par son SKU, et en rapporte l'identifiant du produit et le prix public. Il remplit aussi le nom et l'image quand ils sont vides — il n'écrase jamais ce qui a été saisi à la main.
Le badge à sync à côté du SKU dit qu'une fiche n'a pas encore d'identifiant de produit. Il n'y a pas de bouton par fiche : c'est le bouton du haut qui le retire.
Une clé sans identifiant n'est pas bloquée pour autant — la commande la retrouve en direct par son SKU. Mais elle appelle alors la boutique une fois par ligne, et un hoquet de la boutique fait échouer la commande là où un identifiant stocké l'aurait passée sans toucher au réseau.
Le badge revenait à chaque modification. Enregistrer une fiche effaçait les colonnes tenues par la synchronisation, parce que le formulaire ne les envoie pas : le badge réapparaissait après une simple correction de prix. Corrigé le 09/10/2026 dans src/Repository/ProCatalogRepository.php — le formulaire tient les champs métier, la synchronisation tient le rattachement, et aucun des deux n'écrase le travail de l'autre.
Une clé qui est une variation n'est pas retrouvée
La recherche interroge les produits de la boutique. Une clé dont le SKU appartient à une variation n'y figure pas : elle ressort en échec de synchronisation, et son badge reste.
Ce n'est pas corrigé à ce jour. Les clés concernées fonctionnent — par le rattrapage décrit plus haut — mais au prix d'un appel à la boutique par ligne de commande.