Phoenix Logboek App

WordPress-plugin voor de Phoenix, een zelfgemaakt motorjacht van 7 meter lang, 3 meter breed, 80 cm diepgang, 2,35 meter hoogte en een dieselmotor met topsnelheid van ongeveer 8 km/uur.

Status / v1.2.0 (juli 2026) Deze plugin is ingericht als app-achtige WordPress-oplossing voor een boot: de Phoenix, inclusief route logging, logboek, taken, kosten, bootprofiel, instellingen, rapportages en export-hardening. Post-release update: anonieme dashboard demo-modus (Story 8) toegevoegd zonder database-opslag.

Inhoudsopgave

1. Features
2. Requirements
3. Installation
4. Usage
5. Project Structure
6. MVP Status en Roadmap
7. Deploy Productie
8. Documentatie
9. Contributing
10. License

Features

• Bootprofiel voor de Phoenix met vaste eigenschappen zoals lengte, breedte, diepgang, hoogte, gewicht en brandstoftype
• Start/stop GPS route logging vanaf mobiel of tablet
• Vastleggen van trackpoints, duur, afstand en gemiddelde snelheid
• Brandstofinschatting op basis van gemiddeld verbruik
• Captain's log per dag met foto’s
• GPX kaartgeneratie en delen via download of e-mail
• TODO-beheer met status en prioriteit
• Kostenbeheer voor varen, onderhoud en onderhoudsartikelen
• Dashboard met vaartstatus, live routekaart en recente routeweergave
• Bootprofielbeheer in wp-admin
• Instellingen voor GPS-interval, brandstofverbruik, valuta en afstandseenheid
• Gecombineerde rapportagepagina voor trips, kosten, logboek en taken
• Dedicated admin-UI voor trackpoints bewerken/repareren per trip, inclusief filters op datumrange en laadlimiet
• Bulkacties voor selectie/verwijderen van trips (admin), TODO's en kosten (frontend)
• Schermvullende live routekaart in frontend dashboard
• Anonieme demo-modus met tijdelijke live route zonder database-opslag
• Hardening op import/export validatie en foutrapportage (CSV/GPX/ZIP)

Requirements

• WordPress omgeving
• PHP-ondersteuning voor standaard WordPress pluginfunctionaliteit
• Mobiel of tablet met GPS voor route logging
• Beheerder met voldoende rechten voor configuratie en onderhoud

Installation

1. Plaats de pluginmap in de WordPress plugin directory.
2. Activeer de plugin via het WordPress dashboard.
3. Controleer of het bootprofiel voor de Phoenix is aangemaakt.
4. Stel indien nodig bootgegevens, brandstofverbruik en dashboardvoorkeuren in.

Usage

Bootprofiel

De plugin ondersteunt standaard één boot: de Phoenix.

Vast te leggen bootgegevens:

Gegeven	Waarde
Naam	Phoenix
Type	Zelfgemaakt motorjacht
Lengte	7 meter
Breedte	3 meter
Diepgang	80 cm
Hoogte	2,35 meter
Motor	Diesel
Topsnelheid	Ongeveer 8 km/uur
Gewicht	Ongeveer 4 ton

Route logging

1. Open het dashboard.
2. Druk op Start om een tocht te beginnen.
3. Laat de app GPS-coördinaten vastleggen.
4. Druk op Stop om de tocht af te sluiten.
5. Bekijk duur, afstand, gemiddelde snelheid en geschat brandstofverbruik.

Captain's log

Gebruik het logboek voor dagelijkse notities en voeg eventueel foto’s toe via admin of frontend.

GPX en delen

Na een tocht kan de route als GPX worden gegenereerd en gedeeld via download of e-mail.

TODO en kosten

Gebruik de aparte formulieren voor onderhoudstaken en kostenregistratie.

Rapportages

Gebruik de rapportagepagina in wp-admin voor een gecombineerd periodeoverzicht van trips, kosten, logboekitems en open taken.

Deploy Productie

Huidig productie-artifact:

• dist/bso-phoenix-v1.2.0-prod-20260705.zip

Standaard deployflow:

1. Maak backup van database en pluginmap.
2. Upload het zipbestand via WordPress plugin upload.
3. Activeer/update plugin.
4. Voer rooktest uit op dashboard, rapportages en trackpoints beheer.

Voor volledige operationele stappen en rollback: zie runbook.

Project Structure

bso-phoenix/
├── admin/
│   ├── class-phoenix-admin-page.php
│   ├── class-phoenix-boat-admin.php
│   ├── class-phoenix-cost-admin.php
│   ├── class-phoenix-log-admin.php
│   ├── class-phoenix-reports-admin.php
│   ├── class-phoenix-trackpoints-admin.php
│   ├── class-phoenix-settings-admin.php
│   └── class-phoenix-todo-admin.php
├── assets/
│   ├── css/
│   │   └── phoenix-frontend.css
│   └── js/
│       └── phoenix-frontend.js
├── document/
│   ├── Functional_Design.md
│   ├── Release_Notes_1.0.0.md
│   ├── Release_Notes_1.1.0.md
│   ├── Release_Notes_1.1.1.md
│   ├── Testplan_Trackpoints_Bewerken_Repareren.md
│   ├── User_Story_Trackpoints_Bewerken_Repareren.md
│   └── Technical_Design.md
├── includes/
│   ├── class-phoenix-ajax.php
│   ├── class-phoenix-boat-service.php
│   ├── class-phoenix-cost-ajax.php
│   ├── class-phoenix-cost-service.php
│   ├── class-phoenix-db.php
│   ├── class-phoenix-frontend.php
│   ├── class-phoenix-log-ajax.php
│   ├── class-phoenix-log-service.php
│   ├── class-phoenix-plugin.php
│   ├── class-phoenix-settings-service.php
│   ├── class-phoenix-todo-ajax.php
│   ├── class-phoenix-todo-service.php
│   └── class-phoenix-trip-service.php
├── templates/
│   └── frontend-dashboard.php
├── bso-phoenix.php
├── README.md
└── uninstall.php

MVP Status en Roadmap

Geimplementeerd

• Eén bootprofiel voor de Phoenix
• GPS route logging met start en stop
• Captain's log met foto’s
• GPX generatie en delen
• TODO-beheer
• Kostenbeheer
• Dashboard met live routekaart
• Instellingenmodule
• Rapportagepagina
• Story 1: offline/sync queue met retry voor log + foto-upload
• Story 2: caption- en sorteerbeheer voor bestaande logfoto's
• Story 3: route samenvatting per tocht met directe GPX-download
• Story 4: uniforme actiefeedback en foutmeldingen op frontend
• Story 5: rapportage exportpakket (ZIP met CSV + GPX + metadata)
• Story 6: bulkacties selectie/verwijderen voor trips, TODO's en kosten
• Story 7: schermvullende live routekaart toggle
• Story 8: anonieme dashboard demo-modus zonder opslag
• Hardening: export-validatie en foutafhandeling (10/10 acceptatietests PASS)
• Dedicated admin-UI voor trackpoints bewerken/repareren

Verdere doorontwikkeling

• Formele v1.2.0 release notes / tag
• Aanvullende regressietests rond exports en validatie

Documentatie

Meer details staan in:

• Functional Design
• Technical Design
• Installatie en Acceptatietest Stap 7
• Acceptatietest Run Template Stap 7
• Roadmap v1.2.0
• Runbook Beheer En Deploy
• Changes
• Testplan Hardening Import Export Validatie En Foutrapportage
• User Story Trackpoints Bewerken Repareren
• Testplan Trackpoints Bewerken Repareren
• User Story Anonymous Demo Mode
• Testplan Anonymous Demo Mode
• Release Notes v1.0.0
• Release Notes v1.1.0
• Release Notes v1.1.1
• Release Notes v1.2.0
• Release Notes v1.2.1

Contributing

1. Werk in kleine, testbare stappen.
2. Houd documentatie en implementatie synchroon.
3. Test route logging, logboek, TODO’s en kosten na wijzigingen.
4. Stem ingrijpende wijzigingen eerst af met de beheerder van de Phoenix-setup.

License

GPL-2.0-or-later