@de./types 1.0.0

package/src/lsp/fleet/index.ts

@@ -0,0 +1,327 @@
+import { Type, Static } from '@sinclair/typebox'
+import { BaseServiceDefinitionSchema, BaseServiceDefinitionUpdateSchema } from '../../service'
+import {
+	VehicleEngineSchema,
+	VehicleTypeSchema
+} from './vehicle'
+import { ActionRecordSchema, DateTimeZoneSchema } from '../../time'
+import { MoneySchema, WeightSchema, VolumeSchema } from '../../measure'
+import { EntityStatusSchema } from '../../entity'
+import {
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../../api'
+
+// Fleet Type/Purpose Schema
+export const FleetTypeSchema = Type.Union([
+  // PASSENGER TRANSIT
+  Type.Literal('URBAN_TRANSIT'),        // City buses, trotros
+  Type.Literal('INTERCITY'),            // Long-distance buses
+  Type.Literal('SHUTTLE'),              // Airport, hotel, event shuttles
+  Type.Literal('CORPORATE'),            // Employee transportation
+  Type.Literal('SCHOOL'),               // School buses
+  Type.Literal('UNIVERSITY'),           // Campus transit
+  Type.Literal('TOURISM'),              // Tour buses, sightseeing
+  Type.Literal('CHARTER'),              // Private charter services
+  Type.Literal('EXPRESS'),              // Premium/express services
+  Type.Literal('PARATRANSIT'),          // Accessibility, on-demand transit
+  
+  // FREIGHT/CARGO
+  Type.Literal('CARGO'),                // General freight
+  Type.Literal('DELIVERY'),             // Last-mile delivery
+  Type.Literal('COURIER'),              // Express courier/parcel
+  Type.Literal('REFRIGERATED'),         // Cold chain/reefer fleet
+  Type.Literal('TANKER'),               // Liquid/gas transport
+  Type.Literal('FLATBED'),              // Flatbed/heavy equipment
+  Type.Literal('CONTAINER'),            // Container transport
+  Type.Literal('MOVING'),               // Moving/relocation services
+  
+  // SPECIALIZED
+  Type.Literal('MEDICAL'),              // Ambulances, medical transport
+  Type.Literal('EMERGENCY'),            // Fire, police, emergency
+  Type.Literal('CONSTRUCTION'),         // Construction vehicles
+  Type.Literal('UTILITY'),              // Utility company vehicles
+  Type.Literal('RENTAL'),               // Vehicle rental fleet
+  Type.Literal('RIDESHARE'),            // Uber/Bolt-style fleets
+  Type.Literal('TAXI'),                 // Traditional taxi fleet
+  
+  // GENERAL
+  Type.Literal('MIXED'),                // Multi-purpose fleet
+  Type.Literal('OTHER')
+])
+
+export const FleetOperationalStatusSchema = Type.Union([
+  Type.Literal('OPERATIONAL'),        // Actively serving routes
+  Type.Literal('STANDBY'),           // Ready but not assigned
+  Type.Literal('MAINTENANCE'),        // Under maintenance
+  Type.Literal('DECOMMISSIONED'),    // Out of service
+  Type.Literal('SEASONAL')           // Seasonal operation only
+])
+
+// Fleet Performance Metrics Schema
+export const FleetPerformanceSchema = Type.Object({
+  fleetId: Type.String(),
+  period: Type.Object({
+    start: DateTimeZoneSchema,
+    end: DateTimeZoneSchema
+  }),
+
+  // Operational KPIs
+  kpis: Type.Object({
+    vehicleUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    onTimePerformance: Type.Number({ minimum: 0, maximum: 100 }),
+    serviceFrequency: Type.Number({ minimum: 0 }),
+    passengerThroughput: Type.Number({ minimum: 0 }),
+    averageWaitTime: Type.Number({ minimum: 0 }), // minutes
+
+    // Cost Metrics
+    costPerKilometer: Type.Optional(MoneySchema),
+    costPerPassenger: Type.Optional(MoneySchema),
+    fuelCostEfficiency: Type.Optional(Type.Number({ minimum: 0 })),
+    maintenanceCostRatio: Type.Optional(Type.Number({ minimum: 0 })),
+
+    // Quality Metrics
+    breakdownRate: Type.Number({ minimum: 0 }), // per 1000km
+    customerComplaints: Type.Number({ minimum: 0 }),
+    safetyIncidents: Type.Number({ minimum: 0 }),
+    environmentalScore: Type.Optional(Type.Number({ minimum: 0, maximum: 100 }))
+  })
+})
+
+// Main Fleet Schema - Following Carrier pattern
+export const FleetSchema = Type.Composite([
+  BaseServiceDefinitionSchema,
+  Type.Object({
+    type: FleetTypeSchema,
+
+    // Fleet Composition - Reference-based like Carrier
+    size: Type.Number({ minimum: 0 }), // Current size (like Carrier)
+
+    // Fleet Specifications Summary
+    specs: Type.Optional(Type.Object({
+      totalCapacity: Type.Object({
+        passengers: Type.Number({ minimum: 0 }),
+        weight: WeightSchema,
+        volume: Type.Optional(VolumeSchema)
+      }),
+      averageAge: Type.Optional(Type.Number({ minimum: 0 })),
+      primaryVehicleType: VehicleTypeSchema,
+      supportedEngineTypes: Type.Array(VehicleEngineSchema)
+    })),
+
+    // Performance - Structured like Hub/Warehouse/Carrier
+    performance: Type.Optional(Type.Object({
+      throughput: Type.Object({
+        current: Type.Number({ minimum: 0 }),
+        peak: Type.Number({ minimum: 0 }),
+        average: Type.Number({ minimum: 0 }),
+        target: Type.Number({ minimum: 0 })
+      }),
+
+      timing: Type.Object({
+        averageProcessingTime: Type.Number({ minimum: 0, description: 'minutes' }),
+        averageDwellTime: Type.Number({ minimum: 0, description: 'minutes' }),
+        onTimePerformance: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+      }),
+      
+      quality: Type.Object({
+        accuracy: Type.Number({ minimum: 0, maximum: 100 }),
+        damageRate: Type.Number({ minimum: 0, maximum: 100 }),
+        lossRate: Type.Number({ minimum: 0, maximum: 100 }),
+        customerSatisfaction: Type.Optional(Type.Number({ minimum: 0, maximum: 100 }))
+      }),
+      
+      utilization: Type.Object({
+        capacity: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+        equipment: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+        labor: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+      }),
+      
+      costs: Type.Optional(Type.Object({
+        operatingCostPerPackage: MoneySchema,
+        totalOperatingCost: MoneySchema,
+        efficiencyRating: Type.Number({ minimum: 0, maximum: 100 })
+      }))
+    }))
+  })
+])
+export const FleetUpdateSchema = Type.Composite([
+  BaseServiceDefinitionUpdateSchema,
+  Type.Object({
+    type: Type.Optional(FleetTypeSchema)
+  })
+])
+
+// Enhanced Fleet Stats Schema
+export const FleetStatBySchema = Type.Object({
+  count: Type.Number({ minimum: 0 }),
+  available: Type.Number({ minimum: 0 }),
+  inService: Type.Number({ minimum: 0 }),
+  utilization: Type.Number({ minimum: 0, maximum: 100 }),
+  averageAge: Type.Number({ minimum: 0, description: 'years' }),
+  totalCapacity: Type.Object({
+    passengers: Type.Number({ minimum: 0 }),
+    weight: WeightSchema,
+    volume: Type.Optional(VolumeSchema)
+  }),
+
+  // Performance Metrics
+  performance: Type.Optional(Type.Object({
+    onTimePerformance: Type.Number({ minimum: 0, maximum: 100 }),
+    fuelEfficiency: Type.Optional(Type.Number({ minimum: 0 })),
+    averageSpeed: Type.Optional(Type.Number({ minimum: 0 })),
+    passengerSatisfaction: Type.Optional(Type.Number({ minimum: 0, maximum: 5 }))
+  }))
+})
+
+export const FleetStatsSchema = Type.Object({
+  fleetId: Type.String(),
+  timestamp: DateTimeZoneSchema,
+  period: Type.Object({
+    start: DateTimeZoneSchema,
+    end: DateTimeZoneSchema
+  }),
+
+  // Overall Statistics
+  total: Type.Number({ minimum: 0 }),
+  available: Type.Number({ minimum: 0 }),
+  active: Type.Number({ minimum: 0 }),
+  idle: Type.Number({ minimum: 0 }),
+  maintenance: Type.Number({ minimum: 0 }),
+  utilizationRate: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+
+  // Capacity Statistics
+  totalPassengerCapacity: Type.Number({ minimum: 0 }),
+  averageOccupancy: Type.Number({ minimum: 0, maximum: 100 }),
+
+  // Financial Metrics
+  operationalCost: Type.Optional(MoneySchema),
+  revenue: Type.Optional(MoneySchema),
+  profitability: Type.Optional(Type.Number()), // percentage
+
+  // Performance Metrics
+  performance: Type.Optional(Type.Object({
+    averageOnTimePerformance: Type.Number({ minimum: 0, maximum: 100 }),
+    serviceReliability: Type.Number({ minimum: 0, maximum: 100 }),
+    maintenanceCompliance: Type.Number({ minimum: 0, maximum: 100 }),
+    fuelEfficiency: Type.Optional(Type.Number({ minimum: 0 })),
+    customerSatisfaction: Type.Optional(Type.Number({ minimum: 0, maximum: 5 }))
+  })),
+
+  // Breakdown by Categories
+  byType: Type.Record(Type.String(), FleetStatBySchema), // Using string for flexible vehicle types
+  byStatus: Type.Record(Type.String(), FleetStatBySchema),
+  byEngine: Type.Record(Type.String(), FleetStatBySchema),
+  byCondition: Type.Record(Type.String(), FleetStatBySchema),
+  byRoute: Type.Optional(Type.Record(Type.String(), FleetStatBySchema)),
+  byOperator: Type.Optional(Type.Record(Type.String(), FleetStatBySchema))
+})
+
+// Fleet Assignment Schema
+export const FleetAssignmentSchema = Type.Object({
+  id: Type.String(),
+  fleetId: Type.String(),
+  vehicleId: Type.String(),
+  routeId: Type.Optional(Type.String()),
+  driverId: Type.Optional(Type.String()),
+
+  assignment: Type.Object({
+    start: DateTimeZoneSchema,
+    end: Type.Optional(DateTimeZoneSchema),
+    shift: Type.Optional(Type.Union([
+      Type.Literal('MORNING'),
+      Type.Literal('AFTERNOON'),
+      Type.Literal('EVENING'),
+      Type.Literal('NIGHT'),
+      Type.Literal('FULL_DAY')
+    ])),
+    priority: Type.Optional(Type.Number({ minimum: 1, maximum: 10 }))
+  }),
+
+  created: ActionRecordSchema,
+  updated: Type.Optional(ActionRecordSchema)
+})
+export const FleetAssignmentUpdateSchema = Type.Partial(Type.Omit(FleetAssignmentSchema, ['id', 'created']))
+
+// TypeScript Types
+export type FleetType             = Static<typeof FleetTypeSchema>
+export type Fleet                 = Static<typeof FleetSchema>
+export type FleetUpdate           = Static<typeof FleetUpdateSchema>
+export type FleetStatBy           = Static<typeof FleetStatBySchema>
+export type FleetStats            = Static<typeof FleetStatsSchema>
+export type FleetPerformance      = Static<typeof FleetPerformanceSchema>
+export type FleetAssignment       = Static<typeof FleetAssignmentSchema>
+export type FleetAssignmentUpdate = Static<typeof FleetAssignmentUpdateSchema>
+
+// ─── Request Validation Schemas ───────────────────────────────────────────────
+
+export const FleetCreateBodySchema = Type.Omit(FleetSchema, [
+	'id', 'context',
+	'status', 'alerts',
+	'size',
+	'created', 'updated'
+])
+
+export const FleetStatusUpdateBodySchema = Type.Object({
+	status:            EntityStatusSchema,
+	operationalStatus: Type.Optional(FleetOperationalStatusSchema),
+	reason:            Type.Optional(Type.String({ maxLength: 500 }))
+})
+
+export const FleetListQuerySchema = Type.Object({
+	status:            Type.Optional(EntityStatusSchema),
+	operationalStatus: Type.Optional(FleetOperationalStatusSchema),
+	limit:             Type.Optional(Type.Number({ minimum: 1, maximum: 200, default: 20 })),
+	offset:            Type.Optional(Type.Number({ minimum: 0, default: 0 }))
+})
+
+export const LSPFleetCreateRVS = {
+	headers:  APIHeadersSchema,
+	body:     FleetCreateBodySchema,
+	response: APIResponseDataSchemaFactory({ fleetId: Type.String() })
+}
+
+export const LSPFleetRetrieveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ fleet: FleetSchema })
+}
+
+export const LSPFleetListRVS = {
+	headers:     APIHeadersSchema,
+	querystring: FleetListQuerySchema,
+	response: APIResponseDataSchemaFactory({
+		fleets: Type.Array(FleetSchema),
+		total:  Type.Number(),
+		limit:  Type.Number(),
+		offset: Type.Number()
+	})
+}
+
+export const LSPFleetUpdateRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     FleetUpdateSchema,
+	response: APIResponseDataSchemaFactory({ fleet: FleetSchema })
+}
+
+export const LSPFleetUpdateStatusRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     FleetStatusUpdateBodySchema,
+	response: APIResponseDataSchemaFactory({ fleet: FleetSchema })
+}
+
+export const LSPFleetRemoveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export type LSPFleetCreateValidation       = { headers: Static<typeof LSPFleetCreateRVS.headers>, body: Static<typeof LSPFleetCreateRVS.body>, response: Static<typeof LSPFleetCreateRVS.response> }
+export type LSPFleetRetrieveValidation     = { headers: Static<typeof LSPFleetRetrieveRVS.headers>, params: Static<typeof LSPFleetRetrieveRVS.params>, response: Static<typeof LSPFleetRetrieveRVS.response> }
+export type LSPFleetListValidation         = { headers: Static<typeof LSPFleetListRVS.headers>, querystring: Static<typeof LSPFleetListRVS.querystring>, response: Static<typeof LSPFleetListRVS.response> }
+export type LSPFleetUpdateValidation       = { headers: Static<typeof LSPFleetUpdateRVS.headers>, params: Static<typeof LSPFleetUpdateRVS.params>, body: Static<typeof LSPFleetUpdateRVS.body>, response: Static<typeof LSPFleetUpdateRVS.response> }
+export type LSPFleetUpdateStatusValidation = { headers: Static<typeof LSPFleetUpdateStatusRVS.headers>, params: Static<typeof LSPFleetUpdateStatusRVS.params>, body: Static<typeof LSPFleetUpdateStatusRVS.body>, response: Static<typeof LSPFleetUpdateStatusRVS.response> }
+export type LSPFleetRemoveValidation       = { headers: Static<typeof LSPFleetRemoveRVS.headers>, params: Static<typeof LSPFleetRemoveRVS.params>, response: Static<typeof LSPFleetRemoveRVS.response> }