Ga naar hoofdinhoud

Woordenlijst

Deze pagina definieert de canonieke termen die overal in Agon en zijn documentatie worden gebruikt. Gebruik bij twijfel exact deze termen — geen synoniemen.

Studiomanager​

De eigenaar of beheerder van een Agon-installatie. De studiomanager maakt lessen aan, beheert klanten en instructeurs, configureert lidmaatschappen en heeft volledige toegang tot alle instellingen en rapporten.

Niet: admin, eigenaar, operator.

Klant​

Een persoon die lessen bijwoont bij de studio. Klanten gebruiken de mobiele Agon-app om het rooster te bekijken, lessen te boeken en in te checken.

Niet: lid, leerling, gebruiker, afnemer.

Instructeur​

Een personeelslid dat lessen geeft. Instructeurs staan los van studiomanagers — ze kunnen het lesrooster en de deelnemerslijst zien, maar kunnen geen studio-instellingen wijzigen of toegang krijgen tot financiële gegevens.

Niet: leraar, coach, trainer, personeelslid.

Lestype​

Een herbruikbare definitie van een type les — de naam, standaardduur, standaardcapaciteit en de bijbehorende instructeur. Zie het als het "type" les, niet als een specifieke instantie.

Voorbeeld: "Yoga Flow" is een lestype. Elke dinsdag om 9:00 uur is een aparte geplande les op basis van dat lestype.

Niet: lescategorie, lesdefinitie, activiteit.

Geplande les​

Een specifieke instantie van een lestype op een specifieke datum en tijd, op een specifieke locatie, met een bevestigde instructeur en capaciteit. Klanten boeken geplande lessen, geen lestypen. Een geplande les is een groepsactiviteit met gedeelde capaciteit — zie Afspraak voor het 1-op-1-equivalent.

Niet: lessessie, evenement, slot.

Boeking​

De bevestigde reservering van een klant voor een specifieke geplande les. Een boeking schrijft één credit af van het actieve lidmaatschap van de klant (indien van toepassing) en geeft de klant toegang om in te checken.

Niet: reservering, registratie, inschrijving.

Afspraak​

De bevestigde 1-op-1-boeking van een klant met een specifieke instructeur voor een specifieke afspraakdienst (bijvoorbeeld personal training, massage of privécoaching) op een specifieke datum en tijd. In tegenstelling tot een geplande les heeft een afspraak precies één klant en geen gedeelde capaciteit. Het boeken van een afspraak schrijft één credit af van het actieve lidmaatschap van de klant, hetzelfde mechanisme als bij het boeken van een les — er is geen apart betaalpad voor afspraken. Een studiomanager of instructeur kan een bevestigde afspraak achteraf als voltooid of als no-show markeren, en hetzelfde beleid voor vergoedingen bij late annulering / no-show als bij lesboekingen is van toepassing.

Niet: sessie, privéles, 1-op-1-sessie, reservering, les.

Afspraakdienst​

Een door de studiomanager gedefinieerd type afspraak dat klanten kunnen boeken (bijvoorbeeld "Personal Training" of "Massage van 60 minuten"), met een vaste duur en een optionele buffertijd — een pauze die na elke afspraak wordt afgedwongen voordat de volgende voor dezelfde instructeur kan beginnen. Een dienst deactiveren is een zachte verwijdering: hij verschijnt niet meer voor nieuwe boekingen, maar de afsprakengeschiedenis die ernaar verwijst, blijft behouden. Er is geen optie voor definitieve verwijdering.

Niet: diensttype, sessietype, behandeling.

Beschikbaarheid instructeur​

De terugkerende wekelijkse tijdvensters waarin een instructeur kan worden geboekt voor afspraken (bijvoorbeeld "dinsdag 09:00–13:00"). Beschikbaarheid is alleen wekelijks terugkerend — Agon ondersteunt nog geen datumspecifieke uitzonderingen of vakantieoverschrijvingen. Beschikbare afspraaktijdslots worden berekend op basis van deze vensters, minus de bestaande bevestigde afspraken van de instructeur en de buffertijd van de dienst die wordt geboekt.

Niet: werktijden, rooster, dienst.

Wachtlijst​

Als een geplande les vol is, kunnen klanten zich op de wachtlijst inschrijven. Wanneer een boeking wordt geannuleerd, wordt de eerste klant op de wachtlijst automatisch gepromoveerd tot een bevestigde boeking en op de hoogte gebracht.

Check-in​

Bevestiging dat een klant fysiek aanwezig was bij een les. Inchecken kan worden gedaan door de klant (via QR-code in de mobiele app), door de instructeur (door de code van de klant te scannen) of handmatig door de studiomanager.

Niet: aanmelden, aanwezigheid, inklokken.

Lidmaatschap​

Een pakket dat een klant gedurende een bepaalde periode toegang geeft tot lessen. Er zijn twee soorten:

  • Terugkerend lidmaatschap — actief voor een vast aantal dagen (bijv. 30 dagen) en automatisch verlengd via Stripe.
  • Creditpakket — een vast aantal credits dat één per boeking wordt verbruikt, zonder tijdslimiet.

Niet: abonnement, plan, pakket, pas.

Credit​

Eén enkele eenheid toegang tot één les, inbegrepen in een creditpakket-lidmaatschap. Elke boeking schrijft één credit af. Credits verlopen niet, tenzij het lidmaatschap zelf een vervaldatum heeft.

Niet: token, punt, sessiecredit, lespas.

Overgedragen credit​

Een ongebruikt credit dat naar de volgende factureringsperiode van een klant wordt meegenomen in plaats van verloren te gaan, wanneer een terugkerend lidmaatschapstype creditoverdracht heeft ingeschakeld. Een lidmaatschapstype kan optioneel beperken hoeveel credits per periode kunnen worden overgedragen.

Niet: doorgeschoven credit, opgespaard credit.

Introductieaanbieding​

Een gereduceerde prijs voor de eerste aankoop en/of een geldigheidsvenster op een lidmaatschapstype, dat automatisch aan een klant wordt getoond de eerste keer dat hij dat lidmaatschapstype koopt (of een ander lidmaatschapstype met introductieaanbieding bij dezelfde studio). Reguliere prijzen gelden voor alle latere aankopen.

Niet: proefaanbieding, welkomstkorting, korting voor nieuwe klanten.

Vergoeding late annulering / No-show-vergoeding​

Een bedrag dat aan een klant wordt aangerekend wanneer hij een boeking annuleert binnen het annuleringsvenster (een late annulering, alleen als "annulering schrijft credit af" is ingeschakeld) of als no-show wordt gemarkeerd bij het inchecken. Per klant opgelost als: de override van het lidmaatschapstype van de klant, dan de studiobrede standaard, dan geen vergoeding. Geregistreerd als een Payment-rij in plaats van een automatische kaartafschrijving — de studio moet die nog steeds via haar eigen proces innen.

Niet: boete, annuleringsafschrijving (als apart concept van de vergoeding zelf).

Promotiecode​

Een code die een klant invoert bij het afrekenen van een lidmaatschap om een procentuele of vaste korting te ontvangen. Geconfigureerd door de studiomanager met een optionele gebruikslimiet, een beperking van één keer per klant en een geldigheidsvenster.

Niet: kortingscode, coupon.

Cadeaubon​

Een vooruitbetaald saldo dat wordt geïdentificeerd door een code (formaat GC-XXXXXXXX) dat een klant kan inwisselen bij de aankoop van een lidmaatschap, of dat een studiomanager handmatig uitgeeft voor een telefonische of persoonlijke verkoop. Een klant kan ook zelf een cadeaubon kopen als cadeau voor iemand anders.

Niet: voucher, creditnota.

Tag​

Een kort, gekleurd label dat een studiomanager aan een klant koppelt om de klantenlijst te organiseren en te filteren (bijv. "VIP", "Blessurerisico"). Tags kunnen handmatig worden toegewezen of automatisch via een auto-tagregel. Klanten zien hun eigen tags alleen-lezen in de mobiele app.

Niet: label (als apart concept), categorie.

Product​

Een retailartikel dat een studiomanager in de catalogus bijhoudt voor persoonlijke verkoop — bijv. een eiwitreep of waterfles — met een naam, optionele SKU, prijs en bijgehouden voorraadhoeveelheid. Beheerd onder Producten in de desktop-backoffice; alleen voor managers, geen client-toegankelijke weergave.

Niet: artikel, SKU (een SKU is een veld op een product, niet het product zelf).

Productverkoop​

Een registratie van een voltooide persoonlijke verkoop van een of meer producten, vastgelegd door een studiomanager nadat de betaling al was ontvangen via contant geld, kaart of een andere methode buiten Agon. Optioneel gekoppeld aan een klant, of achtergelaten als een losse verkoop. Het registreren van een verkoop schrijft de verkochte hoeveelheden af van de voorraad van elk product.

Niet: bestelling, transactie, aankoop (voorbehouden voor aankopen van lidmaatschappen/cadeaubonnen die via Stripe worden verwerkt).

Auto-tagregel​

Een regel die automatisch een tag aan een klant toewijst wanneer een gekozen triggergebeurtenis voor hem plaatsvindt (bijvoorbeeld een no-show of een geannuleerde boeking). Geconfigureerd door de studiomanager; werkt automatisch zonder handmatige actie zodra hij is aangemaakt.

Vrijwaring​

Een document (bijvoorbeeld een aansprakelijkheidsverklaring of studiobeleid) dat een studiomanager opstelt en van klanten kan verlangen dat ze het digitaal ondertekenen voordat ze kunnen boeken. Het bewerken van de inhoud van een vrijwaring maakt een nieuwe versie aan en vereist dat elke klant opnieuw ondertekent, ook wie een eerdere versie heeft ondertekend. Ondertekenen gebeurt altijd door de klant zelf — er is geen manier voor een studiomanager of instructeur om namens een klant te ondertekenen.

Niet: toestemmingsformulier (alleen gebruiken bij verwijzing naar het aparte AVG-toestemmingslogboek), verklaring, overeenkomst.

Agendasynchronisatietoken​

Een langlevend geheim dat is ingebed in de URL van de persoonlijke agendafeed van een klant, gebruikt omdat agenda-apps (Google, Apple, Outlook) een statische URL pollen en geen app-login kunnen uitvoeren. Het token in de URL is zelf de credential. Een klant of studiomanager kan het opnieuw genereren, waardoor de oude link ongeldig wordt en opnieuw abonneren vereist is.

Locatie​

Een fysieke plaats waar lessen worden gehouden. In V1 ondersteunt Agon één locatie. Ondersteuning voor meerdere locaties is gepland voor V2. Het veld location_id staat al in het databaseschema.

Niet: filiaal, venue, studio (gebruik "studio" alleen om het hele bedrijf aan te duiden, niet een specifieke ruimte of gebouw).

Tunnel​

Een beveiligde openbare HTTPS-URL die via Cloudflare Tunnel wordt gemaakt en die je klanten in staat stelt de mobiele app van overal met je Agon-instantie te verbinden, zonder je lokale netwerk bloot te stellen.

Niet: URL, verbinding, link, proxy.

Studio-QR-code​

Een QR-code die wordt getoond in Instellingen → Connectiviteit en die de Tunnel-URL codeert. Klanten scannen deze code één keer bij het instellen van de mobiele app om verbinding te maken met je studio.

Website-widget​

Een insluitbaar, alleen-lezen paneel met het lesrooster dat een studiomanager als <iframe> op zijn eigen openbare website plakt (de insluitcode is te vinden in Instellingen → Website-widget). Het toont aankomende geplande lessen met instructeur en beschikbare plaatsen, in de eigen merkkleuren van de studio — nooit prijzen, lidmaatschappen, deelnemerslijsten of contactgegevens van instructeurs. Het ondersteunt momenteel niet het boeken van een les vanuit de widget zelf; klanten boeken nog steeds via de mobiele app. De widget wordt aangeboden vanaf de eigen Tunnel-URL van de studio, dus de insluitcode moet opnieuw worden gekopieerd telkens wanneer het tunneladres verandert (bijvoorbeeld na een herstart van de Agon-backend).

Niet: roosterwidget, boekingswidget, embed, iframe.

Uitnodigingstoken​

Een token met een beperkte geldigheidsduur dat per e-mail wordt verzonden naar een nieuw aangemaakte klant. De klant volgt de link om zijn wachtwoord in te stellen en zijn account te activeren. Verloopt na 7 dagen.

Reset-token​

Een token met een beperkte geldigheidsduur dat per e-mail wordt verzonden wanneer een klant een wachtwoordreset aanvraagt. Verloopt na 2 uur.

Smart List​

Een opgeslagen filter dat een subset van klanten identificeert op basis van lidmaatschapsstatus, recentheid van boekingen, inschrijfdatum of lidmaatschapstype. Gebruikt om gerichte e-mails te versturen.

Blok​

Een enkel element in het canvas van de visuele e-mailbuilder — tekst, afbeelding, knop, scheidingslijn, tussenruimte of ruwe HTML — dat een studiomanager toevoegt, ordent en configureert om een e-mailsjabloon te bouwen. Blokken stapelen van boven naar beneden en elk heeft zijn eigen bediening (uitlijning, kleur, grootte, enzovoort) die verschijnt wanneer het blok is geselecteerd; het canvas geeft de e-mail exact weer zoals die wordt verzonden, live, zonder aparte voorbeeldstap. Een sjabloon dat vóór deze functie is gebouwd of bewerkt heeft geen blokken — het openen ervan biedt "Omzetten naar canvas" aan, wat de bestaande HTML als één beginblok verpakt zodat niets verloren gaat.

Niet: element, component, widget, module.

Gebeurtenistoewijzing​

Een configuratie die een Agon-gebeurtenis (bijv. "nieuwe klant uitgenodigd", "boeking bevestigd") koppelt aan een specifiek e-mail- of SMS-sjabloon. Wanneer de gebeurtenis plaatsvindt, wordt het toegewezen sjabloon automatisch verzonden — op voorwaarde dat die gebeurtenis daadwerkelijk aan het versturen van berichten is gekoppeld (momenteel activeren alleen "nieuwe klant uitgenodigd" en "wachtwoordreset" een verzending, voor zowel e-mail als SMS).

Marketingautomatisering​

Een meerstaps, vertraagde reeks e-mails en/of sms'jes die een studiomanager één keer opbouwt en daarna nooit meer met de hand verstuurt — bijvoorbeeld "wacht 3 dagen na aanmelding, stuur een e-mail; wacht nog 7 dagen, en als de klant nog steeds niet heeft geboekt, stuur er nog een." Opgebouwd uit een trigger (een gebeurtenis zoals een nieuwe aanmelding of boeking, of een terugkerende voorwaarde zoals "heeft in 30 dagen niet geboekt"), een geordende lijst met stappen (elk een vertraging, een kanaal en een sjabloon), en een optionele stopvoorwaarde. Een klant wordt automatisch ingeschreven wanneer de trigger overeenkomt en wordt hoogstens één keer per automatisering ingeschreven, ooit. Anders dan een Gebeurtenistoewijzing, die één enkel bericht verstuurt op het moment dat een gebeurtenis plaatsvindt, spreidt een Marketingautomatisering meerdere berichten uit over de tijd.

Niet: dripcampagne, workflow, reeks (op zichzelf, zonder "automatisering").

Online les​

Een geplande les die de studiomanager heeft gemarkeerd als "Online (Zoom)", waarvoor Agon automatisch een echte Zoom-vergadering aanmaakt en beheert via het eigen gekoppelde Zoom-account van de studiomanager. Alleen een enkele (niet-terugkerende) les kan als online worden gemarkeerd. Klanten zien een client-gerichte deelnamelink ("Deelnemen via Zoom") op de les en hun boeking; de studiomanager en de instructeur zien afzonderlijk een startlink die alleen voor de host is ("vergadering starten"), die nooit aan klanten wordt getoond. Beschikbaar op elk Zoom-abonnement, inclusief de gratis versie.

Niet: virtuele les, Zoom-les, livestream-les.

Migratieassistent​

De ingebouwde tool voor het importeren van je klanten, lidmaatschappen en lessen in Agon vanuit een CSV-, Excel- of JSON-export van je huidige platform. Toegankelijk via Instellingen → Migratie en alleen beschikbaar voor Managers. Elk soort gegevens wordt apart geïmporteerd, één tegelijk. Agon maakt nooit verbinding met je oude platform en vraagt niet om de inloggegevens ervan: je exporteert je eigen gegevens en uploadt het bestand.

Looncomponent​

Een enkele regel die bepaalt hoe een personeelslid loon verdient — Uurtarief, Per les, Commissie of Vast salaris. Een personeelslid kan tegelijk meerdere actieve looncomponenten van verschillende typen hebben (bijvoorbeeld een uurtarief en een commissie samen), maar nooit twee actieve componenten van hetzelfde type. Beheerd onder Personeelssalaris; alleen voor managers, geen client-toegankelijke weergave.

Niet: looncategorie, salarisregel, beloningsregel.

Salarisverwerking​

Een door een studiomanager gegenereerde berekening van wat elk personeelslid verschuldigd is voor een gekozen datumbereik, berekend op basis van hun actieve looncomponenten. Een verwerking begint als een concept, dat vrij opnieuw kan worden gegenereerd, en wordt gefinaliseerd zodra de studiomanager die vergrendelt — de bedragen van een gefinaliseerde verwerking veranderen nooit meer. Het markeren van de regelitems van een gefinaliseerde verwerking als betaald legt vast dat de studiomanager het personeelslid buiten Agon heeft betaald; er wordt geen geld binnen Agon verplaatst.

Niet: salarisperiode, loonronde, loonstrook.

Rol​

Een benoemde set machtigingen die aan precies één personeelsaccount wordt toegewezen en die bepaalt wat dat account in de desktop-app kan zien en doen. Manager en Instructeur zijn ingebouwde rollen die altijd bestaan en niet kunnen worden hernoemd of verwijderd. Een studiomanager kan ook een willekeurig aantal aangepaste rollen definiëren (bijvoorbeeld "Receptie"), die elk Bekijken en/of Beheren verlenen op een combinatie van vijf gebieden: Lessen, Leden, Boekingen, Check-ins en Lidmaatschappen. Beheerd onder Personeel & Rollen; alleen voor managers, geen client-toegankelijke weergave.

Niet: machtigingsgroep, toegangsniveau, gebruikerstype.

Machtiging​

Een enkele verleende bevoegdheid binnen een Rol — één gebied (Lessen, Leden, Boekingen, Check-ins of Lidmaatschappen) op één niveau (Bekijken of Beheren). De volledige set machtigingen van een rol bepaalt welke items in de linkerzijbalk een personeelsaccount ziet en wat het daarmee kan doen. Elk gebied van Agon buiten die vijf (betalingen, rapporten, marketing, instellingen, personeel/salaris, kassa, enzovoort) heeft geen machtiging die daar toegang toe kan geven — die blijven alleen voor managers, ongeacht de machtigingen van een rol.

Niet: scope, recht, toegangsverlening.

Rechtsgebied​

Welk factuursjabloon Agon gebruikt voor een gegenereerde factuur — eu_vat, us_sales_tax of generic — bepaald door het geconfigureerde land van de studio in Instellingen op het moment dat de factuur wordt gegenereerd. Een EU-rechtsgebied levert een btw-factuur met btw-nummers van verkoper/koper en een btw-specificatie; het Amerikaanse rechtsgebied levert een specificatie van omzetbelasting zonder btw-nummervelden; elk ander land levert een generieke factuur zonder geclaimde belastingspecificatie. Zie Factuur.

Niet: regio, belastingzone, land (het land is de studio-instelling die het rechtsgebied bepaalt, niet het rechtsgebied zelf).

Factuur​

Een opeenvolgend genummerd pdf-document dat wordt gegenereerd voor een voltooide lidmaatschapsbetaling of een geregistreerde productverkoop, geformuleerd en gestructureerd voor het rechtsgebied van de studio. Er kan slechts één factuur bestaan per betaling of per verkoop. De facturatie van Agon is een documentgenerator, geen geautomatiseerde dienst voor belastingnaleving — belastingtarieven worden altijd ingevoerd door de studiomanager (of, voor EU-studio's, een geconfigureerd standaard-btw-tarief), en geen enkele factuur wordt ooit ingediend bij het e-factureringsnetwerk van een belastingdienst. Beheerd onder Facturen; alleen voor managers, geen client-toegankelijke weergave.

Niet: kassabon, rekening, afschrift.

Feedback​

Een foutmelding, vraag of suggestie die een medewerker per e-mail naar de ontwikkelaar van Agon stuurt, via het scherm Feedback in de desktopapp (de knop opent een concept aan support@agon-studio.dev) of vanaf elk e-mailaccount. Het concept bevat alleen de appversie en het besturingssysteem; er wordt niets over de studio of haar klanten automatisch toegevoegd.

Niet: supportticket, bugticket, klacht.

AI-providersleutel​

Een API-sleutel die van de studio is, aangemaakt bij een AI-provider (Google Gemini of Groq) en door de studiomanager opgeslagen in Instellingen → AI-assistent. De AI-assistent gebruikt hem om die provider rechtstreeks vanaf de computer van de studio te bereiken. Versleuteld opgeslagen in de lokale database, na het opslaan nooit meer getoond, en gewist met Sleutel verwijderen op hetzelfde tabblad. De assistent kan ook een lokaal model (Ollama) gebruiken. Zie Basismodus.

Niet: licentiesleutel, Agon-sleutel, token.

Basismodus​

Hoe de AI-assistent werkt als er geen AI-providersleutel of lokaal model is ingesteld: een zoekfunctie op trefwoorden in de Agon-documentatie die volledig op de computer van de studio draait, zonder AI en zonder netwerkverbinding. Kan geen vrije vragen beantwoorden, geen AI-acties uitvoeren en geen zakelijk advies geven.

Niet: offlinemodus, gratis modus, lite-modus.

Foutrapportage​

Een optionele instelling in Instellingen → Privacy, standaard uit, waarmee Agon technische details van fouten (zonder persoonsgegevens) via Sentry (EU) naar de ontwikkelaar van Agon kan sturen om bugs op te lossen. Elk rapport bevat de ID van de studio. De keuze van de studiomanager geldt ook voor de mobiele app en de website-widget van de studio.

Niet: telemetrie, analytics, crashlogs.

Top-uitgevers-cohort​

De groep betalende klanten met de hoogste totale uitgaven in een bepaalde periode — de top 20% van betalende klanten op uitgaven, of de top 5 als 20% minder dan dat zou zijn. Gebruikt op de pagina Inzichten en door de bedrijfsadviesvragen van de AI-assistent om te vergelijken hoe je hoogst uitgevende klanten zich gedragen ten opzichte van iedereen. Altijd gerapporteerd als aantallen en gemiddelden op groepsniveau — Agon identificeert nooit welke specifieke klanten in het cohort zitten.

Niet: VIP-klanten, topklanten, beste klanten (alleen gebruiken in gewone gesprekstaal, niet als de technische term voor deze specifieke groep).