# Análisis de superficie

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

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

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 | Scope | 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 snapshot](https://developers.backresto.com/es/docs/collections): `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](https://developers.backresto.com/es/docs/facilities) que lo registró, cuando la aplicación guardó 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"
  }
}
```

## 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](https://developers.backresto.com/es/docs/facilities): 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](https://developers.backresto.com/es/docs/collections) antes de contar
muestras, y [la nota sobre exhaustividad](https://developers.backresto.com/es/docs/support) antes de dar el
recuento a nadie.