Création d'un module wordpress pour la création de colis unique

Module de gestion des clients – Gestionnaire Colis Pro

L'objectif de ce module est de créer un système complet de gestion des clients destiné à une activité de réception, stockage, regroupement et expédition de colis.

Chaque client est associé à un utilisateur WordPress/WooCommerce et dispose d'une fiche client interne possédant une référence unique courte (exemple : CL000001). Cette référence permettra d'identifier rapidement le client lors de la réception des colis et sera utilisée dans l'ensemble du plugin.

Le module devra permettre de rechercher un client par sa référence, son nom, son prénom, son adresse e-mail ou son numéro de téléphone afin de retrouver immédiatement sa fiche.

Chaque fiche client devra centraliser toutes les informations utiles à la gestion logistique :

les informations du client ;
la référence client ;
les colis actuellement en stock ;
les colis déjà expédiés ;
les expéditions réalisées ;
les documents transmis ;
l'historique des opérations.

Le module devra également calculer automatiquement plusieurs indicateurs destinés à l'administration, notamment :

le nombre de colis actuellement en stock ;
le poids total stocké ;
le nombre d'expéditions réalisées ;
les frais de stockage éventuels ;
la dernière réception de colis ;
la dernière expédition.

Les colis visibles dans la fiche client devront être uniquement ceux encore disponibles dans l'entrepôt, c'est-à-dire ceux qui n'ont pas encore été intégrés dans une commande d'expédition.

Le stockage devra être géré automatiquement. Chaque colis bénéficiera de quinze jours de stockage gratuit. Au-delà de cette période, les frais de stockage seront calculés automatiquement selon les paramètres définis dans le plugin.

Le module devra être totalement intégré au reste de l'application et communiquer avec les modules Colis, Expéditions, Transporteurs, Tarifs, Documents, Historique, WooCommerce et E-mails.

Depuis la fiche client, l'administrateur devra pouvoir créer un nouveau colis, consulter les colis existants, préparer une expédition, consulter les documents transmis par le client et accéder à l'historique complet.

Du côté du client, seules les informations utiles devront être visibles. Le client pourra consulter ses colis, ses expéditions, ses documents et effectuer une demande d'expédition, sans jamais accéder aux informations internes telles que les commentaires administratifs.

Module de création des colis

Le module de création des colis constitue le point d'entrée de toute la chaîne logistique. Chaque colis reçu dans l'entrepôt doit être enregistré afin d'être immédiatement associé au bon client et suivi jusqu'à son expédition ou sa destruction.

Lors de la création d'un colis, l'administrateur commence par rechercher le client grâce à sa référence interne, son nom ou son adresse e-mail. Une fois le client sélectionné, le système affiche automatiquement les colis de ce client encore présents en stock afin de faciliter la gestion des réceptions.

Le formulaire de création permet de renseigner toutes les informations nécessaires au traitement du colis :

Référence du client.
Numéro de suivi du transporteur.
Poids réel du colis.
Dimensions (longueur, largeur et hauteur). (visible que par les admin)
Photo du colis à la réception.(non obligatoire)
Commentaire interne réservé à l'administration.
Autorisation ou interdiction du regroupement de ce colis.
Liste des transporteurs autorisés pour ce colis.

Le commentaire interne est exclusivement destiné aux équipes de gestion. Il ne sera jamais affiché au client et permettra de signaler des informations importantes telles qu'un emballage endommagé, un colis fragile, une anomalie constatée ou toute autre remarque utile.

Lors de la réception, l'administrateur pourra également décider si le colis est autorisé ou non au regroupement. Cette décision est prise uniquement par l'administration et ne pourra jamais être modifiée par le client. Si le regroupement est interdit, ce colis devra obligatoirement être expédié seul.

Le module devra également permettre de désactiver certains transporteurs pour un colis spécifique. Cette fonctionnalité est indispensable pour gérer les colis hors gabarit, les marchandises soumises à des restrictions ou les contraintes imposées par certains transporteurs. Ainsi, seuls les transporteurs compatibles seront proposés au client lors de sa demande d'expédition.

Dès l'enregistrement du colis, le système calcule automatiquement le prix en fonction du poids de celui-ci

Chaque colis possède son propre tarif, qui sera calculé automatiquement selon son poids. Ce tarif est enregistré dès la réception du colis et sera utilisé plus tard lors de la création de la demande d'expédition.

Le système génère automatiquement un numéro unique de colis (par exemple : COL000001), enregistre la date de réception, l'utilisateur ayant créé le colis ainsi que son statut initial.

Le statut initial d'un colis est « disponible». Il évoluera ensuite automatiquement tout au long du cycle de vie du colis : disponible, commandé, en attente de paiement, payé, en préparation, expédié, détruit ou annulé.

Lors de la création d'un nouveau colis pour un client, l'administration visualise directement les colis de ce client encore présents dans l'entrepôt sous la forme d'un tableau simplifié comprenant uniquement :

Numéro du colis.
Poids.
Regroupement autorisé (Oui / Non).
Commentaire interne.

Cette vue permet de contrôler rapidement les colis déjà stockés et d'éviter les erreurs lors de la réception.

Le client n'a jamais accès aux informations internes de ce module. Depuis son espace personnel, il visualise uniquement les informations utiles au suivi de ses colis :

Numéro du colis.
Date de réception.
Numéro de suivi.
Poids.
Statut.
Indication précisant si le colis est autorisé ou non au regroupement.

L'objectif de ce module est d'assurer un enregistrement rapide, fiable et complet de chaque colis dès sa réception, tout en automatisant le calcul des tarifs, la gestion des restrictions de transport, le suivi logistique et la préparation des futures expéditions vers les DOM-TOM.

L'architecture du module devra être pensée pour être évolutive afin de permettre l'ajout futur de nouvelles fonctionnalités telles que l'import/export de clients, des statistiques avancées, un programme de fidélité, une API REST ou encore la gestion de plusieurs entrepôts, sans remettre en cause la structure existante.

L'objectif est de disposer d'un module professionnel, robuste, évolutif et parfaitement intégré à WooCommerce, capable de gérer efficacement plusieurs milliers de clients et de colis tout en offrant une interface simple, rapide et adaptée aux besoins quotidiens d'une activité de réexpédition.