Benutzerhandbuch

1. Werkstück anlegen und wiederfinden

Auf der Übersicht die Regenbogen-Schaltfläche „＋ Werkstück“ wählen. Die kurze Anlage folgt der Reihenfolge Titel, Status, Ton und Notizen. Den Ton wählst du aus deiner Werkstatt oder gibst Ton und Hersteller direkt in das Freitextfeld ein. Neue Werkstücke starten mit „In Arbeit“; schon beim Anlegen oder später beim Bearbeiten kannst du auch „In Planung“ oder „Fertig“ wählen. Das Suchfeld „Suche nach Werkstück, Ton oder Glasur“ sowie Inhalts- und Statusfilter helfen später beim Wiederfinden. Die Übersicht zeigt zuerst alle eigenen und danach die geteilten Werkstücke anderer Personen. Beide Bereiche sind nach In Planung → In Arbeit → Fertig sortiert, innerhalb jedes Status nach Titel A–Z. Groß- und Kleinschreibung werden gleich behandelt; ä, ö und ü stehen bei a, o und u, ß bei ss. Auch nach Suchen und Filtern gilt diese Reihenfolge. Auf breiten Bildschirmen ordnet die Übersicht ihre Karten automatisch in zwei oder drei Spalten an; Bild, Titel, Ton und Status bleiben dabei ordentlich innerhalb gleich hoher Karten angeordnet. Über „Werkstück bearbeiten“ in der Werkstückansicht kannst du Titel, Status, Ton und Notizen jederzeit ändern. Eigentümer und Administratoren finden dort auch „Werkstück löschen“. Die anschließende Sicherheitsabfrage entfernt das Werkstück samt Fotos, Bränden, Glasuraufträgen und Freigaben dauerhaft.

2. Fotos, Brände und Glasuren

Diese drei Aktionen haben denselben Regenbogen-Look, weil sie gleichwertige Schritte der Dokumentation sind. Die neutralen Creme-Schaltflächen führen zurück oder öffnen Nebenfunktionen. Bei vorhandenen Fotos oder Glasuren öffnet das kleine Info-Symbol neben der Überschrift den Sortierhinweis; es ist per Antippen und Tastatur bedienbar und zeigt bei Mauszeiger zusätzlich einen Kurz-Hinweis.

1. Bei Fotos kannst du aus der Galerie bis zu zehn Bilder gleichzeitig wählen oder die Kamera öffnen. Ein angetiptes Bild öffnet eine Ansicht zum Zurück- und Weiterblättern. Nach dem letzten Bild beginnt „Von vorne“ wieder beim ersten. Zum Sortieren eine Fotokachel kurz gedrückt halten und dann ziehen; normales Wischen scrollt weiter. Die kleinen Pfeile sind eine optionale Alternative für präzises Antippen oder Tastatur. Das Galeriefoto bleibt dabei markiert und kann ebenfalls verschoben werden; seine Markierung bestimmt das Vorschaubild in der Übersicht, nicht seine Position. Halte die Kachel zum Ziehen kurz ruhig gedrückt und bewege sie dann an die gewünschte Stelle. Am oberen oder unteren Bildschirmrand scrollt die Seite automatisch weiter. Die neue Reihenfolge gilt nach dem Loslassen auch im Fotobetrachter und nach dem Neuladen. Über das Mülleimersymbol öffnest du eine Sicherheitsabfrage zum endgültigen Löschen.
2. Beim Brand eine gespeicherte Brandkombination aus Temperatur und Ort auswählen oder beide Werte frei eintragen. Das Stiftsymbol öffnet einen vorhandenen Brand zum Bearbeiten.
3. Beim Glasurauftrag stehen neben deinen eigenen auch lesbar freigegebene Glasuren zur Auswahl; diese nennen kurz „geteilt von“ und den Benutzernamen. Die Nutzung verändert nie die Originalglasur. Entfällt eine Freigabe später, bleibt dein bereits dokumentierter Auftrag weiterhin sichtbar.
4. Beim Glasurauftrag 1, 2 oder 3 Schichten direkt antippen oder die freie Zahl in das vierte gleich große Zahlenfeld eintragen. Es ist stets genau eine Auswahl aktiv: Die freie Zahl entfernt die Markierung von 1–3; beim Antippen von 1–3 bleibt die freie Zahl für später stehen, ist aber nicht mehr aktiv. Die Positionskacheln lassen sich mehrfach auswählen.
5. In der Werkstückansicht kannst du die Glasuraufträge in ihre tatsächliche Aufbringungsreihenfolge bringen: Eine Kachel kurz gedrückt halten und nach oben oder unten ziehen; normales Wischen bleibt zum Scrollen reserviert. Zugeordnete Fotos erscheinen direkt kompakt in der jeweiligen Kachel. Das Stiftsymbol öffnet die Bearbeitung.

3. Status und Freigabe

Eigene Werkstücke können als fertig markiert und jederzeit wieder geöffnet werden. Freigegebene Werkstücke stehen getrennt in der Übersicht und nennen den Eigentümer. Bei deinen eigenen Werkstücken steht außerdem direkt „Geteilt mit“ samt Benutzernamen. Das Symbol mit den drei verbundenen Punkten öffnet die Freigabeverwaltung; es wird bei Werkstücken, Glasuren und Glasurproben einheitlich verwendet. Neben „＋ Werkstück“ öffnet dasselbe Symbol die Sammelfreigabe aller eigenen Werkstücke. Sie teilt diese bewusst nur zum Ansehen; bereits vorhandene Einzelfreigaben und Bearbeiten-Rechte bleiben dabei unverändert. Beim Bearbeiten einer Glasur steht es direkt oben neben „Änderungen speichern“. Die Freigabefilter der Glasursammlung zeigen nur Personen, mit denen mindestens ein Werkstück geteilt wurde; andere Konten bleiben dort unsichtbar. Im Freigabe-Dialog werden nur Benutzernamen angezeigt, keine E-Mail-Adressen; Administratorkonten sind keine Freigabeziele und erscheinen dort nicht. Für jede Person wählst du „Nur ansehen“ oder „Bearbeiten“. Bearbeiter dürfen das Werkstück samt Fotos, Bränden und Glasuraufträgen ändern, aber keine weiteren Freigaben vergeben.

4. Werkstatt, Glasurproben und Sicherung

In Werkstatt öffnest du direkt die Pflegebereiche für Ton, Brandkombinationen und Glasuren. Jede Einstiegsseite führt über „Zur Werkstatt“ wieder direkt hierher zurück. Beim Ton kannst du neben Hersteller, Sorte und Brennbereich auch Schamotteanteil und Schamottekörnung hinterlegen. Eine Brandkombination verbindet eine Temperatur mit einem Brennort oder Ofen. Die Sammlung zeigt deine Glasuren mit Suche und Filtern. In jeder Zeile steht die Kennung / Artikelnummer direkt unter dem Namen und über dem Brennbereich, sofern sie hinterlegt ist. Das gilt auch für geteilte Glasuren; die Anlage und Bearbeitung öffnen jeweils eine eigene, kompakte Seite. Neben Hersteller, Name und Brennbereich kannst du Informationen frei notieren sowie unter Eigenschaften das Fließverhalten und Lebensmittelecht als Ja oder Nein markieren. Nicht dokumentierte ältere Werte gelten als Nein. Zeigt eine Glasur eine Probe, erscheint deren Galeriefoto direkt in der Sammlung.

Unter Herstellerkatalog wählst du Mayco-, BOTZ- oder AMACO-Glasuren aus, die anschließend in deiner Sammlung stehen. Alle importierten Einträge eines Herstellers sind sichtbar. Die Herstellerauswahl und Suche stehen oben, die Ergebnisliste darunter – auf breiten Bildschirmen in zwei gut lesbaren Spalten. Über „Mehrfachauswahl“ markierst du auf Touch-Geräten oder mit der Maus beliebig viele Einträge und übernimmst sie gemeinsam. Die Einzelübernahme arbeitet direkt in der Liste und sendet ihre Daten an genau die im Browser geöffnete Katalogadresse in derselben robusten Formularcodierung wie die Mehrfachauswahl. Dadurch bleibt sie auch hinter einem Reverse Proxy ohne Seitenwechsel zuverlässig; unter dem Button erscheint ausschließlich bei einem echten Fehler eine verständliche Meldung.

Beim Bearbeiten einer Glasur speicherst du mit „＋ Probe“ zunächst alle Änderungen und öffnest danach direkt eine neue Probe mit dieser Glasur vorausgewählt. Eigene Glasuren können dort auch nach einer Sicherheitsabfrage gelöscht und über das Teilen-Symbol einzeln freigegeben werden. Das gleiche Symbol bei der Sammlung gibt alle eigenen Glasuren gesammelt lesbar frei. Werkstückaufträge werden beim Löschen entfernt; Fotos bleiben als allgemeine Werkstückbilder erhalten. Eine Probe ohne weitere Glasur wird mit ihren Bildern gelöscht.

Unter Glasurproben dokumentierst du gebrannte Teststücke mit einem oder mehreren Bildern. Wähle danach alle verwendeten Glasuren aus und verwende für Temperatur und Brennort dieselbe Brandkombination wie beim Werkstückbrand – oder trage beide Werte frei ein. Bereits gewählte Glasuren stehen oben zusätzlich als kompakte Liste. Für jede davon dokumentierst du getrennt Art des Auftrags, 1, 2, 3 oder frei gewählte Schichten und eine oder mehrere Positionen (oben, Mitte, unten, links, rechts oder vollflächig); über das kleine Papierkorb-Symbol kannst du sie direkt wieder abwählen. Ein angetipptes Probenbild öffnet die gleiche Vollbildgalerie wie ein Werkstückbild. Das Galeriefoto steht immer zuerst, und die Galerie blättert in beiden Richtungen endlos weiter. Bilder lassen sich kurz gedrückt sortieren, per Mülleimer nach Sicherheitsabfrage löschen und als Galeriefoto für die Übersicht festlegen. Über das Teilen-Symbol teilst du eine Probe gezielt, über das Symbol in der Probenübersicht alle eigenen Proben gesammelt mit anderen aktiven Benutzern. Diese sehen sie in ihrer Werkstatt, bleiben aber immer im Nur-ansehen-Modus.

Listen laden Bilder beim Scrollen verzögert, damit längere Sammlungen flüssiger bleiben. Beim Zurückkehren aus einer Unteransicht stellt die App auf langen Seiten die vorherige Scrollposition wieder her. Übernommene Glasuren dürfen persönlich geändert werden; ihre Katalogbasis bleibt erkennbar und andere Benutzer sehen deine Änderungen nicht. Mayco kann regelmäßig abgeglichen werden; BOTZ und AMACO aktualisierst du bei Bedarf als Administratorin oder Administrator manuell im jeweiligen Herstellerkatalog. Nicht mehr gelistete Artikel findest du über „Ausgelaufene Artikel einblenden“ und kannst sie weiterhin übernehmen. Als Administratorin oder Administrator öffnest du Sicherung, um die gesamte Sammlung herunterzuladen oder wiederherzustellen. Sicherungen werden ausschließlich per SSH direkt aus dem NAS-Backup-Ordner wiederhergestellt, auch über 2 GB. Die Oberfläche bietet weiterhin Sicherungs- und Lesearchiv-Downloads. Die genaue, abgesicherte Anweisung steht in der NAS-Einrichtung.

Bildvorschauen

In längeren Übersichten lädt die App kleine, geschützte Bildvorschauen. Das Originalfoto bleibt unverändert gespeichert und wird erst beim Öffnen in der Vollbildansicht geladen. Auf dem Smartphone bleiben Vorschau, Werkstücktitel, Ton und Status sauber lesbar: Der Status steht bei der Kennzeichnung, der Titel erhält darunter die volle Breite und bricht bevorzugt zwischen Wörtern um. Nach einem Update kann die Administration die vorhandenen Vorschauen einmalig auf dem NAS erzeugen; die genaue Anweisung steht in der NAS-Einrichtung.

Farbcode

Rot wird nur dort verwendet, wo Daten ersetzt oder gelöscht werden können. Karten, Eingabefelder, Auswahlkacheln, Hinweise und Bildbedienung greifen in Hell, Dunkel und Systemdarstellung auf dieselben Farbrollen zurück und bleiben dadurch kontrastreich lesbar. Aktionsleisten hinter den Schaltflächen bleiben transparent, damit keine zusätzliche rechteckige Farbfläche entsteht.

5. Hilfe, Darstellung und Anmeldung

Die Töpferscheibe neben „Töpfer-App“ führt wie der Name zur Startseite. Dasselbe Symbol erscheint als Favicon im Browser-Tab und beim Speichern der App auf iPhone oder iPad. Über Hilfe ▾ in der Navigation öffnest du direkt das Untermenü. Alle neutral gerahmten Einträge verwenden dieselbe weiße Kartenfläche beziehungsweise im Dunkelmodus die passende dunkle Fläche und bleiben auf Maus, Touch und Tastatur gleich gut erkennbar. Auf der Startseite startet der Klickleitfaden eine vollständige Einführung: zuerst Ton, Brandkombinationen und Glasuren in der Werkstatt anlegen, danach ein Werkstück dokumentieren und anschließend Proben, Suche, Konto und – bei Administration – Sicherungen kennenlernen. Bei einem ganz neuen Konto beginnt diese Einführung einmal automatisch; über Hilfe lässt sie sich jederzeit erneut starten. Das Handbuch bleibt ebenfalls jederzeit erreichbar. Mit „Feedback senden“ schickst du Ideen, Wünsche oder Fehlermeldungen direkt an die aktiven Administrationskonten. Die Nachricht nennt deinen Namen und Benutzernamen; sie wird nicht als Inhalt in der App gespeichert. Das Darstellungssymbol schaltet bei jedem Klick direkt zwischen System, Hell und Dunkel um. Der Tooltip zeigt dir, welche Einstellung als Nächstes gewählt wird. Hell und Dunkel bleiben in diesem Browser gespeichert; System folgt wieder deinem Gerät. Die Auswahl gilt durchgängig auch für Handbuch, Versionshistorie und die Browserleiste. Administratoren finden Benutzer, Mailprotokoll und Sicherung gebündelt unter Administration ▾.

Bei der einmaligen Einrichtung gibst du neben Name und E-Mail-Adresse auch einen Benutzernamen an. Mit diesem oder deiner E-Mail-Adresse kannst du dich anschließend anmelden. Beim Login legt „Angemeldet bleiben“ eine Anmeldung auf diesem Gerät ab. Die Dauer kann die Administration über die Umgebungsvariablen festlegen. Zum Schutz der Konten begrenzt die App wiederholte Anmeldungen, Passwort-Resets und Registrierungen; nach zu vielen Versuchen wartest du kurz und probierst es später erneut.

6. Konto, eigenes Archiv und Löschung

Unter Konto kannst du Name, Benutzername und E-Mail-Adresse ändern. Für eine neue E-Mail-Adresse wird zusätzlich das aktuelle Passwort verlangt. Das Passwort änderst du getrennt im Bereich „Sicherheit“. Unter Darstellung entscheidest du außerdem pro Konto, ob die Sortierpfeile bei Fotos und Glasuren angezeigt werden.

Mit „Meine Daten herunterladen“ speicherst du ein vollständiges ZIP-Lesearchiv deiner eigenen Werkstücke, Glasurproben, Fotos, Glasuren, Töne und Brandkombinationen. Mit dir geteilte Objekte anderer Personen sind ausgeschlossen, auch im persönlichen Download eines Administrationskontos. Unter Administration → Sicherung kann die Administration ein Lesearchiv aller Konten herunterladen.

Entpacke die ZIP-Datei vollständig in einen Ordner und öffne dort index.html im Browser. Halte alle Dateien und Unterordner zusammen. Die Übersicht bietet Suche und einen Filter für Werkstücke oder Proben; die Werkstattdaten stehen auf einer eigenen Seite. Jede Detailseite enthält die dokumentierten Angaben, Brände, Glasuraufträge und Fotos.

Die gleich großen Vorschauflächen zeigen Bilder ohne Verzerrung. Ein Bild öffnet die Galerie: mit Vor/Zurück, den Pfeiltasten oder horizontalem Wischen blättern; mit Schließen oder Escape zurückkehren. Original öffnen zeigt die unveränderte, zuletzt in der App gespeicherte Bilddatei separat. Speichern oder Kopieren erfolgt über den Browser oder direkt aus dem jeweiligen Ordner originalbilder. Frühere Fassungen bearbeiteter Fotos sind nicht enthalten. Kann eine Vorschau nicht erzeugt werden, ist das Original trotzdem enthalten und erreichbar.

Das Archiv benötigt weder Internet noch Anmeldung oder einen lokalen Server. Auf iPhone/iPad kann die Dateien-Vorschau lokale Links oder die Galerie einschränken; die Nutzung auf physischen Geräten ist noch nicht abschließend geprüft. Dieses Lesearchiv dient zum Anschauen und ist kein wiederherstellbares App-Backup. Für die Wiederherstellung nutze den separaten Download „Vollständiges Backup“.

Die vollständige Kontolöschung entfernt eigene Werkstücke, Fotos, dokumentierte Glasuraufträge und Werkstattdaten. Sie verlangt drei bewusste Schritte: aktuelles Passwort, das Wort „LÖSCHEN“ und das Kontrollkästchen. Das letzte aktive Administratorkonto ist geschützt.

7. Automatische Sicherung und Katalog

Der Administrator kann auf dem NAS eine tägliche Aufgabe für vollständige ZIP-Sicherungen mit Datenbank und Fotos sowie eine wöchentliche Aufgabe für den Mayco-Katalog einrichten. BOTZ und AMACO aktualisierst du bei Bedarf im jeweiligen Reiter des Herstellerkatalogs manuell; dafür ist kein Hintergrundjob vorgesehen. Katalogabgleiche aktualisieren ausschließlich verknüpfte, nicht persönlich geänderte Glasuren; manuell angelegte Einträge werden nicht verändert. Nicht mehr gelistete Artikel bleiben als ausgeblendete Katalogeinträge erhalten und lassen sich bei Bedarf übernehmen. Für ein neues App-Release überträgt der in der NAS-Einrichtung dokumentierte PowerShell-Aufruf ein versionsgenaues Image in die interne Registry. Ein ZIP-Notfallpaket erstellst du nur bei Bedarf bewusst getrennt. Details stehen in der NAS-Einrichtung.

8. Registrierung und Benutzer administrieren

Über „Registrieren“ auf der Login-Seite kann ein neues Konto beantragt werden. Es bleibt zunächst deaktiviert. Aktive Administratorinnen und Administratoren erhalten eine E-Mail und schalten das Konto unter Benutzer frei. Die Registrierung kann in der Serverkonfiguration auch vollständig abgeschaltet werden. Zusätzlich wird sie nach fünf neuen Konten innerhalb einer Stunde oder zehn innerhalb von 24 Stunden automatisch gesperrt, unabhängig von IP-Adresse und E-Mail-Adresse. Die Grenzen können im Betrieb angepasst werden. Der Erklärungstext zu den Grenzen steht am kleinen Info-Symbol neben „Öffentliche Registrierung“. Unter Benutzer → Öffentliche Registrierung siehst du den Zustand und kannst nach Prüfung der neuen Konten „Registrierung wieder freigeben“ wählen. Dabei beginnen die Registrierungszähler neu. Die Sperre endet weder durch Zeitablauf noch durch Löschen eines Kontos. Von der Administration angelegte Konten zählen nicht mit.

Als Administratorin oder Administrator kannst du unter Benutzer neue Konten anlegen, bestehende Konten deaktivieren und später wieder reaktivieren. Beim Anlegen wählst du unter Rolle entweder Benutzer oder Admin. Benutzer ist vorausgewählt; ein Admin kann alle Konten und Anwendungsdaten verwalten. Das neue Konto ist sofort aktiv. Öffentliche Registrierungen erhalten weiterhin ausschließlich die Rolle Benutzer und bleiben zunächst deaktiviert. Deaktivierte Konten können sich nicht mehr anmelden; ihre Daten bleiben zunächst erhalten. Die betroffene Person erhält bei Aktivierung und Deaktivierung eine Information per E-Mail. Das Papierkorb-Symbol führt direkt zur Löschbestätigung. Die Überschrift erhält den Fokus; Fehlermeldungen erscheinen direkt im Löschbereich. Vor einer Löschung ist die Benachrichtigung zunächst ausgewählt. Bei Spam- oder verdächtigen Konten kannst du „Benutzer vor der Löschung per E-Mail benachrichtigen“ abwählen. Dann wird keine Nachricht versendet. Administrationspasswort, das Wort „LÖSCHEN“ und die endgültige Bestätigung bleiben erforderlich.

Unter Mailprotokoll siehst du als Administration, ob ein Versandversuch an den SMTP-Server erfolgreich übergeben wurde. Es ist kein Zustellnachweis. Das Protokoll enthält weder E-Mail-Adressen, Betreffzeilen noch Nachrichteninhalte; bei einer Kontolöschung wird der Empfänger anonymisiert. Die Aufbewahrungszeit legst du mit MAIL_LOG_RETENTION_DAYS fest.

Für eine vollständige Löschung wählst du beim gewünschten Konto das kleine Papierkorb-Symbol. Die abschließende Bestätigung verlangt dein aktuelles Administrationspasswort, das Wort „LÖSCHEN“ und das Kontrollkästchen. Dabei werden auch die eigenen Daten dieses Kontos entfernt. Das eigene Konto verwaltest du unter „Konto“.

9. Datenschutz

Der Link „Datenschutz“ im Footer ist vor und nach der Anmeldung verfügbar. Dort stehen verantwortliche Person, gespeicherte Daten, Freigaben, Passwort-E-Mails, Sicherungen und Kontaktmöglichkeiten.