Bu wiki Cluster ERP'yi kodun gerçekleştirdiği haliyle belgeler. Kullanıcılar, yöneticiler, geliştiriciler ve işletmeciler için giriş noktasıdır ve her bölüme bağlanır. Bölümlerin içeriğini tekrarlamaz; her bölümün dizini kendi sayfalarını listeler.
Cluster ERP nedir¶
Cluster ERP modüler bir kurumsal kaynak planlama sistemidir. Sunucu, create_app ile kurulan bir FastAPI uygulamasıdır (src/cluster_erp/server/app.py:1287-1296) ve verisini asyncpg sürücüsü üzerinden PostgreSQL'de tutar (src/cluster_erp/config/settings.py:841). İş mantığı 28 arka uç modülündedir; sayı, src/cluster_erp/modules/*/module.py içinde ModuleBase sınıfından türeyen 28 sınıf olarak sayıldı. Projenin yazılı mühendislik kuralları modüllerin birbirleriyle yalnızca EventBus üzerinden konuşmasını şart koşar. Kullanıcılar, sunucunun /app yolunda sunduğu webapp/ içindeki metadata güdümlü web uygulamasında (src/cluster_erp/server/app.py:1633-1644) veya src/cluster_erp/desktop/ içindeki PySide6 masaüstü istemcisinde (src/cluster_erp/desktop/main.py:139) çalışır. İki istemci de ekranlarını sunucunun /api/v1/_meta yolunda yayımladığı metadata belgesinden kurar (src/cluster_erp/server/app.py:1518, src/cluster_erp/desktop/core/metadata_store.py:13) ve ikisi de aynı HTTP API'yi çağırır.
Bölümler¶
| Bölüm | Kapsadığı konular | Başlangıç sayfası |
|---|---|---|
| Genel bakış | Cluster ERP'nin ne olduğu, bir bakışta mimari ve depo düzeni | Genel bakış |
| Platform çekirdeği | Arka uç çekirdeği: sunucu açılışı, modül yaşam döngüsü, EventBus, sözleşmeler, ayarlar, veritabanı, kimlikler, para, değişiklik geçmişi ve ortak servisler | Platform çekirdeği |
| Kimlik, erişim, kiracılık, gizlilik ve lisans | Giriş, roller ve izinler, öznitelik politikaları, alan ve satır erişimi, onaylar, kiracılar, kayıt, ilgili kişi başvuruları, lisans ve operatör konsolu | Kimlik, erişim, kiracılık, gizlilik ve lisans |
| Web uygulaması platformu | webapp/ içindeki metadata güdümlü tarayıcı istemcisi ve dayandığı sunucu rotaları |
Web uygulaması platformu |
| Masaüstü istemci | src/cluster_erp/desktop/ içindeki PySide6 istemcisi ve sunucu metadata'sını nasıl çizdiği |
Masaüstü istemci |
| İş modülleri | Taraflardan analitiğe kadar her arka uç modülü için bir sayfa veya klasör | İş modülleri |
| API başvurusu | Kurallar, kimlik doğrulama, hatalar, sistem ve paylaşılan rotalar ve arka uç modülü başına bir sayfa | API başvurusu |
| İşletim | Ortamlar, düğüm kurulumu, yapılandırma, göçler, yedekler, kiracılar ve sürüm çıkarma | İşletim |
| Katkı | Mühendislik kuralları, kalite kapıları, testler, e2e bataryası, geliştirici betikleri ve wiki sayfası yazımı | Katkı |
| Karar kayıtları | Bağlayıcı tasarım kuralları ve her birini uygulayan kod | Karar kayıtları |
| Başvuru | Sözlük ve wiki dışındaki ilgili belgelerin listesi | Başvuru |
| Niyet asistanı | Yazılan istekleri API aksiyonlarına eşleyen yerleşik asistan | Niyet asistanı |
Bu wiki nasıl okunur¶
Her sayfanın tek bir türü vardır: eğitim yaparak öğretir, nasıl yapılır kılavuzu tek bir görevi tamamlatır, başvuru sayfası olguları listeler, açıklama bir parçanın nasıl ve neden çalıştığını anlatır, modül sayfası bir arka uç modülüne genel bakış verir, API sayfası bir yönlendirici grubunun uç noktalarını listeler ve dizin sayfası bir bölümün sayfalarını listeler. Davranışa ilişkin her ifade, onu gösteren koda src/cluster_erp/core/module_base.py:62 gibi bir yol ve satır aralığıyla atıf yapar. "Koddan belirlenemedi." metni, kodun yanıtlamadığı bir soruyu işaretler. "Tutarsızlık." ile başlayan bir uyarı, kod ile projenin yazılı mühendislik kurallarının ayrıştığı bir yeri kaydeder; iki tarafı da anlatır ve hiçbir karar vermez. Her İngilizce name.md sayfasının aynı klasörde, aynı yapıda bir Türkçe ikizi name.tr.md vardır ve dil geçişi ikisi arasında gider. Her sayfanın son satırı, sayfanın denetlendiği commit'i ve tarihi adlandırır.
İlgili sayfalar¶
92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.