salman/igny8
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
627938aa95f62c6f89213024d9d6a7c802485c01
igny8/to-do-s/part2/dashboard_mods.md
IGNY8 VPS (Salman) 7a9fa8fd8f final docs for final audit implemenation
2025-12-27 00:34:22 +00:00

17 KiB
Raw Blame History

Section 1: Dashboard - Audit & Action Plan

Date: December 27, 2025
Status: Finalized for Implementation (To be done LAST after all other sections complete)
Scope: Main dashboard page - metrics, workflow visualization, quick actions

1.1 Current Functionality

Route: /
Files: pages/Dashboard/Home.tsx, components/dashboard/*

What Dashboard Currently Shows

  • Workflow Progress: 6-step pipeline visualization (Sites → Keywords → Clusters → Ideas → Content → Published)
  • Quick Actions: 5 navigation shortcuts
  • Key Metrics: 4 cards (Keywords, Articles, Images, Completion %)
  • Credit Usage: Monthly allowance and usage bar
  • Workflow Modules Guide: 8 info cards explaining modules
  • Onboarding: Site creation wizard for new users

1.2 Critical Gaps

# Issue Impact Priority
1 No aggregated API endpoint Performance - makes 6+ sequential API calls with 120ms delays 🔴 Critical
2 Published content count incorrect Data accuracy - cannot distinguish published vs draft 🔴 Critical
3 Usage Summary is hardcoded Misleading - shows fake "547 credits / $0.34" data 🔴 Critical
4 Recent Activity is hardcoded Misleading - static mock activity that never updates 🔴 Critical
5 No real-time updates Stale data - only refreshes on manual action High

1.3 Missing Professional Features

# Feature Why Important Priority
6 Needs Attention section Users don't know what requires action High
7 Recent content activity No real list of recently created/published content High
8 Error/warning alerts No indication of failed syncs, low credits, config issues High
9 Pipeline queue depth No visibility into items waiting at each stage Medium
10 Automation status No run status, last run time, or items processed Medium
11 Site health/sync status No WordPress sync health indicator Medium

1.4 Workflow Issues

# Issue Priority
12 Quick Actions don't adapt to user state Medium - shows same 5 actions regardless of workflow stage
13 Workflow Completion % is misleading Medium - formula doesn't reflect real content-from-keywords ratio
14 Modules Guide not dismissible Low - 8 large cards always shown, no way to hide
15 Chart widget code exists but unused Low - dead code, no trend visualization

1.5 Issues to Address

Critical (Must Fix)

# Issue Action
1 No aggregated API endpoint Create /v1/dashboard/summary/ endpoint that returns all dashboard data in single call
2 Published content count incorrect Fix query to separate published vs draft status
3 Usage Summary is hardcoded Replace with real billing data from billingStore
4 Recent Activity is hardcoded Implement real activity log OR remove section entirely

High Priority

# Issue Action
5 No real-time updates Add polling or websocket for live updates
6 No "Needs Attention" section Add widget showing: pending reviews, failed syncs, low credits, incomplete setup
7 No recent content activity Show real list of recently created/updated content
8 No error/warning alerts Display alerts for: failed WordPress syncs, approaching limits, config issues

Medium Priority

# Issue Action
9 No pipeline queue depth Show count of items at each workflow stage
10 No automation status Display: last run time, items processed, next scheduled run
11 No site health indicator Show WordPress connection status per site
12 Quick Actions don't adapt Make contextual based on user's workflow state
13 Completion % misleading Revise formula to reflect actual workflow progress

Low Priority

# Issue Action
14 Modules Guide not dismissible Add dismiss/hide option, remember preference
15 Dead chart widget code Either implement trend visualization or remove dead code

1.6 Dashboard Revamp Specification

New Dashboard Layout

┌─────────────────────────────────────────────────────────────────────────────┐
│ DASHBOARD                                                                    │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │ NEEDS ATTENTION (if any)                                             │   │
│  │ ⚠ 3 content pieces pending review                          [View →] │   │
│  │ ⚠ WordPress sync failed for Site A                    [Retry] [Fix] │   │
│  │ ⚠ Credit usage at 85%                                  [Upgrade →]  │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐      │
│  │  Keywords    │ │  Articles    │ │   Images     │ │  Completion  │      │
│  │    156       │ │     43       │ │    127       │ │     68%      │      │
│  │  +12 this mo │ │  +8 this mo  │ │  +24 this mo │ │  ↑ from 52%  │      │
│  └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘      │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │ WORKFLOW PIPELINE                                                    │   │
│  │ Sites(2) → Keywords(156) → Clusters(23) → Ideas(67) → Content(43) → Published(38) │
│  │   ✓           ✓              ✓             12 pending   5 pending    │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  ┌────────────────────────────┐ ┌────────────────────────────────────┐    │
│  │ CONTENT USAGE              │ │ QUICK ACTIONS                      │    │
│  │ ████████████░░░░ 68/100    │ │ [+ Add Keywords]                   │    │
│  │ 68 used this month         │ │ [Generate Content] ← contextual    │    │
│  │ Resets in 12 days          │ │ [Review Drafts] (5)                │    │
│  └────────────────────────────┘ │ [View Published]                   │    │
│                                  └────────────────────────────────────┘    │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │ RECENT ACTIVITY                                                      │   │
│  │ • Generated 5 articles from "Product Reviews" cluster    2 hours ago │   │
│  │ • Published "Best Running Shoes 2025" to Site A          3 hours ago │   │
│  │ • Created 12 ideas from keyword clustering               Yesterday   │   │
│  │ • Automation run completed: 8 articles generated         Yesterday   │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │ AUTOMATION STATUS                                                    │   │
│  │ Status: ● Active    Last run: 2 hours ago    Next: Tomorrow 9:00 AM │   │
│  │ Last run: Processed 15 keywords → 3 clusters → 12 ideas → 8 articles │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Dashboard Components

Component Purpose Data Source
Needs Attention Actionable alerts requiring user action Aggregated from all modules
Key Metrics Overview counts Aggregated API endpoint
Workflow Pipeline Visual progress through stages Aggregated API endpoint
Content Usage Credit/content piece usage billingStore (single source of truth)
Quick Actions Contextual navigation shortcuts Based on workflow state
Recent Activity Real activity log Activity tracking system
Automation Status Automation module summary Automation service

1.7 Aggregated API Endpoint

Endpoint: GET /v1/dashboard/summary/

Response Structure:

{
  "metrics": {
    "keywords_total": 156,
    "keywords_this_month": 12,
    "articles_total": 43,
    "articles_this_month": 8,
    "articles_draft": 5,
    "articles_published": 38,
    "images_total": 127,
    "images_this_month": 24,
    "completion_percentage": 68
  },
  "pipeline": {
    "sites": 2,
    "keywords": 156,
    "clusters": 23,
    "ideas": 67,
    "ideas_pending": 12,
    "content": 43,
    "content_pending": 5,
    "published": 38
  },
  "usage": {
    "credits_used": 68,
    "credits_total": 100,
    "reset_days": 12
  },
  "alerts": [
    {
      "type": "pending_review",
      "message": "3 content pieces pending review",
      "action_url": "/writer/review",
      "action_label": "View"
    },
    {
      "type": "sync_failed",
      "message": "WordPress sync failed for Site A",
      "action_url": "/sites/1/settings",
      "action_label": "Fix"
    }
  ],
  "recent_activity": [
    {
      "type": "content_generated",
      "message": "Generated 5 articles from 'Product Reviews' cluster",
      "timestamp": "2025-12-27T10:30:00Z"
    }
  ],
  "automation": {
    "status": "active",
    "last_run": "2025-12-27T08:00:00Z",
    "next_run": "2025-12-28T09:00:00Z",
    "last_run_summary": "15 keywords → 3 clusters → 12 ideas → 8 articles"
  }
}

1.8 "Needs Attention" Widget Specification

Alert Types

Type Trigger Message Action
pending_review Content in review status > 0 "X content pieces pending review" Link to Writer > Review
sync_failed WordPress sync error "WordPress sync failed for [Site]" Link to Site Settings
low_credits Usage > 80% "Credit usage at X%" Link to Upgrade
credits_exhausted Usage = 100% "Monthly content limit reached" Link to Upgrade
setup_incomplete Setup checklist incomplete "Complete your setup" Link to incomplete item
automation_failed Last automation run had errors "Automation encountered errors" Link to Automation

Display Rules

  • Show maximum 3-4 alerts at a time
  • Prioritize by severity: errors > warnings > info
  • Dismissible alerts (remember dismissal for session)
  • Empty state: Hide section entirely when no alerts

1.9 Quick Actions - Contextual Logic

Logic for Displaying Actions

IF no sites exist:
  → "Create Your First Site"
  
ELSE IF no keywords:
  → "Add Keywords"
  
ELSE IF keywords but no clusters:
  → "Cluster Keywords"
  
ELSE IF clusters but no ideas:
  → "Generate Ideas"
  
ELSE IF ideas but no content:
  → "Generate Content"
  
ELSE IF content in draft:
  → "Review Drafts (X)"
  
ELSE IF content in review:
  → "Publish Content (X)"
  
ALWAYS show:
  → "View Published" (if any published)
  → "Run Automation" (if automation configured)

Default Actions (Always Available)

  • Add Keywords
  • View Planner
  • View Writer
  • Settings

1.10 Implementation Notes

Data Flow

  1. On Dashboard Load:

    • Single API call to /v1/dashboard/summary/
    • Populate all widgets from response
    • No sequential calls, no delays

  2. Real-time Updates (Optional):

    • Poll every 60 seconds for updates
    • OR use WebSocket for push updates
    • Update only changed data

  3. Credit Usage:

    • Use billingStore as single source of truth
    • Dashboard reads from store, doesn't fetch separately

Performance Requirements

  • Dashboard should load in < 2 seconds
  • Single API call instead of 6+ sequential calls
  • Lazy load Modules Guide (below fold)
  • Cache dashboard data for 30 seconds

Summary

Total Issues

Category Critical High Medium Low Total
Data Issues 4 0 0 0 4
Missing Features 0 4 4 0 8
UX Issues 0 0 2 2 4
TOTAL 4 4 6 2 16

Critical Items (Must Fix)

  1. Create aggregated dashboard API endpoint
  2. Fix published content count (distinguish published vs draft)
  3. Replace hardcoded usage summary with real data
  4. Replace hardcoded recent activity with real data OR remove

High Priority Items

  1. Add "Needs Attention" widget
  2. Implement real recent activity log
  3. Add error/warning alerts display
  4. Add real-time or polling updates

Medium Priority Items

  1. Show pipeline queue depth (items at each stage)
  2. Add automation status display
  3. Add site health/sync indicator
  4. Make Quick Actions contextual
  5. Fix completion percentage formula
  6. Integrate Setup Completion Checklist

Files to Create

File Purpose
components/dashboard/NeedsAttention.tsx Alerts widget
components/dashboard/AutomationStatus.tsx Automation summary widget
components/dashboard/RecentActivity.tsx Real activity log
Backend: api/views/dashboard.py Aggregated endpoint

Files to Modify

File Changes
pages/Dashboard/Home.tsx Complete revamp with new layout
components/dashboard/CreditBalanceWidget.tsx Connect to billingStore single source
components/dashboard/WorkflowProgress.tsx Add queue depth indicators
components/dashboard/QuickActions.tsx Add contextual logic
components/dashboard/KeyMetrics.tsx Connect to aggregated API

Backend Work Required

Area Work
Aggregated API Create /v1/dashboard/summary/ endpoint
Activity Logging Ensure all actions are logged for activity feed
Alert Aggregation Collect alerts from all modules
Pipeline Counts Query for items at each workflow stage

Dependencies

Dashboard should be implemented LAST because it depends on:

  • Section 2 (SETUP): Setup Completion Checklist
  • Section 3 (WORKFLOW): Pipeline data, activity logging
  • Section 4 (ACCOUNT): Credit balance single source of truth
  • Section 6 (Navigation): Consistent navigation patterns
Reference in New Issue View Git Blame Copy Permalink