init

enriched-qwen3-coder-next/DataPRO/IService/SLICE Service.md

@@ -0,0 +1,81 @@
+---
+source_files:
+  - DataPRO/IService/SLICE Service/SystemAttribute.cs
+  - DataPRO/IService/SLICE Service/Attribute.cs
+  - DataPRO/IService/SLICE Service/EventAttribute.cs
+generated_at: "2026-04-16T03:56:30.099134+00:00"
+model: "Qwen/Qwen3-Coder-Next-FP8"
+schema_version: 1
+sha256: "61f87a0978ab0f91"
+---
+
+# SLICE Service
+
+## Documentation: SLICE Service Attribute Infrastructure
+
+### 1. Purpose  
+This module provides foundational infrastructure for handling SLICE device attributes within the `DTS.Slice.Service` namespace. It defines base abstractions (`Attribute`, `SystemAttribute`, `EventAttribute`) intended to encapsulate metadata and configuration data associated with system-level, event-level, and user-level attributes. Although the current source files contain only commented-out implementations (no active code), the structure indicates a planned design for typed attribute classes that map to specific data types (e.g., `UInt16`, `Ascii`, `DoubleDict`) and store categories (e.g., `System`, `Event`). The module supports serialization/deserialization of dictionary-based attributes (`Dictionary<byte, double>`) via helper methods in `Attribute`, and is intended to integrate with the `DTS.DASLib.Command.SLICE` command layer.
+
+---
+
+### 2. Public Interface  
+**No public types or members are currently active.** All classes and methods in the provided files are commented out. The following are *intended* public interfaces based on the commented code:
+
+#### `SystemAttribute` (class)
+- **Inherits from**: `Attribute`
+- **Purpose**: Base class for system-level attributes (e.g., serial number, flash size).
+- **Note**: Contains no active members; only commented-out nested `TypeValues` enum and subclasses (`SerialNumberAttribute`, `TotalEventsStoredAttribute`) are present.
+
+#### `EventAttribute` (class)
+- **Inherits from**: `Attribute`
+- **Purpose**: Base class for event-level attributes (e.g., event number, sample rate, timestamps).
+- **Note**: Contains no active members; only commented-out nested `TypeValues` enum and subclasses (e.g., `EventNumber`, `EventName`, `EventStartTime`, `PreEventScaleFactors`) are present.
+
+#### `Attribute` (class)
+- **Inherits from**: `object`
+- **Protected members**:
+  - `protected enum AttributeInterface { Arm, Event, System, User }`
+  - `protected AttributeInterface Store { get; set; }`
+  - `protected AttributeTypes.AttributeDataTypes datatype;`
+  - `protected ushort key;`
+  - `protected object value;`
+- **Public constants**:
+  - `public const int MaxSingleAttributeSize = 500;`
+  - `public const int BulkAttributeStartNumber = 3000;`
+- **Protected methods**:
+  - `protected Dictionary<byte, double> ByteArrayToDict(byte[] bytes)`  
+    Parses a byte array into a dictionary of `byte → double` pairs. Assumes format: `[byte][double][byte][double]...`, where each `double` is 8 bytes.
+  - `protected byte[] DictToByteArray(Dictionary<byte, double> dict)`  
+    Serializes a `Dictionary<byte, double>` into a byte array in the same format as above.
+
+---
+
+### 3. Invariants  
+- **No runtime invariants can be verified** from the source, as all logic is commented out and no constructors, properties, or methods are active.
+- Based on commented code, the *intended* invariants include:
+  - `MaxSingleAttributeSize = 500` bytes — likely a hard limit on serialized attribute size.
+  - `BulkAttributeStartNumber = 3000` — likely an offset indicating where bulk attributes begin (e.g., IDs ≥ 3000 are bulk).
+  - Dictionary serialization assumes fixed-size pairs: 1 byte key + 8 bytes double = 9 bytes per entry.
+  - `EventStartTime` serialization uses 8 bytes total: 4 bytes for seconds (since Unix epoch) + 4 bytes for milliseconds.
+
+---
+
+### 4. Dependencies  
+- **Internal dependencies**:
+  - `DTS.Common.Utils` — likely contains `ByteConvertor` (used in commented code for type conversion).
+  - `DTS.DASLib.Command.SLICE` — provides `AttributeTypes.AttributeDataTypes` (used in commented subclasses).
+- **No external dependencies beyond these namespaces**.
+- **Depended upon by**: Unknown — no usages are visible in the provided files.
+
+---
+
+### 5. Gotchas  
+- **Critical**: All functionality is commented out. This module is non-functional as-is and likely represents a work-in-progress or legacy design artifact.
+- **Ambiguity in `EventStartTime` implementation**: The setter computes `UInt32 fractions = (UInt32)(leftOver.TotalSeconds - (double)seconds);`, which is incorrect — it should use `leftOver.TotalMilliseconds % 1000` or similar to extract milliseconds. This is a likely bug if uncommented.
+- **Inconsistent enum references**: Subclasses reference `QueryArmAttribute.AttributeDataTypes` (e.g., `QueryArmAttribute.AttributeDataTypes.Ascii`), but the base `Attribute` class uses `AttributeTypes.AttributeDataTypes`. This suggests either:
+  - A naming inconsistency (e.g., `QueryArmAttribute` should be `AttributeTypes`), or
+  - A missing import/namespace alias.
+- **Missing `ByteConvertor` usage context**: The helper methods `ByteArrayToDict`/`DictToByteArray` assume `ByteConvertor` exists and supports `Convert(byte[], int, out T)` and `ToByteArray(T)`, but its implementation is not provided.
+- **No validation on dictionary keys**: `ByteArrayToDict` does not check for duplicate keys — adding an existing key would throw `ArgumentException`.
+
+> **Note**: Since no active code exists, these "gotchas" pertain to the *commented design*, not runtime behavior.