@axova/shared 1.0.2 → 1.1.0

package/src/interfaces/inventory-types.ts

@@ -1,1004 +1,1004 @@
-// Comprehensive inventory management types and interfaces
-
-import type {
-	BaseFilter,
-	DateRangeFilter,
-	LocationFilter,
-	StatusFilter,
-} from "../schemas/types";
-
-// =====================================================
-// CORE INVENTORY TYPES
-// =====================================================
-
-export interface InventoryItem {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	productId: string;
-	variantId: string;
-	sku: string;
-	locationId: string;
-	locationType: "warehouse" | "pos";
-	zoneId?: string;
-	binLocation?: string;
-	quantityAvailable: number;
-	quantityCommitted: number;
-	quantityReserved: number;
-	quantityIncoming: number;
-	quantityInTransit: number;
-	safetyStock: number;
-	cycleStock: number;
-	reorderPoint: number;
-	maxStock: number;
-	unitCost?: number;
-	averageCost?: number;
-	lastCost?: number;
-	trackingType: "simple" | "batch" | "serial";
-	expiryTracking: boolean;
-	serialNumberTracking: boolean;
-	createdAt: Date;
-	updatedAt: Date;
-	lastCountDate?: Date;
-	lastMovementDate?: Date;
-	notes?: string;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface CreateInventoryItemRequest {
-	productId: string;
-	variantId: string;
-	sku: string;
-	locationId: string;
-	locationType: "warehouse" | "pos";
-	zoneId?: string;
-	binLocation?: string;
-	initialQuantity: number;
-	safetyStock?: number;
-	reorderPoint?: number;
-	maxStock?: number;
-	unitCost?: number;
-	trackingType?: "simple" | "batch" | "serial";
-	expiryTracking?: boolean;
-	serialNumberTracking?: boolean;
-	notes?: string;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface UpdateInventoryItemRequest {
-	quantityAvailable?: number;
-	safetyStock?: number;
-	reorderPoint?: number;
-	maxStock?: number;
-	unitCost?: number;
-	notes?: string;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface InventoryFilter
-	extends BaseFilter,
-		DateRangeFilter,
-		StatusFilter,
-		LocationFilter {
-	productId?: string;
-	variantId?: string;
-	sku?: string;
-	skus?: string[];
-	trackingType?: "simple" | "batch" | "serial";
-	lowStock?: boolean;
-	outOfStock?: boolean;
-	hasAlerts?: boolean;
-	categoryId?: string;
-}
-
-export interface QuantityUpdate {
-	inventoryItemId: string;
-	quantityChange: number;
-	changeType: "adjustment" | "sale" | "return" | "transfer" | "cycle_count";
-	reason: string;
-	sourceTransactionId?: string;
-	batchNumber?: string;
-	serialNumbers?: string[];
-}
-
-// =====================================================
-// WAREHOUSE TYPES
-// =====================================================
-
-export interface Warehouse {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	name: string;
-	code: string;
-	description?: string;
-	address?: {
-		street: string;
-		city: string;
-		state: string;
-		country: string;
-		postalCode: string;
-		latitude?: number;
-		longitude?: number;
-	};
-	latitude?: number;
-	longitude?: number;
-	timeZone?: string;
-	totalCapacity?: number;
-	usedCapacity: number;
-	capacityUnit: "units" | "cubic_meters" | "pallets";
-	temperatureControlled: boolean;
-	minTemperature?: number;
-	maxTemperature?: number;
-	humidityControlled: boolean;
-	status: "active" | "inactive" | "maintenance" | "closed";
-	operationalHours?: Record<string, { open: string; close: string }>;
-	priority: number;
-	warehouseGroupId?: string;
-	managerId?: string;
-	contactEmail?: string;
-	contactPhone?: string;
-	allowNegativeStock: boolean;
-	autoReceiveTransfers: boolean;
-	requirePickConfirmation: boolean;
-	createdAt: Date;
-	updatedAt: Date;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface CreateWarehouseRequest {
-	name: string;
-	code: string;
-	description?: string;
-	address?: Warehouse["address"];
-	latitude?: number;
-	longitude?: number;
-	timeZone?: string;
-	totalCapacity?: number;
-	capacityUnit?: "units" | "cubic_meters" | "pallets";
-	temperatureControlled?: boolean;
-	minTemperature?: number;
-	maxTemperature?: number;
-	humidityControlled?: boolean;
-	operationalHours?: Record<string, { open: string; close: string }>;
-	priority?: number;
-	warehouseGroupId?: string;
-	managerId?: string;
-	contactEmail?: string;
-	contactPhone?: string;
-	allowNegativeStock?: boolean;
-	autoReceiveTransfers?: boolean;
-	requirePickConfirmation?: boolean;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface POSLocation {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	name: string;
-	code: string;
-	description?: string;
-	address?: Warehouse["address"];
-	latitude?: number;
-	longitude?: number;
-	timeZone?: string;
-	status: "active" | "inactive" | "maintenance";
-	locationType: "retail_store" | "kiosk" | "popup" | "mobile";
-	businessHours?: Record<string, { open: string; close: string }>;
-	managerId?: string;
-	contactEmail?: string;
-	contactPhone?: string;
-	allowNegativeStock: boolean;
-	autoSyncInventory: boolean;
-	syncInterval: number;
-	offlineThreshold: number;
-	allowLocalPricing: boolean;
-	localPricingMarkup?: number;
-	lastSyncAt?: Date;
-	syncStatus: "synced" | "pending" | "error" | "offline";
-	pendingChanges: number;
-	createdAt: Date;
-	updatedAt: Date;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface CreatePOSLocationRequest {
-	name: string;
-	code: string;
-	description?: string;
-	address?: POSLocation["address"];
-	latitude?: number;
-	longitude?: number;
-	timeZone?: string;
-	locationType: "retail_store" | "kiosk" | "popup" | "mobile";
-	businessHours?: Record<string, { open: string; close: string }>;
-	managerId?: string;
-	contactEmail?: string;
-	contactPhone?: string;
-	allowNegativeStock?: boolean;
-	autoSyncInventory?: boolean;
-	syncInterval?: number;
-	offlineThreshold?: number;
-	allowLocalPricing?: boolean;
-	localPricingMarkup?: number;
-	customAttributes?: Record<string, unknown>;
-}
-
-// =====================================================
-// BATCH TRACKING TYPES
-// =====================================================
-
-export interface BatchInfo {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	batchNumber: string;
-	lotNumber?: string;
-	internalBatchId?: string;
-	productId: string;
-	variantId: string;
-	sku: string;
-	status: "active" | "quarantine" | "expired" | "recalled" | "depleted";
-	batchType: "production" | "purchase" | "transfer" | "adjustment";
-	manufactureDate?: Date;
-	receivedDate: Date;
-	expiryDate?: Date;
-	bestByDate?: Date;
-	sellByDate?: Date;
-	useByDate?: Date;
-	initialQuantity: number;
-	currentQuantity: number;
-	reservedQuantity: number;
-	committedQuantity: number;
-	unitCost?: number;
-	totalCost?: number;
-	averageCost?: number;
-	vendorId?: string;
-	vendorName?: string;
-	vendorBatchNumber?: string;
-	purchaseOrderNumber?: string;
-	qualityGrade?: string;
-	qualityNotes?: string;
-	certifications?: Array<{
-		type: string;
-		number: string;
-		issuedBy: string;
-		issuedDate: string;
-		expiryDate?: string;
-	}>;
-	originalLocationId: string;
-	currentLocationIds?: string[];
-	hasAlerts: boolean;
-	alertReasons?: string[];
-	quarantineReason?: string;
-	createdBy: string;
-	lastModifiedBy?: string;
-	createdAt: Date;
-	updatedAt: Date;
-	lastMovementAt?: Date;
-	notes?: string;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface CreateBatchRequest {
-	batchNumber: string;
-	lotNumber?: string;
-	productId: string;
-	variantId: string;
-	sku: string;
-	batchType: "production" | "purchase" | "transfer" | "adjustment";
-	manufactureDate?: Date;
-	receivedDate: Date;
-	expiryDate?: Date;
-	bestByDate?: Date;
-	sellByDate?: Date;
-	useByDate?: Date;
-	initialQuantity: number;
-	unitCost?: number;
-	vendorId?: string;
-	vendorName?: string;
-	vendorBatchNumber?: string;
-	purchaseOrderNumber?: string;
-	qualityGrade?: string;
-	qualityNotes?: string;
-	originalLocationId: string;
-	notes?: string;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface BatchFilter extends BaseFilter, DateRangeFilter, StatusFilter {
-	batchNumber?: string;
-	productId?: string;
-	sku?: string;
-	vendorId?: string;
-	expiringBefore?: Date;
-	hasAlerts?: boolean;
-	qualityGrade?: string;
-}
-
-// =====================================================
-// CYCLE COUNT TYPES
-// =====================================================
-
-export interface CycleCount {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	countNumber: string;
-	countName: string;
-	description?: string;
-	countType:
-		| "full_physical"
-		| "spot_check"
-		| "abc_analysis"
-		| "high_velocity"
-		| "low_velocity"
-		| "location_specific"
-		| "category_specific";
-	countMethod: "manual" | "barcode_assisted" | "rfid" | "automated";
-	locationId?: string;
-	locationType?: "warehouse" | "pos";
-	zoneIds?: string[];
-	binIds?: string[];
-	itemSelectionType:
-		| "all_items"
-		| "specific_skus"
-		| "category"
-		| "velocity_based"
-		| "value_based"
-		| "accuracy_based";
-	selectionCriteria?: {
-		categories?: string[];
-		skus?: string[];
-		productIds?: string[];
-		minValue?: number;
-		maxValue?: number;
-		velocityThreshold?: number;
-		accuracyThreshold?: number;
-		lastCountedBefore?: string;
-	};
-	scheduledDate: Date;
-	scheduledBy: string;
-	frequency?: "weekly" | "monthly" | "quarterly" | "annual" | "ad_hoc";
-	isRecurring: boolean;
-	status:
-		| "scheduled"
-		| "in_progress"
-		| "completed"
-		| "reconciled"
-		| "cancelled"
-		| "on_hold";
-	startedAt?: Date;
-	completedAt?: Date;
-	reconciledAt?: Date;
-	assignedTo?: string[];
-	supervisorId?: string;
-	totalItemsToCount?: number;
-	totalItemsCounted: number;
-	itemsWithDiscrepancies: number;
-	accuracyPercentage?: number;
-	totalVarianceValue?: number;
-	tolerancePercentage: number;
-	requiresApproval: boolean;
-	approvedBy?: string;
-	approvedAt?: Date;
-	reviewedBy?: string;
-	reviewedAt?: Date;
-	reviewNotes?: string;
-	allowBlindCounts: boolean;
-	requirePhotos: boolean;
-	allowPartialCounts: boolean;
-	autoReconcileWithinTolerance: boolean;
-	createdAt: Date;
-	updatedAt: Date;
-	notes?: string;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface CycleCountItem {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	cycleCountId: string;
-	countNumber: string;
-	inventoryItemId: string;
-	productId: string;
-	variantId: string;
-	sku: string;
-	productName?: string;
-	locationId: string;
-	locationType: "warehouse" | "pos";
-	zoneId?: string;
-	binLocation?: string;
-	systemQuantity: number;
-	systemValue?: number;
-	unitCost?: number;
-	countedQuantity?: number;
-	countedValue?: number;
-	quantityVariance?: number;
-	valueVariance?: number;
-	variancePercentage?: number;
-	batchNumber?: string;
-	serialNumbers?: string[];
-	expiryDate?: Date;
-	countStatus:
-		| "pending"
-		| "counted"
-		| "recount_required"
-		| "discrepancy"
-		| "reconciled"
-		| "skipped";
-	countedBy?: string;
-	countedAt?: Date;
-	recountedBy?: string;
-	recountedAt?: Date;
-	recountQuantity?: number;
-	countMethod?: "manual" | "barcode" | "scale" | "estimated";
-	confidenceLevel?: "high" | "medium" | "low";
-	requiresRecount: boolean;
-	recountReason?: string;
-	conditionNotes?: string;
-	qualityIssues?: string[];
-	damageObserved: boolean;
-	isReconciled: boolean;
-	reconciledBy?: string;
-	reconciledAt?: Date;
-	reconciliationMethod?:
-		| "adjust_system"
-		| "accept_variance"
-		| "investigate"
-		| "recount";
-	createdAt: Date;
-	updatedAt: Date;
-	notes?: string;
-}
-
-export interface CreateCycleCountRequest {
-	countName: string;
-	description?: string;
-	countType: CycleCount["countType"];
-	countMethod: CycleCount["countMethod"];
-	locationId?: string;
-	locationType?: "warehouse" | "pos";
-	zoneIds?: string[];
-	binIds?: string[];
-	itemSelectionType: CycleCount["itemSelectionType"];
-	selectionCriteria?: CycleCount["selectionCriteria"];
-	scheduledDate: Date;
-	frequency?: CycleCount["frequency"];
-	isRecurring?: boolean;
-	assignedTo?: string[];
-	supervisorId?: string;
-	tolerancePercentage?: number;
-	requiresApproval?: boolean;
-	allowBlindCounts?: boolean;
-	requirePhotos?: boolean;
-	allowPartialCounts?: boolean;
-	autoReconcileWithinTolerance?: boolean;
-	notes?: string;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface CountItemRequest {
-	cycleCountItemId: string;
-	countedQuantity: number;
-	countMethod?: "manual" | "barcode" | "scale" | "estimated";
-	confidenceLevel?: "high" | "medium" | "low";
-	conditionNotes?: string;
-	qualityIssues?: string[];
-	damageObserved?: boolean;
-	notes?: string;
-}
-
-export interface CycleCountFilter
-	extends BaseFilter,
-		DateRangeFilter,
-		StatusFilter {
-	countType?: string;
-	locationId?: string;
-	scheduledBy?: string;
-	hasDiscrepancies?: boolean;
-	frequency?: string;
-}
-
-// =====================================================
-// TRANSFER TYPES
-// =====================================================
-
-export interface TransferRequest {
-	sourceLocationId: string;
-	sourceLocationType: "warehouse" | "pos";
-	destinationLocationId: string;
-	destinationLocationType: "warehouse" | "pos";
-	transferType: "standard" | "urgent" | "emergency" | "rebalancing" | "return";
-	priority: "low" | "normal" | "high" | "urgent";
-	expectedShipDate?: Date;
-	expectedReceiveDate?: Date;
-	shippingMethod?: string;
-	notes?: string;
-	specialInstructions?: string;
-	requiresApproval?: boolean;
-	allowPartialTransfer?: boolean;
-	requiresInspection?: boolean;
-	items: Array<{
-		inventoryItemId: string;
-		requestedQuantity: number;
-		batchNumber?: string;
-		serialNumbers?: string[];
-		sourceZoneId?: string;
-		sourceBinLocation?: string;
-		destinationZoneId?: string;
-		destinationBinLocation?: string;
-		notes?: string;
-	}>;
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface TransferItem {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	transferId: string;
-	transferNumber: string;
-	inventoryItemId: string;
-	productId: string;
-	variantId: string;
-	sku: string;
-	productName?: string;
-	requestedQuantity: number;
-	approvedQuantity?: number;
-	pickedQuantity?: number;
-	shippedQuantity?: number;
-	receivedQuantity?: number;
-	acceptedQuantity?: number;
-	rejectedQuantity: number;
-	unitCost?: number;
-	totalCost?: number;
-	batchNumber?: string;
-	serialNumbers?: string[];
-	expiryDate?: Date;
-	sourceZoneId?: string;
-	sourceBinLocation?: string;
-	destinationZoneId?: string;
-	destinationBinLocation?: string;
-	conditionAtPick?: string;
-	conditionAtReceive?: string;
-	qualityNotes?: string;
-	hasDiscrepancy: boolean;
-	discrepancyType?: "quantity" | "damage" | "missing" | "extra" | "condition";
-	discrepancyReason?: string;
-	discrepancyResolution?: "accept" | "reject" | "adjust" | "investigate";
-	status:
-		| "pending"
-		| "picked"
-		| "shipped"
-		| "received"
-		| "accepted"
-		| "rejected";
-	createdAt: Date;
-	updatedAt: Date;
-	pickedAt?: Date;
-	shippedAt?: Date;
-	receivedAt?: Date;
-	notes?: string;
-}
-
-export interface TransferFilter
-	extends BaseFilter,
-		DateRangeFilter,
-		StatusFilter {
-	transferType?: string;
-	priority?: string;
-	sourceLocationId?: string;
-	destinationLocationId?: string;
-	requestedBy?: string;
-	hasDiscrepancies?: boolean;
-}
-
-// =====================================================
-// AUTOMATION TYPES
-// =====================================================
-
-export interface AutomationRule {
-	id: string;
-	tenantId: string;
-	storeId: string;
-	ruleName: string;
-	description?: string;
-	ruleType:
-		| "reorder"
-		| "transfer"
-		| "adjustment"
-		| "alert"
-		| "threshold"
-		| "expiry"
-		| "velocity"
-		| "optimization";
-	scope: "global" | "location" | "category" | "product" | "sku";
-	locationIds?: string[];
-	locationTypes?: string[];
-	productCategories?: string[];
-	productIds?: string[];
-	skus?: string[];
-	triggerConditions?: Record<string, unknown>;
-	actions?: Array<{
-		actionType: string;
-		priority: "low" | "medium" | "high" | "urgent";
-		parameters: Record<string, unknown>;
-		requiresApproval?: boolean;
-		approvalRoles?: string[];
-	}>;
-	aiEnabled: boolean;
-	mlModelId?: string;
-	confidenceThreshold?: number;
-	learningEnabled: boolean;
-	executionMode: "automatic" | "manual_approval" | "suggestion_only";
-	maxExecutionsPerDay?: number;
-	cooldownPeriod?: number;
-	priority: number;
-	executionOrder: number;
-	isScheduled: boolean;
-	schedulePattern?: string;
-	nextScheduledRun?: Date;
-	isActive: boolean;
-	canOverride: boolean;
-	temporaryDisableUntil?: Date;
-	executionCount: number;
-	successCount: number;
-	failureCount: number;
-	lastExecutedAt?: Date;
-	lastSuccessAt?: Date;
-	lastFailureAt?: Date;
-	averageExecutionTime?: number;
-	successRate?: number;
-	costSavings?: number;
-	createdBy: string;
-	updatedBy?: string;
-	createdAt: Date;
-	updatedAt: Date;
-	tags?: string[];
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface CreateAutomationRuleRequest {
-	ruleName: string;
-	description?: string;
-	ruleType: AutomationRule["ruleType"];
-	scope: AutomationRule["scope"];
-	locationIds?: string[];
-	locationTypes?: string[];
-	productCategories?: string[];
-	productIds?: string[];
-	skus?: string[];
-	triggerConditions?: Record<string, unknown>;
-	actions?: AutomationRule["actions"];
-	aiEnabled?: boolean;
-	mlModelId?: string;
-	confidenceThreshold?: number;
-	learningEnabled?: boolean;
-	executionMode?: AutomationRule["executionMode"];
-	maxExecutionsPerDay?: number;
-	cooldownPeriod?: number;
-	priority?: number;
-	executionOrder?: number;
-	isScheduled?: boolean;
-	schedulePattern?: string;
-	nextScheduledRun?: Date;
-	canOverride?: boolean;
-	tags?: string[];
-	customAttributes?: Record<string, unknown>;
-}
-
-export interface AutomationRuleFilter extends BaseFilter, StatusFilter {
-	ruleType?: string;
-	scope?: string;
-	aiEnabled?: boolean;
-	executionMode?: string;
-	isScheduled?: boolean;
-	tags?: string[];
-}
-
-export interface AIRecommendation {
-	id: string;
-	type: "reorder" | "transfer" | "pricing" | "optimization";
-	confidence: number;
-	priority: "low" | "medium" | "high" | "urgent";
-	title: string;
-	description: string;
-	impact: {
-		financial?: number;
-		operational?: string;
-		risk?: string;
-	};
-	actions: Array<{
-		actionType: string;
-		parameters: Record<string, unknown>;
-		estimatedOutcome: string;
-	}>;
-	dataPoints: Record<string, unknown>;
-	expiresAt?: Date;
-	createdAt: Date;
-}
-
-// =====================================================
-// ANALYTICS AND REPORTING TYPES
-// =====================================================
-
-export interface InventorySnapshot {
-	date: Date;
-	totalItems: number;
-	totalValue: number;
-	lowStockItems: number;
-	outOfStockItems: number;
-	averageTurnover: number;
-	topMovingItems: Array<{
-		sku: string;
-		productName: string;
-		quantity: number;
-		value: number;
-	}>;
-}
-
-export interface LowStockAlert {
-	id: string;
-	inventoryItemId: string;
-	sku: string;
-	productName: string;
-	locationId: string;
-	locationName: string;
-	currentQuantity: number;
-	reorderPoint: number;
-	safetyStock: number;
-	daysOfSupply: number;
-	severity: "low" | "medium" | "high" | "critical";
-	createdAt: Date;
-}
-
-export interface InventoryInsight {
-	type: "trend" | "anomaly" | "opportunity" | "risk";
-	title: string;
-	description: string;
-	metric: string;
-	value: number;
-	change: number;
-	changeDirection: "up" | "down" | "stable";
-	timeframe: string;
-	actionable: boolean;
-	recommendations?: string[];
-}
-
-export interface DashboardMetrics {
-	totalItems: number;
-	totalValue: number;
-	lowStockCount: number;
-	outOfStockCount: number;
-	expiringSoonCount: number;
-	pendingTransfersCount: number;
-	averageTurnoverRate: number;
-	inventoryAccuracy: number;
-	recentActivity: Array<{
-		type: string;
-		description: string;
-		timestamp: Date;
-	}>;
-	alerts: LowStockAlert[];
-	insights: InventoryInsight[];
-}
-
-export interface InventoryOverview {
-	totalItems: number;
-	totalValue: number;
-	totalLocations: number;
-	lowStockPercentage: number;
-	outOfStockPercentage: number;
-	turnoverRate: number;
-	accuracy: number;
-	categoryBreakdown: Array<{
-		category: string;
-		itemCount: number;
-		value: number;
-		percentage: number;
-	}>;
-	locationBreakdown: Array<{
-		locationId: string;
-		locationName: string;
-		itemCount: number;
-		value: number;
-		utilization: number;
-	}>;
-}
-
-export interface StockMovementReport {
-	period: {
-		startDate: Date;
-		endDate: Date;
-	};
-	totalMovements: number;
-	inboundMovements: number;
-	outboundMovements: number;
-	adjustments: number;
-	transfers: number;
-	valueChange: number;
-	topMovingItems: Array<{
-		sku: string;
-		productName: string;
-		totalMovement: number;
-		inbound: number;
-		outbound: number;
-		netChange: number;
-	}>;
-	movementsByDay: Array<{
-		date: Date;
-		inbound: number;
-		outbound: number;
-		net: number;
-	}>;
-}
-
-export interface VelocityAnalysis {
-	period: {
-		startDate: Date;
-		endDate: Date;
-	};
-	items: Array<{
-		sku: string;
-		productName: string;
-		currentQuantity: number;
-		totalSold: number;
-		averageDailySales: number;
-		turnoverRate: number;
-		daysOfSupply: number;
-		velocityCategory: "fast" | "medium" | "slow" | "dead";
-		reorderRecommendation: string;
-	}>;
-	summary: {
-		fastMoving: number;
-		mediumMoving: number;
-		slowMoving: number;
-		deadStock: number;
-		averageTurnover: number;
-	};
-}
-
-export interface ABCClassification {
-	items: Array<{
-		sku: string;
-		productName: string;
-		annualValue: number;
-		annualQuantity: number;
-		cumulativeValue: number;
-		cumulativePercentage: number;
-		classification: "A" | "B" | "C";
-		recommendedManagement: string;
-	}>;
-	summary: {
-		classA: { count: number; valuePercentage: number };
-		classB: { count: number; valuePercentage: number };
-		classC: { count: number; valuePercentage: number };
-	};
-}
-
-export interface StockValuation {
-	totalValue: number;
-	valuationMethod: "FIFO" | "LIFO" | "weighted_average";
-	byCategory: Array<{
-		category: string;
-		value: number;
-		percentage: number;
-		itemCount: number;
-	}>;
-	byLocation: Array<{
-		locationId: string;
-		locationName: string;
-		value: number;
-		percentage: number;
-		itemCount: number;
-	}>;
-	ageAnalysis: Array<{
-		ageRange: string;
-		value: number;
-		percentage: number;
-		itemCount: number;
-	}>;
-}
-
-export interface ExpiryReport {
-	expiredItems: Array<{
-		sku: string;
-		productName: string;
-		batchNumber: string;
-		expiryDate: Date;
-		quantity: number;
-		value: number;
-		daysExpired: number;
-		locationName: string;
-	}>;
-	expiringSoon: Array<{
-		sku: string;
-		productName: string;
-		batchNumber: string;
-		expiryDate: Date;
-		quantity: number;
-		value: number;
-		daysUntilExpiry: number;
-		locationName: string;
-	}>;
-	summary: {
-		totalExpiredValue: number;
-		totalExpiredQuantity: number;
-		expiringInNext30Days: number;
-		expiringInNext7Days: number;
-		averageDaysToExpiry: number;
-	};
-}
-
-export interface ForecastData {
-	sku: string;
-	productName: string;
-	forecastPeriod: {
-		startDate: Date;
-		endDate: Date;
-	};
-	historicalDemand: Array<{
-		date: Date;
-		demand: number;
-		actual?: number;
-	}>;
-	forecastedDemand: Array<{
-		date: Date;
-		predicted: number;
-		confidence: number;
-		upperBound: number;
-		lowerBound: number;
-	}>;
-	accuracy: {
-		mape: number; // Mean Absolute Percentage Error
-		rmse: number; // Root Mean Square Error
-		bias: number;
-	};
-	seasonality: {
-		detected: boolean;
-		pattern: string;
-		strength: number;
-	};
-	trend: {
-		direction: "up" | "down" | "stable";
-		strength: number;
-	};
-}
-
-export interface ReorderRecommendation {
-	sku: string;
-	productName: string;
-	locationId: string;
-	locationName: string;
-	currentQuantity: number;
-	reorderPoint: number;
-	safetyStock: number;
-	recommendedOrderQuantity: number;
-	leadTime: number;
-	daysOfSupply: number;
-	priority: "low" | "medium" | "high" | "urgent";
-	reasoning: string[];
-	estimatedCost: number;
-	estimatedStockoutRisk: number;
-	supplierRecommendations: Array<{
-		supplierId: string;
-		supplierName: string;
-		unitPrice: number;
-		leadTime: number;
-		minimumOrder: number;
-		reliability: number;
-	}>;
-	aiConfidence: number;
-	lastUpdated: Date;
-}
-
-// Re-export common types
-export type {
-	OperationResult,
-	PaginatedResult,
-	TenantContext,
-	UserContext,
-} from "../schemas/types";
+// Comprehensive inventory management types and interfaces
+
+import type {
+	BaseFilter,
+	DateRangeFilter,
+	LocationFilter,
+	StatusFilter,
+} from "../schemas/types";
+
+// =====================================================
+// CORE INVENTORY TYPES
+// =====================================================
+
+export interface InventoryItem {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	productId: string;
+	variantId: string;
+	sku: string;
+	locationId: string;
+	locationType: "warehouse" | "pos";
+	zoneId?: string;
+	binLocation?: string;
+	quantityAvailable: number;
+	quantityCommitted: number;
+	quantityReserved: number;
+	quantityIncoming: number;
+	quantityInTransit: number;
+	safetyStock: number;
+	cycleStock: number;
+	reorderPoint: number;
+	maxStock: number;
+	unitCost?: number;
+	averageCost?: number;
+	lastCost?: number;
+	trackingType: "simple" | "batch" | "serial";
+	expiryTracking: boolean;
+	serialNumberTracking: boolean;
+	createdAt: Date;
+	updatedAt: Date;
+	lastCountDate?: Date;
+	lastMovementDate?: Date;
+	notes?: string;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface CreateInventoryItemRequest {
+	productId: string;
+	variantId: string;
+	sku: string;
+	locationId: string;
+	locationType: "warehouse" | "pos";
+	zoneId?: string;
+	binLocation?: string;
+	initialQuantity: number;
+	safetyStock?: number;
+	reorderPoint?: number;
+	maxStock?: number;
+	unitCost?: number;
+	trackingType?: "simple" | "batch" | "serial";
+	expiryTracking?: boolean;
+	serialNumberTracking?: boolean;
+	notes?: string;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface UpdateInventoryItemRequest {
+	quantityAvailable?: number;
+	safetyStock?: number;
+	reorderPoint?: number;
+	maxStock?: number;
+	unitCost?: number;
+	notes?: string;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface InventoryFilter
+	extends BaseFilter,
+		DateRangeFilter,
+		StatusFilter,
+		LocationFilter {
+	productId?: string;
+	variantId?: string;
+	sku?: string;
+	skus?: string[];
+	trackingType?: "simple" | "batch" | "serial";
+	lowStock?: boolean;
+	outOfStock?: boolean;
+	hasAlerts?: boolean;
+	categoryId?: string;
+}
+
+export interface QuantityUpdate {
+	inventoryItemId: string;
+	quantityChange: number;
+	changeType: "adjustment" | "sale" | "return" | "transfer" | "cycle_count";
+	reason: string;
+	sourceTransactionId?: string;
+	batchNumber?: string;
+	serialNumbers?: string[];
+}
+
+// =====================================================
+// WAREHOUSE TYPES
+// =====================================================
+
+export interface Warehouse {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	name: string;
+	code: string;
+	description?: string;
+	address?: {
+		street: string;
+		city: string;
+		state: string;
+		country: string;
+		postalCode: string;
+		latitude?: number;
+		longitude?: number;
+	};
+	latitude?: number;
+	longitude?: number;
+	timeZone?: string;
+	totalCapacity?: number;
+	usedCapacity: number;
+	capacityUnit: "units" | "cubic_meters" | "pallets";
+	temperatureControlled: boolean;
+	minTemperature?: number;
+	maxTemperature?: number;
+	humidityControlled: boolean;
+	status: "active" | "inactive" | "maintenance" | "closed";
+	operationalHours?: Record<string, { open: string; close: string }>;
+	priority: number;
+	warehouseGroupId?: string;
+	managerId?: string;
+	contactEmail?: string;
+	contactPhone?: string;
+	allowNegativeStock: boolean;
+	autoReceiveTransfers: boolean;
+	requirePickConfirmation: boolean;
+	createdAt: Date;
+	updatedAt: Date;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface CreateWarehouseRequest {
+	name: string;
+	code: string;
+	description?: string;
+	address?: Warehouse["address"];
+	latitude?: number;
+	longitude?: number;
+	timeZone?: string;
+	totalCapacity?: number;
+	capacityUnit?: "units" | "cubic_meters" | "pallets";
+	temperatureControlled?: boolean;
+	minTemperature?: number;
+	maxTemperature?: number;
+	humidityControlled?: boolean;
+	operationalHours?: Record<string, { open: string; close: string }>;
+	priority?: number;
+	warehouseGroupId?: string;
+	managerId?: string;
+	contactEmail?: string;
+	contactPhone?: string;
+	allowNegativeStock?: boolean;
+	autoReceiveTransfers?: boolean;
+	requirePickConfirmation?: boolean;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface POSLocation {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	name: string;
+	code: string;
+	description?: string;
+	address?: Warehouse["address"];
+	latitude?: number;
+	longitude?: number;
+	timeZone?: string;
+	status: "active" | "inactive" | "maintenance";
+	locationType: "retail_store" | "kiosk" | "popup" | "mobile";
+	businessHours?: Record<string, { open: string; close: string }>;
+	managerId?: string;
+	contactEmail?: string;
+	contactPhone?: string;
+	allowNegativeStock: boolean;
+	autoSyncInventory: boolean;
+	syncInterval: number;
+	offlineThreshold: number;
+	allowLocalPricing: boolean;
+	localPricingMarkup?: number;
+	lastSyncAt?: Date;
+	syncStatus: "synced" | "pending" | "error" | "offline";
+	pendingChanges: number;
+	createdAt: Date;
+	updatedAt: Date;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface CreatePOSLocationRequest {
+	name: string;
+	code: string;
+	description?: string;
+	address?: POSLocation["address"];
+	latitude?: number;
+	longitude?: number;
+	timeZone?: string;
+	locationType: "retail_store" | "kiosk" | "popup" | "mobile";
+	businessHours?: Record<string, { open: string; close: string }>;
+	managerId?: string;
+	contactEmail?: string;
+	contactPhone?: string;
+	allowNegativeStock?: boolean;
+	autoSyncInventory?: boolean;
+	syncInterval?: number;
+	offlineThreshold?: number;
+	allowLocalPricing?: boolean;
+	localPricingMarkup?: number;
+	customAttributes?: Record<string, unknown>;
+}
+
+// =====================================================
+// BATCH TRACKING TYPES
+// =====================================================
+
+export interface BatchInfo {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	batchNumber: string;
+	lotNumber?: string;
+	internalBatchId?: string;
+	productId: string;
+	variantId: string;
+	sku: string;
+	status: "active" | "quarantine" | "expired" | "recalled" | "depleted";
+	batchType: "production" | "purchase" | "transfer" | "adjustment";
+	manufactureDate?: Date;
+	receivedDate: Date;
+	expiryDate?: Date;
+	bestByDate?: Date;
+	sellByDate?: Date;
+	useByDate?: Date;
+	initialQuantity: number;
+	currentQuantity: number;
+	reservedQuantity: number;
+	committedQuantity: number;
+	unitCost?: number;
+	totalCost?: number;
+	averageCost?: number;
+	vendorId?: string;
+	vendorName?: string;
+	vendorBatchNumber?: string;
+	purchaseOrderNumber?: string;
+	qualityGrade?: string;
+	qualityNotes?: string;
+	certifications?: Array<{
+		type: string;
+		number: string;
+		issuedBy: string;
+		issuedDate: string;
+		expiryDate?: string;
+	}>;
+	originalLocationId: string;
+	currentLocationIds?: string[];
+	hasAlerts: boolean;
+	alertReasons?: string[];
+	quarantineReason?: string;
+	createdBy: string;
+	lastModifiedBy?: string;
+	createdAt: Date;
+	updatedAt: Date;
+	lastMovementAt?: Date;
+	notes?: string;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface CreateBatchRequest {
+	batchNumber: string;
+	lotNumber?: string;
+	productId: string;
+	variantId: string;
+	sku: string;
+	batchType: "production" | "purchase" | "transfer" | "adjustment";
+	manufactureDate?: Date;
+	receivedDate: Date;
+	expiryDate?: Date;
+	bestByDate?: Date;
+	sellByDate?: Date;
+	useByDate?: Date;
+	initialQuantity: number;
+	unitCost?: number;
+	vendorId?: string;
+	vendorName?: string;
+	vendorBatchNumber?: string;
+	purchaseOrderNumber?: string;
+	qualityGrade?: string;
+	qualityNotes?: string;
+	originalLocationId: string;
+	notes?: string;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface BatchFilter extends BaseFilter, DateRangeFilter, StatusFilter {
+	batchNumber?: string;
+	productId?: string;
+	sku?: string;
+	vendorId?: string;
+	expiringBefore?: Date;
+	hasAlerts?: boolean;
+	qualityGrade?: string;
+}
+
+// =====================================================
+// CYCLE COUNT TYPES
+// =====================================================
+
+export interface CycleCount {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	countNumber: string;
+	countName: string;
+	description?: string;
+	countType:
+		| "full_physical"
+		| "spot_check"
+		| "abc_analysis"
+		| "high_velocity"
+		| "low_velocity"
+		| "location_specific"
+		| "category_specific";
+	countMethod: "manual" | "barcode_assisted" | "rfid" | "automated";
+	locationId?: string;
+	locationType?: "warehouse" | "pos";
+	zoneIds?: string[];
+	binIds?: string[];
+	itemSelectionType:
+		| "all_items"
+		| "specific_skus"
+		| "category"
+		| "velocity_based"
+		| "value_based"
+		| "accuracy_based";
+	selectionCriteria?: {
+		categories?: string[];
+		skus?: string[];
+		productIds?: string[];
+		minValue?: number;
+		maxValue?: number;
+		velocityThreshold?: number;
+		accuracyThreshold?: number;
+		lastCountedBefore?: string;
+	};
+	scheduledDate: Date;
+	scheduledBy: string;
+	frequency?: "weekly" | "monthly" | "quarterly" | "annual" | "ad_hoc";
+	isRecurring: boolean;
+	status:
+		| "scheduled"
+		| "in_progress"
+		| "completed"
+		| "reconciled"
+		| "cancelled"
+		| "on_hold";
+	startedAt?: Date;
+	completedAt?: Date;
+	reconciledAt?: Date;
+	assignedTo?: string[];
+	supervisorId?: string;
+	totalItemsToCount?: number;
+	totalItemsCounted: number;
+	itemsWithDiscrepancies: number;
+	accuracyPercentage?: number;
+	totalVarianceValue?: number;
+	tolerancePercentage: number;
+	requiresApproval: boolean;
+	approvedBy?: string;
+	approvedAt?: Date;
+	reviewedBy?: string;
+	reviewedAt?: Date;
+	reviewNotes?: string;
+	allowBlindCounts: boolean;
+	requirePhotos: boolean;
+	allowPartialCounts: boolean;
+	autoReconcileWithinTolerance: boolean;
+	createdAt: Date;
+	updatedAt: Date;
+	notes?: string;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface CycleCountItem {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	cycleCountId: string;
+	countNumber: string;
+	inventoryItemId: string;
+	productId: string;
+	variantId: string;
+	sku: string;
+	productName?: string;
+	locationId: string;
+	locationType: "warehouse" | "pos";
+	zoneId?: string;
+	binLocation?: string;
+	systemQuantity: number;
+	systemValue?: number;
+	unitCost?: number;
+	countedQuantity?: number;
+	countedValue?: number;
+	quantityVariance?: number;
+	valueVariance?: number;
+	variancePercentage?: number;
+	batchNumber?: string;
+	serialNumbers?: string[];
+	expiryDate?: Date;
+	countStatus:
+		| "pending"
+		| "counted"
+		| "recount_required"
+		| "discrepancy"
+		| "reconciled"
+		| "skipped";
+	countedBy?: string;
+	countedAt?: Date;
+	recountedBy?: string;
+	recountedAt?: Date;
+	recountQuantity?: number;
+	countMethod?: "manual" | "barcode" | "scale" | "estimated";
+	confidenceLevel?: "high" | "medium" | "low";
+	requiresRecount: boolean;
+	recountReason?: string;
+	conditionNotes?: string;
+	qualityIssues?: string[];
+	damageObserved: boolean;
+	isReconciled: boolean;
+	reconciledBy?: string;
+	reconciledAt?: Date;
+	reconciliationMethod?:
+		| "adjust_system"
+		| "accept_variance"
+		| "investigate"
+		| "recount";
+	createdAt: Date;
+	updatedAt: Date;
+	notes?: string;
+}
+
+export interface CreateCycleCountRequest {
+	countName: string;
+	description?: string;
+	countType: CycleCount["countType"];
+	countMethod: CycleCount["countMethod"];
+	locationId?: string;
+	locationType?: "warehouse" | "pos";
+	zoneIds?: string[];
+	binIds?: string[];
+	itemSelectionType: CycleCount["itemSelectionType"];
+	selectionCriteria?: CycleCount["selectionCriteria"];
+	scheduledDate: Date;
+	frequency?: CycleCount["frequency"];
+	isRecurring?: boolean;
+	assignedTo?: string[];
+	supervisorId?: string;
+	tolerancePercentage?: number;
+	requiresApproval?: boolean;
+	allowBlindCounts?: boolean;
+	requirePhotos?: boolean;
+	allowPartialCounts?: boolean;
+	autoReconcileWithinTolerance?: boolean;
+	notes?: string;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface CountItemRequest {
+	cycleCountItemId: string;
+	countedQuantity: number;
+	countMethod?: "manual" | "barcode" | "scale" | "estimated";
+	confidenceLevel?: "high" | "medium" | "low";
+	conditionNotes?: string;
+	qualityIssues?: string[];
+	damageObserved?: boolean;
+	notes?: string;
+}
+
+export interface CycleCountFilter
+	extends BaseFilter,
+		DateRangeFilter,
+		StatusFilter {
+	countType?: string;
+	locationId?: string;
+	scheduledBy?: string;
+	hasDiscrepancies?: boolean;
+	frequency?: string;
+}
+
+// =====================================================
+// TRANSFER TYPES
+// =====================================================
+
+export interface TransferRequest {
+	sourceLocationId: string;
+	sourceLocationType: "warehouse" | "pos";
+	destinationLocationId: string;
+	destinationLocationType: "warehouse" | "pos";
+	transferType: "standard" | "urgent" | "emergency" | "rebalancing" | "return";
+	priority: "low" | "normal" | "high" | "urgent";
+	expectedShipDate?: Date;
+	expectedReceiveDate?: Date;
+	shippingMethod?: string;
+	notes?: string;
+	specialInstructions?: string;
+	requiresApproval?: boolean;
+	allowPartialTransfer?: boolean;
+	requiresInspection?: boolean;
+	items: Array<{
+		inventoryItemId: string;
+		requestedQuantity: number;
+		batchNumber?: string;
+		serialNumbers?: string[];
+		sourceZoneId?: string;
+		sourceBinLocation?: string;
+		destinationZoneId?: string;
+		destinationBinLocation?: string;
+		notes?: string;
+	}>;
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface TransferItem {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	transferId: string;
+	transferNumber: string;
+	inventoryItemId: string;
+	productId: string;
+	variantId: string;
+	sku: string;
+	productName?: string;
+	requestedQuantity: number;
+	approvedQuantity?: number;
+	pickedQuantity?: number;
+	shippedQuantity?: number;
+	receivedQuantity?: number;
+	acceptedQuantity?: number;
+	rejectedQuantity: number;
+	unitCost?: number;
+	totalCost?: number;
+	batchNumber?: string;
+	serialNumbers?: string[];
+	expiryDate?: Date;
+	sourceZoneId?: string;
+	sourceBinLocation?: string;
+	destinationZoneId?: string;
+	destinationBinLocation?: string;
+	conditionAtPick?: string;
+	conditionAtReceive?: string;
+	qualityNotes?: string;
+	hasDiscrepancy: boolean;
+	discrepancyType?: "quantity" | "damage" | "missing" | "extra" | "condition";
+	discrepancyReason?: string;
+	discrepancyResolution?: "accept" | "reject" | "adjust" | "investigate";
+	status:
+		| "pending"
+		| "picked"
+		| "shipped"
+		| "received"
+		| "accepted"
+		| "rejected";
+	createdAt: Date;
+	updatedAt: Date;
+	pickedAt?: Date;
+	shippedAt?: Date;
+	receivedAt?: Date;
+	notes?: string;
+}
+
+export interface TransferFilter
+	extends BaseFilter,
+		DateRangeFilter,
+		StatusFilter {
+	transferType?: string;
+	priority?: string;
+	sourceLocationId?: string;
+	destinationLocationId?: string;
+	requestedBy?: string;
+	hasDiscrepancies?: boolean;
+}
+
+// =====================================================
+// AUTOMATION TYPES
+// =====================================================
+
+export interface AutomationRule {
+	id: string;
+	tenantId: string;
+	storeId: string;
+	ruleName: string;
+	description?: string;
+	ruleType:
+		| "reorder"
+		| "transfer"
+		| "adjustment"
+		| "alert"
+		| "threshold"
+		| "expiry"
+		| "velocity"
+		| "optimization";
+	scope: "global" | "location" | "category" | "product" | "sku";
+	locationIds?: string[];
+	locationTypes?: string[];
+	productCategories?: string[];
+	productIds?: string[];
+	skus?: string[];
+	triggerConditions?: Record<string, unknown>;
+	actions?: Array<{
+		actionType: string;
+		priority: "low" | "medium" | "high" | "urgent";
+		parameters: Record<string, unknown>;
+		requiresApproval?: boolean;
+		approvalRoles?: string[];
+	}>;
+	aiEnabled: boolean;
+	mlModelId?: string;
+	confidenceThreshold?: number;
+	learningEnabled: boolean;
+	executionMode: "automatic" | "manual_approval" | "suggestion_only";
+	maxExecutionsPerDay?: number;
+	cooldownPeriod?: number;
+	priority: number;
+	executionOrder: number;
+	isScheduled: boolean;
+	schedulePattern?: string;
+	nextScheduledRun?: Date;
+	isActive: boolean;
+	canOverride: boolean;
+	temporaryDisableUntil?: Date;
+	executionCount: number;
+	successCount: number;
+	failureCount: number;
+	lastExecutedAt?: Date;
+	lastSuccessAt?: Date;
+	lastFailureAt?: Date;
+	averageExecutionTime?: number;
+	successRate?: number;
+	costSavings?: number;
+	createdBy: string;
+	updatedBy?: string;
+	createdAt: Date;
+	updatedAt: Date;
+	tags?: string[];
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface CreateAutomationRuleRequest {
+	ruleName: string;
+	description?: string;
+	ruleType: AutomationRule["ruleType"];
+	scope: AutomationRule["scope"];
+	locationIds?: string[];
+	locationTypes?: string[];
+	productCategories?: string[];
+	productIds?: string[];
+	skus?: string[];
+	triggerConditions?: Record<string, unknown>;
+	actions?: AutomationRule["actions"];
+	aiEnabled?: boolean;
+	mlModelId?: string;
+	confidenceThreshold?: number;
+	learningEnabled?: boolean;
+	executionMode?: AutomationRule["executionMode"];
+	maxExecutionsPerDay?: number;
+	cooldownPeriod?: number;
+	priority?: number;
+	executionOrder?: number;
+	isScheduled?: boolean;
+	schedulePattern?: string;
+	nextScheduledRun?: Date;
+	canOverride?: boolean;
+	tags?: string[];
+	customAttributes?: Record<string, unknown>;
+}
+
+export interface AutomationRuleFilter extends BaseFilter, StatusFilter {
+	ruleType?: string;
+	scope?: string;
+	aiEnabled?: boolean;
+	executionMode?: string;
+	isScheduled?: boolean;
+	tags?: string[];
+}
+
+export interface AIRecommendation {
+	id: string;
+	type: "reorder" | "transfer" | "pricing" | "optimization";
+	confidence: number;
+	priority: "low" | "medium" | "high" | "urgent";
+	title: string;
+	description: string;
+	impact: {
+		financial?: number;
+		operational?: string;
+		risk?: string;
+	};
+	actions: Array<{
+		actionType: string;
+		parameters: Record<string, unknown>;
+		estimatedOutcome: string;
+	}>;
+	dataPoints: Record<string, unknown>;
+	expiresAt?: Date;
+	createdAt: Date;
+}
+
+// =====================================================
+// ANALYTICS AND REPORTING TYPES
+// =====================================================
+
+export interface InventorySnapshot {
+	date: Date;
+	totalItems: number;
+	totalValue: number;
+	lowStockItems: number;
+	outOfStockItems: number;
+	averageTurnover: number;
+	topMovingItems: Array<{
+		sku: string;
+		productName: string;
+		quantity: number;
+		value: number;
+	}>;
+}
+
+export interface LowStockAlert {
+	id: string;
+	inventoryItemId: string;
+	sku: string;
+	productName: string;
+	locationId: string;
+	locationName: string;
+	currentQuantity: number;
+	reorderPoint: number;
+	safetyStock: number;
+	daysOfSupply: number;
+	severity: "low" | "medium" | "high" | "critical";
+	createdAt: Date;
+}
+
+export interface InventoryInsight {
+	type: "trend" | "anomaly" | "opportunity" | "risk";
+	title: string;
+	description: string;
+	metric: string;
+	value: number;
+	change: number;
+	changeDirection: "up" | "down" | "stable";
+	timeframe: string;
+	actionable: boolean;
+	recommendations?: string[];
+}
+
+export interface DashboardMetrics {
+	totalItems: number;
+	totalValue: number;
+	lowStockCount: number;
+	outOfStockCount: number;
+	expiringSoonCount: number;
+	pendingTransfersCount: number;
+	averageTurnoverRate: number;
+	inventoryAccuracy: number;
+	recentActivity: Array<{
+		type: string;
+		description: string;
+		timestamp: Date;
+	}>;
+	alerts: LowStockAlert[];
+	insights: InventoryInsight[];
+}
+
+export interface InventoryOverview {
+	totalItems: number;
+	totalValue: number;
+	totalLocations: number;
+	lowStockPercentage: number;
+	outOfStockPercentage: number;
+	turnoverRate: number;
+	accuracy: number;
+	categoryBreakdown: Array<{
+		category: string;
+		itemCount: number;
+		value: number;
+		percentage: number;
+	}>;
+	locationBreakdown: Array<{
+		locationId: string;
+		locationName: string;
+		itemCount: number;
+		value: number;
+		utilization: number;
+	}>;
+}
+
+export interface StockMovementReport {
+	period: {
+		startDate: Date;
+		endDate: Date;
+	};
+	totalMovements: number;
+	inboundMovements: number;
+	outboundMovements: number;
+	adjustments: number;
+	transfers: number;
+	valueChange: number;
+	topMovingItems: Array<{
+		sku: string;
+		productName: string;
+		totalMovement: number;
+		inbound: number;
+		outbound: number;
+		netChange: number;
+	}>;
+	movementsByDay: Array<{
+		date: Date;
+		inbound: number;
+		outbound: number;
+		net: number;
+	}>;
+}
+
+export interface VelocityAnalysis {
+	period: {
+		startDate: Date;
+		endDate: Date;
+	};
+	items: Array<{
+		sku: string;
+		productName: string;
+		currentQuantity: number;
+		totalSold: number;
+		averageDailySales: number;
+		turnoverRate: number;
+		daysOfSupply: number;
+		velocityCategory: "fast" | "medium" | "slow" | "dead";
+		reorderRecommendation: string;
+	}>;
+	summary: {
+		fastMoving: number;
+		mediumMoving: number;
+		slowMoving: number;
+		deadStock: number;
+		averageTurnover: number;
+	};
+}
+
+export interface ABCClassification {
+	items: Array<{
+		sku: string;
+		productName: string;
+		annualValue: number;
+		annualQuantity: number;
+		cumulativeValue: number;
+		cumulativePercentage: number;
+		classification: "A" | "B" | "C";
+		recommendedManagement: string;
+	}>;
+	summary: {
+		classA: { count: number; valuePercentage: number };
+		classB: { count: number; valuePercentage: number };
+		classC: { count: number; valuePercentage: number };
+	};
+}
+
+export interface StockValuation {
+	totalValue: number;
+	valuationMethod: "FIFO" | "LIFO" | "weighted_average";
+	byCategory: Array<{
+		category: string;
+		value: number;
+		percentage: number;
+		itemCount: number;
+	}>;
+	byLocation: Array<{
+		locationId: string;
+		locationName: string;
+		value: number;
+		percentage: number;
+		itemCount: number;
+	}>;
+	ageAnalysis: Array<{
+		ageRange: string;
+		value: number;
+		percentage: number;
+		itemCount: number;
+	}>;
+}
+
+export interface ExpiryReport {
+	expiredItems: Array<{
+		sku: string;
+		productName: string;
+		batchNumber: string;
+		expiryDate: Date;
+		quantity: number;
+		value: number;
+		daysExpired: number;
+		locationName: string;
+	}>;
+	expiringSoon: Array<{
+		sku: string;
+		productName: string;
+		batchNumber: string;
+		expiryDate: Date;
+		quantity: number;
+		value: number;
+		daysUntilExpiry: number;
+		locationName: string;
+	}>;
+	summary: {
+		totalExpiredValue: number;
+		totalExpiredQuantity: number;
+		expiringInNext30Days: number;
+		expiringInNext7Days: number;
+		averageDaysToExpiry: number;
+	};
+}
+
+export interface ForecastData {
+	sku: string;
+	productName: string;
+	forecastPeriod: {
+		startDate: Date;
+		endDate: Date;
+	};
+	historicalDemand: Array<{
+		date: Date;
+		demand: number;
+		actual?: number;
+	}>;
+	forecastedDemand: Array<{
+		date: Date;
+		predicted: number;
+		confidence: number;
+		upperBound: number;
+		lowerBound: number;
+	}>;
+	accuracy: {
+		mape: number; // Mean Absolute Percentage Error
+		rmse: number; // Root Mean Square Error
+		bias: number;
+	};
+	seasonality: {
+		detected: boolean;
+		pattern: string;
+		strength: number;
+	};
+	trend: {
+		direction: "up" | "down" | "stable";
+		strength: number;
+	};
+}
+
+export interface ReorderRecommendation {
+	sku: string;
+	productName: string;
+	locationId: string;
+	locationName: string;
+	currentQuantity: number;
+	reorderPoint: number;
+	safetyStock: number;
+	recommendedOrderQuantity: number;
+	leadTime: number;
+	daysOfSupply: number;
+	priority: "low" | "medium" | "high" | "urgent";
+	reasoning: string[];
+	estimatedCost: number;
+	estimatedStockoutRisk: number;
+	supplierRecommendations: Array<{
+		supplierId: string;
+		supplierName: string;
+		unitPrice: number;
+		leadTime: number;
+		minimumOrder: number;
+		reliability: number;
+	}>;
+	aiConfidence: number;
+	lastUpdated: Date;
+}
+
+// Re-export common types
+export type {
+	OperationResult,
+	PaginatedResult,
+	TenantContext,
+	UserContext,
+} from "../schemas/types";