@mostajs/achats 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,19 @@
3
3
  **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
4
4
  Format : Keep a Changelog ; versions : SemVer.
5
5
 
6
+ ## [0.1.1] — 2026-11-22
7
+
8
+ ### Ajouté
9
+ - Trois exemples publiés, exécutables **depuis le paquet installé, sans autre module** (ils n'importent que `@mostajs/achats` et `node:*`) : `exemples/01-quantite-proposee.mjs`, `exemples/02-cycle-commande.mjs`, `exemples/03-reprise-apres-panne.mjs`, et le lanceur `exemples/tous.mjs`. Cités dans le README et `llms.txt`.
10
+ - Essais T-ACH-23 à T-ACH-26 : chaque exemple tourne dans le dépôt, puis depuis le paquet fabriqué par `npm pack` et installé hors ligne dans un projet vierge ; l'exemple d'intégration tourne et n'est pas publié.
11
+ - Scripts `npm run exemples` et `npm run exemple:integration`.
12
+
13
+ ### Corrigé
14
+ - La 0.1.0 publiait `exemples/reapprovisionner.mjs`, qui importe `@mostajs/stocks`, `@mostajs/fournisseurs` et `@mostajs/numbering` — des dépendances de développement : installé, il ne pouvait pas tourner. Il devient `integration/reapprovisionner.mjs`, dans le dépôt seulement (le script `npm run exemple` devient `npm run exemple:integration`).
15
+
16
+ ### Inchangé
17
+ - Aucune API : `src/` ne change que par la version du manifeste de `register()`.
18
+
6
19
  ## [0.1.0] — 2026-11-18
7
20
 
8
21
  ### Ajouté
package/README.md CHANGED
@@ -46,7 +46,23 @@ const commande = await achats.envoyer(brouillons[0].id, { par: utilisateur.id })
46
46
  await achats.recevoir(commande.id, { par: magasinier.id, lignes: [{ ligne: 1, quantite: 3 }] }); // → recue_partiellement
47
47
  ```
48
48
 
49
- L'exemple complet tourne seul, sur les vrais `stocks`, `fournisseurs` et `numbering` : `npm run exemple`.
49
+ ## Exemples
50
+
51
+ Publiés dans le paquet, ils tournent **depuis le paquet installé, sans autre module** : chacun n'importe que `@mostajs/achats` et `node:*`, écrit ses ports (stock, fournisseurs, numérotation) en quelques lignes, et se vérifie lui-même (code de sortie 0).
52
+
53
+ | Exemple | Ce qu'il montre |
54
+ |---|---|
55
+ | `exemples/01-quantite-proposee.mjs` | `calculerQuantite` : point de commande, position avec l'en-commande, sécurité en jours, minimum de commande, refus d'une donnée invalide |
56
+ | `exemples/02-cycle-commande.mjs` | proposer, brouillon, envoyer (numéro tiré), recevoir en deux fois (excédent refusé puis accepté), solder avec motif, annuler |
57
+ | `exemples/03-reprise-apres-panne.mjs` | panne du stock au milieu d'une livraison, `aReprendre`, `reprendreEntrees` sans double entrée |
58
+ | `exemples/tous.mjs` | les lance tous |
59
+
60
+ ```bash
61
+ node node_modules/@mostajs/achats/exemples/tous.mjs # depuis une application qui a installé le paquet
62
+ npm run exemples # depuis le dépôt
63
+ ```
64
+
65
+ L'exemple d'**intégration** sur les vrais `@mostajs/stocks`, `@mostajs/fournisseurs` et `@mostajs/numbering` reste dans le dépôt, hors du paquet (il a besoin de ces trois modules) : `npm run exemple:integration` (`integration/reapprovisionner.mjs`).
50
66
 
51
67
  ## La quantité proposée
52
68
 
@@ -122,6 +138,7 @@ Le module **contribue** six permissions et n'en attribue aucune à un rôle : c'
122
138
  ## Essais
123
139
 
124
140
  ```bash
125
- npm test # 22 essais T-ACH-n (@mostajs/mjs-unit), sans base ni réseau
126
- npm run exemple # exemple de vérification sur les vrais stocks, fournisseurs et numbering
141
+ npm test # 26 essais T-ACH-n (@mostajs/mjs-unit), sans base ni réseau, dont les exemples lancés depuis le paquet packé
142
+ npm run exemples # les exemples publiés
143
+ npm run exemple:integration # l'exemple sur les vrais stocks, fournisseurs et numbering (dépôt seulement)
127
144
  ```
@@ -0,0 +1,31 @@
1
+ // @mostajs/achats — exemple 1 : la quantité proposée au point de commande (fonction pure, en entiers).
2
+ // Ne demande rien d'autre que le paquet. Lancer : node exemples/01-quantite-proposee.mjs (code 0 = vérifié)
3
+ // @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
4
+ import assert from 'node:assert/strict';
5
+ import { calculerQuantite, ErreurAchats } from '@mostajs/achats';
6
+
7
+ // Un entrepôt : 30 cartons disponibles, 90 consommés sur 30 jours (3 par jour), livrés en 7 jours, par colis de 25.
8
+ const base = { disponible: 30, consommation: { quantite: 90, jours: 30 }, delaiJours: 7, stockSecurite: 10, couvertureJours: 30, multiple: 25 };
9
+
10
+ // 1. Point de commande = demande pendant le délai (3 × 7 = 21) + stock de sécurité (10) = 31 ; 30 ≤ 31 : déclenché.
11
+ // Niveau cible = 31 + 3 × 30 = 121 ; brute = 121 − 30 = 91 ; arrondie au colis de 25 → 100 (4 colis).
12
+ const q = calculerQuantite(base);
13
+ console.log(`déclenché ${q.declenche} : point ${q.pointDeCommande}, cible ${q.niveauCible}, brute ${q.quantiteBrute} → ${q.quantite} (${q.colis} colis)`);
14
+ assert.deepEqual(
15
+ [q.declenche, q.demandePendantDelai, q.stockSecurite, q.pointDeCommande, q.niveauCible, q.quantiteBrute, q.quantite, q.colis],
16
+ [true, 21, 10, 31, 121, 91, 100, 4],
17
+ );
18
+
19
+ // 2. Ce qui est déjà en commande compte dans la position : 30 + 50 = 80 > 31, rien à commander.
20
+ const enCours = calculerQuantite({ ...base, enCommande: 50 });
21
+ console.log(`avec 50 en commande : position ${enCours.position}, déclenché ${enCours.declenche}, quantité ${enCours.quantite}`);
22
+ assert.deepEqual([enCours.position, enCours.declenche, enCours.quantite], [80, false, 0]);
23
+
24
+ // 3. Stock de sécurité en jours (5 jours × 3 = 15) et minimum de commande (150 unités) : 136 brut → 150 (6 colis).
25
+ const m = calculerQuantite({ ...base, stockSecurite: undefined, stockSecuriteJours: 5, minimumQuantite: 150 });
26
+ console.log(`sécurité en jours ${m.stockSecurite}, point ${m.pointDeCommande}, brute ${m.quantiteBrute} → ${m.quantite} (${m.colis} colis)`);
27
+ assert.deepEqual([m.stockSecurite, m.pointDeCommande, m.niveauCible, m.quantiteBrute, m.quantite, m.colis], [15, 36, 126, 96, 150, 6]);
28
+
29
+ // 4. Une donnée invalide est refusée par un code, jamais arrondie en silence.
30
+ assert.throws(() => calculerQuantite({ ...base, disponible: 2.5 }), (e) => e instanceof ErreurAchats && e.code === 'DONNEES_INVALIDES');
31
+ console.log('✓ exemple 1 vérifié');
@@ -0,0 +1,74 @@
1
+ // @mostajs/achats — exemple 2 : le cycle d'une commande fournisseur, de la proposition à la clôture.
2
+ // Les ports (stock, fournisseurs, numérotation) sont écrits ici en quelques lignes : le paquet seul suffit.
3
+ // En production, on branche @mostajs/stocks (portStocks), @mostajs/fournisseurs et @mostajs/numbering (portNumerotation).
4
+ // Lancer : node exemples/02-cycle-commande.mjs (code 0 = vérifié)
5
+ // @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
6
+ import assert from 'node:assert/strict';
7
+ import { creerAchats, depotMemoire, PERMISSION_PAR_OPERATION } from '@mostajs/achats';
8
+
9
+ const JOUR = 86400e3;
10
+ let t = Date.UTC(2026, 10, 2, 8);
11
+ const horloge = () => t;
12
+
13
+ // Port stock : un niveau disponible, une consommation observée, et le journal des entrées.
14
+ const entrees = [];
15
+ const stock = {
16
+ async disponible(articleId) { return articleId === 'carton-40' ? 30 : 0; },
17
+ async consommation() { return 90; }, // 90 sur la fenêtre de 30 jours
18
+ async entrer(e) { entrees.push(e); return { id: `mvt-${entrees.length}` }; },
19
+ };
20
+ // Port fournisseurs : une fiche et une référence au colis de 25 (forme de @mostajs/fournisseurs).
21
+ const fournisseurs = {
22
+ async parId(id) { return id === 'F1' ? { id, nom: 'CARTONNERIE EXEMPLE', actif: true } : null; },
23
+ async fournisseursPourMatiere(articleId) {
24
+ return articleId === 'carton-40' ? [{ fournisseurId: 'F1', code: 'CT-40', parColis: 25, libelle: 'Carton 40x30x30 (25)' }] : [];
25
+ },
26
+ };
27
+ // Port de numérotation : sans trou, tiré à l'envoi seulement.
28
+ let n = 0;
29
+ const numeroter = () => `BC-2026-${String(++n).padStart(4, '0')}`;
30
+
31
+ const achats = creerAchats({ depots: { commandes: depotMemoire(), receptions: depotMemoire() }, stock, fournisseurs, numeroter, horloge });
32
+
33
+ // 1. Proposer (ne crée rien), puis un brouillon par fournisseur, à valider par une personne.
34
+ console.log(`droit à vérifier par l'application avant « proposer » : ${PERMISSION_PAR_OPERATION.proposer}`);
35
+ const [p] = await achats.proposer({ articles: [{ articleId: 'carton-40', delaiJours: 7, stockSecurite: 10, prixUnitaire: 1250 }] });
36
+ console.log(`proposé : ${p.colis} colis de ${p.parColis} chez ${p.fournisseurId}`);
37
+ assert.deepEqual([p.declenche, p.fournisseurId, p.colis, p.quantite], [true, 'F1', 4, 100]);
38
+ const { brouillons } = await achats.brouillonsDepuis([p], { par: 'acheteur' });
39
+ assert.equal(brouillons[0].etat, 'brouillon');
40
+ assert.equal(brouillons[0].numero, null, 'le numéro n\'est tiré qu\'à l\'envoi');
41
+
42
+ // 2. Envoyer : le numéro est tiré.
43
+ const a = await achats.envoyer(brouillons[0].id, { par: 'acheteur' });
44
+ console.log(`envoyée : ${a.numero}, ${a.lignes[0].quantite} colis, total ${a.total}`);
45
+ assert.deepEqual([a.etat, a.numero, a.total], ['envoyee', 'BC-2026-0001', 5000]);
46
+
47
+ // 3. Recevoir en deux livraisons : 3 colis, puis un excédent refusé (rien n'est écrit), puis accepté.
48
+ t += 5 * JOUR;
49
+ const r1 = await achats.recevoir(a.id, { par: 'magasin', bonLivraison: 'BL-1', lignes: [{ ligne: 1, quantite: 3 }] });
50
+ console.log(`livraison 1 : ${r1.commande.etat}, reste ${r1.reliquats[0].reste} colis`);
51
+ assert.equal(r1.commande.etat, 'recue_partiellement');
52
+ await assert.rejects(achats.recevoir(a.id, { par: 'magasin', lignes: [{ ligne: 1, quantite: 2 }] }), (e) => e.code === 'RECEPTION_EXCEDENTAIRE');
53
+ assert.equal(entrees.length, 1, 'le refus n\'a rien entré en stock');
54
+ const r2 = await achats.recevoir(a.id, { par: 'magasin', bonLivraison: 'BL-2', excedent: 'accepter', lignes: [{ ligne: 1, quantite: 2 }] });
55
+ console.log(`livraison 2 : ${r2.commande.etat}, excédent accepté ${r2.excedents[0].excedent} colis`);
56
+ assert.equal(r2.commande.etat, 'soldee');
57
+ assert.deepEqual(entrees.map((e) => [e.quantite, e.montant, e.ref]), [[75, 3750, 'achat:BC-2026-0001'], [50, 2500, 'achat:BC-2026-0001']]);
58
+
59
+ // 4. Une deuxième commande, reçue en partie puis soldée avec un motif : le reliquat est abandonné et tracé.
60
+ const b = await achats.envoyer((await achats.creer({ fournisseurId: 'F1', par: 'acheteur', lignes: [{ articleId: 'carton-40', quantite: 4, prixUnitaire: 1250 }] })).id, { par: 'acheteur' });
61
+ await achats.recevoir(b.id, { par: 'magasin', lignes: [{ ligne: 1, quantite: 1 }] });
62
+ assert.equal(await achats.enCommande('carton-40'), 75, 'reste en commande : 3 colis de 25');
63
+ const bs = await achats.solder(b.id, { par: 'acheteur', motif: 'fin de série chez le fournisseur' });
64
+ console.log(`${bs.numero} : ${bs.etat} (${bs.motifCloture})`);
65
+ assert.equal(bs.etat, 'soldee');
66
+ assert.equal(await achats.enCommande('carton-40'), 0);
67
+
68
+ // 5. Une troisième, annulée avant l'envoi : aucun numéro consommé.
69
+ const c = await achats.creer({ fournisseurId: 'F1', par: 'acheteur', lignes: [{ articleId: 'carton-40', quantite: 2, prixUnitaire: 1250 }] });
70
+ const ca = await achats.annuler(c.id, { par: 'acheteur', motif: 'doublon' });
71
+ assert.deepEqual([ca.etat, ca.numero], ['annulee', null]);
72
+ await assert.rejects(achats.recevoir(c.id, { par: 'magasin', lignes: [{ ligne: 1, quantite: 1 }] }), (e) => e.code === 'COMMANDE_ANNULEE');
73
+ console.log(`états : ${(await achats.lister()).map((x) => `${x.numero ?? '(sans numéro)'} ${x.etat}`).join(' · ')}`);
74
+ console.log('✓ exemple 2 vérifié');
@@ -0,0 +1,56 @@
1
+ // @mostajs/achats — exemple 3 : le stock tombe en panne au milieu d'une livraison ; la reprise termine le travail
2
+ // sans entrer deux fois la même ligne (clé `<réception>:<ligne>`). Le paquet seul suffit.
3
+ // Lancer : node exemples/03-reprise-apres-panne.mjs (code 0 = vérifié)
4
+ // @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
5
+ import assert from 'node:assert/strict';
6
+ import { creerAchats, depotMemoire, ErreurAchats } from '@mostajs/achats';
7
+
8
+ // Port stock qui échoue au deuxième appel tant qu'il est « en panne ».
9
+ const entrees = [];
10
+ let enPanne = true;
11
+ let appels = 0;
12
+ const stock = {
13
+ async entrer(e) {
14
+ appels += 1;
15
+ if (enPanne && appels === 2) throw new Error('stock indisponible');
16
+ entrees.push(e);
17
+ return { id: `mvt-${entrees.length}` };
18
+ },
19
+ async disponible() { return 0; },
20
+ async consommation() { return 0; },
21
+ };
22
+ let n = 0;
23
+ const achats = creerAchats({ depots: { commandes: depotMemoire(), receptions: depotMemoire() }, stock, numeroter: () => `BC-2026-${String(++n).padStart(4, '0')}` });
24
+
25
+ // Une commande de deux lignes, envoyée, puis reçue en entier.
26
+ const c = await achats.creer({ fournisseurId: 'F1', par: 'acheteur', lignes: [
27
+ { articleId: 'carton-40', quantite: 4, prixUnitaire: 1250, parColis: 25 },
28
+ { articleId: 'ruban-48', quantite: 10, prixUnitaire: 300 },
29
+ ] });
30
+ await achats.envoyer(c.id, { par: 'acheteur' });
31
+
32
+ // 1. La réception est enregistrée, la ligne 1 entre en stock, la ligne 2 échoue : erreur à code, avec la réception.
33
+ let receptionId = null;
34
+ await assert.rejects(achats.recevoir(c.id, { par: 'magasin', lignes: [{ ligne: 1, quantite: 4 }, { ligne: 2, quantite: 10 }] }), (e) => {
35
+ assert.ok(e instanceof ErreurAchats);
36
+ assert.equal(e.code, 'ENTREE_STOCK_ECHOUEE');
37
+ receptionId = e.details.receptionId;
38
+ return true;
39
+ });
40
+ console.log(`panne : réception ${receptionId} à reprendre, ${entrees.length} ligne entrée sur 2`);
41
+ assert.equal(entrees.length, 1);
42
+ assert.deepEqual((await achats.aReprendre()).map((r) => r.id), [receptionId]);
43
+
44
+ // 2. Le stock revient ; la reprise n'entre que la ligne manquante.
45
+ enPanne = false;
46
+ await achats.reprendreEntrees(receptionId);
47
+ console.log(`reprise : ${entrees.map((e) => `${e.articleId} ×${e.quantite} (clé ${e.cle})`).join(', ')}`);
48
+ assert.deepEqual(entrees.map((e) => [e.articleId, e.quantite]), [['carton-40', 100], ['ruban-48', 10]]);
49
+ assert.equal(new Set(entrees.map((e) => e.cle)).size, 2, 'aucune ligne entrée deux fois');
50
+ assert.deepEqual(await achats.aReprendre(), []);
51
+
52
+ // 3. Une seconde reprise ne fait rien de plus.
53
+ await achats.reprendreEntrees(receptionId);
54
+ assert.equal(entrees.length, 2);
55
+ assert.equal((await achats.lire(c.id)).etat, 'soldee');
56
+ console.log('✓ exemple 3 vérifié');
@@ -0,0 +1,19 @@
1
+ // @mostajs/achats — lance chaque exemple numéroté de ce dossier dans son propre processus et dit lesquels ont tenu.
2
+ // Lancer : node exemples/tous.mjs (ou npm run exemples dans le dépôt) — code 0 = tous vérifiés.
3
+ // @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
4
+ import { spawnSync } from 'node:child_process';
5
+ import { readdirSync } from 'node:fs';
6
+ import { dirname, join } from 'node:path';
7
+ import { fileURLToPath } from 'node:url';
8
+
9
+ const ici = dirname(fileURLToPath(import.meta.url));
10
+ const exemples = readdirSync(ici).filter((f) => /^\d{2}-.*\.mjs$/.test(f)).sort();
11
+ let echecs = 0;
12
+ for (const f of exemples) {
13
+ const r = spawnSync(process.execPath, [join(ici, f)], { encoding: 'utf8' });
14
+ const ok = r.status === 0;
15
+ if (!ok) echecs += 1;
16
+ console.log(`${ok ? '✓' : '✗'} ${f}${ok ? '' : `\n${r.stdout}${r.stderr}`}`);
17
+ }
18
+ console.log(echecs ? `✗ ${echecs} exemple(s) en échec sur ${exemples.length}` : `✓ ${exemples.length} exemples vérifiés`);
19
+ process.exit(echecs ? 1 : 0);
package/llms.txt CHANGED
@@ -1,4 +1,4 @@
1
- # @mostajs/achats 0.1.0 — fiche LLM
1
+ # @mostajs/achats 0.1.1 — fiche LLM
2
2
  > Commandes fournisseurs (brouillon → envoyée → reçue en partie → soldée, et annulée), quantité proposée au point
3
3
  > de commande avec stock de sécurité, réception partielle ou excédentaire qui entre en stock par un port injecté.
4
4
 
@@ -49,6 +49,15 @@ Que commander, à qui, et qu'en a-t-on reçu ?
49
49
  - horloge () → ms | Date (défaut Date.now) · id () → string (défaut crypto.randomUUID)
50
50
  - reglages objet ou () → objet : { excedent: 'refuser', fenetreJours: 30, couvertureJours: 30 } (lus à chaque appel)
51
51
 
52
+ ## EXEMPLES (publiés, exécutables depuis le paquet installé, sans autre module)
53
+ - exemples/01-quantite-proposee.mjs calculerQuantite : point de commande, position, sécurité en jours, minimum, refus à code
54
+ - exemples/02-cycle-commande.mjs proposer → brouillonsDepuis → envoyer → recevoir (partiel, excédent refusé puis accepté)
55
+ → solder avec motif → annuler ; ports stock, fournisseurs, numeroter écrits en quelques lignes
56
+ - exemples/03-reprise-apres-panne.mjs ENTREE_STOCK_ECHOUEE → aReprendre → reprendreEntrees, sans double entrée
57
+ - exemples/tous.mjs les lance tous (code 0 = vérifiés) : node node_modules/@mostajs/achats/exemples/tous.mjs
58
+ Chaque exemple importe '@mostajs/achats' et node:* seulement, et se vérifie lui-même (assertions).
59
+ Hors du paquet : integration/reapprovisionner.mjs (dépôt seulement), sur les vrais @mostajs/stocks, fournisseurs, numbering.
60
+
52
61
  ## DÉPÔT
53
62
  Contrat à prédicat (@mostajs/repository), un dépôt par entité :
54
63
  create(doc) → doc · findById(id) → doc | null · find(predicat) → doc[] · update(id, patch, { version }?) → doc | null
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mostajs/achats",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Commandes fournisseurs : cycle de vie (brouillon, envoyée, reçue en partie, soldée, annulée), quantité proposée au point de commande avec stock de sécurité, réception partielle ou excédentaire qui entre en stock par un port injecté ; montants entiers, horloge et dépôts injectés, erreurs à codes, permissions contribuées.",
5
5
  "license": "AGPL-3.0-or-later",
6
6
  "author": "Dr Hamid MADANI <drmdh@msn.com>",
@@ -24,7 +24,8 @@
24
24
  },
25
25
  "scripts": {
26
26
  "test": "bash test-scripts/run-tests.sh",
27
- "exemple": "node exemples/reapprovisionner.mjs"
27
+ "exemples": "node exemples/tous.mjs",
28
+ "exemple:integration": "node integration/reapprovisionner.mjs"
28
29
  },
29
30
  "keywords": [
30
31
  "mostajs",
package/src/register.mjs CHANGED
@@ -8,7 +8,7 @@ import { schemaCommandeAchat, schemaReceptionAchat } from './schemas.mjs';
8
8
  export function register(registry) {
9
9
  registry.register({
10
10
  manifest: {
11
- name: 'achats', package: '@mostajs/achats', version: '0.1.0', type: 'business', priority: 110,
11
+ name: 'achats', package: '@mostajs/achats', version: '0.1.1', type: 'business', priority: 110,
12
12
  displayName: 'Achats', description: 'Commandes fournisseurs, quantités proposées, réceptions.',
13
13
  icon: 'ShoppingCart', register: './src/register.mjs',
14
14
  },
@@ -1,60 +0,0 @@
1
- // @mostajs/achats — exemple de vérification : un réapprovisionnement de bout en bout,
2
- // sur les VRAIS @mostajs/stocks, @mostajs/fournisseurs et @mostajs/numbering (dépendances de développement).
3
- // Lancer : npm run exemple (code de sortie 0 = chaque vérification a tenu)
4
- // @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
5
- import assert from 'node:assert/strict';
6
- import { createStocks } from '@mostajs/stocks';
7
- import { creerFournisseurs } from '@mostajs/fournisseurs';
8
- import { createNumbering } from '@mostajs/numbering';
9
- import { creerAchats, depotMemoire, portStocks, portNumerotation } from '../src/index.mjs';
10
-
11
- const JOUR = 86400e3;
12
- let t = Date.UTC(2026, 9, 19, 8);
13
- const horloge = () => t;
14
-
15
- // 1. Le stock : 120 cartons entrés, 90 sortis en 30 jours (3 par jour).
16
- const stocks = createStocks({ repositories: { articles: depotMemoire(), movements: depotMemoire(), reservations: depotMemoire() }, now: () => new Date(t) });
17
- const carton = await stocks.articles.create({ name: 'Carton 40x30x30', unit: 'u', minThreshold: 40 });
18
- await stocks.movements.in(carton.id, { qty: 120, amount: 144000 });
19
- for (let j = 0; j < 30; j++) { t += JOUR; await stocks.movements.out(carton.id, { qty: 3 }); }
20
-
21
- // 2. Le référentiel : un fournisseur, une référence au colis de 25.
22
- const fournisseurs = creerFournisseurs({ depot: depotMemoire(), depotReferences: depotMemoire() });
23
- const f = await fournisseurs.creer({ nom: 'CARTONNERIE EXEMPLE' });
24
- await fournisseurs.referencer({ fournisseurId: f.id, code: 'CT-40', matiereId: carton.id, parColis: 25, libelle: 'Carton 40 (25)' });
25
-
26
- // 3. La numérotation sans trou.
27
- const numbering = createNumbering();
28
- numbering.define({ name: 'commande-achat', format: '[BC]-YYYY-NNNN', resetEvery: 'year' });
29
-
30
- const achats = creerAchats({
31
- depots: { commandes: depotMemoire(), receptions: depotMemoire() },
32
- stock: portStocks(stocks), fournisseurs, numeroter: portNumerotation(numbering), horloge,
33
- });
34
-
35
- // 4. La proposition : disponible 30 ; point = 3×7 + 10 = 31 ; cible = 31 + 3×30 = 121 ; brute 91 → 4 colis.
36
- const [p] = await achats.proposer({ articles: [{ articleId: carton.id, delaiJours: 7, stockSecurite: 10, couvertureJours: 30, prixUnitaire: 1250 }] });
37
- console.log(`proposé : ${p.colis} colis (${p.quantite} unités), point de commande ${p.pointDeCommande}, disponible ${p.disponible}`);
38
- assert.deepEqual([p.disponible, p.pointDeCommande, p.declenche, p.quantite, p.colis], [30, 31, true, 100, 4]);
39
-
40
- // 5. Un brouillon validé, envoyé, reçu en deux fois (avec un excédent refusé entre les deux).
41
- const { brouillons } = await achats.brouillonsDepuis([p], { par: 'responsable' });
42
- const c = await achats.envoyer(brouillons[0].id, { par: 'responsable' });
43
- console.log(`envoyée : ${c.numero}, total ${c.total}`);
44
- assert.equal(c.numero, 'BC-2026-0001');
45
- t += 5 * JOUR;
46
- const r1 = await achats.recevoir(c.id, { par: 'magasin', bonLivraison: 'BL-1', lignes: [{ ligne: 1, quantite: 3 }] });
47
- console.log(`livraison 1 : ${r1.commande.etat}, reliquat ${r1.reliquats[0].reste} colis`);
48
- await assert.rejects(achats.recevoir(c.id, { par: 'magasin', lignes: [{ ligne: 1, quantite: 2 }] }), (e) => e.code === 'RECEPTION_EXCEDENTAIRE');
49
- const r2 = await achats.recevoir(c.id, { par: 'magasin', bonLivraison: 'BL-2', lignes: [{ ligne: 1, quantite: 1 }] });
50
- console.log(`livraison 2 : ${r2.commande.etat}`);
51
- assert.equal(r2.commande.etat, 'soldee');
52
- await assert.rejects(achats.recevoir(c.id, { par: 'magasin', lignes: [{ ligne: 1, quantite: 1 }] }), (e) => e.code === 'COMMANDE_SOLDEE');
53
-
54
- // 6. Le stock a reçu 100 unités, à la référence de la commande.
55
- const niveau = await stocks.levels.of(carton.id);
56
- const entrees = (await stocks.movements.list({ articleId: carton.id })).filter((m) => m.ref === 'achat:BC-2026-0001');
57
- console.log(`stock : ${niveau.qty} unités ; entrées de la commande : ${entrees.map((m) => m.qty).join(' + ')}`);
58
- assert.equal(niveau.qty, 30 + 100);
59
- assert.deepEqual(entrees.map((m) => [m.qty, m.amount]), [[75, 3750], [25, 1250]]);
60
- console.log('✓ exemple vérifié');