Artifact: System-Wide Requirements
This artifact captures the quality attributes and constraints that have system-wide scope. It also captures system-wide functional requirements.
Domains: Requirements

This artifact is used for the following purposes:

  • To describe the quality attributes of the system, and the constraints that the design options must satisfy to deliver the business goals, objectives, or capabilities
  • To capture functional requirements that are not expressed as use cases
  • To negotiate between, and select from, competing design options
  • To assess the sizing, cost, and viability of the proposed system
  • To understand the service-level requirements for operational management of the solution
Brief Outline

Organize system-wide requirements by a number of common themes or subcategories: the areas of performance and capacity, availability, usability, security and privacy, maintainability, manageability, and flexibility. See the supporting guidance for a description of the recommended categorization approach.

For each system-wide requirement, capture attributes such as the source and priority of the requirements, as described by the associated requirements management guidance.

Key Considerations
  • When you document system-wide requirements, ensure that the needs of all of the stakeholders are represented. In particular, include the needs of those who are responsible for maintaining or supporting the system after it is delivered.
  • Typically, there are some overlaps and gray areas between system-wide requirements and other requirements work products. For example, the authorization behavior of a system can be specified as use cases or as statements within system-wide requirements. The overall driving need is that no important requirements are missed or duplicated, and that there is an agreed upon approach for capturing and processing every type of requirement.
  • System-wide requirements originate from many places. Documenting the source of the requirement is particularly important when you separate externally mandated requirements.
  • Requirements are often thought of as "Qualitative" (specifying a quality or desirable characteristic) versus "Quantitative" (specifying a quantity). Qualitative requirements can sometimes be elaborated into quantitative requirements.
  • A good quality requirement is one that you can verify, either through testing or some other objective evaluation.
  • You must evaluate system-wide requirements for cost, schedule impact, and level of contribution to business goals. Based on your evaluation, the system-wide requirements should be iteratively challenged, defended, and amended.
Relationships
More Information