Purchasing quotations modülü (purchasing_quotations)

src/cluster_erp/modules/purchasing_quotations/ içindeki purchasing_quotations modülü tedarikçi tekliflerinin defteridir. Bir tedarikçi teklifi (PurchasingQuotation), bir satın alma teklif talebiyle veya talepsiz olarak bir tedarikçinin teklifini kaydeder; kalem başına indirim, ek ücret ve navlun koşullarıyla fiyatlanır. Bir teklifin ihalesi procurement modülünde bir satın alma siparişi veya satın alma sözleşmesi oluşturabilir ve satın alma info kayıtlarını günceller. Defter, satın alma teklif talebi alt modülünde tutulan tedarikçi tekliflerini de listeler.

Bir bakışta¶

Modül ne yapar¶

• Tedarikçi tekliflerini dört source değeriyle kaydeder: rfq, unsolicited (varsayılan), spot ve price_list (src/cluster_erp/modules/purchasing_quotations/quotations/models.py:40-46, src/cluster_erp/modules/purchasing_quotations/quotations/schemas.py:16).
• Her kalemi bir koşul dizisinden geçirerek etkin birim fiyata ulaştırır (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:797-831).
• Revizyonları tutar: revise bir teklifi yeni bir sürüme kopyalar ve eskisini yerini almış olarak işaretler (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:509-594).
• Kalemleri ihale eder ve istenirse EventBus üzerinden bir satın alma siparişi veya sözleşmesi oluşturur (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:285-346).
• Bir ürün için tüm canlı teklif kalemlerini etkin fiyata göre karşılaştırır ve yerel ve teklif talebi tekliflerinden oluşan bir defter listeler (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:990-1116).

Alt modüller¶

Yönlendirici modül önekinin altına require_app("purchasing_quotations") ile bağlanır (src/cluster_erp/modules/purchasing_quotations/module.py:39-49).

Veri modeli¶

Para Numeric türündedir: toplam ve kalem toplamı Numeric(19, 4), fiyatlar ve koşul değerleri Numeric(18, 4) (src/cluster_erp/modules/purchasing_quotations/quotations/models.py:81, src/cluster_erp/modules/purchasing_quotations/quotations/models.py:127-131, src/cluster_erp/modules/purchasing_quotations/quotations/models.py:172). Kalem kırılımları ensure_product_breakdown ile denetlenir (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:713, src/cluster_erp/modules/purchasing_quotations/quotations/services.py:745).

Ekranlar ve metadata¶

get_metadata üç liste bölümlü bir Tedarikçi Teklifleri (İngilizce Supplier Quotations) kenar çubuğu grubu bildirir: Tedarikçi Teklifleri, Tüm Teklifler (Defter) ve Tedarikçi Teklifi Karşılaştır (src/cluster_erp/modules/purchasing_quotations/module.py:130-170). Defter ve karşılaştırma görünümleri kendi varlıklarıdır: purchasing_quotation_register ve purchasing_quotation_compare (src/cluster_erp/modules/purchasing_quotations/module.py:173-184). Bkz. genel liste.

Durumlar ve aksiyonlar¶

Durumlar in_preparation (varsayılan), submitted, awarded, completed, rejected ve cancelled'dır (src/cluster_erp/modules/purchasing_quotations/quotations/models.py:54-62). Servis her aksiyonu bir hedef duruma ve izin verilen kaynak durumlara eşler (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:57-64).

stateDiagram-v2
 [*] --> in_preparation
 in_preparation --> submitted: submit
 submitted --> awarded: award
 in_preparation --> rejected: reject
 submitted --> rejected: reject
 awarded --> completed: complete
 in_preparation --> cancelled: cancel
 submitted --> cancelled: cancel
 awarded --> cancelled: cancel
 rejected --> in_preparation: reopen
 cancelled --> in_preparation: reopen

Düz anlatımla: bir teklif hazırlanır ve gönderilir, sonra ihale edilir veya reddedilir. İhale edilmiş bir teklif tamamlanır veya iptal edilir. Reddedilmiş veya iptal edilmiş bir teklif yeniden açılabilir. revise, submitted, rejected veya cancelled durumundan çalışır ve yeni bir in_preparation sürümü başlatır (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:509-525).

İş kuralları¶

• Bir teklif yalnızca in_preparation veya submitted durumunda düzenlenebilir (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:54, src/cluster_erp/modules/purchasing_quotations/quotations/services.py:634-640).
• Yalnızca in_preparation, cancelled veya rejected teklifler silinebilir; silme deleted_at alanını doldurur (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:224-238).
• Gönderim için en az bir kalem, reddedilmemiş en az bir kalem, bir para birimi ve bir geçerlilik tarihi gerekir (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:599-633).
• Etkin birim fiyat koşulları sequence sırasıyla dolaşır. Yüzde, yürüyen ara toplama veya net fiyata uygulanır; per_unit birim başına sabit tutar ekler; absolute sabit bir tutarı miktara yayar. İndirimler düşer, ek ücret ve navlun ekler; sonuç sıfırın altına inmez (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:797-831).
• Kalem toplamı miktar çarpı etkin fiyattır ve dört basamağa yuvarlanır; başlık toplamı her kalem veya koşul değişikliğinde yeniden hesaplanır (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:848-874).
• İhale önce kararı saklar, istenirse ardından bir izleyen satın alma siparişi veya sözleşmesi oluşturur; izleyen belge zaten varsa bu adımı atlar (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:321-339, src/cluster_erp/modules/purchasing_quotations/quotations/services.py:389-449).
• code, purchasing_quotation yıllık dizisinden gelir; bir revizyon yeni bir kod ve bir fazla version_no alır (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:168, src/cluster_erp/modules/purchasing_quotations/quotations/services.py:522).
• Kademeler kalem başına saklanır ve revizyonda kopyalanır; etkin fiyat hesabı bunları okumaz (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:580-582, src/cluster_erp/modules/purchasing_quotations/quotations/services.py:848-851).

Olaylar ve sorgular¶

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

SupplierQuotationAwarded ve CreateFollowOnFromSupplierQuotation sözleşmelerini procurement modülü işler; bkz. satın alma sözleşmeleri ve info kayıtları.

Yetkiler¶

Gizlilik, saklama ve geçmiş¶

Modülün privacy_handlers.py dosyası yoktur. Teklifler yumuşak silinir (src/cluster_erp/modules/purchasing_quotations/quotations/services.py:236). Fiyat koşulları ve kademeler, satırlarıyla birlikte yenilenen alt satırlardır; her kaldırma kayda geçsin diye ORM üzerinden kaldırılır (aşağıdaki nota bakın). Değişiklikler değişiklik geçmişi tarafından kaydedilir.

Analitik olguları¶

analytics_facts.py, purchasing_quotation.read ile okunan quotation_count, total_amount, median_amount ve average_lead_time_days ölçülü purchasing_quotation olgu kümesini katar (src/cluster_erp/modules/purchasing_quotations/analytics_facts.py:17-117). Bkz. analitik olguları.

Ayarlar ve başvuru verileri¶

Modülün ayarlar bölümü yoktur. Koddan belirlenemedi: koşul tiplerinin başvuru verisinden gelip gelmemesi gerektiği; bunlar şemada sabit bir Literal olarak tanımlıdır (src/cluster_erp/modules/purchasing_quotations/quotations/schemas.py:16-19).

Testler¶

tests/ içinde modules.purchasing_quotations için (sonuç yok) ve web-client/ içinde dosya adına ve /purchasing_quotations/ yoluna göre grep ile bulundu.

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Procurement modülü
• Satın alma teklif talepleri
• Satın alma sözleşmeleri ve info kayıtları
• Bu modülün API başvurusu

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