Users & Roles Widget

Email Notification Widget

Cron Jobs Widget

Logs Widget

Sitemap Widget

Payment & Subscriptions Widget

User Statuses

User's Controller Endpoints

User Data Models

public class UserVM {
  public string Email { get; set; }
  public string Password { get; set; }
  public string FullName { get; set; }
  public string PhoneNumber { get; set; }
  public string Address { get; set; }
  public string City { get; set; }
  public string State { get; set; }
  public string Country { get; set; }
  public string ZipCode { get; set; }
  public IFormFile ProfilePicture { get; set; }
  public string[] Role { get; set; }
  public bool IsActive { get; set; }
}

public class UserUpdateDto {
  public string Id { get; set; }
  public string Email { get; set; }
  public string FullName { get; set; }
  public string PhoneNumber { get; set; }
  public string Address { get; set; }
  public string City { get; set; }
  public string State { get; set; }
  public string Country { get; set; }
  public string ZipCode { get; set; }
  public string ProfilePicture { get; set; }
  public string[] RoleIds { get; set; }
  public SelectListItem[] RolesList { get; set; }
  public bool IsActive { get; set; }
}

Role's Controller Endpoints

Role Data Models

public class RoleVM {
  public string Name { get; set; }
}

Default System Roles

SMTP Account Management

The EmailAccount model represents SMTP credentials and settings for sending emails.

Dynamic Email Templating

MessageTemplates are stored email blueprints that use DotLiquid placeholders for dynamic content rendering.

Asynchronous Email Processing

Emails are inserted into the QueuedEmail table and sent by a background service.

Primary Email Interface

The EmailEngineService.Execute() method is the main entry point for sending emails.

Task Execute(string templateName, Dictionary<string, string> keyValuePairs);

Template Creation Process

1. Add template to database

   Create new record in MessageTemplate table with placeholders

2. Define required placeholders

   Document all variables needed for the template

   // Required placeholders:
   // - CustomerName
   // - OrderNumber
   // - CustomerEmail
   // - OrderTotal

3. Test the template

   Use sample data to verify rendering works correctly

4. Implement in code

   Call EmailEngineService.Execute() with proper data

Index View (Index.cshtml)

Core Functionality

public async Task InitializeSchedulerJobsAsync()
{
  // Setup all active jobs with Hangfire
  // RecurringJob.AddOrUpdate(...)
}

IScheduledJob

Base interface for all scheduled jobs

public interface IScheduledJob
{
  void Execute();
}

IAsyncScheduledJob

Extends IScheduledJob for async operations

public interface IAsyncScheduledJob : IScheduledJob
{
  Task ExecuteAsync();
}

AsyncScheduledJob

Abstract base class for async jobs

public abstract class AsyncScheduledJob : IAsyncScheduledJob
{
  public abstract Task ExecuteAsync();

  public void Execute() => 
	throw new NotSupportedException();
}

Adding New Job Types

1. Implement IScheduledJob or IAsyncScheduledJob
2. System auto-discovers & registers the types to DI
3. Sync with database types (optional)

public class MyNewJob : IAsyncScheduledJob
{
  public async Task ExecuteAsync()
  {
	// Job logic here
	await Task.Delay(1000);
  }

  public void Execute() => 
	throw new NotSupportedException();
}

// In Startup.cs
services.AddTransient();

Customizing Job Behavior

1. Change default schedule in InitializeSchedulerJobsAsync Or SyncJobTypesWithDatabaseAsync (if not depending on hanfgire storage)
2. Extend ScheduledJob entity for parameters
3. Update DTOs and views

// Example: Changing default schedule
var newJob = new ScheduledJob
{
	JobName = jobType.Name,
	JobType = typeName,
	CronExpression = Cron.Hourly(), // Default
	IsActive = false,
	CreatedAt = DateTime.UtcNow
};

Configuration Steps

Required Stripe Credentials

Webhook Configuration

To receive real-time payment events from Stripe:

Endpoint URL: https://yourdomain.com/webhook/stripe
Events to listen for:
- checkout.session.completed
- checkout.session.expired
- customer.subscription.updated
- customer.subscription.deleted
- invoice.payment_failed

Configuration Steps

Required Paddle Credentials

Webhook Configuration

To receive real-time payment events from Paddle:

Endpoint URL: https://yourdomain.com/webhook/paddle
Events to listen for:
- subscription.created
- subscription.updated
- subscription.cancelled
- transaction.completed
- transaction.paid

Admin UI Configuration

Configuration Steps

Required reCAPTCHA Credentials