# FCM App-Portal – Anleitung für neue Nutzerinnen und Nutzer

Willkommen beim **FCM App-Portal** von FC Münsterlingen. Diese Seite erklärt den **Zugang**, die **Freigabe durch den Verein** und die **Module**, die ihr nach der Einrichtung nutzen könnt.

**Öffentliche Webversion (ohne Login):** [anleitung.html](anleitung.html) – verlinkt auch vom Login, von der Registrierung und vom Portal-Fusszeile.

---

## Was ist das Portal?

Das Portal ist die **zentrale Einstiegsseite** nach dem Login. Von dort öffnet ihr die einzelnen **Anwendungen als Karten** (zum Beispiel Visumportal oder Spesenmeldung). Ob eine Karte sichtbar ist, hängt von eurer **Rolle** und den dafür freigeschalteten **Modulen** ab (siehe unten).

---

## Welche Module gibt es? (Überblick)

| Modul | Kurzbeschreibung |
|--------|------------------|
| **Visumportal** | Belege bzw. einzelne Positionen prüfen, visieren oder mit Begründung ablehnen. **Vorgesehen für Bereichsleiterinnen und visumsberechtigte Personen** (technisch über Rollen und Module freigeschaltet). |
| **Spesenmeldung** | Spesenbelege einreichen, IBAN hinterlegen und den Status eurer Meldungen einsehen. **Grundsätzlich für alle Portal-Nutzerinnen und -Nutzer** vorgesehen. |
| **Mannschaftskonten** | Saldo und Abrechnungen der Mannschaftskasse(n), die eurer Rolle zugeordnet sind. **Vorgesehen für Trainerinnen und Trainer von Aktivmannschaften sowie von C- bis A-Junioren** (technisch über Rollen und Module freigeschaltet). |
| **Profil** | Erreichbar über den Benutzerbereich im Portal: E-Mail, IBAN, Passwort. |

**Zusätzlich (nur für ausgewiesene Administratorinnen und Administratoren):** Im Portal können für die Rolle **Admin** die Karten **Kreditoren-Tool** und **System-Verwaltung** erscheinen. Deren Funktionen sind hier **nicht** beschrieben; sie dienen Buchhaltung und technischer Verwaltung.

---

## Warum sehe ich nicht alle Karten?

- Pro Person werden im Verein **eine oder mehrere Rollen** vergeben (zum Beispiel für eine Funktion oder eine Mannschaft).
- Pro Rolle legt der Administrator fest, **welche Portal-Module** freigeschaltet sind (Zuordnung Rolle → Modul).
- **Alle Module**, die über eure Rollen freigegeben sind, werden zusammengeführt: Ihr seht nur die Karten, die ihr für eure Aufgabe braucht.

**Ohne eine einzige Rolle** zeigt das Portal einen Hinweis, dass die Freischaltung durch den Admin noch aussteht. **Kontaktiert in diesem Fall den Verein**, damit euch die passenden Rollen und Module zugewiesen werden.

**Vereinspolitik beim FC Münsterlingen (Orientierung):** Das **Spesen-Tool** ist für **alle** mit Portalzugang gedacht. Das **Visumportal** ist für **Bereichsleiterinnen und visumsberechtigte Personen** vorgesehen. **Mannschaftskonten** sind für **Trainerinnen und Trainer von Aktivmannschaften** sowie **Trainerinnen und Trainer von C- bis A-Junioren** vorgesehen. Abweichungen nur in begründeten Ausnahmen und über den Administrator.

---

## Ablauf: Registrierung → Freigabe → Nutzung → E-Mails

```mermaid
flowchart LR
  subgraph reg [Registrierung]
    A[Formular ausfüllen]
    B[Konto anlegen]
  end
  subgraph info [Benachrichtigung]
    C[Admin wird informiert]
  end
  subgraph adm [Freigabe]
    D[Rollen zuweisen]
    E[Module pro Rolle]
  end
  subgraph use [Nutzung]
    F[Portal-Karten sichtbar]
  end
  subgraph mail [E-Mail optional]
    G[Freigabe-Mail bei erster Rolle]
  end
  A --> B --> C --> D --> E --> F
  D --> G
```

1. **Registrierung**  
   Über die Seite zum Registrieren gebt ihr Name, E-Mail und Passwort ein. Nach erfolgreicher Anmeldung im System legt das Portal euren Datensatz an. Ihr erhaltet einen Hinweis, **auf die Freigabe durch den Admin** zu warten.

2. **Information an den Administrator**  
   Bei einer neuen Selbstregistrierung wird ein Ereignis ausgelöst, mit dem der Verein **informiert werden kann** (neue Registrierung). Technische Ausfälle bei dieser Benachrichtigung ändern nichts an der Registrierung selbst; der Verein kann euch trotzdem manuell freischalten.

3. **Freigabe durch den Admin**  
   Der Administrator **weist euch Rollen zu** (zum Beispiel im Benutzerbereich der System-Verwaltung). Erst wenn mindestens **eine Rolle** gesetzt ist, können die zugehörigen Portal-Karten erscheinen.

4. **Welche Karten erscheinen?**  
   Zusätzlich stellt der Verein pro Rolle ein, **welche Module** (Visumportal, Spesen, Mannschaftskonten, …) aktiv sind. Ohne Modul-Zuordnung zu euren Rollen bleiben auch nach Rollenzuweisung **keine** fachlichen Karten sichtbar (ausser ihr seid Admin mit den zusätzlichen Admin-Karten).

5. **E-Mail bei der ersten Rolle**  
   Sobald euch die **erste Rolle** zugewiesen wird, kann das System eine **Freigabe- bzw. Benachrichtigungs-E-Mail** auslösen (abhängig von der Konfiguration des Vereins). Wenn keine Mail ankommt, reicht die Freischaltung im Portal trotzdem; bei Unklarheiten den Admin fragen.

**Hinweis:** Je nach Einstellung des Zugangssystems kann zusätzlich eine **Bestätigungs-E-Mail** nötig sein, bevor ihr euch das erste Mal anmelden könnt. Das ist eine Vorgabe der Login-Infrastruktur, nicht des Portals selbst.

---

## Login und Sitzung

- **Start:** Öffnet die Login-Seite des Portals.
- **Anmeldung mit E-Mail und Passwort** oder **Login per Magic Link** (Link wird an eure E-Mail gesendet).
- **Passwort vergessen:** Auf der Login-Seite könnt ihr einen Link zum Zurücksetzen anfordern.
- **Abmelden:** Im Portal über den Bereich mit eurem Namen (**Logout**).

Nach erfolgreichem Login werdet ihr in der Regel zum **Portal** weitergeleitet.

---

## Visumportal

Das Modul ist **für Bereichsleiterinnen und visumsberechtigte Personen** gedacht; im System wird der Zugriff über eure **Rollen** und die zugeordneten **Module** geregelt.

- **Aufgaben:** Ihr seht die euch zugewiesenen **Positionen** (Belege zur Prüfung). Pro Position könnt ihr **visieren** oder **ablehnen** (Ablehnung mit Begründung). Es gibt eine Funktion, um **alle offenen Positionen eines Belegs** in einem Schritt zu visieren, wenn alles passt.
- **Beleg:** Vorschau und Öffnen im neuen Tab möglich.
- **Dashboard:** Für Administratoren kann eine zusätzliche Übersicht mit Kennzahlen sichtbar sein.

---

## Spesenmeldung

Das Spesen-Tool steht **allen** Nutzerinnen und Nutzern mit Portalzugang zur Verfügung, sofern euch das Modul (üblicherweise für alle) zugewiesen ist.

- **Bankverbindung:** Tragt eure **IBAN** ein (wichtig für die Auszahlung); Änderungen sind im **Profil** möglich.
- **Spesen einreichen:** Beleg (Bild oder PDF), Kategorie, Zweck, Kostenstelle, Datum und Betrag. Nach dem Einreichen läuft die Spese in den **Visierungsprozess** ein.
- **Meine Spesen:** Liste eurer Meldungen mit **Status** (zum Beispiel wartend, visiert, bezahlt) und ggf. Auszahlungsdatum; Beleg-Link wo vorhanden.

**Hinweis Selbstvisierung:** Wenn die für die Kostenstelle vorgesehene Visierungsrolle **dieselbe** ist wie eine eurer Rollen, kann die Meldung zur Prüfung an die **Präsidenten-Rolle** weitergeleitet werden, damit keine Person sich selbst visiert. Wenn das System dabei eine Fehlermeldung zeigt, fehlt ggf. die nötige Rolle oder Zuweisung im Verein – dann Admin informieren.

---

## Mannschaftskonten

**Zielgruppe im Verein:** Trainerinnen und Trainer **von Aktivmannschaften** sowie **von C- bis A-Junioren**. Der Zugriff erfolgt über die vom Administrator gesetzten **Rollen** und **Module**.

- Ihr wählt links eine **Mannschaft** aus der Liste (die Liste hängt von euren **Rollen** ab).
- **Aktueller Saldo:** Übersicht der **offenen, visierten** Posten mit Summe; Einzelzeilen mit Datum, Lieferant, Beschreibung, Betrag, Konto und Link zum Beleg.
- **Abrechnungen:** Frühere Mannschaftsabrechnungen mit Betrag, Datum und **Abrechnungs-PDF**; darunter die zugeordneten Original-Belege, soweit vorhanden.

Personen mit erweiterten Rollen (**Admin** oder **Sport**) können alle Mannschaften sehen; andere Nutzerinnen und Nutzer nur die Mannschaften, die zu ihren Rollen passen.

---

## Profil (über den Benutzerbereich im Portal)

- **Name:** Wird angezeigt; Änderungen nur **über den Administrator**.
- **E-Mail:** Ändern mit Bestätigung über **beide** E-Mail-Adressen (alt und neu), wie im Formular beschrieben.
- **IBAN:** Speichern für Spesen-Auszahlungen.
- **Passwort:** Neu setzen mit Wiederholung (Mindestlänge wie auf der Profilseite angegeben).

---

## Kurz gefragt: Ich sehe keine Karten – was nun?

1. Seid ihr mit derselben E-Mail angemeldet, mit der ihr registriert wurdet?  
2. Hat der Verein euch schon **mindestens eine Rolle** gegeben?  
3. Sind für diese Rolle(n) im Verein die **richtigen Module** freigeschaltet?

Wenn alles geklärt ist und es weiterhin hakt, **Admin oder Vorstand** kontaktieren.

---

*FC Münsterlingen – Ein Verein, eine Familie.*