@axova/shared 1.0.0

package/src/schemas/inventory/inventory-tables.ts

@@ -0,0 +1,1927 @@
+import { createId } from "@paralleldrive/cuid2";
+import {
+	boolean,
+	decimal,
+	index,
+	integer,
+	jsonb,
+	pgEnum,
+	pgTable,
+	text,
+	timestamp,
+	unique,
+	varchar,
+} from "drizzle-orm/pg-core";
+import { z } from "zod";
+import {
+	AuditTrailSchema,
+	BusinessHoursSchema,
+	ContactInfoSchema,
+	CuidSchema,
+	GeoLocationSchema,
+} from "../common/common-schemas";
+
+// =====================================================
+// ENUMS
+// =====================================================
+
+export const inventoryLocationTypeEnum = pgEnum("inventory_location_type", [
+	"WAREHOUSE",
+	"POS",
+]);
+export const inventoryStatusEnum = pgEnum("inventory_status", [
+	"IN_STOCK",
+	"OUT_OF_STOCK",
+	"RESERVED",
+	"DAMAGED",
+	"IN_TRANSIT",
+	"QUARANTINED",
+	"RETURNED",
+	"EXPIRED",
+	"LOST",
+	"ADJUSTED",
+]);
+
+export const damageTypeEnum = pgEnum("damage_type", [
+	"PHYSICAL_DAMAGE",
+	"WATER_DAMAGE",
+	"FIRE_DAMAGE",
+	"MANUFACTURING_DEFECT",
+	"PACKAGING_DAMAGE",
+	"EXPIRED",
+	"CONTAMINATED",
+	"MISSING_PARTS",
+	"WRONG_ITEM",
+	"CUSTOMER_RETURN_DAMAGED",
+	"TRANSIT_DAMAGE",
+	"STORAGE_DAMAGE",
+	"THEFT_PARTIAL",
+	"OBSOLETE",
+	"OTHER",
+]);
+
+export const damageSeverityEnum = pgEnum("damage_severity", [
+	"MINOR",
+	"MODERATE",
+	"SEVERE",
+	"COSMETIC",
+]);
+
+export const movementTypeEnum = pgEnum("movement_type", [
+	"PURCHASE_RECEIPT",
+	"TRANSFER_IN",
+	"RETURN_FROM_CUSTOMER",
+	"PRODUCTION_COMPLETE",
+	"ADJUSTMENT_INCREASE",
+	"FOUND_INVENTORY",
+	"SALE",
+	"TRANSFER_OUT",
+	"RETURN_TO_SUPPLIER",
+	"DAMAGED_GOODS",
+	"EXPIRED_GOODS",
+	"THEFT_LOSS",
+	"ADJUSTMENT_DECREASE",
+	"WASTE",
+	"SAMPLE",
+	"PROMOTIONAL_USE",
+	"LOCATION_TRANSFER",
+	"ZONE_TRANSFER",
+	"BIN_TRANSFER",
+	"CYCLE_COUNT_ADJUSTMENT",
+	"PHYSICAL_COUNT_ADJUSTMENT",
+	"RESERVE",
+	"UNRESERVE",
+	"ALLOCATE",
+	"DEALLOCATE",
+	"MARK_DAMAGED",
+	"REPAIR_DAMAGED",
+	"DISPOSE_DAMAGED",
+	"QUARANTINE",
+	"RELEASE_QUARANTINE",
+	"STOCK_RECONCILIATION",
+]);
+
+export const movementStatusEnum = pgEnum("movement_status", [
+	"DRAFT",
+	"PENDING",
+	"IN_PROGRESS",
+	"COMPLETED",
+	"CANCELLED",
+	"FAILED",
+]);
+
+export const warehouseStatusEnum = pgEnum("warehouse_status", [
+	"ACTIVE",
+	"INACTIVE",
+	"CLOSED",
+]);
+export const warehouseTypeEnum = pgEnum("warehouse_type", [
+	"DISTRIBUTION_CENTER",
+	"FULFILLMENT_CENTER",
+	"COLD_STORAGE",
+	"BULK_STORAGE",
+	"CROSS_DOCK",
+	"RETAIL_WAREHOUSE",
+	"MANUFACTURING_WAREHOUSE",
+	"3PL_WAREHOUSE",
+]);
+
+// =====================================================
+// Zod Enums and Schemas (co-located for single-source-of-truth)
+// =====================================================
+
+export const POSLocationTypeEnum = z.enum([
+	"RETAIL",
+	"KIOSK",
+	"POPUP",
+	"OTHER",
+]);
+export const POSLocationStatusEnum = z.enum(["ACTIVE", "INACTIVE", "CLOSED"]);
+
+export const WarehouseStatusEnum = z.enum(["ACTIVE", "INACTIVE", "CLOSED"]);
+export const WarehouseTypeEnum = z.enum([
+	"DISTRIBUTION_CENTER",
+	"FULFILLMENT_CENTER",
+	"COLD_STORAGE",
+	"BULK_STORAGE",
+	"CROSS_DOCK",
+	"RETAIL_WAREHOUSE",
+	"MANUFACTURING_WAREHOUSE",
+	"3PL_WAREHOUSE",
+]);
+
+export const InventoryStatusEnum = z.enum([
+	"IN_STOCK",
+	"OUT_OF_STOCK",
+	"RESERVED",
+	"DAMAGED",
+	"IN_TRANSIT",
+	"QUARANTINED",
+	"RETURNED",
+	"EXPIRED",
+	"LOST",
+	"ADJUSTED",
+]);
+export const LocationTypeEnum = z.enum(["WAREHOUSE", "POS"]);
+
+export const InventoryTransferStatusEnum = z.enum([
+	"PENDING",
+	"IN_TRANSIT",
+	"COMPLETED",
+	"CANCELLED",
+	"FAILED",
+	"PARTIAL",
+	"RETURNED",
+]);
+export const InventoryTransferTypeEnum = z.enum([
+	"WAREHOUSE_TO_WAREHOUSE",
+	"WAREHOUSE_TO_POS",
+	"POS_TO_WAREHOUSE",
+	"POS_TO_POS",
+	"SUPPLIER_TO_WAREHOUSE",
+	"WAREHOUSE_TO_CUSTOMER",
+	"INTERNAL_TRANSFER",
+]);
+
+export const PurchaseOrderStatusEnum = z.enum([
+	"DRAFT",
+	"SENT",
+	"ACKNOWLEDGED",
+	"APPROVED",
+	"PENDING_APPROVAL",
+	"PARTIALLY_RECEIVED",
+	"RECEIVED",
+	"COMPLETED",
+	"CANCELLED",
+	"DISPUTED",
+]);
+
+export const SupplierStatusEnum = z.enum([
+	"ACTIVE",
+	"INACTIVE",
+	"SUSPENDED",
+	"UNDER_REVIEW",
+	"PENDING_APPROVAL",
+	"BLACKLISTED",
+]);
+export const SupplierTypeEnum = z.enum([
+	"MANUFACTURER",
+	"DISTRIBUTOR",
+	"WHOLESALER",
+	"DROPSHIPPER",
+	"SERVICE_PROVIDER",
+	"LOCAL_VENDOR",
+	"INTERNATIONAL_VENDOR",
+	"BROKER",
+	"IMPORTER",
+	"EXPORTER",
+	"RETAILER",
+	"RESELLER",
+	"CONTRACTOR",
+	"CONSULTANT",
+	"PARTS_SUPPLIER",
+	"RAW_MATERIALS_SUPPLIER",
+	"PACKAGING_SUPPLIER",
+	"EQUIPMENT_SUPPLIER",
+	"MAINTENANCE_SUPPLIER",
+	"LOGISTICS_PROVIDER",
+	"FREIGHT_FORWARDER",
+	"CUSTOMS_BROKER",
+	"TECHNOLOGY_VENDOR",
+	"SOFTWARE_VENDOR",
+	"HARDWARE_VENDOR",
+	"OFFICE_SUPPLIES_VENDOR",
+	"UTILITIES_PROVIDER",
+	"CLEANING_SERVICES",
+	"SECURITY_SERVICES",
+	"MARKETING_SERVICES",
+	"PROFESSIONAL_SERVICES",
+	"TEMPORARY_STAFFING",
+	"SPECIALIZED_SUPPLIER",
+	"OTHER",
+]);
+export const SupplierRatingEnum = z.enum([
+	"EXCELLENT",
+	"GOOD",
+	"AVERAGE",
+	"POOR",
+	"UNRATED",
+]);
+
+export const QualityStatusEnum = z.enum([
+	"PENDING_INSPECTION",
+	"PASSED",
+	"FAILED",
+	"CONDITIONALLY_PASSED",
+	"QUARANTINED",
+	"REJECTED",
+	"REWORK_REQUIRED",
+	"RELEASED",
+	"HOLD",
+]);
+export const InspectionTypeEnum = z.enum([
+	"INCOMING_INSPECTION",
+	"IN_PROCESS_INSPECTION",
+	"OUTGOING_INSPECTION",
+	"RANDOM_INSPECTION",
+	"CUSTOMER_COMPLAINT_INSPECTION",
+	"SUPPLIER_AUDIT",
+	"PERIODIC_REVIEW",
+	"EXPIRY_CHECK",
+	"DAMAGE_ASSESSMENT",
+]);
+export const QualityGradeEnum = z.enum(["A", "B", "C", "D", "F"]);
+export const DefectSeverityEnum = z.enum([
+	"CRITICAL",
+	"MAJOR",
+	"MINOR",
+	"COSMETIC",
+]);
+
+// Zod schemas for key resources
+export const InventorySchema = z.object({
+	id: CuidSchema,
+	storeId: z.string(),
+	productId: z.string(),
+	variantId: z.string().optional(),
+	sku: z.string(),
+	barcode: z.string(),
+	locationId: z.string(),
+	locationType: LocationTypeEnum,
+	quantity: z.number().int().nonnegative(),
+	reserved: z.number().int().nonnegative().optional(),
+	committed: z.number().int().nonnegative().optional(),
+	unitCost: z.number().nonnegative().optional(),
+	status: InventoryStatusEnum.default("IN_STOCK"),
+	batchNumber: z.string().optional(),
+	lotNumber: z.string().optional(),
+	expiryDate: z.coerce.date().optional(),
+	lowStockThreshold: z.number().int().nonnegative().optional(),
+	criticalStockThreshold: z.number().int().nonnegative().optional(),
+	available: z.number().int().nonnegative().default(0),
+	notes: z.string().optional(),
+	metadata: z.record(z.any()).optional(),
+	version: z.number().int().default(1),
+	isActive: z.boolean().default(true),
+	createdAt: z.date(),
+	updatedAt: z.date(),
+	createdBy: z.string().optional(),
+	updatedBy: z.string().optional(),
+});
+
+export const InventoryMovementSchema = z
+	.object({
+		id: CuidSchema,
+		storeId: z.string(),
+		movementNumber: z.string(),
+		movementType: z.enum([
+			"PURCHASE_RECEIPT",
+			"TRANSFER_IN",
+			"RETURN_FROM_CUSTOMER",
+			"PRODUCTION_COMPLETE",
+			"ADJUSTMENT_INCREASE",
+			"FOUND_INVENTORY",
+			"SALE",
+			"TRANSFER_OUT",
+			"RETURN_TO_SUPPLIER",
+			"DAMAGED_GOODS",
+			"EXPIRED_GOODS",
+			"THEFT_LOSS",
+			"ADJUSTMENT_DECREASE",
+			"WASTE",
+			"SAMPLE",
+			"PROMOTIONAL_USE",
+			"LOCATION_TRANSFER",
+			"ZONE_TRANSFER",
+			"BIN_TRANSFER",
+			"CYCLE_COUNT_ADJUSTMENT",
+			"PHYSICAL_COUNT_ADJUSTMENT",
+			"RESERVE",
+			"UNRESERVE",
+			"ALLOCATE",
+			"DEALLOCATE",
+		]),
+		status: z.enum([
+			"DRAFT",
+			"PENDING",
+			"IN_PROGRESS",
+			"COMPLETED",
+			"CANCELLED",
+			"FAILED",
+		]),
+		productId: z.string(),
+		variantId: z.string().optional(),
+		sku: z.string(),
+		quantityMoved: z.number(),
+		fromLocationId: z.string().optional(),
+		toLocationId: z.string().optional(),
+		unitCost: z.number().optional(),
+		reason: z.string().optional(),
+		movementDate: z.coerce.date(),
+		createdAt: z.date(),
+		updatedAt: z.date(),
+	})
+	.catchall(z.any());
+
+export const InventoryTransferSchema = z
+	.object({ id: CuidSchema })
+	.catchall(z.any());
+export const QualityControlSchema = z
+	.object({
+		id: CuidSchema,
+		qcNumber: z.string(),
+		inspectedBy: z.string(),
+		inspectionDate: z.date(),
+		createdAt: z.date(),
+		updatedAt: z.date(),
+	})
+	.catchall(z.any());
+export const QualityTemplateSchema = z
+	.object({
+		id: CuidSchema,
+		createdAt: z.date(),
+		updatedAt: z.date(),
+		createdBy: z.string().optional(),
+		updatedBy: z.string().optional(),
+	})
+	.catchall(z.any());
+export const SupplierQualityRatingSchema = z
+	.object({
+		id: CuidSchema,
+		reviewedBy: z.string().optional(),
+		reviewedAt: z.date().optional(),
+		createdAt: z.date(),
+		updatedAt: z.date(),
+	})
+	.catchall(z.any());
+
+export const POSLocationSchema = z.object({
+	id: CuidSchema,
+	storeId: z.string(),
+	code: z.string(),
+	name: z.string(),
+	displayName: z.string().optional(),
+	type: POSLocationTypeEnum,
+	posType: POSLocationTypeEnum.optional(),
+	status: POSLocationStatusEnum,
+	geoLocation: GeoLocationSchema,
+	address: z
+		.object({
+			street: z.string().optional(),
+			line1: z.string().optional(),
+			line2: z.string().optional(),
+			city: z.string(),
+			state: z.string(),
+			postalCode: z.string(),
+			country: z.string(),
+			coordinates: z.object({ lat: z.number(), lng: z.number() }).optional(),
+		})
+		.optional(),
+	timezone: z.string().default("UTC"),
+	primaryContact: ContactInfoSchema.optional(),
+	managementContacts: z.array(ContactInfoSchema).optional(),
+	emergencyContact: ContactInfoSchema.optional(),
+	businessHours: BusinessHoursSchema.optional(),
+	posSystemInfo: z
+		.object({
+			systemName: z.string().optional(),
+			version: z.string().optional(),
+			lastSync: z.coerce.date().optional(),
+			supportedPaymentMethods: z.array(z.string()).optional(),
+			isActive: z.boolean().default(true),
+		})
+		.optional(),
+	allowBackorders: z.boolean().default(false).optional(),
+	autoFulfillment: z.boolean().default(true).optional(),
+	supportedFeatures: z
+		.array(
+			z.enum([
+				"CASH_PAYMENT",
+				"CARD_PAYMENT",
+				"MOBILE_PAYMENT",
+				"GIFT_CARDS",
+				"LAYAWAY",
+				"RETURNS_EXCHANGES",
+				"PRODUCT_LOOKUP",
+				"INVENTORY_CHECK",
+				"CUSTOMER_ORDERS",
+				"RESERVATIONS",
+				"LOYALTY_PROGRAM",
+				"PROMOTIONS",
+				"TAX_CALCULATION",
+				"RECEIPT_PRINTING",
+				"EMAIL_RECEIPTS",
+				"BARCODE_SCANNING",
+				"PRICE_CHECKING",
+			]),
+		)
+		.optional(),
+	hardware: z
+		.array(
+			z.object({
+				id: z.string(),
+				type: z.enum([
+					"POS_TERMINAL",
+					"CASH_REGISTER",
+					"BARCODE_SCANNER",
+					"RECEIPT_PRINTER",
+					"CARD_READER",
+					"SCALE",
+					"SECURITY_CAMERA",
+					"CASH_DRAWER",
+					"DISPLAY_MONITOR",
+					"TABLET",
+				]),
+				brand: z.string().optional(),
+				model: z.string().optional(),
+				serialNumber: z.string().optional(),
+				status: z.enum(["ACTIVE", "MAINTENANCE", "INACTIVE"]),
+				lastMaintenance: z.coerce.date().optional(),
+			}),
+		)
+		.optional(),
+	inventorySettings: z
+		.object({
+			allowNegativeInventory: z.boolean().default(false),
+			autoReorderEnabled: z.boolean().default(false),
+			lowStockWarningEnabled: z.boolean().default(true),
+			stockCountRequired: z.boolean().default(false),
+			barcodeRequired: z.boolean().default(false),
+		})
+		.optional(),
+	salesSettings: z
+		.object({
+			taxRate: z.number().min(0).max(100).optional(),
+			taxExemptAvailable: z.boolean().default(false),
+			discountingEnabled: z.boolean().default(true),
+			maxDiscountPercent: z.number().min(0).max(100).optional(),
+			returnsEnabled: z.boolean().default(true),
+			returnDayLimit: z.number().int().nonnegative().optional(),
+			receiptRequired: z.boolean().default(true),
+		})
+		.optional(),
+	customerServices: z
+		.array(
+			z.enum([
+				"PERSONAL_SHOPPING",
+				"ALTERATIONS",
+				"GIFT_WRAPPING",
+				"DELIVERY",
+				"INSTALLATION",
+				"REPAIR_SERVICE",
+				"CONSULTATION",
+				"TRAINING",
+				"RENTAL",
+				"CUSTOM_ORDERS",
+			]),
+		)
+		.optional(),
+	operationalCosts: z
+		.object({
+			monthlyRent: z.number().nonnegative().optional(),
+			utilities: z.number().nonnegative().optional(),
+			labor: z.number().nonnegative().optional(),
+			maintenance: z.number().nonnegative().optional(),
+			insurance: z.number().nonnegative().optional(),
+			currency: z.string().length(3).default("USD"),
+		})
+		.optional(),
+	securityFeatures: z.array(z.string()).optional(),
+	complianceRequirements: z.array(z.string()).optional(),
+	lastSecurityAudit: z.coerce.date().optional(),
+	description: z.string().optional(),
+	notes: z.string().optional(),
+	internalNotes: z.string().optional(),
+	metadata: z.record(z.any()).optional(),
+	customAttributes: z.record(z.any()).optional(),
+	version: z.number().int().default(1),
+	isActive: z.boolean().default(true),
+	createdAt: z.date(),
+	updatedAt: z.date(),
+	createdBy: z.string().optional(),
+	updatedBy: z.string().optional(),
+	auditTrail: z.array(AuditTrailSchema).optional(),
+});
+
+export const WarehouseSchema = z.object({
+	id: CuidSchema,
+	storeId: z.string(),
+	code: z.string(),
+	name: z.string(),
+	displayName: z.string().optional(),
+	type: WarehouseTypeEnum,
+	status: WarehouseStatusEnum,
+	address: z
+		.object({
+			street: z.string(),
+			city: z.string(),
+			state: z.string(),
+			postalCode: z.string(),
+			country: z.string(),
+			coordinates: z.object({ lat: z.number(), lng: z.number() }).optional(),
+		})
+		.optional(),
+	timezone: z.string().default("UTC"),
+	primaryContact: z
+		.object({ name: z.string(), email: z.string(), phone: z.string() })
+		.optional(),
+	totalArea: z.number().nonnegative().optional(),
+	storageArea: z.number().nonnegative().optional(),
+	ceilingHeight: z.number().nonnegative().optional(),
+	capacity: z
+		.object({
+			volumetric: z.number().nonnegative().optional(),
+			weight: z.number().nonnegative().optional(),
+			palletPositions: z.number().int().nonnegative().optional(),
+			pickingLocations: z.number().int().nonnegative().optional(),
+			unit: z.string().optional(),
+		})
+		.optional(),
+	zones: z
+		.array(
+			z.object({
+				id: z.string(),
+				code: z.string(),
+				name: z.string(),
+				type: z.string(),
+				description: z.string().optional(),
+				capacity: z.number().nonnegative().optional(),
+				temperature: z
+					.object({ min: z.number(), max: z.number(), unit: z.string() })
+					.optional(),
+				humidity: z
+					.object({
+						min: z.number().min(0).max(100),
+						max: z.number().min(0).max(100),
+					})
+					.optional(),
+				binLocations: z
+					.array(
+						z.object({
+							id: z.string(),
+							code: z.string(),
+							row: z.string().optional(),
+							bay: z.string().optional(),
+							level: z.string().optional(),
+							capacity: z.number().nonnegative().optional(),
+							isActive: z.boolean().default(true),
+						}),
+					)
+					.optional(),
+				isActive: z.boolean().default(true),
+			}),
+		)
+		.optional(),
+	description: z.string().optional(),
+	notes: z.string().optional(),
+	internalNotes: z.string().optional(),
+	metadata: z.record(z.any()).optional(),
+	version: z.number().int().default(1),
+	isActive: z.boolean().default(true),
+	createdAt: z.date(),
+	updatedAt: z.date(),
+	createdBy: z.string().optional(),
+	updatedBy: z.string().optional(),
+	auditTrail: z.array(AuditTrailSchema).optional(),
+});
+
+// =====================================================
+// INVENTORY TABLE
+// =====================================================
+
+export const inventory = pgTable(
+	"inventory",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		productId: text("product_id").notNull(),
+		variantId: text("variant_id"),
+		sku: varchar("sku", { length: 255 }).notNull(),
+		barcode: varchar("barcode", { length: 255 }).notNull(),
+		locationId: text("location_id").notNull(),
+		locationType: inventoryLocationTypeEnum("location_type").notNull(),
+
+		// Zone and Bin Information
+		zoneId: text("zone_id"),
+		binLocation: varchar("bin_location", { length: 100 }),
+
+		// Batch and Serial Tracking
+		batchNumber: varchar("batch_number", { length: 255 }),
+		lotNumber: varchar("lot_number", { length: 255 }),
+		serialNumbers: jsonb("serial_numbers").$type<string[]>(),
+
+		// Quantity Management
+		quantity: integer("quantity").notNull().default(0),
+		reserved: integer("reserved").notNull().default(0),
+		available: integer("available").notNull().default(0),
+		committed: integer("committed").notNull().default(0),
+		inTransit: integer("in_transit").notNull().default(0),
+		onOrder: integer("on_order").notNull().default(0),
+
+		// Stock Level Management
+		reorderPoint: integer("reorder_point"),
+		maxStockLevel: integer("max_stock_level"),
+		safetyStock: integer("safety_stock").notNull().default(0),
+
+		// Unit of Measure
+		baseUnitId: text("base_unit_id").notNull(),
+		unitOfMeasure: varchar("unit_of_measure", { length: 50 })
+			.notNull()
+			.default("EACH"),
+
+		// Cost Information
+		unitCost: decimal("unit_cost", { precision: 12, scale: 4 }),
+		averageCost: decimal("average_cost", { precision: 12, scale: 4 }),
+		lastCost: decimal("last_cost", { precision: 12, scale: 4 }),
+		standardCost: decimal("standard_cost", { precision: 12, scale: 4 }),
+		costingMethod: varchar("costing_method", { length: 20 }),
+
+		// Status and Condition
+		status: inventoryStatusEnum("status").notNull().default("IN_STOCK"),
+		condition: varchar("condition", { length: 100 }),
+		qualityGrade: varchar("quality_grade", { length: 50 }),
+
+		// Date Information
+		expiryDate: timestamp("expiry_date", { withTimezone: true }),
+		manufactureDate: timestamp("manufacture_date", { withTimezone: true }),
+		receivedDate: timestamp("received_date", { withTimezone: true }),
+		lastCountedAt: timestamp("last_counted_at", { withTimezone: true }),
+		lastMovementDate: timestamp("last_movement_date", { withTimezone: true }),
+
+		// Supplier Information
+		supplierId: text("supplier_id"),
+		supplierSku: varchar("supplier_sku", { length: 255 }),
+
+		// Alert Thresholds
+		lowStockThreshold: integer("low_stock_threshold"),
+		criticalStockThreshold: integer("critical_stock_threshold"),
+		expiryWarningDays: integer("expiry_warning_days").notNull().default(30),
+
+		// Tracking Configuration
+		trackSerial: boolean("track_serial").notNull().default(false),
+		trackBatch: boolean("track_batch").notNull().default(false),
+		trackExpiry: boolean("track_expiry").notNull().default(false),
+
+		// Damaged Stock Tracking
+		damagedQuantity: integer("damaged_quantity").notNull().default(0),
+		damageType: damageTypeEnum("damage_type"),
+		damageSeverity: damageSeverityEnum("damage_severity"),
+		damageReason: text("damage_reason"),
+		damageValue: decimal("damage_value", { precision: 12, scale: 4 }),
+		damageDate: timestamp("damage_date", { withTimezone: true }),
+		damageReportedBy: text("damage_reported_by"),
+		damageNotes: text("damage_notes"),
+		isRepairable: boolean("is_repairable").notNull().default(false),
+		repairCost: decimal("repair_cost", { precision: 12, scale: 4 }),
+		disposalDate: timestamp("disposal_date", { withTimezone: true }),
+		disposalMethod: varchar("disposal_method", { length: 100 }),
+		insuranceClaim: jsonb("insurance_claim").$type<{
+			claimNumber?: string;
+			amount?: number;
+			status?: string;
+			filedDate?: string;
+			resolvedDate?: string;
+			notes?: string;
+		}>(),
+
+		// Quality Tracking
+		qualityScore: integer("quality_score"),
+		lastQualityCheck: timestamp("last_quality_check", { withTimezone: true }),
+
+		// Quarantine Tracking
+		quarantinedQuantity: integer("quarantined_quantity").notNull().default(0),
+		quarantineReason: text("quarantine_reason"),
+		quarantineDate: timestamp("quarantine_date", { withTimezone: true }),
+		quarantineReleaseDate: timestamp("quarantine_release_date", { withTimezone: true }),
+
+		// Multi-location Tracking
+		isVirtualLocation: boolean("is_virtual_location").notNull().default(false),
+		parentInventoryId: text("parent_inventory_id"),
+
+		// ABC Classification
+		abcClassification: varchar("abc_classification", { length: 1 }),
+
+		// Notes and Metadata
+		notes: text("notes"),
+		internalNotes: text("internal_notes"),
+		metadata: jsonb("metadata").$type<Record<string, any>>().default({}),
+		customAttributes: jsonb("custom_attributes")
+			.$type<Record<string, any>>()
+			.default({}),
+
+		// Version Control
+		version: integer("version").notNull().default(1),
+		isActive: boolean("is_active").notNull().default(true),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		// Performance indexes
+		storeIdIndex: index("idx_inventory_store_id").on(table.storeId),
+		productIdIndex: index("idx_inventory_product_id").on(table.productId),
+		locationIdIndex: index("idx_inventory_location_id").on(table.locationId),
+		skuIndex: index("idx_inventory_sku").on(table.sku),
+		barcodeIndex: index("idx_inventory_barcode").on(table.barcode),
+		statusIndex: index("idx_inventory_status").on(table.status),
+
+		// Unique constraints
+		uniqueProductLocation: unique("idx_inventory_product_location_unique").on(
+			table.storeId,
+			table.productId,
+			table.locationId,
+			table.variantId,
+		),
+		uniqueSkuBarcode: unique("idx_inventory_sku_barcode_unique").on(
+			table.storeId,
+			table.locationId,
+			table.sku,
+			table.barcode,
+		),
+
+		// Quantity and alerts indexes
+		quantityIndex: index("idx_inventory_quantity").on(table.quantity),
+		lowStockIndex: index("idx_inventory_low_stock").on(table.lowStockThreshold),
+		expiryIndex: index("idx_inventory_expiry").on(table.expiryDate),
+	}),
+);
+
+// =====================================================
+// INVENTORY MOVEMENTS TABLE
+// =====================================================
+
+export const inventoryMovements = pgTable(
+	"inventory_movements",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		movementNumber: varchar("movement_number", { length: 100 }).notNull(),
+
+		// Movement Classification
+		movementType: movementTypeEnum("movement_type").notNull(),
+		reason: varchar("reason", { length: 255 }),
+		status: movementStatusEnum("status").notNull().default("DRAFT"),
+
+		// Product Information
+		productId: text("product_id").notNull(),
+		variantId: text("variant_id"),
+		sku: varchar("sku", { length: 255 }).notNull(),
+		productName: varchar("product_name", { length: 255 }),
+
+		// Location Information
+		fromLocationId: text("from_location_id"),
+		fromLocationType: varchar("from_location_type", { length: 50 }),
+		fromZoneId: text("from_zone_id"),
+		fromBinLocation: varchar("from_bin_location", { length: 100 }),
+
+		toLocationId: text("to_location_id"),
+		toLocationType: varchar("to_location_type", { length: 50 }),
+		toZoneId: text("to_zone_id"),
+		toBinLocation: varchar("to_bin_location", { length: 100 }),
+
+		// Quantity Information
+		quantityMoved: integer("quantity_moved").notNull(),
+		unitOfMeasure: varchar("unit_of_measure", { length: 50 })
+			.notNull()
+			.default("EACH"),
+
+		// Batch and Serial Tracking
+		batchNumber: varchar("batch_number", { length: 255 }),
+		lotNumber: varchar("lot_number", { length: 255 }),
+		serialNumbers: jsonb("serial_numbers").$type<string[]>(),
+		expiryDate: timestamp("expiry_date", { withTimezone: true }),
+		manufacturingDate: timestamp("manufacturing_date", { withTimezone: true }),
+
+		// Cost Information
+		unitCost: decimal("unit_cost", { precision: 12, scale: 4 }),
+		totalCost: decimal("total_cost", { precision: 12, scale: 4 }),
+		costingMethod: varchar("costing_method", { length: 20 }),
+
+		// Reference Information
+		referenceType: varchar("reference_type", { length: 50 }),
+		referenceId: text("reference_id"),
+		referenceNumber: varchar("reference_number", { length: 100 }),
+
+		// Quality and Condition
+		conditionBefore: varchar("condition_before", { length: 100 }),
+		conditionAfter: varchar("condition_after", { length: 100 }),
+		qualityGrade: varchar("quality_grade", { length: 50 }),
+
+		// Date Information
+		movementDate: timestamp("movement_date", { withTimezone: true }).notNull(),
+		scheduledDate: timestamp("scheduled_date", { withTimezone: true }),
+		completedDate: timestamp("completed_date", { withTimezone: true }),
+
+		// Processing Information
+		processedBy: text("processed_by"),
+		approvedBy: text("approved_by"),
+		approvedAt: timestamp("approved_at", { withTimezone: true }),
+
+		// Notes
+		notes: text("notes"),
+		internalNotes: text("internal_notes"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		// Performance indexes
+		storeIdIndex: index("idx_movements_store_id").on(table.storeId),
+		productIdIndex: index("idx_movements_product_id").on(table.productId),
+		movementTypeIndex: index("idx_movements_type").on(table.movementType),
+		statusIndex: index("idx_movements_status").on(table.status),
+		movementDateIndex: index("idx_movements_date").on(table.movementDate),
+
+		// Unique movement number per store
+		uniqueMovementNumber: unique("idx_movements_number_unique").on(
+			table.storeId,
+			table.movementNumber,
+		),
+	}),
+);
+
+// =====================================================
+// WAREHOUSES TABLE
+// =====================================================
+
+export const warehouses = pgTable(
+	"warehouses",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		code: varchar("code", { length: 100 }).notNull(),
+		name: varchar("name", { length: 255 }).notNull(),
+		displayName: varchar("display_name", { length: 255 }),
+		type: warehouseTypeEnum("type").notNull(),
+		status: warehouseStatusEnum("status").notNull().default("ACTIVE"),
+
+		// Location Information
+		address: jsonb("address").$type<{
+			street: string;
+			city: string;
+			state: string;
+			postalCode: string;
+			country: string;
+			coordinates?: { lat: number; lng: number };
+		}>(),
+		timezone: varchar("timezone", { length: 50 }).notNull().default("UTC"),
+
+		// Contact Information
+		primaryContact: jsonb("primary_contact").$type<{
+			name: string;
+			email: string;
+			phone: string;
+		}>(),
+
+		// Physical Characteristics
+		totalArea: decimal("total_area", { precision: 10, scale: 2 }),
+		storageArea: decimal("storage_area", { precision: 10, scale: 2 }),
+		ceilingHeight: decimal("ceiling_height", { precision: 8, scale: 2 }),
+		numberOfDocks: integer("number_of_docks"),
+
+		// Capacity Management
+		capacity: jsonb("capacity").$type<{
+			volumetric?: number;
+			weight?: number;
+			palletPositions?: number;
+			pickingLocations?: number;
+			unit?: string;
+		}>(),
+
+		// Zone Configuration
+		zones: jsonb("zones")
+			.$type<
+				Array<{
+					id: string;
+					code: string;
+					name: string;
+					type: string;
+					description?: string;
+					capacity?: number;
+					temperature?: { min: number; max: number; unit: string };
+					humidity?: { min: number; max: number };
+					isActive: boolean;
+				}>
+			>()
+			.default([]),
+
+		// Notes and Metadata
+		description: text("description"),
+		notes: text("notes"),
+		internalNotes: text("internal_notes"),
+		metadata: jsonb("metadata").$type<Record<string, any>>().default({}),
+
+		// Version Control
+		version: integer("version").notNull().default(1),
+		isActive: boolean("is_active").notNull().default(true),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		// Performance indexes
+		storeIdIndex: index("idx_warehouses_store_id").on(table.storeId),
+		statusIndex: index("idx_warehouses_status").on(table.status),
+		typeIndex: index("idx_warehouses_type").on(table.type),
+
+		// Unique constraints
+		uniqueCodePerStore: unique("idx_warehouses_code_unique").on(
+			table.storeId,
+			table.code,
+		),
+	}),
+);
+
+// =====================================================
+// POS LOCATIONS TABLE
+// =====================================================
+
+export const posLocations = pgTable(
+	"pos_locations",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		code: varchar("code", { length: 100 }).notNull(),
+		name: varchar("name", { length: 255 }).notNull(),
+		displayName: varchar("display_name", { length: 255 }),
+		status: varchar("status", { length: 20 }).notNull().default("ACTIVE"),
+
+		// Location Information
+		// Keep simple address for backward compatibility
+		address: jsonb("address").$type<{
+			street: string;
+			city: string;
+			state: string;
+			postalCode: string;
+			country: string;
+			coordinates?: { lat: number; lng: number };
+		}>(),
+		// Advanced geo location object
+		geoLocation: jsonb("geo_location").$type<{
+			lat: number;
+			lng: number;
+			address?: {
+				line1: string;
+				line2?: string;
+				city: string;
+				state: string;
+				postalCode: string;
+				country: string;
+			};
+		}>(),
+		timezone: varchar("timezone", { length: 50 }).notNull().default("UTC"),
+
+		// Contact Information
+		primaryContact: jsonb("primary_contact").$type<{
+			name?: string;
+			email?: string;
+			phone?: string;
+			alternatePhone?: string;
+		}>(),
+		managementContacts: jsonb("management_contacts").$type<
+			Array<{
+				name?: string;
+				email?: string;
+				phone?: string;
+				alternatePhone?: string;
+			}>
+		>(),
+		emergencyContact: jsonb("emergency_contact").$type<{
+			name?: string;
+			email?: string;
+			phone?: string;
+		}>(),
+
+		// Business Hours
+		businessHours: jsonb("business_hours").$type<{
+			timezone?: string;
+			monday?: { open: string; close: string; closed?: boolean };
+			tuesday?: { open: string; close: string; closed?: boolean };
+			wednesday?: { open: string; close: string; closed?: boolean };
+			thursday?: { open: string; close: string; closed?: boolean };
+			friday?: { open: string; close: string; closed?: boolean };
+			saturday?: { open: string; close: string; closed?: boolean };
+			sunday?: { open: string; close: string; closed?: boolean };
+			holidays?: Array<{ date: string; name: string; closed?: boolean }>;
+		}>(),
+
+		// Physical Characteristics
+		floorArea: decimal("floor_area", { precision: 10, scale: 2 }),
+		storageArea: decimal("storage_area", { precision: 10, scale: 2 }),
+		customerArea: decimal("customer_area", { precision: 10, scale: 2 }),
+		numberOfRegister: integer("number_of_register"),
+		parkingSpaces: integer("parking_spaces"),
+
+		// POS Configuration
+		posType: varchar("pos_type", { length: 50 }).notNull().default("RETAIL"),
+		allowBackorders: boolean("allow_backorders").notNull().default(false),
+		autoFulfillment: boolean("auto_fulfillment").notNull().default(true),
+
+		// Equipment and Technology
+		posSystemInfo: jsonb("pos_system_info").$type<{
+			systemName?: string;
+			version?: string;
+			lastSync?: Date;
+			supportedPaymentMethods?: string[];
+			isActive?: boolean;
+		}>(),
+		supportedFeatures: jsonb("supported_features").$type<string[]>(),
+		hardware:
+			jsonb("hardware").$type<
+				Array<{
+					id: string;
+					type:
+					| "POS_TERMINAL"
+					| "CASH_REGISTER"
+					| "BARCODE_SCANNER"
+					| "RECEIPT_PRINTER"
+					| "CARD_READER"
+					| "SCALE"
+					| "SECURITY_CAMERA"
+					| "CASH_DRAWER"
+					| "DISPLAY_MONITOR"
+					| "TABLET";
+					brand?: string;
+					model?: string;
+					serialNumber?: string;
+					status: "ACTIVE" | "MAINTENANCE" | "INACTIVE";
+					lastMaintenance?: Date;
+				}>
+			>(),
+
+		// Inventory & Sales Configuration
+		inventorySettings: jsonb("inventory_settings").$type<{
+			allowNegativeInventory?: boolean;
+			autoReorderEnabled?: boolean;
+			lowStockWarningEnabled?: boolean;
+			stockCountRequired?: boolean;
+			barcodeRequired?: boolean;
+		}>(),
+		salesSettings: jsonb("sales_settings").$type<{
+			taxRate?: number;
+			taxExemptAvailable?: boolean;
+			discountingEnabled?: boolean;
+			maxDiscountPercent?: number;
+			returnsEnabled?: boolean;
+			returnDayLimit?: number;
+			receiptRequired?: boolean;
+		}>(),
+
+		// Customer Services
+		customerServices: jsonb("customer_services").$type<string[]>(),
+
+		// Financial Information
+		operationalCosts: jsonb("operational_costs").$type<{
+			monthlyRent?: number;
+			utilities?: number;
+			labor?: number;
+			maintenance?: number;
+			insurance?: number;
+			currency?: string;
+		}>(),
+
+		// Security and Compliance
+		securityFeatures: jsonb("security_features").$type<string[]>(),
+		complianceRequirements: jsonb("compliance_requirements").$type<string[]>(),
+		lastSecurityAudit: timestamp("last_security_audit", { withTimezone: true }),
+
+		// Notes and Metadata
+		description: text("description"),
+		notes: text("notes"),
+		internalNotes: text("internal_notes"),
+		metadata: jsonb("metadata").$type<Record<string, any>>().default({}),
+		customAttributes: jsonb("custom_attributes")
+			.$type<Record<string, any>>()
+			.default({}),
+
+		// Version Control
+		version: integer("version").notNull().default(1),
+		isActive: boolean("is_active").notNull().default(true),
+
+		// Timestamps & Audit
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+		auditTrail: jsonb("audit_trail").$type<Array<Record<string, any>>>(),
+	},
+	(table) => ({
+		// Performance indexes
+		storeIdIndex: index("idx_pos_locations_store_id").on(table.storeId),
+		statusIndex: index("idx_pos_locations_status").on(table.status),
+		posTypeIndex: index("idx_pos_locations_pos_type").on(table.posType),
+
+		// Unique constraints
+		uniqueCodePerStore: unique("idx_pos_locations_code_unique").on(
+			table.storeId,
+			table.code,
+		),
+	}),
+);
+
+// =====================================================
+// INVENTORY TRANSFERS TABLE
+// =====================================================
+
+export const inventoryTransferStatusEnum = pgEnum("inventory_transfer_status", [
+	"PENDING",
+	"IN_TRANSIT",
+	"COMPLETED",
+	"CANCELLED",
+	"FAILED",
+	"PARTIAL",
+	"RETURNED",
+]);
+
+export const inventoryTransferTypeEnum = pgEnum("inventory_transfer_type", [
+	"WAREHOUSE_TO_WAREHOUSE",
+	"WAREHOUSE_TO_POS",
+	"POS_TO_WAREHOUSE",
+	"POS_TO_POS",
+	"SUPPLIER_TO_WAREHOUSE",
+	"WAREHOUSE_TO_CUSTOMER",
+	"INTERNAL_TRANSFER",
+]);
+
+export const inventoryTransfers = pgTable(
+	"inventory_transfers",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		transferNumber: varchar("transfer_number", { length: 100 }).notNull(),
+
+		// Location Information
+		fromLocationId: text("from_location_id").notNull(),
+		fromLocationType: varchar("from_location_type", { length: 50 }).notNull(),
+		toLocationId: text("to_location_id").notNull(),
+		toLocationType: varchar("to_location_type", { length: 50 }).notNull(),
+
+		// Transfer Details
+		status: inventoryTransferStatusEnum("status").notNull().default("PENDING"),
+		transferType: inventoryTransferTypeEnum("transfer_type").notNull(),
+		priority: varchar("priority", { length: 20 }).notNull().default("NORMAL"),
+
+		// Shipping and Tracking
+		shippingMethod: varchar("shipping_method", { length: 100 }),
+		trackingNumber: varchar("tracking_number", { length: 100 }),
+		carrierName: varchar("carrier_name", { length: 100 }),
+
+		// Cost Information
+		shippingCost: decimal("shipping_cost", { precision: 12, scale: 4 }).default(
+			"0",
+		),
+		totalCost: decimal("total_cost", { precision: 12, scale: 4 }),
+		currency: varchar("currency", { length: 3 }).notNull().default("USD"),
+
+		// Date Management
+		requestedDate: timestamp("requested_date", { withTimezone: true }),
+		scheduledDate: timestamp("scheduled_date", { withTimezone: true }),
+		shippedDate: timestamp("shipped_date", { withTimezone: true }),
+		expectedDeliveryDate: timestamp("expected_delivery_date", {
+			withTimezone: true,
+		}),
+		actualDeliveryDate: timestamp("actual_delivery_date", {
+			withTimezone: true,
+		}),
+		initiatedAt: timestamp("initiated_at", { withTimezone: true }).notNull(),
+		completedAt: timestamp("completed_at", { withTimezone: true }),
+		cancelledAt: timestamp("cancelled_at", { withTimezone: true }),
+
+		// Authorization and Approval
+		requiresApproval: boolean("requires_approval").notNull().default(false),
+		approvedBy: text("approved_by"),
+		approvedAt: timestamp("approved_at", { withTimezone: true }),
+		rejectedBy: text("rejected_by"),
+		rejectedAt: timestamp("rejected_at", { withTimezone: true }),
+		rejectionReason: text("rejection_reason"),
+
+		// Document References
+		referenceOrderNumber: varchar("reference_order_number", { length: 100 }),
+		internalReference: varchar("internal_reference", { length: 100 }),
+		externalReference: varchar("external_reference", { length: 100 }),
+
+		// Quality Control
+		requiresInspection: boolean("requires_inspection").notNull().default(false),
+		inspectedBy: text("inspected_by"),
+		inspectedAt: timestamp("inspected_at", { withTimezone: true }),
+		qualityNotes: text("quality_notes"),
+
+		// Discrepancy Tracking
+		hasDiscrepancies: boolean("has_discrepancies").notNull().default(false),
+		discrepancyNotes: text("discrepancy_notes"),
+
+		// Notes
+		notes: text("notes"),
+		internalNotes: text("internal_notes"),
+		shippingInstructions: text("shipping_instructions"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_transfers_store_id").on(table.storeId),
+		statusIndex: index("idx_transfers_status").on(table.status),
+		transferNumberIndex: index("idx_transfers_number").on(table.transferNumber),
+		uniqueTransferNumber: unique("idx_transfers_number_unique").on(
+			table.storeId,
+			table.transferNumber,
+		),
+	}),
+);
+
+export const inventoryTransferItems = pgTable(
+	"inventory_transfer_items",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		transferId: text("transfer_id").notNull(),
+		productId: text("product_id").notNull(),
+		variantId: text("variant_id"),
+		sku: varchar("sku", { length: 255 }).notNull(),
+		quantity: integer("quantity").notNull(),
+		receivedQuantity: integer("received_quantity").default(0),
+		batchNumber: varchar("batch_number", { length: 255 }),
+		lotNumber: varchar("lot_number", { length: 255 }),
+		serialNumbers: jsonb("serial_numbers").$type<string[]>(),
+		expiryDate: timestamp("expiry_date", { withTimezone: true }),
+		metadata: jsonb("metadata").$type<Record<string, any>>().default({}),
+
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		transferIdIndex: index("idx_transfer_items_transfer_id").on(
+			table.transferId,
+		),
+		productIdIndex: index("idx_transfer_items_product_id").on(table.productId),
+	}),
+);
+
+// =====================================================
+// QUALITY CONTROLS TABLE
+// =====================================================
+
+export const qualityStatusEnum = pgEnum("quality_status", [
+	"PENDING_INSPECTION",
+	"PASSED",
+	"FAILED",
+	"CONDITIONALLY_PASSED",
+	"QUARANTINED",
+	"REJECTED",
+	"REWORK_REQUIRED",
+	"RELEASED",
+	"HOLD",
+]);
+
+export const inspectionTypeEnum = pgEnum("inspection_type", [
+	"INCOMING_INSPECTION",
+	"IN_PROCESS_INSPECTION",
+	"OUTGOING_INSPECTION",
+	"RANDOM_INSPECTION",
+	"CUSTOMER_COMPLAINT_INSPECTION",
+	"SUPPLIER_AUDIT",
+	"PERIODIC_REVIEW",
+	"EXPIRY_CHECK",
+	"DAMAGE_ASSESSMENT",
+]);
+
+export const qualityControls = pgTable(
+	"quality_controls",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		qcNumber: varchar("qc_number", { length: 100 }).notNull(),
+
+		// Product Information
+		productId: text("product_id").notNull(),
+		variantId: text("variant_id"),
+		sku: varchar("sku", { length: 255 }).notNull(),
+		productName: varchar("product_name", { length: 255 }),
+
+		// Batch/Lot Information
+		lotId: text("lot_id"), // FK to inventory_lots
+		batchNumber: varchar("batch_number", { length: 100 }),
+		lotNumber: varchar("lot_number", { length: 100 }),
+		serialNumbers: jsonb("serial_numbers"),
+		autoQuarantined: boolean("auto_quarantined").notNull().default(false),
+
+		// Location and Quantity
+		locationId: text("location_id").notNull(),
+		quantity: integer("quantity").notNull(),
+		sampleSize: integer("sample_size"),
+
+		// Inspection Details
+		inspectionType: inspectionTypeEnum("inspection_type").notNull(),
+		inspectionDate: timestamp("inspection_date", {
+			withTimezone: true,
+		}).notNull(),
+		inspectedBy: text("inspected_by").notNull(),
+		inspectionDuration: integer("inspection_duration"), // minutes
+
+		// Quality Assessment
+		overallStatus: qualityStatusEnum("overall_status").notNull(),
+		qualityGrade: varchar("quality_grade", { length: 20 }),
+		qualityScore: decimal("quality_score", { precision: 5, scale: 2 }),
+
+		// Inspection Criteria and Results
+		criteria: jsonb("criteria").notNull(),
+		defects: jsonb("defects"),
+		measurements: jsonb("measurements"),
+		certificates: jsonb("certificates"),
+
+		// Documentation
+		imageUrls: jsonb("image_urls"),
+		documentUrls: jsonb("document_urls"),
+
+		// Supplier Information (for incoming inspections)
+		supplierId: text("supplier_id"),
+		supplierName: varchar("supplier_name", { length: 255 }),
+		purchaseOrderNumber: varchar("purchase_order_number", { length: 100 }),
+
+		// Action Required
+		actionRequired: boolean("action_required").notNull().default(false),
+		correctionActions: jsonb("correction_actions"),
+
+		// Follow-up Requirements
+		requiresReInspection: boolean("requires_re_inspection")
+			.notNull()
+			.default(false),
+		reInspectionDate: timestamp("re_inspection_date", { withTimezone: true }),
+		reInspectionNotes: text("re_inspection_notes"),
+
+		// Disposition
+		dispositionDate: timestamp("disposition_date", { withTimezone: true }),
+		dispositionAction: varchar("disposition_action", { length: 50 }),
+		dispositionNotes: text("disposition_notes"),
+		dispositionBy: text("disposition_by"),
+
+		// Status Updates
+		completedAt: timestamp("completed_at", { withTimezone: true }),
+		approvedBy: text("approved_by"),
+		approvedAt: timestamp("approved_at", { withTimezone: true }),
+
+		// Customer Notification
+		customerNotified: boolean("customer_notified").notNull().default(false),
+		customerNotificationDate: timestamp("customer_notification_date", {
+			withTimezone: true,
+		}),
+		customerResponse: text("customer_response"),
+
+		// Notes
+		notes: text("notes"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_quality_controls_store_id").on(table.storeId),
+		qcNumberIndex: index("idx_quality_controls_qc_number").on(table.qcNumber),
+		statusIndex: index("idx_quality_controls_status").on(table.overallStatus),
+		inspectionDateIndex: index("idx_quality_controls_inspection_date").on(
+			table.inspectionDate,
+		),
+		uniqueQcNumber: unique("idx_quality_controls_number_unique").on(
+			table.storeId,
+			table.qcNumber,
+		),
+	}),
+);
+
+export const qualityTemplates = pgTable(
+	"quality_templates",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		name: varchar("name", { length: 255 }).notNull(),
+		version: varchar("version", { length: 50 }).notNull(),
+		isActive: boolean("is_active").notNull().default(true),
+
+		// Template Configuration
+		criteria: jsonb("criteria").$type<any[]>().default([]),
+		inspectionTypes: jsonb("inspection_types").$type<string[]>().default([]),
+
+		// Notes
+		description: text("description"),
+		notes: text("notes"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_quality_templates_store_id").on(table.storeId),
+		nameIndex: index("idx_quality_templates_name").on(table.name),
+		isActiveIndex: index("idx_quality_templates_active").on(table.isActive),
+	}),
+);
+
+// =====================================================
+// SUPPLIER QUALITY RATINGS TABLE
+// =====================================================
+
+export const supplierQualityRatings = pgTable(
+	"supplier_quality_ratings",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		supplierId: text("supplier_id").notNull(),
+
+		// Rating Period
+		ratingPeriod: jsonb("rating_period")
+			.$type<{
+				startDate: Date;
+				endDate: Date;
+			}>()
+			.notNull(),
+
+		// Inspection Metrics
+		totalInspections: integer("total_inspections").notNull(),
+		passedInspections: integer("passed_inspections").notNull(),
+		failedInspections: integer("failed_inspections").notNull(),
+
+		// Performance Metrics
+		qualityScore: decimal("quality_score", { precision: 5, scale: 2 }),
+		onTimeDeliveryRate: decimal("on_time_delivery_rate", {
+			precision: 5,
+			scale: 2,
+		}),
+		defectRate: decimal("defect_rate", { precision: 5, scale: 2 }),
+
+		// Overall Rating
+		overallRating: varchar("overall_rating", { length: 20 }),
+
+		// Notes
+		notes: text("notes"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_supplier_quality_ratings_store_id").on(
+			table.storeId,
+		),
+		supplierIdIndex: index("idx_supplier_quality_ratings_supplier_id").on(
+			table.supplierId,
+		),
+	}),
+);
+
+// =====================================================
+// SUPPLIERS TABLE
+// =====================================================
+
+export const supplierStatusEnum = pgEnum("supplier_status", [
+	"ACTIVE",
+	"INACTIVE",
+	"SUSPENDED",
+	"UNDER_REVIEW",
+	"PENDING_APPROVAL",
+	"BLACKLISTED",
+]);
+
+export const supplierTypeEnum = pgEnum("supplier_type", [
+	"MANUFACTURER",
+	"DISTRIBUTOR",
+	"WHOLESALER",
+	"DROPSHIPPER",
+	"SERVICE_PROVIDER",
+	"LOCAL_VENDOR",
+	"INTERNATIONAL_VENDOR",
+	"BROKER",
+	"IMPORTER",
+	"EXPORTER",
+	"RETAILER",
+	"RESELLER",
+	"CONTRACTOR",
+	"CONSULTANT",
+	"PARTS_SUPPLIER",
+	"RAW_MATERIALS_SUPPLIER",
+	"PACKAGING_SUPPLIER",
+	"EQUIPMENT_SUPPLIER",
+	"MAINTENANCE_SUPPLIER",
+	"LOGISTICS_PROVIDER",
+	"FREIGHT_FORWARDER",
+	"CUSTOMS_BROKER",
+	"TECHNOLOGY_VENDOR",
+	"SOFTWARE_VENDOR",
+	"HARDWARE_VENDOR",
+	"OFFICE_SUPPLIES_VENDOR",
+	"UTILITIES_PROVIDER",
+	"CLEANING_SERVICES",
+	"SECURITY_SERVICES",
+	"MARKETING_SERVICES",
+	"PROFESSIONAL_SERVICES",
+	"TEMPORARY_STAFFING",
+	"SPECIALIZED_SUPPLIER",
+	"OTHER",
+]);
+
+export const supplierRatingEnum = pgEnum("supplier_rating", [
+	"EXCELLENT",
+	"GOOD",
+	"AVERAGE",
+	"POOR",
+	"UNRATED",
+]);
+
+export const suppliers = pgTable(
+	"suppliers",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		name: varchar("name", { length: 255 }).notNull(),
+		code: varchar("code", { length: 100 }).notNull(),
+		status: supplierStatusEnum("status").notNull().default("ACTIVE"),
+		type: supplierTypeEnum("type").notNull().default("MANUFACTURER"),
+
+		// Contact Information
+		primaryContact: jsonb("primary_contact").$type<{
+			name?: string;
+			email?: string;
+			phone?: string;
+			alternatePhone?: string;
+		}>(),
+
+		// Address Information
+		address: jsonb("address").$type<{
+			street: string;
+			city: string;
+			state: string;
+			postalCode: string;
+			country: string;
+		}>(),
+		billingAddress: jsonb("billing_address").$type<{
+			street: string;
+			city: string;
+			state: string;
+			postalCode: string;
+			country: string;
+		}>(),
+
+		// Payment Terms
+		paymentTerms: jsonb("payment_terms").$type<{
+			termsDays: number;
+			discountDays?: number;
+			discountPercentage?: number;
+			penaltyRate?: number;
+		}>(),
+
+		// Business Information
+		taxId: varchar("tax_id", { length: 100 }),
+		businessLicense: varchar("business_license", { length: 100 }),
+		certifications: jsonb("certifications").$type<string[]>().default([]),
+
+		// Performance Metrics
+		rating: supplierRatingEnum("rating"),
+		onTimeDeliveryRate: decimal("on_time_delivery_rate", {
+			precision: 5,
+			scale: 2,
+		}),
+		qualityRating: decimal("quality_rating", { precision: 5, scale: 2 }),
+
+		// Business Terms
+		minimumOrderAmount: decimal("minimum_order_amount", {
+			precision: 12,
+			scale: 4,
+		}),
+		leadTimeDays: integer("lead_time_days"),
+		deliveryMethod: varchar("delivery_method", { length: 100 }),
+		currency: varchar("currency", { length: 3 }).notNull().default("USD"),
+
+		// Metadata
+		tags: jsonb("tags").$type<string[]>().default([]),
+		notes: text("notes"),
+		metadata: jsonb("metadata").$type<Record<string, any>>().default({}),
+
+		// Status
+		isActive: boolean("is_active").notNull().default(true),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_suppliers_store_id").on(table.storeId),
+		statusIndex: index("idx_suppliers_status").on(table.status),
+		typeIndex: index("idx_suppliers_type").on(table.type),
+		ratingIndex: index("idx_suppliers_rating").on(table.rating),
+		uniqueCodePerStore: unique("idx_suppliers_code_unique").on(
+			table.storeId,
+			table.code,
+		),
+	}),
+);
+
+// =====================================================
+// PURCHASE ORDERS TABLE
+// =====================================================
+
+export const purchaseOrderStatusEnum = pgEnum("purchase_order_status", [
+	"DRAFT",
+	"SENT",
+	"ACKNOWLEDGED",
+	"APPROVED",
+	"PENDING_APPROVAL",
+	"PARTIALLY_RECEIVED",
+	"RECEIVED",
+	"COMPLETED",
+	"CANCELLED",
+	"DISPUTED",
+]);
+
+export const purchaseOrders = pgTable(
+	"purchase_orders",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		supplierId: text("supplier_id").notNull(),
+		orderNumber: varchar("order_number", { length: 100 }).notNull(),
+		status: purchaseOrderStatusEnum("status").notNull().default("DRAFT"),
+
+		// Order Details
+		orderDate: timestamp("order_date", { withTimezone: true }).notNull(),
+		requestedDeliveryDate: timestamp("requested_delivery_date", {
+			withTimezone: true,
+		}),
+		expectedDeliveryDate: timestamp("expected_delivery_date", {
+			withTimezone: true,
+		}),
+		actualDeliveryDate: timestamp("actual_delivery_date", {
+			withTimezone: true,
+		}),
+
+		// Financial Information
+		subtotal: decimal("subtotal", { precision: 12, scale: 4 }).notNull(),
+		taxAmount: decimal("tax_amount", { precision: 12, scale: 4 }).default("0"),
+		discountAmount: decimal("discount_amount", {
+			precision: 12,
+			scale: 4,
+		}).default("0"),
+		shippingAmount: decimal("shipping_amount", {
+			precision: 12,
+			scale: 4,
+		}).default("0"),
+		totalAmount: decimal("total_amount", { precision: 12, scale: 4 }).notNull(),
+		currency: varchar("currency", { length: 3 }).notNull().default("USD"),
+
+		// Shipping Information
+		shippingAddress: jsonb("shipping_address").$type<{
+			street: string;
+			city: string;
+			state: string;
+			postalCode: string;
+			country: string;
+		}>(),
+
+		// Payment Terms
+		paymentTerms: varchar("payment_terms", { length: 50 }).notNull(),
+
+		// Status Tracking
+		approvedBy: text("approved_by"),
+		approvedAt: timestamp("approved_at", { withTimezone: true }),
+		sentDate: timestamp("sent_date", { withTimezone: true }),
+		acknowledgedDate: timestamp("acknowledged_date", { withTimezone: true }),
+
+		// Notes
+		notes: text("notes"),
+		internalNotes: text("internal_notes"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		createdBy: text("created_by"),
+		updatedBy: text("updated_by"),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_purchase_orders_store_id").on(table.storeId),
+		supplierIdIndex: index("idx_purchase_orders_supplier_id").on(
+			table.supplierId,
+		),
+		statusIndex: index("idx_purchase_orders_status").on(table.status),
+		orderDateIndex: index("idx_purchase_orders_order_date").on(table.orderDate),
+		uniqueOrderNumber: unique("idx_purchase_orders_number_unique").on(
+			table.storeId,
+			table.orderNumber,
+		),
+	}),
+);
+
+export const purchaseOrderItems = pgTable(
+	"purchase_order_items",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		orderId: text("order_id").notNull(),
+		productId: text("product_id").notNull(),
+		variantId: text("variant_id"),
+		sku: varchar("sku", { length: 255 }).notNull(),
+
+		// Quantity and Pricing
+		quantity: integer("quantity").notNull(),
+		receivedQuantity: integer("received_quantity").default(0),
+		unitPrice: decimal("unit_price", { precision: 12, scale: 4 }).notNull(),
+		totalPrice: decimal("total_price", { precision: 12, scale: 4 }).notNull(),
+		taxRate: decimal("tax_rate", { precision: 5, scale: 2 }).default("0"),
+		discountRate: decimal("discount_rate", { precision: 5, scale: 2 }).default(
+			"0",
+		),
+
+		// Notes
+		notes: text("notes"),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		orderIdIndex: index("idx_purchase_order_items_order_id").on(table.orderId),
+		productIdIndex: index("idx_purchase_order_items_product_id").on(
+			table.productId,
+		),
+	}),
+);
+
+export const productSuppliers = pgTable(
+	"product_suppliers",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		productId: text("product_id").notNull(),
+		supplierId: text("supplier_id").notNull(),
+
+		// Supplier Product Information
+		supplierSku: varchar("supplier_sku", { length: 255 }),
+		supplierProductName: varchar("supplier_product_name", { length: 255 }),
+
+		// Pricing and Terms
+		unitCost: decimal("unit_cost", { precision: 12, scale: 4 }),
+		cost: decimal("cost", { precision: 12, scale: 4 }),
+		currency: varchar("currency", { length: 3 }).notNull().default("USD"),
+		minimumOrderQuantity: integer("minimum_order_quantity"),
+		leadTime: integer("lead_time"),
+		packSize: integer("pack_size").default(1),
+		availability: varchar("availability", { length: 20 }).default("IN_STOCK"),
+
+		// Status
+		isActive: boolean("is_active").notNull().default(true),
+		isPreferred: boolean("is_preferred").notNull().default(false),
+
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		lastOrderDate: timestamp("last_order_date", { withTimezone: true }),
+		lastCostUpdate: timestamp("last_cost_update", { withTimezone: true }),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_product_suppliers_store_id").on(table.storeId),
+		productIdIndex: index("idx_product_suppliers_product_id").on(
+			table.productId,
+		),
+		supplierIdIndex: index("idx_product_suppliers_supplier_id").on(
+			table.supplierId,
+		),
+		uniqueProductSupplier: unique("idx_product_suppliers_unique").on(
+			table.storeId,
+			table.productId,
+			table.supplierId,
+		),
+	}),
+);