82 lines
5.4 KiB
Plaintext
82 lines
5.4 KiB
Plaintext
---
|
||
title: Twenty Uygulamaları
|
||
description: Twenty özelleştirmelerini kod olarak oluşturun ve yönetin.
|
||
---
|
||
|
||
<Warning>
|
||
Uygulamalar şu anda alfa aşamasında. Özellik işlevsel ancak hâlâ gelişmekte.
|
||
</Warning>
|
||
|
||
## Uygulamalar Nedir?
|
||
|
||
Uygulamalar, Twenty'yi özel nesneler, alanlar, mantık işlevleri, ön yüz bileşenleri, yapay zekâ yetenekleri ve daha fazlasıyla genişletmenizi sağlar — tümü kod olarak yönetilir. Her şeyi UI üzerinden yapılandırmak yerine, veri modelinizi ve mantığınızı TypeScript'te tanımlar ve bunu bir veya daha fazla çalışma alanına dağıtırsınız.
|
||
|
||
**Oluşturabilecekleriniz:**
|
||
|
||
* **Özel nesneler ve alanlar** — veri modelinizi yeni varlıklarla genişletin veya Şirket ya da Kişi gibi mevcut nesnelere alanlar ekleyin
|
||
* **Mantık işlevleri** — veritabanı olayları, cron zamanlamaları veya HTTP rotaları tarafından tetiklenen sunucu tarafı işlevler
|
||
* **Ön yüz bileşenleri** — Twenty'nin kullanıcı arayüzünde (kayıt sayfaları, komut menüsü, yan paneller) görüntülenen React bileşenleri
|
||
* **Yapay zekâ yetenekleri ve ajanları** — Twenty'nin yapay zekâsını özel yeteneklerle genişletin
|
||
* **Görünümler ve gezinme** — önceden yapılandırılmış kaydedilmiş görünümler ve kenar çubuğu bağlantıları
|
||
|
||
## Hızlı Başlangıç
|
||
|
||
```bash filename="Terminal"
|
||
npx create-twenty-app@latest my-twenty-app
|
||
cd my-twenty-app
|
||
yarn twenty dev
|
||
```
|
||
|
||
Bu, yeni bir uygulamanın iskeletini oluşturur, isteğe bağlı olarak yerel bir Twenty sunucusunu başlatır ve dosyalarınızdaki değişiklikleri izlemeye başlar. Tam adım adım anlatım için [Başlarken](/l/tr/developers/extend/apps/getting-started) kılavuzuna bakın.
|
||
|
||
## Ayrıntılı kılavuzlar
|
||
|
||
| Kılavuz | Açıklama |
|
||
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| [Başlarken](/l/tr/developers/extend/apps/getting-started) | Bir uygulamanın iskeletini oluşturun, yerel bir sunucu kurun, proje yapısı, CI |
|
||
| [Uygulama Oluşturma](/l/tr/developers/extend/apps/building) | Varlık tanımları (`defineObject`, `defineLogicFunction`, `defineFrontComponent` vb.), API istemcileri, npm paketleri, genel varlıklar, test |
|
||
| [Yayınlama](/l/tr/developers/extend/apps/publishing) | Bir sunucuya dağıtın, npm'e ve pazaryerine yayınlayın |
|
||
|
||
## Temel Kavramlar
|
||
|
||
### Varlık algılama
|
||
|
||
SDK, TypeScript dosyalarınızı `export default define<Entity>({...})` çağrılarını tarayarak varlıkları algılar. Dosya adlandırması ve klasör yapısı esnektir — algılama AST tabanlıdır, yol tabanlı değildir.
|
||
|
||
### Kullanılabilir varlık türleri
|
||
|
||
| Fonksiyon | Amaç |
|
||
| ---------------------------------- | ---------------------------------------------------------- |
|
||
| `defineApplication()` | Uygulama meta verileri (zorunlu, uygulama başına bir adet) |
|
||
| `defineObject()` | Alanlara sahip özel nesneler |
|
||
| `defineField()` | Mevcut nesnelerde alanlar |
|
||
| `defineLogicFunction()` | Tetikleyicilerle sunucu tarafı mantık |
|
||
| `defineFrontComponent()` | Twenty'nin kullanıcı arayüzündeki React bileşenleri |
|
||
| `defineRole()` | İzin rolleri |
|
||
| `defineView()` | Kaydedilmiş görünüm yapılandırmaları |
|
||
| `defineNavigationMenuItem()` | Kenar çubuğu gezinme bağlantıları |
|
||
| `defineSkill()` | Yapay zekâ ajanı yetenekleri |
|
||
| `defineAgent()` | İstemlerle yapay zekâ ajanları |
|
||
| `definePageLayout()` | Özel kayıt sayfası düzenleri |
|
||
| `definePreInstallLogicFunction()` | Uygulama kurulmadan önce çalışır |
|
||
| `definePostInstallLogicFunction()` | Uygulama kurulduktan sonra çalışır |
|
||
|
||
### Geliştirme iş akışı
|
||
|
||
1. **`yarn twenty dev`** — kaynak dosyaları izler, değişiklikte yeniden derler, sunucuyla senkronize eder, tipli API istemcileri üretir
|
||
2. **`yarn twenty build`** — dağıtılabilir bir derleme üretir
|
||
3. **`yarn twenty deploy`** — uzak bir Twenty sunucusuna dağıtır
|
||
4. **`yarn twenty add`** — etkileşimli olarak yeni bir varlık iskeleti oluşturur
|
||
|
||
### CLI başvurusu
|
||
|
||
```bash filename="Terminal"
|
||
yarn twenty help # Tüm komutları listele
|
||
yarn twenty server start # Yerel geliştirme sunucusunu başlat
|
||
yarn twenty remote add # Bir Twenty sunucusuna bağlan
|
||
yarn twenty exec -n fn # Bir mantık fonksiyonunu çalıştır
|
||
yarn twenty logs -n fn # Fonksiyon günlüklerini izle
|
||
```
|
||
|
||
Tam CLI başvuru rehberi için [Başlarken](/l/tr/developers/extend/apps/getting-started) kılavuzuna bakın.
|