Module pipeline_id

adaptive_pipeline_domain::value_objects

Module pipeline_id 

Source
Expand description

§Pipeline Identifier Value Object - Core Infrastructure

This module provides a comprehensive pipeline identifier value object that implements type-safe pipeline identification, temporal ordering, and pipeline lifecycle management for the adaptive pipeline system’s core infrastructure.

§Overview

The pipeline identifier system provides:

  • Type-Safe Identification: Strongly-typed pipeline identifiers with compile-time validation
  • Temporal Ordering: ULID-based time-ordered creation sequence for pipeline management
  • Pipeline Lifecycle: Natural ordering for pipeline processing and audit trails
  • Cross-Platform Compatibility: Consistent representation across languages and systems
  • Serialization: Comprehensive serialization across storage backends and APIs
  • Validation: Pipeline-specific validation and business rules

§Key Features

§1. Type-Safe Pipeline Management

Strongly-typed pipeline identifiers with comprehensive validation:

  • Compile-Time Safety: Cannot be confused with other entity IDs
  • Domain Semantics: Clear intent in function signatures and APIs
  • Runtime Validation: Pipeline-specific validation rules
  • Future Evolution: Extensible for pipeline-specific methods

§2. Temporal Ordering and Lifecycle

ULID-based temporal ordering for pipeline management:

  • Time-Ordered Creation: Natural chronological ordering of pipelines
  • Audit Trails: Complete chronological history of pipeline creation
  • Range Queries: Efficient time-based pipeline queries
  • Processing Order: Deterministic pipeline processing sequences

§3. Cross-Platform Compatibility

Consistent pipeline identification across platforms:

  • JSON Serialization: Standard JSON representation
  • Database Storage: Optimized database storage patterns
  • API Integration: RESTful API compatibility
  • Multi-Language: Consistent interface across languages

§Usage Examples

§Basic Pipeline ID Creation

§Time-Based Queries and Range Operations

§Serialization and Cross-Platform Usage

§Performance Characteristics

  • Creation Time: ~2μs for new pipeline ID generation
  • Validation Time: ~1μs for pipeline ID validation
  • Serialization: ~3μs for JSON serialization
  • Memory Usage: ~32 bytes per pipeline ID instance
  • Thread Safety: Immutable value objects are fully thread-safe

§Cross-Platform Compatibility

  • Rust: PipelineId newtype wrapper with full validation
  • Go: PipelineID struct with equivalent interface
  • JSON: String representation of ULID for API compatibility
  • Database: TEXT column with ULID string storage

Modules§

pipeline_id_utils
Utility functions for working with pipeline IDs

Structs§

PipelineId
Pipeline entity identifier value object for type-safe pipeline management