import { useEffect, useMemo, useState } from 'react' import { createFileRoute, Link, useNavigate } from '@tanstack/react-router' import { useTranslation } from 'react-i18next' import axios from 'axios' import { Alert, Badge, Button, Checkbox, EmptyState, IconButton, LoadingBlock, Modal, PageHeader, Panel, SearchInput, Table, TableBody, TableCell, TableHead, TableHeaderCell, TableRow, TextInput, } from '@nstart/ui' import { PlusIcon, PencilSimpleIcon, XCircleIcon, GearIcon, ClockCounterClockwiseIcon, MapTrifoldIcon, TrashIcon, CheckCircleIcon, WarningIcon, XIcon, DownloadSimpleIcon, CaretLeftIcon, CaretRightIcon } from '@phosphor-icons/react' import { useDictionaryDetail, useDictPendingDrafts, useRecordRaw, useRecords, type RecordsFilter, } from '@/api/queries' import { useBulkCloseRecords, useBulkExportRecords, useCreateRecord, useUpdateRecord, useCloseRecord } from '@/api/mutations' import type { BulkCloseResponse, CreateRecordRequest, DataScope, FlattenedRecord } from '@/api/client' import { SchemaDrivenForm } from '@/components/form/SchemaDrivenForm' import { DictionaryEditorDialog } from '@/components/schema/DictionaryEditorDialog' import { DictionaryDependentsPanel } from '@/components/lineage/DictionaryDependentsPanel' import { CascadeConfirmDialog } from '@/components/lineage/CascadeConfirmDialog' import { RecordHistoryDrawer } from '@/components/record/RecordHistoryDrawer' import { AoiPickerDialog, type AoiResult } from '@/components/geo/AoiPickerDialog' import { nowIsoLocal } from '@/lib/dates' import { recordDisplayName } from '@/lib/locales' import { SCOPE_BORDER_TOP, SCOPE_DOT, SCOPE_ORDER } from '@/lib/scope-style' /** * URL search params для filter state — share-friendly, persist между F5. * - q: search query (free text) * - scopes: csv subset of PUBLIC/INTERNAL/RESTRICTED. Empty/missing = все. * - bbox: AOI как CSV "west,south,east,north". Polygon AOI в URL не * сериализуем — слишком длинно (50+ точек), оставляем в local state. * Если bbox задан — initial AOI установится в bbox-режим при mount'е. */ type DictSearch = { q?: string scopes?: string bbox?: string /** Time-travel: ISO datetime "просмотр на момент X". Если задан — backend * findActiveAt(at) возвращает active version на этот момент вместо now(). */ at?: string } const SCOPE_VALUES: ReadonlySet = new Set(['PUBLIC', 'INTERNAL', 'RESTRICTED']) const validateSearch = (raw: Record): DictSearch => { const out: DictSearch = {} if (typeof raw.q === 'string' && raw.q.length > 0) out.q = raw.q if (typeof raw.scopes === 'string') { const valid = raw.scopes .split(',') .map((s) => s.trim().toUpperCase()) .filter((s): s is DataScope => SCOPE_VALUES.has(s as DataScope)) if (valid.length > 0) out.scopes = valid.join(',') } if (typeof raw.bbox === 'string' && /^-?\d+(\.\d+)?(,-?\d+(\.\d+)?){3}$/.test(raw.bbox)) { out.bbox = raw.bbox } // ISO datetime check: 2026-05-08T12:00:00Z или 2026-05-08T12:00:00+03:00. if (typeof raw.at === 'string' && !isNaN(Date.parse(raw.at))) { out.at = raw.at } return out } export const Route = createFileRoute('/dictionaries/$name')({ component: DictionaryDetail, validateSearch, }) type EditState = | { kind: 'closed' } | { kind: 'create' } | { kind: 'edit'; record: FlattenedRecord } | { kind: 'close-confirm'; record: FlattenedRecord } function DictionaryDetail() { const { name } = Route.useParams() const urlSearch = Route.useSearch() const navigate = useNavigate({ from: Route.fullPath }) const { t } = useTranslation() const detailQuery = useDictionaryDetail(name) // AOI: bbox из URL → bbox-AOI rendered initially; polygon AOI живёт // только в local state (не сериализуем в URL — слишком длинно). // setAoi записывает в URL bbox только для bbox-mode (полигон не жмём в URL). const [aoi, setAoi] = useState(() => bboxToAoi(urlSearch.bbox)) // Time-travel state — keep ISO string in URL так чтобы user мог share link // "посмотри dict на 2025-12-31T00:00:00Z". Empty/undefined = now(). const timeTravelAt: string | undefined = urlSearch.at const setTimeTravelAt = (next: string | undefined) => { void navigate({ search: (prev) => ({ ...prev, at: next || undefined }), replace: true, }) } const filter: RecordsFilter | undefined = aoi || timeTravelAt ? { ...(aoi?.kind === 'bbox' ? { bbox: aoi.bboxCsv } : {}), ...(aoi?.kind === 'polygon' ? { polygon: aoi.geojson } : {}), ...(timeTravelAt ? { at: timeTravelAt } : {}), } : undefined const recordsResult = useRecords(name, 'PUBLIC,INTERNAL,RESTRICTED', filter) /** * Approval Workflow v2 Phase 4: pending drafts на этот dict — для бейджа * "На review" в каждой строке records table. Polled 30s. Bypass'нем если * dict не approval-required (нет смысла грузить). */ const pendingDraftsQuery = useDictPendingDrafts( detailQuery.data?.approvalRequired ? name : undefined, ) const pendingByKey = useMemo(() => { const set = new Set() for (const d of pendingDraftsQuery.data ?? []) set.add(d.businessKey) return set }, [pendingDraftsQuery.data]) const createMut = useCreateRecord(name) const updateMut = useUpdateRecord(name) const closeMut = useCloseRecord(name) const bulkCloseMut = useBulkCloseRecords(name) const bulkExportMut = useBulkExportRecords(name) const [edit, setEdit] = useState({ kind: 'closed' }) const [closeReason, setCloseReason] = useState('') const [schemaEditOpen, setSchemaEditOpen] = useState(false) const [historyKey, setHistoryKey] = useState(undefined) const [aoiOpen, setAoiOpen] = useState(false) const [timeTravelOpen, setTimeTravelOpen] = useState(false) /** Phase 3 dict-relationships-v2: cascade dialog state. Открывается из 409 * на close, или явным action из record menu. */ const [cascadeKey, setCascadeKey] = useState(undefined) // Multi-select state. Set — стабильное id'шник. При изменении // records data (mutation success / refetch / filter change) — selection // не очищаем автоматически, но выкидываем те ключи которых больше нет // в видимом фильтре (избегаем "невидимых" выбранных строк). const [selection, setSelection] = useState>(new Set()) const [bulkOpen, setBulkOpen] = useState(false) const [bulkReason, setBulkReason] = useState('') const [bulkResult, setBulkResult] = useState(null) // Search & scope filter — URL-derived. Empty/missing = все scope активны. const search = urlSearch.q ?? '' const scopeFilter = useMemo>( () => new Set(urlSearch.scopes ? (urlSearch.scopes.split(',') as DataScope[]) : []), [urlSearch.scopes], ) const setSearch = (next: string) => { void navigate({ search: (prev) => ({ ...prev, q: next.length > 0 ? next : undefined }), replace: true, }) } const toggleScope = (scope: DataScope) => { const next = new Set(scopeFilter) if (next.has(scope)) next.delete(scope) else next.add(scope) void navigate({ search: (prev) => ({ ...prev, scopes: next.size > 0 ? Array.from(next).join(',') : undefined, }), replace: true, }) } const handleAoiApply = (result: AoiResult) => { setAoi(result) // bbox в URL для share; polygon оставляем в memory. void navigate({ search: (prev) => ({ ...prev, bbox: result.kind === 'bbox' ? result.bboxCsv : undefined, }), replace: true, }) } const handleAoiClear = () => { setAoi(null) void navigate({ search: (prev) => ({ ...prev, bbox: undefined }), replace: true, }) } const handleClearFilters = () => { void navigate({ search: (prev) => ({ ...prev, q: undefined, scopes: undefined }), replace: true, }) } const filteredRecords = useMemo(() => { const raw = recordsResult.data ?? [] if (raw.length === 0) return raw const q = search.trim().toLowerCase() const scopes = scopeFilter return raw.filter((r) => { if (scopes.size > 0 && !scopes.has(r.dataScope)) return false if (q.length === 0) return true // Search по businessKey + JSON.stringify(data) — простой, // покрывает локализованные поля, code, описания. Stringify // O(n) в memory, для 100 записей мгновенно. if (r.businessKey.toLowerCase().includes(q)) return true const haystack = JSON.stringify(r.data).toLowerCase() return haystack.includes(q) }) }, [recordsResult.data, search, scopeFilter]) const filtersActive = search.length > 0 || scopeFilter.size > 0 const filteredCount = filteredRecords.length // Client-side pagination — типичный словарь до 100 записей, server-side // пейджинг overkill. Page 0-indexed. PAGE_SIZE = 50 — достаточно чтобы // увидеть все основные dictionaries без листания. const PAGE_SIZE = 50 const [page, setPage] = useState(0) const totalPages = Math.max(1, Math.ceil(filteredCount / PAGE_SIZE)) // При изменении filter — на page 0 (иначе page может оказаться вне диапазона) useEffect(() => { setPage(0) }, [search, scopeFilter, aoi]) const visibleRecords = useMemo( () => filteredRecords.slice(page * PAGE_SIZE, (page + 1) * PAGE_SIZE), [filteredRecords, page], ) // Каноничный список видимых ключей — для select-all и для очистки selection // от ключей которые больше не видны (filter изменился, запись закрылась). // С client-side pagination "видимые" = только текущая страница, чтобы // select-all чекбокс трогал ровно то что юзер видит на экране. const visibleKeys = useMemo( () => visibleRecords.map((r) => r.businessKey), [visibleRecords], ) // Когда видимый набор сократился — выкидываем из selection невидимые ключи. // Иначе bulk close может пытаться закрыть запись которую юзер уже не видит, // что нарушает "WYSIWYG" принцип multi-select toolbar'а. useEffect(() => { setSelection((prev) => { if (prev.size === 0) return prev const visibleSet = new Set(visibleKeys) const next = new Set() for (const k of prev) if (visibleSet.has(k)) next.add(k) return next.size === prev.size ? prev : next }) }, [visibleKeys]) const allVisibleSelected = visibleKeys.length > 0 && visibleKeys.every((k) => selection.has(k)) const someVisibleSelected = !allVisibleSelected && visibleKeys.some((k) => selection.has(k)) const toggleSelect = (key: string) => { setSelection((prev) => { const next = new Set(prev) if (next.has(key)) next.delete(key) else next.add(key) return next }) } const toggleSelectAll = () => { setSelection((prev) => { if (visibleKeys.every((k) => prev.has(k))) { // Все видимые выбраны → снимаем именно их (не трогаем невидимые, // если такие были; на практике их не должно быть благодаря useEffect) const next = new Set(prev) for (const k of visibleKeys) next.delete(k) return next } const next = new Set(prev) for (const k of visibleKeys) next.add(k) return next }) } const clearSelection = () => setSelection(new Set()) const openBulkClose = () => { setBulkResult(null) setBulkReason('') setBulkOpen(true) } const handleBulkExport = () => { if (selection.size === 0) return bulkExportMut.mutate(Array.from(selection)) } const handleBulkClose = () => { if (selection.size === 0) return bulkCloseMut.mutate( { businessKeys: Array.from(selection), reason: bulkReason || undefined, }, { onSuccess: (res) => { setBulkResult(res) // Снимаем selection с успешно закрытых; оставляем skipped/errors // чтобы юзер видел что ещё не сделано. setSelection((prev) => { const next = new Set(prev) for (const k of res.closed) next.delete(k) return next }) }, }, ) } // Schema-driven extra columns: enum + reference поля — самые info-dense // не-локализованные scalar'ы. Берём первые 2 чтобы не перегрузить // строку (с businessKey + name + scope + extras + дата + actions = 6 // колонок, comfortably fits на 1280px). Skip name/code/businessKey // (уже показаны), всё нескалярное (object/array/localized). const extraColumns = useMemo<{ key: string; label: string; isFk: boolean }[]>(() => { const props = detailQuery.data?.schemaJson?.properties ?? {} const interesting: { key: string; label: string; isFk: boolean }[] = [] for (const [key, prop] of Object.entries(props)) { if (interesting.length >= 2) break if (key === 'name' || key === 'code' || key === 'businessKey') continue const isLocalized = Boolean(prop['x-localized']) if (isLocalized) continue const isEnum = Array.isArray(prop.enum) && prop.enum.length > 0 const isFk = typeof prop['x-references'] === 'string' && Boolean(prop['x-references']) if (!isEnum && !isFk) continue interesting.push({ key, label: humanize(key), isFk }) } return interesting }, [detailQuery.data?.schemaJson]) const editingKey = edit.kind === 'edit' ? edit.record.businessKey : undefined const rawRecordQuery = useRecordRaw(name, editingKey) const handleSubmit = (req: CreateRecordRequest) => { if (edit.kind === 'create') { createMut.mutate(req, { onSuccess: () => setEdit({ kind: 'closed' }) }) return } if (edit.kind === 'edit') { updateMut.mutate( { businessKey: edit.record.businessKey, payload: req }, { onSuccess: () => setEdit({ kind: 'closed' }) }, ) } } const handleClose = () => { if (edit.kind !== 'close-confirm') return const targetKey = edit.record.businessKey closeMut.mutate( { businessKey: targetKey, reason: closeReason || undefined }, { onSuccess: () => { setEdit({ kind: 'closed' }) setCloseReason('') }, onError: (err: unknown) => { // Phase 3 dict-relationships-v2: 409 с cascade-related code // открывает CascadeConfirmDialog. Иначе error inline в close-confirm. const status = (err as { response?: { status?: number } })?.response?.status const code = (err as { response?: { data?: { code?: string } } }) ?.response?.data?.code if ( status === 409 && (code === 'x_references_blocked_by_dependents' || code === 'x_references_cascade_required') ) { setEdit({ kind: 'closed' }) setCloseReason('') setCascadeKey(targetKey) } }, }, ) } const activeMutation = edit.kind === 'create' ? createMut : edit.kind === 'edit' ? updateMut : null const serverError = serverErrorMessage(activeMutation?.error) const totalRecords = recordsResult.data?.length ?? 0 const scope = detailQuery.data?.scope return (
{scope && ( } title={detailQuery.data?.displayName ?? name} description={ detailQuery.data?.description ? `${detailQuery.data.description} · ${totalRecords} ${t('dict.list.records')}` : `${totalRecords} ${t('dict.list.records')}` } actions={
} /> {/* Phase 1 dict-relationships-v2: schema-level reverse FK card. Hide-on-empty — большинство справочников без incoming refs не увидят этот блок. */} {aoi && (
{aoi.kind === 'bbox' ? t('aoi.activeBbox', { value: aoi.bboxCsv }) : t('aoi.activePolygon', { points: aoi.geojson.coordinates[0]?.length ?? 0, })}
)} {/* Time-travel picker — раскрывается по клику на toolbar button. ISO datetime в URL ?at=… — share-friendly. Active state показывает ambient banner справа от input'а. Phase v1 stretch. */} {timeTravelOpen && (
{t('timeTravel.label')} { if (!e.target.value) { setTimeTravelAt(undefined) return } setTimeTravelAt(new Date(e.target.value).toISOString()) }} aria-label={t('timeTravel.label')} /> {timeTravelAt && ( <> {new Date(timeTravelAt).toLocaleString()} )}
)} {/* Active state — ambient banner если ?at= задан, даже если picker закрыт. */} {timeTravelAt && !timeTravelOpen && (
{t('timeTravel.viewing', { date: new Date(timeTravelAt).toLocaleString(), })}
)} {recordsResult.isLoading && } {recordsResult.error && ( {String(recordsResult.error)} )} {recordsResult.data && recordsResult.data.length === 0 && ( )} {recordsResult.data && recordsResult.data.length > 0 && ( <>
setSearch(e.target.value)} placeholder={t('dict.filter.searchPlaceholder')} aria-label={t('dict.filter.searchPlaceholder')} />
{SCOPE_ORDER.map((s) => { const active = scopeFilter.has(s) return ( ) })}
{filtersActive && (
{t('dict.filter.matched', { count: filteredCount, total: totalRecords })}
)}
{filteredRecords.length === 0 ? ( ) : ( <> {selection.size > 0 && ( )} { if (el) el.indeterminate = someVisibleSelected }} onChange={toggleSelectAll} /> {t('dict.col.businessKey')} name / code {extraColumns.map((c) => ( {c.label} ))} {t('dict.col.scope')} {t('dict.col.validFrom')} {t('dict.col.actions')} {visibleRecords.map((r) => ( toggleSelect(r.businessKey)} />
{r.businessKey} {pendingByKey.has(r.businessKey) ? ( {t('dict.pendingReview.label')} ) : null}
{recordDisplayName( r.data, detailQuery.data?.defaultLocale ?? 'ru-RU', )} {extraColumns.map((c) => { const v = r.data?.[c.key] if (v == null || v === '') { return ( ) } const text = String(v) return ( {text} ) })} {r.dataScope} {new Date(r.validFrom).toLocaleDateString()}
} onClick={() => setHistoryKey(r.businessKey)} /> } onClick={() => setEdit({ kind: 'edit', record: r })} /> } onClick={() => setEdit({ kind: 'close-confirm', record: r })} />
))}
{totalPages > 1 && ( setPage((p) => Math.max(0, p - 1))} onNext={() => setPage((p) => Math.min(totalPages - 1, p + 1))} /> )} )} )} setEdit({ kind: 'closed' })} title={ edit.kind === 'create' ? t('dict.action.create') : edit.kind === 'edit' ? `${t('dict.action.edit')}: ${edit.record.businessKey}` : '' } maxWidth="max-w-4xl" panelClassName="max-h-[calc(100vh-2rem)] my-4 flex flex-col" bodyClassName="overflow-y-auto flex-1" > {detailQuery.data && edit.kind === 'create' && ( setEdit({ kind: 'closed' })} /> )} {detailQuery.data && edit.kind === 'edit' && rawRecordQuery.isLoading && ( )} {detailQuery.data && edit.kind === 'edit' && rawRecordQuery.error && ( {String(rawRecordQuery.error)} )} {detailQuery.data && edit.kind === 'edit' && rawRecordQuery.data && ( setEdit({ kind: 'closed' })} /> )} { setEdit({ kind: 'closed' }) setCloseReason('') }} title={t('dict.confirmClose.title')} maxWidth="max-w-md" > {edit.kind === 'close-confirm' && (

{t('dict.confirmClose.body', { key: edit.record.businessKey })}

setCloseReason(e.target.value)} /> {serverErrorMessage(closeMut.error) && ( {serverErrorMessage(closeMut.error)} )}
)}
{detailQuery.data && ( setSchemaEditOpen(false)} onSuccess={() => setSchemaEditOpen(false)} /> )} setHistoryKey(undefined)} dictionaryName={name} businessKey={historyKey} /> setCascadeKey(undefined)} onSuccess={() => { setCascadeKey(undefined) recordsResult.refetch() }} dictionaryName={name} businessKey={cascadeKey} /> setAoiOpen(false)} onApply={handleAoiApply} initial={aoi?.geojson ?? null} /> { setBulkOpen(false) setBulkResult(null) setBulkReason('') }} title={t('dict.bulk.confirmTitle')} maxWidth="max-w-lg" > { setBulkOpen(false) setBulkResult(null) setBulkReason('') }} isPending={bulkCloseMut.isPending} serverError={serverErrorMessage(bulkCloseMut.error)} result={bulkResult} />
) } type BulkSelectionToolbarProps = { count: number totalVisible: number onBulkClose: () => void onBulkExport: () => void onClear: () => void isExporting: boolean } function BulkSelectionToolbar({ count, totalVisible, onBulkClose, onBulkExport, onClear, isExporting, }: BulkSelectionToolbarProps) { const { t } = useTranslation() return (
{t('dict.bulk.selectedCount', { count, total: totalVisible })}
) } type RecordsPaginationProps = { page: number totalPages: number totalCount: number pageSize: number onPrev: () => void onNext: () => void } function RecordsPagination({ page, totalPages, totalCount, pageSize, onPrev, onNext, }: RecordsPaginationProps) { const { t } = useTranslation() const from = page * pageSize + 1 const to = Math.min((page + 1) * pageSize, totalCount) return (
{t('dict.page.range', { from, to, total: totalCount })}
{t('dict.page.of', { cur: page + 1, total: totalPages })}
) } type BulkCloseDialogProps = { count: number reason: string onReasonChange: (s: string) => void onSubmit: () => void onClose: () => void isPending: boolean serverError: string | null result: BulkCloseResponse | null } function BulkCloseDialog({ count, reason, onReasonChange, onSubmit, onClose, isPending, serverError, result, }: BulkCloseDialogProps) { const { t } = useTranslation() // После успеха — показываем сводку; вход на confirm форму прячем if (result) { return (
{result.closed.length > 0 && (
{t('dict.bulk.resultClosed', { count: result.closed.length })}
)} {result.skipped.length > 0 && (
{t('dict.bulk.resultSkipped', { count: result.skipped.length })}
)} {result.errors.length > 0 && (
{t('dict.bulk.resultErrors', { count: result.errors.length })}
)}
{(result.skipped.length > 0 || result.errors.length > 0) && (
    {result.skipped.map((s) => (
  • · {s.businessKey} — {s.reason}
  • ))} {result.errors.map((e) => (
  • ! {e.businessKey} — {e.reason}
  • ))}
)}
) } return (

{t('dict.bulk.confirmBody', { count })}

onReasonChange(e.target.value)} /> {serverError && {serverError}}
) } /** * Bootstrap initial AOI из URL bbox param. Возвращает bbox-AOI с * прямоугольным GeoJSON для preview в picker'е. Невалидные значения * уже отфильтрованы validateSearch — но dup'аем guard на парсинге. */ /** snake_case → 'Snake Case' для column header'ов. */ const humanize = (key: string): string => key.replace(/[_-]+/g, ' ').replace(/\b\w/g, (ch) => ch.toUpperCase()) const bboxToAoi = (bboxCsv: string | undefined): AoiResult | null => { if (!bboxCsv) return null const parts = bboxCsv.split(',').map(Number) if (parts.length !== 4 || parts.some((n) => Number.isNaN(n))) return null const [w, s, e, n] = parts return { kind: 'bbox', bboxCsv, geojson: { type: 'Polygon', coordinates: [ [ [w, s], [e, s], [e, n], [w, n], [w, s], ], ], }, } } const serverErrorMessage = (err: unknown): string | null => { if (!err) return null if (axios.isAxiosError(err)) { const data = err.response?.data as { message?: string; error?: string } | undefined if (err.response?.status === 422) return data?.message ?? 'Validation failed' if (err.response?.status === 409) return data?.message ?? 'Conflict — request already in progress' return data?.message ?? data?.error ?? err.message } return err instanceof Error ? err.message : 'Unknown error' }