Müşteriler ve müşteri parçaları

Bu sayfa src/cluster_erp/modules/crm/ içindeki üç alt modülü anlatır. customers/, bir tarafın müşteri rol kaydı olan müşteri rolünü (Customer) tutar. customer_parts/ bir müşterinin parça numarasını şirketin ürünlerinden birine eşler, customer_part_revisions/ ise o parçanın revizyonlarını tutar. Tarafların rol modeli taraf birleştirme sayfasında anlatılır.

Kapsam ve kaynak¶

Tanımlandığı yer: üç alt modülün models.py, services.py, routes.py ve metadata.py dosyaları ile src/cluster_erp/modules/crm/module.py:115-138 ve src/cluster_erp/modules/crm/module.py:271-297 içindeki taraf işleyicileri.
Sayım: 3 tablo; 6 müşteri ucu, 6 müşteri parçası ucu ve 7 revizyon ucu (@router. dekoratörleri); revizyonlarda 2 ActionMeta girdisi.

Müşteri alanları¶

Ad	Anlam	Kaynak
`code`	`customer` yıllık dizisinden gelen iş anahtarı	`src/cluster_erp/modules/crm/customers/models.py:21`, `src/cluster_erp/modules/crm/customers/services.py:108`
`party_id`	Müşteri rolünü oynayan taraf	`src/cluster_erp/modules/crm/customers/models.py:23-28`
`legal_name`, `tax_no`	Oluşturmada taraftan kopyalanır	`src/cluster_erp/modules/crm/customers/models.py:22`, `src/cluster_erp/modules/crm/customers/models.py:29`
`country_id`	Ülke başvurusu	`src/cluster_erp/modules/crm/customers/models.py:30-35`
`default_incoterm`, `default_currency`, `payment_terms`	Yeni tekliflerin okuduğu ticari varsayılanlar	`src/cluster_erp/modules/crm/customers/models.py:36-38`
`sales_contact_email`, `default_account_manager_id`	İletişim ve müşteri temsilcisi	`src/cluster_erp/modules/crm/customers/models.py:39-46`
`ariba_supplier_id`	Müşterinin satın alma portalında şirketin tedarikçi kimliği	`src/cluster_erp/modules/crm/customers/models.py:47-50`
`is_active`, `extra`	Etkinlik bayrağı ve kiracı tanımlı alan değerleri	`src/cluster_erp/modules/crm/customers/models.py:17`, `src/cluster_erp/modules/crm/customers/models.py:51`

Müşteri parçası ve revizyon alanları¶

Varlık	Alanlar	Kaynak
`CustomerPart` (`crm_customer_parts`)	`customer_id`, `part_id` (bir ürün), `customer_part_no`, `customer_part_name`, `is_active`, `extra`	`src/cluster_erp/modules/crm/customer_parts/models.py:13-52`
`CustomerPartRevision` (`crm_customer_part_revisions`)	`customer_part_id`, `revision_no`, `status` (varsayılan `draft`), `description`, `drawing_doc_id`, `valid_from`	`src/cluster_erp/modules/crm/customer_part_revisions/models.py:13-43`

Revizyon durumları ve aksiyonları¶

Bir revizyon draft, active veya superseded olur (src/cluster_erp/modules/crm/customer_part_revisions/services.py:110-155).

stateDiagram-v2
 [*] --> draft
 draft --> active: activate
 active --> superseded: supersede

Düz anlatımla: bir taslak yalnızca parçanın başka etkin revizyonu yoksa etkin olur. Etkin bir revizyonun yerine yenisi geçirilebilir. Yalnızca taslak düzenlenebilir veya silinebilir (src/cluster_erp/modules/crm/customer_part_revisions/services.py:84-109).

Aksiyon	Etiket	Koşul	Uç	İzin	Kaynak
`activate`	Aktifleştir	`status` değeri `draft`	`POST /customer-part-revisions/{id}/activate`	`customer_part_revision.activate`	`src/cluster_erp/modules/crm/customer_part_revisions/metadata.py:48-58`, `src/cluster_erp/modules/crm/customer_part_revisions/routes.py:103`
`supersede`	Değiştir	`status` değeri `active`	`POST /customer-part-revisions/{id}/supersede`	`customer_part_revision.activate`	`src/cluster_erp/modules/crm/customer_part_revisions/metadata.py:59-69`, `src/cluster_erp/modules/crm/customer_part_revisions/routes.py:118`

Uçlar¶

Yöntem ve yol	İzin	Kaynak
`GET`, `POST /customers/`; `GET`, `PUT`, `DELETE /customers/{customer_id}`; `POST /customers/bulk-delete`	`customer.read`, `.create`, `.update`, `.delete`, `.bulk_delete`	`src/cluster_erp/modules/crm/customers/routes.py:37-147`
`GET`, `POST /customer-parts/`; `GET`, `PUT`, `DELETE /customer-parts/{customer_part_id}`; `POST /customer-parts/bulk-delete`	`customer_part.read`, `.create`, `.update`, `.delete`, `.bulk_delete`	`src/cluster_erp/modules/crm/customer_parts/routes.py:47-157`
`GET`, `POST /customer-parts/{customer_part_id}/revisions`; `GET`, `PUT`, `DELETE /customer-part-revisions/{revision_id}`	`customer_part_revision.read`, `.create`, `.update`, `.delete`	`src/cluster_erp/modules/crm/customer_part_revisions/routes.py:24-91`

Kısıtlar ve doğrulama¶

Oluşturmada, tarafı olan bir müşteri legal_name ve tax_no değerlerini GetPartyById üzerinden alır. Bir taraf müşteri rolünü bir kez oynar: aynı taraf için ikinci oluşturma mevcut rolü günceller (src/cluster_erp/modules/crm/customers/services.py:75-107).
Oluşturma CustomerCreated ve active=True ile PartyRoleSet yayar; silme deleted_at alanını doldurur ve active=False ile PartyRoleSet yayar (src/cluster_erp/modules/crm/customers/services.py:118-145, src/cluster_erp/modules/crm/customers/services.py:196-215).
PartyUpdated değişen görünen adı ve vergi numarasını canlı rollere kopyalar; PartyDeleted onlarda is_active değerini false yapar (src/cluster_erp/modules/crm/module.py:115-138, src/cluster_erp/modules/crm/module.py:271-297).
Bir müşteri parça numarası canlı satırlar arasında müşteri başına benzersizdir (src/cluster_erp/modules/crm/customer_parts/models.py:15-22, src/cluster_erp/modules/crm/customer_parts/services.py:139-155).
Bireysel bir tarafın rolündeki kişisel değerler privacy_handlers.py tarafından toplanır ve anonimleştirilir (src/cluster_erp/modules/crm/privacy_handlers.py:1-12).

Tutarsızlıklar¶

Tanıtılan terimler¶

Terim	Kod tanımlayıcısı	Tanım	Türkçe terim	Kaynak
customer part	`CustomerPart`	Şirketin ürünlerinden birine eşlenmiş müşteri parça numarası.	Müşteri parçası	`src/cluster_erp/modules/crm/customer_parts/models.py:13`
customer part revision	`CustomerPartRevision`	Çizimi ve geçerliliği olan, numaralı bir müşteri parçası revizyonu.	Müşteri parça revizyonu	`src/cluster_erp/modules/crm/customer_part_revisions/models.py:13`

İlgili sayfalar¶

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