docs: README und Appwrite-Console-Anleitung an den Ist-Stand angleichen

Endpoint-Standard ${origin}/v1, echte Projekt-ID im Traefik-Header, Console-
Einstellungen als Soll-Stand statt Tatsache, Test-Befehle je mit Verzeichnis;
Projekt-ID nicht mehr "aircard", Auth-/Dienste-Schritte als optionale Härtung.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

README.md

@@ -22,15 +22,29 @@ npm ci
 npm run dev          # Entwicklungsserver http://localhost:5173
 ```
 
-Login und Speichern brauchen die Appwrite-Route. Der lokale Host wird nur dann erkannt, wenn die Web-Plattform `localhost` in der Appwrite-Console eingetragen ist (unter Projekt → Overview → Integrations → Platforms). Die Umgebungsvariablen `VITE_APPWRITE_ENDPOINT` und `VITE_APPWRITE_PROJECT_ID` müssen für die lokale Entwicklung verfügbar sein (Standard: `https://appwrite.webklar.com/v1` und `6ac2130a00289343d6d5`).
+Login und Speichern brauchen die Appwrite-API. Ohne Einstellung gilt als Endpoint `${location.origin}/v1` (der Entwicklungsserver hat keinen Proxy dafür, es würde also der Vite-Server selbst gefragt). Für die lokale Entwicklung deshalb in `web/.env.local` (steht über `.env*` in `.gitignore`) den Endpoint setzen:
+
+```sh
+VITE_APPWRITE_ENDPOINT=https://appwrite.webklar.com/v1
+```
+
+Die Projekt-ID ist als Standard im Code hinterlegt (`6ac2130a00289343d6d5`, `VITE_APPWRITE_PROJECT_ID` überschreibt sie). Damit Appwrite den lokalen Host akzeptiert, muss die Web-Plattform `localhost` in der Appwrite-Console eingetragen sein (Projekt → Overview → Integrations → Platforms). Der Produktions-Build bekommt `VITE_APPWRITE_ENDPOINT=https://aircard-ios.org/v1` aus der Container-Umgebung (`deploy/compose-snippet.yml`).
 
 ## Tests
 
+Im Frontend (`web/`):
+
 ```sh
-cd web && npx vitest run     # Unit-Tests (card/*, editor/*, account/*)
+cd web
+npx vitest run               # Unit-Tests (card/*, editor/*, account/*, pages/*)
 npx tsc --noEmit             # TypeScript-Prüfung
-node --test deploy/webhook-server.test.js      # Webhook und Build-Logik
-node --test web/scripts/appwrite-setup.test.mjs  # Appwrite-Schema
+```
+
+Im Repo-Wurzelverzeichnis:
+
+```sh
+node --test deploy/webhook-server.test.js        # Webhook-Server (deploy.sh wird dort durch einen Stub ersetzt)
+node --test web/scripts/appwrite-setup.test.mjs  # Appwrite-Schema-Skript
 ```
 
 ## Deploy
@@ -47,15 +61,14 @@ Starten nur mit:
 docker compose up -d aircard-build aircard
 ```
 
-Die Appwrite-API wird über `/home/webklar/apps/traefik/dynamic/aircard.yml` geroutet: Requests auf `aircard-ios.org/v1` mit Header `X-Appwrite-Project: aircard` gehen an den Appwrite-Container.
+Die Appwrite-API wird über `/home/webklar/apps/traefik/dynamic/aircard.yml` geroutet (Vorlage: `deploy/traefik/aircard.yml`): Requests auf `aircard-ios.org/v1` mit Header `X-Appwrite-Project: 6ac2130a00289343d6d5` gehen an den Appwrite-Container. Ohne diesen Header antwortet der nginx der Seite mit 404.
 
 ## Appwrite
 
-Projekt `aircard` auf `appwrite.webklar.com`:
-- Projekt-ID (öffentlich): `6ac2130a00289343d6d5`
-- Datenbank: `aircard`, Tabelle: `cards`, Bucket: `card-images`
-- Auth: E-Mail + Passwort, Sitzungsdauer 30 Tage, max. 5 pro Nutzer, Nutzerlimit 2000
-- Web-Plattformen: `aircard-ios.org`, `localhost`
+Projekt „AirCard“ auf `appwrite.webklar.com`:
+- Projekt-ID (öffentlich, von Appwrite generiert): `6ac2130a00289343d6d5`. Sie steht in `deploy/traefik/aircard.yml`, in `/home/webklar/apps/.env` (`AIRCARD_APPWRITE_PROJECT_ID`) und als Standard in `web/src/account/appwrite.ts`.
+- Datenbank: `aircard`, Tabelle: `cards`, Bucket: `card-images` (das Skript unten legt sie an und prüft sie)
+- Console-Einstellungen laut `docs/appwrite-console.md` (Soll-Stand, nicht maschinell geprüft; `--check` prüft nur das Schema): Auth mit E-Mail + Passwort, Sitzungsdauer 30 Tage, max. 5 Sitzungen pro Nutzer, Nutzerlimit 2000, Web-Plattformen `aircard-ios.org` und `localhost`. Schritte 3 und 4 dort (Auth-Härtung, Dienste abschalten) sind optional und am Live-Projekt unbestätigt.
 
 **Schema prüfen:**
 ```sh

docs/appwrite-console.md

@@ -4,16 +4,20 @@ Klickliste für Kenso. Dauer: etwa 5 Minuten. Console: <https://appwrite.webklar
 
 Alles passiert in der bestehenden Organisation. Das Schema (Datenbank, Tabelle, Bucket) legt danach das Skript `web/scripts/appwrite-setup.mjs` an – dafür musst du nichts anklicken.
 
-**Hinweis:** Das Projekt wird mit der automatisch generierten ID `6ac2130a00289343d6d5` angelegt und dort in `/home/webklar/apps/.env` unter `AIRCARD_APPWRITE_PROJECT_ID` gespeichert. Das Skript liest diese ID aus der Umgebungsvariablen; der Wert muss beim Aufruf verfügbar sein.
+**Hinweis:** Das Projekt wurde mit der automatisch generierten ID `6ac2130a00289343d6d5` angelegt (nicht mit einer selbst gewählten ID). Diese ID steht in `/home/webklar/apps/.env` unter `AIRCARD_APPWRITE_PROJECT_ID`; das Skript liest sie von dort, der Wert muss beim Aufruf verfügbar sein.
+
+**Stand der Einstellungen:** Schritt 2 (Web-Plattform `aircard-ios.org`) ist Voraussetzung, ohne sie lehnt Appwrite die Anfragen der Seite ab. Die Schritte 3 und 4 sind empfohlene Härtung. Ob sie in der Console umgesetzt sind, prüft kein Skript (`--check` deckt nur Schema, Tabelle und Bucket ab). Solange du sie nicht selbst gesetzt hast, läuft das Live-Projekt mit den Appwrite-Standards für Auth und Dienste. Das Schema und die Zeilen-/Dateirechte sind davon unabhängig.
 
 ## 1. Projekt anlegen
 
 1. In der Console anmelden und die bestehende Organisation öffnen.
 2. **Create project** klicken.
 3. Name: `AirCard`.
-4. Beim Feld **Project ID** auf das Stift-Symbol (bzw. „Edit“) klicken und `aircard` eintragen. Die ID lässt sich später nicht mehr ändern; sie muss genau `aircard` heißen.
+4. Das Feld **Project ID** unverändert lassen: Appwrite erzeugt die ID selbst. Nach dem Anlegen steht sie unter **Settings** (und in der Adresszeile der Console). Sie ist öffentlich, steckt im JavaScript der Seite.
 5. **Create** klicken.
 
+Bei einem Neuaufbau bekommt das neue Projekt eine neue ID. Dann müssen drei Stellen dazu passen: die Traefik-Regel (`deploy/traefik/aircard.yml`, dort steht die ID im `Header(...)`), `AIRCARD_APPWRITE_PROJECT_ID` in `/home/webklar/apps/.env` und der Standardwert in `web/src/account/appwrite.ts`.
+
 ## 2. Web-Plattformen eintragen
 
 Projekt `AirCard` → **Overview** → **Integrations** → **Platforms** → **Add platform** → **Web**.
@@ -21,9 +25,9 @@ Projekt `AirCard` → **Overview** → **Integrations** → **Platforms** → **
 1. Name `AirCard Website`, Hostname `aircard-ios.org` → **Create**.
 2. Noch einmal **Add platform** → **Web**: Name `Entwicklung`, Hostname `localhost` → **Create**.
 
-## 3. Auth-Einstellungen
+## 3. Auth-Einstellungen (empfohlene Härtung, keine Voraussetzung für den Betrieb)
 
-Linke Leiste → **Auth** → **Settings**.
+Linke Leiste → **Auth** → **Settings**. Registrieren und Anmelden funktionieren auch mit den Standardwerten; die folgenden Einstellungen begrenzen nur, was Besucher mit dem Projekt anstellen können.
 
 1. Bei **Auth methods** nur **Email/Password** eingeschaltet lassen. Ausschalten: **Magic URL**, **Email OTP**, **Phone**, **Anonymous**, **JWT** (steht dort auch **Invites**: ebenfalls aus).
 2. **Session duration**: `30` Tage → **Update**.
@@ -33,11 +37,11 @@ Linke Leiste → **Auth** → **Settings**.
 
 Keine E-Mail-Bestätigung nötig, Mindestlänge 8 Zeichen ist Standard – dafür ist nichts einzustellen. Die „Passwort vergessen“-Mail geht über den globalen Server-SMTP (Absender WEBklar), auch dafür ist nichts einzustellen.
 
-## 4. Nicht benötigte Dienste abschalten
+## 4. Nicht benötigte Dienste abschalten (optional)
 
-Linke Leiste → **Settings** → Reiter **Services**.
+Linke Leiste → **Settings** → Reiter **Services**. Das ist optionale Härtung: Die Website braucht diese Dienste nicht, schadet aber auch nicht, wenn sie an bleiben. Solange du das nicht gemacht hast, sind sie am Live-Projekt an (z. B. antwortet GraphQL).
 
-1. Ausschalten: **Functions**, **Sites**, **Messaging**, **Teams**, **GraphQL**.
+1. Ausschalten, soweit die Console es dort anbietet: **Functions**, **Sites**, **Messaging**, **Teams**, **GraphQL**.
 2. Alles andere (Account, Avatars, Databases, Locale, Storage …) bleibt an.
 
 ## 5. API-Key `aircard-provision` anlegen
@@ -59,14 +63,15 @@ Dieser Key gehört nur dem Setup-Skript. Die Website selbst braucht ihn nicht.
 Der Key gehört in die Datei `/home/webklar/apps/.env`, nirgendwo sonst.
 
 1. Auf dem Server die Datei öffnen, z. B. `nano /home/webklar/apps/.env`.
-2. Ans Ende springen und eine neue Zeile anfügen, ohne Anführungszeichen und ohne Leerzeichen um das `=`:
+2. Ans Ende springen und neue Zeilen anfügen, ohne Anführungszeichen und ohne Leerzeichen um das `=` (die Projekt-ID ist die in Schritt 1 notierte, siehe Hinweis oben):
 
    ```
+   AIRCARD_APPWRITE_PROJECT_ID=<Projekt-ID>
    AIRCARD_APPWRITE_API_KEY=<hier den kopierten Secret-Wert einfügen>
    ```
 
 3. Speichern (in `nano`: Strg+O, Enter, Strg+X). Andere Zeilen nicht verändern.
-4. Den Key **nicht im Chat teilen**, nicht in Screenshots zeigen und nirgends einchecken. Claude liest ihn nie selbst, das Skript bekommt ihn über `node --env-file=/home/webklar/apps/.env`.
+4. Den Key möglichst nicht im Chat teilen (wer ihn dort einfügt, gibt ihn in den Verlauf), nicht in Screenshots zeigen und nirgends einchecken. Das Skript bekommt ihn über `node --env-file=/home/webklar/apps/.env`, dafür muss ihn niemand sonst sehen.
 
 ## 7. Bescheid geben
 

web/src/vite-env.d.ts

@@ -3,7 +3,7 @@
 interface ImportMetaEnv {
   /** Appwrite-Endpoint; ohne Angabe `${location.origin}/v1` (Produktion: https://aircard-ios.org/v1). */
   readonly VITE_APPWRITE_ENDPOINT?: string;
-  /** Appwrite-Projekt-ID; ohne Angabe `aircard`. */
+  /** Appwrite-Projekt-ID; ohne Angabe die generierte ID des Projekts „AirCard“ (`6ac2130a00289343d6d5`). */
   readonly VITE_APPWRITE_PROJECT_ID?: string;
 }