BOM modülü (bom)

src/cluster_erp/modules/bom/ içindeki bom modülü, üretilen her ürün kırılımının ürün ağacını (BOM) tutar. Bir ürün ağacı kartı inşa ettiği ürünü, modeli ve versiyonu belirtir; taslaktan etkine, etkinden yerini almışa geçen numaralı versiyonları vardır ve her versiyonun bir kalem ağacı bulunur. Modül bir versiyonu maliyetlendirme, üretim ve planlama için etkin miktarlara patlatır ve production modülünün rota iskeletinin operasyon ürün ağacını (eBOM) türetmek için okuduğu ürün ağacını sunar.

Bir bakışta¶

Modül ne yapar¶

• Her ürün kırılımı için temel miktar, kullanım türü ve durumla tek bir ürün ağacı kartı tutar (src/cluster_erp/modules/bom/boms/models.py:17-79).
• Yapıyı sürümler: yalnızca taslaklar düzenlenebilir ve bir ürün ağacının en çok bir versiyonu etkindir (src/cluster_erp/modules/bom/bom_versions/models.py:19-42).
• Kalemleri bir versiyon içinde ağaç olarak saklar; kalem numarası, miktar, birim, fire katsayısı, kesim ölçüleri, üret-ya-da-satın-al seçimi, stok malzemesi, geçerlilik tarihleri ve birim başına işçilik ve maliyet değerleriyle (src/cluster_erp/modules/bom/bom_items/models.py:18-142).
• Yeniden kullanılabilir şablonları bir taslak versiyona kopyalar (src/cluster_erp/modules/bom/bom_versions/services.py:544-651).
• Bir versiyonu etkin miktarlara ve kırılım başına bir toplama patlatır (src/cluster_erp/modules/bom/bom_versions/services.py:722-820).
• Gezgin ağacını, nerede kullanıldığı verisini ve bir satın alma kapsama özetini sunar (src/cluster_erp/modules/bom/bom_versions/services.py:822-836, src/cluster_erp/modules/bom/bom_versions/services.py:1141-1151, src/cluster_erp/modules/bom/bom_versions/services.py:1519-1520).
• Parçası olan bir tasarım onaylandığında ilk taslak versiyonuyla bir ürün ağacı kartı oluşturur (src/cluster_erp/modules/bom/module.py:667-775).

Alt modüller¶

Veri modeli¶

Miktarlar ve para Numeric türündedir: kalem miktarı Numeric(18, 4), maliyetler Numeric(18, 4), fire katsayısı Numeric(6, 4) (src/cluster_erp/modules/bom/bom_items/models.py:62-128). Ürün kimlikleri düz UUID sütunlarıdır; bom modülü bunları veritabanı yabancı anahtarlarıyla değil EventBus üzerinden denetler (src/cluster_erp/modules/bom/boms/services.py:203-213).

Ekranlar ve metadata¶

get_metadata dört bölümlü bir Ürün Ağacı Yönetimi (İngilizce BOM Management) kenar çubuğu grubu bildirir: Ürün Ağacı Gezgini (bom_explorer özel bileşeni), Ürün Ağaçları, Ürün Ağacı Versiyonları ve Ürün Ağacı Şablonları (src/cluster_erp/modules/bom/module.py:838-905). Gezgin sekmelerinin etiketleri Ürün Ağacı · BOM (webapp/i18n/tr.json anahtarı bom_explorer.tab.cs03) ve Operasyon Ürün Ağacı · eBOM (webapp/i18n/tr.json anahtarı bom_explorer.tab.ca03) olur. Ürün kartı üretilebilir ürünler için salt okunur bir Ürün Ağaçları sekmesi gösterir (src/cluster_erp/modules/products_and_services/products/metadata.py:276-285). Kapılı paketler kapılı uygulama paketleri, masaüstü gezgini masaüstü modül ekranları sayfasında anlatılır.

Durumlar ve aksiyonlar¶

Bir ürün ağacı kartı active veya archived olur; kullanım türü manufacturing, engineering veya costing olur (src/cluster_erp/modules/bom/boms/schemas.py:10-11). Bir versiyon draft durumundan active durumuna, oradan superseded durumuna geçer (src/cluster_erp/modules/bom/bom_versions/models.py:20-24).

Şema bir versiyonun yaşam döngüsünü gösterir.

stateDiagram-v2
 [*] --> draft: oluşturma, klonlama veya otomatik BOM
 draft --> active: activate
 active --> superseded: taslak bir ardılla supersede
 draft --> [*]: silme
 superseded --> [*]

Düz anlatımla: bir versiyon draft olarak oluşturulur (src/cluster_erp/modules/bom/bom_versions/services.py:231-274). activate, en az bir canlı kalemi olan ve ürün ağacında başka etkin versiyon bulunmayan bir taslak ister (src/cluster_erp/modules/bom/bom_versions/services.py:417-474). supersede tek çağrıda etkin versiyonu superseded yapar ve aynı ürün ağacının bir taslağını active yapar (src/cluster_erp/modules/bom/bom_versions/services.py:476-542). Yalnızca bir taslak silinebilir ve kalemleri de onunla gider (src/cluster_erp/modules/bom/bom_versions/services.py:305-333).

İş kuralları¶

• Bir ürün ağacı kartını oluşturmak veya değiştirmek, ürünün var olduğunu ve modelin ve versiyonun ona ait olduğunu denetler (src/cluster_erp/modules/bom/boms/services.py:80-108, src/cluster_erp/modules/bom/boms/services.py:130-139).
• Arşivlenmiş bir ürün ağacı yalnızca yeniden etkin yapılabilir (src/cluster_erp/modules/bom/boms/services.py:120-124).
• Etkin veya yerini almış versiyonu olan bir ürün ağacı silinemez; bir ürün ağacını silmek versiyonlarını ve kalemlerini geçici olarak siler (src/cluster_erp/modules/bom/boms/services.py:159-176, src/cluster_erp/modules/bom/boms/services.py:215-267).
• Kalemler yalnızca taslak bir versiyonda eklenebilir veya değiştirilebilir (src/cluster_erp/modules/bom/bom_items/services.py:135-137).
• Sıfır miktar reddedilir; negatif miktar bir ko-üründür (src/cluster_erp/modules/bom/bom_items/services.py:139-146).
• Her kalemin kırılımı doğrulanır; model ve versiyon olmadan verilen bir stok malzemesi ürünün varsayılanlarını alır (src/cluster_erp/modules/bom/bom_items/services.py:91-128, src/cluster_erp/modules/bom/bom_items/services.py:158-169).
• Kalem seviyesi üst kalem zincirinden gelir; zincir döngü yapamaz ve 10 olan MAX_BOM_DEPTH değerinden derine inemez (src/cluster_erp/modules/bom/bom_items/services.py:32, src/cluster_erp/modules/bom/bom_items/services.py:430-470).
• Eksik bir fire katsayısı 0.0300 olan DEFAULT_SCRAP_FACTOR değerini alır (src/cluster_erp/modules/bom/bom_items/services.py:33, src/cluster_erp/modules/bom/bom_items/services.py:180-181).
• clone herhangi bir versiyonu sonraki versiyon numarasıyla ve tüm kalemleriyle yeni bir taslağa kopyalar (src/cluster_erp/modules/bom/bom_versions/services.py:335-415).
• Versiyon toplamları: işçilik dakikaları ve işçilik maliyeti birim başına değerler çarpı miktardır; malzeme maliyeti birim maliyet çarpı miktar bölü bir eksi fire katsayısıdır; ağırlık, ürün ana verisinden yaprak kalemlerin net ağırlığını toplar (src/cluster_erp/modules/bom/bom_versions/services.py:671-718).
• bom_code değeri bom yıllık dizisinden, template_code değeri bom_template dizisinden gelir (src/cluster_erp/modules/bom/boms/services.py:89, src/cluster_erp/modules/bom/bom_templates/services.py:101).

Patlatma ve operasyon ürün ağacı¶

Şema bir ürün ağacı versiyonunun diğer modüllerin okuduğu patlatmaya nasıl dönüştüğünü ve rota iskeletinin ağacı nasıl okuduğunu gösterir.

flowchart TD
 V["BomVersion ve BomItem satırları"] --> F["_filter_effective(as_of)"]
 F --> Q["effective_qty = qty / (1 - fire), her üst kalemin qty / (1 - üst fire) değeriyle çarpılır"]
 Q --> A["production atamalarından operation_type ve work_center_id"]
 A --> R["parça, model, versiyon başına toplam"]
 R --> X["GetBomExplosion yanıtı"]
 X --> C["costing"]
 X --> P["production ve MRP"]
 V --> S["GetBomScaffoldTree yanıtı"]
 S --> W["production rota iskeleti"]
 W --> I["products_and_services modülüne CreateScaffoldIntermediate"]

Düz anlatımla: explosion bir versiyonun canlı kalemlerini yükler ve geçerlilik penceresi verilen tarihi içermeyen kalemleri tüm alt ağaçlarıyla düşürür (src/cluster_erp/modules/bom/bom_versions/services.py:136-159, src/cluster_erp/modules/bom/bom_versions/services.py:734-741). Her kalem için etkin miktar, miktarın bir eksi kendi fire katsayısına bölümüdür; sonra her üst kalemin miktarının bir eksi o üstün fire katsayısına bölümüyle çarpılır ve ROUND_HALF_EVEN ile dört basamağa yuvarlanır; negatif bir ko-ürün miktarı fire almaz (src/cluster_erp/modules/bom/bom_versions/services.py:128-133, src/cluster_erp/modules/bom/bom_versions/services.py:748-767). Operasyon türü ve iş merkezi production modülünün bileşen atamalarından gelir (src/cluster_erp/modules/bom/bom_versions/services.py:790-796). Toplam, etkin miktarları parça, model ve versiyon başına toplar (src/cluster_erp/modules/bom/bom_versions/services.py:798-820). Diğer modüller bunu GetBomExplosion ile ister (src/cluster_erp/modules/bom/module.py:217-228). Patlatma tek bir versiyon içindeki üst kalem bağlarını izler; gezgin tree ayrıca kendi etkin ürün ağacı olan kalemleri açar (src/cluster_erp/modules/bom/bom_versions/services.py:1141-1151).

Operasyon ürün ağacı için production modülünün rota iskeleti tam bir ürün kırılımıyla GetBomScaffoldTree sorar. bom modülü tam olarak o kırılımın etkin versiyonuyla veya adı verilen bir versiyonla ve çözülmüş üret-ya-da-satın-al bilgisiyle tüm canlı kalemleriyle yanıt verir; varsayılan bir kırılıma geri dönmez (src/cluster_erp/modules/bom/module.py:363-420, src/cluster_erp/modules/production/routings/scaffold.py:185-192). İskelet hayalet olmayan kalemleri son bir birleştirme operasyonunun girdilerine dönüştürür ve hayalet kalemlerin alt kalemlerini yukarı taşır; bu modül docstring'inde anlatılır (src/cluster_erp/modules/production/routings/scaffold.py:1-43). Bir rotanın bir operasyonunun çıktısı olduğunda iskelet, products_and_services modülünden CreateScaffoldIntermediate ile bir ara ürün oluşturmasını veya yeniden kullanmasını ister (src/cluster_erp/modules/production/routings/scaffold.py:2221-2239). Rota tarafı rotalar ve operasyon türleri sayfasında belgelenir.

Olaylar ve sorgular¶

Modül 15 sözleşme tüketir ve 14 sözleşme üretir; sayım parties modülü sayfasındaki gibi yapıldı. Tam liste sözleşmeler başvurusu sayfasındadır.

Aboneliklerin taşıdığı kurallar:

• DesignApproved olayında modül tasarımın parçasını okur, o ürünün varsayılan modelini ve versiyonunu alır ve tasarımın adını taşıyan, taslak versiyon 1'i olan active bir ürün ağacı kartı oluşturur. Parçası olmayan bir tasarımı, zaten bir ürün ağacına sahip bir tasarımı ve varsayılan kırılımı olmayan bir ürünü atlar (src/cluster_erp/modules/bom/module.py:667-775).
• ProductDeleted olayında modül silinen ürünün yalnızca taslak versiyonlardaki kalemlerini geçici olarak siler; etkin ve yerini almış versiyonlar satırlarını korur (src/cluster_erp/modules/bom/module.py:777-816).

Yetkiler¶

Gizlilik, saklama ve geçmiş¶

Modül kişisel veri saklamaz ve privacy_handlers.py dosyası yoktur. Silme baştan sona geçicidir ve versiyon ile kalem silmeleri aynı aktörle zincirlenir (src/cluster_erp/modules/bom/boms/services.py:215-249). Değişiklikler değişiklik geçmişi tarafından kaydedilir.

Analitik olguları¶

Bu modülün analytics_facts.py dosyası yoktur.

Ayarlar ve başvuru verileri¶

Modülün ayarlar bölümü yoktur. Stoktan işlenen kalemler için stok birimi hesabı, kesim payı, levha aralığı ve kenar payı ayarlarını core/stock_conversion.py üzerinden okur (src/cluster_erp/modules/bom/bom_versions/services.py:95-125); bkz. ürün kırılımı ve stok dönüşümü.

Testler¶

tests/ içinde modules.bom 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
• Products and services modülü
• Design engineering modülü
• Costing modülü
• Production modülü
• Ürün kırılımı ve stok dönüşümü
• Bu modülün API başvurusu

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