Projekte

Projekte (vormals Boards) sind deine Workspaces in Spedy. Jedes Projekt repräsentiert ein Team, ein Produkt oder jeden Arbeitsbereich, den du verfolgen möchtest. In einem Projekt findest du alle deine Tickets in einem visuellen Kanban-Layout organisiert, das es einfach macht, auf einen Blick zu sehen, was gerade passiert.

Die Kanban-Ansicht

Wenn du ein Projekt öffnest, siehst du deine Tickets über Spalten verteilt. Jede Spalte repräsentiert einen Status in deinem Workflow -- zum Beispiel "Backlog", "To Do", "In Bearbeitung" oder "Erledigt". Um ein Ticket voranzubringen, ziehe es einfach von einer Spalte in die nächste. Die Änderung wird automatisch gespeichert.

Jede Status-Spalte gehört zu einer von vier Kategorien, die Spedy helfen zu verstehen, wo ein Ticket in seinem Lebenszyklus steht:

Du kannst die Status und Spalten, die auf jedem Projekt erscheinen, an die tatsächliche Arbeitsweise deines Teams anpassen.

Projekt erstellen

Um ein neues Projekt zu erstellen, klicke auf den Neues Projekt-Button in der Seitenleiste. Gib deinem Projekt einen Namen und ein kurzes Kürzel (zum Beispiel "ACME"). Dieses Kürzel wird verwendet, um lesbare Ticket-IDs wie ACME-1, ACME-2 usw. zu generieren -- was es einfach macht, Tickets in Gesprächen oder Nachrichten zu referenzieren.

Repository beim Erstellen verbinden

Im selben Dialog legst du unter GitHub-Repository fest, woher der Code des Projekts kommt. Vier Möglichkeiten:

Projekt aus einer Vorlage erstellen

Wählst du Aus Template generieren und danach eine Vorlage aus der Liste, dann:

1. legt Spedy über deine aktive Git-Integration ein neues, privates Repository in deiner eigenen Organisation an,
2. klont die Vorlage und pusht sie in dieses Repository,
3. verknüpft das Repo mit dem Projekt und setzt es als Preview-Repository.

Der Repository-Name wird aus dem Projektnamen abgeleitet (kleingeschrieben, Sonderzeichen werden zu Bindestrichen).

Wo landet das Repo? Immer in deiner eigenen Organisation -- bei dem Anbieter, dessen Integration aktiv ist. Sind GitHub und GitLab verbunden, wird GitHub verwendet; ist nur GitLab verbunden, entsteht das Projekt in GitLab. Verbinde deinen Anbieter vorher unter Einstellungen → Integrationen.

Vorlage und Ziel sind unabhängig voneinander. Eine Vorlage, die auf GitHub liegt, kann in einem GitLab-Projekt landen -- und umgekehrt.

Was übernommen wird: die Vorlage mit allen Branches und Tags, also die vollständige Historie -- inklusive der Preview-Konfiguration (docker-compose.yml und .spedy/), falls die Vorlage sie mitbringt.

Die eingebauten Spedy-Vorlagen (Shopware, Magento, Next.js) sind öffentlich und benötigen keinerlei Zugangsdaten. Eigene Vorlagen registrierst du unter Einstellungen → Projekt-Templates; sie werden mit dem Token deiner eigenen Integration gelesen.

Hinweise

• Das leere Ziel-Repository wird angelegt, bevor der Inhalt hineingepusht wird. Schlägt der Push fehl, bleibt ein leeres Repo zurück; die Fehlermeldung nennt seinen Namen. Lösche es oder wähle beim nächsten Versuch einen anderen Projektnamen -- sonst kollidiert der Repository-Name.
• Das Projekt wird trotzdem erstellt. Scheitert der Repo-Schritt, bekommst du eine Fehlermeldung, behältst aber das Projekt und kannst das Repository später aus den Projekt-Einstellungen verbinden.
• Self-hosted GitLab: Die Instanz muss unter einer öffentlich erreichbaren Adresse liegen. Interne Adressen werden beim Anlegen und Pushen abgelehnt.
• Große Vorlagen brauchen einen Moment -- das Kopieren läuft, während der Dialog noch offen ist.

Projekte bearbeiten und archivieren

Öffne deine Projekt-Einstellungen, um das Projekt umzubenennen, sein Kürzel zu ändern oder die Workflow-Spalten anzupassen. Wenn ein Projekt abgeschlossen oder pausiert ist, kannst du es archivieren, um es aus deiner aktiven Liste zu entfernen, ohne Daten zu löschen. Archivierte Projekte können jederzeit über den Einstellungsbereich wiederhergestellt werden.

Projekt-Zugriffsrollen

Nicht jeder braucht die gleiche Zugriffsebene auf ein Projekt. Spedy bietet drei Rollen, um zu kontrollieren, was jede Person tun kann:

Du kannst einzelne Nutzer zu einem Projekt hinzufügen oder ein ganzes Team zuweisen, damit alle Teammitglieder automatisch Zugriff erhalten. Organisations-Administratoren haben immer Zugriff auf jedes Projekt.

Projekt-Icon

Jedes Projekt hat ein quadratisches Icon -- in der Projektübersicht, im Projekt-Header und überall dort, wo das Projekt auftaucht. Du hast drei Möglichkeiten:

Icon einstellen

1. Öffne Projekt → Einstellungen → Allgemein
2. Gehe zum Abschnitt Projekt-Icon
3. Wähle eine Farbe (12 Töne von Neutral über Petrol bis Rosé) und ein Symbol -- oder klicke auf Bild hochladen

Jede Auswahl wird sofort gespeichert, es gibt keinen Speichern-Button. Die Vorschau oben im Abschnitt zeigt, wie das Projekt künftig überall erscheint.

Hinweise

• Zurück zum Kürzel: Klicke erneut auf das aktive Symbol -- das Projekt zeigt wieder sein Monogramm. Ein hochgeladenes Bild entfernst du über Bild entfernen.
• Farbe gilt für Kürzel und Symbol: Ein hochgeladenes Bild bringt seine eigenen Farben mit; die Farbauswahl wirkt dann nicht mehr auf das Icon.
• Erlaubte Dateien: PNG, JPEG und WebP bis 512 KB. SVG wird bewusst nicht angenommen.
• Berechtigung: Zum Ändern brauchst du dieselbe Berechtigung wie für die übrigen Projekteinstellungen (boards:edit).

Ansichten

Jedes Projekt bietet zwei Ansichten. Wechsle oben auf der Projektseite über den Ansichts-Switcher. Deine Auswahl wird pro Projekt im Browser gespeichert.

Beide Ansichten nutzen die gleichen Board-Filter und öffnen das Ticket-Seitenpanel bei Klick.

Die Tabellen-Ansicht wurde entfernt. Sie zeigte dieselben Tickets mit denselben Filtern wie die Listen-Ansicht. War bei dir zuletzt die Tabelle aktiv, öffnet Spedy das Projekt automatisch wieder im Board -- du musst nichts umstellen. Für eine tabellarische Sicht über mehrere Projekte hinweg nutze den Issues Hub.

Für eine zeitliche Übersicht über Start- und Fälligkeitsdaten steht die separate Timeline-Seite zur Verfügung.

Projektordner

Projektordner gruppieren deine Projekte in der Übersicht -- zum Beispiel nach Kundentyp, Abteilung oder Priorität. Ordner erscheinen als einklappbare Sektionen in der Grid- und Listen-Ansicht.

Ordner erstellen und nutzen

1. Öffne die Projektübersicht
2. Klicke auf Neuer Ordner und gib einen Namen ein
3. Ziehe Projekte per Drag-and-Drop in den Ordner -- oder nutze das Verschieben-Menü auf der Projektkarte

Projekte ohne Ordner stehen weiterhin oben in der Übersicht. Der eingeklappte/ausgeklappte Zustand jedes Ordners wird zwischen Sitzungen gespeichert.

Berechtigungen

• Ordner erstellen erfordert die Berechtigung boards:create
• Ordner umbenennen, umsortieren und löschen erfordert boards:edit
• Beim Löschen eines Ordners werden die enthaltenen Projekte nicht gelöscht -- sie werden in die ungruppierten Projekte verschoben

Ordner sind organisationsweit sichtbar, aber für externe Kunden-Accounts ausgeblendet.

Projekt-Favoriten

Pinne die Projekte an, auf die du am häufigsten zugreifst. Fahre mit der Maus über eine Projektkarte in der Übersicht und klicke auf den Stern, oder nutze das Stern-Icon im Projekt-Header. Der Stern wird amber/gold und das Projekt wird oben im Sidebar-Projektmenü angepinnt.

Favorisierte Projekte erscheinen oberhalb eines Dividers, darunter stehen die zuletzt besuchten Projekte -- alphabetisch sortiert statt abgeschnitten. Die Sidebar zeigt zunächst 5 angepinnte Projekte; scrolle, um weitere zu sehen. Favoriten sind persönlich -- nur du siehst deine eigenen, und sie werden beim Wechsel der Organisation zurückgesetzt. Du kannst bis zu 200 Projekt-Favoriten haben.

Um ein Projekt aus deinen Favoriten zu entfernen, klicke erneut auf den Stern auf der Projektkarte oder im Projekt-Header.

Projekt-Einstellungen

Auf der Projekt-Einstellungsseite kannst du:

• Das Projekt umbenennen oder sein Kürzel aktualisieren
• Verwalten, welche Status und Spalten im Projekt erscheinen
• Teammitglieder hinzufügen oder entfernen und ihre Rollen festlegen
• Das Projekt archivieren oder wiederherstellen