Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
// SPDX-License-Identifier: AGPL-3.0-only
// Carbon (github.com/crbnos/carbon). Modified or adapted versions of this file,
// including ports, remain AGPLv3; serving them over a network requires releasing their source.
import { describe, expect, it } from "vitest";
import { batchDuration, batchPlanBreakdown } from "./batch-duration";
describe("batchDuration", () => {
// The spec's worked example: effective member runs of 40/70/50 minutes
// (labor-driven; machine time 0 or lower) and a 10-minute setup on every
// member, counted once as the shared batch setup.
const members = [
{
setupDuration: 10 * 60,
laborDuration: 40 * 60,
machineDuration: 0,
operationQuantity: 5,
quantityComplete: 0
},
{
setupDuration: 10 * 60,
laborDuration: 70 * 60,
machineDuration: 30 * 60,
operationQuantity: 20,
quantityComplete: 0
},
{
setupDuration: 10 * 60,
laborDuration: 50 * 60,
machineDuration: 0,
operationQuantity: 10,
quantityComplete: 0
}
];
it("Simultaneous: one shared setup plus the longest member run (80 minutes)", () => {
// 10 min setup + max(40, 70, 50) min run.
expect(batchDuration(members, "Simultaneous")).toBe(80 * 60);
});
it("Sequential: one shared setup plus the sum of member runs (170 minutes)", () => {
// 10 min setup + (40 + 70 + 50) min run.
expect(batchDuration(members, "Sequential")).toBe(170 * 60);
});
it("nets a member's run by its remaining fraction (50% complete contributes half)", () => {
const total = batchDuration(
[
{
setupDuration: 0,
laborDuration: 40 * 60,
machineDuration: 0,
operationQuantity: 10,
quantityComplete: 5
}
],
"Sequential"
);
expect(total).toBe(20 * 60);
});
it("zeroes the shared setup once the batch has recorded any production event", () => {
expect(batchDuration(members, "Simultaneous", { hasAnyEvent: true })).toBe(
70 * 60
);
expect(batchDuration(members, "Sequential", { hasAnyEvent: true })).toBe(
160 * 60
);
});
it("returns 0 for an empty batch", () => {
expect(batchDuration([], "Sequential")).toBe(0);
expect(batchDuration([], "Simultaneous")).toBe(0);
});
it("treats operationQuantity <= 0 as fully remaining (full run)", () => {
const total = batchDuration(
[
{
setupDuration: 0,
laborDuration: 40 * 60,
machineDuration: 0,
operationQuantity: 0,
quantityComplete: 3
}
],
"Sequential"
);
expect(total).toBe(40 * 60);
});
it("uses machine time when machineDuration exceeds laborDuration", () => {
const total = batchDuration(
[
{
setupDuration: 0,
laborDuration: 10 * 60,
machineDuration: 25 * 60,
operationQuantity: 5,
quantityComplete: 0
}
],
"Simultaneous"
);
expect(total).toBe(25 * 60);
});
it("clamps an over-complete member to zero remaining run", () => {
const total = batchDuration(
[
{
setupDuration: 5 * 60,
laborDuration: 40 * 60,
machineDuration: 0,
operationQuantity: 10,
quantityComplete: 12
}
],
"Sequential"
);
expect(total).toBe(5 * 60);
});
});
describe("batchPlanBreakdown", () => {
// Two members with BOTH labor and machine so the total's overlap rule bites:
// m1 run = max(40, 30) = 40; m2 run = max(70, 30) = 70. Buckets keep labor
// and machine separate; total combines each member's run.
const members = [
{
setupDuration: 10 * 60,
laborDuration: 40 * 60,
machineDuration: 30 * 60
},
{ setupDuration: 15 * 60, laborDuration: 70 * 60, machineDuration: 30 * 60 }
];
it("Sequential: shared setup, summed buckets, total sums each member's run", () => {
expect(batchPlanBreakdown(members, "Sequential")).toEqual({
setup: 15 * 60,
labor: (40 + 70) * 60,
machine: (30 + 30) * 60,
// NOT setup + labor + machine (which would double-count the overlap):
// 15 + max(40,30) + max(70,30) = 15 + 40 + 70 = 125 min.
total: (15 + 40 + 70) * 60
});
});
it("Simultaneous: shared setup, buckets take the largest, total = setup + longest run", () => {
expect(batchPlanBreakdown(members, "Simultaneous")).toEqual({
setup: 15 * 60,
labor: 70 * 60,
machine: 30 * 60,
// 15 + max(max(40,30), max(70,30)) = 15 + 70 = 85 min.
total: (15 + 70) * 60
});
});
it("returns all zeros for an empty batch", () => {
expect(batchPlanBreakdown([], "Sequential")).toEqual({
setup: 0,
labor: 0,
machine: 0,
total: 0
});
expect(batchPlanBreakdown([], "Simultaneous")).toEqual({
setup: 0,
labor: 0,
machine: 0,
total: 0
});
});
// The plan-vs-schedule guarantee: the display total must equal the
// scheduler's reservation for zero-progress members with no recorded events.
it("total equals batchDuration for zero-progress members without events", () => {
const durationMembers = members.map((m) => ({
...m,
operationQuantity: 10,
quantityComplete: 0
}));
for (const batchType of ["Sequential", "Simultaneous"] as const) {
expect(batchPlanBreakdown(members, batchType).total).toBe(
batchDuration(durationMembers, batchType)
);
}
});
});