Variables de génération

Un template ne connaît pas votre projet. Les variables de génération sont le pont : le template déclare les variables dont il a besoin, et vous en renseignez la valeur dans Restorm. À la génération, chaque valeur est évaluée puis injectée dans le contexte du template.

Variable ou flag natif ?

N’utilisez une variable que pour ce que le design ne porte pas déjà. Les intentions que vous avez saisies dans le design (searchable, PII, volumétrie, profil d’accès, trafic, fraîcheur, sensibilité, rétention, cache, authentification…) sont directement lisibles dans le template via ctx — inutile de les redéclarer. Voir Le contexte du template. Les variables servent aux réglages propres au template : nom de package, namespace, version du framework, générer un Dockerfile ou non, etc.

Déclarer et renseigner

Chaque variable est déclarée par le template (dans son restorm-template.json) avec un nom, une portée, un type, une valeur par défaut et une description facultative. Côté Restorm, vous renseignez sa valeur sous forme d’expression Handlebars — évaluée pour chaque entité concernée, puis convertie vers le type déclaré.

Les types possibles sont string, boolean, number et enum (avec sa liste d’options).

Une action Découvrir les variables utilisées par ce template analyse le template et signale les variables utilisées mais non déclarées, pour éviter les oublis.

Les portées

La portée décide à quel niveau la variable est évaluée et où elle atterrit dans le contexte du template :

Portée	Évaluée	Disponible dans le template
Projet	une fois	ctx.design.vars.<nom>
Modèle	par modèle	ctx.models[].vars.<nom>
Propriété	par propriété	ctx.models[].properties[].vars.<nom>
Route	par route	ctx.groups[].routes[].vars.<nom>

Valeur générale et surcharge

Pour chaque template, vous définissez des valeurs générales par portée (les « variables générales », qui s’appliquent par exemple à tous les modèles). Vous pouvez ensuite surcharger une variable pour un modèle, une propriété ou une route donnés, depuis l’onglet Code generation de cette entité. Une valeur vide signifie « hériter » : la première valeur non vide l’emporte, et toute valeur non résolue remonte comme une erreur — jamais en silence.