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.

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	Portée	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 d'instantané : 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 qui l'a consigné, quand l'application en a gardé un.

{
  "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 — 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 avant de compter des prélèvements, et la note sur l'exhaustivité avant d'en communiquer le décompte à qui que ce soit.