45 lines
1.5 KiB
Markdown
45 lines
1.5 KiB
Markdown
|
# frontend-mvp Specification
|
||
|
|
|
||
|
|
## ADDED Requirements
|
||
|
|
|
||
|
|
### Requirement: Web app exposes the job-seeker tutoring loop
|
||
|
|
|
||
|
|
The system SHALL provide a browser UI for the diagnostic interview loop.
|
||
|
|
|
||
|
|
#### Scenario: user starts diagnostic practice
|
||
|
|
|
||
|
|
- **GIVEN** a job seeker opens the web app
|
||
|
|
- **WHEN** they enter target role, stack, and interview timeline
|
||
|
|
- **THEN** the app creates a diagnostic session
|
||
|
|
- **AND** shows role-relevant questions.
|
||
|
|
|
||
|
|
#### Scenario: user submits an answer
|
||
|
|
|
||
|
|
- **GIVEN** a diagnostic session is active
|
||
|
|
- **WHEN** the user submits an answer
|
||
|
|
- **THEN** the app shows typed grading feedback
|
||
|
|
- **AND** the feedback links to evidence-backed learning state.
|
||
|
|
|
||
|
|
### Requirement: Web app exposes learning progress
|
||
|
|
|
||
|
|
The system SHALL show learner memory, readiness, and next challenge from the
|
||
|
|
backend APIs.
|
||
|
|
|
||
|
|
#### Scenario: progress appears after answer
|
||
|
|
|
||
|
|
- **GIVEN** the user has submitted at least one answer
|
||
|
|
- **WHEN** the app refreshes progress
|
||
|
|
- **THEN** it shows concept mastery, readiness percentage, and next challenge.
|
||
|
|
|
||
|
|
### Requirement: Web app exposes content operations
|
||
|
|
|
||
|
|
The system SHALL provide MVP operator controls for material ingestion,
|
||
|
|
ontology inspection, and teaching asset prompt candidates.
|
||
|
|
|
||
|
|
#### Scenario: operator creates teaching asset prompt
|
||
|
|
|
||
|
|
- **GIVEN** source material has produced ontology candidates
|
||
|
|
- **WHEN** the operator generates an asset prompt for a concept
|
||
|
|
- **THEN** the prompt shows source evidence, review state, model key, and model
|
||
|
|
verification guard.
|