Catalogue structure
Catalogue structure
Ce domaine regroupe les marques, modèles, caractéristiques et canvas. Il sert à structurer les lots pour que les vendeurs puissent les décrire correctement et que les acheteurs puissent les rechercher efficacement.
Notions
| Notion | Définition |
|---|---|
| Marque | Fabricant ou marque commerciale associée à un lot |
| Modèle | Référence ou modèle rattaché à une marque |
| Caractéristique | Information descriptive: année, énergie, puissance, dimensions, état, kilométrage, etc. |
| Canvas | Gabarit de saisie qui indique quelles informations collecter pour un type de lot |
| Catégorie | Famille de lots utilisée pour classer et rechercher |
À quoi sert ce domaine ?
- Aider le vendeur à saisir des informations complètes.
- Standardiser les fiches lots.
- Améliorer la recherche marketplace.
- Éviter les doublons de marques ou modèles.
- Permettre des filtres pertinents par type de lot.
- Faciliter les contrôles admin avant publication.
Workflow catalogue
flowchart TD
besoin["Besoin de structurer un lot"] --> marque["Créer ou sélectionner la marque"]
marque --> modele["Créer ou sélectionner le modèle"]
modele --> caracteristiques["Définir les caractéristiques"]
caracteristiques --> canvas["Composer le canvas"]
canvas --> categorie["Associer aux catégories"]
categorie --> saisie["Saisie du lot"]
saisie --> controle{"Données complètes ?"}
controle -->|Non| correction["Corriger les champs manquants"]
controle -->|Oui| publication["Publication et recherche marketplace"]
Gestion des marques et modèles
| Action | Règle |
|---|---|
| Créer une marque | Réservé aux profils avec le droit INTERNAL.BRAND.MANAGE, pour éviter les doublons |
| Créer un modèle | Réservé aux profils avec le droit INTERNAL.MODEL.MANAGE; doit être rattaché à une marque existante |
| Fusionner des doublons | Réservé aux mêmes droits (INTERNAL.BRAND.MANAGE / INTERNAL.MODEL.MANAGE); sélection d'au moins 2 éléments, choix de l'enregistrement à conserver, nom final optionnel, confirmation obligatoire avant exécution |
| Modifier | Ne doit pas casser les lots existants |
| Supprimer | Aucun contrôle d'usage retrouvé: la suppression d'une marque, d'un modèle ou d'une caractéristique passe directement en base sans vérifier si un lot y fait encore référence (vérifié dans le service backend auctelia/items, contrôleurs marques/modèles/caractéristiques) |
La fusion s'effectue soit ligne à ligne depuis la liste des marques ou des modèles (sélection multiple, action « Fusionner », formulaire radio pour choisir l'enregistrement conservé et un nom de remplacement facultatif), soit via l'outil de nettoyage référentiel décrit ci-dessous.
Détection et fusion des doublons (outil de nettoyage référentiel)
Un outil dédié (« Nettoyage référentiel », un onglet par type : marques ou modèles) aide à repérer et fusionner les doublons par lots plutôt qu'un par un.
| Paramètre | Règle |
|---|---|
| Stratégie de détection | Rapprochement approximatif des noms (« fuse ») |
| Seuil de similarité | Réglable de 0,3 (large) à 0,9 (strict), par pas de 0,05 ; valeur par défaut 0,4 |
| Taille max d'un groupe de doublons | 50 enregistrements |
| Filtre « utilisés par des produits » | Optionnel : n'affiche que les enregistrements déjà rattachés à au moins un lot |
| Scission d'un groupe | Un groupe détecté peut être scindé en sous-groupes, avec exclusion des enregistrements qui ne sont pas de vrais doublons |
| Choix du canonique | Par défaut l'enregistrement avec le plus de lots rattachés ; modifiable manuellement, avec nom personnalisé optionnel |
| Fusion | Se fait sous-groupe par sous-groupe, avec confirmation à chaque fusion |
| Suivi de progression | L'état (traité, ignoré, en attente) est mémorisé dans le navigateur de l'admin, par seuil de recherche utilisé |
Gestion des caractéristiques
Une caractéristique doit être compréhensible, stable et exploitable. Elle peut être obligatoire ou facultative selon le canvas.
| Règle | Explication |
|---|---|
| Type de valeur | 9 types possibles : texte court, texte long, nombre entier, nombre décimal, date, case à cocher (oui/non), choix unique, choix multiple, document |
| Unité | Optionnelle pour les types nombre entier/décimal ; forcée à « sans objet » pour les types case à cocher, document, date et texte long (pas de sélecteur d'unité affiché) |
| Options | Uniquement pour les types choix unique / choix multiple ; chaque option a ses propres traductions et un ordre d'affichage |
| Clé externe | Deux identifiants distincts : une « clé » métier (liste fermée, sert par ex. aux règles de labels d'autorisation) et une « clé ViaMobilis » (texte libre) |
| Obligation | Se règle par canvas (voir ci-dessous) : une même caractéristique peut être obligatoire sur un canvas et facultative sur un autre. Si absente sur un lot, elle bloque la validation |
| Statut | Une caractéristique archivée n'apparaît plus dans le sélecteur de caractéristiques d'un canvas (seules les caractéristiques actives sont proposées) |
| Visibilité | 5 emplacements réglables indépendamment (voir tableau ci-dessous) |
| Recherche | Une caractéristique utile peut devenir un filtre marketplace |
Emplacements de visibilité d'une caractéristique, avec leur valeur par défaut à la création :
| Emplacement | Effet | Valeur par défaut |
|---|---|---|
| Description de l'article | Affichée dans le bloc description de la fiche lot marketplace | Non |
| Liste des articles | Affichée sur la vignette du lot dans les listes marketplace | Non |
| Facture | Affichée sur la facture | Non |
| Rapport de retrait | Affichée dans le rapport de retrait | Non |
| Libre-service (self-service) | Affichée dans le formulaire de dépôt de l'espace personnel vendeur | Oui |
Gestion des canvas
Le canvas est le support de saisie d'un lot. Il détermine les champs attendus et leur logique.
| Étape | Description |
|---|---|
| Définition | L'admin catalogue prépare le gabarit (droit INTERNAL.CATEGORY.MANAGE requis pour créer, éditer ou supprimer un canvas) |
| Caractéristiques | Seules les caractéristiques au statut actif peuvent être ajoutées à un canvas, regroupées par thème dans le sélecteur ; chaque caractéristique ajoutée est facultative par défaut et bascule individuellement en obligatoire via un interrupteur dédié |
| Marque / modèle | Deux cases indépendantes sur le canvas (« Marque obligatoire », « Modèle obligatoire ») imposent leur saisie sur les lots qui utilisent ce canvas |
| Association | Le canvas est rattaché à une ou plusieurs catégories |
| Saisie | Le vendeur ou l'admin renseigne les informations attendues |
| Contrôle | La plateforme détecte les champs manquants ou incohérents |
| Publication | La fiche lot devient lisible et searchable |
Blocages possibles
- Marque ou modèle manquant.
- Modèle incohérent avec la marque.
- Caractéristique obligatoire absente.
- Valeur non conforme au format attendu.
- Canvas non adapté au type de lot.
- Doublon de marque ou modèle à arbitrer.
Ce qui est implémenté
- Les marques et modèles peuvent être créés, lus, modifiés et supprimés.
- La création, modification et suppression d'une marque ou d'un modèle met à jour l'index de recherche.
- Un modèle peut être filtré par marque.
- Un canvas est créé avec un statut actif.
- Un canvas peut être associé à des catégories.
- Quand un canvas est archivé ou supprimé, les catégories associées sont détachées.
- Une caractéristique peut être lue individuellement ou via la liste complète.
- Une clé externe de caractéristique est contrôlée pour éviter les réutilisations non souhaitées.
- La validation d'un lot contrôle les caractéristiques obligatoires du canvas.
- Si le canvas exige une marque ou un modèle, la validation du lot contrôle aussi leur présence.
- Si un champ obligatoire est absent ou invalide, la validation du lot est bloquée et les champs manquants sont stockés sur le lot.
- Un lot véhicule porte des caractéristiques dédiées à la carte grise (genre, type, carrosserie administrative, nombre de places), distinctes des caractéristiques commerciales affichées à l'acheteur, utilisées pour produire les documents de cession.
- Une caractéristique peut être exclue du formulaire de dépôt self-service (espace personnel): elle reste alors saisissable par l'admin, et une valeur déjà renseignée n'est jamais perdue en réouvrant un brouillon, seul le champ est masqué au vendeur. Une caractéristique créée depuis l'admin est visible en self-service par défaut.
- La fiche lot de la marketplace n'affiche, dans son bloc description, que les caractéristiques explicitement marquées comme visibles dans la description; les autres restent internes ou réservées à d'autres emplacements de la fiche.
- La carte lot (vignette affichée dans les listes de la marketplace) n'affiche que les caractéristiques marquées visibles en liste d'articles, indépendamment de leur visibilité en description.
- La visibilité d'une caractéristique se règle indépendamment par emplacement: description du lot, liste d'articles, facture, rapport de retrait et formulaire self-service. L'admin dispose d'un éditeur complet par caractéristique (traductions par langue, clé externe, unité, options pour les listes déroulantes, et ces indicateurs de visibilité); seuls nom, type, thème et statut étaient éditables auparavant.
- Un lot affiche distinctement s'il a été remis en vente ou non, avec la date et l'auteur de la décision; un lot refusé et jamais remis en vente n'affiche plus par erreur un badge « remis en vente ».
- La fusion d'une marque ou d'un modèle exige de sélectionner au moins deux enregistrements, de désigner celui qui est conservé, et se fait sous confirmation explicite; elle est réservée aux droits
INTERNAL.BRAND.MANAGE(marques) etINTERNAL.MODEL.MANAGE(modèles). - Un outil de nettoyage référentiel détecte les doublons de marques et de modèles par similarité de nom (seuil réglable, filtre sur les enregistrements déjà utilisés par des produits) et permet de les fusionner groupe par groupe.
- Seules les caractéristiques actives peuvent être ajoutées à un canvas; chaque caractéristique d'un canvas est facultative par défaut et se bascule individuellement en obligatoire.
Labels d'autorisation d'achat
Un lot peut restreindre qui a le droit de l'acheter via des labels d'autorisation. 8 labels existent au total : Professionnels de l'automobile, Revendeurs de machines-outils, Revendeurs d'engins de chantier et de travaux publics, Professionnels (générique), Carte d'identité nationale, Justificatif de registre, Autorisation manuelle, Ouvert à tous.
- Certains labels sont calculés automatiquement à partir des caractéristiques du lot et deviennent alors obligatoires et verrouillés (case à cocher grisée) dans le formulaire vendeur, avec un bouton d'explication qui détaille la raison exacte du déclenchement.
- Le vendeur garde la main pour cocher des labels additionnels non requis par les caractéristiques du lot, mais uniquement parmi ceux que le contrat de l'organisation vendeuse autorise à activer soi-même (« activable par le vendeur »); les autres labels n'apparaissent dans le formulaire que s'ils ont été déclenchés automatiquement.
- La restriction d'achat s'applique dès qu'un label pertinent est actif sur le lot, quelle qu'en soit l'origine (règle de caractéristique, valeur par défaut du contrat ou choix du vendeur); un lot ne perd plus sa restriction "professionnels uniquement" selon la manière dont le label a été activé.
Règles de calcul automatique (toutes les conditions d'une même ligne doivent être vraies) :
| Règle | Condition(s) | Label ajouté |
|---|---|---|
| Contrôle technique manquant | Dernier contrôle technique datant de plus de 6 mois et première mise en circulation datant de plus de 3 ans | Revendeurs d'engins de chantier et de travaux publics |
| Défaut critique | Caractéristique « défauts critiques » = oui | Revendeurs d'engins de chantier et de travaux publics |
| Destiné à la destruction | Caractéristique « non réimmatriculable pour destruction » = oui | Professionnels de l'automobile |
| Non-conformité sécurité | Caractéristique « non conforme à la sécurité au travail » = oui | Revendeurs de machines-outils et revendeurs d'engins de chantier et de travaux publics |
| Absence de carte grise | Caractéristique « inclut les documents d'immatriculation » = non | Revendeurs d'engins de chantier et de travaux publics |
| Véhicule non roulant | Caractéristique liée à la clé « véhicule non roulant » = faux | Revendeurs d'engins de chantier et de travaux publics |
En complément, dès que l'un des trois labels « revendeurs » ci-dessus (automobile, machines-outils, ou engins de chantier/TP) est actif sur le lot — qu'il ait été déclenché par une règle ou activé par le vendeur — le label générique « Professionnels » est ajouté et verrouillé automatiquement.
Audit trail
L'audit trail est l'historique des actions importantes. Il permet de comprendre ce qui s'est passé, qui a agi, quand, sur quel objet et avec quel résultat.
Commentaires et questions
Les commentaires structurent les échanges autour des lots, ventes, organisations ou dossiers. Certains commentaires sont publics ou visibles par les utilisateurs, d'autres sont internes.