Kavramlar

Twenty uygulamaları, çalışma alanınızı özel nesneler, mantık, UI bileşenleri ve yapay zekâ yetenekleriyle genişleten TypeScript paketleridir. Tam korumalı alan ve izin kontrolleriyle Twenty platformunda çalışırlar.

Uygulamalar nasıl çalışır

Bir uygulama, twenty-sdk paketindeki defineEntity() işlevleri kullanılarak bildirilen varlıklar koleksiyonudur. SDK, bu bildirimleri derleme sırasında AST analiziyle algılar ve bir manifest üretir — uygulamanızın bir çalışma alanına neler eklediğinin eksiksiz bir açıklaması. Bu işlevler, derleme zamanında yapılandırmanızı doğrular ve IDE otomatik tamamlama ile tür güvenliği sağlar.

your-app/
├── src/
│   ├── application-config.ts    ← defineApplication (required, one per app)
│   ├── roles/                   ← defineRole
│   ├── objects/                 ← defineObject
│   ├── fields/                  ← defineField
│   ├── logic-functions/         ← defineLogicFunction
│   ├── front-components/        ← defineFrontComponent
│   ├── skills/                  ← defineSkill
│   ├── agents/                  ← defineAgent
│   ├── views/                   ← defineView
│   ├── navigation-menu-items/   ← defineNavigationMenuItem
│   └── page-layouts/            ← definePageLayout
├── public/                      ← Static assets (images, icons)
└── package.json

Dosya organizasyonu size kalmış. Varlık algılama AST tabanlıdır — dosyanın nerede bulunduğundan bağımsız olarak SDK export default defineEntity(...) çağrılarını bulur. Yukarıdaki klasör yapısı bir gelenektir, zorunluluk değildir.

Varlık türleri

Varlık	Amaç	Belgeler
Uygulama	Uygulama kimliği, varsayılan rol, değişkenler	Uygulama Yapılandırması
Rol	Nesneler ve alanlar üzerindeki izin kümeleri	Roller ve İzinler
Nesne	Alanlara sahip özel kayıt türleri	Nesneler
Alan	Diğer uygulamalardaki nesnelere alan ekleyin	Nesneleri Genişletme
İlişki	Nesneler arasındaki çift yönlü bağlantılar	İlişkiler
Mantık İşlevi	Tetikleyicilerle sunucu tarafı TypeScript	Mantıksal İşlevler
Beceri	Yeniden kullanılabilir yapay zekâ temsilcisi yönergeleri	Beceriler ve Temsilciler
Temsilci	Özel istemlere sahip yapay zekâ asistanları	Beceriler ve Temsilciler
Bağlantı Sağlayıcısı	Üçüncü taraf API’ler için OAuth kimlik bilgileri	Bağlantılar
Görünüm	Önceden yapılandırılmış kayıt listesi görünümleri	Görünümler
Gezinme Menüsü Öğesi	Özel kenar çubuğu öğeleri	Gezinme Menüsü Öğeleri
Sayfa Düzeni	Bir kaydın ayrıntı sayfasındaki sekmeler ve widget’lar	Sayfa Düzenleri
Ön Uç Bileşeni	Twenty içinde korumalı alandaki React kullanıcı arayüzü	Ön Uç Bileşenleri
Komut Menüsü Öğesi	Hızlı işlemler ve Cmd+K girdileri	Komut Menüsü Öğeleri

Korumalı alan

Mantık işlevleri sunucuda yalıtılmış Node.js işlemlerinde çalışır. Verilere yalnızca, kapsamı uygulamanın rol izinleriyle sınırlandırılmış tipli API istemcisi üzerinden erişirler.
Ön uç bileşenleri, Remote DOM kullanan Web Worker’larda çalışır — ana sayfadan yalıtılmıştır ancak yerel DOM öğelerini (iframe’ler değil) oluşturur. Twenty ile mesaj iletimi yapan bir ana makine API’si aracılığıyla iletişim kurarlar.
İzinler, API düzeyinde uygulanır. Çalışma zamanı belirteci (TWENTY_APP_ACCESS_TOKEN), defineApplication() içinde tanımlanan rolden türetilir.

Uygulama yaşam döngüsü

┌─────────────────────────────────────────────────────────┐
│ Development                                             │
│   npx create-twenty-app → yarn twenty dev (live sync)   │
├─────────────────────────────────────────────────────────┤
│ Build & Deploy                                          │
│   yarn twenty dev:build → yarn twenty app:publish        │
├─────────────────────────────────────────────────────────┤
│ Install flow                                            │
│   upload → [pre-install] → metadata migration →         │
│   generate SDK → [post-install] → … → [uninstall]       │
├─────────────────────────────────────────────────────────┤
│ Publish                                                 │
│   npm publish → appears in Twenty marketplace           │
└─────────────────────────────────────────────────────────┘

yarn twenty dev — kaynak dosyalarınızı izler ve bağlı bir Twenty sunucusuna değişiklikleri canlı olarak senkronize eder. Şema değiştiğinde tipli API istemcisi otomatik olarak yeniden oluşturulur.
yarn twenty dev:build — TypeScript’i derler, mantık işlevlerini ve ön uç bileşenlerini esbuild ile paketler ve bir manifest üretir.
Kurulum öncesi/sonrası ve kaldırma kancaları — kurulum sırasında veya kaldırılmadan hemen önce çalışan isteğe bağlı işlevler. Ayrıntılar için Kurulum Kancaları bölümüne bakın.

Sonraki adımlar

Yapılandırma

Uygulama kimliği, varsayılan rol ve kurulum ile kaldırma kancaları.

Veri

Nesneler, alanlar ve çift yönlü ilişkiler.

Mantık

Mantık işlevleri, beceriler, temsilciler ve OAuth bağlantıları.

Düzen

Görünümler, gezinme, sayfa düzenleri, ön uç bileşenleri.

İşlemler

CLI, test, uzak depolar, CI ve uygulamanızı yayımlama.

Genel Bakış

Uygulamalar

API

Kendi Kendine Barındırma

Katkıda Bulunun

Uygulamalar nasıl çalışır

Varlık türleri

Korumalı alan

Uygulama yaşam döngüsü

Sonraki adımlar

Yapılandırma

Veri

Mantık

Düzen

İşlemler

​Uygulamalar nasıl çalışır

​Varlık türleri

​Korumalı alan

​Uygulama yaşam döngüsü

​Sonraki adımlar

Yapılandırma

Veri

Mantık

Düzen

İşlemler

Uygulamalar nasıl çalışır

Varlık türleri

Korumalı alan

Uygulama yaşam döngüsü

Sonraki adımlar