2023-12-13 02:22:02 +03:00
|
|
|
import useSWR from "swr";
|
|
|
|
|
import * as monaco from "monaco-editor";
|
|
|
|
|
import { configureMonacoYaml } from "monaco-yaml";
|
2023-12-16 02:24:50 +03:00
|
|
|
import { useCallback, useEffect, useRef, useState } from "react";
|
2023-12-13 02:22:02 +03:00
|
|
|
import { useApiHost } from "@/api";
|
2023-12-08 16:33:22 +03:00
|
|
|
import Heading from "@/components/ui/heading";
|
2024-03-03 19:32:47 +03:00
|
|
|
import ActivityIndicator from "@/components/indicators/activity-indicator";
|
2023-12-13 02:22:02 +03:00
|
|
|
import { Button } from "@/components/ui/button";
|
2025-03-13 17:57:12 +03:00
|
|
|
import axios, { AxiosError } from "axios";
|
2023-12-13 02:22:02 +03:00
|
|
|
import copy from "copy-to-clipboard";
|
|
|
|
|
import { useTheme } from "@/context/theme-provider";
|
2024-02-06 02:54:08 +03:00
|
|
|
import { Toaster } from "@/components/ui/sonner";
|
|
|
|
|
import { toast } from "sonner";
|
2024-05-21 21:06:17 +03:00
|
|
|
import { LuCopy, LuSave } from "react-icons/lu";
|
|
|
|
|
import { MdOutlineRestartAlt } from "react-icons/md";
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
import { Settings, Code } from "lucide-react";
|
2024-11-05 18:33:41 +03:00
|
|
|
import RestartDialog from "@/components/overlay/dialog/RestartDialog";
|
2025-03-16 18:36:20 +03:00
|
|
|
import { useTranslation } from "react-i18next";
|
2025-03-13 17:57:12 +03:00
|
|
|
import { useRestart } from "@/api/ws";
|
2025-07-10 17:28:23 +03:00
|
|
|
import { useResizeObserver } from "@/hooks/resize-observer";
|
2025-05-24 19:47:15 +03:00
|
|
|
import { FrigateConfig } from "@/types/frigateConfig";
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
import { GuiConfigEditor } from "@/components/config/GuiConfigEditor";
|
|
|
|
|
import { configToYaml } from "@/lib/configUtils";
|
|
|
|
|
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";
|
2023-12-13 02:22:02 +03:00
|
|
|
|
|
|
|
|
type SaveOptions = "saveonly" | "restart";
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
type EditorMode = "yaml" | "gui";
|
2023-12-08 16:33:22 +03:00
|
|
|
|
2025-03-13 17:57:12 +03:00
|
|
|
type ApiErrorResponse = {
|
|
|
|
|
message?: string;
|
|
|
|
|
detail?: string;
|
|
|
|
|
};
|
|
|
|
|
|
2023-12-08 16:33:22 +03:00
|
|
|
function ConfigEditor() {
|
2025-03-16 18:36:20 +03:00
|
|
|
const { t } = useTranslation(["views/configEditor"]);
|
2023-12-13 02:22:02 +03:00
|
|
|
const apiHost = useApiHost();
|
|
|
|
|
|
2024-04-12 15:31:30 +03:00
|
|
|
useEffect(() => {
|
2025-03-16 18:36:20 +03:00
|
|
|
document.title = t("documentTitle");
|
|
|
|
|
}, [t]);
|
2024-04-12 15:31:30 +03:00
|
|
|
|
2025-05-24 19:47:15 +03:00
|
|
|
const { data: config } = useSWR<FrigateConfig>("config", {
|
|
|
|
|
revalidateOnFocus: false,
|
|
|
|
|
});
|
|
|
|
|
const { data: rawConfig } = useSWR<string>("config/raw");
|
2023-12-13 02:22:02 +03:00
|
|
|
|
2024-03-21 04:46:45 +03:00
|
|
|
const { theme, systemTheme } = useTheme();
|
2023-12-13 02:22:02 +03:00
|
|
|
const [error, setError] = useState<string | undefined>();
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
const [editorMode, setEditorMode] = useState<EditorMode>("yaml");
|
2023-12-13 02:22:02 +03:00
|
|
|
|
2023-12-20 17:33:57 +03:00
|
|
|
const editorRef = useRef<monaco.editor.IStandaloneCodeEditor | null>(null);
|
2024-05-27 18:31:58 +03:00
|
|
|
const modelRef = useRef<monaco.editor.ITextModel | null>(null);
|
2023-12-20 17:33:57 +03:00
|
|
|
const configRef = useRef<HTMLDivElement | null>(null);
|
2024-09-20 02:36:07 +03:00
|
|
|
const schemaConfiguredRef = useRef(false);
|
2023-12-13 02:22:02 +03:00
|
|
|
|
2024-11-05 18:33:41 +03:00
|
|
|
const [restartDialogOpen, setRestartDialogOpen] = useState(false);
|
2025-03-13 17:57:12 +03:00
|
|
|
const { send: sendRestart } = useRestart();
|
2024-11-05 18:33:41 +03:00
|
|
|
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
// Store GUI config state
|
|
|
|
|
const [guiConfigData, setGuiConfigData] = useState<Record<string, unknown>>(
|
|
|
|
|
{},
|
|
|
|
|
);
|
|
|
|
|
|
2023-12-13 02:22:02 +03:00
|
|
|
const onHandleSaveConfig = useCallback(
|
2025-03-13 17:57:12 +03:00
|
|
|
async (save_option: SaveOptions): Promise<void> => {
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
let configData: string;
|
|
|
|
|
|
|
|
|
|
if (editorMode === "yaml") {
|
|
|
|
|
if (!editorRef.current) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
configData = editorRef.current.getValue();
|
|
|
|
|
} else {
|
|
|
|
|
// GUI mode - convert to YAML
|
|
|
|
|
configData = configToYaml(guiConfigData);
|
2023-12-13 02:22:02 +03:00
|
|
|
}
|
|
|
|
|
|
2025-03-13 17:57:12 +03:00
|
|
|
try {
|
|
|
|
|
const response = await axios.post(
|
2023-12-13 02:22:02 +03:00
|
|
|
`config/save?save_option=${save_option}`,
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
configData,
|
2023-12-13 02:22:02 +03:00
|
|
|
{
|
|
|
|
|
headers: { "Content-Type": "text/plain" },
|
2024-02-29 01:23:56 +03:00
|
|
|
},
|
2025-03-13 17:57:12 +03:00
|
|
|
);
|
|
|
|
|
|
|
|
|
|
if (response.status === 200) {
|
|
|
|
|
setError("");
|
|
|
|
|
setHasChanges(false);
|
|
|
|
|
toast.success(response.data.message, { position: "top-center" });
|
|
|
|
|
}
|
|
|
|
|
} catch (error) {
|
2025-03-16 18:36:20 +03:00
|
|
|
toast.error(t("toast.error.savingError"), { position: "top-center" });
|
2025-03-13 17:57:12 +03:00
|
|
|
|
|
|
|
|
const axiosError = error as AxiosError<ApiErrorResponse>;
|
|
|
|
|
const errorMessage =
|
|
|
|
|
axiosError.response?.data?.message ||
|
|
|
|
|
axiosError.response?.data?.detail ||
|
|
|
|
|
"Unknown error";
|
|
|
|
|
|
|
|
|
|
setError(errorMessage);
|
|
|
|
|
throw new Error(errorMessage);
|
|
|
|
|
}
|
2023-12-13 02:22:02 +03:00
|
|
|
},
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
[editorRef, editorMode, guiConfigData, t],
|
2023-12-13 02:22:02 +03:00
|
|
|
);
|
|
|
|
|
|
|
|
|
|
const handleCopyConfig = useCallback(async () => {
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
let configData: string;
|
|
|
|
|
|
|
|
|
|
if (editorMode === "yaml") {
|
|
|
|
|
if (!editorRef.current) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
configData = editorRef.current.getValue();
|
|
|
|
|
} else {
|
|
|
|
|
configData = configToYaml(guiConfigData);
|
2023-12-13 02:22:02 +03:00
|
|
|
}
|
|
|
|
|
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
copy(configData);
|
2025-03-16 18:36:20 +03:00
|
|
|
toast.success(t("toast.success.copyToClipboard"), {
|
|
|
|
|
position: "top-center",
|
|
|
|
|
});
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
}, [editorRef, editorMode, guiConfigData, t]);
|
2023-12-13 02:22:02 +03:00
|
|
|
|
2025-03-13 17:57:12 +03:00
|
|
|
const handleSaveAndRestart = useCallback(async () => {
|
|
|
|
|
try {
|
|
|
|
|
await onHandleSaveConfig("saveonly");
|
|
|
|
|
setRestartDialogOpen(true);
|
|
|
|
|
} catch (error) {
|
|
|
|
|
// If save fails, error is already set in onHandleSaveConfig, no dialog opens
|
|
|
|
|
}
|
|
|
|
|
}, [onHandleSaveConfig]);
|
|
|
|
|
|
2023-12-13 02:22:02 +03:00
|
|
|
useEffect(() => {
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
if (!rawConfig || editorMode !== "yaml") {
|
2023-12-13 02:22:02 +03:00
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
2024-09-20 02:36:07 +03:00
|
|
|
const modelUri = monaco.Uri.parse(
|
|
|
|
|
`a://b/api/config/schema_${Date.now()}.json`,
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
// Configure Monaco YAML schema only once
|
|
|
|
|
if (!schemaConfiguredRef.current) {
|
|
|
|
|
configureMonacoYaml(monaco, {
|
|
|
|
|
enableSchemaRequest: true,
|
|
|
|
|
hover: true,
|
|
|
|
|
completion: true,
|
|
|
|
|
validate: true,
|
|
|
|
|
format: true,
|
|
|
|
|
schemas: [
|
|
|
|
|
{
|
|
|
|
|
uri: `${apiHost}api/config/schema.json`,
|
|
|
|
|
fileMatch: [String(modelUri)],
|
|
|
|
|
},
|
|
|
|
|
],
|
|
|
|
|
});
|
|
|
|
|
schemaConfiguredRef.current = true;
|
2023-12-13 02:22:02 +03:00
|
|
|
}
|
|
|
|
|
|
2024-09-20 02:36:07 +03:00
|
|
|
if (!modelRef.current) {
|
2025-05-24 19:47:15 +03:00
|
|
|
modelRef.current = monaco.editor.createModel(rawConfig, "yaml", modelUri);
|
2024-09-20 02:36:07 +03:00
|
|
|
} else {
|
2025-05-24 19:47:15 +03:00
|
|
|
modelRef.current.setValue(rawConfig);
|
2023-12-13 02:22:02 +03:00
|
|
|
}
|
|
|
|
|
|
2023-12-20 17:33:57 +03:00
|
|
|
const container = configRef.current;
|
2023-12-13 02:22:02 +03:00
|
|
|
|
2024-09-20 02:36:07 +03:00
|
|
|
if (container && !editorRef.current) {
|
2023-12-13 02:22:02 +03:00
|
|
|
editorRef.current = monaco.editor.create(container, {
|
|
|
|
|
language: "yaml",
|
|
|
|
|
model: modelRef.current,
|
|
|
|
|
scrollBeyondLastLine: false,
|
2024-03-21 04:46:45 +03:00
|
|
|
theme: (systemTheme || theme) == "dark" ? "vs-dark" : "vs-light",
|
2023-12-13 02:22:02 +03:00
|
|
|
});
|
2025-05-09 16:36:44 +03:00
|
|
|
editorRef.current?.addCommand(
|
|
|
|
|
monaco.KeyMod.CtrlCmd | monaco.KeyCode.KeyS,
|
|
|
|
|
() => {
|
|
|
|
|
onHandleSaveConfig("saveonly");
|
|
|
|
|
},
|
|
|
|
|
);
|
2024-09-20 02:36:07 +03:00
|
|
|
} else if (editorRef.current) {
|
|
|
|
|
editorRef.current.setModel(modelRef.current);
|
2023-12-13 02:22:02 +03:00
|
|
|
}
|
2023-12-20 17:33:57 +03:00
|
|
|
|
|
|
|
|
return () => {
|
2024-09-20 02:36:07 +03:00
|
|
|
if (editorRef.current) {
|
|
|
|
|
editorRef.current.dispose();
|
|
|
|
|
editorRef.current = null;
|
|
|
|
|
}
|
|
|
|
|
if (modelRef.current) {
|
|
|
|
|
modelRef.current.dispose();
|
|
|
|
|
modelRef.current = null;
|
|
|
|
|
}
|
|
|
|
|
schemaConfiguredRef.current = false;
|
2023-12-20 17:33:57 +03:00
|
|
|
};
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
}, [rawConfig, apiHost, systemTheme, theme, onHandleSaveConfig, editorMode]);
|
|
|
|
|
|
|
|
|
|
// Initialize GUI config from parsed config
|
|
|
|
|
useEffect(() => {
|
|
|
|
|
if (config && editorMode === "gui") {
|
|
|
|
|
setGuiConfigData(config as unknown as Record<string, unknown>);
|
|
|
|
|
}
|
|
|
|
|
}, [config, editorMode]);
|
2023-12-13 02:22:02 +03:00
|
|
|
|
2024-08-21 17:19:07 +03:00
|
|
|
// monitoring state
|
|
|
|
|
|
|
|
|
|
const [hasChanges, setHasChanges] = useState(false);
|
|
|
|
|
|
|
|
|
|
useEffect(() => {
|
2025-05-24 19:47:15 +03:00
|
|
|
if (!rawConfig || !modelRef.current) {
|
2024-08-21 17:19:07 +03:00
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
modelRef.current.onDidChangeContent(() => {
|
2025-05-24 19:47:15 +03:00
|
|
|
if (modelRef.current?.getValue() != rawConfig) {
|
2024-08-21 17:19:07 +03:00
|
|
|
setHasChanges(true);
|
|
|
|
|
} else {
|
|
|
|
|
setHasChanges(false);
|
|
|
|
|
}
|
|
|
|
|
});
|
2025-05-24 19:47:15 +03:00
|
|
|
}, [rawConfig]);
|
2024-08-21 17:19:07 +03:00
|
|
|
|
2024-05-27 18:31:58 +03:00
|
|
|
useEffect(() => {
|
2025-05-24 19:47:15 +03:00
|
|
|
if (rawConfig && modelRef.current) {
|
|
|
|
|
modelRef.current.setValue(rawConfig);
|
2024-08-21 17:19:07 +03:00
|
|
|
setHasChanges(false);
|
2024-05-27 18:31:58 +03:00
|
|
|
}
|
2025-05-24 19:47:15 +03:00
|
|
|
}, [rawConfig]);
|
2024-05-27 18:31:58 +03:00
|
|
|
|
2024-08-21 17:19:07 +03:00
|
|
|
useEffect(() => {
|
|
|
|
|
let listener: ((e: BeforeUnloadEvent) => void) | undefined;
|
|
|
|
|
if (hasChanges) {
|
|
|
|
|
listener = (e) => {
|
|
|
|
|
e.preventDefault();
|
|
|
|
|
e.returnValue = true;
|
2025-05-20 00:45:02 +03:00
|
|
|
return t("confirm");
|
2024-08-21 17:19:07 +03:00
|
|
|
};
|
|
|
|
|
window.addEventListener("beforeunload", listener);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return () => {
|
|
|
|
|
if (listener) {
|
|
|
|
|
window.removeEventListener("beforeunload", listener);
|
|
|
|
|
}
|
|
|
|
|
};
|
2025-05-20 00:45:02 +03:00
|
|
|
}, [hasChanges, t]);
|
2024-08-21 17:19:07 +03:00
|
|
|
|
2025-07-10 17:28:23 +03:00
|
|
|
// layout change handler
|
|
|
|
|
|
|
|
|
|
const [{ width, height }] = useResizeObserver(configRef);
|
|
|
|
|
|
2025-06-05 04:48:26 +03:00
|
|
|
useEffect(() => {
|
|
|
|
|
if (editorRef.current) {
|
|
|
|
|
// Small delay to ensure DOM has updated
|
|
|
|
|
const timeoutId = setTimeout(() => {
|
|
|
|
|
editorRef.current?.layout();
|
|
|
|
|
}, 0);
|
|
|
|
|
|
|
|
|
|
return () => clearTimeout(timeoutId);
|
|
|
|
|
}
|
2025-07-10 17:28:23 +03:00
|
|
|
}, [error, width, height]);
|
2025-06-05 04:48:26 +03:00
|
|
|
|
2025-05-24 19:47:15 +03:00
|
|
|
if (!rawConfig) {
|
2023-12-13 02:22:02 +03:00
|
|
|
return <ActivityIndicator />;
|
|
|
|
|
}
|
|
|
|
|
|
2023-12-08 16:33:22 +03:00
|
|
|
return (
|
2024-05-21 21:06:17 +03:00
|
|
|
<div className="absolute bottom-2 left-0 right-0 top-2 md:left-2">
|
2025-06-05 04:48:26 +03:00
|
|
|
<div className="relative flex h-full flex-col overflow-hidden">
|
2024-05-21 21:06:17 +03:00
|
|
|
<div className="mr-1 flex items-center justify-between">
|
2025-05-24 19:47:15 +03:00
|
|
|
<div>
|
|
|
|
|
<Heading as="h2" className="mb-0 ml-1 md:ml-0">
|
|
|
|
|
{t(config?.safe_mode ? "safeConfigEditor" : "configEditor")}
|
|
|
|
|
</Heading>
|
|
|
|
|
{config?.safe_mode && (
|
|
|
|
|
<div className="text-sm text-secondary-foreground">
|
|
|
|
|
{t("safeModeDescription")}
|
|
|
|
|
</div>
|
|
|
|
|
)}
|
|
|
|
|
</div>
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
<div className="flex flex-row gap-2">
|
|
|
|
|
<ToggleGroup
|
|
|
|
|
type="single"
|
|
|
|
|
value={editorMode}
|
|
|
|
|
onValueChange={(value) => {
|
|
|
|
|
if (value) setEditorMode(value as EditorMode);
|
|
|
|
|
}}
|
|
|
|
|
>
|
|
|
|
|
<ToggleGroupItem value="yaml" aria-label="YAML mode">
|
|
|
|
|
<Code className="h-4 w-4 mr-2" />
|
|
|
|
|
<span className="hidden md:inline">YAML</span>
|
|
|
|
|
</ToggleGroupItem>
|
|
|
|
|
<ToggleGroupItem value="gui" aria-label="GUI mode">
|
|
|
|
|
<Settings className="h-4 w-4 mr-2" />
|
|
|
|
|
<span className="hidden md:inline">GUI</span>
|
|
|
|
|
</ToggleGroupItem>
|
|
|
|
|
</ToggleGroup>
|
2024-05-21 21:06:17 +03:00
|
|
|
<Button
|
|
|
|
|
size="sm"
|
|
|
|
|
className="flex items-center gap-2"
|
2025-03-16 18:36:20 +03:00
|
|
|
aria-label={t("copyConfig")}
|
2024-05-21 21:06:17 +03:00
|
|
|
onClick={() => handleCopyConfig()}
|
|
|
|
|
>
|
|
|
|
|
<LuCopy className="text-secondary-foreground" />
|
2025-03-16 18:36:20 +03:00
|
|
|
<span className="hidden md:block">{t("copyConfig")}</span>
|
2024-05-21 21:06:17 +03:00
|
|
|
</Button>
|
|
|
|
|
<Button
|
|
|
|
|
size="sm"
|
|
|
|
|
className="flex items-center gap-2"
|
2025-03-16 18:36:20 +03:00
|
|
|
aria-label={t("saveAndRestart")}
|
2025-03-13 17:57:12 +03:00
|
|
|
onClick={handleSaveAndRestart}
|
2024-05-21 21:06:17 +03:00
|
|
|
>
|
|
|
|
|
<div className="relative size-5">
|
|
|
|
|
<LuSave className="absolute left-0 top-0 size-3 text-secondary-foreground" />
|
|
|
|
|
<MdOutlineRestartAlt className="absolute size-4 translate-x-1 translate-y-1/2 text-secondary-foreground" />
|
|
|
|
|
</div>
|
2025-03-16 18:36:20 +03:00
|
|
|
<span className="hidden md:block">{t("saveAndRestart")}</span>
|
2024-05-21 21:06:17 +03:00
|
|
|
</Button>
|
|
|
|
|
<Button
|
|
|
|
|
size="sm"
|
|
|
|
|
className="flex items-center gap-2"
|
2025-03-16 18:36:20 +03:00
|
|
|
aria-label={t("saveOnly")}
|
2024-05-21 21:06:17 +03:00
|
|
|
onClick={() => onHandleSaveConfig("saveonly")}
|
|
|
|
|
>
|
|
|
|
|
<LuSave className="text-secondary-foreground" />
|
2025-03-16 18:36:20 +03:00
|
|
|
<span className="hidden md:block">{t("saveOnly")}</span>
|
2024-05-21 21:06:17 +03:00
|
|
|
</Button>
|
|
|
|
|
</div>
|
2023-12-13 02:22:02 +03:00
|
|
|
</div>
|
|
|
|
|
|
2025-06-19 18:20:33 +03:00
|
|
|
<div className="mt-2 flex flex-1 flex-col overflow-hidden">
|
2025-06-05 04:48:26 +03:00
|
|
|
{error && (
|
|
|
|
|
<div className="mt-2 max-h-[30%] min-h-[2.5rem] overflow-auto whitespace-pre-wrap border-2 border-muted bg-background_alt p-4 text-sm text-danger md:max-h-[40%]">
|
|
|
|
|
{error}
|
|
|
|
|
</div>
|
|
|
|
|
)}
|
Add comprehensive GUI configuration editor
Implements a complete GUI-based configuration editor that provides a
user-friendly alternative to editing YAML files. No more YAML nightmares!
## Features
### Complete Coverage
- ALL 500+ configuration fields across 70+ nested objects accessible
- 35 top-level sections with 100% schema coverage
- 27 camera fields with 20 nested sub-configurations
- Every detector type, every option, every setting
### User-Friendly Interface
- 17+ tabbed sections for logical organization
- Schema-driven form generation (auto-adapts to new fields)
- Tooltips on every field with descriptions
- Real-time validation with helpful error messages
- Smart defaults pre-filled
- Example values in placeholders
### Sections Include
- Cameras (streams, detection, zones, recording, motion, PTZ)
- Detectors (Coral, OpenVINO, TensorRT, CPU, etc.)
- Objects (tracking, filters, masks)
- Recording (retention, storage, events)
- Snapshots (capture, retention)
- Motion Detection
- MQTT (broker, topics)
- Audio Detection & Transcription
- Face Recognition
- License Plate Recognition (LPR)
- Semantic Search
- Birdseye View
- Review System
- GenAI Integration
- Authentication & Roles
- UI Preferences
- Advanced (database, logging, telemetry, networking, proxy, TLS)
### Technical Implementation
- React Hook Form for performant form state
- Schema-driven architecture (single source of truth)
- TypeScript for type safety
- Radix UI components for accessibility
- Comprehensive validation
- YAML ↔ GUI mode toggle
### Files Added
- web/src/components/config/GuiConfigEditor.tsx - Main editor
- web/src/components/config/SchemaFormRenderer.tsx - Schema-to-UI engine
- web/src/components/config/fields/* - Field components (7 types)
- web/src/components/config/sections/* - Section components
- web/src/lib/configUtils.ts - YAML conversion & validation
- web/src/types/configSchema.ts - TypeScript types
- docs/docs/guides/config_gui.md - User documentation
- COMPLETE_CONFIG_SCHEMA.json - Full schema reference
- CONFIG_SCHEMA_SUMMARY.md - Schema documentation
- verify_gui_completeness.py - Coverage verification script
### Verification
Smoke test confirms 100% coverage:
- ✅ 35 top-level sections (ALL in schema)
- ✅ 26 explicit GUI tabs
- ✅ 27 camera fields with 20 sub-configs
- ✅ All JSON Schema types supported
- ✅ Every field accessible
2025-09-30 08:09:38 +03:00
|
|
|
{editorMode === "yaml" ? (
|
|
|
|
|
<div ref={configRef} className="flex-1 overflow-hidden" />
|
|
|
|
|
) : (
|
|
|
|
|
<div className="flex-1 overflow-auto">
|
|
|
|
|
{config && (
|
|
|
|
|
<GuiConfigEditor
|
|
|
|
|
config={guiConfigData}
|
|
|
|
|
onSave={async (newConfig) => {
|
|
|
|
|
setGuiConfigData(newConfig);
|
|
|
|
|
setHasChanges(true);
|
|
|
|
|
}}
|
|
|
|
|
/>
|
|
|
|
|
)}
|
|
|
|
|
</div>
|
|
|
|
|
)}
|
2025-06-05 04:48:26 +03:00
|
|
|
</div>
|
2024-05-21 21:06:17 +03:00
|
|
|
</div>
|
2024-05-04 22:54:50 +03:00
|
|
|
<Toaster closeButton={true} />
|
2024-11-05 18:33:41 +03:00
|
|
|
<RestartDialog
|
|
|
|
|
isOpen={restartDialogOpen}
|
|
|
|
|
onClose={() => setRestartDialogOpen(false)}
|
2025-03-13 17:57:12 +03:00
|
|
|
onRestart={() => sendRestart("restart")}
|
2024-11-05 18:33:41 +03:00
|
|
|
/>
|
2023-12-13 02:22:02 +03:00
|
|
|
</div>
|
2023-12-08 16:33:22 +03:00
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export default ConfigEditor;
|