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 type { Json } from "@carbon/database";
import {
DatePicker,
InputControlled,
MultiSelect,
Select,
ValidatedForm
} from "@carbon/form";
import { useAction } from "@carbon/query";
import {
Button,
Copy,
HStack,
Subheading,
Tooltip,
TooltipContent,
TooltipTrigger,
toast,
VStack
} from "@carbon/react";
import { Trans, useLingui } from "@lingui/react/macro";
import { useCallback } from "react";
import { LuCopy, LuKeySquare, LuLink } from "react-icons/lu";
import { useParams } from "react-router";
import { z } from "zod";
import {
Assignee,
EmployeeAvatar,
useOptimisticAssignment
} from "~/components";
import { Enumerable } from "~/components/Enumerable";
import { Tags } from "~/components/Form";
import CustomFormInlineFields from "~/components/Form/CustomFormInlineFields";
import { usePermissions, useRouteData } from "~/hooks";
import type { action } from "~/routes/x+/items+/update";
import type { ListItem, StorageItem } from "~/types";
import { path } from "~/utils/path";
import { copyToClipboard } from "~/utils/string";
import {
isIssueLocked,
nonConformanceApprovalRequirement,
nonConformancePriority,
nonConformanceSource
} from "../../quality.models";
import type { Issue } from "../../types";
import { getPriorityIcon, getSourceIcon } from "./IssueIcons";
const IssueProperties = () => {
const { id } = useParams();
if (!id) throw new Error("id not found");
const { t } = useLingui();
const permissions = usePermissions();
const routeData = useRouteData<{
nonConformance: Issue;
nonConformanceTypes: ListItem[];
investigationTypes: ListItem[];
requiredActions: ListItem[];
files: Promise<StorageItem[]>;
tags: { name: string }[];
}>(path.to.issue(id));
const optimisticAssignment = useOptimisticAssignment({
id: id,
table: "nonConformance"
});
const assignee =
optimisticAssignment !== undefined
? optimisticAssignment
: routeData?.nonConformance?.assignee;
const isStarted = routeData?.nonConformance?.status !== "Registered";
const isLocked = isIssueLocked(routeData?.nonConformance?.status);
const fetcher = useAction<typeof action>({
onError: (data) => {
if (data?.error) {
toast.error(data.error.message);
}
}
});
// biome-ignore lint/correctness/useExhaustiveDependencies: suppressed due to migration
const onUpdate = useCallback(
(
field:
| "source"
| "priority"
| "requiredActionIds"
| "approvalRequirements"
| "name"
| "description"
| "locationId"
| "nonConformanceTypeId"
| "openDate"
| "dueDate"
| "closeDate"
| "quantity"
| "itemId"
| "supplierId",
value: string | null
) => {
const formData = new FormData();
formData.append("ids", id);
formData.append("field", field);
formData.append("value", value?.toString() ?? "");
fetcher.submit(formData, {
method: "post",
action: path.to.bulkUpdateIssue
});
},
[id]
);
// biome-ignore lint/correctness/useExhaustiveDependencies: suppressed due to migration
const onUpdateTags = useCallback(
(value: string[]) => {
const formData = new FormData();
formData.append("ids", id);
formData.append("table", "nonConformance");
value.forEach((v) => {
formData.append("value", v);
});
fetcher.submit(formData, {
method: "post",
action: path.to.tags
});
},
[id]
);
// biome-ignore lint/correctness/useExhaustiveDependencies: suppressed due to migration
const onUpdateCustomFields = useCallback(
(value: string) => {
const formData = new FormData();
formData.append("ids", id);
formData.append("table", "nonConformance");
formData.append("value", value);
fetcher.submit(formData, {
method: "post",
action: path.to.customFields
});
},
[id]
);
const disableStructureUpdate =
!permissions.can("delete", "quality") || isStarted || isLocked;
return (
<VStack
spacing={4}
className="w-96 bg-background/30 h-full overflow-y-auto scrollbar-thin scrollbar-track-transparent scrollbar-thumb-accent border-l border-border px-4 py-2 text-sm"
>
<VStack spacing={2}>
<HStack className="w-full justify-between">
<Subheading as="h3" variant="light">
<Trans>Properties</Trans>
</Subheading>
<HStack spacing={1}>
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="ghost"
aria-label={t`Link`}
size="sm"
className="p-1"
onClick={() =>
copyToClipboard(window.location.origin + path.to.issue(id))
}
>
<LuLink className="w-3 h-3" />
</Button>
</TooltipTrigger>
<TooltipContent>
<span>
<Trans>Copy link to issue</Trans>
</span>
</TooltipContent>
</Tooltip>
<Copy
text={routeData?.nonConformance?.nonConformanceId ?? ""}
label={t`Copy issue unique identifier`}
icon={<LuKeySquare className="size-3" />}
variant="ghost"
className="w-auto"
/>
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="ghost"
aria-label={t`Copy`}
size="sm"
className="p-1"
onClick={() =>
copyToClipboard(
routeData?.nonConformance?.nonConformanceId ?? ""
)
}
>
<LuCopy className="w-3 h-3" />
</Button>
</TooltipTrigger>
<TooltipContent>
<span>
<Trans>Copy issue number</Trans>
</span>
</TooltipContent>
</Tooltip>
</HStack>
</HStack>
<VStack spacing={1}>
<span className="text-sm tracking-tight">
{routeData?.nonConformance?.nonConformanceId}
</span>
<ValidatedForm
defaultValues={{
name: routeData?.nonConformance?.name ?? undefined
}}
validator={z.object({
name: z.string()
})}
className="w-full"
>
<span className="text-xs text-muted-foreground">
<InputControlled
label=""
name="name"
size="sm"
inline
isReadOnly={isLocked}
value={routeData?.nonConformance?.name ?? ""}
onBlur={(e) => {
onUpdate("name", e.target.value ?? null);
}}
className="text-muted-foreground"
/>
</span>
</ValidatedForm>
</VStack>
</VStack>
<VStack spacing={2}>
<h3 className="text-xs text-muted-foreground">
<Trans>Assignee</Trans>
</h3>
<Assignee
id={id}
table="nonConformance"
size="sm"
value={assignee ?? ""}
isReadOnly={!permissions.can("update", "quality")}
/>
</VStack>
<ValidatedForm
defaultValues={{
nonConformanceTypeId:
routeData?.nonConformance?.nonConformanceTypeId ?? ""
}}
validator={z.object({
nonConformanceTypeId: z.string().optional()
})}
className="w-full"
>
<Select
options={(routeData?.nonConformanceTypes ?? []).map((type) => ({
value: type.id,
label: <Enumerable value={type.name} />
}))}
isReadOnly={disableStructureUpdate}
label={t`Issue Type`}
termId="issue-issue-type"
name="nonConformanceTypeId"
inline={(value, options) => {
return (
<Enumerable
value={
routeData?.nonConformanceTypes.find((t) => t.id === value)
?.name ?? null
}
/>
);
}}
onChange={(value) => {
if (value) {
onUpdate("nonConformanceTypeId", value.value);
}
}}
/>
</ValidatedForm>
<ValidatedForm
defaultValues={{
source: routeData?.nonConformance?.source ?? ""
}}
validator={z.object({
source: z.string().optional()
})}
className="w-full"
>
<Select
options={nonConformanceSource.map((source) => ({
value: source,
label: (
<div className="flex gap-2 items-center">
{getSourceIcon(source, false)}
<span>{source}</span>
</div>
)
}))}
isReadOnly={disableStructureUpdate}
label={t`Source`}
name="source"
inline={(value, options) => {
return (
<div className="flex gap-2 items-center">
{getSourceIcon(value as "External" | "Internal", false)}
<span>{value}</span>
</div>
);
}}
onChange={(value) => {
if (value) {
onUpdate("source", value.value);
}
}}
/>
</ValidatedForm>
<ValidatedForm
defaultValues={{
priority: routeData?.nonConformance?.priority ?? ""
}}
validator={z.object({
priority: z.string().optional()
})}
className="w-full"
>
<Select
options={nonConformancePriority.map((priority) => ({
value: priority,
label: (
<div className="flex gap-2 items-center">
{getPriorityIcon(priority, false)}
<span>{priority}</span>
</div>
)
}))}
isReadOnly={disableStructureUpdate}
label={t`Priority`}
name="priority"
inline={(value, options) => {
return (
<div className="flex gap-2 items-center">
{getPriorityIcon(
value as "Low" | "Medium" | "High" | "Critical",
false
)}
<span>{value}</span>
</div>
);
}}
onChange={(value) => {
if (value) {
onUpdate("priority", value.value);
}
}}
/>
</ValidatedForm>
<ValidatedForm
defaultValues={{
requiredActionIds: routeData?.nonConformance?.requiredActionIds ?? []
}}
validator={z.object({
requiredActionIds: z.array(z.string()).optional()
})}
className="w-full"
>
<MultiSelect
options={(routeData?.requiredActions ?? []).map((type) => ({
value: type.id,
label: type.name
}))}
isReadOnly={disableStructureUpdate}
label={t`Required Actions`}
name="requiredActionIds"
inline
value={routeData?.nonConformance?.requiredActionIds ?? []}
onChange={(value) => {
onUpdate("requiredActionIds", value.map((v) => v.value).join(","));
}}
/>
</ValidatedForm>
<ValidatedForm
defaultValues={{
approvalRequirements:
routeData?.nonConformance?.approvalRequirements ?? []
}}
validator={z.object({
approvalRequirements: z.array(z.string()).optional()
})}
className="w-full"
>
<MultiSelect
options={nonConformanceApprovalRequirement.map((type) => ({
value: type,
label: type
}))}
isReadOnly={disableStructureUpdate}
label={t`Approval Requirements`}
name="approvalRequirements"
inline
onChange={(value) => {
onUpdate(
"approvalRequirements",
value.map((v) => v.value).join(",")
);
}}
/>
</ValidatedForm>
<ValidatedForm
defaultValues={{
openDate: routeData?.nonConformance?.openDate ?? ""
}}
validator={z.object({
openDate: z.string().min(1, { message: "Open date is required" })
})}
className="w-full"
>
<DatePicker
name="openDate"
label={t`Open Date`}
inline
isDisabled={!permissions.can("update", "quality") || isLocked}
onChange={(date) => {
onUpdate("openDate", date);
}}
/>
</ValidatedForm>
<VStack spacing={2}>
<h3 className="text-xs text-muted-foreground">
<Trans>Created By</Trans>
</h3>
<EmployeeAvatar
employeeId={routeData?.nonConformance?.createdBy!}
size="xxs"
/>
</VStack>
<ValidatedForm
defaultValues={{
dueDate: routeData?.nonConformance?.dueDate ?? ""
}}
validator={z.object({
dueDate: z.string().min(1, { message: "Due date is required" })
})}
className="w-full"
>
<DatePicker
name="dueDate"
label={t`Due Date`}
inline
isDisabled={!permissions.can("update", "quality") || isLocked}
onChange={(date) => {
onUpdate("dueDate", date);
}}
/>
</ValidatedForm>
<ValidatedForm
defaultValues={{
closeDate: routeData?.nonConformance?.closeDate ?? ""
}}
validator={z.object({
closeDate: z.string().min(1, { message: "Close date is required" })
})}
className="w-full"
>
<DatePicker
name="closeDate"
label={t`Close Date`}
inline
isDisabled={!permissions.can("update", "quality") || isLocked}
onChange={(date) => {
onUpdate("closeDate", date);
}}
/>
</ValidatedForm>
<ValidatedForm
defaultValues={{
tags: routeData?.nonConformance?.tags ?? []
}}
validator={z.object({
tags: z.array(z.string()).optional()
})}
className="w-full"
>
<Tags
availableTags={routeData?.tags ?? []}
label={t`Tags`}
name="tags"
table="nonConformance"
inline
onChange={onUpdateTags}
/>
</ValidatedForm>
<CustomFormInlineFields
customFields={
(routeData?.nonConformance?.customFields ?? {}) as Record<
string,
Json
>
}
table="nonConformance"
tags={routeData?.nonConformance?.tags ?? []}
onUpdate={onUpdateCustomFields}
/>
</VStack>
);
};
export default IssueProperties;