ClaudeandClaude Opus 5.5
4aedb1d322
Schlussreview F4. Zeilen und Bilder der Community-Logos (logo-asset.ts) bleiben bis zum Neuladen der Seite im Speicher. Wurde ein Logo danach ausgeblendet oder gelöscht, konnte es aus diesem Zwischenspeicher in ein veröffentlichtes Kartenbild oder in ein heruntergeladenes PNG gelangen. - renderForGallery (Veröffentlichen), der Download im Editor und der Download in „Meine Karten“ rufen vor dem Laden der Bilder forgetLogo(config.logo) (falls eines gewählt ist): Zeile und Bild werden neu vom Server geholt, hidden/fehlt wird also neu geprüft. Veröffentlichen bricht bei einem fehlenden Logo wie bisher mit LOGO_MISSING_PUBLISH ab, „Meine Karten“ meldet es an der Kachel. - Der Download im Editor berücksichtigt assets.logoMissing wie der Hinweis im Editor: das PNG entsteht ohne das fehlende Logo (die Vorschau zeigte es bis dahin noch), der Hinweis „Das gewählte Logo ist nicht mehr verfügbar.“ erscheint und die Vorschau zeichnet ohne Logo, damit PNG und Vorschau dasselbe zeigen. Ist ein Logo wieder da, folgt die Vorschau ebenso. Das gilt nur, solange die Auswahl noch dieselbe ist. - Tests mit dem echten Zwischenspeicher (nur Zeile und Datei aus logos.ts ersetzt): erst geladen, dann ausgeblendet bzw. gelöscht → neu geprüft, Veröffentlichen bricht ab / „Meine Karten“ meldet / der Editor lädt ohne Logo herunter, zeigt den Hinweis (auch zusammen mit dem Größenhinweis) und zeichnet neu; sichtbares Logo wird frisch geholt; Karte ohne Logo holt nichts; „Nur Bild“ bleibt unberührt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AirCard-IOS
Inoffizielles Hobbyprojekt, mit dem man eigene Kartenmotive für Apple Wallet unter https://aircard-ios.org gestalten kann. Bilder hochladen, Vorlage und Netzwerk-Logo wählen, herunterladen – oder mit Konto speichern. Keine Verbindung zu Apple, Visa, Mastercard, UnionPay, American Express, JCB oder Discover.
Aufbau
web/ – Vite + TypeScript ohne Framework. Frontend-Module in src/:
card/– Geometrie, Zuschnitt, Canvas-Rendering (keine DOM-Abhängigkeiten, einzeln testbar)editor/– UI (Vorlagen, Vorschau, Download, Speichern)account/– Appwrite-Client, Auth, Kartenverwaltungpages/– Routen (/,/karten,/passwort-neuvia History-API)
deploy/ – Webhook-Router (Port 8087), Build-Skript (deploy.sh), nginx-Config, Traefik-Route für Appwrite.
docs/ – Spec, Plan, Appwrite-Konfiguration.
Lokal entwickeln
cd web
npm ci
npm run dev # Entwicklungsserver http://localhost:5173
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:
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/):
cd web
npx vitest run # Unit-Tests (card/*, editor/*, account/*, pages/*)
npx tsc --noEmit # TypeScript-Prüfung
Im Repo-Wurzelverzeichnis:
node --test deploy/webhook-server.test.js # Webhook-Server (deploy.sh wird dort durch einen Stub ersetzt)
node --test deploy/deploy.test.js # deploy.sh (echtes Skript, lokaler git-Remote, npm-Stub)
node --test web/scripts/appwrite-setup.test.mjs # Appwrite-Schema-Skript
Deploy
Automatisch: Push auf main → Gitea-Webhook → Container webklar-aircard-build führt npm ci und vite build aus → Ergebnis nach out/ → nginx webklar-aircard liefert.
Manuell:
docker exec webklar-aircard-build sh /deploy.sh
Starten nur mit:
docker compose up -d aircard-build aircard aircard-api
aircard-api ist der kleine API-Dienst der Community-Galerie (deploy/api/, Route aircard-ios.org/api, siehe deploy/api/README.md).
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, von Appwrite generiert):
6ac2130a00289343d6d5. Sie steht indeploy/traefik/aircard.yml, in/home/webklar/apps/.env(AIRCARD_APPWRITE_PROJECT_ID) und als Standard inweb/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;--checkprüft nur das Schema): Auth mit E-Mail + Passwort, Sitzungsdauer 30 Tage, max. 5 Sitzungen pro Nutzer, Nutzerlimit 2000, Web-Plattformenaircard-ios.orgundlocalhost. Schritte 3 und 4 dort (Auth-Härtung, Dienste abschalten) sind optional und am Live-Projekt unbestätigt.
Schema prüfen:
node --env-file=/home/webklar/apps/.env web/scripts/appwrite-setup.mjs --check
Schema erstmalig anlegen:
node --env-file=/home/webklar/apps/.env web/scripts/appwrite-setup.mjs
Umgebungsvariablen (in /home/webklar/apps/.env):
AIRCARD_APPWRITE_PROJECT_ID– Projekt-ID (idempotent im Skript lesbar)AIRCARD_APPWRITE_API_KEY– API-Keyaircard-provision(nur für Setup)
Hinweis
Inoffizielles Hobbyprojekt. Alle Marken gehören ihren Inhabern.