# Nommer le reste

CSS, scripts, variables d'environnement, branches, commits, modules, plugins et portes.


Les statuts de chaque règle sont expliqués dans « Nommer les choses ».

:::note[En bref]
- **NOM-AUTRE-01** · [Nommez une classe ou une variable CSS en kebab-case, par son rôle](#nom-autre-01--nommez-une-classe-ou-une-variable-css-en-kebab-case-par-son-rôle)
- **NOM-AUTRE-02** · [Nommez un script par un verbe, dans la casse de son langage](#nom-autre-02--nommez-un-script-par-un-verbe-dans-la-casse-de-son-langage)
- **NOM-AUTRE-03** · [Préfixez une variable d'environnement du nom du projet](#nom-autre-03--préfixez-une-variable-denvironnement-du-nom-du-projet)
- **NOM-AUTRE-04** · [Nommez une branche par son sujet, en kebab-case](#nom-autre-04--nommez-une-branche-par-son-sujet-en-kebab-case)
- **NOM-AUTRE-05** · [Écrivez un commit `type(domaine): ce que ça fait`](#nom-autre-05--écrivez-un-commit-typedomaine-ce-que-ça-fait)
- **NOM-AUTRE-06** · [Nommez un module par le code de la table `module`](#nom-autre-06--nommez-un-module-par-le-code-de-la-table-module)
- **NOM-AUTRE-07** · [Nommez un plugin par son nom, hors du dépôt du produit](#nom-autre-07--nommez-un-plugin-par-son-nom-hors-du-dépôt-du-produit)
- **NOM-AUTRE-08** · [Versionnez une porte et nommez ses emplacements en minuscules à tirets](#nom-autre-08--versionnez-une-porte-et-nommez-ses-emplacements-en-minuscules-à-tirets)
:::

## Le style

### NOM-AUTRE-01 · Nommez une classe ou une variable CSS en kebab-case, par son rôle

:::tip[Règle]
Jamais par son apparence. Une couleur se déclare une seule fois dans la feuille des fondations. Un code qui vient tel quel de la base garde son `snake_case`.
:::

<div class="avant-apres">

```css title="À éviter"
.bleu-gras { color: #3566e8; }
.mt-3-custom { margin-top: 13px; }
```

```css title="À faire"
.tete-de-fiche { color: var(--bleu); }
.bandeau { margin-top: var(--espace-3); }
```

</div>

<span class="puce usage">Usage constaté</span> Le dépôt la suit presque partout ; aucun document ne la décide encore.

<span class="puce adecider">À décider</span> Quelques variables sont en anglais (`--muted`, `--surface`) dans une famille française : n'en créez pas de nouvelle.

**Voir aussi.** [L'échelle fermée](/regles/interface/)

## Les outils

### NOM-AUTRE-02 · Nommez un script par un verbe, dans la casse de son langage

:::tip[Règle]
Node et shell : `kebab-case`. Python : `snake_case`. Un script se nomme par un verbe à l'infinitif ou par ce qu'il traite. Ne mélangez pas deux casses dans un dossier ; un script réservé à un autre commence par un souligné.
:::

| À éviter | À faire |
| --- | --- |
| `VerifierRoutes.mjs`, `verifier_les_routes.mjs` | `verifier-les-routes.mjs` |
| `CorrectionsConnues.py` | `corrections_connues.py` |

<span class="puce adecider">À décider</span> Un dossier mélange aujourd'hui les deux casses pour Python.

### NOM-AUTRE-03 · Préfixez une variable d'environnement du nom du projet

:::tip[Règle]
Une variable propre au projet porte son préfixe. Ce que le navigateur doit lire s'écrit `NEXT_PUBLIC_…`. Le secret d'un fournisseur prend le nom du fournisseur. Un secret n'est jamais en `NEXT_PUBLIC_`.
:::

| À éviter | À faire |
| --- | --- |
| `BASE`, `SORTIE` | Le préfixe du projet devant le nom |
| `NEXT_PUBLIC_SERVICE_KEY` | `ANTHROPIC_API_KEY`, jamais exposée au navigateur |

<span class="puce usage">Usage constaté</span> Le dépôt la suit presque partout ; aucun document ne la décide encore.

**Exception.** Un fichier d'exemple liste tous les noms, sans valeur.

## Le travail avec git

### NOM-AUTRE-04 · Nommez une branche par son sujet, en kebab-case

:::tip[Règle]
Une branche de chantier a un nom court qui dit le sujet. `main` est la production. Une branche pour un chantier, jamais pour un correctif.
:::

| À éviter | À faire |
| --- | --- |
| `ma-branche`, `test2`, `fix` | `heures-supplementaires` |
| Une branche pour un correctif d'une ligne | Un commit sur `main` |

<span class="puce adecider">À décider</span> Aucun texte ne fixe la forme du nom d'une branche.

### NOM-AUTRE-05 · Écrivez un commit `type(domaine): ce que ça fait`

:::tip[Règle]
Une première ligne au présent, une ligne vide, puis le pourquoi. Types : `fix`, `feat`, `perf`, `refactor`, `style`, `docs`, `test`, `chore`.
:::

| À éviter | À faire |
| --- | --- |
| `fix: bug`, `updates`, `wip` | `fix(facturation): ne plus compter deux fois une facture partagée` |
| Un domaine inventé à chaque commit | Le domaine en un mot : `planning`, `base`, `ecrans` |

<span class="puce ecrite">Règle écrite</span> Écrite dans le guide de contribution ; un crochet vérifie la forme du message.

## Les modules, plugins et portes

### NOM-AUTRE-06 · Nommez un module par le code de la table `module`

:::tip[Règle]
Minuscules, sans accent. Son dossier est `modules/<code>/`, avec une fiche d'identité `module.ts` qui exporte une constante du même nom. Le cœur ne nomme jamais un module.
:::

| À éviter | À faire |
| --- | --- |
| `modules/Habilitations/index.ts` | `modules/habilitations/module.ts` qui exporte `habilitations` |

<span class="puce ecrite">Règle écrite</span> Décidé ; aucun module n'est encore livré dans le code.

**Voir aussi.** [Les portes](/modules/portes/)

### NOM-AUTRE-07 · Nommez un plugin par son nom, hors du dépôt du produit

:::tip[Règle]
Le dossier d'un plugin porte son nom. Ses tables sont `plugin_<nom>_<objet>`. Il lit un module par des vues et fonctions publiques et versionnées, jamais par ses tables internes.
:::

<span class="puce ecrite">Règle écrite</span> Décidé dans les décisions sur les modules et les plugins.

**Voir aussi.** [Les plugins](/modules/plugins/)

### NOM-AUTRE-08 · Versionnez une porte et nommez ses emplacements en minuscules à tirets

:::tip[Règle]
La version d'une porte est une chaîne dans la fiche d'identité : `api: "1"`. Les emplacements du registre s'écrivent en minuscules reliées par des traits d'union.
:::

| À éviter | À faire |
| --- | --- |
| `ficheEmploye`, `fiche_employe` | `fiche-employe` |

Les emplacements décidés : `fiche-employe`, `fiche-operation`, `fiche-affaire`, `fiche-client`, `planning-marques`, `planning-cartes`, `cloche`, `recherche`.

<span class="puce ecrite">Règle écrite</span> Décidé ; la version d'une porte n'est pas encore dans le code.

## Référence rapide

| Règle | À retenir | Tenue par |
| --- | --- | --- |
| **NOM-AUTRE-01** | Nommez une classe ou une variable CSS en kebab-case, par son rôle | Usage constaté, À décider |
| **NOM-AUTRE-02** | Nommez un script par un verbe, dans la casse de son langage | À décider |
| **NOM-AUTRE-03** | Préfixez une variable d'environnement du nom du projet | Usage constaté |
| **NOM-AUTRE-04** | Nommez une branche par son sujet, en kebab-case | À décider |
| **NOM-AUTRE-05** | Écrivez un commit `type(domaine): ce que ça fait` | Règle écrite |
| **NOM-AUTRE-06** | Nommez un module par le code de la table `module` | Règle écrite |
| **NOM-AUTRE-07** | Nommez un plugin par son nom, hors du dépôt du produit | Règle écrite |
| **NOM-AUTRE-08** | Versionnez une porte et nommez ses emplacements en minuscules à tirets | Règle écrite |

## Voir aussi

- [Nommer les choses](/regles/nommage/)
