Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mevlutayilmaz/e-commerce-api
This project provides the backend API for an e-commerce website.
https://github.com/mevlutayilmaz/e-commerce-api
asp-net-core asp-net-core-web-api code-first ecommerce-api entity-framework-core jwt jwt-authentication jwt-token mssql mssql-database mssqlserver onion-architecture web-api
Last synced: 5 days ago
JSON representation
This project provides the backend API for an e-commerce website.
- Host: GitHub
- URL: https://github.com/mevlutayilmaz/e-commerce-api
- Owner: mevlutayilmaz
- Created: 2024-08-16T12:04:52.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-08-23T16:05:23.000Z (about 1 month ago)
- Last Synced: 2024-09-25T18:50:50.434Z (8 days ago)
- Topics: asp-net-core, asp-net-core-web-api, code-first, ecommerce-api, entity-framework-core, jwt, jwt-authentication, jwt-token, mssql, mssql-database, mssqlserver, onion-architecture, web-api
- Language: C#
- Homepage:
- Size: 24.4 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# E-Ticaret API
Bu proje, bir e-ticaret web sitesi için backend API'sini sağlar. Modern yazılım mimarisi prensipleri izleyerek, Entity Framework Core ve Code First yaklaşımı ile Microsoft SQL Server veritabanı kullanılarak geliştirilmiştir. API, ürünlerin, kategorilerin, sepetlerin ve siparişlerin yönetimini sağlar ve kullanıcı kimlik doğrulaması için JWT (JSON Web Token) kullanır. Proje, Onion Architecture prensipleri doğrultusunda katmanlı bir yapıya sahiptir.
## Proje Mimarisi
Proje, bağımlılıkları yönetmek ve kodu daha düzenli hale getirmek için Onion Architecture prensipleri doğrultusunda katmanlı bir mimari kullanır. Her katman belirli bir sorumluluğa sahiptir ve sadece kendisinden daha düşük seviyeli katmanlara bağımlıdır.
### 1. Core Katmanı
Bu katman, uygulamanın iş mantığını ve kurallarını içerir. İki yapıdan oluşur:
- **Domain**:
- Uygulamanın temel yapı taşlarını (Entities) tanımlar. Örneğin, `Product`, `Category`, `Basket`, `Order` entity'leri burada bulunur.
- İş kurallarını ve doğrulamalarını içerir.
- Veritabanı veya diğer altyapı teknolojilerinden bağımsızdır.
- **Application**:
- Use case'leri ve iş mantığının uygulanmasını içerir.
- Domain katmanındaki entity'leri ve arayüzleri kullanarak iş operasyonlarını gerçekleştirir.
- Veritabanı veya diğer altyapı teknolojilerinden bağımsızdır.
- CQRS (Command Query Responsibility Segregation) desenini kullanarak komutları ve sorguları ayırır.
### 2. Infrastructure Katmanı
Bu katman, uygulamanın altyapısal bileşenlerini içerir. İki yapıdan oluşur:
- **Infrastructure**:
- Uygulama genelinde kullanılan ortak altyapı bileşenlerini içerir.
- Örneğin, e-posta gönderme, logging gibi işlemler için servisler burada bulunabilir.
- **Persistence**:
- Veritabanı erişimini yönetir.
- Entity Framework Core kullanarak veritabanı işlemlerini gerçekleştirir.
- Repository desenini kullanarak veritabanı erişimini soyutlar.
- Domain katmanındaki entity'leri veritabanı tablolarına eşler.
### 3. Presentation Katmanı
Bu katman, kullanıcı arayüzünü ve API'yi içerir. Tek bir yapıdan oluşur:
- **API (.NET Web API)**:
- Uygulamanın dış dünyaya açılan kapısıdır.
- HTTP isteklerini alır ve Application katmanındaki use case'leri çağırarak işler.
- JSON formatında yanıtlar döndürür.
- Kullanıcı kimlik doğrulaması ve yetkilendirme için JWT (JSON Web Token) kullanır.
## Kimlik Doğrulama ve Yetkilendirme
Proje, kullanıcı kimlik doğrulaması ve yetkilendirme için JWT (JSON Web Token) kullanır. Kullanıcılar, kullanıcı adı ve şifreleriyle giriş yaparak bir Access Token ve bir Refresh Token alırlar.
- **Access Token**: API'ye erişmek için kullanılır ve sınırlı bir geçerlilik süresine sahiptir.
- **Refresh Token**: Access Token'ın süresi dolduğunda yeni bir Access Token almak için kullanılır ve daha uzun bir geçerlilik süresine sahiptir.
## Proje Detayları
- **Product (Ürün)**: Ürün bilgilerini içerir (Ad, Açıklama, Fiyat, Resim, vb.).
- **Category (Kategori)**: Ürün kategorilerini içerir (Ad, Açıklama, vb.).
- **Basket (Sepet)**: Kullanıcıların sepetlerini içerir (Ürünler, Miktarlar, vb.).
- **Order (Sipariş)**: Kullanıcıların siparişlerini içerir (Ürünler, Miktarlar, Adres, vb.).
- **AppUser**: Uygulama kullanıcılarını temsil eder.
- **AppRole**: Kullanıcı rollerini temsil eder.
## Kurulum ve Çalıştırma
1. **Projeyi klonlayın:**
```bash
git clone https://github.com/mevlutayilmaz/e-commerce-api.git
```
2. **`ECommerce.API` klasörüne gidin.**
3. **`appsettings.json` dosyasında veritabanı bağlantı bilgilerini ayarlayın.**
4. **Paketleri yükleyin:**
```bash
dotnet restore
```
5. **Veritabanını oluşturun ve migrate edin:**
```bash
dotnet ef database update
```
6. **Projeyi çalıştırın:**
```bash
dotnet run
```
## Sonuç
Bu proje, temiz bir mimari ve modern teknolojiler kullanarak geliştirilmiş, güvenli ve ölçeklenebilir bir e-ticaret API'sidir. Proje, katmanlı yapısı sayesinde bakımı ve geliştirilmesi kolaydır.
**Bu API'yi kullanan React projesi:** [E-Commerce UI](https://github.com/mevlutayilmaz/e-commerce-ui)
**Web Scraping işlemi ile veritabanına ürünler eklenebilir:** [Web Scraping](https://github.com/mevlutayilmaz/web-scraping)