Add 5-Orgaanbeheer

5-Orgaanbeheer.-.md

@@ -0,0 +1,109 @@
+# 5. Orgaan- & Commissiebeheer
+
+## Waar je dit beheert
+
+Ga naar `Organen` in de admin-omgeving. Dit is het scherm voor het beheren van commissies, organen en historische ledenaantallen per periode.
+
+## 1. Filteren op orgaan en periode
+
+De bovenste balk bevat de belangrijkste filters:
+
+- `Zoek orgaan, lid of email...`
+- `Datum van`
+- `Datum tot`
+- type filter
+- `Actief / Inactief`
+- `Nieuw`
+- `Exporteer naar Excel`
+
+Deze filters zijn belangrijk omdat de pagina niet alleen een lijst toont, maar ook een historische weergave van samenstellingen. Gebruik bijvoorbeeld de Datum-velden om te zien wie er allemaal in een commissie zat in collegejaar 2024-2025.
+
+## 2. Academisch jaar en historische periode
+
+Het scherm heeft expliciete ondersteuning voor academische jaren. Praktisch betekent dit dat je vaak deze werkstroom gebruikt:
+
+1. kies een start- en einddatum
+2. kies een periode of academisch jaar
+3. controleer welke leden actief waren in die tijd
+4. pas daarna de samenstelling aan of exporteer het overzicht
+
+## 3. Organen en commissies beheren
+
+Per orgaan kun je:
+
+- `Lid toevoegen`
+- bewerken
+- verwijderen
+- de ledenlijst inzien
+- membership-status bekijken
+
+## 4. Leden per orgaan beheren
+
+In de onderliggende tabel per orgaan zie je per lid:
+
+- naam
+- email
+- lichting
+- status
+- lid sinds
+- lid tot
+- acties
+
+De status is meestal zichtbaar via `Actief` / `Inactief` en de membership-datakoppelingsvelden.
+
+## 5. Lidmaatschappen en historie
+
+De app houdt historische lidmaatschappen bij. Je ziet dit in:
+
+- `joined_at`
+- `left_at`
+- `is_active`
+
+Dit is het mechanism dat je in staat stelt om een orgaan of commissie te bekijken zoals die in een vorige periode was samengesteld.
+
+## 6. Exporteren
+
+De knop `Exporteer huidige selectie naar Excel` is het gereedschap voor opsommingen. Gebruik deze vooral voor:
+
+- commissieoverzichten
+- bestuursrapportages
+- periodieke reviews
+- controle van leden in een orgaan
+
+## 7. Werkstroom in de praktijk
+
+### Nieuw orgaan of commissie aanmaken
+
+1. klik `Nieuw`
+2. vul de naam en het type in
+3. controleer de periode
+4. voeg leden toe
+5. controleer de actieve status
+6. exporteer indien nodig
+
+### Periode controleren
+
+1. zet `Datum van` en `Datum tot`
+2. koppel dit aan het juiste academisch jaar of relevante periode
+3. bekijk welke leden in die periode bij het orgaan hoorden
+4. pas membership-data aan wanneer nodig
+
+## 8. Veelvoorkomende punten
+
+### Geen leden onder een orgaan
+
+- controleer of de juiste periode is geselecteerd
+- controleer of de membership in die periode actief was
+- controleer of er filters actief zijn
+
+### Orgaan ziet er verkeerd uit
+
+- controleer of leden correct zijn toegevoegd
+- controleer of `is_active` juist staat
+- controleer of de selected periode niet te breed of te smal is
+
+### Export bevat niet de juiste dataset
+
+- controleer de actieve filters
+- controleer `Datum van` en `Datum tot`
+- controleer of je het juiste orgaan- en type-overzicht hebt geselecteerd