Docs

KANBAN

Dokumentation
Zurück

KANBAN

Wofür ist das?

Das KANBAN-Plugin liefert die Spalten-Konfiguration für die Kanban-Ansicht der Verträge.

In der Vertragsliste können Sie zwischen Listen- und Kanban-Ansicht umschalten. In der Kanban-Ansicht werden Verträge als Karten angezeigt und lassen sich per Drag & Drop zwischen Spalten verschieben.

Beispiele für sinnvolle Spalten:

  • „Anfragen“ (eingehende Homepage-Anfragen)
  • „in Vorbereitung“
  • „bestätigt“
  • „läuft“
  • „abgeschlossen“

Typische Aufgaben (Alltag)

  • Spalten anlegen / umbenennen
  • Reihenfolge der Spalten ändern
  • „Anfragen“-Spalte und „Abgeschlossen“-Spalte markieren
  • Karten in der Vertrags-Kanban-Ansicht verschieben (im Vertrag-Plugin selbst)
  • Karten/Verträge filtern (z.B. nach Mieter, Zeitraum, Suchwort)

Schritt-für-Schritt

1) Spalten verwalten

1. Öffnen Sie Admin → Kanban (/settings/admin/kanban).
2. Sie sehen die Liste der konfigurierten Spalten („Kategorien“) in aktueller Reihenfolge.

2) Spalte anlegen

1. Im Formular neuen Namen eintragen.
2. Speichern (POST /settings/admin/kanban).

3) Spalte umbenennen

  • Auf das Stift-Symbol / „Umbenennen“ → Name eintragen → speichern

(POST /settings/admin/kanban/{id}/rename).

4) Reihenfolge ändern

  • Pfeil hoch / runter benutzen:
  • POST /settings/admin/kanban/{id}/up
  • POST /settings/admin/kanban/{id}/down

5) Spalte „Anfragen“ / „Abgeschlossen“ markieren

Bestimmte Spalten haben Sonderfunktionen:

  • „Anfragen“-Spalte: Hier landen automatisch neue Verträge aus dem HOMEPAGE-Anfrageformular.

Aktivieren via POST /settings/admin/kanban/{id}/toggle-anfragen.

  • „Abgeschlossen“-Spalte: Verträge in dieser Spalte werden in Listen / Statistiken oft separat behandelt.

Aktivieren via POST /settings/admin/kanban/{id}/toggle-abgeschlossen.

> Es kann jeweils sinnvoll nur eine „Anfragen“-Spalte und eine „Abgeschlossen“-Spalte geben.

6) Spalte löschen

  • POST /settings/admin/kanban/{id}/delete
  • Verträge in dieser Spalte landen in der Standardspalte.

7) Im Alltag: Karten verschieben & filtern

  • In der Vertragsliste auf Kanban-Ansicht umschalten.
  • Karte mit Maus / Touch in eine andere Spalte ziehen.
  • Filter (Suche, Zeitraum, Mieter etc.) gelten sowohl für die Listen- als auch für die Kanban-Ansicht.

Häufige Fragen / Probleme

„Karten lassen sich nicht ziehen“

  • Berechtigung zum Bearbeiten von Verträgen vorhanden?
  • Browser-Konsole prüfen: Wenn die kanban/move-Anfrage einen Fehler liefert, läuft der Server eventuell nicht.

„Anfragen aus der Homepage landen nicht im Kanban“

  • HOMEPAGE und VERTRAG aktiv?
  • Spalte als „Anfragen“ markiert (toggle-anfragen)?

„Spaltenreihenfolge stimmt nicht“

  • Reihenfolge im Admin mit Hoch/Runter anpassen.

Technische URLs (Kurzreferenz)

Admin (/settings/admin/kanban):

  • GET /settings/admin/kanban – Übersicht
  • POST /settings/admin/kanban – Spalte anlegen
  • POST /settings/admin/kanban/{id}/rename
  • POST /settings/admin/kanban/{id}/delete
  • POST /settings/admin/kanban/{id}/up
  • POST /settings/admin/kanban/{id}/down
  • POST /settings/admin/kanban/{id}/toggle-anfragen
  • POST /settings/admin/kanban/{id}/toggle-abgeschlossen

Bewegung im Vertrag-Plugin:

  • POST /vertrag/vertraege/kanban/move – Karte zwischen Spalten verschieben

Hinweise

  • KANBAN ist nur sinnvoll, wenn auch VERTRAG aktiv ist.
  • Die Spalten sind global pro Mandant und gelten für alle Nutzer.