Tous les tutoriels

Tutoriel

Gestionnaire OrdiPlus

Version 0.2.1 · Mis à jour le 8 octobre 2026

Le Gestionnaire OrdiPlus permet de suivre l’inventaire des boutiques de Rezé, La Baule et Saint‑Nazaire (cartouches, matériel, PC, etc.). Le tutoriel décrit l’installation du serveur Docker et la première utilisation via le navigateur. Vous apprendrez à configurer l’application, créer votre compte et commencer à gérer le stock.

Ce qu'il faut

  • Un serveur Linux avec accès root
  • Docker et Docker Compose installés
  • nginx configuré en reverse‑proxy avec certificat Let's Encrypt
  • Connexion internet pour récupérer les images Docker

Installation

Déploiement sur VPS (Docker)

  1. 1Se connecter au serveur en SSH.
  2. 2Créer un répertoire de travail, par ex. `/opt/ordiplus`.
  3. 3Cloner le dépôt : `git clone https://github.com/heiphaistos/ordiplus.git .`.
  4. 4Copier le fichier d’exemple `.env.example` en `.env` et y renseigner les variables (POSTGRES_PASSWORD, JWT_SECRET, etc.).
  5. 5Vérifier que le fichier `docker-compose.yml` contient les services `app`, `postgres` et éventuellement `ollama`.
  6. 6Lancer le build et le démarrage : `docker compose up -d --build`.
  7. 7Vérifier les logs : `docker compose logs -f` et s’assurer que le conteneur `app` écoute sur le port 5000.

Configuration nginx

  1. 1Créer un fichier de site dans `/etc/nginx/sites‑available/ordiplus` avec le bloc serveur HTTPS (port 443) et le proxy_pass vers `http://127.0.0.1:5000`.
  2. 2Inclure les en‑têtes de sécurité (HSTS, X‑Frame‑Options, etc.) comme indiqué dans le README.
  3. 3Activer le site : `ln -s /etc/nginx/sites‑available/ordiplus /etc/nginx/sites-enabled/`.
  4. 4Tester la configuration : `nginx -t` puis recharger : `systemctl reload nginx`.

Premier lancement

  1. 1Ouvrir un navigateur et accéder à l’URL du domaine (ex. `https://ordibarre.heiphaistos.org`).
  2. 2Cliquer sur « Créer un compte » et remplir les champs requis (nom, email, mot de passe).
  3. 3Valider l’email si le serveur envoie un lien de confirmation.
  4. 4Se connecter avec les identifiants créés ; la page d’accueil du tableau de bord apparaît.

Ajouter un produit au stock

Enregistrez un nouvel article (cartouche, PC, etc.) dans la base.

  1. 1Dans le tableau de bord, cliquer sur le bouton « Nouvel article ».
  2. 2Saisir le nom, la catégorie, le code interne et le seuil d’alerte.
  3. 3Choisir le magasin (LB, RZ ou SN) où le produit sera stocké.
  4. 4Enregistrer ; le produit apparaît dans la liste du stock.

Générer et imprimer un code‑barcode

Créez un code‑barcode ou QR‑code pour un article afin de le scanner plus tard.

  1. 1Ouvrir la fiche produit depuis la liste du stock.
  2. 2Cliquer sur « Générer code‑barcode ».
  3. 3Sélectionner le format (EAN13, QR) et la taille d’impression.
  4. 4Télécharger le fichier PDF ou PNG et l’imprimer.

Scanner un article avec le mobile

Utilisez la caméra du smartphone pour mettre à jour le stock rapidement.

  1. 1Depuis le tableau de bord, ouvrir la page « Scanner ».
  2. 2Autoriser l’accès à la caméra du téléphone.
  3. 3Pointer la caméra sur le code‑barcode ou QR‑code de l’article.
  4. 4Confirmer l’opération (entrée ou sortie) dans la fenêtre qui s’affiche.

Créer et suivre une commande

Gérez le cycle complet d’une commande de réapprovisionnement.

  1. 1Cliquer sur l’onglet « Commandes » puis sur « Nouvelle commande ».
  2. 2Sélectionner les produits à commander et indiquer les quantités.
  3. 3Choisir le type (auto ou manuel) et valider la création.
  4. 4Lorsque la marchandise arrive, marquer la commande comme « Reçue ».
  5. 5Le stock se met à jour automatiquement.

Utiliser les alertes de stock

Soyez informé dès qu’un article atteint son seuil critique.

  1. 1Accéder à la section « Alertes » depuis le tableau de bord.
  2. 2Filtrer par magasin ou catégorie pour voir les articles en dessous du seuil.
  3. 3Cliquer sur un article pour lancer immédiatement une commande de réapprovisionnement.

Lancer une révision Ultrareview

Exécutez l’audit intégré pour obtenir des scores de performance, accessibilité et sécurité.

  1. 1Dans le menu, choisir « Ultrareview ».
  2. 2Sélectionner le type d’audit souhaité (rapide, complet).
  3. 3Lancer l’audit ; les résultats s’affichent sous forme de tableau avec tendance.
  4. 4Exporter le rapport au format PDF si besoin.

Astuces

  • Utilisez des mots de passe forts pour les comptes administrateur afin de protéger les données sensibles.
  • Planifiez une sauvegarde quotidienne de la base PostgreSQL avec `pg_dump` et stockez les dumps hors‑site.
  • Activez le verrouillage progressif des comptes (`login_attempts`) pour limiter les tentatives de brute‑force.

Questions fréquentes

Comment ajouter un nouvel utilisateur?

Se connecter en tant qu’administrateur, aller dans « Utilisateurs », cliquer sur « Ajouter », saisir le login et le mot de passe, puis attribuer le rôle (admin ou standard).

L’application fonctionne‑t‑elle sans le conteneur Ollama?

Oui. Ollama n’est utilisé que pour la reconnaissance vocale et les rapports Ultrareview avancés ; les fonctions de base (stock, commandes, scans) restent opérationnelles.

Comment mettre à jour l’application?

Pousser les changements sur le dépôt Git, puis sur le serveur exécuter `git pull && docker compose up -d --build`. Le timer systemd le fait automatiquement toutes les 2 minutes.

Pourquoi le token JWT est‑il stocké dans un cookie httpOnly?

Pour empêcher l’accès JavaScript au token et réduire les risques de vol par XSS.

Tutoriel rédigé automatiquement à partir de la documentation du projet, mis à jour à chaque évolution.