> ## Documentation Index
> Fetch the complete documentation index at: https://support.lumicoda.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence : Création par URL

> Spécifications techniques de la page de saisie rapide : paramètres supportés, détection de doublons intégrée et mécanisme d'annulation.

La page **Création par URL** est une interface de saisie spécialisée qui permet de pré-remplir le formulaire de nouveau contact via des paramètres de requête. Elle est conçue pour l'intégration avec des systèmes tiers ou la création de formulaires de capture simplifiés.

## 1. Paramètres d'URL supportés

Le système intercepte les clés suivantes dans l'URL pour alimenter les champs du formulaire.

### Identité et Civil

* `first_name`, `last_name` : Texte. Requis pour déclencher la détection de doublons.
* `gender` : Valeur attendue (`m`, `f`, `x`).
* `birthday` : Date (format `AAAA-MM-JJ`).
* `language` : Code ISO (ex: `fr`, `de`).

### Coordonnées et Adresse

* `email`, `phone` : Texte.
* `address`, `postal_code`, `locality`, `country_code` : Texte.

### Données techniques

* `licence_id`, `reference_id`, `iban` : Texte.
* `type` : Valeur attendue (`individual` ou `organization`).
* `company`, `company_role` : Texte (visibles uniquement si `type=organization`).
* `note` : Zone de texte.

***

## 2. Logique de détection de similarité

Dès que les champs Nom ou Prénom sont modifiés ou reçus via l'URL, le système exécute une recherche de doublons en arrière-plan.

### Algorithme de scoring

* **Seuil d'alerte** : 80% de similarité sur le hash Nom+Prénom.
* **Inclusion** : Détecte si un nom est inclus dans un autre (ex: "Dupont" et "Dupont-Martin").
* **Affichage** : Liste les contacts suspects avec leur score de correspondance et un lien direct vers leur fiche d'édition pour éviter la création d'une nouvelle fiche.

***

## 3. Automates et Sécurité

### Création atomique

Le bouton **Créer** enregistre le contact et ses relations (groupes, parents) en une seule transaction.

### Mécanisme d'annulation (Undo)

Une fois le contact créé, une notification de succès propose un bouton **Annuler**.

* **Action technique** : Déclenche une suppression définitive (`forceDelete`) de l'enregistrement fraîchement créé pour remettre la base de données dans son état initial.

### Remplissage par défaut

Si le paramètre `entry_date` n'est pas fourni dans l'URL, le système applique automatiquement la date du jour comme date d'arrivée.