snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,122 @@
---
title: Alanlar
description: Alanların rolünü anlayın ve bunları nasıl yöneteceğinizi öğrenin.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Alanlar Hakkında
Alanlar bir elektronik tablo içindeki sütunlar gibidir. Metin, sayı veya tarih gibi farklı türde verileri depolarlar. Alanlar standart (gömülü) veya özel (kendi oluşturduğunuz) olabilir.
### Standart Alanlar
Standart alanlar, yaygın iş ihtiyaçlarını karşılamak için Twenty ile yerleşik olarak gelir.
Örneğin, `Ad` ve `Soyad` `Kişi` nesnesinde standart alanlardır. Bireylerin isimleri için metin verileri depolarlar.
Standart alanları silemezsiniz, ancak ihtiyacınız yoksa devre dışı bırakabilirsiniz.
Ayrıca standart `SELECT` türü alanların seçeneklerini özelleştirebilirsiniz; örneğin Fırsatlar'daki `Stage` alanının seçeneklerini.
<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
### Özel Alanlar
Özel alanlar herhangi bir nesneye eklenebilir. Metin, sayı, tarih, açılan seçimler ve daha fazlasını depolayabilirsiniz. Özel alanları, işinize özgü bilgileri izlemek için kullanın.
Örneğin, SpaceX için özel bir alan `Roket Aktif Durumu` olabilir, çalışır durumda olup olmadığını gösterecek.
<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
## Alan Türleri
Twenty çeşitli alan türlerini destekler:
| Tür | Açıklama | Örnek |
| ------------- | ------------------------------------------------------------------- | ---------------------- |
| Adres | Sokak, şehir, eyalet, ülke, posta kodu içeren yapılandırılmış adres | Ofis Adresi |
| Dizi | Metin değerlerinin listesi | Etiketler |
| Boolean | Doğru/Yanlış onay kutusu | Aktif mi |
| Para Birimi | Para birimi koduyla parasal değer | Anlaşma Tutarı (USD) |
| Tarih | Tarih değerleri | Kapanış Tarihi |
| Tarih ve Saat | Saat içeren tarih | Toplantı Saati |
| Alan Adı | Web sitesi alan adı (Şirketler için kullanılır) | acme.com |
| E-posta | E-posta adresleri (birincil + ek) | Kişi E-postası |
| JSON | Yapılandırılmış JSON verisi | Özel meta veri |
| Bağlantılar | Etiketli URL'ler (birincil + ikincil) | Web Sitesi, LinkedIn |
| Uzun Metin | Çok satırlı metin | Açıklama, Notlar |
| Çoklu Seçim | Önceden tanımlı bir listeden birden fazla seçim | Etiketler, Kategoriler |
| Sayı | Sayısal değerler (tam sayılar veya ondalık sayılar) | Miktar, Puan |
| Telefon | Ülke kodlu telefon numaraları | İş Telefonu |
| Puan | Yıldız derecelendirmesi (1-5) | Öncelik, Puan |
| İlişki | Diğer nesnelerdeki kayıtlara bağlantılar | Şirket → Kişiler |
| Seç | Önceden tanımlı bir listeden tek seçim | Aşama, Durum |
| Metin | Tek satırlık metin | Ad, Başlık |
## Özel Alan Oluştur
Herhangi bir nesneye özel bir alan eklemek için şu adımları izleyin:
1. Sol kenar çubuğundaki `Ayarlar`a gidin.
2. `Veri Modeli`ne gidin, ardından özelleştirmek istediğiniz nesneyi seçin.
3. `+ New Field`e tıklayarak devam edin.
4. İhtiyaçlarınıza uygun bir alan adı ve türü seçin. Daha iyi anlama için bir alan açıklaması eklemeyi düşünün.
Yeni oluşturulan alanınız artık uygulamanın alanları içinde kullanılabilir durumda. Belirli bir görünümde görüntülemek için, seçenekler menüsüne tıklayın ve ardından `Alanlar`ı seçin.
<VimeoEmbed videoId="927628219" title="Video gösterimi" />
**Hızlı yol:** Herhangi bir nesne tablosunun sağ üst kısmındaki **+** düğmesine tıklayın, ardından `Alanları özelleştir`i seçin. Bu sizi doğrudan Veri Modeli ayarlarına götürür.
<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
## Bir alanı devre dışı bırakın
Verilerinizi kaybetmeden alanı uygulamadan gizlemek için devre dışı bırakabilirsiniz. Alanı silmek yerine gizleme olarak düşünün.
İşte bu işlemi nasıl yapacağınız:
1. Nesne ayarlarınızda devre dışı bırakmak istediğiniz alanı bulun.
2. Alan yanındaki üç noktaya `⋮` tıklayarak menüyü açın.
3. Açılacak listeden `Devre Dışı Bırak`ı seçin.
<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
Bir alanı devre dışı bıraktığınızda ne olur?
1. **Uygulamada:** Alan kaybolur ve ona yeni değerler ekleyemezsiniz.
2. **Mevcut ilişkiler:** Eğer bir ilişki alanıysa, mevcut bağlantılar kalır ama yeni bağlantılar oluşturamazsınız.
3. **API erişimi:** Halen alanı ve verilerini API aracılığıyla erişebilirsiniz.
Standart ve Özel Alanları tekrar etkin hale getirebilir veya kalıcı olarak silebilirsiniz.
## Alanları Benzersiz Yap
Farklı kayıtların aynı değere sahip olamaması için bir alanı benzersiz yapın. Örneğin, e-posta adresleri her kişi için benzersizdir.
Benzersizliği ayarlarken bir hata alırsanız, verilerinizde (silinen kayıtlar dahil) yinelenen değerleri kontrol edin.
## Dizinler (Gelişmiş)
Veritabanı dizinleri otomatik olarak yönetilir — kendi dizinlerinizi eklemeniz nadiren gereklidir ve yanlış yapmak da kolaydır. Gelişmiş mod açıkken, bir dizine ihtiyacınız olduğunu bildiğiniz durumlar için her nesnenin `Ayarlar → Veri Modeli → <object>` altında bir **Dizinler** bölümü bulunur.
## Alan Yapılandırma En İyi Uygulamaları
### Adlandırma Kuralları ve Kısıtlamaları
* **Tekil ve çoğul adlar farklı olmalıdır**: GraphQL API'miz mutasyonlar için farklı adlara ihtiyaç duyar
* **Korunan alan adları**: bazı adlar sistem kullanımı için ayrılmıştır (ör. `Type`, `Application`)
### Para ve Telefon Alanları
* **Varsayılan para birimi**: veri modeli aracılığıyla yapılandırılabilir
* **Varsayılan ülke kodları**: telefon alanları için veri modeli aracılığıyla yapılandırılabilir
### Seçim Alanları
* **Her Seçim alanı için varsayılan bir seçenek** seçilebilir
### Kayıt Metin Alanları
* **Her nesnenin bir ana gösterim alanı vardır**: Bu alan sol sütunda görünür ve diğer nesnelerle bağlantı kurulduğunda kaydı temsil eder. Bu bir metin alanı olmalıdır. Örneğin, Kişiler bir kişi bir şirkete bağlantı kurulduğunda `İsim` ana alanını kullanır, şirketin görünümünde isimlerini görürsünüz.

View File

@@ -0,0 +1,92 @@
---
title: Nesneler
description: Twenty'de standart ve özel nesneler hakkında bilgi edinin.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Standart Nesneler
Standart nesneler, işe başlamanıza yardımcı olmak için çalışma alanınızda önceden tanımlanmış varlıklardır. Bunlar, Twenty kullanıcıları tarafından erişilebilen, paylaşılan bir veri modelinin parçasıdır. Onları olduğu gibi kullanabilir, özelleştirebilir veya devre dışı bırakabilirsiniz.
<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
### İnsanlar
`İnsanlar` nesnesi, kişilerinizi saklar. Bu nesne, iletişim detayları ve etkileşim geçmişini içerir, böylece tüm müşteri etkileşimlerinizi tek bir yerde görebilirsiniz.
### Şirketler
`Şirketler` nesnesi, iş hesaplarınızı saklar. Endüstri, boyut ve konum gibi detayları içerir. Şirketler, hem `İnsanlar` hem de `Fırsatlar` nesnelerine bağlanır.
### Fırsatlar
`Fırsatlar` nesnesi, işle ilgili verileri saklar. Potansiyel satışların araştırmadan kapanışa kadar olan ilerlemesini izler; aşamaları, fırsat tutarlarını, ilişkili hesabı ve beklenen kapanış tarihini kaydeder. Satış boru hattınızı kanban düzeninde görüntüleyebilirsiniz.
### Notlar
`Notes` nesnesi, Kişiler, Şirketler, Fırsatlar ve diğer kayıtlara eklenebilen serbest biçimli notları saklar. Toplantı özetlerini, önemli ayrıntıları veya bağlamsal bilgileri kaydetmek için notları kullanın.
### Görevler
`Tasks` nesnesi, yapılacaklar ve eylem öğelerini saklar. Görevler Kişiler, Şirketler, Fırsatlar ve diğer kayıtlara bağlanabilir. Takiplerinizi etkin şekilde sürdürebilmek için son tarihleri, atanan kişileri ve tamamlama durumunu izleyin.
## Özel Nesneler
Özel nesneler, standart nesnelerin işleyemediği, kuruluşunuza özgü bilgileri saklamanıza olanak tanır. Örneğin, SpaceX iseniz, Roketler ve Fırlatmalar için özel bir nesne oluşturmak isteyebilirsiniz.
<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
### Yeni Bir Özel Nesne Oluşturma
Yeni bir özel nesne oluşturmak için:
1. Soldaki kenar çubuğundan Ayarlar'a gidin.
2. Çalışma Alanı altında, Veri Modeline gidin. Burada mevcut tüm Standart ve Özel nesnelerinizin (hem aktif hem de devre dışı bırakılmış) genel görünümünü görebileceksiniz.
<VimeoEmbed videoId="926288174" title="Video gösterimi" />
3. Üstteki `+ Yeni nesne` butonuna tıklayın. Adı (tekil ve çoğul olarak), bir simge seçip özel nesneniz için bir açıklama ekleyin ve Kaydet'e tıklayın (sağ üstte). Özel nesne olarak ilanı kullanarak, tekil "ilan" ve çoğul "ilanlar" olur, "Ev sahiplerinin mülklerini sergilemek için oluşturdukları ilanlar." gibi bir açıklamayla.
4. Özel nesneniz oluşturuldu ve kenar çubuğunuzda görünecek. Hemen ona kayıt eklemeye başlayabilirsiniz.
## Nesneleri Yönetme
### Nesneleri Devre Dışı Bırakma
Standart veya özel bir nesneye ihtiyacınız yoksa:
1. Ayarlar → Veri Modeli'ne gidin
2. Devre dışı bırakmak istediğiniz nesneyi bulun ve tıklayın
3. Nesnenin **Ayarlar** sekmesine gidin
4. `Devre Dışı Bırak` düğmesine tıklayın
5. Nesne çalışma alanınızdan gizlenecek ancak veriler korunur
### Nesneleri Yeniden Etkinleştirme
Devre dışı bırakılmış bir nesneyi geri getirmek için:
1. Ayarlar → Veri Modeli'ne gidin
2. `Devre Dışı` filtresini etkinleştirin
3. Devre dışı bırakılmış nesneleri arayın (adlarının yanında `Devre Dışı` yazar)
4. Yeniden etkinleştirmek için `⋮` menüsüne ve ardından `Etkinleştir`e tıklayın
5. Nesne ve tüm verileri geri yüklenecektir
## En İyi Uygulamalar
### Özel Nesneleri Ne Zaman Oluşturmalısınız
* **Benzersiz iş varlıkları**: Sektörünüze veya sürecinize özgü unsurlar
* **Karmaşık ilişkiler**: Birden çok varlık arasındaki bağlantıları izlemeniz gerektiğinde
* **Ölçeklenebilir veriler**: Bir şeyin çok sayıda örneğine sahip olabileceğiniz durumlarda
### Bunun Yerine Alanları Ne Zaman Kullanmalısınız
* **Basit öznitelikler**: Mevcut nesneleri tanımlayan özellikler
* **Kategoriler veya etiketler**: Mevcut kayıtları sınıflandırma yöntemleri
* **Tekil değerler**: Kendi yaşam döngüsüne ihtiyaç duymayan bilgiler
### Nesne Adlandırma
* **Açık, açıklayıcı adlar kullanın**: Nesnenin neyi temsil ettiğini açıkça belli edin
* **Kurallara uyun**: Nesne adı için tekil, koleksiyon için çoğul kullanın
* **Ekibinizi dikkate alın**: Herkesin anlayacağı adları seçin

View File

@@ -0,0 +1,94 @@
---
title: İlişki Alanları
description: İlişki alanlarını kullanarak farklı nesnelerdeki kayıtları birbirine bağlayın.
---
## İlişki Türleri
### Bire-çok
Nesne A'daki bir kayıt, Nesne B'deki birçok kayda bağlanabilir.
**Örnek:** Bir Şirketin birçok Kişisi (çalışanı) olabilir.
### Çoktan-bire
Nesne A'daki birçok kayıt, Nesne B'deki tek bir kayda bağlanabilir.
**Örnek:** Birçok Kişi tek bir Şirkete ait olabilir.
### Birden Fazla Nesne Türüne İşaret Eden İlişkiler
Bazı nesneler, ilişkinin bir tarafında birden fazla nesne türüne bağlanabilir.
**Örnek:** Bir Not aynı anda bir Kişiye VE bir Şirkete VE bir Fırsata eklenebilir. Not "çok" tarafındadır ve birden çok "bir" tarafına bağlanır.
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
Benzer şekilde, bir Proje ("bir" tarafında) birden çok Kişiden, birden çok Şirketten ve birden çok Nottan bağlantılar alabilir.
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
**İçe/Dışa Aktarma kısıtlaması**: Birden fazla nesne türüne işaret eden ilişkiler CSV içe/dışa aktarma için henüz desteklenmiyor. Bu özellik yol haritamızda.
</Warning>
### Çoktan-çoka
Nesne A'daki birçok kayıt, Nesne B'deki birçok kayda bağlanabilir.
**Örnek:** Birçok Kişi birçok Projeye bağlanabilir ve tersi de geçerlidir.
Çoktan çoğa ilişkiler bir **kesişim nesnesi** deseni kullanır: her iki tarafı bağlayan ara bir nesne. Kesişim ilişkisi özelliğiyle Twenty, ara nesneyi arayüzden gizleyerek nihai bağlı kayıtları doğrudan görüntüler.
<Warning>
**Beta Özelliği**: Kesişim ilişkileri, kullanılmadan önce **Settings → Community → Features** bölümünde etkinleştirilmelidir.
</Warning>
Eksiksiz bir adım adım kılavuz için [Çoktan Çoğa İlişkiler Nasıl Oluşturulur](/l/tr/user-guide/data-model/how-tos/create-many-to-many-relations) bölümüne bakın.
## Bir İlişki Alanı Oluşturma
1. **Ayarlar → Veri Modeli** bölümüne gidin
2. İlişki eklemek istediğiniz nesneyi seçin
3. **+ Yeni Alan**'a tıklayın
4. Alan türü olarak **İlişki**'yi seçin
5. İlişkilendirilecek hedef nesne(leri) seçin
6. İlişki ayarlarını yapılandırın:
* **Kaynak nesnedeki alan adı**: Düzenlediğiniz nesnedeki ilişki alanının adı
* **Hedef nesnedeki alan adı**: Hedef nesnede görünecek ilişki alanının adı
* İlişki türü (bire-çok, çoktan-bire)
7. **Kaydet**'e tıklayın
## Standart İlişkiler
Twenty, standart nesneler arasında önceden oluşturulmuş ilişkilerle birlikte gelir:
| Kaynak Nesne | Hedef Nesne | İlişki Türü |
| ------------ | ----------- | ----------- |
| İnsanlar | Şirketler | Çoktan-bire |
| Fırsatlar | Şirketler | Çoktan-bire |
| Fırsatlar | İnsanlar | Çoktan-bire |
## En İyi Uygulamalar
### İlişkileri Planlama
* **Veri modelinizi haritalayın**: İlişkileri oluşturmadan önce planlayın
* **Yönü değerlendirin**: İlişkiye hangi nesnenin "sahip" olduğunu düşünün
* **Döngüsel bağımlılıklardan kaçının**: Veri modelinizi temiz tutun
### İlişkileri Adlandırma
* **Açık adlar kullanın**: İlişkinin neyi temsil ettiğini açıkça belirtin
* **Tutarlı olun**: İlişkiler genelinde benzer adlandırma kalıpları kullanın
* **Her iki tarafı da dikkate alın**: İlişkinin her iki tarafını da uygun şekilde adlandırın
### Performans
* **Aşırı ilişkilendirmeyin**: Çok fazla ilişki çalışma alanınızı yavaşlatabilir
## Kısıtlamalar
* **İlişkileri silmek** bağlantıyı kaldırır, ancak ilişkili kayıtları silmez
* **Döngüsel ilişkiler** veri bütünlüğünü korumak için kaçınılmalıdır