igny8/to-do-s/part1/SECTION_2_FINAL_MODS.md

# Section 2: SETUP Modules - Audit & Action Plan

**Date:** December 27, 2025  
**Status:** Finalized for Implementation  
**Scope:** Add Keywords, Content Settings, Sites (Thinker excluded - admin only)

---

## 2.1 Add Keywords

**Route:** `/setup/add-keywords`  
**File:** `pages/Setup/AddKeywords.tsx`

### Current Functionality
- Browse pre-populated seed keywords from global database (admin-imported CSV)
- Filter by active site's industry/sector
- Bulk select and add keywords to Planner workflow
- Tracks which keywords are already added
- Filters: Search, Country, Difficulty

### Important Clarification
- **This page:** Browse/select from global seed keyword database only
- **Manual keyword entry:** Available in Planner/Keywords page (user's own workflow), NOT here
- **Keyword imports:** Admin-only via backend admin panel

---

### Issues to Address

| # | Issue | Priority | Action |
|---|-------|----------|--------|
| 1 | Sector requirement unclear | High | Add tooltip/message explaining why buttons are disabled when no sector is selected |
| 2 | No "already added" filter | Medium | Add filter toggle: "Show not-yet-added only" |
| 3 | No "Next Step" CTA | High | Add button after keywords added: "Next: Plan Your Content →" linking to Planner |
| 4 | No keyword count summary | Medium | Display: "X keywords in your workflow • Y available to add" |
| 5 | Import/manual add buttons exist | High | Remove any UI elements for importing or manually adding keywords - this is global DB, read-only for users |
| 6 | No Keyword Research indication | Low | Add small teaser text: "Looking for more keywords? Keyword Research coming soon" (user-friendly, non-technical wording) |

---

### Implementation Notes

**For Issue #1 (Sector requirement):**
- When buttons are disabled, show tooltip: "Please select an industry and sector in your Site Settings to browse relevant keywords"
- Consider linking directly to Site Settings

**For Issue #3 (Next Step CTA):**
- Button should appear after user has added at least 1 keyword
- Route to `/planner/keywords`

**For Issue #5 (Remove import/add):**
- Audit the page for any "Import Keywords" or "Add Custom Keyword" buttons
- Remove from UI completely
- Keywords only come from admin-imported global database

---

## 2.2 Content Settings

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

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

### Current State
- ⚠️ **Content Generation:** Shows "saved" but does NOT persist (TODO in code)
- ⚠️ **Publishing:** Shows "saved" but does NOT persist (no backend API)
- ✅ **Image Settings:** Works correctly (has API integration)

---

### Issues to Address

| # | Issue | Priority | Action |
|---|-------|----------|--------|
| 1 | Content Generation NOT PERSISTED | 🔴 Critical | Implement backend API endpoint to save Content Generation settings |
| 2 | Publishing NOT PERSISTED | 🔴 Critical | Implement backend API endpoint - simple toggle for auto-publish (true/false) |
| 3 | False "saved" confirmation | 🔴 Critical | Fix after #1 and #2 - currently misleads users |

---

### Implementation Notes

**For Issue #1 (Content Generation API):**
- Fields to persist: append_to_prompt, default_tone, default_length
- Should save at account level (global, not per-site)

**For Issue #2 (Publishing API):**
- Simple boolean toggle: auto_publish (true/false)
- When true: content automatically publishes to WordPress after generation
- When false: content stays in Review status for manual publishing

**Not Needed for Launch:**
- Per-site content settings
- Thinker prompts connection explanation (handled via shortcodes in prompts)

---

## 2.3 Sites

**Route:** `/sites`  
**Files:** `pages/Sites/List.tsx`, `pages/Sites/SiteSettings.tsx`, `pages/Sites/SiteDashboard.tsx`  
**Tabs (Site Settings):** 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

### What Sites Module Should Be (Launch Scope)
- Connect/manage WordPress sites for content publishing
- Configure WordPress integration (API credentials)
- Set active site for content workflow
- Industry/sector selection (for keyword filtering)

---

### Issues to Address

#### A. Fix/Improve (From Audit)

| # | Issue | Priority | Action |
|---|-------|----------|--------|
| 1 | Dashboard stats are mock data | Medium | Implement real site statistics endpoint OR remove stats display |
| 2 | No inline editing | Low | Add inline edit for site name from list view |
| 3 | No site cloning | Low | Add "Duplicate Site" action to copy configuration |
| 4 | No bulk operations | Low | Add bulk activate/deactivate/delete |
| 5 | Complex site creation flow | High | Allow site creation without requiring industry/sector upfront |
| 6 | Integration tab default after creation | Medium | Default to General tab, not Integrations (less confusing for non-technical users) |
| 7 | No setup progress indicator | High | Add visual checklist showing what's configured vs pending (see below) |

#### B. Remove (Legacy Site Builder)

| # | Issue | Priority | Action |
|---|-------|----------|--------|
| 8 | Site Builder legacy pages | High | Remove all frontend pages/components related to site builder feature |
| 9 | WordPress content fetching | High | Remove code that fetches existing content FROM WordPress (only IGNY8-generated content should exist) |
| 10 | Duplicate Manage.tsx | High | Delete `pages/Sites/Manage.tsx` - redundant with List.tsx |
| 11 | Backend site builder code | High | Remove backend APIs/models related to site builder and external content fetching |

---

### Setup Completion Checklist (New Feature)

Display this checklist on Site card or Site Dashboard to guide users:

```
Site Setup Progress
───────────────────
☑ Site created
☐ Industry/Sectors selected
☐ WordPress integration configured (or skipped)
☐ Keywords added
☐ Content settings configured

[Complete Setup →]
```

**Implementation Notes:**
- Show on each site card in list view (compact version)
- Show expanded on Site Dashboard
- Each item links to relevant settings page
- "Complete Setup" button goes to first incomplete item
- When all complete, show "✓ Ready to create content"

---

## 2.4 SETUP Cross-Module Issues

| # | Issue | Priority | Action |
|---|-------|----------|--------|
| 1 | No guided flow | High | After completing setup tasks, guide user to start content workflow (link to Planner) |
| 2 | Scattered settings | Medium | Document where settings live; consider consolidation in future |
| 3 | No onboarding checklist | High | Implement Setup Completion Checklist (see 2.3 above) |

---

## Summary

### Total Issues by Section

| Section | Critical | High | Medium | Low | Total |
|---------|----------|------|--------|-----|-------|
| 2.1 Add Keywords | 0 | 3 | 2 | 1 | 6 |
| 2.2 Content Settings | 3 | 0 | 0 | 0 | 3 |
| 2.3 Sites | 0 | 6 | 2 | 3 | 11 |
| 2.4 Cross-Module | 0 | 2 | 1 | 0 | 3 |
| **TOTAL** | **3** | **11** | **5** | **4** | **23** |

### Critical Items (Must Fix)

1. **Content Settings - Content Generation tab not saving** → Implement backend API
2. **Content Settings - Publishing tab not saving** → Implement backend API  
3. **Content Settings - False "saved" message** → Fix after APIs implemented

### High Priority Items

1. Add Keywords - Sector requirement tooltip
2. Add Keywords - Next Step CTA to Planner
3. Add Keywords - Remove import/manual add buttons
4. Sites - Allow simpler site creation flow
5. Sites - Add Setup Completion Checklist
6. Sites - Remove Site Builder legacy code (frontend)
7. Sites - Remove WordPress content fetching code
8. Sites - Delete duplicate Manage.tsx
9. Sites - Remove Site Builder backend code
10. Cross-Module - Guided flow after setup
11. Cross-Module - Onboarding checklist implementation

### Files to Delete

| File | Reason |
|------|--------|
| `pages/Sites/Manage.tsx` | Duplicate of List.tsx |
| Site Builder related pages | Legacy feature removed |
| Site Builder related components | Legacy feature removed |

### Files to Modify

| File | Changes |
|------|---------|
| `pages/Setup/AddKeywords.tsx` | Add tooltip, filter, CTA, count summary, remove import buttons, add teaser |
| `pages/account/ContentSettingsPage.tsx` | Connect to new backend APIs |
| `pages/Sites/List.tsx` | Add setup checklist, inline edit, bulk operations |
| `pages/Sites/SiteSettings.tsx` | Default to General tab |
| `pages/Sites/SiteDashboard.tsx` | Fix mock stats, add setup checklist |

### Backend Work Required

| Area | Work |
|------|------|
| Content Settings API | Create endpoints for Content Generation and Publishing settings |
| Site Statistics API | Implement real stats OR remove from frontend |
| Cleanup | Remove Site Builder and content fetching APIs/models |

---

Status after implementation


## Summary of Section 2 Implementation

### 2.1 Add Keywords (IndustriesSectorsKeywords.tsx)
- ✅ Added `showNotAddedOnly` filter state with "Not Yet Added Only" filter option
- ✅ Added `addedCount` and `availableCount` state variables for keyword count tracking  
- ✅ Added keyword count summary showing "X keywords in your workflow • Y available to add"
- ✅ Added "Next: Plan Your Content →" CTA button that appears when keywords are added
- ✅ Added "Looking for more keywords? Keyword Research coming soon!" teaser text
- ✅ Sector requirement tooltip already existed - no changes needed
- ✅ No visible import buttons to remove (dead code existed but was not exposed)

### 2.2 Content Settings (ContentSettingsPage.tsx)
- ✅ Created new backend API endpoint `/v1/system/settings/content/<pk>/` for content_generation and publishing
- ✅ Added `ContentSettingsViewSet` to backend with retrieve/update/save actions
- ✅ Updated frontend to load content_generation and publishing settings from API
- ✅ Updated frontend to save content_generation settings (append_to_prompt, default_tone, default_length)
- ✅ Updated frontend to save publishing settings (auto_publish_enabled, auto_sync_enabled)
- ✅ Removed TODO comments - settings now actually persist

### 2.3 Sites
- ✅ Created `SiteSetupChecklist` component showing setup progress with checklist
- ✅ Updated Dashboard.tsx to use the new checklist component
- ✅ Removed mock stats from Dashboard (were showing all zeros)
- ✅ Deleted Manage.tsx (redundant duplicate of List.tsx)
- ✅ Removed empty `Builder/` folder structure
- ✅ Removed routes to deleted pages in App.tsx
- ✅ Site Settings already defaults to "general" tab - no changes needed

### Files Modified
1. IndustriesSectorsKeywords.tsx
2. ContentSettingsPage.tsx
3. settings_views.py
4. urls.py
5. Dashboard.tsx
6. App.tsx

### Files Created
1. SiteSetupChecklist.tsx

### Files Deleted
1. Manage.tsx
2. `frontend/src/pages/Sites/Builder/` (empty folder)