SocFF — Plateforme de gestion de factures fournisseurs

Bienvenue dans la documentation de SocFF, la plateforme de gestion des factures fournisseurs et bons de commande de Socodicor.

Présentation

SocFF orchestre l'ensemble du cycle de vie d'une facture fournisseur :

Réception — email Office365, scan OCR, dépôt FTP
Validation — interface web de contrôle et validation
Intégration ERP — export EDI vers CEGID, SAP ou BLG

Sous-projets

Projet	Rôle	Port
`soc_ff_backend`	API principale (Express.js + Prisma)	8081
`soc_ff_frontend`	Interface web (Next.js 14)	10021
`soc_ff_cegid`	Connecteur ERP CEGID (NestJS)	10085
`soc_ff_sap`	Connecteur ERP SAP (NestJS)	10088
`soc_ff_blg`	Connecteur ERP BLG Cloud (NestJS)	variable
`soc_ff_recup_avoir_edi`	CLI — récupération avoirs EDI	—
`soc_ff_budget_repartition_facture_achat`	CLI — répartition budget achats	—
`soc_ff_budget_ca_facture_achat`	CLI — analyse CA sur factures achats	—

Démarrage rapide

# Lancer le stack complet (backend + DB + MinIO + SQS + MailCatcher)
docker compose -f soc_ff_backend/docker-compose.yml up -d

# Lancer le frontend
cd soc_ff_frontend && npm run dev

Connecteur ERP actif

Le connecteur ERP utilisé est défini par la variable TYPE_ERP dans le .env du backend. Valeurs possibles : "SAP", "CEGID", "BLG".

Flux de traitement

Fournisseur (email / scan / FTP)
        │
        ▼
┌───────────────────────┐
│    soc_ff_backend     │  ← OCR (Dataleon)
│   Express / Prisma    │  ← Email Office365
│      Port 8081        │  ← AWS SQS
└──────────┬────────────┘
           │ REST + WebSocket
           ▼
┌───────────────────────┐
│   soc_ff_frontend     │
│   Next.js / Port 10021│
└──────────┬────────────┘
           │ (selon TYPE_ERP)
     ┌─────┼─────┐
     ▼     ▼     ▼
  CEGID   SAP   BLG
           │
           ▼
    MSSQL SOCODICOR