Skip to content

The open alternative to Salesforce, designed for AI.

11.7 KB
Raw Blame
---
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" />