🙋‍♀️ Chore Claiming System

Enable household members to take initiative by claiming unassigned chores when they're ready to help!

Overview

The chore claiming system allows household members to self-assign chores that haven't been specifically assigned to anyone yet. This promotes responsibility and helps distribute household tasks fairly when members are available to contribute.

Key Benefits

• Empowers initiative: Members can step up when they're available
• Reduces coordination overhead: No need to manually assign every chore
• Promotes fairness: Anyone can claim available chores
• Instant feedback: Visual confirmation when chores are claimed

How It Works

When chores are created without specific assignments, they appear in the "Unassigned Chores" section where any household member can claim them with a single click.

Getting Started

Prerequisites

• Household setup: Must be part of a household with multiple members
• Unassigned chores: At least one chore must exist without assignments
• Member permissions: All household members can claim unassigned chores

Basic Claiming Workflow

1. View Available Chores

   • Open the chores section in Mind Your Now
   • Look for the "Unassigned Chores" section
   • Available chores show a "Claim" button

2. Claim a Chore

   • Click the blue "Claim" button next to any unassigned chore
   • The chore immediately moves to your "My Chores" section
   • You'll see a success notification confirming the claim

3. Complete the Chore

   • Work on the chore as usual
   • Mark it complete when finished
   • The chore will reflect your completion in household progress

User Interface Guide

Chores Section Layout

The chores interface is organized into three main sections:

1. My Chores

• Shows chores assigned specifically to you
• Displays completion status and due dates
• No claim buttons (already yours)

2. Today's Chores

• Shows all household chores for the current date
• Includes both assigned and unassigned chores
• Mixed view for household coordination

3. Unassigned Chores

• Shows chores available for claiming
• Features prominent "Claim" buttons
• Updates in real-time as chores are claimed

Claim Button States

State	Appearance	Action Available
Available	Blue "Claim" button	Click to claim chore
Claimed	Button disappears	Chore moves to "My Chores"
Processing	Disabled button	Wait for claim to complete

Visual Feedback

• Success toast: Displays "🙋‍♀️ Claimed [Chore Name]!" with thank you message
• Real-time updates: Chore immediately disappears from unassigned list
• My Chores update: Claimed chore appears in your personal list
• Gradient styling: Success message uses blue gradient for positive reinforcement

Advanced Features

Real-Time Synchronization

Claims are synchronized instantly across all devices:

• WebSocket updates: Other family members see changes immediately
• Conflict prevention: If two people try to claim the same chore, first claim wins
• Automatic refresh: Lists update without page reload

Assignment Types Integration

The claiming system works with all chore assignment types:

• Individual chores: One person claims and completes
• Shared chores: Multiple people can claim the same shared chore
• Rotational chores: Claims respect rotation order

Mobile Experience

• Touch-optimized: Claim buttons sized for easy mobile interaction
• Responsive layout: Three-section layout adapts to mobile screens
• Swipe compatibility: Claiming works with mobile gesture navigation

API Integration

Claiming Endpoint

Claims are processed through the unified tasks API:

PUT /api/v2/unified-tasks/{choreId}/assignments
Authorization: Bearer {token}
Content-Type: application/json

{
  "addMembers": ["member-uuid"],
  "assignmentType": "INDIVIDUAL"
}

Response Handling

• Success: Chore assignment created with member details
• Conflict: Error if chore already claimed by assignment limit
• Authentication: Requires valid household member token

Real-Time Events

WebSocket events keep all clients synchronized:

• CHORE_ASSIGNED: Broadcasts when chore is claimed
• Event includes member name and chore title for notifications

Troubleshooting

Common Issues

Claim button not appearing:

• Verify you're a household member with proper permissions
• Check that the chore is truly unassigned (not in rotation queue)
• Refresh the page if WebSocket connection is stale

Claim fails with error:

• Another member may have claimed it first
• Check your internet connection
• Verify you're still logged in to your household

Chore doesn't move to My Chores:

• Wait a moment for real-time synchronization
• Pull down to refresh on mobile
• Check if the chore has specific assignment requirements

Error Messages

Error	Cause	Solution
"Member is already assigned"	You already have this chore	Check "My Chores" section
"Chore not found"	Chore was deleted	Refresh the chore list
"Not authenticated"	Session expired	Log in again

Performance Tips

• Network connectivity: Claims require internet connection
• Background sync: Changes sync when connection restored
• Cache updates: Recent claims cached for offline viewing

Mobile-Specific Features

Touch Interactions

• Large touch targets: Claim buttons sized for thumb interaction
• Haptic feedback: Subtle vibration on successful claim (iOS/Android)
• Pull-to-refresh: Swipe down to manually refresh unassigned chores

Responsive Design

• Stacked layout: Sections stack vertically on narrow screens
• Scroll optimization: Each section independently scrollable
• Button placement: Claim buttons positioned for one-handed use

Household Management

Admin Controls

Household administrators can:

• View who claimed which chores in the activity feed
• Create chores without assignments to enable claiming
• Adjust chore settings that affect claim eligibility

Member Permissions

All household members have equal claiming rights:

• No hierarchy for claiming (first-come, first-served)
• Claims respect existing chore constraints (time windows, difficulty)
• Member roles don't affect claiming ability

Fair Distribution

The system promotes fairness by:

• Making all unassigned chores visible to everyone
• Providing equal opportunity for all members
• Tracking completion patterns for household insights

Best Practices

For Families

• Encourage initiative: Praise members who proactively claim chores
• Create available chores: Leave some chores unassigned for claiming
• Set expectations: Establish household norms about claiming vs. assignment

For Roommates

• Rotation balance: Mix claimed chores with assigned rotations
• Communication: Use chore notes to coordinate complex tasks
• Flexibility: Allow claims on traditionally assigned chores when appropriate

For Organizations

• Shift flexibility: Enable staff to claim open shifts/tasks
• Skills matching: Create claiming pools for different skill levels
• Recognition: Track and celebrate proactive claiming behavior

What's Next?

The claiming system integrates with other Mind Your Now features:

• Achievement tracking: Claims count toward completion achievements
• Analytics: View claiming patterns in household insights
• Notifications: Get alerts when family members claim chores
• Calendar sync: Claimed chores appear in your personal schedule

Ready to encourage more household participation? Start by creating some unassigned chores and let your family members discover the claiming system naturally!