Store API V2 🛒

A scalable, enterprise-grade E-commerce backend built with ASP.NET Core Web API following Clean Architecture principles.

---

📋 Table of Contents

• ✨ Features
• 🏗️ Architecture & Design Patterns
• 🗂️ Project Structure
• 🛠️ Tech Stack
• 🚀 Getting Started
• 🔐 Authentication & Authorization
• 🧪 API Endpoints Overview
• 🗄️ Database & Migrations
• 🤝 Contributing
• 📄 License
• 👨‍💻 Author

---

✨ Features

Feature	Description
🔹 Product Catalog	Full CRUD with advanced filtering by Brand, Type, Price & Search
🔹 Pagination & Sorting	Optimized queries for large datasets with configurable page size
🔹 Specification Pattern	Encapsulated query logic for clean, reusable filtering/sorting
🔹 Generic Repository + UoW	Abstracted data access with transactional consistency
🔹 DTO + AutoMapper	Decoupled API contracts with efficient object mapping
🔹 Global Error Handling	Consistent error responses with detailed diagnostics
🔹 JWT Authentication	Secure endpoints with role-based authorization
🔹 Swagger UI	Interactive API documentation with try-it-out support

---

🏗️ Architecture & Design Patterns

Store.G02.V2/ ├── Core/ # Domain Entities, Interfaces, Specifications │ ├── Entities/ # Aggregates & Value Objects │ ├── Interfaces/ # Repository & Service contracts │ └── Specifications/ # Query specification implementations │ ├── Infrastructure/ # External Implementations │ ├── Data/ # EF Core DbContext & Migrations │ ├── Repositories/ # Concrete Repository implementations │ └── Services/ # Email, File Storage, Auth services │ ├── Shared/ # Cross-cutting Concerns │ ├── DTOs/ # Request/Response models │ ├── Exceptions/ # Custom exception types │ └── Helpers/ # Utilities & Extensions │ └── Store.G02.V2/ # Presentation Layer (API) ├── Controllers/ # REST API endpoints ├── Middleware/ # Global error handling, logging └── Properties/ # appsettings, launchSettings

Patterns Implemented:

• ✅ Clean Architecture – Separation of concerns, dependency inversion
• ✅ Repository + Unit of Work – Testable, transactional data access
• ✅ Specification Pattern – Reusable, composable query logic
• ✅ Generic Repository – DRY CRUD operations across entities
• ✅ DTO Pattern – Secure, versioned API contracts
• ✅ Dependency Injection – Built-in .NET Core DI container

---

🗂️ Project Structure

📦 Store.G02.V2.sln ├── 📁 Core/ │ ├── 📄 Product.cs, Brand.cs, Type.cs │ ├── 📄 IRepository.cs, IUnitOfWork.cs │ └── 📄 BaseSpecification.cs, ISpecification │ ├── 📁 Infrastructure/ │ ├── 📄 StoreContext.cs (EF Core) │ ├── 📄 ProductRepository.cs │ └── 📄 AuthService.cs (JWT Implementation) │ ├── 📁 Shared/ │ ├── 📄 ProductDto.cs, PaginationDto.cs │ ├── 📄 ApiException.cs, ApiResponse │ └── 📄 MappingProfiles.cs (AutoMapper) │ └── 📁 Store.G02.V2/ (API Project) ├── 📄 Program.cs, appsettings.json ├── 📄 ProductsController.cs, AuthController.cs └── 📄 SwaggerConfig.cs

🛠️ Tech Stack

Layer	Technology
Framework	ASP.NET Core 7/8 Web API
Language	C# 12 with modern features
ORM	Entity Framework Core
Database	SQL Server (LocalDB/Production)
Mapping	AutoMapper
Auth	JWT Bearer Tokens, ASP.NET Core Identity
Docs	Swagger/OpenAPI 3.0
Testing	xUnit/MSTest ready structure
Tools	Postman, Bruno, Swagger UI

---

🚀 Getting Started

Prerequisites

• .NET 7/8 SDK
• SQL Server or LocalDB
• Visual Studio 2022 or VS Code + C# Dev Kit
• Postman or Bruno for API testing

Quick Start

# 1. Clone the repository
git clone https://github.com/Mariomedhat899/Store.G02.V2.git
cd Store.G02.V2

# 2. Restore NuGet packages
dotnet restore

# 3. Configure connection string
# Edit: Store.G02.V2/appsettings.json
"ConnectionStrings": {
  "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=StoreG02V2;Trusted_Connection=True;"
}

# 4. Apply Entity Framework migrations
Update-Database
# OR via CLI:
dotnet ef database update

# 5. Run the API
dotnet run --project Store.G02.V2
# Or press F5 in Visual Studio

---
🔐 Authentication & Authorization
This API supports JWT-based authentication for protected endpoints:
POST /api/auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "yourPassword123"
}
Response:
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600,
  "user": { "id": "guid", "email": "user@example.com", "roles": ["Customer"] }
}
Use the token in subsequent requests:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
---
🗄️ Database & Migrations
# Add a new migration
Add-Migration AddProductImageUrl -Context StoreContext

# Update database
Update-Database -Context StoreContext

# Script migration for deployment
Script-Migration -Context StoreContext

# Remove last migration (if needed)
Remove-Migration -Context StoreContext

Seed Data: Initial Brands, Types, and sample Products are seeded on first run.

🛒 ASP.NET Core E-commerce API | Clean Architecture + Repository + Specification Pattern | JWT Auth | EF Core + SQL Server | Swagger Docs