82 lines
5.1 KiB
Plaintext
82 lines
5.1 KiB
Plaintext
---
|
|
title: App di Twenty
|
|
description: Crea e gestisci le personalizzazioni di Twenty come codice.
|
|
---
|
|
|
|
<Warning>
|
|
Le app sono attualmente in fase alfa. La funzionalità funziona ma è ancora in evoluzione.
|
|
</Warning>
|
|
|
|
## Cosa sono le app?
|
|
|
|
Le app ti consentono di estendere Twenty con oggetti, campi, funzioni logiche, componenti front-end, competenze IA e altro ancora — il tutto gestito come codice. Invece di configurare tutto tramite l'interfaccia utente, definisci in TypeScript il modello dati e la logica e li distribuisci in uno o più spazi di lavoro.
|
|
|
|
**Cosa puoi creare:**
|
|
|
|
* **Oggetti e campi personalizzati** — estendi il tuo modello dati con nuove entità o aggiungi campi a oggetti esistenti come Company o Person
|
|
* **Funzioni logiche** — funzioni lato server attivate da eventi del database, pianificazioni cron o route HTTP
|
|
* **Componenti front-end** — componenti React che vengono renderizzati nell'interfaccia utente di Twenty (pagine dei record, menu dei comandi, pannelli laterali)
|
|
* **Competenze e agenti IA** — estendi l'IA di Twenty con funzionalità personalizzate
|
|
* **Viste e navigazione** — viste salvate preconfigurate e link nella barra laterale
|
|
|
|
## Avvio rapido
|
|
|
|
```bash filename="Terminal"
|
|
npx create-twenty-app@latest my-twenty-app
|
|
cd my-twenty-app
|
|
yarn twenty dev
|
|
```
|
|
|
|
Questo genera lo scheletro di una nuova app, avvia facoltativamente un server Twenty locale e inizia a monitorare i tuoi file per le modifiche. Consulta la [Guida introduttiva](/l/it/developers/extend/apps/getting-started) per l'intera procedura.
|
|
|
|
## Guide dettagliate
|
|
|
|
| Guide | Descrizione |
|
|
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| [Guida introduttiva](/l/it/developers/extend/apps/getting-started) | Crea lo scheletro di un'app, configura un server locale, struttura del progetto, CI |
|
|
| [Creare app](/l/it/developers/extend/apps/building) | Definizioni di entità (`defineObject`, `defineLogicFunction`, `defineFrontComponent`, ecc.), client API, pacchetti npm, asset pubblici, test |
|
|
| [Pubblicazione](/l/it/developers/extend/apps/publishing) | Distribuisci su un server, pubblica su npm, marketplace |
|
|
|
|
## Concetti chiave
|
|
|
|
### Rilevamento delle entità
|
|
|
|
L'SDK rileva le entità scansionando i tuoi file TypeScript alla ricerca di chiamate a `export default define<Entity>({...})`. La denominazione dei file e la struttura delle cartelle sono flessibili — il rilevamento è basato sull'AST, non sui percorsi.
|
|
|
|
### Tipi di entità disponibili
|
|
|
|
| Funzione | Scopo |
|
|
| ---------------------------------- | ------------------------------------------------------ |
|
|
| `defineApplication()` | Metadati dell'applicazione (obbligatorio, uno per app) |
|
|
| `defineObject()` | Oggetti personalizzati con campi |
|
|
| `defineField()` | Campi su oggetti esistenti |
|
|
| `defineLogicFunction()` | Logica lato server con trigger |
|
|
| `defineFrontComponent()` | Componenti React nell'interfaccia utente di Twenty |
|
|
| `defineRole()` | Ruoli di autorizzazione |
|
|
| `defineView()` | Configurazioni di viste salvate |
|
|
| `defineNavigationMenuItem()` | Link di navigazione della barra laterale |
|
|
| `defineSkill()` | Competenze dell'agente IA |
|
|
| `defineAgent()` | Agenti IA con prompt |
|
|
| `definePageLayout()` | Layout personalizzati delle pagine dei record |
|
|
| `definePreInstallLogicFunction()` | Viene eseguito prima dell'installazione dell'app |
|
|
| `definePostInstallLogicFunction()` | Viene eseguito dopo l'installazione dell'app |
|
|
|
|
### Flusso di lavoro di sviluppo
|
|
|
|
1. **`yarn twenty dev`** — osserva i file sorgente, ricompila alle modifiche, sincronizza con il server, genera client API tipizzati
|
|
2. **`yarn twenty build`** — produce una build distribuibile
|
|
3. **`yarn twenty deploy`** — distribuisce su un server Twenty remoto
|
|
4. **`yarn twenty add`** — crea lo scheletro di una nuova entità in modo interattivo
|
|
|
|
### Riferimento 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
|
|
```
|
|
|
|
Consulta la [Guida introduttiva](/l/it/developers/extend/apps/getting-started) per il riferimento completo della CLI.
|