sequenceDiagram
    participant Client as External API / Netdata Cloud
    participant Handler as dyncfg.Handler (Framework)
    participant Domain as Callbacks[C] (SD, VNode, Collector)
    participant Rules as dyncfg Rules (Validation Helpers)

    Note over Client,Rules: Processing "CmdAdd" for Dynamic Configuration

    Client->>Handler: CmdAdd(Function fn)
    Handler->>Domain: ExtractKey(fn)
    Domain-->>Handler: key, job_name, ok

    Note over Handler,Domain: NEW: Domain-specific Name Validation
    Handler->>Domain: NEW: ValidateJobName(job_name)
    
    alt Domain is Collector
        Domain->>Rules: JobNameRuleStrict(job_name)
        Rules-->>Domain: error (if dots/spaces/colons)
    else Domain is SD / VNode / SecretStore
        Domain->>Rules: JobNameRuleAllowDots(job_name)
        Rules-->>Domain: error (if spaces/colons)
    end
    
    Domain-->>Handler: error status

    alt Invalid Name
        Handler->>Client: SendCode(400, "invalid job name")
    else Valid Name
        Handler->>Domain: ParseAndValidate(fn, job_name)
        Domain-->>Handler: Config object (C), error
        
        alt Valid Config
            Handler->>Domain: Start(C)
            Domain-->>Handler: success
            Handler->>Client: SendCode(200, "OK")
        else Invalid Config
            Handler->>Client: SendCode(400, "parse error")
        end
    end

    Note over Handler,Domain: Note: Validation happens before expensive payload parsing.