Zelf een afspraak boeken,
zonder een enkel bericht.

Eén businesslaag, hergebruikt door de publieke site, de web-admin en de JSON-API voor de app. Geen logica gedupliceerd.

Stack

PHP 8 met MySQL/MariaDB via vanilla PDO, volledig server-rendered. Geen framework, geen Composer. Draait op shared hosting; elke push naar main deployt via een GitHub Action over FTPS. Alle bedrijfswaarden — tarieven, teksten, werkgebied — staan in een settings-tabel, niet in de code.

Beschikbaarheid

Terugkerende weekregels (weekdag, tijdvak, modus: direct / op aanvraag / gesloten) plus eenmalige uitzonderingen per datum. Eén functie legt beide samen tot de tijdssegmenten van een dag; uitzonderingen overrulen de weekregels.

Google Calendar

OAuth2 in de admin. Google zegt enkel wanneer je bezet bent — de agenda-inhoud blijft dicht. Vrij/bezet wordt elke 15 minuten opgehaald en gecachet. Een bevestigde afspraak verschijnt als event in de doelagenda; bij annuleren verdwijnt het weer.

Slot-engine

Berekent de concrete boekbare startmomenten. Instellingen die meespelen: opzegtermijn, boekingshorizon, slot-granulariteit en per dienst de duur, buffer en modus. Woont de klant buiten de directe straal, dan zakken direct-slots automatisch naar “op aanvraag”.

  beschikbaarheid (weekregels + uitzonderingen)
− Google-bezet (gecachte vrij/bezet)
− bestaande afspraken + hun buffer
  binnen [nu + opzegtermijn, nu + horizon]
  in stappen van de slot-granulariteit
= boekbare slots, elk met hun modus

Prijs & afstand

Postcode en gemeente worden gegeocodeerd (met cache, ook voor mislukkingen). Rijafstand via OpenRouteService, met terugval op hemelsbreed. Buiten het werkgebied is niet boekbaar; in de basisgemeente geldt een vast tarief, elders tarief per km, heen en terug.

Afspraak-levenscyclus

Eén centrale functie schrijft de statusovergang weg en voert daarna de neveneffecten uit — Google, mails, facturatie — in een try/catch, zodat een mislukte mail de statuswijziging nooit breekt. Een tegenvoorstel krijgt een geheime token die na één klik in de mail opbrandt; dat is de enige uitzondering op “geen klant-login”.

aangevraagd ──▶ bevestigd ──▶ uitgevoerd
     │              │
     ▼              ▼
 geweigerd      geannuleerd

E-mail & push

Mail via PHPMailer en SMTP, elke poging gelogd. Alle klantmails gaan automatisch — ontvangst, bevestiging, voorstel, weigering, annulatie — met een blinde kopie voor de technieker. Push naar iPhone via APNs, met een wachtrij die mislukte meldingen opnieuw probeert.

Cron

Drie taken: de vrij/bezet-cache warm houden (elk kwartier), de GDPR-bewaartermijn toepassen (dagelijks) en de push-wachtrij leegmaken (elke minuut).