# Proje Yöneticisi **Yerel projelerin için klavye odaklı bir masaüstü merkezi.** Herhangi bir projeyi tek tuşla bul, editöründe aç; git durumunu ve görevlerini bir bakışta gör.

[Microsoft Store](https://apps.microsoft.com/detail/9P4T86KQRBVK) · [Kurulum dosyasını indir](../../releases/latest) · [English](README.md) · [Kod imzalama ve gizlilik](CODE_SIGNING.md) Proje Yöneticisi ana ekranı

## Özellikler - **Komut paleti** (Ctrl+K): Projelerini bulanık aramayla bul, Enter'a basınca editöründe açılsın. Genel kısayol (Ctrl+Shift+P) uygulama tepsideyken bile paleti açar. - **İstediğin gibi proje ekle**: Klasör seç, pencereye sürükle bırak ya da bir kök klasörü tarayıp bulunan her şeyi tek seferde içe aktar. - **Otomatik algılama**: ~40 dil, framework'ler (React, Next.js, Django, Laravel, Rails, Spring, Flutter, Unity, Godot…) ve paket yöneticileri (npm, pnpm, yarn, bun, cargo, pip, poetry, go, composer, nuget…). - **Her kartta git durumu**: Aktif dal, commit'lenmemiş değişiklikler, uzak dala göre ileride/geride olma. - **Hızlı aksiyonlar**: Editörde (proje bazında seçilebilir: VS Code, VS Code Insiders, Cursor ya da herhangi bir komut), terminalde, Dosya Gezgini'nde ya da GitHub'da aç. - **Proje sayfası**: Notlar, yapılacaklar listesi, işlenmiş README ve tek tıkla çalışan `package.json` script'leri. - **Tüm Görevler**: Bütün projelerin görevleri tek listede. - **Bağlı projeler**: Bir frontend'i backend'ine bağla; klasörlerin diskte nerede olduğu fark etmez. **Başlat** ikisini birlikte, her birini kendi editöründe açar ve dev script'lerini ayrı terminallerde çalıştırır. - **Düzen**: Favoriler, sabitleme, renk kodlu gruplar (kartları gruba sürükle), etiketler, sıralama ve kartları sürükleyerek belirlediğin özel sıra. - **Toplu işlemler**: Ctrl/Shift+tıklama ile birden çok proje seç; hepsini birden favorile, sabitle, etiketle, gruba taşı, birbirine bağla ya da listeden kaldır. - **Tepsi menüsü**: Favori ve son açılan projeler; pencereyi açmadan projeyi aç. - **Bakım**: Taşınan ya da silinen proje klasörlerini fark eder, etiketleri yeniden algılar, yedeği dışa/içe aktarır. - **Türkçe ve İngilizce** arayüz, karanlık ve aydınlık tema, dört stil (Klasik, Sade, Cam, Yumuşak), üçer kart renklendirmesi ve düzeni, sekiz vurgu rengi.

## Kurulum **Microsoft Store (önerilen):** [Microsoft Store](https://apps.microsoft.com/detail/9P4T86KQRBVK)'dan yükle. Store sürümü Microsoft tarafından imzalanır, SmartScreen uyarısı olmadan kurulur ve kendiliğinden güncellenir. Windows 10 (1809) ve sonrası gerekir. **Kurulum dosyası:** [Releases](../../releases/latest) sayfasından en güncel `proje-yoneticisi-setup-.exe` dosyasını indirip çalıştır. Windows 10 ve 11 desteklenir. Kurulum dosyası kod imzalı değil, bu yüzden Windows SmartScreen bilinmeyen yayımcı uyarısı verir. **Daha fazla bilgi → Yine de çalıştır**'ı seç. Her kurulum dosyası bu deponun kaynak kodundan GitHub Actions ile derlenir; ayrıntılar için [kod imzalama ve gizlilik](CODE_SIGNING.md). Kurulum dosyasıyla yüklediysen güncellemek için yeni sürümü eskisinin üzerine kur. Yeni sürüm çıktığını **Ayarlar → Güncellemeler** bölümünden görebilirsin: **Şimdi denetle**'ye bas ya da **Otomatik denetle**'yi aç (varsayılan olarak kapalı; bkz. [gizlilik politikası](CODE_SIGNING.md#privacy-policy)). Projelerin korunur, çünkü uygulama verilerini kurulum klasörünün dışında tutar (bkz. [Verilerin](#verilerin)). Store sürümü verilerini ayrı bir yerde tutar; projelerini ikisi arasında taşımak için **Ayarlar → Yedekleme** ile dışa aktarıp içe aktar. ## Klavye kısayolları | Kısayol | Ne yapar | | --- | --- | | Ctrl+K | Komut paleti | | Enter (palette) | Projeyi başlat (bağlı projeler ve dev script'iyle) ya da editörde aç | | Shift+Enter / Ctrl+Enter (palette) | Yalnızca editörde aç / proje sayfasını aç | | Ctrl+Shift+P | Uygulamayı paletle birlikte öne getirir (tepsiden de çalışır; değiştirilebilir) | | Ctrl+N | Proje ekle | | Ctrl+F | Ara | | Ok tuşları, Enter | Kartlar arasında gez, aç | | Ctrl/Shift+tıklama, Ctrl+A | Proje seç / tümünü seç (Esc seçimi temizler) | | Esc | Geri / kapat | ## Verilerin Her şey bilgisayarında, tek bir JSON dosyasında durur: ``` %APPDATA%\project-manager\data.json ``` Her kayıttan önce önceki halin `.bak` kopyası yazılır; dosya bir gün bozulursa uygulama kendini ondan kurtarır. Ayrıca yanındaki `backups` klasöründe son 7 günün günlük kopyaları tutulur. **Ayarlar → Yedekleme** bu kopyaları listeler ve istediğini geri yükler; her şeyi dışa ya da içe aktarmak da oradan yapılır. Uygulama kendi başına hiçbir ağ isteği yapmaz. İnternete giden tek şey tarayıcıda açtığın bağlantılar ve bir projenin README'sine gömülü `https` görselleridir. ## Geliştirme Gerekenler: Windows üzerinde Node.js 22+ ve npm. ```bash npm install npm run dev # anlık yenilemeli Electron uygulaması npm run dev:web # arayüzü tarayıcıda, uydurma örnek verilerle çalıştırır npm test # birim testleri (Vitest), tests/ klasöründe npm run build # release/ klasörüne kurulum dosyası npm run build:store # release/ klasörüne Microsoft Store (MSIX) paketi ``` | Yol | İçinde ne var | | --- | --- | | `src/main/` | Electron ana süreci: pencere, tepsi, IPC, veri dosyası, git, proje algılama (`detect.js`) | | `src/preload/` | Arayüzün kullanabildiği köprü (`window.api`) | | `src/renderer/src/` | React arayüzü; çeviriler `locales/` klasöründe | | `scripts/` | İkon üretimi ve README ekran görüntüleri | **Dil eklemek**: `src/renderer/src/locales/en.js` dosyasını kopyala, değerleri çevir ve dosyayı `src/renderer/src/lib/i18n.js` içinde kaydet. **Ekran görüntüleri**: `npm run dev:web` çalışırken `npm run screenshots` komutunu çalıştır. Görüntüler `src/renderer/src/lib/mockApi.js` içindeki uydurma örnek verilerden üretilir. `npm run build` sırasında `winCodeSign` açılırken "cannot create symbolic link" hatası alırsan Windows Geliştirici Modu'nu aç (ya da terminali yönetici olarak çalıştır) ve tekrar dene. GitHub Actions'taki sürüm derlemeleri bu soruna takılmaz. ### Sürüm yayımlama Bir sürüm etiketi göndermek, kurulum dosyasını GitHub Actions'ta derleyip bir GitHub sürümüne ekler: ```bash npm version minor # ya da patch / major: package.json'ı yükseltir ve etiketi oluşturur git push --follow-tags ``` ## Lisans [MIT](LICENSE)