Nesting modülü (nesting)

src/cluster_erp/modules/nesting/ içindeki nesting modülü parçaların metal levhalardan nasıl kesileceğini planlar. Bir yerleşim işi levhayı ve parçaları tanımlar; iş harici bir yerleşim aracına dışa aktarılır ve aracın yerleşimi geri içe aktarılır, denetlenir ve saklanır. Modül ardından yerleşimi SVG veya DXF olarak çizer, malzemeyi maliyetlendirir, inventory modülü üzerinden levha stokunu ayırır ve tüketir, yeniden kullanılabilir artıkları kaydeder ve kullanım KPI'larını raporlar. Yerleşimin kendisi modül içinde hesaplanmaz; bkz. yerleşim motoru.

Bir bakışta¶

Modül ne yapar¶

• Levha ölçüsü, kalınlık, malzeme kalitesi, kaplama, kesim payı, parça aralığı, kenar payı, izin verilen döndürmeler, aynalama, en çok levha sayısı ve isteğe bağlı bir levha malzemesi kırılımı ve depoyla bir yerleşim işi kaydeder (src/cluster_erp/modules/nesting/nesting_jobs/models.py:22-291).
• Yerleştirilecek parçaları elle veya üretim ve satış siparişlerinden çekerek listeler (src/cluster_erp/modules/nesting/nesting_jobs/services.py:676-802).
• Bir işi harici bir araç için dışa aktarır ve aracın yerleşimlerini, artıklarını ve parça dış hatlarını içe aktarır (src/cluster_erp/modules/nesting/integration/services.py:114-363).
• Yerleşimi SVG olarak çizer ve DXF olarak yazar (src/cluster_erp/modules/nesting/nesting_jobs/routes.py:307-396).
• Malzemeyi maliyetlendirir, artıkları alacak olarak düşer ve net maliyeti parçalara dağıtır (src/cluster_erp/modules/nesting/nesting_jobs/services.py:555-675).
• Bir işi onaylar, ayrılmış malzemeyi tüketir, artıkları oluşturur ve stoka kaydeder (src/cluster_erp/modules/nesting/nesting_jobs/services.py:311-390).
• Bir dönem için kullanım ve fire KPI'larını raporlar (src/cluster_erp/modules/nesting/kpi/services.py:36-238).

Alt modüller¶

Ayrıntılar işler, parçalar ve artıklar, entegrasyon ve KPI ve yerleşim motoru sayfalarındadır.

Veri modeli¶

Ekranlar ve metadata¶

get_metadata üç bölümlü bir Yerleşim & Optimizasyon (İngilizce Nesting & Optimization) kenar çubuğu grubu bildirir: yerleşim görüntüleyicisi (nesting_viewer özel bileşeni), Yerleşim İşleri ve Artıklar (src/cluster_erp/modules/nesting/module.py:162-217). Görüntüleyici KPI'ları, iş listesini, bir özeti, SVG çizimi ve indirmeleri gösterir; bileşeni olmayan bir istemci bölümü atlar (src/cluster_erp/modules/nesting/module.py:178-187).

Durumlar ve aksiyonlar¶

İş durumları queued, running, completed ve failed olur (src/cluster_erp/modules/nesting/nesting_jobs/schemas.py:10). Bir iş queued olarak başlar ve bir sonuç içe aktarıldığında completed olur (src/cluster_erp/modules/nesting/nesting_jobs/models.py:31-36, src/cluster_erp/modules/nesting/integration/services.py:322). "running" ve "failed" için yapılan grep bu commit'te bu durumlardan birini ayarlayan bir kod bulmaz. Artık durumları arasında available, reserved, consumed ve scrapped vardır (src/cluster_erp/modules/nesting/nesting_remnants/services.py:83, src/cluster_erp/modules/nesting/nesting_remnants/services.py:188-194, src/cluster_erp/modules/nesting/nesting_remnants/services.py:256-262).

Yerleşim hattı¶

Şema bir işin oluşturulmasından onaylanmasına kadar olan yolunu gösterir.

flowchart TD
 A["iş oluşturma (queued)"] --> B["parça ekleme veya siparişlerden parça çekme"]
 B --> C["malzeme ayırma (isteğe bağlı, ReserveStock)"]
 C --> D["işi dışa aktarma"]
 D --> E["harici yerleşim aracı"]
 E --> F["import-result: yerleşimi denetleme ve saklama (completed)"]
 F --> G["svg ve dxf çizimleri"]
 F --> H["maliyet hesaplama (NestingCostCalculated)"]
 H --> I["onay (NestingApproved)"]
 I --> J["malzeme tüketimi (ConsumeReservation, PostGoodsIssue)"]
 I --> K["artık oluşturma ve stoka kaydetme (PostGoodsReceipt)"]
 I --> L["NestingScrapRecorded"]

Düz anlatımla: bir iş queued olarak oluşturulur ve parçalarla doldurulur (src/cluster_erp/modules/nesting/nesting_jobs/services.py:111-160). İş kuyruktayken levha stoku ayrılabilir (src/cluster_erp/modules/nesting/nesting_jobs/services.py:394-468). İş dışa aktarılır, harici bir araçla yerleştirilir ve sonuç içe aktarılır; içe aktarım yerleşimleri denetler ve işi completed olarak işaretler (src/cluster_erp/modules/nesting/integration/services.py:114-363). Tamamlanmış bir iş çizilebilir ve maliyetlendirilebilir (src/cluster_erp/modules/nesting/nesting_jobs/services.py:555-675). Onay kullanımı denetler, sonra ayrılmış malzemeyi tüketir, içe aktarılan artanlardan artıklar oluşturur, bunları stoka kaydeder ve fireyi kaydeder (src/cluster_erp/modules/nesting/nesting_jobs/services.py:311-390).

İş kuralları¶

• Bir işin levha malzemesi isteğe bağlıdır; verildiğinde modeli ve versiyonu doğrulanır (src/cluster_erp/modules/nesting/nesting_jobs/services.py:116-122).
• Bir iş yalnızca queued veya failed durumundayken düzenlenebilir ve silinebilir; tamamlanmış bir iş yalnızca low_utilization_acknowledged ve notes alanlarını kabul eder (src/cluster_erp/modules/nesting/nesting_jobs/services.py:187-199, src/cluster_erp/modules/nesting/nesting_jobs/services.py:228-232).
• Kullanımı eşiğin altında olan bir işin onayı low_utilization_acknowledged ister; eşik varsayılanı 60 olan nesting_low_utilization_threshold ayarıdır (src/cluster_erp/modules/nesting/nesting_jobs/services.py:332-342, src/cluster_erp/modules/nesting/nesting_jobs/routes.py:221-222, src/cluster_erp/config/settings.py:418).
• Malzeme ayırmak bir levha malzemesi kırılımı ve bir depo ister (src/cluster_erp/modules/nesting/nesting_jobs/services.py:394-426).
• Para sonuçları ROUND_HALF_EVEN ile dört basamağa yuvarlanır (src/cluster_erp/modules/nesting/nesting_jobs/services.py:594-628).
• code değeri nesting_job ve nesting_remnant yıllık dizilerinden gelir (src/cluster_erp/modules/nesting/nesting_jobs/services.py:123, src/cluster_erp/modules/nesting/nesting_remnants/services.py:135).

Olaylar ve sorgular¶

Modül 2 sözleşme tüketir ve 16 sözleşme üretir; sayım parties modülü sayfasındaki gibi yapıldı.

GetNestingJobById, costing modülünün okuduğu net_material_cost dahil olmak üzere para ve alan değerlerini dizge olarak döndürür (src/cluster_erp/modules/nesting/module.py:82-108). Tam liste sözleşmeler başvurusu sayfasındadır.

Yetkiler¶

Gizlilik, saklama ve geçmiş¶

Modül kişisel veri saklamaz ve privacy_handlers.py dosyası yoktur. İşler geçici olarak silinir; bir işi silmek parçalarını ve artıklarını da geçici olarak siler (src/cluster_erp/modules/nesting/nesting_jobs/services.py:219-249, src/cluster_erp/modules/nesting/nesting_jobs/services.py:289-309). Değişiklikler değişiklik geçmişi tarafından kaydedilir.

Analitik olguları¶

Bu modülün analytics_facts.py dosyası yoktur. Kendi KPI servisi entegrasyon ve KPI sayfasında anlatılır.

Ayarlar ve başvuru verileri¶

Modül tek bir ayar okur: nesting_low_utilization_threshold (src/cluster_erp/config/settings.py:420). Ayarlar bölümü yoktur ve hiçbir şey tohumlamaz (src/cluster_erp/modules/nesting/module.py:28-30). Bkz. ayarlar başvurusu.

Testler¶

tests/ içinde modules.nesting için grep ile ve web-client/ içinde dosya adıyla bulundu.

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Yerleşim motoru
• İşler, parçalar ve artıklar
• Entegrasyon ve KPI
• Costing modülü
• Inventory modülü
• Bu modülün API başvurusu

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