Grundbegriffe

Wie deine Arbeit gegliedert ist

Organisation. Ein geschlossener Raum mit eigenen Mitgliedern, Rollen und Daten. Agenturen führen meist eine pro Kunde. Ein Konto kann zu mehreren gehören. Mehr unter Was ist eine Organisation?
Projekt. Liegt in einer Organisation und bündelt Tickets, Dokumente und Zeiten. Man sieht nur die Projekte, denen man angehört. Mehr unter Erstes Projekt anlegen.
Ticket. Die Arbeitseinheit, als Liste oder Board. Status, Prioritäten und Felder legst du pro Projekt fest. Mehr unter Tickets.
Rolle. Bestimmt, was jemand sehen und tun darf. So bekommen auch Kunden ihren eigenen Zugang. Mehr unter Rollen und Rechte.

Zwei Arten von Konten

Ein Benutzer arbeitet in Organisationen und meldet sich unter /users/sign_in an. Ein Instanz-Admin kümmert sich um die ganze Installation und meldet sich unter /admin an. Das sind getrennte Konten mit getrennten Anmeldungen. In unserer Cloud sind wir der Instanz-Admin, auf deinem eigenen Server bist du es.

Wie eine Instanz aufgebaut ist

Lalabase ist eine Rails-Anwendung mit serverseitig gerenderten Seiten (Hotwire, kein React). Sie braucht:

Teil	Aufgabe
Anwendung	Weboberfläche, REST-API und MCP-Server
Worker	Hintergrundarbeit: Mail, Benachrichtigungen, KI (Solid Queue)
PostgreSQL mit pgvector	alle Daten, auch der Suchindex des Assistenten
Redis-kompatibler Speicher	Live-Updates und Cache (das Docker-Setup nutzt Valkey)

Docker Compose startet das alles für dich, dazu Caddy für HTTPS. Siehe Systemanforderungen.

Wege von außen

Neben der Web-App gibt es den MCP-Server für Agenten, das CLI-Tool fürs Terminal und eine REST-API unter /api/v1. Alle drei nutzen dieselben Zugriffstoken. Für die REST-API gibt es noch keine öffentliche Referenz.