feat: Complete Real-Time Sync implementation 🔄

BACKEND:
- Fix JWT authentication in FamiliesGateway
  * Configure JwtModule with ConfigService in FamiliesModule
  * Load JWT_SECRET from environment variables
  * Enable proper token verification for WebSocket connections
- Fix circular dependency in TrackingModule
  * Use forwardRef pattern for FamiliesGateway injection
  * Make FamiliesGateway optional in TrackingService
  * Emit WebSocket events when activities are created/updated/deleted

FRONTEND:
- Create WebSocket service (336 lines)
  * Socket.IO client with auto-reconnection (exponential backoff 1s → 30s)
  * Family room join/leave management
  * Presence tracking (online users per family)
  * Event handlers for activities, children, members
  * Connection recovery with auto-rejoin
- Create useWebSocket hook (187 lines)
  * Auto-connect on user authentication
  * Auto-join user's family room
  * Connection status tracking
  * Presence indicators
  * Hooks: useRealTimeActivities, useRealTimeChildren, useRealTimeFamilyMembers
- Expose access token in AuthContext
  * Add token property to AuthContextType interface
  * Load token from tokenStorage on initialization
  * Update token state on login/register/logout
  * Enable WebSocket authentication
- Integrate real-time sync across app
  * AppShell: Connection status indicator + online count badge
  * Activities page: Auto-refresh on family activity events
  * Home page: Auto-refresh daily summary on activity changes
  * Family page: Real-time member updates
- Fix accessibility issues
  * Remove deprecated legacyBehavior from Link components (Next.js 15)
  * Fix color contrast in EmailVerificationBanner (WCAG AA)
  * Add missing aria-labels to IconButtons
  * Fix React key warnings in family member list

DOCUMENTATION:
- Update implementation-gaps.md
  * Mark Real-Time Sync as COMPLETED ✅
  * Document WebSocket room management implementation
  * Document connection recovery and presence indicators
  * Update summary statistics (49 features completed)

FILES CREATED:
- maternal-web/hooks/useWebSocket.ts (187 lines)
- maternal-web/lib/websocket.ts (336 lines)

FILES MODIFIED (14):
Backend (4):
- families.gateway.ts (JWT verification fix)
- families.module.ts (JWT config with ConfigService)
- tracking.module.ts (forwardRef for FamiliesModule)
- tracking.service.ts (emit WebSocket events)

Frontend (9):
- lib/auth/AuthContext.tsx (expose access token)
- components/layouts/AppShell/AppShell.tsx (connection status + presence)
- app/activities/page.tsx (real-time activity updates)
- app/page.tsx (real-time daily summary refresh)
- app/family/page.tsx (accessibility fixes)
- app/(auth)/login/page.tsx (remove legacyBehavior)
- components/common/EmailVerificationBanner.tsx (color contrast fix)

Documentation (1):
- docs/implementation-gaps.md (updated status)

IMPACT:
✅ Real-time family collaboration achieved
✅ Activities sync instantly across all family members' devices
✅ Presence tracking shows who's online
✅ Connection recovery handles poor network conditions
✅ Accessibility improvements (WCAG AA compliance)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

maternal-web/app/activities/page.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useState, useEffect } from 'react';
+import { useState, useEffect, useCallback } from 'react';
 import {
   Box,
   Typography,
@@ -11,6 +11,8 @@ import {
   ListItemText,
   Chip,
   CircularProgress,
+  Snackbar,
+  Alert,
 } from '@mui/material';
 import {
   Restaurant,
@@ -26,6 +28,7 @@ import { useAuth } from '@/lib/auth/AuthContext';
 import { childrenApi, Child } from '@/lib/api/children';
 import { trackingApi, Activity } from '@/lib/api/tracking';
 import { format } from 'date-fns';
+import { useRealTimeActivities } from '@/hooks/useWebSocket';
 
 const activityIcons: Record<string, any> = {
   feeding: <Restaurant />,
@@ -51,9 +54,38 @@ export default function ActivitiesPage() {
   const [selectedChild, setSelectedChild] = useState<Child | null>(null);
   const [activities, setActivities] = useState<Activity[]>([]);
   const [loading, setLoading] = useState(true);
+  const [notification, setNotification] = useState<string | null>(null);
 
   const familyId = user?.families?.[0]?.familyId;
 
+  // Real-time activity handlers
+  const handleActivityCreated = useCallback((activity: Activity) => {
+    console.log('[ActivitiesPage] Real-time activity created:', activity);
+    setActivities((prev) => [activity, ...prev]);
+    setNotification('New activity added by family member');
+  }, []);
+
+  const handleActivityUpdated = useCallback((activity: Activity) => {
+    console.log('[ActivitiesPage] Real-time activity updated:', activity);
+    setActivities((prev) =>
+      prev.map((a) => (a.id === activity.id ? activity : a))
+    );
+    setNotification('Activity updated by family member');
+  }, []);
+
+  const handleActivityDeleted = useCallback((data: { activityId: string }) => {
+    console.log('[ActivitiesPage] Real-time activity deleted:', data);
+    setActivities((prev) => prev.filter((a) => a.id !== data.activityId));
+    setNotification('Activity deleted by family member');
+  }, []);
+
+  // Subscribe to real-time updates
+  useRealTimeActivities(
+    handleActivityCreated,
+    handleActivityUpdated,
+    handleActivityDeleted
+  );
+
   useEffect(() => {
     const loadData = async () => {
       if (!familyId) {
@@ -221,6 +253,22 @@ export default function ActivitiesPage() {
             </Paper>
           )}
         </Box>
+
+        {/* Real-time update notification */}
+        <Snackbar
+          open={!!notification}
+          autoHideDuration={3000}
+          onClose={() => setNotification(null)}
+          anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}
+        >
+          <Alert
+            onClose={() => setNotification(null)}
+            severity="info"
+            sx={{ width: '100%' }}
+          >
+            {notification}
+          </Alert>
+        </Snackbar>
       </AppShell>
     </ProtectedRoute>
   );