Update documentation and validation for identity system

Author: RICHARD-Quentin

docs/summary.json

@@ -30,8 +30,8 @@
         "file": "Documentation_utilisateur.md",
         "children": [
             {
-                "title": "IdentitiesValidation",
-                "file": "./user/IdentitiesValidation.md"
+                "title": "Documentation du Systeme de Validation des schemas complémentaires de l'identité",
+                "file": "./user/Documentation_Systeme_Validation_Identite.md"
             }
         ]
     }

docs/user/IdentitiesValidation.md

@@ -5,11 +5,70 @@
 Ce guide explique comment interagir avec le système de validation des identités dans notre application. Cette fonctionnalité assure que toutes les données relatives aux identités sont valides et conformes aux exigences de l'organisation.
 
 ## Validation des Données
+
+### Résumé
 Lorsque vous soumettez des données d'identité (par exemple, via un formulaire ou une API), le système effectue les vérifications suivantes :
 - Tous les champs obligatoires sont présents.
 - Les données correspondent aux types attendus (chaînes, nombres, dates, etc.).
 - Les valeurs respectent les contraintes spécifiques (par exemple, formats d'email ou de téléphone).
 
+### Données a passer
+Pour valider les données, vous devez fournir :
+Un fichier XML nommé selon le nom de l'objet à valider (par exemple, `supann.xml`).
+Dans le json de la requête, vous devez fournir :
+- Le champs "state" a -1 pour une creation
+- l'object avec comme clé inetorgperson et comme valeur un objet contenant les champs a valider
+- un objet "additionalFields" contenant deux champs :
+- - "objectClasses" : un tableau de string contenant les objectClasses a ajouter a l'objet
+- - "attributes" : un objet contenant les champs a ajouter a l'objet
+
+Par exemple, pour valider un objet supann, vous devez fournir :
+```json
+{
+    "state": -1,
+    "inetorgperson": {
+        "sn": "Doe",
+        "uid": "John",
+        "cn": "John Doe",
+    },
+    "additionalFields": {
+        "objectClasses": ["supann"],
+		"attributes":{
+			"supann": {
+				"supannEmpId": "123456",
+                "supannCivilite": "Mr",
+                "supannBirthName": "Doe"
+            }
+        }
+    }
+}
+```
+
+Avec comme fichier de configuration :
+```yml
+objectClasses:
+  - name: supannPerson
+    desc: 'SUPANN person object class'
+    attributes:
+      - supannEmpId
+      - supannCivilite
+      - supannBirthName
+
+attributes:
+  - name: supannEmpId
+    desc: 'Employee ID'
+    type: string
+    
+  - name: supannCivilite
+    desc: 'Title (Mr, Ms, etc.)'
+    type: string
+
+  - name: supannBirthName
+    desc: 'Birth name'
+    type: string
+```
+
+
 ## Erreurs de Validation
 En cas d'erreur de validation, le système vous fournira un retour détaillé sur les problèmes rencontrés. Cela peut inclure :
 - Des champs manquants.

src/management/identities/validations/_config/supann.yml

@@ -23,48 +23,63 @@ attributes:
   - name: supannEmpId
     desc: 'Employee ID'
     type: string
+    
   - name: supannCivilite
     desc: 'Title (Mr, Ms, etc.)'
     type: string
+
   - name: supannBirthName
     desc: 'Birth name'
     type: string
+
   - name: supannBirthDate
     desc: 'Date of birth'
     type: date
+
   - name: supannBirthPlace
     desc: 'Place of birth'
     type: string
+
   - name: supannMailPerso
     desc: 'Personal email'
     type: string
+
   - name: supannMailPro
     desc: 'Professional email'
     type: string
+
   - name: supannTelPerso
     desc: 'Personal phone number'
     type: string
+
   - name: supannTelPro
     desc: 'Professional phone number'
     type: string
+
   - name: supannPostalAddress
     desc: 'Postal address'
     type: string
+
   - name: supannRole
     desc: 'Role in the organization'
     type: string
+
   - name: supannStatus
     desc: 'Employment status'
     type: string
+
   - name: supannEtablissement
     desc: 'Institution'
     type: string
+
   - name: supannAffectationPrincipale
     desc: 'Primary assignment'
     type: string
+
   - name: supannAffectationSecondaire
     desc: 'Secondary assignment'
     type: string
+
   - name: supannCodeINE
     desc: 'National Education Identifier'
     type: string