diff --git a/README.md b/README.md index 2e62a37..fa621ac 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,97 @@ -# README +

+ Multron Logo +

-## About +

Multron Download Manager

-This is the official Wails Svelte-TS template. +

+ Ağ bant genişliğini maksimuma çıkaran, doğrudan disk offset yazımı yapan, yüksek performanslı ve modern masaüstü indirme yöneticisi. +

-## Live Development +

+ Go + Svelte 5 + Wails + Tailwind CSS + License +

-To run in live development mode, run `wails dev` in the project directory. This will run a Vite development -server that will provide very fast hot reload of your frontend changes. If you want to develop in a browser -and have access to your Go methods, there is also a dev server that runs on http://localhost:34115. Connect -to this in your browser, and you can call your Go code from devtools. +--- -## Building +## ⚡ Temel Mimari ve Özellikler -To build a redistributable, production mode package, use `wails build`. +* **Doğrudan Disk Offset Yazımı (Direct Disk Offset I/O):** İndirilen parçalar geçici dosyalara yazılıp işlem sonunda birleştirilmez (post-download merge yok). Disk üzerinde önceden ayrılan bloklara doğrudan ilgili bayt aralığı yazılır; indirme bittiği an dosya hazırdır. +* **Dinamik Parçalı İndirme:** Ağ durumuna ve sunucu yanıtlarına göre eşzamanlı HTTP bağlantılarını dinamik olarak bölerek bant genişliğini doyurur. +* **Düşük Bellek Ayak İzi (Zero-Allocation Hedefi):** Go motoru tarafında minimum bellek kopyalaması ve optimize edilmiş `io.Writer` akışları. +* **Hafif ve Hızlı Arayüz:** Electron yerine işletim sisteminin yerel WebKit motorunu kullanan Wails, Svelte 5 reaktivitesi ve Tailwind CSS v4 mimarisi. +* **Sözleşme Tabanlı IPC:** Go backend ile Svelte frontend arasında tip güvenli ve olay güdümlü (event-driven) veri senkronizasyonu. + +--- + +## 🛠️ Teknoloji Yığını + +| Katman | Teknoloji | Açıklama | +| :--- | :--- | :--- | +| **Çekirdek Motor** | **Go (Golang)** | Ağ soketleri, segment yönetimi ve dosya I/O | +| **Masaüstü Köprüsü** | **Wails** | İki yönlü IPC ve yerel sistem pencere kontrolü | +| **Kullanıcı Arayüzü**| **Svelte 5 + TypeScript** | Yüksek performanslı ve hafif reaktif arayüz | +| **Stil / Tasarım** | **Tailwind CSS v4** | Modern, karanlık tema odaklı UI bileşenleri | + +--- + +## 📁 Proje Yapısı + +```text +Multron-Download-Manager/ +├── app.go # Wails köprü mantığı ve olay bağlayıcıları +├── main.go # Masaüstü pencere yapılandırması ve giriş noktası +├── pkg/ +│ └── engine/ # Bağımsız Go indirme motoru ve disk yazıcısı +├── frontend/ +│ ├── src/ +│ │ ├── App.svelte # Ana kontrol paneli +│ │ ├── main.ts # Frontend başlangıç noktası +│ │ └── style.css # Tailwind v4 tema direktifleri +│ ├── package.json +│ └── vite.config.ts +├── wails.json # Wails derleme ve paketleme ayarları +└── README.md +``` + +--- + +## 🚀 Geliştirme Ortamı Kurulumu + +### Önkoşullar +* **Go** (1.21 veya üzeri) +* **Node.js** (v18 veya üzeri) ve **npm** +* **Wails CLI:** + ```bash + go install github.com/wailsapp/wails/v2/cmd/wails@latest + ``` + +### Depoyu Klonlama ve Çalıştırma + +```bash +# 1. Depoyu klonlayın +git clone https://github.com/Multron-Community/Multron-Download-Manager.git +cd Multron-Download-Manager + +# 2. Geliştirici modunda başlatın (Hot-Reload devrede) +wails dev +``` + +--- + +## 🌿 Git ve Geliştirme İş Akışı + +Doğrudan `main` dalına commit atılmaz. Tüm özellikler ilgili çalışma dallarından Pull Request açılarak ana dala birleştirilir: + +* `feat/engine-core` : Go indirme motoru, chunk bölücü ve I/O işlemleri. +* `feat/ui-dashboard` : Svelte 5 paneli, hız grafikleri ve kullanıcı etkileşimleri. + +--- + +## 📄 Lisans + +Bu proje **MIT Lisansı** altında lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına göz atabilirsiniz. \ No newline at end of file