init

docs/ai/Common/DTS.Common/Validators.md

@@ -0,0 +1,45 @@
+---
+source_files:
+  - Common/DTS.Common/Validators/SensitivityValidator.cs
+  - Common/DTS.Common/Validators/UARTBAUDRateValidator.cs
+  - Common/DTS.Common/Validators/CANArbBaseBitrateValidator.cs
+generated_at: "2026-04-17T16:35:32.963513+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "26f2d335021e8611"
+---
+
+# Documentation: DTS.Common.Validators
+
+## 1. Purpose
+
+This module provides WPF `ValidationRule` implementations for validating user input in the DTS application's UI layer. It contains three specialized validators: `SensitivityValidator` for ensuring numeric sensitivity values are non-zero, `UARTBAUDRateValidator` for validating UART baud rate configuration values against defined min/max bounds, and `CANArbBaseBitrateValidator` for validating CAN arbitration/base bitrate values. These validators are designed for use in WPF data binding scenarios where input validation is required before accepting user-provided string values.
+
+---
+
+## 2. Public Interface
+
+### `SensitivityValidator`
+**Inherits from:** `ValidationRule`
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `Validate` | `public override ValidationResult Validate(object value, CultureInfo cultureInfo)` | Validates that the input is a parseable `double` and is not equal to zero. Returns `ValidationResult(false, StringResources.InvalidFormat)` if the value cannot be parsed as a double or is not a string. Returns `ValidationResult(false, StringResources.SensitivityCanNotBeZero)` if the parsed value equals `0D`. Returns `ValidationResult(true, null)` for valid non-zero numeric input. |
+
+---
+
+### `UARTBAUDRateValidator`
+**Inherits from:** `ValidationRule`
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `Validate` | `public override ValidationResult Validate(object value, CultureInfo cultureInfo)` | Validates that the input is a parseable `long` within the UART baud rate range. Returns `ValidationResult(false, StringResources.InvalidFormat)` if the value cannot be parsed as a long or is not a string. Returns `ValidationResult(false, ...)` with min/max error messages if the value falls outside `Constant.EmbeddedSensors.BAUD_RATE_MIN` or `Constant.EmbeddedSensors.BAUD_RATE_MAX`. Returns `ValidationResult(true, null)` for valid input within bounds. |
+
+---
+
+### `CANArbBaseBitrateValidator`
+**Inherits from:** `ValidationRule`
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `Validate` | `public override