« Ça marche dans l'ascenseur » est une exigence produit
Une inspectrice de terrain ouvre votre application dans un parking, avec deux étages de béton entre elle et l'antenne la plus proche. Le formulaire est là. L'enregistrement que le formulaire aurait dû charger ne l'est pas, parce que la connexion est tombée pendant que la liste se vidait encore, et la roue de chargement tourne depuis la rampe. Elle fait ce que font les utilisateurs. Elle remonte à la surface, fait le travail sur papier, et le produit qui vient de perdre cette inspection au profit d'un bloc de papier est le même qui a passé tous les tests dans votre bureau.
La thèse de ce billet : le hors-ligne est un environnement, pas un état d'erreur, et il mérite du travail de conception plutôt qu'une reprise avec un délai d'attente mieux réglé. L'application qui marche dans le parking se construit en quatre mouvements, et l'ordre n'est pas négociable. Emporter le jeu de données sur l'appareil avant qu'il soit nécessaire. Faire passer chaque écriture par une file qui survit à un plantage. Rejouer cette file avec la révision du serveur en main, jamais l'horloge de l'appareil. Et écrire la règle de conflit avant le premier conflit, parce qu'une politique de fusion inventée pendant la première fusion est inventée par celui ou celle qui a déposé le ticket le plus énervé.
Un exemple filé de bout en bout porte tout le billet, inventé à dessein, pour que personne n'argumente sur un échantillon d'un seul client : un district routier suit 4 312 ponceaux le long de 620 km de routes, et deux inspectrices rédigent leur état des lieux après les tempêtes. Assez petit pour que tout le jeu tienne dans un fichier SQLite de téléphone, marge comprise, assez grand pour que les bugs de synchronisation s'y cachent. Tout ce qui suit tourne dans ce petit monde, un ponceau et deux appareils compris.
Un jeu de données, téléchargé avant la rampe
Le mouvement un existe parce qu'une écriture sans base ne se fusionne pas plus tard : ce que l'application laisse modifier doit avoir été chargé quelque part, ou l'édition n'a rien à quoi se comparer. Donc le district vient sur l'appareil, tout entier. 4 312 lignes d'enregistrements de ponceaux, leurs notes, et un paquet de tuiles des routes, gardé interchangeable comme nous gardons toute source de tuiles, parce qu'un fournisseur de cartes qui expire est une chose de plus qui ne revient pas quand on l'appelle. Le total fait quelques mégaoctets de SQLite ; tout cela voyage donc sans résistance.
Le téléchargement se fait sur le Wi-Fi du bureau au début du quart, et l'estampille qui dit quand est imprimée à l'écran, liste des ponceaux comprise. Chaque enregistrement porte la révision serveur à laquelle il a été chargé, un petit champ qui porte tout le poids du design, parce que le mouvement trois le consomme. La fraîcheur a un prix, et le design affiche le prix au lieu de le cacher : un ponceau installé après le téléchargement de ce matin n'existe pas jusqu'au prochain, et la date est visible à chaque ouverture de la liste. Cette honnêteté coûte une ligne d'interface et prévient la pire défaillance : une application sûre d'elle qui se croit avec le monde entier en poche.
Chaque écriture passe d'abord par une file d'attente
Le mouvement deux est la discipline qui survit à une batterie morte. Une écriture ne part jamais directement vers le réseau ; elle atterrit dans une table de file d'attente sur l'appareil, avec la clé de l'enregistrement, le changement voulu, et la révision de base contre laquelle l'édition a été faite. La file est la mémoire d'intention du produit : un ponceau marqué « boîtier écrasé » dans le tunnel est consigné au moment de l'observation, qu'un seul paquet quitte le parking ou pas.
create table outbox (
id integer primary key,
device_id text not null,
record_id text not null,
base_revision text not null,
payload text not null,
created_at text not null
);
Cette forme existe grâce à ce que la première version a révélé. Cette version envoyait les éditions droit vers l'API dès qu'une barre de signal apparaissait, et elle a perdu l'édition quand le processus est mort en plein vol sous le passage inférieur : requête morte, observation morte avec elle, enregistrement du téléphone en apparence intact. Une intention qui ne peut pas survivre au processus qui l'a formée n'a jamais été consignée. La file se fiche de quand le réseau revient. C'est sa vertu, et l'origine du problème que le mouvement trois doit trancher.
Rejouer, c'est une conversation sur les révisions
Rejouer une file d'attente n'est pas téléverser. Chaque entrée part vers le serveur avec sa charge utile et sa révision de base, et le serveur répond de trois manières. La révision correspond toujours : l'édition s'applique, et l'entrée sort de la file. L'enregistrement a avancé pendant que le téléphone était dans le tunnel : c'est un conflit, propriété du mouvement quatre. La requête est une reprise après un délai qui n'est en fait jamais mort : le serveur déduplique sur l'appareil et l'identifiant de file, et la même observation ne s'applique pas deux fois.
L'horloge de l'appareil n'intervient dans aucune de ces décisions, sauf à l'écran. Un téléphone qui a passé neuf jours hors couverture se trompe sur le jour d'une manière que personne ne peut auditer ensuite ; nous avons vu le coût de la confiance dans les horloges des terminaux dans le suivi de flotte en temps réel, où dix mille appareils se signalent à leur rythme et où le serveur est le seul arbitre. Ici le serveur estampe le temps de référence ; l'appareil estampe ce qu'il montre à l'utilisatrice. Une file d'intentions plus une révision de base par entrée transforment « la synchronisation » d'un événement en un ensemble de petites questions auxquelles répondre, et ce renversement est l'essentiel de l'ingénierie.
Écrire la règle de conflit avant le premier conflit
Le mouvement quatre est la décision produit, et c'est celle que les équipes sautent. Deux inspectrices couvrent la même tempête. L'inspectrice A marque le ponceau du chemin Miller « boîtier écrasé, débris tassés » et ajoute trois lignes de notes, depuis l'intérieur du parking, hors ligne. L'inspectrice B, dont l'appareil s'est synchronisé à la base à midi, marque le même ponceau « débris partiels » et ajoute sa propre note. La relecture de A atterrit à 16 h contre un enregistrement que la relecture de B a déplacé à 12 h 05. Ce que fait ensuite votre produit, c'est la fonctionnalité. Tout choix ici est une politique, et la seule défaillance est de prétendre qu'il n'y a pas de politique.
merge(old, ours, theirs):
for each field:
ours_changed = ours[field] != old[field]
theirs_changed = theirs[field] != old[field]
if ours_changed and not theirs_changed: keep ours[field]
if theirs_changed and not ours_changed: keep theirs[field]
if neither changed: keep old[field]
if both changed identically: keep either
if both changed differently: send the pair to review
records with an empty review list apply on their own
everything else waits in the review queue, whole record
La règle qu'installe cet exemple est champ par champ, à trois voies, avec un humain au bout. Un côté a changé un champ et l'autre non : ce côté gagne, y compris le côté resté dans le garage. Les deux côtés l'ont changé en la même chose : personne ne discute un accord. Les deux côtés l'ont changé différemment : l'enregistrement entre dans une file de relecture, où les deux valeurs se présentent côte à côte avec les deux notes, et un humain nommé choisit ou combine. Le texte libre ne fusionne jamais tout seul, pour une raison : une règle qui désigne un gagnant pour une note de terrain est une règle qui supprime l'observation de quelqu'un sans la lire. Les chiffres et les statuts prennent la voie automatique rapide. Les mots restent aux personnes.
Le code de synchronisation est de la plomberie. L'écran de relecture, où les deux textes se côtoient, est le produit.
Deux designs que nous avons retirés
Le premier retrait, c'est le last-write-wins appliqué à l'enregistrement entier. C'est la chose la moins chère à livrer, et cela efface du travail : le téléversement complet de l'inspectrice B, horodaté après celui de A, a écrasé trois lignes de notes de terrain que A écrivait depuis l'intérieur du parking, et la suppression ressemblait exactement à rien, parce que l'enregistrement avait toujours chaque champ rempli. La règle de conflit ci-dessus existe à cause de cette défaillance, pas devant elle.
Le deuxième retrait, c'est l'ordonnancement par l'horloge de l'appareil. Deux téléphones qui ont passé des durées différentes hors couverture ne sont pas d'accord sur l'ordre des événements à des minutes ou des jours près, et une piste d'audit construite sur leurs horloges est un récit, pas un journal. Le temps du serveur, une seule horloge, ennuyeux et défendable. L'horloge de l'appareil apparaît à l'écran et nulle part près d'une décision, un format d'affichage plutôt qu'un mécanisme de jugement.
Ce qui reste faux dans ce design
La file de relecture peut grossir. Deux inspectrices qui travaillent à travers la même tempête avec une semaine sans couverture laissent une pile de textes jumelés qui attendent un humain, et rien dans la fusion ne la réduit. La réponse honnête du design : certains conflits sont des affaires de jugement, la file est où ils se font juger, ce qui en fait une promesse d'effectif, pas technique. Les suppressions sont leur propre limite : une suppression qui croise une édition dans la même fenêtre ne se résout pas automatiquement ici, elle passe en relecture, parce que « la structure est partie » contre « la structure est réparée » est exactement la décision qui mérite une personne. Les photos restent modestes aussi : elles se téléversent quand le réseau le permet, elles font la queue derrière le texte, et un enregistrement en attente de photo le dit en face.
Rien de tout cela ne fait du parking une garantie. Cela en fait un endroit où le produit se dégrade exprès, jusqu'au niveau qu'il avait annoncé : une liste estampillée de sa date de téléchargement, une file qui accepte tout, et une ligne de relecture pour les rares éditions que deux humains se sont vraiment disputées.
Si vous ne retenez qu'une décision de ce billet, retenez l'ordre. Jeu de données d'abord, file d'attente ensuite, révisions à la relecture, règle de conflit sur papier avant le premier conflit. Chaque mouvement existe à cause de ce que le précédent a révélé, et la séquence entière tient dans une itération, pas dans un trimestre. L'application qui passe le test de l'ascenseur a décidé, avant la mise en service, ce qui se passe quand deux personnes et un ponceau ne sont pas d'accord, et la bibliothèque de reprises n'y est pour rien.
AngoraTek construit des applications de données de terrain qui continuent de fonctionner de l'autre côté d'un tunnel, et nous disputons les règles de conflit comme ce billet le fait. Si votre produit a son propre parking, [amenez-nous l'enregistrement qui s'est échappé](/fr/#contact) et nous dessinerons les quatre mouvements sur vos données.Merci d'avoir lu jusqu'ici. Si cela ressemble au problème sur lequel vous butez, parlez-nous-en. L'équipe lit chaque message.
Engager la conversation