Sprint 6: Schema design for IDPs, OKRs, Reviews, KPIs, Notes

[henfrydls]

Summary

• Add 12 new Prisma models for the people development platform expansion
• Schema validated by Prisma (prisma validate passes)
• Design validated by HR specialist (anti-patterns reviewed, terminology checked)
• No migration yet — design only, no DB changes until Sprint 7+

New Models (12)

IDPs: DevelopmentPlan, DevelopmentGoal, DevelopmentAction
OKRs: TimePeriod, Objective, KeyResult, CheckIn
Reviews: ReviewCycle, Review, ReviewSkillRating
KPIs: KPI, KPIEntry
Notes: CheckInNote

Key Design Decisions

• 70-20-10 model for action types (experience/social/formal/self_directed)
• OKR scoring: 0.0-1.0 scale, weighted avg of KRs, COMMITTED vs ASPIRATIONAL
• 3 metric types: NUMBER, PERCENT, BINARY with targetDirection (INCREASE/DECREASE)
• Reviews: 5-point scale, manager-only MVP, skill delta snapshots
• KPIs: baseline + target with direction, individual or department level
• Cross-module: Review → IDP link, KPI → Objective link, all → Collaborator hub

HR Specialist Validation Findings

• ✅ IDP, OKR, Review models solid and well-grounded
• ✅ All terminology follows SHRM/CIPD standards
• ⚠️ KPI model improved based on feedback (added baselineValue, targetDirection, collaboratorId)
• ⚠️ Review → IDP link added based on feedback (most critical cross-module connection)

Test plan

• prisma validate passes
• All 105 server tests pass (no regressions)
• Schema is design-only — no migration, no runtime impact