Update 9-Activiteiten

9-Activiteiten.-.md

@@ -1 +1,86 @@
-Welcome to the Wiki.
+# Beheerdershandleiding
+**Module 9 & Webshop: Activiteiten, Evenementen & Tickets Beheer**
+
+> **BELANGRIJK VERSCHIL & CALENDAR INTEGRATIE:**
+> * **Activiteit (Inhoud & Kalender):** Een activiteit is een inhoudelijk of redactioneel programma-onderdeel. **Activiteiten worden automatisch getoond in de centrale Calendar op de website, EN in de Google-Calendar koppeling.**
+> * **Evenement (Tickets & Verkoop):** Een evenement is de commerciële/organisatorische schil aan de achterkant waaraan ticketverkopen, prijzen, capaciteitslimieten en financiële transacties zijn gekoppeld.
+
+Welkom bij de uitgebreide documentatie voor het beheren van **Activiteiten**, **Evenementen** en **Tickets** binnen het administratiepaneel. Deze handleiding legt stap voor stap uit hoe u programma-activiteiten aanmaakt, ticketverkopen instelt en verkochte evenementtickets opvolgt en exporteert.
+
+---
+
+## 1. Activiteiten Beheer (Programma, Kalender & Inhoud)
+
+De pagina **Activiteiten** stelt u in staat om de redactionele of inhoudelijke activiteiten van de organisatie te beheren. Dit betreft de planning, publicatiestatus en visuele weergave van programma-onderdelen die rechtstreeks **in de Calendar geplaatst worden**.
+
+**Belangrijkste functionaliteiten:**
+* **`+ Nieuwe activiteit`:** Met deze knop opent u het dialoogvenster om een nieuwe activiteit toe te voegen aan de planning en Calendar.
+* **Statusbeheer:** Activiteiten kunnen de status `Gepubliceerd` (zichtbaar voor bezoekers op de website/Calendar) of `Concept` (conceptversie, nog niet openbaar) hebben.
+* **Contextmenu (Rechtermuisknop):** Klik met de rechtermuisknop op een rij in de tabel om snel de acties *Bewerken* of *Verwijderen* uit te voeren.
+* **Koppeling met Evenementen:** Indien een activiteit is gekoppeld aan een evenement (voor ticketverkoop), wordt automatisch getoond wie het gekoppelde evenement georganiseerd heeft.
+
+### Datatabel Veldenoverzicht
+
+| Veldnaam | Type / Weergave | Beschrijving |
+| :--- | :--- | :--- |
+| **Titel** | Tekst + Subtekst | De naam van de activiteit en optioneel de naam van de organisator als er een gekoppeld event is. |
+| **Activiteit Datum** | Datum / Tijd | Sorteerbaar veld waarin de geplande datum van de activiteit wordt getoond (bepaalt de weergave in de Calendar). |
+| **Status** | Status Badge | Toont of het item `Gepubliceerd` of `Concept` is. |
+| **Afbeelding** | Thumbnail | Miniatuurweergave van de geüploade omslagafbeelding (gebruikt standaard een placeholder indien leeg). |
+| **Aangemaakt / Bijgewerkt** | Datum stempel | Historie van aanmaak- en bewerkingsdatums voor administratieve controle. |
+
+> **Let op bij verwijderen:** Het verwijderen van een activiteit is definitief en verwijdert de activiteit direct uit de Calendar. Zorg ervoor dat u zeker weet dat een activiteit niet meer op de website of in het archief getoond hoeft te worden.
+
+---
+
+## 2. Evenementen & Ticketinstellingen
+
+Op de pagina **Evenementen** beheert u de feitelijke evenementen waaraan commerciële ticketverkopen en capaciteitslimieten verbonden zijn. Waar de activiteit de presentatie in de Calendar verzorgt, regelt het evenement de administratieve en financiële afhandeling.
+
+**Overzicht van Functionaliteiten:**
+* **Nieuw Evenement:** Voeg een nieuw evenement toe met specifieke locaties, ticketprijzen en capaciteit.
+* **Actief-status:** Een vinkje (✓) geeft aan dat het evenement actief is, een kruisje (X) dat het inactief is.
+* **Ticket Capaciteit Indicator:** Een visuele tag toont de resterende tickets:
+  * **Groen:** Meer dan 100 tickets beschikbaar.
+  * **Oranje:** Minder dan 100 tickets beschikbaar (bijna uitverkocht).
+  * **Rood:** 0 tickets beschikbaar (volledig uitverkocht).
+* **Tooltip Informatie:** Beweeg de muis over de ticket-tag om het precieze aantal verkochte tickets ten opzichte van de maximale capaciteit te bekijken (bijv. `45 / 200`).
+
+### Instellingen in het Event-dialoogvenster
+
+| Instelling | Omschrijving |
+| :--- | :--- |
+| **Naam & Locatie** | De officiële titel van het evenement en de fysieke of online locatie. |
+| **Ticketprijs** | De vaste prijs per ticket in Euro's (€), automatisch geformatteerd. |
+| **Maximale Tickets** | Het totale aantal beschikbare plaatsen (capaciteit). Net zo lang te bestellen tot de limiet bereikt is. |
+| **Beschikbaar Vanaf** | Publicatiedatum vanaf wanneer de ticketverkoop openbaar start. |
+
+---
+
+## 3. Tickets Beheer & Verkoopopvolging
+
+De pagina **Tickets Beheer** biedt een compleet financieel en operationeel overzicht van alle transacties en ticketreserveringen binnen de webshop.
+
+### 1. KPI Dashboard (Statistieken)
+Bovenaan de pagina vindt u vier realtime overzichtskaarten:
+* **Tickets verkocht:** Totaal aantal actieve en reeds gebruikte tickets.
+* **Tickets geannuleerd:** Aantal tickets dat is geannuleerd of terugbetaald.
+* **Tickets pending:** Reserveringen in afwachting van betaling.
+* **Totale omzet:** Totale gegenereerde omzet uit niet-geannuleerde ticketverkopen.
+
+### 2. Filteropties
+Maak gebruik van de ingebouwde filters om gerichte rapportages te maken:
+* **Event filter:** Multi-selectie om te filteren op specifieke evenementen.
+* **Status filter:** Filter op `Actief`, `Gebruikt`, `Geannuleerd` of `Verlopen`.
+* **Reset filters:** Herstel alle filters direct met één muisklik.
+
+### 3. Gegroepeerde Weergave & Export
+De tickets worden overzichtelijk gegroepeerd per evenement met een speciale groepsheader. Deze header toont direct per evenement de verkochte aantallen, geannuleerde aantallen, pending reserveringen en de specifieke event-omzet.
+
+> **Exporteren naar CSV:** Via de knop `Download CSV` in de groepsheader van een evenement kunt u direct een Excel-compatibele lijst van alle bezoekers en ticketnummers exporteren voor toegangscontrole aan de deur.
+
+### 4. Ticket Statussen & Acties (Rechtermuisknop)
+Met behulp van het contextmenu op een ticketrij kunt u snel de volgende acties uitvoeren:
+* **Bekijk details:** Opent een gedetailleerd dialoogvenster met alle bezoeker- en betalingsgegevens.
+* **Markeer als gebruikt:** Wijzigt de status van een ticket wanneer een bezoeker aan de zaal/deur wordt ingecheckt.
+* **Annuleer ticket:** Annuleert het ticket en past automatisch de capaciteit en omzetberekeningen aan.