@axova/shared 1.0.0

package/src/interfaces/inventory-types.ts

@@ -0,0 +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";