@mostajs/compta-analytique 0.1.0

package/README.md

@@ -0,0 +1,16 @@
+# @mostajs/compta-analytique
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later
+
+Comptabilité **analytique** (couche logique) — ventile les écritures par **axe** (type, ligne,
+centre de coût, projet) et calcule recettes/dépenses/net + **parts (%)**. **Compose** une source
+d'écritures injectée (DEVRULES §10) ; DB-agnostique.
+
+```js
+import { createComptaAnalytique } from '@mostajs/compta-analytique';
+const ca = createComptaAnalytique({ source: () => compta.ledger.entries(), axisOf: (e) => e.type });
+await ca.ventilation();  // [{ axis, recettes, depenses, net, count }]
+await ca.share();        // [{ axis, depenses, pct }]
+```
+
+Tests & exemple (§11.1 / §12) : `npm install && npm test`. Proposition & livrables : `docs/`. Fiche LLM : `llms.txt`.

package/llms.txt

@@ -0,0 +1,26 @@
+# @mostajs/compta-analytique — fiche LLM
+> Comptabilité analytique : ventilation des écritures par AXE (type/ligne/centre de coût/projet) + parts.
+
+- Version: 0.1.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Stack: mosta-gestion-stack · Voisins: @mostajs/compta, @mostajs/compta-budget
+
+## RÔLE
+Ventile une SOURCE d'écritures par un AXE analytique (fonction injectée) et calcule
+recettes/dépenses/net + parts (%). Couche logique pure, DB-agnostique, composition (§10) :
+la source = ex. @mostajs/compta `ledger.entries`.
+
+## EXPORTS
+- createComptaAnalytique({ source, axisOf? }) -> { ventilation, share, top }
+
+## API
+- ventilation({ sens? }) -> [{ axis, recettes, depenses, net, count }]  (trié dépenses desc)
+- share() -> [{ axis, depenses, pct }]   (part % du total dépenses)
+- top(n=5) -> ventilation tronquée
+
+## PARAMÈTRES
+- source: () => écritures[]  ({ sens:'recette'|'depense', amount, type?, line?, … })
+- axisOf: (e) => string      dimension analytique (défaut: e.type)
+
+## COMPOSITION (Salsabil)
+createComptaAnalytique({ source: () => compta.ledger.entries(), axisOf: (e) => e.type })   // par type d'aide
+createComptaAnalytique({ source: () => compta.ledger.entries(), axisOf: (e) => e.line })   // par ligne de budget

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@mostajs/compta-analytique",
+  "version": "0.1.0",
+  "description": "Comptabilité analytique — ventilation des écritures par axe (type, ligne, centre de coût, projet) + parts, par composition (DB-agnostique).",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "llms.txt"
+  ],
+  "keywords": [
+    "comptabilite",
+    "analytique",
+    "cost-accounting",
+    "ventilation",
+    "mostajs"
+  ],
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/compta-analytique.test.mjs && node examples/run.mjs"
+  }
+}

package/src/index.js

@@ -0,0 +1,45 @@
+// @mostajs/compta-analytique — comptabilité ANALYTIQUE (couche logique). MVP.
+// Ventile les écritures par AXE analytique (type, ligne, centre de coût, projet…) et
+// calcule recettes/dépenses/net + parts. COMPOSE par INJECTION (DEVRULES §10) : reçoit une
+// SOURCE d'écritures (ex. @mostajs/compta ledger.entries) + une fonction d'axe. DB-agnostique.
+// @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : 0);
+
+/**
+ * @param {object} opts
+ * @param {() => Promise<object[]>} opts.source   écritures { sens:'recette'|'depense', amount, ... }
+ * @param {(e:object) => string} [opts.axisOf]    dimension analytique (défaut: e.type)
+ */
+export function createComptaAnalytique({ source = async () => [], axisOf = (e) => e.type || 'autre' } = {}) {
+  async function rows({ sens } = {}) {
+    return (await source()).filter((e) => !sens || e.sens === sens);
+  }
+
+  /** Ventilation par axe : recettes / dépenses / net / nombre, triée par dépenses décroissantes. */
+  async function ventilation({ sens } = {}) {
+    const es = await rows({ sens });
+    const map = new Map();
+    for (const e of es) {
+      const k = axisOf(e) || 'autre';
+      const cur = map.get(k) || { axis: k, recettes: 0, depenses: 0, count: 0 };
+      if (e.sens === 'recette') cur.recettes += num(e.amount); else cur.depenses += num(e.amount);
+      cur.count += 1; map.set(k, cur);
+    }
+    return [...map.values()].map((x) => ({ ...x, net: x.recettes - x.depenses })).sort((a, b) => b.depenses - a.depenses);
+  }
+
+  /** Part (%) de chaque axe dans le total des dépenses. */
+  async function share() {
+    const v = await ventilation();
+    const total = v.reduce((s, x) => s + x.depenses, 0);
+    return v.map((x) => ({ axis: x.axis, depenses: x.depenses, pct: total ? Math.round((x.depenses / total) * 1000) / 10 : 0 }));
+  }
+
+  /** Top N axes par dépenses. */
+  async function top(n = 5) { return (await ventilation()).slice(0, n); }
+
+  return { ventilation, share, top };
+}
+
+export default createComptaAnalytique;