Version 1.1.0 · Redmine 5.1 und 6 · GPLv2
Dieses Handbuch beschreibt Installation, Konfiguration und täglichen Einsatz des atori Kanban-Board-Plugins.
Das Plugin ergänzt eine projektbezogene Kanban-Ansicht, die direkt auf die in Redmine definierten Ticket-Statuswerte abgebildet wird. Es gibt keinen parallelen Workflow, kein separates Status-Modell und keine Schattendaten: Spalten sind Statuswerte, Karten sind Tickets, und jede Änderung auf dem Board ist ein reguläres Redmine-Ereignis mit dem entsprechenden Journaleintrag.
Zentrale Begriffe:
IssueStatus. Spalten lassen sich im Board-Settings-Dialog ausblenden oder umsortieren; ausgeblendete Spalten existieren in Redmine weiter, erscheinen aber nicht auf dem Board.IssueQuery). Über Queries erreicht man beliebig komplexe Filterlogik, ohne im Plugin eine eigene Abfragesprache nachzubauen.cd /pfad/zu/redmine
unzip at_kanbanboard-1.2.0.zip -d plugins/
bundle exec rake redmine:plugins:migrate NAME=at_kanbanboard RAILS_ENV=production
# Redmine neu starten (passenger/puma/systemd-Unit)cd /pfad/zu/redmine
git clone <repo-url> plugins/at_kanbanboard
bundle exec rake redmine:plugins:migrate NAME=at_kanbanboard RAILS_ENV=production
# Redmine neu startenNach dem Neustart als Administrator einloggen und Administration → Plugins öffnen. Das Plugin Kanban Board sollte mit Version 1.1.0 erscheinen, ohne Fehler-Banner.
cd /pfad/zu/redmine
bundle exec rake redmine:plugins:migrate NAME=at_kanbanboard VERSION=0 RAILS_ENV=production
rm -rf plugins/at_kanbanboard
# Redmine neu startenDer Rake-Task rollt alle Plugin-Migrationen zurück und entfernt die drei vom Plugin verwalteten Tabellen (kanban_boards, kanban_board_columns, kanban_issue_positions). Bestehende Redmine-Daten (Tickets, Status, Abfragen) werden nicht angerührt.
Kanban ist als Projekt-Modul implementiert und standardmäßig deaktiviert.
Das Plugin stellt drei unabhängige Rechte unter Administration → Rollen und Rechte → Kanban-Board bereit:
| Recht | Wirkung | Typische Rolle |
|---|---|---|
| Kanban-Board ansehen | Board sehen, nur lesend | Berichterstatter |
| Tickets auf dem Kanban-Board bearbeiten | Drag & Drop, Reihenfolge innerhalb einer Spalte | Entwickler |
| Kanban-Board verwalten | Board-Einstellungen ändern (Kartenquelle, Swimlanes, WIP, Spaltensichtbarkeit) | Manager |
Die Trennung von Lese- und Bearbeitungsrecht erlaubt es, reinen Stakeholdern Zugang zu gewähren, ohne versehentliche Statuswechsel zu riskieren.
Beim ersten Aufruf des Kanban-Tabs durch einen Benutzer mit Kanban-Board ansehen-Recht wird der Board-Datensatz automatisch angelegt. Eine Spalte pro Ticketstatus wird in der Reihenfolge erzeugt, die Redmine vorgibt; geschlossene Status sind enthalten, können aber nachträglich über die Board-Einstellungen ausgeblendet werden.
Innerhalb eines Projekts mit aktiviertem Kanban-Modul erscheint im Projektmenü der Eintrag Kanban (nach Tickets). Der Klick öffnet das Board mit den aktuellen Tickets, angeordnet nach Status.
Benutzer mit dem Recht Tickets auf dem Kanban-Board bearbeiten können Karten zwischen Spalten ziehen. Das Ablegen löst ein Status-Update am zugrunde liegenden Ticket aus, das durch Redmines normale Workflow-Prüfung läuft – Workflow-Beschränkungen pro Rolle und Tracker werden also respektiert. Ein Journaleintrag wird genauso geschrieben, als hätte man den Status über das reguläre Ticket-Formular geändert.
Das Umsortieren von Karten innerhalb einer Spalte wird in der plugin-eigenen Positionstabelle (kanban_issue_positions) gespeichert und berührt keine Ticketdaten. So lässt sich Priorität auf dem Board ausdrücken, ohne das Prioritätsfeld zu überschreiben.
Standardmäßig zeigt das Board alle Tickets des Projekts. Um die Menge einzugrenzen:
Das Board zeigt nun nur noch die Tickets, die die gespeicherte Abfrage liefert. So lässt sich das Board auf einen Sprint, ein Release, einen Zuständigkeitsbereich oder jede andere Dimension eingrenzen, die sich bereits als Query formulieren lässt.
In den Board-Einstellungen ein Swimlane-Feld wählen. Unterstützt werden:
Leere Auswahl deaktiviert Swimlanes und stellt das Standard-Layout mit einer einzigen Zeile wieder her. Swimlanes sind rein eine Anzeigeeinstellung; ihr Ein- oder Ausschalten ändert keine Ticketdaten.
Pro Spalte lässt sich eine positive Ganzzahl als Grenze setzen. Übersteigt die sichtbare Kartenanzahl das Limit, zeigt der Spaltenkopf eine Warnung. Das Plugin blockiert bewusst keine weiteren Züge – harte Blockaden führen erfahrungsgemäß dazu, dass Arbeit am Tool vorbei organisiert wird, und unterminieren damit den Sinn des Limits.
Um das Limit einer Spalte aufzuheben, Eingabefeld leeren.
In den Board-Einstellungen:
Jeder Kartenzug ist ein Statuswechsel am Ticket – der komplette Änderungsverlauf liegt damit im Ticket-Journal, ohne dass ein separates Log konsultiert oder exportiert werden muss. Swimlane-Gruppenwechsel folgen demselben Weg (das zugehörige Feld wird aktualisiert).
Drag & Drop tut nichts / springt zurück. Prüfen, ob der angemeldete Benutzer das Recht Tickets auf dem Kanban-Board bearbeiten hat und ob Redmines Workflow den Wechsel vom Ausgangs- zum Zielstatus für die Rolle des Benutzers erlaubt. Abgelehnte Übergänge lassen die Karte in die Ausgangsspalte zurückspringen.
Eine Spalte fehlt, obwohl ich weiß, dass Tickets in diesem Status existieren. Board-Einstellungen öffnen und prüfen, ob die Spalte als ausgeblendet markiert ist oder Geschlossene Status ausblenden aktiv ist. Für jeden vorhandenen IssueStatus wird automatisch eine Spalte angelegt; ausgeblendete bleiben aber absichtlich unsichtbar.
Keine Karten, obwohl Tickets existieren. Wenn eine gespeicherte Abfrage als Kartenquelle gesetzt ist, die Filter der Abfrage prüfen – Karten außerhalb der Abfrage werden nicht angezeigt. Kartenquelle in den Board-Einstellungen leeren, um zum Standard zurückzukehren (alle Projekttickets).
Performance bei großen Projekten. Das Board rendert jede Karte, die es findet. Für Projekte mit tausenden offenen Tickets eine gespeicherte Abfrage anlegen, die die Menge auf das tatsächlich Relevante begrenzt (z.B. „dieser Sprint" oder „offen und meinem Team zugewiesen"), und diese als Kartenquelle setzen.
Ein neu angelegter Ticketstatus erscheint nicht auf dem Board. Die Spaltenliste wird bei jedem Board-Aufruf abgeglichen. Seite (oder Projekt) neu laden, dann erscheint die neue Spalte am Ende der Sequenz.
Support ist für zwölf Monate ab Kaufdatum enthalten und deckt Fehlermeldungen, Konfigurationsfragen und Kompatibilitätsprobleme ab.
E-Mail: support@atori.de Erstreaktion: werktags innerhalb von 48 Stunden.
Bitte in Supportanfragen angeben:
log/production.log, sofern verfügbar