183 lines
9.6 KiB
Markdown
183 lines
9.6 KiB
Markdown
# Page Requirements - Site & Sector Selectors
|
|
|
|
**Last Verified:** December 27, 2025
|
|
**Version:** 1.2.0
|
|
|
|
This document outlines all pages in the application and their requirements for site/sector selectors.
|
|
|
|
## Legend
|
|
- **Site Selector**: Whether the page needs a site selector dropdown
|
|
- **Sector Selector**: Whether the page needs a sector selector dropdown
|
|
- **Implementation**: How the selectors should behave on this page
|
|
- **Next Action**: Recommended workflow guidance for Planner/Writer pages
|
|
|
|
---
|
|
|
|
## Planner Module (Content Planning)
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Keywords | `/planner/keywords` | ✅ Required | ✅ Required | Filter keywords by site/sector | `{count} selected → Auto-Cluster` OR `{clustered} clustered → Generate Ideas` |
|
|
| Clusters | `/planner/clusters` | ✅ Required | ✅ Required | Filter clusters by site/sector | `{count} selected → Expand Clusters` OR `{ready} ready → Generate Ideas` |
|
|
| Cluster Detail | `/planner/clusters/:id` | ✅ Read-only | ✅ Read-only | Display only (inherited from cluster) | `Back to Clusters` OR `Generate Ideas from Cluster` |
|
|
| Ideas | `/planner/ideas` | ✅ Required | ✅ Required | Filter ideas by site/sector | `{count} selected → Create Tasks` OR `{approved} approved → Create Tasks` |
|
|
|
|
---
|
|
|
|
## Writer Module (Content Creation)
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Tasks | `/writer/tasks` | ✅ Required | ✅ Required | Filter tasks by site/sector | `{count} selected → Generate Content` OR `{ready} ready → Generate Content` |
|
|
| Content | `/writer/content` | ✅ Required | ✅ Required | Filter content by site/sector | `{count} selected → Generate Images` OR `{draft} drafts → Add Images` |
|
|
| Images | `/writer/images` | ✅ Required | ✅ Required | Filter images by site/sector | `{count} selected → Submit for Review` OR `{ready} ready → Submit for Review` |
|
|
| Review | `/writer/review` | ✅ Required | ✅ Required | Filter review items by site/sector | `{count} selected → Approve Selected` OR `{reviewed} reviewed → Approve All` |
|
|
| Approved | `/writer/approved` | ✅ Required | ✅ Required | Filter approved items by site/sector | `{count} selected → Sync to WordPress` OR `View All Sites` |
|
|
|
|
---
|
|
|
|
## Linker Module (Internal Linking)
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Content List | `/linker/content` | ✅ Required | ✅ Optional | Filter content by site/sector | N/A |
|
|
|
|
---
|
|
|
|
## Optimizer Module (Content Optimization)
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Content Selector | `/optimizer/content` | ✅ Required | ✅ Optional | Filter content for optimization | N/A |
|
|
| Analysis Preview | `/optimizer/analyze/:id` | ✅ Read-only | ❌ Not needed | Display only (inherited from content) | N/A |
|
|
|
|
---
|
|
|
|
## Thinker Module (AI Configuration) - Admin Only
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Prompts | `/thinker/prompts` | ❌ Global | ❌ Global | System-wide prompts | N/A |
|
|
| Author Profiles | `/thinker/author-profiles` | ❌ Global | ❌ Global | System-wide profiles | N/A |
|
|
| Strategies | `/thinker/strategies` | ❌ Global | ❌ Global | System-wide strategies | N/A |
|
|
| Image Testing | `/thinker/image-testing` | ❌ Global | ❌ Global | Testing interface | N/A |
|
|
|
|
---
|
|
|
|
## Sites Module (Site Management)
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Site List | `/sites` | ❌ Shows all | ❌ Not applicable | Lists all sites | N/A |
|
|
| Site Dashboard | `/sites/:id` | ✅ Read-only | ❌ Not needed | Inherited from route param | N/A |
|
|
| Site Content | `/sites/:id/content` | ✅ Read-only | ✅ Optional | Filter by sector within site | N/A |
|
|
| Page Manager | `/sites/:id/pages` | ✅ Read-only | ❌ Not needed | Inherited from route param | N/A |
|
|
| Site Settings | `/sites/:id/settings` | ✅ Read-only | ❌ Not needed | Inherited from route param | N/A |
|
|
| Sync Dashboard | `/sites/:id/sync` | ✅ Read-only | ❌ Not needed | Inherited from route param | N/A |
|
|
| Deployment Panel | `/sites/:id/deploy` | ✅ Read-only | ❌ Not needed | Inherited from route param | N/A |
|
|
|
|
---
|
|
|
|
## Account & Billing
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Account Settings | `/account/settings` | ❌ Not needed | ❌ Not needed | Account-level settings | N/A |
|
|
| Plans & Billing | `/account/plans` | ❌ Not needed | ❌ Not needed | Account-level billing | N/A |
|
|
| Purchase Credits | `/account/purchase-credits` | ❌ Not needed | ❌ Not needed | Account-level purchase | N/A |
|
|
| Usage Analytics | `/account/usage` | ✅ Optional | ❌ Not needed | Filter usage by site | N/A |
|
|
| Content Settings | `/account/content-settings` | ❌ Not needed | ❌ Not needed | Account-level settings | N/A |
|
|
|
|
---
|
|
|
|
## Settings (Admin)
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| General Settings | `/settings` | ❌ Not needed | ❌ Not needed | System-wide settings | N/A |
|
|
| Users | `/settings/users` | ❌ Not needed | ❌ Not needed | User management | N/A |
|
|
| Subscriptions | `/settings/subscriptions` | ❌ Not needed | ❌ Not needed | Subscription management | N/A |
|
|
| System | `/settings/system` | ❌ Not needed | ❌ Not needed | System configuration | N/A |
|
|
| Account | `/settings/account` | ❌ Not needed | ❌ Not needed | Account settings | N/A |
|
|
| AI Settings | `/settings/ai` | ❌ Not needed | ❌ Not needed | AI model configuration | N/A |
|
|
| Plans | `/settings/plans` | ❌ Not needed | ❌ Not needed | Plan management | N/A |
|
|
| Industries | `/settings/industries` | ❌ Not needed | ❌ Not needed | Industry reference data | N/A |
|
|
| Integration | `/settings/integration` | ❌ Not needed | ❌ Not needed | API integrations | N/A |
|
|
| Publishing | `/settings/publishing` | ❌ Not needed | ❌ Not needed | Publishing defaults | N/A |
|
|
| Sites | `/settings/sites` | ❌ Not needed | ❌ Not needed | Site configuration | N/A |
|
|
|
|
---
|
|
|
|
## Reference Data
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Seed Keywords | `/reference/seed-keywords` | ✅ Optional | ✅ Optional | Filter reference keywords | N/A |
|
|
| Industries | `/reference/industries` | ❌ Not needed | ❌ Not needed | Global reference data | N/A |
|
|
|
|
---
|
|
|
|
## Setup
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Add Keywords | `/setup/add-keywords` | ✅ Required | ✅ Required | Target site/sector for import | N/A |
|
|
|
|
---
|
|
|
|
## Other Pages
|
|
|
|
| Page | Route | Site Selector | Sector Selector | Implementation | Recommended Next Action |
|
|
|------|-------|---------------|-----------------|----------------|-------------------------|
|
|
| Home Dashboard | `/` | ✅ Optional | ❌ Not needed | Overview all sites or filter | N/A |
|
|
| Help | `/help` | ❌ Not needed | ❌ Not needed | Documentation | N/A |
|
|
| Components | `/components` | ❌ Not needed | ❌ Not needed | Design system showcase | N/A |
|
|
|
|
---
|
|
|
|
## Implementation Notes
|
|
|
|
### Site Selector Behavior
|
|
- **Required**: User must select a site before content is displayed
|
|
- **Optional**: Shows all sites by default, can filter to specific site
|
|
- **Read-only**: Shows the current site but cannot be changed (inherited from route/context)
|
|
- **Not needed**: Page operates at account/system level
|
|
|
|
### Sector Selector Behavior
|
|
- **Required**: User must select both site and sector
|
|
- **Optional**: Shows all sectors by default within selected site
|
|
- **Read-only**: Shows current sector but cannot be changed
|
|
- **Not needed**: Page doesn't operate at sector level
|
|
|
|
### Next Action Patterns (Planner/Writer)
|
|
The next action button should follow this pattern:
|
|
1. If items are selected → Action on selected items
|
|
2. If no selection but ready items exist → Workflow progression action
|
|
3. If nothing actionable → Hide or disable
|
|
|
|
Example:
|
|
```tsx
|
|
nextAction={selectedIds.length > 0 ? {
|
|
label: 'Process Selected',
|
|
message: `${selectedIds.length} items selected`,
|
|
onClick: handleBulkAction,
|
|
} : workflowStats.ready > 0 ? {
|
|
label: 'Continue to Next Step',
|
|
href: '/next/page',
|
|
message: `${workflowStats.ready} items ready`,
|
|
} : undefined}
|
|
```
|
|
|
|
---
|
|
|
|
## Workflow Pipeline (Planner → Writer)
|
|
|
|
```
|
|
Keywords → Clusters → Ideas → Tasks → Content → Images → Review → Approved
|
|
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
|
|
Cluster Expand Create Generate Generate Submit Approve Sync to
|
|
Keywords Ideas Tasks Content Images Review Content WordPress
|
|
```
|
|
|
|
Each page's "next action" guides users through this pipeline.
|