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.

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	Âmbito	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 instantâneo: 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 que a registou, quando a aplicação guardou um.

{
  "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 tomado, não um que você calcule. É 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 deixe que uma discordância seja deles para resolver.

name é texto, não uma referência. Não aponta para uma zona nem para um equipamento — 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 antes de contar zaragatoas, e a nota sobre a completude antes de comunicar a contagem a quem quer que seja.