mon-entreprise/règles/documentation/éclatement-des-variables-et-espace-de-nom.md

Supposons qu'il y ait deux variables dans notre système.

Variable: motif CDD
valeur:
  une possibilité:
    - motif B
    - motif Z
    - motif H

Variable: CIF CDD
valeur:
  multiplication:
    assiette: salaire brut
    taux: 29%

Rapprochons-nous encore de la réalité. La formule de motif CDD est en fait une imbrication de possibilités :

motif CDD:
  - motif classique
    - motif remplacement
    - motif accroissement d'activité
    - motif saisonnier
  - motif contrat aidé
  - motif complément formation
  - motif issue d'apprentissage

Les formules d'autres variables, par exemple indemnité fin de contrat ou CID CDD peuvent alors dépendre des éléments de cette liste de possibilités imbriquées :

formule:
  non applicable si:
    une de ces conditions:
      - motif saisonnier
      - motif contrat aidé # on cite une catégorie de motifs, mais qui est une variable utilisable en soi

Alors on pourrait représenter la variable motif CDD ainsi :

Variable: motif CDD
formule:
  une possibilité parmi:
  - Variable: classique
    formule:
      une possibilité parmi:
        - Variable: remplacement
          titre: Contrat de remplacement

        - Variable: usage
          titre: Contrat d'usage
          # formule...
        - Variable: accroissement d'activité
          titre: Motif accroissement temporaire d'activité
  - Variable: contrat aidé
    formule:
      une possibilité parmi:
        - A
        - B
  - Variable: complément formation
    description: le motif complément formation c'est...
  - Variable: issue d'apprentissage
    description: le motif d'issue d'apprentissage c'est ...

• L'avantage de cette modélisation, c'est que tout est au même endroit; on évite, pour chaque descente de niveau de l'imbrication, de répéter le chemin de la variable : on factorise de l'information.
• Le problème, c'est que cela nuit vraiment à la lisibilité de la formule motif : on perd complètement la vue très synthétique de notre pseudo modèle de départ :

Variable: motif
une possibilité parmi:
  - classique
  - contrat aidé
  - complément formation
  - issue d'apprentissage

Et finalement, contrairement au mécanisme de composantes utilisé dans le corps des Cotisations, l'information factorisée n'est pas très conséquent : ce n'est que le chemin.

Une autre modélisation, que l'on retient, consiste donc à éclater les variables en utilisant un système d'espace de nom:

Salariat . CDD . motif: classique
# espace de nom : nom de la variable
formule:
  une possibilité:
    - remplacement
    - accroissement d'activité
    - saisonnier

Salariat . CDD . motif : issue d'apprentissage
description: |
  A l'issue d'un contrat d'apprentissage, un contrat de travail à durée déterminée peut être conclu lorsque l'apprenti doit satisfaire aux obligations du service national dans un délai de moins d'un an après l'expiration du contrat d'apprentissage.  

On pourrait même définir l'espace de nom commun Salariat . CDD . motif en en-tête du fichier où est stocké la variable... mais cela nous rendrait trop dépendant du système de fichiers, qui deviendront superflus quand l'édition se fera dans une interface Web.

Pour beaucoup de variables au nom spécifique, il n'est pas souhaitable d'utiliser des espaces de nom, pour ne pas alourdir le code.

Par exemple, on pourrait définir la variable CDD comme activité . contrat salarié . CDD. Mais CDD est un terme non ambigue dans le contexte français.

À l'inverse, motif ou effectif sont trop spécifiques pour être laissés dans l'espace de nom global. Quand une variable contiendra motif dans son sous-espace de nom, c'est celle-ci qui sera utilisée plutôt que celle d'un autre espace, si elle existe.

Pas de panique, une variable globale pourra quand même être rattachée à quelque chose ! Même si elle n'est pas définie dans un espace de noms, CDD sera quand même utilisée dans contrat salarié commune une des valeurs de type de contrat (ou mieux à l'avenir !). Le moteur se chargera de retrouver son attache.

Quand on créée par exemple la variable CDD: motif, donc la variable motif dans l'espace de nom CDD, et qu'on continue avec une variable CDD . motif . classique on fait deux choses :

• si la variable motif a une propriété valeur, on créée un espace pour pour stocker la valeur de cette variable
• on créée aussi un espace de nom associé à cette variable, qui va héberger des variables qui y sont liées et vont souvent intervenir dans la formule de la valeur de motif

la note "typer les variables" peut être lue à la suite de celle-ci.