Kritik malzemeler ve ikame · Cluster ERP Wiki

Bu sayfa src/cluster_erp/modules/procurement/ içindeki iki alt modülü anlatır. critical_materials/ eksik kalmaması gereken malzemeleri teslim süresi sınırları ve bir uyarı eşiğiyle işaretler. substitution_groups/ birbirinin yerine geçebilen ürün kırılımlarını bir tercih sırası ve bir dönüşüm katsayısıyla gruplar. İkisini de MRP çalıştırması okur; bkz. malzeme ihtiyaç planlaması.

Kapsam ve kaynak¶

Tanımlandığı yer: iki alt modülün models.py, services.py, routes.py ve metadata.py dosyaları (ikame üyeleri için ayrıca member_metadata.py); sorgu işleyicileri src/cluster_erp/modules/procurement/module.py:578-652 içinde.
Sayım: 3 tablo; 6 kritik malzeme ucu ve 10 ikame grubu ucu (@router. dekoratörleri); ActionMeta girdisi yok.

Kritik malzeme alanları¶

Ad	Anlam	Kaynak
`product_id`, `product_model_id`, `product_version_id`	Ürün kırılımı	`src/cluster_erp/modules/procurement/critical_materials/models.py:24-40`
`lead_time_days_min`, `lead_time_days_max`	Teslim süresi sınırları	`src/cluster_erp/modules/procurement/critical_materials/models.py:41-48`
`default_vendor_id`	Varsayılan tedarikçi	`src/cluster_erp/modules/procurement/critical_materials/models.py:49`
`mrp_alert_threshold_days`	Planlı sipariş tarihinden kaç gün önce MRP'nin uyarı verdiği	`src/cluster_erp/modules/procurement/critical_materials/models.py:53`
`is_active`, `notes`	Etkinlik bayrağı ve notlar	`src/cluster_erp/modules/procurement/critical_materials/models.py:59-65`

İkame alanları¶

Varlık	Alanlar	Kaynak
`MaterialSubstitutionGroup` (`procurement_substitution_groups`)	`code` (`substitution_group` yıllık dizisi), `name`, `description`, `is_active`	`src/cluster_erp/modules/procurement/substitution_groups/models.py:24-48`, `src/cluster_erp/modules/procurement/substitution_groups/services.py:127`
`MaterialSubstitutionMember` (`procurement_substitution_members`)	`group_id`, ürün kırılımı, `preference_order` (varsayılan 1), `conversion_factor` (`Numeric(10, 6)`, varsayılan 1), `is_primary`, `valid_from`, `valid_to`, `notes`	`src/cluster_erp/modules/procurement/substitution_groups/models.py:56-124`

Uçlar¶

Yöntem ve yol	İzin	Kaynak
`GET`, `POST /critical-materials/`; `GET`, `PUT`, `DELETE /critical-materials/{cm_id}`; `POST /critical-materials/bulk-delete`	`critical_material.read`, `.create`, `.update`, `.delete`, `.bulk_delete`	`src/cluster_erp/modules/procurement/critical_materials/routes.py:27-106`
`GET`, `POST /substitution-groups/`; `GET`, `PUT`, `DELETE /substitution-groups/{group_id}`; `POST /substitution-groups/bulk-delete`	`substitution_group.read`, `.create`, `.update`, `.delete`, `.bulk_delete`	`src/cluster_erp/modules/procurement/substitution_groups/routes.py:30-119`
`GET /substitution-groups/by-product/{product_id}`	`substitution_group.read`	`src/cluster_erp/modules/procurement/substitution_groups/routes.py:68`
`POST /substitution-groups/{group_id}/members`; `PUT`, `DELETE /substitution-groups/{group_id}/members/{member_id}`	`substitution_group.create`, `.update`, `.delete`	`src/cluster_erp/modules/procurement/substitution_groups/routes.py:131-165`

Kısıtlar ve doğrulama¶

Bir ürün canlı satırlar arasında yalnızca bir kez kritik malzeme olabilir. Denetim ve kısmi benzersiz indeks kırılımı değil yalnızca product_id alanını kullanır (src/cluster_erp/modules/procurement/critical_materials/models.py:14-21, src/cluster_erp/modules/procurement/critical_materials/services.py:80-91).
Kritik malzeme ve üye kırılımları ensure_product_breakdown ile denetlenir (src/cluster_erp/modules/procurement/critical_materials/services.py:93, src/cluster_erp/modules/procurement/substitution_groups/services.py:203).
Bir kırılım, canlı üyeler arasında grup başına bir kez yer alır (src/cluster_erp/modules/procurement/substitution_groups/models.py:58-66, src/cluster_erp/modules/procurement/substitution_groups/services.py:208-228).
Bir grubun son üyesi kaldırılamaz (src/cluster_erp/modules/procurement/substitution_groups/services.py:308-322).
GetSubstitutesForProduct etkin olmayan grupları ve geçerlilik penceresi dışındaki üyeleri atlar ve preference_order değerine göre sıralar (src/cluster_erp/modules/procurement/module.py:604-652).
Kalemleri arasında etkin bir kritik malzeme bulunan satın alma talebi high önceliği alır (src/cluster_erp/modules/procurement/purchase_requests/services.py:270-273).
MRP, planlı sipariş tarihi ürünün uyarı eşiği içindeyse ürün başına bir kez CriticalMaterialAlert yayar (src/cluster_erp/modules/procurement/mrp/engine.py:4090-4118).

Tanıtılan terimler¶

Terim	Kod tanımlayıcısı	Tanım	Türkçe terim	Kaynak
critical material	`CriticalMaterial`	Eksikliği MRP ve satın almada öncelikli ele alınsın diye işaretlenen malzeme.	Kritik malzeme	`src/cluster_erp/modules/procurement/critical_materials/models.py:12`
substitution group	`MaterialSubstitutionGroup`	Birbirinin yerine geçebilen ürün kırılımlarının kümesi.	İkame grubu	`src/cluster_erp/modules/procurement/substitution_groups/models.py:24`
conversion factor	`conversion_factor`	Bir üye diğerinin yerine geçtiğinde uygulanan miktar oranı.	Dönüşüm katsayısı	`src/cluster_erp/modules/procurement/substitution_groups/models.py:99-104`

İlgili sayfalar¶

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