Análisis de superficie

Tomas de muestra de superficie: qué se analizó, si pasó y el plan de acción cuando no.

Un análisis de superficie es una toma de muestra. Alguien pasa una prueba por una superficie de trabajo —una tabla de cortar, una cortadora, un estante de la cámara frigorífica— y registra lo que salió. Un registro por muestra: qué se analizó, si fue satisfactorio y qué se decidió cuando no lo fue.

Colección	Permiso	Qué es un registro
`surface-analyses`	`surface-analyses:read`	Una muestra, su veredicto y el plan de acción que hay detrás.

Comparte el sobre de instantánea: id, deleted, capturedAt, receivedAt, sequence y los demás campos rodean al data de abajo.

`surface-analyses`

Campo	Tipo	Significado
`timestamp`	string, obligatorio	Cuándo se tomó la muestra, en milisegundos desde la época Unix como cadena.
`name`	string, obligatorio	Qué se analizó. Texto libre, tecleado por la persona.
`isSatisfactory`	boolean, obligatorio	El veredicto que se registró.
`actionPlan`	string \| null	Qué se decidió al respecto. Texto libre.
`userId`	string \| null	El miembro del personal que lo registró, cuando la aplicación guardó 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"
  }
}

Cómo leerlos

isSatisfactory es un veredicto que se emitió, no uno que usted calcule. Es lo que informó el laboratorio o lo que concluyó el operario sobre el terreno, registrado tal cual. En el registro no hay ningún umbral, ningún recuento ni ninguna unidad con que recalcularlo, y no debería ponerse a buscarlos: preséntelo como el veredicto de ellos, en sus palabras, y deje que un desacuerdo lo resuelvan ellos.

name es texto, no una referencia. No apunta a ninguna zona ni a ningún equipo: aquí no hay ningún id con el que cruzar. Dos muestras de la misma superficie con un mes de diferencia pueden estar escritas de dos maneras distintas, así que agrupe por él solo si está dispuesto a normalizar, y nunca presente un nombre normalizado como el que se registró.

actionPlan es texto libre e independiente del veredicto. Es null cuando no se tecleó nada, que no es lo mismo que no haberse hecho nada, y puede faltar en una muestra no satisfactoria. No deduzca un campo del otro, y no construya un enum a partir de un campo en el que la gente escribe frases.

Y la advertencia que vale para todas las colecciones vale también aquí: lo que obtiene es lo que ha recibido esta API, no el historial completo del restaurante. Consulte la página del sobre antes de contar muestras, y la nota sobre exhaustividad antes de dar el recuento a nadie.