====== STC-007 — Associate Test Events with Test Time ======

[[dido:03-dido-te:99-annexes:annex-c-requirements:03-functional-requirements:03-05-state-and-time-control-requirements:start|Go to C.3.5 State and Time Control Requirements]]

===== Statement =====

The [[dido:99_annexes:annex-b-terms-and-definitions:d:dido-te|DIDO-TE]] SHALL associate each test event identified by the governing [[dido:99_annexes:annex-b-terms-and-definitions:t:test_definition|Test Definition]] with its corresponding **test time**.

===== Source =====

  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-001|[DTE1] U.S. Patent Application US20220237111A1]], defined timelines, recorded points-in-time, repeatable time-sensitive testing, and virtual system time
  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-003|[DTE3] Broad Agency Announcement White Paper]], State and Time Control
  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-005|[DTE5] DIDO-TE Requirements Register]], State and Time Control source requirements

===== Rationale =====

Distributed-system behavior may depend on when an event occurs within the temporal context of a test.

**Test time** identifies the position on the **test timeline** associated with an event during [[dido:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]].

Associating a test event with test time allows event occurrence to be interpreted relative to the controlled temporal context of the test rather than solely by the wall-clock time at which the event was observed.

This association supports repeatability, event ordering, comparison, and interpretation of time-sensitive behavior when Test Executions occur at different wall-clock times or when the test timeline progresses at a rate different from real time.

The governing [[dido:99_annexes:annex-b-terms-and-definitions:t:test_definition|Test Definition]] determines the test events for which this association is required.

This requirement does not prescribe the representation of a time value, timestamp format, clock source, event-recording mechanism, synchronization protocol, or storage technology.

===== Applies To =====

  * [[dido:99_annexes:annex-b-terms-and-definitions:d:dido-te|DIDO-TE]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environment]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:t:test_definition|Test Definition]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:e:evidence|Evidence]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]]

===== Verification =====

Verification confirms that:

  - Each test event identified by the governing Test Definition has an associated test-time value.
  - The associated test-time value identifies the event's position on the test timeline.
  - Test time can be distinguished from wall-clock time when the two differ.
  - Events occurring at different positions on the test timeline can be temporally distinguished.
  - The association between an event and its test time is traceable to the Test Execution in which the event occurred.
  - The association does not require a particular timestamp representation, clock source, synchronization protocol, or storage technology.

Verification includes multiple test events occurring at different points on the test timeline and confirms that each event can be associated with its corresponding test time.

===== Traceability =====

{{backlinks>.}}

===== ConOps Relationship =====

This requirement associates events occurring during Test Execution with the **test time** established by the controlled test timeline.

The resulting temporal association supports Record and Playback, comparison, Validation, Evidence, and Traceability without assigning those separate responsibilities to the State and Time Control requirement family.

===== Delivery Phase =====

TBD

===== Requirement Status =====

Draft

===== Statement Reference =====

<code dokuwiki>
{{section>dido:03-dido-te:99-annexes:annex-c-requirements:03-functional-requirements:03-05-state-and-time-control-requirements:stc-007-associate-test-events-with-test-time#Statement&noheader&nofooter&noeditbtn}}
</code>

----

<WRAP centeralign>
© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.
</WRAP>