🛒 E-Commerce Mobile App

Cross-platform e-ticaret uygulaması (.NET MAUI - Ana Proje)

📖 Dokümantasyon • 🐛 Bug Report • 💡 Feature Request

📋 İçindekiler

• ✨ Özellikler
• 🚀 Teknolojiler
• 📁 Proje Yapısı
• 🛠️ Kurulum
• 📱 Mobil Test
• 🎯 Kullanım
• 📸 Ekran Görüntüleri
• 🔧 Debug Araçları
• 🤝 Katkıda Bulunma
• 📝 Lisans

🎯 Proje Hikayesi

Bu proje .NET MAUI ile cross-platform e-ticaret uygulaması olarak geliştirildi. MAUI projesi Windows ve Android platformlarında teknik sorunlar yaşadığı için, aynı işlevselliği gösteren HTML/CSS/JavaScript tabanlı web alternatifi oluşturuldu.

🏗️ Proje Yapısı

📱 .NET MAUI (Ana Proje)

• Cross-platform mobil ve masaüstü uygulaması
• XAML tabanlı modern UI tasarımı
• C# backend kodu ve MVVM pattern
• Windows, Android, iOS platform desteği
• Gerçek native uygulama deneyimi

🌐 Web Alternatifi (Geçici Çözüm)

• MAUI sorunları nedeniyle oluşturulan alternatif
• HTML5, CSS3, JavaScript ile geliştirildi
• Responsive tasarım (mobil + masaüstü)
• LocalStorage ile veri yönetimi
• Tüm modern tarayıcılarda çalışır

✨ Özellikler

🏠 Ana Sayfa

• 🎨 Modern ve kullanıcı dostu arayüz
• 👤 Kullanıcı girişi sonrası kişiselleştirilmiş deneyim
• 🧭 Tüm sayfalara kolay erişim
• 📱 Tam responsive tasarım

🔐 Kullanıcı Sistemi

• 🔒 Güvenli kayıt olma ve giriş yapma
• ⚠️ Aynı email ile çoklu kayıt engelleme
• ✅ Form validasyonu ve hata yönetimi
• 💾 LocalStorage ile veri saklama
• 🔄 Otomatik oturum yönetimi

🛍️ Ürün Yönetimi

• 📦 6 farklı ürün kategorisi (Elektronik, Giyim, Ev & Yaşam, Spor)
• 🔍 Gerçek zamanlı arama ve filtreleme
• 🎴 Responsive ürün kartları
• 🛒 Sepet butonu ve gerçek zamanlı sayaç
• 🏷️ Kategori bazlı filtreleme

🛒 Sepet Sistemi

• ⚡ Gerçek zamanlı sepet yönetimi
• ➕➖ Miktar artırma/azaltma (+/- butonları)
• 🗑️ Ürün silme ve sepeti temizleme
• 💰 Otomatik toplam tutar hesaplama
• 💳 Ödeme simülasyonu
• 📊 Detaylı sepet özeti

📱 Cross-Platform Desteği

• 📱 Mobil cihazlarda mükemmel görünüm
• 🖥️ Masaüstü tarayıcılarda tam uyumluluk
• 👆 Dokunmatik ve mouse optimizasyonu
• ⚡ Hızlı yükleme ve performans

🚀 Teknolojiler

HTML5

CSS3

JavaScript

Git

🛠️ Kullanılan Teknolojiler

• Frontend: HTML5, CSS3, JavaScript (ES6+)
• Mobile Framework: .NET MAUI (Cross-platform)
• Web Framework: Blazor WebAssembly
• Backend: .NET 8.0
• Veri Saklama: LocalStorage API
• Tasarım: Responsive Web Design (Mobile-first)
• İkonlar: Emoji ve Unicode karakterler
• Server: Python HTTP Server / Node.js
• Versiyon Kontrolü: Git & GitHub

📁 Proje Yapısı

ECommerceMobileApp/
├── 📱 .NET MAUI Projesi (ANA PROJE)
│   ├── ECommerceMobileApp.csproj    # MAUI proje dosyası
│   ├── MainPage.xaml                # Ana sayfa XAML
│   ├── LoginPage.xaml               # Giriş sayfası XAML
│   ├── ProductsPage.xaml            # Ürünler sayfası XAML
│   ├── CartPage.xaml                # Sepet sayfası XAML
│   ├── Models/                      # Veri modelleri (C#)
│   ├── ViewModels/                  # MVVM ViewModeller (C#)
│   ├── Services/                    # API servisleri (C#)
│   └── Platforms/                   # Platform özel kodlar
│       ├── Android/                 # Android platform kodu
│       ├── iOS/                     # iOS platform kodu
│       └── Windows/                 # Windows platform kodu
│
├── 🌐 Web Alternatifi (GEÇİCİ ÇÖZÜM)
│   ├── ecommerce.html               # Ana sayfa
│   ├── login.html                   # Giriş/Kayıt sayfası
│   ├── products.html                # Ürünler sayfası
│   ├── cart.html                    # Sepet sayfası
│   ├── debug-storage.html           # Debug aracı
│   ├── test-user.html               # Test kullanıcısı oluşturucu
│   ├── clear-storage.html           # Veri temizleme aracı
│   ├── server.py                    # Python HTTP server
│   └── screenshots/                 # Ekran görüntüleri
│
└── 📚 Dokümantasyon
    ├── README.md                    # Bu dosya
    └── LICENSE                      # MIT lisansı

🛠️ Kurulum

📋 Gereksinimler

MAUI Projesi için:

• Visual Studio 2022 (17.3+)
• .NET 8.0 SDK
• Windows App SDK (Windows için)
• Android SDK (Android için)

Web Alternatifi için:

• Modern web tarayıcısı (Chrome, Firefox, Safari, Edge)
• Python 3.x veya Node.js (opsiyonel, server için)

🚀 Hızlı Başlangıç

📱 Yöntem 1: .NET MAUI (Ana Proje)

# Repository'yi klonlayın
git clone https://github.com/alknbugra/ecommerce-mobile-app.git
cd ecommerce-mobile-app

# Visual Studio 2022'de açın
# ECommerceMobileApp.csproj dosyasını açın
# F5 ile çalıştırın

🎯 Hedef: Cross-platform native uygulama (Windows, Android, iOS)

🌐 Yöntem 2: Web Alternatifi (Geçici Çözüm)

# Repository'yi klonlayın
git clone https://github.com/alknbugra/ecommerce-mobile-app.git
cd ecommerce-mobile-app

# Python server'ı başlatın
python server.py

🌐 Uygulama http://localhost:8000 adresinde çalışacak. ⚠️ Not: MAUI projesi Windows ve Android'de teknik sorunlar yaşamaktadır.

Yöntem 3: Doğrudan Açma

ecommerce.html dosyasını tarayıcıda açın (CORS kısıtlamaları olabilir).

📱 Mobil Erişim

# IP adresinizi öğrenin
ipconfig  # Windows
ifconfig  # macOS/Linux

# Mobil cihazınızdan erişin
http://[IP-ADRESI]:8000/ecommerce.html

⚠️ Demo Linki Hakkında

Demo linki geçicidir ve PC kapatıldığında çalışmaz. Yerel test için yukarıdaki kurulum adımlarını kullanın.

📱 Mobil Test

1. Server'ı çalıştırın
2. Bilgisayarınızın IP adresini bulun
3. Mobil cihazınızdan http://[IP-ADRESI]:8000/ecommerce.html adresine gidin

🎯 Kullanım

1. Ana Sayfa: Uygulamaya giriş yapın
2. Kayıt Ol: Yeni hesap oluşturun
3. Giriş Yap: Mevcut hesapla giriş yapın
4. Ürünleri İncele: Kategorilere göre filtreleyin
5. Sepete Ekle: Beğendiğiniz ürünleri sepete ekleyin
6. Sepeti Yönet: Miktarları değiştirin, ürünleri silin
7. Ödeme: Simüle edilmiş ödeme işlemi

🔧 Debug Araçları

• debug-storage.html: LocalStorage verilerini görüntüle
• test-user.html: Test kullanıcısı oluştur
• clear-storage.html: Tüm verileri temizle

📸 Ekran Görüntüleri

🏠 Ana Sayfa

Modern tasarım ve kullanıcı dostu arayüz

🔐 Giriş/Kayıt Sayfası

Güvenli kullanıcı kimlik doğrulama sistemi

🛍️ Ürünler Sayfası

Kategori filtreleme ve gerçek zamanlı arama

🛒 Sepet Sayfası

Gelişmiş sepet yönetimi ve ödeme simülasyonu

🤝 Katkıda Bulunma

Katkılarınız her zaman hoş karşılanır! Bu projeyi geliştirmek için:

🚀 Nasıl Katkıda Bulunabilirsiniz?

1. ⭐ Star verin - Projeyi beğendiyseniz yıldız vermeyi unutmayın!
2. 🍴 Fork edin - Repository'yi kendi hesabınıza kopyalayın
3. 🌿 Branch oluşturun - git checkout -b feature/AmazingFeature
4. 💻 Kod yazın - Değişikliklerinizi yapın
5. 📝 Commit edin - git commit -m 'Add some AmazingFeature'
6. 📤 Push edin - git push origin feature/AmazingFeature
7. 🔄 Pull Request oluşturun - Değişikliklerinizi gözden geçirmek için

🐛 Bug Report

Bir hata bulduysanız, lütfen Issues bölümünde bildirin.

💡 Feature Request

Yeni özellik önerileriniz için Issues bölümünü kullanın.

📊 Proje İstatistikleri

👨‍💻 Geliştirici

Buğra Alkın

📝 Lisans

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

MIT License

Copyright (c) 2025 Buğra Alkın

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

⭐ Bu projeyi beğendiyseniz yıldız vermeyi unutmayın!

Made with ❤️ by Buğra Alkın