# Semesterapparat anlegen

Um einen neuen Semesterapparat anzulegen, muss zuerst der Knopf **neu. App anlegen** gedrückt werden. Das Feld der Apparatdetails wird nun zum Bearbeiten entsperrt.

![Anlegen](../images/main_apparatdetails.png){ loading=lazy }

---

## Apparatdetails

### Pflichtfelder

Um einen Apparat erfolgreich anzulegen, müssen alle Felder mit einem **Sternchen (*)** ausgefüllt werden. Ist eine Eingabe nicht valide, wird neben der Eingabe ein :material-close-circle:{ style="color: red" } angezeigt.

!!! warning "Formatierungsanforderungen"
    Folgende Felder haben spezielle Formatierungsanforderungen:

| Feld | Format | Beispiel |
|------|--------|----------|
| **Prof. Name** | Nachname, Vorname | `Müller, Hans` |
| **Mail** | Gültige E-Mail-Adresse | `mueller@ph-freiburg.de` |
| **Tel** | Mindestens 3 Ziffern | `0761-12345` |
| **Semester** | Automatisch berechnet | siehe unten |

### Semester-Logik

Das Semester wird automatisch wie folgt berechnet:

=== "Wintersemester"

    - Checkbox **Winter** aktivieren
    - **Jahr**: 
        - Oktober–Dezember → aktuelles Jahr
        - Januar–September → aktuelles Jahr - 1

=== "Sommersemester"

    - Checkbox **Sommer** aktivieren
    - **Jahr**: aktuelles Jahr (März–August)

### Fehlermeldungen

Beim Versuch, den Apparat zu speichern, bevor alle Felder korrekt ausgefüllt sind, erscheint eine Fehlermeldung:

![Fehler](../images/main_apparatdetails_error.png){ loading=lazy }

!!! tip "Tipp"
    Über **Ok** oder **Cancel** wird die Meldung geschlossen und der Apparat kann weiter bearbeitet werden.

---

## Dokumente hinzufügen

Dem Apparat können Dokumente hinzugefügt werden. Besonders hilfreich ist das Hinzufügen der **Antragsformulare**, da der SemesterapparatsManager diese automatisch auslesen kann.

```mermaid
graph LR
    A[Dokument hinzufügen] --> B{Nächste Aktion}
    B -->|"Daten [...] übernehmen"| C[Medien aus Dokument hinzufügen]
    B -->|Nein| D[Als Referenz speichern]
    C --> E[Medien werden automatisch erkannt]

```

1. Klicken Sie auf **Dokumente hinzufügen**
2. Wählen Sie die gewünschte(n) Datei(en) aus
3. Bei Antragsformularen: Klicken Sie auf **Medien aus Dokument hinzufügen**

!!! warning "Wichtig: Automatisches Speichern"
    Beim Klicken auf **Medien aus Dokument hinzufügen** wird der Apparat automatisch gespeichert. Dies ist erforderlich, da Medien nur einem existierenden Apparat hinzugefügt werden können.

---

## Medienliste

![Optionen der Medienliste](../images/medialist_options.png){ loading=lazy }

In der Medienliste werden alle dem Apparat zugeordneten Medien angezeigt.

### Optionen

| Option | Beschreibung |
|--------|--------------|
| :lucide-eye: **gel. Medien anzeigen** | Zeigt auch gelöschte Medien an |
| :lucide-check-circle: **im Apparat?** | Prüft, ob ausgewählte Medien dem Apparat hinzugefügt wurden |
| :lucide-plus: **Medien hinzufügen** | Manuelle Eingabe von Signaturen |

### Kontextmenü

Mit einem **Rechtsklick** auf ein Medium öffnet sich das Kontextmenü:

![Kontextmenü](../images/media_context_menu_root.png){ loading=lazy }

=== "Allgemeines"

    ![Kontextmenü Allgemeines](../images/media_context_menu_general.png){ loading=lazy }

    - **Bearbeiten**: Metadaten einsehen/bearbeiten
    - **Löschen**: Medium aus dem Apparat entfernen (nicht physisch löschen)

=== "Apparate"

    ![Kontextmenü Apparate](../images/media_context_menu_apparats.png){ loading=lazy }

    - **Zum Apparat hinzufügen**: *(derzeit deaktiviert)*
    - **In Apparat verschieben**: Medium in anderen Apparat verschieben
    - **In Apparat kopieren**: Medium in anderen Apparat kopieren

!!! tip "Mehrfachauswahl"
    Mit ++ctrl+left-button++ können mehrere Medien ausgewählt werden.

---

## Medien manuell hinzufügen

![Medien hinzufügen](../images/add_media.png){ loading=lazy }

### Eingabe

Geben Sie jede Signatur in eine neue Zeile ein und bestätigen Sie mit ++enter++.

### Optionen

| Option | Beschreibung |
|--------|--------------|
| **Modus** | Wählt die Metadatenquelle |
| **Jedes Buch verwenden** | Erlaubt das Hinzufügen von Medien, die noch nicht im Apparat sind |
| **Exakte Signatur** | Nur diese spezifische Signatur verwenden (kein alternatives Exemplar) |

!!! info "Signatursuche"
    Ohne **Exakte Signatur** wird nach der ähnlichsten Signatur gesucht – das gefundene Buch ist dasselbe, aber möglicherweise ein anderes Exemplar.

---

## Apparat speichern

Nach dem Ausfüllen aller Pflichtfelder:

1. Klicken Sie auf **Speichern**
2. Der Apparat wird in der Datenbank gespeichert
3. Optional: Bei aktiviertem **Mail senden** öffnet sich der Mail-Dialog

!!! note "E-Mail-Versand"
    Der E-Mail-Versand erfordert konfigurierte [Mail-Zugangsdaten](../allgemein/hauptoberflaeche.md#e-mail).
