feat(product): add product label management backend

src/Infrastructure/TakeoutSaaS.Infrastructure/App/Persistence/TakeoutAppDbContext.cs

@@ -213,6 +213,14 @@ public sealed class TakeoutAppDbContext(
     /// </summary>
     public DbSet<ProductSpecTemplateProduct> ProductSpecTemplateProducts => Set<ProductSpecTemplateProduct>();
     /// <summary>
+    /// 商品标签。
+    /// </summary>
+    public DbSet<ProductLabel> ProductLabels => Set<ProductLabel>();
+    /// <summary>
+    /// 标签与商品关联。
+    /// </summary>
+    public DbSet<ProductLabelProduct> ProductLabelProducts => Set<ProductLabelProduct>();
+    /// <summary>
     /// SKU 实体。
     /// </summary>
     public DbSet<ProductSku> ProductSkus => Set<ProductSku>();
@@ -456,6 +464,8 @@ public sealed class TakeoutAppDbContext(
         ConfigureProductSpecTemplate(modelBuilder.Entity<ProductSpecTemplate>());
         ConfigureProductSpecTemplateOption(modelBuilder.Entity<ProductSpecTemplateOption>());
         ConfigureProductSpecTemplateProduct(modelBuilder.Entity<ProductSpecTemplateProduct>());
+        ConfigureProductLabel(modelBuilder.Entity<ProductLabel>());
+        ConfigureProductLabelProduct(modelBuilder.Entity<ProductLabelProduct>());
         ConfigureProductSku(modelBuilder.Entity<ProductSku>());
         ConfigureProductAddonGroup(modelBuilder.Entity<ProductAddonGroup>());
         ConfigureProductAddonOption(modelBuilder.Entity<ProductAddonOption>());
@@ -1221,6 +1231,30 @@ public sealed class TakeoutAppDbContext(
         builder.HasIndex(x => new { x.TenantId, x.StoreId, x.ProductId });
     }
 
+    private static void ConfigureProductLabel(EntityTypeBuilder<ProductLabel> builder)
+    {
+        builder.ToTable("product_labels");
+        builder.HasKey(x => x.Id);
+        builder.Property(x => x.StoreId).IsRequired();
+        builder.Property(x => x.Name).HasMaxLength(64).IsRequired();
+        builder.Property(x => x.Color).HasMaxLength(32).IsRequired();
+        builder.Property(x => x.SortOrder).IsRequired();
+        builder.Property(x => x.IsEnabled).IsRequired();
+        builder.HasIndex(x => new { x.TenantId, x.StoreId, x.Name }).IsUnique();
+        builder.HasIndex(x => new { x.TenantId, x.StoreId, x.IsEnabled, x.SortOrder });
+    }
+
+    private static void ConfigureProductLabelProduct(EntityTypeBuilder<ProductLabelProduct> builder)
+    {
+        builder.ToTable("product_label_products");
+        builder.HasKey(x => x.Id);
+        builder.Property(x => x.StoreId).IsRequired();
+        builder.Property(x => x.LabelId).IsRequired();
+        builder.Property(x => x.ProductId).IsRequired();
+        builder.HasIndex(x => new { x.TenantId, x.StoreId, x.LabelId, x.ProductId }).IsUnique();
+        builder.HasIndex(x => new { x.TenantId, x.StoreId, x.ProductId });
+    }
+
     private static void ConfigureProductSku(EntityTypeBuilder<ProductSku> builder)
     {
         builder.ToTable("product_skus");

src/Infrastructure/TakeoutSaaS.Infrastructure/App/Repositories/EfProductRepository.cs

@@ -161,6 +161,17 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
             .ToListAsync(cancellationToken);
     }
 
+    /// <inheritdoc />
+    public async Task<IReadOnlyList<ProductLabel>> GetLabelsByStoreAsync(long tenantId, long storeId, CancellationToken cancellationToken = default)
+    {
+        return await context.ProductLabels
+            .AsNoTracking()
+            .Where(x => x.TenantId == tenantId && x.StoreId == storeId)
+            .OrderBy(x => x.SortOrder)
+            .ThenBy(x => x.Id)
+            .ToListAsync(cancellationToken);
+    }
+
     /// <inheritdoc />
     public Task<ProductSpecTemplate?> FindSpecTemplateByIdAsync(long templateId, long tenantId, CancellationToken cancellationToken = default)
     {
@@ -183,6 +194,14 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
             .FirstOrDefaultAsync(cancellationToken);
     }
 
+    /// <inheritdoc />
+    public Task<ProductLabel?> FindLabelByIdAsync(long labelId, long tenantId, CancellationToken cancellationToken = default)
+    {
+        return context.ProductLabels
+            .Where(x => x.TenantId == tenantId && x.Id == labelId)
+            .FirstOrDefaultAsync(cancellationToken);
+    }
+
     /// <inheritdoc />
     public Task<bool> ExistsSpecTemplateNameAsync(long tenantId, long storeId, string name, long? excludeTemplateId = null, CancellationToken cancellationToken = default)
     {
@@ -225,6 +244,26 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
         return query.AnyAsync(cancellationToken);
     }
 
+    /// <inheritdoc />
+    public Task<bool> ExistsLabelNameAsync(long tenantId, long storeId, string name, long? excludeLabelId = null, CancellationToken cancellationToken = default)
+    {
+        var normalizedName = (name ?? string.Empty).Trim();
+        var normalizedLower = normalizedName.ToLowerInvariant();
+        var query = context.ProductLabels
+            .AsNoTracking()
+            .Where(x =>
+                x.TenantId == tenantId &&
+                x.StoreId == storeId &&
+                x.Name.ToLower() == normalizedLower);
+
+        if (excludeLabelId.HasValue)
+        {
+            query = query.Where(x => x.Id != excludeLabelId.Value);
+        }
+
+        return query.AnyAsync(cancellationToken);
+    }
+
     /// <inheritdoc />
     public async Task<IReadOnlyList<ProductSpecTemplateOption>> GetSpecTemplateOptionsByTemplateIdsAsync(IReadOnlyCollection<long> templateIds, long tenantId, CancellationToken cancellationToken = default)
     {
@@ -260,6 +299,25 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
             .ToListAsync(cancellationToken);
     }
 
+    /// <inheritdoc />
+    public async Task<Dictionary<long, int>> CountLabelProductsByLabelIdsAsync(long tenantId, long storeId, IReadOnlyCollection<long> labelIds, CancellationToken cancellationToken = default)
+    {
+        if (labelIds.Count == 0)
+        {
+            return [];
+        }
+
+        return await context.ProductLabelProducts
+            .AsNoTracking()
+            .Where(x =>
+                x.TenantId == tenantId &&
+                x.StoreId == storeId &&
+                labelIds.Contains(x.LabelId))
+            .GroupBy(x => x.LabelId)
+            .Select(group => new { LabelId = group.Key, Count = group.Count() })
+            .ToDictionaryAsync(item => item.LabelId, item => item.Count, cancellationToken);
+    }
+
     /// <inheritdoc />
     public async Task<IReadOnlyList<long>> FilterExistingProductIdsAsync(long tenantId, long storeId, IReadOnlyCollection<long> productIds, CancellationToken cancellationToken = default)
     {
@@ -585,6 +643,12 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
         return context.ProductSpecTemplateProducts.AddRangeAsync(relations, cancellationToken);
     }
 
+    /// <inheritdoc />
+    public Task AddLabelAsync(ProductLabel label, CancellationToken cancellationToken = default)
+    {
+        return context.ProductLabels.AddAsync(label, cancellationToken).AsTask();
+    }
+
     /// <inheritdoc />
     public Task AddProductAsync(Product product, CancellationToken cancellationToken = default)
     {
@@ -673,6 +737,13 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
         return Task.CompletedTask;
     }
 
+    /// <inheritdoc />
+    public Task UpdateLabelAsync(ProductLabel label, CancellationToken cancellationToken = default)
+    {
+        context.ProductLabels.Update(label);
+        return Task.CompletedTask;
+    }
+
     /// <inheritdoc />
     public async Task DeleteCategoryAsync(long categoryId, long tenantId, CancellationToken cancellationToken = default)
     {
@@ -705,6 +776,23 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
             .ExecuteDeleteAsync(cancellationToken);
     }
 
+    /// <inheritdoc />
+    public async Task DeleteLabelAsync(long labelId, long tenantId, CancellationToken cancellationToken = default)
+    {
+        var existing = await context.ProductLabels
+            .Where(x => x.TenantId == tenantId && x.Id == labelId)
+            .FirstOrDefaultAsync(cancellationToken);
+
+        if (existing is null)
+        {
+            return;
+        }
+
+        await context.ProductLabels
+            .Where(x => x.TenantId == tenantId && x.Id == labelId)
+            .ExecuteDeleteAsync(cancellationToken);
+    }
+
     /// <inheritdoc />
     public async Task RemoveSkusAsync(long productId, long tenantId, CancellationToken cancellationToken = default)
     {
@@ -739,6 +827,17 @@ public sealed class EfProductRepository(TakeoutAppDbContext context) : IProductR
             .ExecuteDeleteAsync(cancellationToken);
     }
 
+    /// <inheritdoc />
+    public async Task RemoveLabelProductsAsync(long labelId, long tenantId, long storeId, CancellationToken cancellationToken = default)
+    {
+        await context.ProductLabelProducts
+            .Where(x =>
+                x.TenantId == tenantId &&
+                x.StoreId == storeId &&
+                x.LabelId == labelId)
+            .ExecuteDeleteAsync(cancellationToken);
+    }
+
     /// <inheritdoc />
     public async Task RemoveAddonGroupsAsync(long productId, long tenantId, CancellationToken cancellationToken = default)
     {

src/Infrastructure/TakeoutSaaS.Infrastructure/Migrations/20260221020356_AddProductLabels.cs

@@ -0,0 +1,96 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace TakeoutSaaS.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddProductLabels : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "product_label_products",
+                columns: table => new
+                {
+                    Id = table.Column<long>(type: "bigint", nullable: false, comment: "实体唯一标识。")
+                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+                    StoreId = table.Column<long>(type: "bigint", nullable: false, comment: "所属门店。"),
+                    LabelId = table.Column<long>(type: "bigint", nullable: false, comment: "标签 ID。"),
+                    ProductId = table.Column<long>(type: "bigint", nullable: false, comment: "商品 ID。"),
+                    CreatedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: false, comment: "创建时间（UTC）。"),
+                    UpdatedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: true, comment: "最近一次更新时间（UTC），从未更新时为 null。"),
+                    DeletedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: true, comment: "软删除时间（UTC），未删除时为 null。"),
+                    CreatedBy = table.Column<long>(type: "bigint", nullable: true, comment: "创建人用户标识，匿名或系统操作时为 null。"),
+                    UpdatedBy = table.Column<long>(type: "bigint", nullable: true, comment: "最后更新人用户标识，匿名或系统操作时为 null。"),
+                    DeletedBy = table.Column<long>(type: "bigint", nullable: true, comment: "删除人用户标识（软删除），未删除时为 null。"),
+                    TenantId = table.Column<long>(type: "bigint", nullable: false, comment: "所属租户 ID。")
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_product_label_products", x => x.Id);
+                },
+                comment: "标签与商品关联关系。");
+
+            migrationBuilder.CreateTable(
+                name: "product_labels",
+                columns: table => new
+                {
+                    Id = table.Column<long>(type: "bigint", nullable: false, comment: "实体唯一标识。")
+                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+                    StoreId = table.Column<long>(type: "bigint", nullable: false, comment: "所属门店。"),
+                    Name = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: false, comment: "标签名称。"),
+                    Color = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false, comment: "标签颜色（HEX）。"),
+                    SortOrder = table.Column<int>(type: "integer", nullable: false, comment: "排序值。"),
+                    IsEnabled = table.Column<bool>(type: "boolean", nullable: false, comment: "是否启用。"),
+                    CreatedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: false, comment: "创建时间（UTC）。"),
+                    UpdatedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: true, comment: "最近一次更新时间（UTC），从未更新时为 null。"),
+                    DeletedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: true, comment: "软删除时间（UTC），未删除时为 null。"),
+                    CreatedBy = table.Column<long>(type: "bigint", nullable: true, comment: "创建人用户标识，匿名或系统操作时为 null。"),
+                    UpdatedBy = table.Column<long>(type: "bigint", nullable: true, comment: "最后更新人用户标识，匿名或系统操作时为 null。"),
+                    DeletedBy = table.Column<long>(type: "bigint", nullable: true, comment: "删除人用户标识（软删除），未删除时为 null。"),
+                    TenantId = table.Column<long>(type: "bigint", nullable: false, comment: "所属租户 ID。")
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_product_labels", x => x.Id);
+                },
+                comment: "商品标签模板（门店维度）。");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_product_label_products_TenantId_StoreId_LabelId_ProductId",
+                table: "product_label_products",
+                columns: new[] { "TenantId", "StoreId", "LabelId", "ProductId" },
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_product_label_products_TenantId_StoreId_ProductId",
+                table: "product_label_products",
+                columns: new[] { "TenantId", "StoreId", "ProductId" });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_product_labels_TenantId_StoreId_IsEnabled_SortOrder",
+                table: "product_labels",
+                columns: new[] { "TenantId", "StoreId", "IsEnabled", "SortOrder" });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_product_labels_TenantId_StoreId_Name",
+                table: "product_labels",
+                columns: new[] { "TenantId", "StoreId", "Name" },
+                unique: true);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "product_label_products");
+
+            migrationBuilder.DropTable(
+                name: "product_labels");
+        }
+    }
+}

src/Infrastructure/TakeoutSaaS.Infrastructure/Migrations/TakeoutAppDbContextModelSnapshot.cs

@@ -4424,6 +4424,142 @@ namespace TakeoutSaaS.Infrastructure.Migrations
                         });
                 });
 
+            modelBuilder.Entity("TakeoutSaaS.Domain.Products.Entities.ProductLabel", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint")
+                        .HasComment("实体唯一标识。");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<string>("Color")
+                        .IsRequired()
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)")
+                        .HasComment("标签颜色（HEX）。");
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone")
+                        .HasComment("创建时间（UTC）。");
+
+                    b.Property<long?>("CreatedBy")
+                        .HasColumnType("bigint")
+                        .HasComment("创建人用户标识，匿名或系统操作时为 null。");
+
+                    b.Property<DateTime?>("DeletedAt")
+                        .HasColumnType("timestamp with time zone")
+                        .HasComment("软删除时间（UTC），未删除时为 null。");
+
+                    b.Property<long?>("DeletedBy")
+                        .HasColumnType("bigint")
+                        .HasComment("删除人用户标识（软删除），未删除时为 null。");
+
+                    b.Property<bool>("IsEnabled")
+                        .HasColumnType("boolean")
+                        .HasComment("是否启用。");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)")
+                        .HasComment("标签名称。");
+
+                    b.Property<int>("SortOrder")
+                        .HasColumnType("integer")
+                        .HasComment("排序值。");
+
+                    b.Property<long>("StoreId")
+                        .HasColumnType("bigint")
+                        .HasComment("所属门店。");
+
+                    b.Property<long>("TenantId")
+                        .HasColumnType("bigint")
+                        .HasComment("所属租户 ID。");
+
+                    b.Property<DateTime?>("UpdatedAt")
+                        .HasColumnType("timestamp with time zone")
+                        .HasComment("最近一次更新时间（UTC），从未更新时为 null。");
+
+                    b.Property<long?>("UpdatedBy")
+                        .HasColumnType("bigint")
+                        .HasComment("最后更新人用户标识，匿名或系统操作时为 null。");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("TenantId", "StoreId", "Name")
+                        .IsUnique();
+
+                    b.HasIndex("TenantId", "StoreId", "IsEnabled", "SortOrder");
+
+                    b.ToTable("product_labels", null, t =>
+                        {
+                            t.HasComment("商品标签模板（门店维度）。");
+                        });
+                });
+
+            modelBuilder.Entity("TakeoutSaaS.Domain.Products.Entities.ProductLabelProduct", b =>
+                {
+                    b.Property<long>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("bigint")
+                        .HasComment("实体唯一标识。");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone")
+                        .HasComment("创建时间（UTC）。");
+
+                    b.Property<long?>("CreatedBy")
+                        .HasColumnType("bigint")
+                        .HasComment("创建人用户标识，匿名或系统操作时为 null。");
+
+                    b.Property<DateTime?>("DeletedAt")
+                        .HasColumnType("timestamp with time zone")
+                        .HasComment("软删除时间（UTC），未删除时为 null。");
+
+                    b.Property<long?>("DeletedBy")
+                        .HasColumnType("bigint")
+                        .HasComment("删除人用户标识（软删除），未删除时为 null。");
+
+                    b.Property<long>("LabelId")
+                        .HasColumnType("bigint")
+                        .HasComment("标签 ID。");
+
+                    b.Property<long>("ProductId")
+                        .HasColumnType("bigint")
+                        .HasComment("商品 ID。");
+
+                    b.Property<long>("StoreId")
+                        .HasColumnType("bigint")
+                        .HasComment("所属门店。");
+
+                    b.Property<long>("TenantId")
+                        .HasColumnType("bigint")
+                        .HasComment("所属租户 ID。");
+
+                    b.Property<DateTime?>("UpdatedAt")
+                        .HasColumnType("timestamp with time zone")
+                        .HasComment("最近一次更新时间（UTC），从未更新时为 null。");
+
+                    b.Property<long?>("UpdatedBy")
+                        .HasColumnType("bigint")
+                        .HasComment("最后更新人用户标识，匿名或系统操作时为 null。");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("TenantId", "StoreId", "ProductId");
+
+                    b.HasIndex("TenantId", "StoreId", "LabelId", "ProductId")
+                        .IsUnique();
+
+                    b.ToTable("product_label_products", null, t =>
+                        {
+                            t.HasComment("标签与商品关联关系。");
+                        });
+                });
+
             modelBuilder.Entity("TakeoutSaaS.Domain.Products.Entities.ProductMediaAsset", b =>
                 {
                     b.Property<long>("Id")
@@ -4707,16 +4843,16 @@ namespace TakeoutSaaS.Infrastructure.Migrations
                         .HasColumnType("integer")
                         .HasComment("最大可选数。");
 
+                    b.Property<int>("MinSelect")
+                        .HasColumnType("integer")
+                        .HasComment("最小可选数。");
+
                     b.Property<string>("Name")
                         .IsRequired()
                         .HasMaxLength(64)
                         .HasColumnType("character varying(64)")
                         .HasComment("模板名称。");
 
-                    b.Property<int>("MinSelect")
-                        .HasColumnType("integer")
-                        .HasComment("最小可选数。");
-
                     b.Property<int>("SelectionType")
                         .HasColumnType("integer")
                         .HasComment("选择方式。");
@@ -4747,11 +4883,11 @@ namespace TakeoutSaaS.Infrastructure.Migrations
 
                     b.HasKey("Id");
 
+                    b.HasIndex("TenantId", "StoreId", "TemplateType", "IsEnabled");
+
                     b.HasIndex("TenantId", "StoreId", "TemplateType", "Name")
                         .IsUnique();
 
-                    b.HasIndex("TenantId", "StoreId", "TemplateType", "IsEnabled");
-
                     b.ToTable("product_spec_templates", null, t =>
                         {
                             t.HasComment("门店规格做法模板。");