wangziqi/tiku-backend.net
1
0
Fork 0
forked from xiongyuxing/tiku-backend.net
Code Pull Requests Activity

feat: add referral crm and commission persistence

Browse Source
This commit is contained in:
xiong
2026-07-26 05:41:47 +08:00
parent fc8e04ebd6
commit 07e2db04d0
7 changed files with 13730 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

182
Tiku.Domain/Growth/GrowthEntities.cs Normal file
View File

@@ -0,0 +1,182 @@
using System.Text.Json;
using Tiku.Domain.Common;
namespace Tiku.Domain.Growth;
public sealed class ReferralTrack : AuditableTenantEntity
{
public Guid? LeadId { get; set; }
public Guid? ReferrerUserId { get; set; }
public Guid? TargetUserId { get; set; }
public string? LegacyId { get; set; }
public string EventType { get; set; } = string.Empty;
public string? RefCode { get; set; }
public string? Source { get; set; }
public string? IpAddress { get; set; }
public string? UserAgent { get; set; }
public JsonElement Metadata { get; set; } = JsonDefaults.Object();
}
public sealed class ReferralCode : AuditableTenantEntity
{
public Guid UserId { get; set; }
public string Code { get; set; } = string.Empty;
public ReferralCodeStatus Status { get; set; } = ReferralCodeStatus.Active;
public string? Channel { get; set; }
public string? LandingPath { get; set; }
public JsonElement Metadata { get; set; } = JsonDefaults.Object();
}
public sealed class ReferralLead : AuditableTenantEntity
{
public Guid StudentUserId { get; set; }
public Guid? ReferrerUserId { get; set; }
public Guid? FirstTrackId { get; set; }
public Guid? AssignedToUserId { get; set; }
public Guid? AssignedBy { get; set; }
public string? RefCode { get; set; }
public string? Source { get; set; }
public ReferralLeadBindType BindType { get; set; } = ReferralLeadBindType.FirstTouch;
public ReferralLeadStatus Status { get; set; } = ReferralLeadStatus.Protected;
public DateTimeOffset? ProtectedUntil { get; set; }
public ReferralAssignmentMode? AssignmentMode { get; set; }
public DateTimeOffset? AssignedAt { get; set; }
public JsonElement Metadata { get; set; } = JsonDefaults.Object();
public DateTimeOffset BoundAt { get; set; } = DateTimeOffset.UtcNow;
}
public sealed class ReferralTeamEdge : AuditableTenantEntity
{
public Guid MemberUserId { get; set; }
public Guid? LeaderUserId { get; set; }
public ReferralTeamRelationType RelationType { get; set; } = ReferralTeamRelationType.SalesTeam;
public ReferralTeamEdgeStatus Status { get; set; } = ReferralTeamEdgeStatus.Active;
public JsonElement Metadata { get; set; } = JsonDefaults.Object();
}
public sealed class ReferralQrcode : AuditableTenantEntity
{
public Guid? UserId { get; set; }
public string RefCode { get; set; } = string.Empty;
public string Scene { get; set; } = string.Empty;
public string Page { get; set; } = "pages/index/index";
public string Provider { get; set; } = "wechat-miniapp";
public string? QrcodeUrl { get; set; }
public ReferralQrcodeStatus Status { get; set; } = ReferralQrcodeStatus.Pending;
public string? ErrorMessage { get; set; }
public JsonElement Metadata { get; set; } = JsonDefaults.Object();
}
public sealed class CrmConfig : AuditableTenantEntity
{
public bool Enabled { get; set; }
public string? Url { get; set; }
public string? SecretRef { get; set; }
public string? FormName { get; set; }
public string? ExamType { get; set; }
public int? TimeoutSeconds { get; set; }
public int? DelaySeconds { get; set; }
public ReferralAssignmentMode AssignmentMode { get; set; } = ReferralAssignmentMode.None;
public JsonElement AssignmentPool { get; set; } = JsonDefaults.Array();
public int AssignmentCursor { get; set; }
public JsonElement AssignmentConfig { get; set; } = JsonDefaults.Object();
}
public sealed class CrmWebhookQueueItem : AuditableTenantEntity
{
public string? LegacyId { get; set; }
public string? RecordId { get; set; }
public string? LeadId { get; set; }
public string? Source { get; set; }
public string? Provider { get; set; }
public CrmWebhookQueueStatus Status { get; set; } = CrmWebhookQueueStatus.Pending;
public DateTimeOffset? ScheduledAt { get; set; }
public int Attempts { get; set; }
public DateTimeOffset? NextAttemptAt { get; set; }
public DateTimeOffset? LastAttemptAt { get; set; }
public string? LastError { get; set; }
public int? LastHttpCode { get; set; }
public string? LastResponseSummary { get; set; }
public DateTimeOffset? SentAt { get; set; }
public string? IdempotencyKey { get; set; }
public string? TargetUrl { get; set; }
public JsonElement Payload { get; set; } = JsonDefaults.Object();
}
public sealed class CrmWebhookLog : AuditableTenantEntity
{
public string? LegacyId { get; set; }
public string? RecordId { get; set; }
public string? LeadId { get; set; }
public int? HttpCode { get; set; }
public string? Outcome { get; set; }
public string? ErrorMessage { get; set; }
public string? RequestBody { get; set; }
public JsonElement RequestPayload { get; set; } = JsonDefaults.Object();
public string? ResponseSummary { get; set; }
public DateTimeOffset? SignedAt { get; set; }
public int? Attempt { get; set; }
}
public sealed class TenantCommissionSetting : AuditableTenantEntity
{
public decimal DefaultRate { get; set; } = 0.2m;
public int MinSettlementCents { get; set; }
public CommissionSettlementCycle SettlementCycle { get; set; } = CommissionSettlementCycle.Monthly;
public JsonElement Config { get; set; } = JsonDefaults.Object();
public Guid? UpdatedBy { get; set; }
}
public sealed class CommissionSettlement : AuditableTenantEntity
{
public Guid ReferrerUserId { get; set; }
public Guid? GeneratedBy { get; set; }
public Guid? ReviewedBy { get; set; }
public Guid? PaidBy { get; set; }
public string SettlementNo { get; set; } = string.Empty;
public CommissionSettlementStatus Status { get; set; } = CommissionSettlementStatus.Draft;
public DateOnly PeriodStart { get; set; }
public DateOnly PeriodEnd { get; set; }
public int SourceCount { get; set; }
public int PaidUserCount { get; set; }
public int GrossAmountCents { get; set; }
public int CommissionAmountCents { get; set; }
public decimal DefaultRate { get; set; }
public decimal? EffectiveRate { get; set; }
public DateTimeOffset? ReviewedAt { get; set; }
public DateTimeOffset? PaidAt { get; set; }
public string? PaymentMethod { get; set; }
public string? PaymentAccount { get; set; }
public string? Remark { get; set; }
public JsonElement Metadata { get; set; } = JsonDefaults.Object();
}
public sealed class CommissionSettlementItem : AuditableTenantEntity
{
public Guid? SettlementId { get; set; }
public Guid ReferrerUserId { get; set; }
public Guid? StudentUserId { get; set; }
public CommissionSourceType SourceType { get; set; } = CommissionSourceType.Order;
public Guid SourceId { get; set; }
public string? SourceNo { get; set; }
public DateTimeOffset? SourcePaidAt { get; set; }
public int GrossAmountCents { get; set; }
public decimal CommissionRate { get; set; }
public int CommissionAmountCents { get; set; }
public CommissionRateSource RateSource { get; set; } = CommissionRateSource.Default;
public string AttributionType { get; set; } = "protected_lead";
public JsonElement Metadata { get; set; } = JsonDefaults.Object();
}
public enum ReferralCodeStatus { Active, Disabled }
public enum ReferralLeadBindType { FirstTouch, Manual, Imported }
public enum ReferralLeadStatus { Protected, Invalid, Released }
public enum ReferralAssignmentMode { None, Direct, RoundRobin, Referrer }
public enum ReferralTeamRelationType { SalesTeam, AgentNetwork, TeacherClass }
public enum ReferralTeamEdgeStatus { Active, Disabled }
public enum ReferralQrcodeStatus { Pending, Ready, Failed, Disabled }
public enum CrmWebhookQueueStatus { Pending, Processing, Retrying, Sent, Failed, Discarded }
public enum CommissionSettlementCycle { Manual, Weekly, Monthly }
public enum CommissionSettlementStatus { Draft, PendingReview, Approved, Paid, Rejected, Cancelled }
public enum CommissionSourceType { Order, ActivationCode }
public enum CommissionRateSource { Batch, Member, Default }

259
Tiku.Infrastructure/Persistence/Configurations/GrowthConfigurations.cs Normal file
View File

@@ -0,0 +1,259 @@
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;
using Tiku.Domain.Growth;
using Tiku.Domain.Identity;
using Tiku.Domain.Tenancy;
namespace Tiku.Infrastructure.Persistence.Configurations;
internal sealed class ReferralTrackConfiguration : IEntityTypeConfiguration<ReferralTrack>
{
public void Configure(EntityTypeBuilder<ReferralTrack> builder)
{
builder.ConfigureTenantEntity("referral_tracks");
builder.ConfigureTimestamps();
builder.Property(entity => entity.LegacyId).HasMaxLength(64);
builder.Property(entity => entity.EventType).HasMaxLength(100);
builder.Property(entity => entity.RefCode).HasColumnType("citext").HasMaxLength(100);
builder.Property(entity => entity.Source).HasMaxLength(100);
builder.Property(entity => entity.IpAddress).HasMaxLength(100);
builder.Property(entity => entity.UserAgent).HasMaxLength(1024);
builder.Property(entity => entity.Metadata).IsJson("{}");
builder.HasIndex(entity => new { entity.TenantId, entity.LegacyId }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.LeadId, entity.CreatedAt });
builder.HasIndex(entity => new { entity.TenantId, entity.RefCode, entity.EventType, entity.CreatedAt });
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.ReferrerUserId).OnDelete(DeleteBehavior.SetNull);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.TargetUserId).OnDelete(DeleteBehavior.SetNull);
builder.HasOne<ReferralLead>().WithMany()
.HasForeignKey(entity => new { entity.TenantId, entity.LeadId })
.HasPrincipalKey(entity => new { entity.TenantId, entity.Id })
.OnDelete(DeleteBehavior.SetNull);
}
}
internal sealed class ReferralCodeConfiguration : IEntityTypeConfiguration<ReferralCode>
{
public void Configure(EntityTypeBuilder<ReferralCode> builder)
{
builder.ConfigureTenantEntity("referral_codes");
builder.ConfigureTimestamps();
builder.Property(entity => entity.Code).HasColumnType("citext").HasMaxLength(100);
builder.Property(entity => entity.Status).HasSnakeCaseEnum();
builder.Property(entity => entity.Channel).HasMaxLength(100);
builder.Property(entity => entity.LandingPath).HasMaxLength(2048);
builder.Property(entity => entity.Metadata).IsJson("{}");
builder.HasIndex(entity => new { entity.TenantId, entity.UserId }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.Code }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.Code, entity.Status });
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.UserId).OnDelete(DeleteBehavior.Cascade);
}
}
internal sealed class ReferralLeadConfiguration : IEntityTypeConfiguration<ReferralLead>
{
public void Configure(EntityTypeBuilder<ReferralLead> builder)
{
builder.ConfigureTenantEntity("referral_leads");
builder.ConfigureTimestamps();
builder.Property(entity => entity.RefCode).HasColumnType("citext").HasMaxLength(100);
builder.Property(entity => entity.Source).HasMaxLength(100);
builder.Property(entity => entity.BindType).HasSnakeCaseEnum();
builder.Property(entity => entity.Status).HasSnakeCaseEnum();
builder.Property(entity => entity.AssignmentMode).HasNullableSnakeCaseEnum();
builder.Property(entity => entity.Metadata).IsJson("{}");
builder.Property(entity => entity.BoundAt).HasDefaultValueSql("now()");
builder.HasIndex(entity => new { entity.TenantId, entity.StudentUserId }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.ReferrerUserId, entity.BoundAt });
builder.HasIndex(entity => new { entity.TenantId, entity.AssignedToUserId, entity.Status, entity.BoundAt });
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.StudentUserId).OnDelete(DeleteBehavior.Cascade);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.ReferrerUserId).OnDelete(DeleteBehavior.SetNull);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.AssignedToUserId).OnDelete(DeleteBehavior.SetNull);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.AssignedBy).OnDelete(DeleteBehavior.SetNull);
builder.HasOne<ReferralTrack>().WithMany()
.HasForeignKey(entity => new { entity.TenantId, entity.FirstTrackId })
.HasPrincipalKey(entity => new { entity.TenantId, entity.Id })
.OnDelete(DeleteBehavior.SetNull);
}
}
internal sealed class ReferralTeamEdgeConfiguration : IEntityTypeConfiguration<ReferralTeamEdge>
{
public void Configure(EntityTypeBuilder<ReferralTeamEdge> builder)
{
builder.ConfigureTenantEntity("referral_team_edges");
builder.ConfigureTimestamps();
builder.Property(entity => entity.RelationType).HasSnakeCaseEnum();
builder.Property(entity => entity.Status).HasSnakeCaseEnum();
builder.Property(entity => entity.Metadata).IsJson("{}");
builder.HasIndex(entity => new { entity.TenantId, entity.MemberUserId, entity.RelationType }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.LeaderUserId, entity.Status });
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.MemberUserId).OnDelete(DeleteBehavior.Cascade);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.LeaderUserId).OnDelete(DeleteBehavior.SetNull);
}
}
internal sealed class ReferralQrcodeConfiguration : IEntityTypeConfiguration<ReferralQrcode>
{
public void Configure(EntityTypeBuilder<ReferralQrcode> builder)
{
builder.ConfigureTenantEntity("referral_qrcodes");
builder.ConfigureTimestamps();
builder.Property(entity => entity.RefCode).HasColumnType("citext").HasMaxLength(100);
builder.Property(entity => entity.Scene).HasMaxLength(300);
builder.Property(entity => entity.Page).HasMaxLength(300);
builder.Property(entity => entity.Provider).HasMaxLength(100);
builder.Property(entity => entity.QrcodeUrl).HasMaxLength(2048);
builder.Property(entity => entity.Status).HasSnakeCaseEnum();
builder.Property(entity => entity.Metadata).IsJson("{}");
builder.HasIndex(entity => new { entity.TenantId, entity.Provider, entity.Scene, entity.Page }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.RefCode, entity.Status });
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.UserId).OnDelete(DeleteBehavior.SetNull);
}
}
internal sealed class CrmConfigConfiguration : IEntityTypeConfiguration<CrmConfig>
{
public void Configure(EntityTypeBuilder<CrmConfig> builder)
{
builder.ConfigureTenantEntity("crm_config");
builder.ConfigureTimestamps();
builder.Property(entity => entity.Url).HasMaxLength(2048);
builder.Property(entity => entity.SecretRef).HasMaxLength(300);
builder.Property(entity => entity.FormName).HasMaxLength(200);
builder.Property(entity => entity.ExamType).HasMaxLength(100);
builder.Property(entity => entity.AssignmentMode).HasSnakeCaseEnum();
builder.Property(entity => entity.AssignmentPool).IsJson("[]");
builder.Property(entity => entity.AssignmentConfig).IsJson("{}");
builder.HasIndex(entity => entity.TenantId).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.AssignmentMode });
}
}
internal sealed class CrmWebhookQueueItemConfiguration : IEntityTypeConfiguration<CrmWebhookQueueItem>
{
public void Configure(EntityTypeBuilder<CrmWebhookQueueItem> builder)
{
builder.ConfigureTenantEntity("crm_webhook_queue");
builder.ConfigureTimestamps();
builder.Property(entity => entity.LegacyId).HasMaxLength(64);
builder.Property(entity => entity.RecordId).HasMaxLength(200);
builder.Property(entity => entity.LeadId).HasMaxLength(200);
builder.Property(entity => entity.Source).HasMaxLength(200);
builder.Property(entity => entity.Provider).HasMaxLength(100);
builder.Property(entity => entity.Status).HasSnakeCaseEnum();
builder.Property(entity => entity.IdempotencyKey).HasMaxLength(200);
builder.Property(entity => entity.TargetUrl).HasMaxLength(2048);
builder.Property(entity => entity.Payload).IsJson("{}");
builder.HasIndex(entity => new { entity.TenantId, entity.LegacyId }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.RecordId })
.IsUnique()
.HasFilter("record_id is not null");
builder.HasIndex(entity => new { entity.TenantId, entity.IdempotencyKey })
.IsUnique()
.HasFilter("idempotency_key is not null");
builder.HasIndex(entity => new { entity.TenantId, entity.Status, entity.ScheduledAt, entity.NextAttemptAt });
builder.HasIndex(entity => new { entity.TenantId, entity.RecordId, entity.CreatedAt })
.HasFilter("record_id is not null");
builder.HasIndex(entity => new { entity.TenantId, entity.Source, entity.CreatedAt })
.HasFilter("source = 'tenant.student.crm_push'");
builder.ToTable(table => table.HasCheckConstraint("ck_crm_webhook_queue_attempts", "attempts >= 0"));
}
}
internal sealed class CrmWebhookLogConfiguration : IEntityTypeConfiguration<CrmWebhookLog>
{
public void Configure(EntityTypeBuilder<CrmWebhookLog> builder)
{
builder.ConfigureTenantEntity("crm_webhook_log");
builder.ConfigureTimestamps();
builder.Property(entity => entity.LegacyId).HasMaxLength(64);
builder.Property(entity => entity.RecordId).HasMaxLength(200);
builder.Property(entity => entity.LeadId).HasMaxLength(200);
builder.Property(entity => entity.Outcome).HasMaxLength(100);
builder.Property(entity => entity.RequestPayload).IsJson("{}");
builder.Property(entity => entity.ResponseSummary).HasMaxLength(2000);
builder.HasIndex(entity => new { entity.TenantId, entity.LegacyId }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.RecordId, entity.CreatedAt });
}
}
internal sealed class TenantCommissionSettingConfiguration : IEntityTypeConfiguration<TenantCommissionSetting>
{
public void Configure(EntityTypeBuilder<TenantCommissionSetting> builder)
{
builder.ConfigureTenantEntity("tenant_commission_settings");
builder.ConfigureTimestamps();
builder.Property(entity => entity.DefaultRate).HasPrecision(6, 4);
builder.Property(entity => entity.SettlementCycle).HasSnakeCaseEnum();
builder.Property(entity => entity.Config).IsJson("{}");
builder.HasIndex(entity => entity.TenantId).IsUnique();
builder.ToTable(table =>
{
table.HasCheckConstraint("ck_tenant_commission_settings_default_rate", "default_rate >= 0 and default_rate <= 1");
table.HasCheckConstraint("ck_tenant_commission_settings_min_settlement", "min_settlement_cents >= 0");
});
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.UpdatedBy).OnDelete(DeleteBehavior.SetNull);
}
}
internal sealed class CommissionSettlementConfiguration : IEntityTypeConfiguration<CommissionSettlement>
{
public void Configure(EntityTypeBuilder<CommissionSettlement> builder)
{
builder.ConfigureTenantEntity("commission_settlements");
builder.ConfigureTimestamps();
builder.Property(entity => entity.SettlementNo).HasMaxLength(100);
builder.Property(entity => entity.Status).HasSnakeCaseEnum();
builder.Property(entity => entity.DefaultRate).HasPrecision(6, 4);
builder.Property(entity => entity.EffectiveRate).HasPrecision(6, 4);
builder.Property(entity => entity.PaymentMethod).HasMaxLength(100);
builder.Property(entity => entity.PaymentAccount).HasMaxLength(200);
builder.Property(entity => entity.Metadata).IsJson("{}");
builder.HasIndex(entity => new { entity.TenantId, entity.SettlementNo }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.ReferrerUserId, entity.PeriodStart, entity.PeriodEnd })
.IsUnique()
.HasDatabaseName("ux_commission_settlements_referrer_period");
builder.HasIndex(entity => new { entity.TenantId, entity.ReferrerUserId, entity.PeriodStart })
.HasDatabaseName("ix_commission_settlements_referrer_start");
builder.ToTable(table =>
{
table.HasCheckConstraint("ck_commission_settlements_counts", "source_count >= 0 and paid_user_count >= 0");
table.HasCheckConstraint("ck_commission_settlements_amounts", "gross_amount_cents >= 0 and commission_amount_cents >= 0");
table.HasCheckConstraint("ck_commission_settlements_rates", "default_rate >= 0 and default_rate <= 1 and (effective_rate is null or (effective_rate >= 0 and effective_rate <= 1))");
table.HasCheckConstraint("ck_commission_settlements_period", "period_end >= period_start");
});
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.ReferrerUserId).OnDelete(DeleteBehavior.Cascade);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.GeneratedBy).OnDelete(DeleteBehavior.SetNull);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.ReviewedBy).OnDelete(DeleteBehavior.SetNull);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.PaidBy).OnDelete(DeleteBehavior.SetNull);
}
}
internal sealed class CommissionSettlementItemConfiguration : IEntityTypeConfiguration<CommissionSettlementItem>
{
public void Configure(EntityTypeBuilder<CommissionSettlementItem> builder)
{
builder.ConfigureTenantEntity("commission_settlement_items");
builder.ConfigureTimestamps();
builder.Property(entity => entity.SourceType).HasSnakeCaseEnum();
builder.Property(entity => entity.SourceNo).HasMaxLength(100);
builder.Property(entity => entity.CommissionRate).HasPrecision(6, 4);
builder.Property(entity => entity.RateSource).HasSnakeCaseEnum();
builder.Property(entity => entity.AttributionType).HasMaxLength(100);
builder.Property(entity => entity.Metadata).IsJson("{}");
builder.HasIndex(entity => new { entity.TenantId, entity.SourceType, entity.SourceId }).IsUnique();
builder.HasIndex(entity => new { entity.TenantId, entity.ReferrerUserId, entity.SourcePaidAt });
builder.HasIndex(entity => new { entity.TenantId, entity.SettlementId });
builder.ToTable(table =>
{
table.HasCheckConstraint("ck_commission_settlement_items_amounts", "gross_amount_cents >= 0 and commission_amount_cents >= 0");
table.HasCheckConstraint("ck_commission_settlement_items_rate", "commission_rate >= 0 and commission_rate <= 1");
});
builder.HasOne<CommissionSettlement>().WithMany()
.HasForeignKey(entity => new { entity.TenantId, entity.SettlementId })
.HasPrincipalKey(entity => new { entity.TenantId, entity.Id })
.OnDelete(DeleteBehavior.SetNull);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.ReferrerUserId).OnDelete(DeleteBehavior.Cascade);
builder.HasOne<User>().WithMany().HasForeignKey(entity => entity.StudentUserId).OnDelete(DeleteBehavior.SetNull);
}
}

11024
Tiku.Infrastructure/Persistence/Migrations/20260725214048_AddReferralCrmAndCommissionPersistence.Designer.cs generated Normal file
View File

File diff suppressed because it is too large Load Diff

799
Tiku.Infrastructure/Persistence/Migrations/20260725214048_AddReferralCrmAndCommissionPersistence.cs Normal file
View File

@@ -0,0 +1,799 @@
using System;
using System.Text.Json;
using Microsoft.EntityFrameworkCore.Migrations;
#nullable disable
namespace Tiku.Infrastructure.Persistence.Migrations
{
/// <inheritdoc />
public partial class AddReferralCrmAndCommissionPersistence : Migration
{
/// <inheritdoc />
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.CreateTable(
name: "commission_settlements",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
referrer_user_id = table.Column<Guid>(type: "uuid", nullable: false),
generated_by = table.Column<Guid>(type: "uuid", nullable: true),
reviewed_by = table.Column<Guid>(type: "uuid", nullable: true),
paid_by = table.Column<Guid>(type: "uuid", nullable: true),
settlement_no = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: false),
status = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
period_start = table.Column<DateOnly>(type: "date", nullable: false),
period_end = table.Column<DateOnly>(type: "date", nullable: false),
source_count = table.Column<int>(type: "integer", nullable: false),
paid_user_count = table.Column<int>(type: "integer", nullable: false),
gross_amount_cents = table.Column<int>(type: "integer", nullable: false),
commission_amount_cents = table.Column<int>(type: "integer", nullable: false),
default_rate = table.Column<decimal>(type: "numeric(6,4)", precision: 6, scale: 4, nullable: false),
effective_rate = table.Column<decimal>(type: "numeric(6,4)", precision: 6, scale: 4, nullable: true),
reviewed_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
paid_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
payment_method = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
payment_account = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
remark = table.Column<string>(type: "text", nullable: true),
metadata = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_commission_settlements", x => x.id);
table.UniqueConstraint("ak_commission_settlements_tenant_id_id", x => new { x.tenant_id, x.id });
table.CheckConstraint("ck_commission_settlements_amounts", "gross_amount_cents >= 0 and commission_amount_cents >= 0");
table.CheckConstraint("ck_commission_settlements_counts", "source_count >= 0 and paid_user_count >= 0");
table.CheckConstraint("ck_commission_settlements_period", "period_end >= period_start");
table.CheckConstraint("ck_commission_settlements_rates", "default_rate >= 0 and default_rate <= 1 and (effective_rate is null or (effective_rate >= 0 and effective_rate <= 1))");
table.ForeignKey(
name: "fk_commission_settlements_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_commission_settlements_users_generated_by",
column: x => x.generated_by,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_commission_settlements_users_paid_by",
column: x => x.paid_by,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_commission_settlements_users_referrer_user_id",
column: x => x.referrer_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_commission_settlements_users_reviewed_by",
column: x => x.reviewed_by,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
});
migrationBuilder.CreateTable(
name: "crm_config",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
enabled = table.Column<bool>(type: "boolean", nullable: false),
url = table.Column<string>(type: "character varying(2048)", maxLength: 2048, nullable: true),
secret_ref = table.Column<string>(type: "character varying(300)", maxLength: 300, nullable: true),
form_name = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
exam_type = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
timeout_seconds = table.Column<int>(type: "integer", nullable: true),
delay_seconds = table.Column<int>(type: "integer", nullable: true),
assignment_mode = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
assignment_pool = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'[]'::jsonb"),
assignment_cursor = table.Column<int>(type: "integer", nullable: false),
assignment_config = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_crm_config", x => x.id);
table.UniqueConstraint("ak_crm_config_tenant_id_id", x => new { x.tenant_id, x.id });
table.ForeignKey(
name: "fk_crm_config_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
});
migrationBuilder.CreateTable(
name: "crm_webhook_log",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
legacy_id = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: true),
record_id = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
lead_id = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
http_code = table.Column<int>(type: "integer", nullable: true),
outcome = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
error_message = table.Column<string>(type: "text", nullable: true),
request_body = table.Column<string>(type: "text", nullable: true),
request_payload = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
response_summary = table.Column<string>(type: "character varying(2000)", maxLength: 2000, nullable: true),
signed_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
attempt = table.Column<int>(type: "integer", nullable: true),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_crm_webhook_log", x => x.id);
table.UniqueConstraint("ak_crm_webhook_log_tenant_id_id", x => new { x.tenant_id, x.id });
table.ForeignKey(
name: "fk_crm_webhook_log_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
});
migrationBuilder.CreateTable(
name: "crm_webhook_queue",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
legacy_id = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: true),
record_id = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
lead_id = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
source = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
provider = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
status = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
scheduled_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
attempts = table.Column<int>(type: "integer", nullable: false),
next_attempt_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
last_attempt_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
last_error = table.Column<string>(type: "text", nullable: true),
last_http_code = table.Column<int>(type: "integer", nullable: true),
last_response_summary = table.Column<string>(type: "text", nullable: true),
sent_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
idempotency_key = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
target_url = table.Column<string>(type: "character varying(2048)", maxLength: 2048, nullable: true),
payload = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_crm_webhook_queue", x => x.id);
table.UniqueConstraint("ak_crm_webhook_queue_tenant_id_id", x => new { x.tenant_id, x.id });
table.CheckConstraint("ck_crm_webhook_queue_attempts", "attempts >= 0");
table.ForeignKey(
name: "fk_crm_webhook_queue_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
});
migrationBuilder.CreateTable(
name: "referral_codes",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
user_id = table.Column<Guid>(type: "uuid", nullable: false),
code = table.Column<string>(type: "citext", maxLength: 100, nullable: false),
status = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
channel = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
landing_path = table.Column<string>(type: "character varying(2048)", maxLength: 2048, nullable: true),
metadata = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_referral_codes", x => x.id);
table.UniqueConstraint("ak_referral_codes_tenant_id_id", x => new { x.tenant_id, x.id });
table.ForeignKey(
name: "fk_referral_codes_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_referral_codes_users_user_id",
column: x => x.user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
});
migrationBuilder.CreateTable(
name: "referral_qrcodes",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
user_id = table.Column<Guid>(type: "uuid", nullable: true),
ref_code = table.Column<string>(type: "citext", maxLength: 100, nullable: false),
scene = table.Column<string>(type: "character varying(300)", maxLength: 300, nullable: false),
page = table.Column<string>(type: "character varying(300)", maxLength: 300, nullable: false),
provider = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: false),
qrcode_url = table.Column<string>(type: "character varying(2048)", maxLength: 2048, nullable: true),
status = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
error_message = table.Column<string>(type: "text", nullable: true),
metadata = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_referral_qrcodes", x => x.id);
table.UniqueConstraint("ak_referral_qrcodes_tenant_id_id", x => new { x.tenant_id, x.id });
table.ForeignKey(
name: "fk_referral_qrcodes_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_referral_qrcodes_users_user_id",
column: x => x.user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
});
migrationBuilder.CreateTable(
name: "referral_team_edges",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
member_user_id = table.Column<Guid>(type: "uuid", nullable: false),
leader_user_id = table.Column<Guid>(type: "uuid", nullable: true),
relation_type = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
status = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
metadata = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_referral_team_edges", x => x.id);
table.UniqueConstraint("ak_referral_team_edges_tenant_id_id", x => new { x.tenant_id, x.id });
table.ForeignKey(
name: "fk_referral_team_edges_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_referral_team_edges_users_leader_user_id",
column: x => x.leader_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_referral_team_edges_users_member_user_id",
column: x => x.member_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
});
migrationBuilder.CreateTable(
name: "tenant_commission_settings",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
default_rate = table.Column<decimal>(type: "numeric(6,4)", precision: 6, scale: 4, nullable: false),
min_settlement_cents = table.Column<int>(type: "integer", nullable: false),
settlement_cycle = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
config = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
updated_by = table.Column<Guid>(type: "uuid", nullable: true),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_tenant_commission_settings", x => x.id);
table.UniqueConstraint("ak_tenant_commission_settings_tenant_id_id", x => new { x.tenant_id, x.id });
table.CheckConstraint("ck_tenant_commission_settings_default_rate", "default_rate >= 0 and default_rate <= 1");
table.CheckConstraint("ck_tenant_commission_settings_min_settlement", "min_settlement_cents >= 0");
table.ForeignKey(
name: "fk_tenant_commission_settings_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_tenant_commission_settings_users_updated_by",
column: x => x.updated_by,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
});
migrationBuilder.CreateTable(
name: "commission_settlement_items",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
settlement_id = table.Column<Guid>(type: "uuid", nullable: true),
referrer_user_id = table.Column<Guid>(type: "uuid", nullable: false),
student_user_id = table.Column<Guid>(type: "uuid", nullable: true),
source_type = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
source_id = table.Column<Guid>(type: "uuid", nullable: false),
source_no = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
source_paid_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
gross_amount_cents = table.Column<int>(type: "integer", nullable: false),
commission_rate = table.Column<decimal>(type: "numeric(6,4)", precision: 6, scale: 4, nullable: false),
commission_amount_cents = table.Column<int>(type: "integer", nullable: false),
rate_source = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
attribution_type = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: false),
metadata = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_commission_settlement_items", x => x.id);
table.UniqueConstraint("ak_commission_settlement_items_tenant_id_id", x => new { x.tenant_id, x.id });
table.CheckConstraint("ck_commission_settlement_items_amounts", "gross_amount_cents >= 0 and commission_amount_cents >= 0");
table.CheckConstraint("ck_commission_settlement_items_rate", "commission_rate >= 0 and commission_rate <= 1");
table.ForeignKey(
name: "fk_commission_settlement_items_commission_settlements_tenant_i~",
columns: x => new { x.tenant_id, x.settlement_id },
principalTable: "commission_settlements",
principalColumns: new[] { "tenant_id", "id" },
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_commission_settlement_items_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_commission_settlement_items_users_referrer_user_id",
column: x => x.referrer_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_commission_settlement_items_users_student_user_id",
column: x => x.student_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
});
migrationBuilder.CreateTable(
name: "referral_leads",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
student_user_id = table.Column<Guid>(type: "uuid", nullable: false),
referrer_user_id = table.Column<Guid>(type: "uuid", nullable: true),
first_track_id = table.Column<Guid>(type: "uuid", nullable: true),
assigned_to_user_id = table.Column<Guid>(type: "uuid", nullable: true),
assigned_by = table.Column<Guid>(type: "uuid", nullable: true),
ref_code = table.Column<string>(type: "citext", maxLength: 100, nullable: true),
source = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
bind_type = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
status = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
protected_until = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
assignment_mode = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: true),
assigned_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
metadata = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
bound_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_referral_leads", x => x.id);
table.UniqueConstraint("ak_referral_leads_tenant_id_id", x => new { x.tenant_id, x.id });
table.ForeignKey(
name: "fk_referral_leads_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_referral_leads_users_assigned_by",
column: x => x.assigned_by,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_referral_leads_users_assigned_to_user_id",
column: x => x.assigned_to_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_referral_leads_users_referrer_user_id",
column: x => x.referrer_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_referral_leads_users_student_user_id",
column: x => x.student_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
});
migrationBuilder.CreateTable(
name: "referral_tracks",
columns: table => new
{
id = table.Column<Guid>(type: "uuid", nullable: false, defaultValueSql: "gen_random_uuid()"),
lead_id = table.Column<Guid>(type: "uuid", nullable: true),
referrer_user_id = table.Column<Guid>(type: "uuid", nullable: true),
target_user_id = table.Column<Guid>(type: "uuid", nullable: true),
legacy_id = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: true),
event_type = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: false),
ref_code = table.Column<string>(type: "citext", maxLength: 100, nullable: true),
source = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
ip_address = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: true),
user_agent = table.Column<string>(type: "character varying(1024)", maxLength: 1024, nullable: true),
metadata = table.Column<JsonElement>(type: "jsonb", nullable: false, defaultValueSql: "'{}'::jsonb"),
tenant_id = table.Column<Guid>(type: "uuid", nullable: false),
created_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()"),
updated_at = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "now()")
},
constraints: table =>
{
table.PrimaryKey("pk_referral_tracks", x => x.id);
table.UniqueConstraint("ak_referral_tracks_tenant_id_id", x => new { x.tenant_id, x.id });
table.ForeignKey(
name: "fk_referral_tracks_referral_leads_tenant_id_lead_id",
columns: x => new { x.tenant_id, x.lead_id },
principalTable: "referral_leads",
principalColumns: new[] { "tenant_id", "id" },
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_referral_tracks_tenants_tenant_id",
column: x => x.tenant_id,
principalTable: "tenants",
principalColumn: "id",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "fk_referral_tracks_users_referrer_user_id",
column: x => x.referrer_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
table.ForeignKey(
name: "fk_referral_tracks_users_target_user_id",
column: x => x.target_user_id,
principalTable: "users",
principalColumn: "id",
onDelete: ReferentialAction.SetNull);
});
migrationBuilder.CreateIndex(
name: "ix_commission_settlement_items_referrer_user_id",
table: "commission_settlement_items",
column: "referrer_user_id");
migrationBuilder.CreateIndex(
name: "ix_commission_settlement_items_student_user_id",
table: "commission_settlement_items",
column: "student_user_id");
migrationBuilder.CreateIndex(
name: "ix_commission_settlement_items_tenant_id_referrer_user_id_sour~",
table: "commission_settlement_items",
columns: new[] { "tenant_id", "referrer_user_id", "source_paid_at" });
migrationBuilder.CreateIndex(
name: "ix_commission_settlement_items_tenant_id_settlement_id",
table: "commission_settlement_items",
columns: new[] { "tenant_id", "settlement_id" });
migrationBuilder.CreateIndex(
name: "ix_commission_settlement_items_tenant_id_source_type_source_id",
table: "commission_settlement_items",
columns: new[] { "tenant_id", "source_type", "source_id" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_commission_settlements_generated_by",
table: "commission_settlements",
column: "generated_by");
migrationBuilder.CreateIndex(
name: "ix_commission_settlements_paid_by",
table: "commission_settlements",
column: "paid_by");
migrationBuilder.CreateIndex(
name: "ix_commission_settlements_referrer_start",
table: "commission_settlements",
columns: new[] { "tenant_id", "referrer_user_id", "period_start" });
migrationBuilder.CreateIndex(
name: "ix_commission_settlements_referrer_user_id",
table: "commission_settlements",
column: "referrer_user_id");
migrationBuilder.CreateIndex(
name: "ix_commission_settlements_reviewed_by",
table: "commission_settlements",
column: "reviewed_by");
migrationBuilder.CreateIndex(
name: "ix_commission_settlements_tenant_id_settlement_no",
table: "commission_settlements",
columns: new[] { "tenant_id", "settlement_no" },
unique: true);
migrationBuilder.CreateIndex(
name: "ux_commission_settlements_referrer_period",
table: "commission_settlements",
columns: new[] { "tenant_id", "referrer_user_id", "period_start", "period_end" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_crm_config_tenant_id",
table: "crm_config",
column: "tenant_id",
unique: true);
migrationBuilder.CreateIndex(
name: "ix_crm_config_tenant_id_assignment_mode",
table: "crm_config",
columns: new[] { "tenant_id", "assignment_mode" });
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_log_tenant_id_legacy_id",
table: "crm_webhook_log",
columns: new[] { "tenant_id", "legacy_id" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_log_tenant_id_record_id_created_at",
table: "crm_webhook_log",
columns: new[] { "tenant_id", "record_id", "created_at" });
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_queue_tenant_id_idempotency_key",
table: "crm_webhook_queue",
columns: new[] { "tenant_id", "idempotency_key" },
unique: true,
filter: "idempotency_key is not null");
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_queue_tenant_id_legacy_id",
table: "crm_webhook_queue",
columns: new[] { "tenant_id", "legacy_id" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_queue_tenant_id_record_id",
table: "crm_webhook_queue",
columns: new[] { "tenant_id", "record_id" },
unique: true,
filter: "record_id is not null");
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_queue_tenant_id_record_id_created_at",
table: "crm_webhook_queue",
columns: new[] { "tenant_id", "record_id", "created_at" },
filter: "record_id is not null");
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_queue_tenant_id_source_created_at",
table: "crm_webhook_queue",
columns: new[] { "tenant_id", "source", "created_at" },
filter: "source = 'tenant.student.crm_push'");
migrationBuilder.CreateIndex(
name: "ix_crm_webhook_queue_tenant_id_status_scheduled_at_next_attemp~",
table: "crm_webhook_queue",
columns: new[] { "tenant_id", "status", "scheduled_at", "next_attempt_at" });
migrationBuilder.CreateIndex(
name: "ix_referral_codes_tenant_id_code",
table: "referral_codes",
columns: new[] { "tenant_id", "code" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_referral_codes_tenant_id_code_status",
table: "referral_codes",
columns: new[] { "tenant_id", "code", "status" });
migrationBuilder.CreateIndex(
name: "ix_referral_codes_tenant_id_user_id",
table: "referral_codes",
columns: new[] { "tenant_id", "user_id" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_referral_codes_user_id",
table: "referral_codes",
column: "user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_leads_assigned_by",
table: "referral_leads",
column: "assigned_by");
migrationBuilder.CreateIndex(
name: "ix_referral_leads_assigned_to_user_id",
table: "referral_leads",
column: "assigned_to_user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_leads_referrer_user_id",
table: "referral_leads",
column: "referrer_user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_leads_student_user_id",
table: "referral_leads",
column: "student_user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_leads_tenant_id_assigned_to_user_id_status_bound_at",
table: "referral_leads",
columns: new[] { "tenant_id", "assigned_to_user_id", "status", "bound_at" });
migrationBuilder.CreateIndex(
name: "ix_referral_leads_tenant_id_first_track_id",
table: "referral_leads",
columns: new[] { "tenant_id", "first_track_id" });
migrationBuilder.CreateIndex(
name: "ix_referral_leads_tenant_id_referrer_user_id_bound_at",
table: "referral_leads",
columns: new[] { "tenant_id", "referrer_user_id", "bound_at" });
migrationBuilder.CreateIndex(
name: "ix_referral_leads_tenant_id_student_user_id",
table: "referral_leads",
columns: new[] { "tenant_id", "student_user_id" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_referral_qrcodes_tenant_id_provider_scene_page",
table: "referral_qrcodes",
columns: new[] { "tenant_id", "provider", "scene", "page" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_referral_qrcodes_tenant_id_ref_code_status",
table: "referral_qrcodes",
columns: new[] { "tenant_id", "ref_code", "status" });
migrationBuilder.CreateIndex(
name: "ix_referral_qrcodes_user_id",
table: "referral_qrcodes",
column: "user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_team_edges_leader_user_id",
table: "referral_team_edges",
column: "leader_user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_team_edges_member_user_id",
table: "referral_team_edges",
column: "member_user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_team_edges_tenant_id_leader_user_id_status",
table: "referral_team_edges",
columns: new[] { "tenant_id", "leader_user_id", "status" });
migrationBuilder.CreateIndex(
name: "ix_referral_team_edges_tenant_id_member_user_id_relation_type",
table: "referral_team_edges",
columns: new[] { "tenant_id", "member_user_id", "relation_type" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_referral_tracks_referrer_user_id",
table: "referral_tracks",
column: "referrer_user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_tracks_target_user_id",
table: "referral_tracks",
column: "target_user_id");
migrationBuilder.CreateIndex(
name: "ix_referral_tracks_tenant_id_lead_id_created_at",
table: "referral_tracks",
columns: new[] { "tenant_id", "lead_id", "created_at" });
migrationBuilder.CreateIndex(
name: "ix_referral_tracks_tenant_id_legacy_id",
table: "referral_tracks",
columns: new[] { "tenant_id", "legacy_id" },
unique: true);
migrationBuilder.CreateIndex(
name: "ix_referral_tracks_tenant_id_ref_code_event_type_created_at",
table: "referral_tracks",
columns: new[] { "tenant_id", "ref_code", "event_type", "created_at" });
migrationBuilder.CreateIndex(
name: "ix_tenant_commission_settings_tenant_id",
table: "tenant_commission_settings",
column: "tenant_id",
unique: true);
migrationBuilder.CreateIndex(
name: "ix_tenant_commission_settings_updated_by",
table: "tenant_commission_settings",
column: "updated_by");
migrationBuilder.AddForeignKey(
name: "fk_referral_leads_referral_tracks_tenant_id_first_track_id",
table: "referral_leads",
columns: new[] { "tenant_id", "first_track_id" },
principalTable: "referral_tracks",
principalColumns: new[] { "tenant_id", "id" },
onDelete: ReferentialAction.SetNull);
}
/// <inheritdoc />
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.DropForeignKey(
name: "fk_referral_leads_referral_tracks_tenant_id_first_track_id",
table: "referral_leads");
migrationBuilder.DropTable(
name: "commission_settlement_items");
migrationBuilder.DropTable(
name: "crm_config");
migrationBuilder.DropTable(
name: "crm_webhook_log");
migrationBuilder.DropTable(
name: "crm_webhook_queue");
migrationBuilder.DropTable(
name: "referral_codes");
migrationBuilder.DropTable(
name: "referral_qrcodes");
migrationBuilder.DropTable(
name: "referral_team_edges");
migrationBuilder.DropTable(
name: "tenant_commission_settings");
migrationBuilder.DropTable(
name: "commission_settlements");
migrationBuilder.DropTable(
name: "referral_tracks");
migrationBuilder.DropTable(
name: "referral_leads");
}
}
}

1370
Tiku.Infrastructure/Persistence/Migrations/TikuDbContextModelSnapshot.cs
View File

File diff suppressed because it is too large Load Diff

12
Tiku.Infrastructure/Persistence/TikuDbContext.cs
View File

@@ -3,6 +3,7 @@ using Tiku.Domain.Catalog;
using Tiku.Domain.Commerce; using Tiku.Domain.Commerce;
using Tiku.Domain.Common; using Tiku.Domain.Common;
using Tiku.Domain.Content; using Tiku.Domain.Content;
using Tiku.Domain.Growth;
using Tiku.Domain.Identity; using Tiku.Domain.Identity;
using Tiku.Domain.Learning; using Tiku.Domain.Learning;
using Tiku.Domain.QuestionBanks; using Tiku.Domain.QuestionBanks;
@@ -91,6 +92,17 @@ public sealed class TikuDbContext(DbContextOptions<TikuDbContext> options) : DbC
public DbSet<TenantPaymentAccount> TenantPaymentAccounts => Set<TenantPaymentAccount>(); public DbSet<TenantPaymentAccount> TenantPaymentAccounts => Set<TenantPaymentAccount>();
public DbSet<TenantSubscription> TenantSubscriptions => Set<TenantSubscription>(); public DbSet<TenantSubscription> TenantSubscriptions => Set<TenantSubscription>();
public DbSet<TenantUsageRecord> TenantUsageRecords => Set<TenantUsageRecord>(); public DbSet<TenantUsageRecord> TenantUsageRecords => Set<TenantUsageRecord>();
public DbSet<ReferralTrack> ReferralTracks => Set<ReferralTrack>();
public DbSet<ReferralCode> ReferralCodes => Set<ReferralCode>();
public DbSet<ReferralLead> ReferralLeads => Set<ReferralLead>();
public DbSet<ReferralTeamEdge> ReferralTeamEdges => Set<ReferralTeamEdge>();
public DbSet<ReferralQrcode> ReferralQrcodes => Set<ReferralQrcode>();
public DbSet<CrmConfig> CrmConfigs => Set<CrmConfig>();
public DbSet<CrmWebhookQueueItem> CrmWebhookQueue => Set<CrmWebhookQueueItem>();
public DbSet<CrmWebhookLog> CrmWebhookLogs => Set<CrmWebhookLog>();
public DbSet<TenantCommissionSetting> TenantCommissionSettings => Set<TenantCommissionSetting>();
public DbSet<CommissionSettlement> CommissionSettlements => Set<CommissionSettlement>();
public DbSet<CommissionSettlementItem> CommissionSettlementItems => Set<CommissionSettlementItem>();
protected override void OnModelCreating(ModelBuilder modelBuilder) protected override void OnModelCreating(ModelBuilder modelBuilder)
{ {

85
Tiku.IntegrationTests/PersistenceModelTests.cs
View File

@@ -3,6 +3,7 @@ using Microsoft.EntityFrameworkCore.Infrastructure;
using Microsoft.EntityFrameworkCore.Metadata; using Microsoft.EntityFrameworkCore.Metadata;
using Tiku.Domain.Commerce; using Tiku.Domain.Commerce;
using Tiku.Domain.Content; using Tiku.Domain.Content;
using Tiku.Domain.Growth;
using Tiku.Domain.Learning; using Tiku.Domain.Learning;
using Tiku.Domain.QuestionBanks; using Tiku.Domain.QuestionBanks;
using Tiku.Domain.Tenancy; using Tiku.Domain.Tenancy;
@@ -26,7 +27,7 @@ public sealed class PersistenceModelTests
.Select(entity => entity.GetTableName()) .Select(entity => entity.GetTableName())
.ToHashSet(StringComparer.Ordinal); .ToHashSet(StringComparer.Ordinal);
Assert.Equal(79, tableNames.Count); Assert.Equal(90, tableNames.Count);
Assert.Contains("tenants", tableNames); Assert.Contains("tenants", tableNames);
Assert.Contains("tenant_settings", tableNames); Assert.Contains("tenant_settings", tableNames);
Assert.Contains("content_entries", tableNames); Assert.Contains("content_entries", tableNames);
@@ -84,6 +85,17 @@ public sealed class PersistenceModelTests
Assert.Contains("tenant_payment_accounts", tableNames); Assert.Contains("tenant_payment_accounts", tableNames);
Assert.Contains("tenant_subscriptions", tableNames); Assert.Contains("tenant_subscriptions", tableNames);
Assert.Contains("tenant_usage_records", tableNames); Assert.Contains("tenant_usage_records", tableNames);
Assert.Contains("referral_tracks", tableNames);
Assert.Contains("referral_codes", tableNames);
Assert.Contains("referral_leads", tableNames);
Assert.Contains("referral_team_edges", tableNames);
Assert.Contains("referral_qrcodes", tableNames);
Assert.Contains("crm_config", tableNames);
Assert.Contains("crm_webhook_queue", tableNames);
Assert.Contains("crm_webhook_log", tableNames);
Assert.Contains("tenant_commission_settings", tableNames);
Assert.Contains("commission_settlements", tableNames);
Assert.Contains("commission_settlement_items", tableNames);
Assert.Contains("questions", tableNames); Assert.Contains("questions", tableNames);
Assert.Contains("question_versions", tableNames); Assert.Contains("question_versions", tableNames);
Assert.Contains("answer_records", tableNames); Assert.Contains("answer_records", tableNames);
@@ -503,4 +515,75 @@ public sealed class PersistenceModelTests
.SequenceEqual(propertyNames)); .SequenceEqual(propertyNames));
} }
} }
[Theory]
[InlineData(typeof(ReferralTrack), nameof(ReferralTrack.Metadata), "'{}'::jsonb")]
[InlineData(typeof(ReferralCode), nameof(ReferralCode.Metadata), "'{}'::jsonb")]
[InlineData(typeof(ReferralLead), nameof(ReferralLead.Metadata), "'{}'::jsonb")]
[InlineData(typeof(ReferralTeamEdge), nameof(ReferralTeamEdge.Metadata), "'{}'::jsonb")]
[InlineData(typeof(ReferralQrcode), nameof(ReferralQrcode.Metadata), "'{}'::jsonb")]
[InlineData(typeof(CrmConfig), nameof(CrmConfig.AssignmentPool), "'[]'::jsonb")]
[InlineData(typeof(CrmConfig), nameof(CrmConfig.AssignmentConfig), "'{}'::jsonb")]
[InlineData(typeof(CrmWebhookQueueItem), nameof(CrmWebhookQueueItem.Payload), "'{}'::jsonb")]
[InlineData(typeof(CrmWebhookLog), nameof(CrmWebhookLog.RequestPayload), "'{}'::jsonb")]
[InlineData(typeof(TenantCommissionSetting), nameof(TenantCommissionSetting.Config), "'{}'::jsonb")]
[InlineData(typeof(CommissionSettlement), nameof(CommissionSettlement.Metadata), "'{}'::jsonb")]
[InlineData(typeof(CommissionSettlementItem), nameof(CommissionSettlementItem.Metadata), "'{}'::jsonb")]
public void Growth_json_properties_are_mapped_to_jsonb(
Type entityType,
string propertyName,
string expectedDefaultValueSql)
{
using var context = new TikuDbContext(Options);
var property = context.Model.FindEntityType(entityType)!
.FindProperty(propertyName)!;
Assert.Equal("jsonb", property.GetColumnType());
Assert.Equal(expectedDefaultValueSql, property.GetDefaultValueSql());
Assert.Equal(typeof(System.Text.Json.JsonElement), property.ClrType);
}
[Fact]
public void Growth_tables_have_expected_unique_indexes_and_decimal_precision()
{
using var context = new TikuDbContext(Options);
AssertHasUniqueIndex<ReferralCode>(nameof(ReferralCode.TenantId), nameof(ReferralCode.Code));
AssertHasUniqueIndex<ReferralLead>(nameof(ReferralLead.TenantId), nameof(ReferralLead.StudentUserId));
AssertHasUniqueIndex<CrmConfig>(nameof(CrmConfig.TenantId));
AssertHasUniqueIndex<CrmWebhookQueueItem>(nameof(CrmWebhookQueueItem.TenantId), nameof(CrmWebhookQueueItem.IdempotencyKey));
AssertHasUniqueIndex<CommissionSettlement>(
nameof(CommissionSettlement.TenantId),
nameof(CommissionSettlement.SettlementNo));
AssertHasUniqueIndex<CommissionSettlementItem>(
nameof(CommissionSettlementItem.TenantId),
nameof(CommissionSettlementItem.SourceType),
nameof(CommissionSettlementItem.SourceId));
AssertPrecision<TenantCommissionSetting>(nameof(TenantCommissionSetting.DefaultRate), 6, 4);
AssertPrecision<CommissionSettlement>(nameof(CommissionSettlement.DefaultRate), 6, 4);
AssertPrecision<CommissionSettlementItem>(nameof(CommissionSettlementItem.CommissionRate), 6, 4);
void AssertHasUniqueIndex<TEntity>(params string[] propertyNames)
{
var indexes = context.Model.FindEntityType(typeof(TEntity))!.GetIndexes();
Assert.Contains(
indexes,
index => index.IsUnique
&& index.Properties
.Select(property => property.Name)
.SequenceEqual(propertyNames));
}
void AssertPrecision<TEntity>(string propertyName, int precision, int scale)
{
var property = context.Model.FindEntityType(typeof(TEntity))!
.FindProperty(propertyName)!;
Assert.Equal(precision, property.GetPrecision());
Assert.Equal(scale, property.GetScale());
}
}
} }