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 {
getDefinitionText,
getEntry,
getTermText,
hasEntry,
lookupEntry,
termSlug
} from "./helpers";
import { terms } from "./terms";
import type { GlossaryEntry } from "./types";
// `terms` is `as const satisfies ...`, so each entry has its narrowed literal
// shape — optional fields (href, aliases) are absent on entries that don't set
// them, which makes loop-style checks awkward. The data still satisfies
// GlossaryEntry, so widen to that uniform shape for the iteration helpers below.
const entriesById = Object.entries(terms) as Array<[string, GlossaryEntry]>;
describe("glossary", () => {
it("every entry has a non-empty term and definition", () => {
for (const [id, entry] of entriesById) {
expect(getTermText(entry), `${id}.term.message`).toMatch(/\S/);
expect(getDefinitionText(entry), `${id}.definition.message`).toMatch(
/\S/
);
}
});
it("href, if set, points at /docs, /guides, or an absolute URL — shape only", () => {
const shape = /^\/(docs|guides)\/|^https?:\/\//;
for (const [id, entry] of entriesById) {
if (entry.href !== undefined) {
expect(entry.href, `${id}.href`).toMatch(shape);
}
}
});
it("slug ids are valid lowercase-hyphen tokens", () => {
// We don't enforce `termSlug(entry.term.message) === id` — many canonical
// ids are intentional abbreviations of a spelled-out term (oem, wip, bom,
// mrp, cogs, rfq, fefo, macrs, 8d, gr-ir). Just check the id shape.
const shape = /^[a-z0-9]+(-[a-z0-9]+)*$/;
for (const [id] of entriesById) {
expect(id, `id "${id}"`).toMatch(shape);
}
});
it("termSlug lowercases, trims and hyphenates a term name", () => {
expect(termSlug("Make to Order")).toBe("make-to-order");
expect(termSlug(" Mixed-Case TEXT ")).toBe("mixed-case-text");
});
it("hasEntry / lookupEntry resolve unknown slugs to nothing", () => {
expect(hasEntry("method")).toBe(true);
expect(hasEntry("not-a-real-slug")).toBe(false);
expect(lookupEntry("method") && getTermText(lookupEntry("method")!)).toBe(
"Method"
);
expect(lookupEntry("not-a-real-slug")).toBeUndefined();
});
it("hasEntry / lookupEntry resolve aliases to the canonical entry", () => {
// `cogs` declares `aliases: ["cost-of-goods-sold"]`. The spelled-out slug
// is not in `terms` but must resolve to the same canonical entry.
expect(hasEntry("cost-of-goods-sold")).toBe(true);
expect(lookupEntry("cost-of-goods-sold")).toBe(getEntry("cogs"));
});
it("every declared alias points at exactly one canonical entry", () => {
// Aliases must be globally unique — if two entries declared the same alias,
// the lookup result would depend on insertion order.
const seen = new Map<string, string>();
for (const [id, entry] of entriesById) {
for (const alias of entry.aliases ?? []) {
const prior = seen.get(alias);
expect(
prior,
`alias "${alias}" is declared on both "${prior}" and "${id}"`
).toBeUndefined();
seen.set(alias, id);
}
}
});
});