Tecto docs
tectoapp.io

Tecto-Dokumentation

Tecto ist ein Kanban-Projektmanagement auf echten Dokumenten. Eine Karte ist kein Titel mit Beschreibungsfeld — sie ist eine Seite: mit einem Textkörper, in den man schreibt, mit Versionsverlauf, Kommentaren, Erwähnungen und Workspace-Feldern. Und dieselbe Karte kann auf mehreren Boards liegen, auf jedem in einer anderen Spalte, ohne kopiert zu werden.

Bitte zuerst lesen

Eine Tecto-Anwendung gibt es, und dies ist ihr Handbuch. Unter app.tectoapp.io liegt sie: eine Seitenleiste mit den Collections und den Boards darin, das Board selbst mit Spalten und Lanes, Karten, die sich mit Maus, Stift oder Finger bewegen lassen, und eine Kartenansicht, die sich unter eigener Adresse über dem Board öffnet. Die Anmeldung ist noch nicht offen; der Weg hinein führt weiter über die Warteliste.

Dieselben Boards sind über die REST-API erreichbar, und die Anwendung schreibt darüber: ein Board anlegen, es umbenennen, eine Karte von einer Spalte in die nächste ziehen — all das geht über die hier beschriebenen Routen. Nur der freie Text nimmt einen anderen Weg: der Textkörper einer Karte und der des Boards laufen über die Live-Verbindung des Editors.

Diese Dokumentation beschreibt also beides: das Produkt, das Sie öffnen, und das System, das Sie programmatisch benutzen können. Dahinter steht dasselbe Board und dieselbe Karte, nicht zwei.

Wenn Sie von der Warteliste kommen: Was Ihnen zugesagt wurde, entsteht auf einem Fundament, das bereits trägt — und die Seiten unten sind genau seine Form.

Das Modell

  • Boards, Spalten und Lanes — was ein Board ist, wie sein Raster konfiguriert wird, und warum eine Spalte keine Auswahloption ist.
  • Karten — Karten sind Seiten, was „gleichzeitig auf zwei Boards" wirklich heißt, und wie eine Karte umzieht.

Darauf aufbauen

  • API — Authentifizierung, Zugriffstoken, Fehler, seitenweise Abfrage, Webhooks und Seiten als Markdown.
  • API-Referenz — jeder Endpunkt, erzeugt aus dem OpenAPI-Dokument, das der Server selbst schreibt.
  • Markdown-Spezifikation — der kanonische Dialekt, in den jeder Kartentext serialisiert und aus dem er verlustfrei zurückgelesen wird.
  • MCP-Server — der hauseigene Model-Context-Protocol-Server, über den ein Assistent Boards liest und Karten bewegt.

Was es genau gibt

In der Anwendung:

  • Eine Seitenleiste mit den Collections und den Boards darin, der Papierkorb und eine Suche über Boards und Karten (⌘K oder die Zeile über den Collections).
  • Das Board: Spalten und Lanes, Karten, die sich mit Maus, Stift oder Finger bewegen lassen, und dieselben Züge im Menü der Karte (hinauf, hinunter, in eine andere Spalte, in eine andere Lane), für alle, die keinen Zeiger benutzen.
  • Eine Kartenansicht unter eigener Adresse, mit Titel und Symbol, der Spalte auf jedem Board, auf dem die Karte liegt, ihren Feldern, dem vollen gemeinsamen Textkörper, Kommentaren und dem Versionsverlauf.
  • Der eigene Textkörper des Boards über dem Raster, mit angehefteten Karten.
  • Eine Anwesenheitsleiste am Board und in der Karte: wer sonst gerade da ist.
  • Persönliche Zugriffstoken in den Einstellungen — die Zugangsdaten für die Schnittstelle unten.

Und über die Schnittstelle:

  • Boards innerhalb einer Collection: anlegen, lesen, umbenennen, Symbol setzen, in den Papierkorb legen.
  • Spalten und Lanes: als Liste am Board konfiguriert.
  • Karten: eine neue anlegen, eine bestehende Seite anhängen, zwischen Spalten und Lanes verschieben, vom Board nehmen.
  • Ein Board als eine einzige gruppierte Abfrage lesen — Karten nach Spalte und Lane gruppiert, mit Fenster und Gesamtzahl je Gruppe. Gemessen an einem Board mit 10.000 Karten.
  • Alles, was eine Karte dadurch erbt, dass sie eine Seite ist: Kommentare, Erwähnungen, Suche, Verlauf, Papierkorb, Workspace-Felder, Ereignisse und Webhooks.
  • Markdown-Export eines Boards, mit den Karten unter ihren Spalten.

Bewusst nicht gebaut — das sind protokollierte Entscheidungen, kein Rückstand, von dem Sie erwarten sollten, dass er bald schrumpft:

  • WIP-Limits.
  • Ein Board filtern oder sortieren. Ein Board steht immer in Board-Reihenfolge.
  • Board-Vorlagen, Automatisierungen, Kartenbilder, öffentliche Board-Freigaben.
  • Kommentare am Textkörper des Boards selbst (Kommentare an Karten gehen).
  • Produktübergreifendes Einbetten: keine Wiki-Seite in einem Board, keine Karte in einer Wiki-Seite, keine Suche über Produkte hinweg. Eine Karte darf ein Projekt benennen, das woanders liegt — ein Link, keine Einbettung; siehe Karten.
  • Import aus einem anderen Werkzeug.

In einer anderen Sprache

Jede Seite hier gibt es auf Deutsch und auf Englisch; die Umschaltung sitzt oben in der Kopfzeile. Die API-Referenz ist die Ausnahme: Ihre Endpunktbeschreibungen kommen unverändert aus der Routentabelle des Servers und bleiben in beiden Sprachen englisch.