Merge pull request 'Plan baseline: business case, stakeholders, plan, design, milestones' (#1) from baseline-plan into main

2026-10-14 15:34:07 +02:00
parent 97eec837a4 5e1a8c1f6f
commit 934d7e4902
49 changed files with 3529 additions and 0 deletions
@@ -0,0 +1,3 @@
 [submodule "framework"]
 	path = framework
 	url = ssh://git@git.tirsystem.com:10022/TirSystem/SQA-QC-Framework.git
@@ -0,0 +1,53 @@
 # ADR-0001: Standard library first, speech as an optional extra
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | ADR-0001 |
 | CrossReference | [BC-001], [SA-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 Allowed Status values: `Proposed`, `Accepted`, `Rejected`, `Deprecated`, `Superseded by ADR-NNNN`.
 ---
 ## Context
 The assignment tells the participant to read the word list with `pandas`. The Product Owner (S01) also wants the Malay word spoken, which needs `gTTS` and `playsound`. GitHub viewers (S03) want no runtime dependencies, and fellow course participants (S02) want a program they can run at once. Options:
 1. `pandas` for CSV and `gTTS` plus `playsound` as normal dependencies: matches the assignment text, but installs a large dependency tree for a 1000 row file, and a failing `playsound` build breaks the install.
 2. Standard library `csv` for the data and `gTTS` plus `playsound` as an optional extra behind a port: no runtime dependency for the core program, speech available on request.
 3. No speech at all: simplest, but does not meet the Product Owner's wish.
 ## Decision
 The core program uses only the Python standard library (`csv`, `tkinter`, `random`, `pathlib`). Speech is an optional extra declared as `speech` in `pyproject.toml` (`pip install -e ".[speech]"`), used through a `SpeechPort`, and replaced by a silent adapter when the extra or the network is missing.
 ## Consequences
 **Positive:**
 - `dependencies` in `pyproject.toml` is empty, which meets success criterion 3 of [BC-001] and the concern of S03.
 - The program and its tests run without a network.
 - A broken audio player cannot stop the program from starting.
 **Negative:**
 - The code differs from the assignment text, which uses `pandas`; the wiki explains the mapping for S02.
 - Two code paths exist for speech (real and silent) and both need tests.
 - `playsound` is unmaintained and is pinned to 1.2.2.
 ## Affected Artifacts
 - [BC-001] — success criterion 3 and the risk about `playsound`
 - [SA-001] — the conflict between S01 and S03
 ---
 [BC-001]: ../business-case.md
 [SA-001]: ../stakeholder-analysis.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,54 @@
 # ADR-0002: Clean architecture with MVVM for the Tkinter program
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | ADR-0002 |
 | CrossReference | [BC-001], [DM-001], [DCD-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 Allowed Status values: `Proposed`, `Accepted`, `Rejected`, `Deprecated`, `Superseded by ADR-NNNN`.
 ---
 ## Context
 The assignment solution is a single script with global variables (`current_card`, `to_learn`, `flip_timer`). The project's coding standard (QC-PY-001, criteria 14 to 17) asks for layers that point inward, ports for external services and a presentation pattern. The program is small, so a full layering has a cost in files. Options:
 1. One module with the assignment's globals: closest to the course, but behaviour cannot be tested without a display and rules are mixed with Tkinter.
 2. The four layers (domain, application, infrastructure, presentation) with MVVM: behaviour is testable, the assignment's function names live on in the view and view model.
 3. Layers without a view model: the view would hold the rules again.
 ## Decision
 The program is built in four layers under `src/flash_card/` with MVVM in the presentation layer. The function names of the assignment (`next_card`, `flip_card`, `is_known`) are kept on the view and on the view model, and the names `current_card` and `flip_timer` are kept where the concept exists (`StudySession.current_card`, `FlashCardView.flip_timer`); the course's `to_learn` list is the `Deck`.
 ## Consequences
 **Positive:**
 - The rules (draw, remove, persist) are tested without Tkinter or a file system.
 - Replacing the CSV file or the speech service touches one adapter.
 - The wiki can map each assignment step to the file that implements it.
 **Negative:**
 - More files than the course solution; a beginner needs the wiki's map to find the assignment's code.
 - Layer boundaries need discipline (DTO at the boundary, one composition root).
 ## Affected Artifacts
 - [DM-001] — concepts refined by the domain layer
 - [DCD-001] — the class design this ADR constrains
 - [BC-001] — objective 5, step by step delivery
 ---
 [BC-001]: ../business-case.md
 [DM-001]: ../domain-model.md
 [DCD-001]: ../dcd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,53 @@
 # ADR-0003: Artifact types skipped for this project
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | ADR-0003 |
 | CrossReference | [BC-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 Allowed Status values: `Proposed`, `Accepted`, `Rejected`, `Deprecated`, `Superseded by ADR-NNNN`.
 ---
 ## Context
 The framework lists more artifact types than a one-week, single-person learning project needs. The journey of the `create-project` skill makes the baseline (`BC`, `SA`, `PP`, `MIL`) mandatory and every other type optional, but requires the reason for a skipped step to be recorded. Options: (1) create every type, which doubles the documents for one person and a 1000 word program; (2) create the baseline, the use case chain the code is traced to (`UCD`, `US`, `UC`, `DM`, `SSD`, `OC`, `SD`, `DCD`, `DICT`) and skip the types that add no information here.
 ## Decision
 Option 2 is chosen. These types are not created in this project, for the reasons given:
 | Type | Reason |
 | --- | --- |
 | `KPI`, `BMC`, `BPMN` | One owner, no revenue and no business process; the measurable success criteria are in the Business Case |
 | `RA` | The idea is not a hunch: the assignment specifies the behaviour, so there is no belief to test before the Business Case |
 | `GOV` | One person owns, builds and approves; the review workflow is the framework's own and the autonomous mode records stand-in reviews |
 | `ERD` | The only persistence is two CSV files with the same two columns, described in the adapters of the Design Class Diagram |
 | `TRN`, `TRR` | No reviewer training for a single-person project |
 ## Consequences
 **Positive:**
 - Less documentation to keep in step for a small program.
 - Reviews concentrate on the documents that carry the decisions.
 **Negative:**
 - A later contributor finds no governance document; the review records show who stood in.
 - If persistence grows beyond a CSV file, an `ERD` must be added in that change.
 ## Affected Artifacts
 - [BC-001] — the success criterion on review coverage counts only created artifacts
 ---
 [BC-001]: ../business-case.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,70 @@
 # Artifact Registry
 This project's artifact state. Types, short names and `CrossReference
 Candidates` come from the framework catalog
 (`framework/registry/artifact-catalog.md`); this file only records where
 each document lives in *this* project and the next version to use.
 Delete rows for types you don't use. Add a row the first time you create a
 document of a type. `Primary File` may contain a glob (e.g.
 `docs/uc-*/uc.md`); `framework/scripts/find-crossreferences.sh` reads it.
 | Short Name | Artifact Type | Primary File | Next Available Version |
 | --- | --- | --- | --- |
 | BC | Business Case | docs/business-case.md | 002 |
 | SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 002 |
 | PP | Project Plan | docs/project-plan.md | 002 |
 | MIL | Milestone / Gateway | docs/milestones/*.md | 008 |
 | UCD | Use Case Diagram | docs/use-case-diagram.md | 002 |
 | US | User Story | docs/user-stories.md | 002 |
 | UC | Use Case | docs/uc-*/uc.md | 002 |
 | OC | Operation Contract | docs/uc-*/oc.md | 002 |
 | SD | Sequence Diagram | docs/uc-*/sd.md | 002 |
 | DM | Domain Model | docs/domain-model.md | 002 |
 | SSD | System Sequence Diagram | docs/uc-*/ssd.md | 002 |
 | DCD | Design Class Diagram | docs/dcd.md | 002 |
 | DICT | Domain Dictionary | docs/dictionary.md | 002 |
 | ADR | Architecture Decision Record | docs/adr/adr-NNNN-*.md | 0004 |
 | RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 023 |
 | TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 |
 ## Languages
 Set the PO language when the project starts; `project-planning` asks for it
 if it is missing. An artifact of a type marked "Written in the PO language"
 exists once, in that language, under its normal name (`business-case.md`); the
 `artifact` skill ("One file per artifact") has the rule.
 | Setting | Value |
 | --- | --- |
 | PO language | en |
 | PO domain | it |
 | High-level register | IT Executive English |
 | Technical register | IT Professional English |
 | Wiki languages | en, da and ms (`framework/process/wiki.md`: en and the PO language at minimum; da and ms added by the Product Owner) |
 Every artifact of a type marked "Yes" below states its language and domain in
 its `Language` and `Domain` Metadata rows; `new-artifact.sh` fills them from
 `PO language` and `PO domain`. `Language` is a BCP 47 code (`da`, `en`).
 `Domain` is a value from this list; add a row to introduce a domain, so a
 reviewer can see at once which professional vocabulary a document uses.
 | Domain | Meaning |
 | --- | --- |
 | it | Software and IT |
 | medical | Healthcare and medical devices |
 | construction | Construction and civil engineering |
 | Artifact types | Register | Written in the PO language |
 | --- | --- | --- |
 | BC, KPI, PP, MIL | IT Executive English | Yes |
 | SA, BMC, BPMN, UCD, US, UC, SSD, DM, RA, GOV, DICT | IT Professional English | Yes |
 | OC, SD, DCD, ERD, ADR, TM, RC, QC, source code | IT Professional English | No |
 ## Notes
 - "Next Available Version" is the zero-padded (3-digit) version to use the
  *next* time a new document of that type is created. Increment it only when
  a brand-new document is created, not when an existing document's
  `## Version History` gets a row.
 - `ADR` uses 4 digits (`0001`); `RC` is sequential across all artifact types.
@@ -0,0 +1,149 @@
 # Business Case: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | BC-001 |
 | CrossReference | [SA-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 | [c3fbcbc] |
 ---
 ## Executive Summary
 The Day 31 assignment of Udemy's *100 Days of Code: The Complete Python Pro Bootcamp* asks the course participant to build a flash card program that helps learn the most frequent words of a foreign language. The program shows a word in the target language, flips the card after three seconds to show its translation, and keeps only the words the learner does not yet know. This project delivers that program for a Malay to Danish word list, built from the four assignment steps (user interface, new flash cards, flipping the cards, saving progress) and extended with spoken Malay words. It is delivered as readable, tested, documented code that other course participants can run and compare with their own solution.
 ## Methodological and Standards Foundation
 - Method: the SQA and QC framework of this repository (plan first, review every artifact against its QC checklist, one pull request per milestone); Larman, *Applying UML and Patterns*, for the use of layers and the presentation pattern.
 - Architecture: clean architecture (domain, application, infrastructure, presentation) with MVVM for the user interface, as the `clean-architecture` skill sets out.
 - Quality standard: ISO/IEC 25010:2023 product quality characteristics, as every QC criterion is tagged.
 - Code: PEP 8, PEP 257 and type hints; Python 3.13 or later; Doxygen comments; `pytest` for tests.
 ## Problem Statement
 - A learner who memorises vocabulary from a plain list has no way to see which words are already known, so time is spent on words that are mastered.
 - The course assignment gives a step-by-step description, not a finished and tested reference that a participant can read, run and compare against.
 - The supplied starting data is French to English. The Product Owner learns Malay and reads Danish, so the program must work with a Malay to Danish list and pronounce the Malay word.
 ## Business Opportunity
 A small, well-structured reference solution gives the Product Owner a language learning tool for daily use, shows how clean architecture applies to a Tkinter program, and gives other course participants and repository visitors an example to learn from.
 ## Objectives
 1. Deliver the four assignment steps as working behaviour: the window with a card and two buttons; a random card per button press; a flip to the translation after 3000 ms; and persistence of the unknown words in `words_to_learn.csv`.
 2. Use the Malay to Danish frequency word list (`data/ms-da.csv`, 1000 words) instead of the French to English list, and speak the Malay word through text to speech without making that a requirement of the core program.
 3. Keep the core program free of third-party runtime dependencies.
 4. Provide a repository others can use: README, wiki in English, Danish and Bahasa Malaysia, screenshots, a repository description and topics.
 5. Keep track of the work step by step, with one reviewed milestone and one pull request per step.
 ## Scope
 ### In Scope
 - Python 3.13 or later Tkinter program with the assignment's function names (`next_card`, `flip_card`, `is_known`).
 - Reading the Malay to Danish list from `data/ms-da.csv` (semicolon separated, header `ms;da`).
 - Saving the words still to learn to `data/words_to_learn.csv` and using that file on the next start.
 - Optional spoken Malay word (text to speech) as an extra that can be installed.
 - `pyproject.toml`, `.gitignore`, `Doxyfile`, virtual environment instructions, `pytest` tests and `constants.py`.
 - README from the framework template, screenshots, and a wiki in English, Danish and Bahasa Malaysia.
 - Repository description and topics on the git host.
 - The framework documents of the baseline: Business Case, Stakeholder Analysis, Project Plan, milestones, review records and traceability matrix.
 ### Out of Scope
 - Other languages: the user interface labels are Malay and Danish only; another word list works by changing the data file but is not delivered.
 - Spaced repetition scheduling, statistics, accounts, cloud synchronisation and mobile apps.
 - Packaging for distribution on PyPI or as an installer.
 - Redistribution of the course's own image files; the card and button images are generated for this project.
 - A translation quality review of the word list.
 ## Expected Benefits
 ### Tangible Benefits
 - A working flash card program for 1000 Malay words with progress that survives a restart.
 - A test suite that protects the behaviour of every assignment step.
 - A repository other participants can run in five commands or fewer.
 ### Intangible Benefits
 - A worked example of clean architecture and MVVM in a small Tkinter program.
 - Practice of the plan-first workflow with reviews and pull requests per step.
 - Learning material in three languages for readers of the wiki.
 ## Strategic Alignment
 The project supports the Product Owner's goal of completing the 100 Days of Code course with understood, well-documented solutions, and the goal of a public repository that shows disciplined engineering practice to its viewers.
 ## Success Criteria
 | # | Criterion | Target | Measure |
 | --- | --- | --- | --- |
 | 1 | Assignment steps delivered | 4 of 4 steps work as described in the assignment | Acceptance checks listed in each step's milestone are all passed |
 | 2 | Tests | `pytest` exits with 0 and every behaviour of steps 1 to 4 has at least one test | `pytest` run on a clean `.venv`, and the milestone's task list |
 | 3 | Runtime dependencies of the core program | 0 third-party packages | `dependencies` in `pyproject.toml` is empty; speech is an optional extra |
 | 4 | Time to run for a newcomer | 5 commands or fewer from clone to running window | Command count in the README's Setup and Run sections |
 | 5 | Wiki coverage | 3 languages (en, da, ms) with the same page set | File list of `docs/wiki/` |
 | 6 | Repository presentation | A description and at least 5 topics are set on the repository | Read back from the git host API |
 | 7 | Review coverage | Every artifact and every milestone's code has an `RC-*` record with verdict Go | `docs/sqa/reviews/` and the Traceability Matrix |
 | 8 | Delivery window | Everything merged by 2026-10-21 | Date of the last merged pull request |
 ## Risks
 | Risk | Impact | Mitigation |
 | --- | --- | --- |
 | Text to speech needs network access and an audio player that may not work on every machine | Spoken word missing for some users | Speech is an optional extra behind a port; the program starts and works without it, and a failure is logged, not raised |
 | The `playsound` package is unmaintained and fails on some Python versions | Install of the extra fails | Pin the version known to work (1.2.2), keep the player behind a port so it can be replaced |
 | Tkinter cannot be tested without a display on a build machine | Presentation code untested in CI | The view model holds the behaviour and is tested without Tkinter; the view test skips when no display exists |
 | The word list has translation errors (machine translated) | Learner learns a wrong meaning | Out of scope for this project; the README says the list is machine translated and may be edited |
 | Course images are copyrighted | Redistribution not allowed in a public repository | Images are generated by a script in this repository |
 ## Assumptions
 - S01 is the Product Owner, the developer and the reviewer; no other person reviews, so the AI acts as stand-in reviewer in autonomous mode and the review records say so.
 - S01 can reach S02 and S03 only through the public repository; no interviews are held.
 - A display and Tkinter are available on the machine where the program runs.
 - Network access is available when the optional speech extra is used.
 - The git host `git.tirsystem.com` is used for the repository, the wiki and the pull requests.
 ## Constraints
 - Python 3.13 or later, with a virtual environment in `.venv`.
 - The folder structure is `src/`, `tests/` and `docs/`.
 - Constants are defined in `constants.py`.
 - The assignment's function names are kept so that participants can compare solutions.
 - The Product Owner's language is English and the domain is IT; the wiki is in English, Danish and Bahasa Malaysia.
 - Delivery by 2026-10-21 (self-set, one week).
 ## Cost–Benefit Assessment
 | Costs | Benefits |
 | --- | --- |
 | About one working week of the Product Owner's time to review the plan and the result | A reusable learning tool and a reference solution. Qualitative on purpose: no revenue is expected, so a quantitative return does not apply; the benefit is learning and portfolio value |
 | No licence or hosting cost; the git host and Python are already available | Documentation and tests reusable for the next course day |
 | Maintenance of the optional speech extra | An example of clean architecture for S02 and S03 |
 ## Stakeholders
 | Stakeholder ID (SA) | Interest in this project |
 | --- | --- |
 | S01 | Owns the product, builds it and reviews it; wants a working tool and a learning record |
 | S02 | Wants readable, runnable code with the assignment's function names and run instructions |
 | S03 | Wants a clear repository description, topics and README, and no runtime dependencies |
 ## Recommendation
 Proceed — the scope is small, the risks are mitigated, and the result serves the Product Owner and two groups of readers at no cost beyond the Product Owner's time.
 ---
 [SA-001]: ./stakeholder-analysis.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,194 @@
 # Design Class Diagram: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | DCD-001 |
 | CrossReference | [DM-001], [SD-001], [DICT-001], [ADR-0002] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Purpose and Scope
 The design classes of the program in `src/flash_card/`, in four layers (domain, application, infrastructure, presentation) with the presentation pattern MVVM ([ADR-0002]). The classes refine the concepts of [DM-001]; names are the IT terms of [DICT-001]. Methods trace to the operation contracts of [OC-001] and the sequence diagrams of [SD-001] (the SSD messages are in [SSD-001]).
 ## Diagram
 ```plantuml
@startuml
 package domain {
  class Card <<frozen>> {
    +front : str
    +back : str
  }
  class LanguagePair <<frozen>> {
    +front_code : str
    +back_code : str
  }
  class Vocabulary <<frozen>> {
    +language_pair : LanguagePair
    +cards : tuple[Card, ...]
  }
  class Deck {
    +language_pair : LanguagePair
    -_cards : list[Card]
    +from_vocabulary(vocabulary : Vocabulary) : Deck
    +cards : tuple[Card, ...]
    +is_empty : bool
    +draw(choose, exclude : Card | None) : Card
    +remove(card : Card) : None
  }
  interface VocabularyRepository {
    +load() : Vocabulary
  }
  interface ProgressRepository {
    +load() : Deck | None
    +save(deck : Deck) : None
  }
  class VocabularyError
  class VocabularyFormatError
  class VocabularyNotFoundError
  class EmptyDeckError
 }
 package application {
  class CardDto <<frozen>> {
    +front_text : str
    +back_text : str
    +front_language : str
    +back_language : str
  }
  interface SpeechPort {
    +speak(text : str, language_code : str) : None
  }
  class StudySession {
    -_deck : Deck
    -_progress : ProgressRepository
    -_speech : SpeechPort
    +current_card : CardDto | None
    +remaining : int
    +next_card() : CardDto | None
    +mark_known() : None
  }
  class open_study_session <<function>>
 }
 package infrastructure {
  class CsvVocabularyRepository {
    -_path : Path
    +load() : Vocabulary
  }
  class CsvProgressRepository {
    -_path : Path
    +load() : Deck | None
    +save(deck : Deck) : None
  }
  class GttsSpeech {
    +speak(text : str, language_code : str) : None
  }
  class NullSpeech {
    +speak(text : str, language_code : str) : None
  }
 }
 package presentation {
  class FlashCardViewModel {
    -_session : StudySession
    +side : Side
    +language_name : str
    +text : str
    +next_card() : None
    +flip_card() : None
    +is_known() : None
  }
  class FlashCardView {
    +flip_timer : str | None
    +next_card() : None
    +flip_card() : None
    +is_known() : None
  }
  class "app.main" as Main <<function>>
 }
 Vocabulary "1" *-- "1..*" Card
 Vocabulary "1" --> "1" LanguagePair
 Deck "1" o-- "0..*" Card
 Deck ..> Vocabulary : built from
 Deck ..> EmptyDeckError : raises
 VocabularyFormatError --|> VocabularyError
 VocabularyNotFoundError --|> VocabularyError
 EmptyDeckError --|> VocabularyError
 StudySession "1" --> "1" Deck
 StudySession "1" --> "1" ProgressRepository
 StudySession "1" --> "1" SpeechPort
 StudySession ..> CardDto : returns
 open_study_session ..> VocabularyRepository
 open_study_session ..> ProgressRepository
 open_study_session ..> StudySession : creates
 CsvVocabularyRepository ..|> VocabularyRepository
 CsvProgressRepository ..|> ProgressRepository
 GttsSpeech ..|> SpeechPort
 NullSpeech ..|> SpeechPort
 FlashCardViewModel "1" --> "1" StudySession
 FlashCardView "1" --> "1" FlashCardViewModel
 Main ..> CsvVocabularyRepository : composes
 Main ..> CsvProgressRepository : composes
 Main ..> GttsSpeech : composes
 Main ..> FlashCardView : composes
@enduml
 ```
 ## Class Table
 | Class | Refines (Domain Model concept) | Responsibility | Attributes | Operations |
 | --- | --- | --- | --- | --- |
 | `Card` | Flash Card | Holds a word and its translation | `front`, `back` | none |
 | `LanguagePair` | Word List (first and second language) | Names the two languages of a word list by code | `front_code`, `back_code` | none |
 | `Vocabulary` | Word List | Holds all cards of a language pair as delivered | `language_pair`, `cards` | none |
 | `Deck` | Words To Learn | Holds the cards still to learn and picks and removes cards | `language_pair`, `_cards` | `from_vocabulary`, `draw`, `remove` |
 | `VocabularyRepository` | Word List | Port: load the delivered word list | none | `load` |
 | `ProgressRepository` | Words To Learn | Port: load and save the words to learn | none | `load`, `save` |
 | `StudySession` | Study Session | Runs one session: draws cards, marks cards known, saves progress, asks for speech | `_deck`, `_progress`, `_speech`, `_current` | `next_card`, `mark_known` |
 | `CardDto` | Flash Card | Plain data that crosses to the presentation layer | four text fields | none |
 | `SpeechPort` | (none: external service) | Port: speak a text in a language | none | `speak` |
 | `CsvVocabularyRepository`, `CsvProgressRepository` | Word List, Words To Learn | Adapters that read and write the semicolon separated CSV file | `_path` | `load`, `save` |
 | `GttsSpeech`, `NullSpeech` | (none) | Adapters for speech: the gTTS service, and silence | none | `speak` |
 | `FlashCardViewModel` | Study Session | Exposes the side, language name and text of the card shown, and the three commands | `_session`, `side`, `language_name`, `text` | `next_card`, `flip_card`, `is_known` |
 | `FlashCardView` | (none: user interface) | Draws the window, forwards the buttons, owns the 3000 ms timer | `flip_timer`, widgets | `next_card`, `flip_card`, `is_known` |
 ## Method Traceability
 | Method signature | Operation Contract / SD message |
 | --- | --- |
 | `open_study_session(vocabulary_repository, progress_repository, speech, choose) -> StudySession` | [OC-001] `startStudySession`, [SD-001] sequence startStudySession (loads the words to learn) |
 | `StudySession.next_card() -> CardDto \| None` | [OC-001] `startStudySession` (first card), `markUnknown`; [SD-001] |
 | `StudySession.mark_known() -> None` | [OC-001] `markKnown` (remove and save); [SD-001] |
 | `FlashCardViewModel.next_card() -> None` | [OC-001] `markUnknown`; [SD-001] |
 | `FlashCardViewModel.is_known() -> None` | [OC-001] `markKnown`; [SD-001] |
 | `FlashCardViewModel.flip_card() -> None` | [SSD-001] timer turn-over (no contract: started by the system's timer) |
 | `FlashCardView.next_card()`, `.is_known()`, `.flip_card()` | the same three operations, forwarded from buttons and the timer; names are the assignment's |
 ## Pattern Annotations
 | Pattern | Classes | Rationale |
 | --- | --- | --- |
 | Repository | `VocabularyRepository`, `ProgressRepository`, CSV adapters | The domain does not know the CSV file |
 | Ports and adapters | `SpeechPort`, `GttsSpeech`, `NullSpeech` | Speech is an optional extra; the core runs without it |
 | Null Object | `NullSpeech` | No `if speech:` checks in the use case |
 | MVVM | `FlashCardView`, `FlashCardViewModel` | Behaviour is tested without Tkinter ([ADR-0002]) |
 | Composition root | `app.main` | The one place that names the adapters |
 ## Dependency Check
 Imports point inward: `domain` imports nothing from the other packages; `application` imports `domain`; `infrastructure` imports `application` and `domain`; `presentation` imports `application` and `domain`, and `app.main` additionally imports `infrastructure`. There is no cycle. `constants.py` imports nothing from the packages.
 ---
 [DM-001]: ./domain-model.md
 [DICT-001]: ./dictionary.md
 [SSD-001]: ./uc-001/ssd.md
 [OC-001]: ./uc-001/oc.md
 [SD-001]: ./uc-001/sd.md
 [ADR-0002]: ./adr/adr-0002-clean-architecture-and-mvvm.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,45 @@
 # Domain Dictionary: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | DICT-001 |
 | CrossReference | [BC-001], [SA-001], [DM-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 | [c3fbcbc] |
 ---
 ## Purpose and Scope
 Maps each Product Owner (PO) term to its professional IT term. PO language: English (`en`), domain: Software and IT (`it`), from the registry's `Languages` section. The PO terms are the words of a language learner; the IT terms are the class and function names of the code.
 ## Dictionary
 | PO term | Language | IT term | Definition | Used as PO term in | Used as IT term in |
 | --- | --- | --- | --- | --- | --- |
 | Flash card | en | `Card` | A word in one language together with its translation in another language. | DM, UC, US | DCD |
 | Word list | en | `Vocabulary` | The complete set of flash cards of one language pair, as delivered with the program. | DM, UC, US | DCD |
 | Words to learn | en | `Deck` | The flash cards the learner does not yet know; it starts as the word list and only gets smaller. | DM, UC, US | DCD |
 | Study session | en | `StudySession` | One run of the program in which the learner is shown cards one by one. | DM, UC, US | DCD |
 | Language pair | en | `LanguagePair` | The two languages of a word list, the language learned and the language of the translation. | DM, UC | DCD |
 | Progress file | en | `ProgressRepository` | The file `words_to_learn.csv` that keeps the words to learn between runs. | UC, US | DCD |
 | Spoken word | en | `SpeechPort` | The Malay word read aloud when its card is shown. | UC, US | DCD |
 ## Rules
 - The Domain Model, use cases and user stories use the PO term; the Operation Contract, Sequence Diagram, Design Class Diagram and ERD use the IT term.
 - One IT term per PO term and one PO term per IT term; no synonyms.
 - "Card" alone means a flash card; "front" is its word in the language learned and "back" is its translation, and the card on screen shows one of them at a time.
 ---
 [BC-001]: ./business-case.md
 [SA-001]: ./stakeholder-analysis.md
 [DM-001]: ./domain-model.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,80 @@
 # Domain Model: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | DM-001 |
 | CrossReference | [UC-001], [UCD-001], [SSD-001], [DICT-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 | [c3fbcbc] |
 ---
 ## Purpose and Scope
 Covers: [UC-001] Study Flash Cards. The model holds the concepts a Learner talks about: the flash card, the word list, the words to learn and the study session. The project-level model is this document; no other use case exists.
 ## Diagram
 Concepts, attributes and associations only — no operations.
 ```plantuml
@startuml
 class "Flash Card" as FlashCard {
  word in the first language
  translation in the second language
 }
 class "Word List" as WordList {
  first language
  second language
 }
 class "Words To Learn" as WordsToLearn
 class "Study Session" as StudySession {
  card shown
  side shown
 }
 WordList "1" o-- "1..*" FlashCard : holds
 WordsToLearn "1" o-- "0..*" FlashCard : holds
 WordsToLearn "1" --> "1" WordList : starts as a copy of
 StudySession "1" --> "1" WordsToLearn : works through
 StudySession "1" --> "0..1" FlashCard : shows
@enduml
 ```
 ## Concept Table
 | Concept | Definition | Attributes | Source (use case / glossary) |
 | --- | --- | --- | --- |
 | Flash Card | A word in one language with its translation in another | word, translation | UC-001 steps 3 and 4 ("card", "translation") |
 | Word List | The complete set of flash cards of a language pair, as delivered with the program | first language, second language | UC-001 step 2 ("word list") |
 | Words To Learn | The flash cards the Learner does not yet know; starts as the word list and only gets smaller | none | UC-001 steps 2 and 6 ("words to learn") |
 | Study Session | One run of the program in which the Learner is shown cards | card shown, side shown | UC-001 main scenario |
 ## Association Table
 | From | Association (reading direction) | To | Multiplicity |
 | --- | --- | --- | --- |
 | Word List | holds | Flash Card | 1 to 1..* |
 | Words To Learn | holds | Flash Card | 1 to 0..* |
 | Words To Learn | starts as a copy of | Word List | 1 to 1 |
 | Study Session | works through | Words To Learn | 1 to 1 |
 | Study Session | shows | Flash Card | 1 to 0..1 |
 ## Generalizations
 | General | Specializations | Is-a justification |
 | --- | --- | --- |
 | none | none | no generalization exists in this domain |
 ---
 [UC-001]: ./uc-001/uc.md
 [UCD-001]: ./use-case-diagram.md
 [SSD-001]: ./uc-001/ssd.md
 [DICT-001]: ./dictionary.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,77 @@
 # MIL-001: Project foundation
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | MIL-001 |
 | CrossReference | [BC-001], [US-001], [DCD-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 | [c3fbcbc] |
 ---
 ## Purpose
 Decide whether the project can start building features: the repository has its configuration, layer skeleton, tooling and run instructions, so that every later milestone adds behaviour to a ready structure.
 ## Deliverable
 A repository in which `pip install -e ".[dev]"` works in a fresh `.venv`, `pytest` runs (with the placeholder test passing), the four layer packages and the three test folders exist, and the README explains how to create the virtual environment, run the program and run the tests.
 ## Go / No-Go Criteria
 | # | Criterion (objectively checkable) | Go | No-Go |
 | --- | --- | --- | --- |
 | 1 | `pyproject.toml` declares Python `>=3.13`, an empty `dependencies` list, the extras `speech` and `dev`, and the pytest, ruff and mypy configuration | Present and `pip install -e ".[dev]"` succeeds in a fresh `.venv` | Missing or install fails |
 | 2 | `.gitignore` is a Python ignore file and also ignores `.venv/`, `.env`, `data/words_to_learn.csv` and `docs/doxygen/` | `git check-ignore` reports each path | A path is not ignored |
 | 3 | `src/flash_card/` has `domain`, `application`, `infrastructure` and `presentation` packages and `constants.py`; `tests/` has `unit`, `integration`, `e2e` | Every folder exists | A folder is missing |
 | 4 | `doxygen Doxyfile` runs without error | Exit code 0 | Any error |
 | 5 | README follows the framework template and gives the `.venv` and `python -m pip install --upgrade pip` commands | `check-readme.sh` reports no finding | Any finding |
 | 6 | `pytest` exits with 0 | Exit code 0 | Any failure |
 ## Dependencies
 | Depends on | Reason |
 | --- | --- |
 | BC-001, SA-001, PP-001 accepted | Required by the plan-first gate before a milestone |
 ## Traceability
 | Business Case objective / KPI / user story | Reference |
 | --- | --- |
 | Objective 3 (no runtime dependencies) and objective 4 (repository others can use) | [BC-001] |
 | Success criteria 3 and 4 | [BC-001] |
 ## Ownership
 | Role | Stakeholder ID (SA) |
 | --- | --- |
 | Owner | S01 |
 | Approving reviewer | S01 (AI as stand-in in autonomous mode) |
 ## Target Date
 2026-10-14 — the first day of the delivery window that ends 2026-10-21 ([BC-001] constraint).
 ## Tasks
 | # | Task | Summary | Needs its own Use Case/User Story? | Reference |
 | --- | --- | --- | --- | --- |
 | 1 | Add pyproject.toml | Declare the project `flash-card` for Python 3.13 or later with no runtime dependencies, an optional `speech` extra (`gTTS`, `playsound==1.2.2`) and a `dev` extra (`pytest`, `ruff`, `mypy`), and configure pytest (`src` on the path, `tests` folder), ruff and mypy. Meets objective 3 of the Business Case and ADR-0001. | No | ADR-0001 |
 | 2 | Add Python .gitignore | Ignore Python build and cache output, `.venv/`, the local `.env` with tokens that is never imported into the project, the generated `docs/doxygen/` and the learner's own `data/words_to_learn.csv`. | No | |
 | 3 | Create the layer skeleton and constants.py | Create `src/flash_card/` with the packages `domain`, `application`, `infrastructure`, `presentation` and `constants.py` (background colour, fonts, delay 3000 ms, file names), and `tests/unit`, `tests/integration`, `tests/e2e`, as ADR-0002 and DCD-001 set out. | No | ADR-0002, DCD-001 |
 | 4 | Add the Doxyfile | Add a `Doxyfile` for `src/` with Python optimisation, output in `docs/doxygen/`, so that the Doxygen comments written in every later milestone produce documentation. | No | |
 | 5 | Write the first README with the .venv instructions | Create README.md from the framework template with overview, requirements, and the commands to create and activate `.venv`, upgrade pip with `python -m pip install --upgrade pip`, install, run and test, for Windows and Linux/macOS. | No | |
 | 6 | Add the word list to the repository | Commit `data/ms-da.csv` (1000 Malay words with Danish translation, semicolon separated, header `ms;da`) and describe its origin and that it is machine translated, in `data/README.md`. | No | |
 ---
 [BC-001]: ../business-case.md
 [US-001]: ../user-stories.md
 [DCD-001]: ../dcd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,75 @@
 # MIL-002: Step 1 - User interface
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | MIL-002 |
 | CrossReference | [BC-001], [US-001], [UC-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 | [c3fbcbc] |
 ---
 ## Purpose
 Decide whether the window of assignment step 1 is complete: a card with a language name and a word, and the two buttons, laid out as the wireframe shows.
 ## Deliverable
 The program starts and shows the window described in `docs/uc-001/wireframe.md`: a 2 x 2 grid where the card (a canvas with the front image and two texts) spans both columns, and the unknown and known buttons are below it. The card shows placeholder text; no data is read yet. The four images are generated by a script of this repository.
 ## Go / No-Go Criteria
 | # | Criterion (objectively checkable) | Go | No-Go |
 | --- | --- | --- | --- |
 | 1 | `python -m flash_card` opens a window titled "Flashy" with background `#B1DDC6` and padding 50 px | Observed, and asserted by the e2e test where a display exists | Different title, colour or padding |
 | 2 | The canvas is 800 x 526 and holds one image and two texts (Arial 40 italic, Arial 60 bold) | Asserted by the e2e test | Any difference |
 | 3 | The buttons use `wrong.png` and `right.png` with no border and sit in row 1, columns 0 and 1 | Asserted by the e2e test | Any difference |
 | 4 | The view holds no rule: the view model gives the texts | View model unit tests pass without Tkinter | A rule is in the view |
 | 5 | The code review against QC-PY-001 has no failed Mandatory criterion | `RC-*` verdict Go | Verdict No-Go |
 | 6 | `pytest` exits with 0 | Exit code 0 | Any failure |
 ## Dependencies
 | Depends on | Reason |
 | --- | --- |
 | MIL-001 | The configuration, layer skeleton and tooling |
 ## Traceability
 | Business Case objective / KPI / user story | Reference |
 | --- | --- |
 | Objective 1, step 1 of the assignment | [BC-001] |
 | US-001.01 See a flash card | [US-001] |
 ## Ownership
 | Role | Stakeholder ID (SA) |
 | --- | --- |
 | Owner | S01 |
 | Approving reviewer | S01 (AI as stand-in in autonomous mode) |
 ## Target Date
 2026-10-15 — within the delivery window that ends 2026-10-21 ([BC-001] constraint).
 ## Tasks
 | # | Task | Summary | Needs its own Use Case/User Story? | Reference |
 | --- | --- | --- | --- | --- |
 | 1 | Generate the card and button images | Write `tools/generate_images.py`, a standard library script that draws `card_front.png`, `card_back.png` (800 x 526, rounded card), `right.png` and `wrong.png` (button icons) with a PNG writer, so no course asset is redistributed; commit the four generated files in `src/flash_card/presentation/assets/`. | No | |
 | 2 | Show the flash card window | Build `FlashCardView` with Tkinter: window title, padding, background, a 2 x 2 grid, the card canvas spanning two columns with image and two texts, and the two image buttons, as in the wireframe. Keep `PhotoImage` objects as attributes so they are not garbage collected. | Yes | US-001.01, wireframe.md |
 | 3 | Add the view model, entry point and composition root | `FlashCardViewModel` exposes the language name and word (placeholders at this step), `presentation/app.py` builds and runs the view, and `python -m flash_card` calls it. | Yes | US-001.01 |
 | 4 | Test the view model and the window | Unit tests of the view model; an e2e test that creates the window, reads the canvas and button configuration and destroys it, skipped when no display is available. | No | |
 ---
 [BC-001]: ../business-case.md
 [US-001]: ../user-stories.md
 [UC-001]: ../uc-001/uc.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,77 @@
 # MIL-003: Step 2 - New flash cards
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | MIL-003 |
 | CrossReference | [BC-001], [US-001], [UC-001], [DCD-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 | [c3fbcbc] |
 ---
 ## Purpose
 Decide whether assignment step 2 works: the word list is read from `data/ms-da.csv` and each press of a button shows a new random card.
 ## Deliverable
 The program reads the word list and shows a random Malay word with the language name "Malay". Pressing the known or the unknown button shows another random word. The domain classes, the CSV reader and the use case that draws cards exist with tests.
 ## Go / No-Go Criteria
 | # | Criterion (objectively checkable) | Go | No-Go |
 | --- | --- | --- | --- |
 | 1 | `CsvVocabularyRepository` reads `data/ms-da.csv` into 1000 cards with the language pair `ms`, `da` | Integration test passes on the real file | Any other count or pair |
 | 2 | A file with a missing header, a row with other than two cells, or no file raises a specific `VocabularyError` subclass | Unit tests pass | An unspecific exception or a silent skip |
 | 3 | A button press shows a card different from the current one when the deck has two or more cards, and the same card when it has one | Unit tests pass | Any other behaviour |
 | 4 | Blank lines in the CSV file are ignored | Unit test passes | A blank line becomes a card |
 | 5 | The domain and application layers import no `tkinter`, `csv` or `random` module; randomness comes in through the injected `choose` function | `grep` check in the review record | An outward import |
 | 6 | Code review against QC-PY-001 has no failed Mandatory criterion; `pytest` exits with 0 | `RC-*` verdict Go and exit code 0 | Otherwise |
 ## Dependencies
 | Depends on | Reason |
 | --- | --- |
 | MIL-002 | The window and view model this step feeds with data |
 ## Traceability
 | Business Case objective / KPI / user story | Reference |
 | --- | --- |
 | Objective 1, step 2; objective 2 (Malay to Danish list) | [BC-001] |
 | US-001.02 Get a new card | [US-001] |
 ## Ownership
 | Role | Stakeholder ID (SA) |
 | --- | --- |
 | Owner | S01 |
 | Approving reviewer | S01 (AI as stand-in in autonomous mode) |
 ## Target Date
 2026-10-16 — within the delivery window that ends 2026-10-21 ([BC-001] constraint).
 ## Tasks
 | # | Task | Summary | Needs its own Use Case/User Story? | Reference |
 | --- | --- | --- | --- | --- |
 | 1 | Add the domain classes | `Card`, `LanguagePair`, `Vocabulary` (frozen dataclasses), `Deck` (draw, remove) and the errors `VocabularyError`, `VocabularyFormatError`, `VocabularyNotFoundError`, `EmptyDeckError`, with the `VocabularyRepository` port. | No | DCD-001 |
 | 2 | Read the word list from CSV | `CsvVocabularyRepository` reads a semicolon separated file with a two-code header using `csv`, `pathlib` and UTF-8, and ignores blank lines; this replaces `pandas` from the assignment (ADR-0001). | No | ADR-0001, DCD-001 |
 | 3 | Draw a random card | `StudySession.next_card` returns a `CardDto` chosen at random from the deck and not equal to the current card when other cards exist; `open_study_session` builds the session from the repository. | Yes | US-001.02 |
 | 4 | Show a new card on each button press | `FlashCardViewModel` and `FlashCardView` get `next_card`; both buttons call it so that the card changes, as in the assignment. | Yes | US-001.02 |
 | 5 | Test the reader, the deck and the session | Unit tests for the domain and the session (with an injected `choose`), integration test of the reader on the real word list, and a view model test. | No | |
 ---
 [BC-001]: ../business-case.md
 [US-001]: ../user-stories.md
 [UC-001]: ../uc-001/uc.md
 [DCD-001]: ../dcd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,74 @@
 # MIL-004: Step 3 - Flip the cards
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | MIL-004 |
 | CrossReference | [BC-001], [US-001], [UC-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 | [c3fbcbc] |
 ---
 ## Purpose
 Decide whether assignment step 3 works: three seconds after a card appears, it turns over and shows the Danish translation.
 ## Deliverable
 After 3000 ms the card shows `card_back.png`, the language name "Danish", the translation, and white text. A button press shows the front of a new card with black text and restarts the timer; a press before the 3000 ms have passed cancels the earlier timer.
 ## Go / No-Go Criteria
 | # | Criterion (objectively checkable) | Go | No-Go |
 | --- | --- | --- | --- |
 | 1 | `FlashCardViewModel.flip_card` changes the side to the back, the language name to the back language and the text to the translation | Unit test passes | Any other state |
 | 2 | `next_card` returns the side to the front | Unit test passes | Side stays on the back |
 | 3 | The view schedules `flip_card` with `after(3000, ...)` and cancels the earlier timer with `after_cancel` before scheduling a new one | e2e test with a recording scheduler, or a unit test of the view with a fake root | Timer leaks or fires twice |
 | 4 | The back uses `card_back.png` and white text; the front uses `card_front.png` and black text | e2e test reads the canvas item configuration | Any difference |
 | 5 | `PhotoImage` objects are created once, outside the callbacks | Code review | An image is created in a function |
 | 6 | Code review against QC-PY-001 has no failed Mandatory criterion; `pytest` exits with 0 | `RC-*` verdict Go and exit code 0 | Otherwise |
 ## Dependencies
 | Depends on | Reason |
 | --- | --- |
 | MIL-003 | Cards with a front and a back to turn |
 ## Traceability
 | Business Case objective / KPI / user story | Reference |
 | --- | --- |
 | Objective 1, step 3 | [BC-001] |
 | US-001.03 See the translation | [US-001] |
 ## Ownership
 | Role | Stakeholder ID (SA) |
 | --- | --- |
 | Owner | S01 |
 | Approving reviewer | S01 (AI as stand-in in autonomous mode) |
 ## Target Date
 2026-10-17 — within the delivery window that ends 2026-10-21 ([BC-001] constraint).
 ## Tasks
 | # | Task | Summary | Needs its own Use Case/User Story? | Reference |
 | --- | --- | --- | --- | --- |
 | 1 | Add the card side to the view model | `Side` enum (front, back) and `flip_card` on the view model, so the language name and text change with the side without Tkinter. | Yes | US-001.03 |
 | 2 | Flip the card after 3000 ms in the view | `FlashCardView.flip_card` swaps image, text colour, title and word with `itemconfig`; `flip_timer` holds the `after` id and is cancelled with `after_cancel` on every button press, as the assignment's hints say. | Yes | US-001.03 |
 | 3 | Test the flip | View model unit tests for both sides, and an e2e test with the real timer replaced by a recording `after`/`after_cancel` pair. | No | |
 ---
 [BC-001]: ../business-case.md
 [US-001]: ../user-stories.md
 [UC-001]: ../uc-001/uc.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,78 @@
 # MIL-005: Step 4 - Save progress
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | MIL-005 |
 | CrossReference | [BC-001], [US-001], [UC-001], [DCD-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 | [c3fbcbc] |
 ---
 ## Purpose
 Decide whether assignment step 4 works: a known word stops coming up, and the words still to learn are kept in `words_to_learn.csv` and used on the next start.
 ## Deliverable
 Pressing the known button removes the current card from the words to learn and saves them to `data/words_to_learn.csv`. A start with that file uses it; a start without it uses `data/ms-da.csv`. When no word is left the card shows "Nothing left to learn".
 ## Go / No-Go Criteria
 | # | Criterion (objectively checkable) | Go | No-Go |
 | --- | --- | --- | --- |
 | 1 | With the 3 word example of the assignment, marking the second known leaves the other two in the saved file, in order, with the original header | Integration test passes | Any other content |
 | 2 | A start with an existing progress file draws only from that file; a start without it draws from the word list | Integration test passes | Any other source |
 | 3 | The unknown button never changes the file | Unit test passes | File changed |
 | 4 | Marking the last card known results in a finished state and does not raise | Unit test passes | An exception |
 | 5 | The program does not overwrite the progress file when it cannot be read; it reports a `VocabularyFormatError` | Unit test passes | File overwritten |
 | 6 | The progress file has the same format as the word list, so that it can be used as a word list | Integration test round trip passes | Different format |
 | 7 | Code review against QC-PY-001 has no failed Mandatory criterion; `pytest` exits with 0 | `RC-*` verdict Go and exit code 0 | Otherwise |
 ## Dependencies
 | Depends on | Reason |
 | --- | --- |
 | MIL-004 | The finished card and the full card cycle |
 ## Traceability
 | Business Case objective / KPI / user story | Reference |
 | --- | --- |
 | Objective 1, step 4 | [BC-001] |
 | US-001.04 Keep my progress | [US-001] |
 ## Ownership
 | Role | Stakeholder ID (SA) |
 | --- | --- |
 | Owner | S01 |
 | Approving reviewer | S01 (AI as stand-in in autonomous mode) |
 ## Target Date
 2026-10-18 — within the delivery window that ends 2026-10-21 ([BC-001] constraint).
 ## Tasks
 | # | Task | Summary | Needs its own Use Case/User Story? | Reference |
 | --- | --- | --- | --- | --- |
 | 1 | Add the progress port and its CSV adapter | `ProgressRepository` (`load` returns the deck or `None`, `save`) and `CsvProgressRepository` sharing the reading and writing code of the word list adapter, so the file format is defined once. | No | DCD-001 |
 | 2 | Remove a known card and save | `Deck.remove`, `StudySession.mark_known` removing the current card and saving the deck; `open_study_session` prefers the progress file as the assignment says. | Yes | US-001.04 |
 | 3 | Show the finished state | When the deck is empty the session returns no card, the view model shows "Nothing left to learn" and the buttons do nothing. | Yes | US-001.04 |
 | 4 | Wire the known button | `is_known` on the view model and view calls `mark_known` and then `next_card`; the unknown button only calls `next_card`. | Yes | US-001.04 |
 | 5 | Test progress | Unit tests for deck, session and finished state; integration tests of the three word example, the restart and the round trip, using `tmp_path`. | No | |
 ---
 [BC-001]: ../business-case.md
 [US-001]: ../user-stories.md
 [UC-001]: ../uc-001/uc.md
 [DCD-001]: ../dcd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,78 @@
 # MIL-006: Spoken Malay word
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | MIL-006 |
 | CrossReference | [BC-001], [US-001], [UC-001], [DCD-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 | [c3fbcbc] |
 ---
 ## Purpose
 Decide whether the Product Owner's extra works without harming the core program: the Malay word is spoken when its card is shown, and the program is unchanged when the speech extra is not installed.
 ## Deliverable
 `pip install -e ".[speech]"` makes the program speak the Malay word on each new card. Without the extra, without a network, or with `--no-speech`, the program works silently and shows no error.
 ## Go / No-Go Criteria
 | # | Criterion (objectively checkable) | Go | No-Go |
 | --- | --- | --- | --- |
 | 1 | `StudySession.next_card` calls `SpeechPort.speak(text, "ms")` once per drawn card, and never for the finished state | Unit test with a fake port passes | Any other number of calls |
 | 2 | `GttsSpeech` imports `gtts` and `playsound` only when it speaks, writes the audio to a temporary file and removes it | Unit test with injected fakes passes | Import at module level or a leftover file |
 | 3 | A failure of the service or the player is logged and not raised | Unit test passes | Exception reaches the caller |
 | 4 | Without the extra installed, `build_speech` returns `NullSpeech` and the program starts | Unit test with a blocked import passes | Start fails |
 | 5 | `dependencies` in `pyproject.toml` is still empty and the extra pins `playsound==1.2.2` | File check in the review record | Any runtime dependency |
 | 6 | Speaking does not block the Tkinter main loop | The adapter speaks in a daemon thread; unit test asserts `speak` returns before the player finishes | The window freezes while speaking |
 | 7 | Code review against QC-PY-001 has no failed Mandatory criterion; `pytest` exits with 0 | `RC-*` verdict Go and exit code 0 | Otherwise |
 ## Dependencies
 | Depends on | Reason |
 | --- | --- |
 | MIL-005 | The complete card cycle the speech hooks into |
 ## Traceability
 | Business Case objective / KPI / user story | Reference |
 | --- | --- |
 | Objective 2 (spoken Malay word), objective 3 (no runtime dependencies) | [BC-001] |
 | US-001.05 Hear the Malay word | [US-001] |
 ## Ownership
 | Role | Stakeholder ID (SA) |
 | --- | --- |
 | Owner | S01 |
 | Approving reviewer | S01 (AI as stand-in in autonomous mode) |
 ## Target Date
 2026-10-19 — within the delivery window that ends 2026-10-21 ([BC-001] constraint).
 ## Tasks
 | # | Task | Summary | Needs its own Use Case/User Story? | Reference |
 | --- | --- | --- | --- | --- |
 | 1 | Add the speech port and the silent adapter | `SpeechPort` in the application layer and `NullSpeech` in infrastructure, so that `StudySession` always has a speaker and has no `if speech` checks. | No | ADR-0001, DCD-001 |
 | 2 | Speak the Malay word on each new card | `StudySession.next_card` asks the port to speak the front text in the front language code. | Yes | US-001.05 |
 | 3 | Add the gTTS adapter | `GttsSpeech` creates the audio with `gTTS`, plays it with `playsound` in a daemon thread, removes the temporary file and logs failures; third-party imports happen on first use. | Yes | US-001.05 |
 | 4 | Choose the speaker in the composition root and add --no-speech | `build_speech` returns `GttsSpeech` when `gtts` and `playsound` can be imported and `NullSpeech` otherwise; the command line option `--no-speech` forces silence. | No | |
 | 5 | Declare the extra and test the adapters | The `speech` extra in `pyproject.toml`; unit tests with fake `gtts`, player and port, none of which uses the network. | No | |
 ---
 [BC-001]: ../business-case.md
 [US-001]: ../user-stories.md
 [UC-001]: ../uc-001/uc.md
 [DCD-001]: ../dcd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,80 @@
 # MIL-007: Documentation and publication
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | MIL-007 |
 | CrossReference | [BC-001], [US-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 | [c3fbcbc] |
 ---
 ## Purpose
 Decide whether the project can be handed to its readers: S02 can run it and compare their solution, and S03 can understand what it is from the repository page.
 ## Deliverable
 The final README with screenshots, the wiki in English, Danish and Bahasa Malaysia (same page set), the generated Doxygen documentation, the final traceability matrix, and the repository description and topics set on the git host.
 ## Go / No-Go Criteria
 | # | Criterion (objectively checkable) | Go | No-Go |
 | --- | --- | --- | --- |
 | 1 | `check-readme.sh` reports no finding and the README has the front and back screenshot | No finding; both files exist and are linked | Any finding |
 | 2 | `docs/wiki/` holds the same pages in `<Page>.md`, `<Page>-da.md` and `<Page>-ms.md` and a `_Sidebar.md` that lists the three languages | File list compared | A page is missing in a language |
 | 3 | The screenshots are taken from the running program, not drawn by hand | Capture script is in `tools/` and the images show the window of this program | Mock-up |
 | 4 | The README gives the `.venv` and pip upgrade commands, and the run and test commands in five commands or fewer | Count in the review record | More than five |
 | 5 | The repository has a description and at least 5 topics on the git host | Read back from the API | Any missing |
 | 6 | `doxygen Doxyfile` builds without warnings about undocumented public items of `src/` | Output of the run | Warnings |
 | 7 | The traceability matrix has a row for every created artifact and the last `RC-*` of each | Row count in the review record | A missing row |
 | 8 | `check-languages.sh` and `check-plan.sh` report no finding | Exit code 0 | Any finding |
 ## Dependencies
 | Depends on | Reason |
 | --- | --- |
 | MIL-006 | The documentation describes the finished program |
 ## Traceability
 | Business Case objective / KPI / user story | Reference |
 | --- | --- |
 | Objective 4 (a repository others can use); success criteria 4, 5, 6, 7 | [BC-001] |
 | All stories (the wiki maps each to a step) | [US-001] |
 ## Ownership
 | Role | Stakeholder ID (SA) |
 | --- | --- |
 | Owner | S01 |
 | Approving reviewer | S01 (AI as stand-in in autonomous mode) |
 ## Target Date
 2026-10-21 — the end of the delivery window ([BC-001] constraint).
 ## Tasks
 | # | Task | Summary | Needs its own Use Case/User Story? | Reference |
 | --- | --- | --- | --- | --- |
 | 1 | Capture screenshots of the running program | Write `tools/capture_screenshots.py` that starts the program, waits for the front, grabs the window, waits 3 s for the back and grabs it again; save `docs/images/screenshot-front.png` and `screenshot-back.png`. The tool needs Pillow, which is a tool-only dependency and not a project dependency. | No | |
 | 2 | Finish the README | Complete the README from the framework template with the screenshots, the assignment-to-code map, the optional speech extra, the data attribution, and the commands to run the program and the tests. | No | |
 | 3 | Write the wiki in English | Pages `Home`, `Install`, `Usage`, `Architecture` in `docs/wiki/` with the language line and a sidebar. | No | |
 | 4 | Translate the wiki to Danish and Bahasa Malaysia | The same four pages as `<Page>-da.md` and `<Page>-ms.md`; commands, file names and IDs stay in English. | No | |
 | 5 | Build the Doxygen documentation | Run `doxygen Doxyfile` and fix undocumented public items; the generated `docs/doxygen/` is ignored by git and described in the README. | No | |
 | 6 | Set the repository description and topics | Update the description and topics of the repository on the git host through its API, using the token from `.env`, which is not read into the project. | No | |
 | 7 | Publish the wiki pages | Push `docs/wiki/` to the repository's wiki over SSH after the merge, because the opt-in publish workflow needs a runner and a secret the project does not have. | No | |
 | 8 | Close the traceability matrix | One row per artifact with its latest review record, and the end-of-run summary of the autonomous run. | No | |
 ---
 [BC-001]: ../business-case.md
 [US-001]: ../user-stories.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,108 @@
 # Project Plan: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | PP-001 |
 | CrossReference | [BC-001], [SA-001], [US-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007] |
 | 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 | [c3fbcbc] |
 ---
 ## Purpose
 This plan schedules the seven phases (gateways) that deliver the flash card program inside the delivery window of one week that the Business Case sets as a constraint (2026-10-14 to 2026-10-21). Each phase is one milestone and is delivered by one pull request, so the Product Owner (S01) can follow the work step by step.
 ## Planning Assumptions
 - Week 1 starts 2026-10-14; the plan ends by 2026-10-21, per the Business Case constraint.
 - One phase takes one day; the last phase (documentation and publication) has three days because the wiki exists in three languages and the screenshots need the finished program.
 - The baseline documents (Business Case, Stakeholder Analysis, Project Plan, use case documents, ADRs) are accepted before MIL-001 starts, in a pull request of their own.
 - Phases 2 to 5 follow the four steps of the course assignment in order; phase 6 is the Product Owner's extra.
 - S01 is owner and approving reviewer of every phase; in autonomous mode the AI acts as stand-in and the review records say so.
 ## Gateway Schedule
 | Gateway | Document | Window | Decision date | Owner | Stories | Main deliverable | Milestone |
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | Project foundation | [MIL-001] | 2026-10-14 | 2026-10-14 | S01 | none | pyproject, gitignore, skeleton, Doxyfile, first README, word list | |
 | Step 1 - User interface | [MIL-002] | 2026-10-15 | 2026-10-15 | S01 | US-001.01 | The window with card and buttons | |
 | Step 2 - New flash cards | [MIL-003] | 2026-10-16 | 2026-10-16 | S01 | US-001.02 | Random cards from the word list | |
 | Step 3 - Flip the cards | [MIL-004] | 2026-10-17 | 2026-10-17 | S01 | US-001.03 | Flip after 3000 ms | |
 | Step 4 - Save progress | [MIL-005] | 2026-10-18 | 2026-10-18 | S01 | US-001.04 | words_to_learn.csv | |
 | Spoken Malay word | [MIL-006] | 2026-10-19 | 2026-10-19 | S01 | US-001.05 | Text to speech as optional extra | |
 | Documentation and publication | [MIL-007] | 2026-10-19 to 2026-10-21 | 2026-10-21 | S01 | none | README, screenshots, wiki in 3 languages, description and topics | |
 ```plantuml
@startgantt
 Project starts 2026-10-14
 [Foundation] starts 2026-10-14 and ends 2026-10-14
 [Step 1 UI] starts 2026-10-15 and ends 2026-10-15
 [Step 2 Cards] starts 2026-10-16 and ends 2026-10-16
 [Step 3 Flip] starts 2026-10-17 and ends 2026-10-17
 [Step 4 Progress] starts 2026-10-18 and ends 2026-10-18
 [Speech] starts 2026-10-19 and ends 2026-10-19
 [Documentation] starts 2026-10-19 and ends 2026-10-21
 [Foundation Go/No-Go] happens 2026-10-14
 [Step 1 Go/No-Go] happens 2026-10-15
 [Step 2 Go/No-Go] happens 2026-10-16
 [Step 3 Go/No-Go] happens 2026-10-17
 [Step 4 Go/No-Go] happens 2026-10-18
 [Speech Go/No-Go] happens 2026-10-19
 [Documentation Go/No-Go] happens 2026-10-21
@endgantt
 ```
 ## Scope Coverage
 | Business Case scope item | Gateway |
 | --- | --- |
 | Tkinter program with the assignment's function names | MIL-002, MIL-003, MIL-004, MIL-005 |
 | Reading `data/ms-da.csv` | MIL-003 |
 | Saving and using `words_to_learn.csv` | MIL-005 |
 | Optional spoken Malay word | MIL-006 |
 | `pyproject.toml`, `.gitignore`, `Doxyfile`, `.venv` instructions, `pytest`, `constants.py` | MIL-001 |
 | README, screenshots, wiki in three languages | MIL-007 |
 | Repository description and topics | MIL-007 |
 | Framework documents of the baseline | Baseline pull request before MIL-001 |
 ## Dependencies
 ```
 Baseline → MIL-001 → MIL-002 → MIL-003 → MIL-004 → MIL-005 → MIL-006 → MIL-007
 ```
 A No-Go on a phase moves every later date by the days the rework takes; the buffer is the 2026-10-20 working day, which has no phase of its own.
 ## Plan Risks
 | Risk | Impact | Mitigation |
 | --- | --- | --- |
 | No display on the machine that runs the review, so the e2e tests skip | Window behaviour is checked by the view model tests only | The review record states whether the e2e tests ran; the screenshots in MIL-007 prove the window on a machine with a display |
 | The git host's CI is not available | The publish workflows cannot run | Milestones are published with `sync-project.sh` and the wiki by SSH push (MIL-007) |
 | The speech extra cannot be installed on the build machine | MIL-006 cannot be demonstrated end to end | The adapter is tested with fakes; the manual check is recorded as not done |
 ## Open Issues
 - No Governance document (GOV): see ADR-0003. S01 is the only approver.
 - The git host's `sync-milestones` workflow is not installed; whether to install it is S01's decision.
 ---
 [BC-001]: ./business-case.md
 [SA-001]: ./stakeholder-analysis.md
 [US-001]: ./user-stories.md
 [MIL-001]: ./milestones/mil-001-foundation.md
 [MIL-002]: ./milestones/mil-002-step1-user-interface.md
 [MIL-003]: ./milestones/mil-003-step2-new-flash-cards.md
 [MIL-004]: ./milestones/mil-004-step3-flip-cards.md
 [MIL-005]: ./milestones/mil-005-step4-save-progress.md
 [MIL-006]: ./milestones/mil-006-malay-speech.md
 [MIL-007]: ./milestones/mil-007-documentation-and-publication.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,68 @@
 # RC-001: Review of BC-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-001 |
 | CrossReference | [BC-001], [QC-BC-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [BC-001]
 - Checklist used: [QC-BC-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 | ROI/Cost-Benefit analysis is quantitative, or where qualitative, is explicitly justified | Pass | The Cost-Benefit table is qualitative and says why: no revenue is expected, so a quantitative return does not apply. |
 | 2 | Risks are identified with documented impact and mitigation | Pass | The Risks table has 5 risks, each with an impact and a mitigation. |
 | 3 | Success criteria are measurable, stating explicit targets rather than vague aspirations | Pass | The Success Criteria table has 8 rows with numeric targets and a measure each (for example 0 third-party packages; 5 commands or fewer). |
 | 4 | Scope explicitly separates In Scope vs Out of Scope | Pass | Scope has `### In Scope` and `### Out of Scope` subsections. |
 | 5 | Stakeholders are cross-referenced to Stakeholder Analysis IDs rather than re-described inline | Pass | The Stakeholders table cites S01, S02 and S03 and does not re-describe their roles. |
 | 6 | Methodology and quality-standard foundation are stated explicitly (e.g. ISO/IEC 25010, Larman) | Pass | Methodological and Standards Foundation names the framework, Larman, ISO/IEC 25010:2023 and PEP 8. |
 | 7 | Assumptions and constraints are explicit and clearly distinguished from one another | Pass | Assumptions and Constraints are separate sections. |
 | 8 | Document supports executive decision-making with a clear, unambiguous recommendation | Pass | Recommendation reads `Proceed` with a one-sentence rationale. |
 ## 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 BC-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [BC-001]: ../../../docs/business-case.md
 [QC-BC-001]: ../../../framework/qc/artifacts/qc-business-case.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,70 @@
 # RC-002: Review of SA-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-002 |
 | CrossReference | [SA-001], [QC-SA-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [SA-001]
 - Checklist used: [QC-SA-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 | Power/Interest grid is filled for every stakeholder, with no gaps or unclassified entries | Pass | S01, S02 and S03 each have power, interest and quadrant; none is unclassified. |
 | 2 | Each stakeholder is assigned a unique, stable ID (e.g. S01-S11 style) reusable for RACI assignments in other artifacts | Pass | IDs S01 to S03 are unique and used unchanged in every other document. |
 | 3 | Roles and organizational context are defined with explicit Power and Interest levels, not just narrative description | Pass | Role, organization, power and interest are tabulated, not only narrated. |
 | 4 | Communication needs (channel, frequency, deliverable type) are mapped to project phases or milestones | Pass | Communication table maps each ID to a channel, frequency, deliverable and milestone. |
 | 5 | Conflicting stakeholder interests are identified with documented mitigation or resolution strategies | Pass | Two conflicts (speech against no dependencies; layers against simple code) have mitigations. |
 | 6 | Stakeholder concerns are explicitly traced to Business Case objectives | Pass | Traceability section maps each concern to a Business Case objective. |
 | 7 | Primary concerns are expressed in both business language and a recognized quality-attribute mapping (e.g. FURPS+) | Pass | Primary Concerns table maps every concern to a FURPS+ attribute. |
 | 8 | Document is understandable and navigable by non-technical stakeholders reviewing their own entry | Pass | Short, plain sentences; each stakeholder can find their own row. |
 ## 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 SA-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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.
 Note: the quadrants of S02 and S03 are the author's assumption, because the Product Owner gave only S01's quadrant; BC-001 records that neither group can be interviewed.
 ## 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 |
 ---
 [SA-001]: ../../../docs/stakeholder-analysis.md
 [QC-SA-001]: ../../../framework/qc/artifacts/qc-stakeholder-analysis.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,54 @@
 # RC-003: Review of PP-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-003 |
 | CrossReference | [PP-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [PP-001]
 - Checklist used: none exists for this type, 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`)
 ## 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 PP-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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 — no checklist exists for the Project Plan type; the plan was checked against the Business Case constraint (delivery by 2026-10-21) and the Go/No-Go criteria of MIL-001 to MIL-007, and the language checklist passes. Accepted as the Product Owner's stand-in, after the Product Owner accepted the plan in chat. Reviewed by AI as stand-in for S01; not independent of the author.
 ## 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 |
 ---
 [PP-001]: ../../../docs/project-plan.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,68 @@
 # RC-004: Review of UCD-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-004 |
 | CrossReference | [UCD-001], [QC-UCD-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [UCD-001]
 - Checklist used: [QC-UCD-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 | Actors are defined with correct UML stereotypes (e.g. `<<System>>`, `<<Actor>>`) | Pass | Actor table gives `<<Actor>>` and the diagram boundary carries `<<System>>`. |
 | 2 | System boundary is clearly drawn and labeled | Pass | The boundary `Flash Card` is drawn and labelled. |
 | 3 | Include/extend relationships are used correctly per UML 2.5.1, not as generic "uses" arrows | Pass | No include or extend is used; the table of Relationships says none, and why. |
 | 4 | Every actor participates in at least one use case (no orphan actors) | Pass | The only actor, Learner, takes part in Study Flash Cards. |
 | 5 | Diagram is traceable to a documented stakeholder need | Pass | The actor traces to S01 and S02 in the Actor Table. |
 | 6 | Use case names are verb phrases describing actor goals, not internal system operations | Pass | `Study Flash Cards` is a verb phrase and an actor goal. |
 | 7 | Diagram is free of implementation detail (e.g. UI widgets, database tables) | Pass | No widget, file or table appears in the diagram. |
 | 8 | Actor and use case naming is consistent with corresponding Use Case and User Story documents | Pass | Names match UC-001 and US-001 (`Learner`, `Study Flash Cards`). |
 ## 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 UCD-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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.
 ## 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 |
 ---
 [UCD-001]: ../../../docs/use-case-diagram.md
 [QC-UCD-001]: ../../../framework/qc/artifacts/qc-use-case-diagram.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,68 @@
 # RC-005: Review of US-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-005 |
 | CrossReference | [US-001], [QC-US-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [US-001]
 - Checklist used: [QC-US-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 | Follows INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable) | Pass | INVEST Check section confirms the six properties and states one dependency exception. |
 | 2 | Written in "As a / I want / So that" form | Pass | All five stories use `As a / I want / so that`. |
 | 3 | Clear, testable acceptance criteria are included | Pass | Every story has Given/When/Then acceptance criteria. |
 | 4 | Traceable to a use case or epic | Pass | Every story traces to a milestone and to UC-001. |
 | 5 | Story is sized to fit within a single iteration | Pass | Each story is one milestone, which fits one iteration. |
 | 6 | Story statement avoids technical implementation detail | Fail | Acceptance criteria name `words_to_learn.csv`, `ms-da.csv` and 3000 ms, which are assignment-mandated names and values rather than pure behaviour. |
 | 7 | Role named in the story matches an actor defined in the Use Case Diagram | Pass | The role `Learner` is the actor of UCD-001. |
 ## 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 US-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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.
 ## Action Items
 | Action | Owner | Due |
 | --- | --- | --- |
 | Criterion 6 (Optional) failed: Story statement avoids technical implementation detail; fix or accept the deferral | S01 | 2026-10-21 |
 | 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 |
 ---
 [US-001]: ../../../docs/user-stories.md
 [QC-US-001]: ../../../framework/qc/artifacts/qc-user-story.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,72 @@
 # RC-006: Review of UC-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-006 |
 | 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 | [c3fbcbc] |
 ---
 ## 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 7 numbered steps. |
 | 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 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. |
 | 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 | en` and `Domain | it`; neither is a placeholder. |
 | 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.
 ## 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 |
 ---
 [UC-001]: ../../../docs/uc-001/uc.md
 [QC-UC-001]: ../../../framework/qc/artifacts/qc-use-case.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,67 @@
 # RC-007: Review of DM-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-007 |
 | CrossReference | [DM-001], [QC-DM-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [DM-001]
 - Checklist used: [QC-DM-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 | Uses ubiquitous/business language throughout; no technical or implementation jargon (e.g. no "table", "class", "pointer") | Pass | Concepts are Flash Card, Word List, Words To Learn and Study Session; no table or class names. |
 | 2 | Multiplicities on associations are correct and complete (e.g. `1..*`, `0..1`) | Pass | Association table gives both multiplicities for all 5 associations. |
 | 3 | No operation/method signatures shown — attributes and associations only | Pass | The diagram has attributes and associations only. |
 | 4 | Associations are named with an unambiguous reading direction | Pass | Every association is named with a reading direction (`holds`, `works through`). |
 | 5 | Generalization/specialization used correctly, reflecting true "is-a" relationships, not misused for code reuse | Pass | Generalization table says none exists, and why. |
 | 6 | Every concept traces to a noun phrase found in the use cases or glossary | Pass | Concept table gives a source noun phrase in UC-001 for every concept. |
 | 7 | Attributes are simple domain data (no foreign-key-like references or object pointers modeled as attributes) | Pass | Attributes are plain data (word, translation, first language, card shown). |
 ## 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 DM-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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.
 ## 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 |
 ---
 [DM-001]: ../../../docs/domain-model.md
 [QC-DM-001]: ../../../framework/qc/artifacts/qc-domain-model.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,67 @@
 # RC-008: Review of SSD-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-008 |
 | CrossReference | [SSD-001], [QC-SSD-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [SSD-001]
 - Checklist used: [QC-SSD-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 | Input/output messages match the corresponding Use Case's main success scenario step-for-step | Pass | System Operations table maps each message to steps of the main success scenario (1 to 7); the timer step is the one stated deviation. |
 | 2 | Actor and System are treated strictly as black boxes (system shown as `:System`) | Pass | The system is `:System`; no internal object appears. |
 | 3 | Object creation/destruction of the System instance handled explicitly where relevant | Pass | Lifecycle Notes state that the system lives for one run. |
 | 4 | Return values are shown for operations that produce one, using dashed return arrows | Pass | Dashed return arrows are drawn for `startStudySession`, the turn-over, `markKnown` and `markUnknown`. |
 | 5 | Alternate/exceptional flows are represented separately (or explicitly out of scope noted) | Pass | The Alternate Flows section states the extensions that add no operation and that they are out of scope. |
 | 6 | Message names are verb phrases consistent with the use case's system responsibilities | Pass | `startStudySession`, `markKnown` and `markUnknown` are verb phrases. |
 | 7 | Diagram references the specific Use Case (name and ID) it depicts | Pass | Source Use Case section names UC-001 and the scenario. |
 ## 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 SSD-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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.
 ## 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 |
 ---
 [SSD-001]: ../../../docs/uc-001/ssd.md
 [QC-SSD-001]: ../../../framework/qc/artifacts/qc-ssd.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,51 @@
 # RC-009: Review of OC-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-009 |
 | CrossReference | [OC-001], [QC-OC-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [OC-001]
 - Checklist used: [QC-OC-001]
 - Scope: full review
 - Language and domain: n/a (technical type)
 - Language reviewer: none
 - Mode: autonomous, not independent (reviewer is `AI as stand-in for S01`)
 ## Checklist Results
 | # | Criterion | Status | Evidence/Notes |
 | --- | --- | --- | --- |
 | 1 | Method signature is complete: operation name, parameter types, and return type | Pass | Each contract gives name, parameter list and return type (`startStudySession(): CardDto | None`). |
 | 2 | Preconditions explicitly list required state before execution | Pass | Preconditions are listed per contract. |
 | 3 | Postconditions explicitly describe resulting state using Larman's "instance created/associated/attribute modified" style | Pass | Postconditions use created / associated / destroyed / attribute set wording. |
 | 4 | Exceptions and error conditions are documented, including the triggering precondition failure | Pass | Each contract has an Exceptions table with the failing precondition. |
 | 5 | Operation is explicitly traceable to a single SSD message | Pass | Each contract traces to exactly one SSD message; the timer step has none and says so. |
 | 6 | Contract avoids specifying implementation/algorithmic details (declarative, not procedural) | Pass | Postconditions are declarative. |
 | 7 | Cross-references the Domain Model classes/associations affected by pre/postconditions | Pass | Domain Model concepts and IT terms are cited per contract. |
 ## Overall Verdict
 Go — every Mandatory criterion passes. Reviewed by AI as stand-in for S01; not independent of the author.
 ## Action Items
 | Action | Owner | Due |
 | --- | --- | --- |
 | none | - | - |
 ---
 [OC-001]: ../../../docs/uc-001/oc.md
 [QC-OC-001]: ../../../framework/qc/artifacts/qc-operation-contract.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,52 @@
 # RC-010: Review of SD-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-010 |
 | CrossReference | [SD-001], [QC-SD-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [SD-001]
 - Checklist used: [QC-SD-001]
 - Scope: full review
 - Language and domain: n/a (technical type)
 - Language reviewer: none
 - Mode: autonomous, not independent (reviewer is `AI as stand-in for S01`)
 ## Checklist Results
 | # | Criterion | Status | Evidence/Notes |
 | --- | --- | --- | --- |
 | 1 | Message passing strictly follows UML sync/async/return arrow syntax | Pass | Calls are solid arrows with dashed returns. |
 | 2 | GRASP/GoF patterns applied and explicitly annotated where used (e.g. Controller, Observer, Mediator, Factory) | Pass | Each sequence has a Pattern Annotations table (Creator, Information Expert, Null Object, MVVM, Repository). |
 | 3 | Lifelines show activation bars matching actual processing time/call nesting | Pass | Activations are drawn for the session and the view model. |
 | 4 | Object creation and destruction shown with correct UML notation (`create`/`destroy` messages, X on lifeline) | Pass | `create` is used for `Deck` and `StudySession`; no object is destroyed during the program's life and that is stated by omission, the process ends. |
 | 5 | Diagram realizes the postconditions of a specific Operation Contract | Pass | Each sequence has a Postcondition Coverage table for its contract in OC-001. |
 | 6 | Responsibility assignment favors low coupling/high cohesion (no god-object receiving all messages) | Pass | Responsibility Check notes state that no object receives all messages. |
 | 7 | Loop, alt, and opt combined fragments used correctly for conditional/repeated behavior | Pass | `alt` and `opt` fragments are used for the progress file and the empty deck. |
 | 8 | Each exception of the realized Operation Contract is shown as an `alt` or `opt` fragment, or its absence is justified | Fail | The exceptions of OC-001 (missing file, malformed file) are raised before the sequence starts and are not drawn as `alt` fragments; 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.
 ## Action Items
 | Action | Owner | Due |
 | --- | --- | --- |
 | Criterion 8 (Optional) failed: Each exception of the realized Operation Contract is shown as an `alt` or `opt` fragment, ; fix or accept the deferral | S01 | 2026-10-21 |
 ---
 [SD-001]: ../../../docs/uc-001/sd.md
 [QC-SD-001]: ../../../framework/qc/artifacts/qc-sequence-diagram.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,53 @@
 # RC-011: Review of DCD-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-011 |
 | CrossReference | [DCD-001], [QC-DCD-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [DCD-001]
 - Checklist used: [QC-DCD-001]
 - Scope: full review
 - Language and domain: n/a (technical type)
 - Language reviewer: none
 - Mode: autonomous, not independent (reviewer is `AI as stand-in for S01`)
 ## Checklist Results
 | # | Criterion | Status | Evidence/Notes |
 | --- | --- | --- | --- |
 | 1 | SOLID principles applied; no god classes with excessive responsibilities | Pass | Each class has one responsibility (Class Table); view, view model, session, deck and adapters are separate. |
 | 2 | Visibility markers correct and consistent (`+` public, `-` private, `#` protected) | Pass | Visibility markers are on all members. |
 | 3 | Relationships correctly distinguished: Association vs Aggregation vs Composition vs Dependency | Pass | Composition (Vocabulary and Card), aggregation (Deck), association, dependency and realization are distinguished. |
 | 4 | Multiplicities and navigability specified on all associations | Pass | Multiplicities are on the associations; dependencies are directed. |
 | 5 | Applied design patterns are annotated explicitly (e.g. Singleton, Factory, Strategy) | Pass | Pattern Annotations table lists Repository, Ports and adapters, Null Object, MVVM, Composition root. |
 | 6 | Method signatures are traceable to Operation Contracts and/or design Sequence Diagrams | Pass | Method Traceability table maps every operation to OC-001 and SD-001 (the timer operation to SSD-001). |
 | 7 | Class names and structure remain consistent with the Domain Model concepts they refine | Pass | The Class Table has a `Refines` column; names match the dictionary's IT terms. |
 | 8 | No circular dependencies between classes/packages unless explicitly justified | Pass | Dependency Check states there are no cycles. |
 | 9 | Dependencies between classes and packages point inward: domain classes do not depend on infrastructure, delivery or framework classes | Pass | Domain imports nothing; infrastructure and presentation point inward (Dependency Check). |
 ## Overall Verdict
 Go — every Mandatory criterion passes. Reviewed by AI as stand-in for S01; not independent of the author.
 ## Action Items
 | Action | Owner | Due |
 | --- | --- | --- |
 | none | - | - |
 ---
 [DCD-001]: ../../../docs/dcd.md
 [QC-DCD-001]: ../../../framework/qc/artifacts/qc-dcd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,67 @@
 # RC-012: Review of DICT-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-012 |
 | CrossReference | [DICT-001], [QC-DICT-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [DICT-001]
 - Checklist used: [QC-DICT-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 | Every row has a PO term, its language, an IT term and a definition | Pass | All 7 rows have PO term, language, IT term and definition. |
 | 2 | Each PO term maps to exactly one IT term and the reverse (no synonyms) | Pass | One IT term per PO term; no synonym appears. |
 | 3 | Every Domain Model concept has a row, and the Domain Model uses its PO term | Pass | The 4 concepts of DM-001 have a row and DM-001 uses the PO term. |
 | 4 | The Operation Contracts, Sequence Diagrams, Design Class Diagrams and ERD use the IT term, not the PO term | Pass | DCD-001, OC-001 and SD-001 use `Card`, `Vocabulary`, `Deck`, `StudySession`. |
 | 5 | Definitions are written in the PO language and are one sentence | Pass | Definitions are one English sentence each. |
 | 6 | "Used as PO term in" and "Used as IT term in" name artifact types that exist in the project | Pass | Artifact types named in both columns exist in the project. |
 | 7 | The dictionary's `Language` and `Domain` rows, and the language of every row, match the PO language and domain in the project registry | Pass | `Language | en` and `Domain | it` match the registry; every row says `en`. |
 ## 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 DICT-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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.
 ## 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 |
 ---
 [DICT-001]: ../../../docs/dictionary.md
 [QC-DICT-001]: ../../../framework/qc/artifacts/qc-dictionary.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,55 @@
 # RC-013: Review of ADR-0001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-013 |
 | CrossReference | [ADR-0001], [QC-ADR-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [ADR-0001]
 - Checklist used: [QC-ADR-001]
 - Scope: full review
 - Language and domain: n/a (technical type)
 - Language reviewer: none
 - Mode: autonomous, not independent (reviewer is `AI as stand-in for S01`)
 ## Checklist Results
 | # | Criterion | Status | Evidence/Notes |
 | --- | --- | --- | --- |
 | 1 | The ID (`ADR-NNNN`, 4-digit) matches the filename number and is unique and sequential | Pass | ID `ADR-0001` matches the file name number. |
 | 2 | Context states the problem, the forces (cost, risk, constraints) and the options evaluated | Pass | Context states the problem, the stakeholders' forces and three options. |
 | 3 | At least two options were considered, or the absence of alternatives is justified | Pass | Three options were considered. |
 | 4 | Decision is stated in one or two unhedged sentences and matches one of the evaluated options | Pass | Decision is stated plainly and is option 2. |
 | 5 | Consequences list both Positive and Negative outcomes | Pass | Consequences have Positive and Negative lists. |
 | 6 | Quality-attribute impacts (performance, security, portability, etc.) are named where the decision affects them | Pass | Portability, reliability (no network needed) and maintainability are named. |
 | 7 | Affected Artifacts are listed as links, and each is also in CrossReference | Pass | Affected Artifacts BC-001 and SA-001 are listed and in CrossReference. |
 | 8 | Status changes are recorded as new Version History rows with a Change summary and Commit link; retained rows are never rewritten | Pass | First version; no status change yet. |
 | 9 | A superseded or deprecated ADR names its successor, and the successor links back | N-A | Not superseded or deprecated. |
 | 10 | Written in business or technical language of the domain, with no unexplained abbreviations | Pass | Written in plain technical English; `gTTS`, `playsound` are product names. |
 | 11 | Status is one of `Proposed`, `Accepted`, `Rejected`, `Deprecated` or `Superseded by ADR-NNNN`, and every Version History row uses only these | Pass | Status `Proposed` before this review; uses an allowed value. |
 ## Overall Verdict
 Go — every Mandatory criterion passes. Reviewed by AI as stand-in for S01; not independent of the author.
 ## Action Items
 | Action | Owner | Due |
 | --- | --- | --- |
 | none | - | - |
 ---
 [ADR-0001]: ../../../docs/adr/adr-0001-standard-library-and-optional-speech.md
 [QC-ADR-001]: ../../../framework/qc/artifacts/qc-adr.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,55 @@
 # RC-014: Review of ADR-0002
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-014 |
 | CrossReference | [ADR-0002], [QC-ADR-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [ADR-0002]
 - Checklist used: [QC-ADR-001]
 - Scope: full review
 - Language and domain: n/a (technical type)
 - Language reviewer: none
 - Mode: autonomous, not independent (reviewer is `AI as stand-in for S01`)
 ## Checklist Results
 | # | Criterion | Status | Evidence/Notes |
 | --- | --- | --- | --- |
 | 1 | The ID (`ADR-NNNN`, 4-digit) matches the filename number and is unique and sequential | Pass | ID `ADR-0002` matches the file name number. |
 | 2 | Context states the problem, the forces (cost, risk, constraints) and the options evaluated | Pass | Context states the problem, the forces and three options. |
 | 3 | At least two options were considered, or the absence of alternatives is justified | Pass | Three options were considered. |
 | 4 | Decision is stated in one or two unhedged sentences and matches one of the evaluated options | Pass | Decision names option 2 in two sentences. |
 | 5 | Consequences list both Positive and Negative outcomes | Pass | Consequences have Positive and Negative lists. |
 | 6 | Quality-attribute impacts (performance, security, portability, etc.) are named where the decision affects them | Pass | Testability and maintainability are named. |
 | 7 | Affected Artifacts are listed as links, and each is also in CrossReference | Pass | Affected Artifacts DM-001, DCD-001 and BC-001 are listed and in CrossReference. |
 | 8 | Status changes are recorded as new Version History rows with a Change summary and Commit link; retained rows are never rewritten | Pass | First version; no status change yet. |
 | 9 | A superseded or deprecated ADR names its successor, and the successor links back | N-A | Not superseded or deprecated. |
 | 10 | Written in business or technical language of the domain, with no unexplained abbreviations | Fail | MVVM and DTO are used without being spelled out; Optional, deferred. |
 | 11 | Status is one of `Proposed`, `Accepted`, `Rejected`, `Deprecated` or `Superseded by ADR-NNNN`, and every Version History row uses only these | Pass | Status `Proposed` before this review; uses an allowed value. |
 ## 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.
 ## Action Items
 | Action | Owner | Due |
 | --- | --- | --- |
 | Criterion 10 (Optional) failed: Written in business or technical language of the domain, with no unexplained abbreviations; fix or accept the deferral | S01 | 2026-10-21 |
 ---
 [ADR-0002]: ../../../docs/adr/adr-0002-clean-architecture-and-mvvm.md
 [QC-ADR-001]: ../../../framework/qc/artifacts/qc-adr.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,55 @@
 # RC-015: Review of ADR-0003
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-015 |
 | CrossReference | [ADR-0003], [QC-ADR-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [ADR-0003]
 - Checklist used: [QC-ADR-001]
 - Scope: full review
 - Language and domain: n/a (technical type)
 - Language reviewer: none
 - Mode: autonomous, not independent (reviewer is `AI as stand-in for S01`)
 ## Checklist Results
 | # | Criterion | Status | Evidence/Notes |
 | --- | --- | --- | --- |
 | 1 | The ID (`ADR-NNNN`, 4-digit) matches the filename number and is unique and sequential | Pass | ID `ADR-0003` matches the file name number. |
 | 2 | Context states the problem, the forces (cost, risk, constraints) and the options evaluated | Pass | Context states the problem and two options. |
 | 3 | At least two options were considered, or the absence of alternatives is justified | Pass | Two options were considered. |
 | 4 | Decision is stated in one or two unhedged sentences and matches one of the evaluated options | Pass | Decision names option 2 and lists the skipped types with reasons. |
 | 5 | Consequences list both Positive and Negative outcomes | Pass | Consequences have Positive and Negative lists. |
 | 6 | Quality-attribute impacts (performance, security, portability, etc.) are named where the decision affects them | N-A | No quality attribute is affected by skipping documents. |
 | 7 | Affected Artifacts are listed as links, and each is also in CrossReference | Pass | Affected Artifact BC-001 is listed and in CrossReference. |
 | 8 | Status changes are recorded as new Version History rows with a Change summary and Commit link; retained rows are never rewritten | Pass | First version; no status change yet. |
 | 9 | A superseded or deprecated ADR names its successor, and the successor links back | N-A | Not superseded or deprecated. |
 | 10 | Written in business or technical language of the domain, with no unexplained abbreviations | Pass | Written in plain English; type codes are the catalog's. |
 | 11 | Status is one of `Proposed`, `Accepted`, `Rejected`, `Deprecated` or `Superseded by ADR-NNNN`, and every Version History row uses only these | Pass | Status `Proposed` before this review; uses an allowed value. |
 ## Overall Verdict
 Go — every Mandatory criterion passes. Reviewed by AI as stand-in for S01; not independent of the author.
 ## Action Items
 | Action | Owner | Due |
 | --- | --- | --- |
 | none | - | - |
 ---
 [ADR-0003]: ../../../docs/adr/adr-0003-skipped-artifact-types.md
 [QC-ADR-001]: ../../../framework/qc/artifacts/qc-adr.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,66 @@
 # RC-016: Review of MIL-001
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-016 |
 | CrossReference | [MIL-001], [QC-MIL-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [MIL-001]
 - Checklist used: [QC-MIL-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 | A concrete deliverable is defined for every gate | Pass | A concrete Deliverable section names the output evaluated at the gate. |
 | 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | The Go / No-Go table has numbered criteria, each with an observable Go and No-Go. |
 | 3 | Dependencies on other milestones are explicitly mapped | Pass | Dependencies table names the milestone or documents it needs. |
 | 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | Traceability table maps to Business Case objectives and the user story. |
 | 5 | Milestone owner and approving reviewer are identified | Pass | Ownership table names S01 as owner and approving reviewer. |
 | 6 | Milestone has a defined target date consistent with project constraints | Pass | Target Date lies inside the 2026-10-14 to 2026-10-21 window of the Business Case. |
 ## 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 MIL-001 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [MIL-001]: ../../../docs/milestones/mil-001-foundation.md
 [QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,66 @@
 # RC-017: Review of MIL-002
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-017 |
 | CrossReference | [MIL-002], [QC-MIL-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [MIL-002]
 - Checklist used: [QC-MIL-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 | A concrete deliverable is defined for every gate | Pass | A concrete Deliverable section names the output evaluated at the gate. |
 | 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | The Go / No-Go table has numbered criteria, each with an observable Go and No-Go. |
 | 3 | Dependencies on other milestones are explicitly mapped | Pass | Dependencies table names the milestone or documents it needs. |
 | 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | Traceability table maps to Business Case objectives and the user story. |
 | 5 | Milestone owner and approving reviewer are identified | Pass | Ownership table names S01 as owner and approving reviewer. |
 | 6 | Milestone has a defined target date consistent with project constraints | Pass | Target Date lies inside the 2026-10-14 to 2026-10-21 window of the Business Case. |
 ## 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 MIL-002 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [MIL-002]: ../../../docs/milestones/mil-002-step1-user-interface.md
 [QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,66 @@
 # RC-018: Review of MIL-003
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-018 |
 | CrossReference | [MIL-003], [QC-MIL-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [MIL-003]
 - Checklist used: [QC-MIL-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 | A concrete deliverable is defined for every gate | Pass | A concrete Deliverable section names the output evaluated at the gate. |
 | 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | The Go / No-Go table has numbered criteria, each with an observable Go and No-Go. |
 | 3 | Dependencies on other milestones are explicitly mapped | Pass | Dependencies table names the milestone or documents it needs. |
 | 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | Traceability table maps to Business Case objectives and the user story. |
 | 5 | Milestone owner and approving reviewer are identified | Pass | Ownership table names S01 as owner and approving reviewer. |
 | 6 | Milestone has a defined target date consistent with project constraints | Pass | Target Date lies inside the 2026-10-14 to 2026-10-21 window of the Business Case. |
 ## 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 MIL-003 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [MIL-003]: ../../../docs/milestones/mil-003-step2-new-flash-cards.md
 [QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,66 @@
 # RC-019: Review of MIL-004
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-019 |
 | CrossReference | [MIL-004], [QC-MIL-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [MIL-004]
 - Checklist used: [QC-MIL-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 | A concrete deliverable is defined for every gate | Pass | A concrete Deliverable section names the output evaluated at the gate. |
 | 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | The Go / No-Go table has numbered criteria, each with an observable Go and No-Go. |
 | 3 | Dependencies on other milestones are explicitly mapped | Pass | Dependencies table names the milestone or documents it needs. |
 | 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | Traceability table maps to Business Case objectives and the user story. |
 | 5 | Milestone owner and approving reviewer are identified | Pass | Ownership table names S01 as owner and approving reviewer. |
 | 6 | Milestone has a defined target date consistent with project constraints | Pass | Target Date lies inside the 2026-10-14 to 2026-10-21 window of the Business Case. |
 ## 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 MIL-004 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [MIL-004]: ../../../docs/milestones/mil-004-step3-flip-cards.md
 [QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,66 @@
 # RC-020: Review of MIL-005
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-020 |
 | CrossReference | [MIL-005], [QC-MIL-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [MIL-005]
 - Checklist used: [QC-MIL-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 | A concrete deliverable is defined for every gate | Pass | A concrete Deliverable section names the output evaluated at the gate. |
 | 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | The Go / No-Go table has numbered criteria, each with an observable Go and No-Go. |
 | 3 | Dependencies on other milestones are explicitly mapped | Pass | Dependencies table names the milestone or documents it needs. |
 | 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | Traceability table maps to Business Case objectives and the user story. |
 | 5 | Milestone owner and approving reviewer are identified | Pass | Ownership table names S01 as owner and approving reviewer. |
 | 6 | Milestone has a defined target date consistent with project constraints | Pass | Target Date lies inside the 2026-10-14 to 2026-10-21 window of the Business Case. |
 ## 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 MIL-005 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [MIL-005]: ../../../docs/milestones/mil-005-step4-save-progress.md
 [QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,66 @@
 # RC-021: Review of MIL-006
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-021 |
 | CrossReference | [MIL-006], [QC-MIL-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [MIL-006]
 - Checklist used: [QC-MIL-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 | A concrete deliverable is defined for every gate | Pass | A concrete Deliverable section names the output evaluated at the gate. |
 | 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | The Go / No-Go table has numbered criteria, each with an observable Go and No-Go. |
 | 3 | Dependencies on other milestones are explicitly mapped | Pass | Dependencies table names the milestone or documents it needs. |
 | 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | Traceability table maps to Business Case objectives and the user story. |
 | 5 | Milestone owner and approving reviewer are identified | Pass | Ownership table names S01 as owner and approving reviewer. |
 | 6 | Milestone has a defined target date consistent with project constraints | Pass | Target Date lies inside the 2026-10-14 to 2026-10-21 window of the Business Case. |
 ## 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 MIL-006 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [MIL-006]: ../../../docs/milestones/mil-006-malay-speech.md
 [QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,66 @@
 # RC-022: Review of MIL-007
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | RC-022 |
 | CrossReference | [MIL-007], [QC-MIL-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 | [c3fbcbc] |
 ---
 ## Artifact Under Review
 - Instance reviewed: [MIL-007]
 - Checklist used: [QC-MIL-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 | A concrete deliverable is defined for every gate | Pass | A concrete Deliverable section names the output evaluated at the gate. |
 | 2 | Explicit Go/No-Go criteria are stated for each gate | Pass | The Go / No-Go table has numbered criteria, each with an observable Go and No-Go. |
 | 3 | Dependencies on other milestones are explicitly mapped | Pass | Dependencies table names the milestone or documents it needs. |
 | 4 | Each milestone is traceable to a Business Case objective or KPI | Pass | Traceability table maps to Business Case objectives and the user story. |
 | 5 | Milestone owner and approving reviewer are identified | Pass | Ownership table names S01 as owner and approving reviewer. |
 | 6 | Milestone has a defined target date consistent with project constraints | Pass | Target Date lies inside the 2026-10-14 to 2026-10-21 window of the Business Case. |
 ## 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 MIL-007 has `Language | en` and `Domain | it`; neither is a placeholder. |
 | 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 Executive 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.
 ## 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 |
 ---
 [MIL-007]: ../../../docs/milestones/mil-007-documentation-and-publication.md
 [QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
 [QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,101 @@
 # Traceability Matrix: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | TM-001 |
 | CrossReference | [BC-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Purpose
 Tracks backward/forward links between artifact instances so that the Business Case's
 cross-artifact traceability success criterion is measurable. A row is added or
 updated whenever an artifact instance is created or reviewed.
 ## Traceability Table
 | Artifact Instance | Type | Language | Domain | Upstream (Backward Link) | Downstream (Forward Link) | Last Reviewed (RC-ID) |
 | --- | --- | --- | --- | --- | --- | --- |
 | BC-001 | Business Case | en | it | - | SA-001, PP-001 | [RC-001] |
 | SA-001 | Stakeholder Analysis | en | it | BC-001 | PP-001, DICT-001 | [RC-002] |
 | PP-001 | Project Plan | en | it | BC-001, SA-001 | MIL-001 to MIL-007 | [RC-003] |
 | UCD-001 | Use Case Diagram | en | it | SA-001, BC-001 | US-001, UC-001 | [RC-004] |
 | US-001 | User Story | en | it | UCD-001, BC-001 | MIL-002 to MIL-006 | [RC-005] |
 | UC-001 | Use Case | en | it | UCD-001, US-001 | DM-001, SSD-001 | [RC-006] |
 | DM-001 | Domain Model | en | it | UC-001 | SSD-001, DICT-001, DCD-001 | [RC-007] |
 | SSD-001 | System Sequence Diagram | en | it | UC-001, DM-001 | DCD-001 | [RC-008] |
 | OC-001 | Operation Contract | - | - | SSD-001, DM-001 | SD-001 | [RC-009] |
 | SD-001 | Sequence Diagram | - | - | OC-001 | DCD-001 | [RC-010] |
 | DCD-001 | Design Class Diagram | - | - | DM-001, SD-001, DICT-001 | src/flash_card | [RC-011] |
 | DICT-001 | Domain Dictionary | en | it | BC-001, SA-001, DM-001 | DCD-001 | [RC-012] |
 | ADR-0001 | Architecture Decision Record | - | - | BC-001 | MIL-001, MIL-003, MIL-006 | [RC-013] |
 | ADR-0002 | Architecture Decision Record | - | - | BC-001 | DCD-001 | [RC-014] |
 | ADR-0003 | Architecture Decision Record | - | - | BC-001 | - | [RC-015] |
 | MIL-001 | Milestone / Gateway | en | it | BC-001, PP-001 | tasks of MIL-001 | [RC-016] |
 | MIL-002 | Milestone / Gateway | en | it | BC-001, PP-001 | tasks of MIL-002 | [RC-017] |
 | MIL-003 | Milestone / Gateway | en | it | BC-001, PP-001 | tasks of MIL-003 | [RC-018] |
 | MIL-004 | Milestone / Gateway | en | it | BC-001, PP-001 | tasks of MIL-004 | [RC-019] |
 | MIL-005 | Milestone / Gateway | en | it | BC-001, PP-001 | tasks of MIL-005 | [RC-020] |
 | MIL-006 | Milestone / Gateway | en | it | BC-001, PP-001 | tasks of MIL-006 | [RC-021] |
 | MIL-007 | Milestone / Gateway | en | it | BC-001, PP-001 | tasks of MIL-007 | [RC-022] |
 ## Coverage Notes
 - `-` in Upstream means foundational; in Downstream it means nothing is built on it yet; in Last Reviewed it means no `RC-*` exists yet. Every row has a review record from the baseline review (autonomous mode, AI as stand-in for S01).
 - Types not created for this project, and why: ADR-0003.
 - Source code (`PY`) is added as `src/` is reviewed, one row per milestone.
 ---
 [BC-001]: ../business-case.md
 [SA-001]: ../stakeholder-analysis.md
 [PP-001]: ../project-plan.md
 [UCD-001]: ../use-case-diagram.md
 [US-001]: ../user-stories.md
 [UC-001]: ../uc-001/uc.md
 [DM-001]: ../domain-model.md
 [SSD-001]: ../uc-001/ssd.md
 [OC-001]: ../uc-001/oc.md
 [SD-001]: ../uc-001/sd.md
 [DCD-001]: ../dcd.md
 [DICT-001]: ../dictionary.md
 [ADR-0001]: ../adr/adr-0001-standard-library-and-optional-speech.md
 [ADR-0002]: ../adr/adr-0002-clean-architecture-and-mvvm.md
 [ADR-0003]: ../adr/adr-0003-skipped-artifact-types.md
 [MIL-001]: ../milestones/mil-001-foundation.md
 [MIL-002]: ../milestones/mil-002-step1-user-interface.md
 [MIL-003]: ../milestones/mil-003-step2-new-flash-cards.md
 [MIL-004]: ../milestones/mil-004-step3-flip-cards.md
 [MIL-005]: ../milestones/mil-005-step4-save-progress.md
 [MIL-006]: ../milestones/mil-006-malay-speech.md
 [MIL-007]: ../milestones/mil-007-documentation-and-publication.md
 [RC-001]: ./reviews/rc-001-business-case.md
 [RC-002]: ./reviews/rc-002-stakeholder-analysis.md
 [RC-003]: ./reviews/rc-003-project-plan.md
 [RC-004]: ./reviews/rc-004-use-case-diagram.md
 [RC-005]: ./reviews/rc-005-user-stories.md
 [RC-006]: ./reviews/rc-006-use-case.md
 [RC-007]: ./reviews/rc-007-domain-model.md
 [RC-008]: ./reviews/rc-008-system-sequence-diagram.md
 [RC-009]: ./reviews/rc-009-operation-contracts.md
 [RC-010]: ./reviews/rc-010-sequence-diagrams.md
 [RC-011]: ./reviews/rc-011-design-class-diagram.md
 [RC-012]: ./reviews/rc-012-domain-dictionary.md
 [RC-013]: ./reviews/rc-013-adr-0001.md
 [RC-014]: ./reviews/rc-014-adr-0002.md
 [RC-015]: ./reviews/rc-015-adr-0003.md
 [RC-016]: ./reviews/rc-016-mil-001.md
 [RC-017]: ./reviews/rc-017-mil-002.md
 [RC-018]: ./reviews/rc-018-mil-003.md
 [RC-019]: ./reviews/rc-019-mil-004.md
 [RC-020]: ./reviews/rc-020-mil-005.md
 [RC-021]: ./reviews/rc-021-mil-006.md
 [RC-022]: ./reviews/rc-022-mil-007.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,84 @@
 # Stakeholder Analysis: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | SA-001 |
 | CrossReference | [BC-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 | [c3fbcbc] |
 ---
 ## Purpose
 This analysis names the people who influence the flash card project or are affected by it, so that owners, reviewers and readers can be cited by a stable ID in every other document. It follows the power and interest grid: each stakeholder is placed in one quadrant, and the quadrant sets how closely the project engages that stakeholder.
 ## Stakeholder Summary Table
 | ID | Name | Role/Title | Organization | Power Level | Interest Level | Quadrant | Primary Concern (Business Language) |
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | S01 | Jens Tirsvad Nielsen, course participant | Product Owner, developer and reviewer | Self (Tirsvad) | HIGH | HIGH | Manage Closely | Finish the assignment with a working, understood and documented solution |
 | S02 | Udemy coursists | Fellow participants of the 100 Days of Code course | Udemy course community | LOW | HIGH | Keep Informed | Readable, runnable code that keeps the assignment's function names, and instructions to run it, so that solutions can be shared and compared |
 | S03 | GitHub viewers | Visitors who browse the repository for ideas | Public | LOW | LOW | Monitor | A clear repository description, topics and README, and no runtime dependencies to install |
 ## Power/Interest Classification Rationale
 - **Manage Closely (S01):** S01 decides scope, writes the code and accepts the result, so both power and interest are high. S01 is the only stakeholder who can accept or reject a milestone.
 - **Keep Informed (S02):** S02 cannot change the project, so power is low. They share code and compare solutions, so interest is high; the project informs them through a README that explains how to run the program and tests, and through function names they recognise from the assignment.
 - **Monitor (S03):** S03 arrive occasionally and have no stake beyond finding the repository useful, so power and interest are both low. The project serves them with a repository description, topics and a README, and does not require them to install runtime dependencies.
 S02 and S03 are classified by S01 as Product Owner; neither can be interviewed, so the classification is an assumption recorded in BC-001.
 ## Primary Concerns and FURPS+ Mapping
 | ID | Concern | FURPS+ attribute |
 | --- | --- | --- |
 | S01 | The four assignment steps work and progress is saved | Functionality |
 | S01 | Work is tracked step by step, each step reviewed | Supportability (+ Process) |
 | S01 | Malay words are spoken, in Danish translation | Functionality |
 | S02 | Code is readable and runnable with the assignment's function names | Usability, Supportability |
 | S02 | Instructions to run the program and its tests | Usability |
 | S03 | Repository description, topics and README are clear | Usability |
 | S03 | No runtime dependencies to install | Supportability (+ Implementation) |
 ## Communication Requirements
 | ID | Channel | Frequency | Deliverable | Phase / Milestone |
 | --- | --- | --- | --- | --- |
 | S01 | Chat session and pull request review | Once per milestone | Pull request with the milestone's changes and review record | MIL-001 to MIL-007 |
 | S02 | README and wiki | Once, at the documentation milestone, then on change | Run and test instructions, assignment function names | MIL-007 |
 | S03 | Repository description, topics, README and wiki | Once, at the documentation milestone | Description, topics, README, screenshots | MIL-007 |
 ## Conflicting Interests and Mitigations
 | Conflict | Stakeholders | Mitigation |
 | --- | --- | --- |
 | S01 wants spoken Malay words (needs `gTTS` and `playsound`), S03 wants no runtime dependencies | S01, S03 | Speech is an optional extra (`pip install .[speech]`) behind a port; the core program uses the standard library only |
 | S01 wants clean architecture with layers, S02 wants code that is simple to read and compare with the assignment | S01, S02 | The assignment's function names (`next_card`, `flip_card`, `is_known`) are kept at the presentation layer, and the wiki maps each assignment step to the files that implement it |
 ## Traceability Analysis
 ### Business Goal Alignment
 | Stakeholder | Concern | Business Case objective |
 | --- | --- | --- |
 | S01 | Four assignment steps work, progress is saved | Objective 1 of [BC-001] |
 | S01 | Spoken Malay word, Danish translation | Objective 2 of [BC-001] |
 | S01 | Step-by-step tracking | Objective 5 of [BC-001] |
 | S02 | Readable, runnable code with assignment function names | Objectives 1 and 4 of [BC-001] |
 | S03 | Description, topics, README, no runtime dependencies | Objectives 3 and 4 of [BC-001] |
 ## Sign-Off
 Proposed by the author. Accepted when `RC-*` for SA-001 has the verdict Go; in autonomous mode by the AI as stand-in for S01, and open to challenge by S01 in the end-of-run summary.
 ---
 [BC-001]: ./business-case.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,99 @@
 # Operation Contracts: Study Flash Cards
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | OC-001 |
 | CrossReference | [SSD-001], [DM-001], [DICT-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 The turn-over of the card after 3000 ms is started by the system's own timer, not by a message from the Learner, so it has no contract; it is realized in [SD-001].
 ## Contract: startStudySession
 | Item | Value |
 | --- | --- |
 | Operation | `startStudySession(): CardDto \| None` |
 | Traces to | `startStudySession` in [SSD-001] |
 | Domain Model concepts | Study Session, Words To Learn, Word List, Flash Card ([DM-001]); IT terms `StudySession`, `Deck`, `Vocabulary`, `Card` ([DICT-001]) |
 **Preconditions**
 - A `Vocabulary` exists in the word list file.
 **Postconditions**
 - A `StudySession` instance was created.
 - A `Deck` instance was created and associated with the `StudySession`.
 - The `Deck` holds the cards of the progress file when it exists, otherwise a copy of the cards of the `Vocabulary`.
 - When the `Deck` is not empty, `StudySession.current_card` was set to a card of the `Deck` and a `CardDto` of it is returned; otherwise `current_card` is `None` and `None` is returned.
 **Exceptions**
 | Condition (failing precondition) | Outcome |
 | --- | --- |
 | The word list file does not exist | `VocabularyNotFoundError` is raised; no session is created |
 | The word list or progress file has no header of two cells, or a row with other than two cells | `VocabularyFormatError` is raised; no session is created and no file is changed |
 ## Contract: markKnown
 | Item | Value |
 | --- | --- |
 | Operation | `markKnown(): None` |
 | Traces to | `markKnown` in [SSD-001] |
 | Domain Model concepts | Study Session, Words To Learn, Flash Card ([DM-001]); IT terms `StudySession`, `Deck`, `Card` ([DICT-001]) |
 **Preconditions**
 - A `StudySession` exists and its `current_card` is not `None`.
 **Postconditions**
 - The `Card` of `current_card` was removed from the `Deck` (the association was destroyed).
 - The `Deck` was stored in the progress file.
 - `StudySession.current_card` was set to `None`.
 **Exceptions**
 | Condition (failing precondition) | Outcome |
 | --- | --- |
 | `current_card` is `None` (no card is shown) | Nothing is changed and nothing is stored |
 ## Contract: markUnknown
 | Item | Value |
 | --- | --- |
 | Operation | `markUnknown(): CardDto \| None` |
 | Traces to | `markUnknown` in [SSD-001] |
 | Domain Model concepts | Study Session, Words To Learn, Flash Card ([DM-001]); IT terms `StudySession`, `Deck`, `Card` ([DICT-001]) |
 **Preconditions**
 - A `StudySession` exists.
 **Postconditions**
 - `StudySession.current_card` was set to a card of the `Deck` that differs from the previous `current_card` when the `Deck` holds two or more cards, and a `CardDto` of it is returned.
 - When the `Deck` is empty, `current_card` is `None` and `None` is returned.
 - The `Deck` and the progress file are unchanged.
 - The Malay word of the new `current_card` was passed to the `SpeechPort`.
 **Exceptions**
 | Condition (failing precondition) | Outcome |
 | --- | --- |
 | The `Deck` is empty | `None` is returned; nothing is spoken |
 ---
 [SSD-001]: ./ssd.md
 [DM-001]: ../domain-model.md
 [DICT-001]: ../dictionary.md
 [SD-001]: ./sd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,171 @@
 # Sequence Diagrams: Study Flash Cards
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | SD-001 |
 | CrossReference | [OC-001], [DCD-001], [DICT-001] |
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [c3fbcbc] |
 ---
 ## Sequence: startStudySession
 **Realizes:** `startStudySession` in [OC-001]
 ### Diagram
 ```plantuml
@startuml
 participant "main : app" as M
 participant ":CsvVocabularyRepository" as VR
 participant ":CsvProgressRepository" as PR
 participant ":StudySession" as S
 participant ":Deck" as D
 participant ":SpeechPort" as SP
 M -> PR : load()
 PR --> M : deck | None
 alt deck is None
  M -> VR : load()
  VR --> M : vocabulary
  create D
  M -> D : from_vocabulary(vocabulary)
  D --> M : deck
 end
 create S
 M -> S : create(deck, progress, speech, choose)
 M -> S : next_card()
 activate S
 opt deck is not empty
  S -> D : draw(choose, exclude)
  D --> S : card
  S -> SP : speak(card.front, front_code)
 end
 S --> M : CardDto | None
 deactivate S
@enduml
 ```
 ### Pattern Annotations
 | Pattern (GRASP / GoF) | Applied to | Rationale |
 | --- | --- | --- |
 | Creator | `app.main` creates `StudySession` | It holds the adapters the session needs |
 | Information Expert | `Deck` draws and removes its own cards | It owns the list of cards |
 | Null Object | `NullSpeech` as `SpeechPort` | The session never tests for speech |
 ### Postcondition Coverage
 | Postcondition (from contract) | Satisfied by message |
 | --- | --- |
 | A `StudySession` instance was created | `create(deck, progress, speech, choose)` |
 | A `Deck` was created from the progress file or a copy of the `Vocabulary` | `PR.load()`, `alt` fragment, `from_vocabulary` |
 | `current_card` set and a `CardDto` returned, or `None` | `next_card()` with the `opt` fragment |
 ### Responsibility Check
 The session coordinates, the deck holds the cards, the repositories hold the file format; no object receives all messages.
 ## Sequence: markKnown
 **Realizes:** `markKnown` in [OC-001]
 ### Diagram
 ```plantuml
@startuml
 participant ":FlashCardView" as V
 participant ":FlashCardViewModel" as VM
 participant ":StudySession" as S
 participant ":Deck" as D
 participant ":CsvProgressRepository" as PR
 V -> VM : is_known()
 activate VM
 VM -> S : mark_known()
 activate S
 opt current_card is not None
  S -> D : remove(card)
  S -> PR : save(deck)
 end
 deactivate S
 VM -> S : next_card()
 S --> VM : CardDto | None
 VM --> V : side, language name, text
 deactivate VM
@enduml
 ```
 ### Pattern Annotations
 | Pattern (GRASP / GoF) | Applied to | Rationale |
 | --- | --- | --- |
 | MVVM | `FlashCardView`, `FlashCardViewModel` | The view raises the event and shows the result; the rule is behind the view model |
 | Repository | `CsvProgressRepository` | The session stores the deck through a port |
 ### Postcondition Coverage
 | Postcondition (from contract) | Satisfied by message |
 | --- | --- |
 | The card was removed from the `Deck` | `remove(card)` |
 | The `Deck` was stored | `save(deck)` |
 | `current_card` was set to `None` | `mark_known()` ends with no current card; `next_card()` then draws the next |
 ### Responsibility Check
 The view model only sequences two session calls and maps the result for the view.
 ## Sequence: markUnknown
 **Realizes:** `markUnknown` in [OC-001]
 ### Diagram
 ```plantuml
@startuml
 participant ":FlashCardView" as V
 participant ":FlashCardViewModel" as VM
 participant ":StudySession" as S
 participant ":Deck" as D
 participant ":SpeechPort" as SP
 V -> VM : next_card()
 VM -> S : next_card()
 activate S
 opt deck is not empty
  S -> D : draw(choose, exclude=current)
  D --> S : card
  S -> SP : speak(card.front, front_code)
 end
 S --> VM : CardDto | None
 deactivate S
 VM --> V : side, language name, text
@enduml
 ```
 ### Pattern Annotations
 | Pattern (GRASP / GoF) | Applied to | Rationale |
 | --- | --- | --- |
 | Information Expert | `Deck.draw` | The deck knows its cards |
 ### Postcondition Coverage
 | Postcondition (from contract) | Satisfied by message |
 | --- | --- |
 | A different card was chosen when two or more exist | `draw(choose, exclude=current)` |
 | Deck and file unchanged | no `remove` or `save` message |
 | The Malay word was passed to the `SpeechPort` | `speak(card.front, front_code)` |
 ### Responsibility Check
 Same as `markKnown`; the session is the only object that speaks and draws.
 ---
 [OC-001]: ./oc.md
 [DCD-001]: ../dcd.md
 [DICT-001]: ../dictionary.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,63 @@
 # System Sequence Diagram: Study Flash Cards
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | SSD-001 |
 | CrossReference | [UC-001], [DM-001], [OC-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 | [c3fbcbc] |
 ---
 ## Source Use Case
 Study Flash Cards ([UC-001]) — scenario: main success scenario, with the unknown button as one repetition.
 ## Diagram
 ```plantuml
@startuml
 actor Learner as L
 participant ":System" as S
 L -> S : startStudySession()
 S --> L : card (word, language name)
 ... 3000 ms pass, the system turns the card over ...
 S --> L : card (translation, language name)
 L -> S : markKnown()
 S --> L : next card (word, language name)
 L -> S : markUnknown()
 S --> L : next card (word, language name)
@enduml
 ```
 ## System Operations
 | Step | Message | Parameters | Return | Use case step |
 | --- | --- | --- | --- | --- |
 | 1 | startStudySession | none | card to show, or "nothing left to learn" | 1, 2, 3 |
 | 2 | (timer) turn the card over | none | the same card, translation side | 4 |
 | 3 | markKnown | none | next card, or "nothing left to learn" | 5, 6, 7 |
 | 4 | markUnknown | none | next card | 5a, 7 |
 The turn-over in step 2 is started by the system's own timer, not by a message from the Learner; it is shown as a return without a call, which is the one deviation from "every return answers a message".
 ## Alternate Flows
 The extensions 2a, 3a, 5b and 7a of [UC-001] add no system operation of their own (they are errors, speech and timer handling inside the three operations above); their behaviour is in [OC-001] as exceptions. They are out of scope of this diagram, which shows the main success scenario with `markUnknown` as the one alternate answer.
 ## Lifecycle Notes
 The system instance lives for one run of the program. The words to learn are created when the session starts and saved after each `markKnown`.
 ---
 [UC-001]: ./uc.md
 [DM-001]: ../domain-model.md
 [OC-001]: ./oc.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,78 @@
 # 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 | [c3fbcbc] |
 ---
 **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.
 ---
 [UCD-001]: ../use-case-diagram.md
 [US-001]: ../user-stories.md
 [SA-001]: ../stakeholder-analysis.md
 [DM-001]: ../domain-model.md
 [SSD-001]: ./ssd.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,38 @@
 # Wireframe: Study Flash Cards
 The Product Owner gave this screen in the first prompt (the course's target screenshot). The presentation layer implements it and does not redesign it. Source use case: [UC-001](./uc.md).
 ## Screen
 ```text
 +----------------------------------------------------------+   background  #B1DDC6
 |   padding 50 px                                          |
 |   +--------------------------------------------------+   |
 |   |                                                  |   |
 |   |                 Malay        (italic, 40 pt)     |   |   card image 800 x 526
 |   |                                                  |   |   card_front.png (white)
 |   |                 aku          (bold, 60 pt)       |   |   card_back.png  (green)
 |   |                                                  |   |
 |   +--------------------------------------------------+   |
 |        [ X unknown ]                  [ v known ]        |   buttons: wrong.png, right.png
 +----------------------------------------------------------+
 ```
 ## Layout
 | Element | Position | Details |
 | --- | --- | --- |
 | Window | whole | Title "Flashy", padding 50 px, background `#B1DDC6` |
 | Card | grid row 0, columns 0 and 1 (both) | `Canvas` 800 x 526, one image, two texts |
 | Language name | centre of card, y = 150 | Arial 40 italic |
 | Word | centre of card, y = 263 | Arial 60 bold |
 | Unknown button | grid row 1, column 0 | `wrong.png`, no border |
 | Known button | grid row 1, column 1 | `right.png`, no border |
 ## States
 | State | Card image | Language name | Word | Text colour |
 | --- | --- | --- | --- | --- |
 | Front (first 3000 ms) | `card_front.png` | Malay | the Malay word | black |
 | Back (after 3000 ms) | `card_back.png` | Danish | the Danish translation | white |
 | Finished | `card_front.png` | (empty) | "Nothing left to learn" | black |
@@ -0,0 +1,57 @@
 # Use Case Diagram: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | UCD-001 |
 | CrossReference | [SA-001], [BC-001], [US-001], [UC-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 | [c3fbcbc] |
 ---
 ## Purpose and Scope
 The system boundary is the flash card program: the window, the word list it reads, the progress file it writes and the optional spoken word. The Learner is the only actor. The git host, the course and the repository's readers are outside the boundary.
 ## Diagram
 ```plantuml
@startuml
 left to right direction
 actor "Learner" as L
 rectangle "Flash Card" <<System>> {
  usecase "Study Flash Cards" as UC1
 }
 L --> UC1
@enduml
 ```
 ## Actor Table
 | Actor | Stereotype | Stakeholder ID (SA) | Goals (use cases) |
 | --- | --- | --- | --- |
 | Learner | `<<Actor>>` | S01, S02 | Study Flash Cards |
 ## Use Case Table
 | Use Case | Actor(s) | Goal |
 | --- | --- | --- |
 | Study Flash Cards | Learner | Learn the words of a word list by seeing each card, checking its translation and keeping only the words not yet known |
 ## Relationships
 None. Hearing the Malay word is an extension flow of Study Flash Cards (see [UC-001]), not a use case of its own, because it has no goal apart from studying.
 ---
 [SA-001]: ./stakeholder-analysis.md
 [BC-001]: ./business-case.md
 [US-001]: ./user-stories.md
 [UC-001]: ./uc-001/uc.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3
@@ -0,0 +1,105 @@
 # User Stories: Flash Card
 ## Metadata
 | Key | Value |
 | --- | --- |
 | ID | US-001 |
 | CrossReference | [UCD-001], [BC-001], [UC-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006] |
 | 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 | [c3fbcbc] |
 ---
 ## Purpose and Scope
 These stories cover the epic "Study Flash Cards": the four steps of the course assignment (the window, new cards, flipping the cards, saving progress) and the spoken Malay word. Each story is delivered by one milestone. The wireframe the stories follow is in `docs/uc-001/wireframe.md`.
 ## Story List
 ### US-001.01 — See a flash card
 **As a** Learner, **I want** a window that shows one flash card with the language name, a word and two buttons (known and unknown), **so that** I can see what I am asked to learn.
 **Acceptance Criteria**
 - Given the program is started, when the window opens, then it shows a card with the language name above a word, a button for "I do not know it" under the left side and a button for "I know it" under the right side.
 - Given the window is open, when I look at the card, then the language name is in italics and the word is in bold, both centred on the card.
 | Traces to | Size | INVEST exceptions |
 | --- | --- | --- |
 | [MIL-002], [UC-001] | fits one iteration | none |
 ### US-001.02 — Get a new card
 **As a** Learner, **I want** a new random word every time I press a button, **so that** I do not meet the words in a fixed order.
 **Acceptance Criteria**
 - Given a card is shown, when I press the known button or the unknown button, then a different random word from the word list is shown.
 - Given the word list has one word, when I press a button, then that word is shown again and the program does not fail.
 | Traces to | Size | INVEST exceptions |
 | --- | --- | --- |
 | [MIL-003], [UC-001] | fits one iteration | none |
 ### US-001.03 — See the translation
 **As a** Learner, **I want** the card to turn over after three seconds and show the translation, **so that** I can check my answer without asking for it.
 **Acceptance Criteria**
 - Given a new card is shown, when 3000 ms have passed, then the card shows the back image, the language name of the translation, the translation, and the text is white.
 - Given a card was shown less than 3000 ms ago, when I press a button, then the earlier timer is cancelled and only the new card is flipped after its own 3000 ms.
 | Traces to | Size | INVEST exceptions |
 | --- | --- | --- |
 | [MIL-004], [UC-001] | fits one iteration | none |
 ### US-001.04 — Keep my progress
 **As a** Learner, **I want** the words I know to stop coming up, and the words still to learn to be kept when I close the program, **so that** I am only tested on what I do not know.
 **Acceptance Criteria**
 - Given a card is shown, when I press the known button, then that word is removed from the words to learn and the remaining words are saved in `words_to_learn.csv`.
 - Given `words_to_learn.csv` exists, when the program starts, then the cards come from that file.
 - Given `words_to_learn.csv` does not exist, when the program starts, then the cards come from the word list `ms-da.csv`.
 - Given all words are known, when the last known button is pressed, then the program shows a message that there is nothing left to learn and does not fail.
 | Traces to | Size | INVEST exceptions |
 | --- | --- | --- |
 | [MIL-005], [UC-001] | fits one iteration | none |
 ### US-001.05 — Hear the Malay word
 **As a** Learner, **I want** to hear the Malay word when its card is shown, **so that** I learn how it is pronounced.
 **Acceptance Criteria**
 - Given the speech extra is installed and a network is available, when a card shows a Malay word, then the word is spoken in Malay.
 - Given the speech extra is not installed or no network is available, when a card is shown, then the program works as without speech and does not show an error to the Learner.
 | Traces to | Size | INVEST exceptions |
 | --- | --- | --- |
 | [MIL-006], [UC-001] | fits one iteration | none |
 ## INVEST Check
 All five stories are Independent in delivery order (each builds on the one before but can be accepted alone), Negotiable in wording, Valuable to the Learner, Estimable, Small (one milestone each) and Testable (every criterion is Given/When/Then). Exception: US-001.02 to US-001.05 depend on the window of US-001.01, which is stated in their milestones' Dependencies.
 ---
 [UCD-001]: ./use-case-diagram.md
 [BC-001]: ./business-case.md
 [UC-001]: ./uc-001/uc.md
 [MIL-002]: ./milestones/mil-002-step1-user-interface.md
 [MIL-003]: ./milestones/mil-003-step2-new-flash-cards.md
 [MIL-004]: ./milestones/mil-004-step3-flip-cards.md
 [MIL-005]: ./milestones/mil-005-step4-save-progress.md
 [MIL-006]: ./milestones/mil-006-malay-speech.md
 [c3fbcbc]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card/commit/c3fbcbcfaf799e0ae34aed7e14d3bc8a62f03db3