@de./types 1.0.0

package/src/lsp/hub/analytics.ts

@@ -0,0 +1,236 @@
+import { Type, Static } from '@sinclair/typebox'
+import { DurationSchema } from '../../time'
+import { ServiceLevelSchema, MoneySchema, PerTimeSchema } from '../../measure'
+import { HubCapacitySchema } from './capacities'
+
+export const HubDemandAnalysisSchema = Type.Object({
+  historicalVolume: Type.Array(Type.Object({
+    period: Type.String(),
+    actualVolume: Type.Number(),
+    peakVolume: Type.Number(),
+    averageVolume: Type.Number(),
+    serviceLevel: ServiceLevelSchema,
+    seasonalityFactor: Type.Number()
+  })),
+  
+  forecastedVolume: Type.Array(Type.Object({
+    period: Type.String(),
+    forecastedVolume: Type.Number(),
+    confidenceLevel: Type.Number({ minimum: 0, maximum: 100 }),
+    growthRate: Type.Number(),
+    demandVariability: Type.Number(),
+    serviceLevel: ServiceLevelSchema
+  })),
+  
+  demandDrivers: Type.Array(Type.Object({
+    driver: Type.String(),
+    impact: Type.Union([
+      Type.Literal('LOW'),
+      Type.Literal('MEDIUM'),
+      Type.Literal('HIGH'),
+      Type.Literal('CRITICAL')
+    ]),
+    description: Type.String(),
+    correlation: Type.Number({ minimum: -1, maximum: 1 })
+  })),
+  
+  seasonalPatterns: Type.Array(Type.Object({
+    season: Type.String(),
+    volumeMultiplier: Type.Number({ minimum: 0 }),
+    durationWeeks: Type.Number({ minimum: 0 }),
+    peakWeeks: Type.Array(Type.Number()),
+    resourceRequirements: Type.String()
+  }))
+})
+
+// Capacity gaps and constraints
+export const HubCapacityGapsSchema = Type.Array(Type.Object({
+  gapId: Type.String(),
+  period: Type.String(),
+  gapType: Type.Union([
+    Type.Literal('SORTING_CAPACITY'),
+    Type.Literal('INBOUND_CAPACITY'),
+    Type.Literal('OUTBOUND_CAPACITY'),
+    Type.Literal('STORAGE_CAPACITY'),
+    Type.Literal('EQUIPMENT_CAPACITY'),
+    Type.Literal('STAFFING_CAPACITY'),
+    Type.Literal('NETWORK_CAPACITY'),
+    Type.Literal('TECHNOLOGY_CAPACITY'),
+    Type.Literal('FINANCIAL_CAPACITY')
+  ]),
+  gapSize: Type.Number(),
+  gapUnit: Type.String(),
+  impact: Type.Union([
+    Type.Literal('LOW'),
+    Type.Literal('MEDIUM'),
+    Type.Literal('HIGH'),
+    Type.Literal('CRITICAL')
+  ]),
+  description: Type.String(),
+  rootCause: Type.String(),
+  affectedServiceLevels: Type.Array(ServiceLevelSchema),
+  urgency: Type.Union([
+    Type.Literal('LOW'),
+    Type.Literal('MEDIUM'),
+    Type.Literal('HIGH'),
+    Type.Literal('IMMEDIATE')
+  ]),
+  estimatedRevenueLoss: Type.Optional(MoneySchema),
+  customerImpact: Type.String()
+}))
+
+// Optimization opportunities
+export const HubOptimizationOpportunitiesSchema = Type.Array(Type.Object({
+  opportunityId: Type.String(),
+  category: Type.Union([
+    Type.Literal('SORTING_OPTIMIZATION'),
+    Type.Literal('FLOW_OPTIMIZATION'),
+    Type.Literal('EQUIPMENT_UPGRADE'),
+    Type.Literal('LAYOUT_REDESIGN'),
+    Type.Literal('STAFFING_OPTIMIZATION'),
+    Type.Literal('TECHNOLOGY_ENHANCEMENT'),
+    Type.Literal('PROCESS_AUTOMATION'),
+    Type.Literal('NETWORK_OPTIMIZATION')
+  ]),
+  description: Type.String(),
+  currentState: Type.String(),
+  proposedState: Type.String(),
+  expectedBenefit: Type.Object({
+    capacityIncrease: Type.Optional(Type.Number({ description: 'percentage' })),
+    throughputIncrease: Type.Optional(PerTimeSchema),
+    efficiencyGain: Type.Optional(Type.Number({ description: 'percentage' })),
+    costReduction: Type.Optional(MoneySchema),
+    qualityImprovement: Type.Optional(Type.Number({ description: 'percentage' })),
+    timeReduction: Type.Optional(DurationSchema)
+  }),
+  implementation: Type.Object({
+    effort: Type.Union([
+      Type.Literal('LOW'),
+      Type.Literal('MEDIUM'),
+      Type.Literal('HIGH'),
+      Type.Literal('MAJOR')
+    ]),
+    duration: DurationSchema,
+    cost: Type.Optional(MoneySchema),
+    resources: Type.Array(Type.String()),
+    risks: Type.Array(Type.String()),
+    dependencies: Type.Array(Type.String()),
+    downtime: Type.Optional(DurationSchema)
+  }),
+  priority: Type.Union([
+    Type.Literal('LOW'),
+    Type.Literal('MEDIUM'),
+    Type.Literal('HIGH'),
+    Type.Literal('CRITICAL')
+  ]),
+  roi: Type.Optional(Type.Number({ description: 'percentage' })),
+  paybackPeriod: Type.Optional(DurationSchema)
+}))
+
+// Strategic recommendations
+export const HubStrategicRecommendationsSchema = Type.Array(Type.Object({
+  recommendationId: Type.String(),
+  type: Type.Union([
+    Type.Literal('IMMEDIATE_ACTION'),
+    Type.Literal('SHORT_TERM_IMPROVEMENT'),
+    Type.Literal('MEDIUM_TERM_STRATEGY'),
+    Type.Literal('LONG_TERM_INVESTMENT'),
+    Type.Literal('CONTINGENCY_PLAN')
+  ]),
+  title: Type.String(),
+  description: Type.String(),
+  rationale: Type.String(),
+  expectedOutcome: Type.String(),
+  businessCase: Type.String(),
+  timeline: Type.Object({
+    startDate: Type.Optional(Type.Number()),
+    endDate: Type.Optional(Type.Number()),
+    duration: DurationSchema,
+    milestones: Type.Array(Type.Object({
+      milestone: Type.String(),
+      date: Type.Number(),
+      deliverable: Type.String()
+    }))
+  }),
+  resources: Type.Object({
+    budget: Type.Optional(MoneySchema),
+    staff: Type.Optional(Type.Number()),
+    equipment: Type.Optional(Type.Array(Type.String())),
+    technology: Type.Optional(Type.Array(Type.String())),
+    facilities: Type.Optional(Type.Array(Type.String())),
+    externalServices: Type.Optional(Type.Array(Type.String()))
+  }),
+  successMetrics: Type.Array(Type.Object({
+    metric: Type.String(),
+    currentValue: Type.Number(),
+    targetValue: Type.Number(),
+    unit: Type.String(),
+    measurementFrequency: Type.String(),
+    reportingMethod: Type.String()
+  })),
+  dependencies: Type.Array(Type.String()),
+  risks: Type.Array(Type.Object({
+    risk: Type.String(),
+    probability: Type.Union([
+      Type.Literal('LOW'),
+      Type.Literal('MEDIUM'),
+      Type.Literal('HIGH')
+    ]),
+    impact: Type.Union([
+      Type.Literal('LOW'),
+      Type.Literal('MEDIUM'),
+      Type.Literal('HIGH'),
+      Type.Literal('CRITICAL')
+    ]),
+    mitigation: Type.String(),
+    contingency: Type.String()
+  })),
+  approval: Type.Object({
+    approvalRequired: Type.Boolean(),
+    approvers: Type.Array(Type.String()),
+    estimatedApprovalTime: DurationSchema
+  })
+}))
+
+// Current capacity state and utilization
+export const HubCapacityStateSchema = Type.Object({
+  capacity: HubCapacitySchema,
+  utilizationSummary: Type.Object({
+    overallUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    sortingUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    inboundUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    outboundUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    crossDockUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    storageUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    equipmentUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    staffUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    networkUtilization: Type.Number({ minimum: 0, maximum: 100 })
+  })
+})
+
+// Hub capacity analysis (broken down into sections)
+export const HubCapacityAnalysisSchema = Type.Object({
+  hubId: Type.String(),
+  analysisDate: Type.Number(),
+  analysisPeriod: Type.Object({
+    start: Type.Number(),
+    end: Type.Number()
+  }),
+  
+  currentState: HubCapacityStateSchema,
+  demandAnalysis: HubDemandAnalysisSchema,
+  capacityGaps: HubCapacityGapsSchema,
+  optimizationOpportunities: HubOptimizationOpportunitiesSchema,
+  recommendations: HubStrategicRecommendationsSchema
+})
+
+// ===== INTEGRATION AND UTILITY SCHEMAS =====
+
+
+// Hub Analytics Types (Broken Down)
+export type HubDemandAnalysis = Static<typeof HubDemandAnalysisSchema>
+export type HubCapacityGaps = Static<typeof HubCapacityGapsSchema>
+export type HubOptimizationOpportunities = Static<typeof HubOptimizationOpportunitiesSchema>
+export type HubStrategicRecommendations = Static<typeof HubStrategicRecommendationsSchema>
+export type HubCapacityState = Static<typeof HubCapacityStateSchema>
+export type HubCapacityAnalysis = Static<typeof HubCapacityAnalysisSchema>