@mostajs/stocks

Auteur : Dr Hamid MADANI [email protected] · Licence : AGPL-3.0-or-later

Gestion des stocks / inventaire (couche logique) — articles, mouvements (entrées/sorties/ajustements), niveaux calculés, lots & péremption, seuils & alertes, valorisation PMP. Compose des repositories injectés (DEVRULES §10) ; DB-agnostique.

import { createStocks, ArticleSchema, StockMovementSchema } from '@mostajs/stocks';
const s = createStocks({ repositories: { articles, movements } }); // repos ORM/data-plug
const a = await s.articles.create({ name: 'Lait', unit: 'L', minThreshold: 10 });
await s.movements.in(a.id, { qty: 50, unitCost: 90, lot: 'L1', expiry: '2026-08-01' });
await s.movements.out(a.id, { qty: 45, beneficiaryId: 'ben-1' });   // refuse le stock négatif
await s.levels.of(a.id);        // { qty: 5, byLot }
await s.alerts.lowStock();      // articles ≤ seuil
await s.alerts.expiringSoon({ days: 30 });
await s.valorize();             // { total, method: 'pmp' }

Tests & exemple (§11.1 / §12) : npm install && npm test. Conception : DESIGN.md. Proposition & livrables : docs/. Fiche LLM : llms.txt.