Chore Metrics/Reporting

[jherforth]

Add in some chore related metrics for reporting.

Core Completion Metrics

• Chore completion rate (overall % and per kid): Total chores completed vs. assigned. Break it down by day/week/month or by chore category (e.g., daily vs. weekly).
• On-time vs. late completions: Track how many were done by the deadline vs. after. This encourages timeliness.
• Missed chores rate: Number/percentage of assigned chores not completed. Pair with reasons if you add optional logging.
• Average chores per day/week per kid (or household total).

Streak & Consistency Metrics

• Current streak and longest streak (not just all-chores days, but also per-kid or per-chore-type streaks).
• Consistency score: e.g., percentage of days where ≥80% of daily chores were done. Or a rolling 7/30-day average completion rate.
• Perfect weeks/months: Count of weeks/months with 100% completion.

Reward & Effort Metrics

• Clams earned vs. spent (YTD or monthly): Shows earning velocity and saving behavior.
• Clams per chore (average): Highlights efficiency or high-value chores.
• Bonus clams earned YTD (or as % of total clams): Builds on your bonus chores idea.
• Redemption rate: How many clams are cashed in for rewards vs. saved. Good for teaching delayed gratification.

Progress & Growth Metrics

• Improvement over time: Month-over-month or week-over-week change in completion rate/streak.
• Chores by difficulty/category: If you categorize chores (easy/medium/hard or by type like "kitchen," "bedroom," "pets"), track distribution and completion per category.
• Total chores completed lifetime or YTD per kid (raw count).
• Leveling/XP system (if you add it): Cumulative "experience" from chores that unlocks badges/levels.

Fun/Gamification Metrics

• Badges/achievements unlocked: Count and list (e.g., "7-day streak," "Kitchen Master").

Reporting-Friendly Ideas
These work well in a dashboard widget or generated reports (PDF/email):

• Visuals: Progress bars, calendars with heatmaps (like GitHub contributions), pie charts for chore types.
• Filters: Per kid, per time period, comparisons (kid A vs. kid B, this month vs. last).
• Alerts/Highlights: "Biggest improver this month," "Longest streak," "Most consistent."

Implementation Tips

• Store historical completion data with timestamps, kid ID, chore ID, clams awarded, and flags (bonus/on-time).
• Calculate many of these on-the-fly or with lightweight aggregates to keep the self-hosted setup efficient.
• Start simple — add 3-4 new ones first (e.g., completion %, longest streak, category breakdown) and expose them in the existing chores widget.