assurance-maladie/nir-validation

Ce composant fournit une validation des valeurs selon les données d'identification française

v1.2.0 2023-09-26 08:09 UTC

Requires

• php: ^7.3||^8.0
• ext-ctype: *
• ext-iconv: *
• symfony/validator: ^4.4||^5.3||^6.0

Requires (Dev)

• assurance-maladie/qualytou: ^2.0
• phpspec/phpspec: ^7.1
• roave/security-advisories: dev-latest

MIT

README

Ce dépôt à pour but de proposer des contraintes sur la représentation des données d'identification française.

Nous proposons plusieurs règles :

• Numéro d'Inscription au Répertoire (NIR)
• Numéro National Provisoire (NNP)
• Migrant de passage (MIG)
• Numéro Identifiant d'Attente (NIA)

Utilisation

PHP natif

Cette partie explique comment utiliser les fonctionnalités du validateur.

L'exemple suivant montre comment valider un NIR :

use Cnamts\Nir\Constraints\Nir;
use Symfony\Component\Validator\Validation;

$validator = Validation::createValidator();
$violations = $validator->validate('2 84 05 88 321 025 30', [new Nir()]);

if (count($violations) !== 0) {
    echo '<ul>';
    foreach ($violations as $violation) {
        echo '<li>'.$violation->getMessage().'</li>';
    }
    echo '</ul>';
}

Symfony

Toutes les contraintes ont été intégrées pour pouvoir être utilisées dans tous les formats supportés par Symfony :

Annotations

// src/Entity/User.php
namespace App\Entity;

// ...
use Cnamts\Nir\Constraints as Assert;

class User
{
    /**
     * @Assert\Nir
     */
    private $identifier;
}

Attributs

// src/Entity/User.php
namespace App\Entity;

// ...
use Cnamts\Nir\Constraints as Assert;

class User
{
    #[Assert\Nir]
    private $identifier;
}

YAML

# config/validator/validation.yaml
App\Entity\User:
    properties:
        identifier:
            - Nir: ~

XML

<!-- config/validator/validation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
        https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

    <class name="App\Entity\User">
        <property name="identifier">
            <constraint name="Nir"/>
        </property>
    </class>
</constraint-mapping>

PHP

// src/Entity/User.php
namespace App\Entity;

// ...
use Cnamts\Nir\Constraints\Nir;
use Symfony\Component\Validator\Mapping\ClassMetadata;

class User
{
    private $identifier;

    public static function loadValidatorMetadata(ClassMetadata $metadata)
    {
        $metadata->addPropertyConstraint('identifier', new Nir());
    }
}

Contraintes

Numéro d'Inscription au Répertoire (NIR)

Le NIR est un numéro à treize caractères dont la composition est précisée dans l'article 4 du décret n° 82-103 du 22 janvier 1982.

Numéro National Provisoire (NNP)

Le NPP est attribué aux personnes nées à l'étranger, qui n'ont jamais été immatriculées.

Migrant de passage (MIG)

Afin de créer au Référentiel Individus (RFI) les individus présents en Bases de Données Opérantes (BDO) en tant que membre de la famille du migrant de passage, il est nécessaire de leur attribuer un numéro de type Migrant unique nationalement.

NIA

L'objectif du NIA est de mettre fin aux numéros provisoires - NNP - créés de manière autonome par les caisses.

Il s'agit de perfectionner la gestion de l'identification par la mise en place d'un numéro provisoire partageable entre tous les Organismes de la Protection Sociale.