ordinarthur 19dd71bd93 feat(api): MistralOcrProvider + multipart upload sur /invoices/upload
MistralOcrProvider (app/services/ocr/mistral_ocr_provider.ts) :
- Pipeline 2 étapes : POST /v1/ocr (mistral-ocr-latest) → markdown structuré, puis POST /v1/chat/completions (mistral-large-latest) avec response_format json_schema strict pour extraire les champs typés (clientName/Email, numero, amountTtcCents, issueDate, dueDate) + un objet `_conf` pour la confiance par champ.
- Télécharge le PDF depuis Drive (MinIO en dev) via getArrayBuffer, encode en base64 pour le data URI.
- Throw clair si storageKey null (incompatible avec le mode JSON {filenames}).
- Throw au constructor si MISTRAL_API_KEY manquante.

getOcrProvider() retourne maintenant vraiment Mistral quand OCR_PROVIDER=mistral (plus de fallback silencieux sur mock).

Multipart upload sur POST /invoices/upload :
- Détecte Content-Type. Si multipart/form-data : itère sur `files[]`, valide ext (pdf/png/jpg/jpeg) + size (10mb), upload chaque fichier vers `import-drafts/<orgId>/<draftId>.<ext>` via @adonisjs/drive, puis appelle createImportBatch avec sources [{filename, storageKey}].
- Si JSON : route compat conservée pour le mode démo.

Refactor service import_batch :
- Nouvelle fonction createImportBatch(orgId, sources) générique
- createImportBatchFromFilenames() devient un wrapper compat (storageKey null)
- OCR exécuté HORS transaction (calls réseau Mistral lents — 3-8s par PDF — pas de raison de tenir un lock PG)

Bruno :
- 06-Imports/02 Upload (multipart Mistral).bru — nouveau, body multipart-form avec @file() à sélectionner. Doc : setup .env, where to find files in MinIO console, latence Mistral.
- Renumérote 03/04/05/06 (Get batch / Validate / Skip / Cancel).
- Met à jour 01 Upload (mock) doc pour pointer vers 02 pour le vrai OCR.

Pour tester :
1. .env → OCR_PROVIDER=mistral + MISTRAL_API_KEY=...
2. Restart pnpm dev:api
3. Bruno → Imports → 02 Upload (multipart Mistral) → sélectionne un PDF
4. Bruno → Imports → 03 Get batch (drafts ont pdfStorageKey + extracted depuis l'OCR)
2026-05-06 15:17:11 +02:00
..

Rubis API — Collection Bruno

Collection Bruno qui répertorie toutes les routes de l'API et permet de les tester en suivant un parcours réaliste (signup → onboarding → création client → facture → encaissement).

Installation

  1. Installe Bruno : https://www.usebruno.com/downloads
  2. Dans Bruno, Open Collection → sélectionne le dossier bruno/ à la racine du repo.
  3. Sélectionne l'environnement local dans le sélecteur en haut à droite.

Démarrer l'API

pnpm dev:up      # Postgres, Redis, MinIO, Mailpit
pnpm dev:api     # API sur http://localhost:3333

Si la DB est neuve : pnpm -F api exec node ace migration:run

Variables d'environnement

Définies dans environments/local.bru. Les valeurs vides (token, userId, etc.) sont remplies automatiquement par les script:post-response :

Variable Source Utilisée par
baseUrl en dur (http://localhost:3333) toutes
email / password / fullName en dur (login fixture) Signup, Login
token rempli après Signup/Login toutes les routes auth
userId rempli après Signup/Login (info)
organizationId rempli après Signup/Login (info, debug)
clientId rempli après Create client détail/update client, création facture
planSlug en dur (standard-30j) détail/update plan
invoiceId rempli après Create invoice OU Validate draft détail/mark-paid
batchId / draftId remplis après Upload (mock) Get batch / Validate / Skip / Cancel

Parcours recommandé (premier run)

  1. Auth → 01 Signup (récupère un token + crée l'org + provisionne les 4 plans)
  2. Account → 01 Get profile (vérifie l'auth)
  3. Organizations → 02 Update my org (onboarding step 2)
  4. Clients → 04 Create (crée un client, capture clientId)
  5. Plans → 01 List (vérifie les 4 plans pré-fournis)
  6. Invoices → 04 Create (crée une facture liée au client)
  7. Invoices → 05 Get detail (vérifie la timeline)
  8. Invoices → 06 Mark paid (encaisse + bonus rubis)
  9. Organizations → 01 Get my org (vérifie rubisCount incrémenté)
  10. Clients → 02 List with stats (vérifie les compteurs)
  11. Imports → 01 Upload (mock) (capture batchId + draftId)
  12. Imports → 02 Get batch (review des drafts pending)
  13. Imports → 03 Validate draft (transforme le draft en facture)

Flow refresh (silent re-login)

Une fois Signup ou Login passé, Bruno a stocké le cookie rubis_refresh dans sa cookie jar. Tu peux vider token dans l'env actif (pour simuler une expiration), puis appeler Auth → 04 Refresh : tu reçois un nouveau access token sans devoir re-saisir email/password. C'est ce que le SPA fera silencieusement quand une requête revient en 401.

Reset entre runs

L'email alice@bruno.test est unique en DB → 2e signup retourne 422 email_taken. Pour repartir propre :

docker exec rubis-postgres psql -U rubis -d rubis_dev -c "DROP SCHEMA public CASCADE; CREATE SCHEMA public;"
pnpm -F api exec node ace migration:run

Ou change email dans l'environnement local pour forcer un nouveau signup à chaque run.