@axova/shared 1.0.0

package/src/schemas/product/product-schema.ts

@@ -0,0 +1,955 @@
+import { createId } from "@paralleldrive/cuid2";
+import {
+	boolean,
+	decimal,
+	index,
+	integer,
+	jsonb,
+	pgEnum,
+	pgTable,
+	text,
+	timestamp,
+	unique,
+	varchar,
+} from "drizzle-orm/pg-core";
+
+// =====================================================
+// ENUMS
+// =====================================================
+
+export const productStatusEnum = pgEnum("product_status", [
+	"DRAFT",
+	"ACTIVE",
+	"INACTIVE",
+	"ARCHIVED",
+	"OUT_OF_STOCK",
+]);
+
+export const productTypeEnum = pgEnum("product_type", [
+	"PHYSICAL",
+	"DIGITAL",
+	"SERVICE",
+	"SUBSCRIPTION",
+	"BUNDLE",
+	"WHOLESALE",
+]);
+
+export const inventoryPolicyEnum = pgEnum("inventory_policy", [
+	"TRACK", // Track inventory
+	"CONTINUE", // Continue selling when out of stock
+	"DENY", // Stop selling when out of stock
+]);
+
+export const fulfillmentServiceEnum = pgEnum("fulfillment_service", [
+	"MANUAL",
+	"AUTOMATED",
+	"THIRD_PARTY",
+	"DROPSHIPPING",
+]);
+
+export const collectionTypeEnum = pgEnum("collection_type", [
+	"MANUAL", // Manually curated
+	"AUTOMATIC", // Rule-based automatic
+	"SMART", // AI-powered smart collections
+]);
+
+export const discountTypeEnum = pgEnum("discount_type", [
+	"PERCENTAGE",
+	"FIXED_AMOUNT",
+	"FREE_SHIPPING",
+	"BOGO", // Buy one get one
+]);
+
+export const variantOptionTypeEnum = pgEnum("variant_option_type", [
+	"COLOR",
+	"SIZE",
+	"MATERIAL",
+	"STYLE",
+	"WEIGHT",
+	"VOLUME",
+	"CUSTOM",
+]);
+
+export const salesChannelEnum = pgEnum("sales_channel", [
+	"POS",
+	"MARKETPLACE",
+	"STOREFRONT",
+]);
+
+// =====================================================
+// CORE PRODUCT TABLE
+// =====================================================
+
+export const products = pgTable(
+	"products",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+
+		// Basic Information
+		title: varchar("title", { length: 255 }).notNull(),
+		description: text("description"),
+		shortDescription: varchar("short_description", { length: 500 }),
+		handle: varchar("handle", { length: 255 }).notNull(), // URL-friendly slug
+
+		// Product Classification
+		productType: productTypeEnum("product_type").notNull().default("PHYSICAL"),
+		vendor: varchar("vendor", { length: 255 }),
+		supplierId: text("supplier_id"),
+		category: varchar("category", { length: 255 }),
+		subcategory: varchar("subcategory", { length: 255 }),
+		tags: jsonb("tags").$type<string[]>().default([]),
+
+		// Product Specifics
+		features: jsonb("features").$type<string[]>().default([]),
+		specifications: jsonb("specifications")
+			.$type<Array<{ name: string; value: string }>>()
+			.default([]),
+
+	// Additional Product Fields
+	unitOfMeasure: varchar("unit_of_measure", { length: 50 }), // e.g., "piece", "kg", "liter", "box"
+	countryOfOrigin: varchar("country_of_origin", { length: 100 }), // Country where product is manufactured
+	hsCode: varchar("hs_code", { length: 20 }), // Harmonized System code for customs
+	returnable: boolean("returnable").notNull().default(true), // Whether product can be returned
+	weightUnit: varchar("weight_unit", { length: 10 }).default("kg"), // kg, lb, oz, g
+
+	// Status and Visibility
+		status: productStatusEnum("status").notNull().default("DRAFT"),
+		isPublished: boolean("is_published").notNull().default(false),
+		publishedAt: timestamp("published_at", { withTimezone: true }),
+		isFeatured: boolean("is_featured").notNull().default(false),
+
+	// Sales Channels - Control where product is available
+	salesChannels: jsonb("sales_channels")
+		.$type<("POS" | "MARKETPLACE" | "STOREFRONT")[]>()
+		.notNull()
+		.default(["POS", "MARKETPLACE", "STOREFRONT"]),
+	
+	// Advanced Sales Channel Configuration
+	salesChannelConfig: jsonb("sales_channel_config")
+		.$type<{
+			POS?: {
+				enabled: boolean;
+				pricing?: { type: "default" | "custom"; customPrice?: number };
+				availability?: { allLocations: boolean; specificLocations?: string[] };
+			};
+			MARKETPLACE?: {
+				enabled: boolean;
+				platforms?: string[]; // e.g., ["amazon", "ebay", "etsy"]
+				pricing?: { type: "default" | "custom"; customPrice?: number };
+				syncInventory?: boolean;
+			};
+			STOREFRONT?: {
+				enabled: boolean;
+				featured?: boolean;
+				pricing?: { type: "default" | "custom"; customPrice?: number };
+				visibility?: "public" | "private" | "members-only";
+			};
+		}>()
+		.default({}),
+
+		// Pricing (in cents for precision)
+		basePrice: decimal("base_price", { precision: 12, scale: 2 }).notNull(),
+		compareAtPrice: decimal("compare_at_price", { precision: 12, scale: 2 }),
+		costPerItem: decimal("cost_per_item", { precision: 12, scale: 2 }),
+
+		// Wholesale Pricing
+		wholesalePrice: decimal("wholesale_price", { precision: 12, scale: 2 }),
+		minWholesaleQuantity: integer("min_wholesale_quantity").default(1),
+		maxWholesaleQuantity: integer("max_wholesale_quantity"),
+		wholesaleEnabled: boolean("wholesale_enabled").notNull().default(false),
+
+	// Inventory Management
+	inventoryPolicy: inventoryPolicyEnum("inventory_policy")
+		.notNull()
+		.default("TRACK"),
+	inventoryQuantity: integer("inventory_quantity").notNull().default(0),
+	inventoryTrackingEnabled: boolean("inventory_tracking_enabled")
+		.notNull()
+		.default(true),
+	trackStock: boolean("track_stock").notNull().default(false),
+	stockLocationId: text("stock_location_id"), // POS location or warehouse ID
+	stockLocationType: varchar("stock_location_type", { length: 20 }), // "POS" or "WAREHOUSE"
+	lowStockThreshold: integer("low_stock_threshold").default(10),
+	allowBackorders: boolean("allow_backorders").notNull().default(false),
+	
+	// Advanced Inventory Tracking Features
+	autoReorder: boolean("auto_reorder").notNull().default(false), // Automatic reorder when stock is low
+	batchTracking: boolean("batch_tracking").notNull().default(false), // Track products by batch/lot number
+	serialTracking: boolean("serial_tracking").notNull().default(false), // Track individual serial numbers
+	expiryTracking: boolean("expiry_tracking").notNull().default(false), // Track expiry dates
+
+		// Physical Properties
+		weight: decimal("weight", { precision: 8, scale: 3 }), // in kg
+		dimensions: jsonb("dimensions").$type<{
+			length?: number;
+			width?: number;
+			height?: number;
+			unit?: "cm" | "in";
+		}>(),
+
+		// Shipping and Fulfillment
+		requiresShipping: boolean("requires_shipping").notNull().default(true),
+		fulfillmentService: fulfillmentServiceEnum("fulfillment_service")
+			.notNull()
+			.default("MANUAL"),
+		shippingClass: varchar("shipping_class", { length: 100 }),
+
+		// SEO and Marketing
+		seoTitle: varchar("seo_title", { length: 255 }),
+		seoDescription: varchar("seo_description", { length: 500 }),
+		seoKeywords: jsonb("seo_keywords").$type<string[]>().default([]),
+		metaFields: jsonb("meta_fields")
+			.$type<Record<string, unknown>>()
+			.default({}),
+
+		// Advanced Features
+		customFields: jsonb("custom_fields")
+			.$type<Record<string, unknown>>()
+			.default({}),
+		variantOptions: jsonb("variant_options")
+			.$type<
+				Array<{
+					name: string;
+					type: string;
+					values: string[];
+					displayType: "dropdown" | "color" | "button" | "swatch";
+				}>
+			>()
+			.default([]),
+
+		// Analytics and Performance
+		totalViews: integer("total_views").notNull().default(0),
+		totalSales: integer("total_sales").notNull().default(0),
+		totalRevenue: decimal("total_revenue", { precision: 12, scale: 2 })
+			.notNull()
+			.default("0"),
+		conversionRate: decimal("conversion_rate", { precision: 5, scale: 4 }),
+		averageRating: decimal("average_rating", { precision: 3, scale: 2 }),
+		reviewCount: integer("review_count").notNull().default(0),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		deletedAt: timestamp("deleted_at", { withTimezone: true }),
+	},
+	(table) => ({
+		// Performance indexes
+		storeIdIndex: index("idx_products_store_id").on(table.storeId),
+		handleUniquePerStore: unique("idx_products_handle_store_unique").on(
+			table.storeId,
+			table.handle,
+		),
+		statusIndex: index("idx_products_status").on(table.status),
+		publishedIndex: index("idx_products_published").on(
+			table.isPublished,
+			table.publishedAt,
+		),
+		featuredIndex: index("idx_products_featured").on(table.isFeatured),
+		categoryIndex: index("idx_products_category").on(table.category),
+		vendorIndex: index("idx_products_vendor").on(table.vendor),
+
+		// Analytics indexes
+		salesIndex: index("idx_products_sales").on(table.totalSales),
+		revenueIndex: index("idx_products_revenue").on(table.totalRevenue),
+		ratingIndex: index("idx_products_rating").on(table.averageRating),
+
+		// Search indexes
+		titleIndex: index("idx_products_title").on(table.title),
+		fullTextSearch: index("idx_products_search").on(
+			table.title,
+			table.description,
+			table.tags,
+		),
+
+		// Inventory indexes
+		inventoryIndex: index("idx_products_inventory").on(table.inventoryQuantity),
+		lowStockIndex: index("idx_products_low_stock").on(
+			table.inventoryQuantity,
+			table.lowStockThreshold,
+		),
+		trackStockIndex: index("idx_products_track_stock").on(table.trackStock),
+		stockLocationIndex: index("idx_products_stock_location").on(
+			table.stockLocationId,
+			table.stockLocationType,
+		),
+
+		// Sales channel index
+		salesChannelsIndex: index("idx_products_sales_channels").on(
+			table.salesChannels,
+		),
+	}),
+);
+
+// =====================================================
+// PRODUCT VARIANTS TABLE
+// =====================================================
+
+export const productVariants = pgTable(
+	"product_variants",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		productId: text("product_id")
+			.notNull()
+			.references(() => products.id, { onDelete: "cascade" }),
+		storeId: text("store_id").notNull(),
+
+		// Variant Identification
+		title: varchar("title", { length: 255 }).notNull(),
+		compareAtPrice: decimal("compare_at_price", { precision: 12, scale: 2 }),
+
+		// Pricing (in cents)
+		price: decimal("price", { precision: 12, scale: 2 }).notNull(),
+		costPerItem: decimal("cost_per_item", { precision: 12, scale: 2 }),
+
+		// Inventory
+		inventoryQuantity: integer("inventory_quantity").notNull().default(0),
+		inventoryItemId: text("inventory_item_id"), // Reference to inventory system
+		fulfillmentService: fulfillmentServiceEnum("fulfillment_service")
+			.notNull()
+			.default("MANUAL"),
+
+		// Physical Properties
+		weight: decimal("weight", { precision: 8, scale: 3 }),
+		dimensions: jsonb("dimensions").$type<{
+			length?: number;
+			width?: number;
+			height?: number;
+			unit?: "cm" | "in";
+		}>(),
+
+		// Variant Options (e.g., color: red, size: large)
+		option1: varchar("option1", { length: 255 }),
+		option2: varchar("option2", { length: 255 }),
+		option3: varchar("option3", { length: 255 }),
+		optionValues: jsonb("option_values")
+			.$type<Record<string, string>>()
+			.default({}),
+
+		// Status and Availability
+		availableForSale: boolean("available_for_sale").notNull().default(true),
+		requiresShipping: boolean("requires_shipping").notNull().default(true),
+
+		// Sales Channels - Control where variant is available (inherits from product if not set)
+		salesChannels: jsonb("sales_channels")
+			.$type<("POS" | "MARKETPLACE" | "STOREFRONT")[]>()
+			.default(["POS", "MARKETPLACE", "STOREFRONT"]),
+
+
+		// Media
+		imageId: text("image_id"), // Primary image for this variant
+		imageUrl: varchar("image_url", { length: 500 }),
+		imageAltText: varchar("image_alt_text", { length: 255 }),
+
+		// Advanced Features
+		customFields: jsonb("custom_fields")
+			.$type<Record<string, unknown>>()
+			.default({}),
+		taxCode: varchar("tax_code", { length: 50 }),
+
+		// Analytics
+		totalSales: integer("total_sales").notNull().default(0),
+		totalRevenue: decimal("total_revenue", { precision: 12, scale: 2 })
+			.notNull()
+			.default("0"),
+
+		// Position for ordering
+		position: integer("position").notNull().default(0),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		// Performance indexes
+		productIdIndex: index("idx_variants_product_id").on(table.productId),
+		storeIdIndex: index("idx_variants_store_id").on(table.storeId),
+		priceIndex: index("idx_variants_price").on(table.price),
+		inventoryIndex: index("idx_variants_inventory").on(table.inventoryQuantity),
+		availableIndex: index("idx_variants_available").on(table.availableForSale),
+		positionIndex: index("idx_variants_position").on(
+			table.productId,
+			table.position,
+		),
+
+		// Option indexes for filtering
+		option1Index: index("idx_variants_option1").on(table.option1),
+		option2Index: index("idx_variants_option2").on(table.option2),
+		option3Index: index("idx_variants_option3").on(table.option3),
+
+		// Sales channel index
+		salesChannelsIndex: index("idx_variants_sales_channels").on(
+			table.salesChannels,
+		),
+	}),
+);
+
+// =====================================================
+// COLLECTIONS TABLE
+// =====================================================
+
+export const collections = pgTable(
+	"collections",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+
+		// Basic Information
+		title: varchar("title", { length: 255 }).notNull(),
+		description: text("description"),
+		handle: varchar("handle", { length: 255 }).notNull(),
+
+		// Collection Type and Rules
+		collectionType: collectionTypeEnum("collection_type")
+			.notNull()
+			.default("MANUAL"),
+		rules: jsonb("rules")
+			.$type<
+				Array<{
+					field: string;
+					relation:
+					| "equals"
+					| "not_equals"
+					| "contains"
+					| "starts_with"
+					| "ends_with"
+					| "greater_than"
+					| "less_than";
+					condition: string;
+				}>
+			>()
+			.default([]),
+
+
+		// SEO and Marketing
+		seoTitle: varchar("seo_title", { length: 255 }),
+		seoDescription: varchar("seo_description", { length: 500 }),
+		seoKeywords: jsonb("seo_keywords").$type<string[]>().default([]),
+
+		// Media
+		imageUrl: varchar("image_url", { length: 500 }),
+		imageAltText: varchar("image_alt_text", { length: 255 }),
+
+		// Display and Sorting
+		sortOrder: varchar("sort_order", { length: 50 }).default("manual"), // manual, best-selling, created, price-asc, price-desc
+		isPublished: boolean("is_published").notNull().default(false),
+		publishedAt: timestamp("published_at", { withTimezone: true }),
+
+		// Advanced Features
+		customFields: jsonb("custom_fields")
+			.$type<Record<string, unknown>>()
+			.default({}),
+		templateSuffix: varchar("template_suffix", { length: 100 }),
+
+		// Analytics
+		totalProducts: integer("total_products").notNull().default(0),
+		totalViews: integer("total_views").notNull().default(0),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		// Performance indexes
+		storeIdIndex: index("idx_collections_store_id").on(table.storeId),
+		handleUniquePerStore: unique("idx_collections_handle_store_unique").on(
+			table.storeId,
+			table.handle,
+		),
+		typeIndex: index("idx_collections_type").on(table.collectionType),
+		publishedIndex: index("idx_collections_published").on(
+			table.isPublished,
+			table.publishedAt,
+		),
+		titleIndex: index("idx_collections_title").on(table.title),
+	}),
+);
+
+// =====================================================
+// PRODUCT COLLECTIONS JUNCTION TABLE
+// =====================================================
+
+export const productCollections = pgTable(
+	"product_collections",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		productId: text("product_id")
+			.notNull()
+			.references(() => products.id, { onDelete: "cascade" }),
+		collectionId: text("collection_id")
+			.notNull()
+			.references(() => collections.id, { onDelete: "cascade" }),
+		position: integer("position").notNull().default(0),
+		isManuallyAdded: boolean("is_manually_added").notNull().default(false),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		// Unique constraint to prevent duplicates
+		productCollectionUnique: unique("idx_product_collection_unique").on(
+			table.productId,
+			table.collectionId,
+		),
+		productIdIndex: index("idx_product_collections_product").on(
+			table.productId,
+		),
+		collectionIdIndex: index("idx_product_collections_collection").on(
+			table.collectionId,
+		),
+		positionIndex: index("idx_product_collections_position").on(
+			table.collectionId,
+			table.position,
+		),
+	}),
+);
+
+// =====================================================
+// PRODUCT IMAGES TABLE
+// =====================================================
+
+export const productImages = pgTable(
+	"product_images",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		productId: text("product_id")
+			.notNull()
+			.references(() => products.id, { onDelete: "cascade" }),
+		variantId: text("variant_id").references(() => productVariants.id, {
+			onDelete: "set null",
+		}),
+
+		// Image Information
+		url: varchar("url", { length: 500 }).notNull(),
+		altText: varchar("alt_text", { length: 255 }),
+		width: integer("width"),
+		height: integer("height"),
+		size: integer("size"), // File size in bytes
+
+		// Image Variants (different sizes)
+		thumbnailUrl: varchar("thumbnail_url", { length: 500 }),
+		mediumUrl: varchar("medium_url", { length: 500 }),
+		largeUrl: varchar("large_url", { length: 500 }),
+
+		// Metadata
+		filename: varchar("filename", { length: 255 }),
+		contentType: varchar("content_type", { length: 100 }),
+		position: integer("position").notNull().default(0),
+
+		// Advanced Features
+		isMain: boolean("is_main").notNull().default(false),
+		customFields: jsonb("custom_fields")
+			.$type<Record<string, unknown>>()
+			.default({}),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		// Performance indexes
+		productIdIndex: index("idx_product_images_product").on(table.productId),
+		variantIdIndex: index("idx_product_images_variant").on(table.variantId),
+		positionIndex: index("idx_product_images_position").on(
+			table.productId,
+			table.position,
+		),
+		mainImageIndex: index("idx_product_images_main").on(
+			table.productId,
+			table.isMain,
+		),
+	}),
+);
+
+// =====================================================
+// PRODUCT CATEGORIES TABLE
+// =====================================================
+
+export const productCategories = pgTable(
+	"product_categories",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+
+		// Category Information
+		name: varchar("name", { length: 255 }).notNull(),
+		description: text("description"),
+		handle: varchar("handle", { length: 255 }).notNull(),
+
+		// Hierarchy
+		parentId: text("parent_id"),
+		level: integer("level").notNull().default(0),
+		path: varchar("path", { length: 1000 }), // e.g., /electronics/phones/smartphones
+
+		// Display
+		imageUrl: varchar("image_url", { length: 500 }),
+		iconUrl: varchar("icon_url", { length: 500 }),
+		position: integer("position").notNull().default(0),
+		isVisible: boolean("is_visible").notNull().default(true),
+
+		// SEO
+		seoTitle: varchar("seo_title", { length: 255 }),
+		seoDescription: varchar("seo_description", { length: 500 }),
+
+		// Analytics
+		productCount: integer("product_count").notNull().default(0),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		// Performance indexes
+		storeIdIndex: index("idx_categories_store_id").on(table.storeId),
+		handleUniquePerStore: unique("idx_categories_handle_store_unique").on(
+			table.storeId,
+			table.handle,
+		),
+		parentIdIndex: index("idx_categories_parent").on(table.parentId),
+		levelIndex: index("idx_categories_level").on(table.level),
+		visibleIndex: index("idx_categories_visible").on(table.isVisible),
+		positionIndex: index("idx_categories_position").on(
+			table.parentId,
+			table.position,
+		),
+	}),
+);
+
+// =====================================================
+// PRODUCT REVIEWS TABLE
+// =====================================================
+
+export const productReviews = pgTable(
+	"product_reviews",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		productId: text("product_id")
+			.notNull()
+			.references(() => products.id, { onDelete: "cascade" }),
+		variantId: text("variant_id").references(() => productVariants.id, {
+			onDelete: "set null",
+		}),
+		storeId: text("store_id").notNull(),
+
+		// Review Information
+		customerId: text("customer_id"), // Customer who wrote the review
+		customerName: varchar("customer_name", { length: 255 }),
+		customerEmail: varchar("customer_email", { length: 255 }),
+
+		// Review Content
+		title: varchar("title", { length: 255 }),
+		content: text("content").notNull(),
+		rating: integer("rating").notNull(), // 1-5 scale
+
+		// Status and Moderation
+		status: varchar("status", { length: 50 }).notNull().default("pending"), // pending, approved, rejected
+		isVerifiedPurchase: boolean("is_verified_purchase")
+			.notNull()
+			.default(false),
+		isRecommended: boolean("is_recommended"),
+
+		// Helpfulness
+		helpfulCount: integer("helpful_count").notNull().default(0),
+		unhelpfulCount: integer("unhelpful_count").notNull().default(0),
+
+		// Metadata
+		reviewSource: varchar("review_source", { length: 100 }), // web, mobile, import
+		ipAddress: varchar("ip_address", { length: 45 }),
+		userAgent: varchar("user_agent", { length: 500 }),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		moderatedAt: timestamp("moderated_at", { withTimezone: true }),
+	},
+	(table) => ({
+		// Performance indexes
+		productIdIndex: index("idx_reviews_product").on(table.productId),
+		storeIdIndex: index("idx_reviews_store").on(table.storeId),
+		customerIdIndex: index("idx_reviews_customer").on(table.customerId),
+		statusIndex: index("idx_reviews_status").on(table.status),
+		ratingIndex: index("idx_reviews_rating").on(table.rating),
+		verifiedIndex: index("idx_reviews_verified").on(table.isVerifiedPurchase),
+		createdAtIndex: index("idx_reviews_created").on(table.createdAt),
+	}),
+);
+
+// =====================================================
+// PRODUCT ANALYTICS TABLE
+// =====================================================
+
+export const productAnalytics = pgTable(
+	"product_analytics",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		productId: text("product_id")
+			.notNull()
+			.references(() => products.id, { onDelete: "cascade" }),
+		storeId: text("store_id").notNull(),
+
+		// Time-based metrics
+		date: timestamp("date", { withTimezone: true }).notNull(),
+		hour: integer("hour"), // 0-23 for hourly analytics
+
+		// Traffic Metrics
+		views: integer("views").notNull().default(0),
+		uniqueViews: integer("unique_views").notNull().default(0),
+		sessions: integer("sessions").notNull().default(0),
+		bounceRate: decimal("bounce_rate", { precision: 5, scale: 4 }),
+
+		// Conversion Metrics
+		addToCarts: integer("add_to_carts").notNull().default(0),
+		purchases: integer("purchases").notNull().default(0),
+		revenue: decimal("revenue", { precision: 12, scale: 2 })
+			.notNull()
+			.default("0"),
+		conversionRate: decimal("conversion_rate", { precision: 5, scale: 4 }),
+
+		// Engagement Metrics
+		averageTimeOnPage: integer("average_time_on_page"), // in seconds
+		clickThroughRate: decimal("click_through_rate", { precision: 5, scale: 4 }),
+		shareCount: integer("share_count").notNull().default(0),
+		wishlistAdds: integer("wishlist_adds").notNull().default(0),
+
+		// Search and Discovery
+		searchImpressions: integer("search_impressions").notNull().default(0),
+		searchClicks: integer("search_clicks").notNull().default(0),
+		searchRanking: decimal("search_ranking", { precision: 8, scale: 4 }),
+
+		// Geographic and Device Data
+		topCountries: jsonb("top_countries")
+			.$type<Array<{ country: string; views: number }>>()
+			.default([]),
+		topDevices: jsonb("top_devices")
+			.$type<Array<{ device: string; views: number }>>()
+			.default([]),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		// Performance indexes for analytics queries
+		productDateIndex: index("idx_analytics_product_date").on(
+			table.productId,
+			table.date,
+		),
+		storeIdIndex: index("idx_analytics_store").on(table.storeId),
+		dateIndex: index("idx_analytics_date").on(table.date),
+		hourlyIndex: index("idx_analytics_hourly").on(
+			table.productId,
+			table.date,
+			table.hour,
+		),
+		viewsIndex: index("idx_analytics_views").on(table.views),
+		revenueIndex: index("idx_analytics_revenue").on(table.revenue),
+		conversionIndex: index("idx_analytics_conversion").on(table.conversionRate),
+	}),
+);
+
+// =====================================================
+// WHOLESALE PRICING TIERS TABLE
+// =====================================================
+
+export const wholesalePricingTiers = pgTable(
+	"wholesale_pricing_tiers",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		productId: text("product_id")
+			.notNull()
+			.references(() => products.id, { onDelete: "cascade" }),
+		variantId: text("variant_id").references(() => productVariants.id, {
+			onDelete: "cascade",
+		}),
+		storeId: text("store_id").notNull(),
+
+		// Tier Information
+		tierName: varchar("tier_name", { length: 100 }).notNull(),
+		tierDescription: text("tier_description"),
+		tierPriority: integer("tier_priority").notNull().default(0), // Higher priority = applied first
+		minQuantity: integer("min_quantity").notNull(),
+		maxQuantity: integer("max_quantity"),
+		price: decimal("price", { precision: 12, scale: 2 }).notNull(),
+		discountPercentage: decimal("discount_percentage", {
+			precision: 5,
+			scale: 2,
+		}),
+
+		// Enhanced Tier Conditions
+		customerType: varchar("customer_type", { length: 50 }), // "RETAILER", "DISTRIBUTOR", "RESELLER", "VIP"
+		customerTags: jsonb("customer_tags").$type<string[]>().default([]), // Additional customer segmentation
+		region: varchar("region", { length: 100 }),
+		country: varchar("country", { length: 50 }),
+		currency: varchar("currency", { length: 3 }).default("USD"),
+		minimumOrderValue: decimal("minimum_order_value", {
+			precision: 12,
+			scale: 2,
+		}),
+
+		// Advanced Pricing Features
+		bulkDiscountType: varchar("bulk_discount_type", { length: 20 }).default(
+			"PERCENTAGE",
+		), // PERCENTAGE, FIXED_AMOUNT, TIERED
+		compoundDiscount: boolean("compound_discount").notNull().default(false), // Can be combined with other discounts
+		exclusiveDiscount: boolean("exclusive_discount").notNull().default(false), // Cannot be combined
+		maxDiscountAmount: decimal("max_discount_amount", {
+			precision: 12,
+			scale: 2,
+		}),
+
+		// Validity and Scheduling
+		validFrom: timestamp("valid_from", { withTimezone: true }),
+		validTo: timestamp("valid_to", { withTimezone: true }),
+		isActive: boolean("is_active").notNull().default(true),
+		isScheduled: boolean("is_scheduled").notNull().default(false),
+		scheduleStart: timestamp("schedule_start", { withTimezone: true }),
+		scheduleEnd: timestamp("schedule_end", { withTimezone: true }),
+
+		// Additional Features
+		freeShipping: boolean("free_shipping").notNull().default(false),
+		freeShippingThreshold: decimal("free_shipping_threshold", {
+			precision: 12,
+			scale: 2,
+		}),
+		expeditedShipping: boolean("expedited_shipping").notNull().default(false),
+		dropShippingEnabled: boolean("drop_shipping_enabled")
+			.notNull()
+			.default(false),
+
+		// Payment Terms
+		paymentTerms: varchar("payment_terms", { length: 50 }), // "NET_30", "NET_60", "COD", "PREPAID"
+		earlyPaymentDiscount: decimal("early_payment_discount", {
+			precision: 5,
+			scale: 2,
+		}),
+		latePaymentPenalty: decimal("late_payment_penalty", {
+			precision: 5,
+			scale: 2,
+		}),
+
+		// Inventory and Fulfillment
+		reservedInventory: integer("reserved_inventory").default(0),
+		autoReplenishment: boolean("auto_replenishment").notNull().default(false),
+		replenishmentThreshold: integer("replenishment_threshold"),
+		leadTimedays: integer("lead_time_days").default(0),
+
+		// Analytics and Tracking
+		totalOrdersCount: integer("total_orders_count").notNull().default(0),
+		totalRevenue: decimal("total_revenue", { precision: 12, scale: 2 })
+			.notNull()
+			.default("0"),
+		averageOrderValue: decimal("average_order_value", {
+			precision: 12,
+			scale: 2,
+		}),
+		lastUsedAt: timestamp("last_used_at", { withTimezone: true }),
+
+		// Custom Fields and Metadata
+		customFields: jsonb("custom_fields")
+			.$type<Record<string, unknown>>()
+			.default({}),
+		internalNotes: text("internal_notes"),
+		customerVisibleNotes: text("customer_visible_notes"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		// Performance indexes
+		productIdIndex: index("idx_wholesale_tiers_product").on(table.productId),
+		variantIdIndex: index("idx_wholesale_tiers_variant").on(table.variantId),
+		storeIdIndex: index("idx_wholesale_tiers_store").on(table.storeId),
+		quantityIndex: index("idx_wholesale_tiers_quantity").on(
+			table.minQuantity,
+			table.maxQuantity,
+		),
+		customerTypeIndex: index("idx_wholesale_tiers_customer_type").on(
+			table.customerType,
+		),
+		activeIndex: index("idx_wholesale_tiers_active").on(table.isActive),
+		validityIndex: index("idx_wholesale_tiers_validity").on(
+			table.validFrom,
+			table.validTo,
+		),
+
+		// Enhanced indexes for new features
+		priorityIndex: index("idx_wholesale_tiers_priority").on(table.tierPriority),
+		scheduledIndex: index("idx_wholesale_tiers_scheduled").on(
+			table.isScheduled,
+			table.scheduleStart,
+			table.scheduleEnd,
+		),
+		regionIndex: index("idx_wholesale_tiers_region").on(table.region),
+		countryIndex: index("idx_wholesale_tiers_country").on(table.country),
+		paymentTermsIndex: index("idx_wholesale_tiers_payment_terms").on(
+			table.paymentTerms,
+		),
+		revenueIndex: index("idx_wholesale_tiers_revenue").on(table.totalRevenue),
+		lastUsedIndex: index("idx_wholesale_tiers_last_used").on(table.lastUsedAt),
+
+		// Composite indexes for complex queries
+		activeScheduleIndex: index("idx_wholesale_tiers_active_schedule").on(
+			table.isActive,
+			table.isScheduled,
+			table.scheduleStart,
+		),
+		customerLocationIndex: index("idx_wholesale_tiers_customer_location").on(
+			table.customerType,
+			table.region,
+			table.country,
+		),
+	}),
+);