İletişim kanalları başvurusu

Bu sayfa src/cluster_erp/modules/parties/communication_channels/ içindeki communication_channels alt modülünün alanlarını, uçlarını ve kurallarını listeler. Bir kanal, bir tarafa ulaşmanın tek bir yoludur; örneğin bir e-posta adresi veya bir telefon numarası, ve bir kanal türüyle türlenir. Kanal türleri, bu alt modülün tohumladığı ve taraf ayarları yolu altında sunduğu başvuru verileridir.

Kapsam ve kaynak¶

Tanımlandığı yer: src/cluster_erp/modules/parties/communication_channels/models.py (ChannelType, CommunicationChannel), schemas.py, services.py (ChannelTypeService, CommunicationChannelService), routes.py, seed_data.py (CHANNEL_TYPE_DEFAULTS); metadata CHANNEL_META, src/cluster_erp/modules/parties/parties/metadata.py:1438 içinde ve CHANNEL_TYPE_META, src/cluster_erp/modules/parties/settings/metadata.py:370 içinde.
Sayım: 2 tablo; 13 uç (routes.py içindeki @router. dekoratörleri); 15 tohumlanmış kanal türü (seed_data.py içinde code anahtarlı girdiler).

Kanal türü alanları¶

Ad	Tür	Anlam	Kaynak
`code`	`String(50)`	Kararlı anahtar, örneğin `email`; canlı satırlar arasında benzersiz	`src/cluster_erp/modules/parties/communication_channels/models.py:18-24`, `src/cluster_erp/modules/parties/communication_channels/models.py:33`
`name`	`String(50)`	Ad; canlı satırlar arasında benzersiz	`src/cluster_erp/modules/parties/communication_channels/models.py:25-30`, `src/cluster_erp/modules/parties/communication_channels/models.py:34`
`translations`	JSON	Dile göre adlar	`src/cluster_erp/modules/parties/communication_channels/models.py:35`
`icon`	`String(50)`	Simge anahtarı	`src/cluster_erp/modules/parties/communication_channels/models.py:36`
`validation_pattern`	`String(500)`	Türle birlikte saklanan bir düzenli ifade	`src/cluster_erp/modules/parties/communication_channels/models.py:37`
`is_active`	bool	Etkinlik bayrağı	`src/cluster_erp/modules/parties/communication_channels/models.py:38`

Tohumlanan kodlar email, phone, mobile, fax, postal_address, website, linkedin, x_twitter, instagram, facebook, youtube, github, whatsapp, telegram ve tiktok olur (src/cluster_erp/modules/parties/communication_channels/seed_data.py:5-113).

Kanal alanları¶

Ad	Tür	Anlam	Kaynak
`code`	`String(20)`, benzersiz	`communication_channel` dizisinden iş anahtarı	`src/cluster_erp/modules/parties/communication_channels/models.py:44`, `src/cluster_erp/modules/parties/communication_channels/services.py:140`
`party_id`	`parties_parties.id` alanına yabancı anahtar	Sahip taraf	`src/cluster_erp/modules/parties/communication_channels/models.py:45-47`
`channel_type_id`	`parties_channel_types.id` alanına yabancı anahtar	Tür	`src/cluster_erp/modules/parties/communication_channels/models.py:48-52`
`value`	`String(500)`	Adres veya numara	`src/cluster_erp/modules/parties/communication_channels/models.py:53`
`label`	`String(100)`	Kısa ad	`src/cluster_erp/modules/parties/communication_channels/models.py:54`
`is_primary`	bool	Tarafın birincil kanalı	`src/cluster_erp/modules/parties/communication_channels/models.py:55`
`is_active`	bool	Etkinlik bayrağı	`src/cluster_erp/modules/parties/communication_channels/models.py:56`

Uçlar¶

Tüm yollar /api/v1/parties altındadır.

Yöntem ve yol	Amaç	İzin	Kaynak
`POST /settings/channel-types/seed-defaults`	Eksik varsayılan türleri oluşturma	`channel_type.seed`	`src/cluster_erp/modules/parties/communication_channels/routes.py:35-41`
`GET /settings/channel-types/`	Türleri listeleme	`channel_type.read`	`src/cluster_erp/modules/parties/communication_channels/routes.py:44-58`
`POST /settings/channel-types/`	Tür oluşturma	`channel_type.create`	`src/cluster_erp/modules/parties/communication_channels/routes.py:61-69`
`PUT /settings/channel-types/{type_id}`	Tür güncelleme	`channel_type.update`	`src/cluster_erp/modules/parties/communication_channels/routes.py:72-83`
`POST /settings/channel-types/bulk-delete`	Birkaç türü geçici silme	`channel_type.bulk_delete`	`src/cluster_erp/modules/parties/communication_channels/routes.py:86-94`
`DELETE /settings/channel-types/{type_id}`	Bir türü geçici silme	`channel_type.delete`	`src/cluster_erp/modules/parties/communication_channels/routes.py:97-105`
`GET /channels/all`	Taraflar arası kanal sayfası	`channel.read`	`src/cluster_erp/modules/parties/communication_channels/routes.py:113-155`
`GET /{party_id}/channels`	Bir tarafın kanalları	`channel.read`	`src/cluster_erp/modules/parties/communication_channels/routes.py:158-166`
`POST /{party_id}/channels`	Oluşturma	`channel.create`	`src/cluster_erp/modules/parties/communication_channels/routes.py:169-181`
`GET /channels/{channel_id}`	Tek kanal	`channel.read`	`src/cluster_erp/modules/parties/communication_channels/routes.py:184-194`
`PUT /channels/{channel_id}`	Güncelleme	`channel.update`	`src/cluster_erp/modules/parties/communication_channels/routes.py:197-211`
`POST /channels/bulk-delete`	Birkaçını geçici silme	`channel.bulk_delete`	`src/cluster_erp/modules/parties/communication_channels/routes.py:214-222`
`DELETE /channels/{channel_id}`	Birini geçici silme	`channel.delete`	`src/cluster_erp/modules/parties/communication_channels/routes.py:225-233`

Kısıtlar ve doğrulama¶

Bir kanalda is_primary ayarlamak, türü ne olursa olsun tarafın diğer tüm canlı kanallarındaki bayrağı temizler (src/cluster_erp/modules/parties/communication_channels/services.py:137-138, src/cluster_erp/modules/parties/communication_channels/services.py:162-163, src/cluster_erp/modules/parties/communication_channels/services.py:226-234).
Tohumlama var olan türleri adla eşleştirir, eksik code değerini ve eksik çevirileri doldurur ve kalanları oluşturur; her başlangıçta çalışır (src/cluster_erp/modules/parties/communication_channels/services.py:73-100, src/cluster_erp/modules/parties/module.py:63-74).
src/ ve webapp/ içinde validation_pattern için yapılan grep onu yalnızca modelde, şemalarda, metadata'da ve tohum verisinde bulur. Bu commit'te hiçbir kod bir kanal değerini desene karşı denetlemez.
Diğer modüller bir tarafın e-posta adreslerini, kodu email olan türdeki canlı ve etkin kanalları okuyan ResolveEntityEmails ile (src/cluster_erp/modules/parties/module.py:489-536), iletişim değerlerini ise GetPartyContactValues ile (src/cluster_erp/modules/parties/privacy_handlers.py:35-66) çözer.

Tutarsızlıklar¶

Tanıtılan terimler¶

Terim	Kod tanımlayıcısı	Tanım	Türkçe terim	Kaynak
communication channel	`CommunicationChannel`	Bir tarafa ulaşmanın tek bir yolu, örneğin bir e-posta adresi veya telefon numarası.	İletişim kanalı	`src/cluster_erp/modules/parties/communication_channels/models.py:41`
channel type	`ChannelType`	Bir kanalı türleyen başvuru kaydı.	Kanal türü	`src/cluster_erp/modules/parties/communication_channels/models.py:15`

İlgili sayfalar¶

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.