Parties alt modülü başvurusu

Bu sayfa src/cluster_erp/modules/parties/parties/ içindeki parties alt modülünün alanlarını, uçlarını ve kurallarını listeler: taraf kartı, bireysel ve kurumsal ayrıntılar ve profil fotoğrafı. Kartın etrafındaki rol modeli taraf birleştirme sayfasındadır. Adreslerin, kanalların ve dillerin kendi sayfaları vardır.

Kapsam ve kaynak¶

Tanımlandığı yer: src/cluster_erp/modules/parties/parties/models.py (Party, Individual, OrganisationInfo), schemas.py, services.py (PartyService), routes.py ve metadata.py (PARTY_META, ADDRESS_META, CHANNEL_META).
Sayım: 3 tablo (models.py içindeki __tablename__); 9 uç (routes.py içindeki @router. dekoratörleri).

Bu alt modülün metadata dosyası ayrıca ADDRESS_META ve CHANNEL_META bildirir (src/cluster_erp/modules/parties/parties/metadata.py:1181, src/cluster_erp/modules/parties/parties/metadata.py:1438); bunlar adresler ve iletişim kanalları sayfalarında anlatılır.

Taraf alanları¶

Ad	Tür	Varsayılan	Anlam	Kaynak
`code`	`String(20)`, benzersiz	`party` dizisinden	Yıllık iş anahtarı	`src/cluster_erp/modules/parties/parties/models.py:26`, `src/cluster_erp/modules/parties/parties/services.py:116`
`party_type`	`String(20)`	yok	`individual` veya `organisation`	`src/cluster_erp/modules/parties/parties/models.py:27`, `src/cluster_erp/modules/parties/parties/schemas.py:17-19`
`display_name`	`String(255)`	yok	Her yerde gösterilen ad	`src/cluster_erp/modules/parties/parties/models.py:28`
`tax_id`, `tax_office`	`String(50)`, `String(255)`	yok	Vergi numarası ve vergi dairesi	`src/cluster_erp/modules/parties/parties/models.py:29-30`
`notes`	`Text`	yok	Serbest notlar	`src/cluster_erp/modules/parties/parties/models.py:31`
`is_active`	bool	`True`	Etkinlik bayrağı; oluşturma yükündeki değer korunur	`src/cluster_erp/modules/parties/parties/models.py:32`, `src/cluster_erp/modules/parties/parties/schemas.py:69-70`
`is_customer`, `is_supplier`, `is_employee`	bool	`False`	Rol bayrakları; bkz. taraf birleştirme	`src/cluster_erp/modules/parties/parties/models.py:33-35`
`photo_attachment_id`	`core_attachments.id` alanına yabancı anahtar	yok	Profil fotoğrafı; yoksa baş harfler gösterilir	`src/cluster_erp/modules/parties/parties/models.py:36-42`
`extra`	JSONB	`{}`	Kiracı tanımlı alan değerleri	`src/cluster_erp/modules/parties/parties/models.py:21-24`

Bireysel ve kurumsal ayrıntılar¶

Varlık	Alanlar	Kural	Kaynak
`Individual`	`first_name`, `last_name` (zorunlu), `middle_name`, `title`, `date_of_birth`, `gender`	taraf başına bir canlı satır (kısmi benzersiz indeks)	`src/cluster_erp/modules/parties/parties/models.py:58-82`
`OrganisationInfo`	`legal_name` (zorunlu), `trade_name`, `registration_number`, `industry`	taraf başına bir canlı satır (kısmi benzersiz indeks)	`src/cluster_erp/modules/parties/parties/models.py:85-105`

Kimlik numarası, sosyal güvenlik numarası ve kan grubu bireysel kayıtta değildir; model yorumu bunların istihdam kaydında tutulduğunu belirtir (src/cluster_erp/modules/parties/parties/models.py:78-79). Oluşturma individual bloğunu yalnızca bireysel bir taraf için, organisation bloğunu yalnızca kurumsal bir taraf için yazar (src/cluster_erp/modules/parties/parties/services.py:130-136).

Uçlar¶

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

Yöntem ve yol	Amaç	İzin	Kaynak
`GET /`	Taraf sayfası; `search`, `party_type`, `role`, `active_only` ve kiracı alanı `extra.<key>` süzgeçleri	`party.read`	`src/cluster_erp/modules/parties/parties/routes.py:37-67`
`POST /`	İsteğe bağlı adresler ve kanallarla taraf oluşturma	`party.create`	`src/cluster_erp/modules/parties/parties/routes.py:70-85`
`GET /{party_id}`	Ayrıntıları, adresleri ve kanallarıyla taraf	`party.read`	`src/cluster_erp/modules/parties/parties/routes.py:88-102`
`PUT /{party_id}`	Güncelleme	`party.update`	`src/cluster_erp/modules/parties/parties/routes.py:105-120`
`POST /bulk-delete`	Birkaçını geçici silme	`party.bulk_delete`	`src/cluster_erp/modules/parties/parties/routes.py:123-132`
`DELETE /{party_id}`	Birini geçici silme	`party.delete`	`src/cluster_erp/modules/parties/parties/routes.py:135-144`
`GET /{party_id}/photo`	Fotoğraf baytları	`party.read`	`src/cluster_erp/modules/parties/parties/routes.py:161-184`
`POST /{party_id}/photo`	Fotoğraf yükleme veya değiştirme	`party.update`	`src/cluster_erp/modules/parties/parties/routes.py:187-230`
`DELETE /{party_id}/photo`	Fotoğrafı kaldırma	`party.update`	`src/cluster_erp/modules/parties/parties/routes.py:233-249`

Liste items, total, total_capped, limit ve offset döndürür; sayım bir dağıtım üst sınırında durur (src/cluster_erp/modules/parties/parties/routes.py:61-67, src/cluster_erp/modules/parties/parties/services.py:75-78). Okuma yanıtları, çağıranın göremeyeceği kiracı alanı değerlerini gizler (src/cluster_erp/modules/parties/parties/routes.py:31-34, src/cluster_erp/modules/parties/parties/routes.py:82-85); bkz. kiracı alanları. Rehberli oluşturma ve rol etkinleştirme sunucu uçlarıdır; bkz. taraf birleştirme.

Kısıtlar ve doğrulama¶

display_name en çok 255 karakter, vergi numarası en çok 50 karakterdir (src/cluster_erp/modules/parties/parties/schemas.py:63-68).
Kiracı tanımlı değerler oluşturma ve güncellemede tanımlarına göre doğrulanır (src/cluster_erp/modules/parties/parties/services.py:112-115, src/cluster_erp/modules/parties/parties/services.py:173-181).
Liste görünen ada göre sıralanır ve bireysel ayrıntıları önceden yükler (src/cluster_erp/modules/parties/parties/services.py:79-87).
Fotoğraf image/jpeg, image/png, image/webp veya image/gif olmalı, boş olmamalı ve en fazla 5 MB olmalıdır; entity_type değeri party_photo olarak saklanır (src/cluster_erp/modules/parties/parties/routes.py:153-154, src/cluster_erp/modules/parties/parties/routes.py:196-225). Bkz. ekler, notlar ve depolama.
Karttaki tamlık katmanları Temel (tür ve ad), Vergi Bilgileri (vergi numarası ve dairesi) ve Eksiksiz (notlar) olur (src/cluster_erp/modules/parties/parties/metadata.py:1156-1174).

Tanıtılan terimler¶

Terim	Kod tanımlayıcısı	Tanım	Türkçe terim	Kaynak
individual details	`Individual`	Bireysel bir tarafın kişiye özgü alanları.	Bireysel bilgiler	`src/cluster_erp/modules/parties/parties/models.py:58`
organisation details	`OrganisationInfo`	Kurumsal bir tarafın yasal alanları.	Kurumsal bilgiler	`src/cluster_erp/modules/parties/parties/models.py:85`

İlgili sayfalar¶

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