apps/backend/src/common/distribution/distribution-planning.service.tsTypeScript
import { Injectable } from '@nestjs/common';
import { FulfillableCapacityService, type CapacityFactor } from '../capacity/fulfillable-capacity.service';
import { DistributionIntelligenceService, type DistributionChannelDemand, type DistributionIntelligenceRecommendation } from './distribution-intelligence.service';
import { IntelligenceReadinessService, type IntelligenceReadiness } from '../intelligence/intelligence-readiness.service';
export interface DistributionPlanningInput {
factors: CapacityFactor[];
channels: DistributionChannelDemand[];
operationalReady?: boolean;
}
export interface DistributionPlanningResult {
fulfillableCapacity: number;
limitingFactors: string[];
recommendation: DistributionIntelligenceRecommendation;
readiness: IntelligenceReadiness;
requiresHumanConfirmation: true;
}
@Injectable()
export class DistributionPlanningService {
constructor(
private readonly capacity: FulfillableCapacityService,
private readonly distribution: DistributionIntelligenceService,
private readonly readiness: IntelligenceReadinessService,
) {}
prepare(input: DistributionPlanningInput): DistributionPlanningResult {
if (!input || typeof input !== 'object' || !Array.isArray(input.factors) || !Array.isArray(input.channels) || input.factors.length > 100 || input.channels.length > 1000 || (input.operationalReady !== undefined && typeof input.operationalReady !== 'boolean')) throw new Error('distribution_planning.invalid');
const capacity = this.capacity.calculate(input.factors);
const recommendation = this.distribution.recommend({fulfillableCapacity: capacity.capacity, channels: input.channels});
const readiness = this.readiness.evaluate({evidenceCount: input.channels.length, capacityAvailable: capacity.capacity > 0, operationalReady: input.operationalReady !== false, requiresHumanConfirmation: true});
return {fulfillableCapacity: capacity.capacity, limitingFactors: capacity.limitingFactors, recommendation, readiness, requiresHumanConfirmation: true};
}
}