Products and services modülü (products_and_services)

src/cluster_erp/modules/products_and_services/ içindeki products_and_services modülü malzeme ana verisidir. Planlama, stok ebadı ve maliyet alanlarıyla ürünleri ve hizmetleri, zorunlu ürün, model ve versiyon kırılımını, bir kategori ağacını, kırılım başına tedarikçi kaynaklarını ve ölçü birimlerini tutar. Bir ürünü anan diğer her modül bu modüle EventBus üzerinden sorar. Ortak kırılım kuralı ürün kırılımı ve stok dönüşümü sayfasında açıklanır.

Bir bakışta¶

Modül ne yapar¶

• Ürünleri ve hizmetleri malzeme türü, dört yetenek bayrağı, durum, birimler, fiziksel veriler, stok ebadı ve üret-ya-da-satın-al verileri, planlama parametreleri, maliyet alanları ve ticari verilerle tutar (src/cluster_erp/modules/products_and_services/products/models.py:20-351).
• Her ürüne en az bir model ve her modele en az bir versiyon verir; böylece stok ve belgeler her zaman tam bir kırılıma kayıt atabilir (src/cluster_erp/modules/products_and_services/product_versions/models.py:16-19).
• Bir ürünü bir kategori ağacının birden çok kategorisine bağlar (src/cluster_erp/modules/products_and_services/products/models.py:395-417, src/cluster_erp/modules/products_and_services/categories/models.py:11-30).
• Tedarikçi kaynaklarını ürün, model, versiyon ve tedarikçi tarafı başına kaydeder (src/cluster_erp/modules/products_and_services/vendors/models.py:14-63).
• Dönüşüm katsayılarıyla birim kategorilerini ve birimleri tutar ve başlangıçta varsayılan bir küme tohumlar (src/cluster_erp/modules/products_and_services/module.py:31-50).

Alt modüller¶

Yönlendirici yolları modül önekine görelidir; altı yönlendiricinin tamamı uygulama yetkisine bağlı tek bir modül yönlendiricisi altında durur (src/cluster_erp/modules/products_and_services/module.py:75-83).

Veri modeli¶

Ürün, model ve versiyon kırılımı¶

Şema kırılım tablolarını ve onları gösteren satırları gösterir.

erDiagram
 Product ||--|{ ProductModel : "product_id"
 ProductModel ||--|{ ProductVersion : "product_model_id"
 Product ||--o{ ProductCategoryLink : "product_id"
 ProductCategory ||--o{ ProductCategoryLink : "category_id"
 Product ||--o| ProductServiceAttributes : "product_id"
 ProductVersion ||--o{ ProductVendor : "product_version_id"
 UnitCategory ||--|{ UnitOfMeasure : "category_id"
 UnitOfMeasure ||--o{ Product : "base_unit_id"

Düz anlatımla: bir ürünün bir veya daha fazla modeli, bir modelin bir veya daha fazla versiyonu vardır. Ürün başına tam olarak bir canlı model ve model başına tam olarak bir canlı versiyon is_default taşır; bunu kısmi benzersiz indeksler zorlar (src/cluster_erp/modules/products_and_services/product_models/models.py:32-38, src/cluster_erp/modules/products_and_services/product_versions/models.py:35-41). Bir versiyon adı kendi modeli içinde benzersizdir (src/cluster_erp/modules/products_and_services/product_versions/models.py:42-49). Bir ürünün kategori bağları ve, bir hizmetse, tek bir hizmet bölümü satırı vardır. Bir tedarikçi kaynağı bir ürünü, bir modeli, bir versiyonu ve bir tedarikçi tarafını belirtir (src/cluster_erp/modules/products_and_services/vendors/models.py:16-49). Birimler bir birim kategorisine aittir ve bir ürün temel, satın alma, satış, ağırlık, hacim ve boyut birimlerini gösterir (src/cluster_erp/modules/products_and_services/products/models.py:103-138).

Varlıklar¶

Para ve miktar sütunları Numeric türündedir; maliyetler ve tedarikçi fiyatları Numeric(18, 4) kullanır (src/cluster_erp/modules/products_and_services/products/models.py:313-314, src/cluster_erp/modules/products_and_services/vendors/models.py:56). Decimal değerler dizge olarak serileştirilir (src/cluster_erp/modules/products_and_services/products/schemas.py:149-151, src/cluster_erp/modules/products_and_services/products/schemas.py:478-481). Bkz. para ve Decimal.

Ekranlar ve metadata¶

get_metadata üç bölümlü bir Ürünler ve Hizmetler (İngilizce Products & Services) kenar çubuğu grubu bildirir: Ürünler (liste), Kategoriler (ağaç) ve unit_category ile unit sekmeli Ayarlar (src/cluster_erp/modules/products_and_services/module.py:954-997). Ürün ayrıntısında Genel, Hizmet, Fiziksel Özellikler, Envanter ve Planlama, Üretim ve Maliyet, Tedarikçiler, Modeller, Ürün Ağaçları ve Stok sekmeleri vardır (src/cluster_erp/modules/products_and_services/products/metadata.py:222-295). Hizmet sekmesi yalnızca service malzeme türü için görünür; fiziksel, envanter, üretim ve stok sekmeleri onun için gizlenir. Ürün Ağaçları sekmesi yalnızca üretilebilir ürünler için görünür ve bom modülünün listesini okur; Stok ise inventory modülünün listesini okur (src/cluster_erp/modules/products_and_services/products/metadata.py:230-294). Oluşturma formu ilk modelin adını, SKU'sunu ve barkodunu ve ilk versiyonun adını toplar (src/cluster_erp/modules/products_and_services/products/metadata.py:381-424). Ürünlerin ve modellerin fotoğrafları vardır (src/cluster_erp/modules/products_and_services/products/metadata.py:118, src/cluster_erp/modules/products_and_services/products/metadata.py:1328). Kategori ağacı GET /categories/tree kullanır (src/cluster_erp/modules/products_and_services/categories/metadata.py:26-32).

Durumlar ve aksiyonlar¶

Ürün durumları draft, active, blocked ve obsolete olur (src/cluster_erp/modules/products_and_services/products/schemas.py:24-28). Durum bir form alanıdır ve değişikliği ProductStatusChanged yayar (src/cluster_erp/modules/products_and_services/products/services.py:590-598). Modül tek bir ActionMeta bildirir.

İş kuralları¶

• Her malzeme türünün, yük bir bayrağı belirtmediğinde kullanılan varsayılan yetenek bayrakları vardır (src/cluster_erp/modules/products_and_services/products/schemas.py:34-89, src/cluster_erp/modules/products_and_services/products/services.py:296-312).
• Kesin kısıtlar: bir hizmet ne stoklanabilir ne üretilebilirdir, bir sarf malzemesi stoklanamaz ve bir hammadde üretilemez; ihlal PRODUCT_CAPABILITY_VIOLATION yanıtını verir (src/cluster_erp/modules/products_and_services/products/schemas.py:91-95, src/cluster_erp/modules/products_and_services/products/services.py:671-683).
• Stoklanamayan bir ürünün parti, seri, raf ömrü, emniyet stoku ve yeniden sipariş noktası alanları temizlenir (src/cluster_erp/modules/products_and_services/products/services.py:48-55, src/cluster_erp/modules/products_and_services/products/services.py:316-318).
• SKU ve barkod canlı ürünler arasında boş olmalıdır (src/cluster_erp/modules/products_and_services/products/services.py:272-292).
• Bir ürün oluşturmak varsayılan modelini oluşturur; ad verilmezse model ürünün adını alır. Model de varsayılan versiyonunu oluşturur; versiyonun adı varsayılan olarak 1 olur (src/cluster_erp/modules/products_and_services/products/services.py:376-395, src/cluster_erp/modules/products_and_services/product_models/services.py:103-112, src/cluster_erp/modules/products_and_services/product_models/schemas.py:22).
• Bir ürünün ilk modeli ve bir modelin ilk versiyonu varsayılan olur; yeni bir varsayılan bayrağı eskisinden alır (src/cluster_erp/modules/products_and_services/product_models/services.py:78-99, src/cluster_erp/modules/products_and_services/product_versions/services.py:72-90).
• Varsayılan model veya versiyon varsayılanlıktan düşürülemez, kullanımdan kaldırılamaz veya silinemez; yanıt HTTP 409 ile PRODUCT_MODEL_DEFAULT_PROTECTED veya PRODUCT_VERSION_DEFAULT_PROTECTED olur (src/cluster_erp/modules/products_and_services/product_models/services.py:115-160, src/cluster_erp/modules/products_and_services/product_versions/services.py:92-140).
• Etkin bir ürün ağacı versiyonunun canlı bileşeni olan bir ürün silinemez; modül bom modülüne GetPartUsageCounts ile sorar ve PRODUCT_IN_ACTIVE_BOM yanıtını verir (src/cluster_erp/modules/products_and_services/products/services.py:604-626).
• Bir ürünü silmek kategori bağlarını ve hizmet bölümünü de aynı zaman damgasıyla geçici olarak siler; yeniden etkinleştirmek onları geri getirir (src/cluster_erp/modules/products_and_services/products/services.py:628-660, src/cluster_erp/modules/products_and_services/module.py:165-236).
• Bir üründe belirtilen her kategori canlı olmalıdır; ilki normalleştirilmemiş category_id olur (src/cluster_erp/modules/products_and_services/products/services.py:151-206).
• Bir tedarikçi kaynağı ürünün ve tarafın var olduğunu denetler, kırılımı doğrular ve aynı kırılım ve taraf için ikinci bir canlı kaynağı HTTP 409 ile reddeder (src/cluster_erp/modules/products_and_services/vendors/services.py:94-143).
• Birim dönüşümü yalnızca tek bir birim kategorisi içinde çalışır: değer çarpı kaynak katsayı, bölü hedef katsayı (src/cluster_erp/modules/products_and_services/settings/services.py:237-247). Tohumda 13 birim kategorisi vardır (src/cluster_erp/modules/products_and_services/settings/seed_data.py, code anahtarlı girdiler).
• Kodlar product, product_model, product_version, product_category ve unit_of_measure yıllık dizilerinden gelir (src/cluster_erp/modules/products_and_services/products/services.py:325, src/cluster_erp/modules/products_and_services/product_models/services.py:79, src/cluster_erp/modules/products_and_services/product_versions/services.py:73).

Olaylar ve sorgular¶

Modül 19 sözleşme tüketir ve 8 sözleşme üretir; sayım parties modülü sayfasındaki gibi yapıldı. Üreticilerin ve tüketicilerin tam listesi sözleşmeler başvurusu sayfasındadır.

CreateScaffoldIntermediate, bir rota operasyonunun çıktısı için stoklanabilir ama üretilemez bir yarı mamul ürünü oluşturur veya SKU'ya göre yeniden kullanır (src/cluster_erp/modules/products_and_services/module.py:806-875). BOM modülü sayfasında anlatılan rota iskeleti tarafından kullanılır.

Yetkiler¶

Gizlilik, saklama ve geçmiş¶

Modül kendine ait kişisel veri saklamaz ve privacy_handlers.py dosyası yoktur. Bir tedarikçi kaynağı, tedarikçi tarafının görünen adını vendor_name_cache içinde tutar (src/cluster_erp/modules/products_and_services/vendors/models.py:51, src/cluster_erp/modules/products_and_services/vendors/services.py:145-148). Değişiklikler değişiklik geçmişi tarafından kaydedilir.

Analitik olguları¶

analytics_facts.py, products_products üzerinde tek bir olgu kümesi, product, bildirir; boyutları malzeme türü, durum, stok biçimi, temin tercihi, ABC göstergesi, aktif ve oluşturulma tarihi, ölçüleri product_count ve average_lead_time_days olur (src/cluster_erp/modules/products_and_services/analytics_facts.py:21-87).

Ayarlar ve başvuru verileri¶

Birim kategorileri ve birimler veritabanındaki başvuru verileridir. Modül her başlangıçta varsayılan kümeyi UNIT_SEED_DATA içinden tohumlar (src/cluster_erp/modules/products_and_services/module.py:37-50, src/cluster_erp/modules/products_and_services/settings/services.py:86-150). Varsayılanları Yükle aksiyonu aynı tohumlamayı istek üzerine çalıştırır.

Testler¶

tests/ içinde modules.products_and_services 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
• Ürün kırılımı ve stok dönüşümü
• Ürün, model ve versiyon kırılımı karar kaydı
• BOM modülü
• Inventory modülü
• Bu modülün API başvurusu
• İlgili malzeme, tarihsel, doğrulanmadı: ağaç içi not src/cluster_erp/modules/products_and_services/docs/how-to.md. Ürün versiyonlarından söz etmez ve ürün modelinde bulunmayan default_unit_id adlı bir alan kullanır (src/cluster_erp/modules/products_and_services/products/models.py:103-116).

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