# Geburtsverein Ernsthausen – Webseite mit Mitgliederbereich

## Was das hier ist

Eine PHP-Webseite mit Login-Bereich: Jedes Mitglied bekommt einen eigenen
Zugang und kann Termine und Neuigkeiten eintragen, bearbeiten und löschen.
Diese erscheinen automatisch auf der Startseite unter „Aktuelles".

Es wird **keine separate Datenbank** benötigt – die Daten werden in einer
SQLite-Datei im Ordner `data/` gespeichert, die automatisch angelegt wird.
Das funktioniert bei praktisch jedem PHP-Hosting (Strato, IONOS, All-Inkl,
u.a.), auch ohne MySQL-Zugang.

## Voraussetzungen

- PHP 8.0 oder neuer mit aktivierter **PDO_SQLITE**-Erweiterung
  (bei den meisten Hostern standardmäßig aktiv)
- Der Ordner `data/` muss vom Webserver **beschreibbar** sein
  (Rechte 755 oder notfalls 775)

## Installation

1. Alle Dateien und Ordner per FTP in das gewünschte Verzeichnis auf dem
   Webspace hochladen (z. B. in den Hauptordner oder einen Unterordner
   wie `/verein`).
2. Falls vorhanden, `GeburtsvereinSatzung.pdf` und den Ordner `foto/`
   (historisches Fotoalbum) mit hochladen bzw. aus der alten Seite
   übernehmen – die Links in der Fußzeile erwarten sie im selben
   Verzeichnis.
3. Im Browser die Seite aufrufen. Da noch kein Mitgliedskonto existiert,
   wirst du automatisch zur **Ersteinrichtung** (`setup.php`) weitergeleitet.
4. Dort das erste Konto anlegen (z. B. für den Präsidenten). Diese Seite
   sperrt sich danach automatisch – sie ist nur sichtbar, solange noch
   kein Konto existiert.
5. Ab jetzt können im Mitgliederbereich (`admin.php`, Link „Mitglieder-
   Login" oben rechts) weitere Vereinsmitglieder eigene Zugänge erhalten.

## Laufender Betrieb

- **Anmelden:** über den Button „Mitglieder-Login" oben rechts.
- **Termin/Neuigkeit eintragen:** im Mitgliederbereich links das
  Formular ausfüllen und veröffentlichen.
- **Eintrag bearbeiten/löschen:** in der Liste rechts über die
  entsprechenden Buttons.
- **Neues Mitglied freischalten:** im Mitgliederbereich unter
  „Neues Mitglied freischalten".

## Betrieb per Docker (nginx + PHP-FPM)

nginx allein kann kein PHP ausführen – dafür ist im Ordner `docker/` ein
fertiges Setup mit einem separaten PHP-FPM-Container dabei. Die
`docker-compose.yml` liegt im Projekt-Hauptverzeichnis, damit alle Pfade
(Build-Kontext, Bind-Mounts) relativ zum Projekt-Root funktionieren –
das ist auch die Voraussetzung für den Portainer-Weg weiter unten.

### Lokal starten (ohne Portainer)

1. Docker und Docker Compose müssen installiert sein.
2. Im Projekt-Hauptverzeichnis ausführen:
   ```
   docker compose up -d --build
   ```
3. Seite ist danach unter `http://localhost:8080` erreichbar.
4. Die SQLite-Datenbank liegt in einem Docker-Volume (`geburtsverein-data`)
   und bleibt beim Neustart der Container erhalten. Ein Backup lässt sich
   z. B. so ziehen:
   ```
   docker compose cp php:/var/www/html/data/geburtsverein.sqlite ./backup.sqlite
   ```

Hinweis: Die `.htaccess`-Datei in `data/` wirkt nur bei Apache. Unter
nginx übernimmt das die Regel `location ^~ /data/ { deny all; }` in
`docker/nginx/default.conf` – die ist hier bereits enthalten.

### Mit Portainer deployen

Portainer kann Compose-Stacks am zuverlässigsten aus einem
**Git-Repository** bauen, weil dann auch das `Dockerfile` und die
nginx-Konfiguration mit heruntergeladen werden (nicht nur die
`docker-compose.yml`).

1. **Projekt in ein Git-Repository legen** (z. B. GitHub, GitLab oder ein
   selbst gehostetes Gitea) und den gesamten Ordnerinhalt dort hochladen
   – inklusive `docker/`-Ordner und `docker-compose.yml`.
2. In Portainer: **Stacks → Add stack**.
3. Einen Namen vergeben (z. B. `geburtsverein`).
4. Als **Build method** „Repository" auswählen:
   - Repository URL: die Git-URL des Projekts
   - Reference: z. B. `refs/heads/main`
   - Compose path: `docker-compose.yml`
   - Bei privatem Repository: Zugangsdaten bzw. Personal Access Token
     hinterlegen
5. **Deploy the stack** klicken. Portainer klont das Repository, baut das
   PHP-Image anhand von `docker/php.Dockerfile` und startet beide
   Container inklusive des Datenvolumes automatisch.
6. Die Seite ist danach über `http://<server-ip>:8080` erreichbar. Läuft
   auf dem Server bereits ein Reverse Proxy (z. B. Nginx Proxy Manager
   oder Traefik, oft ebenfalls über Portainer verwaltet), lässt sich damit
   zusätzlich eine eigene Domain mit HTTPS davorschalten.
7. **Updates ausrollen:** Änderungen ins Git-Repository pushen, dann im
   Stack in Portainer auf „Pull and redeploy" (bzw. „Update the stack" mit
   aktivierter „Re-pull image and redeploy"-Option) klicken.

**Alternative ohne Git:** Falls kein Git-Repository genutzt werden soll,
lässt sich das PHP-Image auch vorab lokal bauen und in eine Registry
(z. B. Docker Hub) pushen. Die `docker-compose.yml` würde dann statt
`build:` einfach `image: dein-benutzername/geburtsverein-php:latest`
verwenden. Die Projektdateien (für die Bind-Mounts) müssten in diesem
Fall trotzdem manuell auf den Server kopiert werden, z. B. per SCP nach
`/opt/geburtsverein`.

## Sicherheitshinweise

- Passwörter werden nur als sicherer Hash gespeichert (`password_hash`),
  nie im Klartext.
- Der Ordner `data/` ist per `.htaccess` vor direktem Zugriff über den
  Browser geschützt. Falls der Server **nginx** statt Apache nutzt, greift
  diese `.htaccess`-Regel nicht – dann bitte den Ordner serverseitig
  zusätzlich sperren oder außerhalb des Web-Verzeichnisses ablegen
  (im Zweifel beim Hoster nachfragen).
- Es lohnt sich, regelmäßig eine Kopie der Datei `data/geburtsverein.sqlite`
  zu sichern (z. B. per FTP herunterladen) – das ist die komplette
  Datenbank mit allen Terminen, Neuigkeiten und Mitgliedskonten.

## Dateiübersicht

```
index.php              Öffentliche Startseite (liest Aktuelles live aus der Datenbank)
login.php               Login-Formular
logout.php               Abmelden
setup.php                 Einmalige Ersteinrichtung des ersten Kontos
admin.php                  Mitgliederbereich: Termine/Neuigkeiten & Mitglieder verwalten
style.css                   Gemeinsames Design
includes/db.php               Datenbankverbindung, legt Tabellen automatisch an
includes/auth.php              Login-/Session-Verwaltung
includes/functions.php          Hilfsfunktionen
includes/nav.php, footer.php     Wiederverwendete Kopf-/Fußzeile
data/                              Ordner für die SQLite-Datenbank (wird automatisch befüllt)
```