Rendez-vous

Les rendez-vous organisent les interactions physiques ou opérationnelles autour d'une vente: visite, inspection, retrait, livraison, remise documentaire ou rendez-vous support.

Usages

Données d'un rendez-vous

• type technique: visite (VISIT) ou retrait (PICKUP);
• mode: sur inscription, sur rendez-vous ou libre (REGISTRATION, APPOINTMENT, OPEN);
• personne ou organisation concernée, avec un rôle (édition, création, vente ou partenaire);
• lot, vente ou facture associée;
• adresse ou lieu (uniquement des adresses de type « retrait » de l'organisation, y compris pour une visite);
• indicateur « adresse de l'évènement visible »;
• indicateur « technicien du shop présent »;
• date et heure fixes, ou « sur rendez-vous » sans date fixée;
• statut;
• instructions;
• commentaires internes ou utilisateur;
• séquence incrémentée à chaque modification (pas d'historique détaillé observé au-delà de ce compteur).

Cycle fonctionnel

flowchart TD
  demande["Demande ou création"] --> proposition["Proposition de créneau"]
  proposition --> confirmation["Confirmation"]
  confirmation --> realise{"Rendez-vous réalisé ?"}
  realise -->|Oui| termine["Terminé"]
  realise -->|Non| reporte["Reporté ou annulé"]
  reporte --> proposition

Règles de gestion

• Un rendez-vous doit être rattaché à un objet métier.
• Les informations de lieu ne doivent être visibles qu'aux personnes concernées.
• Un rendez-vous confirmé ne doit pas être modifié sans trace.
• Les annulations et reports doivent être historisés.

Disponibilité des créneaux

La fenêtre de créneaux proposée pour la visite et le retrait est calculée par rapport à la date de fin de la séance de vente, avec des paramètres configurables par shop (Réglages du shop > Fonctionnement). Valeurs par défaut utilisées côté formulaire quand le shop n'a rien configuré:

• Contrainte de cohérence vérifiée à la saisie: la date de visite ne peut pas être postérieure à la fin de la séance; la date de retrait ne peut pas être antérieure à la fin de la séance.
• Le réglage « délai maximum » existe pour la visite dans les paramètres du shop mais aucune borne n'est appliquée sur la date choisie dans le formulaire vérifié — à confirmer côté produit si c'est voulu.
• Un rendez-vous peut être « Sur rendez-vous » (sans date/heure fixe) plutôt qu'à dates fixes; ce choix est une option du formulaire (dateType), pas une propriété calculée.

Adresse et visibilité

• Le sélecteur d'adresse d'un rendez-vous (visite ou retrait) ne propose que des adresses de type « retrait » de l'organisation vendeuse.
• Un indicateur « adresse de l'évènement visible » et un indicateur « technicien du shop présent » sont éditables sur chaque rendez-vous de visite ou de retrait, par défaut décochés, sans condition d'accès distincte de celle du rendez-vous lui-même (droit EVENT.EVENT.MANAGE).
• Vérifié côté backend (auctelia/api, includeFullItem.js, controllers/appointments.js): l'indicateur « adresse visible » n'est utilisé nulle part comme condition pour inclure ou masquer l'adresse dans la réponse API; il n'est renvoyé que comme un champ informatif parmi d'autres. L'adresse complète du rendez-vous (coordonnées géocodées, conditions de retrait/livraison) est donc présente dans la réponse quelle que soit la valeur de cet indicateur; aucun filtrage n'a été retrouvé ni côté front ni côté API sur ce point précis.
• Aucun rôle différencié de visibilité de l'adresse (acheteur vs vendeur vs opérateur) n'a été retrouvé dans le code front: la donnée est soit présente, soit absente de la réponse API, sans logique de masquage conditionnelle par rôle dans les composants consultés.

Lien avec la facture et le paiement

• Aucun champ ni logique reliant directement un rendez-vous (y compris de type retrait) à une facture ou à son statut de paiement n'a été retrouvé dans le code des applications front ni du SDK API.
• Il existe en revanche une fonctionnalité de confirmation de retrait de fonds sur la facture (le vendeur confirme, une fois la facture payée, avoir remis le lot, avec un code de confirmation) — voir Factures et paiement. Cette fonctionnalité porte sur la facture, pas sur l'objet rendez-vous, et la documentation qui la décrit précise explicitement qu'elle ne doit pas être confondue avec le retrait physique d'un lot.
• La règle générique ci-dessus (« un rendez-vous lié à une facture ou un retrait peut dépendre du paiement ») reflète donc plutôt une intention métier que quelque chose de vérifié au niveau de l'entité rendez-vous dans ce dépôt; elle mérite clarification.

Permissions de création, modification et annulation

• Aucun délai (« pas de modification à moins de X jours ») n'a été retrouvé dans le code limitant la modification ou la suppression d'un rendez-vous par rapport à sa date.
• Supprimer un rendez-vous de retrait ou de visite partagé par plusieurs lots d'une même séance déclenche une confirmation et ne fait que détacher le lot du rendez-vous (le rendez-vous reste actif pour les autres lots); il n'est supprimé que s'il n'est plus rattaché à aucun lot.

Ce qui est implémenté

• Un rendez-vous peut être créé, lu, mis à jour et supprimé.
• La lecture d'un rendez-vous exige un filtre: identifiant, adresse, gestionnaire, organisation ou liste d'identifiants.
• Les rendez-vous peuvent être filtrés par visites ou retraits.
• Le filtre calendrier conserve les rendez-vous depuis les 30 derniers jours.
• Un rendez-vous peut être rattaché à une organisation avec un rôle donné.
• Chaque mise à jour de rendez-vous incrémente une séquence.
• Un rendez-vous de visite ou de retrait porte deux indicateurs éditables: adresse de l'évènement visible, et technicien du shop présent; ils étaient auparavant figés et non enregistrés (correctif du 23/09/2026, #363): addressVisible n'était jamais envoyé à l'API, et aucteliaTechnicianPresent était systématiquement réécrit à false lors d'une mise à jour, quelle que soit la saisie.
• Le sélecteur d'adresse d'un rendez-vous rattaché à un brouillon regroupe les adresses par organisation (« mes adresses » vs adresses des organisations du groupe), utile quand plusieurs organisations liées (parent/filiales) partagent des adresses. Le filtre par type d'adresse (« retrait ») ne s'applique qu'aux adresses propres à l'organisation active; les adresses des organisations liées apparaissent sans filtrage par type.
• Un lot doit avoir au moins un rendez-vous de retrait renseigné dans ses informations de vente avant validation (contrainte de longueur minimale sur la liste des retraits); le rendez-vous de visite n'est obligatoire que si le vendeur a activé l'option « proposer une visite » pour ce lot.
• La fenêtre de dates proposée par défaut pour un retrait ou une visite se calcule à partir de la date de fin de la séance de vente et des paramètres du shop (heures et délais de début/fin, délai maximum); voir « Disponibilité des créneaux » ci-dessus.
• Les droits de gestion d'un rendez-vous (EVENT.EVENT.MANAGE) sont vérifiés sur le shop du lot pour un rendez-vous rattaché à un lot, et sur le shop actif de la session pour un rendez-vous rattaché directement à une séance.