# Dokicasa elenco pratiche (SDK): istruzioni di integrazione per assistenti AI

Da consegnare a un assistente AI per mostrare l'elenco delle pratiche di un
account Dokicasa nel sito di un partner. Guida completa: https://docs.dokicasa.it/form/sdk-pratiche

Se manca un dato (API key, domini, pagina dove mostrarlo), chiedilo all'utente. Non inventarlo.

## Stato: beta, attivazione su richiesta

Usa la stessa attivazione dei domini del form `<dokicasa-form>`.

## Come funziona

- Web Component `<dokicasa-practices>` in un solo file JS
  (`https://app.dokicasa.it/contract-form-v2-sdk/practices-v1.js`), Shadow DOM, niente iframe.
- Il server del partner chiede `POST /api/v3/sdk/token` con `{"scope":"practices"}` e la API key;
  nella pagina va solo `user_token` (1 ora, solo sui domini attivati).
- Mostra elenco (filtri, ricerca, pagine), dettaglio con step e documenti, richieste
  (task) da completare con risposta e allegati. Non crea, modifica o cancella pratiche.

## Regole

1. La API key non deve MAI finire nel browser: il token si chiede dal server.
2. Mostra il componente solo a utenti collegati al sito: chi vede la pagina vede tutte
   le pratiche dell'account.
3. Il token del form (senza scope) non apre l'elenco e viceversa: per entrambi servono due token.
4. Quando il token scade (evento `error` con `status` 401) chiedine uno nuovo al server e
   aggiorna l'attributo `user-token`: il componente ricarica i dati.

## Codice

```html
<script src="https://app.dokicasa.it/contract-form-v2-sdk/practices-v1.js"></script>
<dokicasa-practices user-token="dksdk...." heading="Le tue pratiche"></dokicasa-practices>
```

Attributi: `user-token` (obbligatorio), `heading`, `api-base` (solo staging:
`https://testing.dokicasa.it/api`).
Eventi (CustomEvent.detail): `load {total,page}`, `open {practiceId,name}`,
`task-replied {practiceId,taskId}`, `error {message,status}`.
Colori: stesse variabili CSS del form (`--primary`, `--secondary`, ...) sull'elemento.
