Players have Experience Points

jeffreywescott commented 8 years ago

(depends on #68)

Strategic Goals this issues impacts

!Learner stats match our subjective reality, elicit honest feedback, and promote self-directed, collaborative growth
Benefits
Learners have positive reinforcement to work on projects, are incentivized to put in time and effort (stat only goes up with effort)
All stakeholders can clearly distinguish relative experience levels (internal to the guild) across learners
Learners have a (somewhat) objective measure of each other's experience that depends less on social perception and more on actual time spent in practice
Description

Experience Points (XP) are how we measure productivity and duration of practice. They are roughly equivalent to "effective hours worked", but with more nuance.

XP are measured in hours, up to two decimal places. They can grow indefinitely, but will never recede. In this sense, they are different from a "health" stat that fluctuates.

Eventually, we'll likely introduce gating or leveling mechanisms around XP, to create semantic distinctions between a player with 50 XP and one with 5000 XP.

Data Sources

For each project, use the following data from retro (note: depends on #68):

Actual Contribution
- % of project completed by learner (mean of all teammate's evaluations, incl. self)
Internal project review scores (i.e. those submitted by the team members)
- Project Completeness
- Project Quality
Hours contributed to project per team member
Calculation

To calculate XP earned for a single project, use the formula:

XP = total hours contributed * relative contribution * mean internal project completeness * mean internal project quality

Where:

total hours contributed = the sum of all hours by each team member for that cycle
relative contribution = percent of project contributed to (0..1)
mean internal project completeness = percent of specs implemented for a project (0..1), mean of internal review scores
mean internal project quality = percent rating of project quality rubric (0..1), mean of internal review scores

For example, given the values:

player 1 hours contributed = 40
player 2 hours contributed = 45
player 3 hours contributed = 10
player 1 actual contribution = 0.14
mean internal project completeness = 0.89
mean internal project quality = 0.94

Then XP player 1 for working on this project for this cycle is 11.12

XP = ( (40+45+10) * 0.14 * 0.89 * 0.94) = 11.12.

Addenda:

To determine a player's total XP, sum all project cycle XPs.
Players who work on more than one project per cycle earn XP for every project. Given they are split between multiple projects, their actual contribution should (in theory) be lower, but when aggregated will add up to a "normal" XP for the cycle.
UI Design

Update the post-project DM to each team member to include XP:

**RETROSPECTIVE RESULTS:** #${project.name}

**Internal project reviews:**
Completeness: ${project.avgInternalCompleteness} (avg of: ${project.internalCompletenessReviews.join(', ')})
Quality: ${project.avgInternalQuality} (avg of: ${project.internalQualityReviews.join(', ')})

**Feedback from your team:**
${teamFeedbackList.join('  \n\n')}

**Hours contributed:**
Team size: ${team.length}
Your hours: ${stats.hours || 0}
All team hours: ${stats.teamHours || 0}

${teamHoursList.join('  \n')}

**Contribution to the project:**
Self-assessed: ${stats.rcSelf || 0}%
Team-assessed: ${stats.rcOther || 0}%

Your estimated contribution to the project: ${stats.rc || 0}%
Expected contribution for # of hours: ${stats.ec || 0}%
Contribution difference: ${stats.ecd || 0}%

**Stats earned for this project:**
Experience Points (XP): ${stats.xp || 0}
  = (${stats.teamHours} team hours * ${project.avgInternalCompleteness} completeness * ${project.avgInternalQuality} quality * ${stats.rc} contribution)
Culture Contribution: ${stats.cc || 0}%
Team Play: ${stats.tp || 0}%

Original issue: https://github.com/LearnersGuild/game/issues/150