Commit a614e0

2026-05-28 17:14:10 Manuel Weiser: docs: Update admin and spool documentation to include NFC tag data import and app settings
docs/de/00-inhalt.md ..
@@ 22,7 22,7 @@
| 8 | [Lagerorte (Locations)](/Docs/De/08-Lagerorte) | Lagerplätze und RFID-Integration |
| 9 | [Drucker (Printers)](/Docs/De/09-Drucker) | 3D-Drucker verwalten und integrieren |
| 10 | [Einstellungen (Settings)](/Docs/De/10-Einstellungen) | Profil und Passwort ändern |
- | 11 | [Admin-Bereich](/Docs/De/11-Admin) | Benutzer, Rollen, Geräte, Zusatzfelder, System, Backup |
+ | 11 | [Admin-Bereich](/Docs/De/11-Admin) | Benutzer, Rollen, Geräte, Zusatzfelder, System, Backup, App-Einstellungen (RFID) |
| 12 | [Farbverwaltung](/Docs/De/12-Farbverwaltung) | Farben für Filamente definieren |
| 13 | [Tipps & Häufige Fragen](/Docs/De/13-Faq) | FAQ und Empfehlungen |
| 14 | [Plugin: BambuLab](/Docs/De/14-Plugin-Bambulab) | BambuLab-Druckertreiber-Plugin |
docs/de/07-spulen.md ..
@@ 62,6 62,29 @@
→ Weitere Informationen: [Kapitel 18: FilaManDB Community-Datenbank](/Docs/De/18-Filamandb)
+ #### Daten von NFC-Tag übernehmen
+
+ > **Voraussetzung:** Eine FilaMan-Waage (ESP32) muss eingeschaltet und mit dem Netzwerk verbunden sein.
+
+ Beim Erstellen einer neuen Spule befindet sich ganz oben im Formular der Button **„Von Tag übernehmen"** (hellblau hervorgehoben). Mit dieser Funktion können die Filamentdaten direkt von einem vorhandenen NFC-Tag in das Formular importiert werden – ohne manuelle Eingabe.
+
+ Der Button ist **nur klickbar**, wenn mindestens eine Waage als aktiv erkannt wird. Ist keine Waage online, bleibt er ausgegraut.
+
+ **Vorgehensweise:**
+
+ 1. Klicken Sie auf **„Von Tag übernehmen"** – ein Dialog öffnet sich
+ 2. Sind mehrere Waagen verbunden, wählen Sie das gewünschte Gerät aus
+ 3. Der Dialog fordert Sie auf, die Spule auf die Waage zu legen und den Tag bereitzuhalten
+ 4. Die Waage liest den nächsten NFC-Tag (Wartezeit: bis zu 30 Sekunden)
+ 5. Bei Erfolg:
+ - Wird das passende Filament im Dropdown vorausgewählt, sofern ein Filament mit übereinstimmendem Material und Hersteller in der Datenbank vorhanden ist
+ - Wird eine Bestätigungsmeldung mit dem erkannten Filamentnamen angezeigt
+ 6. Falls kein passendes Filament gefunden wird, erscheint ein Hinweis mit Material und Hersteller des Tags – das Filament kann dann manuell ausgewählt werden
+
+ **Unterstützte Tag-Protokolle:** OpenSpool (`"protocol": "openspool"`) und FilaMan (`"protocol": "filaman"`)
+
+ > 💡 **Tipp:** Um NFC-Tags mit diesen Protokolldaten zu beschreiben, aktivieren Sie unter [Admin → App-Einstellungen](/Docs/De/11-Admin#rfid-extended-data) die Option „RFID Extended Data". Beim nächsten Schreiben eines Tags über die Waage werden die Filamentdaten automatisch im gewählten Format auf den Tag geschrieben.
+
### Spule bearbeiten
In der Aktionsspalte können Sie:
- ✏️ **Bearbeiten** – Spuleninformationen ändern (z. B. Restgewicht nach dem Druck aktualisieren)
docs/de/11-admin.md ..
@@ 306,7 306,44 @@
---
- ## 11.8 Gefahrenzone
+ ## 11.8 App-Einstellungen
+
+ **URL:** `http(s)://url/admin/app-settings`
+
+ Hier werden systemweite Einstellungen verwaltet, die das Verhalten von FilaMan beeinflussen.
+
+ ### RFID Extended Data {#rfid-extended-data}
+
+ In diesem Bereich wird konfiguriert, ob und in welchem Format zusätzliche Filamentdaten auf NFC-Tags geschrieben werden, wenn eine FilaMan-Waage (ESP32) einen Tag beschreibt.
+
+ | Einstellung | Beschreibung |
+ |-------------|-------------|
+ | **RFID Extended Data aktiviert** | Wenn aktiv, werden beim Schreiben eines Spulen-Tags über die Waage zusätzlich Filamentdaten (Material, Farbe, Hersteller, Temperaturen) im gewählten Protokollformat auf den Tag geschrieben. |
+ | **RFID-Protokoll** | Wahl des Datenformats: **OpenSpool** (kompatibel mit dem OpenSpool-Standard) oder **FilaMan** (proprietäres FilaMan-Format). Beide Formate sind von der FilaMan-Waage lesbar. |
+
+ **Auf den Tag geschriebene Felder (wenn aktiviert):**
+
+ ```json
+ {
+ "protocol": "openspool",
+ "version": "1.0",
+ "type": "PLA",
+ "color_hex": "FF3300",
+ "brand": "Bambu Lab",
+ "min_temp": "180",
+ "max_temp": "230"
+ }
+ ```
+
+ Diese Felder werden zusammen mit der Spulen-ID in das Root-Objekt des Tag-Payloads geschrieben.
+
+ > 💡 **Hinweis:** Tags, die im OpenSpool- oder FilaMan-Format beschrieben wurden, können mit der Funktion [„Von Tag übernehmen"](/Docs/De/07-Spulen#daten-von-nfc-tag-übernehmen) beim Erstellen neuer Spulen wieder eingelesen werden. Die Waage erkennt das Protokoll und überträgt Hersteller, Material und Farbe automatisch ins Formular.
+
+ > ⚠️ **Hinweis zur Tag-Kapazität:** NTAG213-Tags (144 Byte Nutzerdaten) können die zusätzlichen Felder möglicherweise nicht aufnehmen, wenn die Spulen-ID bereits viel Platz benötigt. Für Extended Data empfehlen sich NTAG215 (504 Byte) oder NTAG216 (888 Byte).
+
+ ---
+
+ ## 11.9 Gefahrenzone
Am unteren Ende des Admin-Panels befindet sich die rot markierte **Danger Zone** mit einer kritischen Aktion:
docs/en/00-contents.md ..
@@ 22,7 22,7 @@
| 8 | [Locations](/Docs/En/08-Locations) | Storage locations and RFID integration |
| 9 | [Printers](/Docs/En/09-Printers) | Managing and integrating 3D printers |
| 10 | [Settings](/Docs/En/10-Settings) | Updating profile and password |
- | 11 | [Admin Area](/Docs/En/11-Admin) | Users, roles, devices, extra fields, system, backup |
+ | 11 | [Admin Area](/Docs/En/11-Admin) | Users, roles, devices, extra fields, system, backup, app settings (RFID) |
| 12 | [Color Management](/Docs/En/12-Colors) | Defining colors for filaments |
| 13 | [Tips & FAQ](/Docs/En/13-Faq) | Frequently asked questions |
| 14 | [Plugin: BambuLab](/Docs/En/14-Plugin-Bambulab) | BambuLab printer driver plugin |
docs/en/07-spools.md ..
@@ 62,6 62,29 @@
→ More information: [Chapter 18: FilaManDB Community Database](/Docs/En/18-Filamandb)
+ #### Import Data from NFC Tag
+
+ > **Prerequisite:** A FilaMan scale (ESP32) must be powered on and connected to the network.
+
+ When creating a new spool, the **"Import from Tag"** button (highlighted in light blue) appears at the very top of the form. This feature lets you import filament data directly from an existing NFC tag — without any manual entry.
+
+ The button is **only clickable** when at least one scale is detected as active. If no scale is online, it remains grayed out.
+
+ **How it works:**
+
+ 1. Click **"Import from Tag"** — a dialog opens
+ 2. If multiple scales are connected, select the desired device
+ 3. The dialog prompts you to place the spool on the scale and hold the tag ready
+ 4. The scale reads the next NFC tag (waiting time: up to 30 seconds)
+ 5. On success:
+ - The matching filament is pre-selected in the dropdown, if a filament with a matching material type and brand exists in the database
+ - A confirmation message shows the detected filament name
+ 6. If no matching filament is found, a notice displays the material and brand from the tag — you can then select the filament manually
+
+ **Supported tag protocols:** OpenSpool (`"protocol": "openspool"`) and FilaMan (`"protocol": "filaman"`)
+
+ > 💡 **Tip:** To write tags in these formats, enable "RFID Extended Data" under [Admin → App Settings](/Docs/En/11-Admin#rfid-extended-data). The next time a tag is written via the scale, filament data will automatically be embedded in the chosen format.
+
### Edit / Delete a Spool
In the actions column you can:
- ✏️ **Edit** – Update spool information (e.g. remaining weight after printing)
docs/en/11-admin.md ..
@@ 306,7 306,44 @@
---
- ## 11.8 Danger Zone
+ ## 11.8 App Settings
+
+ **URL:** `http(s)://url/admin/app-settings`
+
+ System-wide settings that control FilaMan's behavior are managed here.
+
+ ### RFID Extended Data {#rfid-extended-data}
+
+ This section configures whether and in what format additional filament data is written to NFC tags when a FilaMan scale (ESP32) writes a tag.
+
+ | Setting | Description |
+ |---------|-------------|
+ | **RFID Extended Data enabled** | When active, writing a spool tag via the scale will also embed filament data (material, color, brand, temperatures) in the chosen protocol format. |
+ | **RFID Protocol** | Choice of data format: **OpenSpool** (compatible with the OpenSpool standard) or **FilaMan** (proprietary FilaMan format). Both formats are readable by the FilaMan scale. |
+
+ **Fields written to the tag (when enabled):**
+
+ ```json
+ {
+ "protocol": "openspool",
+ "version": "1.0",
+ "type": "PLA",
+ "color_hex": "FF3300",
+ "brand": "Bambu Lab",
+ "min_temp": "180",
+ "max_temp": "230"
+ }
+ ```
+
+ These fields are written alongside the spool ID in the root object of the tag payload.
+
+ > 💡 **Note:** Tags written in OpenSpool or FilaMan format can be read back using the [Import from Tag](/Docs/En/07-Spools#import-data-from-nfc-tag) feature when creating new spools. The scale detects the protocol and automatically transfers brand, material, and color into the form.
+
+ > ⚠️ **Tag capacity note:** NTAG213 tags (144 bytes user data) may not have enough space for the additional fields if the spool ID already takes up significant space. For Extended Data, NTAG215 (504 bytes) or NTAG216 (888 bytes) are recommended.
+
+ ---
+
+ ## 11.9 Danger Zone
At the bottom of the Admin Panel you will find the red-highlighted **Danger Zone** with one critical action:
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9