FR-UI-003 — Web-Based User Interface [Dido Solutions, Inc Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== FR-UI-003 — Web-Based User Interface ======

[[dido:02-crusible:99-annexes:annex-c-requirements:03-functional-requirements:03-11-management-interfaces:start|Go to C.3.11 Crucible Interfaces]]

===== Statement =====

[[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]] SHALL provide a [[dido:99_annexes:annex-b-terms-and-definitions:w:web_ui|Web-Based User Interface (Web UI)]] for invoking Crucible operations and observing their results.

===== Derived From =====

This requirement derives from:

  * Crucible System Requirements Specification, Version 1.1 Draft, Functional Requirements, FR-UI-001
  * Crucible System Requirements Specification, Version 1.1 Draft, Functional Requirements, FR-UI-002

The Original Requirements establish a web-based interface for managing multiple [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_environment|Infrastructure Environments]] and require the web-based interface to use the same engine and command-line capabilities as the primary command-line interface.[[dido:02-crusible:99-annexes:annex-b:cr-001|[C1]]]

FR-UI-003:

  * Identifies [[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]] as the required system
  * Replaces the broad phrase **web-based management interface** with the controlled term [[dido:99_annexes:annex-b-terms-and-definitions:w:web_ui|Web-Based User Interface (Web UI)]]
  * Expresses provision of the Web-Based User Interface as a direct and independently verifiable requirement
  * Identifies invocation of Crucible operations and observation of their results as the interface behavior
  * Separates provision of the Web-Based User Interface from shared interface operations
  * Separates provision of the Web-Based User Interface from provision of the Command-Line Interface

FR-UI-001 separately governs operations exposed through both interfaces.

FR-UI-002 separately requires the [[dido:99_annexes:annex-b-terms-and-definitions:c:cli|Command-Line Interface (CLI)]].

===== Rationale =====

A [[dido:99_annexes:annex-b-terms-and-definitions:w:web_ui|Web-Based User Interface (Web UI)]] provides a browser-accessible graphical interface through which a person can interact with Crucible.

The Web-Based User Interface enables a user to invoke Crucible operations and observe their resulting status, output, or other observable result without requiring direct command-line interaction.

Providing a Web-Based User Interface gives users an additional access path while preserving the [[dido:99_annexes:annex-b-terms-and-definitions:c:cli|Command-Line Interface (CLI)]] for interactive command-line use, scripts, automated [[dido:99_annexes:annex-b-terms-and-definitions:w:workflow|Workflows]], and [[dido:99_annexes:annex-b-terms-and-definitions:c:ci_cd_pipeline|CI/CD Pipelines]].

This requirement establishes a Web-Based User Interface without prescribing:

  * A particular web browser
  * A particular web framework
  * A particular visual design
  * A particular navigation structure
  * A particular page layout
  * A particular presentation technology
  * A particular client-side framework
  * A particular server-side framework
  * A particular authentication mechanism
  * A particular internal implementation
  * A particular set of Crucible operations
  * Replacement of the Command-Line Interface
  * Duplication of operation implementations

Separate requirements, architecture specifications, interface specifications, security requirements, and user-experience specifications govern those subjects.

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

This requirement applies to:

  * [[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:w:web_ui|Web-Based User Interface (Web UI)]]
  * Crucible operations exposed through the Web-Based User Interface
  * Results produced by operations invoked through the Web-Based User Interface

===== Verification =====

Verification confirms that:

  - [[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]] provides a [[dido:99_annexes:annex-b-terms-and-definitions:w:web_ui|Web-Based User Interface (Web UI)]]
  - A test user can access the Web-Based User Interface through a supported web browser
  - The test user can invoke an identified Crucible operation through the Web-Based User Interface
  - The Web-Based User Interface accepts the inputs required by the selected operation
  - Crucible performs the selected operation
  - The Web-Based User Interface presents an observable operation result
  - The Web-Based User Interface presents an observable completion or execution status

===== Referenced By =====

The following pages reference this requirement:

{{backlinks>.#dido:02-crusible}}

===== Implementation Status =====

Implemented and Verified

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

<todo>Review and approve FR-UI-003 as a leaf requirement.</todo>

----
===== Issues =====

<todo>Confirm which Crucible operations the Web-Based User Interface must expose.</todo>

<todo>Confirm whether the Web-Based User Interface must support management of multiple Infrastructure Environments as an explicit requirement.</todo>

<todo>Determine whether separate requirements define browser support, accessibility, authentication, session management, status presentation, error reporting, and result presentation.</todo>

----
===== Notes for Editors =====

This requirement page retains the stable requirement identifier ''FR-UI-003''.

This page is a leaf requirement page and omits a trailing '':start'' from its namespace.

The Statement uses the following controlling Terms and Definitions entries:

  * [[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:w:web_ui|Web-Based User Interface (Web UI)]]

The Statement addresses provision of a Web-Based User Interface for invoking Crucible operations and observing their results.

FR-UI-001 governs operations exposed through both the Web-Based User Interface and the [[dido:99_annexes:annex-b-terms-and-definitions:c:cli|Command-Line Interface (CLI)]].

FR-UI-002 governs provision of the Command-Line Interface.

The Web-Based User Interface provides an additional interface and does not replace the Command-Line Interface.

The term **observe** requires an operation result or status to be available through the Web-Based User Interface. It does not require every operation to complete synchronously or remain within a single browser interaction.

Do not add particular browsers, web frameworks, page structures, presentation technologies, authentication mechanisms, operation sets, or user-experience obligations unless the controlling requirement changes through an approved requirements process.

To reference this requirement Statement from another wiki page, insert:

<code dokuwiki>
{{section>dido:02-crusible:99-annexes:annex-c-requirements:03-functional-requirements:03-11-management-interfaces:fr-ui-003#Statement&noheader&nofooter&noeditbtn}}
</code>

----

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