Records modülü (records)

src/cluster_erp/modules/records/ içindeki records modülü, hiçbir şeyin doğrudan silinmediği kuralı altında kayıtların yaşam döngüsünü yönetir. Devre dışı bırakma nedenleri kataloğunu tutar, herhangi bir varlığın devre dışı kayıtlarını listelemek ve onları yeniden etkinleştirmek için genel uçlar sunar ve günlük temizliğin devre dışı satırları kalıcı olarak kaldırmasından önceki saklama süresini tutar (src/cluster_erp/modules/records/module.py:15-22). Devre dışı bırakma mekanizmasının kendisi yumuşak silme ve devre dışı bırakma sayfasında anlatılır.

Bir bakışta¶

Modül ne yapar¶

• Bir kayıt kullanımdan kaldırılırken yöneticinin seçebileceği devre dışı bırakma nedenlerini tutar (src/cluster_erp/modules/records/deactivation_reasons/models.py:9-32).
• Devre dışı bırakılabilir herhangi bir varlığın devre dışı kayıtlarını listeler, pasif olabilecek kayıtların etiketlerini çözer ve bir kaydı yeniden etkinleştirir (src/cluster_erp/modules/records/lifecycle_routes.py:1-10).
• Yıl olarak saklama süresini ve her saklama geçişinin kanıt satırlarını tutar (src/cluster_erp/modules/records/retention/models.py:14-49).
• Süreden eski devre dışı satırları ve değişiklik geçmişini fiziksel olarak silen purge_expired işlevini sağlar (src/cluster_erp/modules/records/retention/purge.py:1-7).

Alt modüller¶

Veri modeli¶

Kayıt yaşam döngüsü¶

flowchart TD
 L["canlı kayıt"] -->|nedenli DELETE| D["deleted_at, deleted_by, deactivation_reason doldurulur"]
 R["DeactivationReason kataloğu"] --> D
 D --> H["core_change_history satırı"]
 D --> P["GET /records/module/entity/inactive"]
 P -->|POST .../record_id/activate| L
 D -->|retention_years süresinden eski| X["purge_expired: fiziksel silme"]
 X --> E["RetentionRun kanıt satırı"]

Düz anlatımla:

1. Herhangi bir modülün silme ucu deleted_at alanını doldurur. Merkezi değişiklik geçmişi kancası deleted_by alanını ve istek bağlamındaki nedeni yazar; böylece hiçbir modül nedeni kendisi taşımaz (src/cluster_erp/core/change_history.py:245-259). Değişiklik, değişiklik geçmişine yazılır; bkz. değişiklik geçmişi.
2. GET /records/{module}/{entity}/inactive, {entity}.read iznini ve modülün uygulama yetkisini denetledikten sonra bir varlığın devre dışı satırlarını en yeniden başlayarak listeler (src/cluster_erp/modules/records/lifecycle_routes.py:114-172).
3. POST /records/{module}/{entity}/{record_id}/activate, {entity}.delete iznini denetler, deleted_at ve deactivation_reason alanlarını temizler ve RecordActivated yayar (src/cluster_erp/modules/records/lifecycle_routes.py:224-269).
4. Sunucu günde bir kez saklama geçişini çalıştırır. Düğümün hizmet verdiği her veritabanı için yapılandırılan süreyle purge_expired çağırır ve modüller kendi zaman pencereli satırlarını bıraksın diye RetentionSweep yayar (src/cluster_erp/server/app.py:227-260, src/cluster_erp/server/app.py:404-460).
5. purge_expired önce süresi dolmuş eklerin dosyalarını, ardından deleted_at sütunu olan her tabloyu her biri kendi kayıt noktasında, sonra süreden eski değişiklik geçmişini ve eski audit_log tablosunu siler. Bir tablodaki yabancı anahtar çakışması günlüğe yazılır ve atlanır (src/cluster_erp/modules/records/retention/purge.py:33-176).
6. Veri kaldıran her geçiş bir RetentionRun satırı yazar; yazılamaması temizliği engellemez (src/cluster_erp/modules/records/retention/services.py:20-32).

Ekranlar ve metadata¶

Modülün kenar çubuğu grubu yoktur; kod web Ayarlar ekranından sunulduğunu belirtir (src/cluster_erp/modules/records/module.py:15-22, src/cluster_erp/modules/records/module.py:72). Tek varlığı deactivation_reason olur (src/cluster_erp/modules/records/module.py:73-75). Web istemcisi bir kayıt devre dışı bırakılırken neden listesini sunar (webapp/js/a11y-ui.js:156). Web uygulamasındaki pasif listeler ve yeniden etkinleştirme kayıtlar, belgeler, görüntüleyici ve paylaşım sayfasında anlatılır.

Durum ve aksiyonlar¶

Modül hiçbir ActionMeta tanımlamaz. Durumu, diğer modüllerin kayıtlarındaki deleted_at sütunudur.

İş kuralları¶

• Yalnızca metadata'sı bir delete ucu tanımlayan varlıklar devre dışı bırakılabilir. resolver.py modül ve varlıktan modele eşlemeyi başlangıçta bir kez kurar; düzensiz tablo adları için elle doğrulanmış geçersiz kılmalar kullanır ve çözemediği her varlığı hata olarak günlüğe yazar (src/cluster_erp/modules/records/resolver.py:1-19, src/cluster_erp/modules/records/resolver.py:35-40).
• Saklama süresi 6 ile 250 yıl arasına sıkıştırılır (src/cluster_erp/modules/records/retention/models.py:14-16, src/cluster_erp/modules/records/retention/services.py:49-54).
• Temizlik, genel taramada core_change_history, deleted_records, alembic_version ve core_retention_config tablolarını atlar (src/cluster_erp/modules/records/retention/purge.py:23-30).
• requires_note işaretli bir neden web istemcisinde serbest metin not ister; neden kodunun katalogla sunucu tarafında denetlenmesi web istemcisi dışında bulunamadı (webapp/js/a11y-ui.js:156).
• Bir nedeni silmek deleted_at alanını doldurur (src/cluster_erp/modules/records/deactivation_reasons/services.py:73-79).

Olaylar ve sorgular¶

Modül hiçbir sözleşme tüketmez ve 1 sözleşme üretir; sayım fleet modülü sayfasındaki gibi yapılmıştır.

RetentionSweep, paketin kendisi tarafından değil, source_module="records" ile sunucu tarafından yayılır (src/cluster_erp/server/app.py:240). Tam liste sözleşmeler başvurusunda yer alır.

İzinler¶

Gizlilik, saklama ve geçmiş¶

Modülde privacy_handlers.py yoktur. Yukarıda anlatılan saklama süresine ve temizliğe sahiptir. Günlük geçişin zamanlaması zamanlanmış işler ve saklama sayfasındadır.

Analitik olgular¶

Bu modülde analytics_facts.py yoktur.

Ayarlar ve referans verileri¶

• GET ve PUT /records/retention/ süreyi okur ve ayarlar; eksik satır varsayılan 10 yılla oluşturulur (src/cluster_erp/modules/records/retention/routes.py:17-35, src/cluster_erp/modules/records/retention/services.py:39-47).
• Devre dışı bırakma nedenleri modülün referans verisidir. Pakette bir neden tohumu bulunamadı.

Testler¶

web-client/_e2e_*.mjs içinde /records/ ve tests/*.py içinde modules.records, /records/ veya retention için grep ile bulundu.

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Yumuşak silme ve devre dışı bırakma
• Değişiklik geçmişi
• Logs modülü
• Bu modülün API başvurusu

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