UploadStudyMaterial

1# UploadStudyMaterial.intent , Experience Contract (intent-graph-v1).
2# UX behavior as a first-class contract: journeys, states, recovery, accessibility.
3
4use experience
5
6experience UploadStudyMaterial
7
8  actor Learner
9
10  goal
11    "Turn my existing notes into a structured study plan."
12
13  enter when
14    Learner is signed_in
15    Learner has_selected Certification
16
17  journey HappyPath
18    start at MaterialUpload
19    when Learner selects SupportedDocument
20    show UploadProgress immediately
21    when Upload completes
22    show ProcessingStatus
23    preserve OriginalDocument
24    when StudyPlan is ready
25    show StudyPlan
26    offer ReviewAndEdit
27
28  state Empty
29    explain SupportedFormats
30    offer PasteText
31    offer SelectFile
32
33  state UploadFailure
34    explain RecoverableProblem
35    preserve SelectedDocument
36    offer Retry
37
38  state ProcessingFailure
39    preserve UploadedMaterial
40    offer RetryProcessing
41    offer ContactSupport
42
43  responsive
44    support Mobile
45    support Tablet
46    support Desktop
47
48  accessible
49    target WCAG_2_2_AA
50    keyboard complete
51    screen_reader announce UploadProgress
52    focus move_to ErrorSummary when validation_fails
53
54  follows RecoverableUpload
55
56pattern RecoverableUpload
57
58  requires
59    progress visible
60    selected_file preserved_on_failure
61    error actionable
62    retry available
63
64  accessible
65    progress announced
66    keyboard complete
67    focus managed