Stock Manager

Stock Manager a été développé en duo avec Joël Houinsavi (développeur full-stack). Je suis intervenu aussi bien côté frontend que backend, avec un focus particulier sur le point de vente, le catalogue produit, les transferts inter-magasins, et le chantier multi-organisation.

Le produit couvre tout le cycle de vie du stock pour un réseau de magasins : commandes fournisseurs, réceptions, factures, mouvements de stock, conversions entre formats de conditionnement, inventaires physiques avec validation, et un point de vente complet avec encaissement et remboursement. Les transferts entre magasins ne sont pas un simple déplacement de quantité : chaque transfert confirmé déclenche en une seule transaction la décrémentation du stock source, l'incrémentation du stock destination, et la mise à jour des deux mouvements et des deux répartitions par format de conditionnement, pour qu'un produit ne puisse jamais exister en double ni disparaître entre deux magasins. Un système de rôles à cinq niveaux encadre qui peut faire quoi, de la caissière qui ne voit que l'écran de caisse jusqu'au super-administrateur qui a accès à tout.

Le vrai défi du projet n'a pas été d'ajouter une fonctionnalité de plus, c'est d'avoir fait basculer toute l'architecture vers un modèle multi-organisation alors que l'application tournait déjà avec des données réelles. Concrètement, ça voulait dire ajouter une notion d'organisation à chaque table métier, produits, stock, fournisseurs, commandes, transactions, journaux d'audit, sans casser ce qui fonctionnait déjà. Le plus piégeux dans ce genre de migration, ce ne sont jamais les relations évidentes, ce sont les relations indirectes qu'on découvre en cours de route, une séquence de numérotation de bon de commande, un identifiant de stock composé, une donnée dénormalisée dans un log d'audit, qui doit elle aussi devenir consciente de l'organisation à laquelle elle appartient.

Les opérations qui touchent au stock, vente, transfert, réception, passent systématiquement par des transactions en isolation stricte, pour éviter que deux mouvements concurrents ne corrompent le niveau de stock réel, un risque bien réel dès qu'un produit peut être vendu en point de vente et ajusté manuellement au même moment.

Techniquement, Stock Manager repose sur un backend Node.js et Express en TypeScript, avec Prisma et PostgreSQL, et un frontend Next.js, le tout organisé en architecture à quatre couches strictes, routes, contrôleurs, services, repositories, avec une suite de tests automatisés et une intégration continue sur chaque pull request.