Documentation · Notes de version

Limitations connues

Ce document résume les limitations connues de l'extension ADP Car Market Hub dans sa version actuelle.

Quand utiliser ce document

Lisez ce document lors de la planification d'un déploiement, lors de la préparation d'une note de risque destinée aux clients, ou lors du dépannage d'un comportement qui pourrait être une limitation documentée plutôt qu'un bug.

L'analyse technique détaillée se trouve dans Limitations connues et risques ouverts. Cette page est un résumé plus court destiné aux lecteurs des notes de version.

Aperçu

L'extension est construite sur les mécanismes standards de WordPress (types de publication personnalisés, taxonomies, tables personnalisées, WP-Cron, REST et AJAX). La plupart des limitations découlent de ces choix de conception et des services tiers avec lesquels l'extension peut éventuellement s'intégrer.

Les informations ci-dessous décrivent le comportement observé dans le code source actuel. Vérifiez chaque point par rapport à la version actuelle de l'extension avant de le citer dans un contrat client.

Limitations opérationnelles

Dépendance à WP-Cron. Les importations planifiées, la file d'attente des images, la file d'attente de l'AI Assistant et le nettoyage de la rétention des analyses dépendent tous du déclenchement de WP-Cron. WP-Cron est déclenché par les requêtes et peut être en retard ou totalement manqué sur les sites à faible trafic. Utilisez un vrai cron système (appelant wp-cron.php ou le point de terminaison REST cron-import) pour un comportement prévisible.
Verrous de concurrence. Les exécutions d'importation et de file d'attente d'images utilisent des verrous temporaires (as24ci_cron_import_running, as24ci_image_queue_running). Si un processus s'interrompt (erreur fatale PHP, expiration du délai d'hébergement), le verrou peut survivre au processus. Les verrous obsolètes sont effacés automatiquement une fois le TTL expiré ; la suppression manuelle n'est nécessaire que si vous souhaitez forcer une nouvelle exécution plus tôt.
Budgets de mémoire et de temps d'exécution. Les importations très volumineuses (des milliers de véhicules par exécution, ou des véhicules avec de nombreuses images) peuvent dépasser les limites de mémoire PHP ou de max_execution_time sur les hébergements mutualisés. Ajustez le mode cron ainsi que les limites de véhicules et d'images par exécution en conséquence.
Modifications manuelles des champs importés. Les champs gérés par l'importateur peuvent être écrasés lors de la prochaine importation. Utilisez la couche de surcharges manuelles ou l'emplacement de galerie manuel pour le contenu qui doit survivre aux réimportations.
Mode en ligne à image unique pour les importations cron. Lorsque la file d'attente des images est activée (option par défaut recommandée), seule la première image de chaque véhicule est téléchargée en ligne lors d'une importation cron. Les images restantes sont traitées par le processus asynchrone. Si ce processus ne fonctionne pas, ces images n'apparaîtront pas tant qu'il n'aura pas démarré.

Limitations de sécurité et d'accès

Les identifiants sont stockés dans wp_options. Le Client Secret AutoScout24 et le secret partagé du webhook sont stockés chiffrés au repos, et le jeton cron est stocké sous forme de hachage HMAC unidirectionnel ; les autres réglages et valeurs d'options sont stockés comme des options ordinaires. Traitez les sauvegardes de base de données comme contenant des secrets et renouvelez les identifiants après toute suspicion de compromission. La clé API Gemini gérée utilisée par l'AI Assistant n'est pas saisie ou stockée en tant qu'option WordPress : elle est provisionnée de manière centralisée via la plateforme API ADP Car Market Hub et fournie au site sous forme d'identifiant chiffré lié à la licence. Les clients ne saisissent ni ne voient jamais cette clé.
Dépendance aux capacités. Les pages d'administration de l'extension nécessitent la capacité manage_as24_imports (accordée aux administrateurs par défaut). Les extensions de gestion des rôles qui suppriment cette capacité bloqueront l'accès des administrateurs à l'administration de l'extension.
Les points de terminaison REST publics sont désactivés par défaut et ne doivent être activés que si leurs consommateurs sont connus. Les points de terminaison des favoris et des analyses sont publics par conception lorsque les fonctionnalités correspondantes sont activées, mais appliquent une validation des entrées.

Limitations de confidentialité et de conformité

L'analyse est basée sur le consentement (opt-in) mais, une fois activée, elle enregistre les interactions des visiteurs dans une table personnalisée. Le mode de consentement requis est disponible, mais s'active par défaut lorsque l'intégration du consentement n'est pas reliée au filtre as24ci_analytics_consent_check. Vérifiez la gestion du consentement pour votre juridiction avant d'activer l'analyse.
Les alertes de recherche stockent des données personnelles (e-mail et critères de recherche). La table as24ci_search_agents est supprimée lors de la désinstallation, mais les clients doivent toujours respecter leurs propres obligations de suppression sur demande lors du fonctionnement normal.
L'AI Assistant transmet les données du véhicule au point de terminaison Gemini géré. Lorsqu'il est activé, les invites et le contexte de l'annonce sont envoyés à la configuration Google Gemini gérée dans ADP Car Market Hub. Examinez le traitement des données applicable et les conditions contractuelles de la configuration de l'IA gérée avant d'activer les fonctionnalités d'IA en production.
Les codes QR des fiches techniques PDF utilisent un service tiers par défaut. Remplacez-le par un générateur auto-hébergé via le filtre as24ci_pdf_qr_image_url si les requêtes externes dans les documents imprimables ne sont pas acceptables.
La distribution des e-mails utilise wp_mail(). La réception d'une notification par le destinataire dépend du service de messagerie configuré et de facteurs de délivrabilité externes. L'extension enregistre un indicateur de tentative d'envoi mais ne garantit pas la livraison.

Dépendances externes

Disponibilité de l'API AutoScout24. Les erreurs réseau et les pannes de fournisseur apparaissent comme des exécutions échouées dans les journaux d'importation ; l'absence de données entrantes signifie qu'aucun nouveau véhicule n'est importé, même si WP-Cron se déclenche comme prévu.
Génération de PDF gérée par le navigateur. La fiche technique PDF repose sur le moteur d'impression du navigateur du visiteur. La précision de la mise en page varie d'un navigateur à l'autre.
Point de terminaison d'IA géré. Soumis aux limites de débit de Google Gemini, aux dépréciations de modèles et aux modifications de tarifs indépendantes du contrôle de l'extension.
Récepteurs de webhooks. Des pannes persistantes des récepteurs peuvent entraîner la perte d'événements ; l'extension réessaye les livraisons échouées un nombre limité de fois. Concevez les récepteurs pour qu'ils soient idempotents et qu'ils accusent réception rapidement.

Mises en garde concernant la documentation

Cette documentation décrit le comportement observé dans le code source actuel. Lorsque le code source ne permettait pas d'apporter une réponse concluante, le texte utilise des formulations prudentes telles que « vérifiez par rapport à la version actuelle de l'extension avant de publier ».
Les identifiants de modèle par défaut, les langues prises en charge et les valeurs par défaut des options peuvent changer d'une version à l'autre. Lors de la publication de documents destinés aux clients, copiez les valeurs du code source actuel de l'extension plutôt que de ce document mot à mot.

Atténuations

Configurez un cron système externe pour appeler wp-cron.php ou le point de terminaison REST cron-import afin d'isoler les tâches planifiées du faible trafic.
Configurez des sauvegardes de base de données hors site avec des contrôles d'accès et un chiffrement appropriés.
Associez l'extension à une intégration SMTP ou de messagerie transactionnelle pour des notifications de leads fiables.
Utilisez un environnement de pré-production pour valider les invites d'IA, les modèles PDF et les récepteurs de webhooks avant d'appliquer les modifications en production.
Auditez les rôles qui détiennent manage_as24_imports et les services tiers qui sont connectés.