Over dit project
Bootwacht bewaakt kleinere zeilboten tijdens winterstalling en aan de steiger. Aan boord hangt een Raspberry Pi met Zigbee-sensoren; die slaat elke meting eerst lokaal op een SSD op en stuurt hem daarna versleuteld naar één Next.js-applicatie in de EU. Deze pagina legt het hele systeem uit — van de I²C-draadjes tot de transactionele notificatie-outbox — voor wie meebouwt, meekijkt of overweegt klant te worden.
Deze hele pagina als één tekstbestand — handig om in NotebookLM, een LLM of een e-reader te plakken.
Dit is een uitleg, geen contract. De repository, de ADR's en de contractdocumenten zijn leidend zodra deze pagina en de code van elkaar afwijken. Bootwacht is bovendien een informatiesysteem: het vervangt geen verzekering, gecertificeerd alarmsysteem of onderhoud. Laatst herzien: 2026-08-15.
Uitgangspunten
Elke waarneming wordt op de boot naar SQLite geschreven vóórdat er ook maar een netwerkverbinding wordt geprobeerd. Valt 4G weg, dan blijft de historie compleet en levert de boot later alsnog na. De SSD aan boord bewaart standaard 3.650 dagen; de cloud 90.
De Raspberry Pi begint élke verbinding zelf — ook voor schakelopdrachten, die hij ophaalt in plaats van ontvangt. Er is dus geen open poort, geen VPN-endpoint en geen publiek bereikbare Home Assistant. Dat werkt door carrier-grade NAT heen en houdt het aanvalsoppervlak van een onbemande boot minimaal.
Eén VPS, één applicatieproces, één SQLite-bestand, geen betaalde platformabonnementen. De pilot van winter 2026/27 moet begrijpelijk en goedkoop zijn; de schaalgrens is expliciet opgeschreven zodat niemand er per ongeluk overheen loopt.
Een gevraagde toestand is geen bevestigde toestand. Het dashboard toont pas 'aan' als de Pi de opdracht heeft uitgevoerd en de werkelijke stand heeft teruggemeld, en markeert verbruiksdata na twee uur als verouderd. Offline, mislukt en onbekend blijven zichtbaar.
Of iets openbaar mag zijn, staat op de metricdefinitie — niet in een view. Locatie is standaard privé; de publieke Idefix-pagina is één expliciet geauditeerde uitzondering op precies één punt van precies één boot, zonder historie.
Standaardhardware (Raspberry Pi, Zigbee, Home Assistant) en een publieke repository in plaats van een gesloten merkdoos. Een eigenaar kan zelf een sensor bijprikken: een nieuwe numerieke of booleaanse metric wordt bij eerste levering automatisch geregistreerd.
Systeemkaart
De architectuur scheidt bewust wat er aan boord draait, wat centraal gehost wordt en wat Bootwacht helemaal niet zelf doet.
Klik een onderdeel voor de details, of kies hieronder een route om te zien wat er meedoet.
Op iedere bewaakte boot
Sensoren, een Zigbee-coördinator, Home Assistant, de Bootwacht Edge-service en een eigen SQLite-database op SSD. Dit deel blijft werken zonder internet.
Eén VPS in de EU
Eén Next.js-proces achter een reverse proxy: publieke site, telemetrie-API, commandowachtrij, alarmlogica, notificatie-outbox en drie soorten dashboards.
Mensen en diensten van derden
Browsers van klanten en beheerders, plus de diensten die Bootwacht bewust niet zelf bouwt: betalen, e-mail versturen, kaarten tonen, operationele monitoring en back-ups bewaren.
Volg een route door het systeem
De belangrijkste route van het systeem. Let op de volgorde: eerst lokaal vastleggen, dan pas het netwerk proberen.
Stap 1 van 7
Een SNZB-02D meldt 4,1 °C over Zigbee; de INA219 aan de I²C-bus meldt 12,4 V. Batterijgevoede sensoren slapen tussen berichten door, wat jaren batterijduur oplevert.
Betrokken onderdelen:
Verder lezen:Telemetriecontract v1Telemetrie-domeinmodel
Technologiekeuzes
Elk onderdeel heeft één smalle taak. Klap iets open voor de reden en het bijbehorende compromis.
Alles op de Pi is gekozen op één criterium: blijft het werken als er drie weken niemand aan boord komt en de 4G-verbinding wegvalt?
De computer aan boord, gevoed vanaf de 12 V-serviceaccu via een 5 V-omvormer.
Genoeg rekenkracht voor Home Assistant plus een container, met een enorme hoeveelheid bestaande documentatie en onderdelen. Aandachtspunt: de hub is een single point of failure en vraagt een watchdog, herstartstrategie en een doordacht laagspanningsgedrag.
Draadloos netwerk met laag verbruik tussen de sensoren en de coördinator aan boord.
Water-, contact-, beweging- en temperatuursensoren zijn breed verkrijgbaar en goedkoop, en slapende batterijsensoren zijn een volwassen techniek. LoRaWAN is uitgesteld, niet afgewezen: dat wordt pas interessant bij 'Bootwacht Marina', waar veel boten één gateway kunnen delen. Matter lost interoperabiliteit op, niet de verbinding met de wal.
Hardware-integratielaag met een stabiele lokale API.
Het kent duizenden apparaten, zodat Bootwacht geen eigen driverlaag hoeft te onderhouden en een eigenaar zelf een sensor kan bijprikken. Bootwacht behandelt het bewust als een leverancier: alleen de ondersteunde API, nooit de interne database.
De taal van de Bootwacht Edge-service.
Een kleine, expliciete en goed testbare service naast Home Assistant, dat zelf ook Python is. Sluit bovendien aan op het analysewerk dat de maker in Python doet.
De duurzame opslag aan boord, op de SSD.
Eén bestand, transacties, checks en foreign keys, zonder serverproces of netwerkafhankelijkheid. Precies wat je wil in een omgeving waar de stroom er zomaar af kan gaan.
Herhaalbare runtime voor Edge en Home Assistant.
Identieke Python-dependencies op elke Pi, plus harde inperking: geen capabilities, read-only rootfilesystem en schrijfrecht op alleen het datavolume.
Eén applicatie bedient drie heel verschillende doelgroepen: browsers van klanten, beheerschermen en een vloot apparaten die geen mens achter zich heeft.
Website, dashboards en alle server-endpoints in één project.
Django is serieus overwogen — het geeft gratis een sterke backoffice en past bij het Python-werk van de maker. Toch werd Next.js gekozen: het wint op PWA en dashboardinteractiviteit, houdt het bij één taal end-to-end, en de site bestond al geaudit en gedocumenteerd. De erkende prijs: beheerschermen bouw je met de hand.
De interactieve onderdelen van dashboards en beheer.
Server components voor alles wat mag worden voorgerenderd, client components alleen waar echt interactie nodig is. Dat houdt privélogica op de server.
Eén getypeerde taal van database tot knop.
Prisma genereert types uit het schema, dus een modelwijziging breekt bij het typechecken en niet pas in productie. npm run typecheck is verplicht vóór oplevering.
Schema, migraties en getypeerde queries.
Eén schemabestand is de bron voor database én types, en $transaction geeft de atomaire alarm-plus-outboxregel die het notificatieontwerp nodig heeft.
Huisstijl en responsive opmaak.
De maritieme kleuren staan als tokens in tailwind.config.ts: navy voor rust, 'signal' als messing scheepsbeslag, zeildoek-zand als achtergrond en reddingsboei-koraal voor acties. Koppen in Fraunces, tekst in Source Sans.
Wachtwoordhashing en ondertekende sessies.
Geen extern auth-platform voor twee rollen en een handvol gebruikers. bcrypt hasht, jose ondertekent met een vastgepind HS256, en de databasecontrole op tokenVersion levert de intrekbaarheid die een pure JWT mist.
Standaard Web Push zonder tussenpartij.
Zelfbeheerde VAPID-sleutels betekenen geen abonnement, geen extra verwerker en geen leveranciers-lock-in — passend bij een pilot die klein en uitlegbaar moet blijven.
De uitgebreide grafiekverkenner over de hele retentieperiode.
Zoomen en pannen op langere reeksen. De compacte 48-uurs sparklines zijn juist handgeschreven SVG, zodat het dashboard zelf licht blijft.
De pilot draait op één VPS in de EU, en de dingen die Bootwacht niet zelf wil zijn — betaalverwerker, mailprovider, kaartleverancier — zijn bewust uitbesteed.
Besturingssysteem en runtime op de VPS.
Langdurige ondersteuning en de meest gangbare combinatie voor een gebouwde Next.js-applicatie. De app draait als een eigen onbevoorrechte servicegebruiker.
HTTPS-ingang, certificaatbeheer en client-IP-waarheid.
Automatische certificaten en een korte, leesbare configuratie. Let op: bij een Plesk-image gebruik je de Nginx/Apache-ingang van Plesk — twee producten mogen niet vechten om poort 80 en 443.
Procesbewaking, geplande taken en logging.
Start na een reboot, herstart na een crash en activeert persistente oneshot-timers voor offlinebewaking, windverwachtingen en notificatiebezorging. Journalctl maakt uitkomsten zichtbaar; geen extra procesmanager of betaalde scheduler nodig.
De pilotinfrastructuur: 2 vCPU, 2 GB RAM, 90 GB NVMe.
Vast, laag maandbedrag zonder kosten per request, bij de partij waar het domein al staat. Vercel is uitgesteld omdat SQLite en een ratelimiter in procesgeheugen niet passen bij stateless meerdere instanties. Back-ups zitten níét in het pakket.
Gehoste betaalpagina met iDEAL en kaart.
Kaartgegevens komen nooit langs Bootwacht, dus de PCI-scope blijft minimaal. Mollie zou een vervanging van drie bestanden zijn: stripe.ts, /api/checkout en de webhook.
Aflevering van contactformulierberichten.
Eenvoudige API en domeinverificatie. Orderbevestigingen en wachtwoordreset zijn bewust nog niet gebouwd en blijft afzonderlijk gepland in #2.
Domeinmodel
De cloud slaat genormaliseerde observaties op in plaats van één steeds bredere tabel met een kolom per denkbare sensor.
Account met rol CUSTOMER of ADMIN. tokenVersion is de knop om sessies in te trekken.
Velden
email String @uniquepasswordHash String— bcryptrole String— CUSTOMER | ADMINtokenVersion Int— ophogen = alle sessies van deze gebruiker direct ongeldigRelaties
De aggregate root. Alles hangt aan een boot, en een boot mag al bestaan en meten vóórdat er een klant aan gekoppeld is.
Velden
name Stringmarina String?deviceToken String @unique— crypto.randomBytes, bewust géén cuid — die zijn voorspelbaarisPublic Boolean— maximaal één boot tegelijk; de admin-API zet de rest uituserId String?— onDelete: SetNullRelaties
Het klantgebonden startmoment van het totaalrapport. Een reset verschuift alleen dit tijdstip en laat telemetrie en alarmhistorie intact.
Velden
userId + boatId String @uniqueresetAt DateTimeupdatedAt DateTimeRelaties
Niet-destructieve maand- en categoriebaseline waarmee één boot vanaf nul kan worden weergegeven terwijl bronrapporten en budgethandhaving intact blijven.
Velden
boatId String @uniqueperiodStart + resetAt DateTimeuplink baselines BigIntattribution generation + baselines String? + BigInt?Relaties
De herbruikbare catalogus van grootheden. Hier — en nergens anders — staat of iets openbaar mag zijn en of het alarmen ondersteunt.
Velden
code String @id— temperature, humidity, location, …valueType Enum— number | boolean | locationcanonicalUnit String?minimumValue / maximumValue Decimal?— fysieke grensisPublicAllowed Boolean— location = falsesupportsAlerts BooleanRelaties
De stabiele logische identiteit die de boot stuurt. Boat + externalId is uniek, en de metric mag na registratie niet meer veranderen.
Velden
externalId String— bijv. cabin.temperaturename String— mag wél wijzigenlastSeenAt DateTimeRelaties
Eén atomaire momentopname met maximaal één reading per sensor. Boat + observationId is uniek; dát maakt retries veilig.
Velden
observationId String— idempotentiesleutelobservedAt DateTime— tijd op de bootreceivedAt DateTime— tijd in de cloudpayloadHash String— volgorde-onafhankelijk; verschil = 409Relaties
Precies één waardevariant per reading: een getal, een boolean, of een gekoppelde LocationValue. Applicatievalidatie én databasechecks dwingen dat af.
Velden
numberValue Decimal?booleanValue Boolean?Relaties
Een coördinaat is bewust één waarde en geen twee losse sensoren, zodat je nooit een breedtegraad van 10:00 met een lengtegraad van 10:05 combineert.
Velden
latitude Decimal— -90 … 90longitude Decimal— -180 … 180accuracyMeters Decimal?— 0 … 100.000Relaties
Eén duurzaam incident per doorlopende regelconditie, met gekozen ernst en een aparte actief-, afhandel- en hersteltoestand.
Velden
type String— FROST | HUMIDITY | BATTERY | BILGE | SHORE_POWER | CONDENSATION | GEOFENCE | OFFLINE | SENSOR_OFFLINE | FORECAST_WIND | PRESSURE_DROPseverity String?— INFORMATIEF | WAARSCHUWING | KRITIEKlifecycleVersion Int— 0 = historie; 1 = incidentactive / startedAt / resolvedAt Boolean / DateTime?stateKey / activeIncidentKey String?— actieve sleutel is uniekacknowledged / acknowledgedAt Boolean / DateTime?— staat los van hersteldeletedAt DateTime?— geaudite soft-delete van inactieve historieRelaties
Alleen de afwijkingen van de standaard worden opgeslagen. Een ontbrekende rij betekent de veilige default — daardoor was er nooit een backfill nodig.
Velden
category Stringenabled Booleanthreshold Decimal?delayMinutes / cooldownMinutes IntrecoveryEnabled BooleanRelaties
De serverside toestandsmachine voor vertraging, hysterese, cooldown en herstel. Bewaart alleen tijdstippen en id's, nooit gekopieerde meetwaarden.
Velden
stateKey String @unique— boot + categorie + optionele sensoractive BooleanconditionSince / lastAlertAt / lastRecoveryAt DateTime?Relaties
Expliciete toestemming per gebruiker, boot en kanaal, inclusief de versie van de toestemmingstekst en stille uren met tijdzone.
Velden
channel String— PUSH | EMAIL_FALLBACKconsentVersion / consentGrantedAt String? / DateTime?quietHoursStartMinutes Int— 1320 = 22:00timezone String— IANA, standaard Europe/AmsterdamRelaties
De transactionele outbox. Bevat bewust geen berichttekst, meetwaarde, coördinaat of provider-endpoint — alleen een opake destinationKey.
Velden
status String— PENDING | DEFERRED | RETRYING | ACCEPTED | FAILED | SUPPRESSEDdestinationKey String— opake PushSubscription-idoccurrenceKey / occurrenceType String— INITIAL | REMINDER | RECOVERYattemptCount / nextAttemptAt Int / DateTimeleaseToken / leaseExpiresAt String? / DateTime?— tijdelijke claim voor één dispatcherfailureCode String?— privacy-veilige codeRelaties
De cloud-identiteit van één goedgekeurde stekker. Home Assistant-entity-id's staan uitsluitend in de root-owned Edge-configuratie.
Velden
externalId Stringmodel String— alleen SONOFF_S60ZBTPFadminEnabled BooleanlastSeenAt DateTime?Relaties
Een expliciete gewenste eindtoestand met korte levensduur. activeOutletKey is de serialisatiegrens op databaseniveau.
Velden
activeOutletKey String? @unique— gevuld zolang PENDING of DELIVERED; daarna leegdesiredState Enum— ON | OFF — geen togglestatus Enum— PENDING | DELIVERED | SUCCEEDED | FAILED | EXPIREDexpiresAt DateTime— aanmaak + 30 sRelaties
Bewijsregels met losse id-velden in plaats van cascaderende relaties, zodat de historie leesbaar blijft nadat een account, boot of stekker is verwijderd.
Velden
actorUserId / boatId / targetId String?action / eventType StringresultCode String?Relaties
Kan zonder account geplaatst worden. De bedanktpagina zoekt uitsluitend op publicToken, nooit op een intern id.
Velden
amountCents Int— altijd hele eurocentenstatus String— PENDING | PAIDpublicToken String @unique— crypto.randomBytesuserId String?— gastbestellingen koppelen is handmatigRelaties
Een Home Assistant-entity mag hernoemd of vervangen worden zonder dat de Bootwacht-identiteit verandert. Verandert de fysieke betekenis wél, dan introduceer je een nieuw logisch id in plaats van het oude te hergebruiken.
Niet 'de client stuurt hopelijk niet dubbel', maar een unieke constraint op boat + observationId en op alert + user + channel + destination + occurrence. Een retry kán dus geen dubbele meting of dubbele melding maken.
Genormaliseerde observaties en readings betekenen dat een nieuwe sensor geen migratie vraagt. Een onbekende numerieke of booleaanse metric wordt bij eerste levering automatisch geregistreerd — privé en zonder alarmen, tot iemand hem bewust promoveert.
De Pi kent geen Boat (hij ís er één) en heeft extra leveringsvelden, maar verder is het model identiek. Dat maakt het redeneren over 'waar staat deze meting nu' eenvoudig.
Contracten en limieten
Deze waarden staan in de contractdocumenten en worden op precies één plek gecontroleerd. Verandert er één, dan verandert het contract mee.
Een waarde buiten deze grenzen levert HTTP 400, niet 500 — een kapotte sensor mag geen serverfout heten. Batterijpercentage en accuspanning zijn expres losse metrics.
| Metric | Type | Eenheid | Geaccepteerd bereik |
|---|---|---|---|
| temperature | getal | Cel | -50 … 80 |
| humidity | getal | % | 0 … 100 |
| battery_percent | getal | % | 0 … 100 |
| battery_voltage | getal | V | 0 … 60 |
| water_detected | boolean | — | true / false |
| shore_power | boolean | — | true / false |
| contact_open | boolean | — | true / false |
| location | locatie | — | lat -90…90, lon -180…180 |
Nieuwe scalaire metrics worden geaccepteerd bij een geldige kleine-letternaam, een eindige waarde en een eenheid van hoogstens 16 tekens. Ze krijgen automatisch een privé, niet-alarmerende definitie. Eigen locatie-objecten worden niet geaccepteerd.
De eerste vijf regels reproduceren precies het gedrag van vóór de instellingenpagina, zodat bestaande boten niets merkten van de invoering.
| Categorie | Standaard | Ernst | Klantbereik | Cooldown | Hysterese |
|---|---|---|---|---|---|
| Lage temperatuur | aan, 3 °C | waarschuwing | -5 … 10 °C | 60 min | 0,5 °C |
| Hoge luchtvochtigheid | aan, 85 % | waarschuwing | 60 … 95 % | 60 min | 5 procentpunt |
| Lage accuspanning | aan, 12,0 V | kritiek | 10,5 … 13,0 V | 60 min | 0,3 V |
| Water in de bilge | aan | kritiek | vaste richting | 60 min | conditie moet opheffen |
| Verlies walstroom | aan | kritiek | vaste richting | 60 min | conditie moet opheffen |
| Dauwpuntmarge | uit, geen grens | waarschuwing | 0,5 … 20,0 °C | 60 min | 0,5 °C |
| Geen nieuwe metingen | uit, 120 min | waarschuwing | 30 … 1.440 min | 360 min | nieuwe ontvangst |
Ernst verlagen, een regel uitzetten, een drempel minder gevoelig maken, vertraging of cooldown verhogen, of herstel uitzetten vraagt een expliciete tweede bevestiging in UI én API. Bewegings- en geofence-instellingen zijn nog niet beschikbaar: een positiepunt ontvangen levert op zichzelf nog geen goedgekeurde bewegingsregel.
| Onderwerp | Waarde | Waarom |
|---|---|---|
| Telemetriepayload | max. 64 readings, 64 KiB | begrensde parsekosten per request |
| Ratelimit live telemetrie | 120 / uur / boot | gereserveerd voor actuele status |
| Ratelimit backfill | 720 / uur / boot | begrensd herstel zonder live data te blokkeren |
| Ratelimit inloggen | 10 / 5 min / IP | tegen wachtwoordgokken |
| Ratelimit registreren | 5 / 10 min / IP | beperkt accountenumeratie |
| Ratelimit checkout | 10 / 10 min / IP | tegen orderspam |
| Geldigheid schakelcommando | 30 s | voorkomt uitvoering na een storing |
| Commandobody | 16 KiB | apparaat- én klantendpoints |
| Verouderde energiedata | > 2 uur | dekt twee gemiste snapshots |
| Offline-detectie vloot | > 2 uur geen meting | rode markering in beheer |
| Retentie cloud / boot | 90 / 3.650 dagen | AVG-minimalisatie vs. data-eigendom |
| Sessieduur | 30 dagen | intrekbaar via tokenVersion |
| Pilotplekken | 25 | regio IJsselmeer en Friesland |
Vertrouwensgrenzen
Deze maatregelen bepalen de vorm van de architectuur en zijn geen optioneel laatste laagje.
Apparaat → cloud
Telemetrie wordt alleen geaccepteerd voor de boot die bij het token in de header hoort. Het token komt uit crypto.randomBytes, wordt bij aanmaken één keer getoond en kan in het beheer geroteerd worden — waarna het oude direct stopt.
Browser → cloud
De cookie is onleesbaar voor browserscripts en het JWT-algoritme staat vast op HS256. Elke controle kijkt óók of de gebruiker nog bestaat en of tokenVersion klopt, zodat sessies centraal ingetrokken kunnen worden.
Formulier → API
Inloggen, registreren, checkout en klantmutaties eisen een toegestane Origin. Requests zonder Origin — apparaten, webhooks, curl — blijven bewust werken, want die zijn geen browserbedreiging.
Publiek → privé
Alleen het nieuwste geldige punt van de ene boot met isPublic=true is publiek. Historie, bewegingsalerts, andere boten, klantgegevens en device-tokens blijven uitgesloten — en de publieke pagina raakt de notificatiemodellen niet aan.
Configuratie → runtime
Zonder AUTH_SECRET start productie niet, zonder Stripe-sleutel én zonder expliciete DEMO_MODE=1 staat bestellen uit, en een startscript valideert de productieomgeving. Ontbrekende configuratie mag nooit stilletjes een onveilig pad openen.
Beheerder → boot
Een beheerder mag elk bootdashboard openen, maar elke inzage schrijft een AdminAuditLog. Beheerweergaven zijn read-only voor telemetrie, commando's en audit, en tonen nooit tokens, wachtwoordhashes of Push-endpoints.
Software → fysieke wereld
Alleen een goedgekeurd model, alleen een lokaal gemapte entity, alleen expliciete eindtoestanden, met een verlooptijd van 30 seconden en een geverifieerd opstartgedrag 'Off'. Walstroom, bilgepompen, verwarming en machines vallen buiten scope.
Netwerk → browser
frame-ancestors none, nosniff, een strikt referrer-beleid, permissions-policy zonder camera, microfoon en geolocatie, HSTS in productie, en frame-src die uitsluitend OpenStreetMap toelaat.
Bewust geaccepteerd
Registratie meldt dat een e-mailadres al bestaat (enumeratie, gemitigeerd door de ratelimit). De ratelimiter zit in procesgeheugen en vraagt bij meerdere instanties een gedeelde store. En npm audit meldt twee moderate findings in de door Next.js gebundelde postcss waarvoor geen patch bestaat — 'npm audit fix --force' draaien is hier schadelijk.
Deploymentbeeld
Architectuurbesluiten
Elk besluit staat als ADR in de repository, inclusief de afgewezen alternatieven en de voorwaarden om het te heroverwegen.
Roadmap
Metricdefinities, stabiele sensoren, idempotente observaties, getypeerde readings en atomaire locatie — aan boord én in de cloud, met een simulator om het te oefenen.
Zes categorieën met vertraging, hysterese, cooldown, instelbare ernst en optioneel herstel, plus alarmlijnen in de grafieken en een tweede bevestiging bij risicovolle versoepelingen.
Eén goedgekeurd stekkermodel, expliciete eindtoestanden, 30 seconden geldigheid, serialisatie op databaseniveau en verbruiksmeting met een eerlijk meetmoment.
Positie wordt al opgeslagen, maar een positiepunt ontvangen is nog geen goedgekeurde bewegingsregel. Er moet een regel komen die onderscheid maakt tussen zwaaien aan de lijn en werkelijk vertrekken.
Nu verkocht als eenmalig jaarbedrag. Echte Stripe Subscriptions zijn een beperkte wijziging: mode 'subscription' plus een Price-object.
Veel boten op één stallingslocatie die een door de haven beheerde gateway delen. Dat is geen firmwareschakelaar: het vraagt andere hardware, credentials per apparaat, een netwerkserver, multi-tenant autorisatie en dekkingsplanning — plus gatewayredundantie, want anders is één gateway een gedeeld faalpunt.
Geen SCM/VbV-certificering, geen 24/7-meldkamer en geen verzekeraarskorting-route: te professioneel en regulatoir voor deze fase. Ook sms, WhatsApp, Signal en bellen vallen buiten scope. De FAQ op de site zegt dit expliciet — liever eerlijk dan suggestief.
Begrippenlijst
Veelgestelde vragen
Omdat het verschil met een merkdoos juist de openheid is. Een eigenaar kan zien wat er gebeurt met zijn data, zelf een sensor bijprikken en het kastje blijven gebruiken als Bootwacht ophoudt te bestaan. De waarde zit in de gebouwde en ondersteunde combinatie, de installatie aan boord en de service in de regio — niet in geheime software.
Aan boord verandert er niets: sensoren blijven meten en elke observatie wordt naar de SSD geschreven. De wachtrij loopt op. Na herstel levert Edge de nieuwste status eerst en voert daarna begrensde oudste backfill af met de originele id's, waardoor de cloud geen dubbelen krijgt. Oude waarden veranderen geen actuele sensor-alerts. Wat je in die periode mist, is het remote inzicht — daar is de offline-alarmregel voor.
Voor deze vorm niet. Eén proces, één schrijver, een handvol boten die elke vijf minuten een kleine payload sturen: dat is ver onder wat SQLite aankan. De echte beperking is niet de belasting maar de topologie — je kunt geen tweede instantie starten. Die grens staat expliciet opgeschreven, samen met wat er dan tegelijk moet veranderen.
Nee, en dat staat er bewust overal bij. Bootwacht is een informatiesysteem: het vertelt je wat er aan boord gebeurt. Er is geen meldkamer, geen certificering en geen garantie dat een melding op tijd gezien wordt. Het vervangt geen verzekering, gecertificeerd alarmsysteem of goed onderhoud.
Jij, en beheerders — waarbij elke beheerdersinzage een auditregel schrijft. Locatie is op metricniveau als niet-publiek gemarkeerd, dus geen enkele publieke query kan erbij. De enige uitzondering is de demoboot Idefix, waarvoor de eigenaar zelf toestemming gaf, en die uitzondering geldt voor precies één punt zonder historie.
Ja. Koppel het apparaat in Home Assistant, voeg de entity toe aan de Edge-mapping met een eigen stabiel logisch id, en de eerste levering registreert de metric automatisch. Nieuwe metrics beginnen privé en zonder alarmondersteuning tot iemand ze bewust opneemt in de catalogus.
Omdat het onverwacht in- of uitschakelen van walstroom, een bilgepomp, verwarming of machines brand, wateroverlast of schade kan geven. Er is één goedgekeurd stekkermodel, met een geverifieerd opstartgedrag 'Off' zodat een stroomstoring niets aanzet. Uitbreiden vraagt een belastingstest en expliciete goedkeuring, geen codewijziging.
Lees AGENTS.md voor de werkwijze, dan bootwacht-website/CLAUDE.md voor de applicatie. Werk vanuit een GitHub-issue met milestone, prioriteit, gebied en omvang, op een eigen branch, met een pull request. Documentatie hoort bij dezelfde wijziging: is een contract, ADR of deze pagina achterhaald, dan is de wijziging niet klaar.
Verder lezen
Deze pagina legt de vorm uit; onderstaande bestanden zijn leidend voor de details.
Eerste sessie
Deze pagina is gegenereerd uit één databron in de repository (src/lib/architecture-guide). Een onderdeel, route, besluit of begrip toevoegen is een datawijziging — de opmaak hoeft niet aangeraakt te worden.