@mostajs/aop-classify 0.1.0

package/README.md

@@ -0,0 +1,13 @@
+# @mostajs/aop-classify
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later
+
+Classification d'**appels d'offres** — **logique pure** (zéro I/O), extraite d'AgoraScope.
+Température `hot/warm/cold/frozen` (par échéance), **score d'urgence** et **score de pertinence** multi-facteurs.
+
+```js
+import { classify, temperatureEmoji } from '@mostajs/aop-classify';
+const c = classify({ deadline, value, procedure, views, bookmarks });
+// { temperature:'hot', urgency:80, score:74, scoreTemperature:'warm' }
+```
+Tests/§12 : `npm install && npm test`. Stack : `mosta-aop-stack`.

package/llms.txt

@@ -0,0 +1,21 @@
+# @mostajs/aop-classify — fiche LLM
+> Classification d'appels d'offres (LOGIQUE PURE, zéro I/O) : température, urgence, score de pertinence.
+
+- Version: 0.1.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Stack: mosta-aop-stack · Extrait d'AgoraScope (temperature-classifier.ts + Tender.calculateScore)
+
+## RÔLE
+Brique PURE (aucune dépendance, aucune I/O) consommée par aop-core / aop-ingestion / aop-ui-html.
+
+## EXPORTS
+- classifyTemperature(deadline, now?, thresholds?) -> 'hot'|'warm'|'cold'|'frozen'  (par échéance ; null→cold, passée→frozen, <30j hot, <90j warm)
+- urgencyScore(deadline, now?) -> 0..100   (inverse des jours restants)
+- computeScore({deadline,value,procedure,views,bookmarks}, now?) -> 0..100  (multi-facteurs)
+- scoreToTemperature(score) -> Temperature   (≥80 hot, ≥60 warm, ≥30 cold, sinon frozen)
+- classify(t, now?, thresholds?) -> { temperature, urgency, score, scoreTemperature }
+- temperatureColor/Emoji/Label/Description(t) ; DEFAULT_THRESHOLDS {hot:30,warm:90}
+
+## PIÈGES
+- DEUX notions de température : par ÉCHÉANCE (classifyTemperature, canonique) vs dérivée du SCORE (scoreToTemperature).
+- Seuils EXCLUSIFS : 30 j → warm (pas hot), 90 j → cold.
+- procedure ∈ open|restricted|negotiated|competitive_dialogue|innovation_partnership.

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mostajs/aop-classify",
+  "version": "0.1.0",
+  "description": "Classification d'appels d'offres (logique pure) : température hot/warm/cold/frozen, score d'urgence, score de pertinence multi-facteurs. Extrait d'AgoraScope.",
+  "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": [
+    "appel-offres",
+    "tender",
+    "classification",
+    "temperature",
+    "scoring",
+    "mostajs"
+  ],
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/aop-classify.test.mjs && node examples/run.mjs"
+  }
+}

package/src/index.js

@@ -0,0 +1,95 @@
+// @mostajs/aop-classify — classification d'appels d'offres (LOGIQUE PURE, zéro I/O).
+// Extrait d'AgoraScope (src/lib/ingestion/temperature-classifier.ts + Tender.calculateScore).
+// Température hot/warm/cold/frozen (par échéance), score d'urgence, score de pertinence multi-facteurs.
+// @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+/** @typedef {'hot'|'warm'|'cold'|'frozen'} Temperature */
+
+const DAY_MS = 86400000;
+export const DEFAULT_THRESHOLDS = { hot: 30, warm: 90 }; // jours
+
+const toDate = (d) => (d == null ? null : d instanceof Date ? d : new Date(d));
+const daysUntil = (deadline, now) => Math.floor((deadline.getTime() - now.getTime()) / DAY_MS);
+
+/**
+ * Température d'un AO selon l'échéance.
+ *   pas d'échéance → cold · échéance passée → frozen · <hot j → hot · <warm j → warm · sinon cold.
+ * @param {Date|string|null} deadline
+ * @param {Date} [now]
+ * @param {{hot:number,warm:number}} [thresholds]
+ * @returns {Temperature}
+ */
+export function classifyTemperature(deadline, now = new Date(), thresholds = DEFAULT_THRESHOLDS) {
+  const d = toDate(deadline);
+  if (!d || isNaN(d.getTime())) return 'cold';
+  if (d < now) return 'frozen';
+  const days = daysUntil(d, now);
+  if (days < thresholds.hot) return 'hot';
+  if (days < thresholds.warm) return 'warm';
+  return 'cold';
+}
+
+/** Score d'urgence 0..100 (inverse du nb de jours restants ; 0 si échéance absente/passée). */
+export function urgencyScore(deadline, now = new Date()) {
+  const d = toDate(deadline);
+  if (!d || isNaN(d.getTime()) || d < now) return 0;
+  const days = daysUntil(d, now);
+  if (days <= 1) return 100;
+  if (days <= 7) return 90;
+  if (days <= 14) return 80;
+  if (days <= 30) return 70;
+  if (days <= 60) return 50;
+  if (days <= 90) return 30;
+  return 10;
+}
+
+const clamp = (n, lo, hi) => Math.min(hi, Math.max(lo, n));
+
+/**
+ * Score de pertinence 0..100 (multi-facteurs : échéance, valeur, procédure, engagement).
+ * @param {object} t { deadline, value?, procedure?, views?, bookmarks? }
+ * @param {Date} [now]
+ */
+export function computeScore(t = {}, now = new Date()) {
+  const { deadline, value = 0, procedure = '', views = 0, bookmarks = 0 } = t;
+  let score = 0;
+  // Échéance (fenêtre de réponse)
+  const d = toDate(deadline);
+  const days = d && !isNaN(d.getTime()) ? daysUntil(d, now) : -1;
+  if (days > 30) score += 25; else if (days > 15) score += 20; else if (days > 7) score += 15; else if (days > 3) score += 10; else score += 5;
+  // Valeur estimée
+  if (value > 500000) score += 25; else if (value > 100000) score += 20; else if (value > 50000) score += 15; else if (value > 10000) score += 10; else score += 5;
+  // Procédure
+  score += ({ open: 25, restricted: 20, competitive_dialogue: 15, negotiated: 10, innovation_partnership: 20 }[procedure]) || 0;
+  // Engagement
+  score += Math.min(25, views * 0.1 + bookmarks * 2);
+  return clamp(Math.round(score), 0, 100);
+}
+
+/** Température dérivée d'un score de pertinence (≥80 hot, ≥60 warm, ≥30 cold, sinon frozen). */
+export function scoreToTemperature(score) {
+  if (score >= 80) return 'hot';
+  if (score >= 60) return 'warm';
+  if (score >= 30) return 'cold';
+  return 'frozen';
+}
+
+const COLORS = { hot: '#EF4444', warm: '#F97316', cold: '#3B82F6', frozen: '#9CA3AF' };
+const EMOJIS = { hot: '🔴', warm: '🟠', cold: '🔵', frozen: '⬜' };
+export const temperatureColor = (t) => COLORS[t] || '#6B7280';
+export const temperatureEmoji = (t) => EMOJIS[t] || '⚪';
+export const temperatureLabel = (t) => `tender.temperature.${t}`;            // clé i18n
+export const temperatureDescription = (t) => `tender.temperature.${t}.description`;
+
+/** Classification complète d'un AO : { temperature, urgency, score, scoreTemperature }. */
+export function classify(t = {}, now = new Date(), thresholds = DEFAULT_THRESHOLDS) {
+  const score = computeScore(t, now);
+  return {
+    temperature: classifyTemperature(t.deadline, now, thresholds),
+    urgency: urgencyScore(t.deadline, now),
+    score,
+    scoreTemperature: scoreToTemperature(score),
+  };
+}
+
+export default { classifyTemperature, urgencyScore, computeScore, scoreToTemperature, classify, temperatureColor, temperatureEmoji, temperatureLabel, temperatureDescription, DEFAULT_THRESHOLDS };