mirror of
https://github.com/Tria-plc/edr-platform.git
synced 2026-08-27 14:20:58 +00:00
282 lines
9.7 KiB
TypeScript
282 lines
9.7 KiB
TypeScript
import { AllocationLoadType } from '@edr/types';
|
||
|
||
import { Booking } from '../bookings/entities/booking.entity';
|
||
import { WagonType } from '../wagon-types/entities/wagon-type.entity';
|
||
import {
|
||
buildBulkWagonPlan,
|
||
buildContainerWagonPlan,
|
||
buildMixedWagonPlan,
|
||
containerWagonsForLines,
|
||
expandBookingContainerUnits,
|
||
expandContainerItems,
|
||
roundTons,
|
||
sumWagonsRequired,
|
||
validate20ftContainerRules,
|
||
validateContainerPlacements,
|
||
} from './wagon-plan.util';
|
||
|
||
const nw5: WagonType = {
|
||
id: 'wt-nw5',
|
||
code: 'NW5',
|
||
name: 'Flat Wagon',
|
||
capacityTons: 70,
|
||
lengthMeters: 14,
|
||
supportedLoadTypes: ['CONTAINER'],
|
||
isActive: true,
|
||
supportsContainer: true,
|
||
} as WagonType;
|
||
|
||
const cw3: WagonType = {
|
||
id: 'wt-cw3',
|
||
code: 'CW3',
|
||
name: 'Covered Wagon',
|
||
capacityTons: 60,
|
||
lengthMeters: 14,
|
||
supportedLoadTypes: ['BULK'],
|
||
isActive: true,
|
||
supportsContainer: false,
|
||
} as WagonType;
|
||
|
||
const makeContainerBooking = (
|
||
id: string,
|
||
lines: Array<{ quantity: number; wagonsRequired: number; vgmPerUnitTons?: number }>,
|
||
): Booking =>
|
||
({
|
||
id,
|
||
reference: id,
|
||
freightType: 'CONTAINER',
|
||
cargoTotalWeightVgm: lines.reduce(
|
||
(sum, line) => sum + line.quantity * (line.vgmPerUnitTons ?? 25),
|
||
0,
|
||
),
|
||
bookingContainers: lines.map((line, index) => ({
|
||
id: `${id}-line-${index}`,
|
||
containerTypeId: `ct-${index}`,
|
||
quantity: line.quantity,
|
||
wagonsRequired: line.wagonsRequired,
|
||
vgmPerUnitTons: line.vgmPerUnitTons ?? 25,
|
||
})),
|
||
}) as Booking;
|
||
|
||
describe('wagon-plan.util', () => {
|
||
it('uses slot-based planning: 2×20ft = 1 wagon slot', () => {
|
||
const booking = makeContainerBooking('b1', [{ quantity: 2, wagonsRequired: 1 }]);
|
||
const plan = buildContainerWagonPlan([booking], nw5);
|
||
expect(plan).toHaveLength(1);
|
||
expect(plan[0]?.allocations[0]?.loadType).toBe(AllocationLoadType.Container);
|
||
});
|
||
|
||
it('uses slot-based planning: 1×40ft = 1 wagon slot', () => {
|
||
const booking = makeContainerBooking('b2', [{ quantity: 1, wagonsRequired: 1 }]);
|
||
const plan = buildContainerWagonPlan([booking], nw5);
|
||
expect(plan).toHaveLength(1);
|
||
});
|
||
|
||
it('sums wagons across multiple container lines', () => {
|
||
const booking = makeContainerBooking('b3', [
|
||
{ quantity: 2, wagonsRequired: 1 },
|
||
{ quantity: 1, wagonsRequired: 1 },
|
||
]);
|
||
expect(sumWagonsRequired(booking)).toBe(2);
|
||
const plan = buildContainerWagonPlan([booking], nw5);
|
||
expect(plan).toHaveLength(2);
|
||
});
|
||
|
||
it('counts a bulk booking\'s wagons from the plan, not a flat 1', () => {
|
||
// 700T of sugar on 60T CW3 gondolas = 12 wagons; the stored wagonsRequired
|
||
// must carry all of them so gross weight charges 12 tares downstream.
|
||
const booking = {
|
||
id: 'bulk-700',
|
||
reference: 'bulk-700',
|
||
freightType: 'BULK',
|
||
cargoTotalWeightVgm: 700,
|
||
bookingContainers: [],
|
||
} as unknown as Booking;
|
||
const plan = buildBulkWagonPlan([booking], cw3);
|
||
expect(plan).toHaveLength(12);
|
||
expect(sumWagonsRequired(booking, plan)).toBe(12);
|
||
// Without a plan the pre-plan fallback still applies.
|
||
expect(sumWagonsRequired(booking)).toBe(1);
|
||
});
|
||
|
||
it('counts container wagons from the plan TEU packing', () => {
|
||
const booking = makeContainerBooking('c-plan', [{ quantity: 6, wagonsRequired: 3 }]);
|
||
const plan = buildContainerWagonPlan([booking], nw5);
|
||
expect(sumWagonsRequired(booking, plan)).toBe(3);
|
||
});
|
||
|
||
it('6×20ft containers = 3 wagon slots (2 per wagon)', () => {
|
||
// 20ft containers take half a wagon each, so 6 * 0.5 = 3 wagons
|
||
const booking = makeContainerBooking('b6x20', [{ quantity: 6, wagonsRequired: 3 }]);
|
||
expect(sumWagonsRequired(booking)).toBe(3);
|
||
const plan = buildContainerWagonPlan([booking], nw5);
|
||
expect(plan).toHaveLength(3);
|
||
// Verify sequence numbers are 1, 2, 3
|
||
expect(plan.map((s) => s.sequenceNo)).toEqual([1, 2, 3]);
|
||
});
|
||
|
||
it('expands container items per quantity', () => {
|
||
const booking = makeContainerBooking('b4', [{ quantity: 3, wagonsRequired: 3 }]);
|
||
const items = expandContainerItems(booking, 'alloc-1');
|
||
expect(items).toHaveLength(3);
|
||
expect(items[0]?.wagonBookingAllocationId).toBe('alloc-1');
|
||
});
|
||
|
||
it('rounds tons to three decimal places', () => {
|
||
expect(roundTons(1.23456)).toBe(1.235);
|
||
expect(roundTons('bad')).toBe(0);
|
||
});
|
||
|
||
it('builds mixed plan with container block before bulk', () => {
|
||
const containerBooking = makeContainerBooking('c1', [{ quantity: 2, wagonsRequired: 2 }]);
|
||
const bulkBooking = {
|
||
id: 'b1',
|
||
reference: 'BKG-BULK',
|
||
freightType: 'BULK',
|
||
cargoTotalWeightVgm: 120,
|
||
bookingContainers: [],
|
||
} as unknown as Booking;
|
||
|
||
const plan = buildMixedWagonPlan([containerBooking], [bulkBooking], nw5, cw3);
|
||
expect(plan).toHaveLength(4);
|
||
expect(plan[0]?.slotLoadType).toBe('CONTAINER');
|
||
expect(plan[2]?.slotLoadType).toBe('BULK');
|
||
expect(plan.map((s) => s.sequenceNo)).toEqual([1, 2, 3, 4]);
|
||
});
|
||
|
||
it('expands booking container units for UI rows', () => {
|
||
const booking = makeContainerBooking('c2', [{ quantity: 3, wagonsRequired: 3 }]);
|
||
const units = expandBookingContainerUnits([booking]);
|
||
expect(units).toHaveLength(3);
|
||
expect(units[1]?.unitIndex).toBe(1);
|
||
expect(units[1]?.bookingContainerId).toBe('c2-line-0');
|
||
});
|
||
|
||
it('validates required placements per container unit', () => {
|
||
const booking = makeContainerBooking('c3', [{ quantity: 2, wagonsRequired: 2 }]);
|
||
const plan = buildContainerWagonPlan([booking], nw5);
|
||
const violations = validateContainerPlacements([booking], plan, []);
|
||
expect(violations.some((v) => v.includes('required'))).toBe(true);
|
||
|
||
const units = expandBookingContainerUnits([booking]);
|
||
const placements = units.map((unit, index) => ({
|
||
bookingContainerId: unit.bookingContainerId,
|
||
unitIndex: unit.unitIndex,
|
||
sequenceNo: plan[index]?.sequenceNo ?? 1,
|
||
containerNumber: `CNTR-${index + 1}`,
|
||
}));
|
||
expect(validateContainerPlacements([booking], plan, placements)).toEqual([]);
|
||
});
|
||
|
||
it('rejects 20ft container over max individual weight', () => {
|
||
const booking = makeContainerBooking('c20', [{ quantity: 2, wagonsRequired: 1, vgmPerUnitTons: 35 }]);
|
||
const units = expandBookingContainerUnits([booking]);
|
||
const placements = units.map((unit, index) => ({
|
||
bookingContainerId: unit.bookingContainerId,
|
||
unitIndex: unit.unitIndex,
|
||
sequenceNo: 1,
|
||
containerNumber: `CNTR-${index + 1}`,
|
||
}));
|
||
|
||
const violations = validate20ftContainerRules(units, placements, {
|
||
max20ftContainerWeightTons: 30,
|
||
max20ftPairWeightDiffTons: 10,
|
||
});
|
||
|
||
expect(violations.some((v) => v.includes('exceeds max 30T'))).toBe(true);
|
||
});
|
||
|
||
it('rejects 20ft pair when weight difference exceeds limit', () => {
|
||
const booking = makeContainerBooking('c21', [
|
||
{ quantity: 2, wagonsRequired: 1, vgmPerUnitTons: 25 },
|
||
]);
|
||
booking.bookingContainers![0]!.vgmPerUnitTons = 25;
|
||
const units = expandBookingContainerUnits([booking]);
|
||
units[1]!.grossWeightTons = 10;
|
||
const placements = units.map((unit) => ({
|
||
bookingContainerId: unit.bookingContainerId,
|
||
unitIndex: unit.unitIndex,
|
||
sequenceNo: 1,
|
||
containerNumber: `CNTR-${unit.unitIndex}`,
|
||
}));
|
||
|
||
const violations = validate20ftContainerRules(units, placements, {
|
||
max20ftContainerWeightTons: 30,
|
||
max20ftPairWeightDiffTons: 10,
|
||
});
|
||
|
||
expect(violations.some((v) => v.includes('weight difference'))).toBe(true);
|
||
});
|
||
|
||
it('builds bulk-only plan as degenerate mixed case', () => {
|
||
const bulkBooking = {
|
||
id: 'b2',
|
||
reference: 'BKG-BULK-2',
|
||
freightType: 'BULK',
|
||
cargoTotalWeightVgm: 60,
|
||
bookingContainers: [],
|
||
} as unknown as Booking;
|
||
const plan = buildMixedWagonPlan([], [bulkBooking], nw5, cw3);
|
||
expect(plan).toHaveLength(1);
|
||
expect(plan[0]?.slotLoadType).toBe('BULK');
|
||
expect(buildBulkWagonPlan([bulkBooking], cw3)).toHaveLength(1);
|
||
});
|
||
});
|
||
|
||
describe('containerWagonsForLines — TEU-aware, ceil booking total once', () => {
|
||
const line = (quantity: number, wagonsPerUnit: number, wagonsRequired?: number) => ({
|
||
quantity,
|
||
wagonsRequired: wagonsRequired ?? quantity * wagonsPerUnit,
|
||
containerType: { sizeFt: wagonsPerUnit >= 1 ? 40 : 20 },
|
||
});
|
||
|
||
it('20×20ft = 10 wagons (not 20)', () => {
|
||
expect(containerWagonsForLines([line(20, 0.5)])).toBe(10);
|
||
});
|
||
|
||
it('38×20ft = 19 wagons', () => {
|
||
expect(containerWagonsForLines([line(38, 0.5)])).toBe(19);
|
||
});
|
||
|
||
it('2×20ft = 1 wagon', () => {
|
||
expect(containerWagonsForLines([line(2, 0.5)])).toBe(1);
|
||
});
|
||
|
||
it('odd 3×20ft = 2 wagons (single line ceils)', () => {
|
||
expect(containerWagonsForLines([line(3, 0.5)])).toBe(2);
|
||
});
|
||
|
||
it('3×20ft + 3×20ft = 3 wagons (ceil TOTAL, not per line)', () => {
|
||
// per-line ceil would give 2 + 2 = 4; the booking total is ceil(1.5+1.5)=3.
|
||
expect(containerWagonsForLines([line(3, 0.5), line(3, 0.5)])).toBe(3);
|
||
});
|
||
|
||
it('three 1×20ft lines = 2 wagons (ceil TOTAL)', () => {
|
||
// per-line ceil would give 1+1+1 = 3; total is ceil(0.5*3)=ceil(1.5)=2.
|
||
expect(
|
||
containerWagonsForLines([line(1, 0.5), line(1, 0.5), line(1, 0.5)]),
|
||
).toBe(2);
|
||
});
|
||
|
||
it('5×20ft + 2×40ft = 5 wagons', () => {
|
||
expect(containerWagonsForLines([line(5, 0.5), line(2, 1)])).toBe(5);
|
||
});
|
||
|
||
it('21×40ft = 21 wagons', () => {
|
||
expect(containerWagonsForLines([line(21, 1)])).toBe(21);
|
||
});
|
||
|
||
it('falls back to line wagonsRequired when containerType/sizeFt missing', () => {
|
||
// No containerType relation loaded → use the stored (0.5-aware) fraction.
|
||
expect(
|
||
containerWagonsForLines([
|
||
{ quantity: 20, wagonsRequired: 10 } as never,
|
||
]),
|
||
).toBe(10);
|
||
});
|
||
|
||
it('empty line set = 0 wagons', () => {
|
||
expect(containerWagonsForLines([])).toBe(0);
|
||
});
|
||
});
|