Modules Overview

Overview

Comprehensive product management system with support for variants, categories, brands, and advanced features.

Entities (7)

• Product: Main product entity with rich business logic
• ProductVariant: Product variations (size, color, etc.)
• ProductSpecification: Technical specifications
• ProductGallery: Multiple product images
• Category: Hierarchical product categories
• Brand: Product manufacturers/brands
• Tag: Product tags for categorization

Key Features

• Hierarchical categories (unlimited depth)
• Multi-category products
• Product tagging system
• Image gallery with thumbnails
• Inventory management (stock tracking)
• Low-stock alerts
• Featured products
• Discount pricing with percentage calculation
• Product ratings (automatic aggregation)
• View count tracking
• SEO optimization (slug, meta tags)
• Product dimensions and weight
• Sales count tracking

Business Logic Methods

// Inventory Management
product.UpdateStock(newQuantity);
product.DecreaseStock(quantity);
product.IncreaseStock(quantity);

// Stock Status
bool inStock = product.IsInStock();
bool lowStock = product.IsLowStock();

// Pricing
decimal effectivePrice = product.GetEffectivePrice();
decimal discount = product.GetDiscountPercentage();

// Sales Tracking
product.IncrementSalesCount();
product.IncrementViewCount();

API Endpoints

15 endpoints: GET /api/app/product, POST /api/app/product, etc.

View API Details →

Overview

Full-featured shopping cart with session support for guest users and persistent carts for authenticated users.

Entities (2)

• Cart: Shopping cart with user/session tracking
• CartItem: Individual cart items with quantity

Key Features

• Session-based cart for guest users
• Persistent cart for authenticated users
• Add/update/remove items
• Quantity validation against stock
• Cart expiration (30 days)
• Discount code application
• Real-time total calculation
• Cart abandonment tracking
• Multi-step checkout process
• Stock reservation during checkout

Business Rules

• Automatic stock validation on add/update
• Price recalculation on cart changes
• Discount validation and application
• Cart expiry cleanup (background job)
• Maximum 100 items per cart

API Endpoints

8 endpoints: GET /api/app/cart/my-cart, POST /api/app/cart/add-item, etc.

View API Details →

Overview

Complete order lifecycle management from creation to delivery, with status tracking and order history.

Entities (3)

• Order: Main order entity with comprehensive tracking
• OrderItem: Individual order line items
• OrderStatusHistory: Status change audit trail

Order Lifecycle

Key Features

• Unique order number generation (ORD-YYYYMMDD-####)
• 7 order states with transitions
• Customer information capture
• Shipping address integration
• Payment method selection
• Order status updates with timestamps
• Order cancellation support
• Order history for customers
• Admin order management
• Customer notes
• Denormalized data for performance
• Stock reservation on order creation

API Endpoints

12 endpoints: GET /api/app/order/my-orders, POST /api/app/order/{id}/cancel, etc.

View API Details →

Overview

Flexible payment processing system supporting multiple payment methods and gateways.

Entities (2)

• Payment: Payment transaction records
• PaymentMethod: Available payment methods

Payment Methods

• ZarinPal (Iranian payment gateway)
• Cash on Delivery
• Bank Transfer
• Credit Card (ready for integration)

Payment States

Key Features

• Multiple payment methods
• Payment gateway abstraction
• Payment status tracking
• Transaction ID logging
• Amount verification
• Payment confirmation
• Refund support
• Payment method CRUD (admin)

API Endpoints

5 endpoints: POST /api/app/payment/initiate, POST /api/app/payment/verify, etc.

Overview

Comprehensive shipping management with multiple carriers and tracking support.

Entities (2)

• Shipment: Shipment records with tracking
• ShippingMethod: Available shipping options

Shipping Methods

• Standard: 3-5 business days
• Express: 1-2 business days
• Same Day: Within 24 hours (major cities)

Key Features

• Multiple shipping methods
• Shipping cost calculation (weight-based)
• Tracking number management
• Delivery status tracking
• Estimated delivery dates
• Carrier information
• Shipping address validation

API Endpoints

6 endpoints: GET /api/app/shipping-method/active, POST /api/app/shipment/track, etc.

Overview

Flexible discount system with support for various promotion types and usage rules.

Entities (1)

• Discount: Discount codes and rules

Discount Types

• Percentage: Discount by percentage (e.g., 10% off)
• Fixed Amount: Fixed discount (e.g., 50,000 Toman off)

Key Features

• Discount codes (alphanumeric)
• Percentage and fixed amount discounts
• Date-based activation/expiration
• Usage limits (total and per-user)
• Minimum order amount requirements
• User-specific discounts
• Active/inactive status
• Discount validation logic

Business Rules

// Discount Validation
bool isValid = discount.IsValid();
bool isExpired = discount.IsExpired();
bool isUsageLimitReached = discount.HasReachedUsageLimit();
bool meetsMinimumAmount = orderTotal >= discount.MinimumOrderAmount;

// Discount Calculation
decimal discountAmount = discount.CalculateDiscountAmount(orderTotal);

API Endpoints

5 endpoints: POST /api/app/discount/validate, GET /api/app/discount/active, etc.

Overview

Complete review system with approval workflow, replies, likes, and image uploads.

Entities (4)

• ProductReview: Customer product reviews
• ReviewReply: Admin/seller replies to reviews
• ReviewLike: Helpful/not helpful votes
• ReviewImage: Review photos uploaded by customers

Key Features

• 5-star rating system
• Review approval workflow (admin moderation)
• Verified purchase badges
• Like/dislike functionality (helpful votes)
• Admin/seller replies
• Featured reviews
• Review images (multi-upload)
• Automatic product rating aggregation
• Review sorting (helpful, recent, rating)
• Customer name and email capture

Review Workflow

API Endpoints

8 endpoints: GET /api/app/product-review/by-product/{id}, POST /api/app/product-review, etc.

Overview

Advanced wishlist functionality with multiple lists, priorities, and sharing capabilities.

Entities (2)

• Wishlist: Customer wishlists
• WishlistItem: Products in wishlists

Key Features

• Multiple wishlists per user
• Default wishlist auto-creation
• Public/private wishlists
• Priority levels (High, Medium, Low)
• Notes for wishlist items
• Share wishlist functionality
• Add to cart from wishlist
• Price drop notifications (prepared)

Priority Levels

API Endpoints

7 endpoints: GET /api/app/wishlist/my-wishlists, POST /api/app/wishlist/add-item, etc.