De ce există aplicații
Fluxurile de lucru acoperă automatizările fără cod. Dar unele lucruri au nevoie de cod: un motor de stabilire a prețurilor personalizat, un pipeline proprietar de îmbogățire a datelor, o verificare de conformitate care rulează la fiecare actualizare de înregistrare, un panou UI personalizat care preia date dintr-un instrument intern. Aplicațiile vă permit să le construiți ca extensii de primă clasă — nu scripturi fragile care comunică cu un API din exterior, ci cod care rulează pe platformă, cu acces complet la sistemul de tipuri, modelul de permisiuni și UI.Ce poate defini o aplicație
O aplicație este un pachet TypeScript care declară entități folosindtwenty-sdk:
| Entitate | Ce face |
|---|---|
| Obiecte și câmpuri | Tabele de date noi și câmpuri pe obiectele existente — același tratament ca pentru cele încorporate. |
| Funcții logice | TypeScript pe server declanșat de rute HTTP, programări cron sau evenimente din baza de date |
| Componente front-end | Componente React sandboxate care se afișează în UI-ul Twenty (panou lateral, widgeturi, meniul de comenzi). |
| Abilități și agenți | Capabilități AI — instrucțiuni reutilizabile și asistenți autonomi |
| Vizualizări și navigare | Vizualizări de listă preconfigurate și elemente de meniu în bara laterală |
export default defineObject(...) în orice fișier .ts și SDK-ul îl va detecta.
Cum rulează
- Funcțiile logice se execută în procese Node.js izolate, sandboxate față de gazdă. Acestea accesează datele printr-un client API tipizat, limitat de permisiunile rolului aplicației.
- Componentele front-end rulează în Web Workers folosind Remote DOM — izolate de pagina principală, dar randând elemente DOM native (nu iframes).
- Permisiunile sunt aplicate la nivelul API-ului. O aplicație vede doar ceea ce îi permite rolul său.
Experiența dezvoltatorului
Scrieți aplicația ca un proiect TypeScript pe mașina dvs. CLI-ul urmărește fișierele sursă și le sincronizează în timp real cu un server Twenty care rulează — editați un fișier și vedeți modificarea în UI în mai puțin de o secundă. Clientul API tipizat este regenerat automat atunci când schema se schimbă. Când sunteți gata,yarn twenty app:publish --private publică pe un server de producție, sau yarn twenty app:publish vă listează aplicația pe npm și în marketplace-ul Twenty.
Creați prima dvs. aplicație
Ghid în trei etape — generați scheletul, rulați un server local, sincronizați modificările.