Socialflow/task.md

Task: Socialflow - Analytics & Token Management

Context

Implementation of a robust Facebook Page Token management system (automatic renewal) and a new Facebook Analytics module (ingestion & dashboard) to improve platform reliability and value.

Current Focus

Planning and Architecture Definition.

Master Plan

Phase 1: Foundation & Data

• Requirements & Architecture Analysis
• Review Implementation Plan
• [BACKEND] Update Database Schema (Analytics tables, SocialPages extension)
• [BACKEND] Run Drizzle Migration (Pending DB connectivity)

Phase 2: Core Services

• [NEW] server/services/token_manager.ts (Encryption + Refresh Logic)
• [NEW] server/services/analytics.ts (Graph API Fetch, DB Store)
• [NEW] server/utils/graph_client.ts (Typed Graph API Client)
• [MODIFY] server/routes.ts - Register analytics routes
• [NEW] server/cron.ts - Setup Daily Token Check

Phase 3: Frontend

• [NEW] client/src/components/analytics/AnalyticsDashboard.tsx
• [NEW] client/src/components/analytics/MetricsCard.tsx
• [NEW] client/src/pages/AnalyticsPage.tsx & Mobile Version
• [MODIFY] client/src/App.tsx - Add /analytics route
• [MODIFY] client/src/components/sidebar.tsx - Add navigation link

Phase 4: Verification

Phase 4: Verification & Stabilization

• [TEST] Verify implementation builds correctly (npm run build)
• [FIX] Deployment: Implemented automated safe DB migration on startup
• [FIX] Encryption: Unified TokenManager encryption with storage service (Fixed Invalid Token error)
• [FIX] Resilience: Added auto-expiration for invalid tokens in AnalyticsService
• [FIX] Feedback: Improved error reporting in AnalyticsService
• [MANUAL] Validate Analytics Data accuracy through UI

Progress Log

• 20 Jan 2026 - Architecture defined: Service-based approach, Encryption for tokens, Node-cron for scheduling.
• 20 Jan 2026 - Build Fixed: Resolved circular dependencies (db import) and frontend type errors.