Files
031-flash-card/docs/sqa/reviews/rc-033-use-case-level.md

5.7 KiB

RC-033: Review of UC-001

Metadata

Key Value
ID RC-033
CrossReference UC-001, QC-UC-001, QC-LANG-001

Version History

Date Status Author Reviewer Change Commit
2026-10-14 Accepted Jens Tirsvad Nielsen AI as stand-in for S01 Initial version 0b983b7

Artifact Under Review

  • Instance reviewed: UC-001
  • Checklist used: QC-UC-001, and QC-LANG-001 (language and domain)
  • Scope: full review
  • Language and domain: en / it
  • Language reviewer: none (the stand-in for S01 reads the language and knows the domain)
  • Mode: autonomous, not independent (reviewer is AI as stand-in for S01)

Checklist Results

# Criterion Status Evidence/Notes
1 Consists of a single, concise paragraph summarizing only the primary success scenario N-A The format is Fully Dressed; the Brief format criterion does not apply.
2 Written as an informal multi-paragraph narrative; may mention some alternate flows without formal structure N-A The format is Fully Dressed; the Casual format criterion does not apply.
3 All standard sections are present: actors, preconditions, postconditions, main success scenario, alternative/exception flows Pass Scope, level, actor, stakeholders, pre- and postconditions, main success scenario and extensions are present.
4 Preconditions and postconditions are explicitly defined Pass Preconditions and postconditions are listed.
5 Primary actor is explicitly stated Pass Primary actor is Learner.
6 Stakeholders and their interests are stated Pass Stakeholders S01 and S02 and their interests are stated.
7 Main success scenario is written as clear, numbered steps Pass Main success scenario has 9 numbered steps, including the level choice (steps 2 and 3).
8 Alternative/exception flows correctly reference <<include>>/<<extend>> use cases where relevant, per UML 2.5.1 Pass UCD-001 has no include or extend relationship, so no extension needs to reference one; the extensions (3a, 4a, 5a, 7a, 7b, 9a) are plain alternative flows.
9 Explicit business rules are captured per step where applicable, rather than embedded loosely in narrative text Pass The Business Rules table gives a rule per step.
10 Naming of actors and use case title is consistent with the corresponding Use Case Diagram and User Stories Pass Title and actor match UCD-001 and US-001; the level step matches US-001.06.
11 Scope/level (e.g. summary, user-goal, subfunction) is explicitly stated Pass Level: user-goal and Scope: Flash Card program.
12 Use case is written from the actor's goal perspective, free of UI or implementation detail Pass Steps are written as goals and answers; buttons, files and milliseconds are in the wireframe and milestones.

Language and Domain Results

# Criterion Status Evidence/Notes
1 The Metadata table has a Language row and a Domain row, and neither is a placeholder Pass Metadata of UC-001 has `Language
2 Language is a BCP 47 code and Domain is a value from the registry's domain list Pass en is a BCP 47 code and it is a value of the registry's domain list.
3 The content (prose and table cells) is written in the stated language Pass Prose and table cells are English; Malay and Danish words and file names appear only as quoted data.
4 The register matches the one the registry gives for the artifact type Pass The registry gives IT Professional English for this type; the text is written for that reader.
5 Domain terms are the PO terms of the domain's dictionary, with no synonyms Pass The PO terms of DICT-001 (flash card, word list, words to learn, study session) are used and no synonym replaces them.
6 Metadata keys, section headings, IDs and statuses are in English Pass Metadata keys, headings, IDs and statuses are English.
7 No translated twin (<name>.<language>.md) exists beside the document Pass No translated twin exists beside the document (checked in docs/).
8 A change of language or domain since the previous accepted version has a Version History row and was reviewed again Pass First version; no change of language or domain since an earlier accepted version.
9 A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly Pass The reviewer is the stand-in for S01, the Product Owner, who reads English and knows the IT domain; no second language reviewer is needed (review-checklist-process step 2). Open to challenge by S01 in the end-of-run summary.
10 Abbreviations are spelled out on first use, in the stated language Fail CSV, MVVM, UI, PO and similar abbreviations are not all spelled out at first use; Optional, deferred.

Overall Verdict

Go — every Mandatory criterion passes; the failed Optional criteria are deferred with an action item. Reviewed by AI as stand-in for S01; not independent of the author.

Full review (not a delta) after the level choice was added for MIL-008.

Action Items

Action Owner Due
Criterion LANG 10 (Optional) failed: Abbreviations are spelled out on first use, in the stated language; fix or accept the deferral S01 2026-10-21