Guide administrateur

L'administration se trouve sur https://cargamento.vozit.dev/admin. Elle sert à ouvrir les accès à l'outil, à brancher des applications sur l'API et à adapter l'outil à votre flotte.

Le site public (la vitrine) est à la racine ; l'outil est sur /app et demande un compte.

Se connecter

Même page de connexion que l'outil : https://cargamento.vozit.dev/connexion. Un compte administrateur voit l'entrée Administration dans son menu et le lien en pied de page de l'outil ; un compte utilisateur n'a accès qu'à l'outil (une adresse /admin lui répond « Accès réservé »).

Le premier administrateur se crée sur le serveur :

php bin/create-admin.php prenom.nom@societe.fr "Prénom Nom"

Le mot de passe est généré et affiché une fois. La même commande réinitialise le mot de passe d'un compte existant et lui rend le rôle administrateur (utile si plus personne ne peut se connecter). Les suivants se créent dans Administration › Utilisateurs.

Après 10 mots de passe faux depuis une même adresse IP en 15 minutes, la connexion est bloquée un quart d'heure pour cette adresse.

Tableau de bord

Demandes d'accès à traiter, utilisateurs actifs, clés d'API actives, plans enregistrés, appels à l'API sur 30 jours et appels en erreur.

Demandes d'accès

Les visiteurs du site remplissent Demander un accès (nom, société, email, téléphone facultatif, besoin). Les demandes arrivent dans Administration › Demandes, les nouvelles en tête et marquées d'un trait bleu.

Aucun email n'est envoyé automatiquement, ni au demandeur ni à l'administration : consultez cette page régulièrement (le tableau de bord affiche le nombre de demandes à traiter).

Pour chaque demande :

Créer le compte ouvre la page Utilisateurs avec l'email et le nom déjà remplis ; à la création, la demande passe en « traitée ».
Marquer traitée (ou Remettre en nouvelle) sans créer de compte, par exemple après un refus.
Supprimer efface la demande.

Utilisateurs

Administration › Utilisateurs.

Créer un compte

Email, nom, rôle : Utilisateur (outil seul) ou Administrateur (outil et administration).
Créer et générer un mot de passe : le mot de passe s'affiche une seule fois, sans caractères ambigus pour pouvoir le recopier sur une tablette.
Copier les identifiants met dans le presse-papiers l'adresse de connexion, l'email et le mot de passe, prêts à envoyer à la personne par un canal sûr.

La personne peut ensuite changer son mot de passe dans Mon compte.

Gérer un compte

Action	Effet
Nouveau mot de passe	Génère et affiche un nouveau mot de passe ; l'ancien ne marche plus et tous les appareils de la personne sont déconnectés.
Rendre admin / Retirer admin	Donne ou retire l'accès à l'administration.
Désactiver / Réactiver	Bloque la connexion sans supprimer le compte. La session en cours est coupée immédiatement.
Supprimer	Efface le compte définitivement.

Vous ne pouvez ni désactiver, ni supprimer, ni rétrograder votre propre compte : demandez-le à un autre administrateur.

Clés d'API

Chaque application qui appelle l'API (ERP, logiciel d'entrepôt, application mobile) reçoit sa propre clé. On peut ainsi en couper une sans toucher aux autres.

Administration › Clés d'API.
Saisissez le nom de l'application ou du client, par exemple « ERP Cyprès » ou « WMS Lyon ».
Créer : la clé (cg_ suivi de 40 caractères) s'affiche une seule fois. Copiez-la et transmettez-la au développeur par un canal sûr.

Seule une empreinte de la clé est conservée : si elle est perdue, créez-en une nouvelle et révoquez l'ancienne.

Révoquer coupe la clé immédiatement : les appels suivants reçoivent une erreur 401. Les plans créés avec cette clé restent consultables par leur lien, par les personnes qui ont un compte.

Le tableau montre pour chaque clé la date du dernier appel, le nombre d'appels sur 30 jours et le nombre de plans créés.

Référentiels

Véhicules

Les valeurs livrées sont des moyennes de marché (fiche technique §3.3). Remplacez-les par les cotes intérieures utiles de votre flotte : longueur, largeur, hauteur en centimètres, charge utile en kilogrammes.

Code : identifiant court utilisé par l'API (vehicleCode), en minuscules, chiffres, - et _. Il ne se modifie pas après création ; custom est réservé.
Ordre : position dans la liste de l'outil.
Actif : décoché, le véhicule disparaît de l'outil et de l'API sans être supprimé.
Suppr. puis Enregistrer : suppression définitive.
La dernière ligne, vide, sert à ajouter un véhicule.

Types de palettes

Même principe : longueur, largeur, épaisseur du plateau (cm), tare (kg). Le libellé court s'affiche dans les lignes de chargement de l'écran Camion.

Modifier un référentiel ne change pas les plans déjà enregistrés : ils gardent les cotes du moment de leur création. Les postes qui utilisent l'outil voient la nouvelle liste au prochain chargement de la page.

Seuils d'alerte de répartition

Seuil	Défaut	Effet
Centre de gravité min	30 % de la longueur	En dessous : « Charge déséquilibrée », répartir vers l'arrière.
Centre de gravité max	65 % de la longueur	Au-dessus : « Charge déséquilibrée », répartir vers l'avant.
Décalage latéral max	5 % de la largeur	Au-delà : « Décalage latéral de … cm ».

Ces valeurs par défaut sont celles de la fiche technique et restent à valider par l'exploitation. Elles s'appliquent à l'outil et à l'API ; une application peut les surcharger pour un calcul précis.

Plans enregistrés

Liste des plans créés par les applications connectées, avec leur référence et la clé qui les a créés. Le nom ouvre le plan dans l'outil (lien /p/…, ouvert uniquement aux personnes connectées). Supprimer efface le plan : son lien ne fonctionne plus.

Journal de l'API

Les 300 derniers appels : date, clé, requête, statut (vert sous 400, rouge au-delà), durée, adresse IP. Le contenu des requêtes n'est pas enregistré.

Codes utiles : 401 clé absente, invalide ou révoquée ; 422 saisie invalide ; 429 limite de débit atteinte (120 appels par minute et par clé par défaut).

Bonnes pratiques

Un compte nominatif par personne plutôt qu'un compte partagé : on peut couper un départ sans gêner les autres.
Une clé par application et par environnement (test, production).
Révoquez la clé d'un prestataire à la fin de sa mission.
Saisissez la flotte réelle avant la mise en service, puis faites valider le plan par un chef de quai sur trois chargements réels (critère d'acceptation de la fiche §8.2).