Files
031-flash-card/docs/uc-001/uc.md
T
Tirsvad c3fbcbcfaf Add the plan baseline: business case, stakeholders, plan, design and milestones
Business Case, Stakeholder Analysis, Project Plan, use case chain
(UCD, US, UC, DM, SSD, OC, SD, DCD, DICT), three ADRs, milestones
MIL-001 to MIL-007, the traceability matrix and 22 review records
(autonomous mode, AI as stand-in for S01).
2026-10-14 21:33:25 +08:00

3.0 KiB

UC-001: Study Flash Cards

Metadata

Key Value
ID UC-001
CrossReference UCD-001, US-001, SA-001, DM-001, SSD-001
Language en
Domain it

Version History

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

Format: Fully Dressed

Fully Dressed

  • Scope: Flash Card program
  • Level: user-goal
  • Primary Actor: Learner
  • Stakeholders and Interests:
    • S01 — learns the Malay words and wants only unknown words to come up
    • S02 — wants to see the assignment's behaviour step by step
  • Preconditions:
    • A word list exists.
    • A display is available.
  • Postconditions (success guarantee):
    • The words the Learner marked as known are no longer in the words to learn.
    • The words to learn are kept, so that the next session starts from them.

Main Success Scenario

  1. The Learner starts the program.
  2. The system loads the words to learn: from the kept progress when it exists, otherwise from the word list.
  3. The system shows a random card with the word in Malay.
  4. After three seconds the system turns the card over and shows the translation in Danish.
  5. The Learner states that the word is known.
  6. The system removes the word from the words to learn and keeps the words to learn.
  7. The system shows a new random card, and the Learner repeats from step 4 until no word is left.

Extensions (Alternative / Exception Flows)

  • 3a. Spoken words are available on the Learner's machine:
    1. The system speaks the Malay word. If speaking fails, the system logs it and goes on.
  • 5a. The Learner states that the word is not known:
    1. The system keeps the word in the words to learn and shows a new random card; the Learner goes on at step 4.
  • 5b. The Learner answers before three seconds have passed:
    1. The system cancels the turn-over of the card being shown and starts a new one for the next card.
  • 7a. No word is left:
    1. The system tells the Learner that there is nothing left to learn, and further answers change nothing.
  • 2a. The kept progress or the word list is unreadable:
    1. The system reports the problem to the Learner and ends; it does not overwrite the kept progress.

Special Requirements / Business Rules

Step Rule
3, 7 The next card is chosen at random from the words to learn
4 The turn-over comes three seconds after the card appears
6 A word is identified by its Malay and Danish text; the first equal word is removed
2 The word list names its two languages and holds one word and one translation per card

Open Issues

  • Starting again (resetting the kept progress) is not offered in the program; deleting the kept progress does it.