init

docs/ai/Common/DTS.Common/Interface/DownloadEvent.md

@@ -0,0 +1,44 @@
+---
+source_files:
+  - Common/DTS.Common/Interface/DownloadEvent/IDownloadEvent.cs
+generated_at: "2026-04-17T16:10:17.621281+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "54b69dae98e15350"
+---
+
+# DownloadEvent
+
+### Purpose
+This module defines `IDownloadEvent`, an interface representing a download event within the DTS system. It appears to be related to "Multiple download event" functionality (per FB 6399 reference) and provides a data-bound model for event configuration, including event identification, timing/length information, and associated test/DTS file references. The interface inherits from `INotifyPropertyChanged`, indicating it is designed for data binding in UI scenarios.
+
+### Public Interface
+
+**`IDownloadEvent`** (inherits `INotifyPropertyChanged`)
+
+| Member | Type | Description |
+|--------|------|-------------|
+| `EventNumber` | `int` | Gets or sets the numeric identifier for the download event. |
+| `EventNumberDisplay` | `string` | Gets or sets the display string for the event number. |
+| `IsEnabled` | `bool` | Gets or sets whether the event is enabled. |
+| `IsReadonly` | `bool` | Gets or sets whether the event is read-only. |
+| `IsDefault` | `bool` | Gets whether this event is the default. (Read-only property) |
+| `EventLength` | `TimeSpan` | Gets or sets the total length available for the download event. |
+| `ShouldDisplayLength` | `bool` | Gets or sets whether the event length should be displayed in the UI. |
+| `TestItem` | `string` | Gets or sets the test item identifier. |
+| `DTSFile` | `string` | Gets or sets the associated DTS file reference. |
+
+### Invariants
+- `IsDefault` is a read-only property; implementers must provide logic to determine default status.
+- All properties except `IsDefault` are read/write.
+- Implementers must implement `INotifyPropertyChanged` to support UI data binding.
+
+### Dependencies
+- **Depends on**: `System`, `System.ComponentModel` (for `INotifyPropertyChanged`).
+- **Depended on by**: Cannot be determined from source alone.
+
+### Gotchas
+- The comment references "FB 6399" which appears to be a feature/bug tracking identifier; the context of this reference is not available in source.
+- The distinction between `EventNumber` (int) and `EventNumberDisplay` (string) suggests formatting or localization requirements that are not specified in the interface.
+
+---