# 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?](https://lalabase.com/docs/de/guides/basics/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](https://lalabase.com/docs/de/guides/basics/first-project).
- **Ticket.** Die Arbeitseinheit, als Liste oder Board. Status, Prioritäten und Felder legst
  du pro Projekt fest. Mehr unter [Tickets](https://lalabase.com/docs/de/guides/basics/tickets).
- **Rolle.** Bestimmt, was jemand sehen und tun darf. So bekommen auch Kunden ihren eigenen
  Zugang. Mehr unter [Rollen und Rechte](https://lalabase.com/docs/de/guides/team/roles-permissions).

## 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](https://lalabase.com/docs/de/self-hosting/getting-started/requirements).

## Wege von außen

Neben der Web-App gibt es den [MCP-Server](https://lalabase.com/docs/de/mcp/introduction/overview) für Agenten, das
[CLI-Tool](https://lalabase.com/docs/de/cli/getting-started/overview) fürs Terminal und eine REST-API unter
`/api/v1`. Alle drei nutzen dieselben [Zugriffstoken](https://lalabase.com/docs/de/guides/ai/personal-access-tokens).
Für die REST-API gibt es noch keine öffentliche Referenz.