multiphp/implementation_plan.md

Trunçgil Multi-PHP & MySQL Server (Electron) Uygulama Planı

Bu plan, Windows platformunda Laragon veya XAMPP benzeri, ancak Electron ile modern bir arayüze sahip, çoklu PHP sürümlerini destekleyen bir geliştirme sunucusu uygulamasının yapımını kapsar.

Temel Hedefler

• Çoklu PHP Desteği: Kullanıcının istediği PHP sürümünü seçip anında aktif edebilmesi.
• MySQL/MariaDB Yönetimi: Veritabanı servisinin uygulama içinden başlatılıp durdurulabilmesi.
• Nginx Entegrasyonu: Web sunucusu olarak Nginx kullanarak performanslı bir yapı sunulması.
• Material UI (MUI): Tüm arayüz sisteminde modern ve standart bir görünüm için MUI kullanımı.
• Gelişmiş Ayarlar (Settings): Alias yapılandırması, VHost yönetimi ve özel dizin eşlemeleri.
• Dinamik İndirme (Download Manager): Kurulumda boş gelen uygulamanın kullanıcı isteğiyle PHP, MySQL, Nginx gibi servisleri indirebilmesi.
• Proje Bazlı Sürüm Yönetimi: Hangi projenin/dizinin hangi PHP ve MySQL sürümüyle çalışacağının tekil olarak belirlenmesi.
• Kurumsal Kimlik: Belirlenen renk paleti (#153E5E, #4A7CA3) ve logo (truncgil-multiphp-server.svg) ile markalı bir arayüz.
• Otomatik Sürüm Algılama (Auto-Detect): Proje dizinindeki composer.json dosyasını analiz ederek gerekli PHP ve Laravel sürümünü otomatik tespit etme.
• Arkaplanda Çalışma (System Tray): Uygulamanın sistem tepsisinde (tray) çalışarak servisleri yönetmeye devam etmesi.
• Windows Servis Entegrasyonu: Nginx, PHP ve MySQL servislerinin opsiyonel olarak Windows Servisi (sc.exe veya winsw) olarak kurulup yönetilebilmesi.
• Uluslararasılaştırma (i18n): Uygulamanın Türkçe, İngilizce ve Almanca gibi çoklu dil desteği sunması (tr.json, en.json, de.json).
• Otomatik Konfigürasyon: VHost, PHP.ini ve MySQL ayarlarının kullanıcı müdahalesi olmadan hazırlanması.

Teknik Detaylar ve Modern Yaklaşım (2026 Standartları)

1. Teknoloji Yığını ve Araçlar

Bakım kolaylığı ve tip güvenliği için proje modern araçlarla yapılandırılacaktır:

• Dil: TypeScript (Tüm süreçlerde tip güvenliği için).
• Build Aracı: electron-vite (Vite tabanlı, hızlı derleme ve süreç yönetimi).
• Framework: React (veya Vue), durum yönetimi için verinin Main sürece sadık kaldığı (Single Source of Truth) bir yapı.
• Paketleme: Electron Forge ve electron-updater (Otomatik güncelleme desteği için).

2. Güvenlik Odaklı Mimari (Security-First)

Renderer (UI) sürecinin doğrudan sistem kaynaklarına erişimi kesinlikle engellenecektir:

• Context Isolation & Sandboxing: contextIsolation: true ve sandbox: true zorunlu olarak aktif edilecek.
• Preload Scripts: Renderer ve Main arasındaki tek köprü. contextBridge ile sadece gerekli fonksiyonlar güvenli bir şekilde aktarılacak.
• IPC Service Layer: Tüm sistem işlemleri (dosya yazma, servis başlatma) ipcMain.handle ve ipcRenderer.invoke üzerinden asenkron servisler olarak kurgulanacak.

3. Servis ve İşlem Yönetimi (Node.js)

• Modüler Main Process: Mantık main.ts içinde boğulmak yerine src/main/services/, src/main/ipc/ gibi klasörlere ayrılacak.
• Worker Threads: Ağır CPU gerektiren işlemler (ZIP açma, log analizi vb.) ana süreci (Main) bloklamaması için Worker thread'lerde çalıştırılacak.
• Child Process & Windows Services:
  • Servisler varsayılan olarak child_process.spawn ile uygulama açıkken yönetilir.
  • Kullanıcı isteğine bağlı olarak winsw (Windows Service Wrapper) veya benzeri bir yöntemle kalıcı Windows Servisi olarak sisteme kurulabilir.
• System Tray Yönetimi:
  • Uygulama ana ekranı kapatıldığında sistem tepsisinde çalışmaya devam eder (Minimize to tray).
  • Sağ tık menüsü ile tüm servisleri "Durdur/Başlat" ve "Çıkış" seçenekleri sunulur.

4. Kullanıcı Arayüzü & i18n

• Material UI (MUI): Kurumsal kimlik renkleri (#153E5E, #4A7CA3) ile premium tasarım.
• i18n (Localization): tr.json, en.json, de.json dosyaları locales/ klasöründe tutulacak. i1ext benzeri bir kütüphane ile hem Renderer hem de Main süreçte dil desteği sunulacak.
• Code Splitting: Uygulama RAM kullanımını optimize etmek için lazy loading kullanılacak.

5. Performans ve Bakım

• ASAR Integrity: Paketleme sırasında bütünlük kontrolü aktif edilecek.
• Lazy Load & Startup: V8 snapshot ve asenkron modül yükleme ile başlangıç hızı optimize edilecek.
• Auto-Update: Kullanıcının müdahalesine gerek kalmadan arka planda güncelleme kontrolü.

Klasör Yapısı (Best Practice)

multiphp/
├── src/
│   ├── main/           # Ana süreç (TypeScript)
│   │   ├── services/   # ProcessManager, DownloadService, ConfigService
│   │   ├── ipc/        # IPC Handlers
│   │   └── index.ts    # Giriş noktası
│   ├── preload/        # Bridge scriptleri
│   ├── renderer/       # UI (React/Vite)
│   │   ├── components/
│   │   ├── hooks/
│   │   └── locales/    # tr.json, en.json...
│   └── shared/         # Main ve Renderer ortak tipler/sabitler
├── bin/                # Portable binary'ler (İndirildikten sonra)
├── config/             # Şablonlar (Nginx, PHP, MySQL)
├── out/                # Build çıktıları
└── package.json

Doğrulama ve Test Adımları

1. İzolasyon: Farklı PHP sürümlerinin çakışmadan çalışması.
2. Güvenlik Testi: Renderer içinden Node yeteneklerine erişilemediğinin teyidi.
3. Performans: Başlangıç süresi ve RAM kullanım ölçümleri.
4. Temiz Kapanış: Uygulama kapandığında tüm alt süreçlerin (Nginx, PHP, MySQL) sonlanması.