82 lines
5.0 KiB
Plaintext
82 lines
5.0 KiB
Plaintext
---
|
|
title: Aplikace Twenty
|
|
description: Vytvářejte a spravujte přizpůsobení Twenty jako kód.
|
|
---
|
|
|
|
<Warning>
|
|
Aplikace jsou aktuálně v alfa fázi. Funkce funguje, ale stále se vyvíjí.
|
|
</Warning>
|
|
|
|
## Co jsou aplikace?
|
|
|
|
Aplikace vám umožňují rozšířit Twenty o vlastní objekty, pole, logické funkce, front-endové komponenty, AI schopnosti a další — vše je spravováno jako kód. Místo konfigurace všeho přes uživatelské rozhraní definujete v TypeScriptu svůj datový model a logiku a nasadíte je do jednoho nebo více pracovních prostorů.
|
|
|
|
**Co můžete vytvořit:**
|
|
|
|
* **Vlastní objekty a pole** — rozšiřte svůj datový model o nové entity nebo přidejte pole k existujícím objektům, jako jsou Společnost nebo Osoba
|
|
* **Logické funkce** — serverové funkce spouštěné událostmi v databázi, plány cronu nebo HTTP routami
|
|
* **Front-endové komponenty** — komponenty Reactu, které se vykreslují v uživatelském rozhraní Twenty (stránky záznamů, příkazová nabídka, postranní panely)
|
|
* **Dovednosti AI a agenti** — rozšiřte AI v Twenty o vlastní možnosti
|
|
* **Zobrazení a navigace** — předkonfigurovaná uložená zobrazení a odkazy v postranním panelu
|
|
|
|
## Rychlý start
|
|
|
|
```bash filename="Terminal"
|
|
npx create-twenty-app@latest my-twenty-app
|
|
cd my-twenty-app
|
|
yarn twenty dev
|
|
```
|
|
|
|
Tímto se vytvoří kostra nové aplikace, volitelně se spustí lokální server Twenty a začne sledovat změny ve vašich souborech. Podrobný postup najdete v průvodci [Začínáme](/l/cs/developers/extend/apps/getting-started).
|
|
|
|
## Podrobné návody
|
|
|
|
| Průvodce | Popis |
|
|
| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| [Začínáme](/l/cs/developers/extend/apps/getting-started) | Vytvoření kostry aplikace, nastavení lokálního serveru, struktura projektu, CI |
|
|
| [Tvorba aplikací](/l/cs/developers/extend/apps/building) | Definice entit (`defineObject`, `defineLogicFunction`, `defineFrontComponent` atd.), klienti API, balíčky npm, veřejná aktiva, testování |
|
|
| [Publikování](/l/cs/developers/extend/apps/publishing) | Nasazení na server, publikování na npm, tržiště |
|
|
|
|
## Klíčové pojmy
|
|
|
|
### Detekce entit
|
|
|
|
SDK detekuje entity prohledáváním vašich souborů TypeScript a hledá volání `export default define<Entity>({...})`. Pojmenování souborů a struktura složek jsou flexibilní — detekce je založená na AST, nikoli na cestách.
|
|
|
|
### Dostupné typy entit
|
|
|
|
| Funkce | Účel |
|
|
| ---------------------------------- | ------------------------------------------------ |
|
|
| `defineApplication()` | Metadata aplikace (povinné, jedno na aplikaci) |
|
|
| `defineObject()` | Vlastní objekty s poli |
|
|
| `defineField()` | Pole u existujících objektů |
|
|
| `defineLogicFunction()` | Serverová logika se spouštěči |
|
|
| `defineFrontComponent()` | Komponenty Reactu v uživatelském rozhraní Twenty |
|
|
| `defineRole()` | Role oprávnění |
|
|
| `defineView()` | Konfigurace uložených zobrazení |
|
|
| `defineNavigationMenuItem()` | Odkazy postranní navigace |
|
|
| `defineSkill()` | Dovednosti agenta AI |
|
|
| `defineAgent()` | AI agenti s prompty |
|
|
| `definePageLayout()` | Vlastní rozvržení stránek záznamu |
|
|
| `definePreInstallLogicFunction()` | Spouští se před instalací aplikace |
|
|
| `definePostInstallLogicFunction()` | Spouští se po instalaci aplikace |
|
|
|
|
### Vývojový postup
|
|
|
|
1. **`yarn twenty dev`** — sleduje zdrojové soubory, při změně znovu sestaví, synchronizuje se serverem a generuje typované klienty API
|
|
2. **`yarn twenty build`** — vytvoří distribuovatelný build
|
|
3. **`yarn twenty deploy`** — nasadí na vzdálený server Twenty
|
|
4. **`yarn twenty add`** — interaktivně vytvoří kostru nové entity
|
|
|
|
### Referenční dokumentace CLI
|
|
|
|
```bash filename="Terminal"
|
|
yarn twenty help # List all commands
|
|
yarn twenty server start # Start local dev server
|
|
yarn twenty remote add # Connect to a Twenty server
|
|
yarn twenty exec -n fn # Execute a logic function
|
|
yarn twenty logs -n fn # Stream function logs
|
|
```
|
|
|
|
Úplný přehled příkazů CLI najdete v průvodci [Začínáme](/l/cs/developers/extend/apps/getting-started).
|