c7714e3e8a
Migrations :
- import_batches (uuid id, organization_id FK CASCADE)
- import_drafts (uuid id, batch_id FK CASCADE, filename, pdf_storage_key nullable, extracted/edited/confidence en jsonb, status ENUM PG natif pending/validated/skipped, invoice_id FK SET NULL)
Schema rules : tape précisément extracted/edited/confidence (sinon `any`) + status enum.
Services :
- OcrProvider : interface (storageKey + filename → champs avec confiance par champ)
- MockOcrProvider : génère des champs plausibles depuis le filename (numero parsed via regex, montants random multiples de 50cts, dates ISO décalées) + 30 % de cas avec emails à confiance basse pour simuler la review UX
- getOcrProvider() : sélectionne via OCR_PROVIDER env var (default mock, mistral en attente d'ADR-020)
- createImportBatchFromFilenames : compose extracted/edited/confidence par draft, tente un match client immédiat (case-insensitive sur le nom) pour pré-remplir clientId
- resolveClient extrait dans un service partagé (3 priorités : clientId → match nom → création + email requis), réutilisé par invoices_controller et import_batches_controller
Endpoints (auth + scope par organization) :
- POST /invoices/upload : V1 mock body { filenames[] }, 201 → ImportBatch avec ses drafts. Multipart upload réel quand Mistral arrivera, contrat de réponse identique.
- GET /invoices/import-batch/:id : poll pendant la review
- POST /invoices/import-batch/:id/drafts/:draftId/validate : crée Invoice (résolution client) + draft.status=validated + draft.invoiceId
- POST .../drafts/:draftId/skip : draft.status=skipped (idempotent)
- DELETE /invoices/import-batch/:id : CASCADE drop drafts, les invoices validées restent
Routes : ordre soigné — /upload, /counts, /import-batch/* AVANT /:id pour éviter le shadowing.
Bruno : nouveau dossier 06-Imports avec 5 requêtes documentées + capture batchId/draftId dans l'env local. README mis à jour avec le parcours étendu (étapes 11-13).
62 lines
1.8 KiB
TypeScript
62 lines
1.8 KiB
TypeScript
import type { TransactionClientContract } from '@adonisjs/lucid/types/database'
|
|
import Client from '#models/client'
|
|
|
|
export type ResolveClientInput = {
|
|
clientId?: string | null
|
|
clientName: string
|
|
clientEmail?: string | null
|
|
}
|
|
|
|
export type ResolveClientResult =
|
|
| { client: Client; created: boolean }
|
|
| { errorCode: 'client_email_required' }
|
|
|
|
/**
|
|
* Résolution client à la création de facture / validation d'import OCR.
|
|
*
|
|
* Priorité (mêmes règles côté API que côté MSW) :
|
|
* 1. `clientId` fourni + existant dans l'org → utilise tel quel.
|
|
* 2. Match par nom (case-insensitive) sur les clients de l'org.
|
|
* 3. Création à la volée → `clientEmail` REQUIS, sinon
|
|
* `{ errorCode: 'client_email_required' }`.
|
|
*
|
|
* Le contrôleur appelant transforme l'erreur en HTTP 422 avec le code stable.
|
|
*/
|
|
export async function resolveClient(
|
|
organizationId: string,
|
|
fields: ResolveClientInput,
|
|
trx: TransactionClientContract
|
|
): Promise<ResolveClientResult> {
|
|
if (fields.clientId) {
|
|
const c = await Client.query({ client: trx })
|
|
.where('organization_id', organizationId)
|
|
.where('id', fields.clientId)
|
|
.first()
|
|
if (c) return { client: c, created: false }
|
|
}
|
|
|
|
const matched = await Client.query({ client: trx })
|
|
.where('organization_id', organizationId)
|
|
.whereILike('name', fields.clientName)
|
|
.first()
|
|
if (matched) return { client: matched, created: false }
|
|
|
|
if (!fields.clientEmail) {
|
|
return { errorCode: 'client_email_required' }
|
|
}
|
|
|
|
const created = await Client.create(
|
|
{
|
|
organizationId,
|
|
name: fields.clientName,
|
|
email: fields.clientEmail,
|
|
phone: null,
|
|
address: null,
|
|
siret: null,
|
|
notes: null,
|
|
},
|
|
{ client: trx }
|
|
)
|
|
return { client: created, created: true }
|
|
}
|