DP44/enriched-qwen3-coder-next/Common/DTS.Common.Serialization/Properties.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common.Serialization/Properties/AssemblyInfo.cs Common/DTS.Common.Serialization/Properties/Settings1.Designer.cs	2026-04-16T03:37:53.704211+00:00	Qwen/Qwen3-Coder-Next-FP8	1	56e1c9c1d32b363c

Properties

Documentation: DTS.Common.Serialization Assembly

---

1. Purpose

This module provides shared serialization-related infrastructure for the DTS system, primarily encapsulating application settings and metadata for the serialization assembly. Based on the source files, it does not contain any serialization logic (e.g., JSON/XML converters, serializers, or deserializers) itself. Instead, it defines a strongly-typed settings class (Settings1) for user- and application-scoped configuration values—particularly those related to TDM (Test Data Manager) file paths, default time ranges, and last-used values for TSV export/import UI state—and exposes assembly-level metadata (title, version, COM visibility). Its role is to centralize configuration state and assembly identity, likely consumed by other modules that perform actual data serialization/deserialization.

---

2. Public Interface

DTS.Serialization.Properties.Settings1

A strongly-typed settings class derived from System.Configuration.ApplicationSettingsBase. It exposes the following properties:

Property	Type	Scope	Default Value	Description
TDMFolder	string	User-scoped	".\\Data\\TDM CFC1000"	Path to the TDM data folder.
DefaultStart	double	User-scoped	-500	Default start time (likely in milliseconds or seconds) for time-range operations.
DefaultStop	double	User-scoped	500	Default stop time (aligned with DefaultStart).
TSVPOCNameLastUsed	string	User-scoped	"#NOVALUE"	Last-used point-of-contact name in TSV export/import workflows.
TSVPOCPhoneAndEmailLastUsed	string	User-scoped	"#NOVALUE"	Last-used POC contact info in TSV workflows.
TSVDataTypeLastUsed	string	User-scoped	"Converted"	Last-used data type selection (e.g., raw, converted) in TSV workflows.
TSVLabNameLastUsed	string	User-scoped	"#NOVALUE"	Last-used lab name in TSV workflows.
TSVTestObjectLastUsed	string	User-scoped	"#NOVALUE"	Last-used test object identifier in TSV workflows.
TSVTestTypeLastUsed	string	User-scoped	"#NOVALUE"	Last-used test type in TSV workflows.
TableHeader	System.Drawing.Color	Application-scoped	RGB(215, 225, 255)	Background color for table headers (read-only).
AlternatingRow	System.Drawing.Color	User-scoped	RGB(238, 242, 255)	Background color for alternating table rows.

• Static Property:
  public static Settings1 Default { get; }
  Returns the singleton instance of Settings1, thread-safe via ApplicationSettingsBase.Synchronized.

Note

: No public methods beyond property getters/setters are defined in this assembly. No serialization/deserialization functions are present.

---

3. Invariants

• Settings1.Default is a singleton: always returns the same instance (synchronized for thread safety).
• TableHeader is read-only (application-scoped); attempts to set it via set will fail at runtime (no setter defined).
• All string settings use "#NOVALUE" as a sentinel for "unset" or "no previous value".
• TDMFolder defaults to a relative path (".\\Data\\TDM CFC1000"), implying the application expects a specific directory structure.
• Time range defaults (DefaultStart, DefaultStop) are symmetric around zero (-500 to 500), suggesting a centered time window (e.g., ±500 ms).
• Settings are persisted per-user (user-scoped) except TableHeader, which is per-application.

---

4. Dependencies

Dependencies of this module:

• System.Configuration (for ApplicationSettingsBase, UserScopedSettingAttribute, etc.)
• System.Drawing (for System.Drawing.Color)
• System.Runtime.CompilerServices and System.CodeDom.Compiler (for generated-code attributes)

Dependencies on this module:

• Other modules in the DTS system likely reference this assembly to access Settings1.Default for configuration persistence (e.g., UI forms that save/load TSV export options or TDM paths).
• No direct evidence of this module consuming other serialization logic—its name (DTS.Common.Serialization) may be misleading; it is primarily a settings container.

---

5. Gotchas

• Misleading assembly name: Despite being named DTS.Common.Serialization, this assembly contains no serialization logic (no ISerializer, JsonSerializer, etc.). It is a configuration/settings module.
• Hardcoded paths: TDMFolder uses a Windows-style relative path (".\\Data\\TDM CFC1000"), which may break on non-Windows platforms or if the directory structure changes.
• Sentinel values: "#NOVALUE" is used as a placeholder for unset string settings. Consumers must explicitly check for this value instead of assuming null or string.Empty.
• Color format: Colors are defined as comma-separated RGB strings in attributes (e.g., "215, 225, 255"), but System.Drawing.Color parsing is implicit—no validation is visible in this file.
• Thread safety: While Synchronized() is used, Settings1 is mutable (most properties have setters). Concurrent writes to user-scoped settings may cause race conditions.
• Auto-generated file: Settings1.Designer.cs is auto-generated; manual edits will be overwritten. Changes should be made in the designer or via .settings files.
• Versioning: Assembly version 1.06.0081 suggests a long-lived module; ensure backward compatibility if settings evolve (e.g., new keys added in future versions).

None identified beyond the above.