init

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

@@ -0,0 +1,94 @@
+---
+source_files:
+  - Common/DTS.CommonCore/Enums/TTS/TTSEnums.cs
+generated_at: "2026-04-16T02:43:11.533810+00:00"
+model: "Qwen/Qwen3-Coder-Next-FP8"
+schema_version: 1
+sha256: "f097505e03f0c09d"
+---
+
+# TTS
+
+## Documentation: `DTS.Common.Enums.TTS.TTSEnums`
+
+### 1. Purpose  
+This module defines enumerations and supporting attributes used to manage field-level metadata for TTS (likely *Test & Test System* or *Transducer Test System*) import configurations, specifically addressing legacy column mapping issues (e.g., issue #18396). It provides a structured way to classify fields by their current relevance (`RequiredParameter`, `RemainedButNotUsed`, `RemovedParameter`) and supports parsing and validation of TTS import data through the `FieldSupportAttribute`. The enums `ToyotaFieldOrder`, `ToyotaBridgeType`, and `ToyotaZeroMethods` model domain-specific configuration options for sensor/channel setup.
+
+---
+
+### 2. Public Interface  
+
+#### `FieldSupportLevel` enum  
+- **Values**:  
+  - `RequiredParameter`: Field is actively used and required.  
+  - `RemainedButNotUsed`: Field exists in legacy data but is ignored in processing.  
+  - `RemovedParameter`: Field is obsolete and no longer present in current data formats.  
+
+#### `FieldSupportAttribute` class  
+- **Inherits**: `Attribute`  
+- **Usage**: Applied to enum fields to declare their support status.  
+- **Properties**:  
+  - `SupportLevel`: Gets or sets the `FieldSupportLevel` value assigned to the attributed enum member.  
+- **Methods**:  
+  - `FieldSupportAttribute(FieldSupportLevel value)`: Constructor setting `SupportLevel`.  
+  - `static FieldSupportLevel GetSupportLevel(Enum genericEnum)`:  
+    - Returns the `FieldSupportLevel` associated with the given enum value via its `FieldSupportAttribute`.  
+    - If no attribute is present, returns `FieldSupportLevel.RemovedParameter` as default.  
+
+#### `ToyotaFieldOrder` enum  
+- **Purpose**: Represents ordered column indices for TTS import (e.g., CSV/Excel), with each member annotated with `FieldSupportAttribute`.  
+- **Key Members**:  
+  - `ChannelNumber`, `ChannelCode`, `JCodeOrDescription`, `ChannelRange`, `ChannelFilterHz`, `SensorSerialNumber`, `SensorExcitationVolts`, `SensorPolarity`: Marked `RequiredParameter`.  
+  - `SensorID`, `SensorSensitivity`, `SensorCapacity`, `SensorEU`, `ChannelType`, `Description`, `ProportionalToExcitation`, `BridgeResistance`, `InitialOffsetVoltage`, `RemoveOffset`, `ZeroMethod`: Marked `RemainedButNotUsed`.  
+  - `InitialOffsetVoltageTolerance`, `CableCompensationMultiplier`, `InitialEUInMV`, `InitialEUInEU`, `IRTRACCExponent`, `PolynomialConstant`, `PolynomialCoefficentC/B/A/Alpha`, `ISOCode`, `ISODescription`, `ISOPolarity`, `KyowaSpecificField_1`: Marked `RemovedParameter`.  
+
+#### `ToyotaBridgeType` enum  
+- **Purpose**: Defines supported bridge configurations for sensors.  
+- **Values**:  
+  - `FullBridge`, `HalfBridge`, `Voltage`, `PotentionmeterFullBridge`, `PotentionmeterHalfBridge`, `IRTRACC`, `LinearChestPot`.  
+- **Notes**: Each value has a `[Description]` attribute (from `System.ComponentModel`), but no custom attribute or behavior is defined for it in this file.  
+
+#### `ToyotaZeroMethods` enum  
+- **Purpose**: Specifies zeroing methods for sensor calibration.  
+- **Values**:  
+  - `None = 0` (Description: `"0"`),  
+  - `AverageOverTime = 1` (Description: `"1"`),  
+  - `UsePreEventDiagnosticsZero = 2` (Description: `"2"`).  
+- **Notes**: Only `[Description]` attributes are present; no custom support-level metadata.
+
+---
+
+### 3. Invariants  
+- **`FieldSupportAttribute.GetSupportLevel` behavior**:  
+  - For any `Enum` value, if the field lacks a `FieldSupportAttribute`, the method **always returns `FieldSupportLevel.RemovedParameter`**.  
+  - The method relies on reflection (`GetMember`, `GetCustomAttributes`) and is not optimized; performance may degrade with frequent use.  
+- **`ToyotaFieldOrder` ordering**:  
+  - Values are explicitly assigned sequential integer indices starting at `0`, implying strict positional semantics (e.g., column order in an import file).  
+  - The `FieldSupportLevel` annotations are *static metadata* and do not affect runtime behavior unless explicitly consumed elsewhere.  
+- **No validation logic is defined in this module**: The enums and attribute serve as *declarative metadata*; enforcement of support levels occurs in dependent code.
+
+---
+
+### 4. Dependencies  
+- **Dependencies on other modules**:  
+  - `System` (core runtime types), `System.ComponentModel` (for `DescriptionAttribute`), `System.Linq` (for `Any()`, `ElementAt()` in `GetSupportLevel`).  
+- **Used by**:  
+  - *Not specified in this file*, but `FieldSupportAttribute.GetSupportLevel` is clearly designed for use in TTS import/parsing logic (e.g., to filter columns during data loading).  
+  - `ToyotaFieldOrder` is likely referenced by import handlers to map columns to properties.  
+  - `ToyotaBridgeType` and `ToyotaZeroMethods` are likely used in sensor configuration classes or UI components.  
+
+---
+
+### 5. Gotchas  
+- **`GetSupportLevel` default behavior**:  
+  - Missing `FieldSupportAttribute` on an enum field silently defaults to `RemovedParameter`, which may mask omissions during refactoring.  
+- **Typos in `ToyotaBridgeType`**:  
+  - `PotentionmeterFullBridge` and `PotentionmeterHalfBridge` are misspelled (should be *Potentiometer*). This is preserved in the source.  
+- **`ToyotaZeroMethods` descriptions are numeric strings**:  
+  - Descriptions (`"0"`, `"1"`, `"2"`) match the underlying values but provide no semantic clarity. This may cause confusion if used in UI or logs.  
+- **No runtime enforcement of `FieldSupportLevel`**:  
+  - The enum and attribute are *metadata-only*; consumers must explicitly check `GetSupportLevel` to act on support status.  
+- **Historical context**:  
+  - The `KyowaSpecificField_1` comment references an internal Fogbugz link (`http://fogbugz/fogbugz/default.asp?5433`), suggesting legacy vendor-specific handling that may be obsolete or poorly documented.  
+- **Reflection overhead**:  
+  - `GetSupportLevel` uses reflection on every call; caching is not implemented. Repeated use in hot paths may impact performance.