Skip to content

feat(evaluation): add Educational Reasoning to EvaluationReport - #75

Open
RachitSMane wants to merge 1 commit into
vicharanashala:mainfrom
RachitSMane:feature/educational-reasoning
Open

feat(evaluation): add Educational Reasoning to EvaluationReport#75
RachitSMane wants to merge 1 commit into
vicharanashala:mainfrom
RachitSMane:feature/educational-reasoning

Conversation

@RachitSMane

Copy link
Copy Markdown

Summary

This PR introduces a backend-driven Educational Reasoning system for Evaluation Reports.

The reasoning pipeline generates structured educational insights using deterministic logic derived from:

  • Student question responses
  • Existing evaluation results
  • AI evaluation pipeline outputs
  • FLN curriculum structure
  • Personalized evaluation summaries

The frontend now consumes this structured reasoning directly from the backend instead of relying on duplicated or heuristic logic.


What changed

Backend

  • Added modular Educational Reasoning engine
  • Added curriculum loader for FLN Levels Structure
  • Added structured EvaluationReasoning model
  • Added evidence generation
  • Added learning progression generation
  • Added curriculum summary generation
  • Added confidence calculation
  • Added remediation summary generation
  • Integrated reasoning into EvaluationReport
  • Replaced duplicated concept mastery logic with backend-generated reasoning

Frontend

  • Added Educational Reasoning component
  • Updated EvaluationReport types
  • Render backend reasoning directly
  • Removed dependency on heuristic concept mastery

Architecture improvements

  • Backend is now the single source of truth for Educational Reasoning.
  • Concept Mastery is derived from graded question evidence instead of level-based heuristics.
  • Curriculum information is loaded from the existing FLN Levels Structure rather than duplicated.
  • Reasoning modules are separated into focused builders for easier maintenance.

Verification

Verified:

  • npm run build
  • npm run lint
  • End-to-end diagnostic workflow
  • Worksheet workflow
  • Educational Reasoning rendering
  • Concept Mastery consistency
  • Curriculum summaries
  • Learning progression
  • Confidence generation

Notes for reviewers

This PR is intentionally backend-driven.

The frontend now consumes the structured EvaluationReasoning payload without implementing additional educational logic.

The implementation preserves backward compatibility because the reasoning field is optional.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant