Depo tek bir Windows iş istasyonu için grafik bir kurulum yolu içerir: installer/cluster_erp_setup.iss içindeki bir Inno Setup betiği, INSTALL.bat başlatıcısı, README_INSTALL.txt kılavuzu ve installer/setup_wizard.pyw kurulum sihirbazı. Bu sayfa her dosyanın ne yaptığını açıklar. Bir Linux düğümü bir Linux düğümü kurun sayfasında açıklanan farklı bir yol kullanır.
Kapsam ve kaynak¶
- Tanımlandığı yer:
installer/cluster_erp_setup.iss,INSTALL.bat,README_INSTALL.txt,installer/setup_wizard.pyw(SetupWizard). - Sayı: belge dizesi listesinden sayılan altı sihirbaz sayfası (
installer/setup_wizard.pyw:6-12); sihirbaz günlüğünde, 8. adımın günlük satırı olmayan dokuz numaralı kurulum adımı (installer/setup_wizard.pyw:504-699).
Sihirbazın hesaplar ve parolalar için önceden doldurduğu varsayılan değerler güvenlik açıklama politikası gereği yazılmamıştır.
Inno Setup betiği¶
| Bölüm | İçerik | Kaynak |
|---|---|---|
| Tanımlar | Ürün adı, 0.1.0 sürümü, yayımcı ve program girişi olarak start_desktop.bat. |
installer/cluster_erp_setup.iss:5-9 |
[Setup] |
Program dosyaları klasörü altına kurar, yönetici yetkisi ister, kurulum günlüğü yazar ve çıktıyı sürüme göre adlandırır. | installer/cluster_erp_setup.iss:11-25 |
[Languages] |
Türkçe ve İngilizce. | installer/cluster_erp_setup.iss:27-29 |
[Files] |
src, migrations, pyproject.toml, alembic.ini, .env.example ve sihirbaz. |
installer/cluster_erp_setup.iss:31-37 |
[Run] |
Kopyalamadan sonra sihirbazı başlatır. | installer/cluster_erp_setup.iss:39-40 |
[Icons], [Tasks] |
Program, sihirbaz ve kaldırıcı için başlat menüsü girdileri; isteğe bağlı masaüstü kısayolu. | installer/cluster_erp_setup.iss:42-49 |
[UninstallDelete] |
Kaldırmada sanal ortamı, __pycache__ klasörünü ve .env dosyasını siler. |
installer/cluster_erp_setup.iss:51-54 |
INSTALL.bat ve README_INSTALL.txt¶
INSTALL.bat, python komutunun PATH üzerinde olduğunu denetler, sürümünü yazar ve sihirbazı başlatır; Python yoksa indirme adresini yazar ve durur (INSTALL.bat:11-40). README_INSTALL.txt dört adımlı Türkçe bir kılavuzdur: Python'u kurun, PostgreSQL'i kurun, INSTALL.bat dosyasını çalıştırın ve programı başlatın; ardından sorun giderme notları gelir (README_INSTALL.txt:5-66).
Kurulum sihirbazı¶
Sihirbaz yalnız Python 3.12 veya daha yenisine ihtiyaç duyan bir tkinter uygulamasıdır ve eski sürümleri reddeder (installer/setup_wizard.pyw:1-12, installer/setup_wizard.pyw:794-800).
| Adım | Davranış | Kaynak |
|---|---|---|
| 1 | Kaynak ağacını .git, .env, sanal ortamlar ve node_modules olmadan seçilen klasöre kopyalar. |
installer/setup_wizard.pyw:503-519 |
| 2 | venv adlı bir sanal ortam oluşturur. |
installer/setup_wizard.pyw:521-528 |
| 3 | Projeyi pip install -e . ile, ardından PySide6==6.8.3 ve email-validator paketlerini kurar. |
installer/setup_wizard.pyw:533-545 |
| 4 | Veritabanı ayarları, sunucu ana makinesi ve bağlantı noktası, CLUSTER_ERP_DEBUG=false ve rastgele bir gizli anahtarla .env yazar. |
installer/setup_wizard.pyw:547-567 |
| 5 | PostgreSQL araçları bulunursa ve seçenek açıksa veritabanı rolünü ve veritabanını oluşturur ve üzerlerinde yetki verir. | installer/setup_wizard.pyw:569-626 |
| 6 | alembic upgrade head koşar. |
installer/setup_wizard.pyw:628-653 |
| 7 | İlk yöneticiyi argon2 parola hash'iyle veritabanında oluşturur. | installer/setup_wizard.pyw:655-696 |
| 9 | start_server.bat ve start_desktop.bat dosyalarını yazar ve kısayolları oluşturur. |
installer/setup_wizard.pyw:698-734 |
Sihirbaz PostgreSQL araçlarını önce program dosyaları klasörlerinde, sonra PATH üzerinde arar (installer/setup_wizard.pyw:420-434). Veritabanı adları ve rol adları _SAFE_IDENT kalıbına uymalıdır (installer/setup_wizard.pyw:58-67). start_desktop.bat sunucu bağlantı noktasını dinleyen her süreci durdurur, sunucuyu arka planda başlatır, bekler ve masaüstü istemciyi başlatır (installer/setup_wizard.pyw:709-724).
Kısıtlar ve doğrulama¶
- Sihirbaz, Linux düğümünden ve sürekli tümleştirmeden farklı olarak paketleri
requirements.lockve hash'leri olmadan kurar (installer/setup_wizard.pyw:533-545,deploy/install.sh:153,.github/workflows/ci.yml:47). - Inno Setup betiğinin
[Files]listesindewebappklasörü yoktur (installer/cluster_erp_setup.iss:31-37); sunucu/appyolunu yalnız o klasör varsa bağlar (src/cluster_erp/server/app.py:1633-1634). - Betikteki ve sihirbazdaki ürün sürümü
0.1.0sabitidir (installer/cluster_erp_setup.iss:6,installer/setup_wizard.pyw:51).
Tutarsızlıklar¶
Tanıtılan terimler¶
| Terim | Kod tanımlayıcısı | Tanım | Türkçe terim | Kaynak |
|---|---|---|---|---|
| kurulum sihirbazı | SetupWizard |
Cluster ERP'yi bir Windows iş istasyonuna kuran tkinter programı. | kurulum sihirbazı | installer/setup_wizard.pyw:74 |
İlgili sayfalar¶
92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.