🏪 StoreFlow - Mağaza Yönetim Sistemi

Versiyon: Beta 1.0.0
Platform: Windows Desktop (.NET 8.0)
Geliştirici: @toprak-coder

---

📋 İçindekiler

• Proje Hakkında
• Yenilikler (Beta)
• Özellikler
• Teknolojiler
• Kurulum
• Veritabanı Yapılandırması
• Kullanım
• Ekran Görüntüleri
• Proje Yapısı
• Katkıda Bulunma
• Lisans

---

🎯 Proje Hakkında

StoreFlow, küçük ve orta ölçekli işletmeler için geliştirilmiş modern bir mağaza ve ürün yönetim sistemidir. Windows Forms teknolojisi kullanılarak C# ile geliştirilmiş bu uygulama, kullanıcı dostu arayüzü ve kapsamlı özellikleriyle ürün envanteri yönetimini kolaylaştırır.

---

🆕 Yenilikler (Beta)

✨ Beta 1.0.0 ile Gelen Yenilikler

🌍 Çoklu Dil Desteği

• Türkçe ve İngilizce dil seçenekleri
• Dinamik dil değiştirme sistemi
• Tüm arayüz öğelerinde çoklu dil desteği
• `Langues/` klasöründe kaynak dosyaları:
  • `Lang-TR.resx` - Türkçe dil kaynakları
  • `Lang-EN.resx` - İngilizce dil kaynakları

📊 Excel'e Aktarma

• Ürün listelerini Excel formatında dışa aktarma
• Raporlama ve analiz için veri export
• Kolay veri paylaşımı ve yedekleme

🗄️ Gelişmiş Veritabanı Bağlantı Yönetimi

• Kullanıcı dostu veritabanı bağlantı arayüzü
• Kendi veritabanınızı kolayca bağlayabilme
• Bağlantı dizesi yönetimi iyileştirildi
• Yerel veri saklama (LocalData) ile DB ismi kaydedilir
• Yeni formlar:
  • `DataBaseConnection.cs` - Basit bağlantı formu
  • `DatabaseConnectionDetailed.cs` - Detaylı bağlantı ayarları

🏗️ OOP Yapısına Geçiş

• Dashboard ve diğer UserControl'larda nesne yönelimli programlama
• `UserData` modeli ile kullanıcı bilgileri yönetimi
• Kapsülleme (Encapsulation) uygulandı
• Daha temiz ve sürdürülebilir kod yapısı
• `Models/UserData.cs` - Kullanıcı veri modeli

📁 Yeniden Yapılandırılmış Dosya Sistemi

Proje artık daha organize bir yapıya sahip:

StoreFlow/
├── Forms/                    # Tüm form dosyaları
│   ├── appform.cs
│   ├── LoginForm.cs
│   ├── RegisterForm.cs
│   ├── DataBaseConnection.cs
│   ├── DatabaseConnectionDetailed.cs
│   └── UrunDuzenleWinform.cs
├── Langues/                  # Dil kaynakları
│   ├── Lang-TR.resx
│   └── Lang-EN.resx
├── Models/                   # Veri modelleri
│   └── UserData.cs
├── UserControls/             # Kullanıcı kontrolleri
│   ├── Dashboard.cs
│   ├── Ayarlar.cs
│   ├── AppConfiguration.cs
│   ├── KategoriEkle.cs
│   ├── UrunEkle.cs
│   ├── UrunSil.cs
│   ├── UrunDuzenle.cs
│   └── UrunleriGoruntule.cs
└── Program.cs

🎯 Uygulama İsmi Değişikliği

• Eski isim: "login and register"
• Yeni isim: StoreFlow
• Tüm formlarda tutarlı isimlendirme yapıldı

---

✨ Özellikler

🔐 Kullanıcı Yönetimi

• Kayıt Sistemi: Yeni kullanıcı kaydı oluşturma
• Giriş Sistemi: Güvenli kullanıcı girişi
• Profil Yönetimi: Kullanıcı bilgilerini güncelleme ve hesap silme

📦 Ürün Yönetimi

• Ürün Ekleme: Yeni ürünler ekleme
• Ürün Düzenleme: Mevcut ürünleri güncelleme
• Ürün Silme: Tekli, çoklu ve toplu silme seçenekleri
• Ürün Görüntüleme: Modern DataGridView ile listeleme
• Excel'e Aktarma: Ürün listelerini Excel formatında dışa aktarma 📊

🏷️ Kategori Yönetimi

• Kategori ekleme, silme ve listeleme

📊 Dashboard (Kontrol Paneli)

• Hoş geldin mesajı (çoklu dil desteği)
• Anlık saat gösterimi
• Hızlı erişim butonları
• Sosyal medya bağlantıları
• OOP yapısı ile geliştirildi

⚙️ Ayarlar

• Kullanıcı adı ve şifre değiştirme
• Dil seçimi (Türkçe/İngilizce)
• Veritabanı bağlantı ayarları
• Hesap silme

🌐 Çoklu Dil Desteği

• Türkçe (TR)
• İngilizce (EN)
• Dinamik dil değiştirme

---

🛠️ Teknolojiler

Temel Teknolojiler

• Framework: .NET 8.0 (Windows Forms)
• Dil: C#
• IDE: Visual Studio 2022
• Veritabanı: Microsoft SQL Server (SQL Express)

NuGet Paketleri

• Microsoft.Data.SqlClient (6.1.1)
• ReaLTaiizor (3.8.1.3)
• Syncfusion.Chart.Windows (31.1.21)
• System.Data.SqlClient (4.9.0)
• WinForms.DataVisualization (1.10.0)

---

📥 Kurulum

Gereksinimler

1. Windows 10/11 (64-bit)
2. .NET 8.0 Runtime veya SDK
3. SQL Server (Express Edition yeterli)
4. Visual Studio 2022 (Geliştirme için)

Adım Adım Kurulum

1. Projeyi İndirin

git clone https://github.com/toprak-coder/StoreFlow.git
cd StoreFlow

2. .NET 8.0 SDK Kurulumu

.NET 8.0 SDK İndir

3. SQL Server Kurulumu

• SQL Server Express İndir
• SQL Server Management Studio (SSMS) önerilir

4. Projeyi Açın

# Visual Studio ile açın
start "StoreFlow.sln"

# Veya komut satırından derleyin
dotnet restore
dotnet build

---

🗄️ Veritabanı Yapılandırması

1. Veritabanı Oluşturma

SQL Server Management Studio'da aşağıdaki SQL komutlarını çalıştırın:

-- Veritabanı oluştur
CREATE DATABASE ImLazy;
GO

USE ImLazy;
GO

-- Users tablosu
CREATE TABLE Users (
    Id INT PRIMARY KEY IDENTITY(1,1),
    username NVARCHAR(50) NOT NULL UNIQUE,
    passcode NVARCHAR(100) NOT NULL,
    _name NVARCHAR(100) NOT NULL,
    gender NVARCHAR(10),
    dob DATE,
    CreatedDate DATETIME DEFAULT GETDATE()
);

-- Products tablosu
CREATE TABLE Products (
    ProductID INT PRIMARY KEY IDENTITY(1,1),
    Name NVARCHAR(100) NOT NULL,
    ProductData NVARCHAR(MAX),
    Category NVARCHAR(50),
    CreatedDate DATETIME DEFAULT GETDATE(),
    UpdatedDate DATETIME DEFAULT GETDATE()
);

-- İndeksler
CREATE INDEX IX_Users_Username ON Users(username);
CREATE INDEX IX_Products_Category ON Products(Category);
CREATE INDEX IX_Products_Name ON Products(Name);

2. Veritabanı Bağlantısı (Yeni!)

Beta sürümünde artık uygulama içinden veritabanı bağlantısı yapabilirsiniz:

1. Uygulamayı başlatın
2. "Veritabanı Bağlantısı" butonuna tıklayın
3. SQL Server bilgilerinizi girin
4. "Bağlantıyı Test Et" butonuna tıklayın
5. Başarılı olursa "Kaydet" butonuna tıklayın

---

🚀 Kullanım

İlk Çalıştırma

1. Uygulamayı Başlatın
2. Veritabanı Bağlantısını Yapın
3. Dil Seçimi Yapın (Türkçe/İngilizce)
4. Kayıt Olun
5. Giriş Yapın

Ana Özellikler

📊 Ürün Görüntüleme ve Excel'e Aktarma

1. Sol menüden "Ürün Detayları" seçin
2. Tüm ürünleri tabloda görün
3. "Excel'e Aktar" butonuna tıklayarak verileri dışa aktarın

🌐 Dil Değiştirme

1. Ayarlar menüsüne gidin
2. Dil seçeneğini bulun
3. Türkçe veya İngilizce seçin
4. Uygulama otomatik olarak seçilen dile geçer

---

📸 Ekran Görüntüleri

Giriş Ekranı

Dashboard

Ürün Yönetimi

---

📁 Proje Yapısı

StoreFlow/
├── Forms/                       # Form dosyaları
│   ├── appform.cs
│   ├── LoginForm.cs
│   ├── RegisterForm.cs
│   ├── DataBaseConnection.cs    # 🆕 Veritabanı bağlantı formu
│   ├── DatabaseConnectionDetailed.cs  # 🆕 Detaylı bağlantı
│   └── UrunDuzenleWinform.cs
├── Langues/                     # 🆕 Dil kaynakları
│   ├── Lang-TR.resx             # Türkçe
│   └── Lang-EN.resx             # İngilizce
├── Models/                      # 🆕 Veri modelleri
│   └── UserData.cs              # Kullanıcı veri modeli
├── UserControls/                # Kullanıcı kontrolleri
│   ├── Dashboard.cs             # OOP yapısı
│   ├── Ayarlar.cs
│   ├── AppConfiguration.cs      # 🆕 Uygulama yapılandırması
│   ├── KategoriEkle.cs
│   ├── UrunEkle.cs
│   ├── UrunSil.cs
│   ├── UrunDuzenle.cs
│   └── UrunleriGoruntule.cs     # Excel export
└── Program.cs

---

🔧 Geliştirme Notları

Beta Sürümü İyileştirmeleri

• ✅ Çoklu dil desteği eklendi (TR/EN)
• ✅ Excel'e aktarma özelliği eklendi
• ✅ Veritabanı bağlantı yönetimi iyileştirildi
• ✅ OOP yapısına geçildi (UserData modeli)
• ✅ Dosya yapısı yeniden organize edildi
• ✅ Uygulama adı "StoreFlow" olarak güncellendi

Gelecek Özellikler (Roadmap)

• QR kod oluşturma ve okutma
• Şifre şifreleme (BCrypt/Argon2)
• Excel ile ürün yükleme
• Stok takibi ve fiyat yönetimi
• Satış işlemleri ve raporlama
• Daha fazla dil seçeneği
• Tema seçenekleri (Dark/Light)
• Cloud veritabanı desteği

---

🤝 Katkıda Bulunma

1. Bu repository'yi fork edin
2. Yeni bir branch oluşturun (`git checkout -b feature/YeniOzellik`)
3. Değişikliklerinizi commit edin (`git commit -m 'Yeni özellik eklendi'`)
4. Branch'inizi push edin (`git push origin feature/YeniOzellik`)
5. Pull Request oluşturun

---

📞 İletişim

Geliştirici: Toprak
GitHub: @toprak-coder
Twitter/X: @Psikoz_Coder

---

📄 Lisans

Bu proje MIT License altında lisanslanmıştır.

---

📝 Sürüm Geçmişi

Beta 1.0.0 (Güncel)

• 🆕 Çoklu dil desteği (Türkçe/İngilizce)
• 🆕 Excel'e aktarma özelliği
• 🆕 Gelişmiş veritabanı bağlantı yönetimi
• 🆕 OOP yapısına geçiş (UserData modeli)
• 🆕 Dosya yapısı yeniden organize edildi
• 🆕 Uygulama adı StoreFlow olarak güncellendi
• ✅ Bağlantı dizesi yönetimi iyileştirildi
• ✅ Dashboard ve UserControl'larda kapsülleme uygulandı

Alpha 1.0.0 (Önceki)

• ✅ Temel kullanıcı yönetimi
• ✅ Ürün CRUD işlemleri
• ✅ Kategori yönetimi
• ✅ Dashboard ve ayarlar paneli
• ✅ Modern UI tasarımı

---

⚠️ Önemli Notlar

1. Güvenlik: Bu beta sürümde şifreler düz metin olarak saklanmaktadır. Üretim ortamında kullanmayın!
2. Veritabanı: İlk çalıştırmada veritabanı bağlantı ayarlarını yapmanız gerekecektir.
3. Yedekleme: Önemli verilerinizi düzenli olarak yedekleyin.
4. Dil Desteği: Şu anda Türkçe ve İngilizce dilleri desteklenmektedir.

---

StoreFlow - Mağaza yönetimini kolaylaştırın! 🚀

Bu proje aktif geliştirme aşamasındadır. Geri bildirimleriniz ve önerileriniz için GitHub Issues kullanabilirsiniz.