Analisi di superficie

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

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: 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 che l'ha registrato, quando l'app ne ha conservato uno.

{
  "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: 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 prima di contare i tamponi, e la nota sulla completezza prima di comunicare il conteggio a chiunque.