Catalogo

Il catalogo è ciò di cui un ristorante tiene un elenco anziché misurarlo: chi consegna, cosa entra dalla porta, e cosa la cucina prepara da sé. Qui niente è un controllo o una lettura. Sono le righe che tutto il resto nomina, quindi di solito sono la prima cosa che carica e l'ultima che cambia.

Tutte e tre condividono l'involucro di istantanea: id, deleted, capturedAt, receivedAt, sequence e gli altri stanno accanto al data descritto qui sotto.

suppliers

Un record per ogni fornitore che il ristorante ha inserito, che da lui sia arrivato qualcosa di recente o no.

{
  "id": "1f3c2a76-5b94-4b0e-9c1a-6d8f0a2e7b31",
  "collection": "suppliers",
  "deleted": false,
  "capturedAt": "1789431600214",
  "receivedAt": "1789431604771",
  "sequence": "412",
  "data": {
    "name": "Metro Nanterre",
    "isDeleted": false,
    "contactMethods": [
      { "type": "phone", "value": "+33 1 41 20 30 40" },
      { "type": "email", "value": "commandes@example.test" }
    ],
    "accountNumber": "FR-884213"
  }
}

contactMethods[].type non è un enum. Lo schema dice stringa e si ferma lì, e i valori qui sopra sono un'illustrazione anziché un elenco. Ci faccia uno switch con un ramo predefinito, e mostri il value comunque sia scritto il type.

Una consegna incorpora il suo fornitore in linea come { id, name } — abbastanza da mettere su schermo, e nulla di più. Questa collezione è dove stanno il numero di conto e il numero di telefono.

products

Cosa il ristorante riceve e utilizza. Il record è scarno quanto sembra.

{
  "id": "6b0d4ea2-91c7-4f3d-a0be-2c5f7d1e8a44",
  "collection": "products",
  "deleted": false,
  "capturedAt": "1789431980551",
  "receivedAt": "1789432001903",
  "sequence": "413",
  "data": {
    "name": "Beurre doux 250 g",
    "isDeleted": false
  }
}

Il record è tutto qui: nessun riferimento, nessuna categoria, nessuna unità, nessun fornitore. Se il suo modello ha bisogno di qualcuna di queste cose, sta a lei tenerla, con chiave l'id dell'involucro.

Nient'altro punta a un prodotto tramite id. Una consegna registra cosa è stato misurato come temperatureRecords[].product, testo libero digitato durante il controllo — veda consegne. Far corrispondere quello a questo elenco è lavoro sulle stringhe dalla sua parte, e «Beurre doux 250 g» non è «beurre doux». Lo faccia se deve, ma non presenti il risultato come una join.

preparations

Qualcosa fatto in casa anziché ricevuto — una salsa, un fondo, una terrina.

{
  "id": "c47e8b13-0a52-4d96-8f1b-73ae2905cd6f",
  "collection": "preparations",
  "deleted": false,
  "capturedAt": "1789455120087",
  "receivedAt": "1789455133642",
  "sequence": "418",
  "data": {
    "name": "Sauce béarnaise",
    "lifespan": 3,
    "allergens": ["oeuf", "lait"],
    "isDeleted": false
  }
}

lifespan non porta alcuna unità. Lo schema le dà un numero e nulla con cui interpretarlo. Non stampi «3 giorni» perché tre sembra giorni — verifichi cosa intenda l'app per il ristorante che sta leggendo, e lo etichetti in modo esplicito se non ci riesce.

allergens è un elenco di stringhe, non un elenco normativo. Le voci arrivano dall'app nella lingua del ristorante. Non le mappi sui quattordici allergeni nominati senza controllare cosa dicano davvero le stringhe, e non tratti un array vuoto come un controllo degli allergeni superato — significa anche che nessuno l'ha compilato.

isDeleted non è deleted

Ogni collezione di questa pagina porta entrambi, significano cose diverse, e chi consuma i dati filtrando su uno solo dei due ottiene un elenco sbagliato.

• deleted, sull'involucro, è il tombstone della copia shadow. true significa che il record è stato cancellato nell'app e che data non c'è più. È così che viene a sapere che qualcosa è sparito — le regole sono nella pagina sull'involucro.
• isDeleted, dentro data, è l'indicatore di cancellazione logica dell'app sulla riga. Il record è ancora lì, ha ancora il suo nome, e arriva ancora con deleted: false. Il ristorante l'ha dismesso: ha smesso di proporlo nei selettori, e l'ha tenuto perché i vecchi record si risolvano ancora.

Quindi filtri su entrambi. Rispetti solo deleted e il suo elenco di fornitori si riempie di fornitori che il ristorante ha abbandonato due anni fa. Rispetti solo isDeleted e si tiene righe che sono state cancellate del tutto, perché un tombstone non ha alcun data da cui leggere l'indicatore.

Conservi però le righe dismesse anziché scartarle. Una consegna dello scorso marzo nomina ancora un fornitore che oggi è isDeleted: true, e risolvere quel nome è l'intera ragione per cui tiene questo elenco.

Leggere il catalogo

Queste tre sono piccole, cambiano lentamente e servono a quasi tutto il resto, il che ne fa la parte economica di una sincronizzazione e la parte facile da sbagliare in modo sottile.

• Le percorra per prime, le tenga, le aggiorni a intervalli regolari. L'intero catalogo di un ristorante è una manciata di pagine a limit=100. Lo tenga nel suo archivio con chiave l'id dell'involucro, e risolva i nomi da lì anziché recuperarli per ogni record.
• I nomi cambiano, gli id no. name è testo libero che il ristorante modifica durante il servizio. Memorizzi l'id come sua chiave e tratti il nome come un'etichetta da aggiornare — mai come qualcosa su cui fare una join.
• Anche qui l'assenza è ambigua. Un fornitore che non compare può non essere mai stato inserito, oppure può non essere ancora arrivato a noi. Veda l'avvertenza prima di comunicare un conteggio.