fa52468a80
Banner upload compact/directiv (fara 'mediu global' derutant), text Cont onest (importul web fara mediu activ nu are creds -> esueaza), si aliniere referinta navigare la 'Meniu cont › Cont' in erori/integrare (nu exista 'tab-ul Cont' in UI). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
250 lines
8.6 KiB
Python
250 lines
8.6 KiB
Python
"""Catalog central de erori AutoPass.
|
||
|
||
Singura sursa de adevar care mapeaza fiecare cod de eroare la (problema, fix),
|
||
cu un helper care construieste obiectul de eroare pe 3 niveluri:
|
||
- nivel 1 (tehnic): `cod` + `cauza` — ce s-a intamplat exact
|
||
- nivel 2 (utilizator): `problema` — descriere scurta, inteligibila
|
||
- nivel 3 (actiune): `fix` — ce trebuie facut pentru a remedia
|
||
|
||
Modul PUR — fara import DB sau HTTP.
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# CATALOG
|
||
# cheie = cod (string), valoare = {"problema": str, "fix": str}
|
||
# ---------------------------------------------------------------------------
|
||
|
||
CATALOG: dict[str, dict[str, str]] = {
|
||
"VIN_FORMAT": {
|
||
"problema": "VIN invalid",
|
||
"fix": (
|
||
"Verifica VIN-ul pe talon (pozitia E) sau pe caroserie: exact 17 caractere"
|
||
" majuscule, fara spatii si fara literele O, I, Q."
|
||
),
|
||
},
|
||
"NR_INMATRICULARE_FORMAT": {
|
||
"problema": "Numar de inmatriculare invalid",
|
||
"fix": (
|
||
"Foloseste doar litere si cifre majuscule, maxim 10 caractere, fara spatii"
|
||
" sau cratima (ex. B123ABC)."
|
||
),
|
||
},
|
||
"DATA_FORMAT": {
|
||
"problema": "Data prestatiei in format gresit",
|
||
"fix": "Scrie data ca AAAA-LL-ZZ (ex. 2026-06-22).",
|
||
},
|
||
"DATA_PREA_VECHE": {
|
||
"problema": "Data prestatiei prea veche",
|
||
"fix": (
|
||
"RAR accepta prestatii doar incepand cu 01.12.2024;"
|
||
" verifica data prestatiei."
|
||
),
|
||
},
|
||
"DATA_VIITOR": {
|
||
"problema": "Data prestatiei in viitor",
|
||
"fix": "Data prestatiei nu poate fi dupa ziua de azi; corecteaza data.",
|
||
},
|
||
"ODOMETRU_FINAL_FORMAT": {
|
||
"problema": "Odometru final invalid",
|
||
"fix": (
|
||
"Scrie kilometrajul final ca numar intreg, fara zecimale sau text"
|
||
" (ex. 145000)."
|
||
),
|
||
},
|
||
"ODOMETRU_INITIAL_LIPSA": {
|
||
"problema": "Lipseste odometrul initial",
|
||
"fix": (
|
||
"Prestatiile R-ODO / I-ODO cer kilometrajul initial; completeaza-l."
|
||
),
|
||
},
|
||
"ODOMETRU_INITIAL_FORMAT": {
|
||
"problema": "Odometru initial invalid",
|
||
"fix": (
|
||
"Scrie kilometrajul initial ca numar intreg, fara zecimale sau text."
|
||
),
|
||
},
|
||
"ODOMETRU_INITIAL_ORDINE": {
|
||
"problema": "Odometru initial mai mare decat finalul",
|
||
"fix": (
|
||
"Kilometrajul initial trebuie sa fie mai mic sau egal cu cel final;"
|
||
" verifica cele doua valori."
|
||
),
|
||
},
|
||
"PRESTATII_GOALE": {
|
||
"problema": "Nicio prestatie",
|
||
"fix": "Adauga cel putin o prestatie cu cod RAR valid.",
|
||
},
|
||
"B64_INVALID": {
|
||
"problema": "Imaginea nu este base64 valid",
|
||
"fix": (
|
||
"Trimite imaginea codata base64 corect, sau omite campul daca nu ai imagine."
|
||
),
|
||
},
|
||
"COD_NEMAPAT": {
|
||
"problema": "Lipseste codul RAR al operatiei",
|
||
"fix": (
|
||
"Alege codul RAR pentru aceasta operatie in tab-ul Mapari"
|
||
" (ai sugestii automate)."
|
||
),
|
||
},
|
||
"AUTO_SEND_OPRIT": {
|
||
"problema": "Necesita confirmare manuala",
|
||
"fix": (
|
||
"Codul e mapat cu trimitere automata oprita; verifica randul si"
|
||
" pune-l manual in coada."
|
||
),
|
||
},
|
||
"RAR_VALIDARE": {
|
||
"problema": "RAR a respins prezentarea",
|
||
"fix": (
|
||
"Corecteaza campul semnalat de RAR (vezi cauza) si reincearca;"
|
||
" detaliile exacte sunt in mesajul tehnic RAR."
|
||
),
|
||
},
|
||
"RAR_EROARE_SERVER": {
|
||
"problema": "RAR a esuat la inregistrarea prezentarii",
|
||
"fix": (
|
||
"RAR a raspuns cu o eroare de server (vezi cauza). Trimiterea NU se"
|
||
" reincearca automat si NU a fost confirmata — verifica datele (in special"
|
||
" codul prestatiei) si re-trimite dupa corectare."
|
||
),
|
||
},
|
||
"RAR_CREDS_INVALIDE": {
|
||
"problema": "Credentiale RAR invalide",
|
||
"fix": (
|
||
"Verifica email-ul si parola contului RAR in Meniu cont › Cont;"
|
||
" trimiterea nu se reincearca automat la credentiale gresite."
|
||
),
|
||
},
|
||
"IMPORT_FISIER_PREA_MARE": {
|
||
"problema": "Fisier prea mare",
|
||
"fix": (
|
||
"Imparte fisierul in bucati de maxim 5000 de randuri si incarca-le pe rand."
|
||
),
|
||
},
|
||
"CERERE_PREA_MARE": {
|
||
"problema": "Corpul cererii depaseste limita permisa",
|
||
"fix": (
|
||
"Trimite o cerere mai mica (imparte fisierul/lista in bucati mai mici"
|
||
" si retrimite)."
|
||
),
|
||
},
|
||
"IMPORT_ANTET_NECLAR": {
|
||
"problema": "Antet de coloane neclar",
|
||
"fix": (
|
||
"Asigura-te ca primul rand contine numele coloanelor"
|
||
" (ex. VIN, Numar, Data)."
|
||
),
|
||
},
|
||
"IMPORT_ENCODING": {
|
||
"problema": "Codare de caractere nesuportata",
|
||
"fix": "Salveaza fisierul ca CSV UTF-8 (sau xlsx) si reincarca.",
|
||
},
|
||
"IMPORT_FISIER_NERECUNOSCUT": {
|
||
"problema": "Fisier nerecunoscut",
|
||
"fix": "Incarca un fisier .xlsx sau .csv valid.",
|
||
},
|
||
"IMPORT_MULTIPLE_SHEETS": {
|
||
"problema": "Mai multe foi in fisier",
|
||
"fix": "Pastreaza datele intr-o singura foaie sau alege foaia de import.",
|
||
},
|
||
"IMPORT_FARA_MAPARE_COLOANE": {
|
||
"problema": "Coloanele nu sunt mapate",
|
||
"fix": (
|
||
"Mapeaza intai coloanele fisierului la campurile cerute, apoi continua."
|
||
),
|
||
},
|
||
"IMPORT_CONFIRMARE_GRESITA": {
|
||
"problema": "Numar confirmat gresit",
|
||
"fix": (
|
||
"Numarul confirmat difera de randurile gata de trimis;"
|
||
" verifica preview-ul si reconfirma."
|
||
),
|
||
},
|
||
"IMPORT_OVERRIDE_ILIZIBIL": {
|
||
"problema": "Editarea anterioara nu se poate citi",
|
||
"fix": (
|
||
"Editarea salvata este ilizibila (probabil cheia s-a schimbat);"
|
||
" reediteaza randul."
|
||
),
|
||
},
|
||
"COLOANE_FORMAT_JSON": {
|
||
"problema": "Format de coloane (JSON) invalid",
|
||
"fix": (
|
||
"Verifica sintaxa JSON a maparii de coloane"
|
||
" (ghilimele duble, acolade inchise corect)."
|
||
),
|
||
},
|
||
"EROARE_INTERNA": {
|
||
"problema": "Eroare interna a gateway-ului",
|
||
"fix": (
|
||
"Nu e o problema de date trimise de tine. Reincearca peste cateva"
|
||
" momente; daca persista, contacteaza administratorul cu identificatorul"
|
||
" cererii (request_id) afisat."
|
||
),
|
||
},
|
||
# Coduri de plan (PRD 5.17)
|
||
"PLAN_LIMITA_LUNARA": {
|
||
"problema": "Ai atins limita planului Gratuit (60 prestatii/luna)",
|
||
"fix": (
|
||
"Treci pe planul Standard sau Pro, sau asteapta inceperea lunii urmatoare."
|
||
" Numarul de prestatii ramase in luna curenta e in campul cauza."
|
||
),
|
||
},
|
||
"PLAN_FARA_API": {
|
||
"problema": "Importul prin API e disponibil pe planul Pro",
|
||
"fix": (
|
||
"Planul tau curent nu include accesul la API."
|
||
" Endpoint-ul /v1/prezentari/valideaza ramane disponibil pentru testare fara upgrade."
|
||
" Contacteaza-ne pentru a face upgrade la planul Pro."
|
||
),
|
||
},
|
||
"RAR_MEDIU_INDISPONIBIL": {
|
||
"problema": "Mediul RAR cerut nu e disponibil",
|
||
"fix": (
|
||
"Activeaza mediul si introdu credentialele RAR in Meniu cont › Cont."
|
||
" Mediile disponibile acum sunt in campul cauza."
|
||
),
|
||
},
|
||
}
|
||
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# eroare()
|
||
# ---------------------------------------------------------------------------
|
||
|
||
def eroare(
|
||
cod: str,
|
||
*,
|
||
field: str | None = None,
|
||
cauza: str | None = None,
|
||
) -> dict:
|
||
"""Construieste un obiect de eroare pe 3 niveluri din CATALOG.
|
||
|
||
Parametri
|
||
---------
|
||
cod: Codul de eroare (cheie in CATALOG). Ridica KeyError daca absent.
|
||
field: Campul care a generat eroarea (optional, pentru context).
|
||
cauza: Descrierea tehnica a erorii concrete (optional).
|
||
Daca lipseste, `cauza` si `message` preiau valoarea `problema` din catalog.
|
||
|
||
Returneaza
|
||
----------
|
||
dict cu exact cheile: field, cod, problema, cauza, fix, message.
|
||
"""
|
||
entry = CATALOG[cod] # ridica KeyError daca cod absent
|
||
problema = entry["problema"]
|
||
fix = entry["fix"]
|
||
cauza_efectiva = cauza if cauza is not None else problema
|
||
message = cauza if cauza is not None else problema
|
||
return {
|
||
"field": field,
|
||
"cod": cod,
|
||
"problema": problema,
|
||
"cauza": cauza_efectiva,
|
||
"fix": fix,
|
||
"message": message,
|
||
}
|