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)

ordinis-admin-ui/src/api/client.ts

@@ -1,9 +1,5 @@
 import axios from 'axios'
 
-/**
- * Centralized axios instance. JWT injection вешается через interceptor:
- * когда @nstart/auth интегрируется, добавляем Authorization: Bearer ...
- */
 export const apiClient = axios.create({
   baseURL: import.meta.env.VITE_API_BASE ?? '/api/v1',
   timeout: 10_000,
@@ -12,7 +8,6 @@ export const apiClient = axios.create({
 apiClient.interceptors.request.use((config) => {
   const lang = (typeof navigator !== 'undefined' && navigator.language) || 'ru-RU'
   config.headers['Accept-Language'] = `${lang},ru-RU;q=0.9,en-US;q=0.8`
-  // JWT placeholder
   const token = localStorage.getItem('ordinis.token')
   if (token) config.headers['Authorization'] = `Bearer ${token}`
   return config
@@ -28,12 +23,14 @@ apiClient.interceptors.response.use(
   },
 )
 
+export type DataScope = 'PUBLIC' | 'INTERNAL' | 'RESTRICTED'
+
 export type DictionaryDefinition = {
   id: string
   name: string
   displayName?: string
   description?: string
-  scope: 'PUBLIC' | 'INTERNAL' | 'RESTRICTED'
+  scope: DataScope
   schemaVersion: string
   bundle: string
   supportedLocales: string[]
@@ -42,12 +39,59 @@ export type DictionaryDefinition = {
   updatedAt: string
 }
 
+export type JsonSchema = {
+  type?: string
+  title?: string
+  description?: string
+  properties?: Record<string, JsonSchema>
+  required?: string[]
+  enum?: unknown[]
+  format?: string
+  pattern?: string
+  minLength?: number
+  maxLength?: number
+  minimum?: number
+  maximum?: number
+  items?: JsonSchema
+  additionalProperties?: boolean | JsonSchema
+  ['x-localized']?: boolean
+  default?: unknown
+}
+
+export type DictionaryDetail = DictionaryDefinition & {
+  schemaJson: JsonSchema
+}
+
 export type FlattenedRecord = {
   id: string
   businessKey: string
   data: Record<string, unknown>
-  dataScope: 'PUBLIC' | 'INTERNAL' | 'RESTRICTED'
+  dataScope: DataScope
   validFrom: string
   validTo: string
   _meta?: { locale?: string }
 }
+
+export type RecordResponse = {
+  id: string
+  dictionaryId: string
+  businessKey: string
+  data: Record<string, unknown>
+  geometryWkt?: string
+  dataScope: DataScope
+  validFrom: string
+  validTo: string
+  createdAt: string
+  updatedAt: string
+  createdBy?: string
+  updatedBy?: string
+  version: number
+}
+
+export type CreateRecordRequest = {
+  businessKey: string
+  data: Record<string, unknown>
+  geometryWkt?: string
+  validFrom?: string
+  validTo?: string
+}

ordinis-admin-ui/src/api/mutations.ts

@@ -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] })
+    },
+  })
+}

ordinis-admin-ui/src/api/queries.ts

@@ -1,17 +1,31 @@
 import { useQuery, queryOptions } from '@tanstack/react-query'
-import { apiClient, type DictionaryDefinition, type FlattenedRecord } from './client'
+import {
+  apiClient,
+  type DictionaryDefinition,
+  type DictionaryDetail,
+  type FlattenedRecord,
+} from './client'
 
 export const dictionariesQuery = queryOptions({
-  queryKey: ['dictionaries'],
+  queryKey: ['dictionaries'] as const,
   queryFn: async (): Promise<DictionaryDefinition[]> => {
     const { data } = await apiClient.get<DictionaryDefinition[]>('/dictionaries')
     return data
   },
 })
 
+export const dictionaryDetailQuery = (name: string) =>
+  queryOptions({
+    queryKey: ['dictionary', name] as const,
+    queryFn: async (): Promise<DictionaryDetail> => {
+      const { data } = await apiClient.get<DictionaryDetail>(`/dictionaries/${name}`)
+      return data
+    },
+  })
+
 export const recordsQuery = (dictionaryName: string, scopeCsv: string) =>
   queryOptions({
-    queryKey: ['records', dictionaryName, scopeCsv],
+    queryKey: ['records', dictionaryName, scopeCsv] as const,
     queryFn: async (): Promise<FlattenedRecord[]> => {
       const { data } = await apiClient.get<FlattenedRecord[]>(
         `/${dictionaryName}/records`,
@@ -22,5 +36,6 @@ export const recordsQuery = (dictionaryName: string, scopeCsv: string) =>
   })
 
 export const useDictionaries = () => useQuery(dictionariesQuery)
+export const useDictionaryDetail = (name: string) => useQuery(dictionaryDetailQuery(name))
 export const useRecords = (dictionaryName: string, scopeCsv: string) =>
   useQuery(recordsQuery(dictionaryName, scopeCsv))