Aller au contenu
Baptiste.Dev
Retour aux projets
Projet Pro★ Featured

EvoStock

WMS nativement connecté à Sage 100 : application scanette, console web et serveur .NET 10, utilisé en production par des opérateurs d'entrepôt.

EvoStock

Le WMS nativement connecté à Sage 100, conçu et développé chez EvoFlux, intégrateur et éditeur de logiciels Sage basé à Chartres. Réception, rangement, préparation, expédition, inventaire et traçabilité lot / n° de série, le tout au code-barres, sans double saisie. Il tourne en production au quotidien chez un premier client industriel, avec plusieurs opérateurs en simultané.

👉 Découvrir EvoStock sur le site d'EvoFlux


#D'où vient l'idée ?

EvoFlux intègre différents ERP, dont Sage 100. Plusieurs de nos clients avaient besoin d'un WMS, mais aucun sur le marché n'était proprement connecté à Sage : les solutions existantes passent par des services intermédiaires et des synchronisations batch qui créent des incohérences de données.

On a donc décidé de créer un WMS directement connecté à Sage, sans couche intermédiaire : les écritures passent par les Objets Métiers Sage (COM), les lectures directement par la base SQL.


#Timeline

PériodeÉtape
Août 2025Arrivée en alternance chez EvoFlux. Reprise du code d'un stagiaire de première année : 2 semaines pour comprendre le métier et refactoriser entièrement l'existant.
Sept. – déc. 2025Les grands process un par un : Réception (lots/séries, emplacements, zone tampon + rangement, multi-utilisateurs), Interrogation de stock, Mouvement de stock, puis Inventaire persistant sur plusieurs semaines. Premiers tests terrain chez le client.
Janv. – fév. 2026Refonte graphique, process d'Expédition, colisage, impression d'étiquettes, mails automatiques. Mise en place d'un backlog avec scoring ROI par client.
Mars 2026 · v0.8Le client utilise l'app au quotidien. Première console PC, journalisation structurée.
Avril 2026 · v0.8.5Trois modes de réception / rangement, collaboration temps réel avec période de grâce, mails par templates Scriban. Purge des secrets de l'historique Git et CI complète. Hotfix d'un incident de production (voir plus bas).
Juin 2026 · v0.8.6Refonte temps réel de l'inventaire avec reconnexion automatique, supervision depuis le PC, lots FIFO / LIFO, passage à Sage 100 v12.
Juillet 2026 · v0.8.7Expédition de masse multi-BL, flux documentaires configurables (commande → BL), zone tampon, refonte de la couche COM Sage.
Août 2026 · v0.8.8Ordres de transfert Sage, codes-barres à infos libres, console PC réécrite en Blazor WebAssembly, installeur MSI signé. Première release officielle.
Sept. 2026 · v0.9.0Migration du protocole TCP maison vers une API REST authentifiée par JWT, HTTPS optionnel, rôles vérifiés côté serveur, contrôle des quantités avant l'appel à Sage, passage en .NET 10.
Aujourd'huiEvoStock est commercialisé par EvoFlux et continue d'évoluer, avec de nouveaux clients en cours de déploiement.

#Architecture

La solution compte 7 projets .NET, un installeur et un microservice :

  • Application scanette : .NET 10 MAUI Blazor Hybrid, pensée pour les terminaux Android des opérateurs (PDA Keyence) : scan de codes-barres, photos, sessions de travail partagées.
  • Serveur : ASP.NET Core en service Windows. API REST (un contrôleur par domaine), hubs SignalR temps réel et pont COM vers Sage 100.
  • Console web : Blazor WebAssembly + Tailwind CSS pour l'administration (utilisateurs, rôles, flux, mails, modèles d'étiquettes) et la supervision en direct.
  • Bibliothèque partagée : DTOs et exceptions métier communs aux clients et au serveur.
  • Installeur : MSI WiX signé, avec assistant de configuration (SQL, Sage, SMTP, HTTPS), service Windows, règles de pare-feu et mise à jour avec rollback.
  • Microservice PDF : Python FastAPI pour la génération des étiquettes et documents.

#REST + JWT et SignalR

Au départ, les scanettes parlaient au serveur via un protocole TCP maison (framing JSON préfixé par la longueur) : léger, mais sans authentification standard ni chiffrement simple. En v0.9.0, je l'ai remplacé par une API REST authentifiée par JWT, avec HTTPS optionnel par certificat :

  • l'identité vient toujours du jeton, jamais de ce qu'envoie le client ;
  • les routes d'administration sont protégées côté serveur (avant, elles étaient seulement masquées dans l'interface) ;
  • un contrat d'erreurs clair : 422 pour un refus métier, 401 pour une session expirée, 403 pour des droits insuffisants.

Pour les opérations collaboratives (plusieurs opérateurs sur une même réception, un inventaire, une expédition), des hubs SignalR authentifiés et restreints par rôle synchronisent l'état en temps réel, avec reconnexion automatique et reprise de session.


#Intégration Sage 100

Connexion directe à Sage 100 v11 et v12, sans synchronisation batch :

  • Écritures via les Objets Métiers Sage (COM Interop) : réceptions, expéditions, transferts, ordres de transfert, inventaires. Sage COM n'étant pas thread-safe, tous les appels passent par un thread STA dédié et sérialisé, avec une libération systématique des objets COM.
  • Lectures en SQL paramétré directement sur la base Sage : articles, stock, emplacements, lots / séries, dépôts.
  • Contrôle des quantités avant chaque sortie de stock, avec les mêmes règles que Sage : l'erreur remonte à l'opérateur avant d'atteindre l'ERP.

#Process métier

  • Réception : simple, par lots / séries, multi-emplacement, zone tampon + rangement, multi-opérateurs
  • Expédition : préparation, colisage, validation mono ou multi-emplacement, expédition de masse multi-BL
  • Inventaire : multi-opérateurs, sessions persistées pouvant durer plusieurs semaines
  • Mouvements et transferts : entre emplacements, entre dépôts, ordres de transfert Sage
  • Interrogation de stock : par article, dépôt et emplacement
  • Retour client : à partir d'une facture, avec photos
  • Flux documentaires configurables (commande → bon de livraison)
  • Impression d'étiquettes personnalisables et mails automatiques par flux (templates Scriban)

#Industrialisation

  • CI GitHub Actions : scan de secrets (gitleaks), build et tests, build de l'APK, dotnet format, warnings traités comme des erreurs, et scan Trivy bloquant (failles HIGH / CRITICAL et licences copyleft).
  • Signature de l'APK et du MSI via Azure Artifact Signing, avec authentification OIDC fédérée : aucun secret stocké dans la CI.
  • ~140 cas de tests unitaires (xUnit, Moq) sur la bibliothèque partagée et le serveur.
  • Un audit et un CHANGELOG détaillé à chaque version.
  • Plus de 1 100 commits entre août 2025 et septembre 2026.

#Retours d'expérience

Ce projet m'a appris que la production ne pardonne pas. Quelques incidents qui m'ont fait progresser :

  • La démo ratée (février 2026) : un bug réseau critique est apparu en pleine démonstration chez le client. Je l'ai trouvé et corrigé ensuite, et au retour chez le client le mois suivant, l'app était adoptée au quotidien.
  • Le pool SQL saturé (avril 2026) : sous la charge de plusieurs scanettes, le serveur rechargeait ses paramètres à chaque requête et épuisait le pool de connexions. Correctif : cache verrouillé et accès entièrement asynchrones.
  • Le crash COM _purecall : des crashs aléatoires du serveur sous charge, impossibles à reproduire à la demande. Cause racine : le compteur de références de certains objets COM Sage, libérés plus tard par le garbage collector .NET sur un autre thread, alors que Sage tentait encore de les utiliser. Correctif : une libération explicite et déterministe à la fin de chaque scope COM.
  • L'application qui gèle : quand le serveur était injoignable, l'interface de la scanette se figeait jusqu'à 18 secondes (et Android affichait « L'application ne répond pas »). En cause : le contexte de synchronisation de Blazor sur MAUI, qui ramène les continuations async sur le thread UI, et une reconnexion SignalR qui saturait ce même thread. Correctif : des pages qui s'affichent avant de charger leurs données, une connexion temps réel sortie du thread UI, une reconnexion maîtrisée et des timeouts explicites.

Chaque incident a donné lieu à une note de diagnostic dans le dépôt : cause racine, mécanisme, correctif.


#Gestion de projet

J'ai mis en place un backlog avec un scoring ROI pondéré par client et par complexité technique : chaque tâche est évaluée sur sa valeur business et son temps estimé, ce qui permet de prioriser les demandes de plusieurs clients à la fois.


#L'équipe

Je travaille principalement seul sur EvoStock, en tant que lead dev. Un collègue m'assiste sur une partie spécifique : les fonctions qui utilisent les Objets Métiers de Sage (COM Interop).


#Ce que j'ai appris

  • Écouter le terrain : les retours des opérateurs ont complètement changé ma manière de concevoir les interfaces
  • Déboguer en production : diagnostiquer un crash non reproductible à partir des codes d'erreur et des logs, puis en documenter la cause racine
  • Sécuriser une application existante : migrer un protocole maison vers REST + JWT, avec des rôles vérifiés côté serveur
  • Industrialiser : CI, scans de sécurité, signature des binaires, installeur, versioning et changelog
  • Bas niveau C# : COM Interop et threads STA, gestion mémoire, async sur mobile
  • Le métier WMS : comprendre le quotidien des personnes qui l'utilisent pour concevoir un outil qui colle à leurs méthodes réelles