Subscriptions modülü (subscriptions)

src/cluster_erp/modules/subscriptions/ içindeki subscriptions modülü yinelenen işleri kaydeder: şirketin sunduğu planları, müşterilerin bu planlara aboneliklerini ve şirketin kendisinin tedarikçilerle olan aboneliklerini. Fatura dönemlerini, yenilemeleri ve süre dolumunu izler ve yaşam döngüsü olayları yayar; fatura üretmez. Bir iş modülüdür; bir kiracının SaaS üyeliği değildir, o çok kiracılılık sayfasında açıklanır.

Bir bakışta¶

Modül ne yapar¶

• Bir plan hangi yinelenen ürünün satıldığını, ne sıklıkla faturalandığını ve hangi fiyatla satıldığını belirtir (src/cluster_erp/modules/subscriptions/plans/models.py:13-21).
• Bir satış aboneliği koşullarını etkin bir plandan alır; bir satın alma aboneliğinin koşulları bir tedarikçiye karşı doğrudan girilir (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:129-206).
• Etkinleştirme planın koşullarının anlık görüntüsünü alır; böylece sonraki plan değişiklikleri geçmişi yeniden yazmaz (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:247-275).
• Günlük bir tarama, dönemi bitmiş abonelikleri yeniler veya sona erdirir (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:348-390, src/cluster_erp/server/app.py:504-546).

Alt modüller¶

Veri modeli¶

Para değerleri Numeric sütunlar ve şemalarda Decimal olur; olaylar tutarları dizge olarak taşır (src/cluster_erp/modules/subscriptions/plans/models.py:43-47, src/cluster_erp/modules/subscriptions/plans/schemas.py:22-24, src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:415-444). Bkz. para ve Decimal.

Ekranlar ve metadata¶

get_metadata, iki liste bölümüyle Abonelikler (İngilizce Subscriptions) adlı bir kenar çubuğu grubu bildirir: customer_subscription için Abonelikler ve subscription_plan için Planlar (İngilizce Plans) (src/cluster_erp/modules/subscriptions/module.py:121-153). Fatura döngüsü seçenekleri Aylık, Üç Aylık, Altı Aylık ve Yıllık olur (src/cluster_erp/modules/subscriptions/customer_subscriptions/metadata.py:40-45).

Durumlar ve aksiyonlar¶

Plan durumları draft, active, retired sırasıyla ilerler, geri dönüş yoktur (src/cluster_erp/modules/subscriptions/plans/services.py:101-117). Abonelik durumları draft, active, paused, cancelled ve expired olur (src/cluster_erp/modules/subscriptions/customer_subscriptions/models.py:97-100).

Durum şeması bir aboneliğin yaşam döngüsünü gösterir.

stateDiagram-v2
    [*] --> draft: create
    draft --> active: activate
    active --> paused: pause
    paused --> active: resume
    active --> active: renew veya tarama yenilemesi
    active --> expired: tarama, bitiş geldi veya yenileme kapalı
    draft --> cancelled: cancel
    active --> cancelled: cancel
    paused --> cancelled: cancel
    cancelled --> [*]
    expired --> [*]

Düz anlatımla: abonelik draft olarak yaratılır; activate ilk dönemi başlatır; pause ve resume active ile paused arasında geçirir; renew veya tarama etkin bir aboneliğin dönemini ilerletir; tarama bitiş tarihini geçmiş veya dönemi yenilemesi kapalıyken bitmiş etkin bir aboneliği sona erdirir; cancel zaten iptal edilmemiş veya sona ermemiş her aboneliği bitirir (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:247-399). Etiketler metadata etiket sözlüklerinden gelir.

İş kuralları¶

• Bir satış aboneliği bir müşteri ve etkin bir plan ister; bir satın alma aboneliği bir tedarikçi, ürün üçlüsünün tamamı, fiyat, döngü ve para birimi ister (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:129-190).
• subscription_no ve plan code değeri next_code ile verilen yıllık iş anahtarlarıdır (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:112, src/cluster_erp/modules/subscriptions/plans/services.py:65).
• Bir dönem ay olarak döngü uzunluğu (1, 3, 6 veya 12) çarpı interval_count olur ve ilk dönemin ayın gününe sabitlenir (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:35-53, src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:328-339).
• Tarama vadesi gelmiş her dönemi yakalar ve dönem başına bir yenileme yayar (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:365-385).
• Bir olaydaki tutar birim fiyat çarpı miktardır (src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:426-444).

Olaylar ve sorgular¶

Dört olay sınıfı için modül dışında yapılan grep bu commit'te hiçbir abone bulmaz.

Yetkiler¶

Yaşam döngüsü kodları ek kodlar olarak tohumlanır (src/cluster_erp/server/app.py:837-847).

Gizlilik, saklama ve geçmiş¶

Modül müşterilerin ve tedarikçilerin taraf kimliklerini saklar ama kendine ait kişisel alanı yoktur ve privacy_handlers.py dosyası yoktur. Değişiklikler değişiklik geçmişine yazılır; bkz. değişiklik geçmişi. extra içindeki kiracı tanımlı değerler okumada izne göre süzülür (src/cluster_erp/modules/subscriptions/customer_subscriptions/routes.py:42-48).

Analitik olguları¶

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

Ayarlar ve başvuru verileri¶

Modül kendine özgü bir ayar okumaz. Para birimleri plan şemasında desenle doğrulanan üç harfli kodlardır (src/cluster_erp/modules/subscriptions/plans/schemas.py:23). Günlük tarama her kiracı veritabanında bir lider kilidi altında çalışır (src/cluster_erp/server/app.py:504-546).

Testler¶

tests/ ve web-client/ içinde dosya adıyla bulundu.

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Bu modülün API başvurusu
• Kimlik, erişim, kiracılık, gizlilik ve lisans
• Para ve Decimal

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