FlexiPrice

FlexiPrice is a flexible and dynamic pricing .Net Library designed for e-commerce platforms. It allows for calculating product prices based on various factors such as customer loyalty, stock levels, time-limited promotions, and other customizable strategies. This project is open-source and can be used and expanded as needed.it has some different example strategies that you can modify them or build your strategies on top of them.so:

Any contribution would be welcomed for adding more strategies to project.

Features

• Dynamic Pricing: Calculate product prices dynamically based on multiple discount strategies.
• Customizable: Easily add or modify discount strategies according to your business logic.
• Modular Design: The engine is designed as a reusable .NET library that can be integrated into any e-commerce system.

Table of Contents

1. Installation
2. Usage
3. Advanced Factors
4. Extending FlexiPriceEngine
5. Discount Strategies
6. Contributing
7. License

---

Installation

Follow these steps to install and use FlexiPriceEngine in your project:

1. Clone the repository:

   git clone https://github.com/yourusername/FlexiPriceEngine.git

2. Build the project:

   dotnet build

3. Add reference: Add a reference to the FlexiPriceEngine.Core and FlexiPriceEngine.Application projects in your .NET solution.

4. Install dependencies: You may need to install any necessary NuGet packages based on your setup.

---

Usage

To get started with FlexiPriceEngine, follow these steps to set up the pricing engine and apply various discount strategies:

Step 1: Create the Pricing Engine

Initialize the pricing engine and add the discount strategies you want to apply.

var pricingEngine = new PricingEngine();
pricingEngine.AddDiscountService(new LoyaltyDiscountStrategy());
pricingEngine.AddDiscountService(new StockLevelDiscountStrategy());
pricingEngine.AddDiscountService(new PurchaseHistoryDiscountStrategy(orderService));

Step 2: Calculate the Final Price

Use the CalculateFinalPrice method to compute the final price of a product for a customer.

var customer = new Customer { LoyaltyTier = "Gold", Region = "US" };
var product = new Product { BasePrice = 1000 };

var finalPrice = pricingEngine.CalculateFinalPrice(customer, product);

Console.WriteLine($"Final Price: {finalPrice}");

---

Advanced Factors

FlexiPriceEngine includes advanced factors to handle complex pricing scenarios:

1. Customer Purchase History Analysis

Analyze a customer's purchase history to offer personalized discounts.

pricingEngine.AddDiscountService(new PurchaseHistoryDiscountStrategy(orderService));

• Example: Customers who frequently buy complementary products receive additional discounts.

2. Geographic Location-Based Pricing

Offer region-specific discounts based on the customer's geographic location.

pricingEngine.AddDiscountService(new RegionalPricingStrategy());

• Example: Customers in APAC regions get a higher discount due to market demand.

3. Time of Day/Week-Based Pricing

Apply dynamic pricing based on the time of day or week.

pricingEngine.AddDiscountService(new TimeBasedDiscountStrategy());

• Example: Apply a 10% discount during off-peak hours (2 AM - 6 AM) and special weekend promotions.

---

Extending FlexiPriceEngine

FlexiPriceEngine is designed to be modular and extensible. You can add new services, discount strategies, or custom logic by implementing the IDiscountService interface.

Step 1: Create a Custom Discount Strategy

To add a custom discount strategy, implement the IDiscountService interface.

public class SeasonalDiscountStrategy : IDiscountService
{
    public Discount CalculateDiscount(Customer customer, Product product)
    {
        var discount = new Discount { Percentage = 0 };

        if (DateTime.Now.Month == 12) // Apply discount during December
        {
            discount.Percentage = 15;
            discount.Description = "Holiday Discount";
        }

        return discount;
    }
}

Step 2: Register the Custom Strategy

After creating a custom strategy, register it in the pricing engine.

pricingEngine.AddDiscountService(new SeasonalDiscountStrategy());

---

Discount Strategies

Here are some of the discount strategies supported by FlexiPriceEngine:

1. Loyalty Discount:

   • Offers a discount based on the customer's loyalty tier.

2. Stock Level Discount:

   • Adjusts the discount based on the stock level of the product.

3. Purchase History Discount:

   • Offers a discount based on a customer's purchase history.

4. Regional Pricing Discount:

   • Provides region-specific discounts based on the customer’s location.

5. Time-Based Discount:

   • Applies discounts depending on the time of day or week.

---

Contributing

Contributions are welcome! If you'd like to contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and ensure tests are passing.
4. Submit a pull request.

For major changes, please open an issue first to discuss your idea.

---

License

This project is licensed under the MIT License. See the LICENSE file for details.