feat: invoice OCR digitization (3 engines) and gamification v2

- Add three selectable OCR engines (Tesseract, PaddleOCR-local, Azure Document
  Intelligence) behind a shared packages/core dispatcher, wired into Add
  Transaction's scan flow, a new Settings > Dev Mode > Digitize Invoices batch
  tool, and a per-receipt quick-digitize action from Transactions > Invoices.
- Add gamification v2: coins/cosmetics shop, daily XP goal, budget health,
  personal league, perfect-day streaks, a financial path, and a weekly recap.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: MetalSyntax

apps/web/App.tsx

@@ -16,6 +16,7 @@ import { ScheduledPaymentView } from './views/ScheduledPaymentView';
 import { TransactionsListView } from './views/TransactionsListView';
 import { CalendarHeatmapView } from './views/CalendarHeatmapView';
 import { CurrencyPerformanceView } from './views/CurrencyPerformanceView';
+import { InvoiceDigitizeView } from './views/settings/InvoiceDigitizeView';
 import { ScheduledNotificationsView } from './views/ScheduledNotificationsView';
 import { ShoppingListView } from './views/ShoppingListView';
 import { PeopleView } from './views/PeopleView';
@@ -31,7 +32,8 @@ import { XPToastContainer } from './components/gamification/XPToast';
 import { LevelUpModal } from './components/gamification/LevelUpModal';
 import { BadgeEarnedSheet } from './components/gamification/BadgeEarnedSheet';
 import { ThemeProvider } from './contexts/ThemeContext';
-import type { BadgeDefinition, LevelId, GamificationProfile } from '@parity/core';
+import type { BadgeDefinition, LevelId, GamificationProfile, DailyGoalTier } from '@parity/core';
+import { createDefaultProfile, toISODate, CHALLENGE_TEMPLATES, offsetDate } from '@parity/core';
 import { getTranslation } from '@parity/i18n';
 import { motion, AnimatePresence } from 'framer-motion';
 import './index.css';
@@ -223,7 +225,7 @@ function AppContent() {
   const { data: ratesData, refetch: fetchAllRates } = useExchangeRates(isLoaded);
 
   // Gamification engine
-  const { profile: gamProfile, dispatchEvent: dispatchGamEvent, pendingRewards, clearRewards } = useGamification();
+  const { profile: gamProfile, dispatchEvent: dispatchGamEvent, pendingRewards, clearRewards, buyShopItem, equipOutfit, rerollChallenge, updateDailyGoal } = useGamification();
   const [xpToasts, setXpToasts] = useState<{ xpGained: number; label: string }[]>([]);
   const [levelUpLevel, setLevelUpLevel] = useState<LevelId | null>(null);
   const [badgesToShow, setBadgesToShow] = useState<BadgeDefinition[]>([]);
@@ -1255,7 +1257,15 @@ function AppContent() {
     }
   };
 
-  const handleStartFresh = (data: { profile: Partial<UserProfile>; displayCurrency: Currency; isBalanceVisible: boolean; navbarFavorites: string[] }) => {
+  const handleStartFresh = (data: { 
+    profile: Partial<UserProfile>; 
+    displayCurrency: Currency; 
+    isBalanceVisible: boolean; 
+    navbarFavorites: string[];
+    dailyGoal: DailyGoalTier;
+    hasDebtsSeed: boolean;
+    attentionGoal: 'saving' | 'budgeting' | 'logging';
+  }) => {
     setUserProfile(prev => ({ ...prev, ...data.profile }));
     setDisplayCurrency(data.displayCurrency);
     localStorage.setItem("displayCurrency", data.displayCurrency);
@@ -1276,6 +1286,61 @@ function AppContent() {
       icon: 'wallet',
     };
     setAccounts([initialWallet]);
+
+    // Create customized initial gamification profile
+    const initialGamProfile = createDefaultProfile();
+    initialGamProfile.dailyGoal = data.dailyGoal;
+    initialGamProfile.placementCompletedAt = new Date().toISOString();
+    
+    // Seed initial challenges based on attentionGoal and hasDebtsSeed
+    const today = toISODate(new Date());
+    const matchedTemplates: string[] = [];
+    if (data.attentionGoal === 'saving') {
+      matchedTemplates.push('daily_log_today', 'weekly_save_25', 'monthly_goal_progress');
+    } else if (data.attentionGoal === 'budgeting') {
+      matchedTemplates.push('daily_log_today', 'weekly_control_food', 'monthly_all_green');
+    } else {
+      matchedTemplates.push('daily_log_today', 'weekly_no_gaps', 'monthly_goal_progress');
+    }
+    
+    if (data.hasDebtsSeed) {
+      matchedTemplates.push('weekly_settle_debt');
+    }
+    
+    for (const tid of matchedTemplates) {
+      const temp = CHALLENGE_TEMPLATES.find(t => t.id === tid);
+      if (temp) {
+        let targetVal = 1;
+        const target = temp.target;
+        if (target) {
+          if ('count' in target) targetVal = target.count;
+          else if ('amount' in target) targetVal = target.amount;
+          else if ('limit' in target) targetVal = target.limit;
+          else if ('envelopeCount' in target) targetVal = target.envelopeCount;
+          else if ('days' in target) targetVal = target.days;
+          else if ('progressPercent' in target) targetVal = target.progressPercent;
+        }
+
+        const expiresAt = temp.horizon === 'daily' 
+          ? today + 'T23:59:59.999Z'
+          : temp.horizon === 'weekly'
+            ? offsetDate(today, 7) + 'T23:59:59.999Z'
+            : offsetDate(today, 30) + 'T23:59:59.999Z';
+
+        initialGamProfile.challengeProgress[temp.id] = {
+          challengeId: temp.id,
+          assignedAt: today + 'T00:00:00.000Z',
+          expiresAt,
+          current: 0,
+          target: targetVal,
+          completed: false,
+          completedAt: null,
+          xpClaimed: false,
+        };
+      }
+    }
+    
+    idbService.saveGamificationProfile(initialGamProfile);
     setIsFirstTime(false);
   };
 
@@ -1660,6 +1725,9 @@ function AppContent() {
               onUpdateTransaction={(tx) => setTransactions(prev => prev.map(t => t.id === tx.id ? tx : t))}
               initialViewMode={currentView === 'INVOICES' ? 'INVOICES' : 'LIST'}
               showConfirm={showConfirm}
+              userProfile={userProfile}
+              isDevMode={isDevMode}
+              showAlert={showAlert}
             />
           )}
           {currentView === 'HEATMAP' && (
@@ -1687,6 +1755,15 @@ function AppContent() {
               isDevMode={isDevMode}
             />
           )}
+          {currentView === 'INVOICE_DIGITIZE' && (
+            <InvoiceDigitizeView
+              onBack={() => setCurrentView('PROFILE')}
+              transactions={filteredTransactions}
+              onUpdateTransaction={(tx) => setTransactions(prev => prev.map(t => t.id === tx.id ? tx : t))}
+              userProfile={userProfile}
+              showAlert={showAlert}
+            />
+          )}
           {currentView === 'SCHEDULED_NOTIFICATIONS' && (
             <ScheduledNotificationsView
               onBack={() => setCurrentView('PROFILE')}
@@ -1779,6 +1856,10 @@ function AppContent() {
             <AcademyView
               profile={gamProfile}
               onBack={() => setCurrentView('DASHBOARD')}
+              onBuyItem={buyShopItem}
+              onEquipOutfit={equipOutfit}
+              onRerollChallenge={rerollChallenge}
+              onUpdateDailyGoal={updateDailyGoal}
               t={t}
             />
           )}
@@ -1819,7 +1900,7 @@ function AppContent() {
 
         {/* Bottom Nav (Only visible on Dashboard and Wallet/Profile root) */}
         {['DASHBOARD', 'WALLET', 'PROFILE', 'ANALYSIS', 'TRANSACTIONS', 'BUDGET', 'SCHEDULED', 'HEATMAP', 'CURRENCY_PERF', 'SHOPPING_LIST', 'CONTACTS', 'DEBT_TRACKER', 'EXPORT', 'FIN_CALENDAR', 'IMPORT', 'PDF_REPORT', 'SCENARIO_PLANNER'].includes(currentView) && isNavVisible && !showAdd && !showSettings && (
-          <div className="h-20 bg-theme-surface/95 backdrop-blur-md border-t border-white/5 flex items-center justify-center gap-4 md:gap-24 px-2 relative z-10 pb-2 flex-shrink-0 w-full transition-all duration-300 animate-in slide-in-from-bottom-full">
+          <div className="h-20 bg-theme-surface/95 backdrop-blur-md border-t border-white/5 flex items-center justify-center gap-0 md:gap-24 px-2 relative z-10 pb-2 flex-shrink-0 w-full transition-all duration-300 animate-in slide-in-from-bottom-full">
             {(() => {
               const NAV_ICON_MAP: Record<string, React.ReactNode> = {
                 DASHBOARD: <Home size={24} />,
@@ -1934,6 +2015,8 @@ function AppContent() {
             } as Transaction : null)}
             showAlert={showAlert}
             contacts={contacts}
+            isDevMode={isDevMode}
+            userProfile={userProfile}
           />
         )}
 

apps/web/__tests__/gamification.test.ts

@@ -0,0 +1,149 @@
+import { 
+  createDefaultProfile, 
+  processEvent, 
+  evaluateBadges, 
+  CHALLENGE_TEMPLATES, 
+  BADGE_DEFINITIONS,
+  GamificationProfile
+} from '@parity/core';
+import type { GamificationEvent } from '@parity/core';
+
+describe('Gamification Engine — Automated Badges & Challenges Tests', () => {
+  let profile: GamificationProfile;
+  const today = '2026-07-02';
+
+  beforeEach(() => {
+    profile = createDefaultProfile();
+  });
+
+  describe('Badge Attainment Conditions', () => {
+    it('should award first_dollar badge on transaction_created event', () => {
+      const event: GamificationEvent = {
+        type: 'transaction_created',
+        timestamp: new Date().toISOString(),
+      };
+      const earned = evaluateBadges(profile, event, []);
+      const badge = earned.find(b => b.id === 'first_dollar');
+      expect(badge).toBeDefined();
+      expect(badge?.xp).toBe(25);
+    });
+
+    it('should award multi_wallet badge when wallet currency count is three_or_more', () => {
+      const event: GamificationEvent = {
+        type: 'transaction_created',
+        timestamp: new Date().toISOString(),
+        payload: { walletCount: 3, currency: 'three_or_more' }
+      };
+      const earned = evaluateBadges(profile, event, []);
+      const badge = earned.find(b => b.id === 'multi_wallet');
+      expect(badge).toBeDefined();
+    });
+
+    it('should award digital_fortress badge when composite drive sync and PWA installs are met', () => {
+      const event1: GamificationEvent = {
+        type: 'pwa_installed',
+        timestamp: new Date().toISOString(),
+      };
+      const result = processEvent(profile, event1, [], today);
+      
+      const event2: GamificationEvent = {
+        type: 'drive_sync_enabled',
+        timestamp: new Date().toISOString(),
+      };
+      const result2 = processEvent(result.updatedProfile, event2, [], today);
+      const earned = result2.newBadges.find(b => b.id === 'digital_fortress');
+      expect(earned).toBeDefined();
+    });
+
+    it('should award goal_crusher badge when completed goals is at least 1', () => {
+      profile.stats.totalGoalsCompleted = 1;
+      const event: GamificationEvent = {
+        type: 'transaction_created',
+        timestamp: new Date().toISOString(),
+      };
+      const earned = evaluateBadges(profile, event, []);
+      expect(earned.find(b => b.id === 'goal_crusher')).toBeDefined();
+    });
+
+    it('should award debt_slayer badge when debt payments completed is at least 1', () => {
+      profile.stats.totalDebtsSettled = 1;
+      const event: GamificationEvent = {
+        type: 'transaction_created',
+        timestamp: new Date().toISOString(),
+      };
+      const earned = evaluateBadges(profile, event, []);
+      expect(earned.find(b => b.id === 'debt_slayer')).toBeDefined();
+    });
+
+    it('should award on_fire badge when streak is at least 7 days', () => {
+      profile.streak.currentDays = 7;
+      const event: GamificationEvent = {
+        type: 'transaction_created',
+        timestamp: new Date().toISOString(),
+      };
+      const earned = evaluateBadges(profile, event, []);
+      expect(earned.find(b => b.id === 'on_fire')).toBeDefined();
+    });
+
+    it('should award rate_watcher badge on rate_watch_7_days event', () => {
+      const event: GamificationEvent = {
+        type: 'rate_watch_7_days',
+        timestamp: new Date().toISOString(),
+      };
+      const earned = evaluateBadges(profile, event, []);
+      expect(earned.find(b => b.id === 'rate_watcher')).toBeDefined();
+    });
+  });
+
+  describe('Challenge Progression & Completion Loops', () => {
+    it('should progress daily_log_today challenge and complete it on reaching target', () => {
+      const template = CHALLENGE_TEMPLATES.find(c => c.id === 'daily_log_today')!;
+      profile.challengeProgress['daily_log_today'] = {
+        challengeId: 'daily_log_today',
+        assignedAt: '2026-07-02T00:00:00.000Z',
+        expiresAt: '2026-07-02T23:59:59.999Z',
+        current: 0,
+        target: 1,
+        completed: false,
+        completedAt: null,
+        xpClaimed: false,
+      };
+
+      const event: GamificationEvent = {
+        type: 'transaction_created',
+        timestamp: new Date().toISOString(),
+      };
+
+      const result = processEvent(profile, event, [], today);
+      const cp = result.updatedProfile.challengeProgress['daily_log_today'];
+      expect(cp.current).toBe(1);
+      expect(cp.completed).toBe(true);
+      expect(result.xpGained).toBeGreaterThanOrEqual(template.xpReward);
+    });
+
+    it('should progress weekly_streak_7 challenge on active days', () => {
+      profile.challengeProgress['weekly_streak_7'] = {
+        challengeId: 'weekly_streak_7',
+        assignedAt: '2026-07-02T00:00:00.000Z',
+        expiresAt: '2026-07-09T23:59:59.999Z',
+        current: 0,
+        target: 7,
+        completed: false,
+        completedAt: null,
+        xpClaimed: false,
+      };
+
+      profile.streak.currentDays = 7;
+
+      const event: GamificationEvent = {
+        type: 'daily_streak',
+        timestamp: new Date().toISOString(),
+      };
+
+      const result = processEvent(profile, event, [], today);
+      const cp = result.updatedProfile.challengeProgress['weekly_streak_7'];
+      expect(cp.current).toBe(7);
+      expect(cp.completed).toBe(true);
+    });
+  });
+});