====== STC-002 — Restore Test State ======

[[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 restore the state specified by the governing [[dido:99_annexes:annex-b-terms-and-definitions:t:test_definition|Test Definition]] before a repeated [[dido:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]] begins.

===== Source =====

  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-001|[DTE1] U.S. Patent Application US20220237111A1]], repeated initialization from a desired starting point, restart from an unmodified baseline state, and repeatable test execution
  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-002|[DTE2] Non-Traditional BAA Submission]], controlled initial states and repeatable testing
  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-003|[DTE3] Broad Agency Announcement White Paper]], controlled initial states and repeatable testing
  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-005|[DTE5] DIDO-TE Requirements Register]], State and Time Control source requirements

===== Rationale =====

Repeated testing requires the ability to return the Test Environment to controlled conditions before another Test Execution begins.

**State restoration** returns the relevant parts of the [[dido:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environment]] to the state specified for the repeated Test Execution.

The restored state may include the condition of participating [[dido:99_annexes:annex-b-terms-and-definitions:n:node|Nodes]], [[dido:99_annexes:annex-b-terms-and-definitions:t:twin_realization|Twin Realizations]], data, [[dido:99_annexes:annex-b-terms-and-definitions:c:configuration|Configuration]], or other [[dido:99_annexes:annex-b-terms-and-definitions:r:resource|Resources]] when those conditions are specified by the governing Test Definition.

The governing Test Definition determines the state to be restored. DIDO-TE restores those specified conditions before the repeated Test Execution begins.

State restoration is distinct from initial-state establishment. STC-001 establishes the initial state required for Test Execution. STC-002 restores specified state for subsequent or repeated Test Execution.

Restoration does not require the prior state to have been preserved using a particular snapshot, checkpoint, image, storage, or virtualization mechanism. The requirement concerns the resulting restored state rather than the mechanism used to produce it.

===== 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:n:node|Node]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:t:twin_realization|Twin Realization]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:c:configuration|Configuration]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:r:resource|Resource]]

===== Verification =====

Verification confirms that:

  - The governing Test Definition specifies the state required before the repeated Test Execution.
  - The specified state is restored before the repeated Test Execution begins.
  - Each condition specified as part of the restored state can be verified before Test Execution.
  - State changed by a preceding Test Execution does not remain when that state differs from the state specified for the repeated Test Execution.
  - Conditions not specified by the governing Test Definition are not required by this requirement.
  - The restored state is traceable to the governing Test Definition.
  - Restoration does not require a particular snapshot, checkpoint, storage, virtualization, or provisioning technology.

Verification includes a Test Execution that changes at least one specified state condition, followed by restoration and a repeated Test Execution, and confirms that the specified state is restored before the repeated execution begins.

===== Traceability =====

{{backlinks>.}}

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

This requirement restores the **starting state** required for repeated Test Execution.

STC-001 establishes an initial test state. STC-002 restores the specified state after preceding activity has changed the Test Environment.

The remaining STC requirements govern the temporal context associated with repeated Test Execution.

===== 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-002-restore-test-state#Statement&noheader&nofooter&noeditbtn}}
</code>

----

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