feat(web): code-aware field errors + min count validation (#46)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-07 23:20:30 +02:00
parent 3900bc362c
commit 537b847acb
6 changed files with 57 additions and 15 deletions
+1 -1
View File
@@ -5,7 +5,7 @@
"objects": { "title": "Objects", "empty": "No objects yet", "loadError": "Could not load objects", "notFound": "Object not found", "prev": "Previous", "next": "Next", "of": "of", "new": "New object", "filter": "Filter objects…", "pageSize": "Per page", "columns": { "number": "Object №", "name": "Name", "visibility": "Visibility", "location": "Location", "count": "#", "updated": "Updated" }, "unknownRef": "(unknown)" },
"fieldsLabels": { "objectNumber": "Object number", "objectName": "Name", "count": "Number of objects", "briefDescription": "Brief description", "currentLocation": "Current location", "currentOwner": "Current owner", "recorder": "Recorder", "recordingDate": "Recording date", "visibility": "Visibility" },
"visibility": { "draft": "Draft", "internal": "Internal", "public": "Public" },
"form": { "selectPlaceholder": "— select —", "create": "Create object", "save": "Save", "cancel": "Cancel", "visibility": "Visibility", "draft": "Draft", "internal": "Internal", "required": "This field is required", "rejected": "The server rejected the changes — check required and referenced fields", "fieldRejected": "The field \"{{field}}\" was rejected — check its value", "flexibleHeading": "Catalogue fields", "saving": "Saving…", "createAnother": "Save & create another" },
"form": { "selectPlaceholder": "— select —", "create": "Create object", "save": "Save", "cancel": "Cancel", "visibility": "Visibility", "draft": "Draft", "internal": "Internal", "required": "This field is required", "rejected": "The server rejected the changes — check required and referenced fields", "fieldRejected": "The field \"{{field}}\" was rejected — check its value", "flexibleHeading": "Catalogue fields", "saving": "Saving…", "createAnother": "Save & create another", "minCount": "Must be at least 1", "fieldError": { "type_mismatch": "Wrong type for this field", "unresolved": "Referenced value not found", "unknown": "Unknown field" } },
"actions": { "edit": "Edit", "delete": "Delete", "rename": "Rename", "save": "Save", "closeDetail": "Close detail", "confirmDelete": "Delete this object? This cannot be undone.", "confirmDeleteTerm": "Delete this term? This cannot be undone.", "confirmDeleteAuthority": "Delete this authority? This cannot be undone.", "confirmDeleteField": "Delete this field definition? This cannot be undone.", "confirmDeleteVocabulary": "Delete this vocabulary? This cannot be undone.", "inUse": "Can't delete — used by {{count}} object(s). Clear those fields first." },
"labels": { "label": "Label", "externalUri": "External URI (optional)", "otherLanguages": "This entry also has labels in other languages, which are kept." },
"theme": { "light": "Light", "dark": "Dark", "system": "System" },
+1 -1
View File
@@ -5,7 +5,7 @@
"objects": { "title": "Föremål", "empty": "Inga föremål ännu", "loadError": "Kunde inte ladda föremål", "notFound": "Föremålet hittades inte", "prev": "Föregående", "next": "Nästa", "of": "av", "new": "Nytt föremål", "filter": "Filtrera föremål…", "pageSize": "Per sida", "columns": { "number": "Föremålsnr", "name": "Namn", "visibility": "Synlighet", "location": "Plats", "count": "Antal", "updated": "Uppdaterad" }, "unknownRef": "(okänd)" },
"fieldsLabels": { "objectNumber": "Föremålsnummer", "objectName": "Namn", "count": "Antal föremål", "briefDescription": "Kort beskrivning", "currentLocation": "Nuvarande plats", "currentOwner": "Nuvarande ägare", "recorder": "Registrerad av", "recordingDate": "Registreringsdatum", "visibility": "Synlighet" },
"visibility": { "draft": "Utkast", "internal": "Intern", "public": "Publik" },
"form": { "selectPlaceholder": "— välj —", "create": "Skapa föremål", "save": "Spara", "cancel": "Avbryt", "visibility": "Synlighet", "draft": "Utkast", "internal": "Intern", "required": "Fältet är obligatoriskt", "rejected": "Servern avvisade ändringarna — kontrollera obligatoriska och refererade fält", "fieldRejected": "Fältet \"{{field}}\" avvisades — kontrollera värdet", "flexibleHeading": "Katalogfält", "saving": "Sparar…", "createAnother": "Spara & skapa ny" },
"form": { "selectPlaceholder": "— välj —", "create": "Skapa föremål", "save": "Spara", "cancel": "Avbryt", "visibility": "Synlighet", "draft": "Utkast", "internal": "Intern", "required": "Fältet är obligatoriskt", "rejected": "Servern avvisade ändringarna — kontrollera obligatoriska och refererade fält", "fieldRejected": "Fältet \"{{field}}\" avvisades — kontrollera värdet", "flexibleHeading": "Katalogfält", "saving": "Sparar…", "createAnother": "Spara & skapa ny", "minCount": "Måste vara minst 1", "fieldError": { "type_mismatch": "Fel typ för detta fält", "unresolved": "Refererat värde hittades inte", "unknown": "Okänt fält" } },
"actions": { "edit": "Redigera", "delete": "Ta bort", "rename": "Byt namn", "save": "Spara", "closeDetail": "Stäng detalj", "confirmDelete": "Ta bort detta föremål? Detta kan inte ångras.", "confirmDeleteTerm": "Ta bort denna term? Detta kan inte ångras.", "confirmDeleteAuthority": "Ta bort denna auktoritet? Detta kan inte ångras.", "confirmDeleteField": "Ta bort denna fältdefinition? Detta kan inte ångras.", "confirmDeleteVocabulary": "Ta bort denna vokabulär? Detta kan inte ångras.", "inUse": "Kan inte ta bort — används av {{count}} föremål. Rensa de fälten först." },
"labels": { "label": "Etikett", "externalUri": "Extern URI (valfritt)", "otherLanguages": "Denna post har även etiketter på andra språk, som behålls." },
"theme": { "light": "Ljust", "dark": "Mörkt", "system": "System" },
+5 -3
View File
@@ -17,7 +17,7 @@ function tree() {
);
}
test("edit: fields PUT 422 with field body -> field error message shown and field marked invalid", async () => {
test("edit: fields PUT 422 with type_mismatch code -> code-specific field message shown and field marked invalid", async () => {
server.use(
http.get("/api/admin/objects/:id", () =>
HttpResponse.json({ ...amphora, fields: { inscription: "old" } }),
@@ -33,8 +33,10 @@ test("edit: fields PUT 422 with field body -> field error message shown and fiel
await screen.findByDisplayValue("Amphora");
await userEvent.click(screen.getByRole("button", { name: /save/i }));
const alerts = await screen.findAllByText(/inscription.*rejected/i);
expect(alerts.length).toBeGreaterThanOrEqual(2);
// Banner still reports the rejected field name; the field highlight uses the code-specific message.
await screen.findByText(/inscription.*rejected/i);
expect(await screen.findByText("Wrong type for this field")).toBeInTheDocument();
});
test("edit: prefilled, save -> PUT core + PUT fields -> back to detail", async () => {
+13 -1
View File
@@ -30,7 +30,12 @@ function ObjectEditFormLoaded({ object, id }: { object: AdminObjectView; id: str
const update = useUpdateObject();
const setFields = useSetFields();
const locationState = location.state as { fieldsError?: boolean; fieldErrorKey?: string } | null;
const locationState = location.state as {
created?: boolean;
fieldsError?: boolean;
fieldErrorKey?: string;
fieldErrorCode?: string;
} | null;
const [error, setError] = useState<string | null>(() => {
if (locationState?.fieldErrorKey) return t("form.fieldRejected", { field: locationState.fieldErrorKey });
@@ -42,6 +47,10 @@ function ObjectEditFormLoaded({ object, id }: { object: AdminObjectView; id: str
locationState?.fieldErrorKey ?? null,
);
const [fieldErrorCode, setFieldErrorCode] = useState<string | null>(
locationState?.fieldErrorCode ?? null,
);
useBreadcrumb([
{ label: t("nav.objects"), to: "/objects" },
{ label: object.object_number, to: `/objects/${id}` },
@@ -64,6 +73,7 @@ function ObjectEditFormLoaded({ object, id }: { object: AdminObjectView; id: str
const onSubmit = async (values: ObjectFormValues): Promise<boolean> => {
setError(null);
setFieldErrorKey(null);
setFieldErrorCode(null);
try {
await update.mutateAsync({ id, body: values.core });
@@ -71,6 +81,7 @@ function ObjectEditFormLoaded({ object, id }: { object: AdminObjectView; id: str
} catch (e) {
if (e instanceof FieldRejection) {
setFieldErrorKey(e.field);
setFieldErrorCode(e.code);
setError(t("form.fieldRejected", { field: e.field }));
} else {
setError(t("form.rejected"));
@@ -89,6 +100,7 @@ function ObjectEditFormLoaded({ object, id }: { object: AdminObjectView; id: str
defaults={defaults}
formError={error}
fieldErrorKey={fieldErrorKey}
fieldErrorCode={fieldErrorCode}
onSubmit={onSubmit}
onCancel={() => navigate(`/objects/${id}`)}
/>
+18
View File
@@ -47,6 +47,24 @@ test("required core + required flexible field block submit", async () => {
expect(onSubmit).not.toHaveBeenCalled();
});
test("number_of_objects of 0 is blocked client-side with the minCount message", async () => {
const onSubmit = vi.fn();
renderApp(<ObjectForm mode="create" onSubmit={onSubmit} onCancel={() => {}} />);
await userEvent.type(await screen.findByLabelText(/object number/i), "A-9");
await userEvent.type(screen.getByLabelText(/^name/i), "Amphora");
await userEvent.type(screen.getByLabelText(/inscription/i), "To the gods");
const count = screen.getByLabelText(/number of objects/i);
await userEvent.clear(count);
await userEvent.type(count, "0");
await userEvent.click(screen.getByRole("button", { name: /create object/i }));
expect(await screen.findByText("Must be at least 1")).toBeInTheDocument();
expect(onSubmit).not.toHaveBeenCalled();
});
test("edit mode: no visibility control, save button, prefilled values", async () => {
const onSubmit = vi.fn();
renderApp(
+19 -9
View File
@@ -51,6 +51,7 @@ export function ObjectForm({
onCancel,
formError,
fieldErrorKey,
fieldErrorCode,
}: {
mode: "create" | "edit";
defaults?: { core: ObjectCore; fields: Record<string, unknown> };
@@ -58,6 +59,7 @@ export function ObjectForm({
onCancel: () => void;
formError?: string | null;
fieldErrorKey?: string | null;
fieldErrorCode?: string | null;
}) {
const { t } = useTranslation();
const { default_language } = useConfig();
@@ -80,12 +82,14 @@ export function ObjectForm({
useEffect(() => {
if (fieldErrorKey) {
form.setError(`fields.${fieldErrorKey}` as never, {
type: "server",
message: t("form.fieldRejected", { field: fieldErrorKey }),
});
const codeKey = fieldErrorCode ? `form.fieldError.${fieldErrorCode}` : "";
const message =
fieldErrorCode && t(codeKey) !== codeKey
? t(codeKey)
: t("form.fieldRejected", { field: fieldErrorKey });
form.setError(`fields.${fieldErrorKey}` as never, { type: "server", message });
}
}, [fieldErrorKey, form, t]);
}, [fieldErrorKey, fieldErrorCode, form, t]);
const runSubmit = (createAnother: boolean) =>
handleSubmit(async (data) => {
@@ -106,7 +110,7 @@ export function ObjectForm({
const coreField = (
key: keyof ObjectCore,
labelKey: string,
opts?: { type?: string; required?: boolean },
opts?: { type?: string; required?: boolean; min?: number },
) => (
<div className="space-y-1">
<Label htmlFor={key}>{t(`fieldsLabels.${labelKey}`)}</Label>
@@ -117,14 +121,20 @@ export function ObjectForm({
{...register(
`core.${key}` as const,
opts?.type === "number"
? { valueAsNumber: true, required: opts?.required }
? {
valueAsNumber: true,
required: opts?.required,
...(opts?.min !== undefined
? { min: { value: opts.min, message: t("form.minCount") } }
: {}),
}
: { required: opts?.required },
)}
/>
{errors.core?.[key] && (
<p role="alert" className="text-xs text-destructive">
{t("form.required")}
{errors.core[key]?.message || t("form.required")}
</p>
)}
</div>
@@ -149,7 +159,7 @@ export function ObjectForm({
{coreField("object_number", "objectNumber", { required: true })}
{coreField("object_name", "objectName", { required: true })}
{coreField("number_of_objects", "count", { type: "number", required: true })}
{coreField("number_of_objects", "count", { type: "number", required: true, min: 1 })}
{coreField("brief_description", "briefDescription")}
{coreField("current_location", "currentLocation")}
{coreField("current_owner", "currentOwner")}