igny8/to-do-s/PRE-LAUNCH-AUDIT.md

Pre-Launch System Audit

Date: December 25, 2025
Purpose: Identify functional workflow gaps and improvements for pre-launch QA
Scope: Non-cosmetic, professional, workflow-based issues only

---

Table of Contents

1. Dashboard
2. SETUP Modules
3. WORKFLOW Modules
4. ACCOUNT Modules
5. HELP Module
6. Sidebar & Navigation
7. Summary & Prioritization

---

1. Dashboard

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

Current Functionality

• 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

Critical Gaps

Issue	Impact	Details
No aggregated API endpoint	Performance	Makes 6+ sequential API calls with 120ms delays to avoid rate limiting
Published content count incorrect	Data accuracy	Cannot distinguish published vs draft content
Usage Summary is hardcoded	Misleading	Shows fake "547 credits / $0.34" data
Recent Activity is hardcoded	Misleading	Static mock activity that never updates
No real-time updates	Stale data	Only refreshes on manual action

Missing Professional Features

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

Workflow Issues

1. Quick Actions don't adapt to user state - Shows same 5 actions regardless of workflow stage
2. Workflow Completion % is misleading - Formula doesn't reflect real content-from-keywords ratio
3. Modules Guide not dismissible - 8 large cards always shown, no way to hide
4. Chart widget code exists but unused - Dead code, no trend visualization

Recommendations

Priority 1 - Must Fix:

• Create /v1/dashboard/summary/ aggregated endpoint
• Fix published content count (separate published vs draft)
• Replace hardcoded usage data with real billing data
• Remove or implement real recent activity

Priority 2 - High Value:

• Add "Needs Attention" section (pending reviews, failed syncs, low credits)
• Add actionable pending task count per pipeline stage
• Add automation run status display
• Add WordPress sync health indicator

Priority 3 - UX Polish:

• Make Quick Actions contextual based on workflow state
• Add loading skeleton
• Make Workflow Modules Guide dismissible
• Fix or remove trend chart code

---

2. SETUP Modules

2.1 Add Keywords

Route: /setup/add-keywords
Files: pages/Setup/AddKeywords.tsx
Tabs: None (single page)

Current Functionality

• Displays global seed keywords filtered by active site's industry/sector
• Browse pre-populated keyword database (admin-imported CSV)
• Add selected keywords to Planner workflow
• Tracks already-added keywords
• Bulk selection and bulk add
• Filters: Search, Country, Difficulty
• Admin CSV upload capability

Functional Gaps

Issue	Impact
Sector requirement unclear	Buttons disabled with no tooltip explaining why
No keyword research integration	Can only browse pre-imported seeds, no external discovery
No manual keyword entry	Cannot add custom keywords not in seed database
No keyword details/preview	No SERP features, trends, or related keywords visible
No "already added" filter	Cannot filter to show only not-yet-added keywords

Workflow Issues

• No "Next Step" CTA after adding keywords → users don't know to go to Planner
• No keyword count summary (X in workflow, Y available)

Recommendations

• Add "Next: Plan Your Content →" button after keywords added
• Add "Show not-yet-added only" filter
• Add manual keyword entry form
• Add tooltip explaining disabled state when no sector selected
• Add keyword count summary

---

2.2 Content Settings

Route: /account/content-settings
Files: pages/account/ContentSettingsPage.tsx
Tabs: Content Generation, Publishing, Image Settings

Current Functionality

• Content Generation: Append to prompt, default tone, default length
• Publishing: Auto-publish toggle, keep updated toggle
• Image Settings: Quality, style, sizes, format (DALL-E 2/3/Runware)

Critical Gaps

Issue	Impact	Severity
Content Generation NOT PERSISTED	Settings appear to save but don't - TODO comments in code	🔴 Critical
Publishing NOT PERSISTED	Same issue - no backend API implemented	🔴 Critical
Only Image Settings work	Only tab with actual API integration	🔴 Critical
No per-site settings	Global only, but multi-site users need site-specific	🟠 High

Workflow Issues

• False confidence: Users see "Settings saved successfully" but nothing is saved
• No indication that Content Generation/Publishing tabs are non-functional
• Disconnected from Thinker prompts (which also affect content generation)

Recommendations

• 🔴 CRITICAL: Implement backend endpoints for Content Generation settings
• 🔴 CRITICAL: Implement backend endpoints for Publishing settings
• Either hide non-functional tabs or mark as "Coming Soon"
• Add relationship explanation to Thinker prompts
• Consider per-site overrides

---

2.3 Sites

Route: /sites
Files: pages/Sites/List.tsx, pages/Sites/SiteSettings.tsx, pages/Sites/SiteDashboard.tsx
Tabs: Site Settings has 3 tabs (General, Integrations, Content Types)

Current Functionality

• List all sites with filtering (search, type, hosting, status)
• Create sites via WorkflowGuide (requires industry + sectors)
• Activate/deactivate sites
• Navigate to site dashboard, content, settings
• Settings: Name, URL, SEO, WordPress integration, content type mapping

Functional Gaps

Issue	Impact
Dashboard stats are mock data	getSiteDashboardStats returns hardcoded zeros
No inline editing	Must navigate to settings to change site name
No site cloning	Cannot duplicate site configuration
Duplicate pages	List.tsx and Manage.tsx overlap functionality
No bulk operations	Cannot bulk activate/delete sites

Workflow Issues

• Complex site creation requires industry/sector upfront (users may not know yet)
• Integration tab default after creation confuses non-technical users
• No setup progress indicator showing what's configured vs pending

Recommendations

• Add site setup checklist/progress indicator on cards
• Allow site creation without immediate WordPress setup
• Add inline editing for site name from list
• Remove or merge Manage.tsx if redundant
• Implement real site statistics endpoint
• Add "Skip integration for now" option

---

2.4 Thinker (Admin Only)

Route: /thinker/prompts
Files: pages/Thinker/Prompts.tsx, pages/Thinker/AuthorProfiles.tsx, pages/Thinker/Strategies.tsx, pages/Thinker/ImageTesting.tsx
Tabs: Prompts, Author Profiles, Strategies (Coming Soon), Image Testing (Coming Soon)

Current Functionality

• Prompts: View/edit AI prompt templates (Clustering, Ideas, Content, Images, etc.)
• Author Profiles: CRUD for author profiles (name, description, tone, language)
• Strategies: Coming Soon placeholder
• Image Testing: Coming Soon placeholder

Functional Gaps

Issue	Impact
50% Coming Soon	Strategies + Image Testing are placeholders
No prompt testing	Cannot preview prompt output before saving
No prompt versioning	No history or rollback capability
No per-site prompts	All prompts global, no site-specific variations
Author Profiles not connected	Unclear how/where they're used in workflow
No variable reference	Placeholders like [IGNY8_KEYWORDS] undocumented

Workflow Issues

• Admin-only with no explanation of relationship to Content Settings (user-accessible)
• No prompt categories in UI (hardcoded grouping)
• Strategies/Image Testing pages offer no value

Recommendations

• Either complete or hide Strategies and Image Testing
• Add prompt testing capability (preview with sample data)
• Add prompt version history
• Document relationship between Content Settings and Thinker Prompts
• Show where Author Profiles are used
• Add prompt variable reference documentation

---

SETUP Cross-Module Issues

Issue	Impact
No guided flow	After setup tasks, no clear path to start content workflow
Scattered settings	Content settings split across 3 locations
No onboarding checklist	No unified "Setup Complete" indicator

Setup Completion Checklist Needed:

• Site created
• Industry/Sectors selected
• Integration configured (or skipped)
• Keywords added
• Content settings configured

---

3. WORKFLOW Modules

3.1 Planner

Route: /planner/keywords
Files: pages/Planner/Keywords.tsx, pages/Planner/Clusters.tsx, pages/Planner/ClusterView.tsx, pages/Planner/Ideas.tsx, pages/Planner/KeywordOpportunities.tsx
Tabs: Keywords, Clusters, Ideas (in-page navigation)

Current Functionality

• Keywords: CRUD, bulk status updates, auto-cluster AI, filters
• Clusters: CRUD, bulk operations, auto-generate ideas AI
• Ideas: CRUD, bulk queue to writer, filters
• Flow: Keywords → Auto-Cluster → Clusters → Auto-Generate Ideas → Ideas → Queue to Writer

Functional Gaps

Issue	Impact	Severity
KeywordOpportunities hidden	Page exists at /planner/keyword-opportunities but NOT in navigation tabs	🟠 High
No "Add to Existing Cluster"	Auto-cluster creates new clusters only, can't add to existing	🟡 Medium
No cluster merge/split	Cannot combine or split clusters	🟡 Medium
No cluster progress indicator	Can't see which clusters already have ideas generated	🟠 High
Ideas missing queued count	No indicator of how many are pending vs processed	🟡 Medium

Workflow Issues

• Seed keyword system (KeywordOpportunities) is orphaned from main workflow
• Cluster → Ideas transition unclear (which clusters need ideas?)
• No return path from Ideas to source cluster

Recommendations

• Add KeywordOpportunities to Planner tabs (Critical for onboarding)
• Add "Assign to Cluster" bulk action for existing clusters
• Add Ideas Count badge on Clusters table
• Make cluster name clickable on Ideas page

---

3.2 Writer

Route: /writer/tasks
Files: pages/Writer/Tasks.tsx, pages/Writer/Drafts.tsx, pages/Writer/ContentView.tsx, pages/Writer/Images.tsx, pages/Writer/Review.tsx, pages/Writer/Published.tsx
Tabs: Queue, Drafts, Images, Review, Published

Current Functionality

• Tasks: CRUD, generate content (row action only), generate images bulk
• Drafts: List drafts, view details, status updates
• Images: Grouped by content, image generation
• Review: Status=review filter, publish to WordPress
• Published: Status=published, WordPress sync status

Functional Gaps

Issue	Impact	Severity
No bulk content generation	Must click each row individually, generate_content removed from bulk	🔴 Critical
No content editing	ContentView is read-only, no inline editing	🔴 Critical
No manual task creation	Must go through Ideas, can't create task directly	🟠 High
No content regeneration	Can't regenerate with different params, must delete & re-queue	🟠 High
Review → Published manual only	No simple "Mark as Published" for non-WordPress	🟡 Medium

Workflow Issues

• Status progression confusion (Draft → Review → Published requires different pages)
• ContentView missing actions bar (must return to list for actions)
• Images detached from content workflow
• No send_to_linker action (only send_to_optimizer)

Recommendations

• 🔴 CRITICAL: Add bulk content generation with rate limiting
• 🔴 CRITICAL: Implement inline content editing in ContentView
• Add content action bar (Edit, Regenerate, Add Images, Optimize, Link, Publish)
• Add send_to_linker row action
• Add manual task creation capability

---

3.3 Automation

Route: /automation
Files: pages/Automation/Dashboard.tsx
Tabs: None (single page)

Current Functionality

• Pipeline overview (7 stages: Keywords→Clusters→Ideas→Tasks→Content→Image Prompts→Images)
• Schedule configuration (frequency, time, enable/disable)
• Run controls (Run Now, Pause, Resume)
• Real-time progress polling
• Metrics display and activity log

Functional Gaps

Issue	Impact
No stage-by-stage control	All-or-nothing, can't run individual stages
No review gate config	Stage 7 "Review Gate" has no UI to configure rules
No error recovery	If stage fails, must rerun entire pipeline
No batch size config	Can't throttle items per run
No dry run/preview	Can't see what WOULD process before running
Activity log not filterable	Can't filter by stage, status, or date

Workflow Issues

• Credit estimation unclear (labeled "content pieces" but shows credits?)
• Run history depth unknown, no pagination
• No indication of manual vs automated items

Recommendations

• Add stage toggles (enable/disable individual stages)
• Add preview mode (show items that will process)
• Add retry for failed items (per-item or per-stage)
• Add activity log filters
• Clarify credit vs content labeling

---

3.4 Linker

Route: /linker/content
Files: pages/Linker/Content.tsx, pages/Linker/Dashboard.tsx (not routed)
Tabs: Content only (Dashboard exists but hidden)

Current Functionality

• Content list with link count and version
• Single-item "Add Links" button
• Batch linking capability (code exists, UI unclear)
• Recent results display (last 3)

Functional Gaps

Issue	Impact
Dashboard not exposed	Dashboard.tsx exists but not in navigation
No content filtering	Can't filter by status, cluster, or link count
No bulk selection UI	handleBatchLink exists but no checkboxes
No link preview/management	Shows count but can't view/edit actual links
No "Needs Linking" filter	Can't find content with 0 links easily

Workflow Issues

• Completely separate from Writer, requires manual navigation
• Link results only show "last 3" in session, no persistent history
• No cluster-based linking

Recommendations

• Add content filters (status, cluster, "needs linking")
• Add bulk selection checkboxes
• Add link details modal (show/manage individual links)
• Add "Link All New Content" action
• Integrate into Writer ContentView

---

3.5 Optimizer

Route: /optimizer/content
Files: pages/Optimizer/Content.tsx, pages/Optimizer/AnalysisPreview.tsx (orphaned), pages/Optimizer/Dashboard.tsx (not routed)
Tabs: Content only (Dashboard exists but hidden)

Current Functionality

• Content list with optimization scores
• Entry point selection (auto, writer, wordpress, external, manual)
• Single-item and batch optimize
• Score display (overall, SEO, readability, engagement)

Functional Gaps

Issue	Impact
Dashboard not exposed	Dashboard.tsx exists but not in navigation
AnalysisPreview orphaned	Route exists but no UI link to it
Limited filtering	Only source/search, no score range filter
No optimization history	No before/after comparison
No optimization settings	Can't configure what aspects to optimize
No suggested actions	Scores show but no recommendations

Workflow Issues

• Must navigate to Optimizer separately (disconnected from Writer)
• Analysis vs Optimize confusion (analyze never used)
• No re-optimization control

Recommendations

• Add Analysis Preview link ("Preview Scores" action)
• Add score-based filters ("Score < 70", "Needs SEO")
• Add optimization recommendations
• Add "Optimize All Below Threshold" bulk action
• Integrate into Writer (auto-analyze during draft)

---

WORKFLOW Cross-Module Issues

Issue	Impact
No Planner → Writer visibility	After queuing, must manually switch modules
No Writer → Linker integration	No "Add Links" button in content view
No Writer → Optimizer integration	Optimize exists but no score preview
No cross-module notifications	User doesn't know when AI tasks complete
No breadcrumb navigation	Can't see full workflow path (Cluster → Idea → Task → Content)

Cross-Module Recommendations

• Add global notification system for completed tasks
• Add breadcrumb navigation showing workflow path
• Add "Next Step" suggestions after each action
• Unify content detail view with ALL actions available
• Add workflow progress indicator

---

4. ACCOUNT Modules

4.1 Account Settings

Route: /account/settings
Files: pages/account/AccountSettingsPage.tsx
Tabs: Account, Profile, Team

Current Functionality

• Account Tab: Organization name, billing email, full billing address, tax ID/VAT
• Profile Tab: First/last name, email, phone, timezone, language, notifications, security
• Team Tab: List team members, invite via email, remove members, role display

Functional Gaps

Issue	Impact	Severity
Profile NOT connected to API	Form saves nowhere - fake save with timeout	🔴 Critical
No role assignment on invite	Only email/name collected, no role dropdown	🟠 High
No role editing for members	Cannot change Member to Admin or vice versa	🟠 High
Change Password does nothing	Static button with no functionality	🔴 Critical
No email verification	Can change email without verification	🟠 High
No 2FA option	Security section minimal	🟡 Medium
No account deletion	Cannot close account	🟡 Medium
No session management	Cannot view/revoke active sessions	🟡 Medium

Workflow Issues

• Orphaned TeamManagement.tsx file exists (395 lines, not routed)
• Inconsistent role system (shows Admin/Member but backend returns is_admin boolean)
• No pending invitation status or resend capability
• No team member limit enforcement display

Recommendations

• 🔴 CRITICAL: Implement profile API and connect Profile tab
• 🔴 CRITICAL: Implement password change functionality
• Add role selection to team invitation
• Add invitation management (resend, cancel pending)
• Show team member count vs plan limit
• Delete orphaned TeamManagement.tsx

---

4.2 Plans & Billing

Route: /account/plans
Files: pages/account/PlansAndBillingPage.tsx, pages/Billing/CreditPurchase.tsx
Tabs: Current Plan, Upgrade Plan, History

Current Functionality

• Current Plan: Plan name, status, credits, balance, renewal date, features
• Upgrade: Pricing table, plan comparison, change policy
• History: Invoices with PDF download, payments, payment methods

Functional Gaps

Issue	Impact
No proration preview	Doesn't show prorated amount before upgrade
Credit purchase not linked	/billing/credits exists separately but not linked
Cancellation is immediate	No reason collection, no retention offers
No payment failure retry	If payment fails, no retry UI
No downgrade proration display	Policy exists but no calculation shown

Workflow Issues

• Throttling errors surface directly to users ("Request was throttled. Retrying...")
• Cancel flow has no confirmation dialog
• Payment method supports bank_transfer, manual, stripe, paypal but UI only shows some
• No billing cycle visualization (renewal date not prominent)

Recommendations

• Add proration preview before plan changes
• Add confirmation dialog for cancellation
• Link credit purchase from this page
• Add cancellation reason collection
• Clean up throttling messages (use spinner)

---

4.3 Usage

Route: /account/usage
Files: pages/account/UsageAnalyticsPage.tsx, pages/account/UsageLimits.tsx, pages/account/CreditActivity.tsx
Tabs: Your Limits & Usage, Credit History, API Activity

Current Functionality

• Quick Stats: Credits left, used this month, monthly limit, usage %
• Limits: Hard limits (sites, users, keywords, clusters) + Monthly limits
• Credit History: Transaction log with type, amount, description
• API Activity: Call statistics, endpoint breakdown

Critical Gaps

Issue	Impact	Severity
API Activity is HARDCODED	Shows fake static values (1,234, 567, 342) not real data	🔴 Critical
Success rate is fake	Hardcoded 98.5%	🔴 Critical
No usage alerts	No notification when approaching limits	🟠 High
No per-site usage	Can't see which site consumed what	🟠 High
No per-user usage	Can't see team member individual usage	🟠 High
No usage export	Cannot download usage report	🟡 Medium
No usage forecasting	No "you'll run out in X days"	🟡 Medium

Workflow Issues

• No actionable insights (doesn't suggest upgrade when hitting limits)
• Credit history lacks context (no link to what was generated)
• Disconnected from billing (separate page to upgrade)

Recommendations

• 🔴 CRITICAL: Implement actual API activity tracking or hide tab
• Add usage alerts configuration (email at 80%, 90%, 100%)
• Add per-site/per-user usage breakdown
• Add "Upgrade" CTA when limits approaching
• Add usage export functionality

---

4.4 AI Models (Admin Only)

Route: /settings/integration
Files: pages/Settings/IntegrationPage.tsx
Sections: OpenAI Integration, Runware Integration, Image Generation, Site Integrations

Current Functionality

• OpenAI: Enable/disable, model selection, connection testing, validation
• Runware: Enable/disable, model selection, connection testing
• Image Generation: Service selection, model selection, image settings
• Testing: Generate test images with preview
• Site Integrations: Connected site management

Functional Gaps

Issue	Impact	Severity
Fictional GPT model names	Shows GPT-5.1, GPT-5.2 which don't exist	🔴 Critical
No fallback configuration	If OpenAI fails, no automatic Runware fallback	🟠 High
No cost tracking	Can't see integration costs	🟡 Medium
No integration health history	Only current status, no uptime history	🟡 Medium
No API key rotation	Can't rotate keys without disabling	🟡 Medium
No audit log	No record of when settings changed	🟠 High

Workflow Issues

• Admin-only but affects all users (no scope clarification)
• Page mixes LLM models, image generation, AND site integrations
• Complex modal nesting (settings, details, form all separate)
• No preview of cost impact when changing models

Recommendations

• 🔴 CRITICAL: Fix GPT model names to actual models (gpt-4-turbo, gpt-4, gpt-3.5-turbo)
• Add integration change audit logging
• Add cost estimation when changing models
• Consider separating site integrations to own page
• Add fallback configuration

---

ACCOUNT Cross-Module Issues

Issue	Impact
Multiple credit balance sources	Plans, Usage, billingStore all fetch independently
Fragmented billing pages	PlansAndBillingPage, CreditPurchase, legacy routes
Legacy routes still exist	/billing/overview, /team, /profile all redirect
No audit log across modules	No record of who changed what when
No notification preferences	Cannot configure billing/usage email alerts

---

5. HELP Module

5.1 Help & Docs

Route: /help
Files: pages/Help/HelpCenter.tsx, pages/Help/Documentation.tsx (placeholder), pages/Help/SystemTesting.tsx (placeholder), pages/Help/FunctionTesting.tsx (placeholder)
Routes: /help, /help/docs, /help/system-testing, /help/function-testing

Current Functionality

• Table of Contents with jump-to-section navigation
• Getting Started: Quick Start Guide, Workflow Overview
• Planner Module: Keywords, Clusters, Ideas documentation
• Writer Module: Tasks, Content, Images documentation
• Automation Setup overview
• FAQ section (~20 questions)
• Support CTA buttons (non-functional)

Critical Gaps

Issue	Impact	Severity
Support dropdown link broken	Goes to /profile which has NO route - 404	🔴 Critical
Contact Support button does nothing	<button> with no onClick handler	🔴 Critical
Feature Request button does nothing	Same - no functionality	🔴 Critical
3 of 4 help pages empty	/help/docs, /help/system-testing, /help/function-testing are placeholders	🟠 High
No actual support channel	No email, chat, or ticket system	🔴 Critical

Missing Documentation

Module	Status	Coverage
Thinker	Active	1 FAQ only - no section
Linker	Optional	Not mentioned
Optimizer	Optional	Not mentioned
Publisher	Active	Not documented
Sites/Site Builder	Active	Not documented
Billing/Credits	Active	1 FAQ only
Account Settings	Active	Not documented

Workflow Issues

• No search functionality - Must scroll or use TOC
• No contextual help - No in-app tooltips or "?" icons
• No help sub-navigation - Routes exist but no tabs visible
• Stale content risk - Hardcoded in TSX, requires deployment to update

Recommendations

• 🔴 CRITICAL: Fix Support dropdown link (/profile → /help or support page)
• 🔴 CRITICAL: Implement Contact Support (mailto: or external support URL)
• 🔴 CRITICAL: Add WordPress setup guide
• Document missing modules (Sites, Publisher, Thinker)
• Create Troubleshooting guide
• Add search functionality
• Add credit cost documentation
• Remove or implement placeholder pages

---

6. Sidebar & Navigation

File: layout/AppSidebar.tsx

Current Structure

Dashboard (standalone)
├─ SETUP
│   ├─ Add Keywords → /setup/add-keywords
│   ├─ Content Settings → /account/content-settings
│   ├─ Sites (if site_builder enabled) → /sites
│   └─ Thinker (admin only, if thinker enabled) → /thinker/prompts
├─ WORKFLOW
│   ├─ Planner (if planner enabled) → /planner/keywords
│   ├─ Writer (if writer enabled) → /writer/tasks
│   ├─ Automation (if automation enabled) → /automation
│   ├─ Linker (if linker enabled) → /linker/content
│   └─ Optimizer (if optimizer enabled) → /optimizer/content
├─ ACCOUNT
│   ├─ Account Settings → /account/settings
│   ├─ Plans & Billing → /account/plans
│   ├─ Usage → /account/usage
│   └─ AI Models (admin only) → /settings/integration
└─ HELP
    └─ Help & Docs → /help

Navigation Gaps

Issue	Impact
KeywordOpportunities not in navigation	/planner/keyword-opportunities exists but not accessible
Linker Dashboard not exposed	/linker/dashboard exists but only /linker/content in sidebar
Optimizer Dashboard not exposed	/optimizer/dashboard exists but only /optimizer/content in sidebar
Help sub-pages hidden	/help/docs, /help/system-testing, /help/function-testing not navigable
Credit purchase not in sidebar	/billing/credits exists but not accessible from sidebar

Menu Order Issues

Current Order	Recommended Order	Reason
Add Keywords first in SETUP	Sites first	User should create site before adding keywords
Content Settings before Sites	Content Settings last	Configure after site is set up
Planner before Writer	Planner before Writer ✓	Correct - follows workflow

Missing Navigation Features

Feature	Impact
No breadcrumb navigation	User can't see full path (Cluster → Idea → Task → Content)
No "Next Step" guidance	After completing action, user doesn't know where to go
No active section highlighting	Sidebar doesn't show which section is active
No keyboard navigation	Can't navigate sidebar with keyboard
No recent pages	Can't quickly return to recently visited pages

Recommendations

• Add KeywordOpportunities to Planner sub-navigation
• Consider reordering SETUP: Sites → Add Keywords → Content Settings → Thinker
• Add breadcrumb navigation component
• Add "What's Next?" suggestions after key actions
• Consider exposing Dashboard pages for Linker/Optimizer

---

7. Summary & Prioritization

🔴 CRITICAL - Must Fix Before Launch

#	Issue	Module	Type
1	Content Generation/Publishing settings NOT SAVED	Content Settings	Data Loss
2	Profile tab NOT connected to API	Account Settings	Data Loss
3	Password change does nothing	Account Settings	Security
4	API Activity data is HARDCODED fake	Usage	Misleading Data
5	Support buttons do nothing	Help	No Support Channel
6	Support dropdown goes to 404	Help	Broken Link
7	Fictional GPT model names (GPT-5.1, 5.2)	AI Models	Data Integrity
8	No bulk content generation	Writer	Core Workflow Blocked
9	No content editing capability	Writer	Core Workflow Blocked
10	Dashboard has hardcoded usage/activity data	Dashboard	Misleading Data

🟠 HIGH - Significant Impact on User Experience

#	Issue	Module
11	No role assignment/editing for team members	Account Settings
12	No proration preview for plan changes	Plans & Billing
13	No cancellation confirmation dialog	Plans & Billing
14	KeywordOpportunities hidden from navigation	Planner
15	No cluster progress indicator (which have ideas)	Planner
16	No content regeneration capability	Writer
17	3 of 4 help pages are empty placeholders	Help
18	No dashboard API endpoint (6+ sequential calls)	Dashboard
19	Published content count incorrect	Dashboard
20	No "Needs Attention" section	Dashboard
21	No usage alerts when approaching limits	Usage
22	Sites Dashboard shows mock/zero data	Sites
23	Thinker has 50% "Coming Soon" pages	Thinker
24	No integration audit logging	AI Models

🟡 MEDIUM - Professional Polish Needed

#	Issue	Module
25	No manual keyword entry	Add Keywords
26	No "Next Step" CTA after actions	Add Keywords, Planner
27	No pending invitation management	Account Settings
28	No 2FA option	Account Settings
29	No per-site/per-user usage breakdown	Usage
30	No search in Help	Help
31	Missing module documentation (Sites, Thinker, etc.)	Help
32	Automation has no stage-by-stage control	Automation
33	Linker has no content filtering	Linker
34	Optimizer has no score-based filtering	Optimizer
35	No cross-module notifications	All
36	No breadcrumb navigation	All
37	Quick Actions don't adapt to user state	Dashboard

---

Implementation Phases

Phase 1: Critical Fixes (Must Complete)

Focus: Data integrity, security, core functionality

• Fix Content Settings API (Content Gen + Publishing tabs)
• Fix Profile API connection
• Implement password change
• Remove/fix hardcoded API Activity data
• Implement support channel (mailto or external URL)
• Fix Support dropdown link
• Fix GPT model names
• Add bulk content generation
• Add inline content editing

Phase 2: Core Workflow Improvements

Focus: User workflow efficiency

• Add dashboard aggregated API endpoint
• Add "Needs Attention" widget
• Add KeywordOpportunities to navigation
• Add cluster progress indicators
• Add content regeneration
• Add team role management
• Add plan change proration preview
• Add cancellation confirmation

Phase 3: Professional Polish

Focus: Edge cases and advanced features

• Complete Help documentation
• Add usage alerts
• Add per-site usage breakdown
• Add stage controls to Automation
• Add filtering to Linker/Optimizer
• Add breadcrumb navigation
• Add cross-module notifications

---

Quick Wins (< 1 hour each)

1. Fix Support dropdown link (/profile → /help)
2. Add mailto: to Contact Support button
3. Fix GPT model names (rename to actual models)
4. Add cancellation confirmation dialog
5. Remove/hide API Activity tab until implemented
6. Add KeywordOpportunities to Planner tabs
7. Fix profile save to show "Coming Soon" instead of fake save

---

Files to Delete (Orphaned/Duplicate)

File	Reason
pages/account/TeamManagement.tsx	Orphaned, functionality in AccountSettingsPage
pages/Sites/Manage.tsx	Duplicate of List.tsx
pages/Help/Documentation.tsx	Empty placeholder
pages/Help/SystemTesting.tsx	Empty placeholder
pages/Help/FunctionTesting.tsx	Empty placeholder
pages/Thinker/Strategies.tsx	Empty "Coming Soon"
pages/Thinker/ImageTesting.tsx	Empty "Coming Soon"

---

Total Issues Identified: 37
Critical: 10
High: 14
Medium: 13