VErsion 1.3.2

2026-01-03 09:35:43 +00:00
parent f1ba0aa531
commit f10916bfab
12 changed files with 957 additions and 110 deletions
--- a/docs/30-FRONTEND/PAGES.md
+++ b/docs/30-FRONTEND/PAGES.md
@@ -1,7 +1,7 @@
 # Frontend Pages & Routes

-**Last Verified:** January 1, 2026  
-**Version:** 1.3.0  
+**Last Verified:** January 3, 2026  
+**Version:** 1.3.2  
 **Framework:** React 19 + TypeScript + React Router 6 + Vite

 ---
@@ -60,6 +60,27 @@ Routes defined in `/frontend/src/App.tsx`:

 ## SETUP Routes

+### Onboarding Wizard (NEW v1.3.2)
+
+| Route | File | Description |
+|-------|------|-------------|
+| `/setup/wizard` | `Setup/SetupWizard.tsx` | 5-step onboarding wizard for new users |
+
+**Steps:**
+1. **Welcome** - Feature overview, get started CTA
+2. **Add Site** - Site name, industry/sector selection, creates site with defaults
+3. **Connect Integration** - WordPress plugin installation (optional, can skip)
+4. **Add Keywords** - Initial keyword entry with paste support (optional)
+5. **Complete** - Success summary, next steps, go to dashboard
+
+**Components:** `frontend/src/components/onboarding/`
+- `OnboardingWizard.tsx` - Main wizard container and state
+- `steps/Step1Welcome.tsx` - Welcome screen
+- `steps/Step2AddSite.tsx` - Site creation with SelectDropdown + Badge sectors
+- `steps/Step3ConnectIntegration.tsx` - WordPress setup
+- `steps/Step4AddKeywords.tsx` - Keyword input
+- `steps/Step5Complete.tsx` - Completion summary
+
 ### Add Keywords

 | Route | File | Description |
@@ -86,11 +107,19 @@ Routes defined in `/frontend/src/App.tsx`:
 | Route | File | Description |
 |-------|------|-------------|
 | `/sites` | `Sites/List.tsx` | Site listing with setup checklist per site |
-| `/sites/:id/dashboard` | `Sites/Dashboard.tsx` | Site overview with setup checklist |
-| `/sites/:id/settings` | `Sites/Settings.tsx` | Site settings (General, Integrations, Content Types) |
+| `/sites/:id` | `Sites/Dashboard.tsx` | Site dashboard with quick actions and widgets |
+| `/sites/:id/settings` | `Sites/Settings.tsx` | Site settings (General, Integrations, Publishing, Content Types) |
+
+**v1.3.2 Changes:**
+- Site Dashboard redesigned with SiteInfoBar component
+- Quick actions now 2-column card grid layout
+- AI Operations widget loads real data from getDashboardStats API
+- Fixed race condition in async loadSiteData
+- Settings page has new Publishing Settings tab

 **Components:**
 - `SiteSetupChecklist` - Shows setup progress (site created, industry/sectors, WordPress, keywords)
+- `SiteInfoBar` - Reusable site info header for site-specific pages

 ### Thinker (Admin Only)

@@ -136,7 +165,42 @@ Routes defined in `/frontend/src/App.tsx`:

 | Route | File | Description |
 |-------|------|-------------|
-| `/automation` | `Automation/Dashboard.tsx` | 7-stage pipeline, schedule config, run controls |
+| `/automation` | `Automation/AutomationPage.tsx` | 7-stage pipeline, schedule config, run controls |
+
+---
+
+## PUBLISHER Routes (NEW v1.3.2)
+
+### Content Calendar
+
+| Route | File | Description |
+|-------|------|-------------|
+| `/publisher` | → `/publisher/content-calendar` | Redirect |
+| `/publisher/content-calendar` | `Publisher/ContentCalendar.tsx` | Content calendar with scheduling |
+
+**Features:**
+- Calendar view with month navigation
+- List view with drag-and-drop reordering
+- Schedule content by dragging to calendar dates
+- Unschedule content from queue
+- Stats: scheduled, publishing, published counts
+- Filter by site (inherited from layout)
+
+**Content Status Fields:**
+- `status`: `draft | review | approved | published` (workflow status)
+- `site_status`: `not_published | scheduled | publishing | published | failed` (publishing status)
+- `scheduled_publish_at`: DateTime for scheduled publishing
+
+**API Integration:**
+- `POST /api/v1/writer/content/{id}/schedule/` - Schedule content
+- `POST /api/v1/writer/content/{id}/unschedule/` - Remove from schedule
+- `GET /api/v1/writer/content/?status__in=approved,published` - Multi-status filter
+
+### Legacy Redirects
+
+| Old Route | Redirects To |
+|-----------|--------------|
+| `/sites/:id/publishing-queue` | `/publisher/content-calendar` |

 ### Linker (Optional Module)

@@ -269,9 +333,20 @@ These routes redirect to their new locations:
 | `/profile` | `/account/settings` |
 | `/import-export` | `/account/settings` |
 | `/billing/overview` | `/account/plans` |
-| `/billing/credits` | `/account/plans` (separate page exists at `Billing/CreditPurchase.tsx`) |
+| `/billing/credits` | `/account/plans` |
 | `/billing/history` | `/account/plans` |
 | `/publishing` | `/account/content-settings` |
+| `/writer/published` | `/writer/approved` |
+| `/sites/:id/publishing-queue` | `/publisher/content-calendar` |
+
+---
+
+## Internal Pages (Non-Indexed)
+
+| Route | File | Description |
+|-------|------|-------------|
+| `/ui-elements` | `UIElements.tsx` | Design system reference page |
+| `/components` | `Components.tsx` | Component showcase |

 ---

@@ -282,6 +357,7 @@ frontend/src/pages/
 ├── account/
 │   ├── AccountSettingsPage.tsx     # Account, Profile, Team tabs
 │   ├── ContentSettingsPage.tsx     # Content Gen, Publishing, Images tabs
+│   ├── NotificationsPage.tsx       # Full notifications with filters
 │   ├── PlansAndBillingPage.tsx     # Plan, Upgrade, History tabs
 │   ├── UsageAnalyticsPage.tsx      # Limits, Credit History, API tabs
 │   ├── UsageLimits.tsx             # Limits tab component
@@ -293,7 +369,7 @@ frontend/src/pages/
 │   ├── ResetPassword.tsx
 │   └── VerifyEmail.tsx
 ├── Automation/
-│   └── Dashboard.tsx
+│   └── AutomationPage.tsx
 ├── Billing/
 │   └── CreditPurchase.tsx
 ├── Dashboard/
@@ -310,28 +386,34 @@ frontend/src/pages/
 ├── Planner/
 │   ├── Keywords.tsx
 │   ├── Clusters.tsx
-│   ├── ClusterView.tsx
+│   ├── ClusterDetail.tsx
 │   └── Ideas.tsx
+├── Publisher/                       # NEW v1.3.2
+│   └── ContentCalendar.tsx
 ├── Settings/
 │   └── IntegrationPage.tsx         # AI Models (admin)
 ├── Setup/
-│   └── IndustriesSectorsKeywords.tsx  # Add Keywords page
+│   ├── IndustriesSectorsKeywords.tsx  # Add Keywords page
+│   └── SetupWizard.tsx             # NEW v1.3.2 - Onboarding wizard
 ├── Sites/
 │   ├── List.tsx                    # Site listing
-│   ├── Dashboard.tsx               # Site overview + checklist
-│   └── Settings.tsx                # Site configuration
+│   ├── Dashboard.tsx               # Site overview + quick actions
+│   ├── Settings.tsx                # Site config with Publishing tab
+│   ├── Content.tsx                 # Site content listing
+│   └── SyncDashboard.tsx           # Sync status
 ├── Thinker/
 │   ├── Prompts.tsx
 │   ├── AuthorProfiles.tsx
 │   ├── Strategies.tsx              # Coming Soon
 │   └── ImageTesting.tsx            # Coming Soon
-└── Writer/
-    ├── Tasks.tsx
-    ├── Drafts.tsx
-    ├── ContentView.tsx
-    ├── Images.tsx
-    ├── Review.tsx
-    └── Approved.tsx           # Renamed from Published.tsx (v1.2.0)
+├── Writer/
+│   ├── Tasks.tsx
+│   ├── Content.tsx
+│   ├── ContentView.tsx
+│   ├── Images.tsx
+│   ├── Review.tsx
+│   └── Approved.tsx                # Renamed from Published.tsx (v1.2.0)
+└── UIElements.tsx                   # NEW v1.3.2 - Design system ref
 ```

 ---
@@ -353,14 +435,15 @@ frontend/src/pages/

 ---

-## Navigation Structure (Sidebar)
+## Navigation Structure (Sidebar v1.3.2)

 ```
 Dashboard
 ├── SETUP
+│   ├── Setup Wizard [first-time users]
 │   ├── Add Keywords
 │   ├── Content Settings
-│   ├── Sites [if site_builder enabled]
+│   ├── Sites
 │   └── Thinker [admin only, if thinker enabled]
 ├── WORKFLOW
 │   ├── Planner [if planner enabled]
@@ -368,9 +451,12 @@ Dashboard
 │   ├── Writer [if writer enabled]
 │   │   └── In-page: Queue → Drafts → Images → Review → Approved
 │   ├── Automation [if automation enabled]
+│   ├── Publisher
+│   │   └── Content Calendar
 │   ├── Linker [if linker enabled]
 │   └── Optimizer [if optimizer enabled]
 ├── ACCOUNT
+│   ├── Notifications
 │   ├── Account Settings (Account → Profile → Team)
 │   ├── Plans & Billing (Plan → Upgrade → History)
 │   ├── Usage (Limits → Credit History → API Activity)
@@ -381,11 +467,15 @@ Dashboard

 ---

-## Known Issues (from Audit)
+## Component Updates (v1.3.2)

-1. **Linker/Optimizer Dashboards** exist but not exposed in navigation
-2. **Help sub-pages** are placeholders
-3. **ContentView** is read-only (no editing capability)
-4. Legacy redirects may cause confusion
+**New Components:**
+- `SiteInfoBar` - Reusable site info header for site-specific pages
+- `IconButton` - Icon-only button component
+- `CalendarItemTooltip` - Tooltip for calendar items
+- `OnboardingWizard` + 5 step components

-See `/PRE-LAUNCH-AUDIT.md` for complete issue list.
+**Updated Components:**
+- All components updated for semantic color tokens
+- Badge, Button, Card use design system colors
+- 100+ files with color standardization