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 { Hidden, Submit, TextArea, ValidatedForm } from "@carbon/form";
import {
BarProgress,
Button,
HStack,
Input,
InputGroup,
InputRightElement,
Modal,
ModalBody,
ModalContent,
ModalDescription,
ModalFooter,
ModalHeader,
ModalTitle,
ScrollArea,
Tabs,
TabsContent,
TabsList,
TabsTrigger,
VStack
} from "@carbon/react";
import { Trans, useLingui } from "@lingui/react/macro";
import { useEffect, useState } from "react";
import { LuCheck, LuList, LuQrCode, LuX } from "react-icons/lu";
import { useFetcher } from "react-router";
import { inspectionSampleValidator } from "~/services/models";
import type { InspectionTrackedEntity } from "~/services/types";
import { path } from "~/utils/path";
type Props = {
inspectionId: string;
isSerial: boolean;
remaining: InspectionTrackedEntity[];
inspected: number;
sampleSize: number;
fails: number;
acceptanceNumber: number;
onClose: () => void;
};
export default function ScanInspectionSample({
inspectionId,
isSerial,
remaining,
inspected,
sampleSize,
fails,
acceptanceNumber,
onClose
}: Props) {
const { t } = useLingui();
const fetcher = useFetcher<{ error?: unknown; success?: boolean }>();
const [serial, setSerial] = useState("");
const [selected, setSelected] = useState<InspectionTrackedEntity | null>(
null
);
// Bumped after each successful save so the form (notes) remounts and clears,
// even for non-serial parts where there's no entity selection to change.
const [resetKey, setResetKey] = useState(0);
const findMatch = (value: string): InspectionTrackedEntity | null => {
if (!value) return null;
const needle = value.toLowerCase();
return (
remaining.find((e) => {
if (e.id === value) return true;
if (e.readableId && e.readableId.toLowerCase() === needle) return true;
return false;
}) ?? null
);
};
// biome-ignore lint/correctness/useExhaustiveDependencies: keep findMatch around for future UI without re-introducing unused-variable churn
useEffect(() => {
setSelected(findMatch(serial));
}, [serial, remaining]);
useEffect(() => {
if (fetcher.state === "idle" && fetcher.data && !fetcher.data.error) {
setSerial("");
setSelected(null);
setResetKey((k) => k + 1);
}
}, [fetcher.state, fetcher.data]);
const isSubmitting = fetcher.state !== "idle";
// Serial parts require a scanned/selected tracked entity; other tracking
// types add a sample column without one.
const canRecord = isSerial ? !!selected : true;
return (
<Modal
open
onOpenChange={(open) => {
if (!open) onClose();
}}
>
<ModalContent size="large">
<ModalHeader>
<ModalTitle>
<Trans>Inspect Item</Trans>
</ModalTitle>
<ModalDescription>
<Trans>
Scan or select a tracked entity from this lot to add it as a
sample column, then record its result in the grid.
</Trans>
</ModalDescription>
</ModalHeader>
<ValidatedForm
key={`${selected?.id ?? "none"}-${resetKey}`}
fetcher={fetcher}
method="post"
action={path.to.inspectionSample(inspectionId)}
validator={inspectionSampleValidator}
defaultValues={{
inspectionId,
trackedEntityId: selected?.id ?? "",
status: "Pending",
notes: ""
}}
>
<ModalBody>
<Hidden name="inspectionId" value={inspectionId} />
<Hidden name="trackedEntityId" value={selected?.id ?? ""} />
<Hidden name="status" value="Pending" />
<VStack spacing={4} className="w-full">
<BarProgress
label={t`Progress`}
value={`${inspected} / ${sampleSize} · ${fails} ${fails === 1 ? "failure" : "failures"} · Ac ${acceptanceNumber}`}
progress={inspected}
max={Math.max(1, sampleSize)}
activeClassName={
fails > acceptanceNumber ? "bg-red-500" : "bg-emerald-500"
}
/>
{isSerial && (
<Tabs defaultValue="scan" className="w-full">
<TabsList className="grid w-full grid-cols-2 mb-4">
<TabsTrigger value="scan">
<LuQrCode className="mr-2" />
<Trans>Scan</Trans>
</TabsTrigger>
<TabsTrigger value="select">
<LuList className="mr-2" />
<Trans>Select</Trans>
</TabsTrigger>
</TabsList>
<TabsContent value="scan" className="mt-0 w-full">
<VStack spacing={3} className="w-full">
<InputGroup className="w-full">
<Input
autoFocus
placeholder={t`Scan or enter tracked entity ID, serial, or batch`}
value={serial}
onChange={(e) => setSerial(e.target.value)}
/>
<InputRightElement>
{serial &&
(selected ? (
<LuCheck className="text-green-500" />
) : (
<LuX className="text-red-500" />
))}
</InputRightElement>
</InputGroup>
{selected && (
<div className="w-full rounded-md border p-3">
<div className="text-xs text-muted-foreground">
<Trans>Tracked Entity</Trans>
</div>
<div className="font-mono text-sm">
{selected.readableId ?? selected.id}
</div>
{selected.readableId && (
<div className="text-xs text-muted-foreground mt-1">
{selected.id}
</div>
)}
</div>
)}
</VStack>
</TabsContent>
<TabsContent value="select" className="mt-0 w-full">
<ScrollArea className="h-[40dvh] w-full">
<VStack spacing={2} className="w-full pr-3">
{remaining.length === 0 ? (
<p className="text-center text-muted-foreground w-full py-6">
<Trans>No remaining entities to inspect.</Trans>
</p>
) : (
remaining.map((e) => {
const isSelected = selected?.id === e.id;
return (
<HStack
key={e.id}
className="w-full justify-between p-4 border rounded-md"
>
<VStack
spacing={0}
className="w-full items-start min-w-0"
>
<p className="font-mono text-sm truncate w-full">
{e.readableId ?? e.id}
</p>
{e.readableId && (
<p className="text-xs text-muted-foreground truncate w-full">
{e.id}
</p>
)}
</VStack>
<Button
size="sm"
variant={isSelected ? "primary" : "secondary"}
onClick={() => setSerial(e.id)}
>
{isSelected ? (
<Trans>Selected</Trans>
) : (
<Trans>Select</Trans>
)}
</Button>
</HStack>
);
})
)}
</VStack>
</ScrollArea>
</TabsContent>
</Tabs>
)}
<TextArea name="notes" label={t`Notes`} isDisabled={!canRecord} />
</VStack>
</ModalBody>
<ModalFooter>
<HStack spacing={2}>
<Button variant="secondary" onClick={onClose}>
<Trans>Close</Trans>
</Button>
<Submit
leftIcon={<LuCheck />}
isDisabled={!canRecord || isSubmitting}
>
<Trans>Add Sample</Trans>
</Submit>
</HStack>
</ModalFooter>
</ValidatedForm>
</ModalContent>
</Modal>
);
}