Skip to content

feat: add peer review SP features for Phase 1 project evaluation - #120

Open
23f3001369 wants to merge 11 commits into
vicharanashala:mainfrom
23f3001369:feat/peer-review
Open

feat: add peer review SP features for Phase 1 project evaluation#120
23f3001369 wants to merge 11 commits into
vicharanashala:mainfrom
23f3001369:feat/peer-review

Conversation

@23f3001369

Copy link
Copy Markdown

Summary

Adds peer review SP feature for Phase 1 project evaluation:

  • Project Submission: Students submit their PR link, project report, and product.md for peer review
  • 10-Question Rubric: Anonymous peer evaluation with 10 Yes/No questions (max 30 points), covering code quality, documentation, problem-solving, and project structure
  • SP Rewards: Reviewee earns up to 30 SP after receiving 3 peer reviews; Reviewer earns 50 SP after completing 3 mandatory reviews
  • Admin Endpoints: View submissions, reviews, and summary stats

New Models

  • \PeerReview\ - individual peer review with responses, scores, SP awards
  • \PeerReviewSubmission\ - student's Phase 1 project submission

New Endpoints

  • \GET /peer-review/rubric\ - get the evaluation rubric
  • \POST /peer-review/submit\ - submit project for review
  • \GET /peer-review/my-submission\ - view own submission + received reviews
  • \GET /peer-review/to-review\ - get available submissions to review
  • \POST /peer-review/start/:submissionId\ - start reviewing a submission
  • \POST /peer-review/submit-review/:reviewId\ - submit completed review
  • \GET /peer-review/my-reviews-given\ - view reviews given
  • \GET /admin/peer-review/submissions\ - admin: list submissions
  • \GET /admin/peer-review/reviews\ - admin: list reviews with filters
  • \GET /admin/peer-review/stats\ - admin: summary statistics

Category

  • Added \peer_review\ to SPTransaction category enum

- Exit Ticket: students submit within 24h of session end, auto-graded by NLP quality scorer, +3 SP for accepted tickets
- Peer Review: Phase 1 project submission + anonymous peer evaluation with 10-question rubric (max 30 pts)
  - +30 SP to reviewee after 3 peer reviews received
  - +50 SP to reviewer after completing 3 mandatory reviews
  - Admin endpoints for submissions, reviews, and stats
- New models: ExitTicket, PeerReview, PeerReviewSubmission
- New services: exitTicketScoring (NLP quality evaluator)
- New pipeline script: exit-ticket-grader.cjs (cron-based grading)
- Extended SPTransaction category enum with peer_review and exit_ticket
- Phase 1 project submission + anonymous peer evaluation with 10-question rubric (max 30 pts)
- Reviewee earns SP after 3 reviews received
- Reviewer earns SP after completing 3 mandatory reviews
- Admin endpoints for submissions, reviews, and stats
- New models: PeerReview, PeerReviewSubmission
- Extended SPTransaction category enum with peer_review
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