<!-- Uebersetzung von docs/HANDBUCH.md, Quell-Commit 9097793, Stand 2026-09-01 -->
TowerZERO Handboek
Handleiding voor exploitanten, bestuursleden en Betriebsleiter (Duitse wettelijke term voor de verantwoordelijke voor de exploitatie van een ongecontroleerd vliegveld). Dit handboek beschrijft de bediening via het webdashboard - geen techniek, geen commandoregel. Voor installatie en hardware zie README.md (ontwikkelaarsdocumentatie).
Dit handboek is direct in het dashboard te lezen: menu-item Help (pagina /hilfe). Dit bestand is daarvoor de bron - wijzigingen hier verschijnen na de volgende update automatisch in de Help-sectie.
Bijgewerkt: 13.08.2026.
Hoe TowerZERO vluchten herkent
TowerZERO luistert met meerdere receivers tegelijk mee en bouwt daaruit automatisch logboekvermeldingen op:
- ADS-B / transponder (1090 MHz): motorvliegtuigen, helikopters en alle luchtvaartuigen met transponder - registratie, type, positie, hoogte. Optioneel aangevuld met internetbronnen (OpenSky, adsb.fi), die de gaten in de eigen antenne opvullen met gegevens van andere receivers.
- FLARM / OGN (868 MHz): zweefvliegtuigen, motorzweefvliegtuigen en ULs met FLARM - via het Open Glider Network en, afhankelijk van de uitbouwfase, via een eigen receiver direct op het veld.
- Luchtvaartradio: het systeem luistert mee op de veldfrequentie en herkent meldingen zoals start-, landings- en positieoproepen (spraakherkenning volgens de officiële radiotelefonieprocedures).
Een fusielogica voegt de bronnen samen: zien ADS-B en radio hetzelfde vliegtuig, dan ontstaat toch maar één vermelding. Circuits met touch-and-go worden als één trainingsblok met teller bijgehouden, niet als veel losse vluchten. Sleepstart-paren (sleepvliegtuig + zweefvliegtuig) herkent het systeem en koppelt beide vermeldingen aan elkaar.
Wat u hierover moet weten:
- De geofence bepaalt wat meetelt. Alleen bewegingen binnen de ingestelde straal rond het veld (en onder de ingestelde hoogte) worden geregistreerd. Doorvluchten zonder landing worden weggefilterd.
- De detectiegraad ligt op ca. 95-97%. Losse vluchten kunnen ontbreken - typisch wanneer een apparaat aan boord was uitgeschakeld. Het logboek is een zeer goede basis, maar vervangt niet de controlerende blik.
- Radiostilte aan de grond is normaal. FLARM en transponder staan bij geparkeerde toestellen meestal uit. Een vliegtuig wordt in de regel pas bij de start zichtbaar - lege weergaven bij een vol voorterrein zijn geen fout.
- Anonieme FLARM-ID's (zonder opgeslagen registratie) worden als zodanig weergegeven. Hoe beter de thuisvloot wordt bijgehouden, hoe meer daarvan een naam krijgen (zie het hoofdstuk Thuisvloot).
- Alle tijden in het systeem zijn in UTC.
Hoofdstuk: Dashboard
De startpagina toont in één oogopslag de vliegactiviteit van vandaag:
- Vliegbewegingen vandaag: starts, landingen, totaal aantal vermeldingen, waarvan bevestigd en openstaand.
- Bronnen vandaag: via welke ontvangstwegen de bewegingen van vandaag zijn gedetecteerd - handig als snelle gezondheidscheck: ontbreekt een bron helemaal, dan loont een blik in Instellingen (antennestatus).
- Laatste vliegbewegingen: de meest recente vermeldingen met registratie, type, tijden, bronnen en status.
De pagina wordt automatisch elke 30 seconden bijgewerkt.
Hoofdstuk: Logboek
Het volledige logboek van alle geregistreerde bewegingen (bewaartermijn: 2 jaar, daarna automatische anonimisering).
- Filteren: periode afbakenen via de velden "Van" en "Tot".
- Kolommen: registratie, roepnaam, type, start- en landingstijd (UTC), herkomst/bestemming, bemanning, passagiers, soort vlucht, bronnen, status.
- CSV-export: de knop "CSV-export" downloadt de gefilterde periode als bestand voor Excel.
De status van een vermelding is ofwel openstaand (automatisch geregistreerd, nog niet gecontroleerd) of bevestigd (iemand heeft de gegevens gecontroleerd of aangevuld). Bevestigen kan op twee manieren - zie het volgende hoofdstuk.
Hoofdstuk: Vluchten bevestigen en aanvullen
De wet vereist voor elke vlucht enkele gegevens die de sensoren niet kunnen weten: bemanning, passagiers, soort vlucht. Daarvoor zijn er twee pagina's met hetzelfde doel maar verschillende doelgroepen:
Bevestigen (voor de Betriebsleiter/toren): alle openstaande vluchten onder elkaar, met invoervelden direct in de lijst:
- Bemanning en passagiers als getal.
- Soort vlucht: circuit, overlandvlucht, lesvlucht, sleepstart, sleepstart (gesleept), commercieel of overig. Het type vlucht "lesvlucht" stuurt daarnaast de lesvluchtkorting van de facturatie aan (indien geactiveerd).
- Vertrek- en bestemmingsvliegveld: de gewone naam volstaat (bijv. "Bad Neuenahr") - de ICAO-code wordt automatisch opgezocht.
- "Bevestigen" slaat op en werkt de status bij.
Pilotenportaal (voor piloten): dezelfde openstaande vluchten als kaarten met alle gedetecteerde details - tijden, circuits met individuele tijden om uit te klappen, sleepstart-aanduiding ("sleept" / "op sleep achter ..."). Via "Aanvullen & bevestigen" vult de piloot zijn eigen gegevens aan. Het portaal is bereikbaar via het openbare adres van de box - piloten hebben geen login nodig.
Hoofdstuk: Thuisvloot
Bereikbaar onder Instellingen (pagina /admin/aircraft): de lijst van vliegtuigen die op het veld gestationeerd zijn. Ze is het geheugen van het systeem - hoe beter bijgehouden, hoe beter detectie, toewijzing en facturatie worden:
- Een gedetecteerd vliegtuig uit de thuisvloot krijgt automatisch registratie, type en verenigingstoewijzing in zijn logboekvermeldingen.
- De eigenaarsnaam is het factuuradres van de facturatie (groepering per houder).
- MTOW en tariefindeling heeft de matrixmodus van de facturatie nodig.
- Sleephaak en eigen start (bij motorzweefvliegtuigen) helpen bij de sleepstart-detectie.
Velden per vliegtuig: roepnaam (radio), registratie, wedstrijdkenmerk (zweefvliegtuig), type, ICAO-hexcode (transponder), FLARM-ID, OGN-roepnaam, categorie (zweefvliegtuig, motorzweefvliegtuig/TMG, motorvliegtuig, ultralicht, helikopter), eigenaarstype (vereniging, vliegschool, privé, commercieel), eigenaarsnaam, sleephaak, eigen start, MTOW, tariefindeling, notities. De categorie overstemt de automatische classificatie - in geval van twijfel hier expliciet instellen.
Twee hulpmiddelen nemen u werk uit handen:
- Automatische suggesties: vliegtuigen die regelmatig vanaf het veld starten maar nog niet in de lijst staan, worden door het systeem voorgesteld met alle bekende gegevens - één klik neemt ze over.
- Niet-toegewezen FLARM-ID's vandaag: FLARM-ID's zonder bekende registratie die vandaag meermaals op het veld waren, kunnen via een keuzemenu direct aan een vliegtuig uit de thuisvloot worden toegewezen.
Hoofdstuk: Live-kaart
De live-kaart (menu-item "Kaart") toont het actuele luchtruim rond het veld:
- Vliegtuigen in real time met identificatie, hoogte en spoor; de kleur komt overeen met de hoogte.
- De geofence-straal is ingetekend - wat daarbinnen ligt, wordt geregistreerd.
- Kaartlagen: wegenkaart en topografische kaart, optioneel een luchtruim-overlay (indien ingesteld).
De kaart dient ter visualisatie en controle ("ziet het systeem wat ik zie?") - het logboek ontstaat er onafhankelijk van.
Hoofdstuk: FLARM lokaal (extra functie)
Het menu-item "FLARM" toont de directe FLARM-ontvangst van de eigen antenne: alle in de afgelopen 24 uur ontvangen vliegtuigen met afstand, hoogte en aantal waarnemingen - ook die buiten de geofence. Nuttig voor het zweefvliegbedrijf (reikwijdtecontrole, wie er vandaag in de lucht was) en voor antennediagnose.
Deze functie vereist extra ontvangsthardware en een activeringscode; zonder activering toont de pagina een overeenkomstige melding. Activering in Instellingen, sectie OGN/FLARM.
Hoofdstuk: Logboek-widget voor de verenigingswebsite
Het logboek kan in uw eigen website worden ingesloten. De pagina /embed/docs levert de kant-en-klare code om te kopiëren (een iframe) inclusief voorbeeld.
- Geen login nodig: bezoekers zien de vluchten van vandaag en gisteren; piloten kunnen hun gegevens direct in de widget aanvullen.
- Privacy: er worden alleen gegevens getoond die toch al publiekelijk ontvangbaar zijn (registratie, tijden). Aangevulde gegevens zoals bemanning en passagiers worden opgeslagen, maar niet openbaar weergegeven.
- Misbruikbescherming: opslaan is beperkt tot 30 handelingen per minuut en afzender.
- De widget haalt de gegevens live op van de TowerZERO-box; is deze offline, dan toont hij een foutmelding.
Hoofdstuk: Facturatie (landingsgelden)
Wat de functie doet
TowerZERO registreert landingen automatisch. De facturatiefunctie maakt daar een factureringsbasis van: ze groepeert alle landingen per houder, berekent ze met uw tarieventabel en exporteert het resultaat als CSV, afdrukbare nota of factuurontwerp.
Drie uitgangspunten die u moet kennen:
- Automatische registratie, eerlijk vermeld. De detectiegraad ligt op ca. 95-97%. Elk overzicht is een basis om te controleren, geen gecontroleerd factuurdocument. Niet-toewijsbare vliegtuigen (bijv. anonieme FLARM-ID's) worden zichtbaar als aparte post vermeld - dat zijn uw gemiste inkomsten.
- Elke touchdown telt als landing. Circuits met touch-and-go worden meegeteld (gebruikelijke regel van goedgekeurde tarievenlijsten).
- Alle bedragen zijn netto. Btw komt er bij de facturering bovenop.
Inschakelen
De functie staat standaard uitgeschakeld en verstoort het gewone logboekgebruik niet. Om te activeren:
- Instellingen openen, naar de sectie Extra functies scrollen.
- Vinkje zetten bij **"Facturatiefunctie (landingsgelden) activeren"**.
- Daarna verschijnt het menu-item Facturatie bovenaan in de navigatie (tussen FLARM en Instellingen).
De tarieventabel instellen
De tarieventabel stelt u eenmalig handmatig in - daarna staat ze vast. Er zijn twee modi (keuze bovenaan de facturatiepagina, te bevestigen met "Modus opslaan"):
Eenvoudig (6 klassen) - voldoende voor de meeste verenigingsvelden. Eén bedrag per landing voor elke klasse:
- Ultralicht
- Zweefvliegtuig
- Motorzweefvliegtuig (TMG)
- Helikopter
- Motorvliegtuig
- Standaard / overige (opvangklasse, als niets anders past)
De klasse wordt automatisch herkend aan registratie en vliegtuigtype. Opmerking over motorzweefvliegtuigen: echte touring-motorzweefvliegtuigen (bijv. SF 25 Falke, Super Dimona, G109) vallen in de TMG-klasse. Zweefvliegtuigen met een thuiskomhulpmotor (sustainer, bijv. Discus-2cT) gelden verder als zweefvliegtuig - ze starten op sleep en landen zoals zweefvliegtuigen.
Matrix (categorieën x MTOW) - voor velden met een goedgekeurde tarievenlijst op basis van geluidscategorieën en gewichtsklassen (voorbeeld: verkeerslandingsplaatsen zoals Bonn/Hangelar). U legt eigen categorieën aan als rijen (bijv. "Geluidscategorie A", "Geluidscategorie B"), telkens met bedragen voor de gewichtsstappen:
- tot 1.000 kg / tot 1.200 kg / tot 1.400 kg / tot 2.000 kg (vaste bedragen)
- boven 2.000 kg: een tarief per aangevangen 1.000 kg maximaal startgewicht
Bovendien mogelijk:
- Vast tarief: draagt een rij een bedrag in de kolom "Vast tarief", dan worden de gewichtsstappen genegeerd - typisch voor het vaste tarief zweefvliegen.
- Standaard voor zweefvliegtuigen: precies één rij kan worden gemarkeerd als standaard voor zweefvliegtuigen. Alle als zweefvliegtuig herkende vliegtuigen zonder eigen indeling komen daar automatisch terecht.
Om de matrix te kunnen laten rekenen, heeft elk vliegtuig twee stamgegevens nodig in de thuisvloot (pagina /admin/aircraft):
- MTOW (kg): maximaal startgewicht volgens de toelating.
- Tariefindeling: de naam van de matrixrij, exact zoals in de tabel benoemd (bijv. "Geluidscategorie A").
Voor gasten geldt de gebruikelijke bewijslogica van goedgekeurde tarievenlijsten:
- Gast met bekend MTOW, maar zonder indeling: de duurste categorie van zijn gewichtsklasse geldt ("zonder bewijs").
- Gast zonder MTOW: het vliegtuig wordt weergegeven als **"niet indeelbaar"** met 0,00 - het systeem raadt niet. Vul het MTOW achteraf aan (het vliegtuig aan de thuisvloot toevoegen volstaat, ook voor regelmatige gasten), dan rekent de volgende export correct.
Individuele tarieven per registratie bestaan in beide modi: een vast bedrag voor een bepaalde registratie wint het van elke klasse en elke matrix. Handig ook als 0,00 - bijvoorbeeld voor kosteloze officiële dienstvluchten.
Lesvluchtkorting: optioneel kunt u een percentage vastleggen (veld naast de moduskeuze). Het wordt automatisch afgetrokken wanneer bij de logboekvermelding de soort vlucht "lesvlucht" is ingevuld. De soort vlucht onderhoudt u handmatig op de vermelding - het systeem herkent lesvluchten niet zelf. Op de nota verschijnt de aftrek transparant als "Lesvlucht (-X%)".
Facturatieronde: factureren zonder iets te vergeten
Het systeem werkt volgens het principe "nog niet gefactureerd":
- De pagina toont onder "Openstaande landingen" alles wat sinds de laatste ronde is opgelopen - gegroepeerd per houder, met totalen.
- "Ronde afsluiten + CSV" neemt precies deze landingen op in een nieuwe, genummerde ronde en downloadt het CSV-bestand. Elke landing komt terecht in precies één ronde - nooit dubbel, nooit vergeten. Nagekomen landingen (later gedetecteerde landingen) verschijnen automatisch in de volgende ronde.
- "CSV-voorbeeld exporteren" downloadt hetzelfde overzicht zonder een ronde af te sluiten - om vooraf te controleren.
- Optie "Verenigingstoestellen uitsluiten": de toestellen van de exploiterende vereniging (houder-type "vereniging" in de thuisvloot) verschijnen dan niet op de factuur. De ronde boekt ze toch, zodat ze zich niet als "openstaand" opstapelen.
- Afgesloten rondes staan onderaan de pagina en kunnen op elk moment opnieuw als CSV of nota gedownload worden. Belangrijk: herdownloads rekenen met de dan actuele tarieven; de totaalkolom van de tabel toont de stand bij afsluiting.
Het CSV-bestand is voorbereid voor Excel (Duitse versie): puntkomma-gescheiden, bedragen met komma.
Nota's: het landingsoverzicht
De nota is een informatief overzicht - uitdrukkelijk geen factuurdocument en geen betaalverzoek. Hij draagt een overeenkomstige vermelding in de voettekst. Er zijn twee varianten:
- Dagnota: alle landingen van een kalenderdag. Datum kiezen, "Dagnota bekijken" - klaar. De dagnota is puur informatief en boekt niets.
- Rondenota: het individuele bewijsstuk voor een afgesloten ronde (link "Nota" in de rondetabel) - als bijlage bij de facturatie.
Beide tonen een blad per houder met alle vluchten, tarieven en totalen. Afdrukken in de browser genereert een pdf (knop "Afdrukken / als pdf opslaan" - kies in het afdrukdialoogvenster "Als pdf opslaan").
Dagafsluiting: nota's per e-mail versturen
Wie 's avonds het veld afsluit, kan de nota's van de dag met één klik versturen: "Dagafsluiting: nota's versturen".
- De interne ontvangerslijst (bijv. Betriebsleiter, boekhouding) ontvangt de totaalnota met alle houders.
- Houders met een opgeslagen e-mailadres ontvangen **alleen hun eigen** nota. De adressen onderhoudt u in de tabel "E-mailadressen van houders" op de facturatiepagina. Houders zonder adres worden gewoon overgeslagen.
- Elke verzending wordt gelogd (weergave van de laatste verzendingen op de pagina).
Voorwaarde is een ingerichte e-mailverzending via de mailbox van de exploitant. Dat gaat direct op de facturatiepagina: sectie "E-mailverzending instellen (mailbox van de exploitant)" - smtp-server, poort, gebruikersnaam, wachtwoord, versleuteling (STARTTLS op poort 587 of SSL op poort 465), afzenderadres en de interne ontvangers invullen, opslaan, klaar (werkt onmiddellijk). Met "Testmail versturen" controleert u direct de opgeslagen instellingen - de testmail gaat naar een willekeurig adres of naar de eerste interne ontvanger. De toegangsgegevens krijgt u van uw e-mailprovider; bij twijfel helpt de TowerZERO-service. Zolang er geen verzending is ingesteld, verschijnt de verzendknop niet.
Overdracht aan de boekhoudsoftware
In plaats van handmatig CSV-werk kan TowerZERO afgesloten rondes rechtstreeks als factuurontwerpen overdragen aan Papierkram (knop "Ontwerpen aanmaken" in de Papierkram-kolom van de betreffende ronde). Per houder ontstaat één ontwerp met alle posten; controle en verzending gebeuren in de boekhoudsoftware - TowerZERO stelt geen facturen op. De overdracht kan veilig herhaald worden: reeds overgedragen houders worden bij een tweede klik overgeslagen. Voorwaarde is een Papierkram-account van de exploitant (API-toegang in de configuratie). Andere aanbieders (Lexware Office, Billomat) zijn voorbereid, maar nog niet beschikbaar.
Wat de facturatie bewust niet kan
- Hangvluchten van helikopters (vergoeding per aangevangen minuut) kan het systeem niet betrouwbaar meten - gelieve dit handmatig na te registreren.
- Complexe lesvluchtregelingen (korting alleen op bepaalde tijden, minimumbedragen, alleen bepaalde geluidscategorieën) beeldt het percentageveld niet af - het rekent een uniforme aftrek.
- Noodlandingen en andere vrijstellingen per geval: de betreffende vermelding vóór het afsluiten van de ronde in het logboek corrigeren, of voor permanent vrijgestelde registraties een individueel tarief van 0,00 aanmaken.
- Stallingskosten (per nacht) registreert het systeem niet - het telt landingen, geen stallingstijd.
- Jaarlijkse terugbetalingen (bijv. voor zweefvliegclubs) berekent u buiten het systeem; de rondes leveren daarvoor de totalen.
Korte checklist voor de inrichting
- Instellingen: facturatiefunctie activeren.
- Tariefmodus kiezen (eenvoudig of matrix), bedragen invullen, opslaan.
- Thuisvloot controleren: houdernamen ingevuld? Bij matrix: MTOW en indeling per toestel?
- Optioneel: individuele tarieven (bijv. 0,00 voor officiële vluchten), lesvluchtkorting, e-mailadressen van houders.
- Na een paar dagen: CSV-voorbeeld controleren, eerste ronde afsluiten.
Hoofdstuk: Instellingen
De pagina Instellingen bundelt configuratie en systeemstatus. De technische inrichting (receivers, frequenties, gegevensbronnen) neemt in de regel de TowerZERO-service voor haar rekening - in het dagelijks gebruik zijn vooral deze gebieden interessant:
- Vliegveld en geofence: stamgegevens van het veld en het registratiegebied (straal en maximale hoogte). Wijzigingen hier werken direct door op wat in het logboek terechtkomt.
- Antennestatus: een stoplicht per ontvangstweg (ADS-B, FLARM, radio) met ontvangstpercentages en plausibiliteitsbeoordeling. Eerste aanspreekpunt bij de vraag "ontvangt de box nog goed?".
- Watchdog en systeemstatus: bewaking van de interne diensten. Meldt de watchdog zich aanhoudend, neem dan contact op met support.
- Database & export: bewaartermijn en CSV-export.
- Extra functies: de vinkjes voor optionele functies. De facturatiefunctie (zie hoofdstuk Facturatie) en de vliegveldprofielwissel voor demo- en zwerftoestellen - deze laatste blendt de sectie Vliegveldprofiel in en vereist bij activering een activeringscode. Op permanent geïnstalleerde boxen blijft hij uitgeschakeld.
Als vuistregel: statusweergaven bekijken is altijd zonder risico; configuratiewaarden alleen wijzigen als duidelijk is wat ze doen - bij twijfel eerst support raadplegen.
Na een stroomstoring
Korte storingen overbrugt een optionele UPS ongemerkt. Na een langere storing blijft het apparaat uit: eenmaal op de aan-knop drukken, na twee tot drie minuten draait alles weer. Er gaan geen gegevens verloren.
Hoofdstuk: Support
Onder Instellingen vindt u het supportformulier (pagina /admin/support): vraag beschrijven, versturen - daaruit ontstaat direct een ticket bij TowerZERO-support. De belangrijkste systeeminformatie (versie, configuratiestand) wordt automatisch meegestuurd, zodat de diagnose zonder wedervragen kan starten.
Voor al het overige: westkueste.net of de bekende directe lijn.