OElite.Services.Platform

Platform business logic services: auth, customer, merchant, order, payment, inventory, role, settings, tenant, and omni-channel operations.

Overview

OElite.Services.Platform provides the business logic service layer for the OElite eCommerce Platform. Every service implements IOEliteService and is auto-discovered and registered through OElite.Common.Hosting's AddOEliteDependencyInjections() extension.

This package is the heart of the Platform's business operations: it orchestrates data access (via OElite.Data.Platform), applies business rules, manages caching, and emits audit events. Nexus (the core API server) is the primary consumer.

Features

🔐 Auth & Identity

• AuthService: Authentication, token issuance, refresh, and revocation
• RoleService / PermissionService: RBAC and permission catalog management
• IPasswordHasher: Argon2id password hashing

🏪 Commerce Operations

• CustomerService: Customer CRUD, search, multi-tenant isolation
• MerchantService: Merchant onboarding, settings, configuration
• ProductService / CategoryService / CampaignService: Catalog management
• OrderService: Order lifecycle (create, cancel, fulfill, refund)
• PaymentService: Payment processing and webhook handling
• FinanceService: Invoices, expenses, payment tracking

📦 Inventory & Operations

• InventoryService: Stock adjustments, reservations, low-stock alerts
• DashboardService: Aggregated analytics and KPIs

🏢 Multi-tenant

• TenantService: Tenant context resolution and configuration
• SettingService: Per-tenant configuration overrides
• All services enforce tenant isolation via RequestContext

🌐 OmniChannel

• SalesChannelStockAllocationService: Multi-channel stock allocation
• ShippingProviderService / MerchantShippingProviderService: Shipping integration
• OeSterlingAccountService / OeSterlingUsageEventService: Loyalty points accounting
• EnhancedSalesChannelService: Channel management and synchronization

🔔 Auxiliary

• NotificationService: Email, push, and in-app notification dispatch
• PasswordHasher: Argon2id implementation

Quick Start

1. Installation

dotnet add package OElite.Services.Platform

2. Inject a Service

using OElite.Services.Platform.Biz.Customers;

public class MyController
{
    private readonly CustomerService _customers;

    public MyController(CustomerService customers)
    {
        _customers = customers;
    }

    public async Task<IActionResult> GetById(string id)
    {
        var customer = await _customers.GetByIdAsync(id);
        return customer is null ? NotFound() : Ok(customer);
    }
}

Services are auto-registered via OElite's AddOEliteDependencyInjections() — no manual services.AddScoped<CustomerService>() required.

Dependencies

• OElite.Services (core service patterns)
• OElite.Data.Platform (repositories)
• OElite.Common.Platform (entities and DTOs)
• OElite.Common.Hosting.AspNetCore (DI integration)
• OElite.Restme.Hosting 2.x, OElite.Restme.MongoDb 2.x, OElite.Restme.RateLimiting 2.x

Related Packages

• OElite.Common.Hosting.AspNetCore - DI auto-discovery entry point
• OElite.Servers.Nexus - Reference implementation using all these services

License

Copyright (c) Phanes. All rights reserved.