DP44/enriched-qwen3-coder-next/Common/DTS.Common/Interface/SystemSettings/ISOSettings.md

---
source_files:
  - Common/DTS.Common/Interface/SystemSettings/ISOSettings/IisoSettingsView.cs
  - Common/DTS.Common/Interface/SystemSettings/ISOSettings/IISOSettingsModel.cs
  - Common/DTS.Common/Interface/SystemSettings/ISOSettings/IISOSettingsViewModel.cs
  - Common/DTS.Common/Interface/SystemSettings/ISOSettings/IISOSettingsData.cs
generated_at: "2026-04-16T03:06:41.114570+00:00"
model: "Qwen/Qwen3-Coder-Next-FP8"
schema_version: 1
sha256: "e046fb22f092ebcb"
---

# ISOSettings

## Documentation: ISO Settings Module

### 1. Purpose  
This module defines the core interfaces for managing ISO (International Organization for Standardization) code settings within the system’s settings framework. It implements a standard Model-View-ViewModel (MVVM) pattern to decouple data, presentation, and business logic for ISO-related configuration. The module enables runtime configuration of UI behavior and data validation rules related to ISO codes—such as uniqueness enforcement, view modes, and helper tool visibility—while abstracting persistence and state management through well-defined contracts.

---

### 2. Public Interface  

- **`IISOSettingsView`**  
  *Signature:* `public interface IISOSettingsView : IBaseView { }`  
  *Behavior:* A marker interface for the view layer in the MVVM pattern. It inherits from `IBaseView`, implying it represents a UI component (e.g., a settings dialog or page) responsible for rendering ISO settings and capturing user input. No behavior is defined here—consumers must implement concrete view types.

- **`IISOSettingsModel`**  
  *Signature:*  
  ```csharp
  public interface IISOSettingsModel : IBaseModel
  {
      void SaveData(IISOSettingsData data);
      IISOSettingsData LoadData();
  }
  ```  
  *Behavior:* Defines persistence operations for ISO settings. `SaveData` writes the current state (via `IISOSettingsData`) to storage (e.g., config file, database). `LoadData` retrieves and returns the persisted settings. Inherits from `IBaseModel`, implying lifecycle or state management responsibilities.

- **`IISOSettingsViewModel`**  
  *Signature:*  
  ```csharp
  public interface IISOSettingsViewModel : IBaseViewModel
  {
      IISOSettingsView View { get; set; }
      IISOSettingsData ISOData { get; set; }
      IISOSettingsModel Model { get; set; }
  }
  ```  
  *Behavior:* Coordinates the interaction between `IISOSettingsView`, `IISOSettingsData`, and `IISOSettingsModel`. It holds references to all three layers, enabling data binding, command routing, and state synchronization. Inherits from `IBaseViewModel`, implying integration with the application’s MVVM infrastructure.

- **`IISOSettingsData`**  
  *Signature:*  
  ```csharp
  public interface IISOSettingsData : IBaseClass
  {
      bool UniqueISOCodesRequired { get; set; }
      IsoViewMode ISOViewMode { get; set; }
      bool ShowISOStringBuilder { get; set; }
      bool ShowChannelCodeLookupHelper { get; set; }
      bool UseISOCodeFilterMapping { get; set; }
      bool ShowISOCodes { get; }
      bool ShowUserCodes { get; }
      bool ChannelNamesOnly { get; }
  }
  ```  
  *Behavior:* Encapsulates runtime and persisted configuration for ISO code display and validation. Includes:
  - **Writable properties** (`get; set;`):  
    - `UniqueISOCodesRequired`: Enforces uniqueness of ISO codes during entry.  
    - `ISOViewMode`: Controls how ISO codes are presented (e.g., list vs. tree view), via the `IsoViewMode` enum (defined elsewhere).  
    - `ShowISOStringBuilder`: Toggles visibility of the ISO code generation helper.  
    - `ShowChannelCodeLookupHelper`: Toggles visibility of the channel code lookup tool.  
    - `UseISOCodeFilterMapping`: Enables/disables filtering logic based on ISO code mappings.  
  - **Read-only properties** (`get;` only):  
    - `ShowISOCodes`: Indicates whether ISO codes should be displayed in the UI.  
    - `ShowUserCodes`: Indicates whether user-defined codes (non-ISO) should be displayed.  
    - `ChannelNamesOnly`: If `true`, suppresses code display and shows channel names exclusively.  
  Inherits from `IBaseClass`, implying base functionality (e.g., change notification, cloning).

---

### 3. Invariants  

- **Data Consistency**: `IISOSettingsData` must be fully initialized before `SaveData` is called; partial or null data may lead to undefined persistence behavior.  
- **View-ViewModel Coupling**: `IISOSettingsViewModel.View` must be assigned before the view is shown; otherwise, UI rendering may fail or throw exceptions.  
- **Read-Only Constraints**: Properties `ShowISOCodes`, `ShowUserCodes`, and `ChannelNamesOnly` are *derived* or *computed* (no setter). Their values must be consistent with writable settings (e.g., `ChannelNamesOnly = true` likely implies `ShowISOCodes = false` and `ShowUserCodes = false`), though enforcement is not explicit in this interface.  
- **Enum Dependency**: `IsoViewMode` (used in `ISOViewMode`) must be defined in `DTS.Common.Enums`; its valid values and semantics are not specified here and must be inferred from that enum’s definition.

---

### 4. Dependencies  

- **Depends on**:  
  - `DTS.Common.Base` (via `IBaseView`, `IBaseModel`, `IBaseViewModel`, `IBaseClass`).  
  - `DTS.Common.Enums` (via `IsoViewMode` in `IISOSettingsData`).  
- **Depended upon by**:  
  - Concrete implementations of `IISOSettingsView` (e.g., WPF/WinForms UI controls).  
  - Concrete implementations of `IISOSettingsModel` (e.g., file-based or database persistence layers).  
  - Concrete implementations of `IISOSettingsViewModel` (e.g., settings controller logic).  
  - Other modules that consume ISO settings (e.g., code validation services, UI rendering engines).  

---

### 5. Gotchas  

- **Read-Only Properties Ambiguity**: The read-only properties (`ShowISOCodes`, `ShowUserCodes`, `ChannelNamesOnly`) lack setters, but their values are not derived from writable properties in the interface. Implementation details (e.g., logic in a concrete class) must define how these are computed—this is not specified here.  
- **Missing Validation Rules**: While `UniqueISOCodesRequired` exists, there is no interface-level guarantee that validation occurs when ISO codes are added/modified. Consumers must implement validation logic themselves.  
- **Enum Reference Uncertainty**: `IsoViewMode` is referenced but not defined in this module. Its possible values and semantics (e.g., `List`, `Tree`, `Compact`) must be verified in `DTS.Common.Enums`.  
- **No Error Handling Contract**: `SaveData` and `LoadData` do not specify exceptions or return codes for failure cases (e.g., I/O errors, serialization issues). Error handling is implementation-dependent.  
- **No Versioning/Compatibility**: No mechanism for schema versioning or migration is evident. Changes to `IISOSettingsData` may break backward compatibility with persisted data.  

*None of the above are explicitly documented in the source; they are inferred from interface design gaps.*