docs: start frontend mvp milestone

This commit is contained in:
user
2026-04-26 18:34:47 +09:00
parent 4bb1d07f94
commit 3493f8b5a5
8 changed files with 225 additions and 18 deletions

View File

@@ -0,0 +1,44 @@
# 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.