# Oberflächenanalysen

> Oberflächenabstriche: was geprüft wurde, ob es bestanden wurde und der Maßnahmenplan, wenn nicht.

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

Eine Oberflächenanalyse ist ein Abstrich. Jemand führt einen Test über eine
Arbeitsfläche (ein Schneidbrett, eine Aufschnittmaschine, ein Regal im
Kühlraum) und erfasst, was dabei herauskam. Ein Datensatz pro Abstrich: was
geprüft wurde, ob es zufriedenstellend war und was entschieden wurde, wenn
nicht.

| Collection | Scope | Was ein Datensatz ist |
| --- | --- | --- |
| `surface-analyses` | `surface-analyses:read` | Ein Abstrich, sein Urteil und der Maßnahmenplan dahinter. |

Sie teilt sich den [Snapshot-Umschlag](https://developers.backresto.com/de/docs/collections): `id`, `deleted`,
`capturedAt`, `receivedAt`, `sequence` und der Rest stehen um das `data`
darunter herum.

## `surface-analyses`

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `timestamp` | string, **Pflicht** | Wann der Abstrich genommen wurde, als String mit Millisekunden seit Epoch. |
| `name` | string, **Pflicht** | Was geprüft wurde. Freitext, von der Person getippt. |
| `isSatisfactory` | boolean, **Pflicht** | Das Urteil, das erfasst wurde. |
| `actionPlan` | string \| null | Was darüber entschieden wurde. Freitext. |
| `userId` | string \| null | Der [Mitarbeiter](https://developers.backresto.com/de/docs/facilities), der ihn erfasst hat, sofern die App einen behalten hat. |

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

## Sie richtig lesen

**`isSatisfactory` ist ein gefälltes Urteil, keines, das Sie berechnen.** Es
ist, was das Labor gemeldet oder was die Person vor Ort geschlossen hat, so
erfasst, wie es gegeben wurde. Es gibt im Datensatz weder Schwelle noch Anzahl
noch Einheit, um es nachzurechnen, und Sie sollten auch nicht danach suchen:
Stellen Sie es als deren Urteil dar, in deren Worten, und überlassen Sie eine
Meinungsverschiedenheit denen, die sie zu klären haben.

**`name` ist Text, keine Referenz.** Es zeigt nicht auf einen
[Bereich oder ein Gerät](https://developers.backresto.com/de/docs/facilities): Hier gibt es keine Kennung, über
die Sie verbinden könnten. Zwei Abstriche derselben Fläche im Abstand eines
Monats können zweierlei geschrieben sein; gruppieren Sie also nur darauf, wenn
Sie bereit sind zu normalisieren, und geben Sie einen normalisierten Namen nie
als den aus, der erfasst wurde.

**`actionPlan` ist Freitext und vom Urteil unabhängig.** Es ist `null`, wenn
nichts getippt wurde, und das ist nicht dasselbe, wie dass nichts getan wurde;
es kann auch bei einem nicht zufriedenstellenden Abstrich fehlen. Schließen Sie
nicht von einem Feld auf das andere, und bauen Sie kein Enum aus einem Feld, in
das Leute Sätze schreiben.

Und der Vorbehalt, der für jede Collection gilt, gilt auch hier: Was Sie
bekommen, ist, was diese API empfangen hat, nicht die vollständige Geschichte
des Restaurants. Lesen Sie [die Seite zum Umschlag](https://developers.backresto.com/de/docs/collections), bevor
Sie Abstriche zählen, und
[die Anmerkung zur Vollständigkeit](https://developers.backresto.com/de/docs/support), bevor Sie die Anzahl
irgendjemandem melden.