Ekler, notlar ve depolama

Cluster ERP'deki her kayıt, çekirdekteki iki ortak tablo üzerinden dosya ve not taşıyabilir. Bu sayfa core/attachments.py, core/notes.py, server/routes/attachments.py ve server/routes/notes.py içindeki tabloları, servisleri ve rotaları, core/upload_policy.py içindeki yükleme politikasını ve core/storage.py içindeki depolama arka uçlarını listeler. documents modülünün sürümlü belge yönetimi ayrı bir özelliktir; bkz. documents.

Kapsam ve kaynak¶

• Tanımlandığı yer: src/cluster_erp/core/attachments.py (Attachment, AttachmentService), src/cluster_erp/core/notes.py (Note, NoteService), src/cluster_erp/core/upload_policy.py (check_upload), src/cluster_erp/core/storage.py (StorageBackend, create_storage_backend), src/cluster_erp/server/routes/attachments.py, src/cluster_erp/server/routes/notes.py
• Sayı: 8 ek rotası ve 6 not rotası (@router. dekoratörlerinden sayıldı); 3 depolama arka ucu sınıfı; 40 varsayılan izinli uzantı

İki tablo da üst kayda yabancı anahtar olmadan entity_type ve entity_id ile bağlanır; böylece her varlık onları kullanabilir.

Ekler¶

core_attachments, BaseModel'den türer ve şu sütunları ekler (src/cluster_erp/core/attachments.py:51-63):

Depolama anahtarı attachments/<entity_type>/<entity_id>/<stored name> biçimindedir; çok kiracılı bir düğümde başına tenants/<tenant key>/ eklenir (src/cluster_erp/core/attachments.py:38-48). İndirmeler safe_content_disposition ile kurulan bir Content-Disposition başlığı taşır; bu işlev ASCII addan tırnak, ters bölü, satır sonu ve noktalı virgül karakterlerini çıkarır ve UTF-8 adı yüzde kodlar (src/cluster_erp/core/attachments.py:24-35).

AttachmentService yöntemleri (src/cluster_erp/core/attachments.py:88-206):

Ek rotaları¶

Yönlendirici öneki /api/v1/attachments'tır (src/cluster_erp/server/routes/attachments.py:27).

Dosyası eksik bir satırın indirilmesi HTTP 404 ile FILE_NOT_FOUND_ON_DISK yanıtı verir (src/cluster_erp/server/routes/attachments.py:114-115).

Yükleme politikası¶

check_upload(filename, data, allowed) kabul edilen uzantıyı döndürür ya da UPLOAD_TYPE_REFUSED kodu ve HTTP 415 ile AppError yükseltir (src/cluster_erp/core/upload_policy.py:65-84). İki denetim uygular:

1. Küçük harfli uzantı izin listesinde olmalıdır: attachment_allowed_extensions ayarı ya da DEFAULT_ALLOWED_EXTENSIONS içindeki 40 varsayılan (src/cluster_erp/core/upload_policy.py:21-27, src/cluster_erp/config/settings.py:368-374).
2. Bilinen dosya imzası olan 24 uzantı için içerik o imzayla başlamalıdır (src/cluster_erp/core/upload_policy.py:30-55, src/cluster_erp/core/upload_policy.py:76-82).

Yükleme rotası check_upload işlevini yapılandırılmış listeyle çağırır (src/cluster_erp/server/routes/attachments.py:73-75). Modül belge dizgisi yürütülebilir dosyaların ve betiklerin listede olmadığını belirtir (src/cluster_erp/core/upload_policy.py:1-10).

Notlar¶

core_notes, BaseModel'den türer ve code, entity_type, entity_id ve content ekler (src/cluster_erp/core/notes.py:17-23). NoteCreate, entity_type (en fazla 50 karakter), entity_id ve boş olmayan content alır; NoteUpdate content alır (src/cluster_erp/core/notes.py:26-33). NoteService notları listeler, getirir, oluşturur (note sırasından bir kodla), günceller, kullanımdan kaldırır, toplu kullanımdan kaldırır ve sayar (src/cluster_erp/core/notes.py:48-114).

Not rotaları¶

Yönlendirici öneki /api/v1/notes'tur (src/cluster_erp/server/routes/notes.py:14).

Depolama arka uçları¶

StorageBackend, save, load, delete ve exists yöntemlerini taşıyan bir protokoldür (src/cluster_erp/core/storage.py:11-18). Lifespan süreç başına bir arka uç oluşturur ve app.state.storage üzerinde saklar (src/cluster_erp/server/app.py:65-75, src/cluster_erp/server/app.py:92).

create_storage_backend, storage_backend s3 ise S3'ü, değilse yerel depolamayı seçer. storage_encryption_key ayarlıysa sonucu EncryptedStorageBackend ile sarar, değilse bir uyarı yazar (src/cluster_erp/core/storage.py:177-209). Ayar doğrulayıcısı anahtarı çok kiracılı kipte zorunlu kılar (src/cluster_erp/config/settings.py:805-809). Anahtar yönetimi ikinci faktör ve gizli depolama sayfasında belgelenir.

Kısıtlar ve doğrulama¶

• Bir ek satırı ve dosyası aynı istekte yazılır; dosya satır flush edilmeden önce kaydedilir (src/cluster_erp/core/attachments.py:126-142).
• Bir eki kullanımdan kaldırmak saklanan dosyayı silmez (src/cluster_erp/core/attachments.py:155-161). Saklama süresinde dosyaların kaldırılması records modülüne aittir; bkz. records.

Tanıtılan terimler¶

İlgili sayfalar¶

• Platform çekirdeği
• Ortak sunucu rotaları
• Ayarlar başvurusu
• Kayıt belgeleri, görüntüleyici ve paylaşım

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