Bu sayfa Cluster ERP deposunun üst düzey klasörlerini ve dosyalarını listeler ve her birinin içeriğini söyler. Kod bulmak için bir başvuru tablosudur. Parçaların birlikte nasıl çalıştığını anlatmaz; bunun için mimariye genel bakış sayfasına bakın.
Kapsam ve kaynak¶
Listeler, 92f8051 commit'inde depo kökü ve adı geçen her klasör listelenerek üretilmiştir. Sayılar yöntemlerini tabloda belirtir.
- Tanımlandığı yer: depo ağacı
- Sayı: 15 kaynak klasör satırı, 1 CI klasörü, 5 çalışma zamanı veya kişisel klasör ve 11 kök dosya satırı
Kaynak klasörler¶
Bu klasörler ürün kodunu, testleri, kurulum dosyalarını veya belgeleri tutar.
| Klasör | İçeriği | Sayı ve yöntem | Kaynak |
|---|---|---|---|
src/cluster_erp/ |
Python paketi: ai/, config/, core/, desktop/, modules/, server/ |
modules/ içinde 28 modül klasörü (ls, __pycache__ hariç) |
pyproject.toml:90-91 |
src/cluster_erp/ai/ |
Niyet motoru, sözcükleyici, vektörleştirici ve İngilizce ile Türkçe niyet derlemleri | 5 dosya (ls, __init__.py ve __pycache__ hariç) |
src/cluster_erp/ai/intent_engine.py |
src/cluster_erp/core/ |
Her modülün kullandığı platform çekirdeği | __init__.py dahil 47 *.py dosyası (ls) |
src/cluster_erp/core/__init__.py |
src/cluster_erp/server/ |
FastAPI uygulama fabrikası, ara katmanlar, hata işleyicileri, ortak rotalar ve operatör komut satırı araçları | __init__.py dahil 21 *.py dosyası, routes/ içinde 10 rota dosyası (__init__.py hariç), services/ içinde 1 modül (ls) |
src/cluster_erp/server/app.py |
src/cluster_erp/desktop/ |
PySide6 masaüstü istemcisi | desktop/modules/ içinde 7 modül klasörü (ls) |
src/cluster_erp/desktop/main.py |
webapp/ |
/app yolunda sunulan metadata güdümlü web uygulaması: index.html, operator.html, js/, css/, i18n/, fonts/, assets/, store/ |
js/ içinde 52, store/ içinde 26 girdi (ls) |
src/cluster_erp/server/app.py:1633-1644 |
web-client/ |
Playwright uçtan uca süitleri, batarya koşucusu, sondalar ve bir Vite React projesi | 197 _e2e_*.mjs süiti (ls) |
web-client/_run_battery.mjs |
gated_apps/ |
İstemciye yalnızca uygulama mağazası üzerinden ulaşan uygulama paketleri | Her birinde app.js bulunan 9 klasör (ls gated_apps/*/app.js) |
gated_apps/ |
migrations/ |
Alembic ortamı ve sürümleri | versions/ içinde 218 *.py dosyası (ls) |
alembic.ini:2 |
deploy/ |
Linux düğüm kurulumu, servis birimi, süreç yöneticisi yapılandırması, ters vekil örneği, PostgreSQL rolleri ve ayarı, cron dosyası, konteyner dosyaları | 11 dosya ve docker/ klasörü (ls) |
deploy/README.md |
tests/ |
Pytest süitleri | 106 test_*.py dosyası (ls) |
tests/test_architecture_boundaries.py |
scripts/ |
backup/ içindeki yedekleme betikleri ve iki bakım betiği |
backup/ içinde 6 dosya, üst düzeyde 2 betik (ls) |
scripts/backup/ |
tools/ |
Geliştirici araçları | 3 dosya (ls) |
tools/ |
installer/ |
Windows kurulum betiği ve kurulum sihirbazı | 2 dosya (ls) |
installer/cluster_erp_setup.iss |
docs/ |
Tarihsel planlar, denetimler, araştırmalar ve docs/wiki/ içindeki bu wiki |
Üst düzeyde 62 girdi (ls) |
docs/wiki/README.md |
docs/wiki/ dışındaki docs/ belgeleri tarihseldir. Wiki onları kaynak olarak göstermez (bkz. belgeleme standardı).
Sürekli tümleştirme¶
| Klasör | İçeriği | Sayı ve yöntem | Kaynak |
|---|---|---|---|
.github/workflows/ |
CI iş akışı | 1 dosya, ci.yml (ls) |
.github/workflows/ci.yml |
Çalışma zamanı ve kişisel klasörler¶
Bu klasörler çalışma ağacında bulunur ama ürün kaynağı değildir. İçerikleri belgelenmez.
| Klasör | Nedir | Sayı ve yöntem | Kaynak |
|---|---|---|---|
data/ |
Yerel bir sunucunun çalışma zamanı verisi | Sayılmadı | src/cluster_erp/config/settings.py:348 |
_shots/ |
Sondaların ekran görüntüleri | Sayılmadı | _shots/ |
reports/ |
Üretilmiş raporlar | Sayılmadı | reports/ |
research_notes/ |
Kişisel araştırma notları | Sayılmadı | research_notes/ |
graphify-out/ |
Bir grafik aracının üretilmiş çıktısı | Sayılmadı | graphify-out/ |
Kök dosyalar¶
| Dosya | İçeriği | Kaynak |
|---|---|---|
pyproject.toml |
Paket metadata'sı, bağımlılıklar, desktop eki, konsol betikleri, Ruff ve mypy yapılandırması |
pyproject.toml:5-10, pyproject.toml:86-88 |
alembic.ini |
Alembic yapılandırması; script_location = migrations |
alembic.ini:2 |
requirements.lock ve uv.lock |
Sabitlenmiş bağımlılık kümeleri (bu sayfa için okunmadı) | requirements.lock |
| iç kural kitabı (yayımlanmaz) | Katkıda bulunanlar için proje kuralları ve hedefler | iç kural kitabı (yayımlanmaz) |
CHANGELOG.md |
Sürüm notları | CHANGELOG.md |
LICENSE |
Tescilli lisans metni | LICENSE |
README.md |
Depo tanıtım dosyası | README.md |
INSTALL.bat ve README_INSTALL.txt |
Windows kurulum yardımcıları | INSTALL.bat |
start_desktop.bat |
Masaüstü istemci için Windows başlatıcısı | start_desktop.bat |
.env.example |
Örnek ortam değişkeni adları (değerler aktarılmaz) | .env.example |
.gitignore, .gitattributes, .dockerignore |
Depo ve konteyner derleme ayarları | .gitignore |
Kök düzeydeki *.log ve *.png dosyaları yerel artıklardır ve belgelenmez.
Kısıtlar ve doğrulama¶
- Alembic klasörü
migrations/klasörüdür (alembic.ini:2).migrations/env.pyhedef metadata'yı kurmak için her modülünmodelspaketini içe aktarır (migrations/env.py:76-86). - Sunucu web uygulamasını
<depo kökü>/webappyolunda bulur (src/cluster_erp/server/app.py:1633). Yalnızca klasör varsa bağlar (src/cluster_erp/server/app.py:1634). web-client/srciçindeki Vite React projesinin kullanımda olup olmadığı koddan belirlenemedi.web-client/README.mdhazır Vite şablon metnidir.
İlgili sayfalar¶
92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.