feat: complete phase six backoffice operations

Tiku.Application/PlatformAdmin/PlatformAdminModels.cs

@@ -0,0 +1,262 @@
+using System.Text.Json;
+using Tiku.Domain.Commerce;
+using Tiku.Domain.Platform;
+using Tiku.Domain.Tenancy;
+using Tiku.Domain.Identity;
+
+namespace Tiku.Application.PlatformAdmin;
+
+public sealed record PlatformAdminActor(Guid UserId);
+
+public sealed record PlatformAdminQuery(string? Status = null, string? Search = null, int? Limit = null);
+
+public sealed record PlatformOverview(
+    int TenantCount,
+    int ActiveTenantCount,
+    int SuspendedTenantCount,
+    int OrderCount,
+    int PaidOrderCount,
+    int RevenueCents,
+    int QuestionBankCount,
+    int QuestionCount,
+    int LearningActiveUserCount);
+
+public sealed record PlatformTenantList(IReadOnlyCollection<PlatformTenantItem> Items);
+
+public sealed record PlatformTenantItem(
+    Guid Id,
+    string Slug,
+    string Name,
+    string? LegalName,
+    TenantStatus Status,
+    TenantMode Mode,
+    BillingStatus BillingStatus,
+    DateTimeOffset? SubscriptionExpiresAt,
+    int DomainCount,
+    DateTimeOffset CreatedAt,
+    DateTimeOffset UpdatedAt);
+
+public sealed record PlatformTenantDetail(
+    PlatformTenantItem Tenant,
+    IReadOnlyCollection<PlatformTenantDomainItem> Domains,
+    IReadOnlyCollection<PlatformTenantSubscriptionItem> Subscriptions,
+    TenantBillingProfileItem? BillingProfile);
+
+public sealed record PlatformTenantDomainItem(
+    Guid Id,
+    Guid TenantId,
+    string Host,
+    TenantDomainType DomainType,
+    TenantDomainStatus Status,
+    bool IsPrimary,
+    DateTimeOffset? VerifiedAt,
+    DateTimeOffset? DnsVerifiedAt,
+    DateTimeOffset? TlsReadyAt,
+    DateTimeOffset? LastCheckedAt,
+    string? LastFailureReason);
+
+public sealed record PlatformTenantSubscriptionItem(
+    Guid Id,
+    Guid TenantId,
+    string PlanCode,
+    TenantSubscriptionStatus Status,
+    DateTimeOffset? StartsAt,
+    DateTimeOffset? ExpiresAt,
+    string? BillingCycle,
+    int AmountCents,
+    JsonElement Metadata);
+
+public sealed record TenantBillingProfileItem(
+    Guid TenantId,
+    string? BillingName,
+    string? TaxId,
+    string? ContactName,
+    string? ContactPhoneMasked,
+    string? ContactEmail,
+    string? BillingAddress,
+    string? InvoiceTitle,
+    TenantInvoiceTitleType? InvoiceType,
+    string? BankName,
+    string? BankAccountMasked,
+    JsonElement Metadata);
+
+public sealed record CreatePlatformTenantCommand(
+    string Slug,
+    string Name,
+    string? LegalName,
+    TenantStatus Status,
+    BillingStatus BillingStatus,
+    JsonElement Metadata);
+
+public sealed record UpdatePlatformTenantStatusCommand(
+    Guid TenantId,
+    TenantStatus Status,
+    BillingStatus BillingStatus,
+    string? Reason);
+
+public sealed record UpsertPlatformTenantBillingProfileCommand(
+    Guid TenantId,
+    string? BillingName,
+    string? TaxId,
+    string? ContactName,
+    string? ContactPhone,
+    string? ContactEmail,
+    string? BillingAddress,
+    string? InvoiceTitle,
+    TenantInvoiceTitleType? InvoiceType,
+    string? BankName,
+    string? BankAccountMasked,
+    JsonElement Metadata);
+
+public sealed record PlatformPlanList(IReadOnlyCollection<PlatformSaasPlan> Items);
+
+public sealed record UpsertPlatformSubscriptionCommand(
+    Guid TenantId,
+    string PlanCode,
+    TenantSubscriptionStatus Status,
+    DateTimeOffset? StartsAt,
+    DateTimeOffset? ExpiresAt,
+    string? BillingCycle,
+    int AmountCents,
+    JsonElement Metadata);
+
+public sealed record PlatformDomainList(IReadOnlyCollection<PlatformTenantDomainItem> Items);
+
+public sealed record PlatformDomainRecheckResult(Guid DomainId, TenantDomainStatus Status, DateTimeOffset LastCheckedAt);
+
+public sealed record PlatformStaffList(IReadOnlyCollection<PlatformStaffItem> Items);
+
+public sealed record PlatformStaffItem(
+    Guid UserId,
+    string? Name,
+    string? PhoneMasked,
+    string? Email,
+    UserStatus Status,
+    IReadOnlyCollection<string> RoleCodes,
+    DateTimeOffset CreatedAt,
+    DateTimeOffset UpdatedAt);
+
+public sealed record UpsertPlatformStaffCommand(
+    Guid? UserId,
+    string? Email,
+    string? Phone,
+    string? Name,
+    UserStatus Status,
+    IReadOnlyCollection<Guid> RoleIds);
+
+public sealed record UpdatePlatformStaffStatusCommand(Guid UserId, UserStatus Status, string? Reason);
+
+public sealed record PlatformAuditLogList(IReadOnlyCollection<PlatformAuditLogItem> Items);
+
+public sealed record PlatformAuditLogItem(
+    Guid Id,
+    Guid? TenantId,
+    Guid? ActorUserId,
+    string Action,
+    string? TargetType,
+    string? TargetId,
+    JsonElement Details,
+    string? IpAddress,
+    string? UserAgent,
+    DateTimeOffset CreatedAt);
+
+public sealed record PlatformAuditAlertList(IReadOnlyCollection<PlatformAuditAlert> Items);
+
+public sealed record UpdatePlatformAuditAlertStatusCommand(
+    Guid AlertId,
+    PlatformAuditAlertStatus Status,
+    string? ResolutionNote);
+
+public sealed record PlatformDunningChannelList(IReadOnlyCollection<PlatformDunningChannelItem> Items);
+
+public sealed record PlatformDunningChannelItem(
+    Guid Id,
+    string ChannelCode,
+    string Name,
+    string? Description,
+    bool Enabled,
+    PlatformDunningProvider Provider,
+    string WebhookUrlMasked,
+    string? SecretRef,
+    IReadOnlyCollection<string> ReminderTypes,
+    IReadOnlyCollection<string> ReminderChannels,
+    int MinReminderLevel,
+    IReadOnlyCollection<Guid> TenantIds,
+    int TimeoutSeconds,
+    JsonElement Metadata,
+    DateTimeOffset CreatedAt,
+    DateTimeOffset UpdatedAt);
+
+public sealed record UpsertPlatformDunningChannelCommand(
+    Guid? ChannelId,
+    string ChannelCode,
+    string Name,
+    string? Description,
+    bool Enabled,
+    PlatformDunningProvider Provider,
+    string WebhookUrl,
+    string? SecretRef,
+    IReadOnlyCollection<string> ReminderTypes,
+    IReadOnlyCollection<string> ReminderChannels,
+    int MinReminderLevel,
+    IReadOnlyCollection<Guid> TenantIds,
+    int TimeoutSeconds,
+    JsonElement Metadata);
+
+public sealed record DisablePlatformDunningChannelCommand(Guid ChannelId, string? Reason);
+
+public sealed record PlatformDunningEventList(IReadOnlyCollection<PlatformDunningEventItem> Items);
+
+public sealed record PlatformDunningEventItem(
+    Guid Id,
+    Guid TenantId,
+    Guid ChannelId,
+    Guid ReminderId,
+    Guid InvoiceId,
+    PlatformDunningProvider Provider,
+    PlatformDunningNotificationStatus Status,
+    int Attempts,
+    DateTimeOffset ScheduledAt,
+    DateTimeOffset? NextAttemptAt,
+    DateTimeOffset? LastAttemptAt,
+    DateTimeOffset? SentAt,
+    string? LastError,
+    int? LastHttpCode,
+    string? LastResponseSummary,
+    JsonElement RequestPayload,
+    JsonElement Metadata,
+    DateTimeOffset CreatedAt,
+    DateTimeOffset UpdatedAt);
+
+public sealed record RetryPlatformDunningEventCommand(Guid EventId, string? Reason);
+
+public interface IPlatformAdminService
+{
+    Task<PlatformOverview> GetOverviewAsync(PlatformAdminActor actor, CancellationToken cancellationToken = default);
+    Task<PlatformTenantList> GetTenantsAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformTenantDetail> GetTenantDetailAsync(PlatformAdminActor actor, Guid tenantId, CancellationToken cancellationToken = default);
+    Task<PlatformTenantItem> CreateTenantAsync(PlatformAdminActor actor, CreatePlatformTenantCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformTenantItem> UpdateTenantStatusAsync(PlatformAdminActor actor, UpdatePlatformTenantStatusCommand command, CancellationToken cancellationToken = default);
+    Task<TenantBillingProfileItem> UpsertTenantBillingProfileAsync(PlatformAdminActor actor, UpsertPlatformTenantBillingProfileCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformPlanList> GetPlansAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformTenantSubscriptionItem> UpsertSubscriptionAsync(PlatformAdminActor actor, UpsertPlatformSubscriptionCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformDomainList> GetDomainsAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformDomainRecheckResult> RecheckDomainAsync(PlatformAdminActor actor, Guid domainId, CancellationToken cancellationToken = default);
+    Task<PlatformStaffList> GetStaffAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformStaffItem> UpsertStaffAsync(PlatformAdminActor actor, UpsertPlatformStaffCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformStaffItem> UpdateStaffStatusAsync(PlatformAdminActor actor, UpdatePlatformStaffStatusCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformAuditLogList> GetAuditLogsAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformAuditAlertList> GetAuditAlertsAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformAuditAlert> UpdateAuditAlertStatusAsync(PlatformAdminActor actor, UpdatePlatformAuditAlertStatusCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformDunningChannelList> GetDunningChannelsAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformDunningChannelItem> UpsertDunningChannelAsync(PlatformAdminActor actor, UpsertPlatformDunningChannelCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformDunningChannelItem> DisableDunningChannelAsync(PlatformAdminActor actor, DisablePlatformDunningChannelCommand command, CancellationToken cancellationToken = default);
+    Task<PlatformDunningEventList> GetDunningEventsAsync(PlatformAdminActor actor, PlatformAdminQuery query, CancellationToken cancellationToken = default);
+    Task<PlatformDunningEventItem> GetDunningEventDetailAsync(PlatformAdminActor actor, Guid eventId, CancellationToken cancellationToken = default);
+    Task<PlatformDunningEventItem> RetryDunningEventAsync(PlatformAdminActor actor, RetryPlatformDunningEventCommand command, CancellationToken cancellationToken = default);
+}
+
+public sealed class PlatformAdminException(string message, string code) : Exception(message)
+{
+    public string Code { get; } = code;
+}