# KODESIL KASA & TREASURY - CANLI SUNUCU VE CPANEL KURULUM REHBERI
# Hedef Domain: https://kasa.jetambar.com

Bu rehber, Kodesil Kasa Sistemini cPanel (Node.js Selector), CloudLinux veya VPS/PM2 sunucunuzda **kasa.jetambar.com** adresiyle tek adımda canlıya almanız için adım adım hazırlanmıştır.

---

## 1. Paketlenen Hazır Dosyalar
Projenin ana dizininde canlıya almaya hazır şu dosyalar yer almaktadır:
- **kasa_jetambar_deploy.zip**: Sunucuya tek tıkla yükleyebileceğiniz tüm derlenmiş frontend (`dist/`), sunucu dosyaları (`server.js`), şablonlar ve yapılandırmaları içeren hazır dağıtım paketi.
- **kasa_schema.sql** (ve **live_data_import.sql**): phpMyAdmin üzerinden 1-tıkla içe aktarılacak tüm MySQL tabloları ve 10.103 adet işlem verisini içeren veritabanı yedeği.
- **server.js**: cPanel Node.js Selector ve Phusion Passenger uyumlu bağımsız üretim sunucusu.
- **.env.production**: `kasa.jetambar.com` ve `kasa@jetambar.com` için önceden doldurulmuş ortam değişkenleri.

---

## 2. Adım Adım Kurulum (cPanel / LiteSpeed / Node.js Selector)

### Adım 1: cPanel'de Subdomain Oluşturun
1. cPanel ana paneline girin -> **Domains (Alan Adları)** veya **Subdomains (Alt Alan Adları)** bölümüne tıklayın.
2. Yeni alt alan adı oluşturun:
   - **Subdomain:** `kasa`
   - **Domain:** `jetambar.com`
   - **Document Root:** `/home/kullanici_adiniz/kasa.jetambar.com`
3. **Create (Oluştur)** butonuna basın.

---

### Adım 2: MySQL Veritabanını Oluşturun ve Verileri Yükleyin
1. cPanel -> **MySQL Databases (MySQL Veritabanları)** bölümüne girin.
2. Yeni veritabanı oluşturun (Örn: `jetambar_kasa`).
3. Yeni veritabanı kullanıcısı oluşturun (Örn: `jetambar_kasauser`) ve güçlü bir şifre belirleyin.
4. "Add User to Database (Kullanıcıyı Veritabanına Ekle)" kısmından kullanıcıya veritabanı üzerinde **ALL PRIVILEGES (Tüm Yetkiler)** verin.
5. cPanel ana sayfasına dönüp **phpMyAdmin**'i açın.
6. Sol menüden yeni oluşturduğunuz veritabanını seçin.
7. Üst menüden **Import (İçe Aktar)** sekmesine tıklayın.
8. `kasa_schema.sql` (veya `live_data_import.sql`) dosyasını seçip **Import (Git)** butonuna basın.
   * Tüm tablolar (`users`, `invitations`, `transactions`, `audit_logs`, `settings`) ve başlangıç verileri veritabanınıza eksiksiz yüklenecektir.

---

### Adım 3: cPanel'de "Setup Node.js App" Oluşturun
1. cPanel ana sayfasında **Software** altında **Setup Node.js App** seçeneğine tıklayın.
2. **Create Application** butonuna basın:
   - **Node.js version:** `20.x` veya `22.x`
   - **Application mode:** `Production`
   - **Application root:** `kasa.jetambar.com` (Subdomain klasörünüz)
   - **Application URL:** `kasa.jetambar.com`
   - **Application startup file:** `server.js`
3. **Create** butonuna basarak uygulamayı oluşturun.

---

### Adım 4: Proje Dosyalarını Yükleyin
1. cPanel **File Manager (Dosya Yöneticisi)** uygulamasını açın.
2. `kasa.jetambar.com` klasörünün içine girin.
3. Üstteki **Upload (Yükle)** butonuna basarak bilgisayarınızdaki **kasa_jetambar_deploy.zip** dosyasını yükleyin.
4. Yükleme tamamlandıktan sonra zip dosyasına sağ tıklayıp **Extract (Çıkart)** seçeneğini seçin.

---

### Adım 5: .env Dosyasını Düzenleyin
`kasa.jetambar.com` klasörü içindeki `.env` dosyasını cPanel Dosya Yöneticisi ile açıp veritabanı bilgilerinizi doğrulayın:

```env
NODE_ENV=production
PORT=3000
HOST=0.0.0.0
APP_URL=https://kasa.jetambar.com
API_HOST=https://kasa.jetambar.com

# cPanel MySQL Veritabanı Bilgileriniz
DB_HOST=localhost
DB_PORT=3306
DB_NAME=jetambar_kasa
DB_USER=jetambar_kasa
DB_PASS="fM+[;x-mcSK@E.B4"

# E-Posta / SMTP Bilgileri (Önceden Yapılandırıldı)
SMTP_HOST=mail.jetambar.com
SMTP_PORT=465
SMTP_SECURE=true
SMTP_USER=kasa@jetambar.com
SMTP_PASS="mS#ZxMpFM?ySfb~r"
SMTP_FROM="Kodesil Kasa <kasa@jetambar.com>"

JWT_SECRET="kodesil_kasa_production_secret_key_2026_jetambar"
```

---

### Adım 6: Paketleri Kurun ve Uygulamayı Başlatın
1. cPanel **Setup Node.js App** sayfasına geri dönün.
2. Sayfanın en üstünde yer alan sanal ortam komutunu kopyalayın (Örn: `source /home/kullanici/nodevenv/kasa.jetambar.com/20/bin/activate`).
3. cPanel **Terminal** uygulamasını açın ve komutları çalıştırın:
```bash
# 1. Node.js sanal ortamına girin (size verilen komut)
source /home/kullanici/nodevenv/kasa.jetambar.com/20/bin/activate

# 2. Proje dizinine geçin
cd /home/kullanici/kasa.jetambar.com

# 3. Gerekli paketleri kurun
npm install

# 4. Sunucuyu test edin (İsteğe bağlı)
node server.js
```
4. cPanel Setup Node.js App sayfasına dönüp **Restart Application** butonuna tıklayın.

---

## 3. Sistem Sağlık ve Canlılık Kontrolü
Uygulama başladığında tarayıcınızdan şu adrese giderek servis durumunu kontrol edebilirsiniz:
`https://kasa.jetambar.com/api/health`

Beklenen yanıt:
```json
{
  "status": "ok",
  "service": "Kodesil Kasa & Treasury Production API",
  "domain": "kasa.jetambar.com",
  "database": "mysql",
  "uptime": 12.4
}
```

---

## 4. Kullanıcı Giriş Bilgileri ve Davet Sistemi

### Başlangıç Yönetici ve Kullanıcı Hesapları:
| E-Posta | Başlangıç Şifresi | Yetki Rolü | Açıklama |
|---|---|---|---|
| **admin@kodesil.com** | `kodesil2026` | Sistem Yöneticisi (Admin) | Tüm sistem, kullanıcılar, loglar ve ayarlar |
| **kasa@jetambar.com** | `mS#ZxMpFM?ySfb~r` | Düzenleme Yetkilisi | Kasa hareketleri, raporlar ve işlemler |

### Personel Davet Bağlantıları:
Yeni bir personele davet gönderildiğinde sistem otomatik olarak şu formatta güvenli tek kullanımlık bir bağlantı üretir ve personele e-posta ile iletir:
`https://kasa.jetambar.com/?invite={token}`

Personel bu bağlantıya tıkladığında:
1. Şirket logosu ve davet ayrıntıları doğrulanır ("Personel Davet Onayı").
2. Personel adını, soyadını ve kendi belirleyeceği şifreyi girer.
3. "Hesabı Oluştur ve Giriş Yap" butonuna basarak doğrudan sisteme katılır.
4. Kullanılmış veya geçersiz bağlantılarda sistem otomatik olarak "Davet Bulunamadı / Süresi Dolmuş" uyarı kartını gösterir.

---

## 5. Sorun Giderme (Troubleshooting)

- **Excel (.xlsm) İndirme:** Sunucuda Python 3 kurulu olmalıdır (cPanel'de varsayılan olarak `/usr/bin/python3` mevcuttur).
- **SSL / HTTPS Uyarısı:** cPanel **SSL/TLS Status** bölümünden `kasa.jetambar.com` için "Run AutoSSL" butonuna basarak ücretsiz Let's Encrypt / cPanel SSL sertifikanızı 1 dakikada aktifleştirebilirsiniz.
- **Port ve Yeniden Başlatma:** cPanel LiteSpeed / Passenger portu otomatik yönetir; `.env` içindeki `PORT=3000` Passenger tarafından arka planda yönlendirilir.
