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

162 lines
4.6 KiB
Markdown

# 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)
4. `AutomationPage.tsx` - Simplify (remove metrics & history)
5. `Sites/Settings.tsx` - Remove Publishing tab
6. `AccountSettingsPage.tsx` - Consolidate 3 pages
7. `App.tsx` - Update routes
8. `AppSidebar.tsx` - Update menu
9. `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)
4. Create Pipeline Settings page
5. Simplify Run Now page
6. Update Stage 8 labels
### Phase 3: Polish (2-3 hours)
7. Consolidate Account Settings
8. Move Notifications to HELP
9. 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)