# StudyPlanner PHP + SQLite

## Voraussetzungen
- PHP 8.1 oder neuer
- PHP-Erweiterung PDO_SQLite (`pdo_sqlite`)
- Webhosting mit PHP-Unterstützung und beschreibbarem Datenordner

## Lokal testen
Im Projektordner:
```bash
php -S localhost:8000 -t public
```
Dann `http://localhost:8000` öffnen.

Die Datenbank wird beim ersten Aufruf automatisch unter `data/studyplanner.sqlite` angelegt. Für diesen lokalen Test muss PHP auf die Dateien im Projektverzeichnis zugreifen können.

## Online installieren
1. Projekt auf ein PHP-Webhosting hochladen.
2. `public/` als Web-Document-Root einstellen. Falls dein Hoster das nicht erlaubt, `index.php`, `api.php` und `assets/` in den Webroot legen und `config.php`/`data/` möglichst außerhalb des öffentlich erreichbaren Verzeichnisses halten; Pfade in `config.php` dann anpassen.
3. PHP-Erweiterung `pdo_sqlite` aktivieren.
4. Schreibrechte für den Datenbankordner einrichten.
5. HTTPS aktivieren.
6. Vor öffentlicher Nutzung unbedingt Anmeldung/Zugriffsschutz ergänzen.

## Wichtiger Sicherheitshinweis
Diese erste Version besitzt noch keinen Login und ist für den persönlichen Test gedacht. Nicht ungeschützt öffentlich ins Internet stellen. Für den echten Onlinebetrieb ergänzen wir als nächsten Schritt Benutzeranmeldung, CSRF-Schutz, Backups und sichere Datenbankablage.

## Inhalte
- 18 Studienmonate
- Rückstände in Monat 3 und 7
- Lernhefte aus dem bereitgestellten SGD-Campus-Auszug
- Statusverwaltung für Lernhefte und Einsendeaufgaben
- Zwei alternative IHK-Prüfungsfenster aus den hochgeladenen Screenshots
- Dark Mode / Light Mode
- responsive Darstellung
- SQLite-Datenbank über PDO

Nach der ersten Anmeldung kannst du über **Konto** dein Initialpasswort ändern. Das neue Passwort muss mindestens 14 Zeichen lang sein.


## Daten sichern und wiederherstellen (v0.4)
Nach der Anmeldung findest du oben den Link **Daten sichern**.
- **Backup herunterladen:** erzeugt eine konsistente SQLite-Datei (VACUUM INTO), die du lokal speichern kannst.
- **Wiederherstellen:** akzeptiert nur SQLite-Dateien mit den erwarteten StudyPlanner-Tabellen und bestandener `PRAGMA integrity_check`.
- Vor dem Restore wird eine temporäre Rückfallsicherung erstellt.
- Die Wiederherstellung ersetzt auch Benutzerkonten und Passworthashes durch den Stand der Sicherungsdatei.
- Upload-Limit: 25 MB.

Bewahre Sicherungen an einem zweiten, sicheren Ort auf. Lade sie nicht in öffentliche Cloud-Ordner. Die Backup-Seite ist nur nach Login erreichbar; Download und Restore sind an die Sitzung gebunden. Für den Onlinebetrieb muss HTTPS aktiviert sein.


## Als Handy-App installieren (PWA, Version 0.5)
- `manifest.webmanifest`, Service Worker und PNG-App-Icons liegen im Ordner `public/`.
- Die App kann über Chrome auf Android über das Browsermenü **Installieren** bzw. **Zum Startbildschirm hinzufügen** installiert werden.
- Voraussetzung: Die Website muss über HTTPS erreichbar sein (oder lokal über `localhost`). Auf HTTP-Webhosting wird die Installationsfunktion von Chrome nicht zuverlässig angeboten.
- Die PHP-Seiten und API-Antworten werden absichtlich nicht offline gespeichert. Nur statische Dateien/Icons werden gecacht, damit private Studien- und Kontodaten nicht auf dem Gerät im Cache landen.
- Nach einem Update wird ein neuer statischer Cache angelegt; alte StudyPlanner-Caches werden beim Aktivieren entfernt.


## Standardkonto und Initialpasswort

Für die erste Anmeldung wird beim erstmaligen Anlegen der Datenbank automatisch das Standardkonto erstellt:

- **Benutzername:** `marcus`
- **Initialpasswort:** wurde automatisch generiert und dem Betreiber separat im Chat mitgeteilt.
- **Passwortspeicherung:** In SQLite wird ausschließlich der von PHP `password_hash()` erzeugte Passwort-Hash gespeichert, niemals das Klartextpasswort.

Nach der ersten Anmeldung bitte unter **Konto → Passwort ändern** ein persönliches, einzigartiges Passwort setzen. Das Initialpasswort steht aus Sicherheitsgründen nicht im README und sollte nicht in Projektdateien oder gemeinsam genutzten Backups im Klartext abgelegt werden.

## Private Gerätefreischaltung
Beim ersten Aufruf eines neuen Geräts muss der Aktivierungscode in vier Feldern eingegeben werden. Die Bindestriche sind nur optische Trenner. Nach erfolgreicher Prüfung wird ein zufälliges Geräte-Token als HttpOnly-/SameSite-Cookie auf dem Gerät gespeichert; serverseitig liegt nur dessen SHA-256-Hash. Das Cookie ist ein Jahr gültig. Danach bleibt die Gerätefreischaltung bestehen, zusätzlich ist weiterhin die normale Anmeldung mit Benutzername und Passwort erforderlich. Auf einem anderen Gerät ist eine neue Freischaltung nötig.

Der Aktivierungscode wird in der Anwendung nur als Passwort-Hash gespeichert. Die Freischaltung schützt den Zugriff zusätzlich, ersetzt aber keine sichere HTTPS-Konfiguration und keine starken Zugangsdaten.
