ForgeFusion.Core.Data.Entities.Traders 1.1.1-beta

ForgeFusion Traders Library

Overview

The ForgeFusion.Core.Data.Entities.Traders library provides a comprehensive set of models and relationships for representing and managing trader entities within the ForgeFusion ecosystem. It is a key part of the Datastores layer and is designed to support complex trading, supply chain, and business network scenarios.

✨ Features

• Trader Entity Abstractions: Core models for buyers, sellers, merchants, suppliers, outlets, and clusters.
• Relationship Modeling: Rich navigation properties for representing real-world relationships between traders, such as:
  • Merchants and their outlets
  • Suppliers and their catalogues
  • Clusters of merchants and suppliers
• Extensible Base Types: All trader entities inherit from common base types, supporting features like soft deletion, auditing, and multi-tenancy.
• Integration with Products and Accounts: Direct references to product catalogues and account/tenant entities for seamless business logic integration.
• Support for Business Networks: Models for clusters and associations, enabling advanced supply chain and distribution scenarios.
• Serialization and Data Annotations: Uses attributes for JSON serialization and data validation, ensuring robust API and data layer integration.

Key Entities

• Merchant: Represents a seller or business entity, with support for outlets, catalogues, and cluster memberships.
• Supplier: Represents a supplier in the network, with catalogues and cluster relationships.
• Outlet: Represents a physical or logical outlet/store for a merchant.
• Cluster: Represents a group or association of merchants or suppliers for business collaboration.
• Buyer: Represents a customer or purchasing entity in the system.

Example Relationships

• A Merchant can have multiple Outlets and belong to multiple Clusters.
• A Supplier can have multiple Catalogues and belong to multiple Clusters.
• Clusters can group merchants and suppliers for business logic such as promotions, distribution, or reporting.

Integration

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

Installation

Install via NuGet: dotnet add package ForgeFusion.Core.Data.Entities.Traders

Guidance for Contributors

• Add new trader types or relationships by extending the base trader entities.
• Use data annotations and JSON attributes for all new models.
• Integrate with products and accounts for end-to-end business scenarios.

Example Usage

var merchant = new Merchant {
    IsCreditCustomer = true,
    Outlets = new List<Outlet> { /* ... */ },
    Catalogues = new List<Catalogue> { /* ... */ }
};

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