docs: add xml comments and update ignore rules

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

@@ -36,107 +36,331 @@ public sealed class TakeoutAppDbContext(
     IIdGenerator? idGenerator = null)
     : TenantAwareDbContext(options, tenantProvider, currentUserAccessor, idGenerator)
 {
+    /// <summary>
+    /// 租户聚合根。
+    /// </summary>
     public DbSet<Tenant> Tenants => Set<Tenant>();
+    /// <summary>
+    /// 租户套餐。
+    /// </summary>
     public DbSet<TenantPackage> TenantPackages => Set<TenantPackage>();
+    /// <summary>
+    /// 租户订阅。
+    /// </summary>
     public DbSet<TenantSubscription> TenantSubscriptions => Set<TenantSubscription>();
+    /// <summary>
+    /// 租户订阅历史。
+    /// </summary>
     public DbSet<TenantSubscriptionHistory> TenantSubscriptionHistories => Set<TenantSubscriptionHistory>();
+    /// <summary>
+    /// 租户配额使用记录。
+    /// </summary>
     public DbSet<TenantQuotaUsage> TenantQuotaUsages => Set<TenantQuotaUsage>();
+    /// <summary>
+    /// 租户账单。
+    /// </summary>
     public DbSet<TenantBillingStatement> TenantBillingStatements => Set<TenantBillingStatement>();
+    /// <summary>
+    /// 租户通知。
+    /// </summary>
     public DbSet<TenantNotification> TenantNotifications => Set<TenantNotification>();
+    /// <summary>
+    /// 租户公告。
+    /// </summary>
     public DbSet<TenantAnnouncement> TenantAnnouncements => Set<TenantAnnouncement>();
+    /// <summary>
+    /// 租户公告已读记录。
+    /// </summary>
     public DbSet<TenantAnnouncementRead> TenantAnnouncementReads => Set<TenantAnnouncementRead>();
+    /// <summary>
+    /// 租户认证资料。
+    /// </summary>
     public DbSet<TenantVerificationProfile> TenantVerificationProfiles => Set<TenantVerificationProfile>();
+    /// <summary>
+    /// 租户审计日志。
+    /// </summary>
     public DbSet<TenantAuditLog> TenantAuditLogs => Set<TenantAuditLog>();
-
+    /// <summary>
+    /// 商户实体。
+    /// </summary>
     public DbSet<Merchant> Merchants => Set<Merchant>();
+    /// <summary>
+    /// 商户资质文件。
+    /// </summary>
     public DbSet<MerchantDocument> MerchantDocuments => Set<MerchantDocument>();
+    /// <summary>
+    /// 商户合同。
+    /// </summary>
     public DbSet<MerchantContract> MerchantContracts => Set<MerchantContract>();
+    /// <summary>
+    /// 商户员工。
+    /// </summary>
     public DbSet<MerchantStaff> MerchantStaff => Set<MerchantStaff>();
+    /// <summary>
+    /// 商户审计日志。
+    /// </summary>
     public DbSet<MerchantAuditLog> MerchantAuditLogs => Set<MerchantAuditLog>();
+    /// <summary>
+    /// 商户分类。
+    /// </summary>
     public DbSet<MerchantCategory> MerchantCategories => Set<MerchantCategory>();
-
+    /// <summary>
+    /// 门店实体。
+    /// </summary>
     public DbSet<Store> Stores => Set<Store>();
+    /// <summary>
+    /// 门店营业时间。
+    /// </summary>
     public DbSet<StoreBusinessHour> StoreBusinessHours => Set<StoreBusinessHour>();
+    /// <summary>
+    /// 门店节假日。
+    /// </summary>
     public DbSet<StoreHoliday> StoreHolidays => Set<StoreHoliday>();
+    /// <summary>
+    /// 门店配送区域。
+    /// </summary>
     public DbSet<StoreDeliveryZone> StoreDeliveryZones => Set<StoreDeliveryZone>();
+    /// <summary>
+    /// 门店桌台区域。
+    /// </summary>
     public DbSet<StoreTableArea> StoreTableAreas => Set<StoreTableArea>();
+    /// <summary>
+    /// 门店桌台。
+    /// </summary>
     public DbSet<StoreTable> StoreTables => Set<StoreTable>();
+    /// <summary>
+    /// 门店员工班次。
+    /// </summary>
     public DbSet<StoreEmployeeShift> StoreEmployeeShifts => Set<StoreEmployeeShift>();
+    /// <summary>
+    /// 自提配置。
+    /// </summary>
     public DbSet<StorePickupSetting> StorePickupSettings => Set<StorePickupSetting>();
+    /// <summary>
+    /// 自提时间段。
+    /// </summary>
     public DbSet<StorePickupSlot> StorePickupSlots => Set<StorePickupSlot>();
-
+    /// <summary>
+    /// 商品分类。
+    /// </summary>
     public DbSet<ProductCategory> ProductCategories => Set<ProductCategory>();
+    /// <summary>
+    /// 商品。
+    /// </summary>
     public DbSet<Product> Products => Set<Product>();
+    /// <summary>
+    /// 商品属性组。
+    /// </summary>
     public DbSet<ProductAttributeGroup> ProductAttributeGroups => Set<ProductAttributeGroup>();
+    /// <summary>
+    /// 商品属性项。
+    /// </summary>
     public DbSet<ProductAttributeOption> ProductAttributeOptions => Set<ProductAttributeOption>();
+    /// <summary>
+    /// SKU 实体。
+    /// </summary>
     public DbSet<ProductSku> ProductSkus => Set<ProductSku>();
+    /// <summary>
+    /// 加料分组。
+    /// </summary>
     public DbSet<ProductAddonGroup> ProductAddonGroups => Set<ProductAddonGroup>();
+    /// <summary>
+    /// 加料选项。
+    /// </summary>
     public DbSet<ProductAddonOption> ProductAddonOptions => Set<ProductAddonOption>();
+    /// <summary>
+    /// 定价规则。
+    /// </summary>
     public DbSet<ProductPricingRule> ProductPricingRules => Set<ProductPricingRule>();
+    /// <summary>
+    /// 商品媒体资源。
+    /// </summary>
     public DbSet<ProductMediaAsset> ProductMediaAssets => Set<ProductMediaAsset>();
-
+    /// <summary>
+    /// 库存项目。
+    /// </summary>
     public DbSet<InventoryItem> InventoryItems => Set<InventoryItem>();
+    /// <summary>
+    /// 库存调整记录。
+    /// </summary>
     public DbSet<InventoryAdjustment> InventoryAdjustments => Set<InventoryAdjustment>();
+    /// <summary>
+    /// 库存批次。
+    /// </summary>
     public DbSet<InventoryBatch> InventoryBatches => Set<InventoryBatch>();
+    /// <summary>
+    /// 库存锁定记录。
+    /// </summary>
     public DbSet<InventoryLockRecord> InventoryLockRecords => Set<InventoryLockRecord>();
-
+    /// <summary>
+    /// 购物车。
+    /// </summary>
     public DbSet<ShoppingCart> ShoppingCarts => Set<ShoppingCart>();
+    /// <summary>
+    /// 购物车明细。
+    /// </summary>
     public DbSet<CartItem> CartItems => Set<CartItem>();
+    /// <summary>
+    /// 购物车加料。
+    /// </summary>
     public DbSet<CartItemAddon> CartItemAddons => Set<CartItemAddon>();
+    /// <summary>
+    /// 结账会话。
+    /// </summary>
     public DbSet<CheckoutSession> CheckoutSessions => Set<CheckoutSession>();
-
+    /// <summary>
+    /// 订单聚合。
+    /// </summary>
     public DbSet<Order> Orders => Set<Order>();
+    /// <summary>
+    /// 订单明细。
+    /// </summary>
     public DbSet<OrderItem> OrderItems => Set<OrderItem>();
+    /// <summary>
+    /// 订单状态流转。
+    /// </summary>
     public DbSet<OrderStatusHistory> OrderStatusHistories => Set<OrderStatusHistory>();
+    /// <summary>
+    /// 退款申请。
+    /// </summary>
     public DbSet<RefundRequest> RefundRequests => Set<RefundRequest>();
-
+    /// <summary>
+    /// 支付记录。
+    /// </summary>
     public DbSet<PaymentRecord> PaymentRecords => Set<PaymentRecord>();
+    /// <summary>
+    /// 支付退款记录。
+    /// </summary>
     public DbSet<PaymentRefundRecord> PaymentRefundRecords => Set<PaymentRefundRecord>();
-
+    /// <summary>
+    /// 预订记录。
+    /// </summary>
     public DbSet<Reservation> Reservations => Set<Reservation>();
+    /// <summary>
+    /// 排号记录。
+    /// </summary>
     public DbSet<QueueTicket> QueueTickets => Set<QueueTicket>();
-
+    /// <summary>
+    /// 配送订单。
+    /// </summary>
     public DbSet<DeliveryOrder> DeliveryOrders => Set<DeliveryOrder>();
+    /// <summary>
+    /// 配送事件。
+    /// </summary>
     public DbSet<DeliveryEvent> DeliveryEvents => Set<DeliveryEvent>();
-
+    /// <summary>
+    /// 团购订单。
+    /// </summary>
     public DbSet<GroupOrder> GroupOrders => Set<GroupOrder>();
+    /// <summary>
+    /// 团购参与者。
+    /// </summary>
     public DbSet<GroupParticipant> GroupParticipants => Set<GroupParticipant>();
-
+    /// <summary>
+    /// 优惠券模板。
+    /// </summary>
     public DbSet<CouponTemplate> CouponTemplates => Set<CouponTemplate>();
+    /// <summary>
+    /// 优惠券实例。
+    /// </summary>
     public DbSet<Coupon> Coupons => Set<Coupon>();
+    /// <summary>
+    /// 营销活动。
+    /// </summary>
     public DbSet<PromotionCampaign> PromotionCampaigns => Set<PromotionCampaign>();
-
+    /// <summary>
+    /// 会员档案。
+    /// </summary>
     public DbSet<MemberProfile> MemberProfiles => Set<MemberProfile>();
+    /// <summary>
+    /// 会员等级。
+    /// </summary>
     public DbSet<MemberTier> MemberTiers => Set<MemberTier>();
+    /// <summary>
+    /// 积分流水。
+    /// </summary>
     public DbSet<MemberPointLedger> MemberPointLedgers => Set<MemberPointLedger>();
+    /// <summary>
+    /// 成长值日志。
+    /// </summary>
     public DbSet<MemberGrowthLog> MemberGrowthLogs => Set<MemberGrowthLog>();
-
+    /// <summary>
+    /// 会话记录。
+    /// </summary>
     public DbSet<ChatSession> ChatSessions => Set<ChatSession>();
+    /// <summary>
+    /// 会话消息。
+    /// </summary>
     public DbSet<ChatMessage> ChatMessages => Set<ChatMessage>();
+    /// <summary>
+    /// 工单记录。
+    /// </summary>
     public DbSet<SupportTicket> SupportTickets => Set<SupportTicket>();
+    /// <summary>
+    /// 工单评论。
+    /// </summary>
     public DbSet<TicketComment> TicketComments => Set<TicketComment>();
-
+    /// <summary>
+    /// 分销合作伙伴。
+    /// </summary>
     public DbSet<AffiliatePartner> AffiliatePartners => Set<AffiliatePartner>();
+    /// <summary>
+    /// 分销订单。
+    /// </summary>
     public DbSet<AffiliateOrder> AffiliateOrders => Set<AffiliateOrder>();
+    /// <summary>
+    /// 分销结算。
+    /// </summary>
     public DbSet<AffiliatePayout> AffiliatePayouts => Set<AffiliatePayout>();
-
+    /// <summary>
+    /// 打卡活动。
+    /// </summary>
     public DbSet<CheckInCampaign> CheckInCampaigns => Set<CheckInCampaign>();
+    /// <summary>
+    /// 打卡记录。
+    /// </summary>
     public DbSet<CheckInRecord> CheckInRecords => Set<CheckInRecord>();
+    /// <summary>
+    /// 社区帖子。
+    /// </summary>
     public DbSet<CommunityPost> CommunityPosts => Set<CommunityPost>();
+    /// <summary>
+    /// 社区评论。
+    /// </summary>
     public DbSet<CommunityComment> CommunityComments => Set<CommunityComment>();
+    /// <summary>
+    /// 社区互动。
+    /// </summary>
     public DbSet<CommunityReaction> CommunityReactions => Set<CommunityReaction>();
-
+    /// <summary>
+    /// 地图位置。
+    /// </summary>
     public DbSet<MapLocation> MapLocations => Set<MapLocation>();
+    /// <summary>
+    /// 导航请求。
+    /// </summary>
     public DbSet<NavigationRequest> NavigationRequests => Set<NavigationRequest>();
-
+    /// <summary>
+    /// 指标定义。
+    /// </summary>
     public DbSet<MetricDefinition> MetricDefinitions => Set<MetricDefinition>();
+    /// <summary>
+    /// 指标快照。
+    /// </summary>
     public DbSet<MetricSnapshot> MetricSnapshots => Set<MetricSnapshot>();
+    /// <summary>
+    /// 告警规则。
+    /// </summary>
     public DbSet<MetricAlertRule> MetricAlertRules => Set<MetricAlertRule>();
-
+    /// <summary>
+    /// 配置实体映射关系。
+    /// </summary>
+    /// <param name="modelBuilder">模型构建器。</param>
     protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
+        // 1. 调用基类配置
         base.OnModelCreating(modelBuilder);
-
+        // 2. 配置全部实体映射
         ConfigureTenant(modelBuilder.Entity<Tenant>());
         ConfigureMerchant(modelBuilder.Entity<Merchant>());
         ConfigureStore(modelBuilder.Entity<Store>());