# CSV-Processor v2.0 - Benutzerhandbuch

## Inhaltsverzeichnis

1. [Überblick](#überblick)
2. [Installation](#installation)
3. [Programmversionen](#programmversionen)
4. [CLI-Version: Schritt-für-Schritt](#cli-version)
5. [GUI-Version: Schritt-für-Schritt](#gui-version)
6. [Voreinstellungen nutzen](#voreinstellungen-nutzen)
7. [Mapping-Dateien erstellen](#mapping-dateien-erstellen)
8. [Häufige Anwendungsfälle](#häufige-anwendungsfälle)
9. [Tipps & Tricks](#tipps--tricks)
10. [Fehlerbehebung](#fehlerbehebung)

---

## Überblick

Der CSV-Processor ist ein professionelles Werkzeug zur Verarbeitung und Konvertierung von CSV- und Excel-Dateien. Er ermöglicht:

✅ **Import** von CSV, Excel (XLSX/XLS)  
✅ **Export** als CSV, Excel (XLSX), OpenDocument (ODS)  
✅ **Spaltennamen-Mapping** (z.B. "btr" → "Betrag")  
✅ **Datenbereinigung** (leere Zeilen/Spalten entfernen)  
✅ **Spaltenauswahl** (nur gewünschte Spalten exportieren)  
✅ **Sortierung** nach beliebigen Spalten  
✅ **Voreinstellungen** für wiederkehrende Aufgaben  

---

## Installation

Das Programm wurde bereits auf Ihrem System installiert. Falls nicht, wenden Sie sich an die IT.

### Programme starten:

**CLI-Version (Terminal):**
```bash
csv-processor-cli
```

**GUI-Version (Grafisch):**
- Im Anwendungsmenü unter "Office" → "CSV-Processor"
- Oder im Terminal: `csv-processor-gui`

---

## Programmversionen

### CLI-Version (Terminal)
- **Für wen:** Fortgeschrittene Benutzer, Automatisierung
- **Vorteile:** Schnell, scriptfähig, volle Kontrolle
- **Start:** `csv-processor-cli`

### GUI-Version (Grafisch)
- **Für wen:** Alle Benutzer, besonders Einsteiger
- **Vorteile:** Intuitiv, visuelle Vorschau, einfache Bedienung
- **Start:** `csv-processor-gui` oder über Anwendungsmenü

**Empfehlung:** Für tägliche Arbeit die GUI-Version, für wiederkehrende Aufgaben mit Voreinstellungen beide geeignet.

---

## CLI-Version: Schritt-für-Schritt

### Programmstart

```bash
csv-processor-cli
```

Sie sehen das Hauptmenü:
```
╔═══════════════════════════════════════════════════════╗
║     CSV-PROCESSOR v2.0 - Dateiverarbeitung           ║
╚═══════════════════════════════════════════════════════╝

Verfügbare Features:
  Import: CSV, Excel (XLSX/XLS)
  Export: CSV, Excel (XLSX), OpenDocument (ODS)

══════════════════════════════════════════════════════════
 HAUPTMENÜ
══════════════════════════════════════════════════════════
  1. Neue Datei verarbeiten
  2. Voreinstellungen verwalten
  0. Beenden

Ihre Wahl:
```

### Erste Verwendung (ohne Voreinstellung)

#### Schritt 1: Datei verarbeiten wählen
```
Ihre Wahl: 1
```

#### Schritt 2: Keine Voreinstellung
```
Möchten Sie eine Voreinstellung laden? [j/n]: n
```

#### Schritt 3: Quelldatei angeben
```
Pfad zur Quelldatei (CSV/XLSX/XLS/ODS): /home/benutzer/Downloads/daten.csv
```

**Bei CSV:** Sie sehen eine interaktive Konfiguration:
```
══════════════════════════════════════════════════════════
 CSV-IMPORT KONFIGURATION
══════════════════════════════════════════════════════════

Datei: daten.csv
Erkanntes Encoding: utf-8
Erkannter Delimiter: Semikolon (;)
Erkanntes Quoting: MINIMAL

──────────────────────────────────────────────────────────
 VORSCHAU DER ERSTEN ZEILEN:
──────────────────────────────────────────────────────────

Zeile 1:
  Rohtext: Name;Betrag;Datum;Kategorie...
  Geparst: 4 Felder
    Feld 1: 'Name'
    Feld 2: 'Betrag'
    ...

──────────────────────────────────────────────────────────
 AKTUELLE EINSTELLUNGEN:
──────────────────────────────────────────────────────────
  1. Encoding: utf-8
  2. Delimiter: Semikolon (;)
  3. Quoting: MINIMAL

  0. ✓ Diese Einstellungen verwenden
──────────────────────────────────────────────────────────

Was möchten Sie ändern? [0-3]: 0
```

**Tipp:** Prüfen Sie die Vorschau! Wenn die Felder korrekt getrennt sind, drücken Sie `0`.

#### Schritt 4: Kopfzeile bestätigen
```
Hat die CSV-Datei eine Kopfzeile mit Spaltennamen? [j/n]: j
```

#### Schritt 5: Mapping anwenden (optional)
```
Möchten Sie Spaltennamen umbenennen? [j/n]: j
Pfad zur Mapping-JSON-Datei: /usr/share/csv-processor/mietermerkmale.json
✓ 5 Spaltennamen umbenannt
```

#### Schritt 6: Leere Zeilen
```
Sollen komplett leere Zeilen entfernt werden? [j/n]: j
✓ 3 leere Zeilen entfernt
```

#### Schritt 7: Unvollständige Zeilen (optional)
```
Möchten Sie Zeilen mit zu wenig Informationen analysieren/entfernen? [j/n]: n
```

#### Schritt 8: Leere Spalten
```
Sollen leere Spalten entfernt werden? [j/n]: j
✓ 2 leere Spalten entfernt
```

**Wichtig:** Leere Spalten werden VOR der Spaltenauswahl entfernt!

#### Schritt 9: Spaltenauswahl

Sie sehen eine Liste aller verfügbaren (nicht-leeren) Spalten:

```
══════════════════════════════════════════════════════════
 SPALTENAUSWAHL
══════════════════════════════════════════════════════════
● = Angewählt  |  ○ = Abgewählt
──────────────────────────────────────────────────────────
  ● 1. btr → Betrag
  ● 2. dat → Datum
  ● 3. kto → Kontonummer
  ● 4. empf → Empfänger
  ● 5. verw → Verwendungszweck
──────────────────────────────────────────────────────────
Aktuell ausgewählt: 5 von 5 Spalten
══════════════════════════════════════════════════════════

Optionen:
  [Nummern] - Spalten an/abwählen (z.B. '1,2,3' oder '1-5,10-15')
  + [Nummern] - Spalten ANwählen (z.B. '+1,2,3')
  - [Nummern] - Spalten ABwählen (z.B. '-1,2,3')
  alle - Alle Spalten anwählen
  keine - Alle Spalten abwählen
  q - Auswahl beenden und fortfahren

Ihre Wahl:
```

**Beispiele:**
- `3` - Spalte 3 umschalten (an→ab oder ab→an)
- `-3,5` - Spalten 3 und 5 ABwählen (rot)
- `+1-10` - Spalten 1 bis 10 ANwählen (grün)
- `1-5,10-15` - Spalten 1-5 und 10-15 umschalten
- `q` - Fertig

```
Ihre Wahl: -3
✓ 1 Spalte(n) abgewählt

Ihre Wahl: q
```

#### Schritt 10: Kopf-/Fußzeile (optional)
```
Möchten Sie eine Kopf- oder Fußzeile hinzufügen? [j/n]: j
Kopfzeile (Enter für keine): Export vom 19.10.2025
Fußzeile (Enter für keine): Erstellt mit CSV-Processor
```

#### Schritt 11: Sortierung (optional)
```
Möchten Sie die Daten sortieren? [j/n]: j

Verfügbare Spalten zum Sortieren:
  1. Betrag
  2. Datum
  3. Empfänger
  4. Verwendungszweck

Nummer der Spalte: 2

Datentyp für Sortierung:
  1. Text (string)
  2. Datum
  3. Zeit
  4. Dezimalzahl

Ihre Wahl [1-4]: 2
✓ Daten nach 'Datum' sortiert
```

#### Schritt 12: Ausgabeformat wählen
```
Verfügbare Ausgabeformate:
  1. CSV
  2. Excel (XLSX)
  3. OpenDocument (ODS)

Ihre Wahl: 1
```

**Bei CSV-Export:**
```
CSV-EXPORT KONFIGURATION

Delimiter wählen:
  1. Semikolon (;) - Standard für deutsche Excel-Versionen
  2. Komma (,) - Internationaler Standard
  3. Tab - Gut für Import in andere Programme

Ihre Wahl [1-3]: 1

Quoting (Anführungszeichen) wählen:
  1. MINIMAL - Nur Felder mit Sonderzeichen (empfohlen)
  2. ALLE - Alle Felder in Anführungszeichen
  3. NICHT_NUMERISCH - Nur Text-Felder
  4. KEINE - Keine Anführungszeichen

Ihre Wahl [1-4]: 1
```

#### Schritt 13: Zieldatei speichern
```
Name/Pfad der Zieldatei (ohne Endung): ausgabe
✓ CSV-Datei erfolgreich gespeichert: ausgabe.csv
```

#### Schritt 14: Als Voreinstellung speichern
```
Möchten Sie diese Einstellungen als Voreinstellung speichern? [j/n]: j
Name für die Voreinstellung: meine_standard_export
✓ Voreinstellung 'meine_standard_export' gespeichert.
```

**Fertig!** Sie sind zurück im Hauptmenü.

### Mit Voreinstellung arbeiten

Beim nächsten Mal:

```
Ihre Wahl: 1

Verfügbare Voreinstellungen:
  1. meine_standard_export
  2. mietermerkmale

Möchten Sie eine Voreinstellung laden? [j/n]: j
Nummer oder Name der Voreinstellung: 1
✓ Voreinstellung 'meine_standard_export' geladen.
```

Dann nur noch:
1. Quelldatei angeben
2. Zieldatei angeben
3. **Fertig!**

Alle anderen Schritte werden automatisch durchgeführt! 🚀

---

## GUI-Version: Schritt-für-Schritt

### Programmstart

```bash
csv-processor-gui
```

Oder über das Anwendungsmenü: **Office** → **CSV-Processor**

### Hauptfenster

![GUI Overview](diagram)

```
┌─────────────────────────────────────────────────────────┐
│ Datei  Voreinstellungen  Hilfe                          │
├─────────────────────────────────────────────────────────┤
│ ┌─ Quelldatei ────────────────────────────────────────┐ │
│ │ Datei: [________________] [Durchsuchen] [Laden]    │ │
│ └─────────────────────────────────────────────────────┘ │
│                                                          │
│ ┌─ Verarbeitungseinstellungen ─────────────────────────┐│
│ │ ☑ Datei hat Kopfzeile                               ││
│ │ ☑ Leere Zeilen entfernen                            ││
│ │ ☑ Leere Spalten entfernen (vor Spaltenauswahl)     ││
│ │ Mapping-Datei: [________________] [...]             ││
│ │ Ausgabeformat: ⦿ CSV  ○ Excel  ○ ODS               ││
│ └─────────────────────────────────────────────────────┘│
│                                                          │
│ ┌─ Spaltenauswahl ─────────────────────────────────────┐│
│ │ [Alle auswählen] [Alle abwählen] [Auswahl umkehren] ││
│ │ ┌──────────────────────────────────────────────────┐││
│ │ │ ☑ btr → Betrag                                   │││
│ │ │ ☑ dat → Datum                                    │││
│ │ │ ☑ empf → Empfänger                               │││
│ │ │ ☐ alte_spalte (nicht gemappt)                    │││
│ │ └──────────────────────────────────────────────────┘││
│ └─────────────────────────────────────────────────────┘│
│                                                          │
│ ┌─ Status ──────────────────────────────────────────────┐│
│ │ 12:34:56 - Datei geladen: 5 Spalten, 100 Zeilen    ││
│ │ 12:34:57 - Leere Spalten entfernt: 2                ││
│ └─────────────────────────────────────────────────────┘│
│                                                          │
│              [Vorschau]  [Verarbeiten & Speichern]      │
└─────────────────────────────────────────────────────────┘
```

### Schritt-für-Schritt Anleitung

#### 1. Datei laden

**Option A: Durchsuchen**
1. Klick auf **[Durchsuchen]**
2. Datei auswählen (CSV oder Excel)
3. **[Öffnen]** klicken

**Option B: Pfad eingeben**
1. Pfad ins Feld eingeben: `/home/benutzer/Downloads/daten.csv`
2. **[Laden]** klicken

**Ergebnis:**
```
Status:
12:34:56 - Lade Datei: daten.csv
12:34:56 - Erfolgreich geladen: 8 Spalten, 234 Zeilen
```

#### 2. Einstellungen prüfen

Alle wichtigen Einstellungen sind als Checkboxen verfügbar:

- **☑ Datei hat Kopfzeile** - Fast immer aktiviert
- **☑ Leere Zeilen entfernen** - Empfohlen
- **☑ Leere Spalten entfernen** - Empfohlen (passiert vor Spaltenauswahl!)

#### 3. Mapping-Datei wählen (optional)

1. Klick auf **[...]** neben "Mapping-Datei"
2. Datei auswählen (z.B. `mietermerkmale.json`)
3. **[Öffnen]**
4. Datei neu laden mit **[Laden]**

**Ergebnis:** Spaltennamen werden umbenannt, z.B.:
- `btr → Betrag`
- `dat → Datum`

#### 4. Spalten auswählen

Im Bereich "Spaltenauswahl" sehen Sie alle verfügbaren Spalten.

**Alle Spalten sind standardmäßig ausgewählt (☑).**

**Spalten abwählen:**
- Klick auf Spalte → wird abgewählt (☐)
- Klick nochmal → wird wieder ausgewählt (☑)

**Schnellaktionen:**
- **[Alle auswählen]** - Alle Spalten auf ☑
- **[Alle abwählen]** - Alle Spalten auf ☐
- **[Auswahl umkehren]** - ☑↔☐

**Mehrfachauswahl:**
- **Strg + Klick** - Mehrere Spalten einzeln auswählen
- **Shift + Klick** - Bereich auswählen

**Wichtig:** Nur grüne Spalten (☑) werden exportiert. Zusätzlich werden leere Spalten automatisch übersprungen!

#### 5. Vorschau (optional)

Klick auf **[Vorschau]** um die verarbeiteten Daten zu sehen:

```
┌─ Datenvorschau ──────────────────────────────────────┐
│ Betrag    │ Datum      │ Empfänger    │ Verwendung  │
├───────────┼────────────┼──────────────┼─────────────┤
│ 150.50    │ 01.10.2025 │ Müller GmbH  │ Miete       │
│ 75.00     │ 03.10.2025 │ Stadtwerke   │ Strom       │
│ ...       │ ...        │ ...          │ ...         │
└──────────────────────────────────────────────────────┘
Zeige erste 100 von 234 Zeilen
                                              [Schließen]
```

#### 6. Verarbeiten & Speichern

Klick auf **[Verarbeiten & Speichern]**

1. Dateiname eingeben: `ausgabe`
2. Speicherort wählen
3. **[Speichern]**

**Status-Meldungen:**
```
12:45:10 - Leere Zeilen entfernt: 3
12:45:10 - Leere Spalten entfernt: 2
12:45:10 -   - alte_spalte1 (leer)
12:45:10 -   - temp_field (leer)
12:45:11 - Übersprungene Spalten (leer): 1
12:45:11 - Abgewählte Spalten (rot): 2
12:45:11 - Finale Verarbeitung: 5 Spalten, 231 Zeilen
12:45:12 - Datei gespeichert: ausgabe.csv
```

**Erfolgsmeldung:**
```
┌─ Erfolg ─────────────────────────────────┐
│                                           │
│  Datei erfolgreich gespeichert:          │
│  /home/benutzer/Documents/ausgabe.csv    │
│                                           │
│                          [OK]             │
└───────────────────────────────────────────┘
```

#### 7. Voreinstellung speichern

**Menü** → **Voreinstellungen** → **Speichern**

```
┌─ Voreinstellung speichern ──────────────┐
│ Name der Voreinstellung:                │
│ [meine_export_einstellung_________]     │
│                                          │
│                  [OK]      [Abbrechen]  │
└──────────────────────────────────────────┘
```

Name eingeben → **[OK]**

```
Status:
12:50:00 - Voreinstellung gespeichert: meine_export_einstellung
```

### Voreinstellung laden

**Menü** → **Voreinstellungen** → **Laden**

```
┌─ Voreinstellung laden ──────────────────┐
│ Voreinstellung auswählen:               │
│ ┌─────────────────────────────────────┐ │
│ │ meine_export_einstellung            │ │
│ │ mietermerkmale                      │ │
│ │                                     │ │
│ └─────────────────────────────────────┘ │
│                  [OK]      [Abbrechen]  │
└──────────────────────────────────────────┘
```

Voreinstellung auswählen → **[OK]**

**Alle Einstellungen werden automatisch geladen!**

---

## Voreinstellungen nutzen

### Was wird gespeichert?

Eine Voreinstellung enthält:
- ☑ Kopfzeile ja/nein
- ☑ Leere Zeilen entfernen
- ☑ Leere Spalten entfernen
- 📄 Pfad zur Mapping-Datei
- 📊 Spaltenauswahl
- 💾 Ausgabeformat (CSV/Excel/ODS)
- 🔧 CSV-Export-Einstellungen (Delimiter, Quoting)
- 📏 Sortierung (Spalte & Datentyp)

### Wann sind Voreinstellungen sinnvoll?

✅ **Monatliche Berichte** - Immer gleiche Verarbeitung  
✅ **Standard-Exporte** - Wiederkehrende Aufgaben  
✅ **Team-Workflows** - Einheitliche Formate  
✅ **Verschiedene Datenquellen** - Unterschiedliche Mappings  

### Voreinstellung bearbeiten (nur CLI)

**Hauptmenü** → **2** (Voreinstellungen verwalten)

```
╔═══════════════════════════════════════════════════════╗
║          VOREINSTELLUNGEN VERWALTEN                   ║
╚═══════════════════════════════════════════════════════╝

Verfügbare Voreinstellungen:
  1. meine_export_einstellung
  2. mietermerkmale

Optionen:
  1. Voreinstellung bearbeiten
  2. Voreinstellung löschen
  0. Zurück zum Hauptmenü

Ihre Wahl: 1
```

**Voreinstellung bearbeiten:**
1. Voreinstellung auswählen
2. Alle Schritte durchgehen (mit aktuellen Werten vorausgefüllt)
3. Bei Schritt 6 (Spaltenauswahl): Beispieldatei laden
4. Spalten wie gewohnt aus-/abwählen
5. Am Ende: Überschreiben oder neu speichern

---

## Mapping-Dateien erstellen

### Was ist ein Mapping?

Ein Mapping übersetzt technische Spaltennamen in lesbare Namen:

```
"btr"   → "Betrag"
"dat"   → "Datum"
"empf"  → "Empfänger"
```

### Format

Mapping-Dateien sind JSON-Dateien:

```json
{
  "btr": "Betrag",
  "dat": "Datum",
  "kto": "Kontonummer",
  "blz": "Bankleitzahl",
  "empf": "Empfänger",
  "verw": "Verwendungszweck"
}
```

### Eigenes Mapping erstellen

1. Texteditor öffnen (z.B. `nano`, `gedit`)
2. JSON-Format verwenden (siehe oben)
3. Als `.json` speichern (z.B. `mein_mapping.json`)

**Beispiel:**
```bash
nano ~/Dokumente/bank_mapping.json
```

Inhalt:
```json
{
  "alt1": "Neuer Name 1",
  "alt2": "Neuer Name 2",
  "xyz": "Beschreibung XYZ"
}
```

Speichern: **Strg+O**, **Enter**, **Strg+X**

### Mitgeliefertes Mapping

Das System enthält bereits: `/usr/share/csv-processor/mietermerkmale.json`

Dieses können Sie als Vorlage verwenden oder direkt nutzen.

---

## Häufige Anwendungsfälle

### 1. Monatlicher Export aus Buchhaltung

**Situation:** Jeden Monat CSV-Export aus Buchhaltungssoftware → Excel-Datei für Chef

**Lösung:**
1. **Einmalig:** Voreinstellung "Buchhaltung_Export" erstellen
   - Mapping: Spaltennamen übersetzen
   - Spalten: Nur relevante auswählen
   - Format: Excel
   - Sortierung: Nach Datum
   
2. **Jeden Monat:**
   - Programm starten
   - Voreinstellung laden
   - Neue CSV-Datei angeben
   - Ausgabename: `Bericht_Oktober_2025.xlsx`
   - **Fertig in 30 Sekunden!**

### 2. Daten für verschiedene Abteilungen

**Situation:** Gleiche Quelldaten, aber unterschiedliche Spalten für verschiedene Teams

**Lösung:**
- Voreinstellung "Export_Vertrieb" - Nur Vertriebsspalten
- Voreinstellung "Export_Buchhaltung" - Nur Finanzspalten
- Voreinstellung "Export_Geschäftsführung" - Übersicht

### 3. Excel zu CSV konvertieren

**Situation:** Excel-Datei von Kunde → Eigenes System braucht CSV

**Lösung (GUI):**
1. Excel-Datei laden
2. Alle Einstellungen auf Standard lassen
3. Ausgabeformat: CSV
4. Delimiter: Semikolon
5. Speichern

### 4. CSV bereinigen

**Situation:** CSV-Datei mit vielen leeren Zeilen/Spalten

**Lösung:**
1. Datei laden
2. ☑ Leere Zeilen entfernen
3. ☑ Leere Spalten entfernen
4. Alle Spalten ausgewählt lassen
5. Speichern

### 5. Spaltennamen vereinheitlichen

**Situation:** Verschiedene Systeme, unterschiedliche Spaltennamen, sollen gleich sein

**Lösung:**
1. Mapping-Datei erstellen mit allen Varianten:
```json
{
  "btr": "Betrag",
  "betrag": "Betrag",
  "amount": "Betrag",
  "sum": "Betrag"
}
```
2. Voreinstellung mit diesem Mapping
3. Auf alle Dateien anwenden

---

## Tipps & Tricks

### Performance

**Große Dateien (>10.000 Zeilen):**
- Verarbeitung kann 5-30 Sekunden dauern
- Bei Excel: Erstes Tabellenblatt ist schneller
- GUI: Status-Log beobachten

**Sehr große Dateien (>100.000 Zeilen):**
- CLI-Version ist etwas schneller
- Leere Spalten vorher entfernen spart Zeit
- Ggf. Datei vorher splitten

### Spaltenauswahl

**Trick: Schnell viele Spalten abwählen (CLI):**
```
Ihre Wahl: -10-50
```
Wählt Spalten 10 bis 50 ab (rot)

**Trick: Nur wenige Spalten behalten (GUI):**
1. **[Alle abwählen]**
2. **Strg+Klick** auf gewünschte Spalten

### Mappings

**Tipp:** Verwenden Sie sprechende Ziel-Namen:
- ✅ "Betrag in Euro"
- ✅ "Datum (Format: TT.MM.JJJJ)"
- ❌ "btr_eur"

**Tipp:** Ein Mapping pro Datenquelle:
- `system_a_mapping.json`
- `system_b_mapping.json`
- `kunde_xy_mapping.json`

### CSV-Export

**Für Excel (deutsche Version):**
- Delimiter: Semikolon
- Quoting: Minimal

**Für andere Software:**
- Delimiter: Komma oder Tab
- Quoting: Alle (sicherer)

**Für Datenbanken:**
- Delimiter: Tab
- Quoting: Minimal
- Keine Kopf-/Fußzeile

### Voreinstellungen

**Namenskonvention:**
```
[Zweck]_[Format]_[Besonderheit]
```

Beispiele:
- `Mietermerkmale_Excel_monatlich`
- `Buchhaltung_CSV_Vertrieb`
- `Datenbank_Import_Tab`

### Datensicherheit

✅ **Original-Dateien bleiben unverändert**  
✅ **Keine Daten werden ins Internet gesendet**  
✅ **Voreinstellungen enthalten keine Daten, nur Konfiguration**  

---

## Fehlerbehebung

### "Datei nicht gefunden"

**Problem:** Pfad falsch oder Datei existiert nicht

**Lösung:**
- Pfad nochmal prüfen
- In GUI: **[Durchsuchen]** verwenden
- Tippfehler korrigieren
- Bei Netzlaufwerken: Verbindung prüfen

### "Fehler beim Lesen der CSV"

**Problem:** Encoding oder Format nicht erkannt

**Lösung (CLI):**
- Im Import-Dialog verschiedene Encodings probieren
- Delimiter manuell wählen

**Lösung (GUI):**
- Datei in Excel öffnen
- Als CSV mit UTF-8 speichern
- Erneut laden

### "Keine Spalten ausgewählt"

**Problem:** Alle Spalten abgewählt oder alle leer

**Lösung:**
- Prüfen ob Spalten grün (☑) sind
- Ggf. "Leere Spalten entfernen" deaktivieren
- Quelldatei prüfen: Enthält sie Daten?

### "Excel-Support nicht verfügbar"

**Problem:** Bibliothek `openpyxl` fehlt

**Lösung:**
```bash
pip3 install openpyxl
```

Oder IT kontaktieren.

### "Programm reagiert nicht" (GUI)

**Problem:** Große Datei wird verarbeitet

**Lösung:**
- Warten (Status-Log beobachten)
- Bei >100.000 Zeilen: 1-2 Minuten normal
- Ggf. CLI-Version verwenden

### Voreinstellung lädt nicht alle Spalten

**Grund:** Gespeicherte Spalten sind in aktueller Datei leer oder nicht vorhanden

**Das ist normal!** Das Programm überspringt automatisch:
1. Leere Spalten (wenn "Leere Spalten entfernen" aktiv)
2. Nicht vorhandene Spalten

**Status-Meldung beachten:**
```
Übersprungene Spalten (leer oder nicht vorhanden): 3
  - alte_spalte1
  - leere_spalte2
  - nicht_vorhanden
```

---

## Support

Bei Problemen oder Fragen:

1. **Diese Anleitung durchlesen** 📖
2. **Status-/Log-Meldungen beachten** 📋
3. **IT-Abteilung kontaktieren** 💻

---

## Schnellreferenz

### CLI-Befehle

| Aktion | Befehl |
|--------|--------|
| Programm starten | `csv-processor-cli` |
| Datei verarbeiten | Hauptmenü → `1` |
| Voreinstellungen | Hauptmenü → `2` |
| Beenden | Hauptmenü → `0` oder `Strg+C` |

### GUI-Shortcuts

| Aktion | Shortcut |
|--------|----------|
| Programm starten | `csv-processor-gui` |
| Datei öffnen | **Strg+O** |
| Speichern | **Strg+S** |
| Voreinstellung laden | **Strg+L** |

### Spaltenauswahl (CLI)

| Eingabe | Bedeutung |
|---------|-----------|
| `q` | Fertig |
| `alle` | Alle auswählen |
| `keine` | Alle abwählen |
| `3` | Spalte 3 umschalten |
| `1,2,3` | Spalten 1,2,3 umschalten |
| `+5` | Spalte 5 ANwählen |
| `-5` | Spalte 5 ABwählen |
| `1-10` | Spalten 1-10 umschalten |
| `+1-10` | Spalten 1-10 ANwählen |
| `-1-10` | Spalten 1-10 ABwählen |

---

**Version:** 2.0  
**Stand:** Oktober 2025  
**Erstellt für:** Interne Nutzung