Kernel kurulumu

Gereksinimler, kurulum sihirbazı, .env, Windows servisi ve güvenlik duvarı. Yönetici için

#Gereksinimler

Bileşen	Gereksinim
Sunucu bilgisayar	Windows; mağazada sürekli açık. Kernel hafiftir, özel donanım gerekmez.
Node.js	22.13 veya üstü (LTS önerilir). SQLite Node içinde gelir; ayrı veritabanı kurulumu yoktur.
MikroERP	V16 veya V17. Kernel SQL Server'a doğrudan bağlanır (aracı servis yok). Sürüm otomatik algılanır.
SQL kullanıcısı	Mikro veritabanında okuma ve yazma yetkisi (satış faturaları yazılacağı için).
Ağ	Kasa bilgisayarları sunucuya TCP ile erişebilmeli (varsayılan port 4750).

#Yöntem 1 — Kurulum sihirbazı (önerilen)

Kernel klasöründeki NemraSetup.exe beş adımda ayarları .env dosyasına yazar, kernel'i başlatır ve paneli açar.

Ortam kontrolüNode.js sürümü, bağımlılıklar (node_modules) ve varsa mevcut .env denetlenir. Node.js yoksa sihirbaz bunu söyler; önce nodejs.org'dan LTS sürümünü kurun.
SunucuPort (varsayılan 4750), dinleme adresi ve işletme adı. "Port müsait mi?" ile portun boş olduğunu denetleyin. POS cihazlarının bağlanabilmesi için dinleme adresi Tüm ağ kartları (0.0.0.0) kalmalıdır.
Yönetici hesabıPanele ilk girişte kullanılacak kullanıcı adı ve şifre (en az 5 karakter). Varsayılan kullanıcı adı ve şifre admin'dir; ilk girişten sonra Profil'den değiştirin. Üret ile güçlü bir şifre de üretebilirsiniz — not alın.
Mikro bağlantısıSQL Server, port, kullanıcı ve şifre. Bağlantıyı test et ile veritabanları listelenir, birini seçersiniz. Bu adımı sonraya bırakabilirsiniz (panelden girilir).
Özet ve kurulumKaydet ve Başlat ayarları yazar. Mevcut bir .env varsa .env.bak olarak yedeklenir. İsterseniz kernel hemen başlatılır ve panel tarayıcıda açılır.

#Yöntem 2 — Elle kurulum

cd kernel
copy .env.example .env     <- değerleri düzenleyin (aşağıya bakın)
npm install
npm start                  <- http://localhost:4750/admin

Geliştirme sırasında dosya değişince yeniden başlatan mod için npm run dev kullanılır.

#.env dosyası

kernel/.env dosyası ilk kurulum değerlerini taşır. Yalnızca ilk açılışta SQLite'a işlenir; sonraki değişiklikler panelden yapılır, .env onların üzerine yazmaz. PORT ve HOST ise her açılışta okunur.

Değişken	Anlamı
PORT, HOST	Dinlenecek port (varsayılan 4750) ve adres (0.0.0.0 = tüm ağ kartları, 127.0.0.1 = yalnızca bu bilgisayar).
LICENSE_SERVER_URL, HELP_BASE_URL	Lisans sunucusu ve yardım sitesinin adresi (varsayılan https://pos.nemra.net). Normalde değiştirilmez; her açılışta okunur.
NEMRA_DATA_DIR	Veri klasörü (varsayılan kernel/data). Başka bir diske taşımak için.
COMPANY_NAME	İşletme adı (panel başlıklarında ve raporlarda görünür).
ADMIN_USERNAME, ADMIN_PASSWORD, ADMIN_FULL_NAME	Doluysa ilk yönetici otomatik oluşturulur ve panelin kurulum sihirbazı atlanır.
MIKRO_SERVER, MIKRO_PORT, MIKRO_DATABASE, MIKRO_USER, MIKRO_PASSWORD	Mikro SQL Server bağlantısı. Adlandırılmış örnek için SUNUCU\SQLEXPRESS; yerel makine için .
MIKRO_VERSION	auto (varsayılan), V16 veya V17.
MIKRO_PRICE_LIST, MIKRO_WALKIN_PARTNER, MIKRO_DEFAULT_SERIES, MIKRO_USER_NO	Satış aktarımı başlangıç değerleri: fiyat listesi, "Perakende Müşteri" cari kodu, varsayılan evrak serisi, Mikro kullanıcı no.

.env ve data/ klasörü şifreler ve imza anahtarı içerir. Bu dosyaları paylaşmayın, e-postayla göndermeyin. data/config.json içindeki imza anahtarı kaybolursa kayıtlı Mikro şifresi ve cihaz anahtarları çözülemez.

#Port ve güvenlik duvarı

Varsayılan port 4750'dir ve kernel portu asla otomatik değiştirmez: POS cihazları sabit bir adrese bağlıdır. Port doluysa kernel açık bir hata mesajıyla kapanır (çıkış kodu 1).
Başka bilgisayarlardaki kasaların bağlanabilmesi için sunucuda Windows Güvenlik Duvarı'nda bu porta TCP, gelen izin verin.
POS'a girilecek adres: http://<sunucunun-IP'si>:4750. Sunucunun ağ adreslerini panelde Sistem sayfası "POS'un bağlanacağı adres" satırında görürsünüz. Sunucunun IP'sini sabitleyin (DHCP rezervasyonu) — IP değişirse tüm kasaların adresi güncellenmelidir.

#Windows servisi olarak çalıştırma

Sunucu yeniden başladığında kernel'in kendiliğinden açılması için servis olarak kurun. NSSM gerekir (PATH'te olmalı).

# Yönetici olarak açılmış PowerShell
cd kernel
.\scripts\install-service.ps1                  # servis adı: NemraPosKernel
.\scripts\uninstall-service.ps1                # kaldırmak için

Servis otomatik başlar, günlükler data\logs\kernel-out.log ve kernel-err.log dosyalarına yazılır (10 MB'ta döner).

#Güncelleme

Sistem ▸ Yedek indir ile yedek alın.
Servisi durdurun, yeni kernel dosyalarını kopyalayın (data/ ve .env'e dokunmayın), npm install çalıştırın.
Servisi başlatın. Veritabanı şeması açılışta kendiliğinden güncellenir.

#Yedekleme ve geri yükleme

Tüm kernel verisi data/ klasöründedir. Yedek = data/kernel.db. Panelden Sistem ▸ Yedek indir çalışırken bile tutarlı bir kopya verir.
Yedek; kasiyerleri, terminalleri, ayarları ve henüz Mikro'ya aktarılmamış satışları içerir. Mikro verisi Mikro'nun kendi yedeğiyle alınır.
Geri yüklemek için kernel'i durdurup data/kernel.db dosyasını yedekle değiştirin ve başlatın. data/config.json (imza anahtarı) aynı kalmalıdır.