# Mail2Fax für STARFACE

Custom Block für den STARFACE Module Designer - E-Mails abrufen und PDF-Anhänge als Fax versenden.

## Quick Start

### Option 1: Fertig-Modul verwenden (Empfohlen für Endbenutzer)

Wenn du das fertige Modul (`fax2Mail_v54.sfm`) verwenden möchtest:

```bash
# 1. JavaMail auf STARFACE installieren
./install-javamail.sh <starface-ip>

# 2. STARFACE neustarten
ssh root@<starface-ip> 'systemctl restart tomcat'

# 3. Modul importieren
# STARFACE Admin → Module → Module Designer → "Modul importieren"
# Datei auswählen: fax2Mail_v54.sfm
```

**Fertig!** Weiter mit der [Konfiguration](v8-9-10/INSTALLATION.md#teil-2-modul-konfiguration).

### Option 2: Selbst kompilieren (für Entwickler)

Wenn du den Code ändern möchtest:

```bash
# 1. Java 21 installieren (falls nötig)
./install-java21.sh

# 2. STARFACE APIs holen (inkl. JavaMail-Installation)
./fetch-starface-libs.sh <starface-ip>

# 3. Block kompilieren
cd v8-9-10
./build-block.sh
```

## Projektstruktur

```
mail2fax/
├── fax2Mail_v54.sfm         # Fertig-Modul (zum Importieren)
├── install-javamail.sh      # Installiert NUR JavaMail (für Fertig-Modul)
├── fetch-starface-libs.sh   # Holt STARFACE APIs + JavaMail (für Entwickler)
├── install-java21.sh        # Installiert Java 21 (für Entwickler)
├── README.md
└── v8-9-10/                 # Für STARFACE 8/9/10
    ├── Mail2FaxBlock.java   # Custom Block Quellcode
    ├── Mail2FaxCleanup.java # Cleanup Block
    ├── build-block.sh       # Kompilier-Script
    ├── libs/starface/       # STARFACE JARs (nach fetch)
    ├── README.md            # Technische Dokumentation
    ├── INSTALLATION.md      # Schritt-für-Schritt Handbuch
    └── docu/                # Screenshots
```

## Funktionsweise

1. Block ruft E-Mails per IMAP/POP3 ab
2. Ziel-Faxnummer wird aus dem Betreff gelesen
3. PDF-Anhänge werden als Fax gesendet
4. E-Mails werden als gelesen markiert oder gelöscht

## Installation

Siehe [v8-9-10/README.md](v8-9-10/README.md) für die Anleitung zur Integration im Module Designer.