Add the plan baseline: business case, stakeholders, plan, design and milestones

Business Case, Stakeholder Analysis, Project Plan, use case chain (UCD, US, UC, DM, SSD, OC, SD, DCD, DICT), three ADRs, milestones MIL-001 to MIL-007, the traceability matrix and 22 review records (autonomous mode, AI as stand-in for S01).
2026-10-14 21:33:25 +08:00
parent 97eec837a4
commit c3fbcbcfaf
49 changed files with 3484 additions and 0 deletions
@@ -0,0 +1,62 @@
+# 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 | pending |
+
+---
+
+## 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