# Analisi di superficie

> Tamponi di superficie: cosa è stato analizzato, se ha superato la prova e il piano d'azione quando non l'ha superata.

Source: https://developers.backresto.com/it/docs/surface-analyses

Un'analisi di superficie è un tampone. Qualcuno passa un test su un piano di
lavoro (un tagliere, un'affettatrice, un ripiano di cella frigorifera) e
registra cosa è risultato. Un record per tampone: cosa è stato analizzato, se
era soddisfacente, e cosa è stato deciso quando non lo era.

| Collezione | Scope | Che cos'è un record |
| --- | --- | --- |
| `surface-analyses` | `surface-analyses:read` | Un tampone, il suo verdetto e il piano d'azione che ne è seguito. |

Condivide l'[involucro di snapshot](https://developers.backresto.com/it/docs/collections): `id`, `deleted`,
`capturedAt`, `receivedAt`, `sequence` e gli altri stanno attorno al `data` qui
sotto.

## `surface-analyses`

| Campo | Tipo | Significato |
| --- | --- | --- |
| `timestamp` | string, **obbligatorio** | Quando è stato effettuato il tampone, millisecondi dall'epoch come stringa. |
| `name` | string, **obbligatorio** | Cosa è stato analizzato. Testo libero, digitato dalla persona. |
| `isSatisfactory` | boolean, **obbligatorio** | Il verdetto che è stato registrato. |
| `actionPlan` | string \| null | Cosa è stato deciso al riguardo. Testo libero. |
| `userId` | string \| null | Il [membro del personale](https://developers.backresto.com/it/docs/facilities) che l'ha registrato, quando l'app ne ha conservato uno. |

```json
{
  "id": "6f1d92c4-0b7a-4d31-9f18-3a6c2e5b7d40",
  "collection": "surface-analyses",
  "deleted": false,
  "capturedAt": "1789815240512",
  "receivedAt": "1789815312004",
  "sequence": "412",
  "data": {
    "timestamp": "1789812000000",
    "name": "Planche de découpe viande",
    "isSatisfactory": false,
    "actionPlan": "Désinfection renforcée, nouveau prélèvement lundi",
    "userId": "b3f7c1a0-5d42-4e88-9a16-7c0e2d4b9f31"
  }
}
```

## Leggerle

**`isSatisfactory` è un verdetto che è stato emesso, non uno che calcola lei.**
È ciò che ha riportato il laboratorio o ciò che l'operatore ha concluso sul
posto, registrato così com'è stato dato. Nel record non c'è né una soglia, né un
conteggio, né un'unità da cui ricalcolarlo, e non deve andarli a cercare: lo
presenti come il loro verdetto, nelle loro parole, e lasci che un disaccordo sia
una faccenda loro.

**`name` è testo, non un riferimento.** Non punta a un'[area o a
un'apparecchiatura](https://developers.backresto.com/it/docs/facilities): qui non c'è alcun id su cui fare una
join. Due
tamponi sulla stessa superficie a un mese di distanza possono essere scritti in
due modi diversi, quindi ci raggruppi sopra solo se è disposto a normalizzare, e
non presenti mai un nome normalizzato come quello che è stato registrato.

**`actionPlan` è testo libero ed è indipendente dal verdetto.** È null quando
non è stato digitato nulla, il che non equivale a dire che non sia stato fatto
nulla, e può mancare su un tampone non soddisfacente. Non deduca un campo
dall'altro, e non costruisca un enum a partire da un campo in cui le persone
scrivono frasi.

E l'avvertenza che vale per ogni collezione vale anche qui: quello che ottiene è
ciò che questa API ha ricevuto, non lo storico completo del ristorante. Veda
[la pagina sull'involucro](https://developers.backresto.com/it/docs/collections) prima di contare i tamponi, e
[la nota sulla completezza](https://developers.backresto.com/it/docs/support) prima di comunicare il conteggio a
chiunque.