# Análises de superfície

> Zaragatoas de superfície: o que foi testado, se passou, e o plano de ação quando não passou.

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

Uma análise de superfície é uma zaragatoa. Alguém passa um teste por uma
superfície de trabalho (uma tábua de corte, uma máquina de fatiar, uma
prateleira de câmara frigorífica) e regista o que veio de volta. Um registo
por zaragatoa: o que foi testado, se foi satisfatório, e o que foi decidido
quando não foi.

| Coleção | Scope | O que é um registo |
| --- | --- | --- |
| `surface-analyses` | `surface-analyses:read` | Uma zaragatoa, o seu veredito, e o plano de ação por trás dele. |

Partilha o [envelope de snapshot](https://developers.backresto.com/pt/docs/collections): `id`, `deleted`,
`capturedAt`, `receivedAt`, `sequence` e os restantes ficam à volta do `data`
abaixo.

## `surface-analyses`

| Campo | Tipo | Significado |
| --- | --- | --- |
| `timestamp` | string, **obrigatório** | Quando a zaragatoa foi feita, em milissegundos desde a época Unix, em forma de cadeia de caracteres. |
| `name` | string, **obrigatório** | O que foi testado. Texto livre, escrito pela pessoa. |
| `isSatisfactory` | boolean, **obrigatório** | O veredito que foi registado. |
| `actionPlan` | string \| null | O que foi decidido a esse respeito. Texto livre. |
| `userId` | string \| null | O [funcionário](https://developers.backresto.com/pt/docs/facilities) que a registou, quando a aplicação guardou um. |

```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"
  }
}
```

## Como os ler

**`isSatisfactory` é um veredito que foi emitido, não um que lhe caiba
calcular.** É o que o laboratório comunicou ou o que o operador concluiu ali
mesmo, registado tal como foi dado. Não há no registo limiar, contagem nem
unidade a partir dos quais o recalcular, e não deve andar à procura de um:
apresente-o como o veredito deles, nas palavras deles e, se houver discordância,
deixe que sejam eles a resolvê-la.

**`name` é texto, não uma referência.** Não aponta para uma
[zona nem para um equipamento](https://developers.backresto.com/pt/docs/facilities): não há aqui identificador
nenhum pelo qual unir. Duas zaragatoas da mesma superfície com um mês de
intervalo podem estar escritas de duas maneiras diferentes, por isso só agrupe
por este campo se estiver disposto a normalizá-lo, e nunca apresente um nome
normalizado como aquele que foi registado.

**`actionPlan` é texto livre e é independente do veredito.** É `null` quando
não foi escrito nada, o que não é o mesmo que nada ter sido feito, e pode estar
ausente numa zaragatoa não satisfatória. Não deduza um campo a partir do outro,
e não construa uma enumeração a partir de um campo em que as pessoas escrevem
frases.

E a ressalva que se aplica a todas as coleções aplica-se também aqui: o que
recebe é o que esta API recebeu, não o histórico completo do restaurante. Veja
[a página do envelope](https://developers.backresto.com/pt/docs/collections) antes de contar zaragatoas, e
[a nota sobre a completude](https://developers.backresto.com/pt/docs/support) antes de comunicar a contagem a quem
quer que seja.