@mostajs/agora-sourcing

Auteur : Dr Hamid MADANI [email protected] · Licence : AGPL-3.0-or-later Statut : ⚠️ proposition / scaffold (0.0.1) — non implémenté, périmètre à valider (cas C).

Le sourcing maison — « moins d'IA, plus d'outils ». Au lieu de demander à un LLM de chercher les offres (où il hallucine et ne sait pas optimiser), agora-sourcing scrape les faits, calcule la meilleure décision d'achat, puis ne laisse au LLM que la synthèse.

SCRAPE (faits)              OPTIMISE (décision)               RFQ / PRÉSENTE
moteur agora (cheerio)  →   @mostajs/ro-pla (solve)        →  @mostajs/sourcing (sendRfqs)
registre de scrapers       min-cost-flow / MILP / hungarian    + Top-N
   prix, devise, lien          allocation optimale

Trois briques composées

| Brique | Module | Rôle | |---|---|---| | Collecte | moteur agora (extrait d'AgoraScope-Studio) | scraping cheerio (+ puppeteer optionnel), registre de scrapers façon ORM, anti-bot (rate-limit/retries/CloudFlare), search/scrape | | Optimisation | @mostajs/ro-pla (composé) | transforme les offres en problème exact : achat fractionné (min-cost-flow), sélection sous contraintes (MILP), affectation (hungarian) | | RFQ | @mostajs/sourcing (composé) | sendRfqs, modèle Offer, dispatchers — réutilisé, pas réécrit |

API (esquisse)

agoraSource(query | order, { qty, constraints }) → {
  offers,       // offres scrappées (faits : fournisseur, prix+devise, MOQ, pays, lien)
  allocation,   // décision d'achat optimale (ro-pla) : combien acheter chez qui
  topN          // Top-N par prix (référence)
}

Tout injecté (DI) : scrapers, solveur ro-pla, dispatchers RFQ — le module est agnostique et testable par stub (règle d'or).

Périmètre

• Numérique : réutilise les 21 scrapers d'AgoraScope-Studio (templates/code/apps).
• Physique (négoce) : ajoute connecteurs e-commerce (Amazon/AliExpress/Alibaba…) + découverte moteur de recherche (query → URLs candidates → scrape). (Hypothèse de travail : négoce = physique ; ajustable.)

Conformité

Respect robots.txt / CGU par défaut, rate-limit, identification UA ; pas de contournement abusif. Voir livrable #15 (sécurité/abus) avant prod.

Livrables (DEVRULES §14)

• #1 Étude : docs/01-ETUDE-AGORA-SOURCING.md
• #2 Audit : docs/02-AUDIT-AGORA-SOURCING.md
• #3 Plan dev/test : docs/03-PLAN-DEV-TEST-AGORA-SOURCING.md

⚠️ Non implémenté : ce README décrit l'intention. Voir le plan pour le séquencement.