ForgeFusion.Core.Data.Products 1.1.1-beta

ForgeFusion Products Library

Overview

The ForgeFusion.Core.Data.Products library provides a comprehensive set of models and logic for managing product catalogs, variants, offers, and discounts within the ForgeFusion ecosystem. It is a core part of the Datastores layer and is designed to support complex product management, pricing, and promotional scenarios.

✨ Features

• Product Catalog Models: Core entities for products, product variants, and catalogues.
• Offer and Discount Management: Models for offers, discounts, and pricing strategies.
• Variant Support: Support for product variants, themes, and attributes.
• Integration with Traders and Accounts: Direct references to trader entities (e.g., merchants, suppliers) and account/tenant entities for seamless business logic integration.
• Extensible Base Types: All product entities inherit from common base types, supporting features like soft deletion, auditing, and multi-tenancy.
• Serialization and Data Annotations: Uses attributes for JSON serialization and data validation, ensuring robust API and data layer integration.

Key Entities

• Product: Represents a core product in the catalog.
• ProductVariant: Represents a specific variant of a product (e.g., size, color).
• Catalogue: Represents a collection of products offered by a merchant or supplier.
• BaseOfferModel: Represents an offer or discount applied to products or catalogues.

Example Relationships

• A Product can have multiple ProductVariants.
• A Catalogue can contain multiple Products and be associated with a merchant or supplier.
• Offers can be applied to products, variants, or entire catalogues.

Integration

• Depends on:
  • ForgeFusion.Core.Data.Common (base models, interfaces)
  • ForgeFusion.Entities.Core.Account (tenant, user references)
  • ForgeFusion.Core.Data.Entities.Traders (merchant, supplier references)
• Used by:
  • Inventory, Financials, Storage, and other domain libraries for product-related logic.

Installation

Install via NuGet: dotnet add package ForgeFusion.Core.Data.Products

Guidance for Contributors

• Add new product types, variants, or offer models by extending the base product entities.
• Use data annotations and JSON attributes for all new models.
• Integrate with traders and accounts for end-to-end business scenarios.

Example Usage

var product = new Product {
    Name = "Premium Coffee",
    Variants = new List<ProductVariant> { /* ... */ }
};

For more details, see the ForgeFusion documentation or explore the source code for entity definitions and relationships.