Adds basic description of PAS

Author: cyrillkuettel

.gitignore

@@ -4,3 +4,4 @@ __pycache__/
 .cache/
 .idea/
 .DS_Store
+site/

content/services/index.md

@@ -83,6 +83,14 @@ Jeder Service basiert auf modular aufgebauten GovTech [Modulen](/module/).
 
 	[:octicons-arrow-right-24: Mehr erfahren](/services/datenportal-abstimmungen-swissvotes/)
 
+-   :material-gavel:{ .lg .middle } **Parlamentsverwaltung (PAS)**
+
+	---
+
+	Verwaltung von Parlamentarier:innen, Kommissionen, Anwesenheiten und Entschädigungen für den Kantonsrat.
+
+	[:octicons-arrow-right-24: Mehr erfahren](/services/parlamentsverwaltung/)
+
 -   :material-domain:{ .lg .middle } **Intranet**
 
 	---

content/services/parlamentsverwaltung/abrechnungslauf.md

@@ -0,0 +1,82 @@
+---
+title: Abrechnungslauf
+description: Entschädigungen berechnen, prüfen und exportieren
+---
+
+# Abrechnungslauf
+
+Ein Abrechnungslauf definiert den Zeitraum (z.B. ein Quartal), für den Entschädigungen der Parlamentarier:innen berechnet und exportiert werden. Pro Zeitraum existiert genau ein Abrechnungslauf. Zeiträume dürfen sich nicht überlappen.
+
+## Anwesenheiten erfassen
+
+Während ein Abrechnungslauf offen ist, können Anwesenheiten erfasst werden. Das Anwesenheitsdatum muss innerhalb eines offenen Abrechnungslaufs liegen.
+
+### Einzelerfassung
+
+Eine Anwesenheit für eine einzelne Person. Felder: Datum, Dauer, Sitzungsart und Kommission (entfällt bei Plenarsitzung). Alle vier Sitzungsarten stehen zur Verfügung. Parlamentarier:innen können nur eigene Anwesenheiten erfassen, Kommissionspräsident:innen zusätzlich für ihre Kommissionsmitglieder.
+
+### Sammelerfassung Kommission
+
+Erfasst Anwesenheiten für alle Mitglieder einer Kommission gleichzeitig. Nach Auswahl der Kommission erscheinen die zugehörigen Mitglieder als Auswahlliste. Die Sitzungsart ist auf **Kommission** oder **Kürzestsitzung** beschränkt. Der Abschluss kann direkt gesetzt werden.
+
+Verfügbar für Administratoren und Kommissionspräsident:innen.
+
+### Sammelerfassung Plenarsitzung
+
+Erfasst Anwesenheiten für alle aktiven Parlamentarier:innen gleichzeitig. Alle Personen sind automatisch vorausgewählt — einzelne können abgewählt werden. Die Sitzungsart ist immer **Plenarsitzung**.
+
+Nur für Administratoren.
+
+### Sammelbearbeitung und -löschung
+
+Anwesenheiten aus einer Sammelerfassung werden als Gruppe gespeichert. Sie können nachträglich gemeinsam bearbeitet oder gelöscht werden.
+
+## Abschluss
+
+Parlamentarier:innen und Kommissionspräsident:innen markieren ihre Anwesenheiten als abgeschlossen, sobald alle Sitzungen erfasst sind. Der Abschluss kann bei der Einzelerfassung oder bei der Sammelerfassung Kommission gesetzt werden.
+
+Nach dem Abschluss:
+
+- Administratoren werden per E-Mail benachrichtigt
+- Für diese Person und diesen Zeitraum können keine weiteren Anwesenheiten gebucht werden
+- Wird bei einer Sammelerfassung versucht, eine Person mit bestehendem Abschluss erneut zu buchen, wird die gesamte Erfassung abgelehnt
+
+Auf der Detailseite des Abrechnungslaufs ist der Abschlussstatus pro Kommission ersichtlich (z.B. «3/7 abgeschlossen»), inklusive einer Auflistung der noch ausstehenden Mitglieder.
+
+## Abrechnungslauf abschliessen
+
+Sobald alle Kommissionen abgeschlossen sind, kann der Abrechnungslauf geschlossen werden. Danach sind keine Änderungen an den Anwesenheiten mehr möglich.
+
+## Entschädigung
+
+Die Entschädigungen werden auf Basis der konfigurierten Sätze berechnet. Jeder Satz gilt für ein Kalenderjahr und enthält Tarife pro Sitzungsart, differenziert nach Mitglied und Präsident:in.
+
+Zusätzlich wird eine **Teuerungszulage** als prozentualer Aufschlag angewendet. Alle Beträge werden auf 5 Rappen gerundet.
+
+| Sitzungsart | Berechnung |
+|-------------|------------|
+| Plenarsitzung | Pauschale pro Halbtag |
+| Kommission | Grundbetrag bis 2 Stunden, danach pro 30 Minuten |
+| Kommission (interkantonal) | Pauschale pro Halbtag |
+| Aktenstudium | Tarif pro 30 Minuten |
+| Aktenstudium (interkantonal) | Tarif pro Stunde |
+| Kürzestsitzung | Tarif pro 30 Minuten |
+
+**Präsidialzulagen** werden separat pro Abrechnungslauf konfiguriert und zur Entschädigung addiert.
+
+## Exporte
+
+Vom Abrechnungslauf aus stehen folgende Exporte zur Verfügung:
+
+**PDF-Exporte:**
+
+- **Abrechnungen nach Partei** — Aufstellung pro Partei mit Einzelanwesenheiten und Zusammenfassung
+- **Abrechnungen nach Kommission** — Aufstellung pro Kommission, gruppiert nach Partei
+- **Abrechnungen nach Parlamentarier:in** — Persönliche Abrechnung mit Adresse und Gesamtbetrag
+- **Alle Parlamentarier:innen (ZIP)** — Alle persönlichen Abrechnungen als ZIP-Archiv
+
+**Excel/CSV-Exporte:**
+
+- **Abschlussliste (XLSX)** — Übersicht aller Parlamentarier:innen mit aggregierten Beträgen plus Detailblatt mit Einzelanwesenheiten
+- **Buchungen Abrechnungslauf (XLSX)** — Buchungsjournal für die Lohnverarbeitung
+- **KR-Entschädigungen (CSV)** — Export für die Finanzbuchhaltung (FIBU) mit Lohnarten und Kontonummern

content/services/parlamentsverwaltung/datenimport.md

@@ -0,0 +1,37 @@
+---
+title: Datenimport (KUB)
+description: Automatischer und manueller Import von Stammdaten aus dem KUB
+---
+
+# Datenimport (KUB)
+
+PAS importiert Stammdaten aus dem KUB (Kontakte- und Beziehungsverwaltung) des Kantons Zug. Der Import synchronisiert Parlamentarier:innen, Kommissionen, Parteien und deren Mitgliedschaften.
+
+## Automatischer Import
+
+Ein stündlicher Cronjob synchronisiert die Daten automatisch aus der KUB-API. Voraussetzung ist eine gültige API-Konfiguration (Token, Basis-URL, Zertifikatsverzeichnis).
+
+Der Import läuft in zwei Phasen:
+
+1. **Stammdaten**: Personen, Organisationen und Mitgliedschaften werden abgeglichen.
+2. **Zusatzdaten**: Personalnummer, Vertragsnummer, Wahlkreis, Adresse und weitere Felder werden pro Person nachgeladen.
+
+Anschliessend werden die Benutzerkonten der Parlamentarier:innen synchronisiert (Erstellung und Aktualisierung).
+
+## Manueller Import
+
+Administratoren können Daten auch manuell über die Weboberfläche importieren. Dazu werden drei JSON-Dateien hochgeladen:
+
+- **Personen** — Parlamentarier:innen mit Grunddaten
+- **Organisationen** — Kommissionen, Fraktionen und weitere Gremien
+- **Mitgliedschaften** — Zuordnungen zwischen Personen und Organisationen
+
+## Importprotokoll
+
+Jeder Import wird protokolliert. Das Protokoll enthält:
+
+- Zeitpunkt und Art des Imports (automatisch oder manuell)
+- Anzahl erstellter, aktualisierter und unveränderter Datensätze
+- Status (erfolgreich, fehlgeschlagen, Timeout)
+
+Die Importhistorie ist über **Verwaltung > Importprotokoll** einsehbar.

content/services/parlamentsverwaltung/index.md

@@ -0,0 +1,85 @@
+---
+title: Parlamentsverwaltung (PAS)
+description: Verwaltung von Parlamentarier:innen, Kommissionen, Anwesenheiten und Entschädigungen für den Kantonsrat
+---
+
+# Parlamentsverwaltung (PAS)
+
+PAS (Parliamentarian Accounting System) bildet die Anwesenheitserfassung und Entschädigungsabrechnung des Kantonsrats ab. Stammdaten werden aus dem KUB importiert.
+
+## Überblick
+
+- Parlamentarier:innen, Kommissionen und Fraktionen zentral verwalten
+- Anwesenheiten pro Sitzung erfassen und abschliessen
+- Entschädigungen auf Basis konfigurierter Sätze berechnen
+- Abrechnungsläufe durchführen und als Excel/PDF exportieren
+- Stammdaten automatisch aus dem KUB importieren
+
+## Konzepte
+
+### Parlamentarier:innen
+
+Jede:r Parlamentarier:in wird mit persönlichen Angaben (Name, Partei, Fraktion, Wahlkreis) sowie Rollen geführt. Die Daten können manuell erfasst oder aus dem KUB importiert werden.
+
+### Kommissionen
+
+Kommissionen bilden die organisatorische Einheit für Sitzungen. Jede Kommission hat Mitglieder, die über Mitgliedschaften zugeordnet werden. Es gibt normale, interkantonale und offizielle Kommissionen.
+
+### Legislaturperioden
+
+Legislaturperioden definieren den zeitlichen Rahmen, in dem Parlamentarier:innen aktiv sind.
+
+### Anwesenheiten
+
+Anwesenheiten dokumentieren die Teilnahme an Sitzungen. Jede Anwesenheit enthält Datum, Dauer und Art:
+
+- **Plenarsitzung** — Sitzung des gesamten Kantonsrats
+- **Kommission** — reguläre Kommissionssitzung
+- **Aktenstudium** — Vorbereitung von Kommissionsgeschäften
+- **Kürzestsitzung** — kurze Verfahrenssitzung
+
+Anwesenheiten können auf drei Arten erfasst werden:
+
+- **Einzelerfassung** — Eine Anwesenheit für eine einzelne Person. Alle vier Sitzungsarten stehen zur Verfügung. Parlamentarier:innen und Kommissionspräsident:innen können diese Variante nutzen.
+- **Sammelerfassung Kommission** — Alle Mitglieder einer Kommission werden für eine Sitzung gleichzeitig erfasst. Die Kommission wird ausgewählt, danach erscheinen die zugehörigen Mitglieder als Auswahlliste. Sitzungsart ist auf Kommission oder Kürzestsitzung beschränkt. Verfügbar für Administratoren und Kommissionspräsident:innen.
+- **Sammelerfassung Plenarsitzung** — Alle aktiven Parlamentarier:innen werden automatisch vorausgewählt. Einzelne Personen können abgewählt werden. Sitzungsart ist immer Plenarsitzung. Nur für Administratoren.
+
+Sammelerfassungen werden als Gruppe gespeichert und können nachträglich gemeinsam bearbeitet oder gelöscht werden.
+
+### Abschluss
+
+Parlamentarier:innen und Kommissionspräsident:innen markieren ihre Anwesenheiten als abgeschlossen, sobald alle Sitzungen eines Abrechnungslaufs erfasst sind. Nach dem Abschluss werden Administratoren per E-Mail benachrichtigt. Danach können keine weiteren Anwesenheiten für diesen Zeitraum gebucht werden.
+
+### Abrechnungsläufe
+
+Ein Abrechnungslauf definiert einen Zeitraum (z.B. ein Quartal), für den Entschädigungen berechnet werden. Pro Zeitraum existiert genau ein Abrechnungslauf. Der Abschlussstatus pro Kommission ist auf der Detailseite des Abrechnungslaufs ersichtlich.
+
+### Sätze
+
+Die Sätze definieren die Entschädigungstarife pro Jahr, differenziert nach Sitzungsart und Rolle (Mitglied vs. Präsident:in). Zusätzlich wird eine Teuerungszulage als prozentualer Aufschlag angewendet. Alle Beträge werden auf 5 Rappen gerundet.
+
+### Präsidialzulagen
+
+Zusätzliche Entschädigungen für Präsident:in und Vize-Präsident:in des Kantonsrats, die pro Abrechnungslauf konfiguriert werden.
+
+## Datenimport
+
+PAS importiert Stammdaten automatisch aus dem KUB (Kontakte- und Beziehungsverwaltung) des Kantons Zug. Der Import umfasst Parlamentarier:innen, Kommissionen, Mitgliedschaften und Parteien. Ein stündlicher Cronjob synchronisiert die Daten. Jeder Import wird protokolliert und ist über die Importübersicht einsehbar.
+
+## Exporte
+
+- **Abrechnungen nach Parlamentarier:in** — persönliche Abrechnung als PDF
+- **Abrechnungen nach Partei** — Aufstellung pro Partei als PDF
+- **Abrechnungen nach Kommission** — Aufstellung pro Kommission als PDF
+- **Alle Parlamentarier:innen (ZIP)** — alle persönlichen Abrechnungen gebündelt
+- **Abschlussliste (XLSX)** — Übersicht und Details aller Anwesenheiten
+- **Buchungen Abrechnungslauf (XLSX)** — Buchungsjournal für die Lohnverarbeitung
+- **KR-Entschädigungen (CSV)** — Export für die Finanzbuchhaltung (FIBU)
+
+## Berechtigungen
+
+| Rolle | Zugriff |
+|-------|---------|
+| Administrator:in | Vollzugriff auf alle Funktionen, Abrechnungsläufe und Einstellungen |
+| Kommissionspräsident:in | Anwesenheiten der eigenen Kommissionsmitglieder erfassen und abschliessen |
+| Parlamentarier:in | Eigene Anwesenheiten erfassen und einsehen |

mkdocs.yml

@@ -92,6 +92,10 @@ nav:
         - Konfiguration Startseiteneinstellungen: services/planauflage-baugesuche/konfiguration-startseite.md
       - Versammlungen (Landsgemeinde): services/versammlungen-landsgemeinde/index.md
       - Datenportal Abstimmungen (Swissvotes): services/datenportal-abstimmungen-swissvotes/index.md
+      - Parlamentsverwaltung (PAS):
+        - services/parlamentsverwaltung/index.md
+        - Abrechnungslauf: services/parlamentsverwaltung/abrechnungslauf.md
+        - Datenimport (KUB): services/parlamentsverwaltung/datenimport.md
       - Intranet: services/intranet/index.md
   - Module:
       - module/index.md