Concepte

Cum funcționează aplicațiile

O aplicație este o colecție de entități declarate folosind funcțiile defineEntity() din pachetul twenty-sdk. CLI detectează aceste declarații prin intermediul analizei AST la momentul creării și produce un manifest — o descriere completă a ceea ce aplicația ta adaugă la un spațiu de lucru. Aceste funcții validează configurația în timpul build-ului și oferă completare automată în IDE și siguranța tipurilor.

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

Organizarea fișierelor depinde de tine. Detectarea entității este bazată pe AST - SDK găsește `export default defineEntity(. .)” apelează indiferent de locul unde trăieşte fişierul . Structura de foldere de mai sus este o convenție, nu o cerință.

Tipuri de entități

Entitate	Scop	Documentație
Aplicație	Identitatea aplicației, rolul implicit, variabile	Application Config
Rol	Seturi de permisiuni pentru obiecte și câmpuri	Roles & Permissions
Obiect	Tipuri de înregistrări personalizate cu câmpuri	Objects
Câmp	Adăugați câmpuri la obiecte din alte aplicații	Extending Objects
Relație	Legături bidirecționale între obiecte	Relations
Regulă de validare	Condiții pe care o înregistrare trebuie să le îndeplinească înainte de a putea fi salvată	Reguli de validare
Funcție logică	TypeScript pe partea de server cu declanșatoare	Funcții logice
Abilitate	Instrucțiuni reutilizabile pentru agenți AI	Abilități și agenți
Agent	Agenți AI cu prompturi personalizate	Abilități și agenți
Flux de lucru	Fluxuri de lucru gata făcute cu un declanșator și pași	Workflows
Furnizor de conexiune	OAuth sau conectare personalizată pentru conturi terțe	Connections
Furnizor de mesagerie	Trimite răspunsuri de pe canalele de mesagerie ale unei aplicații printr-o conexiune	Canale de mesagerie
Server MCP	Server MCP extern pe care AI-ul spațiului de lucru îl poate apela	Abilități și agenți
Vizualizare	Vizualizări preconfigurate ale listelor de înregistrări	Views
Element de meniu de navigare	Intrări personalizate în bara laterală	Navigation Menu Items
Layout pagină	File și widgeturi pe pagina de detalii a unei înregistrări	Page Layouts
Componentă front-end	Interfață React izolată (sandboxed) în Twenty	Componente front-end
Dependențe partajate	Dependențele partajate de componentele front-end ale aplicației, declarate în package.json	Dependențe partajate
Element din meniul de comenzi	Acțiuni rapide și intrări Cmd+K	Command Menu Items
Setari meniu element	Intră în meniul de setări al aplicației, fiecare redare a componentei din față	Setări meniu elemente

Izolare (sandboxing)

Funcțiile logice rulează în procese Node.js izolate pe server. Accesează datele doar prin intermediul clientului tastat API, care acționează fie ca persoană care a declanșat rularea, fie ca aplicație în sine. Vezi Cine accesează un apel utilizat.
Componentele front-end rulează în Web Workers folosind Remote DOM — izolate de pagina principală, dar randând elemente DOM native (nu iframes). Acestea comunică cu Twenty printr-un API al gazdei bazat pe transmiterea de mesaje.
Permisiunile sunt aplicate la nivelul API-ului. Două tokeni runtime sunt injectaţi, ambele derivate din rolul declarat cu `defineApplicationRole()”; cea implicită este îngustată și mai mult la ceea ce persoana declanșatoare poate face ori de câte ori cineva se află în spatele rulării.

Ciclul de viață al aplicației

┌─────────────────────────────────────────────────────────┐
│ 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           │
└─────────────────────────────────────────────────────────┘

douăzeci de aplicații dev — îți urmărește fișierele sursă și modificările live-syncs la un server conectat. După o sincronizare reușită, regenerează clientul API tipizat atunci când schema sau pachetul generator instalat s-au modificat ori când fișierele client generate lipsesc sau au fost modificate. Pentru a reîmprospăta tipurile după schimbarea spațiului de lucru în interfața cu utilizatorul, rulează twenty app generate-client.
douăzeci de aplicații construite — compilează TypeScript, împachetează funcțiile logice și componentele frontale cu esbuild, și produce un manifest.
Hook-uri pre/post-instalare și dezinstalare — funcții opționale care rulează în timpul instalării sau chiar înainte de eliminare. Vezi Install Hooks pentru detalii.

Pașii următori

Configurați

Identitatea aplicației, rolul implicit, și instalați și dezinstalați hook-uri.

Date

Obiecte, domenii și relații bidirecționale.

Logic

Funcții de logică, competențe, agenți, conexiuni și canale de mesagerie.

Layout

vizualizări, navigare, layout-uri de pagini, componente din față.

Operații

CLI, testare, telecomenzi, CI și publicarea aplicației tale.

Dezvoltatori

Aplicații

API

Autogazda

Contribuie

Biblioteca UI

Cum funcționează aplicațiile

Tipuri de entități

Izolare (sandboxing)

Ciclul de viață al aplicației

Pașii următori

​Cum funcționează aplicațiile

​Tipuri de entități

​Izolare (sandboxing)

​Ciclul de viață al aplicației

​Pașii următori

Cum funcționează aplicațiile

Tipuri de entități

Izolare (sandboxing)

Ciclul de viață al aplicației

Pașii următori