@mostajs/aop-alerts 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @mostajs/aop-alerts
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+Alertes de veille d appels d offres (**ORM-first**) : critères + **matching pondéré pur** (seuil 30%) + planification. Stack `mosta-aop-stack`.

package/llms.txt

@@ -0,0 +1,7 @@
+# @mostajs/aop-alerts — fiche LLM
+> Alertes de veille AO (ORM-first) : critères, matching pondéré PUR (seuil 30%), planification.
+
+## EXPORTS
+AlertSchema · matchAlert(alert,tender)->{matches,score} · nextRun(alert,now) · createAlerts({repositories:{alerts}}) · createMemoryRepositories()
+Poids: keywords 30, cpv 20, budget 15, types 10, procedures 10, location 15. excludeKeywords => rejet. Seuil match = 30%.
+Stack mosta-aop-stack. run(alert,tenders) trie par score.

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@mostajs/aop-alerts",
+  "version": "0.1.0",
+  "description": "Alertes de veille d'appels d'offres (ORM-first) : critères, matching pondéré pur (seuil 30%), planification. 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"
+  ],
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/aop-alerts.test.mjs && node examples/run.mjs"
+  }
+}

package/src/aop-alerts.js

@@ -0,0 +1,17 @@
+// @mostajs/aop-alerts — service alertes (ORM-first) + matching pur. @author Dr Hamid MADANI <drmdh@msn.com>
+import { matchAlert, nextRun } from './match.js';
+export function createAlerts({ repositories, now = () => new Date() } = {}) {
+  if (!repositories?.alerts) throw new Error('aop-alerts: repositories.alerts requis (seam ORM)');
+  const repo = repositories.alerts;
+  async function create(data) { const a = await repo.create({ ...data, nextRunAt: nextRun(data, now()).toISOString() }); return a; }
+  /** Évalue une alerte sur une liste d'AO → AO correspondants (triés par score). */
+  function run(alert, tenders) {
+    return tenders.map((t) => ({ tender: t, ...matchAlert(alert, t) })).filter((r) => r.matches).sort((a, b) => b.score - a.score);
+  }
+  return {
+    create, list: () => repo.list(), get: (id) => repo.get(id), update: (id, p) => repo.update(id, p),
+    find: (p) => repo.find(p), active: () => repo.find((a) => a.isActive && !a.isPaused),
+    match: matchAlert, run, nextRun: (a) => nextRun(a, now()),
+    async markRun(id) { const a = await repo.get(id); if (!a) return null; return repo.update(id, { lastRunAt: now().toISOString(), nextRunAt: nextRun(a, now()).toISOString() }); },
+  };
+}

package/src/index.js

@@ -0,0 +1,4 @@
+export { AlertSchema } from './schemas.js';
+export { matchAlert, nextRun } from './match.js';
+export { createAlerts } from './aop-alerts.js';
+export { createMemoryRepositories } from './memory-repo.js';

package/src/match.js

@@ -0,0 +1,34 @@
+// @mostajs/aop-alerts — matching alerte↔AO (LOGIQUE PURE). Port fidèle d'AgoraScope Alert.checkMatch.
+// Poids: keywords 30, cpv 20, budget 15, types 10, procédures 10, localisation 15 ; seuil 30%. @author Dr Hamid MADANI
+const lc = (s) => String(s || '').toLowerCase();
+const has = (arr) => Array.isArray(arr) && arr.length > 0;
+
+/** @returns {{ matches:boolean, score:number }} score = pourcentage 0..100 des critères satisfaits. */
+export function matchAlert(alert, tender) {
+  const c = alert?.criteria || {};
+  const text = `${lc(tender?.title)} ${lc(tender?.description)} ${(tender?.keywords || []).map(lc).join(' ')}`;
+  // Exclusions : un seul mot exclu présent ⇒ rejet immédiat.
+  if (has(c.excludeKeywords) && c.excludeKeywords.some((k) => text.includes(lc(k)))) return { matches: false, score: 0 };
+  let score = 0, maxScore = 0;
+  if (has(c.keywords)) { maxScore += 30; const matched = c.keywords.filter((k) => text.includes(lc(k))); if (matched.length) score += (matched.length / c.keywords.length) * 30; }
+  if (has(c.cpvCodes)) { maxScore += 20; if ((tender?.cpvCodes || []).some((cpv) => c.cpvCodes.includes(cpv))) score += 20; }
+  if (c.budget) { maxScore += 15; const v = tender?.financial?.estimatedValue ?? 0; if ((c.budget.min == null || v >= c.budget.min) && (c.budget.max == null || v <= c.budget.max)) score += 15; }
+  if (has(c.types)) { maxScore += 10; if (c.types.includes(tender?.type)) score += 10; }
+  if (has(c.procedures)) { maxScore += 10; if (c.procedures.includes(tender?.procedure)) score += 10; }
+  if (c.location) { maxScore += 15; const L = c.location, loc = tender?.location || {};
+    if (L.departments?.includes(loc.department) || L.regions?.includes(loc.region) || L.cities?.includes(tender?.organization?.address?.city)) score += 15; }
+  const finalScore = maxScore > 0 ? (score / maxScore) * 100 : 0;
+  return { matches: finalScore >= 30, score: Math.round(finalScore) };
+}
+
+/** Prochaine exécution selon la fréquence (immediate|daily|weekly|monthly). */
+export function nextRun(alert, now = new Date()) {
+  const f = alert?.notifications?.frequency || 'daily'; const sch = alert?.notifications?.schedule || {};
+  const d = new Date(now);
+  if (f === 'immediate') return now;
+  const at = (x) => { x.setHours(sch.hour ?? 9, sch.minute ?? 0, 0, 0); return x; };
+  if (f === 'daily') { d.setDate(d.getDate() + 1); return at(d); }
+  if (f === 'weekly') { const target = sch.dayOfWeek ?? 1; const delta = ((target - d.getDay() + 7) % 7) || 7; d.setDate(d.getDate() + delta); return at(d); }
+  if (f === 'monthly') { d.setMonth(d.getMonth() + 1, 1); return at(d); }
+  d.setDate(d.getDate() + 1); return at(d);
+}

package/src/memory-repo.js

@@ -0,0 +1,2 @@
+function coll(){const m=new Map();let s=0;return{create:async d=>{const id=String(++s),r={id,...d};m.set(id,r);return r;},get:async id=>m.get(id)||null,list:async()=>[...m.values()],find:async p=>[...m.values()].filter(p),update:async(id,patch)=>{const r=m.get(id);if(!r)return null;const u={...r,...patch};m.set(id,u);return u;}};}
+export function createMemoryRepositories(){return{alerts:coll()};}

package/src/schemas.js

@@ -0,0 +1,15 @@
+// @mostajs/aop-alerts — schéma ORM. @author Dr Hamid MADANI <drmdh@msn.com>
+export const AlertSchema = {
+  name: 'Alert', collection: 'alerts', timestamps: true,
+  fields: {
+    userId: { type: 'string', default: null }, companyId: { type: 'string', default: null },
+    name: { type: 'string', required: true }, description: { type: 'text', default: '' },
+    criteria: { type: 'json', default: {} },          // { keywords, excludeKeywords, cpvCodes, budget{min,max}, types, procedures, location }
+    notifications: { type: 'json', default: { enabled: true, channels: ['email'], frequency: 'daily' } },
+    stats: { type: 'json', default: { matchCount: 0, notificationsSent: 0 } },
+    isActive: { type: 'boolean', default: true }, isPaused: { type: 'boolean', default: false },
+    priority: { type: 'string', enum: ['low', 'normal', 'high'], default: 'normal' },
+    lastRunAt: { type: 'date', default: null }, nextRunAt: { type: 'date', default: null },
+  },
+  indexes: [{ fields: { userId: 'asc' } }, { fields: { isActive: 'asc' } }],
+};