feat(admin-ui): record CRUD with json-schema-driven form

POST/PUT/DELETE формы для записей справочников. Schema-driven рендер полей из definition.schemaJson — i18n-aware (x-localized → input на каждый supportedLocale), enum → select, type → text/number/checkbox/array. Валидация через ajv (Draft-07, match backend networknt validator). - new: api/mutations.ts с Idempotency-Key (crypto.randomUUID) и query invalidation - new: SchemaDrivenForm — react-hook-form + ajv compile per-schema, errors через setError по ajv instancePath - new: Modal (Esc + backdrop click) и confirm dialog для close-операции - nginx: regex location ^/api/v1/dictionaries/[^/]+$ → writer (admin schema fetch) - queries: dictionaryDetailQuery возвращает full def с schemaJson - i18n: RU/EN ключи для CRUD (create/edit/close, validFrom/validTo, confirm)
2026-05-04 01:49:08 +03:00
parent d5a747616a
commit b1b1f05e3c
11 changed files with 3137 additions and 36 deletions
@@ -0,0 +1,63 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query'
+import {
+  apiClient,
+  type CreateRecordRequest,
+  type RecordResponse,
+} from './client'
+
+const idempotencyKey = () =>
+  typeof crypto !== 'undefined' && 'randomUUID' in crypto
+    ? crypto.randomUUID()
+    : `${Date.now()}-${Math.random().toString(36).slice(2)}`
+
+export const useCreateRecord = (dictionaryName: string) => {
+  const qc = useQueryClient()
+  return useMutation({
+    mutationFn: async (req: CreateRecordRequest): Promise<RecordResponse> => {
+      const { data } = await apiClient.post<RecordResponse>(
+        `/dictionaries/${dictionaryName}/records`,
+        req,
+        { headers: { 'Idempotency-Key': idempotencyKey() } },
+      )
+      return data
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ['records', dictionaryName] })
+    },
+  })
+}
+
+export const useUpdateRecord = (dictionaryName: string) => {
+  const qc = useQueryClient()
+  return useMutation({
+    mutationFn: async (params: {
+      businessKey: string
+      payload: CreateRecordRequest
+    }): Promise<RecordResponse> => {
+      const { data } = await apiClient.put<RecordResponse>(
+        `/dictionaries/${dictionaryName}/records/${encodeURIComponent(params.businessKey)}`,
+        params.payload,
+        { headers: { 'Idempotency-Key': idempotencyKey() } },
+      )
+      return data
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ['records', dictionaryName] })
+    },
+  })
+}
+
+export const useCloseRecord = (dictionaryName: string) => {
+  const qc = useQueryClient()
+  return useMutation({
+    mutationFn: async (params: { businessKey: string; reason?: string }): Promise<void> => {
+      await apiClient.delete(
+        `/dictionaries/${dictionaryName}/records/${encodeURIComponent(params.businessKey)}`,
+        { params: params.reason ? { reason: params.reason } : undefined },
+      )
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ['records', dictionaryName] })
+    },
+  })
+}