i18n - docs translations (#20366)

Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
2026-05-07 18:53:27 +02:00
parent 24e64350ee
commit 95bc8aea28
175 changed files with 5164 additions and 5007 deletions
@@ -1,14 +1,14 @@
 ---
-title: Concepts
-description: How Twenty apps work — entity model, sandboxing, and the install lifecycle.
+title: Konzepte
+description: Funktionsweise von Twenty-Apps – Entity-Modell, Sandboxing und der Installations-Lebenszyklus.
 icon: sitemap
 ---

-Twenty apps are TypeScript packages that extend your workspace with custom objects, logic, UI components, and AI capabilities. They run on the Twenty platform with full sandboxing and permission controls.
+Twenty-Apps sind TypeScript-Pakete, die Ihren Arbeitsbereich mit benutzerdefinierten Objekten, Logik, UI-Komponenten und KI-Funktionen erweitern. Sie laufen auf der Twenty-Plattform mit vollständigem Sandboxing und Berechtigungsverwaltung.

-## How apps work
+## Wie Apps funktionieren

-An app is a collection of **entities** declared using `defineEntity()` functions from the `twenty-sdk` package. The SDK detects these declarations via AST analysis at build time and produces a **manifest** — a complete description of what your app adds to a workspace. These functions validate your configuration at build time and provide IDE autocompletion and type safety.
+Eine App ist eine Sammlung von **Entitäten**, die mithilfe von `defineEntity()`-Funktionen aus dem Paket `twenty-sdk` deklariert werden. Das SDK erkennt diese Deklarationen zur Build-Zeit per AST-Analyse und erzeugt ein **Manifest** — eine vollständige Beschreibung dessen, was Ihre App zu einem Arbeitsbereich hinzufügt. Diese Funktionen validieren Ihre Konfiguration zur Build-Zeit und bieten IDE-Autovervollständigung sowie Typsicherheit.

 ```
 your-app/
@@ -29,35 +29,35 @@ your-app/
 ```

 <Note>
-  **File organization is up to you.** Entity detection is AST-based — the SDK finds `export default defineEntity(...)` calls regardless of where the file lives. The folder structure above is a convention, not a requirement.
+  **Die Dateiorganisation liegt bei Ihnen.** Die Entitätserkennung ist AST-basiert — das SDK findet Aufrufe von `export default defineEntity(...)`, unabhängig davon, wo sich die Datei befindet. Die obige Ordnerstruktur ist eine Konvention, keine Anforderung.
 </Note>

-## Entity types
+## Entitätstypen

-| Entity                   | Purpose                                    | Docs                                                                          |
-| ------------------------ | ------------------------------------------ | ----------------------------------------------------------------------------- |
-| **Application**          | App identity, default role, variables      | [Application Config](/l/de/developers/extend/apps/config/application)              |
-| **Role**                 | Permission sets on objects and fields      | [Roles & Permissions](/l/de/developers/extend/apps/config/roles)                   |
-| **Object**               | Custom record types with fields            | [Objects](/l/de/developers/extend/apps/data/objects)                               |
-| **Field**                | Add fields to objects from other apps      | [Extending Objects](/l/de/developers/extend/apps/data/extending-objects)           |
-| **Relation**             | Bidirectional links between objects        | [Relations](/l/de/developers/extend/apps/data/relations)                           |
-| **Logic Function**       | Server-side TypeScript with triggers       | [Logic Functions](/l/de/developers/extend/apps/logic/logic-functions)              |
-| **Skill**                | Reusable AI agent instructions             | [Skills & Agents](/l/de/developers/extend/apps/logic/skills-and-agents)            |
-| **Agent**                | AI assistants with custom prompts          | [Skills & Agents](/l/de/developers/extend/apps/logic/skills-and-agents)            |
-| **Connection Provider**  | OAuth credentials for third-party APIs     | [Connections](/l/de/developers/extend/apps/logic/connections)                      |
-| **View**                 | Pre-configured record list views           | [Views](/l/de/developers/extend/apps/layout/views)                                 |
-| **Navigation Menu Item** | Custom sidebar entries                     | [Navigation Menu Items](/l/de/developers/extend/apps/layout/navigation-menu-items) |
-| **Page Layout**          | Tabs and widgets on a record's detail page | [Page Layouts](/l/de/developers/extend/apps/layout/page-layouts)                   |
-| **Front Component**      | Sandboxed React UI inside Twenty           | [Front Components](/l/de/developers/extend/apps/layout/front-components)           |
-| **Command Menu Item**    | Quick actions and Cmd+K entries            | [Command Menu Items](/l/de/developers/extend/apps/layout/command-menu-items)       |
+| Entität                    | Zweck                                                      | Dokumentation                                                                   |
+| -------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| **Anwendung**              | App-Identität, Standardrolle, Variablen                    | [Application Config](/l/de/developers/extend/apps/config/application)                |
+| **Rolle**                  | Berechtigungssätze für Objekte und Felder                  | [Roles & Permissions](/l/de/developers/extend/apps/config/roles)                     |
+| **Objekt**                 | Benutzerdefinierte Datensatztypen mit Feldern              | [Objekte](/l/de/developers/extend/apps/data/objects)                                 |
+| **Feld**                   | Felder zu Objekten aus anderen Apps hinzufügen             | [Extending Objects](/l/de/developers/extend/apps/data/extending-objects)             |
+| **Beziehung**              | Bidirektionale Verknüpfungen zwischen Objekten             | [Beziehungen](/l/de/developers/extend/apps/data/relations)                           |
+| **Logikfunktion**          | Serverseitiges TypeScript mit Triggern                     | [Logikfunktionen](/l/de/developers/extend/apps/logic/logic-functions)                |
+| **Skill**                  | Wiederverwendbare Anweisungen für KI-Agenten               | [Skills & Agenten](/l/de/developers/extend/apps/logic/skills-and-agents)             |
+| **Agent**                  | KI-Assistenten mit benutzerdefinierten Prompts             | [Skills & Agenten](/l/de/developers/extend/apps/logic/skills-and-agents)             |
+| **Verbindungsanbieter**    | OAuth-Zugangsdaten für Drittanbieter-APIs                  | [Connections](/l/de/developers/extend/apps/logic/connections)                        |
+| **Ansicht**                | Vorkonfigurierte Listenansichten für Datensätze            | [Ansichten](/l/de/developers/extend/apps/layout/views)                               |
+| **Navigationsmenüeintrag** | Benutzerdefinierte Seitenleisten-Einträge                  | [Navigationsmenüeinträge](/l/de/developers/extend/apps/layout/navigation-menu-items) |
+| **Seitenlayout**           | Tabs und Widgets auf der Detailseite eines Datensatzes     | [Seiten-Layouts](/l/de/developers/extend/apps/layout/page-layouts)                   |
+| **Frontend-Komponente**    | Gedisplayte React-UI in einer Sandbox innerhalb von Twenty | [Frontend-Komponenten](/l/de/developers/extend/apps/layout/front-components)         |
+| **Befehlsmenü-Eintrag**    | Schnellaktionen und Cmd+K-Einträge                         | [Befehlsmenü-Einträge](/l/de/developers/extend/apps/layout/command-menu-items)       |

 ## Sandboxing

-* **Logic functions** run in isolated Node.js processes on the server. They only access data through the typed API client, scoped to the app's role permissions.
-* **Front components** run in Web Workers using Remote DOM — sandboxed from the main page but rendering native DOM elements (not iframes). They communicate with Twenty via a message-passing host API.
-* **Permissions** are enforced at the API level. The runtime token (`TWENTY_APP_ACCESS_TOKEN`) is derived from the role defined in `defineApplication()`.
+* **Logikfunktionen** laufen in isolierten Node.js-Prozessen auf dem Server. Sie greifen nur über den typisierten API-Client auf Daten zu, begrenzt durch die Rollenberechtigungen der App.
+* **Frontend-Komponenten** laufen in Web Workers mit Remote DOM — von der Hauptseite isoliert, rendern aber native DOM-Elemente (keine iframes). Sie kommunizieren über eine Message-Passing-Host-API mit Twenty.
+* **Berechtigungen** werden auf API-Ebene durchgesetzt. Das Laufzeit-Token (`TWENTY_APP_ACCESS_TOKEN`) wird aus der in `defineApplication()` definierten Rolle abgeleitet.

-## App lifecycle
+## App-Lebenszyklus

 ```
 ┌─────────────────────────────────────────────────────────┐
@@ -76,26 +76,26 @@ your-app/
 └─────────────────────────────────────────────────────────┘
 ```

-* **`yarn twenty dev`** — watches your source files and live-syncs changes to a connected Twenty server. The typed API client is regenerated automatically when the schema changes.
-* **`yarn twenty build`** — compiles TypeScript, bundles logic functions and front components with esbuild, and produces a manifest.
-* **Pre/post-install hooks** — optional functions that run during installation. See [Install Hooks](/l/de/developers/extend/apps/config/install-hooks) for details.
+* **`yarn twenty dev`** — überwacht Ihre Quelldateien und synchronisiert Änderungen in Echtzeit mit einem verbundenen Twenty-Server. Der typisierte API-Client wird automatisch neu erzeugt, wenn sich das Schema ändert.
+* **`yarn twenty build`** — kompiliert TypeScript, bündelt Logikfunktionen und Frontend-Komponenten mit esbuild und erzeugt ein Manifest.
+* **Pre/Post-Install-Hooks** — optionale Funktionen, die während der Installation ausgeführt werden. Details finden Sie unter [Install Hooks](/l/de/developers/extend/apps/config/install-hooks).

-## Next steps
+## Nächste Schritte

 <CardGroup cols={2}>
-  <Card title="Config" icon="screwdriver-wrench" href="/l/de/developers/extend/apps/config/overview">
-    Application identity, default role, and install hooks.
+  <Card title="Konfiguration" icon="screwdriver-wrench" href="/l/de/developers/extend/apps/config/overview">
+    App-Identität, Standardrolle und Install-Hooks.
  </Card>
-  <Card title="Data" icon="database" href="/l/de/developers/extend/apps/data/overview">
-    Objects, fields, and bidirectional relations.
+  <Card title="Daten" icon="database" href="/l/de/developers/extend/apps/data/overview">
+    Objekte, Felder und bidirektionale Relationen.
  </Card>
-  <Card title="Logic" icon="bolt" href="/l/de/developers/extend/apps/logic/overview">
-    Logic functions, skills, agents, and OAuth connections.
+  <Card title="Logik" icon="bolt" href="/l/de/developers/extend/apps/logic/overview">
+    Logikfunktionen, Skills, Agents und OAuth-Verbindungen.
  </Card>
  <Card title="Layout" icon="table-columns" href="/l/de/developers/extend/apps/layout/overview">
-    Views, navigation, page layouts, front components.
+    Ansichten, Navigation, Seiten-Layouts, Front-Komponenten.
  </Card>
-  <Card title="Operations" icon="rocket" href="/l/de/developers/extend/apps/operations/overview">
-    CLI, testing, remotes, CI, and publishing your app.
+  <Card title="Operationen" icon="rocket" href="/l/de/developers/extend/apps/operations/overview">
+    CLI, Tests, Remotes, CI und das Veröffentlichen Ihrer App.
  </Card>
 </CardGroup>