ODOO Mapping via JSON RPC <>WebApp#5

Cette fiche est destinée à être suivie pas à pas dans Odoo Studio.

📂 Module Cible : Contacts (res.partner)

Nous allons utiliser l'objet standard "Contact". Dans Odoo, un infirmier freelance sera considéré comme un Contact Individuel (et non une société).

A. Champs Standards (À réutiliser impérativement)

Ne créez pas de nouveaux champs pour ceux-ci, utilisez les natifs d'Odoo pour bénéficier des fonctionnalités SMS, Email et Géolocalisation.

B. Champs Personnalisés (À créer avec Odoo Studio)

Préfixe recommandé : x_

Voici les champs spécifiques à créer pour matcher vos écrans 1, 2, 3 et 4.

1. Identité & Segmentation

2. Métier & Géographie

3. Consentements & RGPD (Légal)

4. Gamification & Onboarding (Planche 4 - Vidéos)

⚙️ Automatisations Recommandées (Odoo Studio / Server Actions)

Pour que la base de données reste propre, demandez à votre intégrateur (ou faites dans Studio) ces deux automatisations :

1. Concaténation du Nom :
   • Déclencheur : À la mise à jour de x_firstname ou x_lastname.
   • Code Python : record['name'] = (record.x_firstname or '') + ' ' + (record.x_lastname or '')
   • Pourquoi ? Odoo a besoin du champ standard name pour les factures, les emails, etc.
2. Création Utilisateur Portail :
   • Quand le formulaire d'inscription est validé (après vérification email), une action serveur doit créer un utilisateur système (res.users) lié à ce contact (res.partner) pour qu'il puisse se connecter à l'appli.

Parfait. Passons au morceau le plus technique : La gestion des Expériences Professionnelles.

Contrairement au profil de base, ici nous avons une relation "1 vers Plusieurs" (One-to-Many). Un infirmier a plusieurs expériences.

Nous ne pouvons pas stocker cela directement dans la fiche contact (res.partner). Nous allons créer un Modèle Personnalisé via Odoo Studio.

📂 Nouveau Modèle : Expérience Candidat (x_candidate_experience)

Dans Odoo Studio, ne surchargez pas les modules RH existants (conçus pour vos salariés). Créez un nouvel objet dédié aux freelances.

1. Création de l'Objet (Table)

• Nom du modèle : x_candidate_experience
• Description : Historique pro des infirmiers/candidats.
• Ordre de tri par défaut : x_date_start desc (Pour voir les expériences récentes en premier).

2. Le Champ de Liaison (Crucial)

C'est ce qui relie l'expérience à l'infirmier.

Une fois ce champ créé, allez sur le modèle res.partner (Contact), ajoutez un onglet "Expériences" et insérez le champ "One2many" pointant vers x_candidate_experience.

3. Les Champs de Données (Mapping React)

Voici les champs à créer dans x_candidate_experience pour matcher votre formulaire React (Planches 5, 6, 7).

4. Champ Calculé (Optionnel mais recommandé)

Pour faciliter le tri des candidats dans Odoo plus tard, ajoutez un champ calculé :

💡 Résumé pour le développeur React

L'expérience utilisateur React est fluide (ajout dans une liste temporaire), mais techniquement, vous avez deux stratégies d'enregistrement vers Odoo :

Stratégie A (Recommandée) : Enregistrement unitaire

À chaque fois que l'utilisateur clique sur "Enregistrer l'expérience" dans le formulaire, vous envoyez un appel API create.

Stratégie B : Envoi en bloc (Batch)

Vous attendez que l'utilisateur clique sur "Valider" (fin de la liste) pour tout envoyer. C'est plus risqué si l'appli plante.

Exemple de Payload JSON (Création d'une expérience) :

codeJSON

downloadcontent_copy

{
  "model": "x_candidate_experience",
  "method": "create",
  "args": [{
    "x_studio_candidat": 142, // ID du Contact (récupéré à l'étape précédente)
    "x_studio_poste": "infirmier",
    "x_studio_tablissement": "Clinique des Lilas",
    "x_studio_ville": "Lyon",
    "x_studio_date_dbut": "2023-04-01",
    "x_studio_date_fin": "2023-06-30",
    "x_studio_toujours_en_poste": false,
    "x_studio_type_dtablissement": "clinique",
    "x_studio_description": "Service des urgences...",
    // Pour le fichier binaire, Odoo demande du Base64
    "x_studio_nom_du_fichier": "certificat_travail.pdf",
    "x_studio_certificat_travail": "JVBERi0xLjQKJ..." // Base64 string
  }]
}

C'est la dernière étape, mais c'est la plus sensible car elle touche à la conformité légale (KYC) et aux documents administratifs.

Ici, nous avons deux types de données :

1. Des fichiers (Diplômes, CNI, CV...).
2. Des statuts de validation (Vidéos vues, Identité vérifiée par Persona).

Voici la structure recommandée pour garder un Odoo propre et sécurisé.

📂 Nouveau Modèle : Documents de Conformité (x_compliance_document)

Plutôt que de créer 10 champs binaires sur la fiche contact (ce qui alourdit la base), nous allons créer un modèle dédié. Cela permet de gérer les dates d'expiration (ex: CNI périmée) et le statut de validation (ex: Diplôme rejeté car illisible).

1. Création de l'Objet (Table)

• Nom du modèle : x_compliance_document
• Description : Documents légaux et administratifs des candidats.

2. Les Champs (Mapping React)

📂 Extensions sur le Contact (res.partner)

Certaines données de vos écrans ne sont pas des documents, mais des informations propres à l'infirmier. Il faut les ajouter directement sur la fiche contact.

1. Identifiants & Statuts (Planche 8 - Liste Tâches)

2. Gestion Identité / KYC (Planche 9 - Persona)

Attention : Si vous utilisez une solution externe comme "Persona" ou "Onfido" (comme suggéré par vos écrans), ne stockez pas les données biométriques dans Odoo pour des raisons RGPD/Sécurité. Stockez uniquement le résultat.

⚙️ Logique de Validation (Workflow Odoo)

Pour gérer cela efficacement dans Odoo, je vous conseille de configurer une Vue Kanban sur le modèle x_compliance_document groupée par x_validation_status.

1. L'app React envoie le document 

   →→

    Il arrive dans la colonne "À valider" (draft).
   
2. Un administrateur Synergia vérifie le fichier PDF.
3. Il glisse la carte dans la colonne "Validé" (valid).
4. Automatisation (Action Serveur) : Si tous les documents obligatoires (CNI + Diplôme + RPPS) d'un candidat passent à "Validé", alors passer le statut du Contact (res.partner) à "Profil Vérifié".

💡 Résumé pour le développeur React

Voici comment gérer l'upload des fichiers (Planches 8 & 9) vers Odoo via l'API.

Payload JSON (Upload d'un document) :

codeJSON

downloadcontent_copy

{
  "model": "x_compliance_document",
  "method": "create",
  "args": [{
    "x_studio_candidat": 142,
    "x_studio_type_de_document": "Diploma",
    "x_studio_nom_du_fichier": "diplome_etat_infirmier.pdf",
    "x_studio_fichier": "JVBERi0xLjQKJ...", // Base64 string du fichier
    "x_studio_statut": "Draft"
  }]
}

Payload JSON (Mise à jour statut vidéo/tâches) :

Quand l'utilisateur a fini la vidéo "Frais et URSSAF".

codeJSON

downloadcontent_copy

{
  "model": "res.partner",
  "method": "write",
  "args": [
    [142], // ID de l'utilisateur
    {
      "x_studio_vidos_onboarding": "completed",
      "x_studio_engagements_signs": true
    }
  ]
}

✅ Conclusion du Mapping

Vous avez maintenant l'architecture complète pour construire votre backend Odoo Studio :

1. res.partner (Customisé) : Profil, Info légales, Statut Onboarding.
2. x_candidate_experience : CV et parcours pro.
3. x_compliance_document : La GED (Gestion Électronique des Documents) pour valider les profils.