# Analyses de surface

> Les prélèvements de surface : ce qui a été testé, s'il est conforme, et le plan d'action quand il ne l'est pas.

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

Une analyse de surface, c'est un prélèvement. Quelqu'un passe un test sur un
plan de travail (une planche à découper, une trancheuse, une étagère de
chambre froide) et consigne ce qui en est ressorti. Un enregistrement par
prélèvement : ce qui a été testé, si c'était satisfaisant, et ce qui a été
décidé quand ça ne l'était pas.

| Collection | Scope | Ce qu'est un enregistrement |
| --- | --- | --- |
| `surface-analyses` | `surface-analyses:read` | Un prélèvement, son verdict, et le plan d'action qui va avec. |

Elle partage l'[enveloppe de snapshot](https://developers.backresto.com/fr/docs/collections) : `id`, `deleted`,
`capturedAt`, `receivedAt`, `sequence` et le reste entourent le `data`
ci-dessous.

## `surface-analyses`

| Champ | Type | Signification |
| --- | --- | --- |
| `timestamp` | string, **obligatoire** | Quand le prélèvement a été pris, en millisecondes depuis l'epoch sous forme de chaîne de caractères. |
| `name` | string, **obligatoire** | Ce qui a été testé. Texte libre, saisi par la personne. |
| `isSatisfactory` | boolean, **obligatoire** | Le verdict qui a été consigné. |
| `actionPlan` | string \| null | Ce qui en a été décidé. Texte libre. |
| `userId` | string \| null | Le [membre du personnel](https://developers.backresto.com/fr/docs/facilities) qui l'a consigné, quand l'application en a gardé un. |

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

## Les lire

**`isSatisfactory` est un verdict qui a été rendu, pas un verdict que vous
calculez.** C'est ce que le laboratoire a rapporté ou ce que l'opérateur a
conclu sur place, consigné tel quel. Il n'y a dans l'enregistrement ni seuil,
ni décompte, ni unité pour le recalculer, et vous ne devriez pas en chercher :
présentez-le comme leur verdict, avec leurs mots, et laissez-leur le soin de
trancher un désaccord.

**`name` est du texte, pas une référence.** Il ne pointe ni vers une
[zone ni vers un équipement](https://developers.backresto.com/fr/docs/facilities) : il n'y a pas d'identifiant ici
sur lequel joindre. Deux prélèvements de la même surface à un mois d'intervalle
peuvent être orthographiés de deux façons différentes : ne groupez dessus que
si vous acceptez de normaliser, et ne présentez jamais un nom normalisé comme
celui qui a été consigné.

**`actionPlan` est du texte libre et indépendant du verdict.** Il vaut `null`
quand rien n'a été saisi, ce qui n'est pas la même chose que rien n'a été fait,
et il peut être absent sur un prélèvement non satisfaisant. Ne déduisez pas un
champ de l'autre, et n'allez pas tirer une énumération d'un champ où les gens
écrivent des phrases.

Et la mise en garde qui vaut pour toutes les collections vaut ici aussi : ce
que vous obtenez, c'est ce que cette API a reçu, pas l'historique complet du
restaurant. Voyez [la page de l'enveloppe](https://developers.backresto.com/fr/docs/collections) avant de compter
des prélèvements, et [la note sur l'exhaustivité](https://developers.backresto.com/fr/docs/support) avant d'en
communiquer le décompte à qui que ce soit.