Backend — soc_ff_backend

API principale de SocFF. Construite avec Express.js, Prisma (ORM) et TypeScript.

Démarrage

# Stack complet
docker compose -f soc_ff_backend/docker-compose.yml up -d

# Serveur de dev seul
docker compose -f soc_ff_backend/docker-compose.yml run -it --rm web npm run dev

Structure

soc_ff_backend/
├── main.ts              # Point d'entrée Express
├── cli.ts               # Outil CLI autonome
├── src/
│   ├── routes/          # Définitions des routes
│   ├── controllers/     # Handlers par domaine
│   ├── services/        # Logique métier
│   │   ├── ocr/         # Pipeline OCR
│   │   ├── invoices/    # CRUD factures
│   │   ├── edi/         # Génération EDI
│   │   ├── email/       # Office365
│   │   └── ...
│   ├── repository/      # Accès Prisma
│   └── cron/            # Tâches planifiées
└── prisma/
    ├── schema.prisma
    └── migrations/

Migrations Prisma

# Créer et appliquer une migration
docker compose -f soc_ff_backend/docker-compose.yml run -it --rm web \
  npx prisma migrate dev --name <nom_migration>

# Régénérer le client Prisma
docker compose -f soc_ff_backend/docker-compose.yml run -it --rm web \
  npx prisma generate

Cron jobs

Fichier	Horaires	Rôle
dataleon.cron.ts	21h30 quotidien	Feedback OCR
import.cron.ts	18h25, toutes les heures	Sync ERP
socff.cron.ts	Toutes les heures (6h-22h)	Workflow factures
socorder.cron.ts	Toutes les minutes (6h-23h)	Commandes & encours
edi/integrationErp.ts	Toutes les minutes (6h-23h)	Export EDI