Files
tutor-service/openspec/changes/frontend-mvp/specs/frontend-mvp/spec.md
2026-04-26 18:34:47 +09:00

1.5 KiB

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.