Challenges & Achievements: Overview & Functionality

The Challenges & Achievements in the system enhances motivation by rewarding consistency and long-term effort in addition to the standard points awarded for individual chores. While chore completions provide immediate feedback, achievements and challenges offer larger, structured goals to keep kids engaged over time.

---

🏆 Achievements & Challenges: Key Concepts

1. Achievements – Rewards earned for completing a set number of chores over time. These are personal milestones for each child, such as completing 100 chores or maintaining a chore streak for 30 days.
2. Challenges – Time-bound goals that apply to one or multiple kids. These might require completing 50 chores in a month or working together to reach a shared goal.

---

📊 Sensor Naming & Tracking

Entity Naming for Sensors

To ensure consistency and clarity, sensors follow this format:

• Kid-Specific Achievements → sensor.kc_{kid_name}_achievement_status_{achievement_name}
• Overall Challenges → sensor.kc_challenge_status_{challenge_name}

---

📝 How Tracking Works

Kid-Specific Sensors (sensor.kc_{kid_name}_achievement_status_{achievement_name})

• State: Tracks either a percentage of completion or the number of completed chores, depending on the achievement type.
• Raw Progress Attribute: Counts the exact number of chores claimed or approved toward the goal.

Overall Challenge Sensors (sensor.kc_challenge_status_{challenge_name})

• State: Tracks progress toward the overall goal when multiple kids are involved.
• Example: If a challenge requires 50 chores per child in 30 days, the sensor will track the total number of chores completed and the percentage of progress toward that goal.

When does tracking start?

• Tracking starts from the moment they are created—past chore completions do not count toward the total.
• If an achievement is set for 100 chore completions, and the chore was done 60 times before the achievement existed, the child must complete it 100 more times from that point forward.

How Are Chores Counted?

• If the Achievement or Challenge is tied to a specific chore, only that chore’s approvals contribute to progress.
• If not tied to a specific chore, the system counts approvals across all chores.
• If multiple chore approvals per day are allowed, each approval increases the counter.
• If multiple completions are not allowed, the counter only increases once per day per chore when the approval is completed.

---

🔄 Sensor Updates & Completion Logic

⏳ When Are Sensors Updated?

• Automatically at the defined update interval (default: every 5 minutes).
• Whenever a chore is updated (claimed, approved, or rejected).

🏁 What Happens When an Achievement or Challenge is Completed?

• Sensor state remains at 100% (or the final count if not percentage-based).
• Reward points are automatically added when the last required chore is approved.
• The sensor does not reset or change states—it remains in the completed state.

🛑 What Happens to Challenges When They End?

• If a challenge has a time limit, the sensor stops tracking after the deadline.
• No further updates occur once the challenge is completed or expired.

---

🛠️ Parent Actions: Managing Achievements & Challenges

After an achievement or challenge is completed, parents can:

1. Leave the sensor as-is for historical tracking.
2. Manually delete the sensor and create a new one for a fresh challenge.
3. Modify or reset an existing challenge if desired.

---

🔹 Summary: How to Use Achievements & Challenges Effectively

✔ Use achievements for long-term motivational goals (e.g., "Complete 100 chores").
✔ Use challenges to create short-term competitions or team goals (e.g., "50 chores in a week").
✔ Progress is automatically tracked and updates with chore completion.
✔ Rewards are given automatically when milestones are reached.
✔ Challenges expire at their deadline and stop tracking progress.
✔ Parents can reset or delete completed challenges as needed.

This structured system ensures kids stay motivated and engaged while providing parents with a clear and automated way to track progress. 🚀

---

🏆 Examples of Achievement Goals in a Chore System

Achievements reward kids for hitting personal milestones based on their total chore completions or streaks, helping them build habits and consistency over time.

Here are some example achievement goals:

---

🥇 1. Chore Completion Milestones

• 🟡 Chore Champion: Complete 100 chores (Milestone Achievement)
• 🟠 Household Helper: Complete 250 chores
• 🔵 Master of Tasks: Complete 500 chores

Why It’s Great:
✅ Recognizes long-term effort
✅ Easy to track through cumulative progress

---

🔥 2. Streak-Based Achievements

• 📅 Daily Dynamo: Complete chores every day for 7 days
• 💪 Streak Star: Maintain a 30-day streak of chore completions
• 🌟 Consistent Contributor: Complete at least 1 chore every day for 100 days

Why It’s Great:
✅ Encourages daily habits
✅ Builds discipline and routine

---

💪 Examples of Challenge Goals in a Chore System

Challenges are time-bound goals designed to motivate kids to complete tasks within a set period. Unlike personal achievements, challenges are typically short-term and push kids to reach goals quickly.

Here are some example challenge goals:

---

🗓️ 1. Time-Bound Completion Challenges

• 🏃 Weekend Warrior: Complete 10 chores between Friday and Sunday
• 📅 Monthly Marathon: Finish 50 chores in 30 days
• ☀️ Summer Sprint: Complete 100 chores during summer break

Why It’s Great:
✅ Adds urgency and excitement
✅ Keeps kids engaged during breaks or holidays

---

💯 2. Streak and Consistency Challenges

• 🔥 Daily Streak Challenge: Complete at least 1 chore every day for 14 days
• 💪 Two-Week Warrior: Finish chores every day for 14 consecutive days
• 🌞 30-Day Commitment: Complete at least one chore daily for an entire month

Why It’s Great:
✅ Builds consistent habits
✅ Helps kids develop daily routines

---

🚀 3. Special Theme Challenges

• 🌿 Eco Warrior Challenge: Complete chores focused on recycling, composting, or saving energy (e.g., take out recycling, turn off lights, water plants)
• 🐶 Pet Care Pro: Perform all pet-related chores for a full week
• 💧 Laundry Legend: Handle all laundry chores for 2 weeks

Why It’s Great:
✅ Adds creativity and variety to chore routines
✅ Allows kids to focus on themed tasks and skills

---