@burdenoff/microfe-movethewheels 2026.510.105

package/src/movethewheels/types/index.ts

@@ -0,0 +1,744 @@
+/**
+ * MoveTheWheels Microfrontend Types
+ *
+ * All TypeScript type definitions for the logistics platform.
+ */
+
+import type { ReactNode } from 'react';
+
+// Re-export from fe-libs for convenience
+export interface NavItem {
+  id: string;
+  label: string;
+  icon?: ReactNode;
+  path: string;
+  badge?: number;
+  order?: number;
+  group?: string;
+  visible?: boolean;
+  children?: NavItem[];
+}
+
+export interface FooterItem {
+  id: string;
+  label: string;
+  icon?: string;
+  onClick?: () => void;
+  type?: 'status' | 'action' | 'info';
+  order?: number;
+  badge?: string;
+  section?: 'left' | 'center' | 'right';
+  visible?: boolean;
+}
+
+export interface User {
+  id: string;
+  email: string;
+  firstName?: string;
+  lastName?: string;
+  avatar?: string;
+  username?: string;
+  name?: string;
+  role?: string;
+}
+
+export interface MicrofrontendRootProps {
+  basePath: string;
+  navigate: (path: string) => void;
+  currentUser?: User | null;
+  tenantId?: string;
+  workspaceId?: string;
+  apiGatewayUrl?: string;
+  authToken?: string;
+  /**
+   * Workspace-scoped JWT token. The gateway requires both authToken (Authorization)
+   * and workspaceToken (X-Workspace-Authorization) for workspace-scoped operations.
+   */
+  workspaceToken?: string;
+  onAuthError?: () => void;
+  registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+  registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+}
+
+// MoveTheWheels specific props
+export interface MoveTheWheelsRootProps extends MicrofrontendRootProps {
+  defaultView?: 'dashboard' | 'orders' | 'fleet';
+  onOrderSelect?: (order: Order) => void;
+}
+
+// User roles
+export type UserRole =
+  | 'business_owner'
+  | 'logistics_manager'
+  | 'operations_coordinator'
+  | 'warehouse_supervisor'
+  | 'warehouse_worker'
+  | 'driver'
+  | 'fleet_operator'
+  | 'dispatcher'
+  | 'customer_b2b'
+  | 'customer_b2c'
+  | 'service_provider'
+  | 'marketplace_vendor';
+
+// Address type
+export interface Address {
+  street: string;
+  city: string;
+  state: string;
+  postalCode: string;
+  country: string;
+  latitude?: number;
+  longitude?: number;
+}
+
+// Location type
+export interface Location {
+  latitude: number;
+  longitude: number;
+  address?: string;
+  timestamp?: Date;
+  accuracy?: number;
+}
+
+// Dimensions type
+export interface Dimensions {
+  length: number;
+  width: number;
+  height: number;
+  unit: 'cm' | 'in' | 'm';
+}
+
+// Company type
+export interface Company {
+  id: string;
+  name: string;
+  type: string;
+  address: Address;
+  contactInfo: {
+    primaryEmail: string;
+    primaryPhone: string;
+    website?: string;
+  };
+  settings: {
+    timezone: string;
+    currency: string;
+    language: string;
+    notifications: {
+      email: boolean;
+      sms: boolean;
+      push: boolean;
+      orderUpdates: boolean;
+      deliveryAlerts: boolean;
+      systemNotifications: boolean;
+    };
+    integration: Record<string, unknown>;
+  };
+  subscription: {
+    id: string;
+    name: string;
+    type: string;
+    features: string[];
+    limits: {
+      orders: number;
+      users: number;
+      warehouses: number;
+      vehicles: number;
+      storage: number;
+      apiCalls: number;
+    };
+    pricing: {
+      monthly: number;
+      annual: number;
+      currency: string;
+      billingCycle: string;
+    };
+    status: string;
+    startDate: Date;
+  };
+  isActive: boolean;
+  createdAt: Date;
+}
+
+// Customer type
+export interface Customer {
+  id: string;
+  name: string;
+  email: string;
+  phone: string;
+  type: 'b2b' | 'b2c';
+  company?: string;
+  address: Address;
+  businessLicense?: string;
+  taxId?: string;
+  website?: string;
+  preferredContactMethod: 'email' | 'phone' | 'both';
+  marketingOptIn: boolean;
+  notes?: string;
+  isActive: boolean;
+  rating: number;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+// Product type
+export interface Product {
+  id: string;
+  sku: string;
+  name: string;
+  description: string;
+  category: string;
+  brand?: string;
+  dimensions: Dimensions;
+  weight: number;
+  value: number;
+  barcode?: string;
+  images: string[];
+  attributes: Array<{
+    name: string;
+    value: string;
+    type: string;
+  }>;
+  hazardous: boolean;
+  temperatureControlled: boolean;
+  fragile: boolean;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+// Order item type
+export interface OrderItem {
+  id: string;
+  productId: string;
+  name: string;
+  description?: string;
+  quantity: number;
+  weight: number;
+  dimensions: Dimensions;
+  value: number;
+  sku: string;
+  barcode?: string;
+}
+
+// Order timeline event
+export interface OrderTimelineEvent {
+  timestamp: Date;
+  status: string;
+  location?: Address;
+  notes?: string;
+  performedBy: string;
+}
+
+// Order pricing
+export interface OrderPricing {
+  subtotal: number;
+  taxes: number;
+  fees: {
+    delivery: number;
+    handling: number;
+    insurance?: number;
+  };
+  total: number;
+  currency: string;
+  paymentMethod: string;
+  paymentStatus: 'pending' | 'paid' | 'failed' | 'refunded';
+}
+
+// Order status type
+export type OrderStatus =
+  | 'pending'
+  | 'confirmed'
+  | 'assigned'
+  | 'picked_up'
+  | 'in_transit'
+  | 'out_for_delivery'
+  | 'delivered'
+  | 'cancelled'
+  | 'failed';
+
+// Order type
+export interface Order {
+  id: string;
+  orderNumber: string;
+  customerId: string;
+  customerInfo: {
+    name: string;
+    email: string;
+    phone: string;
+    company?: string;
+    preferredDeliveryTime?: string;
+    deliveryInstructions?: string;
+  };
+  items: OrderItem[];
+  status: OrderStatus;
+  orderType: 'b2b' | 'b2c';
+  priority: 'low' | 'normal' | 'high' | 'urgent';
+  pickupAddress: Address;
+  deliveryAddress: Address;
+  scheduledPickup?: Date;
+  scheduledDelivery?: Date;
+  actualPickup?: Date;
+  actualDelivery?: Date;
+  driverId?: string;
+  vehicleId?: string;
+  trackingNumber: string;
+  specialInstructions?: string;
+  pricing: OrderPricing;
+  timeline: OrderTimelineEvent[];
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+// Vehicle type
+export type VehicleType = 'van' | 'truck' | 'motorcycle' | 'bicycle' | 'car';
+export type VehicleStatus = 'available' | 'assigned' | 'maintenance' | 'out_of_service';
+
+export interface VehicleDocument {
+  id: string;
+  type: 'registration' | 'insurance' | 'inspection' | 'permit';
+  documentUrl: string;
+  expiryDate: Date;
+  verified: boolean;
+}
+
+export interface Vehicle {
+  id: string;
+  vehicleNumber: string;
+  type: VehicleType;
+  make: string;
+  model: string;
+  year: number;
+  capacity: {
+    weight: number;
+    volume: number;
+    pallets?: number;
+  };
+  status: VehicleStatus;
+  driverId?: string;
+  currentLocation?: Location;
+  lastMaintenance?: Date;
+  nextMaintenance?: Date;
+  fuelLevel?: number;
+  mileage?: number;
+  documents: VehicleDocument[];
+  createdAt: Date;
+}
+
+// Driver type
+export type DriverStatus = 'available' | 'busy' | 'offline' | 'on_break';
+
+export interface DriverDocument {
+  id: string;
+  type: 'license' | 'insurance' | 'certification' | 'background_check';
+  documentUrl: string;
+  expiryDate: Date;
+  verified: boolean;
+}
+
+export interface Driver {
+  id: string;
+  userId: string;
+  fullName: string;
+  employeeId: string;
+  licenseNumber: string;
+  licenseType: string;
+  licenseExpiry: Date;
+  vehicleIds: string[];
+  assignedVehicle?: string;
+  status: DriverStatus;
+  currentLocation?: Location;
+  joinDate: Date;
+  baseSalary: number;
+  completedOrders: number;
+  todayOrders: number;
+  specializations: string[];
+  workingHours: {
+    startTime: string;
+    endTime: string;
+    workingDays: string[];
+    maxHoursPerDay: number;
+    maxHoursPerWeek: number;
+    currentHoursToday: number;
+    currentHoursThisWeek: number;
+  };
+  ratings: {
+    overall: number;
+    punctuality: number;
+    communication: number;
+    carefulHandling: number;
+    professionalism: number;
+    onTimeDelivery: number;
+    totalRatings: number;
+  };
+  documents: DriverDocument[];
+  earnings: {
+    totalEarnings: number;
+    weeklyEarnings: number;
+    monthlyEarnings: number;
+    pendingPayments: number;
+    completedDeliveries: number;
+    bonuses: number;
+  };
+  compliance: {
+    hoursOfService: boolean;
+    documentation: boolean;
+    vehicleInspection: boolean;
+    lastUpdate: Date;
+  };
+  createdAt: Date;
+}
+
+// Warehouse zone type
+export interface WarehouseZone {
+  id: string;
+  name: string;
+  type: 'receiving' | 'storage' | 'picking' | 'packing' | 'shipping';
+  location: string;
+  capacity: number;
+  currentOccupancy: number;
+}
+
+// Warehouse equipment type
+export interface WarehouseEquipment {
+  id: string;
+  type: string;
+  model: string;
+  status: 'operational' | 'maintenance' | 'out_of_service';
+  lastMaintenance: Date;
+  nextMaintenance: Date;
+}
+
+// Warehouse type
+export interface Warehouse {
+  id: string;
+  name: string;
+  code: string;
+  address: Address;
+  type: 'distribution' | 'fulfillment' | 'cold_storage' | 'cross_dock';
+  capacity: {
+    totalSpace: number;
+    usedSpace: number;
+    totalPallets: number;
+    usedPallets: number;
+    specialAreas: Array<{
+      type: string;
+      capacity: number;
+      currentUsage: number;
+      temperature?: { min: number; max: number; unit: string };
+    }>;
+  };
+  operatingHours: Record<
+    string,
+    {
+      open: string;
+      close: string;
+    } | null
+  >;
+  contacts: Array<{
+    primaryEmail: string;
+    primaryPhone: string;
+  }>;
+  zones: WarehouseZone[];
+  equipment: WarehouseEquipment[];
+  staff: Array<{
+    userId: string;
+    role: string;
+    shift: string;
+    permissions: string[];
+  }>;
+  metrics: {
+    throughput: number;
+    accuracy: number;
+    productivity: number;
+    utilization: number;
+    ordersFulfilled: number;
+    averageProcessingTime: number;
+    lastUpdated: Date;
+  };
+  isActive: boolean;
+  createdAt: Date;
+}
+
+// Inventory movement type
+export interface InventoryMovement {
+  id: string;
+  type: 'inbound' | 'outbound' | 'transfer' | 'adjustment';
+  quantity: number;
+  reason: string;
+  reference?: string;
+  performedBy: string;
+  timestamp: Date;
+  cost?: number;
+}
+
+// Inventory type
+export interface Inventory {
+  id: string;
+  productId: string;
+  warehouseId: string;
+  zoneId: string;
+  quantity: number;
+  reservedQuantity: number;
+  availableQuantity: number;
+  reorderLevel: number;
+  maxLevel: number;
+  lastRestocked: Date;
+  location: {
+    aisle: string;
+    shelf: string;
+    position: string;
+    level: number;
+  };
+  movements: InventoryMovement[];
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+// Route stop type
+export interface RouteStop {
+  id: string;
+  orderId: string;
+  sequence: number;
+  address: Address;
+  type: 'pickup' | 'delivery';
+  scheduledTime: Date;
+  actualTime?: Date;
+  duration: number;
+  status: 'pending' | 'completed' | 'skipped' | 'failed';
+  notes?: string;
+}
+
+// Traffic condition type
+export interface TrafficCondition {
+  timestamp: Date;
+  condition: 'light' | 'moderate' | 'heavy' | 'severe';
+  delay: number;
+  location: string;
+}
+
+// Route type
+export interface Route {
+  id: string;
+  name: string;
+  driverId: string;
+  vehicleId: string;
+  status: 'planned' | 'in_progress' | 'completed' | 'cancelled';
+  stops: RouteStop[];
+  distance: number;
+  estimatedDuration: number;
+  actualDuration?: number;
+  startTime?: Date;
+  endTime?: Date;
+  optimized: boolean;
+  trafficConditions: TrafficCondition[];
+  createdAt: Date;
+}
+
+// Tracking alert type
+export interface TrackingAlert {
+  id: string;
+  type: 'delay' | 'deviation' | 'temperature' | 'damage' | 'security';
+  severity: 'low' | 'medium' | 'high' | 'critical';
+  message: string;
+  timestamp: Date;
+  acknowledged: boolean;
+  resolvedAt?: Date;
+}
+
+// Tracking type
+export interface Tracking {
+  id: string;
+  entityId: string;
+  entityType: 'order' | 'vehicle' | 'driver';
+  currentLocation: Location;
+  locationHistory: Location[];
+  status: string;
+  estimatedArrival?: Date;
+  nextCheckpoint?: string;
+  alerts: TrackingAlert[];
+  lastUpdated: Date;
+}
+
+// Notification type
+export interface Notification {
+  id: string;
+  type: 'success' | 'warning' | 'error' | 'info';
+  title: string;
+  message: string;
+  read: boolean;
+  actionUrl?: string;
+  createdAt: Date;
+}
+
+// Dashboard widget type
+export interface DashboardWidget {
+  id: string;
+  type: 'metric' | 'chart' | 'table' | 'map' | 'list';
+  title: string;
+  size: 'small' | 'medium' | 'large';
+  position: { x: number; y: number };
+  config: {
+    dataSource: string;
+    chartType?: string;
+    refreshInterval?: number;
+    metrics?: string[];
+    filters?: Record<string, unknown>;
+  };
+}
+
+// Service provider types
+export interface ServiceProvider {
+  id: string;
+  userId: string;
+  companyName: string;
+  businessType: string;
+  description: string;
+  services: string[];
+  coverage: {
+    countries: string[];
+    states: string[];
+    cities: string[];
+    zipCodes: string[];
+    serviceRadius: number;
+    domesticService: boolean;
+    internationalService: boolean;
+  };
+  certifications: Array<{
+    id: string;
+    name: string;
+    issuingBody: string;
+    certificateNumber: string;
+    issueDate: Date;
+    expiryDate: Date;
+    documentUrl: string;
+    verified: boolean;
+  }>;
+  pricing: {
+    model: string;
+    basePrice: number;
+    currency: string;
+    minimumCharge: number;
+    additionalFees: unknown[];
+    discounts: unknown[];
+    negotiable: boolean;
+  };
+  availability: {
+    operatingHours: Record<string, { open: string; close: string } | null>;
+    responseTime: number;
+    leadTime: number;
+    capacity: number;
+    blackoutDates: string[];
+    emergencyService: boolean;
+  };
+  rating: number;
+  totalReviews: number;
+  verificationStatus: string;
+  documents: unknown[];
+  contactInfo: {
+    primaryEmail: string;
+    primaryPhone: string;
+    website?: string;
+  };
+  isActive: boolean;
+  featured: boolean;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface ServiceOffering {
+  id: string;
+  serviceProviderId: string;
+  title: string;
+  description: string;
+  category: string;
+  subCategory: string;
+  features: string[];
+  pricing: {
+    basePrice: number;
+    currency: string;
+    pricePerUnit: number;
+    unit: string;
+    minimumCharge: number;
+  };
+  duration: {
+    estimated: number;
+    minimum: number;
+    maximum: number;
+    unit: string;
+  };
+  requirements: string[];
+  capacity: {
+    maxWeight: number;
+    maxVolume: number;
+    maxDistance: number;
+    simultaneousOrders: number;
+  };
+  images: string[];
+  tags: string[];
+  isActive: boolean;
+  createdAt: Date;
+}
+
+// Analytics types
+export interface Analytics {
+  overview: {
+    totalOrders: number;
+    totalRevenue: number;
+    activeVehicles: number;
+    onTimeDeliveryRate: number;
+    customerSatisfaction: number;
+  };
+  trends: {
+    dailyOrders: Array<{ date: string; orders: number }>;
+    revenue: Array<{ month: string; revenue: number }>;
+  };
+  fleet: {
+    utilization: number;
+    totalVehicles: number;
+    activeVehicles: number;
+    maintenanceVehicles: number;
+    outOfServiceVehicles: number;
+    fuelEfficiency: number;
+  };
+  performance: {
+    onTimePickup: number;
+    onTimeDelivery: number;
+    damagedItems: number;
+    customerComplaints: number;
+    driverRatings: number;
+  };
+}
+
+// Filter types
+export interface OrderFilter {
+  status?: OrderStatus;
+  customerId?: string;
+  driverId?: string;
+  dateFrom?: Date;
+  dateTo?: Date;
+  priority?: string;
+  orderType?: 'b2b' | 'b2c';
+}
+
+export interface FleetFilter {
+  vehicleType?: VehicleType;
+  status?: VehicleStatus;
+  driverId?: string;
+}
+
+export interface InventoryFilter {
+  warehouseId?: string;
+  productId?: string;
+  lowStock?: boolean;
+}
+
+export interface CustomerFilter {
+  type?: 'b2b' | 'b2c';
+  isActive?: boolean;
+  search?: string;
+}
+
+// Context value type
+export interface MoveTheWheelsContextValue extends MoveTheWheelsRootProps {
+  // Additional context values can be added here
+}