init

enriched-qwen3-coder-next/Common/DTS.CommonCore/Enums/GroupTemplates.md

@@ -0,0 +1,68 @@
+---
+source_files:
+  - Common/DTS.CommonCore/Enums/GroupTemplates/GroupTemplateChannelFields.cs
+  - Common/DTS.CommonCore/Enums/GroupTemplates/GroupTemplateFields.cs
+generated_at: "2026-04-16T02:44:06.705516+00:00"
+model: "Qwen/Qwen3-Coder-Next-FP8"
+schema_version: 1
+sha256: "e8a5b65535302547"
+---
+
+# GroupTemplates
+
+## Documentation: Group Template Field Enumerations
+
+### 1. Purpose  
+This module defines two strongly-typed enumerations—`GroupTemplateFields` and `GroupTemplateChannelFields`—that represent the set of valid field names used when referencing or manipulating group template data structures within the system. These enums serve as standardized identifiers for field-level operations (e.g., filtering, sorting, mapping, or validation) related to group templates and their associated channels, ensuring consistency across layers that consume or produce group template metadata.
+
+### 2. Public Interface  
+No classes, methods, or properties are exposed. Only two `public enum` types are defined:
+
+- **`GroupTemplateFields`**  
+  ```csharp
+  public enum GroupTemplateFields
+  {
+      Name,
+      Description,
+      Channels,
+      LastModifiedBy,
+      LastModified,
+      AssociatedGroups
+  }
+  ```
+  Represents top-level fields of a group template entity. Values correspond to core properties of a group template (e.g., `Name`, `Description`) or nested collections (`Channels`, `AssociatedGroups`), as well as audit metadata (`LastModifiedBy`, `LastModified`).
+
+- **`GroupTemplateChannelFields`**  
+  ```csharp
+  public enum GroupTemplateChannelFields
+  {
+      Required,
+      Name,
+      ISOCode,
+      Custom,
+      DisplayOrder
+  }
+  ```
+  Represents fields of individual channel objects *within* a group template’s `Channels` collection. Includes both required metadata (`Name`, `ISOCode`), configuration flags (`Required`, `Custom`), and ordering (`DisplayOrder`).
+
+### 3. Invariants  
+- All enum values are *exhaustive* for their respective domains (i.e., no additional fields are defined beyond those listed).
+- `GroupTemplateFields.Channels` is the only field in `GroupTemplateFields` that contains *nested* data; its value is expected to be a collection of objects, each describable via `GroupTemplateChannelFields`.
+- `GroupTemplateChannelFields.Required` and `GroupTemplateChannelFields.Custom` are boolean-like flags (though represented as enum values, not booleans), implying they are used as discrete states rather than numeric values.
+- No ordering guarantees are implied by the enum definitions themselves (i.e., `DisplayOrder` is a *field name*, not an ordering of the enum values).
+
+### 4. Dependencies  
+- **Internal dependencies**:  
+  - `DTS.Common.Enums.GroupTemplates` namespace (inferred from `namespace` declaration).  
+  - Likely consumed by modules handling group template serialization/deserialization, UI form generation, or data mapping (e.g., ORM or DTO layers), though no direct imports are visible in the provided source.  
+- **External dependencies**: None (no `using` statements present in the source).  
+- **Depended upon**: Other modules in the `DTS.CommonCore` assembly (or downstream projects) that require field-level metadata for group templates or channels.
+
+### 5. Gotchas  
+- **No semantic validation**: The enums themselves do not enforce constraints (e.g., `Required` is not validated against `Custom` or `ISOCode` behavior). Consumers must implement business logic around field relationships.  
+- **Ambiguity in `Custom`**: The meaning of `GroupTemplateChannelFields.Custom` is unclear without additional context—it may indicate user-defined fields, non-standard channel types, or a flag for dynamic extensibility.  
+- **No versioning**: The enums are static; adding new fields requires a breaking change.  
+- **Case sensitivity**: As with all C# enums, string comparisons (e.g., in JSON or database mappings) must preserve exact casing (`"Name"` ≠ `"name"`).  
+- **`LastModified` type ambiguity**: While `GroupTemplateFields.LastModified` is listed, the underlying type (e.g., `DateTime`, `string`, `long`) is not defined here and must be inferred from consuming code.  
+
+None identified beyond the above.