# Begriffe, die dir begegnen

Repository, Commit, Pipeline, Server, Docker und Workspace sind Begriffe, die dir auf der Application Platform ständig begegnen, und jeder von ihnen wird kurz und mit Plattform-Bezug erklärt.

> Source: https://www.application-platform.com/de/docs/basics/

## Repository

Ein Repository, kurz Repo, ist ein Ordner mit deinem Code samt Änderungsgeschichte. Jeder Baustein deines Projekts hat ein eigenes Repository in GitLab; lokal arbeitest du in einer Kopie.

## Git, Commit und Push

Git verwaltet die Änderungsgeschichte; ein Commit ist ein gespeicherter Zwischenstand mit kurzer Nachricht, ein [Push]({{< relref "save-and-publish" >}}) lädt Commits nach GitLab hoch. Ein Push auf `main` startet die Pipeline.

## Terminal

Das Terminal ist ein Fenster für Textbefehle; unter Windows heißt es Terminal oder PowerShell, in VS Code oder Cursor öffnest du es über das Menü **Terminal**. Du brauchst es vor allem für `ap run-local` und `ap login`.

## Server

Ein [Server]({{< relref "servers" >}}) ist ein Rechner im Internet, der deine Anwendung ausliefert; Backends, Web-Apps und Homepages brauchen einen, reine Mobile-Apps nicht. Unter **Server** legst du einen eigenen, einen Cloud-Server bei Hetzner oder Hostinger oder einen Managed Server an.

## Domain und DNS

Eine [Domain]({{< relref "domain" >}}) ist der lesbare Name deiner Anwendung, etwa `example.com`; DNS übersetzt ihn über Einträge bei deinem Domain-Anbieter in die Adresse deines Servers. Unter **Domains** zeigt die Plattform die nötigen Einträge und prüft sie.

## Pipeline und Deployment

Eine [Pipeline]({{< relref "what-are-pipelines" >}}) ist eine Kette automatischer Schritte nach jedem Push: testen, Version berechnen, bauen und verteilen. Deployment bringt einen Build auf einen Server, nach jedem Push auf `main` automatisch auf Dev und per Klick auf Prod.

## KI-Agent

Ein [KI-Agent]({{< relref "work-with-ai-agents" >}}) wie Claude Code, Cursor oder Codex liest deinen Code, schreibt Änderungen und führt Befehle aus. In jedem Projekt befolgt er die Regeln aus `AGENTS.md`, und mit dem Agent-Plugin legt er Projekte an, importiert und klont sie.

## Docker

Docker verpackt eine Anwendung mit allem, was sie braucht, in einen Container. Die Pipeline baut aus Backend oder Web-App ein Docker-Image für den Server. Lokal braucht `ap run-local` für die Docker-Dienste eines Backends Docker Desktop.

## Umgebungsvariablen

[Umgebungsvariablen]({{< relref "environment-setup" >}}) sind Einstellungen, die eine Anwendung beim Start liest, etwa die Adresse des Backends. Sie liegen im Ordner `env/` jedes Repositorys; Dateien mit `generated` im Namen schreibt die Plattform, eigene Werte gehören in `custom`-Dateien wie `env/local.custom.env`.

## Workspace

Der lokale Workspace ist der Ordner `~/Documents/application-platform/`, in den die Setup-App deine Projekte klont. Ein [Remote-Workspace]({{< relref "setup-your-computer" >}}) ist ein Entwicklungsrechner in der Cloud, den du unter **Workspaces** anlegst und per Remote Desktop oder im Browser benutzt.

## Organisation und Projekt

Eine Organisation ist der Rahmen für dein Team mit Mitgliedern, Abrechnung, Servern und Anbindungen. Ein Projekt ist ein Produkt darin mit eigener GitLab-Gruppe. Administratoren verwalten Organisation, Projekte und Zugänge; Developer arbeiten an zugewiesenen Projekten.

Damit kannst du [dein erstes Projekt anlegen]({{< relref "getting-started" >}}) oder ein [bestehendes Projekt übernehmen]({{< relref "import-existing-project" >}}).