task-manager/implementation_plan.md

Implementation Plan - Reward Shop

Goal

Implement a "Reward Shop" where users can spend their hard-earned XP on virtual or real-world rewards. This enhances the gamification loop.

User Review Required

Important

Schema Changes: We will need to reset the database or run migrations to add the new rewards and user_rewards tables. Since we are in dev/prototype mode, I will likely push schema changes which might require a DB reset if we don't have a migration system set up (currently using drizzle-kit push).

Proposed Changes

Database Schema (shared/schema.ts)

[NEW] rewards table

• id: serial primary key
• title: text (localizable key or raw text)
• description: text
• cost: integer (XP cost)
• icon: text (lucide icon name)
• type: text ('virtual', 'real_world', 'feature_unlock')
• is_system: boolean (default true, for built-in rewards)

[NEW] user_rewards table

• id: serial primary key
• user_id: integer (ref users)
• reward_id: integer (ref rewards)
• purchased_at: timestamp

Backend (server/routes.ts)

[NEW] GET /api/rewards

• Returns list of all available rewards.
• Checks user_rewards to mark which ones are already owned (unique/one-time rewards).

[NEW] POST /api/rewards/buy

• Params: rewardId, userId
• Logic:
  1. Check user XP balance.
  2. If sufficient, deduct XP.
  3. Insert into user_rewards.
  4. Return success + new XP balance.

Frontend

[MODIFY] client/src/pages/AchievementsPage.tsx

• Add a new Tab: "Belohnungen" (Rewards).
• Render a grid of "Reward Cards".

[NEW] client/src/components/gamification/RewardCard.tsx

• Displays Icon, Title, Description, Cost.
• "Buy" button (Green if affordable, Grey if not).
• "Owned" badge if already purchased.

Translations (en.json, de.json)

• Add rewards namespace.
• Keys: shopTitle, buy, insufficientFunds, owned.

Verification Plan

Automated Tests

• None planned for now (prototyping).

Manual Verification

1. Browse: Check if rewards load in the new tab.
2. Buy (Success): Click buy on an affordable item -> XP decreases, item marked owned.
3. Buy (Fail): Click buy on expensive item -> Error toast "Not enough XP".