# Globale Filamente

## Bereich

- Route: `/filaments`
- Zweck: Hersteller-, Material- und Filament-Stammdaten pflegen und Community-Profile vorbereiten

## Wann du diesen Bereich nutzt

Die Seite `Globale Filamente` ist die Materialdatenbasis der App. Du nutzt sie:

- um Hersteller und Filamente neu anzulegen
- um Herstellerdaten und Logos zu pflegen
- um nach Materialgruppen, Farben, Profiltypen oder SKU zu suchen
- um mehrere Filamente gesammelt zu bearbeiten
- um User-Filamente zusammen mit Herstellerdaten an die Community zu teilen

## Wichtige Elemente der Seite

### Filterbereich

Die Filterbox ist in einen kompakten und einen erweiterten Modus aufgeteilt.

- eingeklappt: nur Freitextsuche und Suchbutton
- ausgeklappt: Hauptfilter und erweiterte Filter
- Tabs: `Basis` und `Erweiterte Filter`

### Toolbar

Die obere Toolbar ist menübasiert aufgebaut:

- `Herstellerdaten`
- `Filamente`
- `Community & Tools`
- `Analyse & Wechsel`

Dort liegen unter anderem:

- Markieren und Markierung aufheben
- Sortierung
- Ansichtswechsel
- Hersteller neu anlegen oder bearbeiten
- Community-Share

### Herstellerstruktur

Die Ergebnisliste ist hierarchisch:

1. Hersteller
2. Materialgruppe
3. einzelne Filamente

### Filamentkarten

Die Filamentkarten enthalten die eigentlichen Materialinformationen und Schnellaktionen wie:

- Bearbeiten
- Mehr
- Datenblattstatus
- Quellen- und Profilhinweise

## Voraussetzungen

Vor sinnvoller Arbeit in diesem Bereich sollten folgende Dinge klar sein:

- der Herstellername ist bekannt
- Materialgruppe ist bekannt
- wichtige Grunddaten wie Farbe, SKU oder Temperaturen liegen vor
- bei Community-Share sind es echte User-Profile

## Schritt-für-Schritt Anleitung

### Schritt 1: Die Seite öffnen

1. Im linken Menü auf `Globale Filamente` klicken.
2. Warten, bis Filterbox, Toolbar und Herstellerstruktur geladen sind.
3. Entscheiden, ob die kompakte Suche reicht oder erweiterte Filter nötig sind.

### Schritt 2: Mit der Suche eingrenzen

1. In das Freitextfeld Hersteller, Material, Farbe oder SKU eingeben.
2. Optional den Filterbereich aufklappen.
3. Im Tab `Basis` Hersteller, Material oder SKU/EAN zusätzlich setzen.
4. Auf `Suchen` klicken.

### Schritt 3: Mit Sekundärfiltern verfeinern

1. In der Toolbar die Sekundärfilter öffnen.
2. Materialgruppen wie `PLA`, `PETG`, `ABS`, `ASA` oder `TPU` wählen.
3. Profiltypen wie `Basic`, `Matt`, `Silk`, `Rainbow` oder `Glow` wählen.
4. Filter anwenden und prüfen, ob nur noch die passenden Hersteller und Filamente sichtbar sind.

### Schritt 4: Hersteller und Materialgruppen aufklappen

1. In der Ergebnisliste den gewünschten Hersteller suchen.
2. Den Aufklapp-Button am Hersteller betätigen.
3. Danach die passende Materialgruppe öffnen.
4. Nun die einzelnen Filamente lesen, markieren oder bearbeiten.

### Schritt 5: Herstellerdaten pflegen

1. In der Toolbar das Menü `Herstellerdaten` öffnen.
2. `Herstellerdaten bearbeiten` oder `Neuer Hersteller` wählen.
3. Namen, Slug, Kontakt- oder Profildaten ergänzen.
4. Falls vorhanden ein Brand-Logo als PNG hochladen.
5. Speichern.

### Schritt 6: Filamente einzeln bearbeiten

1. In der Filamentkarte auf `Bearbeiten` klicken.
2. Felder wie Farbe, Temperaturen, SKU, Profil oder Datenblatt-Link anpassen.
3. Die logischen Gruppen im Dialog nutzen:
   - Basisdaten
   - Druckdaten
   - Materialeigenschaften
   - Community-/Quellenstatus
4. Speichern.
5. Anschließend prüfen, ob die Änderung in der Karte sichtbar ist.

### Schritt 7: Mehrere Filamente gesammelt bearbeiten

1. Filamente in den Karten markieren.
2. In der Toolbar `Batch-Edit` oder die passende Sammelaktion wählen.
3. Nur die Felder ändern, die wirklich für alle markierten Datensätze gelten.
4. Speichern.
5. Ergebnis an mehreren Karten kontrollieren.

### Schritt 8: Einen neuen Hersteller anlegen

1. Das Menü `Herstellerdaten` öffnen.
2. `Neuer Hersteller` wählen.
3. Herstellername und Slug setzen.
4. Optional Karten- oder Kontaktdaten ergänzen.
5. Brand-Logo als PNG hochladen.
6. Falls nötig passende Leerspulenprofile anlegen.
7. Speichern.

### Schritt 9: Community-Share nutzen

1. `Filamente teilen` öffnen.
2. Links die gewünschten Hersteller auswählen.
3. Rechts die einzelnen User-Profile prüfen.
4. Vollständigkeit von Hersteller- und Profildaten kontrollieren.
5. Datenblatt-Link und Logo-Status prüfen.
6. Upload starten.
7. Fortschritt im Dialog beobachten.
8. Nach Abschluss Erfolgsmeldung und XP-Belohnung lesen.

## Beispiel-Eingaben

```text
Freitext: cailab petg transparent
Hersteller: Cailab
Material: PETG
SKU / EAN: CAI-PETG-TRBL-175
Sekundärfilter Material: PETG
Sekundärfilter Profil: Basic
```

## Typische Fehler oder Stolperstellen

- Nur die eingeklappte Freitextsuche wird benutzt, obwohl weitere Filter noch aktiv sind.
- Hersteller wird aufgeklappt, aber die Materialgruppe nicht geöffnet.
- Batch-Edit wird auf gemischte Datensätze angewendet, obwohl nicht alle Werte zusammenpassen.
- Community-Share wird mit Pack-Filamenten statt echten User-Filamenten erwartet.
- Herstellerdaten werden lokal geändert, aber vor dem Teilen nicht mehr geprüft.

## Screenshot-Pflicht

1. Gesamtansicht mit Filterbox, Toolbar und Herstellerliste
2. aufgeklappter Hersteller mit geöffneter Materialgruppe
3. Herstellerdaten- oder Community-Share-Dialog mit Beispielauswahl
