init

docs/ai/DataPRO/Modules/Hardware/HardwareList/Converters.md

@@ -0,0 +1,45 @@
+---
+source_files:
+  - DataPRO/Modules/Hardware/HardwareList/Converters/FirstUseDateConverter.cs
+  - DataPRO/Modules/Hardware/HardwareList/Converters/StandInFieldConverter.cs
+generated_at: "2026-04-17T16:45:06.957738+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "efc40e7dad9708c9"
+---
+
+# HardwareList.Converters Documentation
+
+## 1. Purpose
+
+This module provides WPF `IValueConverter` implementations for the HardwareList UI layer. These converters transform `HardwareModel` data into display-friendly values for data-bound controls, handling edge cases such as missing data, invalid states, and stand-in hardware representations. The converters ensure consistent display formatting (e.g., returning `"---"` or `"N/A"` placeholders) across the hardware list views.
+
+---
+
+## 2. Public Interface
+
+### `FirstUseDateConverter`
+
+**Implements:** `System.Windows.Data.IValueConverter`
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `Convert` | `(object value, Type targetType, object parameter, CultureInfo culture) → object` | Returns the first use date display value. If `value` is not a `HardwareModel`, returns `Strings.Table_NA`. If `model.IsFirstUseValid` is `false`, returns `Strings.NotApplicable`. If `model.FirstUseDate` is non-null, returns that date. Otherwise returns `Strings.Table_NA`. |
+| `ConvertBack` | `(object value, Type targetType, object parameter, CultureInfo culture) → object` | Returns the input `DateTime` unchanged if `value` is a `DateTime`; otherwise returns `Strings.Table_NA`. |
+
+---
+
+### `StandInFieldConverter`
+
+**Implements:** `System.Windows.Data.IValueConverter`
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `Convert` | `(object value, Type targetType, object parameter, CultureInfo culture) → object` | Returns field values for non-stand-in hardware. If `value` is not a `HardwareModel`, returns `Strings.Table_NA`. If `model.Hardware` is not an `IISOHardware`, returns `string.Empty`. If `isoHW.StandIn` is `true`, returns `Strings.Table_NA`. Otherwise, uses the string `parameter` to select: `"CalDueDate"` → `model.CalDueDate`, `"CalDate"` → `model.CalDate`, `"Firmware"` → `model.Firmware`. Unrecognized parameters return `Strings.Table_NA`. |
+| `ConvertBack` | `(object value, Type targetType, object parameter, CultureInfo culture) → object` | Returns the input `DateTime` unchanged if `value` is a `DateTime`; otherwise returns `Strings.Table_NA`. |
+
+---
+
+## 3. Invariants
+
+-