Team-Sitzung für „Analyse und Gespräch“ – Server-Datei zum Selbstbetrieb
MY COACHING FOR YOU, https://www.my-coaching4you.de/
Freie Software unter der GNU General Public License, Version 3 oder neuer (GPL-3.0-or-later) – siehe LIZENZ.txt.
English: see README.txt.

WOFÜR
Im Tool „Analyse und Gespräch“ (SWOT, GROW, SOAR, Retrospektive …) können mehrere Personen gleichzeitig am selben
Board arbeiten – die „Team-Sitzung“. Dafür braucht es einen Server, über den die Browser der Teilnehmenden Karten,
Punkte und Einstellungen abgleichen. Die Datei team-sitzung.php in diesem Paket ist dieser Server.

- In der MC4Y-Produktivitätssuite brauchen Sie diese Datei NICHT: Dort läuft die Team-Sitzung über den Server der Suite.
- Außerhalb der Suite hat das Tool keine voreingestellte Adresse. Sie tragen die Adresse Ihres eigenen Servers selbst ein.
- MY COACHING FOR YOU betreibt keinen Server für Team-Sitzungen und bietet keinen an.

WER IST VERANTWORTLICH?
Wer team-sitzung.php auf einem Server betreibt, ist für die Daten der Team-Sitzungen verantwortlich – die Namen der
Teilnehmenden und die Inhalte der Boards. Dazu gehören in der Regel eigene Datenschutzhinweise für die Teilnehmenden
und, wenn ein Hoster den Webspace stellt, ein Vertrag zur Auftragsverarbeitung (Art. 28 DSGVO) mit ihm. Das Tool fragt
vor dem Starten und Beitreten eine Einwilligung ab: Gespeichert wird „auf dem eingetragenen Server“, verantwortlich ist,
wer ihn betreibt.

VORAUSSETZUNGEN
- Webspace mit PHP 7.1 oder neuer und der Erweiterung mbstring (bei fast allen Hostern vorhanden), erreichbar über https.
- PHP darf neben team-sitzung.php einen Ordner anlegen (bzw. in den Datenordner schreiben, siehe unten).
- Apache oder LiteSpeed (beide lesen .htaccess). Bei nginx, IIS oder Caddy unbedingt einen Datenordner außerhalb des
  Webverzeichnisses eintragen (siehe „Datenordner“) – sonst lehnt team-sitzung.php jede Anfrage ab, damit die
  Sitzungsdateien nicht offen im Netz liegen.

SO GEHT ES
1. team-sitzung.php per FTP oder SFTP auf Ihren Webspace laden, z. B. als https://www.ihre-domain.de/team-sitzung.php
2. Die Adresse im Browser aufrufen. Die Antwort {"ok":false,"error":"methode"} zeigt, dass PHP läuft – die Datei
   nimmt nur Anfragen des Tools an.
3. Im Tool „Analyse und Gespräch“ auf „Team-Sitzung“ klicken, im Feld „Server-Adresse“ die Adresse aus Schritt 1
   eintragen, Namen eingeben, die Einwilligung ankreuzen und „Sitzung starten“ wählen.
4. Code und PIN an die Teilnehmenden geben. Wird das Tool über eine Web-Adresse geöffnet, zeigt das Sitzungsfenster
   zusätzlich einen Link: Er enthält Code und Server-Adresse, die PIN nicht.
5. Beim ersten Start legt team-sitzung.php daneben den Ordner team-sitzungen/ an, mit einer .htaccess, die jeden Abruf
   über das Web sperrt. Prüfen Sie das: https://www.ihre-domain.de/team-sitzungen/_ratelimit.json muss mit
   „403 Forbidden“ antworten.

WO DAS TOOL LAUFEN KANN
- Als heruntergeladene Datei (analyse.html doppelt anklicken): Sie verbindet sich mit Ihrem Server; team-sitzung.php
  sendet dafür die nötige Freigabe („Access-Control-Allow-Origin“) mit.
- Von Ihrem eigenen Webspace: analyse.html neben team-sitzung.php hochladen.
- In der Online-Fassung auf www.my-coaching4you.de erlauben die Sicherheitsregeln der Website keine Verbindung zu
  fremden Servern. Dort ist eine Team-Sitzung nicht möglich; das Tool sagt das beim Versuch und nennt die beiden Wege oben.

DATENORDNER (empfohlen, wo der Hoster es erlaubt)
Oben in team-sitzung.php:   const DATENORDNER = '/pfad/ausserhalb/des/webverzeichnisses/team-sitzungen';
oder die Umgebungsvariable MC4Y_TEAM_ORDNER setzen. Fehlt der Ordner, wird er angelegt.

WAS GESPEICHERT WIRD
Je Sitzung eine Datei <CODE>.json: die Inhalte des Boards (Karten, Punkte, Feldnamen, Notizen, Titel, Datum, Fokus,
Zeitbox), die Namen der gerade Teilnehmenden mit dem Zeitpunkt ihrer letzten Aktivität (der Eintrag entfällt nach etwa
30 Sekunden ohne Aktivität), PIN und Leitungsschlüssel nur als Hashwerte. Zur Begrenzung der Anfragen die Datei
_ratelimit.json mit einem Hashwert der IP-Adresse für eine Minute. Keine Cookies.
Löschen: „Sitzung für alle beenden und löschen“ löscht sofort. Sonst löscht team-sitzung.php Sitzungen 7 Tage nach der
letzten Aktivität – geprüft, sobald die Datei wieder aufgerufen wird (höchstens einmal je Stunde). Wird sie lange nicht
aufgerufen, bleibt eine abgelaufene Sitzung so lange liegen; wer das ausschließen will, löscht den Ordner von Hand oder
lässt die Adresse beim Hoster täglich aufrufen. Die Server-Logdateien des Hosters (mit IP-Adressen) sind davon unabhängig.

HAFTUNG
team-sitzung.php wird unentgeltlich und ohne Gewähr bereitgestellt (siehe LIZENZ.txt). Für Schäden aus der Nutzung,
insbesondere Datenverlust, wird nur bei Vorsatz und grober Fahrlässigkeit gehaftet; die Haftung für Schäden aus der
Verletzung von Leben, Körper oder Gesundheit sowie zwingende gesetzliche Haftung bleiben unberührt. Betrieb, Sicherheit
und Aktualität des Servers liegen bei Ihnen. Bitte keine besonders schutzwürdigen Daten (z. B. Gesundheitsangaben) in
Team-Sitzungen eintragen.
