feat(T5): editor web mapare operatii (hibrid + fuzzy + on-demand needs_mapping)

T5 reinterpretat: nu import DBF, ci editor web al maparii operatie ROAAUTO ->
cod RAR, cu fuzzy lookup si validare de catre utilizator.

- Contract hibrid: item prestatie accepta cod_prestatie (RAR direct, back-compat)
  SAU cod_op_service+denumire (mapat de gateway prin operations_mapping).
- Ingestie: op intern necunoscut -> submission needs_mapping (nu pleaca la RAR);
  codul rezolvat se scrie inapoi in payload_json -> payload builder + worker neatinse.
- Editor HTMX (_mapari.html + GET /_fragments/mapari, POST /mapari): listeaza
  op-urile nemapate, fuzzy preselecteaza codul RAR, save -> re-rezolvare automata
  (queued / needs_data).
- Fuzzy: rapidfuzz.token_sort_ratio pe denumire normalizata (fara diacritice).
- Nomenclator: seed fallback 18 coduri la boot (offline) + refresh live din worker.
- Cont default id=1 cat timp auth API-key (CORE) nu exista (account_id NULL).
- Endpointuri API: GET /v1/mapari/pending, POST /v1/mapari (respinge cod inexistent).
- 15 teste noi (tests/test_mapping.py); 69 pass total.
- Contract actualizat (docs/api-rar-contract.md), rapidfuzz==3.14.5 in requirements.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/api-rar-contract.md

@@ -265,6 +265,35 @@ Fiecare item din `content` (live):
 7. **URL nomenclator confirmat** = `/nomenclator/getNomenclatorPrestatii` (nu varianta din
    operationId Swagger). Constatarea #5 din `plan-eng-review` (URL-uri din VFP, nu din spec) — confirmată.
 
+## API gateway (ROAAUTO -> gateway): mapare operatii (hibrid, 2026-06-15)
+
+Aceasta e suprafata **gateway-ului**, nu RAR. Un item din `prestatii` la
+`POST /v1/prezentari` poate veni in doua forme (cel putin una obligatorie):
+
+| Camp item | Note |
+|---|---|
+| `cod_prestatie` | cod RAR direct (ex. `OE-1`). Trece neatins -> validare T3 -> coada. |
+| `cod_op_service` | cod intern ROAAUTO. Gateway-ul il traduce in cod RAR prin `operations_mapping`. |
+| `denumire` | denumirea operatiei ROAAUTO; folosita pentru fuzzy lookup in editor. |
+
+Daca lipsesc **ambele** coduri -> `422` (shape). Op cu `cod_op_service` necunoscut
+(fara mapare) -> submission `needs_mapping` (NU se trimite la RAR), apare in editorul
+web. La salvarea maparii, submission-urile blocate pe acel cod se re-rezolva automat
+(-> `queued`, sau `needs_data` daca regula odometru/continut cere asta). Codul RAR
+rezolvat se scrie inapoi in `payload_json`, deci payload builder + worker raman
+code-driven.
+
+Endpointuri noi:
+- `GET /v1/mapari/pending` — operatii nemapate distincte + sugestii fuzzy (`{cod_prestatie, nume_prestatie, score}`).
+- `POST /v1/mapari` `{account_id?, cod_op_service, cod_prestatie, auto_send}` — upsert mapare + re-rezolvare. Respinge `cod_prestatie` inexistent in nomenclator (422).
+- Web: `GET /_fragments/mapari` (editor HTMX), `POST /mapari` (form, salveaza + re-randeaza).
+
+Fuzzy: `rapidfuzz.token_sort_ratio` pe denumire normalizata (fara diacritice, upper).
+Nomenclatorul se ia **live** din RAR (worker upsert la fiecare login); seed fallback
+de 18 coduri la boot (`app/nomenclator_seed.py`) ca editorul sa mearga offline.
+Auth API-key (CORE) inca neimplementat -> `account_id` curge ca `NULL` si e atribuit
+contului default `id=1` (seed in schema); cand auth livreaza, account_id real curge natural.
+
 ## Open questions rămase (actualizat)
 
 1. ~~Sursa pozei odometrului~~ — **închis** (poză opțională).