π Overview
Prepare the service boundaries for future student analysis.
This issue does not implement BKT yet. It establishes where progress and performance logic will live.
π― Objectives
β’ Create progress schemas.
β’ Create progress service skeleton.
β’ Create performance analyzer skeleton.
β’ Define progress response format.
β’ Define topic performance response format.
π― Scope
API and service contracts only.
π Call Chain
Attempts
β
Performance Analyzer
β
Progress Service
β
Progress API
βοΈ Technical Notes
Do not hardcode frontend-specific calculations inside routes.
Routes call services.
Services call analysis logic.
π« Out of Scope
β’ BKT formulas
β’ Recommendations
β’ AI teaching
π Dependencies
β’ W1-B3-01 Attempt Architecture
β
Acceptance Criteria
β’ Progress schema exists.
β’ Service boundary is defined.
β’ API endpoint returns valid placeholder/test data.
β’ No business logic exists directly inside routes.
πΏ Branch
progress-performance-foundation
π¨ Files Concerned
backend/app/
βββ schemas/
β βββ progress.py
βββ api/routes/
β βββ progress.py
βββ services/
β βββ progress_service.py
βββ adaptive/
βββ performance_analyzer.py
π Overview
Prepare the service boundaries for future student analysis.
This issue does not implement BKT yet. It establishes where progress and performance logic will live.
π― Objectives
β’ Create progress schemas.
β’ Create progress service skeleton.
β’ Create performance analyzer skeleton.
β’ Define progress response format.
β’ Define topic performance response format.
π― Scope
API and service contracts only.
π Call Chain
Attempts
β
Performance Analyzer
β
Progress Service
β
Progress API
βοΈ Technical Notes
Do not hardcode frontend-specific calculations inside routes.
Routes call services.
Services call analysis logic.
π« Out of Scope
β’ BKT formulas
β’ Recommendations
β’ AI teaching
π Dependencies
β’ W1-B3-01 Attempt Architecture
β Acceptance Criteria
β’ Progress schema exists.
β’ Service boundary is defined.
β’ API endpoint returns valid placeholder/test data.
β’ No business logic exists directly inside routes.
πΏ Branch
progress-performance-foundation
π¨ Files Concerned
backend/app/
βββ schemas/
β βββ progress.py
βββ api/routes/
β βββ progress.py
βββ services/
β βββ progress_service.py
βββ adaptive/
βββ performance_analyzer.py