The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
---
title: Concetti
description: Come funzionano le app Twenty — modello di entità, sandboxing e ciclo di vita dell’installazione.
---
import { PageBanner } from "/snippets/page-banner.mdx"
import { CardTitle } from "/snippets/card-title.mdx"
## Come funzionano le app
Un'app è una raccolta di **entità** dichiarate utilizzando le funzioni `defineEntity()` del pacchetto `twenty-sdk`. Il CLI rileva queste dichiarazioni tramite analisi AST al momento della costruzione e produce un **manifest** — una descrizione completa di ciò che la tua app aggiunge a uno spazio di lavoro. Queste funzioni convalidano la configurazione in fase di build e offrono il completamento automatico nell'IDE e la sicurezza dei tipi.
```
your-app/
├── src/
│ ├── application-config.ts ← defineApplication (required, one per app)
│ ├── roles/ ← defineRole
│ ├── objects/ ← defineObject
│ ├── fields/ ← defineField
│ ├── validation-rules/ ← defineValidationRule
│ ├── logic-functions/ ← defineLogicFunction
│ ├── front-components/ ← defineFrontComponent
│ ├── skills/ ← defineSkill
│ ├── agents/ ← defineAgent
│ ├── mcp-servers/ ← defineMcpServer
│ ├── views/ ← defineView
│ ├── navigation-menu-items/ ← defineNavigationMenuItem
│ ├── settings-menu-items/ ← defineSettingsMenuItem
│ └── page-layouts/ ← definePageLayout
├── public/ ← Static assets (images, icons)
└── package.json
```
<Note>
**L'organizzazione dei file sta a te.** Il rilevamento delle entità è basato su AST — l'SDK
trova `export default defineEntity(. .)` chiamate indipendentemente da dove vive il file
. La struttura delle cartelle sopra è una convenzione, non un requisito.
</Note>
## Tipi di entità
| Entità | Scopo | Documentazione |
| -------------------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Applicazione** | Identità dell’app, ruolo predefinito, variabili | [Configurazione dell’applicazione](/it/developers/extend/apps/config/application) |
| **Ruolo** | Set di autorizzazioni per oggetti e campi | [Ruoli e autorizzazioni](/it/developers/extend/apps/config/roles) |
| **Oggetto** | Tipi di record personalizzati con campi | [Oggetti](/it/developers/extend/apps/data/objects) |
| **Campo** | Aggiungi campi agli oggetti di altre app | [Estensione degli oggetti](/it/developers/extend/apps/data/extending-objects) |
| **Relazione** | Collegamenti bidirezionali tra oggetti | [Relazioni](/it/developers/extend/apps/data/relations) |
| **Regola di convalida** | Condizioni che un record deve soddisfare prima di poter essere salvato | [Regole di convalida](/it/developers/extend/apps/data/validation-rules) |
| **Funzione logica** | TypeScript lato server con trigger | [Funzioni logiche](/it/developers/extend/apps/logic/logic-functions) |
| **Abilità** | Istruzioni riutilizzabili per agenti IA | [Abilità e agenti](/it/developers/extend/apps/logic/skills-and-agents) |
| **Agente** | Assistenti IA con prompt personalizzati | [Abilità e agenti](/it/developers/extend/apps/logic/skills-and-agents) |
| \*\*Flusso Di Lavoro | Flussi di lavoro pronti con un trigger e passi | [Workflows](/it/developers/extend/apps/logic/workflows) |
| **Provider di connessione** | OAuth o accesso personalizzato per account di terze parti | [Connessioni](/it/developers/extend/apps/logic/connections) |
| **Provider di messaggistica** | Invia risposte dai canali di messaggistica di un'app tramite una connessione | [Canali di messaggistica](/it/developers/extend/apps/logic/messaging-channels#sending-replies) |
| **Server MCP** | Server MCP esterno che l'IA dell'area di lavoro può chiamare | [Abilità e agenti](/it/developers/extend/apps/logic/skills-and-agents) |
| **Vista** | Viste di elenco dei record preconfigurate | [Viste](/it/developers/extend/apps/layout/views) |
| **Voce del menu di navigazione** | Voci della barra laterale personalizzate | [Voci del menu di navigazione](/it/developers/extend/apps/layout/navigation-menu-items) |
| **Layout di pagina** | Schede e widget nella pagina dei dettagli di un record | [Layout di pagina](/it/developers/extend/apps/layout/page-layouts) |
| **Componente front-end** | UI React in sandbox all’interno di Twenty | [Componenti front-end](/it/developers/extend/apps/layout/front-components) |
| **Dipendenze condivise** | Dipendenze condivise dai componenti front-end dell'app, dichiarate in package.json | [Dipendenze condivise](/it/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) |
| **Voce del menu comandi** | Azioni rapide e voci Cmd+K | [Voci del menu comandi](/it/developers/extend/apps/layout/command-menu-items) |
| **Elemento Menu Impostazioni** | Voci nel menu delle impostazioni dell'app, ogni rendering di un componente frontale | [Elementi Menu Impostazioni](/it/developers/extend/apps/layout/front-components#settings-menu-items) |
## Sandboxing
* **Le funzioni logiche** vengono eseguite in processi Node.js isolati sul server. Essi accedono solo ai dati attraverso il client API digitato, che agisce sia come la persona che ha innescato la corsa o come l'app stessa. Vedi [Di chi accede a una chiamata](/it/developers/extend/apps/logic/logic-functions#whose-access-a-call-uses).
* **I componenti front-end** vengono eseguiti in Web Workers utilizzando il Remote DOM — isolati dalla pagina principale ma renderizzando elementi DOM nativi (non iframe). Comunicano con Twenty tramite un'API host basata sul passaggio di messaggi.
* **Le autorizzazioni** vengono applicate a livello di API. Vengono iniettati due token di runtime, entrambi derivati dal ruolo dichiarato con `defineApplicationRole()`; quello predefinito si restringe ulteriormente a ciò che la persona che innesca può fare ogni volta che qualcuno è dietro la corsa.
## Ciclo di vita dell'app
```
┌─────────────────────────────────────────────────────────┐
│ Development │
│ twenty app init → twenty app dev (live sync) │
├─────────────────────────────────────────────────────────┤
│ Build & Deploy │
│ twenty app build → twenty app publish │
├─────────────────────────────────────────────────────────┤
│ Install flow │
│ upload → [pre-install] → metadata migration → │
│ generate SDK → [post-install] → … → [uninstall] │
├─────────────────────────────────────────────────────────┤
│ Publish │
│ npm publish → appears in Twenty marketplace │
└─────────────────────────────────────────────────────────┘
```
* **`venti app dev`** — guarda i tuoi file sorgente e le modifiche live syncs in un server Twenty collegato. Dopo una sincronizzazione riuscita, rigenera il client API tipizzato quando lo schema o il pacchetto del generatore installato sono cambiati, oppure quando i file del client generati sono mancanti o modificati. Per aggiornare i tipi dopo aver modificato l'area di lavoro nell'interfaccia utente, esegui `twenty app generate-client`.
* **`venti app build`** — compila TypeScript, raggruppa funzioni logiche e componenti frontali con esbuild, e produce un manifesto.
* **Hook di pre/post-installazione e disinstallazione** — funzioni opzionali che vengono eseguite durante l’installazione o subito prima della rimozione. Vedi [Hook di installazione](/it/developers/extend/apps/config/install-hooks) per i dettagli.
## Prossimi passaggi
<CardGroup cols={2} className="documentation-card-group">
<Card href="/it/developers/extend/apps/config/overview" img="/images/documentation/section-overview-icons-v1/apps-config.svg">
<CardTitle>Config</CardTitle>
Identità dell'applicazione, ruolo predefinito e installa e disinstalla hook.
</Card>
<Card href="/it/developers/extend/apps/data/overview" img="/images/documentation/section-overview-icons-v1/apps-data.svg">
<CardTitle>Data</CardTitle>
Oggetti, campi e relazioni bidirezionali.
</Card>
<Card href="/it/developers/extend/apps/logic/overview" img="/images/documentation/section-overview-icons-v1/apps-logic.svg">
<CardTitle>Logica</CardTitle>
Funzioni logiche, competenze, agenti, connessioni e canali di messaggistica.
</Card>
<Card href="/it/developers/extend/apps/layout/overview" img="/images/user-guide/halftone/layout-window-v1.svg">
<CardTitle>Layout</CardTitle>
Visualizzazioni, navigazione, layout delle pagine, componenti anteriori.
</Card>
<Card href="/it/developers/extend/apps/operations/overview" img="/images/documentation/section-overview-icons-v1/apps-operations.svg">
<CardTitle>Operations</CardTitle>
CLI, testing, remotes, CI, and publishing your app.
</Card>
</CardGroup>
<PageBanner illustration="dev-apps" />