# SINGLE_EVALUATION_FLOW

## Scopo
Descrive il flusso frontend della funzionalità **Evaluación Individual** (route: `/evaluations/single`) e il passaggio alla pagina risultati **FastCheck** (route: `/fast-check-ex`), includendo le chiamate API effettuate dal frontend.

## Componenti coinvolti
- **UI form valutazione**: `src/pages/evaluations/SingleEvaluation.tsx`
- **Pagina risultati**: `src/pages/FastCheckEX.tsx`
- **Client HTTP**: `src/services/api.ts` (`apiClient`)
- **Auth**: `src/contexts/AuthContext.tsx` + `src/services/authService.ts`
- **Tenant/Crediti**: `src/contexts/TenantContext.tsx`

## Base URL API
Il frontend usa:
- `globalThis.__APP_ENV__?.VITE_API_BASE_URL`
- fallback: `https://duxiter.azurianlab.com/api`

Tutte le chiamate sotto sono relative a questa base URL.

## Flusso ad alto livello
1. L’utente apre **Evaluación Individual** (`/evaluations/single`)
2. Il frontend carica contesto sessione/tenant (token + crediti)
3. L’utente inserisce e conferma il **RUT** (validazione lato client + accettazione termini)
4. Alla submit:
   - controlla se esiste già un risultato in DB
   - se esiste: reindirizza direttamente a **FastCheck** con `rut` in querystring
   - se non esiste: avvia `lookup` e poi reindirizza a **FastCheck**
5. In **FastCheck** vengono caricati i dettagli del risultato e i dati “accessori” (AI analysis, liste, note, ecc.)

## Normalizzazione RUT (frontend)
- Durante digitazione il RUT viene formattato.
- Prima delle API, il RUT viene “sanitizzato” togliendo i punti: `formattedRut.replace(/\./g, '')`
- L’hyphen rimane (es. `12.345.678-9` → `12345678-9`)

## Diagramma (sequenza)

```mermaid
sequenceDiagram
  autonumber
  actor U as Utente
  participant SE as FE: /evaluations/single (SingleEvaluation.tsx)
  participant AC as FE: AuthContext/AuthService
  participant TC as FE: TenantContext
  participant API as Backend API (VITE_API_BASE_URL)
  participant FC as FE: /fast-check-ex (FastCheckEX.tsx)

  U->>SE: Apre pagina
  SE->>AC: Ripristina sessione (token in localStorage)
  AC->>API: GET /auth/me
  SE->>TC: Carica tenant/crediti
  TC->>API: GET /tenant (Bearer token)

  U->>SE: Inserisce RUT + accetta termini
  U->>SE: Submit

  SE->>API: GET /rut/results/rut/{rutSanitized}
  alt Esiste già un risultato
    SE-->>FC: navigate("/fast-check-ex?rut={rutSanitized}")
  else Non esiste (404)
    SE->>API: POST /rut/lookup { rut: rutSanitized, isMonitoring: false }
    SE-->>FC: navigate("/fast-check-ex?rut={rutSanitized}")
  end

  FC->>API: GET /rut/results/rut/{rutSanitized} (opzionale ?risk=true)
  opt Se non c'è rut o serve "latest"
    FC->>API: GET /rut/results/latest
    FC->>API: GET /rut/results/rut/{latestRut}
  end
  opt Funzioni accessorie in FastCheck
    FC->>API: GET /rut/ai-analysis/{rut} (opzionale ?regenerate=true)
    FC->>API: POST /rut/fast-check-summary/{rut} { summary }
    FC->>API: GET /lpalto/search/rut/{rut}
    FC->>API: GET /lpmedio/search/rut/{rut}
    FC->>API: GET /antiunion-cases/rut/{rut}
    FC->>API: GET /user-notes/rut/{rut}
    FC->>API: POST /user-notes { rut, note, tags }
    FC->>API: PUT /user-notes/{noteId} { note, tags }
    FC->>API: DELETE /user-notes/{noteId}
    FC->>API: PUT /rut/results/rut/{rut}/update-pep-status { ... }
  end
```

## Chiamate API per “Evaluación Individual” (pagina `/evaluations/single`)
Chiamate direttamente collegate al submit:

1. **Controllo esistenza risultato**
- `GET /rut/results/rut/{rut}`
  - Se risponde con dati: considerato “già esistente” → redirect a FastCheck
  - Se 404: procede con `lookup`

2. **Avvio valutazione**
- `POST /rut/lookup`
  - Body: `{ "rut": "{rut}", "isMonitoring": false }`
  - In seguito redirect a FastCheck

## Chiamate “di contesto” (sessione/tenant)
Queste possono avvenire mentre l’utente è su `/evaluations/single`:

- `GET /auth/me` (ripristino sessione)
- `GET /tenant` (crediti/tenant; header `Authorization: Bearer <token>`)

## Caricamento risultati (pagina `/fast-check-ex`)
FastCheck usa tipicamente questi endpoint per mostrare il risultato della valutazione:

- `GET /rut/results/rut/{rut}` (opzionale `?risk=true`)
- `GET /rut/results/{resultId}` (opzionale `?risk=true`)
- `GET /rut/results/latest`

In base alle feature attive in UI, possono aggiungersi:
- `GET /rut/ai-analysis/{rut}` (opzionale `?regenerate=true`)
- `POST /rut/fast-check-summary/{rut}`
- `GET /lpalto/search/rut/{rut}`
- `GET /lpmedio/search/rut/{rut}`
- `GET /antiunion-cases/rut/{rut}`
- Note utente:
  - `GET /user-notes/rut/{rut}`
  - `POST /user-notes`
  - `PUT /user-notes/{noteId}`
  - `DELETE /user-notes/{noteId}`
- Aggiornamento stato PEP:
  - `PUT /rut/results/rut/{rut}/update-pep-status`

## Stati e UX (sintesi)
- Submit bloccato se:
  - RUT non valido
  - termini non accettati
  - loading in corso
- Se crediti tenant = 0: viene mostrato un dialog informativo.
- In caso di errore non-404 nel check esistenza: viene loggato ma il flusso continua con `lookup`.

## Note operative
- Il redirect a `/fast-check-ex` è parte integrante del flusso: la pagina “Evaluación Individual” funge da avvio/trigger, mentre la visualizzazione del risultato avviene in FastCheck.