Files
igny8/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_REFACTOR_SUMMARY.md
2026-01-17 03:49:50 +00:00

4.6 KiB

Navigation Refactoring - Quick Summary

What's Changing?

1. New Automation Overview Page 📊

  • Comprehensive dashboard showing everything about automation
  • Current site data status (keywords, clusters, ideas, etc.)
  • Cost estimation - what will be processed & how much it costs
  • Last run details - complete breakdown per stage (items processed, created, credits used)
  • Run history table - last 10-20 runs with details
  • Similar to site dashboard and homepage design

2. Publish Settings Moved 🔧

  • From: /sites/:id/settings?tab=publishing
  • To: /publisher/publish-settings (in PUBLISHER dropdown)
  • Why: Makes more sense with publisher workflow + fixes bug where site selector changed all sites
  • New: Uses store-based site awareness (only affects current view)

3. Automation Reorganized

3 focused pages:

  • Overview - Comprehensive dashboard (NEW)
  • Pipeline Settings - 7 stage toggles + batch config (from ConfigModal)
  • Run Now - Simplified, just stage cards + controls (metrics & history moved to Overview)

4. Publisher Section Created 📅

Groups all publishing workflow:

  • Content Review
  • Publish / Schedule
  • Publish Settings (NEW here)
  • Content Calendar

5. Account Consolidated 👤

  • From: 3 separate pages with tabs
  • To: 1 page with 3 cards (Account Info, Profile, Team)
  • Benefit: Less clicking, faster access

6. Stage 8 Consistency 🎯

  • Card title: "Stage 8" (instead of "Scheduled")
  • Right label: "Approved → Scheduled" (consistent with other stages)

7. Notifications Moved 🔔

  • From ACCOUNT section → HELP section

New Sidebar Structure

PUBLISHER (NEW)
├── Content Review
├── Publish / Schedule
├── Publish Settings ← NEW HERE
└── Content Calendar

AUTOMATION (REORGANIZED)
├── Overview ← NEW DASHBOARD
├── Pipeline Settings ← FROM MODAL
└── Run Now ← SIMPLIFIED

ACCOUNT (SIMPLIFIED)
├── Account Settings ← SINGLE PAGE NOW
├── Plans & Billing
├── Usage
└── AI Models

HELP (UPDATED)
├── Notifications ← MOVED HERE
└── Help & Docs

Files to Create (3)

  1. AutomationOverview.tsx - NEW comprehensive dashboard
  2. PipelineSettings.tsx - Extract from ConfigModal
  3. PublishSettings.tsx - Extract from Sites/Settings.tsx

Files to Modify (6)

  1. AutomationPage.tsx - Simplify (remove metrics & history)
  2. Sites/Settings.tsx - Remove Publishing tab
  3. AccountSettingsPage.tsx - Consolidate 3 pages
  4. App.tsx - Update routes
  5. AppSidebar.tsx - Update menu
  6. AppHeader.tsx - Update site selector

Key Benefits

For Users:

  • Transparency: See exactly what automation did (items processed, credits used, output status)
  • Better Organization: Related features grouped logically
  • Simpler Navigation: Less drilling down through menus
  • Bug Fix: Publish Settings site selector works correctly now

For Development:

  • Clearer Code: Separated concerns (Overview vs Run Now vs Settings)
  • Easier Maintenance: Each page has focused purpose
  • Better Testing: Isolated functionality easier to test
  • Future-Proof: Easier to add features to appropriate sections

Implementation Order

Phase 1: Core Features (6-8 hours)

  1. Create Automation Overview page
  2. Create Publish Settings page (fixes bug)
  3. Update routes and sidebar navigation

Phase 2: Refinement (3-4 hours)

  1. Create Pipeline Settings page
  2. Simplify Run Now page
  3. Update Stage 8 labels

Phase 3: Polish (2-3 hours)

  1. Consolidate Account Settings
  2. Move Notifications to HELP
  3. Final testing and documentation

Total: 11-15 hours (can be split across multiple sessions)


Testing Focus Areas

Critical:

  • Publish Settings site selector (must fix bug)
  • Automation Overview metrics accuracy
  • Cost estimation calculations
  • Last run details per stage

Important:

  • All navigation links work
  • No broken routes
  • Run Now controls still work
  • Stage cards update correctly

Nice to Have:

  • Breadcrumbs consistent
  • Loading states smooth
  • Responsive design
  • Dark mode

Questions Before Starting?

  1. Cost estimation - Use existing API or create new endpoint?
  2. Last run details - Extend API or new endpoint for per-stage breakdown?
  3. Timeline - Prefer doing all at once or phase by phase?
  4. Testing - Any specific scenarios to test?

Status: 📋 Plan complete and ready for implementation

Next Step: Approve plan and start Phase 1 (Automation Overview + Publish Settings)