blog·5 min lezen

Meldingen die zichzelf opruimen

Zeventien soorten signalen, elk uur opnieuw berekend, en ze verdwijnen zodra de oorzaak weg is. Hoe we meldingen bouwden die geen inbox vol zetten, en wat er bij de uitrol bijna misging.

We willen niet elke dag door lijsten lopen. Laat de app zelf zeggen
wat er aandacht nodig heeft, en stil zijn als er niets is.

Bijna elk bedrijfssysteem dat we tegenkomen heeft hetzelfde probleem: iemand moet elke ochtend zeven lijsten doorlopen om te zien of er iets fout zit. Dus bouwden we voor een drankengroothandel met slijterij een meldingenlaag in hun inkoopapp. Zeventien soorten signalen, elk uur opnieuw berekend, en ze verdwijnen zodra de oorzaak weg is. Het draait in productie. De klant blijft anoniem en er staan hier geen bedragen, prijzen of marges.

Niet opslaan wat je kunt berekenen

De eerste keuze was de belangrijkste: een melding is geen gebeurtenis die we wegschrijven, maar een conclusie uit de huidige toestand.

Elk uur, en verder na elke synchronisatie met de boekhouding en na elke geslaagde upload van een factuur, kijkt een taak naar de stand van zaken en bepaalt welke meldingen er nu zijn. Elke melding krijgt een sleutel: de soort plus het ding waar hij over gaat. Die lijst wordt vergeleken met wat er in de database staat.

  • Een sleutel die nieuw is, wordt een melding.
  • Een sleutel die verdwenen is, krijgt een datum bij "opgelost" en gaat van de pagina af.
  • Een sleutel die er al was, blijft dezelfde melding, maar de inhoud wordt bijgewerkt.

Dat laatste punt is wat het rustig houdt. Staat er een melding over prijzen open en komt er een factuur bij, dan verandert het aantal in de melding wel, maar er gaat geen tweede mail uit. Je hebt hem al gezien.

Ontdubbelen laten we niet aan de code over maar aan de database: een unieke index op administratie plus sleutel, maar alleen zolang de melding niet is opgelost. Dezelfde melding kan dus niet twee keer bestaan, en komt een probleem later terug, dan mag er wel een nieuwe komen. Eén regel in een migratie in plaats van een halve pagina controles.

De uitrol die bijna een stortvloed werd

Hier ging het in de testomgeving goed fout. Zet je dit aan op een administratie met drie jaar facturen erin, dan heeft die administratie op dag één honderden open signalen. Allemaal terecht, en allemaal oud. Als die in één keer de deur uit gaan, heb je het systeem meteen verbrand.

De oplossing is simpel en we zouden hem overal weer zo doen: bij de eerste ronde per administratie, en na het importeren van oude gegevens, wordt de bestaande toestand als "bekend" vastgelegd. Geen mail, niet in de teller, niet op de pagina. Alleen wat daarna nieuw ontstaat, is een melding.

Je begint dus met een leeg scherm dat zich vult met wat er echt gebeurt. Wie de oude stand wil zien, heeft daar de gewone overzichten voor.

Soorten, en wie wat krijgt

De zeventien soorten gaan over drie dingen: de koppeling zelf (synchronisatie mislukt, toegang verloopt binnen een week, daglimiet bijna op), het dagelijkse werk (een factuur die klaarstaat, een nieuwe bestelling, een factuur die niet op de cent sluit) en de inkoop (een artikel meer dan 10 procent duurder dan de vorige keer, een artikel meer dan 30 procent goedkoper, een andere leverancier die minstens 5 procent lager staat).

Elke soort heeft een ernst: slecht, let op, of alleen ter informatie. En elke gebruiker kiest zelf per soort en per kanaal of hij er bericht van wil. De beheerder beheert de hele matrix. Dat lijkt veel knoppen voor een klein bedrijf, maar het alternatief is dat iedereen alles krijgt en dus niemand meer kijkt.

Twee soorten hebben we er op verzoek weer uit gehaald, en dat is net zo belangrijk als wat erin zit. Betalingen en het boeken van de ontvangst gaan bij deze klant via een eigen werkwijze buiten de app om. Dus hoort de app daar niet over te piepen. De gevallen blijven in de code bestaan voor de meldingen die al in de database staan, maar er wordt niets meer over verzameld.

Twee die niet vanzelf oplossen

Niet alles is een conclusie uit de toestand. Eén melding gaat over iets wat een mens buiten de app moet doen: een order waarbij gratis flessen tegen de volle prijs geboekt zijn, die iemand op de inkoopfactuur moet aftrekken. Dat kan de app niet zien gebeuren. Die melding blijft dus open tot iemand hem afvinkt.

Eén melding doet actief iets: staat er een "opvallend lage inkoopprijs" open, dan boekt de app die factuur niet naar de boekhouding. Negen van de tien keer is dat een verkeerde eenheid, een doos die als een fles is gelezen, en dan wil je dat het stopt voordat het in de administratie staat.

Een melding is een taak

Halverwege de bouw bleek de vraag niet "wat is er aan de hand" maar "van wie is dit". Daarom kan elke melding aan iemand toegewezen zijn. Elke soort heeft een standaardpersoon, je kunt een melding doorsturen met een bericht, of zelf oppakken met één knop. Dat staat in het logboek. De pagina en het belletje tonen eerst wat voor jou is, of voor niemand.

Niet mailen is een functie

Drie dingen die we bewust zo hebben gebouwd:

Een ronde zonder nieuws is stil. Rustige uurruns komen niet in het logboek en worden na een week opgeruimd. Anders staat je logboek vol met "niets nieuw".

Een mislukte mail laat de taak nooit falen. Hij wordt gelogd en tot drie keer opnieuw geprobeerd. Lukt het na twee dagen nog niet, dan laten we het. Een melding van twee dagen oud alsnog mailen helpt niemand.

Maximaal vijfentwintig meldingen in één bericht. Meer dan dat leest niemand, en de rest staat in de app.

Naast mail is er Telegram, per gebruiker en per soort aan te zetten. Koppelen gaat met een eenmalige code die een kwartier geldig is en waarvan we alleen de versleutelde vorm bewaren. Blokkeert iemand de bot, dan halen we de koppeling er zelf af en ziet die persoon dat in de app. De ronde faalt daar niet van, en de mail gaat gewoon door. De dagelijkse samenvatting van 07:00 blijft mail, en staat standaard uit: die moet je zelf willen.

Veelgemaakte fouten

Meldingen als gebeurtenissen opslaan. Dan moet je zelf opruimen, en dat vergeet je ergens. Bereken ze opnieuw en laat verdwijnen wat niet meer bestaat.

Ontdubbelen in de code doen. Een unieke index die alleen geldt voor open meldingen doet het beter dan welke controle in je applicatie ook.

Alle bestaande signalen meteen mailen bij de uitrol. Leg de beginstand vast als bekend. Eén keer goed doen is het verschil tussen een systeem dat gebruikt wordt en een filterregel in iemands mailprogramma.

Een melding opnieuw mailen omdat het aantal veranderde. Werk de open melding bij, verstuur niets.

Alles aanzetten voor iedereen. Per persoon per soort per kanaal kiezen klinkt als overkill, en is het niet.

Een melding maken die niemand kan oplossen. Als er geen knop is die naar de plek leidt waar je het fixt, hoort het geen melding te zijn.

Wat een koppeling op Exact Online kan doen, staat op Exact Online koppelen. Wil je zoiets in je eigen systeem, kijk dan op maatwerk.

MK
Maarten Keizer

Oprichter van Invoker. Ruim twintig jaar hosting, systeembeheer en webdevelopment; bouwt de Claude-hosting zelf en test alles eerst op de eigen servers.

over maarten