init

docs/ai/Common/DTS.CommonCore/Interface/Hardware/AddEditHardware.md

@@ -0,0 +1,34 @@
+---
+source_files:
+  - Common/DTS.CommonCore/Interface/Hardware/AddEditHardware/IAddEditHardwareView.cs
+  - Common/DTS.CommonCore/Interface/Hardware/AddEditHardware/IAddEditHardwareDASModule.cs
+  - Common/DTS.CommonCore/Interface/Hardware/AddEditHardware/IAddEditHardwareViewModel.cs
+  - Common/DTS.CommonCore/Interface/Hardware/AddEditHardware/IAddEditHardwareHardware.cs
+generated_at: "2026-04-17T16:34:44.412956+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "907536c511d406d2"
+---
+
+# Documentation: DTS.Common.Interface.Hardware.AddEditHardware
+
+## 1. Purpose
+
+This module defines the contract for the "Add/Edit Hardware" feature within the DTS system. It provides interfaces for a Model-View-ViewModel (MVVM) architecture that manages Data Acquisition System (DAS) hardware configuration, including modules, serial numbers, firmware versions, IP addresses, rack configurations, and SLICE hardware integration. The module supports both physical hardware and "stand-in" (virtual/placeholder) hardware representations, enabling users to create, edit, and validate hardware records before persisting them to the database.
+
+---
+
+## 2. Public Interface
+
+### IAddEditHardwareView
+**Inherits from:** `IBaseView`
+
+| Member | Signature | Description |
+|--------|-----------|-------------|
+| `Activated` | `void Activated()` | Notifies the view that it has been activated and should handle any post-activation work. |
+| `ViewDbVersion` | `int ViewDbVersion { get; set; }` | Gets or sets the database version associated with the view. |
+
+---
+
+### IAddEditHardwareViewModel
+**Inherits from:**

docs/ai/Common/DTS.CommonCore/Interface/Hardware/HardwareList.md

@@ -0,0 +1,55 @@
+---
+source_files:
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/ISLICE6TreeView.cs
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/IHardwareListView.cs
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/IHardwareListSelectView.cs
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/IHardwareListOverdueView.cs
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/IHardwareListReplaceView.cs
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/ISLICE6TreeNode.cs
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/IHardware.cs
+  - Common/DTS.CommonCore/Interface/Hardware/HardwareList/IHardwareListViewModel.cs
+generated_at: "2026-04-17T15:32:47.168530+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "af82a8a0bf11db3d"
+---
+
+# Hardware List Interfaces Documentation
+
+## 1. Purpose
+
+This module defines the interfaces for managing hardware inventory within the DTS diagnostics system. It provides abstractions for viewing, selecting, replacing, and tracking calibration status of various hardware types (SLICE6, SLICE6DB, TDAS, G5, POWERPRO, TSR Air, etc.). The module supports hardware association workflows (linking SLICE6 units to SLICE6DB units), calibration overdue tracking, hardware replacement during tests, and sample rate/clock synchronization configuration. It follows a Model-View-ViewModel (MVVM) pattern with view interfaces and a main `IHardwareListViewModel` orchestrating operations.
+
+---
+
+## 2. Public Interface
+
+### View Interfaces
+
+All view interfaces are marker interfaces extending `IBaseView` with no additional members:
+
+| Interface | Purpose (inferred from name) |
+|-----------|------------------------------|
+| `IHardwareListView` | Main hardware list display |
+| `IHardwareListSelectView` | Hardware selection UI |
+| `IHardwareListOverdueView` | Displays overdue calibration hardware |
+| `IHardwareListReplaceView` | Hardware replacement workflow UI |
+| `ISLICE6TreeView` | Tree view for SLICE6 hardware associations |
+
+### ISLICE6TreeNode
+
+Represents a node in the SLICE6 tree hierarchy.
+
+```csharp
+public interface ISLICE6TreeNode
+{
+    int DASId { get; set; }
+    string SerialNumber { get; set; }
+    int Port { get; set; }
+    string PortString { get; }        // Read-only
+    int Number { get; set; }
+    int PositionOnChain { get; set; }
+    string PositionOnChainString { get; }  // Read-only
+}
+```
+