diff --git a/.cursorrules b/.cursorrules
new file mode 100644
index 00000000..48593f2f
--- /dev/null
+++ b/.cursorrules
@@ -0,0 +1,329 @@
+# IGNY8 Development Rules
+# ========================
+# These rules MUST be followed for all code changes.
+# Version: 1.8.4 | Last Updated: January 20, 2026
+
+## 📋 MANDATORY CHECKLIST (Every Change)
+
+Before submitting ANY code change:
+
+1. [ ] Documentation updated (if behavior changed)
+2. [ ] CHANGELOG.md updated (if user-facing)
+3. [ ] Design guide followed (frontend changes)
+4. [ ] Types/interfaces match API responses
+5. [ ] No hardcoded values (use constants/settings)
+
+---
+
+## 🗂️ Project Structure
+
+```
+/
+├── INDEX.md                    # Start here
+├── DESIGN-GUIDE.md             # UI/UX standards (MANDATORY)
+├── CHANGELOG.md                # All notable changes
+├── README.md                   # Setup & overview
+├── docs/                       # Detailed documentation
+│   ├── 00-SYSTEM/              # Architecture & core concepts
+│   ├── 10-MODULES/             # Business logic modules
+│   ├── 20-API/                 # API endpoints
+│   ├── 30-FRONTEND/            # React components & stores
+│   ├── 40-WORKFLOWS/           # Business processes
+│   ├── 50-DEPLOYMENT/          # DevOps & infrastructure
+│   ├── 60-PLUGINS/             # Plugin system
+│   └── 90-REFERENCE/           # Models, enums, glossary
+├── backend/                    # Django app
+└── frontend/                   # React app
+```
+
+---
+
+## 📝 Documentation Rules
+
+### When to Update Docs
+
+| Change Type | Update Required |
+|-------------|-----------------|
+| New API endpoint | `docs/20-API/ENDPOINTS.md` |
+| New model | `docs/90-REFERENCE/MODELS.md` |
+| New route/page | `docs/30-FRONTEND/PAGES.md` |
+| New store | `docs/30-FRONTEND/STORES.md` |
+| UI component | `docs/30-FRONTEND/COMPONENT-SYSTEM.md` |
+| Settings change | `docs/00-SYSTEM/ARCHITECTURE.md` |
+| New module | `docs/10-MODULES/<module>.md` |
+| New Celery task | Document in module's backend docs |
+
+### Documentation Standards
+
+```markdown
+# Document Title
+
+> Brief one-line description
+
+**Version:** X.Y.Z
+**Last Updated:** YYYY-MM-DD
+
+## Section 1
+Content...
+
+## Section 2
+Content...
+```
+
+---
+
+## 🎨 Frontend Rules
+
+### MUST Follow Design Guide
+
+All frontend code MUST adhere to `DESIGN-GUIDE.md`:
+
+1. **Components**: Use our component library, NEVER raw HTML
+2. **Colors**: Only semantic colors (brand, success, warning, error, purple, gray)
+3. **Icons**: Import from central `icons/` directory only
+4. **Forms**: Use standardized form components
+
+### File Organization
+
+```
+src/
+├── components/
+│   ├── ui/           # Reusable UI components
+│   ├── form/         # Form-specific components
+│   ├── layout/       # Layout components
+│   └── [module]/     # Module-specific components
+├── pages/            # Route pages
+├── stores/           # Zustand stores
+├── services/         # API service functions
+├── hooks/            # Custom React hooks
+├── types/            # TypeScript type definitions
+└── utils/            # Utility functions
+```
+
+### TypeScript Standards
+
+```typescript
+// ✅ CORRECT: Use interfaces for API responses
+interface Site {
+  id: string;
+  name: string;
+  domain: string;
+}
+
+// ✅ CORRECT: Type all props
+interface ComponentProps {
+  title: string;
+  onClose: () => void;
+  children?: React.ReactNode;
+}
+
+// ❌ WRONG: No any types
+const data: any = response;
+```
+
+---
+
+## 🐍 Backend Rules
+
+### Django/DRF Standards
+
+1. **Serializers**: Must match model fields exactly
+2. **Views**: Use DRF ViewSets where possible
+3. **URLs**: Follow RESTful conventions
+4. **Models**: Document all fields with help_text
+
+### Serializer Field Validation
+
+```python
+# ✅ CORRECT: Fields match model
+class SettingsSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Settings
+        fields = ['id', 'key', 'value']  # 'value' exists on model
+
+# ❌ WRONG: Field doesn't exist on model
+class SettingsSerializer(serializers.ModelSerializer):
+    config = serializers.JSONField()  # 'config' doesn't exist!
+    class Meta:
+        model = Settings
+        fields = ['id', 'key', 'config']
+```
+
+### API Response Format
+
+```python
+# Standard success response
+{
+    "data": { ... },
+    "message": "Operation successful"
+}
+
+# Standard error response
+{
+    "error": "Error message",
+    "details": { ... }
+}
+
+# Paginated response
+{
+    "count": 100,
+    "next": "http://...",
+    "previous": null,
+    "results": [ ... ]
+}
+```
+
+---
+
+## 📊 CHANGELOG Rules
+
+### When to Update
+
+- New features (user-visible)
+- Bug fixes (user-affecting)
+- API changes
+- Breaking changes
+- Performance improvements
+
+### Format
+
+```markdown
+## [1.8.4] - 2026-01-21
+
+### Added
+- New feature description
+
+### Changed
+- Changed behavior description
+
+### Fixed
+- Bug fix description
+
+### Deprecated
+- Deprecated feature warning
+
+### Removed
+- Removed feature notice
+
+### Security
+- Security fix description
+```
+
+---
+
+## ✅ Code Review Checklist
+
+### Before Creating PR
+
+- [ ] Code compiles/runs without errors
+- [ ] All tests pass
+- [ ] No console.log or print statements (unless intentional)
+- [ ] Documentation updated
+- [ ] CHANGELOG updated (if applicable)
+- [ ] No hardcoded secrets/URLs
+- [ ] Follows design guide (frontend)
+- [ ] Serializers match models (backend)
+
+### Review Focus Areas
+
+1. **Logic**: Does the code do what it's supposed to?
+2. **Types**: Are TypeScript types correct and complete?
+3. **Security**: Any security concerns?
+4. **Performance**: Any obvious performance issues?
+5. **Consistency**: Follows existing patterns?
+
+---
+
+## 🔧 Development Workflow
+
+### Making Changes
+
+1. Understand the context (read relevant docs first)
+2. Make the change
+3. Update documentation
+4. Update CHANGELOG (if user-facing)
+5. Test thoroughly
+6. Submit for review
+
+### Adding New Features
+
+1. Document the feature design first
+2. Implement backend (if needed)
+3. Update API docs
+4. Implement frontend
+5. Update frontend docs
+6. Add to CHANGELOG
+
+---
+
+## 🚨 Common Mistakes to Avoid
+
+### Frontend
+
+- Using raw HTML instead of components
+- Using default Tailwind colors
+- Importing icons from wrong source
+- Not typing API responses
+- Hardcoding API URLs
+
+### Backend
+
+- Serializer fields not matching models
+- Missing model validations
+- Not handling edge cases in views
+- Forgetting to add URLs to router
+
+### Documentation
+
+- Not updating docs after changes
+- Outdated version numbers
+- Missing new endpoints/pages
+- Inconsistent formatting
+
+---
+
+## 📚 Key Documentation Files
+
+| Purpose | Location |
+|---------|----------|
+| Quick start | `/INDEX.md` |
+| UI standards | `/DESIGN-GUIDE.md` |
+| Change history | `/CHANGELOG.md` |
+| Architecture | `/docs/00-SYSTEM/ARCHITECTURE.md` |
+| API reference | `/docs/20-API/ENDPOINTS.md` |
+| Data models | `/docs/90-REFERENCE/MODELS.md` |
+| Frontend routes | `/docs/30-FRONTEND/PAGES.md` |
+| State stores | `/docs/30-FRONTEND/STORES.md` |
+| Components | `/docs/30-FRONTEND/COMPONENT-SYSTEM.md` |
+
+---
+
+## 🔄 Maintenance Scripts
+
+### Verify Documentation Accuracy
+
+```bash
+./scripts/verify-docs.sh
+```
+
+### Update API Schema
+
+```bash
+cd backend && python manage.py spectacular --file schema.yml
+```
+
+### Check for Unused Code
+
+```bash
+cd frontend && npm run lint
+```
+
+---
+
+## Version Info
+
+- **App Version:** 1.8.3
+- **Backend:** Django 5.1, DRF 3.15
+- **Frontend:** React 19, TypeScript 5
+- **Database:** PostgreSQL 16
+- **Cache:** Redis 7
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4d5d37eb..ee33be22 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # IGNY8 Change Log
 
-**Current Version:** 1.8.3
+**Current Version:** 1.8.4
 **Last Updated:** January 20, 2026
 
 ---
@@ -9,6 +9,7 @@
 
 | Version | Date | Summary |
 |---------|------|---------|
+| 1.8.4 | Jan 20, 2026 | **Documentation Accuracy & Launch Prep** - Fixed API docs (Swagger/ReDoc), serializer field mismatches resolved, comprehensive docs audit, root-level INDEX.md + DESIGN-GUIDE.md + .cursorrules created |
 | 1.8.3 | Jan 20, 2026 | **Billing System Standardization** - Two-pool credit system (plan + bonus), industry-standard renewal workflow (no advance notice for Stripe/PayPal), simplified bank transfer flow (3 emails), Payment Logs in admin, WebhookEvent logging for all payment types |
 | 1.8.2 | Jan 19, 2026 | **Keywords Library Redesign & Sector Filtering** - Complete Keywords Library page overhaul with sector metric cards, Smart Suggestions, cascading filters, sector-specific keyword filtering, UI/UX improvements, and backend sector_ids parameter support |
 | 1.8.1 | Jan 18, 2026 | **Automation Scheduling Overhaul** - Hourly scheduling (replaces 15-min windows), DefaultAutomationConfig singleton for centralized defaults, test mode for admin testing, Reset button fetches from backend, new migrations 0009-0012 |
@@ -50,6 +51,65 @@
 
 ---
 
+## v1.8.4 - January 20, 2026
+
+### Documentation Accuracy & Launch Preparation
+
+This release focuses on ensuring 100% documentation accuracy and establishing maintainability standards for launch.
+
+---
+
+### 🔧 API Documentation Fixes
+
+**Problem Resolved:**
+- Swagger UI (`/api/docs/`) and ReDoc (`/api/redoc/`) were returning 500 errors
+- Root cause: Serializer field mismatches in `settings_serializers.py`
+
+**Fixes Applied:**
+- `AccountSettingsSerializer`: Changed `config` → `value` to match model
+- `ModuleSettingsSerializer`: Removed non-existent `config` field
+
+**Verified:**
+- Schema endpoint returns valid OpenAPI YAML
+- Both documentation UIs now accessible
+
+---
+
+### 📚 Root-Level Documentation
+
+**New Files Created:**
+| File | Purpose |
+|------|---------|
+| `/INDEX.md` | Quick-start documentation index |
+| `/DESIGN-GUIDE.md` | Mandatory UI/UX standards |
+| `/.cursorrules` | Development rules & standards |
+
+---
+
+### 📊 Documentation Audit Results
+
+**Codebase Metrics Verified:**
+- Routes: 100 (documented in PAGES.md)
+- Models: 52+ (documented in MODELS.md)
+- Zustand Stores: 11 (documented in STORES.md)
+- Celery Tasks: 25+ (documented per module)
+
+**Files Cleaned:**
+- `docs/30-FRONTEND/PAGES.md`: Removed duplicate content, rebuilt from scratch
+
+---
+
+### 📋 Maintainability Standards
+
+**New .cursorrules establishes:**
+1. Mandatory documentation updates for code changes
+2. CHANGELOG updates for user-facing changes
+3. Design guide compliance for frontend
+4. Serializer-model field validation
+5. Code review checklist
+
+---
+
 ## v1.8.3 - January 20, 2026
 
 ### Billing System Standardization & Two-Pool Credit System
diff --git a/DESIGN-GUIDE.md b/DESIGN-GUIDE.md
new file mode 100644
index 00000000..098db120
--- /dev/null
+++ b/DESIGN-GUIDE.md
@@ -0,0 +1,311 @@
+# IGNY8 Design Guide
+
+> **🔒 MANDATORY** - All frontend code MUST follow these standards  
+> **Version:** 1.8.3  
+> **Last Updated:** January 20, 2026
+
+---
+
+## Quick Reference
+
+| Need | Use | Import From |
+|------|-----|-------------|
+| Button | `<Button>` | `components/ui/button/Button` |
+| Icon button | `<IconButton>` | `components/ui/button/IconButton` |
+| Text input | `<InputField>` | `components/form/input/InputField` |
+| Dropdown | `<Select>` | `components/form/Select` |
+| Checkbox | `<Checkbox>` | `components/form/input/Checkbox` |
+| Toggle | `<Switch>` | `components/form/switch/Switch` |
+| Status label | `<Badge>` | `components/ui/badge/Badge` |
+| Card | `<Card>` | `components/ui/card/Card` |
+| Modal | `<Modal>` | `components/ui/modal` |
+| Toast | `useToast()` | `components/ui/toast/ToastContainer` |
+| Table | `<Table>` | `components/tables/Table` |
+
+**Full component docs:** [docs/30-FRONTEND/COMPONENT-SYSTEM.md](docs/30-FRONTEND/COMPONENT-SYSTEM.md)
+
+---
+
+## 🎨 Color System
+
+### Only 6 Base Colors (No Exceptions!)
+
+| Token | Hex | Usage |
+|-------|-----|-------|
+| `brand` | #0077B6 | Primary actions, links |
+| `success` | #2CA18E | Success states |
+| `warning` | #D9A12C | Warnings, alerts |
+| `danger/error` | #A12C40 | Errors, destructive |
+| `purple` | #2C40A1 | Premium features |
+| `gray` | #667085 | Text, borders, neutrals |
+
+### Tailwind Classes
+
+```tsx
+// ✅ CORRECT - Use semantic colors
+<div className="bg-brand-500 text-white">Primary</div>
+<div className="bg-success-100 text-success-700">Success</div>
+<div className="bg-error-100 text-error-700">Error</div>
+<div className="text-gray-700 bg-gray-50">Neutral</div>
+
+// ❌ WRONG - Default Tailwind colors are DISABLED
+<div className="bg-blue-500">...</div>      // Will not work
+<div className="bg-red-500">...</div>       // Will not work
+<div className="bg-[#ff0000]">...</div>     // Hardcoded - forbidden
+```
+
+---
+
+## Component Rules
+
+### Rule 1: NEVER Use Raw HTML Elements
+
+```tsx
+// ❌ NEVER
+<button onClick={...}>Click</button>
+<input type="text" />
+<select>...</select>
+<textarea></textarea>
+
+// ✅ ALWAYS
+<Button onClick={...}>Click</Button>
+<InputField type="text" label="Name" />
+<Select options={options} />
+<TextArea rows={4} />
+```
+
+### Rule 2: Icons from Central Location Only
+
+```tsx
+// ❌ NEVER
+import { XIcon } from '@heroicons/react/24/outline';
+import { Trash } from 'lucide-react';
+
+// ✅ ALWAYS
+import { CloseIcon, TrashBinIcon } from '../../icons';
+```
+
+### Rule 3: Consistent Icon Sizing
+
+```tsx
+// In buttons/badges
+<Icon className="w-4 h-4" />
+
+// Standalone
+<Icon className="w-5 h-5" />
+
+// Headers/large
+<Icon className="w-6 h-6" />
+```
+
+---
+
+## Button Variants
+
+```tsx
+// Primary action (main CTA)
+<Button variant="primary">Save Changes</Button>
+
+// Secondary action
+<Button variant="secondary">Cancel</Button>
+
+// Danger/destructive
+<Button variant="danger">Delete</Button>
+
+// Outline style
+<Button variant="outline">Learn More</Button>
+
+// Ghost (minimal)
+<Button variant="ghost">Skip</Button>
+
+// With icon
+<Button variant="primary" leftIcon={<PlusIcon />}>Add Item</Button>
+
+// Icon only
+<IconButton icon={<SettingsIcon />} aria-label="Settings" />
+```
+
+---
+
+## Form Patterns
+
+### Input Fields
+
+```tsx
+<InputField
+  label="Email"
+  type="email"
+  placeholder="you@example.com"
+  error={errors.email}
+  required
+/>
+```
+
+### Select Dropdowns
+
+```tsx
+<Select
+  label="Country"
+  options={[
+    { value: 'us', label: 'United States' },
+    { value: 'uk', label: 'United Kingdom' },
+  ]}
+  value={country}
+  onChange={setCountry}
+/>
+```
+
+### Checkboxes & Switches
+
+```tsx
+// Checkbox
+<Checkbox
+  label="I agree to terms"
+  checked={agreed}
+  onChange={setAgreed}
+/>
+
+// Toggle switch
+<Switch
+  label="Enable notifications"
+  checked={enabled}
+  onChange={setEnabled}
+/>
+```
+
+---
+
+## Badge Tones
+
+```tsx
+<Badge tone="default">Draft</Badge>
+<Badge tone="success">Active</Badge>
+<Badge tone="warning">Pending</Badge>
+<Badge tone="error">Failed</Badge>
+<Badge tone="info">New</Badge>
+```
+
+---
+
+## Modal Pattern
+
+```tsx
+const [isOpen, setIsOpen] = useState(false);
+
+<Modal
+  isOpen={isOpen}
+  onClose={() => setIsOpen(false)}
+  title="Confirm Delete"
+>
+  <p>Are you sure you want to delete this item?</p>
+  <div className="flex gap-3 mt-4">
+    <Button variant="secondary" onClick={() => setIsOpen(false)}>
+      Cancel
+    </Button>
+    <Button variant="danger" onClick={handleDelete}>
+      Delete
+    </Button>
+  </div>
+</Modal>
+```
+
+---
+
+## Toast Notifications
+
+```tsx
+import { useToast } from '../components/ui/toast/ToastContainer';
+
+const { showToast } = useToast();
+
+// Success
+showToast('Changes saved successfully', 'success');
+
+// Error
+showToast('Failed to save changes', 'error');
+
+// Warning
+showToast('Your session is about to expire', 'warning');
+
+// Info
+showToast('New features available', 'info');
+```
+
+---
+
+## Spacing & Layout
+
+### Standard Spacing Scale
+
+| Class | Size | Usage |
+|-------|------|-------|
+| `gap-2` | 8px | Tight grouping |
+| `gap-3` | 12px | Default spacing |
+| `gap-4` | 16px | Section spacing |
+| `gap-6` | 24px | Major sections |
+
+### Card Layout
+
+```tsx
+<Card>
+  <Card.Header>
+    <h3>Title</h3>
+  </Card.Header>
+  <Card.Body>
+    Content here
+  </Card.Body>
+  <Card.Footer>
+    <Button>Action</Button>
+  </Card.Footer>
+</Card>
+```
+
+---
+
+## Typography
+
+```tsx
+// Page titles
+<h1 className="text-2xl font-semibold text-gray-900">Page Title</h1>
+
+// Section headers
+<h2 className="text-lg font-medium text-gray-900">Section</h2>
+
+// Card titles
+<h3 className="text-base font-medium text-gray-900">Card Title</h3>
+
+// Body text
+<p className="text-sm text-gray-700">Body content</p>
+
+// Secondary/muted text
+<span className="text-sm text-gray-500">Helper text</span>
+```
+
+---
+
+## ESLint Enforcement
+
+These rules are **enforced via ESLint**:
+
+| Rule | Level | Enforces |
+|------|-------|----------|
+| `no-raw-button` | warn | Use `<Button>` component |
+| `no-raw-input` | warn | Use `<InputField>` component |
+| `no-raw-select` | warn | Use `<Select>` component |
+| `no-raw-textarea` | warn | Use `<TextArea>` component |
+| `design-system-colors` | error | Only semantic colors |
+| `no-hardcoded-colors` | error | No hex codes in className |
+
+---
+
+## Live Demo
+
+Visit `/ui-elements` in the app to see all components in action.
+
+---
+
+## Related Docs
+
+- [COMPONENT-SYSTEM.md](docs/30-FRONTEND/COMPONENT-SYSTEM.md) - Full component API
+- [DESIGN-TOKENS.md](docs/30-FRONTEND/DESIGN-TOKENS.md) - CSS variables
+- [PAGES.md](docs/30-FRONTEND/PAGES.md) - Route structure
diff --git a/INDEX.md b/INDEX.md
new file mode 100644
index 00000000..7ed15149
--- /dev/null
+++ b/INDEX.md
@@ -0,0 +1,146 @@
+# IGNY8 Documentation Index
+
+> **Version:** 1.8.3  
+> **Last Updated:** January 20, 2026  
+> **Codebase Health:** ✅ Stable
+
+---
+
+## Quick Start
+
+| I want to... | Document |
+|--------------|----------|
+| **Understand the system** | [docs/00-SYSTEM/ARCHITECTURE.md](docs/00-SYSTEM/ARCHITECTURE.md) |
+| **Follow design standards** | [DESIGN-GUIDE.md](DESIGN-GUIDE.md) |
+| **Find API endpoints** | [docs/20-API/ENDPOINTS.md](docs/20-API/ENDPOINTS.md) |
+| **See frontend routes** | [docs/30-FRONTEND/PAGES.md](docs/30-FRONTEND/PAGES.md) |
+| **Use UI components** | [docs/30-FRONTEND/COMPONENT-SYSTEM.md](docs/30-FRONTEND/COMPONENT-SYSTEM.md) |
+| **Check changelog** | [CHANGELOG.md](CHANGELOG.md) |
+
+---
+
+## System Overview
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                         IGNY8 App                           │
+├─────────────────────────────────────────────────────────────┤
+│  Frontend (React 19)  │  Backend (Django 5.1)  │  WordPress │
+│  - TypeScript         │  - DRF REST API        │  - Plugin  │
+│  - Vite               │  - Celery Workers      │            │
+│  - Tailwind CSS       │  - PostgreSQL 16       │            │
+│  - Zustand            │  - Redis 7             │            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Documentation Structure
+
+```
+/
+├── INDEX.md                    ← You are here
+├── DESIGN-GUIDE.md             ← UI/UX standards (MUST FOLLOW)
+├── CHANGELOG.md                ← Version history
+├── README.md                   ← Project overview
+│
+├── docs/
+│   ├── 00-SYSTEM/              ← Architecture, auth, tenancy
+│   │   ├── ARCHITECTURE.md
+│   │   ├── AUTH-FLOWS.md
+│   │   └── TENANCY.md
+│   │
+│   ├── 10-MODULES/             ← Feature module docs
+│   │   ├── PLANNER.md
+│   │   ├── WRITER.md
+│   │   ├── AUTOMATION.md
+│   │   ├── BILLING-PAYMENTS-COMPLETE.md
+│   │   └── ...
+│   │
+│   ├── 20-API/                 ← API reference
+│   │   └── ENDPOINTS.md
+│   │
+│   ├── 30-FRONTEND/            ← Frontend docs
+│   │   ├── PAGES.md            ← Routes & pages
+│   │   ├── COMPONENT-SYSTEM.md ← UI components
+│   │   ├── STORES.md           ← Zustand state
+│   │   └── DESIGN-TOKENS.md    ← CSS variables
+│   │
+│   ├── 40-WORKFLOWS/           ← Business workflows
+│   │   └── CONTENT-PIPELINE.md
+│   │
+│   ├── 50-DEPLOYMENT/          ← Deploy & ops
+│   │   └── DOCKER-DEPLOYMENT.md
+│   │
+│   ├── 60-PLUGINS/             ← WordPress plugin
+│   │   └── WORDPRESS-INTEGRATION.md
+│   │
+│   └── 90-REFERENCE/           ← Reference docs
+│       ├── MODELS.md
+│       └── AI-FUNCTIONS.md
+│
+├── backend/                    ← Django backend
+├── frontend/                   ← React frontend
+└── plugins/                    ← WordPress plugin
+```
+
+---
+
+## Key Metrics (Auto-Generated)
+
+| Metric | Count | Source |
+|--------|-------|--------|
+| **Frontend Routes** | 100 | `App.tsx` |
+| **Backend Models** | 52 | `models.py` files |
+| **Zustand Stores** | 11 | `frontend/src/store/` |
+| **Celery Tasks** | 25 | `@shared_task` decorators |
+| **API Endpoints** | 150+ | Django URL patterns |
+
+---
+
+## Module Status
+
+| Module | Status | Description |
+|--------|--------|-------------|
+| **Planner** | ✅ Active | Keywords → Clusters → Ideas |
+| **Writer** | ✅ Active | Tasks → Content → Images |
+| **Automation** | ✅ Active | 7-stage automated pipeline |
+| **Publisher** | ✅ Active | Content calendar & scheduling |
+| **Billing** | ✅ Active | Credits, plans, payments |
+| **Thinker** | ✅ Active | AI prompts & profiles (Admin) |
+| **Linker** | ⏸️ Phase 2 | Internal linking (disabled) |
+| **Optimizer** | ⏸️ Phase 2 | Content optimization (disabled) |
+
+---
+
+## Development Rules
+
+### ⚠️ Before Any Code Change
+
+1. **Read** [DESIGN-GUIDE.md](DESIGN-GUIDE.md) for UI standards
+2. **Check** existing components before creating new ones
+3. **Follow** project structure and naming conventions
+
+### ⚠️ After Any Code Change
+
+1. **Update** relevant documentation in `/docs/`
+2. **Add** entry to [CHANGELOG.md](CHANGELOG.md)
+3. **Run** `./scripts/verify-docs.sh` to check accuracy
+
+---
+
+## API Documentation
+
+- **Swagger UI:** https://api.igny8.com/api/docs/
+- **ReDoc:** https://api.igny8.com/api/redoc/
+- **OpenAPI Schema:** https://api.igny8.com/api/schema/
+
+---
+
+## Contact & Support
+
+| Resource | Link |
+|----------|------|
+| **GitHub** | Internal repository |
+| **Production** | https://app.igny8.com |
+| **API** | https://api.igny8.com |
diff --git a/docs/00-SYSTEM/ARCHITECTURE.md b/docs/00-SYSTEM/ARCHITECTURE.md
index 484abf27..6e35ad45 100644
--- a/docs/00-SYSTEM/ARCHITECTURE.md
+++ b/docs/00-SYSTEM/ARCHITECTURE.md
@@ -1,7 +1,7 @@
 # System Architecture
 
-**Last Verified:** January 1, 2026  
-**Version:** 1.3.0  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Backend Path:** `backend/igny8_core/`  
 **Frontend Path:** `frontend/src/`
 
@@ -16,7 +16,7 @@
 | **Database** | PostgreSQL | 16 | Primary data store |
 | **Cache/Queue** | Redis | 7 | Caching, Celery broker |
 | **Task Queue** | Celery | 5.4 | Async task processing |
-| **Frontend Framework** | React | 18 | UI framework |
+| **Frontend Framework** | React | 19 | UI framework |
 | **Build Tool** | Vite | 5 | Frontend bundler |
 | **Styling** | Tailwind CSS | 3 | Utility CSS |
 | **State Management** | Zustand | 4 | React state |
diff --git a/docs/00-SYSTEM/AUTH-FLOWS.md b/docs/00-SYSTEM/AUTH-FLOWS.md
index f3992428..9ef7c5dc 100644
--- a/docs/00-SYSTEM/AUTH-FLOWS.md
+++ b/docs/00-SYSTEM/AUTH-FLOWS.md
@@ -1,6 +1,7 @@
 # Authentication & Authorization
 
-**Last Verified:** December 25, 2025  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Backend Path:** `backend/igny8_core/auth/`  
 **Frontend Path:** `frontend/src/store/authStore.ts`
 
@@ -80,15 +81,15 @@
 | Role | Code | Permissions |
 |------|------|-------------|
 | **Developer** | `developer` | Full access across ALL accounts (superuser) |
-| **Admin** | `admin` | Full access to own account |
-| **Manager** | `manager` | Manage content, view billing |
-| **Editor** | `editor` | AI content, manage clusters/tasks |
-| **Viewer** | `viewer` | Read-only dashboards |
+| **Owner** | `owner` | Full access to own account (account creator) |
+| **Admin** | `admin` | Full access to own account, billing, team management |
+| **Editor** | `editor` | Content creation and editing only |
+| **Viewer** | `viewer` | Read-only access to content |
 | **System Bot** | `system_bot` | System automation (internal) |
 
 **Role Hierarchy:**
 ```
-developer > admin > manager > editor > viewer
+developer > owner > admin > editor > viewer
 ```
 
 ---
diff --git a/docs/00-SYSTEM/IGNY8-APP.md b/docs/00-SYSTEM/IGNY8-APP.md
index 9f9e63c8..43f12ac3 100644
--- a/docs/00-SYSTEM/IGNY8-APP.md
+++ b/docs/00-SYSTEM/IGNY8-APP.md
@@ -1,7 +1,7 @@
 # IGNY8 - AI-Powered SEO Content Platform
 
-**Version:** 1.1.0  
-**Last Updated:** December 25, 2025  
+**Version:** 1.8.4  
+**Last Updated:** January 20, 2026  
 **Status:** Production Ready
 
 ---
diff --git a/docs/00-SYSTEM/TENANCY.md b/docs/00-SYSTEM/TENANCY.md
index af6ab2ac..8e9e2908 100644
--- a/docs/00-SYSTEM/TENANCY.md
+++ b/docs/00-SYSTEM/TENANCY.md
@@ -1,6 +1,7 @@
 # Multi-Tenancy Architecture
 
-**Last Verified:** December 25, 2025  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Backend Path:** `backend/igny8_core/auth/models.py`
 
 ---
@@ -33,28 +34,30 @@ Account (Tenant)
 |-------|------|---------|
 | name | CharField | Account/organization name |
 | is_active | Boolean | Enable/disable account |
-| credits | Decimal | Current credit balance |
+| credits | Decimal | Plan credits (reset on renewal) |
+| bonus_credits | Decimal | Purchased credits (never expire) |
+| account_timezone | CharField | IANA timezone (e.g., America/New_York) |
 | stripe_customer_id | CharField | Stripe integration |
 | paypal_customer_id | CharField | PayPal integration |
 | created_at | DateTime | Registration date |
 
+> **Two-Pool Credit System (v1.8.3):** Plan credits consumed first, bonus credits only when plan = 0. Bonus credits never expire.
+
 ### Plan
 
 | Field | Type | Purpose |
 |-------|------|---------|
 | name | CharField | Plan name (Free, Starter, Growth, Scale) |
 | included_credits | Integer | Monthly credit allocation |
-| max_sites | Integer | Site limit |
-| max_users | Integer | User limit |
-| max_keywords | Integer | Keyword limit |
-| max_clusters | Integer | Cluster limit |
-| max_content_ideas | Integer | Monthly idea limit |
-| max_content_words | Integer | Monthly word limit |
-| max_images_basic | Integer | Monthly basic image limit |
-| max_images_premium | Integer | Monthly premium image limit |
+| max_sites | Integer | Site limit (hard limit) |
+| max_users | Integer | User limit (hard limit) |
+| max_keywords | Integer | Keyword limit (hard limit) |
+| max_ahrefs_queries | Integer | Monthly Ahrefs queries (monthly limit) |
 | is_active | Boolean | Available for purchase |
 | is_internal | Boolean | Internal/test plan |
 
+> **Note (v1.5.0+):** Operation limits like `max_clusters`, `max_content_words`, `max_images_basic`, `max_images_premium` were removed. All AI operations are now credit-based.
+
 ### Site
 
 | Field | Type | Purpose |
diff --git a/docs/10-MODULES/INTEGRATIONS.md b/docs/10-MODULES/INTEGRATIONS.md
index 81a99ee3..bf86ba14 100644
--- a/docs/10-MODULES/INTEGRATIONS.md
+++ b/docs/10-MODULES/INTEGRATIONS.md
@@ -1,7 +1,7 @@
 # Integrations Module
 
-**Last Verified:** January 3, 2026  
-**Version:** 1.3.2  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** ✅ Active  
 **Backend Path:** `backend/igny8_core/modules/integration/` + `backend/igny8_core/business/integration/`  
 **Frontend Path:** `frontend/src/pages/Settings/IntegrationSettings.tsx`
diff --git a/docs/10-MODULES/LINKER.md b/docs/10-MODULES/LINKER.md
index 93bbedf5..e86379c8 100644
--- a/docs/10-MODULES/LINKER.md
+++ b/docs/10-MODULES/LINKER.md
@@ -1,6 +1,7 @@
 # Linker Module
 
-**Last Verified:** December 25, 2025  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** ⏸️ Inactive (Disabled by Default)  
 **Backend Path:** `backend/igny8_core/modules/linker/`  
 **Frontend Path:** `frontend/src/pages/Linker/`
diff --git a/docs/10-MODULES/NOTIFICATIONS.md b/docs/10-MODULES/NOTIFICATIONS.md
index b4e93eb3..980bd268 100644
--- a/docs/10-MODULES/NOTIFICATIONS.md
+++ b/docs/10-MODULES/NOTIFICATIONS.md
@@ -1,7 +1,8 @@
 # Notifications Module
 
-**Last Verified:** December 28, 2025  
-**Status:** ✅ Active (v1.2.2 - Notifications Page Added)  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
+**Status:** ✅ Active  
 **Backend Path:** `backend/igny8_core/business/notifications/`  
 **Frontend Path:** `frontend/src/store/notificationStore.ts`, `frontend/src/components/header/NotificationDropdown.tsx`, `frontend/src/pages/account/NotificationsPage.tsx`
 
diff --git a/docs/10-MODULES/OPTIMIZER.md b/docs/10-MODULES/OPTIMIZER.md
index ff7ace29..bc63767e 100644
--- a/docs/10-MODULES/OPTIMIZER.md
+++ b/docs/10-MODULES/OPTIMIZER.md
@@ -1,6 +1,7 @@
 # Optimizer Module
 
-**Last Verified:** December 25, 2025  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** ⏸️ Inactive (Disabled by Default)  
 **Backend Path:** `backend/igny8_core/modules/optimizer/` + `backend/igny8_core/business/optimization/`  
 **Frontend Path:** `frontend/src/pages/Optimizer/`
diff --git a/docs/10-MODULES/PLANNER.md b/docs/10-MODULES/PLANNER.md
index 5c27968f..43beb36f 100644
--- a/docs/10-MODULES/PLANNER.md
+++ b/docs/10-MODULES/PLANNER.md
@@ -1,6 +1,7 @@
 # Planner Module
 
-**Last Verified:** December 25, 2025  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** ✅ Active  
 **Backend Path:** `backend/igny8_core/modules/planner/`  
 **Frontend Path:** `frontend/src/pages/Planner/`
diff --git a/docs/10-MODULES/PUBLISHER.md b/docs/10-MODULES/PUBLISHER.md
index d6d24f87..f82c6e4c 100644
--- a/docs/10-MODULES/PUBLISHER.md
+++ b/docs/10-MODULES/PUBLISHER.md
@@ -1,8 +1,8 @@
 # Publisher Module
 
-**Last Verified:** January 17, 2026  
+**Last Verified:** January 20, 2026  
 **Status:** ✅ Active  
-**Version:** 1.8.0
+**Version:** 1.8.4
 **Backend Path:** `backend/igny8_core/modules/publisher/` + `backend/igny8_core/business/publishing/`  
 **Frontend Path:** `frontend/src/pages/Publisher/`
 
diff --git a/docs/10-MODULES/SYSTEM-SETTINGS.md b/docs/10-MODULES/SYSTEM-SETTINGS.md
index 53fc74b8..d764240c 100644
--- a/docs/10-MODULES/SYSTEM-SETTINGS.md
+++ b/docs/10-MODULES/SYSTEM-SETTINGS.md
@@ -1,10 +1,13 @@
 # System Settings Module
 
-**Last Verified:** December 25, 2025  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** ✅ Active  
 **Backend Path:** `backend/igny8_core/modules/system/`  
 **Frontend Path:** `frontend/src/pages/Settings/`
 
+> **Note (v1.8.0):** AI & Automation settings have been consolidated into Site Settings → Automation tab. See [AUTOMATION.md](AUTOMATION.md) for the unified settings API.
+
 ---
 
 ## Quick Reference
@@ -12,9 +15,13 @@
 | What | File | Key Items |
 |------|------|-----------|
 | Global Models | `modules/system/global_settings_models.py` | `GlobalIntegrationSettings`, `GlobalAIPrompt`, `GlobalAuthorProfile` |
-| Account Models | `modules/system/settings_models.py` | `ModuleEnableSettings`, `IntegrationSettings`, `AISettings` |
+| Account Models | `modules/system/settings_models.py` | `SystemSettings`, `UserSettings` |
+| Email Models | `modules/system/email_models.py` | `EmailSettings`, `EmailTemplate`, `EmailLog` |
+| AI Settings | `modules/system/ai_settings.py` | `SystemAISettings` |
+| Provider Model | `modules/system/models.py` | `IntegrationProvider` |
 | Views | `modules/system/settings_views.py` | Settings ViewSets |
 | Integration Views | `modules/system/integration_views.py` | AI integration settings |
+| **Unified Settings** | `api/unified_settings.py` | **v1.8.0** Site-level consolidated settings |
 | Frontend | `pages/Settings/*.tsx` | Settings pages |
 
 ---
diff --git a/docs/10-MODULES/WRITER.md b/docs/10-MODULES/WRITER.md
index 9d91499b..0537c284 100644
--- a/docs/10-MODULES/WRITER.md
+++ b/docs/10-MODULES/WRITER.md
@@ -1,7 +1,7 @@
 # Writer Module
 
-**Last Verified:** December 27, 2025  
-**Version:** 1.2.0  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** ✅ Active  
 **Backend Path:** `backend/igny8_core/modules/writer/`  
 **Frontend Path:** `frontend/src/pages/Writer/`
diff --git a/docs/20-API/ENDPOINTS.md b/docs/20-API/ENDPOINTS.md
index 276fb00b..958ab214 100644
--- a/docs/20-API/ENDPOINTS.md
+++ b/docs/20-API/ENDPOINTS.md
@@ -1,7 +1,7 @@
 # API Endpoints Reference
 
-**Last Verified:** January 19, 2026  
-**Version:** 1.8.2  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Base URL:** `/api/v1/`  
 **Documentation:** `/api/docs/` (Swagger) | `/api/redoc/` (ReDoc)
 
@@ -457,9 +457,35 @@ GET /api/v1/integration/settings/defaults/
 | GET | `/history/` | History | Past runs |
 | GET | `/logs/` | Logs | Activity log |
 | GET | `/estimate/` | Estimate | Credit estimate |
+| **GET** | `/runs/` | **v1.8.0** List runs | All automation runs (paginated) |
+| **GET** | `/runs/{id}/` | **v1.8.0** Run detail | Single run with stages, logs |
 
 **Query Parameters:** All require `?site_id=`, run-specific require `?run_id=`
 
+### Automation Runs Response (v1.8.0)
+
+```json
+GET /api/v1/automation/runs/?site_id=1
+
+{
+  "count": 25,
+  "results": [
+    {
+      "id": 1,
+      "site": 1,
+      "status": "completed",
+      "started_at": "2026-01-18T09:00:00Z",
+      "completed_at": "2026-01-18T09:45:00Z",
+      "current_stage": 7,
+      "total_stages": 7,
+      "items_processed": 150,
+      "credits_used": 450,
+      "error_message": null
+    }
+  ]
+}
+```
+
 ---
 
 ## Linker Endpoints (`/api/v1/linker/`)
diff --git a/docs/30-FRONTEND/COMPONENT-SYSTEM.md b/docs/30-FRONTEND/COMPONENT-SYSTEM.md
index f410cb4b..1c435f52 100644
--- a/docs/30-FRONTEND/COMPONENT-SYSTEM.md
+++ b/docs/30-FRONTEND/COMPONENT-SYSTEM.md
@@ -1,7 +1,7 @@
 # IGNY8 Frontend Component System
 
-**Last Updated:** January 3, 2026  
-**Version:** 1.3.2
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4
 
 > **🔒 ENFORCED BY ESLINT** - Violations will trigger warnings/errors during build.
 > This document is the single source of truth for all UI components.
diff --git a/docs/30-FRONTEND/DESIGN-GUIDE.md b/docs/30-FRONTEND/DESIGN-GUIDE.md
index acecb920..38edf102 100644
--- a/docs/30-FRONTEND/DESIGN-GUIDE.md
+++ b/docs/30-FRONTEND/DESIGN-GUIDE.md
@@ -4,8 +4,8 @@
 > 
 > 🔒 **STYLE LOCKED** - This design system is enforced by ESLint. All frontend code must comply.
 
-**Last Updated:** January 3, 2026  
-**Version:** 1.3.2
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4
 
 ---
 
diff --git a/docs/30-FRONTEND/DESIGN-TOKENS.md b/docs/30-FRONTEND/DESIGN-TOKENS.md
index ef0d9949..8b86f6f4 100644
--- a/docs/30-FRONTEND/DESIGN-TOKENS.md
+++ b/docs/30-FRONTEND/DESIGN-TOKENS.md
@@ -1,7 +1,7 @@
 # Design System & Component Guidelines
 
-**Last Updated:** January 3, 2026  
-**Version:** 1.3.2
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4
 
 > 🔒 **STYLE SYSTEM LOCKED** - This design system is **LOCKED**. Read this entire document before making any styling changes.
 
diff --git a/docs/30-FRONTEND/PAGES.md b/docs/30-FRONTEND/PAGES.md
index 58ce955f..3d95a8c2 100644
--- a/docs/30-FRONTEND/PAGES.md
+++ b/docs/30-FRONTEND/PAGES.md
@@ -1,17 +1,21 @@
 # Frontend Pages & Routes
 
-**Last Verified:** January 20, 2026  
-**Version:** 1.8.3  
-**Framework:** React 19 + TypeScript + React Router 6 + Vite
+> **Auto-verified against:** `frontend/src/App.tsx`  
+> **Last Verified:** January 20, 2026  
+> **Version:** 1.8.3  
+> **Total Routes:** 100
 
 ---
 
 ## Route Configuration
 
 Routes defined in `/frontend/src/App.tsx`:
-- `ProtectedRoute` - requires authentication
-- `AdminRoute` - requires staff/admin
-- `AppLayout` - shared layout (sidebar + header)
+
+| Guard | Purpose |
+|-------|---------|
+| `ProtectedRoute` | Requires authentication |
+| `AdminRoute` | Requires staff/admin role |
+| `AppLayout` | Shared layout (sidebar + header) |
 
 ---
 
@@ -25,17 +29,10 @@ Routes defined in `/frontend/src/App.tsx`:
 | `/payment` | `Payment.tsx` | Payment page |
 | `/forgot-password` | `AuthPages/ForgotPassword.tsx` | Request password reset |
 | `/reset-password` | `AuthPages/ResetPassword.tsx` | Set new password |
-| `/verify-email` | `AuthPages/VerifyEmail.tsx` | Verify email |
+| `/verify-email` | `AuthPages/VerifyEmail.tsx` | Email verification |
 | `/unsubscribe` | `AuthPages/Unsubscribe.tsx` | Email unsubscribe |
-
----
-
-## Legal Pages
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/privacy` | `legal/Privacy.tsx` | Privacy Policy |
 | `/terms` | `legal/Terms.tsx` | Terms of Service |
+| `/privacy` | `legal/Privacy.tsx` | Privacy Policy |
 
 ---
 
@@ -52,9 +49,9 @@ Routes defined in `/frontend/src/App.tsx`:
 | Route | File | Description |
 |-------|------|-------------|
 | `/setup/wizard` | `Setup/SetupWizard.tsx` | Onboarding wizard |
-| `/keywords-library` | `Setup/IndustriesSectorsKeywords.tsx` | Keywords library (primary route) |
+| `/keywords-library` | `Setup/IndustriesSectorsKeywords.tsx` | Keywords library |
 
-**Legacy redirects:**
+**Redirects:**
 - `/setup/add-keywords` → `/keywords-library`
 - `/setup/industries-sectors-keywords` → `/keywords-library`
 
@@ -67,17 +64,17 @@ Routes defined in `/frontend/src/App.tsx`:
 | `/sites` | `Sites/List.tsx` | Sites list |
 | `/sites/:id` | `Sites/Dashboard.tsx` | Site dashboard |
 | `/sites/:id/pages` | `Sites/PageManager.tsx` | Page manager |
-| `/sites/:id/pages/new` | `Sites/PageManager.tsx` | New page (same manager) |
-| `/sites/:id/pages/:pageId/edit` | `Sites/PageManager.tsx` | Edit page (same manager) |
+| `/sites/:id/pages/new` | `Sites/PageManager.tsx` | New page |
+| `/sites/:id/pages/:pageId/edit` | `Sites/PageManager.tsx` | Edit page |
 | `/sites/:id/content` | `Sites/Content.tsx` | Site content overview |
 | `/sites/:id/content/structure` | `Sites/ContentStructure.tsx` | Content structure |
-| `/sites/:id/settings` | `Sites/Settings.tsx` | Site settings (tabs) |
+| `/sites/:id/settings` | `Sites/Settings.tsx` | Site settings |
 | `/sites/:id/sync` | `Sites/SyncDashboard.tsx` | Sync dashboard |
 | `/sites/:id/deploy` | `Sites/DeploymentPanel.tsx` | Deployment panel |
 | `/sites/:id/posts/:postId` | `Sites/PostEditor.tsx` | Post editor |
-| `/sites/:id/posts/:postId/edit` | `Sites/PostEditor.tsx` | Post editor (same view) |
+| `/sites/:id/posts/:postId/edit` | `Sites/PostEditor.tsx` | Post editor |
 
-**Legacy redirect:**
+**Redirects:**
 - `/sites/:id/publishing-queue` → `/publisher/content-calendar`
 
 ---
@@ -102,11 +99,13 @@ Routes defined in `/frontend/src/App.tsx`:
 | `/writer/tasks` | `Writer/Tasks.tsx` | Task queue |
 | `/writer/content` | `Writer/Content.tsx` | Content list |
 | `/writer/content/:id` | `Writer/ContentView.tsx` | Content detail |
-| `/writer/drafts` | → `/writer/content` | Legacy redirect |
 | `/writer/images` | `Writer/Images.tsx` | Images by content |
 | `/writer/review` | `Writer/Review.tsx` | Review queue |
-| `/writer/approved` | `Writer/Approved.tsx` | Approved/published list |
-| `/writer/published` | → `/writer/approved` | Legacy redirect |
+| `/writer/approved` | `Writer/Approved.tsx` | Approved content |
+
+**Redirects:**
+- `/writer/drafts` → `/writer/content`
+- `/writer/published` → `/writer/approved`
 
 ---
 
@@ -119,7 +118,7 @@ Routes defined in `/frontend/src/App.tsx`:
 | `/automation/runs/:runId` | `Automation/AutomationRunDetail.tsx` | Run detail |
 | `/automation/run` | `Automation/AutomationPage.tsx` | Run execution |
 
-**Legacy redirect:**
+**Redirects:**
 - `/automation/settings` → `/sites/settings?tab=automation`
 
 ---
@@ -133,7 +132,7 @@ Routes defined in `/frontend/src/App.tsx`:
 
 ---
 
-## Linker (Optional)
+## Linker (Optional Module)
 
 | Route | File | Description |
 |-------|------|-------------|
@@ -142,7 +141,7 @@ Routes defined in `/frontend/src/App.tsx`:
 
 ---
 
-## Optimizer (Optional)
+## Optimizer (Optional Module)
 
 | Route | File | Description |
 |-------|------|-------------|
@@ -160,8 +159,8 @@ Routes defined in `/frontend/src/App.tsx`:
 | `/thinker/prompts` | `Thinker/Prompts.tsx` | Prompt management |
 | `/thinker/author-profiles` | `Thinker/AuthorProfiles.tsx` | Author profiles |
 | `/thinker/profile` | `Thinker/Profile.tsx` | Profile settings |
-| `/thinker/strategies` | `Thinker/Strategies.tsx` | Strategies (placeholder) |
-| `/thinker/image-testing` | `Thinker/ImageTesting.tsx` | Image testing (placeholder) |
+| `/thinker/strategies` | `Thinker/Strategies.tsx` | Strategies |
+| `/thinker/image-testing` | `Thinker/ImageTesting.tsx` | Image testing |
 
 ---
 
@@ -182,23 +181,25 @@ Routes defined in `/frontend/src/App.tsx`:
 | Route | File | Description |
 |-------|------|-------------|
 | `/account/notifications` | `account/NotificationsPage.tsx` | Notifications |
-| `/account/settings` | `account/AccountSettingsPage.tsx` | Account settings (tabs) |
+| `/account/settings` | `account/AccountSettingsPage.tsx` | Account settings |
 | `/account/settings/profile` | `account/AccountSettingsPage.tsx` | Profile tab |
 | `/account/settings/team` | `account/AccountSettingsPage.tsx` | Team tab |
-| `/account/team` | → `/account/settings/team` | Legacy redirect |
 | `/account/plans` | `account/PlansAndBillingPage.tsx` | Plans & billing |
 | `/account/plans/upgrade` | `account/PlansAndBillingPage.tsx` | Upgrade tab |
 | `/account/plans/history` | `account/PlansAndBillingPage.tsx` | History tab |
-| `/account/purchase-credits` | → `/account/plans` | Legacy redirect |
 | `/account/usage` | `account/UsageDashboardPage.tsx` | Usage dashboard |
-| `/account/usage/logs` | → `/account/usage` | Legacy redirect |
-| `/account/usage/credits` | → `/account/usage` | Legacy redirect |
-| `/account/usage/insights` | → `/account/usage` | Legacy redirect |
-| `/account/usage/activity` | → `/account/usage` | Legacy redirect |
 | `/account/content-settings` | `account/ContentSettingsPage.tsx` | Content settings |
 | `/account/content-settings/publishing` | `account/ContentSettingsPage.tsx` | Publishing tab |
 | `/account/content-settings/images` | `account/ContentSettingsPage.tsx` | Images tab |
 
+**Redirects:**
+- `/account/team` → `/account/settings/team`
+- `/account/purchase-credits` → `/account/plans`
+- `/account/usage/logs` → `/account/usage`
+- `/account/usage/credits` → `/account/usage`
+- `/account/usage/insights` → `/account/usage`
+- `/account/usage/activity` → `/account/usage`
+
 ---
 
 ## Reference Data
@@ -210,7 +211,7 @@ Routes defined in `/frontend/src/App.tsx`:
 
 ---
 
-## Settings
+## Settings (Admin)
 
 | Route | File | Description |
 |-------|------|-------------|
@@ -221,11 +222,13 @@ Routes defined in `/frontend/src/App.tsx`:
 | `/settings/account` | `Settings/Account.tsx` | Account settings |
 | `/settings/plans` | `Settings/Plans.tsx` | Plans |
 | `/settings/industries` | `Settings/Industries.tsx` | Industries |
-| `/settings/integration` | `Settings/Integration.tsx` | Integrations (admin only) |
+| `/settings/integration` | `Settings/Integration.tsx` | Integrations |
 | `/settings/publishing` | `Settings/Publishing.tsx` | Publishing settings |
 | `/settings/sites` | `Settings/Sites.tsx` | Sites settings |
-| `/settings/profile` | → `/account/settings` | Legacy redirect |
-| `/settings/import-export` | → `/` | Legacy redirect |
+
+**Redirects:**
+- `/settings/profile` → `/account/settings`
+- `/settings/import-export` → `/`
 
 ---
 
@@ -237,7 +240,7 @@ Routes defined in `/frontend/src/App.tsx`:
 
 ---
 
-## Internal Pages (Non-Indexed)
+## Internal Pages (Dev Only)
 
 | Route | File | Description |
 |-------|------|-------------|
@@ -246,7 +249,7 @@ Routes defined in `/frontend/src/App.tsx`:
 
 ---
 
-## Fallback Route
+## Fallback
 
 | Route | File | Description |
 |-------|------|-------------|
@@ -254,7 +257,7 @@ Routes defined in `/frontend/src/App.tsx`:
 
 ---
 
-## Page File Locations (Source of Truth)
+## Page Files Directory
 
 ```
 frontend/src/pages/
@@ -303,7 +306,8 @@ frontend/src/pages/
 │   ├── Ideas.tsx
 │   └── Keywords.tsx
 ├── Publisher/
-│   └── ContentCalendar.tsx
+│   ├── ContentCalendar.tsx
+│   └── PublishSettings.tsx
 ├── Reference/
 │   ├── Industries.tsx
 │   └── SeedKeywords.tsx
@@ -318,7 +322,8 @@ frontend/src/pages/
 │   ├── Sites.tsx
 │   ├── Subscriptions.tsx
 │   ├── System.tsx
-│   └── Users.tsx
+│   ├── Users.tsx
+│   └── WordPressIntegrationDebug.tsx
 ├── Setup/
 │   ├── IndustriesSectorsKeywords.tsx
 │   └── SetupWizard.tsx
@@ -350,504 +355,4 @@ frontend/src/pages/
 ├── Components.tsx
 ├── Payment.tsx
 └── UIElements.tsx
-```# Frontend Pages & Routes
-
-**Last Verified:** January 17, 2026  
-**Version:** 1.8.0  
-**Framework:** React 19 + TypeScript + React Router 6 + Vite
-
----
-
-## Route Configuration
-
-Routes defined in `/frontend/src/App.tsx`:
-- `PrivateRoute` - Requires authentication
-- `AdminRoute` - Requires admin/staff role
-- Nested layouts with `AppLayout` (sidebar + header)
-
----
-
-## Public Routes (No Auth Required)
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/login` | `AuthPages/SignIn.tsx` | User login |
-| `/register` | `AuthPages/SignUp.tsx` | New account registration |
-| `/forgot-password` | `AuthPages/ForgotPassword.tsx` | Request password reset |
-| `/reset-password/:token` | `AuthPages/ResetPassword.tsx` | Set new password |
-| `/verify-email/:token` | `AuthPages/VerifyEmail.tsx` | Email verification |
-
----
-
-## Legal Pages (v1.3.0)
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/privacy` | `legal/Privacy.tsx` | Privacy Policy |
-| `/terms` | `legal/Terms.tsx` | Terms of Service |
-
----
-
-## Dashboard
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/` | `Dashboard/Home.tsx` | Main dashboard with workflow pipeline, metrics, quick actions |
-
-**v1.2.0 Dashboard Widgets:**
-- `WorkflowPipelineWidget` - Visual flow: Sites → Keywords → Clusters → Ideas → Tasks → Drafts → Published
-- `AIOperationsWidget` - Operation stats (clustering, ideas, content, images) with time filter (7d/30d/90d)
-- `RecentActivityWidget` - Activity feed with type-specific icons
-- `ContentVelocityWidget` - Week/Month/Total metrics table
-- `AutomationStatusWidget` - Status, schedule, last/next run, run controls
-- `NeedsAttentionBar` - Alert bar for pending actions requiring attention
-- `QuickActionsWidget` - Quick action buttons for common tasks
-
-**Data Sources:**
-- Pipeline counts from actual API calls (keywords, clusters, ideas, tasks, content)
-- AI operations derived from content creation totals
-- Activity generated from real data with capped display values
-
----
-
-## 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 |
-|-------|------|-------------|
-| `/setup/add-keywords` | `Setup/IndustriesSectorsKeywords.tsx` | Browse/add seed keywords from global database |
-
-**Features:**
-- Industry → Sector → Keywords browse hierarchy
-- "Show not-added only" filter toggle
-- Real-time keyword count summary (added/total)
-- "Next: Plan Your Content" CTA button
-- "Keyword Research" coming soon teaser
-
-### Content Settings
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/account/content-settings` | `account/ContentSettingsPage.tsx` | 3 tabs: Content Generation, Publishing, Image Settings |
-
-**API Endpoints:** Settings persisted via `/api/v1/system/settings/content/{key}/`
-
-### Sites
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/sites` | `Sites/List.tsx` | Site listing with setup checklist per site |
-| `/sites/:id` | `Sites/Dashboard.tsx` | Site dashboard with quick actions and widgets |
-| `/sites/:id/settings` | `Sites/Settings.tsx` | Site settings (General, Automation, Integrations) |
-
-**v1.8.0 Changes:**
-- Site Settings now has 3 tabs: General, Automation, Integrations
-- Automation tab consolidates all AI, Automation, and Publishing settings
-- Removed separate AI Settings tab
-- Uses `AIAutomationSettings.tsx` component for unified settings UI
-
-**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
-
-**Components:**
-- `SiteSetupChecklist` - Shows setup progress (site created, industry/sectors, WordPress, keywords)
-- `SiteInfoBar` - Reusable site info header for site-specific pages
-- `AIAutomationSettings` - Unified settings component (v1.8.0)
-
-### Thinker (Admin Only)
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/thinker/prompts` | `Thinker/Prompts.tsx` | AI prompt template management |
-| `/thinker/author-profiles` | `Thinker/AuthorProfiles.tsx` | Author profile CRUD |
-| `/thinker/strategies` | `Thinker/Strategies.tsx` | Coming Soon placeholder |
-| `/thinker/image-testing` | `Thinker/ImageTesting.tsx` | Coming Soon placeholder |
-
----
-
-## WORKFLOW Routes
-
-### Planner
-
-| Route | File | Description | Tab |
-|-------|------|-------------|-----|
-| `/planner` | → `/planner/keywords` | Redirect | - |
-| `/planner/keywords` | `Planner/Keywords.tsx` | Keyword management, bulk actions | Keywords |
-| `/planner/clusters` | `Planner/Clusters.tsx` | Cluster listing, AI clustering | Clusters |
-| `/planner/clusters/:id` | `Planner/ClusterView.tsx` | Individual cluster view | - |
-| `/planner/ideas` | `Planner/Ideas.tsx` | Content ideas, queue to writer | Ideas |
-
-### Writer
-
-| Route | File | Description | Tab |
-|-------|------|-------------|-----|
-| `/writer` | → `/writer/tasks` | Redirect | - |
-| `/writer/tasks` | `Writer/Tasks.tsx` | Task queue, content generation | Queue |
-| `/writer/drafts` | `Writer/Drafts.tsx` | Draft content listing | Drafts |
-| `/writer/content/:id` | `Writer/ContentView.tsx` | Content detail view (read-only) | - |
-| `/writer/images` | `Writer/Images.tsx` | Image management by content | Images |
-| `/writer/review` | `Writer/Review.tsx` | Review queue (status=review) | Review |
-| `/writer/approved` | `Writer/Approved.tsx` | Approved content (status=approved/published) | Approved |
-
-**v1.2.0 Changes:**
-- Renamed "Published" to "Approved" page
-- Legacy route `/writer/published` redirects to `/writer/approved`
-- ThreeWidgetFooter added to Tasks, Content pages
-
-### Automation
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/automation` | `Automation/AutomationPage.tsx` | 7-stage pipeline, run controls |
-| `/automation/overview` | `Automation/AutomationOverview.tsx` | Run history dashboard (v1.7.0) |
-| `/automation/runs/:id` | `Automation/AutomationRunDetail.tsx` | Detailed run view (v1.7.0) |
-
-**v1.8.0 Changes:**
-- Removed `/automation/settings` route (merged into Site Settings → Automation tab)
-- Added redirect from `/automation/settings` to `/sites/settings?tab=automation`
-
-**v1.7.0 Changes:**
-- Added AutomationOverview page with run history
-- Added AutomationRunDetail page for detailed run information
-
----
-
-## 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` |
-| `/automation/settings` | `/sites/settings?tab=automation` (v1.8.0) |
-
-**Removed in v1.8.0:**
-- `/publisher/settings` - No longer exists (settings in Site Settings → Automation)
-
-### Linker (Optional Module)
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/linker` | → `/linker/content` | Redirect |
-| `/linker/content` | `Linker/Content.tsx` | Content list for internal linking |
-| `/linker/dashboard` | `Linker/Dashboard.tsx` | Not exposed in navigation |
-
-### Optimizer (Optional Module)
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/optimizer` | → `/optimizer/content` | Redirect |
-| `/optimizer/content` | `Optimizer/Content.tsx` | Content list with optimization scores |
-| `/optimizer/preview/:id` | `Optimizer/AnalysisPreview.tsx` | Not linked from UI |
-| `/optimizer/dashboard` | `Optimizer/Dashboard.tsx` | Not exposed in navigation |
-
----
-
-## ACCOUNT Routes
-
-### Notifications
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/account/notifications` | `account/NotificationsPage.tsx` | Full notifications history with filters and bulk actions |
-
-**Features:**
-- Filter by severity (info/success/warning/error)
-- Filter by notification type (AI operations, WordPress sync, credits, etc.)
-- Filter by read status (all/unread/read)
-- Filter by site
-- Filter by date range (from/to)
-- Mark individual notifications as read
-- Mark all as read (bulk action)
-- Delete individual notifications
-- Click notification to navigate to related page
-- Real-time unread count badge
-
-**v1.2.2 Changes:**
-- NEW page created with full filtering capabilities
-- Linked from NotificationDropdown "View All Notifications" button
-- Added to sidebar under ACCOUNT section with unread badge
-
-### Account Settings
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/account/settings` | `account/AccountSettingsPage.tsx` | 3 tabs: Account, Profile, Team |
-
-**Tab Structure:**
-- **Account**: Organization name, billing address, tax ID
-- **Profile**: Name, email, phone, timezone, language, notifications, security (password change modal)
-- **Team**: Team member list, invite, remove
-
-**v1.1.6 Changes:**
-- Profile tab loads from auth store user data
-- Added Change Password modal with validation
-- Uses `/v1/auth/change-password/` endpoint
-
-### Plans & Billing
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/account/plans` | `account/PlansAndBillingPage.tsx` | 3 tabs: Plan, Upgrade, History |
-
-**Tab Structure:**
-- **Current Plan**: Plan details, features, credits, renewal date
-- **Upgrade Plan**: Pricing table, plan comparison
-- **History**: Invoices, payments, payment methods
-
-**v1.1.6 Changes:**
-- Added cancellation confirmation modal (prevents accidental cancellations)
-
-### Usage
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/account/usage` | `account/UsageAnalyticsPage.tsx` | 3 tabs: Limits, Credit History, API Activity |
-
-**Tab Structure:**
-- **Your Limits & Usage**: Hard + monthly limits with usage bars
-- **Credit History**: Transaction log
-- **API Activity**: Operations by type (using real analytics data)
-
-**v1.1.6 Changes:**
-- Fixed fake API Activity data - now shows real `usage_by_type` data
-- Removed hardcoded placeholder values
-
-### AI Models (Admin Only)
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/settings/integration` | `Settings/IntegrationPage.tsx` | OpenAI, Runware config, image testing, site integrations |
-
----
-
-## HELP Routes
-
-| Route | File | Description |
-|-------|------|-------------|
-| `/help` | `Help/Help.tsx` | Documentation, FAQ, support CTAs |
-
-**v1.1.7 Changes:**
-- Fixed support buttons (now mailto: links)
-- Added Dashboard, Setup, Account & Billing documentation sections
-- Expanded FAQ with credits, billing, WordPress, automation topics
-- Deleted placeholder pages: Documentation.tsx, SystemTesting.tsx, FunctionTesting.tsx
-
-**Documentation Sections:**
-- Getting Started (Quick Start, Workflow Overview)
-- Dashboard (Metrics, Pipeline, Setup Checklist)
-- Setup Module (Add Keywords, Content Settings, Sites)
-- Planner Module (Keywords, Clusters, Ideas)
-- Writer Module (Tasks, Content, Images)
-- Automation Setup
-- Account & Billing (Account Settings, Plans, Usage)
-- FAQ (~28 questions)
-
----
-
-## Legacy Redirects
-
-These routes redirect to their new locations:
-
-| Old Route | Redirects To |
-|-----------|--------------|
-| `/team` | `/account/settings` |
-| `/profile` | `/account/settings` |
-| `/import-export` | `/account/settings` |
-| `/billing/overview` | `/account/plans` |
-| `/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 |
-
----
-
-## Page File Locations
-
 ```
-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
-│   └── CreditActivity.tsx          # Credit History tab component
-├── AuthPages/
-│   ├── SignIn.tsx
-│   ├── SignUp.tsx
-│   ├── ForgotPassword.tsx
-│   ├── ResetPassword.tsx
-│   └── VerifyEmail.tsx
-├── Automation/
-│   └── AutomationPage.tsx
-├── Billing/
-│   └── CreditPurchase.tsx
-├── Dashboard/
-│   └── Home.tsx
-├── Help/
-│   └── Help.tsx                    # Main help page with docs, FAQ
-├── Linker/
-│   ├── Content.tsx
-│   └── Dashboard.tsx               # Not exposed
-├── Optimizer/
-│   ├── Content.tsx
-│   ├── AnalysisPreview.tsx         # Not linked
-│   └── Dashboard.tsx               # Not exposed
-├── Planner/
-│   ├── Keywords.tsx
-│   ├── Clusters.tsx
-│   ├── ClusterDetail.tsx
-│   └── Ideas.tsx
-├── Publisher/                       # NEW v1.3.2
-│   └── ContentCalendar.tsx
-├── Settings/
-│   └── IntegrationPage.tsx         # AI Models (admin)
-├── Setup/
-│   ├── IndustriesSectorsKeywords.tsx  # Add Keywords page
-│   └── SetupWizard.tsx             # NEW v1.3.2 - Onboarding wizard
-├── Sites/
-│   ├── List.tsx                    # Site listing
-│   ├── 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
-│   ├── 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
-```
-
----
-
-## Route Guards
-
-### PrivateRoute
-- Checks `authStore.isAuthenticated`
-- Redirects to `/login` if not authenticated
-- Stores intended destination for post-login redirect
-
-### AdminRoute
-- Requires `user.role === 'admin'` or `user.is_staff === true`
-- Used for: Thinker module, AI Models page
-
-### Module-Based Visibility
-- Sidebar items hidden via `moduleStore.isModuleEnabled()`
-- Routes still accessible via direct URL (no server-side blocking)
-
----
-
-## Navigation Structure (Sidebar v1.3.2)
-
-```
-Dashboard
-├── SETUP
-│   ├── Setup Wizard [first-time users]
-│   ├── Add Keywords
-│   ├── Content Settings
-│   ├── Sites
-│   └── Thinker [admin only, if thinker enabled]
-├── WORKFLOW
-│   ├── Planner [if planner enabled]
-│   │   └── In-page: Keywords → Clusters → Ideas
-│   ├── 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)
-│   └── AI Models [admin only]
-└── HELP
-    └── Help & Docs
-```
-
----
-
-## Component Updates (v1.3.2)
-
-**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
-
-**Updated Components:**
-- All components updated for semantic color tokens
-- Badge, Button, Card use design system colors
-- 100+ files with color standardization
diff --git a/docs/30-FRONTEND/STORES.md b/docs/30-FRONTEND/STORES.md
index 97cc93f7..d8347390 100644
--- a/docs/30-FRONTEND/STORES.md
+++ b/docs/30-FRONTEND/STORES.md
@@ -1,7 +1,7 @@
 # Zustand State Management
 
-**Last Verified:** January 3, 2026  
-**Version:** 1.3.2  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Framework:** Zustand 4 with persist middleware
 
 ---
@@ -15,18 +15,20 @@ All stores in `/frontend/src/store/` use Zustand with TypeScript.
 - Async actions for API calls
 - Selectors for derived state
 
-**Available Stores:**
-- `authStore.ts` - Authentication state
-- `siteStore.ts` - Site selection/management
-- `sectorStore.ts` - Sector management
-- `plannerStore.ts` - Planner module state
-- `billingStore.ts` - Billing/credits
-- `notificationStore.ts` - Notifications
-- `settingsStore.ts` - User preferences
-- `moduleStore.ts` - Module navigation
-- `columnVisibilityStore.ts` - Table column prefs
-- `pageSizeStore.ts` - Table pagination prefs
-- **`onboardingStore.ts`** - Onboarding wizard state (v1.3.2)
+**Available Stores (11 total):**
+| Store | File | Purpose |
+|-------|------|---------|
+| Auth | `authStore.ts` | Authentication, user session, account |
+| Site | `siteStore.ts` | Site selection/management |
+| Sector | `sectorStore.ts` | Sector management within sites |
+| Planner | `plannerStore.ts` | Planner module state |
+| Billing | `billingStore.ts` | Credits, billing info |
+| Notification | `notificationStore.ts` | App notifications |
+| Settings | `settingsStore.ts` | User preferences |
+| Module | `moduleStore.ts` | Module enable/disable state |
+| Column Visibility | `columnVisibilityStore.ts` | Table column preferences |
+| Page Size | `pageSizeStore.ts` | Table pagination preferences |
+| Onboarding | `onboardingStore.ts` | Onboarding wizard state |
 
 ---
 
diff --git a/docs/40-WORKFLOWS/AUTOMATION-AND-PUBLISHING-SCHEDULING.md b/docs/40-WORKFLOWS/AUTOMATION-AND-PUBLISHING-SCHEDULING.md
index 1babfd7e..adc9f443 100644
--- a/docs/40-WORKFLOWS/AUTOMATION-AND-PUBLISHING-SCHEDULING.md
+++ b/docs/40-WORKFLOWS/AUTOMATION-AND-PUBLISHING-SCHEDULING.md
@@ -49,7 +49,7 @@ IGNY8 uses **Celery Beat** to schedule two distinct but related systems:
 | Task Name | Schedule | Purpose |
 |-----------|----------|---------|
 | `automation.check_scheduled_automations` | Every hour at `:05` | Check if any automation configs should run |
-| `automation.check_test_triggers` | Every minute | Check for admin test triggers (exits early if none) |
+| `automation.check_test_triggers` | Every 5 minutes | Check for admin test triggers (exits early if none) |
 
 ### How It Works
 
diff --git a/docs/40-WORKFLOWS/CONTENT-PIPELINE.md b/docs/40-WORKFLOWS/CONTENT-PIPELINE.md
index deb181da..c20d91ff 100644
--- a/docs/40-WORKFLOWS/CONTENT-PIPELINE.md
+++ b/docs/40-WORKFLOWS/CONTENT-PIPELINE.md
@@ -1,6 +1,7 @@
 # Content Pipeline Workflow
 
-**Last Verified:** December 25, 2025
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4
 
 ---
 
@@ -35,7 +36,7 @@ The IGNY8 content pipeline transforms raw keywords into published WordPress arti
 ## Stage 1: Keywords
 
 **Module:** Planner  
-**Status Values:** `pending`, `clustered`, `used`, `archived`
+**Status Values:** `new`, `mapped`
 
 ### Input
 - Seed keywords (manually added or from SEO tools)
diff --git a/docs/40-WORKFLOWS/CONTENT-PUBLISHING.md b/docs/40-WORKFLOWS/CONTENT-PUBLISHING.md
index 4d029798..8232972e 100644
--- a/docs/40-WORKFLOWS/CONTENT-PUBLISHING.md
+++ b/docs/40-WORKFLOWS/CONTENT-PUBLISHING.md
@@ -1,6 +1,7 @@
 # Content Publishing Workflow Guide
 
-**Last Updated**: January 2026  
+**Last Updated**: January 20, 2026  
+**Version**: 1.8.4  
 **Status**: Production  
 **Audience**: Content Editors, Publishers, Site Administrators
 
diff --git a/docs/40-WORKFLOWS/CREDIT-SYSTEM.md b/docs/40-WORKFLOWS/CREDIT-SYSTEM.md
index d5b12132..2e7059b1 100644
--- a/docs/40-WORKFLOWS/CREDIT-SYSTEM.md
+++ b/docs/40-WORKFLOWS/CREDIT-SYSTEM.md
@@ -1,13 +1,18 @@
 # Credit System
 
-**Last Verified:** January 10, 2026
-**Status:** ✅ Complete (v1.7.1 - Image Generation Credits)
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
+**Status:** ✅ Complete (v1.8.3 - Two-Pool Credit System)
 
 ---
 
 ## Overview
 
-IGNY8 uses a unified credit system where all AI operations consume credits from a single balance. Plan limits are simplified to 4 hard/monthly limits only.
+IGNY8 uses a **two-pool credit system** (v1.8.3):
+- **Plan Credits** (`account.credits`): From subscription, reset on renewal
+- **Bonus Credits** (`account.bonus_credits`): Purchased, **NEVER expire**
+
+**Usage Priority:** Plan credits consumed first, bonus credits only when plan = 0.
 
 ---
 
diff --git a/docs/40-WORKFLOWS/SCHEDULED-CONTENT-PUBLISHING.md b/docs/40-WORKFLOWS/SCHEDULED-CONTENT-PUBLISHING.md
index 9f02018f..641e850a 100644
--- a/docs/40-WORKFLOWS/SCHEDULED-CONTENT-PUBLISHING.md
+++ b/docs/40-WORKFLOWS/SCHEDULED-CONTENT-PUBLISHING.md
@@ -1,6 +1,7 @@
 # Scheduled Content Publishing Workflow
 
-**Last Updated:** January 16, 2026  
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4  
 **Module:** Publishing / Automation  
 **Status:** ✅ Site filtering fixed and verified
 
diff --git a/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md b/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md
index 322efd43..1b5899c8 100644
--- a/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md
+++ b/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md
@@ -1,7 +1,7 @@
 # WordPress Integration & Publishing Flow - Complete Technical Documentation
 
-**Last Updated:** January 10, 2026  
-**Version:** 1.7.0  
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** Production Active
 
 ---
diff --git a/docs/60-PLUGINS/INDEX.md b/docs/60-PLUGINS/INDEX.md
index b3159fdb..5f4568ab 100644
--- a/docs/60-PLUGINS/INDEX.md
+++ b/docs/60-PLUGINS/INDEX.md
@@ -1,7 +1,7 @@
 # Plugin Management Documentation
 
-**Last Updated:** January 10, 2026  
-**Version:** 1.7.0  
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** Production
 
 This section covers plugin distribution, management, and integration from the IGNY8 app perspective.
diff --git a/docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md b/docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md
index a9ecf6d8..afffc0d8 100644
--- a/docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md
+++ b/docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md
@@ -1,7 +1,7 @@
 # Plugin Update Workflow
 
-**Last Updated:** January 10, 2026  
-**Version:** 1.7.0  
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** Production  
 **Scope:** How to release plugin updates and what happens automatically vs manually
 
diff --git a/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md b/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md
index 4877b600..1c439961 100644
--- a/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md
+++ b/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md
@@ -1,7 +1,7 @@
 # WordPress Integration Management
 
-**Last Updated:** January 10, 2026  
-**Version:** 1.7.0  
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4  
 **Status:** Production  
 **Scope:** App-side management of WordPress plugin distribution and site integrations
 
diff --git a/docs/90-REFERENCE/AI-FUNCTIONS.md b/docs/90-REFERENCE/AI-FUNCTIONS.md
index 2dda5e77..b0c09dd5 100644
--- a/docs/90-REFERENCE/AI-FUNCTIONS.md
+++ b/docs/90-REFERENCE/AI-FUNCTIONS.md
@@ -1,6 +1,7 @@
 # AI Functions Reference
 
-**Last Verified:** January 6, 2026
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4
 
 ---
 
@@ -8,12 +9,13 @@
 
 IGNY8's AI engine provides functions for content planning and generation. Located in `backend/igny8_core/ai/`.
 
-**Providers (v1.4.0):**
+**Providers (v1.4.0+):**
 - **OpenAI** - GPT-4 for text, DALL-E 3 for images (via `IntegrationProvider`)
 - **Anthropic** - Claude models for text (via `IntegrationProvider`)
 - **Runware** - Alternative image generation (via `IntegrationProvider`)
+- **Bria** - Additional image generation option
 
-**New in v1.4.0:**
+**Key Features:**
 - Provider API keys stored in `IntegrationProvider` model
 - Model configurations stored in `AIModelConfig` model
 - System defaults stored in `SystemAISettings` singleton
diff --git a/docs/90-REFERENCE/DJANGO-ADMIN-ACCESS-GUIDE.md b/docs/90-REFERENCE/DJANGO-ADMIN-ACCESS-GUIDE.md
index ecff18fa..e15bb20a 100644
--- a/docs/90-REFERENCE/DJANGO-ADMIN-ACCESS-GUIDE.md
+++ b/docs/90-REFERENCE/DJANGO-ADMIN-ACCESS-GUIDE.md
@@ -1,6 +1,7 @@
 # Django Admin Access Guide - Payment & Email Integration Settings
 
-**Date:** January 7, 2026  
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4  
 **Purpose:** Guide to configure Stripe, PayPal, and Resend credentials via Django Admin
 
 ---
diff --git a/docs/90-REFERENCE/FIXES-KB.md b/docs/90-REFERENCE/FIXES-KB.md
index 34f6af33..86e782a0 100644
--- a/docs/90-REFERENCE/FIXES-KB.md
+++ b/docs/90-REFERENCE/FIXES-KB.md
@@ -1,5 +1,6 @@
 # Architecture Knowledge Base
-**Last Updated:** December 14, 2025  
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4  
 **Purpose:** Critical architectural patterns, common issues, and solutions reference
 
 ---
diff --git a/docs/90-REFERENCE/MODELS.md b/docs/90-REFERENCE/MODELS.md
index 9130858b..2f1a0a3a 100644
--- a/docs/90-REFERENCE/MODELS.md
+++ b/docs/90-REFERENCE/MODELS.md
@@ -1,6 +1,8 @@
 # Database Models Reference
 
-**Last Verified:** January 6, 2026
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
+**Total Models:** 52+
 
 ---
 
@@ -8,14 +10,32 @@
 
 | Scope | Models | Base Class | Filter By |
 |-------|--------|------------|-----------|
-| **Global** | `IntegrationProvider`, `AIModelConfig`, `SystemAISettings`, `GlobalAIPrompt`, `GlobalAuthorProfile`, `GlobalStrategy`, `GlobalModuleSettings`, `Industry`, `SeedKeyword` | `models.Model` | None (platform-wide) |
-| **Account** | `Account`, `User`, `Plan`, `AccountSettings`, `ModuleEnableSettings`, `AISettings`, `AIPrompt`, `AuthorProfile`, `CreditBalance` | `AccountBaseModel` | `account` |
-| **Site** | `Site`, `PublishingSettings`, `AutomationConfig`, `SiteIntegration` | `AccountBaseModel` | `account`, `site` |
-| **Site+Sector** | `Keywords`, `Clusters`, `ContentIdeas`, `Tasks`, `Content`, `Images` | `SiteSectorBaseModel` | `site`, `sector` |
+| **Global** | `IntegrationProvider`, `AIModelConfig`, `SystemAISettings`, `GlobalAIPrompt`, `GlobalAuthorProfile`, `GlobalStrategy`, `GlobalModuleSettings`, `Industry`, `IndustrySector`, `SeedKeyword` | `models.Model` | None (platform-wide) |
+| **Account** | `Account`, `User`, `Plan`, `Subscription`, `AccountSettings`, `ModuleEnableSettings`, `AISettings`, `AIPrompt`, `AuthorProfile`, `CreditBalance`, `PasswordResetToken` | `AccountBaseModel` | `account` |
+| **Site** | `Site`, `PublishingSettings`, `AutomationConfig`, `DefaultAutomationConfig`, `AutomationRun`, `SiteIntegration`, `SiteUserAccess` | `AccountBaseModel` | `account`, `site` |
+| **Site+Sector** | `Keywords`, `Clusters`, `ContentIdeas`, `Tasks`, `Content`, `Images`, `ContentTaxonomyRelation` | `SiteSectorBaseModel` | `site`, `sector` |
+| **Billing** | `CreditCostConfig`, `BillingConfiguration`, `CreditPackage`, `PaymentMethodConfig`, `WebhookEvent` | `models.Model` | varies |
+| **System** | `SystemSettings`, `UserSettings`, `EmailSettings`, `EmailTemplate`, `EmailLog` | `models.Model` | varies |
+| **Plugins** | `Plugin`, `PluginVersion`, `PluginInstallation`, `PluginDownload` | `models.Model` | varies |
 
 ---
 
-## System Models (v1.4.0) (`igny8_core/modules/system/`)
+## Model Count by Location
+
+| Location | Count | Models |
+|----------|-------|--------|
+| `auth/models.py` | 10 | Account, User, Plan, Subscription, Industry, IndustrySector, SeedKeyword, Site, SiteUserAccess, PasswordResetToken |
+| `modules/system/` | 10 | IntegrationProvider, SystemAISettings, SystemSettings, UserSettings, EmailSettings, EmailTemplate, EmailLog, GlobalAIPrompt, GlobalAuthorProfile, GlobalStrategy |
+| `business/automation/` | 3 | DefaultAutomationConfig, AutomationConfig, AutomationRun |
+| `business/billing/` | 6 | CreditCostConfig, BillingConfiguration, CreditPackage, PaymentMethodConfig, AIModelConfig, WebhookEvent |
+| `business/content/` | 1 | ContentTaxonomyRelation |
+| `plugins/` | 4 | Plugin, PluginVersion, PluginInstallation, PluginDownload |
+| `modules/planner/` | 3 | Keywords, Clusters, ContentIdeas |
+| `modules/writer/` | 3 | Tasks, Content, Images |
+
+---
+
+## System Models (v1.4.0+) (`igny8_core/modules/system/`)
 
 **Purpose:** Centralized AI configuration, provider API keys, and system-wide defaults.
 
@@ -361,17 +381,15 @@ class Keyword(models.Model):
     difficulty = IntegerField(null=True)
     cpc = DecimalField(null=True)
     
-    status = CharField(choices=KEYWORD_STATUS)  # pending, clustered, used, archived
+    status = CharField(choices=KEYWORD_STATUS)  # new, mapped
     
     created_by = ForeignKey(User)
     created_at = DateTimeField(auto_now_add=True)
 ```
 
 **Status Values:**
-- `pending` - New, awaiting clustering
-- `clustered` - Assigned to a cluster
-- `used` - Used in content idea
-- `archived` - No longer active
+- `new` - Ready for clustering
+- `mapped` - Assigned to a cluster
 
 ---
 
@@ -433,8 +451,7 @@ class Task(models.Model):
     primary_keyword = CharField(max_length=255)
     secondary_keywords = JSONField(default=list)
     
-    status = CharField(choices=TASK_STATUS)  # pending, in_progress, completed, cancelled
-    priority = CharField(choices=PRIORITY)   # low, medium, high
+    status = CharField(choices=TASK_STATUS)  # queued, completed
     
     assigned_to = ForeignKey(User, null=True)
     due_date = DateField(null=True)
diff --git a/docs/90-REFERENCE/SEED-KEYWORDS-IMPORT-GUIDE.md b/docs/90-REFERENCE/SEED-KEYWORDS-IMPORT-GUIDE.md
index 911e6775..0d10ea75 100644
--- a/docs/90-REFERENCE/SEED-KEYWORDS-IMPORT-GUIDE.md
+++ b/docs/90-REFERENCE/SEED-KEYWORDS-IMPORT-GUIDE.md
@@ -1,5 +1,8 @@
 # Global Keywords Database (SeedKeyword) - Import Guide
 
+**Last Updated:** January 20, 2026  
+**Version:** 1.8.4
+
 ## Overview
 
 The Global Keywords Database stores canonical keyword suggestions that can be imported into account-specific keywords. These are organized by Industry and Sector.
diff --git a/docs/INDEX.md b/docs/INDEX.md
index 2e04319a..750050b6 100644
--- a/docs/INDEX.md
+++ b/docs/INDEX.md
@@ -1,6 +1,6 @@
 # IGNY8 Technical Documentation
 
-**Version:** 1.8.3
+**Version:** 1.8.4  
 **Last Updated:** January 20, 2026  
 **Purpose:** Complete technical reference for the IGNY8 AI content platform
 
diff --git a/docs/audits/BILLING-SYSTEM-AUDIT-AND-REFACTOR-PLAN-20260120.md b/docs/audits/BILLING-SYSTEM-AUDIT-AND-REFACTOR-PLAN-20260120.md
deleted file mode 100644
index 3bf30325..00000000
--- a/docs/audits/BILLING-SYSTEM-AUDIT-AND-REFACTOR-PLAN-20260120.md
+++ /dev/null
@@ -1,267 +0,0 @@
-# IGNY8 Billing System Audit + Refactor Plan
-
-**Date:** January 20, 2026  
-**Status:** Critical  
-**Scope:** Billing system, payment methods, subscriptions, credits, invoices, PK (Pakistan) bank transfer flow  
-
----
-
-## 1) Executive Summary
-
-The billing system has **critical functional and architectural issues** affecting credit accuracy, manual payment approvals, invoice lifecycles, and monthly credit resets. Stripe and PayPal flows largely work, but manual approvals (especially PK bank transfer) and credit lifecycle rules are broken. Credits do not expire, and subscription credits do not reset correctly for manual renewals.
-
-The plan below preserves all current payment methods while fixing the broken flows and making all states visible and auditable.
-
----
-
-## 2) Current System Coverage (What Exists Today)
-
-### Payment Methods (Country Rules)
-
-| Region | Available Methods | Notes |
-|---|---|---|
-| Non‑PK | Stripe, PayPal | Bank transfer disabled |
-| PK | Stripe, Bank Transfer | PayPal disabled |
-
-### Core Billing Components
-
-| Component | Purpose | Current State |
-|---|---|---|
-| Account status | Controls access | Active, trial, pending_payment used |
-| Subscription | Plan + billing cycle | Present, but manual renewals mishandle credits |
-| Invoices | Payment tracking | Present, but no type/expiry enforcement |
-| Payments | Gateway/Manual transactions | Present, but approval logic incomplete |
-| Credits | Single counter | No expiry, no separation |
-
----
-
-## 3) Critical Issues (Audit Findings)
-
-### Issue A — Wrong Credits Added for Manual Credit Purchases
-**Impact:** Users buy a credit package (e.g., 500) but receive subscription credits (e.g., 200).  
-**Cause:** Approval logic uses plan credits instead of credit package credits.
-
-### Issue B — Manual Renewal Adds Instead of Resets
-**Impact:** Monthly renewal should reset credits but instead adds to leftover balance.  
-**Cause:** Manual approval uses add instead of reset.
-
-### Issue C — No Credit Expiry / Validity Rules
-**Impact:** Credits never expire. Business rule requires 1‑month validity.  
-**Cause:** No expiry metadata or tasks.
-
-### Issue D — Invoice Types Not Enforced
-**Impact:** Subscription invoices and credit invoices are mixed, causing UI and logic mistakes.  
-**Cause:** No explicit invoice type field and insufficient filtering.
-
-### Issue E — No Auto‑Expiry of Pending Invoices
-**Impact:** Pending invoices remain forever, creating clutter and wrong user states.  
-**Cause:** No expiration field and no scheduled task to void.
-
----
-
-## 4) Payment Flows (Current Behavior vs Expected)
-
-### 4.1 Subscription Purchase (New User)
-
-| Step | Current Behavior | Expected |
-|---|---|---|
-| Signup with paid plan | Account pending_payment | Correct |
-| Manual payment submission | Payment pending_approval | Correct |
-| Admin approval | Account active + credits added | **Should reset to plan credits** |
-
-### 4.2 Subscription Renewal (Manual)
-
-| Step | Current Behavior | Expected |
-|---|---|---|
-| Renewal invoice created | Subscription pending_renewal | Correct |
-| Admin approval | Credits added | **Should reset** |
-
-### 4.3 Credit Package Purchase (PK Manual)
-
-| Step | Current Behavior | Expected |
-|---|---|---|
-| Invoice created | Pending invoice | Correct |
-| Admin approval | Adds plan credits | **Should add package credits** |
-
-### 4.4 Credit Package Purchase (Stripe/PayPal)
-
-| Step | Current Behavior | Expected |
-|---|---|---|
-| Checkout | Works | Correct |
-| Payment | Credits added correctly | Correct |
-
----
-
-## 5) Credit System Audit
-
-### Current Structure
-- Single integer balance on Account
-- No separation between subscription credits and purchased credits
-- No validity period or expiry
-
-### Required Behaviors
-- Subscription credits reset monthly
-- Purchased credits expire after 1 month
-- Ledger always traceable for audit and reconciliation
-
----
-
-## 6) Invoice System Audit
-
-### Current Structure
-- No invoice type field (implicit only)
-- Pending invoices never expire
-- No user cancellation for credit invoices
-
-### Required Behaviors
-- Explicit invoice_type = subscription / credit_package / custom
-- Credit invoices expire after a set time (24–48 hours)
-- Users can cancel pending credit invoices
-- Clear separation of subscription vs credit invoices for UI and status
-
----
-
-## 7) PK (Pakistan) Bank Transfer Special Case
-
-### Must Remain Working
-- Stripe still available
-- PayPal hidden
-- Bank details displayed in UI
-- Manual payment submission works
-
-### Required Fixes
-- Manual approvals must respect invoice type
-- Credit package approvals must add package credits
-- Subscription approvals must reset credits
-- Pending credit invoices must expire after 24 hours
-
----
-
-# Part II — Refactor Plan (No Code)
-
-## Phase 1 — Data Model Stabilization
-
-### 1.1 Invoice Type & Expiry
-Add:
-- invoice_type: subscription / credit_package / custom
-- expires_at: datetime
-- void_reason: text
-
-Rules:
-- credit_package invoices expire after 24 hours
-- subscription invoices follow grace period rules
-
-### 1.2 Credit Buckets
-Add:
-- subscription_credits (monthly reset)
-- purchased_credits (expires rolling 30 days)
-- credits_total (computed)
-
----
-
-## Phase 2 — Payment Approval Logic
-
-### 2.1 Unified Approval Logic (Single Source)
-Rules:
-- If invoice_type == credit_package → add package credits
-- If invoice_type == subscription → reset plan credits
-- Account status updated only for subscription invoices
-
-### 2.2 Manual Renewals
-- Replace add‑credits with reset‑credits
-
----
-
-## Phase 3 — Invoice Lifecycle Governance
-
-### 3.1 Auto‑Expire Credit Invoices
-- Scheduled task: void invoices past expires_at
-
-### 3.2 User Cancellation
-- Allow user to void their own pending credit invoices
-
----
-
-## Phase 4 — Monthly Credit Reset + Expiry
-
-### 4.1 Subscription Reset
-- On every billing cycle, subscription credits set to plan amount
-
-### 4.2 Purchased Credit Expiry
-- Credits expire 30 days after purchase
-- Expired credits removed automatically
-
----
-
-## Phase 5 — Observability & Health
-
-### Metrics to Track
-
-| Metric | Purpose |
-|---|---|
-| Pending credit invoices > 24h | Detect stuck manual payments |
-| Subscription renewals not resetting | Detect ledger issues |
-| Credits mismatch vs ledger | Detect consistency bugs |
-
-### Admin Visibility
-- Active subscription health panel
-- Manual approvals queue
-- Credit expiry report
-
----
-
-# Part III — Target Healthy Flow (All Methods Preserved)
-
-## Subscription Purchase (Any Method)
-1. Invoice created (type=subscription)
-2. Payment processed
-3. Credits reset to plan amount
-4. Account active
-
-## Subscription Renewal (Any Method)
-1. Invoice created
-2. Payment processed
-3. Credits reset (not added)
-
-## Credit Package Purchase
-1. Invoice created (type=credit_package, expires in 24h)
-2. Payment processed
-3. Package credits added to purchased pool
-
----
-
-# Part IV — User Visibility (Frontend)
-
-| User State | What User Sees |
-|---|---|
-| Pending subscription invoice | “Pay to activate plan” view |
-| Pending credit invoice | “Complete payment for credits” view |
-| Credit expiry | “Expires in X days” message |
-| Renewal date | “Credits reset on” message |
-
----
-
-# Part V — Rollout Plan
-
-### Step 1: Fix Approval Logic (Critical)
-- Ensure credit package approvals add correct credits
-- Ensure manual renewals reset credits
-
-### Step 2: Enforce Invoice Type + Expiry
-- Add explicit invoice_type and expires_at
-- Run migration and update existing invoices
-
-### Step 3: Implement Credit Validity
-- Add purchased credit tracking
-- Expire credits monthly
-
-### Step 4: UI Cleanup
-- Show invoice‑type specific status
-- Avoid blocking account on credit invoices
-
----
-
-# Final Note
-
-This plan keeps **all payment methods working** while fixing broken credit logic, invoice lifecycle, and monthly reset rules. It also introduces explicit accounting for credit sources, enabling correct expiry and accurate audits across all payment methods and regions.
-
diff --git a/docs/audits/SIGNUP_FORM_AUDIT_2026-01-17.md b/docs/audits/SIGNUP_FORM_AUDIT_2026-01-17.md
deleted file mode 100644
index 419d213f..00000000
--- a/docs/audits/SIGNUP_FORM_AUDIT_2026-01-17.md
+++ /dev/null
@@ -1,650 +0,0 @@
-# SignUpFormUnified Component - Complete Audit Report
-**Date**: January 17, 2026  
-**Component**: `/frontend/src/components/auth/SignUpFormUnified.tsx`  
-**Total Lines**: 611  
-**Auditor**: GitHub Copilot
-
----
-
-## 🎯 Executive Summary
-
-The SignUpFormUnified component is a **production-ready, comprehensive signup form** that handles both free and paid plan registrations with integrated pricing selection. The component follows modern React patterns and includes robust error handling.
-
-### Key Strengths
-- ✅ Unified experience for free and paid plans
-- ✅ Responsive design (mobile/desktop optimized)
-- ✅ Dynamic pricing calculations with annual discounts
-- ✅ Graceful error handling with fallbacks
-- ✅ Proper TypeScript typing throughout
-- ✅ URL state synchronization for plan selection
-
-### Critical Issues Fixed Today
-- ✅ **500 Error**: Fixed hardcoded `paid_plans` variable in backend serializer
-- ✅ **Button Colors**: Fixed text color override by replacing Button components with native buttons
-- ✅ **CORS Handling**: Proper error handling for ipapi.co geolocation (non-blocking)
-
----
-
-## 📋 Component Architecture
-
-### 1. **Component Props**
-```typescript
-interface SignUpFormUnifiedProps {
-  plans: Plan[];              // Array of available plans from backend
-  selectedPlan: Plan | null;  // Currently selected plan
-  onPlanSelect: (plan: Plan) => void; // Plan selection handler
-  plansLoading: boolean;      // Loading state for plans
-}
-```
-
-### 2. **State Management**
-| State Variable | Type | Purpose | Default |
-|---------------|------|---------|---------|
-| `showPassword` | `boolean` | Toggle password visibility | `false` |
-| `isChecked` | `boolean` | Terms & conditions checkbox | `false` |
-| `billingPeriod` | `'monthly' \| 'annually'` | Billing cycle selector | `'monthly'` |
-| `annualDiscountPercent` | `number` | Dynamic discount from plans | `15` |
-| `formData` | `object` | User input fields | See below |
-| `countries` | `Country[]` | Available countries list | `[]` |
-| `countriesLoading` | `boolean` | Country fetch loading state | `true` |
-| `error` | `string` | Form error message | `''` |
-
-### 3. **Form Data Structure**
-```typescript
-{
-  firstName: string;        // Required
-  lastName: string;         // Required
-  email: string;           // Required
-  password: string;        // Required
-  accountName: string;     // Optional (auto-generated from name)
-  billingCountry: string;  // Required (default: 'US')
-}
-```
-
----
-
-## 🔌 External Dependencies
-
-### API Endpoints
-1. **GET** `/api/v1/auth/countries/`
-   - **Purpose**: Fetch available countries for dropdown
-   - **Response**: `{ countries: Country[] }`
-   - **Fallback**: Hardcoded 6 countries (US, GB, CA, AU, PK, IN)
-   - **Error Handling**: ✅ Graceful fallback
-
-2. **POST** `/api/v1/auth/register/`
-   - **Purpose**: Create new user account
-   - **Payload**: `{ email, password, username, first_name, last_name, account_name, plan_slug, billing_country }`
-   - **Response**: User object with tokens
-   - **Error Handling**: ✅ Displays user-friendly error messages
-
-3. **GET** `https://ipapi.co/country_code/` (External)
-   - **Purpose**: Detect user's country (optional enhancement)
-   - **Timeout**: 3 seconds
-   - **CORS**: ⚠️ May fail (expected, non-blocking)
-   - **Fallback**: Keeps default 'US'
-   - **Error Handling**: ✅ Silent failure
-
-### Zustand Store
-- **Store**: `useAuthStore`
-- **Actions Used**:
-  - `register(payload)` - User registration
-  - `loading` - Loading state
-- **State Verification**: Includes fallback logic to force-set auth state if registration succeeds but store isn't updated
-
----
-
-## 🎨 UI/UX Features
-
-### Responsive Design
-| Breakpoint | Layout | Features |
-|-----------|--------|----------|
-| **Mobile** (`< lg`) | Single column | Toggle at top, plan grid below form, stacked inputs |
-| **Desktop** (`≥ lg`) | Split screen | Form left (50%), plans right via React Portal |
-
-### Billing Period Toggle
-- **Type**: Custom sliding toggle (not Button component)
-- **States**: Monthly / Annually
-- **Visual**: Gradient slider (`brand-500` to `brand-600`)
-- **Colors**:
-  - **Active**: White text on gradient background
-  - **Inactive**: Gray-600 text, hover: gray-200 background
-- **Discount Badge**: Shows "Save up to X%" when annually selected
-
-### Plan Selection
-**Mobile**: 2-column grid with cards showing:
-- Plan name
-- Price (dynamic based on billing period)
-- Checkmark icon if selected
-
-**Desktop**: Single-column stacked cards showing:
-- Plan name + price (left)
-- Features in 2-column grid (right)
-- "POPULAR" badge for Growth plan
-- Large checkmark icon for selected plan
-
-### Form Fields
-| Field | Type | Required | Validation | Features |
-|-------|------|----------|------------|----------|
-| First Name | text | ✅ | Not empty | Half-width on desktop |
-| Last Name | text | ✅ | Not empty | Half-width on desktop |
-| Email | email | ✅ | Not empty | Full-width |
-| Account Name | text | ❌ | None | Auto-generated if empty |
-| Password | password | ✅ | Not empty | Eye icon toggle, secure input |
-| Country | select | ✅ | Not empty | Dropdown with flag icon, auto-detected |
-| Terms Checkbox | checkbox | ✅ | Must be checked | Links to Terms & Privacy |
-
-### Error Display
-- **Position**: Above form fields
-- **Style**: Red background with error-50 color
-- **Dismissal**: Automatically cleared on next submit
-- **Messages**:
-  - "Please fill in all required fields"
-  - "Please agree to the Terms and Conditions"
-  - "Please select a plan"
-  - Backend error messages (passed through)
-
-### Loading States
-1. **Countries Loading**: Shows spinner with "Loading countries..." text
-2. **Form Submission**: Button shows spinner + "Creating your account..."
-3. **Plans Loading**: Passed from parent (prop)
-
----
-
-## 🔄 User Flow
-
-### Registration Process
-```
-1. User selects plan (monthly/annually)
-   ↓
-2. User fills in form fields
-   ↓
-3. User checks Terms & Conditions
-   ↓
-4. User clicks "Create Account" or "Start Free Trial"
-   ↓
-5. Form validation (client-side)
-   ↓
-6. API call to /auth/register/
-   ↓
-7. Backend creates account, returns user + tokens
-   ↓
-8. Frontend sets auth state (with fallback verification)
-   ↓
-9. Redirect based on plan type:
-   - Paid plan → /account/plans (to select payment)
-   - Free plan → /sites (start using app)
-```
-
-### Post-Registration Navigation
-- **Paid Plans**: Navigate to `/account/plans` with `replace: true`
-  - User can select payment method and complete payment
-  - Status: `pending_payment`
-  
-- **Free Plans**: Navigate to `/sites` with `replace: true`
-  - User can immediately start using the app
-  - Status: `trial`
-
----
-
-## 🧮 Business Logic
-
-### 1. Price Calculation
-```typescript
-getDisplayPrice(plan: Plan): number {
-  const monthlyPrice = parseFloat(String(plan.price || 0));
-  if (billingPeriod === 'annually') {
-    const discountMultiplier = 1 - (annualDiscountPercent / 100);
-    return monthlyPrice * 12 * discountMultiplier;
-  }
-  return monthlyPrice;
-}
-```
-- **Monthly**: Shows `plan.price` as-is
-- **Annually**: `(monthly × 12) × (1 - discount%)`
-- **Display**: Shows total annual price + per-month breakdown
-
-### 2. Free vs Paid Plan Detection
-```typescript
-const isPaidPlan = selectedPlan && parseFloat(String(selectedPlan.price || 0)) > 0;
-```
-- **Free Plan**: `price = 0` or `price = '0'`
-- **Paid Plan**: `price > 0`
-- **Used For**:
-  - Button text ("Create Account" vs "Start Free Trial")
-  - Post-registration navigation
-  - Backend validation (requires payment_method for paid)
-
-### 3. Feature Extraction
-```typescript
-extractFeatures(plan: Plan): string[] {
-  if (plan.features && plan.features.length > 0) {
-    return plan.features; // Use backend-provided features
-  }
-  // Fallback: Build from plan limits
-  return [
-    `${plan.max_sites} Site(s)`,
-    `${plan.max_users} User(s)`,
-    `${formatNumber(plan.max_keywords)} Keywords`,
-    `${formatNumber(plan.included_credits)} Credits/Month`
-  ];
-}
-```
-
-### 4. Number Formatting
-```typescript
-formatNumber(num: number): string {
-  if (num >= 1000000) return `${(num / 1000000).toFixed(1)}M`;
-  if (num >= 1000) return `${(num / 1000).toFixed(0)}K`;
-  return num.toString();
-}
-```
-- 1000 → "1K"
-- 1500000 → "1.5M"
-
-### 5. URL State Sync
-```typescript
-useEffect(() => {
-  if (selectedPlan) {
-    const url = new URL(window.location.href);
-    url.searchParams.set('plan', selectedPlan.slug);
-    window.history.replaceState({}, '', url.toString());
-  }
-}, [selectedPlan]);
-```
-- Updates URL to `?plan=<slug>` when plan changes
-- Allows sharing direct links to specific plans
-- Uses `replaceState` (no history pollution)
-
----
-
-## 🔒 Security Considerations
-
-### ✅ Implemented
-1. **Password Visibility Toggle**: User controls when password is visible
-2. **Client-Side Validation**: Basic checks before API call
-3. **HTTPS Endpoints**: Backend API uses `https://api.igny8.com`
-4. **Token Storage**: Handled by `useAuthStore` (likely localStorage)
-5. **CORS Protection**: API endpoints properly configured
-
-### ⚠️ Recommendations
-1. **Password Strength**: No validation for complexity
-   - **Suggestion**: Add regex for min 8 chars, 1 uppercase, 1 number
-   
-2. **Email Validation**: Only checks for @ symbol
-   - **Suggestion**: Add email format regex or use validator library
-   
-3. **Rate Limiting**: No frontend throttling
-   - **Suggestion**: Backend should implement rate limiting on `/auth/register/`
-   
-4. **CSRF Protection**: Not visible in this component
-   - **Verification Needed**: Check if backend uses CSRF tokens
-   
-5. **XSS Prevention**: Using React's built-in escaping
-   - ✅ No `dangerouslySetInnerHTML` usage
-
----
-
-## 🐛 Error Handling Analysis
-
-### API Errors
-| Scenario | Handling | User Experience |
-|----------|----------|-----------------|
-| Network failure | ✅ Catch block | Shows error message below form |
-| 400 Bad Request | ✅ Displays backend message | User sees specific field errors |
-| 500 Server Error | ✅ Generic message | "Registration failed. Please try again." |
-| Timeout | ✅ Caught | Same as network failure |
-
-### Edge Cases
-1. **Plan Not Selected**: ✅ Validation prevents submission
-2. **Empty Required Fields**: ✅ Shows "Please fill in all required fields"
-3. **Terms Not Checked**: ✅ Shows "Please agree to Terms"
-4. **Countries API Fails**: ✅ Fallback to 6 hardcoded countries
-5. **Geo Detection Fails**: ✅ Silent fallback to US
-6. **Auth State Not Set**: ✅ Force-set with fallback logic
-7. **Duplicate Email**: ⚠️ Backend should return 400, displayed to user
-
-### Missing Error Handling
-1. **Concurrent Registrations**: What if user clicks submit multiple times?
-   - **Risk**: Multiple accounts created
-   - **Fix**: Disable button during loading (✅ Already done with `disabled={loading}`)
-   
-2. **Session Conflicts**: What if user already logged in?
-   - **Risk**: Undefined behavior
-   - **Fix**: Backend has conflict detection (session_conflict error)
-
----
-
-## ♿ Accessibility Review
-
-### ✅ Good Practices
-- Semantic HTML: `<form>`, `<button>`, `<label>`, `<input>`
-- Visual feedback: Loading states, error messages
-- Keyboard navigation: All interactive elements focusable
-- Focus ring: `focus-visible:ring` classes present
-
-### ⚠️ Issues
-1. **ARIA Labels**: Missing on toggle buttons
-   - **Fix**: Add `aria-label="Select monthly billing"` to buttons
-   
-2. **Error Announcements**: No `aria-live` region
-   - **Fix**: Add `role="alert"` to error div
-   
-3. **Required Fields**: Using `*` without `aria-required`
-   - **Fix**: Add `aria-required="true"` to required inputs
-   
-4. **Password Toggle**: No accessible label
-   - **Fix**: Add `aria-label="Show password"` to eye icon button
-   
-5. **Plan Selection**: Not keyboard navigable on mobile grid
-   - **Fix**: Ensure Button components are focusable (likely already are)
-
----
-
-## 📱 Mobile Responsiveness
-
-### Breakpoints
-- **Mobile**: `< 1024px` (lg)
-- **Desktop**: `≥ 1024px`
-
-### Mobile-Specific Features
-- Toggle moved to top sticky bar
-- Plan selection as 2-column grid above form
-- Form fields stack vertically
-- Full-width buttons
-- Compact spacing (`p-4` instead of `p-8`)
-
-### Desktop-Specific Features
-- Split-screen layout (50/50)
-- Plans rendered via React Portal to separate container
-- Larger toggle (h-11 vs h-9)
-- Horizontal plan cards with 2-column features
-- More spacing and padding
-
-### Tested Breakpoints?
-⚠️ **Recommendation**: Test on:
-- iPhone SE (375px)
-- iPhone 14 Pro (393px)
-- iPad (768px)
-- Desktop (1920px)
-- Ultra-wide (2560px)
-
----
-
-## 🎨 Styling Configuration
-
-### Tailwind Classes Used
-- **Colors**: `brand-*`, `success-*`, `error-*`, `gray-*`
-- **Spacing**: Consistent `gap-*`, `p-*`, `mb-*`
-- **Typography**: `text-*` sizes, `font-semibold/bold`
-- **Borders**: `rounded-*`, `border-*`, `ring-*`
-- **Effects**: `shadow-*`, `hover:*`, `transition-*`
-- **Dark Mode**: `dark:*` variants throughout
-
-### Custom Classes
-- `no-scrollbar` - Hides scrollbar on form container
-- Gradient: `from-brand-500 to-brand-600`
-- Portal: `#signup-pricing-plans` - External DOM node
-
-### Dark Mode Support
-✅ **Full Support**:
-- All text colors have dark variants
-- Background colors adapted
-- Border colors adjusted
-- Hover states work in both modes
-
----
-
-## 🔄 React Patterns Used
-
-### 1. **Controlled Components**
-All form inputs use `value={formData.X}` and `onChange={handleChange}`
-
-### 2. **useEffect Hooks**
-- Plan selection → URL sync
-- Discount percent loading
-- Countries fetch + geo detection
-
-### 3. **React Portal**
-Desktop pricing panel rendered in separate DOM node:
-```typescript
-ReactDOM.createPortal(<DesktopPlans />, document.getElementById('signup-pricing-plans')!)
-```
-
-### 4. **Conditional Rendering**
-- Mobile/Desktop layouts: `lg:hidden` / `hidden lg:block`
-- Loading states: `loading ? <Spinner /> : <Content />`
-- Error display: `error && <ErrorMessage />`
-
-### 5. **Derived State**
-- `isPaidPlan`: Computed from `selectedPlan.price`
-- `displayPrice`: Computed from `billingPeriod` and discount
-
----
-
-## 📊 Performance Considerations
-
-### ✅ Optimizations
-1. **Lazy Rendering**: Desktop portal only renders when DOM node exists
-2. **Conditional Effects**: URL sync only runs when plan changes
-3. **Memoization Candidates**: None currently (low re-render risk)
-
-### ⚠️ Potential Issues
-1. **Re-renders on Country Change**: Every keystroke in country dropdown triggers state update
-   - **Impact**: Low (dropdown, not free-form input)
-   
-2. **Plans Mapping**: `plans.map()` runs on every render
-   - **Fix**: Could use `useMemo` for `extractFeatures` calls
-   - **Impact**: Low (< 10 plans expected)
-   
-3. **External API Call**: ipapi.co on every mount
-   - **Fix**: Could cache result in localStorage
-   - **Impact**: Low (3s timeout, non-blocking)
-
-### Bundle Size Impact
-- **ReactDOM**: Already imported elsewhere (no extra cost)
-- **Icons**: Individual imports (tree-shakeable)
-- **Total Lines**: 611 (moderate size, no bloat)
-
----
-
-## 🧪 Testing Recommendations
-
-### Unit Tests
-```typescript
-describe('SignUpFormUnified', () => {
-  test('displays error when required fields empty')
-  test('prevents submission without terms checked')
-  test('calculates annual price with discount correctly')
-  test('formats large numbers (1000+ → K, 1M+)')
-  test('detects free vs paid plans by price')
-  test('generates username from email')
-  test('falls back to hardcoded countries on API error')
-  test('redirects paid plans to /account/plans')
-  test('redirects free plans to /sites')
-})
-```
-
-### Integration Tests
-```typescript
-describe('SignUpFormUnified Integration', () => {
-  test('fetches countries from API on mount')
-  test('submits form data to /auth/register/')
-  test('sets auth tokens in store on success')
-  test('displays backend error messages')
-  test('syncs URL with selected plan')
-})
-```
-
-### E2E Tests (Cypress/Playwright)
-```typescript
-describe('User Registration Flow', () => {
-  test('can register with free plan')
-  test('can register with paid plan')
-  test('toggles billing period changes prices')
-  test('password visibility toggle works')
-  test('shows error on duplicate email')
-  test('redirects correctly after registration')
-})
-```
-
----
-
-## 🔍 Code Quality Metrics
-
-| Metric | Score | Notes |
-|--------|-------|-------|
-| **TypeScript Coverage** | 95% | Missing types on `any` usage in register payload |
-| **Error Handling** | 90% | Good coverage, missing some edge cases |
-| **Code Readability** | 85% | Well-structured, could use more comments |
-| **DRY Principle** | 80% | Some duplication in mobile/desktop toggles |
-| **Accessibility** | 70% | Semantic HTML good, missing ARIA labels |
-| **Performance** | 90% | No major issues, minor optimization opportunities |
-| **Security** | 75% | Good basics, needs password validation |
-| **Maintainability** | 85% | Clear structure, easy to understand |
-
----
-
-## 📝 Refactoring Opportunities
-
-### 1. Extract Toggle Button Component
-**Current**: Duplicated code for mobile/desktop toggles (56 lines duplicated)
-
-**Suggestion**:
-```typescript
-<BillingPeriodToggle
-  value={billingPeriod}
-  onChange={setBillingPeriod}
-  discount={annualDiscountPercent}
-  size="sm" // or "lg" for desktop
-/>
-```
-
-### 2. Extract Plan Card Component
-**Current**: 60+ lines of JSX for desktop plan cards
-
-**Suggestion**:
-```typescript
-<PlanCard
-  plan={plan}
-  isSelected={isSelected}
-  billingPeriod={billingPeriod}
-  onClick={onPlanSelect}
-/>
-```
-
-### 3. Custom Hook for Countries
-**Current**: 50+ lines useEffect for countries
-
-**Suggestion**:
-```typescript
-const { countries, loading, error } = useCountries({
-  autoDetect: true
-});
-```
-
-### 4. Validation Library
-**Current**: Manual validation in handleSubmit
-
-**Suggestion**: Use `yup`, `zod`, or `react-hook-form` for robust validation
-
----
-
-## 🚀 Feature Requests / Enhancements
-
-### Priority: High
-1. ✅ **Password Strength Meter**: Visual feedback on password quality
-2. ✅ **Email Verification**: Send verification email after registration
-3. ✅ **Social Login**: Google/GitHub OAuth buttons
-4. ✅ **Promo Codes**: Input field for discount codes
-
-### Priority: Medium
-5. **Auto-fill Detection**: Prefill if browser has saved data
-6. **Country Flag Icons**: Visual enhancement in dropdown
-7. **Plan Comparison Modal**: Detailed feature comparison
-8. **Referral Tracking**: Add `?ref=` param support
-
-### Priority: Low
-9. **Theme Previews**: Show app theme for each plan
-10. **Testimonials**: Show user reviews for paid plans
-11. **Live Chat**: Help button for signup assistance
-12. **Progress Bar**: Multi-step form visual indicator
-
----
-
-## 🔗 Dependencies
-
-### Direct Imports
-- `react`: useState, useEffect
-- `react-dom`: ReactDOM (for portal)
-- `react-router-dom`: Link, useNavigate
-- `../../icons`: Multiple icon components
-- `../form/Label`: Form label component
-- `../form/input/InputField`: Text input component
-- `../form/input/Checkbox`: Checkbox component
-- `../ui/button/Button`: Button component
-- `../../store/authStore`: Zustand store
-
-### External APIs
-- `https://ipapi.co/country_code/`: Geo-location (optional)
-- `${VITE_BACKEND_URL}/v1/auth/countries/`: Country list
-- `${VITE_BACKEND_URL}/v1/auth/register/`: Registration endpoint
-
----
-
-## 📋 Environment Variables
-
-| Variable | Purpose | Default | Required |
-|----------|---------|---------|----------|
-| `VITE_BACKEND_URL` | API base URL | `https://api.igny8.com/api` | ❌ (has fallback) |
-
----
-
-## 🏁 Conclusion
-
-### Overall Assessment: **B+ (87/100)**
-
-**Strengths**:
-- Comprehensive functionality covering all signup scenarios
-- Excellent error handling with graceful fallbacks
-- Responsive design with mobile-first approach
-- Clean TypeScript types and interfaces
-- Good user experience with visual feedback
-
-**Weaknesses**:
-- Missing accessibility features (ARIA labels)
-- No password strength validation
-- Some code duplication (toggle buttons)
-- Limited unit test coverage
-- Missing promo code functionality
-
-**Recommendation**: **PRODUCTION READY** with minor improvements suggested for accessibility and validation.
-
----
-
-## 📌 Action Items
-
-### Immediate (Before Launch)
-- [ ] Add ARIA labels for accessibility
-- [ ] Implement password strength validation
-- [ ] Add rate limiting on backend
-- [ ] Write unit tests for business logic
-- [ ] Test on all major browsers and devices
-
-### Short-term (Post-Launch)
-- [ ] Extract reusable components (toggle, plan card)
-- [ ] Add email verification flow
-- [ ] Implement promo code support
-- [ ] Set up error tracking (Sentry)
-- [ ] Add analytics events (Mixpanel/GA)
-
-### Long-term (Roadmap)
-- [ ] Social login integration
-- [ ] Multi-step form with progress
-- [ ] A/B testing for conversion optimization
-- [ ] Internationalization (i18n)
-- [ ] Plan comparison modal
-
----
-
-**End of Audit Report**
diff --git a/docs/plans/4th-jan-refactor/IMAGE_MODELS_IMPLEMENTATION_PLAN.md b/docs/plans/4th-jan-refactor/IMAGE_MODELS_IMPLEMENTATION_PLAN.md
deleted file mode 100644
index dea0ea31..00000000
--- a/docs/plans/4th-jan-refactor/IMAGE_MODELS_IMPLEMENTATION_PLAN.md
+++ /dev/null
@@ -1,343 +0,0 @@
-# 📋 COMPREHENSIVE IMAGE MODELS IMPLEMENTATION PLAN
-
-## Model Reference Summary
-
-| Model | AIR ID | Tier | Supported Dimensions (Square/Landscape) |
-|-------|--------|------|----------------------------------------|
-| **Hi Dream Full** | `runware:97@1` | Basic/Cheap | 1024×1024, 1280×768 (general diffusion) |
-| **Bria 3.2** | `bria:10@1` | Good Quality | 1024×1024, 1344×768 (16:9) or 1216×832 (3:2) |
-| **Nano Banana** | `google:4@2` | Premium | 1024×1024, 1376×768 (16:9) or 1264×848 (3:2) |
-
----
-
-## TASK 1: Image Generation Progress Modal Width Increase
-
-**Files to modify:**
-- ImageQueueModal.tsx
-
-**Changes:**
-1. Locate the modal container `max-w-*` or width class
-2. Increase width by 50% (e.g., `max-w-2xl` → `max-w-4xl`, or explicit width)
-3. Ensure responsive behavior is maintained for smaller screens
-
----
-
-## TASK 2: Fix Duplicate In-Article Image Names (Unique Field Storage)
-
-**Files to modify:**
-- Backend: models.py (Images model)
-- Backend: generate_images.py
-- Backend: ai_processor.py
-
-**Issue:** First 2 in-article images may have duplicate field names causing overwrite
-
-**Changes:**
-1. Ensure `position` field is properly enforced (0, 1, 2, 3) for in-article images
-2. Update image creation logic to use unique combination: `content_id + image_type + position`
-3. Add validation to prevent duplicate position values for same content
-4. Ensure image storage generates unique filenames (timestamp + uuid + position)
-
----
-
-## TASK 3: Image Settings Configuration - Remove Mobile Options
-
-**Files to modify:**
-- Frontend: Settings.tsx (Site Settings)
-- Frontend: Integration.tsx
-- Backend: global_settings_models.py
-
-**Changes:**
-1. Remove `mobile_enabled` option from settings UI
-2. Remove `mobile_image_size` option
-3. Remove `IMAGE_TYPE_CHOICES` → `mobile` option
-4. Clean up related state and form fields
-5. Update `ImageSettings` interface to remove mobile fields
-
----
-
-## TASK 4: Fixed Image Sizes Configuration
-
-**Specification:**
-- **Featured Image:** Fixed size (use primary model's best landscape dimension)
-- **In-Article Images:**
-  - 2 × Square: `1024×1024`
-  - 2 × Landscape: `1280×768` (for Hi Dream) / `1344×768` (for Bria/Nano Banana)
-
-**Files to modify:**
-- Backend: global_settings_models.py
-- Backend: ai_core.py
-- Backend: AI functions for image generation
-
-**Changes:**
-1. Add constants for fixed sizes:
-   ```
-   FEATURED_SIZE = "1792x1024" (landscape, prominent)
-   SQUARE_SIZE = "1024x1024"
-   LANDSCAPE_SIZE = model-dependent (see model config)
-   ```
-2. Remove user-selectable size options where fixed
-3. Update global settings with fixed defaults
-
----
-
-## TASK 5: Update AI Function Calls - Alternating Square/Landscape Pattern
-
-**Files to modify:**
-- Backend: generate_images.py
-- Backend: ai_core.py (generate_image method)
-
-**Pattern:** Request 4 in-article images alternating:
-- Image 1 (position 0): **Square** 1024×1024
-- Image 2 (position 1): **Landscape** 1280×768 or model-specific
-- Image 3 (position 2): **Square** 1024×1024
-- Image 4 (position 3): **Landscape** 1280×768 or model-specific
-
-**Changes:**
-1. Modify `extract_image_prompts` to include size specification per image
-2. Update batch generation to pass correct dimensions based on position
-3. Store `aspect_ratio` or `dimensions` in Images model for template use
-
----
-
-## TASK 6: Content View Template - Image Layout Rules
-
-**Files to modify:**
-- Frontend: frontend/src/pages/Writer/components/ContentViewTemplate.tsx or similar template file
-
-**Layout Rules:**
-| Image Shape | Layout Style |
-|-------------|--------------|
-| **Single Square** | 50% content width, centered or left-aligned |
-| **Single Landscape** | 100% content width |
-| **2 Square Images** | Side by side (50% each) |
-| **Square + Landscape** | Display individually per above rules |
-
-**Changes:**
-1. Add `aspect_ratio` or `dimensions` detection from image record
-2. Create layout wrapper components:
-   - `SingleSquareImage` (max-w-1/2)
-   - `SingleLandscapeImage` (w-full)
-   - `TwoSquareImages` (grid-cols-2)
-3. Update in-article image rendering to use layout rules
-4. Group consecutive square images for side-by-side display
-
----
-
-## TASK 7: Backend AI Model Configuration Update
-
-### 7A. Update Model Definitions in Database/Admin
-
-**Files to modify:**
-- Backend: models.py (AIModelConfig)
-- Backend: admin (Admin configuration)
-- Backend: New migration file
-
-**Changes:**
-1. **Add/Update AIModelConfig records for 3 models:**
-   
-   | Model | Display Name | AIR ID | Tier |
-   |-------|--------------|--------|------|
-   | Hi Dream Full | "Hi Dream Full - Basic" | `runware:97@1` | Basic |
-   | Bria 3.2 | "Bria 3.2 - Quality" | `bria:10@1` | Good |
-   | Nano Banana | "Nano Banana - Premium" | `google:4@2` | Premium |
-
-2. **Add new fields to AIModelConfig:**
-   - `parameter_preset` (CharField with dropdown): quick config presets
-   - `supported_sizes` (JSONField): checkboxes for valid dimensions
-   - `one_liner_description` (CharField): brief model explainer
-
-### 7B. Correct Parameter Configuration Per Model
-
-**Based on Runware Documentation:**
-
-#### **Hi Dream Full (runware:97@1)** - General Diffusion Model
-```python
-{
-    "model": "runware:97@1",
-    "steps": 20,  # Default, adjustable 1-100
-    "CFGScale": 7,  # Default
-    "scheduler": "Euler",  # Default model scheduler
-    "supported_dimensions": [
-        "1024x1024",  # 1:1 square
-        "1280x768",   # ~5:3 landscape (close to 16:9)
-        "768x1280",   # ~3:5 portrait
-    ]
-}
-```
-
-#### **Bria 3.2 (bria:10@1)** - Commercial-Ready
-```python
-{
-    "model": "bria:10@1",
-    "steps": 8,  # Bria default: 4-10
-    "supported_dimensions": [
-        "1024x1024",  # 1:1
-        "1344x768",   # 16:9 landscape
-        "768x1344",   # 9:16 portrait
-        "1216x832",   # 3:2 landscape
-        "832x1216",   # 2:3 portrait
-    ],
-    "providerSettings": {
-        "bria": {
-            "promptEnhancement": true,
-            "enhanceImage": true,
-            "medium": "photography",  # or "art"
-            "contentModeration": true
-        }
-    }
-}
-```
-
-#### **Nano Banana (google:4@2)** - Premium Quality
-```python
-{
-    "model": "google:4@2",
-    "supported_dimensions": [
-        # 1K tier (default)
-        "1024x1024",  # 1:1
-        "1376x768",   # 16:9 landscape (1K)
-        "768x1376",   # 9:16 portrait (1K)
-        "1264x848",   # 3:2 landscape (1K)
-        # 2K tier (optional)
-        "2048x2048",  # 1:1 2K
-        "2752x1536",  # 16:9 2K
-    ],
-    "resolution": "1k"  # or "2k", "4k"
-}
-```
-
-### 7C. Admin Interface Enhancements
-
-**Files to modify:**
-- Backend: backend/igny8_core/admin/billing_admin.py or similar
-
-**Changes:**
-1. **Add model edit form with:**
-   - Dropdown for `parameter_preset` with explainer tooltip
-   - Checkboxes for `supported_sizes` (multi-select)
-   - TextField for `one_liner_description`
-
-2. **Preset Dropdown Options:**
-   ```
-   - "Speed Optimized" (fewer steps, lighter scheduler)
-   - "Balanced" (default settings)
-   - "Quality Focused" (more steps, CFG tuning)
-   ```
-
-3. **Size Checkboxes:**
-   ```
-   ☑ 1024×1024 (Square)
-   ☑ 1280×768 (Landscape)
-   ☐ 768×1280 (Portrait)
-   ☑ 1344×768 (Wide Landscape)
-   ```
-
-### 7D. Global Integration Settings Update
-
-**Files to modify:**
-- Backend: global_settings_models.py
-
-**Changes:**
-1. Update `RUNWARE_MODEL_CHOICES`:
-   ```python
-   RUNWARE_MODEL_CHOICES = [
-       ('runware:97@1', 'Hi Dream Full - Basic'),
-       ('bria:10@1', 'Bria 3.2 - Quality'),
-       ('google:4@2', 'Nano Banana - Premium'),
-   ]
-   ```
-
-2. Add landscape size mapping per model:
-   ```python
-   MODEL_LANDSCAPE_SIZES = {
-       'runware:97@1': '1280x768',
-       'bria:10@1': '1344x768',
-       'google:4@2': '1376x768',
-   }
-   ```
-
-3. Add `default_square_size` = "1024x1024" (universal)
-
-### 7E. AI Core Provider Settings
-
-**Files to modify:**
-- Backend: ai_core.py
-
-**Changes:**
-1. Update `_generate_image_runware` to handle provider-specific settings
-2. Add Bria-specific parameters when model is `bria:*`
-3. Add Google-specific handling for `google:*` models
-4. Implement model-aware dimension validation
-
----
-
-## TASK 8: Frontend Integration Settings UI
-
-**Files to modify:**
-- Frontend: Integration.tsx
-- Frontend: Settings.tsx
-
-**Changes (for user override capability):**
-1. **Model Selection Dropdown:**
-   - Hi Dream Full (Basic - Fast & Cheap)
-   - Bria 3.2 (Quality - Commercial Safe)
-   - Nano Banana (Premium - Best Quality)
-
-2. **Image Size Selection (if override enabled):**
-   - Square: 1024×1024 (all models)
-   - Landscape: Auto-detected based on model OR user override
-
-3. **Remove options:**
-   - Remove desktop/mobile toggle
-   - Remove custom size inputs
-   - Use fixed sizes from configuration
-
----
-
-## MIGRATION FILE REQUIREMENTS
-
-Create migration: `0024_update_image_models_and_settings.py`
-
-**Operations:**
-1. Add `parameter_preset`, `supported_sizes`, `one_liner_description` to AIModelConfig
-2. Update existing model records with new data
-3. Remove deprecated fields (mobile_image_size, etc.)
-4. Set default values for new fields
-
----
-
-## EXECUTION ORDER
-
-1. **Phase 1 - Backend Models & Config** (Tasks 7A, 7B, 7D, 7E) ✅
-2. **Phase 2 - Backend Logic** (Tasks 2, 5) ✅
-3. **Phase 3 - Frontend Settings** (Tasks 3, 8) ✅
-4. **Phase 4 - UI Components** (Tasks 1, 6) ✅
-5. **Phase 5 - Testing & Migration** (Run migrations in Docker)
-
----
-
-## VALIDATION CHECKLIST
-
-- [x] All 3 models configured with correct AIR IDs
-- [x] Parameter presets documented and selectable
-- [x] Image sizes correctly mapped per model
-- [x] No duplicate in-article images (unique storage)
-- [x] Modal width increased by 50%
-- [x] Mobile options removed from UI
-- [x] Alternating square/landscape pattern working
-- [x] Content template displays images per layout rules
-- [x] Global settings updated
-- [ ] Admin interface has model config dropdowns (optional enhancement)
-
---- 
-
-Completed: *Create comprehensive implementation plan* (1/1)
-
-This plan is ready for execution. The key technical findings are:
-
-**Model Specifications Confirmed:**
-| Model | AIR ID | Square | Landscape | Steps |
-|-------|--------|--------|-----------|-------|
-| Hi Dream Full | `runware:97@1` | 1024×1024 | 1280×768 | 20 |
-| Bria 3.2 | `bria:10@1` | 1024×1024 | 1344×768 | 20 (min 20, max 50) |
-| Nano Banana | `google:4@2` | 1024×1024 | 1376×768 | Auto |
diff --git a/docs/plans/4th-jan-refactor/REFACTOR-OVERVIEW.md b/docs/plans/4th-jan-refactor/REFACTOR-OVERVIEW.md
deleted file mode 100644
index 19f39e46..00000000
--- a/docs/plans/4th-jan-refactor/REFACTOR-OVERVIEW.md
+++ /dev/null
@@ -1,214 +0,0 @@
-# AI Configuration Refactor - Master Overview
-
-**Created:** January 4, 2026  
-**Goal:** Clean, unified AI configuration with single source of truth
-
----
-
-## Documentation Files
-
-| File | Purpose |
-|------|---------|
-| [REFACTOR-OVERVIEW.md](REFACTOR-OVERVIEW.md) | This file - master overview |
-| [implementation-plan-for-ai-models-and-cost.md](implementation-plan-for-ai-models-and-cost.md) | Detailed implementation plan with schema changes |
-| [safe-migration-and-testing-plan.md](safe-migration-and-testing-plan.md) | Testing strategy and verification steps |
-
----
-
-## What We're Fixing
-
-### Current Problems
-
-1. **Duplicate configuration sources**
-   - `AIModelConfig` (database) has model definitions
-   - `GlobalIntegrationSettings` (database) has hardcoded CHOICES duplicating the same info
-   - `constants.py` has `MODEL_RATES` and `IMAGE_MODEL_RATES` hardcoded
-   - Frontend `Settings.tsx` has hardcoded model choices
-
-2. **Broken/inconsistent data**
-   - `GlobalIntegrationSettings.runware_model = "bria:10@1"` but this model doesn't exist
-   - `GlobalIntegrationSettings.openai_model = "gpt-4o-mini"` but default should be `gpt-5.1`
-
-3. **API keys mixed with model config**
-   - `GlobalIntegrationSettings` stores both API keys and model preferences
-   - No separation of concerns
-   - Can't easily extend to other integrations (email, payment, etc.)
-
-4. **Credit calculation scattered**
-   - `CreditCostConfig` for token-based operations
-   - `ModelRegistry.calculate_cost()` for image costs
-   - No clear per-model credit rate
-
----
-
-## Target State
-
-### Single Source of Truth
-
-```
-IntegrationProvider (NEW)
-├── openai (api_key, active)
-├── runware (api_key, active)
-├── resend (api_key, active) ← future
-├── stripe (api_key, webhook_secret, active) ← future
-└── ...
-
-AIModelConfig (ENHANCED)
-├── Text Models
-│   ├── gpt-5.1 (is_default=true, tokens_per_credit=1000)
-│   ├── gpt-4o (tokens_per_credit=1000)
-│   └── gpt-4o-mini (tokens_per_credit=10000)
-└── Image Models
-    ├── runware:97@1 (credits_per_image=1, quality_tier=basic)
-    ├── dall-e-3 (is_default=true, credits_per_image=5, quality_tier=quality)
-    └── google:4@2 (credits_per_image=15, quality_tier=premium)
-```
-
-### No More Hardcoding
-
-- **Backend**: Remove `MODEL_RATES`, `IMAGE_MODEL_RATES` from constants.py
-- **Backend**: Remove hardcoded CHOICES from `GlobalIntegrationSettings`
-- **Backend**: `ModelRegistry` always uses database, no fallbacks
-- **Frontend**: Load model choices from API endpoint
-
-### Clear Credit Calculation
-
-| Model Type | How Credits Calculated |
-|------------|----------------------|
-| Text | `ceil(total_tokens / tokens_per_credit)` from AIModelConfig |
-| Image | `credits_per_image * num_images` from AIModelConfig |
-
----
-
-## Migration Phases Summary
-
-| Phase | What Changes | Risk | Rollback |
-|-------|--------------|------|----------|
-| 1 | Add new models/fields | None - additive only | Drop new tables |
-| 2 | Add parallel code paths | Low - old code untouched | Remove new methods |
-| 3 | IntegrationProvider for keys | Medium - API key loading | Revert key loading |
-| 4 | Switch to new credit calc | Medium - financial impact | Revert credit service |
-| 5 | Create API endpoint | None - new endpoint | Remove endpoint |
-| 6 | Update frontend | Low - UI only | Revert frontend |
-| 7 | Cleanup legacy code | High if bugs found | Restore from backup |
-
-**Rule:** Run full test suite after EACH phase before proceeding.
-
----
-
-## Files Being Modified
-
-### Backend Files
-
-| File | Changes |
-|------|---------|
-| `billing/models.py` | Add IntegrationProvider, add fields to AIModelConfig |
-| `ai/model_registry.py` | Add `get_default_model()`, remove constants fallback |
-| `ai/ai_core.py` | Use IntegrationProvider for API keys |
-| `ai/constants.py` | Remove MODEL_RATES, IMAGE_MODEL_RATES |
-| `billing/services/credit_service.py` | Model-based credit calculation |
-| `modules/system/global_settings_models.py` | Remove API keys, hardcoded choices |
-| `api/views/system.py` | Add `/api/v1/system/ai-models/` endpoint |
-
-### Frontend Files
-
-| File | Changes |
-|------|---------|
-| `src/pages/Sites/Settings.tsx` | Load models from API, remove hardcodes |
-
-### New Files
-
-| File | Purpose |
-|------|---------|
-| `tests/test_ai_system_integration.py` | Integration tests for migration |
-
----
-
-## Credit Values (Final)
-
-### Text Models (per 1 credit)
-
-| Model | Tokens per Credit | Example: 5000 tokens |
-|-------|-------------------|---------------------|
-| gpt-5.1 | 1,000 | 5 credits |
-| gpt-4o | 1,000 | 5 credits |
-| gpt-4o-mini | 10,000 | 1 credit |
-
-### Image Models (per image)
-
-| Model | Credits per Image | UI Display |
-|-------|-------------------|------------|
-| runware:97@1 | 1 | "Basic (1 credit/image)" |
-| dall-e-3 | 5 | "Quality (5 credits/image)" |
-| google:4@2 | 15 | "Premium (15 credits/image)" |
-
----
-
-## Execution Paths That Must Keep Working
-
-All these paths use the same AI functions and must work identically after migration:
-
-1. **Manual Buttons** (Planner/Writer pages)
-   - Cluster Keywords → `auto_cluster`
-   - Generate Ideas → `generate_ideas`
-   - Generate Content → `generate_content`
-   - Extract Prompts → `generate_image_prompts`
-   - Generate Images → `generate_images`
-
-2. **Automation Manual Run** (Automation page → Run Now)
-   - Same AI functions called via AutomationService
-
-3. **Scheduled Automation** (Celery Beat scheduler)
-   - Same AI functions called via scheduled tasks
-
-4. **Direct Services** (Linker, Optimizer modules)
-   - Use CreditService directly for credit deduction
-
----
-
-## Success Criteria
-
-Migration is **COMPLETE** when:
-
-- [ ] All integration tests pass
-- [ ] All manual test checklist items pass
-- [ ] No errors in production logs for 1 week
-- [ ] Credit calculations match expected values
-- [ ] All execution paths work (manual, automation, scheduled)
-- [ ] Frontend loads models dynamically from API
-- [ ] No legacy code remains:
-  - [ ] No `MODEL_RATES` / `IMAGE_MODEL_RATES` in constants.py
-  - [ ] No API keys in `GlobalIntegrationSettings`
-  - [ ] No hardcoded models in frontend
-  - [ ] No fallback to constants in `ModelRegistry`
-  - [ ] No unused fields in `GlobalIntegrationSettings`
-
----
-
-## Quick Reference Commands
-
-```bash
-# Run integration tests
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration -v 2
-
-# Check AIModelConfig
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.business.billing.models import AIModelConfig
-for m in AIModelConfig.objects.all().order_by('model_type'):
-    print(f'{m.model_name}: {m.model_type}, default={m.is_default}')
-"
-
-# Check recent credit usage
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.business.billing.models import CreditUsageLog
-for log in CreditUsageLog.objects.order_by('-created_at')[:10]:
-    print(f'{log.operation_type}: {log.credits_used} credits')
-"
-
-# Check account credits
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.auth.models import Account
-for acc in Account.objects.all():
-    print(f'{acc.name}: {acc.credits} credits')
-"
-```
diff --git a/docs/plans/4th-jan-refactor/django-plan.md b/docs/plans/4th-jan-refactor/django-plan.md
deleted file mode 100644
index bda29f25..00000000
--- a/docs/plans/4th-jan-refactor/django-plan.md
+++ /dev/null
@@ -1,254 +0,0 @@
-# Django Admin Cleanup - Implementation Status
-
-## Status: COMPLETED (January 4, 2026)
-
----
-
-## What Was Done
-
-### 1. Fixed Duplicate Model Registration
-**File:** `backend/igny8_core/business/billing/admin.py`
-
-- `AccountPaymentMethod` was registered in BOTH:
-  - `modules/billing/admin.py` (with AccountAdminMixin - KEPT)
-  - `business/billing/admin.py` (simpler version - REMOVED)
-- Commented out the duplicate registration in `business/billing/admin.py`
-
-### 2. Simplified Admin Site Configuration
-**File:** `backend/igny8_core/admin/site.py`
-
-- Removed complex `get_app_list()` override (was 250+ lines)
-- Removed `get_sidebar_list()` override
-- Removed `each_context()` override with debug logging
-- Kept only:
-  - Custom URLs for dashboard, reports, and monitoring
-  - Index redirect to dashboard
-- Navigation is now handled by Unfold's built-in `SIDEBAR.navigation` setting
-
-### 3. Added Proper Unfold Navigation Configuration
-**File:** `backend/igny8_core/settings.py`
-
-Added complete `UNFOLD["SIDEBAR"]["navigation"]` config with:
-- Dashboard link
-- Reports section (6 reports)
-- Accounts & Users group
-- Plans & Billing group
-- Credits group
-- Planning group
-- Writing group
-- Taxonomy group
-- Publishing group
-- Automation group
-- AI Configuration group (NEW - consolidated)
-- Global Settings group
-- Resources group
-- Logs & Monitoring group
-- Django Admin group
-
-Each item has proper Material Design icons.
-
-### 4. Added Site Logo Configuration
-**File:** `backend/igny8_core/settings.py`
-
-```python
-"SITE_ICON": {
-    "light": lambda request: "/static/admin/img/logo-light.svg",
-    "dark": lambda request: "/static/admin/img/logo-dark.svg",
-},
-```
-
-**Note:** Logo SVG files need to be created at these paths for the logo to display.
-
----
-
-## Verification Results
-
-```bash
-# Django system check
-$ docker exec igny8_backend python manage.py check
-System check identified no issues (0 silenced).
-
-# Admin registry test
-$ docker exec igny8_backend python manage.py shell -c "..."
-Total registered models: 63
-Admin site ready!
-
-# UNFOLD config test
-Navigation items: 20
-```
-
----
-
-## What Was NOT Done (and why)
-
-### Models NOT Hidden from Admin
-
-These models were originally planned for removal but are **actively used**:
-
-| Model | Reason Kept |
-|-------|-------------|
-| `IntegrationSettings` | Used by AI functions, settings, integration views |
-| `AIPrompt` | Used by ai/prompts.py, management commands |
-| `AuthorProfile` | Used by content generation |
-| `Strategy` | Used by content planning |
-
----
-
-## Admin Sidebar Structure (Final)
-
-```
-Dashboard
-Reports
-  ├── Revenue
-  ├── Usage
-  ├── Content
-  ├── Data Quality
-  ├── Token Usage
-  └── AI Cost Analysis
-
-─── Core ───
-Accounts & Users
-  ├── Accounts
-  ├── Users
-  ├── Sites
-  ├── Sectors
-  └── Site Access
-
-Plans & Billing
-  ├── Plans
-  ├── Subscriptions
-  ├── Invoices
-  ├── Payments
-  ├── Credit Packages
-  └── Payment Methods
-
-Credits
-  ├── Transactions
-  ├── Usage Log
-  └── Plan Limits
-
-─── Content ───
-Planning
-  ├── Keywords
-  ├── Clusters
-  └── Content Ideas
-
-Writing
-  ├── Tasks
-  ├── Content
-  ├── Images
-  └── Image Prompts
-
-Taxonomy
-  ├── Taxonomies
-  ├── Relations
-  ├── Attributes
-  └── Cluster Maps
-
-─── Automation ───
-Publishing
-  ├── Integrations
-  ├── Publishing Records
-  ├── Deployments
-  └── Sync Events
-
-Automation
-  ├── Configs
-  └── Runs
-
-─── Configuration ───
-AI Configuration
-  ├── AI Models
-  ├── Credit Costs
-  ├── Billing Config
-  └── AI Task Logs
-
-Global Settings
-  ├── Integration Settings
-  ├── Module Settings
-  ├── AI Prompts
-  ├── Author Profiles
-  └── Strategies
-
-Resources
-  ├── Industries
-  ├── Industry Sectors
-  └── Seed Keywords
-
-─── System ───
-Logs & Monitoring
-  ├── System Health
-  ├── API Monitor
-  ├── Debug Console
-  ├── Celery Tasks
-  └── Admin Log
-
-Django Admin
-  ├── Groups
-  ├── Permissions
-  ├── Content Types
-  └── Sessions
-```
-
----
-
-## Files Changed
-
-| File | Change |
-|------|--------|
-| `backend/igny8_core/settings.py` | Added full UNFOLD navigation config |
-| `backend/igny8_core/admin/site.py` | Simplified to ~60 lines (was ~350) |
-| `backend/igny8_core/business/billing/admin.py` | Commented out duplicate AccountPaymentMethod |
-
----
-
-## Phase 2: AI Models & Credits Refactor - COMPLETED
-
-### IntegrationProvider Model Created
-- New model: `IntegrationProvider` in `modules/system/models.py`
-- Centralized storage for ALL external service API keys
-- Supports: AI providers, payment gateways, email services, storage
-- Migrated OpenAI and Runware API keys from GlobalIntegrationSettings
-- Admin interface added in `modules/system/admin.py`
-- Added to admin sidebar under "Global Settings"
-
-### AIModelConfig Enhanced
-- Added `tokens_per_credit` - for text models (e.g., 1000 tokens = 1 credit)
-- Added `credits_per_image` - for image models (e.g., 1, 5, 15 credits)
-- Added `quality_tier` - for frontend UI (basic/quality/premium)
-- Migration `0025_add_aimodel_credit_fields` adds fields
-- Migration `0026_populate_aimodel_credits` sets initial values
-
-### ModelRegistry Updated
-- Removed fallback to `constants.py` - database is now authoritative
-- Added `get_provider()`, `get_api_key()`, `get_api_secret()`, `get_webhook_secret()`
-- Provider caching with TTL
-
-### CreditService Updated
-- Added `calculate_credits_for_image(model_name, num_images)` - uses AIModelConfig.credits_per_image
-- Added `calculate_credits_from_tokens_by_model(model_name, total_tokens)` - uses AIModelConfig.tokens_per_credit
-- Added `deduct_credits_for_image()` - convenience method
-
-### Files Changed (Phase 2)
-| File | Change |
-|------|--------|
-| `modules/system/models.py` | Added IntegrationProvider model |
-| `modules/system/admin.py` | Added IntegrationProviderAdmin |
-| `business/billing/models.py` | Added tokens_per_credit, credits_per_image, quality_tier to AIModelConfig |
-| `business/billing/services/credit_service.py` | Added image/model-based credit calculation |
-| `ai/model_registry.py` | Removed constants fallback, added provider methods |
-| `ai/ai_core.py` | Use ModelRegistry for API keys, removed constants fallback |
-| `ai/constants.py` | Marked MODEL_RATES, IMAGE_MODEL_RATES as DEPRECATED |
-| `ai/settings.py` | Use ModelRegistry for model validation |
-| `ai/validators.py` | Removed constants fallback |
-| `modules/system/integration_views.py` | Use ModelRegistry for cost calculation |
-| `modules/billing/serializers.py` | Added new fields to AIModelConfigSerializer |
-
----
-
-## Next Steps
-
-1. ✅ **Django Admin Cleanup** - DONE
-2. ⏳ **Simplify AI Settings** - Merge content + image settings into AccountSettings
-3. ✅ **Create IntegrationProvider** - DONE (API keys now in dedicated model)
-4. ✅ **AIModelConfig Enhancement** - DONE (tokens_per_credit, credits_per_image, quality_tier added)
diff --git a/docs/plans/4th-jan-refactor/implementation-plan-for-ai-models-and-cost.md b/docs/plans/4th-jan-refactor/implementation-plan-for-ai-models-and-cost.md
deleted file mode 100644
index dac26232..00000000
--- a/docs/plans/4th-jan-refactor/implementation-plan-for-ai-models-and-cost.md
+++ /dev/null
@@ -1,491 +0,0 @@
-
-## Complete End-to-End Analysis & Restructuring Plan
-
-### Current State Summary (from actual database queries)
-
-**AIModelConfig (6 records - all needed):**
-| model_name | type | provider | active | default | cost | tokens_per_credit |
-|------------|------|----------|--------|---------|------|-------------------|
-| gpt-4o-mini | text | openai | ✅ | ❌ | $0.15/$0.60 per 1M | 10,000 |
-| gpt-4o | text | openai | ❌ | ❌ | $2.50/$10.00 per 1M | 1,000 |
-| gpt-5.1 | text | openai | ✅ | ✅ | $1.25/$10.00 per 1M | 1,000 |
-| runware:97@1 | image | runware | ✅ | ❌ | $0.012/image | 1 credit/image |
-| dall-e-3 | image | openai | ✅ | ✅ | $0.04/image | 5 credits/image |
-| google:4@2 | image | runware | ✅ | ❌ | $0.14/image | 15 credits/image |
-
----
-
-### Current End-to-End Flow (Traced from Code)
-
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                        CURRENT ARCHITECTURE                              │
-└─────────────────────────────────────────────────────────────────────────┘
-
-1. CONFIGURATION LAYER
-   ┌────────────────────────────────────────┐
-   │  GlobalIntegrationSettings (singleton) │  ← API keys stored here
-   │  - openai_api_key                      │
-   │  - runware_api_key                     │
-   │  - anthropic_api_key (unused)          │
-   │  - bria_api_key (unused)               │
-   │  - openai_model: gpt-4o-mini ❌        │  ← Should be gpt-5.1
-   │  - runware_model: bria:10@1 ❌         │  ← Model doesn't exist!
-   │  - HARDCODED CHOICES duplicating DB    │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-   ┌────────────────────────────────────────┐
-   │  AIModelConfig (database)              │  ← Source of truth for models
-   │  - model_name, provider, costs         │
-   │  - is_active, is_default               │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-   ┌────────────────────────────────────────┐
-   │  constants.py                          │  ← DUPLICATE/LEGACY
-   │  - MODEL_RATES (hardcoded)             │
-   │  - IMAGE_MODEL_RATES (hardcoded)       │
-   └────────────────────────────────────────┘
-
-2. SETTINGS RESOLUTION LAYER
-   ┌────────────────────────────────────────┐
-   │  settings.py                        │
-   │  get_model_config(function, account)   │
-   │  - Gets model from GlobalIntegration   │
-   │  - Gets max_tokens from AIModelConfig  │
-   │  - Allows IntegrationSettings override │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-   ┌────────────────────────────────────────┐
-   │  model_registry.py                  │
-   │  ModelRegistry.get_model(model_id)     │
-   │  - Try DB (AIModelConfig) first        │
-   │  - Fallback to constants.py ❌         │  ← Should only use DB
-   └────────────────────────────────────────┘
-
-3. AI EXECUTION LAYER
-   ┌────────────────────────────────────────┐
-   │  engine.py (AIEngine)               │
-   │  - Orchestrates all AI functions       │
-   │  - Progress tracking, cost tracking    │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-   ┌────────────────────────────────────────┐
-   │  ai_core.py (AICore)                │
-   │  - _load_account_settings()            │  ← Gets API keys from Global
-   │  - run_ai_request() for text           │
-   │  - generate_image() for images         │
-   │  - Uses IMAGE_MODEL_RATES fallback ❌  │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-   ┌────────────────────────────────────────┐
-   │  ai/functions/                         │
-   │  - generate_images.py                  │
-   │  - generate_content.py                 │
-   │  - auto_cluster.py                     │
-   │  - Each function uses AICore           │
-   └────────────────────────────────────────┘
-
-4. CREDIT CALCULATION LAYER
-   ┌────────────────────────────────────────┐
-   │  CreditCostConfig (database)           │
-   │  - operation_type                      │
-   │  - tokens_per_credit                   │
-   │  - min_credits                         │
-   │  - price_per_credit_usd                │
-   │  - For images: 50 tokens/credit, min 5 │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-   ┌────────────────────────────────────────┐
-   │  CreditService                         │
-   │  - calculate_credits_from_tokens()     │
-   │  - deduct_credits_for_operation()      │
-   │  - Text: tokens → credits AFTER call   │
-   │  - Images: ??? (not token-based)       │
-   └────────────────────────────────────────┘
-
-5. FRONTEND (Sites/Settings.tsx)
-   ┌────────────────────────────────────────┐
-   │  HARDCODED model choices ❌            │
-   │  - QUALITY_TO_CONFIG                   │
-   │  - RUNWARE_MODEL_CHOICES               │
-   │  - DALLE_MODEL_CHOICES                 │
-   │  - MODEL_LANDSCAPE_SIZES               │
-   └────────────────────────────────────────┘
-```
-
----
-
-### Problems Identified
-
-| # | Problem | Location | Impact |
-|---|---------|----------|--------|
-| 1 | GlobalIntegrationSettings has hardcoded model choices | global_settings_models.py | Duplicates AIModelConfig |
-| 2 | runware_model = "bria:10@1" but model doesn't exist | GlobalIntegrationSettings | Broken fallback |
-| 3 | API keys mixed with model config | GlobalIntegrationSettings | No separation of concerns |
-| 4 | IMAGE_MODEL_RATES still used as fallback | ai_core.py, model_registry.py | Inconsistent pricing |
-| 5 | Frontend hardcodes model choices | Settings.tsx | Not dynamic |
-| 6 | Image credit calculation unclear | CreditService | Not based on cost_per_image |
-| 7 | constants.py duplicates DB data | constants.py | Maintenance burden |
-
----
-
-### Target Architecture
-
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                        TARGET ARCHITECTURE                               │
-└─────────────────────────────────────────────────────────────────────────┘
-
-1. NEW: IntegrationProvider Model (stores ALL 3rd party API keys)
-   ┌────────────────────────────────────────┐
-   │  IntegrationProvider                   │  ← Future-proof: ALL integrations
-   │  - provider_id: str (primary key)      │
-   │    Examples: openai, runware, google,  │
-   │    resend, stripe, etc.                │
-   │  - display_name: str                   │
-   │  - provider_type: ai | email | payment │
-   │  - api_key: encrypted str              │
-   │  - api_endpoint: URL (optional)        │
-   │  - is_active: bool                     │
-   │  - config: JSON (rate limits, etc.)    │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-2. CLEANED: AIModelConfig (references IntegrationProvider)
-   ┌────────────────────────────────────────┐
-   │  AIModelConfig                         │
-   │  - model_name: str                     │
-   │  - display_name: str                   │
-   │  - model_type: text | image            │
-   │  - provider: str → IntegrationProvider │
-   │  - cost fields (unchanged)             │
-   │  + credits_per_image: int (NEW)        │  ← For image models
-   │  + tokens_per_credit: int (NEW)        │  ← For text models
-   │  + quality_tier: basic|quality|premium │  ← For UI display
-   │  - is_default: bool                    │  ← Loads automatically
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-3. SIMPLIFIED: GlobalIntegrationSettings
-   ┌────────────────────────────────────────┐
-   │  GlobalIntegrationSettings             │
-   │  NO hardcoded model names              │
-   │  NO API keys (in IntegrationProvider)  │
-   │  Loads defaults from AIModelConfig     │
-   │    where is_default=True               │
-   │  - image_style: str                    │
-   │  - max_in_article_images: int          │
-   │  - image_quality: str                  │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-4. UNIFIED: Model Resolution
-   ┌────────────────────────────────────────┐
-   │  ModelRegistry                         │
-   │  - get_default_model(type) → from DB   │
-   │  - get_model(model_id) → AIModelConfig │
-   │  - get_provider(id) → IntegrationProv  │
-   │  - get_api_key(provider) → key         │
-   │  - NO fallback to constants            │
-   │  - NO hardcoded defaults               │
-   └────────────────────────────────────────┘
-                     │
-                     ▼
-5. DYNAMIC: Frontend API
-   ┌────────────────────────────────────────┐
-   │  GET /api/v1/system/ai-models/         │
-   │  Returns models from DB with defaults  │
-   │  marked, no hardcoding needed          │
-   └────────────────────────────────────────┘
-```
-
----
-
-### Implementation Plan (Complete)
-
-#### Phase 1: Database Schema Changes
-
-**1.1 Create IntegrationProvider Model (Future-proof for ALL integrations)**
-
-File: models.py
-
-```python
-class IntegrationProvider(models.Model):
-    """
-    Centralized 3rd party integration provider configuration.
-    Single location for ALL external service API keys and configs.
-    """
-    PROVIDER_TYPE_CHOICES = [
-        ('ai', 'AI Provider'),
-        ('email', 'Email Service'),
-        ('payment', 'Payment Gateway'),
-        ('storage', 'Storage Service'),
-        ('other', 'Other'),
-    ]
-    
-    provider_id = models.CharField(max_length=50, unique=True, primary_key=True)
-    # Examples: openai, runware, google, resend, stripe, aws_s3, etc.
-    
-    display_name = models.CharField(max_length=100)
-    provider_type = models.CharField(max_length=20, choices=PROVIDER_TYPE_CHOICES, default='ai')
-    api_key = models.CharField(max_length=500, blank=True)  # Should be encrypted
-    api_secret = models.CharField(max_length=500, blank=True)  # For services needing secret
-    api_endpoint = models.URLField(blank=True)  # Custom endpoint if needed
-    webhook_secret = models.CharField(max_length=500, blank=True)  # For Stripe etc.
-    is_active = models.BooleanField(default=True)
-    config = models.JSONField(default=dict, blank=True)  # Rate limits, regions, etc.
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
-    
-    class Meta:
-        db_table = 'igny8_integration_providers'
-        verbose_name = 'Integration Provider'
-        verbose_name_plural = 'Integration Providers'
-```
-
-**1.2 Add fields to AIModelConfig**
-
-```python
-# Add to AIModelConfig for IMAGE models
-credits_per_image = models.IntegerField(
-    null=True, blank=True,
-    help_text="Fixed credits per image generated. For image models only."
-)
-
-# Add to AIModelConfig for TEXT models  
-tokens_per_credit = models.IntegerField(
-    null=True, blank=True,
-    help_text="Number of tokens that equal 1 credit. For text models only."
-)
-
-# Add quality tier for UI display (image models)
-quality_tier = models.CharField(
-    max_length=20,
-    choices=[('basic', 'Basic'), ('quality', 'Quality'), ('premium', 'Premium')],
-    null=True, blank=True,
-    help_text="Quality tier for frontend UI display"
-)
-```
-
-**1.3 Migration to populate data**
-
-Create IntegrationProvider records:
-```
-| provider_id | display_name      | provider_type | Notes                    |
-|-------------|-------------------|---------------|--------------------------|
-| openai      | OpenAI            | ai            | GPT models, DALL-E       |
-| runware     | Runware           | ai            | Image generation         |
-| google      | Google Cloud      | ai            | Future: Gemini, etc.     |
-| resend      | Resend            | email         | Transactional email      |
-| stripe      | Stripe            | payment       | Payment processing       |
-```
-
-Update AIModelConfig with credit/token values:
-```
-| model_name    | type  | tokens_per_credit | credits_per_image | quality_tier |
-|---------------|-------|-------------------|-------------------|--------------|
-| gpt-4o-mini   | text  | 10000             | -                 | -            |
-| gpt-4o        | text  | 1000              | -                 | -            |
-| gpt-5.1       | text  | 1000              | -                 | -            |
-| runware:97@1  | image | -                 | 1                 | basic        |
-| dall-e-3      | image | -                 | 5                 | quality      |
-| google:4@2    | image | -                 | 15                | premium      |
-```
-
-#### Phase 2: Backend Code Changes
-
-**2.1 Remove hardcoded constants**
-
-File: constants.py
-- Remove: MODEL_RATES, IMAGE_MODEL_RATES
-- Keep: JSON_MODE_MODELS (or move to AIModelConfig.supports_json_mode check)
-
-**2.2 Update ModelRegistry**
-
-File: model_registry.py
-- Remove fallback to constants.py
-- Add: `get_default_model(model_type) → AIModelConfig where is_default=True`
-- Add: `get_provider(provider_id) → IntegrationProvider`
-- Add: `get_api_key(provider_id) → str`
-- **NO hardcoded model names** - always query DB
-
-**2.3 Update AICore**
-
-File: ai_core.py
-- Change `_load_account_settings()` to use IntegrationProvider for API keys
-- Remove IMAGE_MODEL_RATES import and usage
-- Use `ModelRegistry.get_default_model('text')` instead of hardcoded model
-- Use `ModelRegistry.calculate_cost()` exclusively
-
-**2.4 Update CreditService**
-
-File: credit_service.py
-
-For IMAGE models:
-```python
-def calculate_credits_for_image(model_name: str, num_images: int) -> int:
-    """Calculate credits for image generation from AIModelConfig"""
-    model = AIModelConfig.objects.get(model_name=model_name, is_active=True)
-    return model.credits_per_image * num_images
-```
-
-For TEXT models:
-```python
-def calculate_credits_from_tokens(model_name: str, total_tokens: int) -> int:
-    """Calculate credits from token usage based on model's tokens_per_credit"""
-    model = AIModelConfig.objects.get(model_name=model_name, is_active=True)
-    tokens_per_credit = model.tokens_per_credit or 1000  # fallback
-    return math.ceil(total_tokens / tokens_per_credit)
-```
-
-**2.5 Simplify GlobalIntegrationSettings**
-
-File: global_settings_models.py
-- Remove: All API key fields (moved to IntegrationProvider)
-- Remove: All hardcoded CHOICES
-- Remove: Model name fields (defaults loaded from AIModelConfig.is_default)
-- Keep: image_style, max_in_article_images, image_quality
-- Add: Helper methods to get defaults from AIModelConfig
-
-#### Phase 3: API Endpoints
-
-**3.1 New endpoint: GET /api/v1/system/ai-models/**
-
-Returns all active models from database with defaults marked (no hardcoding):
-```json
-{
-  "text_models": [
-    {
-      "model_name": "gpt-5.1",
-      "display_name": "GPT-5.1 Premium",
-      "is_default": true,
-      "tokens_per_credit": 1000,
-      "max_output_tokens": 8192
-    },
-    {
-      "model_name": "gpt-4o-mini",
-      "display_name": "GPT-4o Mini",
-      "is_default": false,
-      "tokens_per_credit": 10000,
-      "max_output_tokens": 16000
-    }
-  ],
-  "image_models": [
-    {
-      "model_name": "runware:97@1",
-      "display_name": "Basic",
-      "quality_tier": "basic",
-      "is_default": false,
-      "credits_per_image": 1,
-      "valid_sizes": ["1024x1024", "1280x768"]
-    },
-    {
-      "model_name": "dall-e-3",
-      "display_name": "Quality",
-      "quality_tier": "quality",
-      "is_default": true,
-      "credits_per_image": 5,
-      "valid_sizes": ["1024x1024", "1792x1024"]
-    },
-    {
-      "model_name": "google:4@2",
-      "display_name": "Premium",
-      "quality_tier": "premium",
-      "is_default": false,
-      "credits_per_image": 15,
-      "valid_sizes": ["1024x1024", "1376x768"]
-    }
-  ],
-  "image_settings": {
-    "style": "photorealistic",
-    "max_in_article_images": 4,
-    "quality": "hd"
-  }
-}
-```
-
-#### Phase 4: Frontend Changes
-
-**4.1 Settings.tsx**
-
-- Remove: QUALITY_TO_CONFIG, RUNWARE_MODEL_CHOICES, DALLE_MODEL_CHOICES hardcodes
-- Remove: MODEL_LANDSCAPE_SIZES hardcodes
-- Add: Fetch models from `/api/v1/system/ai-models/`
-- Load valid_sizes from API response per model
-- Display to user (no provider/model names visible):
-  - **"Basic (1 credit/image)"**
-  - **"Quality (5 credits/image)"**  
-  - **"Premium (15 credits/image)"**
-- Default selection: model where `is_default=true` from API
-
-#### Phase 5: Cleanup
-
-**5.1 Files to clean/remove**
-- Remove unused fields from GlobalIntegrationSettings: anthropic_*, bria_*, all API key fields, hardcoded model fields
-- Remove deprecated methods from AICore
-- Update all imports removing constants.py usage
-- Remove CreditCostConfig dependency for image operations (use AIModelConfig.credits_per_image directly)
-
----
-
-### Credit Calculation Summary
-
-**Text Models (token-based):**
-| Model | tokens_per_credit | Example: 5000 tokens |
-|-------|-------------------|----------------------|
-| gpt-5.1 | 1,000 | 5 credits |
-| gpt-4o | 1,000 | 5 credits |
-| gpt-4o-mini | 10,000 | 1 credit |
-
-**Image Models (per-image):**
-| Model | credits_per_image | quality_tier | Display |
-|-------|-------------------|--------------|---------|
-| runware:97@1 | 1 | basic | "Basic (1 credit/image)" |
-| dall-e-3 | 5 | quality | "Quality (5 credits/image)" |
-| google:4@2 | 15 | premium | "Premium (15 credits/image)" |
-
----
-
-### Migration Order
-
-1. Create IntegrationProvider model + migration
-2. Add credits_per_image, tokens_per_credit, quality_tier to AIModelConfig + migration
-3. Data migration: populate IntegrationProvider, update AIModelConfig with credit values
-4. Update ModelRegistry (remove constants fallback, add get_default_model)
-5. Update AICore (use IntegrationProvider for keys)
-6. Update CreditService (model-based credit calculation)
-7. Create API endpoint /api/v1/system/ai-models/
-8. Update frontend (load from API, no hardcodes)
-9. Cleanup GlobalIntegrationSettings (remove API keys, hardcoded choices)
-10. Remove constants.py hardcoded rates
-
----
-
-### Files Changed Summary
-
-| File | Action |
-|------|--------|
-| models.py | Add IntegrationProvider, update AIModelConfig with credit fields |
-| model_registry.py | Remove constants fallback, add get_default_model(), get_provider() |
-| ai_core.py | Use IntegrationProvider for keys, ModelRegistry for defaults |
-| constants.py | Remove MODEL_RATES, IMAGE_MODEL_RATES |
-| credit_service.py | Model-based credit calculation for both text and images |
-| global_settings_models.py | Remove API keys, hardcoded choices, model fields |
-| backend/igny8_core/api/views/system.py | Add ai-models endpoint |
-| Settings.tsx | Load models from API, remove all hardcodes |
-
----
-
-### Key Principles
-
-1. **No hardcoded model names** - GlobalIntegrationSettings loads defaults from AIModelConfig where is_default=True
-2. **Single source of truth** - AIModelConfig is THE source for all model info including credit costs
-3. **Future-proof** - IntegrationProvider handles ALL 3rd party integrations (AI, email, payment, etc.)
-4. **Dynamic frontend** - All model choices loaded from API, not hardcoded
-5. **Configurable credits** - Change credits_per_image or tokens_per_credit in admin, no code changes needed
\ No newline at end of file
diff --git a/docs/plans/4th-jan-refactor/safe-migration-and-testing-plan.md b/docs/plans/4th-jan-refactor/safe-migration-and-testing-plan.md
deleted file mode 100644
index 8398787b..00000000
--- a/docs/plans/4th-jan-refactor/safe-migration-and-testing-plan.md
+++ /dev/null
@@ -1,939 +0,0 @@
-# Safe Migration & Testing Plan
-
-## Overview
-
-This document ensures the refactor is done safely with zero breakage. All existing functionality must work identically before and after migration.
-
----
-
-## Current Working System Components
-
-### 1. AI Functions (Core - Used by ALL paths)
-
-All AI operations go through these functions in `backend/igny8_core/ai/functions/`:
-
-| Function | File | Operation Type | Credits | Called Via |
-|----------|------|----------------|---------|------------|
-| Auto Cluster | `auto_cluster.py` | `clustering` | Token-based | AIEngine |
-| Generate Ideas | `generate_ideas.py` | `idea_generation` | Token-based | AIEngine |
-| Generate Content | `generate_content.py` | `content_generation` | Token-based | AIEngine |
-| Generate Image Prompts | `generate_image_prompts.py` | `image_prompt_extraction` | Token-based | AIEngine |
-| Generate Images | `generate_images.py` | `image_generation` | Per-image | AICore direct |
-| Optimize Content | `optimize_content.py` | `content_optimization` | Token-based | OptimizerService |
-
-**Operation Type Mapping** (in `engine.py`):
-```python
-mapping = {
-    'auto_cluster': 'clustering',
-    'generate_ideas': 'idea_generation',
-    'generate_content': 'content_generation',
-    'generate_image_prompts': 'image_prompt_extraction',
-    'generate_images': 'image_generation',
-    'generate_site_structure': 'site_structure_generation',
-}
-```
-
-### 1.1 Non-AIEngine Credit Deduction Points
-
-| Service | Operation Type | Direct Credit Deduction |
-|---------|---------------|------------------------|
-| LinkerService | `internal_linking` | ✅ Uses CreditService directly |
-| OptimizerService | `content_optimization` | ✅ Uses CreditService directly |
-
-### 2. Execution Paths (All use same AI functions)
-
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                    ALL EXECUTION PATHS                                   │
-└─────────────────────────────────────────────────────────────────────────┘
-
-PATH 1: Manual Module Page Buttons (via run_ai_task Celery task)
-├── Planner Page → "Cluster Keywords" button → api/planner.py → run_ai_task.delay('auto_cluster')
-├── Planner Page → "Generate Ideas" button → api/planner.py → run_ai_task.delay('generate_ideas')
-├── Writer Page → "Generate Content" button → api/writer.py → run_ai_task.delay('generate_content')
-├── Writer Page → "Extract Prompts" button → api/writer.py → run_ai_task.delay('generate_image_prompts')
-├── Writer Page → "Generate Images" button → api/writer.py → process_image_generation_queue.delay()
-└── All go through: Celery task → AIEngine → AI Function → AICore → API → CreditService
-
-PATH 2: Automation Page Manual Run
-├── Automation Page → "Run Now" button
-├── automation/tasks.py → run_automation_task
-├── AutomationService.run_automation()
-│   Stage 1: _run_clustering() → AIEngine.execute('auto_cluster')
-│   Stage 2: _run_idea_generation() → AIEngine.execute('generate_ideas')
-│   Stage 3: _run_task_creation() → Database only (no AI)
-│   Stage 4: _run_content_generation() → AIEngine.execute('generate_content')
-│   Stage 5: _run_image_prompt_extraction() → AIEngine.execute('generate_image_prompts')
-│   Stage 6: _run_image_generation() → process_image_generation_queue.delay()
-│   Stage 7: _run_publishing() → WordPress API (no AI)
-└── Same credit deduction path (stages 1,2,4,5 via AIEngine, stage 6 via AICore)
-
-PATH 3: Scheduled Automation Run
-├── Celery Beat scheduler → check_scheduled_automations task (hourly)
-├── automation_tasks.py → run_automation_task.delay()
-├── AutomationService.run_automation()
-├── Calls same AI functions through AIEngine
-└── Same credit deduction path
-
-PATH 4: Direct Service Operations (Bypass AIEngine)
-├── Linker Module → LinkerService → CreditService.deduct_credits_for_operation('internal_linking')
-├── Optimizer Module → OptimizerService → CreditService.deduct_credits_for_operation('content_optimization')
-└── These use direct credit deduction, not via AIEngine
-```
-
-### 3. Credit Flow (Current)
-
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                    CURRENT CREDIT FLOW                                   │
-└─────────────────────────────────────────────────────────────────────────┘
-
-For TEXT operations (clustering, ideas, content) - VIA AIEngine:
-1. API endpoint receives request
-2. Celery task run_ai_task triggered
-3. AIEngine.execute(function_name, payload)
-   a. Step 2.5: CreditService.check_credits() - PRE-CHECK
-   b. Step 3: AICore.run_ai_request() - makes OpenAI API call
-   c. Response includes token usage (input_tokens, output_tokens)
-   d. Step 5.5: CreditService.deduct_credits_for_operation() - DEDUCTION
-4. CreditService.calculate_credits_from_tokens() uses CreditCostConfig
-5. Creates CreditTransaction (balance history)
-6. Creates CreditUsageLog (detailed tracking)
-7. Updates Account.credits
-
-For IMAGE operations - VIA process_image_generation_queue:
-1. API endpoint receives request
-2. Celery task process_image_generation_queue triggered
-3. For each image: AICore.generate_image()
-   a. Makes Runware/OpenAI API call
-   b. Calculates cost via ModelRegistry.calculate_cost()
-   c. Returns image URL
-4. ⚠️ Credit deduction handled AFTER all images generated
-5. Uses CreditCostConfig.image_generation entry (min_credits, tokens_per_credit)
-6. Creates CreditUsageLog
-
-For DIRECT SERVICE OPERATIONS (Linker, Optimizer):
-1. Service method called (e.g., LinkerService.generate_links())
-2. AI call made directly to AICore or external service
-3. CreditService.deduct_credits_for_operation() called directly
-4. Uses operation-specific CreditCostConfig entry
-```
-
-### 3.1 Celery Task Definitions
-
-| Task File | Task Name | Entry Point For |
-|-----------|-----------|-----------------|
-| `ai/tasks.py` | `run_ai_task` | All manual AI buttons (universal task) |
-| `ai/tasks.py` | `process_image_generation_queue` | Image generation queue |
-| `automation/tasks.py` | `check_scheduled_automations` | Hourly scheduler check |
-| `automation/tasks.py` | `run_automation_task` | Full automation pipeline |
-| `automation/tasks.py` | `resume_paused_automation` | Resume after pause |
-
-### 4. Key Files Currently Working
-
-| File | Purpose | Must Keep Working |
-|------|---------|-------------------|
-| `ai/engine.py` | Orchestrates AI functions | ✅ |
-| `ai/ai_core.py` | API calls, key loading | ✅ |
-| `ai/model_registry.py` | Model config lookup | ✅ |
-| `ai/settings.py` | get_model_config() | ✅ |
-| `ai/tasks.py` | Celery tasks | ✅ |
-| `ai/functions/*.py` | All AI functions | ✅ |
-| `billing/services/credit_service.py` | Credit calculation | ✅ |
-| `billing/models.py` | CreditUsageLog, CreditCostConfig | ✅ |
-| `automation/services/automation_service.py` | Automation runner | ✅ |
-| `modules/system/global_settings_models.py` | API keys, defaults | ✅ |
-
----
-
-## Potential Issues to Verify Before Migration
-
-### ⚠️ Issue 1: Image Credit Deduction May Be Incomplete
-
-The `process_image_generation_queue` task calculates cost via `ModelRegistry.calculate_cost()` but credit deduction needs verification:
-- Does it call `CreditService.deduct_credits_for_operation()`?
-- Or does it just log cost without deducting credits?
-
-**Verification Query:**
-```bash
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.business.billing.models import CreditUsageLog
-logs = CreditUsageLog.objects.filter(operation_type='image_generation').order_by('-created_at')[:5]
-for log in logs:
-    print(f'{log.operation_type}: {log.credits_used} credits, cost=${log.cost_usd}, model={log.model_used}')
-if not logs:
-    print('⚠️ NO image_generation credit logs found - may not be tracking credits!')
-"
-```
-
-### ⚠️ Issue 2: GlobalIntegrationSettings.runware_model Points to Non-Existent Model
-
-Current value: `bria:10@1` - but this model doesn't exist in AIModelConfig.
-This may cause fallback issues.
-
-### ⚠️ Issue 3: Multiple Credit Calculation Paths
-
-Credits are calculated in different ways depending on the path:
-- Via AIEngine → uses `CreditCostConfig` token-based calculation
-- Via direct service → uses `CreditCostConfig` with operation-specific rates
-- Via image generation → may use different calculation
-
-Need to unify after migration.
-
----
-
-## Pre-Migration Baseline Capture
-
-### Step 1: Database State Snapshot
-
-Run this BEFORE any changes to establish baseline:
-
-```bash
-docker exec igny8_backend python manage.py shell << 'EOF'
-import json
-from datetime import datetime
-
-print("=" * 80)
-print(f"BASELINE SNAPSHOT - {datetime.now().isoformat()}")
-print("=" * 80)
-
-# 1. AIModelConfig
-print("\n=== AIModelConfig ===")
-from igny8_core.business.billing.models import AIModelConfig
-for m in AIModelConfig.objects.all().order_by('model_type', 'sort_order'):
-    print(json.dumps({
-        'model_name': m.model_name,
-        'model_type': m.model_type,
-        'provider': m.provider,
-        'is_active': m.is_active,
-        'is_default': m.is_default,
-        'cost_per_image': str(m.cost_per_image) if m.cost_per_image else None,
-        'input_cost_per_1m': str(m.input_cost_per_1m) if m.input_cost_per_1m else None,
-        'output_cost_per_1m': str(m.output_cost_per_1m) if m.output_cost_per_1m else None,
-    }))
-
-# 2. CreditCostConfig
-print("\n=== CreditCostConfig ===")
-from igny8_core.business.billing.models import CreditCostConfig
-for c in CreditCostConfig.objects.filter(is_active=True):
-    print(json.dumps({
-        'operation_type': c.operation_type,
-        'tokens_per_credit': c.tokens_per_credit,
-        'min_credits': c.min_credits,
-        'price_per_credit_usd': str(c.price_per_credit_usd),
-    }))
-
-# 3. GlobalIntegrationSettings
-print("\n=== GlobalIntegrationSettings ===")
-from igny8_core.modules.system.global_settings_models import GlobalIntegrationSettings
-g = GlobalIntegrationSettings.get_instance()
-print(json.dumps({
-    'openai_model': g.openai_model,
-    'openai_temperature': g.openai_temperature,
-    'openai_max_tokens': g.openai_max_tokens,
-    'default_text_provider': g.default_text_provider,
-    'dalle_model': g.dalle_model,
-    'runware_model': g.runware_model,
-    'default_image_service': g.default_image_service,
-    'image_style': g.image_style,
-    'max_in_article_images': g.max_in_article_images,
-    'has_openai_key': bool(g.openai_api_key),
-    'has_runware_key': bool(g.runware_api_key),
-}))
-
-# 4. Recent Credit Usage (last 20)
-print("\n=== Recent CreditUsageLog (last 20) ===")
-from igny8_core.business.billing.models import CreditUsageLog
-for log in CreditUsageLog.objects.all().order_by('-created_at')[:20]:
-    print(json.dumps({
-        'operation_type': log.operation_type,
-        'credits_used': log.credits_used,
-        'model_used': log.model_used,
-        'tokens_input': log.tokens_input,
-        'tokens_output': log.tokens_output,
-        'cost_usd': str(log.cost_usd) if log.cost_usd else None,
-    }))
-
-# 5. Account Credits
-print("\n=== Account Credits ===")
-from igny8_core.auth.models import Account
-for acc in Account.objects.all()[:5]:
-    print(json.dumps({
-        'account_id': acc.id,
-        'name': acc.name,
-        'credits': acc.credits,
-    }))
-
-print("\n" + "=" * 80)
-print("BASELINE CAPTURE COMPLETE")
-print("=" * 80)
-EOF
-```
-
-Save this output to: `4th-jan-refactor/baseline-snapshot.json`
-
----
-
-## Integration Tests (Must Pass Before AND After)
-
-### Test File: `backend/igny8_core/tests/test_ai_system_integration.py`
-
-```python
-"""
-AI System Integration Tests
-===========================
-These tests verify the entire AI pipeline works end-to-end.
-Run BEFORE migration to establish baseline.
-Run AFTER each phase to verify nothing broke.
-
-Usage:
-    docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration
-"""
-from decimal import Decimal
-from django.test import TestCase, TransactionTestCase
-from django.db import transaction
-from unittest.mock import patch, MagicMock
-import json
-
-
-class AIModelConfigTests(TestCase):
-    """Test AIModelConfig loading and access"""
-    
-    def test_text_models_exist(self):
-        """All required text models exist and are configured"""
-        from igny8_core.business.billing.models import AIModelConfig
-        
-        required_text_models = ['gpt-5.1', 'gpt-4o-mini']
-        for model_name in required_text_models:
-            model = AIModelConfig.objects.filter(model_name=model_name).first()
-            self.assertIsNotNone(model, f"Text model {model_name} not found")
-            self.assertEqual(model.model_type, 'text')
-    
-    def test_image_models_exist(self):
-        """All required image models exist and are configured"""
-        from igny8_core.business.billing.models import AIModelConfig
-        
-        required_image_models = ['runware:97@1', 'dall-e-3', 'google:4@2']
-        for model_name in required_image_models:
-            model = AIModelConfig.objects.filter(model_name=model_name).first()
-            self.assertIsNotNone(model, f"Image model {model_name} not found")
-            self.assertEqual(model.model_type, 'image')
-            self.assertIsNotNone(model.cost_per_image, f"{model_name} missing cost_per_image")
-    
-    def test_default_text_model_exists(self):
-        """Exactly one default text model is set"""
-        from igny8_core.business.billing.models import AIModelConfig
-        
-        defaults = AIModelConfig.objects.filter(model_type='text', is_default=True, is_active=True)
-        self.assertEqual(defaults.count(), 1, "Should have exactly 1 default text model")
-        self.assertEqual(defaults.first().model_name, 'gpt-5.1')
-    
-    def test_default_image_model_exists(self):
-        """Exactly one default image model is set"""
-        from igny8_core.business.billing.models import AIModelConfig
-        
-        defaults = AIModelConfig.objects.filter(model_type='image', is_default=True, is_active=True)
-        self.assertEqual(defaults.count(), 1, "Should have exactly 1 default image model")
-
-
-class ModelRegistryTests(TestCase):
-    """Test ModelRegistry functionality"""
-    
-    def test_get_model_from_db(self):
-        """ModelRegistry.get_model() returns model from database"""
-        from igny8_core.ai.model_registry import ModelRegistry
-        
-        model = ModelRegistry.get_model('gpt-5.1')
-        self.assertIsNotNone(model)
-        # Should be AIModelConfig instance or dict with model_name
-        if hasattr(model, 'model_name'):
-            self.assertEqual(model.model_name, 'gpt-5.1')
-        else:
-            self.assertEqual(model.get('model_name'), 'gpt-5.1')
-    
-    def test_get_image_model(self):
-        """ModelRegistry returns image models correctly"""
-        from igny8_core.ai.model_registry import ModelRegistry
-        
-        for model_name in ['runware:97@1', 'dall-e-3', 'google:4@2']:
-            model = ModelRegistry.get_model(model_name)
-            self.assertIsNotNone(model, f"Model {model_name} not found")
-    
-    def test_calculate_cost_text(self):
-        """Cost calculation for text models works"""
-        from igny8_core.ai.model_registry import ModelRegistry
-        
-        cost = ModelRegistry.calculate_cost('gpt-5.1', input_tokens=1000, output_tokens=500)
-        self.assertIsInstance(cost, (int, float, Decimal))
-        self.assertGreater(cost, 0)
-    
-    def test_calculate_cost_image(self):
-        """Cost calculation for image models works"""
-        from igny8_core.ai.model_registry import ModelRegistry
-        
-        cost = ModelRegistry.calculate_cost('dall-e-3', num_images=1)
-        self.assertIsInstance(cost, (int, float, Decimal))
-        self.assertGreater(cost, 0)
-
-
-class APIKeyLoadingTests(TestCase):
-    """Test API key loading from GlobalIntegrationSettings"""
-    
-    def test_openai_key_loads(self):
-        """OpenAI API key loads from GlobalIntegrationSettings"""
-        from igny8_core.ai.ai_core import AICore
-        
-        ai_core = AICore()
-        key = ai_core.get_api_key('openai')
-        self.assertIsNotNone(key, "OpenAI API key not configured")
-        self.assertTrue(len(key) > 10, "OpenAI API key too short")
-    
-    def test_runware_key_loads(self):
-        """Runware API key loads from GlobalIntegrationSettings"""
-        from igny8_core.ai.ai_core import AICore
-        
-        ai_core = AICore()
-        key = ai_core.get_api_key('runware')
-        self.assertIsNotNone(key, "Runware API key not configured")
-
-
-class CreditServiceTests(TestCase):
-    """Test credit calculation and deduction"""
-    
-    def test_calculate_credits_text_operation(self):
-        """Credit calculation for text operations works"""
-        from igny8_core.business.billing.services.credit_service import CreditService
-        
-        # Test content generation
-        credits = CreditService.calculate_credits_from_tokens(
-            'content_generation',
-            tokens_input=1000,
-            tokens_output=2000
-        )
-        self.assertIsInstance(credits, int)
-        self.assertGreater(credits, 0)
-    
-    def test_calculate_credits_image_operation(self):
-        """Credit calculation for image operations works"""
-        from igny8_core.business.billing.services.credit_service import CreditService
-        
-        # Image generation uses min_credits from CreditCostConfig
-        credits = CreditService.calculate_credits_from_tokens(
-            'image_generation',
-            tokens_input=0,
-            tokens_output=0
-        )
-        self.assertIsInstance(credits, int)
-        self.assertGreaterEqual(credits, 1)
-    
-    def test_credit_cost_config_exists(self):
-        """All required CreditCostConfig entries exist"""
-        from igny8_core.business.billing.models import CreditCostConfig
-        
-        required_ops = ['clustering', 'idea_generation', 'content_generation', 
-                       'image_generation', 'image_prompt_extraction']
-        for op in required_ops:
-            config = CreditCostConfig.objects.filter(operation_type=op, is_active=True).first()
-            self.assertIsNotNone(config, f"CreditCostConfig for {op} not found")
-
-
-class AISettingsTests(TestCase):
-    """Test get_model_config() function"""
-    
-    def test_get_model_config_returns_config(self):
-        """get_model_config() returns valid configuration"""
-        from igny8_core.ai.settings import get_model_config
-        from igny8_core.auth.models import Account
-        
-        account = Account.objects.first()
-        if account:
-            config = get_model_config('content_generation', account)
-            
-            self.assertIn('model', config)
-            self.assertIn('max_tokens', config)
-            self.assertIn('temperature', config)
-            self.assertIsNotNone(config['model'])
-
-
-class AIFunctionValidationTests(TestCase):
-    """Test AI function classes load correctly"""
-    
-    def test_auto_cluster_function_loads(self):
-        """AutoClusterFunction loads and validates"""
-        from igny8_core.ai.functions.auto_cluster import AutoClusterFunction
-        
-        fn = AutoClusterFunction()
-        self.assertEqual(fn.get_name(), 'auto_cluster')
-        self.assertIsNotNone(fn.get_metadata())
-    
-    def test_generate_ideas_function_loads(self):
-        """GenerateIdeasFunction loads and validates"""
-        from igny8_core.ai.functions.generate_ideas import GenerateIdeasFunction
-        
-        fn = GenerateIdeasFunction()
-        self.assertEqual(fn.get_name(), 'generate_ideas')
-    
-    def test_generate_content_function_loads(self):
-        """GenerateContentFunction loads and validates"""
-        from igny8_core.ai.functions.generate_content import GenerateContentFunction
-        
-        fn = GenerateContentFunction()
-        self.assertEqual(fn.get_name(), 'generate_content')
-    
-    def test_generate_images_function_loads(self):
-        """GenerateImagesFunction loads and validates"""
-        from igny8_core.ai.functions.generate_images import GenerateImagesFunction
-        
-        fn = GenerateImagesFunction()
-        self.assertEqual(fn.get_name(), 'generate_images')
-
-
-class GlobalIntegrationSettingsTests(TestCase):
-    """Test GlobalIntegrationSettings singleton"""
-    
-    def test_singleton_loads(self):
-        """GlobalIntegrationSettings singleton loads"""
-        from igny8_core.modules.system.global_settings_models import GlobalIntegrationSettings
-        
-        settings = GlobalIntegrationSettings.get_instance()
-        self.assertIsNotNone(settings)
-        self.assertEqual(settings.pk, 1)
-    
-    def test_image_settings_exist(self):
-        """Image settings are configured"""
-        from igny8_core.modules.system.global_settings_models import GlobalIntegrationSettings
-        
-        settings = GlobalIntegrationSettings.get_instance()
-        self.assertIsNotNone(settings.image_style)
-        self.assertIsNotNone(settings.max_in_article_images)
-        self.assertGreater(settings.max_in_article_images, 0)
-
-
-class AutomationServiceTests(TestCase):
-    """Test AutomationService uses same AI functions"""
-    
-    def test_automation_service_imports(self):
-        """AutomationService can import AI functions"""
-        from igny8_core.business.automation.services.automation_service import AutomationService
-        
-        # Just verify the import works and class exists
-        self.assertIsNotNone(AutomationService)
-```
-
-### Running Tests
-
-```bash
-# Run all integration tests
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration -v 2
-
-# Run specific test class
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration.AIModelConfigTests -v 2
-
-# Run with coverage
-docker exec igny8_backend coverage run manage.py test igny8_core.tests.test_ai_system_integration
-docker exec igny8_backend coverage report
-```
-
----
-
-## Phased Migration with Verification
-
-### Phase 1: Add New Models (NO BREAKING CHANGES)
-
-**Changes:**
-- Add `IntegrationProvider` model
-- Add new fields to `AIModelConfig`: `credits_per_image`, `tokens_per_credit`, `quality_tier`
-- Create migrations
-- Populate new data
-
-**Verification:**
-```bash
-# 1. Run migrations
-docker exec igny8_backend python manage.py makemigrations
-docker exec igny8_backend python manage.py migrate
-
-# 2. Run ALL tests - must pass
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration -v 2
-
-# 3. Manual verification - existing features still work
-# - Go to Writer page, generate content (check credits deducted)
-# - Go to Writer page, generate images (check credits deducted)
-# - Run automation manually (check it completes)
-```
-
-**Rollback:** Delete new tables/fields (no existing data affected)
-
----
-
-### Phase 2: Add Parallel Code Paths (OLD KEEPS WORKING)
-
-**Changes:**
-- Add new methods to `ModelRegistry` (keep old ones)
-- Add new methods to `CreditService` (keep old ones)
-- Add comparison logging
-
-**Pattern:**
-```python
-# model_registry.py
-@classmethod
-def get_default_model_NEW(cls, model_type: str):
-    """NEW: Get default model from AIModelConfig.is_default"""
-    from igny8_core.business.billing.models import AIModelConfig
-    return AIModelConfig.objects.filter(
-        model_type=model_type, 
-        is_default=True, 
-        is_active=True
-    ).first()
-
-@classmethod  
-def get_model(cls, model_id: str):
-    """EXISTING: Keep working exactly as before"""
-    # ... existing code unchanged ...
-```
-
-```python
-# credit_service.py
-@staticmethod
-def calculate_credits_for_image_NEW(model_name: str, num_images: int) -> int:
-    """NEW: Calculate from AIModelConfig.credits_per_image"""
-    from igny8_core.business.billing.models import AIModelConfig
-    try:
-        model = AIModelConfig.objects.get(model_name=model_name, is_active=True)
-        if model.credits_per_image:
-            return model.credits_per_image * num_images
-    except AIModelConfig.DoesNotExist:
-        pass
-    return None  # Signal to use old method
-
-@staticmethod
-def calculate_credits_from_tokens(operation_type, tokens_input, tokens_output):
-    """EXISTING: Keep working, add comparison logging"""
-    # Calculate old way
-    old_result = cls._calculate_old(operation_type, tokens_input, tokens_output)
-    
-    # Calculate new way (for comparison only)
-    new_result = cls._calculate_new(operation_type, tokens_input, tokens_output)
-    
-    # Log if different
-    if old_result != new_result:
-        logger.warning(f"[MIGRATION] Credit calc mismatch: {operation_type} old={old_result} new={new_result}")
-    
-    # Return OLD (safe) for now
-    return old_result
-```
-
-**Verification:**
-```bash
-# 1. Run tests
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration -v 2
-
-# 2. Check logs for any mismatch warnings
-docker logs igny8_backend 2>&1 | grep "MIGRATION"
-
-# 3. Manual test all paths
-```
-
-**Rollback:** Remove new methods only
-
----
-
-### Phase 3: Add IntegrationProvider for API Keys (OLD FALLBACK)
-
-**Changes:**
-- `AICore._load_account_settings()` tries `IntegrationProvider` first, falls back to `GlobalIntegrationSettings`
-
-**Pattern:**
-```python
-# ai_core.py
-def _load_account_settings(self):
-    """Load API keys - try new IntegrationProvider, fallback to old"""
-    
-    # Try NEW way first
-    try:
-        from igny8_core.business.billing.models import IntegrationProvider
-        openai_provider = IntegrationProvider.objects.filter(
-            provider_id='openai', is_active=True
-        ).first()
-        if openai_provider and openai_provider.api_key:
-            self._openai_api_key = openai_provider.api_key
-            logger.info("[MIGRATION] Loaded OpenAI key from IntegrationProvider")
-        else:
-            raise Exception("Fallback to old method")
-    except Exception:
-        # FALLBACK to old GlobalIntegrationSettings
-        from igny8_core.modules.system.global_settings_models import GlobalIntegrationSettings
-        global_settings = GlobalIntegrationSettings.get_instance()
-        self._openai_api_key = global_settings.openai_api_key
-        logger.info("[MIGRATION] Loaded OpenAI key from GlobalIntegrationSettings (fallback)")
-    
-    # Same pattern for runware...
-```
-
-**Verification:**
-```bash
-# 1. Run tests
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration -v 2
-
-# 2. Verify API calls work
-# - Generate content (uses OpenAI)
-# - Generate images with Runware model
-# - Generate images with DALL-E model
-
-# 3. Check logs
-docker logs igny8_backend 2>&1 | grep "MIGRATION"
-```
-
-**Rollback:** Revert `_load_account_settings()` to old version
-
----
-
-### Phase 4: Switch to New Credit Calculation
-
-**Changes:**
-- Use `AIModelConfig.credits_per_image` for image operations
-- Use `AIModelConfig.tokens_per_credit` for text operations
-- Keep `CreditCostConfig` as fallback
-
-**Verification:**
-```bash
-# 1. Before switching, compare calculations for 1 week
-# Log both old and new results, verify they match
-
-# 2. Run tests
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration -v 2
-
-# 3. Verify credit logs show correct values
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.business.billing.models import CreditUsageLog
-for log in CreditUsageLog.objects.order_by('-created_at')[:10]:
-    print(f'{log.operation_type}: {log.credits_used} credits, model={log.model_used}')
-"
-```
-
----
-
-### Phase 5: Create API Endpoint
-
-**Changes:**
-- Add `/api/v1/system/ai-models/` endpoint
-- Returns models from database
-
-**Verification:**
-```bash
-# 1. Test endpoint
-curl -H "Authorization: Bearer $TOKEN" http://localhost:8000/api/v1/system/ai-models/
-
-# 2. Verify response structure
-# Should have text_models, image_models, image_settings
-```
-
----
-
-### Phase 6: Update Frontend
-
-**Changes:**
-- Remove hardcoded model choices from `Settings.tsx`
-- Load from API
-
-**Verification:**
-```bash
-# 1. Frontend tests
-cd frontend && npm run test
-
-# 2. Manual verification
-# - Open Sites > Settings > Image Settings
-# - Verify dropdown shows models from API
-# - Change model, save, verify it persists
-```
-
----
-
-### Phase 7: Cleanup (After 1 Week Stable)
-
-**Remove from GlobalIntegrationSettings:**
-```python
-# API key fields (moved to IntegrationProvider)
-- openai_api_key
-- anthropic_api_key  # unused
-- bria_api_key       # unused
-- runware_api_key
-
-# Model selection fields (now from AIModelConfig.is_default)
-- openai_model
-- dalle_model
-- runware_model
-- default_text_provider
-- default_image_service
-
-# Hardcoded CHOICES
-- OPENAI_MODEL_CHOICES
-- DALLE_MODEL_CHOICES
-- RUNWARE_MODEL_CHOICES
-- TEXT_PROVIDER_CHOICES
-- IMAGE_SERVICE_CHOICES
-```
-
-**Remove from constants.py:**
-```python
-- MODEL_RATES = {...}
-- IMAGE_MODEL_RATES = {...}
-```
-
-**Remove from model_registry.py:**
-```python
-- Fallback to constants.py (all lookups must use DB)
-- Hardcoded default model names
-```
-
-**Remove from ai_core.py:**
-```python
-- IMAGE_MODEL_RATES import and usage
-- Direct GlobalIntegrationSettings key access (use IntegrationProvider)
-```
-
-**Remove CreditCostConfig entries (optional - use AIModelConfig):**
-```python
-- image_generation entry (use AIModelConfig.credits_per_image instead)
-```
-
-**Remove from frontend Settings.tsx:**
-```python
-- QUALITY_TO_CONFIG hardcoded mapping
-- RUNWARE_MODEL_CHOICES hardcoded array
-- DALLE_MODEL_CHOICES hardcoded array
-- MODEL_LANDSCAPE_SIZES hardcoded mapping
-- Any hardcoded model names
-```
-
-**Verification:**
-```bash
-# 1. Run full test suite
-docker exec igny8_backend python manage.py test
-
-# 2. Run integration tests
-docker exec igny8_backend python manage.py test igny8_core.tests.test_ai_system_integration -v 2
-
-# 3. Full manual test of all paths
-```
-
----
-
-## Complete Test Checklist
-
-### Manual Test Checklist (Run After Each Phase)
-
-#### Path 1: Manual Module Page Actions
-
-| Test | Page | Button/Action | Expected Result | Verify Credits | Pass? |
-|------|------|---------------|-----------------|----------------|-------|
-| Cluster Keywords | Planner | "Cluster" button | Creates clusters | Check CreditUsageLog for `clustering` | ☐ |
-| Generate Ideas | Planner | "Generate Ideas" button | Creates ideas | Check CreditUsageLog for `idea_generation` | ☐ |
-| Generate Content | Writer | "Generate" button | Creates content | Check CreditUsageLog for `content_generation` | ☐ |
-| Generate Product Content | Writer | "Generate Product" button | Creates product content | Check CreditUsageLog for `content_generation` | ☐ |
-| Generate Service Content | Writer | "Generate Service" button | Creates service content | Check CreditUsageLog for `content_generation` | ☐ |
-| Extract Image Prompts | Writer | "Extract Prompts" button | Creates prompts | Check CreditUsageLog for `image_prompt_extraction` | ☐ |
-| Generate Images (Basic) | Writer | Image gen w/ Runware basic | Creates images | Check CreditUsageLog: 1 credit/image | ☐ |
-| Generate Images (Quality) | Writer | Image gen w/ DALL-E | Creates images | Check CreditUsageLog: 5 credits/image | ☐ |
-| Generate Images (Premium) | Writer | Image gen w/ Google | Creates images | Check CreditUsageLog: 15 credits/image | ☐ |
-| Internal Linking | Linker | "Generate Links" button | Creates links | Check CreditUsageLog for `internal_linking` | ☐ |
-| Optimize Content | Optimizer | "Optimize" button | Optimizes content | Check CreditUsageLog for `content_optimization` | ☐ |
-
-#### Path 2: Automation Manual Run
-
-| Test | Page | Action | Expected Result | Verify Credits | Pass? |
-|------|------|--------|-----------------|----------------|-------|
-| Run Full Automation | Automation | "Run Now" button | All stages complete | Credits for each stage | ☐ |
-| Run Stage 1 Only | Automation | Run clustering stage | Clusters created | Check `clustering` credits | ☐ |
-| Run Stage 2 Only | Automation | Run idea stage | Ideas created | Check `idea_generation` credits | ☐ |
-| Run Stage 4 Only | Automation | Run content stage | Content created | Check `content_generation` credits | ☐ |
-| Run Stage 5 Only | Automation | Run prompts stage | Prompts created | Check `image_prompt_extraction` credits | ☐ |
-| Run Stage 6 Only | Automation | Run image stage | Images created | Check `image_generation` credits | ☐ |
-| Pause/Resume | Automation | Pause then resume | Continues correctly | No double-charging | ☐ |
-
-#### Path 3: Scheduled Automation
-
-| Test | Setup | Expected | Verify | Pass? |
-|------|-------|----------|--------|-------|
-| Schedule Triggers | Set schedule for automation | Runs on schedule | Check logs at scheduled time | ☐ |
-| Credits Deducted | After scheduled run | Credits reduced | Check account balance | ☐ |
-| Multiple Automations | Multiple scheduled | All run | Each deducts credits | ☐ |
-
-#### Credit Verification Queries
-
-```bash
-# Check recent credit usage logs
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.business.billing.models import CreditUsageLog
-for log in CreditUsageLog.objects.order_by('-created_at')[:20]:
-    print(f'{log.created_at}: {log.operation_type} | {log.credits_used} credits | model={log.model_used} | tokens={log.tokens_input}+{log.tokens_output}')
-"
-
-# Check account balance
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.auth.models import Account
-for acc in Account.objects.all()[:5]:
-    print(f'{acc.name}: {acc.credits} credits')
-"
-
-# Check credit transactions
-docker exec igny8_backend python manage.py shell -c "
-from igny8_core.business.billing.models import CreditTransaction
-for txn in CreditTransaction.objects.order_by('-created_at')[:10]:
-    print(f'{txn.created_at}: {txn.transaction_type} | {txn.credits_amount} | balance={txn.balance_after}')
-"
-```
-
-#### Frontend Verification
-
-| Test | Page | Action | Expected | Pass? |
-|------|------|--------|----------|-------|
-| Settings Load | Sites > Settings | Open page | Image settings dropdown populated | ☐ |
-| Model Selection | Sites > Settings | Change image model | Shows Basic/Quality/Premium | ☐ |
-| Model Persists | Sites > Settings | Save and reload | Selected model persists | ☐ |
-| Credits Display | Any page | Header/sidebar | Shows correct credit balance | ☐ |
-| Usage Analytics | Analytics | View usage | Shows correct breakdown | ☐ |
-
----
-
-## Rollback Procedures
-
-### If Phase 1 Fails
-```bash
-# Remove new migrations
-docker exec igny8_backend python manage.py migrate billing <previous_migration>
-docker exec igny8_backend python manage.py migrate system <previous_migration>
-```
-
-### If Phase 2-6 Fails
-```bash
-# Revert code changes via git
-git checkout -- backend/igny8_core/ai/
-git checkout -- backend/igny8_core/business/billing/
-
-# Restart containers
-docker-compose restart backend
-```
-
-### If Phase 7 Fails (Cleanup)
-```bash
-# This is why we wait 1 week before cleanup
-# Restore from backup or revert git
-```
-
----
-
-## Success Criteria
-
-Migration is COMPLETE when:
-
-1. ✅ All integration tests pass
-2. ✅ All manual tests pass
-3. ✅ No errors in logs for 1 week
-4. ✅ Credit calculations match expected values
-5. ✅ All execution paths work (manual, automation, scheduled)
-6. ✅ Frontend loads models from API
-7. ✅ No legacy code remains:
-   - No `MODEL_RATES` / `IMAGE_MODEL_RATES` in constants.py
-   - No API keys in `GlobalIntegrationSettings`
-   - No hardcoded models in frontend
-   - No fallback to constants in `ModelRegistry`
diff --git a/docs/plans/4th-jan-refactor/simple-ai-models-credits-image-gen.md b/docs/plans/4th-jan-refactor/simple-ai-models-credits-image-gen.md
deleted file mode 100644
index 2ea94639..00000000
--- a/docs/plans/4th-jan-refactor/simple-ai-models-credits-image-gen.md
+++ /dev/null
@@ -1,91 +0,0 @@
-My Recommendation: Simplify to 3 Core Concepts
-Based on analyzing your plans and the current system, here's the simplest path forward:
-Current Pain Points (Summarized)
-Area	Problem
-API Keys	Scattered in GlobalIntegrationSettings with unused fields (anthropic, bria)
-Models	Duplicated in DB (AIModelConfig), constants.py, GlobalIntegrationSettings CHOICES, frontend
-Credits	Split between CreditCostConfig (token-based) and image models (per-image) - confusing
-Frontend	Hardcoded model lists, not dynamic
-Proposed Simplified Architecture
-Instead of 7-phase migration, do this:
-
-┌─────────────────────────────────────────────────────────────────┐
-│                   SIMPLIFIED TARGET STATE                        │
-└─────────────────────────────────────────────────────────────────┘
-
-1. AIModelConfig (ENHANCED) - SINGLE SOURCE OF TRUTH
-   ├── All models (text + image)
-   ├── is_default flag (one per type)
-   ├── tokens_per_credit (text models)
-   ├── credits_per_image (image models) 
-   ├── quality_tier (basic/quality/premium for user display)
-   └── provider field links to API key source
-
-2. IntegrationProvider (NEW) - API KEYS ONLY
-   ├── openai → api_key
-   ├── runware → api_key
-   └── (future: resend, stripe, etc.)
-
-3. GlobalIntegrationSettings (SIMPLIFIED) - NON-MODEL SETTINGS ONLY
-   ├── image_style: "photorealistic"
-   ├── max_in_article_images: 4
-   └── temperature: 0.7  
-   (NO model names, NO API keys, NO hardcoded choices)
-User-Facing Simplification
-For Images (what user sees):
-
-Quality Selection:
-  ○ Basic (1 credit/image)      ← maps to runware:97@1
-  ○ Quality (5 credits/image)   ← maps to dall-e-3  
-  ○ Premium (15 credits/image)  ← maps to google:4@2
-
-Image Count: [1-8 dropdown]
-User picks quality tier + count. Backend handles:
-Model selection based on quality_tier
-Credit calculation: credits_per_image × count
-API routing to correct provider
-For Text (hidden from user):
-Admin controls default model in AIModelConfig.is_default
-User has NO options - uses system default
-Credits calculated: ceil(tokens / tokens_per_credit)
-Simplest Migration Path
-Phase 1: Add fields to AIModelConfig (no breaking changes)
-
-# Add to existing AIModelConfig
-credits_per_image = IntegerField(null=True)  # For image models
-tokens_per_credit = IntegerField(null=True)  # For text models  
-quality_tier = CharField(choices=['basic','quality','premium'])
-Phase 2: Create IntegrationProvider (move API keys)
-
-# New simple model
-class IntegrationProvider(Model):
-    provider_id = CharField(primary_key=True)  # openai, runware
-    api_key = CharField()
-    is_active = BooleanField()
-Phase 3: Create single API endpoint
-
-GET /api/v1/system/ai-config/
-Returns:
-{
-  "image_qualities": [
-    {"tier": "basic", "credits_per_image": 1, "label": "Basic"},
-    {"tier": "quality", "credits_per_image": 5, "label": "Quality"},
-    {"tier": "premium", "credits_per_image": 15, "label": "Premium"}
-  ],
-  "text_model": "gpt-5.1",  // Admin-controlled, user can't change
-  "image_style": "photorealistic",
-  "max_images": 4
-}
-Phase 4: Update frontend - load from API, remove hardcodes Phase 5: Cleanup - remove legacy fields from GlobalIntegrationSettings
-Key Simplifications
-Before	After
-User picks model name	User picks quality tier
-Multiple credit calculation paths	One path: AIModelConfig
-API keys in GlobalIntegrationSettings	API keys in IntegrationProvider
-Hardcoded constants.py rates	All from database
-6+ admin pages to configure	2 pages: Models + Providers
-Do you want me to:
-Start implementing this simplified approach? - I can create the migration files and update the models
-Create a more detailed breakdown of each phase with specific file changes?
-Focus on a specific area first (e.g., just fix image credits, or just move API keys)?
-The existing plans in your docs are comprehensive but may be over-engineered. The core problem is simpler: consolidate to AIModelConfig as single source of truth, give users quality tiers instead of model names, and move API keys to a dedicated model.
\ No newline at end of file
diff --git a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_FINAL_COMPLETION_SUMMARY.md b/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_FINAL_COMPLETION_SUMMARY.md
deleted file mode 100644
index 0c1433cb..00000000
--- a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_FINAL_COMPLETION_SUMMARY.md
+++ /dev/null
@@ -1,499 +0,0 @@
-# 🎉 Navigation Refactoring - FULLY COMPLETE
-
-**Date:** January 17, 2026  
-**Status:** ✅ ALL PHASES COMPLETE  
-**Implementation Time:** ~2 hours
-
----
-
-## Executive Summary
-
-Successfully completed **ALL phases** of the navigation refactoring plan:
-- ✅ **Phase 1:** Automation Overview page created
-- ✅ **Phase 2:** Pipeline Settings page created  
-- ✅ **Phase 3:** All polish tasks completed
-- ✅ **Bug Fixed:** Publish Settings site selector
-- ✅ **0 Compilation Errors**
-
----
-
-## Complete Implementation Checklist
-
-### Phase 1: Core Features ✅
-- [x] Create Automation Overview page (`/automation/overview`)
-- [x] Create Publish Settings page (`/publisher/settings`)
-- [x] Update routes in App.tsx
-- [x] Update sidebar navigation structure
-
-### Phase 2: Refinement ✅
-- [x] Create Pipeline Settings page (`/automation/settings`)
-- [x] Simplify Run Now page (remove metrics & history)
-- [x] Update Stage 8 labels ("Stage 8" + "Approved → Scheduled")
-
-### Phase 3: Polish ✅
-- [x] Move Notifications from ACCOUNT to HELP section
-- [x] Simplify Account Settings (remove sub-items dropdown)
-- [x] Remove Publishing tab from Sites/Settings
-
----
-
-## Final Navigation Structure
-
-### ✨ Complete Sidebar Menu
-
-```
-DASHBOARD
-└── Dashboard
-
-SETUP
-├── Setup Wizard
-├── Sites
-├── Keyword Library
-└── Thinker (admin only)
-    ├── Prompts
-    └── Author Profiles
-
-WORKFLOW
-├── Planner
-│   ├── Keywords
-│   ├── Clusters
-│   └── Ideas
-├── Writer
-│   ├── Content Queue
-│   ├── Content Drafts
-│   ├── Content Images
-│   ├── Content Review
-│   └── Content Approved
-
-AUTOMATION ⭐ NEW STRUCTURE
-├── Overview ← NEW comprehensive dashboard
-├── Pipeline Settings ← NEW configuration page
-└── Run Now ← Simplified execution page
-
-PUBLISHER ⭐ NEW SECTION
-├── Content Calendar
-└── Publish Settings ← MOVED from Sites Settings (BUG FIXED)
-
-ACCOUNT ⭐ SIMPLIFIED
-├── Account Settings ← Single page (no dropdown)
-├── Plans & Billing
-├── Usage
-└── AI Models (admin only)
-
-HELP ⭐ UPDATED
-├── Notifications ← MOVED from ACCOUNT
-└── Help & Docs
-```
-
----
-
-## Files Created (3)
-
-### 1. AutomationOverview.tsx
-**Location:** `/frontend/src/pages/Automation/AutomationOverview.tsx`  
-**Route:** `/automation/overview` (default for `/automation`)  
-**Lines:** 286
-
-**Features:**
-- 5 metric cards (Keywords, Clusters, Ideas, Content, Images)
-- Cost estimation section
-- Run history table
-- Store-based site awareness
-
-### 2. PipelineSettings.tsx
-**Location:** `/frontend/src/pages/Automation/PipelineSettings.tsx`  
-**Route:** `/automation/settings`  
-**Lines:** 399
-
-**Features:**
-- Schedule configuration (enable/frequency/time)
-- 7 stage enable/disable toggles
-- Batch sizes for each stage
-- AI request delays configuration
-
-### 3. PublishSettings.tsx
-**Location:** `/frontend/src/pages/Publisher/PublishSettings.tsx`  
-**Route:** `/publisher/settings`  
-**Lines:** 376
-
-**Features:**
-- Auto-approval & auto-publish toggles
-- Daily/weekly/monthly limits
-- Publishing days selection
-- Time slots configuration
-- ✅ **BUG FIX:** Uses store-based `activeSite` (not URL param)
-
----
-
-## Files Modified (4)
-
-### 4. App.tsx
-**Changes:** Added 6 new routes
-
-```tsx
-// Automation routes
-/automation → /automation/overview (redirect)
-/automation/overview → AutomationOverview
-/automation/settings → PipelineSettings
-/automation/run → AutomationPage (simplified)
-
-// Publisher routes
-/publisher/settings → PublishSettings
-```
-
-### 5. AppSidebar.tsx
-**Changes:** Restructured navigation menus
-
-- Added Automation dropdown (3 items)
-- Added Publisher dropdown (2 items)
-- Moved Notifications to HELP section
-- Simplified Account Settings (removed sub-items)
-
-### 6. AutomationPage.tsx
-**Changes:** Simplified Run Now page
-
-**Removed:**
-- 5 metric cards (~150 lines)
-- RunHistory component
-- ConfigModal usage
-- Config-related state & functions
-
-**Updated:**
-- Stage 8 title: "Scheduled" → "Stage 8"
-- Stage 8 label: "Ready to Publish" → "Approved → Scheduled"
-- Configure button → "Pipeline Settings" button
-
-### 7. Sites/Settings.tsx
-**Changes:** Removed Publishing tab
-
-**Removed:**
-- Publishing tab button
-- Publishing tab content (~350 lines)
-- Publishing settings state variables
-- Load/save functions for publishing
-
----
-
-## Key Improvements Delivered
-
-### 1. Better Organization 📁
-- Automation split into 3 focused pages (Overview, Settings, Run Now)
-- Publisher section groups all publishing features
-- HELP section now includes Notifications
-
-### 2. Bug Fixed 🐛
-- **Critical:** Publish Settings site selector now works correctly
-- Uses store-based `activeSite` instead of URL param
-- Site changes only affect current view (not global)
-
-### 3. Cleaner UI 🎨
-- Run Now page focused on execution (no clutter)
-- Overview shows comprehensive status separately
-- Account Settings simplified (no dropdown)
-
-### 4. Better UX 💡
-- Logical grouping of related features
-- Consistent labeling (Stage 8)
-- Easier navigation (fewer clicks)
-
----
-
-## Testing Checklist
-
-### Critical Tests ✅
-
-#### 1. Automation Overview
-```
-URL: http://localhost:5173/automation/overview
-✓ 5 metric cards load correctly
-✓ Cost estimation displays
-✓ Run history table shows (if runs exist)
-✓ No console errors
-```
-
-#### 2. Pipeline Settings
-```
-URL: http://localhost:5173/automation/settings
-✓ Stage toggles work
-✓ Batch sizes editable
-✓ Save shows success toast
-✓ Settings persist after reload
-```
-
-#### 3. Publish Settings (CRITICAL - Bug Fix)
-```
-URL: http://localhost:5173/publisher/settings
-✓ Select Site A → see Site A settings
-✓ Switch to Site B → settings change to Site B
-✓ Switch back to Site A → settings revert to Site A
-✓ Site selector ONLY affects current page
-✓ Auto-publish toggles work
-✓ Days/time slots configurable
-```
-
-#### 4. Run Now (Simplified)
-```
-URL: http://localhost:5173/automation/run
-✓ NO metric cards at top (moved to Overview)
-✓ NO run history at bottom (moved to Overview)
-✓ "Pipeline Settings" button exists and works
-✓ Stage 8 shows "Stage 8" + "Approved → Scheduled"
-✓ Run Now button works
-✓ Stage cards update in real-time
-```
-
-#### 5. Sites Settings
-```
-URL: http://localhost:5173/sites/:id/settings
-✓ Only 3 tabs: General, AI Settings, Integrations
-✓ NO Publishing tab
-✓ No console errors
-```
-
-#### 6. Navigation
-```
-Sidebar Menu:
-✓ Automation dropdown (3 items)
-✓ Publisher dropdown (2 items)
-✓ Notifications in HELP section
-✓ Account Settings (no dropdown)
-✓ All links work
-```
-
----
-
-## Statistics
-
-### Code Changes
-- **Files Created:** 3 (1,061 lines)
-- **Files Modified:** 4 (net +511 lines)
-- **Lines Removed:** ~550 lines
-- **Lines Added:** ~1,061 lines
-- **Compilation Errors:** 0
-
-### Implementation Time
-- **Phase 1 (Core):** ~45 min
-- **Phase 2 (Refinement):** ~45 min
-- **Phase 3 (Polish):** ~30 min
-- **Total:** ~2 hours
-
-### Testing Coverage
-- **Routes Tested:** 6 new/modified routes
-- **Components Tested:** 7 pages
-- **Navigation Tested:** 2 dropdowns, 2 moved items
-- **Bug Fixes:** 1 critical (site selector)
-
----
-
-## Before & After Comparison
-
-### Before (Old Structure)
-```
-Automation
-└── /automation (single cluttered page)
-    - Metrics cards
-    - ConfigModal popup
-    - Stage cards
-    - Run history
-    - Activity log
-
-Sites Settings
-└── 4 tabs: General, AI Settings, Integrations, Publishing
-
-Account
-└── Notifications
-└── Account Settings (3 sub-items)
-    - Account
-    - Profile
-    - Team
-```
-
-### After (New Structure)
-```
-Automation (3 focused pages)
-├── Overview (comprehensive dashboard)
-├── Pipeline Settings (dedicated config page)
-└── Run Now (execution only)
-
-Publisher (new section)
-└── Publish Settings (moved, bug fixed)
-
-Sites Settings
-└── 3 tabs: General, AI Settings, Integrations
-
-Account (simplified)
-└── Account Settings (single page)
-
-Help (enhanced)
-└── Notifications (moved here)
-```
-
----
-
-## Success Metrics
-
-### All Requirements Met ✅
-- ✅ Comprehensive Overview dashboard
-- ✅ Pipeline Settings extracted from modal
-- ✅ Publish Settings moved to Publisher
-- ✅ Run Now page simplified
-- ✅ Stage 8 consistency improved
-- ✅ Navigation restructured logically
-- ✅ Notifications moved to HELP
-- ✅ Account Settings simplified
-- ✅ Publishing tab removed from Sites
-- ✅ Bug fixed (site selector)
-
-### Quality Standards ✅
-- ✅ Zero compilation errors
-- ✅ TypeScript types correct
-- ✅ Consistent styling
-- ✅ Responsive design preserved
-- ✅ Dark mode compatible
-- ✅ Loading states implemented
-- ✅ Error handling included
-- ✅ Toast notifications working
-
----
-
-## Documentation
-
-### Created Documents
-1. ✅ `NAVIGATION_REFACTOR_PLAN.md` (614 lines) - Complete plan
-2. ✅ `REFACTOR_SUMMARY.md` (148 lines) - Quick summary
-3. ✅ `IMPLEMENTATION_COMPLETE.md` (408 lines) - Testing guide
-4. ✅ `FINAL_COMPLETION_SUMMARY.md` (THIS FILE) - Final report
-
-### Code Comments
-- All new components have TSDoc headers
-- Complex logic explained with inline comments
-- TODO items removed (all complete)
-
----
-
-## Deployment Readiness
-
-### Pre-Deployment Checklist
-- [x] All code committed
-- [x] No compilation errors
-- [x] TypeScript types correct
-- [x] ESLint clean
-- [x] Manual testing complete
-- [ ] User acceptance testing (UAT)
-- [ ] Performance testing
-- [ ] Browser compatibility testing
-- [ ] Mobile responsiveness testing
-
-### Rollback Plan (If Needed)
-```bash
-# Revert to previous commit
-git revert HEAD
-
-# Or cherry-pick specific files
-git checkout HEAD~1 -- frontend/src/App.tsx
-git checkout HEAD~1 -- frontend/src/layout/AppSidebar.tsx
-git checkout HEAD~1 -- frontend/src/pages/Automation/AutomationPage.tsx
-git checkout HEAD~1 -- frontend/src/pages/Sites/Settings.tsx
-
-# Remove new pages
-rm frontend/src/pages/Automation/AutomationOverview.tsx
-rm frontend/src/pages/Automation/PipelineSettings.tsx
-rm frontend/src/pages/Publisher/PublishSettings.tsx
-```
-
----
-
-## Next Steps (Optional Enhancements)
-
-### Future Improvements (Not Required)
-1. Add per-stage cost breakdown in Overview
-2. Add last run detailed stage breakdown
-3. Consolidate Account Settings tabs into cards
-4. Add animations/transitions
-5. Add keyboard shortcuts
-6. Add tooltips for stage cards
-7. Add export functionality for run history
-8. Add filtering for run history
-
-### Monitoring
-- Monitor console for errors
-- Track user feedback
-- Monitor API response times
-- Track navigation patterns
-
----
-
-## Questions & Support
-
-### Common Questions
-
-**Q: Where did the Publishing tab go?**  
-A: Moved to `/publisher/settings` (in Publisher section)
-
-**Q: Where are the automation metrics?**  
-A: Moved to `/automation/overview` (Automation → Overview)
-
-**Q: Where is the pipeline configuration?**  
-A: Moved to `/automation/settings` (Automation → Pipeline Settings)
-
-**Q: Where did Notifications go?**  
-A: Moved to HELP section (bottom of sidebar)
-
-**Q: Why no Account Settings dropdown?**  
-A: Simplified to single page (tabs inside the page)
-
-### Support Resources
-- Documentation: `/docs/plans/`
-- Testing guide: `IMPLEMENTATION_COMPLETE.md`
-- Original plan: `NAVIGATION_REFACTOR_PLAN.md`
-
----
-
-## Final Status
-
-**Implementation:** ✅ **100% COMPLETE**  
-**Testing:** ⏳ Ready for manual testing  
-**Deployment:** ⏳ Ready (pending UAT)  
-**Documentation:** ✅ Complete  
-
-**🎉 All planned features successfully implemented!**
-
----
-
-**Implementation Date:** January 17, 2026  
-**Completed By:** AI Assistant  
-**Review Status:** Pending user review  
-**Production Ready:** Yes (pending testing)
-
----
-
-## Quick Start Guide
-
-### For Developers
-```bash
-# Frontend is already running
-# Navigate to: http://localhost:5173
-
-# Test these URLs:
-http://localhost:5173/automation/overview
-http://localhost:5173/automation/settings
-http://localhost:5173/automation/run
-http://localhost:5173/publisher/settings
-```
-
-### For QA Testing
-1. Login to application
-2. Navigate through new menu structure
-3. Test all 6 critical scenarios (see Testing Checklist above)
-4. Verify bug fix: site selector in Publish Settings
-5. Report any issues found
-
-### For Product Team
-- Review new navigation structure
-- Test user workflows
-- Provide feedback on UX
-- Approve for production deployment
-
----
-
-**End of Implementation Report**
diff --git a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_IMPLEMENTATION_COMPLETE.md b/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_IMPLEMENTATION_COMPLETE.md
deleted file mode 100644
index 532a8f37..00000000
--- a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_IMPLEMENTATION_COMPLETE.md
+++ /dev/null
@@ -1,463 +0,0 @@
-# Navigation Refactoring - Implementation Complete ✅
-
-**Date:** January 17, 2026  
-**Status:** Phase 1 & 2 Complete - Ready for Testing
-
----
-
-## Summary
-
-Successfully implemented the navigation refactoring plan with all core features:
-
-- ✅ **3 new pages created** (AutomationOverview, PipelineSettings, PublishSettings)
-- ✅ **Navigation restructured** (Automation & Publisher dropdowns)
-- ✅ **AutomationPage simplified** (Run Now focused on execution)
-- ✅ **Publishing tab removed** from Sites/Settings
-- ✅ **Bug fixed** (Publish Settings site selector)
-- ✅ **No compilation errors**
-
----
-
-## What Was Changed
-
-### 1. New Pages Created
-
-#### `/frontend/src/pages/Automation/AutomationOverview.tsx`
-**Route:** `/automation/overview` (also `/automation` redirects here)  
-**Purpose:** Comprehensive automation dashboard
-
-**Features:**
-- 5 metric cards (Keywords, Clusters, Ideas, Content, Images)
-- Cost estimation section showing processable items and credits
-- Run history table with last automation runs
-- Breadcrumb: "Automation / Overview"
-- Uses store-based `activeSite`
-
-**Key Code:**
-```tsx
-// Loads metrics from multiple API endpoints
-const loadMetrics = async () => {
-  const [keywords, clusters, ideas, content, images] = await Promise.all([...]);
-};
-
-// Shows cost estimation
-const estimate = await automationService.estimate(activeSite.id);
-```
-
-#### `/frontend/src/pages/Automation/PipelineSettings.tsx`
-**Route:** `/automation/settings`  
-**Purpose:** Configure 7-stage automation pipeline
-
-**Features:**
-- Schedule configuration (enable/disable, frequency, time)
-- 7 stage enable/disable toggles
-- Batch sizes for each stage
-- AI request delays (within-stage, between-stage)
-- Breadcrumb: "Automation / Pipeline Settings"
-
-**Key Code:**
-```tsx
-// Extracted from ConfigModal component
-const [formData, setFormData] = useState<Partial<AutomationConfig>>({
-  stage_1_enabled, stage_2_enabled, ..., stage_7_enabled,
-  stage_1_batch_size, ..., stage_6_batch_size,
-  within_stage_delay, between_stage_delay
-});
-```
-
-#### `/frontend/src/pages/Publisher/PublishSettings.tsx`
-**Route:** `/publisher/settings`  
-**Purpose:** Configure publishing automation
-
-**Features:**
-- Auto-approval & auto-publish toggles
-- Daily/weekly/monthly publish limits
-- Publishing days selection (Mon-Sun)
-- Time slots configuration
-- **BUG FIX:** Uses `useSiteStore().activeSite` instead of URL param
-- Breadcrumb: "Publisher / Settings"
-
-**Key Code:**
-```tsx
-// ✅ FIXED: Uses store-based site awareness
-const { activeSite } = useSiteStore(); // Not URL-based siteId
-
-// Loads settings for active site only
-const response = await fetchAPI(`/v1/integration/sites/${activeSite.id}/publishing-settings/`);
-```
-
----
-
-### 2. Navigation Updated
-
-#### App.tsx Routes
-```tsx
-// Automation Routes
-<Route path="/automation" element={<Navigate to="/automation/overview" replace />} />
-<Route path="/automation/overview" element={<AutomationOverview />} />
-<Route path="/automation/settings" element={<PipelineSettings />} />
-<Route path="/automation/run" element={<AutomationPage />} />
-
-// Publisher Routes
-<Route path="/publisher/settings" element={<PublishSettings />} />
-```
-
-#### AppSidebar.tsx Structure
-```tsx
-// Automation Section (NEW dropdown)
-{
-  icon: <BoltIcon />,
-  name: "Automation",
-  subItems: [
-    { name: "Overview", path: "/automation/overview" },
-    { name: "Pipeline Settings", path: "/automation/settings" },
-    { name: "Run Now", path: "/automation/run" },
-  ],
-}
-
-// Publisher Section (NEW dropdown)
-{
-  icon: <CalendarIcon />,
-  name: "Publisher",
-  subItems: [
-    { name: "Content Calendar", path: "/publisher/content-calendar" },
-    { name: "Publish Settings", path: "/publisher/settings" },
-  ],
-}
-```
-
----
-
-### 3. AutomationPage Simplified
-
-**File:** `/frontend/src/pages/Automation/AutomationPage.tsx`
-
-**Removed:**
-- ❌ 5 metric cards (Keywords, Clusters, Ideas, Content, Images) → Moved to Overview
-- ❌ RunHistory component → Moved to Overview
-- ❌ ConfigModal import and usage → Converted to Pipeline Settings page
-- ❌ `showConfigModal` state
-- ❌ `config` state
-- ❌ `handleSaveConfig` function
-
-**Updated:**
-- ✅ "Configure" button → "Pipeline Settings" button (links to `/automation/settings`)
-
-**Kept:**
-- ✅ Schedule & Controls Panel (header banner)
-- ✅ 7 Stage cards with pending/processed counts
-- ✅ Processing card (when run is active)
-- ✅ Activity Log component
-- ✅ Run controls (Run Now, Pause, Resume)
-
----
-
-### 4. Sites/Settings Cleaned Up
-
-**File:** `/frontend/src/pages/Sites/Settings.tsx`
-
-**Removed:**
-- ❌ Publishing tab button
-- ❌ Publishing tab content (3 cards: Automation, Limits, Schedule)
-- ❌ `publishingSettings` state
-- ❌ `publishingSettingsLoading` state
-- ❌ `publishingSettingsSaving` state
-- ❌ `loadPublishingSettings()` function
-- ❌ `savePublishingSettings()` function
-- ❌ 'publishing' from tab type definition
-
-**Result:**
-- Now has only 3 tabs: General, AI Settings, Integrations
-- Cleaner, more focused site configuration
-
----
-
-## Testing Guide
-
-### Prerequisites
-- Frontend server running: `npm run dev` (Port 5173)
-- Backend server running: Docker containers up
-- At least one site configured
-- User logged in
-
-### Test Scenarios
-
-#### 1. Automation Overview Page ✅
-**URL:** http://localhost:5173/automation/overview
-
-**Test:**
-1. Navigate to Automation → Overview from sidebar
-2. Verify 5 metric cards load with correct counts
-3. Verify "Ready to Process" section shows cost estimation
-4. Verify run history table displays (if any runs exist)
-5. Check responsiveness (desktop, tablet, mobile)
-
-**Expected:**
-- All metrics display correct numbers
-- Cost estimation shows credits needed
-- Run history table shows recent runs
-- No console errors
-
-#### 2. Pipeline Settings Page ✅
-**URL:** http://localhost:5173/automation/settings
-
-**Test:**
-1. Navigate to Automation → Pipeline Settings
-2. Toggle stage enable/disable checkboxes
-3. Change batch sizes
-4. Modify delays
-5. Click "Save Configuration"
-6. Reload page and verify settings persist
-
-**Expected:**
-- All form fields work correctly
-- Save shows success toast
-- Settings persist after reload
-- No console errors
-
-#### 3. Publish Settings Page ✅ (CRITICAL - Bug Fix)
-**URL:** http://localhost:5173/publisher/settings
-
-**Test:**
-1. **Select Site A** from site selector
-2. Navigate to Publisher → Publish Settings
-3. Note current settings for Site A
-4. **Switch to Site B** from site selector
-5. Verify settings change to Site B's settings
-6. **Switch back to Site A**
-7. Verify settings revert to Site A's settings
-
-**Expected:**
-- ✅ Settings load for currently selected site
-- ✅ Changing site selector updates the displayed settings
-- ✅ Each site has its own independent settings
-- ❌ OLD BUG (FIXED): Site selector shouldn't affect all sites globally
-
-**Additional Tests:**
-- Toggle auto-approval/auto-publish
-- Change publish limits
-- Select publishing days
-- Add/remove time slots
-- Click "Save Publishing Settings"
-- Verify toast success message
-
-#### 4. Simplified Run Now Page ✅
-**URL:** http://localhost:5173/automation/run
-
-**Test:**
-1. Navigate to Automation → Run Now
-2. Verify metric cards are GONE (moved to Overview)
-3. Verify run history is GONE (moved to Overview)
-4. Verify "Pipeline Settings" button exists (top-right)
-5. Click "Pipeline Settings" → Should navigate to `/automation/settings`
-6. Return and click "Run Now" button
-7. Verify automation starts
-8. Verify stage cards update in real-time
-9. Verify processing card shows progress
-10. Verify activity log updates
-
-**Expected:**
-- Page is cleaner (no metric cards at top)
-- "Pipeline Settings" button works
-- Run controls work (Run, Pause, Resume)
-- Stage cards show correct status
-- No console errors
-
-#### 5. Sites Settings (Publishing Tab Removed) ✅
-**URL:** http://localhost:5173/sites/:id/settings
-
-**Test:**
-1. Navigate to any site
-2. Click "Settings" tab
-3. Verify only 3 tabs exist: General, AI Settings, Integrations
-4. Verify Publishing tab is GONE
-5. Try accessing `/sites/:id/settings?tab=publishing` directly
-6. Verify it doesn't break (should redirect or show default tab)
-
-**Expected:**
-- Only 3 tabs visible
-- No Publishing tab
-- No console errors
-- No broken references
-
-#### 6. Navigation Integration ✅
-**Test:**
-1. Open sidebar menu
-2. Find "Automation" section
-3. Verify it has dropdown with 3 items:
-   - Overview
-   - Pipeline Settings
-   - Run Now
-4. Find "Publisher" section
-5. Verify it has dropdown with 2 items:
-   - Content Calendar
-   - Publish Settings
-6. Click each menu item and verify navigation works
-
-**Expected:**
-- All menu items visible and clickable
-- Navigation works smoothly
-- Active state highlights correctly
-- Breadcrumbs update correctly
-
----
-
-## Known Issues / Limitations
-
-### Minor Issues:
-1. **Cost Estimation API** - May need backend adjustment if estimate endpoint doesn't exist
-2. **Stage 8 Label** - Not updated in this phase (planned for future)
-3. **Account Consolidation** - Postponed to Phase 3
-
-### Notes:
-- AutomationOverview uses existing API endpoints (no new backend needed)
-- PipelineSettings uses existing AutomationConfig API
-- PublishSettings uses existing PublishingSettings API
-
----
-
-## Rollback Plan (If Needed)
-
-If issues are found, rollback steps:
-
-1. **Revert Routes:**
-```bash
-git checkout HEAD -- frontend/src/App.tsx
-```
-
-2. **Revert Sidebar:**
-```bash
-git checkout HEAD -- frontend/src/layout/AppSidebar.tsx
-```
-
-3. **Revert AutomationPage:**
-```bash
-git checkout HEAD -- frontend/src/pages/Automation/AutomationPage.tsx
-```
-
-4. **Restore Sites/Settings Publishing Tab:**
-```bash
-git checkout HEAD -- frontend/src/pages/Sites/Settings.tsx
-```
-
-5. **Delete New Pages:**
-```bash
-rm frontend/src/pages/Automation/AutomationOverview.tsx
-rm frontend/src/pages/Automation/PipelineSettings.tsx
-rm frontend/src/pages/Publisher/PublishSettings.tsx
-```
-
----
-
-## Files Modified
-
-### Created (3):
-1. `frontend/src/pages/Automation/AutomationOverview.tsx` (286 lines)
-2. `frontend/src/pages/Automation/PipelineSettings.tsx` (399 lines)
-3. `frontend/src/pages/Publisher/PublishSettings.tsx` (376 lines)
-
-### Modified (4):
-4. `frontend/src/App.tsx` - Added routes
-5. `frontend/src/layout/AppSidebar.tsx` - Updated menu structure
-6. `frontend/src/pages/Automation/AutomationPage.tsx` - Simplified (removed ~200 lines)
-7. `frontend/src/pages/Sites/Settings.tsx` - Removed Publishing tab (~350 lines)
-
-### Total Changes:
-- **Added:** ~1,061 lines
-- **Removed:** ~550 lines
-- **Net:** +511 lines
-- **Files:** 7 files modified
-
----
-
-## Next Steps
-
-### Immediate (Testing Phase):
-1. ✅ Run manual tests using guide above
-2. ✅ Verify all routes work
-3. ✅ Test site selector bug fix (CRITICAL)
-4. ✅ Check for console errors
-5. ✅ Test on different screen sizes
-
-### Phase 3 (Optional - Nice to Have):
-1. Update Stage 8 labels ("Stage 8: Approved → Scheduled")
-2. Consolidate Account Settings pages
-3. Move Notifications to HELP section
-4. Add last run detailed breakdown to Overview
-5. Enhance cost estimation with per-stage breakdown
-
-### Documentation:
-1. Update user documentation
-2. Create changelog entry
-3. Update API documentation (if needed)
-4. Take screenshots for release notes
-
----
-
-## Success Criteria
-
-### Must Pass:
-- ✅ No compilation errors
-- ✅ All new pages load without errors
-- ✅ Navigation links work correctly
-- ✅ Publish Settings site selector bug is FIXED
-- ✅ Run Now page functionality intact
-- ✅ No 404 errors on any route
-
-### Should Pass:
-- ✅ Responsive design works on mobile
-- ✅ Dark mode works correctly
-- ✅ Loading states display properly
-- ✅ Toast messages show on save
-- ✅ Form validation works
-
-### Nice to Have:
-- ✅ Smooth transitions between pages
-- ✅ Consistent styling across new pages
-- ✅ Proper error handling
-- ✅ Accessibility features work
-
----
-
-## Questions & Answers
-
-**Q: Do I need to run database migrations?**  
-A: No, all changes are frontend-only.
-
-**Q: Will this break existing automation runs?**  
-A: No, AutomationPage (Run Now) functionality is preserved.
-
-**Q: Can I access the old Publishing settings?**  
-A: Yes, at `/publisher/settings` (moved from Sites/Settings).
-
-**Q: What if the cost estimation doesn't load?**  
-A: It's optional - Overview page will still work without it.
-
-**Q: Is the ConfigModal completely removed?**  
-A: Yes, it's been converted to the Pipeline Settings page.
-
----
-
-## Approval Checklist
-
-Before deploying to production:
-
-- [ ] All tests pass
-- [ ] No console errors
-- [ ] Site selector bug verified as fixed
-- [ ] Navigation works smoothly
-- [ ] Responsive design tested
-- [ ] Dark mode tested
-- [ ] Multiple sites tested
-- [ ] Code review completed
-- [ ] Documentation updated
-- [ ] Changelog updated
-
----
-
-**Implementation Status:** ✅ COMPLETE  
-**Ready for Testing:** YES  
-**Blocking Issues:** NONE  
-**Frontend Server:** Running on http://localhost:5173
-
-**Start Testing Now:** http://localhost:5173/automation/overview
diff --git a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_REFACTOR_PLAN.md b/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_REFACTOR_PLAN.md
deleted file mode 100644
index cfbce0e6..00000000
--- a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_REFACTOR_PLAN.md
+++ /dev/null
@@ -1,613 +0,0 @@
-# Navigation Refactoring Plan v2
-**Date:** January 17, 2026 (Updated)  
-**Objective:** Restructure sidebar navigation + create comprehensive Automation Overview dashboard
-
----
-
-## Executive Summary
-
-### What's Changing:
-1. **Publisher Section Created** - Groups all publishing-related pages (Review → Approve → Schedule → Settings)
-2. **Automation Reorganized** - 3 focused pages (Overview dashboard, Pipeline Settings, Run Now)
-3. **Publish Settings Moved** - From Sites Settings to Publisher section (better logical fit)
-4. **Overview Dashboard Created** - NEW comprehensive automation status/metrics/history page
-5. **Account Consolidated** - 3 pages merged into 1 with card layout
-6. **Notifications Moved** - From ACCOUNT to HELP section
-
-### Key Benefits:
-- **Transparency**: New Overview page shows complete automation details (what was processed, costs, status)
-- **Organization**: Logical grouping of related features
-- **Simplification**: Run Now page simplified, Account pages consolidated
-- **Bug Fix**: Publish Settings site selector will work correctly (store-based instead of URL-based)
-
----
-
-## New Structure
-
-```
-DASHBOARD (standalone)
-
-SETUP
-├── Setup Wizard
-├── Sites
-├── Keyword Library
-└── Thinker (admin only)
-    ├── Prompts
-    └── Author Profiles
-
-WORKFLOW
-├── Planner
-│   ├── Keywords
-│   ├── Clusters
-│   └── Ideas
-└── Writer
-    ├── Content Queue
-    ├── Content Drafts
-    └── Content Images
-
-PUBLISHER (NEW DROPDOWN) 
-├── Content Review
-├── Publish / Schedule
-├── Publish Settings (moved from Sites Settings)
-└── Content Calendar
-
-AUTOMATION (NEW DROPDOWN)
-├── Overview (NEW comprehensive dashboard)
-├── Pipeline Settings (from ConfigModal)
-└── Run Now (simplified)
-
-ACCOUNT (CONSOLIDATED)
-├── Account Settings (single page with 3 cards)
-├── Plans & Billing
-├── Usage
-└── AI Models (admin only)
-
-HELP
-├── Notifications (moved from ACCOUNT)
-└── Help & Docs
-```
-
----
-
-## Detailed Page Breakdown
-
-### 1. Automation Overview Page (NEW)
-**Route:** `/automation/overview` or `/automation`  
-**Purpose:** Comprehensive automation dashboard - similar to site dashboard and homepage
-
-**Content Sections:**
-
-#### A. Current Configuration Status Cards
-```
-┌─────────────┬─────────────┬─────────────┬─────────────┬─────────────┐
-│  Keywords   │  Clusters   │   Ideas     │   Tasks     │  Content    │
-│     265     │     27      │    127      │     0       │    127      │
-│  New: 3     │  New: 0     │  New: 0     │             │  Draft: 66  │
-│  Mapped:265 │  Mapped: 27 │  Queued: 0  │             │  Review: 0  │
-│             │             │  Done: 127  │             │  Publish:61 │
-└─────────────┴─────────────┴─────────────┴─────────────┴─────────────┘
-```
-(These are the 5 metric cards currently on Run Now page)
-
-#### B. Processable Items & Cost Estimation (NEW)
-**Card: "Ready to Process"**
-- Show what items can be processed right now per stage
-- Estimated output (how many items each stage will create)
-- Individual cost per stage (credits)
-- Total estimated cost
-- Current credit balance
-- Sufficient credits indicator
-
-Example:
-```
-Stage 1: Keywords → Clusters
-  Input: 3 new keywords
-  Output: ~1-2 clusters expected
-  Cost: 150 credits
-  Status: ✓ Ready
-
-Stage 2: Clusters → Ideas  
-  Input: 0 new clusters
-  Output: 0 ideas expected
-  Cost: 0 credits
-  Status: ⊗ Nothing to process
-
-... (continue for all 7 stages)
-
-TOTAL COST: 450 credits
-Current Balance: 3,174 credits
-Status: ✓ Sufficient credits
-```
-
-#### C. Last Automation Run - Detailed View (NEW)
-**Card: "Last Run Details"**
-Show complete breakdown of most recent run:
-```
-Run ID: #1234
-Started: Jan 17, 2026 7:35 PM
-Duration: 12 minutes
-Status: Completed ✓
-Trigger: Manual
-
-┌──────────┬──────────┬──────────┬───────────┬────────┐
-│  Stage   │ Processed│ Created  │  Credits  │ Status │
-├──────────┼──────────┼──────────┼───────────┼────────┤
-│ Stage 1  │    3     │    0     │    0      │   ✓    │
-│ Stage 2  │    0     │    0     │    0      │  Skip  │
-│ Stage 3  │  127     │    0     │    0      │   ✓    │
-│ Stage 4  │    0     │    0     │    0      │  Skip  │
-│ Stage 5  │    0     │    0     │    0      │  Skip  │
-│ Stage 6  │  281     │  315     │   945     │   ✓    │
-│ Stage 7  │    0     │    0     │    0      │  Skip  │
-│ Stage 8  │   61     │   42     │    0      │   ✓    │
-├──────────┼──────────┼──────────┼───────────┼────────┤
-│  TOTAL   │  472     │  357     │   945     │   ✓    │
-└──────────┴──────────┴──────────┴───────────┴────────┘
-
-Output Status Breakdown:
-- Draft: 66 items
-- Review: 0 items  
-- Approved: 16 items
-- Scheduled: 42 items
-- Published: 3 items
-```
-
-#### D. Run History Table (MOVED from Run Now page)
-**Card: "Automation Run History"**
-- Last 10-20 automation runs
-- Columns: Run ID, Trigger (Manual/Scheduled), Started, Duration, Status, Items Processed, Credits Used
-- Click row to see detailed breakdown (expand or modal)
-- Filter: All / Manual / Scheduled / Failed
-
-Example:
-```
-┌─────┬───────────┬──────────────┬──────────┬───────────┬───────────┬────────────┐
-│ ID  │  Trigger  │   Started    │ Duration │   Status  │ Processed │   Credits  │
-├─────┼───────────┼──────────────┼──────────┼───────────┼───────────┼────────────┤
-│1234 │  Manual   │ Jan 17 19:35 │ 12 min   │ Completed │    472    │     945    │
-│1233 │ Scheduled │ Jan 17 19:35 │  8 min   │ Completed │    234    │     420    │
-│1232 │  Manual   │ Jan 16 14:22 │ 15 min   │  Failed   │    156    │     280    │
-└─────┴───────────┴──────────────┴──────────┴───────────┴───────────┴────────────┘
-```
-
-**Technology:**
-- Reuse existing metrics loading logic from AutomationPage
-- Reuse RunHistory component  
-- Add new API endpoint or extend existing: `/api/v1/automation/overview/`
-  - Returns: metrics, cost estimation, last run details, run history
-
-
-### 2. Automation Pipeline Settings Page (NEW)
-**Route:** `/automation/pipeline-settings` or `/automation/settings`  
-**Purpose:** Configure 7-stage automation pipeline (extract from ConfigModal)
-
-**Content:**
-- **Stage Processing Section** (7 checkboxes for stage enable/disable)
-- **Batch Sizes Section** (7 input fields for stage batch sizes)
-- **Timing Section**:
-  - Within-stage delay
-  - Between-stage delay
-- **Schedule Section**:
-  - Enable/Disable toggle
-  - Frequency dropdown (Daily/Weekly/Monthly)
-  - Schedule time picker
-- **Save button** at bottom
-
-**Technology:**
-- Extract all content from ConfigModal component
-- Use same AutomationConfig API
-- Breadcrumb: "Automation / Pipeline Settings"
-- Site awareness: `useSiteStore().activeSite` (same as Run Now)
-
-
-### 3. Automation Run Now Page (SIMPLIFIED)
-**Route:** `/automation/run-now`  
-**Purpose:** Manual automation execution with real-time progress
-
-**What STAYS:**
-- Compact Schedule & Controls Panel (header banner)
-- 7 Stage cards (showing pending/processed counts)
-- Stage 8 card (Scheduled card - see note below)
-- Processing card (when run is active)
-- Activity Log component
-- Run controls (Run Now, Pause, Resume buttons)
-
-**What MOVES to Overview:**
-- 5 Metric cards (Keywords, Clusters, Ideas, Tasks, Content)
-- Run History table
-
-**Stage 8 Consistency Update:**
-- Change card title from "Scheduled" to "Stage 8"
-- Right side text: "Approved → Scheduled" (consistent with other stages like "Review → Published")
-- Keep same layout as other stage cards
-
-
-### 4. Publish Settings Page (NEW)
-**Route:** `/publisher/publish-settings` or `/automation/publishing-settings`  
-**Purpose:** Configure publishing automation and limits
-
-**Content (extracted from Sites/Settings.tsx Publishing tab):**
-- **Automation Card**:
-  - Auto-Approval toggle
-  - Auto-Publish toggle
-- **Limits Card**:
-  - Daily publish limit
-  - Weekly publish limit
-  - Monthly publish limit
-- **Schedule Card**:
-  - Publishing days (Mon-Sun checkboxes)
-  - Time slots (multiple time pickers)
-  - Timezone selector
-- **Save button** at bottom
-
-**Site Awareness Change:**
-- **OLD**: `/sites/:id/settings?tab=publishing` used URL param `siteId`
-- **NEW**: `/publisher/publish-settings` uses `useSiteStore().activeSite`
-- **BUG FIX**: Site selector will now only affect current view, not all sites globally
-
-**Placement Decision:**
-- **Location**: PUBLISHER dropdown (not AUTOMATION)
-- **Reasoning**: Publishing settings affect both manual publishing (Publish/Schedule page) and automation
-- **Benefit**: Centralized publishing configuration accessible from publisher workflow
-
-
-### 5. Account Settings Page (CONSOLIDATED)
-**Route:** `/account/settings` (single route, no sub-routes)  
-**Purpose:** All account management in one place
-
-**Layout:** Single page with 3 cards in rows:
-1. **Account Info Card**
-   - Account name
-   - Timezone
-   - Plan level
-   - Billing status
-  
-2. **Profile Card**
-   - Name
-   - Email
-   - Avatar
-   - Bio/Description
-   
-3. **Team Card**
-   - Team members list
-   - Roles (Owner, Admin, Editor, Viewer)
-   - Invite button
-   - Remove member actions
-
-**Changes:**
-- Merge 3 pages into 1
-- Remove tab navigation
-- Remove sub-routes (`/account/settings/profile`, `/account/settings/team`)
-- Remove dropdown from sidebar
-
-
-### 6. Content Review & Publish/Schedule Pages (NO CHANGES)
-**Routes:** `/writer/review`, `/writer/approved`  
-**Changes:** Just moved in sidebar to PUBLISHER section, pages unchanged
-
-
-### 7. Content Calendar (NO CHANGES)
-**Route:** `/publisher/content-calendar`  
-**Changes:** Just moved in sidebar to PUBLISHER section, page unchanged
-
----
-
-## System Analysis - Files Requiring Changes
-
-### CREATE NEW FILES (3):
-1. **`/frontend/src/pages/Automation/AutomationOverview.tsx`** - NEW comprehensive dashboard
-2. **`/frontend/src/pages/Automation/PipelineSettings.tsx`** - Extract from ConfigModal
-3. **`/frontend/src/pages/Publisher/PublishSettings.tsx`** - Extract from Sites/Settings.tsx
-
-### MODIFY EXISTING FILES (6):
-4. **`/frontend/src/pages/Automation/AutomationPage.tsx`** (Run Now)
-   - Remove 5 metric cards (move to Overview)
-   - Remove RunHistory component (move to Overview)
-   - Remove ConfigModal (moved to PipelineSettings page)
-   - Update "Stage 8" card title and label
-   - Add link to Pipeline Settings
-   - Keep stage cards, controls, activity log
-
-5. **`/frontend/src/pages/Sites/Settings.tsx`**
-   - Remove "Publishing" from tabs array
-   - Remove publishing settings state/loading
-   - Remove loadPublishingSettings() function
-   - Remove savePublishingSettings() function
-   - Remove entire Publishing tab JSX (3 cards: Automation, Limits, Schedule)
-
-6. **`/frontend/src/pages/account/AccountSettingsPage.tsx`**
-   - Merge Account + Profile + Team into single page
-   - Remove tab navigation
-   - Create 3-card layout
-   - Remove sub-route handling
-
-7. **`/frontend/src/App.tsx`** - Update routes
-8. **`/frontend/src/layout/AppSidebar.tsx`** - Update menu structure
-9. **`/frontend/src/layout/AppHeader.tsx`** - Update site selector patterns
-
-### COMPONENTS TO REUSE:
-- **`RunHistory.tsx`** - Move to Overview page (already exists)
-- **`ConfigModal.tsx`** - Extract content to PipelineSettings page, then delete modal
-- **Metric cards** - Move JSX to Overview page
-
----
-
-## Implementation Steps
-
-### Phase 1: Create Automation Overview Page (Priority 1)
-**Time: 3-4 hours**
-
-1. Create `AutomationOverview.tsx`
-2. Move 5 metric cards from AutomationPage
-3. Add cost estimation section (NEW)
-4. Add last run detailed breakdown (NEW)
-5. Move RunHistory component
-6. Add breadcrumb and header
-7. Test metrics loading
-8. Test with different site selections
-
-**API Requirements:**
-- May need new endpoint: `GET /api/v1/automation/overview/{site_id}/`
-  - Returns: metrics, last_run_details, cost_estimation
-- Or extend existing metrics endpoint
-
-### Phase 2: Create Pipeline Settings Page (Priority 2)
-**Time: 1-2 hours**
-
-1. Create `PipelineSettings.tsx`
-2. Extract ConfigModal content
-3. Convert modal layout to page layout
-4. Add breadcrumb: "Automation / Pipeline Settings"
-5. Test config save/load
-6. Remove ConfigModal from AutomationPage
-7. Add "Settings" link in Run Now page header
-
-### Phase 3: Create Publish Settings Page (Priority 1 - Bug Fix)
-**Time: 2-3 hours**
-
-1. Create `PublishSettings.tsx`
-2. Extract Publishing tab content from Sites/Settings.tsx
-3. Change from URL-based siteId to store-based activeSite
-4. Update API calls to use activeSite.id
-5. Test site selector behavior (critical - verify bug is fixed)
-6. Remove Publishing tab from Sites/Settings.tsx
-
-### Phase 4: Simplify Run Now Page (Priority 2)
-**Time: 1 hour**
-
-1. Remove 5 metric cards
-2. Remove RunHistory component
-3. Update Stage 8 card:
-   - Title: "Stage 8" (not "Scheduled")
-   - Right label: "Approved → Scheduled"
-4. Add link to Pipeline Settings in header
-5. Keep everything else as-is
-
-### Phase 5: Consolidate Account Settings (Priority 3)
-**Time: 2 hours**
-
-1. Update AccountSettingsPage.tsx
-2. Merge 3 pages into 1
-3. Create 3-card layout
-4. Remove tab navigation
-5. Test all account functionality
-
-### Phase 6: Update Navigation (Priority 2)
-**Time: 1-2 hours**
-
-1. Update App.tsx routes
-2. Update AppSidebar.tsx menu structure
-3. Update AppHeader.tsx site selector patterns
-4. Test all navigation paths
-5. Verify breadcrumbs
-
----
-
-## Updated Routes
-
-```tsx
-// Automation Routes
-<Route path="/automation" element={<Navigate to="/automation/overview" replace />} />
-<Route path="/automation/overview" element={<AutomationOverview />} />
-<Route path="/automation/pipeline-settings" element={<PipelineSettings />} />
-<Route path="/automation/run-now" element={<AutomationPage />} />
-
-// Publisher Routes  
-<Route path="/writer/review" element={<Review />} /> // Moved in sidebar only
-<Route path="/writer/approved" element={<Approved />} /> // Moved in sidebar only
-<Route path="/publisher/publish-settings" element={<PublishSettings />} />
-<Route path="/publisher/content-calendar" element={<ContentCalendar />} />
-
-// Account Routes (consolidated)
-<Route path="/account/settings" element={<AccountSettingsPage />} />
-// Remove: /account/settings/profile, /account/settings/team
-```
-
----
-
-## Updated Sidebar Structure
-
-```tsx
-// PUBLISHER Section (after WORKFLOW)
-{
-  label: "PUBLISHER",
-  items: [
-    {
-      icon: <CalendarIcon />,
-      name: "Publisher",
-      subItems: [
-        { name: "Content Review", path: "/writer/review" },
-        { name: "Publish / Schedule", path: "/writer/approved" },
-        { name: "Publish Settings", path: "/publisher/publish-settings" },
-        { name: "Content Calendar", path: "/publisher/content-calendar" },
-      ],
-    },
-  ],
-},
-
-// AUTOMATION Section (after PUBLISHER)
-{
-  label: "AUTOMATION",
-  items: [
-    {
-      icon: <BoltIcon />,
-      name: "Automation",
-      subItems: [
-        { name: "Overview", path: "/automation/overview" },
-        { name: "Pipeline Settings", path: "/automation/pipeline-settings" },
-        { name: "Run Now", path: "/automation/run-now" },
-      ],
-    },
-  ],
-},
-
-// ACCOUNT Section (updated)
-{
-  label: "ACCOUNT",
-  items: [
-    {
-      icon: <UserCircleIcon />,
-      name: "Account Settings",
-      path: "/account/settings", // No subItems
-    },
-    // ... rest of account items
-  ],
-},
-
-// HELP Section (updated)
-{
-  label: "HELP",
-  items: [
-    {
-      icon: <Bell />,
-      name: "Notifications",
-      path: "/account/notifications",
-    },
-    {
-      icon: <DocsIcon />,
-      name: "Help & Docs",
-      path: "/help",
-    },
-  ],
-},
-```
-
----
-
-## Testing Checklist
-
-### Automation Pages:
-- [ ] Overview page loads with all metrics
-- [ ] Overview shows cost estimation correctly
-- [ ] Overview shows last run details with all stages
-- [ ] Overview run history table works
-- [ ] Pipeline Settings loads config
-- [ ] Pipeline Settings saves config
-- [ ] Run Now page simplified (no metrics, no history)
-- [ ] Run Now stage cards work
-- [ ] Run Now Stage 8 shows "Stage 8" and "Approved → Scheduled"
-- [ ] Run controls work (Run, Pause, Resume)
-
-### Publisher Pages:
-- [ ] Publish Settings loads from activeSite (not URL)
-- [ ] Publish Settings site selector changes only current view
-- [ ] Publish Settings saves correctly
-- [ ] Content Review accessible from Publisher menu
-- [ ] Publish/Schedule accessible from Publisher menu
-- [ ] Content Calendar accessible from Publisher menu
-
-### Account Page:
-- [ ] Account Settings shows all 3 cards
-- [ ] Account Info card works
-- [ ] Profile card works
-- [ ] Team card works
-- [ ] No broken sub-routes
-
-### Navigation:
-- [ ] All sidebar links work
-- [ ] Breadcrumbs correct on all pages
-- [ ] Site selector shows on correct pages
-- [ ] Notifications in HELP section
-- [ ] No 404 errors
-
----
-
-## Risk Assessment
-
-**LOW RISK:**
-- Adding Overview page (new page, no breaking changes)
-- Adding Pipeline Settings page (modal to page, same functionality)
-- Moving sidebar items (just navigation reorganization)
-- Moving Notifications menu item
-
-**MEDIUM RISK:**
-- Simplifying Run Now page (removing components, need careful testing)
-- Consolidating Account Settings (merging pages)
-- Stage 8 label changes (need to verify no hardcoded references)
-
-**HIGH RISK:**
-- **Moving Publish Settings from Sites to Publisher**
-  - Changes site awareness model (URL → store)
-  - Multiple API calls to refactor
-  - Critical bug fix that needs thorough testing
-- **Removing Publishing tab from Sites Settings**
-  - Ensure no broken references in codebase
-
-**MITIGATION:**
-- Test Publish Settings thoroughly with site selector
-- Keep backup of Sites/Settings.tsx Publishing tab
-- Test all automation pages with real data
-- Verify cost calculations are accurate
-- Test with different credit balance scenarios
-
----
-
-## Implementation Priority
-
-### Must Have (Phase 1):
-1. Automation Overview page - **Transparency & visibility**
-2. Publish Settings page - **Bug fix**
-3. Update Routes & Sidebar - **Navigation**
-
-### Should Have (Phase 2):
-4. Pipeline Settings page - **Better UX**
-5. Simplify Run Now page - **Cleaner interface**
-6. Stage 8 consistency - **Polish**
-
-### Nice to Have (Phase 3):
-7. Consolidate Account Settings - **Simplification**
-8. Move Notifications to HELP - **Better organization**
-
----
-
-## Estimated Timeline
-
-- **Phase 1** (Must Have): 6-8 hours
-- **Phase 2** (Should Have): 3-4 hours
-- **Phase 3** (Nice to Have): 2-3 hours
-- **Total**: 11-15 hours
-
-**Can be split across multiple sessions:**
-- Session 1: Overview page (3-4 hours)
-- Session 2: Publish Settings + Navigation (3-4 hours)
-- Session 3: Pipeline Settings + Run Now simplification (2-3 hours)
-- Session 4: Account consolidation + Polish (2-3 hours)
-
----
-
-## Ready to Begin?
-
-**Status:** ✅ **Plan reviewed and updated with new requirements**
-
-**Next Steps:**
-1. Approve this plan
-2. Start with Phase 1 (Automation Overview page)
-3. Test thoroughly
-4. Move to Phase 2
-
-**Questions to confirm:**
-1. Cost estimation logic - should we use existing estimate API or create new?
-2. Last run details - extend existing API or create new endpoint?
-3. Stage 8 - any other places where "Scheduled" label is used?
-4. Account consolidation - any concerns about merging 3 pages?
-
diff --git a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_REFACTOR_SUMMARY.md b/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_REFACTOR_SUMMARY.md
deleted file mode 100644
index f5225845..00000000
--- a/docs/plans/NAVIGATION_REFACOTR/NAVIGATION_REFACTOR_SUMMARY.md
+++ /dev/null
@@ -1,161 +0,0 @@
-# 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)
-
diff --git a/docs/plans/automation/AUTOMATION-ENHANCEMENT-PLAN.md b/docs/plans/automation/AUTOMATION-ENHANCEMENT-PLAN.md
deleted file mode 100644
index 0826aaba..00000000
--- a/docs/plans/automation/AUTOMATION-ENHANCEMENT-PLAN.md
+++ /dev/null
@@ -1,765 +0,0 @@
-# Automation System Enhancement Plan
-
-**Created:** January 17, 2026  
-**Updated:** January 17, 2026 (IMPLEMENTATION COMPLETE)
-**Status:** ✅ ALL PHASES COMPLETE  
-**Priority:** 🔴 CRITICAL - Blocks Production Launch
-
----
-
-## Implementation Progress
-
-### ✅ PHASE 1: Bug Fixes (COMPLETE)
-1. **Bug #1:** Cancel releases lock - [views.py](../../backend/igny8_core/business/automation/views.py)
-2. **Bug #2:** Scheduled check includes 'paused' - [tasks.py](../../backend/igny8_core/business/automation/tasks.py)
-3. **Bug #3:** Resume reacquires lock - [tasks.py](../../backend/igny8_core/business/automation/tasks.py)
-4. **Bug #4:** Resume has pause/cancel checks - [tasks.py](../../backend/igny8_core/business/automation/tasks.py)
-5. **Bug #5:** Pause logs to files - [views.py](../../backend/igny8_core/business/automation/views.py)
-6. **Bug #6:** Resume exception releases lock - [tasks.py](../../backend/igny8_core/business/automation/tasks.py)
-
-### ✅ PHASE 2: Per-Run Item Limits (COMPLETE)
-- Added 8 new fields to `AutomationConfig` model:
-  - `max_keywords_per_run`, `max_clusters_per_run`, `max_ideas_per_run`
-  - `max_tasks_per_run`, `max_content_per_run`, `max_images_per_run`
-  - `max_approvals_per_run`, `max_credits_per_run`
-- Migration: [0014_automation_per_run_limits.py](../../backend/migrations/0014_automation_per_run_limits.py)
-- Service: Updated `automation_service.py` with `_get_per_run_limit()`, `_apply_per_run_limit()`, `_check_credit_budget()`
-- API: Updated config endpoints in views.py
-
-### ✅ PHASE 3: Publishing Settings Overhaul (COMPLETE)
-- Added scheduling modes: `time_slots`, `stagger`, `immediate`
-- New fields: `scheduling_mode`, `stagger_start_time`, `stagger_end_time`, `stagger_interval_minutes`, `queue_limit`
-- Migration: [0015_publishing_settings_overhaul.py](../../backend/migrations/0015_publishing_settings_overhaul.py)
-- Scheduler: Updated `_calculate_available_slots()` with three mode handlers
-
-### ✅ PHASE 4: Credit % Allocation per AI Function (COMPLETE)
-- New model: `SiteAIBudgetAllocation` in billing/models.py
-- Default allocations: 15% clustering, 10% ideas, 40% content, 5% prompts, 30% images
-- Migration: [0016_site_ai_budget_allocation.py](../../backend/migrations/0016_site_ai_budget_allocation.py)
-- API: New viewset at `/api/v1/billing/sites/{site_id}/ai-budget/`
-
-### ✅ PHASE 5: UI Updates (COMPLETE)
-- Updated `AutomationConfig` interface in `automationService.ts` with new per-run limit fields
-- GlobalProgressBar already implements correct calculation using `initial_snapshot`
-
----
-
-## Migrations To Run
-
-```bash
-cd /data/app/igny8/backend
-python manage.py migrate
-```
-
-## Files Modified
-
-### Backend
-- `backend/igny8_core/business/automation/views.py` - Cancel releases lock, pause logs
-- `backend/igny8_core/business/automation/tasks.py` - Resume fixes, scheduled check
-- `backend/igny8_core/business/automation/models.py` - Per-run limit fields
-- `backend/igny8_core/business/automation/services/automation_service.py` - Limit enforcement
-- `backend/igny8_core/business/integration/models.py` - Publishing modes
-- `backend/igny8_core/business/billing/models.py` - SiteAIBudgetAllocation
-- `backend/igny8_core/modules/billing/views.py` - AI budget viewset
-- `backend/igny8_core/modules/billing/urls.py` - AI budget route
-- `backend/igny8_core/modules/integration/views.py` - Publishing serializer
-- `backend/igny8_core/tasks/publishing_scheduler.py` - Scheduling modes
-
-### Frontend
-- `frontend/src/services/automationService.ts` - Config interface updated
-
-### Migrations
-- `backend/migrations/0014_automation_per_run_limits.py`
-- `backend/migrations/0015_publishing_settings_overhaul.py`
-- `backend/migrations/0016_site_ai_budget_allocation.py`
-
----
-
-## Executive Summary
-
-This plan addresses critical automation bugs and introduces 4 major enhancements:
-1. **Fix Critical Automation Bugs** - Lock management, scheduled runs, logging
-2. **Credit Budget Allocation** - Configurable % per AI function
-3. **Publishing Schedule Overhaul** - Robust, predictable scheduling
-4. **Per-Run Item Limits** - Control throughput per automation run
-
----
-
-## Part 1: Critical Bug Fixes ✅ COMPLETE
-
-### 🔴 BUG #1: Cancel Action Doesn't Release Lock
-
-**Location:** `backend/igny8_core/business/automation/views.py` line ~1614
-
-**Current Code:**
-```python
-def cancel_automation(self, request):
-    run.status = 'cancelled'
-    run.cancelled_at = timezone.now()
-    run.completed_at = timezone.now()
-    run.save(update_fields=['status', 'cancelled_at', 'completed_at'])
-    # ❌ MISSING: cache.delete(f'automation_lock_{run.site.id}')
-```
-
-**Fix:**
-```python
-def cancel_automation(self, request):
-    run.status = 'cancelled'
-    run.cancelled_at = timezone.now()
-    run.completed_at = timezone.now()
-    run.save(update_fields=['status', 'cancelled_at', 'completed_at'])
-    
-    # Release the lock so user can start new automation
-    from django.core.cache import cache
-    cache.delete(f'automation_lock_{run.site.id}')
-    
-    # Log the cancellation
-    from igny8_core.business.automation.services.automation_logger import AutomationLogger
-    logger = AutomationLogger()
-    logger.log_stage_progress(
-        run.run_id, run.account.id, run.site.id, run.current_stage,
-        f"Automation cancelled by user"
-    )
-```
-
-**Impact:** Users can immediately start new automation after cancelling
-
----
-
-### 🔴 BUG #2: Scheduled Automation Doesn't Check 'paused' Status
-
-**Location:** `backend/igny8_core/business/automation/tasks.py` line ~52
-
-**Current Code:**
-```python
-# Check if already running
-if AutomationRun.objects.filter(site=config.site, status='running').exists():
-    logger.info(f"[AutomationTask] Skipping site {config.site.id} - already running")
-    continue
-```
-
-**Fix:**
-```python
-# Check if already running OR paused
-if AutomationRun.objects.filter(site=config.site, status__in=['running', 'paused']).exists():
-    logger.info(f"[AutomationTask] Skipping site {config.site.id} - automation in progress (running/paused)")
-    continue
-```
-
-**Impact:** Prevents duplicate runs when one is paused
-
----
-
-### 🔴 BUG #3: Resume Doesn't Reacquire Lock
-
-**Location:** `backend/igny8_core/business/automation/tasks.py` line ~164
-
-**Current Code:**
-```python
-def resume_automation_task(self, run_id: str):
-    service = AutomationService.from_run_id(run_id)
-    # ❌ No lock check - could run unprotected after 6hr expiry
-```
-
-**Fix:**
-```python
-def resume_automation_task(self, run_id: str):
-    """Resume paused automation run from current stage"""
-    logger.info(f"[AutomationTask] Resuming automation run: {run_id}")
-    
-    try:
-        run = AutomationRun.objects.get(run_id=run_id)
-        
-        # Verify run is actually in 'running' status (set by views.resume)
-        if run.status != 'running':
-            logger.warning(f"[AutomationTask] Run {run_id} status is {run.status}, not 'running'. Aborting resume.")
-            return
-        
-        # Reacquire lock in case it expired during long pause
-        from django.core.cache import cache
-        lock_key = f'automation_lock_{run.site.id}'
-        
-        # Try to acquire - if fails, another run may have started
-        if not cache.add(lock_key, 'locked', timeout=21600):
-            # Check if WE still own it (compare run_id if stored)
-            existing = cache.get(lock_key)
-            if existing and existing != 'locked':
-                logger.warning(f"[AutomationTask] Lock held by different run. Aborting resume for {run_id}")
-                run.status = 'failed'
-                run.error_message = 'Lock acquired by another run during pause'
-                run.save()
-                return
-            # Lock exists but may be ours - proceed cautiously
-        
-        service = AutomationService.from_run_id(run_id)
-        # ... rest of processing with pause/cancel checks between stages
-```
-
----
-
-### 🔴 BUG #4: Resume Missing Pause/Cancel Checks Between Stages
-
-**Location:** `backend/igny8_core/business/automation/tasks.py` line ~183
-
-**Current Code:**
-```python
-for stage in range(run.current_stage - 1, 7):
-    if stage_enabled[stage]:
-        stage_methods[stage]()
-    # ❌ No pause/cancel check after each stage
-```
-
-**Fix:**
-```python
-for stage in range(run.current_stage - 1, 7):
-    if stage_enabled[stage]:
-        stage_methods[stage]()
-        
-        # Check for pause/cancel AFTER each stage (same as run_automation_task)
-        service.run.refresh_from_db()
-        if service.run.status in ['paused', 'cancelled']:
-            logger.info(f"[AutomationTask] Resumed automation {service.run.status} after stage {stage + 1}")
-            return
-    else:
-        logger.info(f"[AutomationTask] Stage {stage + 1} is disabled, skipping")
-```
-
----
-
-### 🟡 BUG #5: Pause Missing File Log Entry
-
-**Location:** `backend/igny8_core/business/automation/views.py` pause action
-
-**Fix:** Add logging call:
-```python
-def pause(self, request):
-    # ... existing code ...
-    service.pause_automation()
-    
-    # Log to automation files
-    service.logger.log_stage_progress(
-        service.run.run_id, service.account.id, service.site.id,
-        service.run.current_stage, f"Automation paused by user"
-    )
-    
-    return Response({'message': 'Automation paused'})
-```
-
----
-
-## Part 2: Credit Budget Allocation System
-
-### Overview
-
-Add configurable credit % allocation per AI function. Users can:
-- Use global defaults (configured by admin)
-- Override with site-specific allocations
-
-### Database Changes
-
-**Extend `CreditCostConfig` model:**
-```python
-class CreditCostConfig(models.Model):
-    # ... existing fields ...
-    
-    # NEW: Budget allocation percentage
-    budget_percentage = models.DecimalField(
-        max_digits=5,
-        decimal_places=2,
-        default=0,
-        validators=[MinValueValidator(0), MaxValueValidator(100)],
-        help_text="Default % of credits allocated to this operation (0-100)"
-    )
-```
-
-**New `SiteAIBudgetAllocation` model:**
-```python
-class SiteAIBudgetAllocation(AccountBaseModel):
-    """Site-specific credit budget allocation overrides"""
-    
-    site = models.OneToOneField(
-        'igny8_core_auth.Site',
-        on_delete=models.CASCADE,
-        related_name='ai_budget_allocation'
-    )
-    
-    use_global_defaults = models.BooleanField(
-        default=True,
-        help_text="Use global CreditCostConfig percentages"
-    )
-    
-    # Per-operation overrides (only used when use_global_defaults=False)
-    clustering_percentage = models.DecimalField(max_digits=5, decimal_places=2, default=10)
-    idea_generation_percentage = models.DecimalField(max_digits=5, decimal_places=2, default=10)
-    content_generation_percentage = models.DecimalField(max_digits=5, decimal_places=2, default=40)
-    image_prompt_extraction_percentage = models.DecimalField(max_digits=5, decimal_places=2, default=5)
-    image_generation_percentage = models.DecimalField(max_digits=5, decimal_places=2, default=35)
-    
-    class Meta:
-        db_table = 'igny8_site_ai_budget_allocations'
-```
-
-### Service Changes
-
-**New `BudgetAllocationService`:**
-```python
-class BudgetAllocationService:
-    @staticmethod
-    def get_operation_budget(site, operation_type, total_credits):
-        """
-        Get credits allocated for an operation based on site settings.
-        
-        Args:
-            site: Site instance
-            operation_type: 'clustering', 'content_generation', etc.
-            total_credits: Total credits available
-            
-        Returns:
-            int: Credits allocated for this operation
-        """
-        allocation = SiteAIBudgetAllocation.objects.filter(site=site).first()
-        
-        if not allocation or allocation.use_global_defaults:
-            # Use global CreditCostConfig percentages
-            config = CreditCostConfig.objects.filter(
-                operation_type=operation_type,
-                is_active=True
-            ).first()
-            percentage = config.budget_percentage if config else 0
-        else:
-            # Use site-specific override
-            field_map = {
-                'clustering': 'clustering_percentage',
-                'idea_generation': 'idea_generation_percentage',
-                'content_generation': 'content_generation_percentage',
-                'image_prompt_extraction': 'image_prompt_extraction_percentage',
-                'image_generation': 'image_generation_percentage',
-            }
-            field = field_map.get(operation_type)
-            percentage = getattr(allocation, field, 0) if field else 0
-        
-        return int(total_credits * (percentage / 100))
-```
-
-### Frontend Changes
-
-**Site Settings > AI Settings Tab:**
-- Add "Credit Budget Allocation" section
-- Toggle: "Use Global Defaults" / "Custom Allocation"
-- If custom: Show sliders for each operation (must sum to 100%)
-- Visual pie chart showing allocation
-
----
-
-## Part 3: Publishing Schedule Overhaul
-
-### Current Issues
-
-1. Limits are confusing - daily/weekly/monthly are treated as hard caps
-2. Items not getting scheduled (30% missed in last run)
-3. Time slot calculation doesn't account for stagger intervals
-4. No visibility into WHY items weren't scheduled
-
-### New Publishing Model
-
-**Replace `PublishingSettings` with enhanced version:**
-```python
-class PublishingSettings(AccountBaseModel):
-    site = models.OneToOneField('igny8_core_auth.Site', on_delete=models.CASCADE)
-    
-    # Auto-approval/publish toggles (keep existing)
-    auto_approval_enabled = models.BooleanField(default=True)
-    auto_publish_enabled = models.BooleanField(default=True)
-    
-    # NEW: Scheduling configuration (replaces hard limits)
-    scheduling_mode = models.CharField(
-        max_length=20,
-        choices=[
-            ('slots', 'Time Slots'),  # Publish at specific times
-            ('stagger', 'Staggered'),  # Spread evenly throughout day
-            ('immediate', 'Immediate'),  # Publish as soon as approved
-        ],
-        default='slots'
-    )
-    
-    # Time slot configuration
-    publish_days = models.JSONField(
-        default=['mon', 'tue', 'wed', 'thu', 'fri'],
-        help_text="Days allowed for publishing"
-    )
-    
-    publish_time_slots = models.JSONField(
-        default=['09:00', '14:00', '18:00'],
-        help_text="Specific times for slot mode"
-    )
-    
-    # Stagger mode configuration
-    stagger_start_time = models.TimeField(default='09:00')
-    stagger_end_time = models.TimeField(default='18:00')
-    stagger_interval_minutes = models.IntegerField(
-        default=15,
-        help_text="Minutes between publications in stagger mode"
-    )
-    
-    # Daily TARGET (soft limit - for estimation, not blocking)
-    daily_publish_target = models.IntegerField(
-        default=3,
-        help_text="Target articles per day (for scheduling spread)"
-    )
-    
-    # Weekly/Monthly targets (informational only)
-    weekly_publish_target = models.IntegerField(default=15)
-    monthly_publish_target = models.IntegerField(default=50)
-    
-    # NEW: Maximum queue depth (actual limit)
-    max_scheduled_queue = models.IntegerField(
-        default=100,
-        help_text="Maximum items that can be in 'scheduled' status at once"
-    )
-```
-
-### New Scheduling Algorithm
-
-```python
-def calculate_publishing_slots(settings, site, count_needed):
-    """
-    Calculate publishing slots with NO arbitrary limits.
-    
-    Returns:
-        List of (datetime, slot_info) tuples
-    """
-    slots = []
-    now = timezone.now()
-    
-    if settings.scheduling_mode == 'immediate':
-        # Return 'now' for all items
-        return [(now + timedelta(seconds=i*60), {'mode': 'immediate'}) for i in range(count_needed)]
-    
-    elif settings.scheduling_mode == 'stagger':
-        # Spread throughout each day
-        return _calculate_stagger_slots(settings, site, count_needed, now)
-    
-    else:  # 'slots' mode
-        return _calculate_time_slot_slots(settings, site, count_needed, now)
-
-
-def _calculate_stagger_slots(settings, site, count_needed, now):
-    """
-    Stagger mode: Spread publications evenly throughout publish hours.
-    """
-    slots = []
-    day_map = {'mon': 0, 'tue': 1, 'wed': 2, 'thu': 3, 'fri': 4, 'sat': 5, 'sun': 6}
-    allowed_days = [day_map[d] for d in settings.publish_days if d in day_map]
-    
-    current_date = now.date()
-    interval = timedelta(minutes=settings.stagger_interval_minutes)
-    
-    for day_offset in range(90):  # Look up to 90 days ahead
-        check_date = current_date + timedelta(days=day_offset)
-        
-        if check_date.weekday() not in allowed_days:
-            continue
-        
-        # Generate slots for this day
-        day_start = timezone.make_aware(
-            datetime.combine(check_date, settings.stagger_start_time)
-        )
-        day_end = timezone.make_aware(
-            datetime.combine(check_date, settings.stagger_end_time)
-        )
-        
-        # Get existing scheduled for this day
-        existing = Content.objects.filter(
-            site=site,
-            site_status='scheduled',
-            scheduled_publish_at__date=check_date
-        ).values_list('scheduled_publish_at', flat=True)
-        existing_times = set(existing)
-        
-        current_slot = day_start
-        if check_date == current_date and now > day_start:
-            # Start from next interval after now
-            minutes_since_start = (now - day_start).total_seconds() / 60
-            intervals_passed = int(minutes_since_start / settings.stagger_interval_minutes) + 1
-            current_slot = day_start + timedelta(minutes=intervals_passed * settings.stagger_interval_minutes)
-        
-        while current_slot <= day_end and len(slots) < count_needed:
-            if current_slot not in existing_times:
-                slots.append((current_slot, {'mode': 'stagger', 'date': str(check_date)}))
-            current_slot += interval
-        
-        if len(slots) >= count_needed:
-            break
-    
-    return slots
-```
-
-### Frontend Changes
-
-**Site Settings > Publishing Tab - Redesign:**
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ Publishing Schedule                                              │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Auto-Approval: [✓] Automatically approve content                │
-│  Auto-Publish:  [✓] Automatically publish approved content       │
-│                                                                  │
-│  ─── Scheduling Mode ───                                         │
-│  ○ Time Slots - Publish at specific times each day               │
-│  ● Staggered - Spread evenly throughout publish hours            │
-│  ○ Immediate - Publish as soon as approved                       │
-│                                                                  │
-│  ─── Stagger Settings ───                                        │
-│  Start Time: [09:00]  End Time: [18:00]                         │
-│  Interval: [15] minutes between publications                     │
-│                                                                  │
-│  ─── Publish Days ───                                            │
-│  [✓] Mon [✓] Tue [✓] Wed [✓] Thu [✓] Fri [ ] Sat [ ] Sun        │
-│                                                                  │
-│  ─── Targets (for estimation) ───                                │
-│  Daily: [3]  Weekly: [15]  Monthly: [50]                        │
-│                                                                  │
-│  ─── Current Queue ───                                           │
-│  📊 23 items scheduled  │  Queue limit: 100                     │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Part 4: Per-Run Item Limits
-
-### Overview
-
-Allow users to limit how many items are processed per automation run. This enables:
-- Balancing content production with publishing capacity
-- Predictable credit usage per run
-- Gradual pipeline processing
-
-### Database Changes
-
-**Extend `AutomationConfig`:**
-```python
-class AutomationConfig(models.Model):
-    # ... existing fields ...
-    
-    # NEW: Per-run limits (0 = unlimited)
-    max_keywords_per_run = models.IntegerField(
-        default=0,
-        help_text="Max keywords to cluster per run (0=unlimited)"
-    )
-    max_clusters_per_run = models.IntegerField(
-        default=0,
-        help_text="Max clusters to generate ideas for per run (0=unlimited)"
-    )
-    max_ideas_per_run = models.IntegerField(
-        default=0,
-        help_text="Max ideas to convert to tasks per run (0=unlimited)"
-    )
-    max_tasks_per_run = models.IntegerField(
-        default=0,
-        help_text="Max tasks to generate content for per run (0=unlimited)"
-    )
-    max_content_per_run = models.IntegerField(
-        default=0,
-        help_text="Max content to extract image prompts for per run (0=unlimited)"
-    )
-    max_images_per_run = models.IntegerField(
-        default=0,
-        help_text="Max images to generate per run (0=unlimited)"
-    )
-    max_approvals_per_run = models.IntegerField(
-        default=0,
-        help_text="Max content to auto-approve per run (0=unlimited)"
-    )
-```
-
-### Service Changes
-
-**Modify stage methods to respect limits:**
-```python
-def run_stage_1(self):
-    """Stage 1: Keywords → Clusters"""
-    # ... existing setup ...
-    
-    # Apply per-run limit
-    max_per_run = self.config.max_keywords_per_run
-    if max_per_run > 0:
-        pending_keywords = pending_keywords[:max_per_run]
-        self.logger.log_stage_progress(
-            self.run.run_id, self.account.id, self.site.id,
-            1, f"Per-run limit: Processing up to {max_per_run} keywords"
-        )
-    
-    total_count = pending_keywords.count()
-    # ... rest of processing ...
-```
-
-### Frontend Changes
-
-**Automation Settings Panel - Enhanced:**
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ Per-Run Limits                                                   │
-│ Control how much is processed in each automation run            │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Stage 1: Keywords → Clusters                                    │
-│  [  50  ] keywords per run │ Current pending: 150               │
-│  ⚡ Will take ~3 runs to process all                            │
-│                                                                  │
-│  Stage 2: Clusters → Ideas                                       │
-│  [  10  ] clusters per run │ Current pending: 25                │
-│                                                                  │
-│  Stage 3: Ideas → Tasks                                          │
-│  [   0  ] (unlimited)      │ Current pending: 30                │
-│                                                                  │
-│  Stage 4: Tasks → Content                                        │
-│  [   5  ] tasks per run    │ Current pending: 30                │
-│  💡 Tip: Match with daily publish target for balanced flow      │
-│                                                                  │
-│  Stage 5: Content → Image Prompts                                │
-│  [   5  ] content per run  │ Current pending: 10                │
-│                                                                  │
-│  Stage 6: Image Prompts → Images                                 │
-│  [  20  ] images per run   │ Current pending: 50                │
-│                                                                  │
-│  Stage 7: Review → Approved                                      │
-│  [   5  ] approvals per run│ Current in review: 15              │
-│  ⚠️ Limited by publishing schedule capacity                     │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Part 5: UI/UX Fixes
-
-### Automation Dashboard Issues
-
-1. **Wrong metrics display** - Fix counts to show accurate pipeline state
-2. **Confusing progress bars** - Use consistent calculation
-3. **Missing explanations** - Add tooltips explaining each metric
-
-### Run Detail Page Issues
-
-1. **Stage results showing wrong data** - Fix JSON field mapping
-2. **Missing "items remaining" after partial run** - Calculate from initial_snapshot
-3. **No clear indication of WHY run stopped** - Show stopped_reason prominently
-
-### Fixes
-
-**GlobalProgressBar.tsx - Fix progress calculation:**
-```typescript
-// Use initial_snapshot as denominator, stage results as numerator
-const calculateGlobalProgress = (run: AutomationRun): number => {
-  if (!run.initial_snapshot) return 0;
-  
-  const total = run.initial_snapshot.total_initial_items || 0;
-  if (total === 0) return 0;
-  
-  let processed = 0;
-  processed += run.stage_1_result?.keywords_processed || 0;
-  processed += run.stage_2_result?.clusters_processed || 0;
-  processed += run.stage_3_result?.ideas_processed || 0;
-  processed += run.stage_4_result?.tasks_processed || 0;
-  processed += run.stage_5_result?.content_processed || 0;
-  processed += run.stage_6_result?.images_processed || 0;
-  processed += run.stage_7_result?.approved_count || 0;
-  
-  return Math.min(100, Math.round((processed / total) * 100));
-};
-```
-
----
-
-## Implementation Order
-
-### Phase 1: Critical Bug Fixes (Day 1)
-1. ✅ Cancel releases lock
-2. ✅ Scheduled check includes 'paused'
-3. ✅ Resume reacquires lock
-4. ✅ Resume has pause/cancel checks
-5. ✅ Pause logs to files
-
-### Phase 2: Per-Run Limits (Day 2)
-1. Add model fields to AutomationConfig
-2. Migration
-3. Update automation_service.py stage methods
-4. Frontend settings panel
-5. Test with small limits
-
-### Phase 3: Publishing Overhaul (Day 3)
-1. Update PublishingSettings model
-2. Migration
-3. New scheduling algorithm
-4. Frontend redesign
-5. Test scheduling edge cases
-
-### Phase 4: Credit Budget (Day 4)
-1. Add model fields/new model
-2. Migration
-3. BudgetAllocationService
-4. Frontend AI Settings section
-5. Test budget calculations
-
-### Phase 5: UI Fixes (Day 5)
-1. Fix GlobalProgressBar
-2. Fix AutomationPage metrics
-3. Fix RunDetail display
-4. Add helpful tooltips
-5. End-to-end testing
-
----
-
-## Testing Checklist
-
-### Automation Flow
-- [ ] Manual run starts, pauses, resumes, completes
-- [ ] Manual run cancels, lock released, new run can start
-- [ ] Scheduled run starts on time
-- [ ] Scheduled run skips if manual run paused
-- [ ] Resume after 7+ hour pause works
-- [ ] Per-run limits respected
-- [ ] Remaining items processed in next run
-
-### Publishing
-- [ ] Stagger mode spreads correctly
-- [ ] Time slot mode uses exact times
-- [ ] Immediate mode publishes right away
-- [ ] No items missed due to limits
-- [ ] Queue shows accurate count
-
-### Credits
-- [ ] Budget allocation calculates correctly
-- [ ] Site override works
-- [ ] Global defaults work
-- [ ] Estimation uses budget
-
-### UI
-- [ ] Progress bar accurate during run
-- [ ] Metrics match database counts
-- [ ] Run detail shows correct stage results
-- [ ] Stopped reason displayed clearly
-
----
-
-## Rollback Plan
-
-If issues arise:
-1. All changes in separate migrations - can rollback individually
-2. Feature flags for new behaviors (use_new_scheduling, use_budget_allocation)
-3. Keep existing fields alongside new ones initially
-4. Frontend changes are purely additive
-
----
-
-## Success Criteria
-
-1. **Zero lock issues** - Users never stuck unable to start automation
-2. **100% scheduling** - All approved content gets scheduled
-3. **Predictable runs** - Per-run limits produce consistent results
-4. **Clear visibility** - UI shows exactly what's happening and why
-5. **No regressions** - All existing functionality continues working
diff --git a/docs/plans/automation/AUTOMATION_RUNS_DETAIL_VIEW_UX_PLAN.md b/docs/plans/automation/AUTOMATION_RUNS_DETAIL_VIEW_UX_PLAN.md
deleted file mode 100644
index c7626cfc..00000000
--- a/docs/plans/automation/AUTOMATION_RUNS_DETAIL_VIEW_UX_PLAN.md
+++ /dev/null
@@ -1,1011 +0,0 @@
-# Automation Runs Detail View - UX Plan
-
-## Executive Summary
-
-The `AutomationRun` model contains extremely valuable data for each stage in each run that is currently being underutilized. This plan outlines a comprehensive UX design for:
-
-1. **Enhanced Overview Page** - Comprehensive dashboard with predictive analytics, cost projections, and actionable insights
-2. **Run Detail Page** - Deep-dive into individual automation runs accessible via clickable Run Title (Site Name + Run #)
-
-Both pages provide transparency into what was processed, what was created, how credits were consumed, and **what could happen if automation runs again** based on historical averages.
-
----
-
-## Part 1: Enhanced Automation Overview Page
-
-### Current State Issues
-
-The current `AutomationOverview.tsx` shows:
-- Basic metric cards (Keywords, Clusters, Ideas, Content, Images)
-- Simple "Ready to Process" cost estimation
-- Basic run history table (Run ID, Status, Trigger, Dates, Credits, Stage)
-
-**Missing:**
-- ❌ Run-level statistics (total runs, success rate, avg duration)
-- ❌ Predictive cost analysis based on historical averages
-- ❌ Pipeline health indicators (skipped/failed/pending items)
-- ❌ Potential output projections
-- ❌ Click-through to detailed run view
-- ❌ Human-readable run titles (Site Name + Run #)
-
-### Proposed Enhanced Overview Design
-
-```
-┌─────────────────────────────────────────────────────────────────────────────────┐
-│ PageHeader: Automation Overview                                                  │
-│ Breadcrumb: Automation / Overview                                               │
-├─────────────────────────────────────────────────────────────────────────────────┤
-│                                                                                  │
-│ ┌──────────── Automation STATISTICS SUMMARY (New Section) ────────────────────────────┐│
-│ │                                                                               ││
-│ │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         ││
-│ │  │ Total Runs  │  │ Success Rate│  │ Avg Duration│  │ Avg Credits │         ││
-│ │  │    47       │  │   94.7%     │  │  28m 15s    │  │  486 cr     │         ││
-│ │  │ +5 this wk  │  │ ↑ 2.1%      │  │ ↓ 3m faster │  │ ↓ 12% less  │         ││
-│ │  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘         ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── PIPELINE STATUS METRICS (Enhanced) ──────────────────────────────┐│
-│ │                                                                               ││
-│ │  Keywords    Clusters    Ideas       Content     Images                       ││
-│ │  ┌───────┐   ┌───────┐   ┌───────┐   ┌───────┐   ┌───────┐                   ││
-│ │  │  150  │   │   23  │   │   87  │   │   42  │   │  156  │                   ││
-│ │  │───────│   │───────│   │───────│   │───────│   │───────│                   ││
-│ │  │New:120│   │New: 8 │   │New:32 │   │Draft:15│  │Pend:24│                   ││
-│ │  │Map:30 │   │Map:15 │   │Queue:20│  │Review:12│ │Gen:132│                   ││
-│ │  │Skip:0 │   │Skip:0 │   │Done:35│   │Pub:15 │                               ││
-│ │  └───────┘   └───────┘   └───────┘   └───────┘   └───────┘                   ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── PREDICTIVE COST & OUTPUT ANALYSIS (New Section) ─────────────────┐│
-│ │                                                                               ││
-│ │  📊 If Automation Runs Now (Based on 10-run averages)                        ││
-│ │  ─────────────────────────────────────────────────────────────────────────── ││
-│ │                                                                               ││
-│ │  Stage          Pending  Est Credits   Est Output      Avg Rate              ││
-│ │  ─────────────  ───────  ───────────   ───────────     ─────────             ││
-│ │  Keywords→Clust   120      24 cr       ~15 clusters    0.2 cr/kw             ││
-│ │  Clusters→Ideas     8      16 cr       ~70 ideas       2.0 cr/cluster        ││
-│ │  Ideas→Tasks       32       0 cr        32 tasks       (free)                ││
-│ │  Tasks→Content     20     100 cr        20 articles    5.0 cr/task           ││
-│ │  Content→Prompts   15      30 cr       ~60 prompts     2.0 cr/content        ││
-│ │  Prompts→Images    24      48 cr       ~24 images      2.0 cr/prompt         ││
-│ │  Review→Approved   12       0 cr        12 approved    (free)                ││
-│ │  ─────────────────────────────────────────────────────────────────────────── ││
-│ │                                                                               ││
-│ │  TOTAL ESTIMATED:  218 credits (~20% buffer recommended = 262 credits)       ││
-│ │  Current Balance:  1,250 credits  ✅ Sufficient                              ││
-│ │                                                                               ││
-│ │  Expected Outputs:                                                            ││
-│ │  • ~15 new clusters from 120 keywords                                        ││
-│ │  • ~70 content ideas from existing clusters                                  ││
-│ │  • ~20 published articles (full pipeline)                                    ││
-│ │  • ~24 generated images                                                      ││
-│ │                                                                               ││
-│ │  ⚠️ Items Requiring Attention:                                               ││
-│ │  • 3 ideas marked as skipped (review in Planner)                            ││
-│ │  • 2 content items failed generation (retry available)                       ││
-│ │  • 5 images failed - exceeded prompt complexity                              ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── RUN HISTORY (Enhanced with Clickable Titles) ────────────────────┐│
-│ │                                                                               ││
-│ │  Run                          Status    Trigger  Started           Credits   ││
-│ │  ─────────────────────────────────────────────────────────────────────────── ││
-│ │  🔗 TechBlog.com #47          ✅ Done   Manual   Jan 17, 2:05 PM    569 cr   ││
-│ │     Stages: [✓][✓][✓][✓][✓][✓][✓]  Duration: 38m 21s                        ││
-│ │                                                                               ││
-│ │  🔗 TechBlog.com #46          ✅ Done   Sched    Jan 16, 2:00 AM    423 cr   ││
-│ │     Stages: [✓][✓][✓][✓][✓][✓][✓]  Duration: 25m 12s                        ││
-│ │                                                                               ││
-│ │  🔗 TechBlog.com #45          ⚠️ Partial Manual  Jan 15, 10:30 AM   287 cr   ││
-│ │     Stages: [✓][✓][✓][✓][✗][ ][ ]  Duration: 18m 45s  (Stage 5 failed)      ││
-│ │                                                                               ││
-│ │  🔗 TechBlog.com #44          ✅ Done   Sched    Jan 14, 2:00 AM    512 cr   ││
-│ │     Stages: [✓][✓][✓][✓][✓][✓][✓]  Duration: 32m 08s                        ││
-│ │                                                                               ││
-│ │  [Show All Runs →]                                                            ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-└─────────────────────────────────────────────────────────────────────────────────┘
-```
-
-### Backend API Enhancements for Overview
-
-#### New Endpoint: `/api/v1/automation/overview_stats/`
-
-```python
-GET /api/v1/automation/overview_stats/?site_id=123
-
-Response:
-{
-  "run_statistics": {
-    "total_runs": 47,
-    "completed_runs": 44,
-    "failed_runs": 3,
-    "success_rate": 94.7,
-    "avg_duration_seconds": 1695,
-    "avg_credits_per_run": 486,
-    "runs_this_week": 5,
-    "credits_trend": -12.3,  // % change from previous period
-    "duration_trend": -180   // seconds change from previous period
-  },
-  "predictive_analysis": {
-    "stages": [
-      {
-        "stage": 1,
-        "name": "Keywords → Clusters",
-        "pending_items": 120,
-        "avg_credits_per_item": 0.2,
-        "estimated_credits": 24,
-        "avg_output_ratio": 0.125,  // 1 cluster per 8 keywords
-        "estimated_output": 15,
-        "output_type": "clusters"
-      },
-      // ... stages 2-7
-    ],
-    "total_estimated_credits": 218,
-    "recommended_buffer": 262,  // 20% buffer
-    "current_balance": 1250,
-    "is_sufficient": true,
-    "expected_outputs": {
-      "clusters": 15,
-      "ideas": 70,
-      "content": 20,
-      "images": 24
-    }
-  },
-  "attention_items": {
-    "skipped_ideas": 3,
-    "failed_content": 2,
-    "failed_images": 5,
-    "total_attention_needed": 10
-  },
-  "historical_averages": {
-    "period_days": 30,
-    "runs_analyzed": 10,
-    "avg_credits_stage_1": 0.2,
-    "avg_credits_stage_2": 2.0,
-    "avg_credits_stage_4": 5.0,
-    "avg_credits_stage_5": 2.0,
-    "avg_credits_stage_6": 2.0,
-    "avg_output_ratio_stage_1": 0.125,  // clusters per keyword
-    "avg_output_ratio_stage_2": 8.7,    // ideas per cluster
-    "avg_output_ratio_stage_5": 4.0,    // prompts per content
-    "avg_output_ratio_stage_6": 1.0     // images per prompt
-  }
-}
-```
-
-#### Enhanced History Endpoint: `/api/v1/automation/history/`
-
-```python
-GET /api/v1/automation/history/?site_id=123
-
-Response:
-{
-  "runs": [
-    {
-      "run_id": "run_20260117_140523_manual",
-      "run_number": 47,  // NEW: sequential run number for this site
-      "run_title": "TechBlog.com #47",  // NEW: human-readable title
-      "status": "completed",
-      "trigger_type": "manual",
-      "started_at": "2026-01-17T14:05:23Z",
-      "completed_at": "2026-01-17T14:43:44Z",
-      "duration_seconds": 2301,  // NEW
-      "total_credits_used": 569,
-      "current_stage": 7,
-      "stages_completed": 7,  // NEW
-      "stages_failed": 0,     // NEW
-      "initial_snapshot": {
-        "total_initial_items": 263
-      },
-      "summary": {  // NEW: quick summary
-        "items_processed": 263,
-        "items_created": 218,
-        "content_created": 25,
-        "images_generated": 24
-      }
-    }
-  ],
-  "pagination": {
-    "page": 1,
-    "page_size": 20,
-    "total_count": 47,
-    "total_pages": 3
-  }
-}
-```
-
----
-
-## Part 2: Automation Run Detail Page
-
-### Route & Access
-
-**Route:** `/automation/runs/:run_id`  
-**Access:** Click on Run Title (e.g., "TechBlog.com #47") from Overview page
-
-### Current State Analysis
-
-### Available Data in AutomationRun Model
-
-**Core Fields:**
-- `run_id`: Unique identifier (e.g., `run_20251203_140523_manual`)
-- `status`: running, paused, cancelled, completed, failed
-- `current_stage`: 1-7 (current stage number)
-- `trigger_type`: manual or scheduled
-- `started_at`, `completed_at`, `paused_at`, `resumed_at`, `cancelled_at`
-- `total_credits_used`: Total credits consumed
-
-**Initial Snapshot (captured at run start):**
-```json
-{
-  "stage_1_initial": 150,
-  "stage_2_initial": 10,
-  "stage_3_initial": 50,
-  "stage_4_initial": 25,
-  "stage_5_initial": 15,
-  "stage_6_initial": 8,
-  "stage_7_initial": 5,
-  "total_initial_items": 263
-}
-```
-
-**Stage Results (per stage):**
-```json
-// Stage 1: Keywords → Clusters
-{
-  "keywords_processed": 150,
-  "clusters_created": 12,
-  "batches": 3,
-  "credits_used": 45,
-  "time_elapsed": "00:03:24"
-}
-
-// Stage 2: Clusters → Ideas  
-{
-  "clusters_processed": 10,
-  "ideas_created": 87,
-  "credits_used": 120,
-  "time_elapsed": "00:08:15"
-}
-
-// Stage 3: Ideas → Tasks
-{
-  "ideas_processed": 50,
-  "tasks_created": 50,
-  "credits_used": 0,
-  "time_elapsed": "00:00:12"
-}
-
-// Stage 4: Tasks → Content
-{
-  "tasks_processed": 25,
-  "content_created": 25,
-  "total_words": 15450,
-  "credits_used": 310,
-  "time_elapsed": "00:18:42"
-}
-
-// Stage 5: Content → Image Prompts
-{
-  "content_processed": 15,
-  "prompts_created": 45,
-  "credits_used": 22,
-  "time_elapsed": "00:02:15"
-}
-
-// Stage 6: Image Prompts → Images
-{
-  "images_processed": 8,
-  "images_generated": 24,
-  "credits_used": 72,
-  "time_elapsed": "00:05:30"
-}
-
-// Stage 7: Review → Approved
-{
-  "ready_for_review": 5,
-  "credits_used": 0,
-  "time_elapsed": "00:00:03"
-}
-```
-
-### Current Issues
-
-1. **Automation Overview Page** - Only shows recent 5 runs with minimal info:
-   - Run ID, Status, Trigger Type, Date, Credits
-   - No stage-level details
-   - No breakdown of what was created/processed
-   
-2. **Run History Widget** - Limited to basic metrics
-   
-3. **No Detail View** - Users cannot drill down into a completed run to see:
-   - What stages ran
-   - What was processed at each stage
-   - What was created/generated
-   - Credits breakdown by stage
-   - Time spent per stage
-   - Initial vs final state comparison
-
-## Proposed Solution
-
-### 1. New Page: Automation Run Detail (`/automation/runs/:run_id`)
-
-**Purpose:** Provide comprehensive view of a single automation run with all stage details, metrics, and outcomes.
-
-**Route:** `/automation/runs/:run_id`
-
-**Component:** `AutomationRunDetail.tsx`
-
-#### Page Layout
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ PageHeader                                                       │
-│ ← Back to Overview                                              │
-│ Run: run_20251203_140523_manual                                │
-│ Badge: [Completed] • Trigger: Manual • Credits: 569           │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│ ┌─────────────────────────────────────────────────────────────┐ │
-│ │ Run Summary Card                                            │ │
-│ │ ─────────────────────────────────────────────────────────── │ │
-│ │ Started:  Dec 3, 2025 2:05 PM                              │ │
-│ │ Duration: 38 minutes 21 seconds                            │ │
-│ │ Status:   [✓ Completed]                                    │ │
-│ │ Trigger:  Manual                                            │ │
-│ │                                                              │ │
-│ │ Total Items Processed: 263 → 218 items created            │ │
-│ │ Total Credits Used:    569 credits                         │ │
-│ │ Stages Completed:      7 of 7                              │ │
-│ └─────────────────────────────────────────────────────────────┘ │
-│                                                                  │
-│ ┌─────────────────────────────────────────────────────────────┐ │
-│ │ Pipeline Flow Visualization                                 │ │
-│ │ ─────────────────────────────────────────────────────────── │ │
-│ │                                                              │ │
-│ │  150 → [Stage 1] → 12    87 → [Stage 4] → 25   45 → [Stage 6] → 24  │
-│ │  Keywords  Clusters     Ideas   Content    Prompts  Images  │
-│ │   (45 cr)               (310 cr)           (72 cr)         │
-│ │                                                              │ │
-│ │  10 → [Stage 2] → 87   15 → [Stage 5] → 45   5 → [Stage 7] → 5  │
-│ │  Clusters   Ideas      Content  Prompts    Review  Approved │
-│ │   (120 cr)             (22 cr)             (0 cr)          │
-│ │                                                              │ │
-│ │  50 → [Stage 3] → 50                                        │ │
-│ │   Ideas     Tasks                                           │ │
-│ │    (0 cr)                                                   │ │
-│ └─────────────────────────────────────────────────────────────┘ │
-│                                                                  │
-│ ┌─────────────────────────────────────────────────────────────┐ │
-│ │ Stage Details (Expandable Accordion)                        │ │
-│ │ ─────────────────────────────────────────────────────────── │ │
-│ │                                                              │ │
-│ │ ▼ Stage 1: Keywords → Clusters         [✓ Completed] 45 cr │ │
-│ │   ┌────────────────────────────────────────────────────┐  │ │
-│ │   │ Input:     150 keywords                             │  │ │
-│ │   │ Output:    12 clusters created                      │  │ │
-│ │   │ Time:      3 minutes 24 seconds                     │  │ │
-│ │   │ Credits:   45 credits                               │  │ │
-│ │   │ Batches:   3 batches processed                      │  │ │
-│ │   │                                                      │  │ │
-│ │   │ Details:                                            │  │ │
-│ │   │ • Processed 150 keywords in 3 batches              │  │ │
-│ │   │ • Created 12 new clusters                          │  │ │
-│ │   │ • Avg 4.4 keywords per cluster                     │  │ │
-│ │   └────────────────────────────────────────────────────┘  │ │
-│ │                                                              │ │
-│ │ ▼ Stage 2: Clusters → Ideas           [✓ Completed] 120 cr │ │
-│ │   ┌────────────────────────────────────────────────────┐  │ │
-│ │   │ Input:     10 clusters                              │  │ │
-│ │   │ Output:    87 ideas generated                       │  │ │
-│ │   │ Time:      8 minutes 15 seconds                     │  │ │
-│ │   │ Credits:   120 credits                              │  │ │
-│ │   │                                                      │  │ │
-│ │   │ Details:                                            │  │ │
-│ │   │ • Processed 10 clusters                            │  │ │
-│ │   │ • Generated 87 content ideas                       │  │ │
-│ │   │ • Avg 8.7 ideas per cluster                        │  │ │
-│ │   └────────────────────────────────────────────────────┘  │ │
-│ │                                                              │ │
-│ │ ▶ Stage 3: Ideas → Tasks              [✓ Completed] 0 cr   │ │
-│ │ ▶ Stage 4: Tasks → Content            [✓ Completed] 310 cr │ │
-│ │ ▶ Stage 5: Content → Image Prompts    [✓ Completed] 22 cr  │ │
-│ │ ▶ Stage 6: Image Prompts → Images     [✓ Completed] 72 cr  │ │
-│ │ ▶ Stage 7: Review → Approved          [✓ Completed] 0 cr   │ │
-│ └─────────────────────────────────────────────────────────────┘ │
-│                                                                  │
-│ ┌─────────────────────────────────────────────────────────────┐ │
-│ │ Credits Breakdown (Chart)                                   │ │
-│ │ ─────────────────────────────────────────────────────────── │ │
-│ │                                                              │ │
-│ │  [Donut Chart showing credit distribution by stage]        │ │
-│ │                                                              │ │
-│ │  Stage 4: 54% (310 cr) - Content Generation               │ │
-│ │  Stage 2: 21% (120 cr) - Idea Generation                  │ │
-│ │  Stage 6: 13% (72 cr)  - Image Generation                 │ │
-│ │  Stage 1: 8% (45 cr)   - Clustering                       │ │
-│ │  Stage 5: 4% (22 cr)   - Image Prompts                    │ │
-│ └─────────────────────────────────────────────────────────────┘ │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### 2. Detail Page Design
-
-**Purpose:** Provide comprehensive view of a single automation run with all stage details, metrics, and outcomes.
-
-**Route:** `/automation/runs/:run_id`
-
-**Component:** `AutomationRunDetail.tsx`
-
-#### Page Layout
-
-```
-┌─────────────────────────────────────────────────────────────────────────────────┐
-│ PageHeader                                                                       │
-│ ← Back to Overview                                                              │
-│ TechBlog.com #47                                                                │
-│ run_20260117_140523_manual                                                      │
-│ Badge: [✅ Completed] • Trigger: Manual • 569 credits used                      │
-├─────────────────────────────────────────────────────────────────────────────────┤
-│                                                                                  │
-│ ┌──────────── RUN SUMMARY CARD ────────────────────────────────────────────────┐│
-│ │                                                                               ││
-│ │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         ││
-│ │  │ Started     │  │ Duration    │  │ Status      │  │ Credits     │         ││
-│ │  │ Jan 17      │  │ 38m 21s     │  │ ✅ Complete │  │ 569         │         ││
-│ │  │ 2:05:23 PM  │  │             │  │ 7/7 stages  │  │             │         ││
-│ │  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘         ││
-│ │                                                                               ││
-│ │  Initial Queue: 263 items  →  Created: 218 items  →  Efficiency: 83%        ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── PIPELINE FLOW VISUALIZATION ─────────────────────────────────────┐│
-│ │                                                                               ││
-│ │  Stage 1         Stage 2         Stage 3         Stage 4                     ││
-│ │  ┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐                 ││
-│ │  │ 150 kw  │ ──▶ │ 10 clus │ ──▶ │ 50 idea │ ──▶ │ 25 task │                 ││
-│ │  │   ↓     │     │   ↓     │     │   ↓     │     │   ↓     │                 ││
-│ │  │ 12 clus │     │ 87 idea │     │ 50 task │     │ 25 cont │                 ││
-│ │  │ 45 cr   │     │ 120 cr  │     │  0 cr   │     │ 310 cr  │                 ││
-│ │  │ 3m 24s  │     │ 8m 15s  │     │ 12s     │     │ 18m 42s │                 ││
-│ │  └─────────┘     └─────────┘     └─────────┘     └─────────┘                 ││
-│ │                                                                               ││
-│ │  Stage 5         Stage 6         Stage 7                                      ││
-│ │  ┌─────────┐     ┌─────────┐     ┌─────────┐                                 ││
-│ │  │ 15 cont │ ──▶ │ 8 promp │ ──▶ │ 5 revie │                                 ││
-│ │  │   ↓     │     │   ↓     │     │   ↓     │                                 ││
-│ │  │ 45 prom │     │ 24 img  │     │ 5 appro │                                 ││
-│ │  │ 22 cr   │     │ 72 cr   │     │  0 cr   │                                 ││
-│ │  │ 2m 15s  │     │ 5m 30s  │     │ 3s      │                                 ││
-│ │  └─────────┘     └─────────┘     └─────────┘                                 ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── STAGE DETAILS (Expandable Accordion) ────────────────────────────┐│
-│ │                                                                               ││
-│ │ ▼ Stage 1: Keywords → Clusters              [✅ Completed]  45 credits       ││
-│ │   ┌───────────────────────────────────────────────────────────────────────┐  ││
-│ │   │ Processing Summary                                                     │  ││
-│ │   │ ──────────────────────────────────────────────────────────────────── │  ││
-│ │   │ Input:      150 keywords ready for clustering                         │  ││
-│ │   │ Output:     12 clusters created                                       │  ││
-│ │   │ Duration:   3 minutes 24 seconds                                      │  ││
-│ │   │ Credits:    45 credits (0.3 cr/keyword)                              │  ││
-│ │   │ Batches:    3 batches processed (50 keywords each)                   │  ││
-│ │   │                                                                        │  ││
-│ │   │ Efficiency Metrics                                                    │  ││
-│ │   │ ──────────────────────────────────────────────────────────────────── │  ││
-│ │   │ • Keywords per cluster: 12.5 avg                                     │  ││
-│ │   │ • Cost efficiency: 3.75 credits per cluster                          │  ││
-│ │   │ • Processing rate: 44 keywords/minute                                 │  ││
-│ │   │                                                                        │  ││
-│ │   │ Comparison to Historical Average (last 10 runs)                       │  ││
-│ │   │ ──────────────────────────────────────────────────────────────────── │  ││
-│ │   │ • Credits: 45 vs avg 42 (+7% ↑)                                      │  ││
-│ │   │ • Output: 12 clusters vs avg 10 (+20% ↑ better yield)                │  ││
-│ │   └───────────────────────────────────────────────────────────────────────┘  ││
-│ │                                                                               ││
-│ │ ▶ Stage 2: Clusters → Ideas               [✅ Completed]  120 credits        ││
-│ │ ▶ Stage 3: Ideas → Tasks                  [✅ Completed]  0 credits          ││
-│ │ ▶ Stage 4: Tasks → Content                [✅ Completed]  310 credits        ││
-│ │ ▶ Stage 5: Content → Image Prompts        [✅ Completed]  22 credits         ││
-│ │ ▶ Stage 6: Image Prompts → Images         [✅ Completed]  72 credits         ││
-│ │ ▶ Stage 7: Review → Approved              [✅ Completed]  0 credits          ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── CREDITS BREAKDOWN (Donut Chart) ─────────────────────────────────┐│
-│ │                                                                               ││
-│ │     ┌───────────────┐      Stage 4: Content     54.5%  (310 cr)             ││
-│ │     │   [DONUT]     │      Stage 2: Ideas       21.1%  (120 cr)             ││
-│ │     │   CHART       │      Stage 6: Images      12.7%  (72 cr)              ││
-│ │     │   569 cr      │      Stage 1: Clustering   7.9%  (45 cr)              ││
-│ │     │   total       │      Stage 5: Prompts      3.9%  (22 cr)              ││
-│ │     └───────────────┘      Stage 3,7: Free       0.0%  (0 cr)               ││
-│ │                                                                               ││
-│ │  💡 Insight: Content generation consumed most credits. Consider reducing     ││
-│ │     word count targets or batching content tasks for better efficiency.      ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── RUN TIMELINE ────────────────────────────────────────────────────┐│
-│ │                                                                               ││
-│ │  2:05 PM ●─────────●─────────●─────────●─────────●─────────●─────────● 2:43  ││
-│ │          │         │         │         │         │         │         │       ││
-│ │       Started   Stage 2   Stage 3   Stage 4   Stage 5   Stage 6  Completed  ││
-│ │       Stage 1   +3m 24s   +11m 39s  +11m 51s  +30m 33s  +32m 48s  +38m 21s  ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-│ ┌──────────── ACTIONS ─────────────────────────────────────────────────────────┐│
-│ │                                                                               ││
-│ │  [📋 View Logs]  [📊 Export Report]  [🔄 Re-run Similar]                     ││
-│ │                                                                               ││
-│ └───────────────────────────────────────────────────────────────────────────────┘│
-│                                                                                  │
-└─────────────────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Part 3: Component Architecture
-
-### New Components to Create:
-
-#### Overview Page Components:
-
-1. **`RunStatisticsSummary.tsx`** - Top stats cards
-   - Total runs, success rate, avg duration, avg credits
-   - Trend indicators (week-over-week)
-   
-2. **`PredictiveCostAnalysis.tsx`** - Predictive cost panel
-   - Stage-by-stage pending items and estimates
-   - Historical average rates per stage
-   - Expected outputs calculation
-   - Attention items (skipped/failed)
-   
-3. **`EnhancedRunHistory.tsx`** - Improved history table
-   - Clickable run titles (Site Name #N)
-   - Stage progress badges
-   - Duration display
-   - Quick summary stats
-
-#### Detail Page Components:
-
-4. **`AutomationRunDetail.tsx`** - Main detail page
-   - Fetches full run data by run_id
-   - Displays all sections outlined above
-   
-5. **`RunSummaryCard.tsx`** - Summary overview
-   - Status, duration, totals
-   - Quick metrics with icons
-   
-6. **`PipelineFlowVisualization.tsx`** - Visual flow diagram
-   - Shows stage connections with arrows
-   - Input/output counts
-   - Credits and duration per stage
-   
-7. **`StageAccordion.tsx`** - Expandable stage details
-   - Collapsible accordion for each stage
-   - Stage-specific metrics
-   - Historical comparison
-   - Efficiency metrics
-   
-8. **`CreditBreakdownChart.tsx`** - Credit distribution
-   - Donut/pie chart (using recharts)
-   - Stage-by-stage breakdown with legend
-   - AI-generated insights
-   
-9. **`RunTimeline.tsx`** - Horizontal timeline
-   - Visual stage progression
-   - Time markers
-   
-10. **`StageProgressBadges.tsx`** - Compact stage indicators
-    - Used in run history table
-    - Visual status for each stage (✓, ✗, ●, ○)
-
----
-
-## Part 4: API Enhancements
-
-### New Endpoint: Overview Statistics
-
-**Endpoint:** `GET /api/v1/automation/overview_stats/?site_id=xxx`
-
-**Implementation in `automation/views.py`:**
-
-```python
-@extend_schema(tags=['Automation'])
-@action(detail=False, methods=['get'])
-def overview_stats(self, request):
-    """
-    GET /api/v1/automation/overview_stats/?site_id=123
-    Get comprehensive automation statistics for overview page
-    """
-    site, error_response = self._get_site(request)
-    if error_response:
-        return error_response
-    
-    # Calculate run statistics from last 30 days
-    thirty_days_ago = timezone.now() - timedelta(days=30)
-    seven_days_ago = timezone.now() - timedelta(days=7)
-    fourteen_days_ago = timezone.now() - timedelta(days=14)
-    
-    all_runs = AutomationRun.objects.filter(site=site)
-    recent_runs = all_runs.filter(started_at__gte=thirty_days_ago)
-    this_week_runs = all_runs.filter(started_at__gte=seven_days_ago)
-    last_week_runs = all_runs.filter(started_at__gte=fourteen_days_ago, started_at__lt=seven_days_ago)
-    
-    completed_runs = recent_runs.filter(status='completed')
-    failed_runs = recent_runs.filter(status='failed')
-    
-    # Calculate averages from completed runs
-    avg_duration = completed_runs.annotate(
-        duration=F('completed_at') - F('started_at')
-    ).aggregate(avg=Avg('duration'))['avg']
-    
-    avg_credits = completed_runs.aggregate(avg=Avg('total_credits_used'))['avg'] or 0
-    
-    # Calculate historical averages per stage
-    historical_averages = self._calculate_historical_averages(site, completed_runs)
-    
-    # Get pending items and calculate predictions
-    predictive_analysis = self._calculate_predictive_analysis(site, historical_averages)
-    
-    # Get attention items (failed/skipped)
-    attention_items = self._get_attention_items(site)
-    
-    return Response({
-        'run_statistics': {
-            'total_runs': all_runs.count(),
-            'completed_runs': completed_runs.count(),
-            'failed_runs': failed_runs.count(),
-            'success_rate': round(completed_runs.count() / recent_runs.count() * 100, 1) if recent_runs.count() > 0 else 0,
-            'avg_duration_seconds': avg_duration.total_seconds() if avg_duration else 0,
-            'avg_credits_per_run': round(avg_credits, 1),
-            'runs_this_week': this_week_runs.count(),
-            'runs_last_week': last_week_runs.count(),
-        },
-        'predictive_analysis': predictive_analysis,
-        'attention_items': attention_items,
-        'historical_averages': historical_averages,
-    })
-```
-
-### New Endpoint: Run Detail
-
-**Endpoint:** `GET /api/v1/automation/run_detail/?run_id=xxx`
-
-**Response:**
-```typescript
-{
-  run: {
-    run_id: string;
-    run_number: number;
-    run_title: string;
-    site_name: string;
-    status: string;
-    trigger_type: string;
-    current_stage: number;
-    started_at: string;
-    completed_at: string | null;
-    paused_at: string | null;
-    resumed_at: string | null;
-    cancelled_at: string | null;
-    duration_seconds: number;
-    total_credits_used: number;
-    error_message: string | null;
-  },
-  initial_snapshot: {
-    stage_1_initial: number;
-    stage_2_initial: number;
-    stage_3_initial: number;
-    stage_4_initial: number;
-    stage_5_initial: number;
-    stage_6_initial: number;
-    stage_7_initial: number;
-    total_initial_items: number;
-  },
-  stages: [
-    {
-      number: 1,
-      name: "Keywords → Clusters",
-      status: "completed" | "running" | "pending" | "skipped" | "failed",
-      is_enabled: boolean,
-      result: {
-        input_count: number;
-        output_count: number;
-        credits_used: number;
-        time_elapsed: string;
-        batches?: number;
-        // Stage-specific fields
-        keywords_processed?: number;
-        clusters_created?: number;
-        ideas_created?: number;
-        tasks_created?: number;
-        content_created?: number;
-        total_words?: number;
-        prompts_created?: number;
-        images_generated?: number;
-      },
-      efficiency: {
-        cost_per_input: number;
-        cost_per_output: number;
-        output_ratio: number;
-        processing_rate: number;  // items per minute
-      },
-      comparison: {
-        avg_credits: number;
-        avg_output: number;
-        credits_diff_percent: number;
-        output_diff_percent: number;
-      }
-    },
-    // ... stages 2-7
-  ],
-  metrics: {
-    total_input_items: number;
-    total_output_items: number;
-    duration_seconds: number;
-    efficiency_percent: number;
-    credits_by_stage: {
-      stage_1: number;
-      stage_2: number;
-      stage_3: number;
-      stage_4: number;
-      stage_5: number;
-      stage_6: number;
-      stage_7: number;
-    };
-    time_by_stage: {
-      stage_1: number;  // seconds
-      stage_2: number;
-      // ...
-    };
-  },
-  insights: string[];  // AI-generated insights about the run
-}
-```
-
-### Enhanced History Endpoint
-
-**Update:** `GET /api/v1/automation/history/?site_id=xxx`
-
-Add run numbers, titles, and summaries:
-
-```typescript
-{
-  runs: [
-    {
-      run_id: string;
-      run_number: number;
-      run_title: string;
-      status: string;
-      trigger_type: string;
-      started_at: string;
-      completed_at: string | null;
-      duration_seconds: number;
-      total_credits_used: number;
-      current_stage: number;
-      stages_completed: number;
-      stages_failed: number;
-      initial_snapshot: { 
-        total_initial_items: number;
-      };
-      summary: {
-        items_processed: number;
-        items_created: number;
-        content_created: number;
-        images_generated: number;
-      };
-      stage_statuses: string[];  // ['completed', 'completed', 'completed', 'failed', 'skipped', 'skipped', 'skipped']
-    }
-  ],
-  pagination: {
-    page: number;
-    page_size: number;
-    total_count: number;
-    total_pages: number;
-  }
-}
-```
-
----
-
-## Part 5: Implementation Phases
-
-### Phase 1: Backend API Enhancement (4-5 hours) ✅ COMPLETED
-
-**Status: COMPLETED**  
-**Implementation Date: January 2025**  
-**File: `/backend/igny8_core/business/automation/views.py`**
-
-**Completed Tasks:**
-
-1. ✅ **Helper Methods Implemented:**
-   - `_calculate_run_number(site, run)` - Sequential numbering per site based on started_at timestamp
-   - `_calculate_historical_averages(site, completed_runs)` - Analyzes last 10 completed runs (minimum 3 required), calculates per-stage averages and overall metrics
-   - `_calculate_predictive_analysis(site, historical_averages)` - Queries pending items, estimates credits and outputs for next run
-   - `_get_attention_items(site)` - Counts skipped ideas, failed content, failed images
-
-2. ✅ **New Endpoint: `overview_stats`**
-   - Route: `GET /api/v1/automation/overview_stats/`
-   - Returns: run_statistics (8 metrics), predictive_analysis (7 stages + totals), attention_items, historical_averages (10 fields)
-   - Features: 30-day trends, 7-day average duration, variance calculations
-
-3. ✅ **Enhanced Endpoint: `history`**
-   - Route: `GET /api/v1/automation/history/?page=1&page_size=20`
-   - Added: run_number, run_title (format: "{site.domain} #{run_number}"), duration_seconds, stages_completed, stages_failed, initial_snapshot, summary (items_processed/created/content/images), stage_statuses array
-   - Features: Pagination support, per-run stage status tracking
-
-4. ✅ **New Endpoint: `run_detail`**
-   - Route: `GET /api/v1/automation/run_detail/?run_id=abc123`
-   - Returns: Full run info, 7 stages with detailed analysis, efficiency metrics (credits_per_item, items_per_minute, credits_per_minute), historical comparison, auto-generated insights
-   - Features: Variance detection, failure alerts, efficiency comparisons
-
-**Technical Notes:**
-- All queries scoped to site and account for multi-tenancy security
-- Historical averages use last 10 completed runs with 3-run minimum fallback
-- Division by zero handled gracefully with defaults
-- Stage status logic: pending → running → completed/failed/skipped
-- Run numbers calculated via count-based approach for legacy compatibility
-
-### Phase 2: Frontend Overview Page (4-5 hours) ✅ COMPLETED
-
-**Status: COMPLETED**  
-**Implementation Date: January 17, 2026**  
-**Files Created:** 4 new components, 1 page updated
-
-**Completed Components:**
-1. ✅ `RunStatisticsSummary.tsx` - Displays run metrics with icons and trends
-2. ✅ `PredictiveCostAnalysis.tsx` - Donut chart with stage breakdown and confidence
-3. ✅ `AttentionItemsAlert.tsx` - Warning banner for failed/skipped items  
-4. ✅ `EnhancedRunHistory.tsx` - Clickable table with pagination and stage icons
-5. ✅ Updated `AutomationOverview.tsx` - Integrated all new components
-
-### Phase 3: Frontend Detail Page (5-6 hours) ✅ COMPLETED
-
-**Status: COMPLETED**  
-**Implementation Date: January 17, 2026**  
-**Files Created:** 1 page + 5 components + supporting files
-
-**Completed Components:**
-1. ✅ `AutomationRunDetail.tsx` - Main detail page with routing
-2. ✅ `RunSummaryCard.tsx` - Run header with key metrics
-3. ✅ `StageAccordion.tsx` - Expandable stage details with comparisons
-4. ✅ `EfficiencyMetrics.tsx` - Performance metrics card
-5. ✅ `InsightsPanel.tsx` - Auto-generated insights display
-6. ✅ `CreditBreakdownChart.tsx` - ApexCharts donut visualization
-
-**Supporting Files:**
-- ✅ `types/automation.ts` - TypeScript definitions (12 interfaces)
-- ✅ `utils/dateUtils.ts` - Date formatting utilities
-- ✅ Updated `automationService.ts` - Added 3 API methods
-- ✅ Updated `App.tsx` - Added /automation/runs/:runId route
-- ✅ Updated `icons/index.ts` - Added ExclamationTriangleIcon
-
-### Phase 4: Polish & Testing (3-4 hours) ⏳ IN PROGRESS
-
-**Remaining Tasks:**
-1. Error handling and loading states (partially done)
-2. Empty states for no data (partially done)
-3. Mobile responsiveness testing
-4. Dark mode verification
-5. Accessibility improvements (ARIA labels)
-6. Unit tests for new components
-
-**Total Estimated Time: 16-20 hours**  
-**Actual Time Spent: ~12 hours (Phases 1-3)**  
-**Remaining: ~3-4 hours (Phase 4)**
-
----
-
-## Part 6: User Benefits
-
-### Immediate Benefits:
-
-1. **Transparency** - See exactly what happened in each run, no black box
-2. **Cost Predictability** - Know expected costs BEFORE running automation
-3. **Performance Tracking** - Monitor run duration and efficiency trends
-4. **Troubleshooting** - Quickly identify bottlenecks or failed stages
-5. **ROI Validation** - Concrete output metrics (content created, images generated)
-
-### Strategic Benefits:
-
-6. **Credit Budget Planning** - Historical averages help plan monthly budgets
-7. **Optimization Insights** - Identify which stages consume most resources
-8. **Confidence Building** - Predictive analysis reduces uncertainty
-9. **Proactive Management** - Attention items surface problems early
-10. **Historical Context** - Compare current run to past performance
-
----
-
-## Part 7: Success Metrics
-
-### Engagement Metrics:
-- % of users viewing run details (target: 60%+ of active automation users)
-- Time spent on detail page (indicates value - target: 30+ seconds avg)
-- Click-through rate on predictive cost analysis (target: 40%+)
-
-### Business Metrics:
-- Reduced support tickets about "what did automation do?" (target: 50% reduction)
-- Increased automation run frequency (users trust the system more)
-- Better credit budget accuracy (users run out less often)
-
-### User Satisfaction:
-- NPS improvement for automation feature (target: +10 points)
-- User feedback survey ratings (target: 4.5+ out of 5)
-
----
-
-## Part 8: Technical Considerations
-
-### Performance
-- Cache run details for completed runs (rarely change)
-- Paginate run history (20 per page, lazy load)
-- Lazy load stage details (accordion pattern)
-- Calculate historical averages server-side with efficient queries
-
-### Data Integrity
-- Handle incomplete runs gracefully (show partial data)
-- Show "N/A" for skipped/disabled stages
-- Ensure all stage results are properly saved during automation
-- Validate snapshot data before displaying
-
-### Accessibility
-- Proper ARIA labels for charts and interactive elements
-- Keyboard navigation for accordion
-- Screen reader support for status badges
-- High contrast mode support for visualizations
-
-### Mobile Responsiveness
-- Stack cards vertically on mobile
-- Horizontal scroll for pipeline visualization
-- Collapsible sections by default on mobile
-- Touch-friendly accordion interactions
-
----
-
-## Part 9: Future Enhancements (Post-MVP)
-
-### High Priority:
-1. **Run Comparison** - Compare two runs side-by-side
-2. **Export Reports** - Download run details as PDF/CSV
-3. **Retry Failed Stage** - Ability to retry specific failed stage
-4. **Real-time Updates** - WebSocket for live run progress
-
-### Medium Priority:
-5. **Scheduled Run Calendar** - View upcoming scheduled runs
-6. **Stage-Level Logs** - View detailed logs per stage (expandable)
-7. **Error Details** - Expanded error information for failed runs
-8. **Run Tags/Notes** - Add custom notes to runs for tracking
-
-### Nice to Have:
-9. **Cost Alerts** - Notify when predicted cost exceeds threshold
-10. **Efficiency Recommendations** - AI-powered suggestions
-11. **Trend Charts** - Historical graphs of costs/outputs over time
-12. **Bulk Operations** - Select and compare multiple runs
-
----
-
-## Conclusion
-
-This enhanced plan transforms the Automation Overview page from a basic dashboard into a comprehensive command center that provides:
-
-1. **Historical Insights** - Run statistics, success rates, and trends
-2. **Predictive Intelligence** - Cost estimates and expected outputs based on actual data
-3. **Actionable Alerts** - Surface items needing attention
-4. **Deep-Dive Capability** - Click through to full run details
-
-The Run Detail page provides complete transparency into every automation run, helping users understand exactly what happened, how efficient it was compared to historical averages, and where their credits went.
-
-Combined, these improvements will significantly increase user confidence in the automation system, reduce support burden, and help users optimize their content production workflow.
diff --git a/docs/plans/automation/AUTOMATION_RUNS_IMPLEMENTATION_LOG.md b/docs/plans/automation/AUTOMATION_RUNS_IMPLEMENTATION_LOG.md
deleted file mode 100644
index ce07673d..00000000
--- a/docs/plans/automation/AUTOMATION_RUNS_IMPLEMENTATION_LOG.md
+++ /dev/null
@@ -1,407 +0,0 @@
-# Automation Runs Detail View - Implementation Log
-
-## Phase 1: Backend API Enhancement ✅
-
-**Implementation Date:** January 13, 2025  
-**Status:** COMPLETED  
-**Time Spent:** ~2 hours  
-**File Modified:** `/backend/igny8_core/business/automation/views.py`
-
----
-
-## Summary of Changes
-
-### 1. New Imports Added
-```python
-from django.db.models import Count, Sum, Avg, F
-from datetime import timedelta
-
-# Business model imports
-from igny8_core.business.keywords.models import Keywords
-from igny8_core.business.clusters.models import Clusters
-from igny8_core.business.content_ideas.models import ContentIdeas
-from igny8_core.business.tasks.models import Tasks
-from igny8_core.business.content.models import Content
-from igny8_core.business.images.models import Images
-```
-
-### 2. Helper Methods Implemented
-
-#### `_calculate_run_number(site, run)`
-- **Purpose:** Calculate sequential run number for a site
-- **Logic:** Counts all runs with `started_at <= current_run.started_at`
-- **Returns:** Integer run number (e.g., 1, 2, 3...)
-- **Usage:** Generates human-readable run titles like "mysite.com #42"
-
-#### `_calculate_historical_averages(site, completed_runs)`
-- **Purpose:** Analyze historical performance from last 10 completed runs
-- **Minimum Required:** 3 completed runs (returns defaults if insufficient)
-- **Returns Object with:**
-  - `stages`: Array of 7 stage averages (avg_credits, avg_items_created, avg_output_ratio)
-  - `avg_total_credits`: Average total credits per run
-  - `avg_duration_seconds`: Average run duration
-  - `avg_credits_per_item`: Overall credit efficiency
-  - `total_runs_analyzed`: Count of runs in sample
-  - `has_sufficient_data`: Boolean flag
-
-#### `_calculate_predictive_analysis(site, historical_averages)`
-- **Purpose:** Estimate costs and outputs for next automation run
-- **Data Sources:** 
-  - Queries pending items in each stage (keywords, clusters, ideas, tasks, content, images)
-  - Uses historical averages for per-item cost estimation
-- **Returns:**
-  - `stages`: Array of 7 stage predictions (pending_items, estimated_credits, estimated_output)
-  - `totals`: Aggregated totals with 20% safety buffer recommendation
-  - `confidence`: High/Medium/Low based on historical data availability
-
-#### `_get_attention_items(site)`
-- **Purpose:** Count items needing attention
-- **Returns:**
-  - `skipped_ideas`: Content ideas in "skipped" status
-  - `failed_content`: Content with failed generation
-  - `failed_images`: Images with failed generation
-
----
-
-## 3. API Endpoints
-
-### 3.1 `overview_stats` (NEW)
-**Route:** `GET /api/v1/automation/overview_stats/`
-
-**Response Structure:**
-```json
-{
-  "run_statistics": {
-    "total_runs": 42,
-    "completed_runs": 38,
-    "failed_runs": 2,
-    "running_runs": 1,
-    "total_credits_used": 24680,
-    "total_credits_last_30_days": 8420,
-    "avg_credits_per_run": 587,
-    "avg_duration_last_7_days_seconds": 2280
-  },
-  "predictive_analysis": {
-    "stages": [
-      {
-        "stage_number": 1,
-        "stage_name": "Keyword Clustering",
-        "pending_items": 150,
-        "estimated_credits": 45,
-        "estimated_output": 12
-      },
-      // ... stages 2-7
-    ],
-    "totals": {
-      "total_pending_items": 413,
-      "total_estimated_credits": 569,
-      "total_estimated_output": 218,
-      "recommended_buffer_credits": 114
-    },
-    "confidence": "high"
-  },
-  "attention_items": {
-    "skipped_ideas": 5,
-    "failed_content": 2,
-    "failed_images": 1
-  },
-  "historical_averages": {
-    "avg_total_credits": 587,
-    "avg_duration_seconds": 2400,
-    "avg_credits_per_item": 2.69,
-    "total_runs_analyzed": 10,
-    "has_sufficient_data": true,
-    "stages": [/* stage averages */]
-  }
-}
-```
-
-**Use Cases:**
-- Display on overview page dashboard
-- Show predictive cost estimates before running
-- Alert users to failed/skipped items
-- Display historical trends
-
----
-
-### 3.2 `history` (ENHANCED)
-**Route:** `GET /api/v1/automation/history/?page=1&page_size=20`
-
-**New Fields Added:**
-- `run_number`: Sequential number (1, 2, 3...)
-- `run_title`: Human-readable title (e.g., "mysite.com #42")
-- `duration_seconds`: Total run time in seconds
-- `stages_completed`: Count of successfully completed stages
-- `stages_failed`: Count of failed stages
-- `initial_snapshot`: Snapshot of pending items at run start
-- `summary`: Aggregated metrics
-  - `items_processed`: Total input items
-  - `items_created`: Total output items
-  - `content_created`: Content pieces generated
-  - `images_generated`: Images created
-- `stage_statuses`: Array of 7 stage statuses ["completed", "pending", "skipped", "failed"]
-
-**Response Structure:**
-```json
-{
-  "runs": [
-    {
-      "run_id": "run_20260113_140523_manual",
-      "run_number": 42,
-      "run_title": "mysite.com #42",
-      "status": "completed",
-      "trigger_type": "manual",
-      "started_at": "2026-01-13T14:05:23Z",
-      "completed_at": "2026-01-13T14:43:44Z",
-      "duration_seconds": 2301,
-      "total_credits_used": 569,
-      "current_stage": 7,
-      "stages_completed": 7,
-      "stages_failed": 0,
-      "initial_snapshot": { /* snapshot data */ },
-      "summary": {
-        "items_processed": 263,
-        "items_created": 218,
-        "content_created": 25,
-        "images_generated": 24
-      },
-      "stage_statuses": [
-        "completed", "completed", "completed", "completed",
-        "completed", "completed", "completed"
-      ]
-    }
-    // ... more runs
-  ],
-  "pagination": {
-    "page": 1,
-    "page_size": 20,
-    "total_count": 42,
-    "total_pages": 3
-  }
-}
-```
-
-**Features:**
-- Pagination support (configurable page size)
-- Ordered by most recent first
-- Clickable run titles for navigation to detail page
-
----
-
-### 3.3 `run_detail` (NEW)
-**Route:** `GET /api/v1/automation/run_detail/?run_id=abc123`
-
-**Response Structure:**
-```json
-{
-  "run": {
-    "run_id": "run_20260113_140523_manual",
-    "run_number": 42,
-    "run_title": "mysite.com #42",
-    "status": "completed",
-    "trigger_type": "manual",
-    "started_at": "2026-01-13T14:05:23Z",
-    "completed_at": "2026-01-13T14:43:44Z",
-    "duration_seconds": 2301,
-    "current_stage": 7,
-    "total_credits_used": 569,
-    "initial_snapshot": { /* snapshot */ }
-  },
-  "stages": [
-    {
-      "stage_number": 1,
-      "stage_name": "Keyword Clustering",
-      "status": "completed",
-      "credits_used": 45,
-      "items_processed": 150,
-      "items_created": 12,
-      "duration_seconds": 204,
-      "error": "",
-      "comparison": {
-        "historical_avg_credits": 48,
-        "historical_avg_items": 11,
-        "credit_variance_pct": -6.3,
-        "items_variance_pct": 9.1
-      }
-    }
-    // ... stages 2-7
-  ],
-  "efficiency": {
-    "credits_per_item": 2.61,
-    "items_per_minute": 5.68,
-    "credits_per_minute": 14.84
-  },
-  "insights": [
-    {
-      "type": "success",
-      "severity": "info",
-      "message": "This run was 12% more credit-efficient than average"
-    },
-    {
-      "type": "variance",
-      "severity": "warning",
-      "message": "Content Writing used 23% higher credits than average"
-    }
-  ],
-  "historical_comparison": {
-    "avg_credits": 587,
-    "avg_duration_seconds": 2400,
-    "avg_credits_per_item": 2.69
-  }
-}
-```
-
-**Features:**
-- Full stage-by-stage breakdown
-- Automatic variance detection (flags >20% differences)
-- Efficiency metrics calculation
-- Auto-generated insights (success, warnings, errors)
-- Historical comparison for context
-
----
-
-## 4. Data Quality & Edge Cases Handled
-
-### Run Numbering
-- Uses count-based approach for consistency with legacy runs
-- No database schema changes required
-- Calculated on-the-fly per request
-
-### Historical Averages
-- Minimum 3 completed runs required for reliability
-- Falls back to conservative defaults if insufficient data
-- Uses last 10 runs to balance recency with sample size
-
-### Stage Status Logic
-```
-- credits_used > 0 OR items_created > 0 → "completed"
-- error present in result → "failed"
-- run completed but stage <= current_stage and no data → "skipped"
-- otherwise → "pending"
-```
-
-### Division by Zero Protection
-- All calculations check denominators before dividing
-- Returns 0 or default values for edge cases
-- No exceptions thrown for missing data
-
-### Multi-Tenancy Security
-- All queries filtered by `site` from request context
-- Run detail endpoint validates run belongs to site
-- No cross-site data leakage possible
-
----
-
-## 5. Testing Recommendations
-
-### API Testing (Phase 1 Complete)
-```bash
-# Test overview stats
-curl -H "Authorization: Bearer <token>" \
-  "http://localhost:8000/api/v1/automation/overview_stats/"
-
-# Test history with pagination
-curl -H "Authorization: Bearer <token>" \
-  "http://localhost:8000/api/v1/automation/history/?page=1&page_size=10"
-
-# Test run detail
-curl -H "Authorization: Bearer <token>" \
-  "http://localhost:8000/api/v1/automation/run_detail/?run_id=run_20260113_140523_manual"
-```
-
-### Edge Cases to Test
-1. New site with 0 runs
-2. Site with 1-2 completed runs (insufficient historical data)
-3. Run with failed stages
-4. Run with skipped stages
-5. Very short runs (<1 minute)
-6. Very long runs (>1 hour)
-7. Runs with 0 credits used (all skipped)
-8. Invalid run_id in run_detail
-
----
-
-## 6. Next Steps: Frontend Implementation
-
-### Phase 2: Frontend Overview Page (4-5 hours)
-**Components to Build:**
-1. `RunStatisticsSummary.tsx` - Display run_statistics with trends
-2. `PredictiveCostAnalysis.tsx` - Show predictive_analysis with donut chart
-3. `AttentionItemsAlert.tsx` - Display attention_items warnings
-4. `EnhancedRunHistory.tsx` - Table with clickable run titles
-5. Update `AutomationOverview.tsx` to integrate all components
-
-### Phase 3: Frontend Detail Page (5-6 hours)
-**Components to Build:**
-1. `AutomationRunDetail.tsx` - Main page component with routing
-2. `RunSummaryCard.tsx` - Display run header info
-3. `PipelineFlowVisualization.tsx` - Visual stage flow diagram
-4. `StageAccordion.tsx` - Expandable stage details
-5. `CreditBreakdownChart.tsx` - Recharts donut chart
-6. `RunTimeline.tsx` - Chronological stage timeline
-7. `EfficiencyMetrics.tsx` - Display efficiency stats
-8. `InsightsPanel.tsx` - Show auto-generated insights
-
-### Phase 4: Polish & Testing (3-4 hours)
-- Loading states and error handling
-- Empty states (no runs, no data)
-- Mobile responsive design
-- Dark mode support
-- Accessibility (ARIA labels, keyboard navigation)
-- Unit tests with Vitest
-
----
-
-## 7. Performance Considerations
-
-### Database Queries
-- **overview_stats**: ~8-10 queries (optimized with select_related)
-- **history**: 1 query + pagination (efficient)
-- **run_detail**: 1 query for run + 1 for historical averages
-
-### Optimization Opportunities (Future)
-1. Cache historical_averages for 1 hour (low churn)
-2. Add database indexes on `site_id`, `started_at`, `status`
-3. Consider materialized view for run statistics
-4. Add Redis caching for frequently accessed runs
-
-### Estimated Load Impact
-- Typical overview page load: 500-800ms
-- Run detail page load: 200-400ms
-- History pagination: 100-200ms per page
-
----
-
-## 8. Documentation Links
-
-- **Main UX Plan:** `/docs/plans/AUTOMATION_RUNS_DETAIL_VIEW_UX_PLAN.md`
-- **Implementation File:** `/backend/igny8_core/business/automation/views.py`
-- **Related Models:** 
-  - `/backend/igny8_core/business/automation/models.py`
-  - `/backend/igny8_core/business/keywords/models.py`
-  - `/backend/igny8_core/business/clusters/models.py`
-  - `/backend/igny8_core/business/content_ideas/models.py`
-
----
-
-## 9. Success Metrics (Post-Deployment)
-
-### User Engagement
-- Track clicks on run titles in history (expect 40%+ CTR)
-- Monitor time spent on detail pages (target: 2-3 min avg)
-- Track usage of predictive analysis before runs
-
-### Performance
-- P95 API response time < 1 second
-- Frontend initial load < 2 seconds
-- No errors in error tracking (Sentry/equivalent)
-
-### Business Impact
-- Reduction in support tickets about "why did this cost X credits?"
-- Increase in manual automation triggers (due to cost predictability)
-- User feedback scores (NPS) improvement
-
----
-
-**End of Phase 1 Implementation Log**  
-**Next Action:** Begin Phase 2 - Frontend Overview Page Components
diff --git a/docs/plans/automation/AUTOMATION_RUNS_IMPLEMENTATION_SUMMARY.md b/docs/plans/automation/AUTOMATION_RUNS_IMPLEMENTATION_SUMMARY.md
deleted file mode 100644
index 24653501..00000000
--- a/docs/plans/automation/AUTOMATION_RUNS_IMPLEMENTATION_SUMMARY.md
+++ /dev/null
@@ -1,335 +0,0 @@
-# Automation Runs Detail View - Implementation Summary
-
-## ✅ Implementation Complete (Phases 1-3)
-
-**Date:** January 17, 2026  
-**Status:** Backend + Frontend Complete, Ready for Testing  
-**Implementation Time:** ~12 hours (estimated 12-15 hours)
-
----
-
-## Overview
-
-Successfully implemented a comprehensive automation runs detail view system with:
-- Enhanced backend API with predictive analytics
-- Modern React frontend with ApexCharts visualizations
-- Full TypeScript type safety
-- Dark mode support
-- Responsive design
-
----
-
-## 📁 Files Created/Modified
-
-### Backend (Phase 1) - 2 files modified
-```
-backend/igny8_core/business/automation/views.py        [MODIFIED] +450 lines
-docs/plans/AUTOMATION_RUNS_DETAIL_VIEW_UX_PLAN.md     [MODIFIED]
-```
-
-### Frontend (Phases 2-3) - 15 files created/modified
-```
-frontend/src/types/automation.ts                                      [CREATED]
-frontend/src/utils/dateUtils.ts                                       [CREATED]
-frontend/src/services/automationService.ts                            [MODIFIED]
-frontend/src/components/Automation/DetailView/RunStatisticsSummary.tsx    [CREATED]
-frontend/src/components/Automation/DetailView/PredictiveCostAnalysis.tsx  [CREATED]
-frontend/src/components/Automation/DetailView/AttentionItemsAlert.tsx     [CREATED]
-frontend/src/components/Automation/DetailView/EnhancedRunHistory.tsx      [CREATED]
-frontend/src/components/Automation/DetailView/RunSummaryCard.tsx          [CREATED]
-frontend/src/components/Automation/DetailView/StageAccordion.tsx          [CREATED]
-frontend/src/components/Automation/DetailView/EfficiencyMetrics.tsx       [CREATED]
-frontend/src/components/Automation/DetailView/InsightsPanel.tsx           [CREATED]
-frontend/src/components/Automation/DetailView/CreditBreakdownChart.tsx    [CREATED]
-frontend/src/pages/Automation/AutomationOverview.tsx                       [MODIFIED]
-frontend/src/pages/Automation/AutomationRunDetail.tsx                      [CREATED]
-frontend/src/App.tsx                                                       [MODIFIED]
-frontend/src/icons/index.ts                                                [MODIFIED]
-```
-
-**Total:** 17 files (11 created, 6 modified)
-
----
-
-## 🎯 Features Implemented
-
-### Backend API (Phase 1)
-
-#### 1. Helper Methods
-- `_calculate_run_number()` - Sequential run numbering per site
-- `_calculate_historical_averages()` - Last 10 runs analysis (min 3 required)
-- `_calculate_predictive_analysis()` - Next run cost/output estimation
-- `_get_attention_items()` - Failed/skipped items counter
-
-#### 2. New Endpoints
-
-**`GET /api/v1/automation/overview_stats/`**
-```json
-{
-  "run_statistics": { /* 8 metrics */ },
-  "predictive_analysis": { /* 7 stages + totals */ },
-  "attention_items": { /* 3 issue types */ },
-  "historical_averages": { /* 10 fields + stages */ }
-}
-```
-
-**`GET /api/v1/automation/run_detail/?run_id=xxx`**
-```json
-{
-  "run": { /* run info */ },
-  "stages": [ /* 7 detailed stages */ ],
-  "efficiency": { /* 3 metrics */ },
-  "insights": [ /* auto-generated */ ],
-  "historical_comparison": { /* averages */ }
-}
-```
-
-**`GET /api/v1/automation/history/?page=1&page_size=20` (ENHANCED)**
-```json
-{
-  "runs": [ /* enhanced with run_number, run_title, stage_statuses, summary */ ],
-  "pagination": { /* page info */ }
-}
-```
-
-### Frontend Components (Phases 2-3)
-
-#### Overview Page Components
-1. **RunStatisticsSummary** - 4 key metrics cards + additional stats
-2. **PredictiveCostAnalysis** - Donut chart + stage breakdown
-3. **AttentionItemsAlert** - Warning banner for issues
-4. **EnhancedRunHistory** - Clickable table with pagination
-
-#### Detail Page Components
-1. **AutomationRunDetail** - Main page with comprehensive layout
-2. **RunSummaryCard** - Header with status, dates, metrics
-3. **StageAccordion** - Expandable sections (7 stages)
-4. **EfficiencyMetrics** - Performance metrics card
-5. **InsightsPanel** - Auto-generated insights
-6. **CreditBreakdownChart** - Donut chart visualization
-
----
-
-## 🔑 Key Features
-
-### ✅ Predictive Analytics
-- Estimates credits and outputs for next run
-- Based on last 10 completed runs
-- Confidence levels (High/Medium/Low)
-- 20% buffer recommendation
-
-### ✅ Historical Comparisons
-- Per-stage credit variance tracking
-- Output ratio comparisons
-- Efficiency trend analysis
-- Visual variance indicators
-
-### ✅ Human-Readable Run Titles
-- Format: `{site.domain} #{run_number}`
-- Example: `mysite.com #42`
-- Sequential numbering per site
-
-### ✅ Auto-Generated Insights
-- Variance warnings (>20% deviation)
-- Efficiency improvements detection
-- Stage failure alerts
-- Contextual recommendations
-
-### ✅ Rich Visualizations
-- ApexCharts donut charts
-- Color-coded stage status icons (✓ ✗ ○ ·)
-- Progress indicators
-- Dark mode compatible
-
-### ✅ Comprehensive Stage Analysis
-- Input/output metrics
-- Credit usage tracking
-- Duration measurements
-- Error details
-
----
-
-## 🎨 UI/UX Highlights
-
-- **Clickable Rows**: Navigate from history to detail page
-- **Pagination**: Handle large run histories
-- **Loading States**: Skeleton screens during data fetch
-- **Empty States**: Graceful handling of no data
-- **Responsive**: Works on mobile, tablet, desktop
-- **Dark Mode**: Full support throughout
-- **Accessibility**: Semantic HTML, color contrast
-
----
-
-## 📊 Data Flow
-
-```
-User visits /automation/overview
-    ↓
-AutomationOverview.tsx loads
-    ↓
-Calls overview_stats endpoint → RunStatisticsSummary, PredictiveCostAnalysis, AttentionItemsAlert
-Calls enhanced history endpoint → EnhancedRunHistory
-    ↓
-User clicks run title in history
-    ↓
-Navigate to /automation/runs/{run_id}
-    ↓
-AutomationRunDetail.tsx loads
-    ↓
-Calls run_detail endpoint → All detail components
-```
-
----
-
-## 🧪 Testing Checklist (Phase 4)
-
-### Backend Testing
-- [ ] Test overview_stats with 0 runs
-- [ ] Test with 1-2 runs (insufficient historical data)
-- [ ] Test with 10+ runs (full historical analysis)
-- [ ] Test run_detail with completed run
-- [ ] Test run_detail with failed run
-- [ ] Test run_detail with running run
-- [ ] Test pagination in history endpoint
-- [ ] Verify run number calculation accuracy
-
-### Frontend Testing
-- [ ] Overview page loads without errors
-- [ ] Predictive analysis displays correctly
-- [ ] Attention items show when issues exist
-- [ ] History table renders all columns
-- [ ] Clicking run title navigates to detail
-- [ ] Detail page shows all sections
-- [ ] Charts render without errors
-- [ ] Stage accordion expands/collapses
-- [ ] Insights display with correct styling
-- [ ] Pagination controls work
-
-### Cross-Browser Testing
-- [ ] Chrome/Edge
-- [ ] Firefox
-- [ ] Safari
-
-### Responsive Testing
-- [ ] Mobile (320px-768px)
-- [ ] Tablet (768px-1024px)
-- [ ] Desktop (1024px+)
-
-### Dark Mode Testing
-- [ ] All components render correctly in dark mode
-- [ ] Charts are visible in dark mode
-- [ ] Text contrast meets accessibility standards
-
----
-
-## 🚀 Deployment Steps
-
-1. **Backend Deployment**
-   ```bash
-   # No migrations required (no schema changes)
-   cd /data/app/igny8/backend
-   python manage.py collectstatic --noinput
-   # Restart gunicorn/uwsgi
-   ```
-
-2. **Frontend Deployment**
-   ```bash
-   cd /data/app/igny8/frontend
-   npm run build
-   # Deploy dist/ folder to CDN/nginx
-   ```
-
-3. **Verification**
-   - Navigate to `/automation/overview`
-   - Verify new components load
-   - Click a run title
-   - Verify detail page loads
-
----
-
-## 📈 Performance Notes
-
-### Backend
-- **overview_stats**: ~8-10 queries, 500-800ms
-- **run_detail**: 2 queries, 200-400ms
-- **history**: 1 query + pagination, 100-200ms
-
-### Frontend
-- **Bundle size increase**: ~45KB (compressed)
-- **Initial load time**: <2s on fast connection
-- **Chart rendering**: <100ms
-
-### Optimization Opportunities
-- Cache historical_averages for 1 hour
-- Add database indexes on `site_id`, `started_at`, `status`
-- Implement virtual scrolling for large run lists
-- Lazy load chart libraries
-
----
-
-## 🔒 Security Considerations
-
-✅ **All queries scoped to site** - No cross-site data leakage  
-✅ **Run detail validates ownership** - Users can only view their runs  
-✅ **No SQL injection risks** - Using Django ORM  
-✅ **No XSS risks** - React escapes all output  
-
----
-
-## 📚 Documentation
-
-- **Main Plan**: `/docs/plans/AUTOMATION_RUNS_DETAIL_VIEW_UX_PLAN.md`
-- **Implementation Log**: `/docs/plans/AUTOMATION_RUNS_IMPLEMENTATION_LOG.md`
-- **API Documentation**: Generated by drf-spectacular
-- **Component Docs**: Inline JSDoc comments
-
----
-
-## 🎯 Success Metrics
-
-**Measure after 2 weeks:**
-- [ ] Click-through rate on run titles (target: 40%+)
-- [ ] Average time on detail page (target: 2-3 min)
-- [ ] Predictive analysis usage before runs
-- [ ] User feedback/NPS improvement
-- [ ] Support ticket reduction for "credit usage" questions
-
----
-
-## 🔄 Future Enhancements (Not in Scope)
-
-1. **Export functionality** - Download run data as CSV/PDF
-2. **Run comparison** - Side-by-side comparison of 2 runs
-3. **Real-time updates** - WebSocket integration for live runs
-4. **Custom date ranges** - Filter history by date range
-5. **Saved filters** - Remember user preferences
-6. **Email notifications** - Alert on completion/failure
-7. **Advanced analytics** - Trends over 30/60/90 days
-8. **Stage logs viewer** - Inline log viewing per stage
-
----
-
-## 👥 Credits
-
-**Implementation Team:**
-- Backend API: Phase 1 (4-5 hours)
-- Frontend Components: Phases 2-3 (8-10 hours)
-- Documentation: Throughout
-
-**Technologies Used:**
-- Django REST Framework
-- React 19
-- TypeScript
-- ApexCharts
-- TailwindCSS
-- Zustand (state management)
-
----
-
-## ✅ Sign-Off
-
-**Phases 1-3: COMPLETE**  
-**Phase 4: Testing & Polish** - Remaining ~3-4 hours
-
-All core functionality implemented and working. Ready for QA testing and user feedback.
diff --git a/docs/plans/automation/AUTOMATION_RUNS_QUICK_START.md b/docs/plans/automation/AUTOMATION_RUNS_QUICK_START.md
deleted file mode 100644
index e116e797..00000000
--- a/docs/plans/automation/AUTOMATION_RUNS_QUICK_START.md
+++ /dev/null
@@ -1,238 +0,0 @@
-# Quick Start Guide - Automation Runs Detail View
-
-## 🚀 How to Test the New Features
-
-### 1. Start the Application
-
-**Backend:**
-```bash
-cd /data/app/igny8/backend
-python manage.py runserver
-```
-
-**Frontend:**
-```bash
-cd /data/app/igny8/frontend
-npm run dev
-```
-
-### 2. Access the Overview Page
-
-Navigate to: `http://localhost:5173/automation/overview`
-
-You should see:
-- ✅ **Run Statistics Summary** - Cards showing total/completed/failed/running runs
-- ✅ **Predictive Cost Analysis** - Donut chart with estimated credits for next run
-- ✅ **Attention Items Alert** - Warning if there are failed/skipped items
-- ✅ **Enhanced Run History** - Table with clickable run titles
-
-### 3. Explore the Detail Page
-
-**Option A: Click a Run Title**
-- Click any run title in the history table (e.g., "mysite.com #42")
-- You'll navigate to `/automation/runs/{run_id}`
-
-**Option B: Direct URL**
-- Find a run_id from the backend
-- Navigate to: `http://localhost:5173/automation/runs/run_20260117_140523_manual`
-
-You should see:
-- ✅ **Run Summary Card** - Status, dates, duration, credits
-- ✅ **Insights Panel** - Auto-generated alerts and recommendations
-- ✅ **Credit Breakdown Chart** - Donut chart showing credit distribution
-- ✅ **Efficiency Metrics** - Performance stats with historical comparison
-- ✅ **Stage Accordion** - Expandable sections for all 7 stages
-
-### 4. Test Different Scenarios
-
-#### Scenario 1: Site with No Runs
-- Create a new site or use one with 0 automation runs
-- Visit `/automation/overview`
-- **Expected:** "No automation runs yet" message
-
-#### Scenario 2: Site with Few Runs (< 3 completed)
-- Use a site with 1-2 completed runs
-- **Expected:** Predictive analysis shows "Low confidence"
-
-#### Scenario 3: Site with Many Runs (> 10)
-- Use a site with 10+ completed runs
-- **Expected:** Full historical averages, "High confidence" predictions
-
-#### Scenario 4: Failed Run
-- Find a run with status='failed'
-- View its detail page
-- **Expected:** Error insights, red status badge, error messages in stages
-
-#### Scenario 5: Running Run
-- Trigger a new automation run (if possible)
-- View overview page while it's running
-- **Expected:** "Running Runs: 1" in statistics
-
-### 5. Test Interactions
-
-- [ ] Click run title → navigates to detail page
-- [ ] Expand/collapse stage accordion sections
-- [ ] Change page in history pagination
-- [ ] Hover over chart sections to see tooltips
-- [ ] Toggle dark mode (if available in app)
-
-### 6. Verify Data Accuracy
-
-#### Backend API Tests
-```bash
-# Get overview stats
-curl -H "Authorization: Bearer <token>" \
-  "http://localhost:8000/api/v1/automation/overview_stats/?site_id=1"
-
-# Get enhanced history
-curl -H "Authorization: Bearer <token>" \
-  "http://localhost:8000/api/v1/automation/history/?site_id=1&page=1&page_size=10"
-
-# Get run detail
-curl -H "Authorization: Bearer <token>" \
-  "http://localhost:8000/api/v1/automation/run_detail/?site_id=1&run_id=run_xxx"
-```
-
-#### Verify Calculations
-- Check that run numbers are sequential (1, 2, 3...)
-- Verify historical averages match manual calculations
-- Confirm predictive estimates align with pending items
-- Ensure stage status icons match actual stage results
-
-### 7. Mobile Responsive Testing
-
-**Test on different screen sizes:**
-```
-- 320px (iPhone SE)
-- 768px (iPad)
-- 1024px (Desktop)
-- 1920px (Large Desktop)
-```
-
-**What to check:**
-- Cards stack properly on mobile
-- Tables scroll horizontally if needed
-- Charts resize appropriately
-- Text remains readable
-- Buttons are touch-friendly
-
-### 8. Dark Mode Testing
-
-If your app supports dark mode:
-- [ ] Toggle to dark mode
-- [ ] Verify all text is readable
-- [ ] Check chart colors are visible
-- [ ] Ensure borders/dividers are visible
-- [ ] Confirm badge colors have good contrast
-
-### 9. Performance Check
-
-Open browser DevTools:
-- **Network tab**: Check API response times
-  - overview_stats should be < 1s
-  - run_detail should be < 500ms
-  - history should be < 300ms
-- **Performance tab**: Record page load
-  - Initial render should be < 2s
-  - Chart rendering should be < 100ms
-- **Console**: Check for errors or warnings
-
-### 10. Browser Compatibility
-
-Test in multiple browsers:
-- [ ] Chrome/Edge (Chromium)
-- [ ] Firefox
-- [ ] Safari (if on Mac)
-
----
-
-## 🐛 Common Issues & Solutions
-
-### Issue: "No data available"
-**Solution:** Ensure the site has at least one automation run in the database.
-
-### Issue: Charts not rendering
-**Solution:** Check that ApexCharts is installed: `npm list react-apexcharts`
-
-### Issue: 404 on detail page
-**Solution:** Verify the route is added in App.tsx and the run_id is valid
-
-### Issue: Historical averages showing 0
-**Solution:** Need at least 3 completed runs for historical data
-
-### Issue: Predictive analysis shows "Low confidence"
-**Solution:** Normal if < 3 completed runs exist
-
-### Issue: Dark mode colors look wrong
-**Solution:** Verify Tailwind dark: classes are applied correctly
-
----
-
-## 📸 Screenshots to Capture
-
-For documentation/demo purposes:
-
-1. **Overview Page - Full View**
-   - Shows all 4 components
-   - With real data
-
-2. **Predictive Analysis Chart**
-   - Donut chart with 7 stages
-   - Credit breakdown visible
-
-3. **Run History Table**
-   - Multiple runs visible
-   - Stage status icons clear
-
-4. **Detail Page - Run Summary**
-   - Top section with status and metrics
-
-5. **Stage Accordion - Expanded**
-   - One stage expanded showing details
-   - Historical comparison visible
-
-6. **Credit Breakdown Chart**
-   - Donut chart on detail page
-
-7. **Insights Panel**
-   - With actual insights displayed
-
-8. **Mobile View**
-   - Both overview and detail pages
-
----
-
-## ✅ Final Verification Checklist
-
-Before marking complete:
-- [ ] All 3 new endpoints return data
-- [ ] Overview page loads without errors
-- [ ] Detail page loads without errors
-- [ ] Routing works (click run title)
-- [ ] Pagination works in history
-- [ ] Charts render correctly
-- [ ] Stage accordion expands/collapses
-- [ ] Historical comparisons show variance %
-- [ ] Auto-generated insights appear
-- [ ] Dark mode looks good
-- [ ] Mobile layout is usable
-- [ ] No console errors
-- [ ] TypeScript compiles without errors
-- [ ] Backend tests pass (if any)
-
----
-
-## 🎉 Success!
-
-If all above items work, the implementation is complete and ready for:
-1. User acceptance testing (UAT)
-2. Staging deployment
-3. Production deployment
-4. User training/documentation
-
----
-
-**Need help?** Check:
-- `/docs/plans/AUTOMATION_RUNS_DETAIL_VIEW_UX_PLAN.md` - Full specification
-- `/docs/plans/AUTOMATION_RUNS_IMPLEMENTATION_LOG.md` - Detailed implementation notes
-- `/docs/plans/AUTOMATION_RUNS_IMPLEMENTATION_SUMMARY.md` - High-level overview
diff --git a/docs/plans/implemented/ACCURATE-INTEGRATION-SECURITY-PLAN.md b/docs/plans/implemented/ACCURATE-INTEGRATION-SECURITY-PLAN.md
deleted file mode 100644
index befe40fd..00000000
--- a/docs/plans/implemented/ACCURATE-INTEGRATION-SECURITY-PLAN.md
+++ /dev/null
@@ -1,297 +0,0 @@
-# IGNY8 ↔ WordPress Integration Security Plan
-
-**Date:** 2026-01-13  
-**Status:** Audit Complete - Plan Ready
-
----
-
-## PART 1: ACTUAL ARCHITECTURE (VERIFIED)
-
-### 1.1 Publishing Flow (WORKING - No Changes Needed)
-
-```
-Frontend (Review/Approved pages)
-         │
-         ▼
-POST /v1/publisher/publish/
-         │
-         ▼
-PublisherService._publish_to_destination()
-         │
-         ├── Gets API key: content.site.wp_api_key (SINGLE SOURCE OF TRUTH)
-         ├── Gets URL: content.site.domain or content.site.url
-         │
-         ▼
-WordPressAdapter._publish_via_api_key()
-         │
-         ▼
-POST {site_url}/wp-json/igny8/v1/publish
-    Headers: X-IGNY8-API-KEY: {api_key}
-         │
-         ▼
-Plugin: check_permission() validates header against stored igny8_api_key
-         │
-         ▼
-Plugin creates/updates WordPress post
-```
-
-**Key Finding:** Publishing does NOT use SiteIntegration model. It uses:
-- `Site.wp_api_key` - for authentication
-- `Site.domain` - for WordPress URL
-
-### 1.2 Data Storage Locations
-
-| Location | Field | Purpose | Used By |
-|----------|-------|---------|---------|
-| **Django Site model** | `wp_api_key` | API key (source of truth) | Publishing, test-connection |
-| **Django Site model** | `domain` | WordPress URL | Publishing |
-| **WordPress wp_options** | `igny8_api_key` | Stored copy of API key | Plugin auth check |
-| **WordPress wp_options** | `igny8_site_id` | Site ID from key | Plugin display |
-| **WordPress wp_options** | `igny8_integration_id` | Integration ID | Plugin (currently unused) |
-| **WordPress wp_options** | `igny8_last_structure_sync` | Last sync timestamp | Connection status UI |
-
-### 1.3 SiteIntegration Model Status
-
-**Table exists:** `igny8_site_integrations`  
-**Records:** 0 (empty)  
-**Used by:** 
-- `publishing_scheduler.py` - scheduled publishing (requires record)
-- `wordpress_publishing.py` - Celery task path (requires record)
-- `sync_metadata_service.py` - metadata sync (requires record)
-- `ContentViewSet.publish` action (requires record)
-
-**NOT used by:**
-- `PublisherService` (main UI publishing path) - uses Site directly
-- `WordPressAdapter` - uses Site.wp_api_key directly
-
----
-
-## PART 2: SECURITY ISSUES FOUND
-
-### 2.1 Plugin Public Endpoints (SECURITY RISK)
-
-| Endpoint | Current Permission | Risk | Data Exposed |
-|----------|-------------------|------|--------------|
-| `/igny8/v1/status` | `__return_true` (PUBLIC) | Medium | Plugin installed, has_api_key, plugin version |
-| `/igny8/v1/site-metadata/` | `__return_true` (PUBLIC*) | Low | Post types, taxonomies (auth checked inside) |
-
-*Note: `/site-metadata/` checks permission inside callback but still registers as public
-
-### 2.2 Backend test-connection Flow
-
-The `test_connection_collection` endpoint:
-1. Uses `AllowAny` permission class
-2. BUT validates authentication inside the handler
-3. Calls public `/status` endpoint to check if plugin installed
-4. Then calls authenticated `/verify-key` endpoint
-
-**Issue:** Relies on public `/status` endpoint to detect plugin presence.
-
----
-
-## PART 3: RECOMMENDED CHANGES
-
-### 3.1 Plugin Changes (REQUIRED)
-
-#### 3.1.1 Make `/status` Endpoint Authenticated
-
-**File:** `plugins/wordpress/source/igny8-wp-bridge/includes/class-igny8-rest-api.php`
-
-**Current (lines 83-87):**
-```php
-register_rest_route('igny8/v1', '/status', array(
-    'methods' => 'GET',
-    'callback' => array($this, 'get_status'),
-    'permission_callback' => '__return_true', // Public endpoint for health checks
-));
-```
-
-**Change to:**
-```php
-register_rest_route('igny8/v1', '/status', array(
-    'methods' => 'GET',
-    'callback' => array($this, 'get_status'),
-    'permission_callback' => array($this, 'check_api_key_auth'),
-));
-```
-
-#### 3.1.2 Add Lightweight Auth Check Method
-
-Add new method to allow API key OR no key if not configured yet:
-
-```php
-/**
- * Check API key authentication for status-type endpoints
- * Returns true if: no API key stored yet, OR valid API key provided
- */
-public function check_api_key_auth($request) {
-    $stored_api_key = function_exists('igny8_get_secure_option') 
-        ? igny8_get_secure_option('igny8_api_key') 
-        : get_option('igny8_api_key');
-    
-    // If no API key configured yet, allow access (plugin not connected)
-    if (empty($stored_api_key)) {
-        return true;
-    }
-    
-    // If API key is configured, require valid key in header
-    $header_api_key = $request->get_header('x-igny8-api-key');
-    if ($header_api_key && hash_equals($stored_api_key, $header_api_key)) {
-        return true;
-    }
-    
-    return new WP_Error('rest_forbidden', 'Invalid API key', array('status' => 401));
-}
-```
-
-#### 3.1.3 Fix `/site-metadata/` Route Registration
-
-**Current (lines 74-79):**
-```php
-register_rest_route('igny8/v1', '/site-metadata/', array(
-    'methods' => 'GET',
-    'callback' => array($this, 'get_site_metadata'),
-    'permission_callback' => '__return_true',
-));
-```
-
-**Change to:**
-```php
-register_rest_route('igny8/v1', '/site-metadata/', array(
-    'methods' => 'GET',
-    'callback' => array($this, 'get_site_metadata'),
-    'permission_callback' => array($this, 'check_permission'),
-));
-```
-
-Then remove the internal permission check from `get_site_metadata()` method.
-
-### 3.2 Backend Changes (REQUIRED)
-
-#### 3.2.1 Update test-connection to Not Rely on Public Endpoint
-
-**File:** `backend/igny8_core/modules/integration/views.py`
-
-**Current approach:**
-1. Call `/status` (public) to check plugin installed
-2. Call `/verify-key` (authenticated) to verify key
-
-**New approach:**
-1. Call `/verify-key` directly
-2. If 200 → plugin installed AND key valid
-3. If 404 → plugin not installed (route doesn't exist)
-4. If 401/403 → plugin installed but key mismatch
-
-**Change Check 2 section (approximately lines 218-237):**
-
-```python
-# Check 2 & 3 Combined: Plugin installed + API key verification
-# Use /verify-key endpoint - if it succeeds, both are confirmed
-try:
-    verify_response = http_requests.get(
-        f"{site_url.rstrip('/')}/wp-json/igny8/v1/verify-key",
-        headers={
-            'X-IGNY8-API-KEY': stored_api_key,
-            'Content-Type': 'application/json'
-        },
-        timeout=10
-    )
-    if verify_response.status_code == 200:
-        health_checks['plugin_installed'] = True
-        health_checks['plugin_has_api_key'] = True
-        health_checks['api_key_verified'] = True
-    elif verify_response.status_code == 404:
-        # Route not found = plugin not installed
-        issues.append("IGNY8 plugin not installed on WordPress site")
-    elif verify_response.status_code in [401, 403]:
-        # Auth failed = plugin installed but key doesn't match
-        health_checks['plugin_installed'] = True
-        issues.append("API key mismatch - copy the API key from IGNY8 to WordPress plugin settings")
-    else:
-        issues.append(f"Unexpected response from plugin: HTTP {verify_response.status_code}")
-except http_requests.exceptions.ConnectionError:
-    issues.append("Cannot connect to WordPress site")
-except Exception as e:
-    issues.append(f"Connection error: {str(e)}")
-```
-
-### 3.3 SiteIntegration Decision (OPTIONAL)
-
-The SiteIntegration model is used by:
-- Scheduled publishing task
-- ContentViewSet.publish action  
-- Metadata sync service
-
-**Options:**
-
-**Option A: Remove SiteIntegration entirely**
-- Modify scheduled publishing to use Site directly
-- Modify sync service to use Site directly
-- Remove model and migrations
-- **Effort:** High, risk of breaking things
-
-**Option B: Keep but don't require it**
-- Current main publishing path works without it
-- Scheduled publishing would need records created
-- **Effort:** Low, minimal changes
-
-**Recommendation:** Option B - Keep as-is. The main UI publishing flow works. If scheduled publishing is needed, run:
-```bash
-docker exec igny8_backend python manage.py sync_wordpress_api_keys
-```
-
----
-
-## PART 4: IMPLEMENTATION ORDER
-
-### Phase 1: Plugin Security (30 min)
-1. Add `check_api_key_auth()` method to plugin
-2. Change `/status` endpoint to use `check_api_key_auth`
-3. Change `/site-metadata/` to use `check_permission`
-4. Remove internal permission check from `get_site_metadata()`
-5. Build and deploy plugin
-
-### Phase 2: Backend Update (15 min)
-1. Update `test_connection_collection` to use only `/verify-key`
-2. Remove `/status` endpoint call
-3. Test connection flow
-
-### Phase 3: Testing (15 min)
-1. Test plugin uninstalled scenario (404 from /verify-key)
-2. Test plugin installed, no key (401 from /verify-key)
-3. Test plugin installed, wrong key (401 from /verify-key)
-4. Test plugin installed, correct key (200 from /verify-key)
-5. Test publishing still works
-
----
-
-## PART 5: FILES TO MODIFY
-
-### Plugin Files
-| File | Changes |
-|------|---------|
-| `includes/class-igny8-rest-api.php` | Add `check_api_key_auth()`, update route permissions |
-
-### Backend Files
-| File | Changes |
-|------|---------|
-| `modules/integration/views.py` | Update `test_connection_collection` logic |
-
----
-
-## PART 6: WHAT STAYS THE SAME
-
-✅ **Publishing flow** - No changes needed  
-✅ **Site.wp_api_key** - Single source of truth  
-✅ **Site.domain** - WordPress URL source  
-✅ **WordPressAdapter** - Works correctly  
-✅ **Plugin /publish endpoint** - Already authenticated  
-✅ **Plugin /verify-key endpoint** - Already authenticated  
-✅ **SiteIntegration model** - Keep for scheduled publishing (optional use)
-
----
-
-## Document History
-| Date | Author | Changes |
-|------|--------|---------|
-| 2026-01-13 | AI | Created after proper code audit |
diff --git a/docs/plans/implemented/COMPREHENSIVE-SYSTEM-FIX-PLAN-JAN-10-2026.md b/docs/plans/implemented/COMPREHENSIVE-SYSTEM-FIX-PLAN-JAN-10-2026.md
deleted file mode 100644
index d17ba3c3..00000000
--- a/docs/plans/implemented/COMPREHENSIVE-SYSTEM-FIX-PLAN-JAN-10-2026.md
+++ /dev/null
@@ -1,1156 +0,0 @@
-# COMPREHENSIVE SYSTEM FIX PLAN
-**Date:** January 10, 2026  
-**Last Updated:** January 10, 2026  
-**Priority:** CRITICAL  
-**Status:** Phases 1-6 Complete - Phase 7 (Optional Features)
-
----
-
-## EXECUTIVE SUMMARY
-
-This plan tracks all identified system issues, their status, and implementation details. Issues are categorized by priority and module.
-
-**Issue Categories:**
-1. **Backend Data Model & Credits** (2 issues - ✅ COMPLETED)
-2. **Frontend - Automation** (3 issues)
-3. **Frontend - Publishing & Calendar** (3 issues)
-4. **Frontend - Planner/Writer Pages** (2 issues)
-5. **Frontend - Sites & Settings** (3 issues)
-6. **Branding & Terminology** (2 issues)
-7. **New Features** (2 issues)
-
-**Completion Status:**
-- ✅ Phase 1 (Backend Credit System): COMPLETED (v1.7.1)
-- ✅ Phase 2 (Automation & Credits): COMPLETED (Jan 10, 2026 - 2 hours)
-- ✅ Phase 3 (Calendar & Content): COMPLETED (Jan 10, 2026 - 1 hour)
-- ✅ Phase 4 (Widget & Data Consistency): COMPLETED (Jan 10, 2026 - 30 min)
-- ✅ Phase 5 (Sites & Settings): COMPLETED (Jan 10, 2026 - 30 min)
-- ✅ Phase 6 (Branding & Terminology): COMPLETED (Jan 10, 2026 - 45 min)
-- ✅ Phase 7 (New Features): COMPLETED (Jan 10, 2026 - Issue 17 verified, Issue 16 skipped)
-
-**Impact:** These fixes will ensure:
-- ✅ All AI functions log consistently to AI tasks, notifications, and usage logs
-- ✅ Image generation properly deducts and logs credits with cost calculations
-- ✅ No attribute errors in AI model configuration
-- ✅ Consistent data display across all pages
-- ✅ Improved UX with proper button styling and working features
-- ✅ Proper terminology throughout the app (site vs wordpress)
-- ✅ Auto-approve and auto-publish working correctly
-- ✅ Content calendar showing published content
-
----
-
-## ISSUE 1: AIModelConfig AttributeError - `input_cost_per_1m`
-
-### ✅ COMPLETED - v1.7.1
-
-**Error Message:**
-```
-Failed to cluster keywords: Unexpected error: 'AIModelConfig' object has no attribute 'input_cost_per_1m'
-```
-
-**Root Cause:**
-The `AIModelConfig` model uses field names `cost_per_1k_input` and `cost_per_1k_output`, but `model_registry.py` was trying to access `input_cost_per_1m` and `output_cost_per_1m` (old field names).
-
-**Fix Applied in v1.7.1:**
-- Updated field references in `model_registry.py` to use correct field names
-- Updated field references in `serializers.py` to match
-
-**Files Changed:**
-1. `backend/igny8_core/ai/model_registry.py`
-2. `backend/igny8_core/modules/billing/serializers.py`
-
----
-
-## ISSUE 2: Image Generation - Missing Credit Tracking & Logging
-
-### ✅ COMPLETED - v1.7.1
-
-**Problem:**
-Image generation was not:
-- ❌ Logging to AI tasks table (AITaskLog)
-- ❌ Logging to notifications
-- ❌ Logging to usage logs with cost calculations
-- ❌ Deducting credits properly based on model configuration
-
-**Fix Applied in v1.7.1:**
-- Added `CreditService.check_credits_for_image()` method
-- Pre-generation credit verification in `tasks.py`
-- Credit deduction after each successful image
-- AITaskLog creation for image generation
-- Notification integration
-
-**Files Changed:**
-1. `backend/igny8_core/business/billing/services/credit_service.py`
-2. `backend/igny8_core/ai/tasks.py`
-
-**See CHANGELOG v1.7.1 for full details.**
-  → ai_core.generate_image() 
-  → Returns result
-  → Deduct credits (CreditService.deduct_credits_for_image)
-  → Create AITaskLog
-  → Create notification
-  → Create usage log with cost
-```
-
-**What Exists (Ready to Use):**
-- ✅ `CreditService.calculate_credits_for_image()` - calculates credits from model config
-- ✅ `CreditService.deduct_credits_for_image()` - deducts credits and creates logs
-- ✅ `AIModelConfig.credits_per_image` - configured for all image models
-- ✅ Notification templates for image generation
-
-**What's Missing:**
-- ❌ Integration of credit tracking into image generation flow
-- ❌ AITaskLog creation for image generation
-- ❌ Notification creation for image generation
-- ❌ Usage log creation with cost calculation
-
-**Fix Strategy:**
-
-### Phase 1: Integrate Credit Tracking into Image Generation
-
-**Step 1.1: Update `generate_images_core()` function**
-
-File: `backend/igny8_core/ai/functions/generate_images.py`
-
-Current logic (lines 203-278):
-```python
-def generate_images_core(task_ids, account_id, progress_callback):
-    # ... gets tasks ...
-    # ... generates images ...
-    # ❌ NO credit tracking
-    return {'success': True, 'images_created': count}
-```
-
-**NEW Implementation:**
-```python
-def generate_images_core(task_ids, account_id, progress_callback):
-    """Core image generation with full credit tracking"""
-    from igny8_core.business.billing.services.credit_service import CreditService
-    from igny8_core.business.notifications.services import NotificationService
-    from igny8_core.ai.models import AITaskLog
-    
-    # Get account
-    account = Account.objects.get(id=account_id)
-    
-    # Validate
-    fn = GenerateImagesFunction()
-    validated = fn.validate({'ids': task_ids}, account)
-    if not validated['valid']:
-        return {'success': False, 'error': validated['error']}
-    
-    # Prepare
-    data = fn.prepare({'ids': task_ids}, account)
-    tasks = data['tasks']
-    model = data['model']  # e.g., 'dall-e-3'
-    
-    # Get model config for credits
-    from igny8_core.business.billing.models import AIModelConfig
-    model_config = AIModelConfig.objects.get(model_name=model, is_active=True)
-    
-    # Calculate total images to generate
-    total_images = 0
-    for task in tasks:
-        if task.content:
-            total_images += 1  # Featured image
-            total_images += data.get('max_in_article_images', 0)  # In-article images
-    
-    # Calculate total credits needed
-    total_credits = model_config.credits_per_image * total_images
-    
-    # CHECK CREDITS FIRST (before any generation)
-    if account.credits < total_credits:
-        error_msg = f"Insufficient credits. Required: {total_credits}, Available: {account.credits}"
-        # Create failed notification
-        NotificationService.create_notification(
-            account=account,
-            notification_type='ai_image_failed',
-            message=error_msg,
-            related_object_type='task',
-            related_object_id=tasks[0].id if tasks else None
-        )
-        return {'success': False, 'error': error_msg}
-    
-    # Create AITaskLog for tracking
-    task_log = AITaskLog.objects.create(
-        account=account,
-        function_name='generate_images',
-        phase='INIT',
-        status='pending',
-        payload={'task_ids': task_ids, 'model': model}
-    )
-    
-    ai_core = AICore(account=account)
-    images_created = 0
-    total_cost_usd = 0.0
-    
-    try:
-        # Process each task
-        for task in tasks:
-            if not task.content:
-                continue
-            
-            # Extract prompts
-            prompts_data = fn.build_prompt({'task': task, **data}, account)
-            
-            # Generate featured image
-            featured_result = ai_core.generate_image(
-                prompt=formatted_featured_prompt,
-                provider=data['provider'],
-                model=model,
-                function_name='generate_images'
-            )
-            
-            if featured_result.get('url'):
-                # Save image
-                fn.save_output(
-                    {'url': featured_result['url'], 'image_type': 'featured'},
-                    {'task': task, **data},
-                    account
-                )
-                images_created += 1
-                total_cost_usd += float(featured_result.get('cost', 0))
-            
-            # Generate in-article images (if configured)
-            # ... similar logic ...
-        
-        # DEDUCT CREDITS (with usage log and cost)
-        from igny8_core.business.billing.services.credit_service import CreditService
-        from igny8_core.business.billing.models import BillingConfiguration
-        
-        # Calculate actual credits used (based on images generated)
-        credits_used = images_created * model_config.credits_per_image
-        
-        # Calculate cost per credit for usage log
-        billing_config = BillingConfiguration.get_instance()
-        cost_per_credit = billing_config.default_credit_price_usd
-        total_cost_for_log = float(credits_used) * float(cost_per_credit)
-        
-        # Deduct credits (creates CreditTransaction, CreditUsageLog)
-        CreditService.deduct_credits_for_image(
-            account=account,
-            model_name=model,
-            num_images=images_created,
-            description=f"Generated {images_created} images for {len(tasks)} tasks",
-            metadata={
-                'task_ids': task_ids,
-                'images_created': images_created,
-                'model': model
-            },
-            cost_usd=total_cost_usd,  # Actual AI provider cost
-            related_object_type='task',
-            related_object_id=tasks[0].id if tasks else None
-        )
-        
-        # Update AITaskLog
-        task_log.status = 'success'
-        task_log.phase = 'DONE'
-        task_log.cost = total_cost_usd
-        task_log.result = {
-            'images_created': images_created,
-            'credits_used': credits_used,
-            'tasks_processed': len(tasks)
-        }
-        task_log.save()
-        
-        # Create success notification
-        NotificationService.create_notification(
-            account=account,
-            notification_type='ai_image_success',
-            message=f'Generated {images_created} images using {credits_used} credits',
-            metadata={
-                'images_created': images_created,
-                'credits_used': credits_used,
-                'tasks_processed': len(tasks)
-            },
-            related_object_type='task',
-            related_object_id=tasks[0].id if tasks else None
-        )
-        
-        return {
-            'success': True,
-            'images_created': images_created,
-            'credits_used': credits_used,
-            'cost_usd': total_cost_usd,
-            'message': f'Generated {images_created} images'
-        }
-        
-    except Exception as e:
-        # Update task log with error
-        task_log.status = 'error'
-        task_log.error = str(e)
-        task_log.save()
-        
-        # Create failed notification
-        NotificationService.create_notification(
-            account=account,
-            notification_type='ai_image_failed',
-            message=f'Image generation failed: {str(e)}',
-            error=str(e),
-            related_object_type='task',
-            related_object_id=tasks[0].id if tasks else None
-        )
-        
-        return {'success': False, 'error': str(e)}
-```
-
-**Step 1.2: Ensure Notification Types Exist**
-
-File: `backend/igny8_core/business/notifications/services.py`
-
-Check if these notification types are defined:
-- `ai_image_success`
-- `ai_image_failed`
-
-If not, add them to the notification type choices.
-
-### Phase 2: Test All Image Generation Paths
-
-**Test Cases:**
-1. ✅ Manual image generation via Writer module
-2. ✅ Automation image generation
-3. ✅ Bulk image generation
-4. ✅ Insufficient credits handling
-5. ✅ AI provider errors handling
-
-**Validation Checks:**
-- [ ] AITaskLog created for each image generation run
-- [ ] Credits deducted correctly based on model config
-- [ ] CreditUsageLog created with correct operation_type='image_generation'
-- [ ] Cost calculated correctly (provider cost + credit cost)
-- [ ] Notifications created for success/failure
-- [ ] Frontend credits counter updates in real-time
-
----
-
-## ISSUE 3: Pause/Cancel Button Colors in Automation
-
-### ✅ COMPLETED
-
-**Problem:**
-Pause/Cancel buttons in automation in-progress panel needed better button colors for clarity.
-
-**Fix Applied:**
-Updated button variants from `outline` to `primary` for better visibility.
-
-**File:** `frontend/src/components/Automation/CurrentProcessingCardV2.tsx`
-
-**Current Implementation (CORRECT):**
-```tsx
-<Button variant="primary" tone="warning" ...>Pause</Button>
-<Button variant="primary" tone="success" ...>Resume</Button>
-<Button variant="primary" tone="danger" ...>Cancel</Button>
-```
-
----
-
-## ISSUE 4: Automation Stage Cards - Credits Not Showing During Processing
-
-### 🔴 CRITICAL - UI Gap
-
-**Problem:**
-Credits are not showing in Stage 1, 2, 4, and 5 stage cards when processing, but they DO show in Stage 6 card. Need consistency across all stages.
-
-**Root Cause:**
-The `StageCard.tsx` component doesn't have a mechanism to display credits during processing. Only Stage 6 (Image Generation) shows credits because the `CurrentProcessingCardV2.tsx` displays `currentRun.total_credits_used`.
-
-**Files to Investigate:**
-1. `frontend/src/components/Automation/StageCard.tsx` - Individual stage cards
-2. `frontend/src/components/Automation/CurrentProcessingCardV2.tsx` - In-progress panel
-
-**Fix Strategy:**
-1. Pass credits information to StageCard when stage is active
-2. Display credits consumed during that stage's processing
-3. Fetch real-time credit updates from backend
-
-**Implementation:**
-
-```tsx
-// In StageCard.tsx - Add credits display
-interface StageCardProps {
-  // ... existing props
-  creditsUsed?: number;        // Credits used by this stage
-  creditsPerItem?: number;     // Credit cost per item processed
-}
-
-// Display in active state:
-{isActive && (
-  <div className="mt-2 pt-2 border-t border-brand-200">
-    <div className="flex justify-between text-xs">
-      <span className="text-brand-600">Credits Used:</span>
-      <span className="font-bold text-brand-700">{creditsUsed || 0}</span>
-    </div>
-  </div>
-)}
-```
-
----
-
-## ISSUE 5: Automation In-Progress Panel - Credits Badge Not Incrementing
-
-### 🔴 CRITICAL - Real-time UX Issue
-
-**Problem:**
-The credits badge in the automation in-progress panel shows `0` and doesn't increment after each stage completes. It should show cumulative credits used during the entire run.
-
-**Root Cause:**
-Looking at `CurrentProcessingCardV2.tsx`, it displays `currentRun.total_credits_used` but this value isn't being updated in real-time from the backend during processing.
-
-**Current Code (Line 297):**
-```tsx
-<span className="text-base font-bold text-warning-600">{currentRun.total_credits_used}</span>
-```
-
-**Fix Strategy:**
-
-### Option 1: Poll Credit Updates More Frequently
-```tsx
-// Add dedicated credit polling
-useEffect(() => {
-  const pollCredits = async () => {
-    try {
-      const response = await fetchAPI(`/v1/automation/runs/${runId}/credits/`);
-      setCreditsUsed(response.total_credits_used);
-    } catch (err) {}
-  };
-  
-  if (currentRun.status === 'running') {
-    const interval = setInterval(pollCredits, 2000); // Every 2 seconds
-    return () => clearInterval(interval);
-  }
-}, [currentRun.status, runId]);
-```
-
-### Option 2: Include Credits in Processing State Response
-Backend should return `credits_used_so_far` in the processing state endpoint.
-
-**Files to Change:**
-1. `frontend/src/components/Automation/CurrentProcessingCardV2.tsx`
-2. `backend/igny8_core/business/automation/services/automation_service.py` (if needed)
-
----
-
-## ISSUE 6: WorkflowCompletionWidget - Inconsistent Data Across Pages
-
-### 🔴 CRITICAL - Data Integrity Issue
-
-**Problem:**
-The WorkflowCompletionWidget shows different counts on different pages because it filters by active sector.
-
-**Root Cause:**
-The `useWorkflowStats()` hook uses `activeSector` from store, which changes per page.
-
-**File:** `frontend/src/hooks/useWorkflowStats.ts`
-
-**Current Code (Line 151):**
-```typescript
-const { activeSector } = useSectorStore();
-const sectorParam = activeSector?.id ? `&sector_id=${activeSector.id}` : '';
-```
-
-**Fix:**
-Remove sector filter - widget should always show site-wide stats.
-
-```typescript
-// Remove sector dependency
-const loadStats = useCallback(async () => {
-  const siteParam = `&site_id=${activeSite.id}`;
-  // NO sector filter for consistent widget display
-  const baseParams = siteParam;
-  // ...
-}, [activeSite?.id]); // Remove activeSector from dependencies
-```
-
----
-
-## ISSUE 7: Content Calendar and List Not Showing
-
-### 🔴 CRITICAL - Feature Broken
-
-**Problem:**
-Content calendar and content list at `/publisher/content-calendar` not showing. Calendar missing completely and list also not showing any past published content.
-
-**Investigation:**
-
-**File:** `frontend/src/pages/Publisher/ContentCalendar.tsx`
-
-**Current Implementation Analysis:**
-- Component fetches ALL content for the site (line 134-145)
-- `publishedItems` filters for items with `external_id` (line 110-112)
-- Calendar uses `getPublishedItemsForDate()` and `getScheduledItemsForDate()`
-
-**Possible Issues:**
-1. `external_id` might not be set on published content
-2. `updated_at` used as publish date might not be correct
-3. Data fetch might be failing silently
-
-**Debug Steps:**
-```tsx
-console.log('[ContentCalendar] publishedItems:', publishedItems);
-console.log('[ContentCalendar] Sample with external_id:', 
-  allContent.filter(c => c.external_id));
-```
-
-**Fix Strategy:**
-1. Verify that published content has `external_id` set
-2. Check if backend is returning published content correctly
-3. May need to use `site_status === 'published'` instead of checking `external_id`
-
----
-
-## ISSUE 8: Auto-Approve and Auto-Publish on Site Settings
-
-### 🔴 CRITICAL - Feature Not Functional
-
-**Problem:**
-Auto-approve and auto-publish toggles on Site Settings → Publishing tab need to be made functional.
-
-**Current State (from code analysis):**
-
-**Backend Models Exist:**
-- `PublishingSettings.auto_approval_enabled` - in `business/integration/models.py:265`
-- `PublishingSettings.auto_publish_enabled` - in `business/integration/models.py:271`
-
-**Backend Service Integration Exists:**
-- `automation_service.py:1491` - Checks `auto_approval_enabled`
-- `automation_service.py:1632` - Checks `auto_publish_enabled` and triggers publish
-
-**Frontend Implementation Exists:**
-- Site Settings Publishing tab has toggles
-- Saves via `savePublishingSettings()` on toggle change
-
-**Issues to Fix:**
-1. ✅ Backend models exist
-2. ✅ Backend service checks the flags
-3. ❓ Need to verify data flow is working
-4. ❓ Need to verify settings are being loaded correctly
-
-**Testing Required:**
-1. Toggle auto-approval ON → Run automation → Content should go to 'approved' not 'review'
-2. Toggle auto-publish ON → Content approved → Should trigger publish to WordPress
-
----
-
-## ISSUE 9: Publishing Settings Save Button
-
-### 🟡 MEDIUM - UX Improvement
-
-**Problem:**
-Limits and Schedule settings in Publishing tab save immediately on change. They should require a Save button click instead. Only the automation toggles should save on toggle.
-
-**Current Implementation:**
-File: `frontend/src/pages/Sites/Settings.tsx` (lines 1025-1100)
-
-```tsx
-// Limits Card - saves on every change (WRONG)
-<InputField
-  value={publishingSettings.daily_publish_limit}
-  onChange={(e) => {
-    const value = ...;
-    setPublishingSettings({ ...publishingSettings, daily_publish_limit: value });
-    // Missing: Should NOT auto-save here
-  }}
-/>
-
-// Automation Card - saves on toggle (CORRECT for toggles)
-<Switch
-  checked={publishingSettings.auto_approval_enabled}
-  onChange={(checked) => {
-    setPublishingSettings(newSettings);
-    savePublishingSettings({ auto_approval_enabled: checked }); // ✅ OK for toggles
-  }}
-/>
-```
-
-**Fix Strategy:**
-1. Remove immediate save from Limits and Schedule cards
-2. Add a "Save Settings" button at bottom of Publishing tab
-3. Keep toggle-based save for Automation card only
-
-**New Code:**
-```tsx
-// Limits Card - no auto-save
-onChange={(e) => {
-  setPublishingSettings({ ...publishingSettings, daily_publish_limit: value });
-  // Don't call savePublishingSettings here
-}}
-
-// Add Save button at bottom
-<div className="flex justify-end mt-6">
-  <Button 
-    variant="primary" 
-    onClick={() => savePublishingSettings(publishingSettings)}
-    disabled={publishingSettingsSaving}
-  >
-    {publishingSettingsSaving ? 'Saving...' : 'Save Settings'}
-  </Button>
-</div>
-```
-
----
-
-## ISSUE 10: Planner and Writer Pagination
-
-### 🟡 MEDIUM - Navigation Issue
-
-**Problem:**
-Pagination not working properly on all Planner and Writer pages.
-
-**Pages Affected:**
-- `/planner/keywords`
-- `/planner/clusters`
-- `/planner/ideas`
-- `/writer/tasks`
-- `/writer/drafts`
-- `/writer/images`
-
-**Current Implementation:**
-All pages use similar pagination pattern via `TablePageTemplate`:
-- `currentPage` state
-- `pageSize` state
-- `setCurrentPage` passed to Pagination component
-
-**Possible Issues:**
-1. Page doesn't reset when filters change
-2. Total count not being calculated correctly
-3. Backend not respecting page parameter
-
-**Debug Steps:**
-1. Check network tab - verify `page` param sent correctly
-2. Check response - verify `count` and `results` correct
-3. Check `setCurrentPage` - verify it triggers data reload
-
-**Files to Check:**
-1. `frontend/src/pages/Planner/Keywords.tsx`
-2. `frontend/src/pages/Planner/Clusters.tsx`
-3. `frontend/src/pages/Writer/Tasks.tsx`
-4. `frontend/src/templates/TablePageTemplate.tsx`
-
----
-
-## ISSUE 11: Footer Widgets Data Audit
-
-### 🟡 MEDIUM - Data Accuracy
-
-**Problem:**
-Need to audit footer widgets on all Planner and Writer pages to ensure counts are accurate.
-
-**Widgets to Audit:**
-1. **Credits Widget** - Shows credit balance
-2. **Quick Stats Widget** - Shows items pending/processed
-3. **Workflow Completion Widget** - Shows pipeline progress
-
-**Audit Table Required:**
-
-| Page | Widget | Model/API | Field | Filter/Criteria | Status |
-|------|--------|-----------|-------|-----------------|--------|
-| Keywords | Quick Stats | Keyword | count | site_id, status | TBD |
-| Clusters | Quick Stats | Cluster | count | site_id | TBD |
-| Ideas | Quick Stats | ContentIdea | count | site_id | TBD |
-| Tasks | Quick Stats | Task | count | site_id | TBD |
-| ... | ... | ... | ... | ... | ... |
-
-**Investigation Required:**
-1. List all widgets shown on each page
-2. Document API endpoint each widget calls
-3. Document filter criteria used
-4. Verify counts match backend reality
-
----
-
-## ISSUE 12: Usage Logs Cost Calculation Formula
-
-### 🟡 MEDIUM - Documentation/Clarity
-
-**Problem:**
-Need to document the formula/criteria used for cost calculation in Usage Logs page.
-
-**Page:** `/account/usage/logs`
-
-**Current Implementation:**
-File: `frontend/src/pages/account/UsageLogsPage.tsx`
-
-The page displays `cost_usd` from the `CreditUsageLog` model.
-
-**Backend Cost Calculation:**
-File: `backend/igny8_core/business/billing/services/credit_service.py`
-
-```python
-# For text operations (clustering, content, ideas):
-credits = tokens_used / tokens_per_credit
-cost_usd = credits * credit_price_usd  # From BillingConfiguration
-
-# For image operations:
-credits = num_images * credits_per_image  # From AIModelConfig
-cost_usd = credits * credit_price_usd
-```
-
-**Top Metrics Calculation:**
-The summary stats on the usage page are calculated client-side from loaded logs:
-```typescript
-const totalCredits = logs.reduce((sum, log) => sum + log.credits_used, 0);
-const totalCost = logs.reduce((sum, log) => sum + parseFloat(log.cost_usd || '0'), 0);
-```
-
-**Documentation to Add:**
-- Add tooltip/help text explaining cost calculation
-- Show formula in UI: "Cost = Credits Used × Credit Price ($0.XX per credit)"
-
----
-
-## ISSUE 13: Sites Page - Add Site Button Not Working
-
-### 🔴 CRITICAL - Core Feature Broken
-
-**Problem:**
-Neither the top "Add New Website" button nor the empty state button works on the Sites page.
-
-**Investigation Results:**
-
-**File:** `frontend/src/pages/Sites/List.tsx`
-
-**Current Implementation:**
-```tsx
-// Line 71: State
-const [showWelcomeGuide, setShowWelcomeGuide] = useState(false);
-
-// Line 481: Button
-<Button 
-  onClick={() => setShowWelcomeGuide(!showWelcomeGuide)} 
-  ...
->
-  Add New Website
-</Button>
-
-// Line 527-534: Conditional render
-{showWelcomeGuide && (
-  <div className="mb-6">
-    <WorkflowGuide onSiteAdded={() => {
-      loadSites();
-      setShowWelcomeGuide(false);
-    }} />
-  </div>
-)}
-```
-
-**Root Cause Analysis:**
-The button toggles `showWelcomeGuide` which should show the `WorkflowGuide` component. If it's not working:
-1. State toggle might not be working
-2. `WorkflowGuide` component might not be rendering
-3. Component might have internal errors
-
-**Debug Steps:**
-1. Add console.log to onClick handler
-2. Check if WorkflowGuide component exists
-3. Check for any JS errors in console
-
-**Fix Strategy:**
-If WorkflowGuide isn't appropriate for Sites page:
-- Create dedicated AddSiteModal or AddSiteForm
-- Use similar flow to homepage setup wizard
-
----
-
-## ISSUE 14: AI Model Names - Branding Update
-
-### 🟡 MEDIUM - Branding Consistency
-
-**Problem:**
-AI model names like "GPT-4", "DALL-E", "Claude" should be replaced with "IGNY8 AI" in user-facing areas (Help page, docs, etc.).
-
-**Areas to Update:**
-
-**Help Page (`frontend/src/pages/Help/Help.tsx`):**
-- Line 263: "Images are generated using AI (DALL-E 3 for premium, Runware for basic)"
-- Should be: "Images are generated using IGNY8 AI (Premium quality or Basic quality)"
-
-**Other Locations to Check:**
-- `/frontend/src/pages/Settings/Publishing.tsx`
-- `/frontend/src/pages/Billing/Credits.tsx`
-- Any tooltip or help text mentioning specific AI models
-
-**Guideline:**
-- Backend/Admin: Keep technical model names (for configuration)
-- Frontend/User-facing: Use "IGNY8 AI" or quality tier names (Basic, Quality, Premium)
-
-**Search Pattern:**
-```bash
-grep -r "GPT-4\|DALL-E\|Claude\|OpenAI\|Anthropic" frontend/src/pages/
-```
-
----
-
-## ISSUE 15: WordPress to Site Terminology
-
-### 🟡 MEDIUM - Terminology Consistency
-
-**Problem:**
-System says "WordPress" in many places where "site" should be used, especially since Shopify and Custom Site integrations are coming.
-
-**Context:**
-- Integration section: Keep "WordPress" where it refers to WordPress-specific features
-- Global/help text: Use "site" or "your website" instead of "WordPress"
-
-**Examples to Fix:**
-
-**Keep "WordPress":**
-- "Connect WordPress" button (integration-specific)
-- "WordPress Integration" settings tab
-- "IGNY8 WP Bridge Plugin" references
-
-**Change to "site":**
-- "Publish to WordPress" → "Publish to your site"
-- "WordPress sync" → "Site sync" (in general contexts)
-- Help text mentioning WordPress as the only option
-
-**Search Pattern:**
-```bash
-grep -ri "wordpress" frontend/src/pages/ --include="*.tsx" | grep -v "WordPressIntegration"
-```
-
-**Files to Review:**
-1. `frontend/src/pages/Help/Help.tsx`
-2. `frontend/src/pages/Settings/Publishing.tsx`
-3. `frontend/src/pages/legal/Terms.tsx`
-4. `frontend/src/pages/Billing/Credits.tsx`
-
----
-
-## ISSUE 16: Content View - Image Regeneration
-
-### 🟢 NEW FEATURE - Enhancement
-
-**Problem:**
-Need ability to regenerate images from the content view with:
-- Custom prompt input
-- Option to regenerate from original prompt
-- Option to generate at higher quality tier
-
-**Current State:**
-- Backend: API endpoint documented but NOT implemented
-- Frontend: No regenerate buttons exist
-
-**Implementation Plan:**
-
-### Backend:
-Add `regenerate` action to `ImageViewSet`:
-```python
-# In modules/writer/views.py - ImageViewSet
-@action(detail=True, methods=['post'])
-def regenerate(self, request, pk=None):
-    image = self.get_object()
-    custom_prompt = request.data.get('custom_prompt', '')
-    quality_tier = request.data.get('quality_tier', image.quality_tier)
-    
-    # Append custom prompt to original if provided
-    prompt = image.prompt
-    if custom_prompt:
-        prompt = f"{prompt}. {custom_prompt}"
-    
-    # Check credits for quality tier
-    # Generate new image
-    # Update image record
-    # Return result
-```
-
-### Frontend:
-Add regenerate button to content view:
-```tsx
-// In ContentViewTemplate or similar
-<Button
-  variant="secondary"
-  size="sm"
-  onClick={() => setShowRegenerateModal(true)}
->
-  <RefreshIcon /> Regenerate Image
-</Button>
-
-// Modal with options:
-// - Custom prompt textarea
-// - Quality tier selector (Basic/Quality/Premium)
-// - "Use original prompt" checkbox
-```
-
-**Credit Calculation:**
-- Show credit cost before regeneration
-- Different costs for different quality tiers
-
----
-
-## ISSUE 17: Auto-Publish After Stage 7 Approval
-
-### ✅ COMPLETED - Already Implemented
-
-**Problem:**
-After Stage 7 (Review) completes and content is approved, need to automatically schedule content for publishing based on auto-publish settings.
-
-**Actual Flow (VERIFIED IN CODE):**
-Stage 7 → Content status = 'review' → IF auto_approval_enabled → Status = 'approved' → IF auto_publish_enabled → Schedule for publishing
-
-**Implementation Status:**
-
-### ✅ Backend Implementation - COMPLETE
-**File:** `backend/igny8_core/business/automation/services/automation_service.py` (lines 1475-1710)
-
-**Stage 7 Logic:**
-1. Line 1491: Checks `publishing_settings.auto_approval_enabled`
-2. Lines 1507-1590: If enabled, changes content status from 'review' → 'approved'
-3. Line 1632: Checks `publishing_settings.auto_publish_enabled`
-4. Lines 1640-1680: If enabled, schedules approved content:
-   - Calls `_calculate_available_slots(publishing_settings, site)`
-   - Assigns `scheduled_publish_at` timestamps to content
-   - Sets `site_status = 'scheduled'`
-   - Respects daily/weekly/monthly publish limits
-
-### ✅ Publishing Scheduler - COMPLETE
-**File:** `backend/igny8_core/tasks/publishing_scheduler.py`
-- `_calculate_available_slots()` function exists (lines 109-240)
-- Calculates next 30 days of available slots
-- Respects publish_days, publish_time_slots, and limits
-- Returns list of datetime objects
-
-### ✅ Site Settings Toggles - FUNCTIONAL
-**File:** `frontend/src/pages/Sites/Settings.tsx`
-- Auto-Approval toggle (line 1069) - saves immediately
-- Auto-Publish toggle (line 1085) - saves immediately
-- Both call `savePublishingSettings()` via PATCH API
-
-**Verification Date:** January 10, 2026
-**Status:** Code review confirms full implementation - ready for E2E testing
-
----
-## UPDATED IMPLEMENTATION PRIORITY & ORDER
-
-### ✅ Phase 1: Backend Critical (COMPLETED in v1.7.1)
-1. ✅ Issue 1: AIModelConfig AttributeError
-2. ✅ Issue 2: Image Generation Credit Tracking
-3. ✅ Issue 3: Button Colors (already fixed)
-
-### ✅ Phase 2: Automation & Credits (COMPLETED - Jan 10, 2026)
-**Actual Time: 2 hours**
-
-4. ✅ **Issue 4: Stage Cards Credits Display** (COMPLETED)
-   - Fixed credits display condition from `credits_used > 0` to `credits_used !== undefined`
-   - Now shows credits even when 0, providing better visibility
-   - Updated both stage grids (1-4 and 5-7)
-   - **File:** `frontend/src/pages/Automation/AutomationPage.tsx`
-
-5. ✅ **Issue 5: Credits Badge Not Incrementing** (COMPLETED)
-   - Removed sector filter from credits API call in useWorkflowStats hook
-   - Credits now show site-wide total regardless of active sector
-   - Added creditsSiteParam for site-only filtering
-   - **File:** `frontend/src/hooks/useWorkflowStats.ts`
-
-6. ✅ **Issue 8: Auto-Approve/Auto-Publish** (VERIFIED - Code Complete)
-   - Verified backend implementation in Stage 7 (lines 1493-1678)
-   - Auto-approval checks `publishing_settings.auto_approval_enabled`
-   - Auto-publish checks `publishing_settings.auto_publish_enabled`
-   - Queues approved content to WordPress via Celery tasks
-   - **Status:** Functional - Needs E2E Testing
-   - **File:** `backend/igny8_core/business/automation/services/automation_service.py`
-
-### ✅ Phase 3: Calendar & Content (COMPLETED - Jan 10, 2026)
-**Actual Time: 1 hour**
-
-7. ✅ **Issue 7: Content Calendar Not Showing** (COMPLETED)
-   - Fixed published content detection to check BOTH `external_id` AND `site_status === 'published'`
-   - Previously only checked `external_id`, missing published items without external WordPress ID
-   - Updated stats calculation for published/scheduled/approved counts
-   - **File:** `frontend/src/pages/Publisher/ContentCalendar.tsx`
-
-8. ✅ **Issue 9: Publishing Settings Save Button** (COMPLETED)
-   - Added "Save Publishing Settings" button at bottom of Publishing tab
-   - Button calls `savePublishingSettings()` with full settings object
-   - Shows loading state during save operation
-   - **File:** `frontend/src/pages/Sites/Settings.tsx`
-
-### ✅ Phase 4: Widget & Data Consistency (COMPLETED - Jan 10, 2026)
-**Actual Time: 30 minutes**
-
-9. ✅ **Issue 6: WorkflowWidget Consistency** (COMPLETED)
-   - Removed ALL sector filtering from useWorkflowStats hook
-   - Removed sectorParam from API calls
-   - Removed activeSector from dependencies
-   - Widget now shows site-wide stats consistently across all pages
-   - **File:** `frontend/src/hooks/useWorkflowStats.ts`
-
-10. ✅ **Issue 10: Pagination Issues** (VERIFIED - No Action Needed)
-   - Reviewed pagination implementation in Keywords, Clusters, Ideas, Tasks pages
-   - Code properly resets to page 1 when filters change
-   - PageSize changes trigger explicit reload
-   - Backend pagination tests confirm correct behavior
-   - **Status:** Pagination is working correctly - no bugs found
-
-11. ✅ **Issue 11: Footer Widgets Audit** (DOCUMENTED)
-   - All Planner/Writer pages use StandardThreeWidgetFooter
-   - Widgets use useWorkflowStats hook (now sector-independent)
-   - Footer displays: Credits Balance, Quick Stats, Workflow Completion
-   - **Status:** Widgets functional, data sourced from site-wide stats
-
-### ✅ Phase 5: Sites & Settings (COMPLETED - Jan 10, 2026)
-**Actual Time: 30 minutes**
-
-12. ✅ **Issue 13: Add Site Button** (COMPLETED - 20 min)
-    - **Root Cause:** Sites/List.tsx used local `showWelcomeGuide` state, but WorkflowGuide component checks `isGuideVisible` from onboarding store
-    - **Fix:** Replaced local state with `useOnboardingStore()` hook and `toggleGuide()` method
-    - **Changes:**
-      - Added onboarding store import
-      - Replaced `showWelcomeGuide` state with `isGuideVisible` from store
-      - Changed button onClick from local setState to `toggleGuide()`
-      - Fixed both top button and empty state button
-    - **File:** `frontend/src/pages/Sites/List.tsx`
-
-13. ✅ **Issue 12: Usage Logs Documentation** (COMPLETED - 10 min)
-    - Added info card explaining cost calculation formulas
-    - Card displays:
-      - Text operations formula: (Tokens ÷ Tokens per Credit) × Credit Price
-      - Image operations formula: (Images × Credits per Image) × Credit Price
-      - Note about total cost including provider + credit costs
-    - **File:** `frontend/src/pages/account/UsageLogsPage.tsx`
-
-### ✅ Phase 6: Branding & Terminology (COMPLETED - Jan 10, 2026)
-**Actual Time: 45 minutes**
-
-14. ✅ **Issue 14: AI Model Names Branding** (COMPLETED - 25 min)
-    - Replaced all user-facing AI provider references with "IGNY8 AI"
-    - Changed quality tier names from provider-specific to generic:
-      - "DALL-E 3" → "Premium quality"
-      - "Runware" → "Basic quality"
-      - "GPT-4o/Claude" → "IGNY8 AI"
-    - Updated sections:
-      - FAQ answers (3 questions)
-      - Image Settings tab description
-      - Image Generation section (2 locations)
-      - AI Providers section
-      - Credit System section
-    - **File:** `frontend/src/pages/Help/Help.tsx`
-
-15. ✅ **Issue 15: WordPress to Site Terminology** (COMPLETED - 20 min)
-    - Replaced generic WordPress references with "site" or "your site"
-    - Kept WordPress-specific references in integration contexts
-    - Updated 11 locations:
-      - Workflow pipeline FAQ
-      - Image generation FAQ
-      - Status badges and descriptions
-      - Publish actions
-      - Featured image descriptions
-      - Review stage intro
-      - Calendar tracking descriptions
-    - **Guideline Applied:**
-      - Integration sections: Keep "WordPress" (e.g., "WordPress Integration", "IGNY8 WP Bridge plugin")
-      - Generic contexts: Use "site" (e.g., "Publish to your site", "Live on your site")
-    - **File:** `frontend/src/pages/Help/Help.tsx`
-
-### ✅ Phase 7: New Features (COMPLETED - Jan 10, 2026)
-**Actual Time: 0 hours (verification only)**
-
-16. ⏭️ **Issue 16: Image Regeneration** (SKIPPED per user request)
-    - User requested to skip this issue
-    - Can be implemented in future if needed
-
-17. ✅ **Issue 17: Auto-Publish After Stage 7** (VERIFIED - 0 hours)
-    - Already implemented in automation_service.py
-    - Code review confirmed full functionality:
-      - Auto-approval logic (line 1491)
-      - Status change 'review' → 'approved' (line 1569)
-      - Auto-publish check (line 1632)
-      - Scheduling with slot calculation (lines 1640-1680)
-    - Site Settings toggles functional and saving correctly
-    - **File:** `backend/igny8_core/business/automation/services/automation_service.py`
-
----
-
-## ISSUE SUMMARY TABLE
-
-| # | Issue | Priority | Status | Est. Time |
-|---|-------|----------|--------|-----------|
-| 1 | AIModelConfig AttributeError | ✅ | DONE | - |
-| 2 | Image Credit Tracking | ✅ | DONE | - |
-| 3 | Button Colors | ✅ | DONE | - |
-| 4 | Stage Cards Credits | ✅ | DONE | 1h |
-| 5 | Credits Badge Increment | ✅ | DONE | 30m |
-| 6 | Widget Consistency | ✅ | DONE | 20m |
-| 7 | Content Calendar | ✅ | DONE | 30m |
-| 8 | Auto-Approve/Publish | ✅ | VERIFIED | - |
-| 9 | Publishing Save Button | ✅ | DONE | 20m |
-| 10 | Pagination Issues | ✅ | VERIFIED | - |
-| 11 | Footer Widgets Audit | ✅ | DOCUMENTED | 10m |
-| 12 | Usage Logs Docs | ✅ | DONE | 10m |
-| 13 | Add Site Button | ✅ | DONE | 20m |
-| 14 | AI Model Names | ✅ | DONE | 25m |
-| 15 | WordPress → Site | ✅ | DONE | 20m |
-| 16 | Image Regeneration | ⏭️ | SKIPPED | - |
-| 17 | Auto-Publish Stage 7 | ✅ | VERIFIED | - |
-
-**Legend:**
-- 🔴 CRITICAL - Must fix
-- 🟡 MEDIUM - Should fix
-- 🟢 LOW/NEW - Nice to have
-- ✅ COMPLETED
-- ⏭️ SKIPPED
-
----
-
-## TESTING CHECKLIST
-
-### After Each Fix
-- [ ] Run backend server without errors
-- [ ] Test the specific feature fixed
-- [ ] Check browser console for errors
-- [ ] Verify no regression in related features
-
-### Phase 2 Verification ✅ COMPLETED
-- [x] Run automation and verify credits show on all stage cards
-- [x] Verify credits badge increments after each stage (site-wide, no sector filter)
-- [ ] Toggle auto-approve ON → Content goes to 'approved' (CODE VERIFIED - Needs E2E test)
-- [ ] Toggle auto-publish ON → Approved content gets scheduled (CODE VERIFIED - Needs E2E test)
-
-### Phase 3 Verification ✅ COMPLETED
-- [x] Content calendar shows scheduled items (checks site_status)
-- [x] Content calendar shows published items (checks external_id OR site_status)
-- [ ] Calendar view renders correctly (NEEDS MANUAL TEST)
-- [ ] List view shows all content (NEEDS MANUAL TEST)
-- [x] Save button works for limits/schedule
-
-### Phase 4-5 Verification
-- [ ] Widget shows same counts on all pages
-- [ ] Pagination works on all tables
-- [ ] Add Site button opens wizard
-- [ ] New site can be created
-
-### Phase 6 Verification
-- [ ] No GPT/DALL-E references in user-facing text
-- [ ] "Site" used instead of "WordPress" in generic contexts
-
----
-
-## SUCCESS CRITERIA
-
-✅ **All fixes successful when:**
-
-1. ✅ No attribute errors in AI functions (DONE - v1.7.1)
-2. ✅ All AI functions log to all 3 locations (DONE - v1.7.1)
-3. ✅ Image generation deducts credits correctly (DONE - v1.7.1)
-4. ✅ **Credits display on all stage cards during processing** (DONE - Jan 10)
-5. ✅ **Credits badge increments in real-time** (DONE - Jan 10)
-6. ✅ **Widget shows consistent data across all pages** (DONE - Jan 10)
-7. ✅ **Content calendar displays scheduled and published content** (DONE - Jan 10)
-8. ✅ **Auto-approve and auto-publish work correctly** (VERIFIED - Jan 10)
-9. ✅ **Add Site button works on Sites page** (DONE - Jan 10)
-10. ✅ **Consistent IGNY8 AI branding throughout** (DONE - Jan 10)
-11. ✅ **Generic "site" terminology where appropriate** (DONE - Jan 10)
-
----
-
-## END OF COMPREHENSIVE FIX PLAN v2
-
-**Last Updated:** January 10, 2026 - 19:30 UTC
-**Total Issues:** 17
-**Completed:** 16 issues (Issues 1-15, 17)
-**Skipped:** 1 issue (Issue 16)
-**Critical Issues:** 0 pending - All critical and medium priority issues resolved!
-**Phase 7 Status:** Complete (Issue 17 verified as already implemented, Issue 16 skipped per user request)
-
-This plan is based on actual codebase analysis and reflects the true state of the system.
-
-**🎉 ALL PHASES COMPLETE! 🎉**
\ No newline at end of file
diff --git a/docs/plans/implemented/CREDITS-LIMITS-AUDIT-REPORT.md b/docs/plans/implemented/CREDITS-LIMITS-AUDIT-REPORT.md
deleted file mode 100644
index 238497d9..00000000
--- a/docs/plans/implemented/CREDITS-LIMITS-AUDIT-REPORT.md
+++ /dev/null
@@ -1,2449 +0,0 @@
-# Credits & Limits System - Implementation Plan
-
-**Date:** January 5, 2026  
-**Status:** 🚧 IMPLEMENTATION PLAN - Pending Execution  
-**Prepared For:** IGNY8 Platform  
-**Purpose:** Comprehensive plan to simplify, optimize, and properly enforce credits and limits system
-
----
-
-## Executive Summary
-
-This implementation plan addresses the IGNY8 platform's credits and limits system based on complete codebase analysis.
-
-### Core Philosophy: SIMPLICITY
-
-**Keep ONLY 4 Hard Limits:**
-1. **Sites** - How many sites per account
-2. **Team Users** - How many team members
-3. **Keywords** - Total keywords in workspace
-4. **Ahrefs Queries** - Monthly research queries (NEW)
-
-**Everything Else = Credits** - Let users consume credits however they want (content, images, ideas, etc.)
-
-### What We're Doing
-
-✅ **REMOVE** all unnecessary monthly limits (content_ideas, content_words, images_basic, images_premium, image_prompts)  
-✅ **SIMPLIFY** to credit-based system only  
-✅ **ENFORCE** the 4 hard limits properly  
-✅ **ELIMINATE** data duplication across pages  
-✅ **REDESIGN** Usage page with multi-dimensional insights  
-✅ **IMPLEMENT** Ahrefs keyword research structure  
-✅ **VALIDATE** all credit balance checks  
-✅ **USE** user-friendly terminology (no "API", "operations", etc.)
-
----
-
-## 1. FINAL SIMPLIFIED MODEL
-
-### 1.1 The Only Limits That Matter
-
-| Limit | Type | Description | Enforcement |
-|-------|------|-------------|-------------|
-| **Sites** | Hard | Max sites per account | ✅ Keep & Enforce |
-| **Team Users** | Hard | Max team members | ✅ Keep & Enforce |
-| **Keywords** | Hard | Total keywords in workspace | ✅ Keep & Enforce |
-| **Ahrefs Queries** | Monthly | Research queries per month | 🆕 Implement |
-
-### 1.2 What Gets REMOVED
-
-**❌ REMOVE These Limits (Use Credits Instead):**
-- `max_content_ideas` - Let credits control this
-- `max_content_words` - Let credits control this
-- `max_images_basic` - Let credits control this
-- `max_images_premium` - Let credits control this
-- `max_image_prompts` - Let credits control this
-- `max_clusters` - Let credits control this (or combine with keywords)
-- `usage_content_ideas` - Not needed
-- `usage_content_words` - Not needed
-- `usage_images_basic` - Not needed
-- `usage_images_premium` - Not needed
-- `usage_image_prompts` - Not needed
-
-**Why Remove?**
-- Confusing for users ("I have credits but can't generate content?")
-- Double limiting (credits + monthly limits)
-- Maintenance overhead
-- Credit system already provides control
-
-### 1.3 Keyword Research Structure (NEW)
-
-**Two Ways to Add Keywords:**
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                   KEYWORD RESEARCH OPTIONS                       │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Option 1: IGNY8 Pre-Researched Keywords (FREE)                │
-│  ────────────────────────────────────────────                  │
-│  • Access global keyword database                              │
-│  • Filter by industry, sector, country                         │
-│  • Pre-analyzed for search volume, difficulty                  │
-│  • Free to browse and add to workspace                         │
-│  • Limited by: max_keywords (total workspace limit)            │
-│                                                                  │
-│  Option 2: Ahrefs Live Research (LIMITED)                      │
-│  ────────────────────────────────────────────                  │
-│  • Query Ahrefs API directly                                   │
-│  • Get fresh, custom keyword data                              │
-│  • Monthly query limit (e.g., 50-500 depending on plan)        │
-│  • Limited by: max_ahrefs_queries (monthly limit)              │
-│  • Results can be added to workspace (counts toward max_keywords)│
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-**Implementation:**
-- Rename current "Add Keywords" to "Browse Pre-Researched Keywords"
-- Add new tab/section "Research with Ahrefs" (with monthly limit indicator)
-- Show remaining queries: "You have 42/50 Ahrefs queries remaining this month"
-
----
-
-## 2. Current System Analysis (What We Found)
-
-### 1.1 Frontend Pages Breakdown
-
-#### Plans & Billing Dropdown (`/account/plans`)
-
-| Page | Route | Primary Purpose | Current Data Displayed |
-|------|-------|----------------|----------------------|
-| **Current Plan** | `/account/plans` | View active subscription | Plan name, price, renewal date, included credits |
-| **Upgrade Plan** | `/account/plans/upgrade` | Compare and purchase plans | Pricing table with all plans, features, limits |
-| **History** | `/account/plans/history` | Invoices and payments | Invoice list, payment methods, transaction history |
-
-**File:** `frontend/src/pages/account/PlansAndBillingPage.tsx` (881 lines)
-
-**Tab Structure:**
-```typescript
-type TabType = 'plan' | 'upgrade' | 'invoices';
-```
-
-**Key Data Shown:**
-- Current plan details (name, price, billing cycle)
-- Upgrade options (pricing table with all plans)
-- Credit balance (via `getCreditBalance()`)
-- Billing history (invoices, payments)
-- Payment methods management
-
-#### Usage Dropdown (`/account/usage`)
-
-| Page | Route | Primary Purpose | Current Data Displayed |
-|------|-------|----------------|----------------------|
-| **Limits & Usage** | `/account/usage` | Track plan limits | Hard limits + monthly limits with progress bars |
-| **Credit History** | `/account/usage/credits` | View credit transactions | Transaction log (purchases, deductions, adjustments) |
-| **Activity** | `/account/usage/activity` | Monitor API operations | API call statistics by operation type |
-
-**File:** `frontend/src/pages/account/UsageAnalyticsPage.tsx` (266 lines)
-
-**Tab Structure:**
-```typescript
-type TabType = 'limits' | 'activity' | 'api';
-```
-
-**Key Data Shown:**
-- Usage summary (hard limits: sites, users, keywords, clusters)
-- Monthly limits (content ideas, words, images)
-- Credit balance and monthly usage
-- Transaction history
-- API activity by operation type
-
----
-
-### 1.2 Backend Models
-
-#### Account Model (`backend/igny8_core/auth/models.py`)
-
-**Credits Field:**
-```python
-credits = models.IntegerField(default=0, validators=[MinValueValidator(0)])
-```
-
-**Monthly Usage Tracking Fields:**
-```python
-usage_content_ideas = models.IntegerField(default=0)        # Monthly limit tracking
-usage_content_words = models.IntegerField(default=0)        # Monthly limit tracking
-usage_images_basic = models.IntegerField(default=0)         # Monthly limit tracking
-usage_images_premium = models.IntegerField(default=0)       # Monthly limit tracking
-usage_image_prompts = models.IntegerField(default=0)        # Monthly limit tracking
-usage_period_start = models.DateTimeField(null=True)        # Billing period tracking
-usage_period_end = models.DateTimeField(null=True)          # Billing period tracking
-```
-
-#### Plan Model
-
-**Hard Limits (Never Reset):**
-```python
-max_sites = models.IntegerField(default=1)           # Sites allowed per account
-max_users = models.IntegerField(default=1)           # Team members allowed
-max_keywords = models.IntegerField(default=1000)     # Total keywords allowed
-max_clusters = models.IntegerField(default=100)      # Total clusters allowed
-```
-
-**Monthly Limits (Reset on Billing Cycle):**
-```python
-max_content_ideas = models.IntegerField(default=300)      # Ideas per month
-max_content_words = models.IntegerField(default=100000)   # Words per month
-max_images_basic = models.IntegerField(default=300)       # Basic images per month
-max_images_premium = models.IntegerField(default=60)      # Premium images per month
-max_image_prompts = models.IntegerField(default=300)      # Image prompts per month
-```
-
-**Credits:**
-```python
-included_credits = models.IntegerField(default=0)        # Monthly credit allocation
-extra_credit_price = models.DecimalField(default=0.01)   # Price per additional credit
-```
-
----
-
-## 2. Data Flow Analysis
-
-### 2.1 Credit Deduction Flow
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                   CREDIT DEDUCTION WORKFLOW                      │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  1. User triggers AI operation (e.g., generate content)         │
-│                        ↓                                         │
-│  2. Backend service calls CreditService                          │
-│                        ↓                                         │
-│  3. Check balance: CreditService.check_credits(account, credits)│
-│                        ↓                                         │
-│  4. Execute AI operation (OpenAI/Runware/etc.)                  │
-│                        ↓                                         │
-│  5. AI returns tokens used (input + output)                     │
-│                        ↓                                         │
-│  6. Calculate credits: CreditService.calculate_credits_from_tokens()│
-│     • Lookup AIModelConfig.tokens_per_credit for model          │
-│     • credits = ceil(total_tokens / tokens_per_credit)          │
-│                        ↓                                         │
-│  7. Deduct credits:                                             │
-│     • Create CreditTransaction (amount=-credits)                │
-│     • Create CreditUsageLog (operation details)                 │
-│     • Update Account.credits                                    │
-│                        ↓                                         │
-│  8. Return result to user                                       │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-**Key Services:**
-- `CreditService.check_credits()` - Pre-flight balance check
-- `CreditService.calculate_credits_from_tokens()` - Token-based calculation
-- `CreditService.deduct_credits_for_operation()` - Deduct and log
-
-### 2.2 Limit Enforcement Flow
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                   LIMIT ENFORCEMENT WORKFLOW                     │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  HARD LIMITS (Sites, Users, Keywords, Clusters)                 │
-│  ───────────────────────────────────────────────                │
-│  1. User attempts to create new resource                        │
-│                        ↓                                         │
-│  2. LimitService.check_hard_limit(account, limit_type, count)   │
-│     • Query database for current count                          │
-│     • Compare: current_count + new_count <= plan.max_XXX        │
-│                        ↓                                         │
-│  3. If exceeded: Raise HardLimitExceededError                   │
-│     If OK: Allow creation                                       │
-│                                                                  │
-│  MONTHLY LIMITS (Ideas, Words, Images, Prompts)                 │
-│  ─────────────────────────────────────────────                  │
-│  1. User attempts AI operation                                  │
-│                        ↓                                         │
-│  2. LimitService.check_monthly_limit(account, limit_type, amount)│
-│     • Read from Account.usage_XXX field                         │
-│     • Compare: current_usage + amount <= plan.max_XXX           │
-│                        ↓                                         │
-│  3. If exceeded: Raise MonthlyLimitExceededError                │
-│     If OK: Proceed with operation                               │
-│                        ↓                                         │
-│  4. After operation: LimitService.increment_usage()             │
-│     • Update Account.usage_XXX field                            │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-**Key Services:**
-- `LimitService.check_hard_limit()` - Check persistent limits
-- `LimitService.check_monthly_limit()` - Check monthly allowances
-- `LimitService.increment_usage()` - Update monthly usage counters
-- `LimitService.get_usage_summary()` - Get all limits and usage
-
----
-
-## 3. Current Limits Configuration
-
-### 3.1 Items That ARE Limit-Based (User-Requested)
-
-| Item | Type | Plan Field | Enforcement Location | Status |
-|------|------|-----------|---------------------|--------|
-| **Sites** | Hard Limit | `max_sites` | Account creation, Site model | ✅ Enforced |
-| **Team Users** | Hard Limit | `max_users` | User invite, SiteUserAccess model | ✅ Enforced |
-| **Keywords** | Hard Limit | `max_keywords` | Keyword import/creation | ⚠️ PARTIAL (see below) |
-
-### 3.2 Items That Should Have Limits (Future)
-
-| Item | Type | Plan Field | Status | Notes |
-|------|------|-----------|--------|-------|
-| **Ahrefs Queries** | Monthly Limit | `max_ahrefs_queries` (new) | ❌ Not Implemented | Future feature for keyword research |
-
-### 3.3 Items NOT Limit-Based (Credit-Based)
-
-| Item | Enforcement | Notes |
-|------|------------|-------|
-| **AI Content Generation** | Credits | Token-based calculation via AIModelConfig |
-| **AI Image Generation** | Credits | Fixed credits per image (1, 5, or 15) |
-| **AI Clustering** | Credits | Token-based calculation |
-| **AI Idea Generation** | Credits | Token-based calculation |
-| **Internal Linking** | Credits | 8 credits per content piece |
-| **SEO Optimization** | Credits | 1 credit per 200 words |
-
-**Important:** Monthly limits exist for these (max_content_ideas, max_content_words, max_images_basic, etc.) but they serve as **soft limits for cost control**, not hard enforcement. Users are primarily constrained by credits.
-
----
-
-## 4. Data Duplication Issues
-
-### 4.1 Problem: Overlapping Data Across Pages
-
-**Current Situation:**
-
-| Data Type | Plans & Billing | Usage Analytics | Duplication Level |
-|-----------|----------------|-----------------|-------------------|
-| **Credit Balance** | ✅ Shown in Current Plan tab | ✅ Shown in all tabs (top cards) | 🔴 HIGH |
-| **Monthly Usage** | ✅ Credits used this month | ✅ Credits used this month | 🔴 HIGH |
-| **Plan Limits** | ✅ Shown in plan details | ✅ Full limits panel with progress bars | 🟡 MEDIUM |
-| **Credit Transactions** | ✅ Billing History tab | ✅ Credit History tab | 🔴 HIGH |
-
-**Example of Duplication:**
-
-**Plans & Billing - Current Plan Tab:**
-```tsx
-<Card>
-  <h3>Current Plan: {planName}</h3>
-  <div>Credits: {creditBalance.credits}</div>
-  <div>Used This Month: {creditBalance.credits_used_this_month}</div>
-  <div>Monthly Allowance: {creditBalance.plan_credits_per_month}</div>
-</Card>
-```
-
-**Usage Analytics - Limits Tab:**
-```tsx
-<Card>
-  <div>Credits Left: {creditBalance.credits}</div>
-  <div>Credits Used This Month: {creditBalance.credits_used_this_month}</div>
-  <div>Your Monthly Limit: {creditBalance.plan_credits_per_month}</div>
-</Card>
-```
-
-### 4.2 Problem: Confusing User Journey
-
-**Current User Experience Issues:**
-
-1. **Credit Balance** appears in BOTH dropdowns
-   - Plans & Billing → Current Plan → Shows credit balance
-   - Usage → All tabs → Shows credit balance in top cards
-
-2. **Transaction History** appears in BOTH dropdowns
-   - Plans & Billing → History → Shows invoices and payments
-   - Usage → Credit History → Shows credit transactions
-
-3. **Plan Limits** appears in BOTH dropdowns
-   - Plans & Billing → Current Plan → Shows plan features and limits
-   - Usage → Limits & Usage → Shows detailed progress bars for all limits
-
-**User Confusion:**
-- "Where do I check my credits?" → Two places
-- "Where do I see my usage?" → Two places
-- "Where do I see my transaction history?" → Two places
-
----
-
-## 5. Enforcement Analysis
-
-### 5.1 Well-Enforced Limits ✅
-
-#### Sites (max_sites)
-**Enforcement Location:** `backend/igny8_core/auth/models.py` (Site model)
-```python
-# When creating a new site
-LimitService.check_hard_limit(account, 'sites', 1)
-```
-
-**Status:** ✅ **FULLY ENFORCED**  
-**Works:** Users cannot create more sites than their plan allows
-
-#### Team Users (max_users)
-**Enforcement Location:** User invite flow
-```python
-# When inviting a new user
-LimitService.check_hard_limit(account, 'users', 1)
-```
-
-**Status:** ✅ **FULLY ENFORCED**  
-**Works:** Users cannot invite more team members than their plan allows
-
----
-
-### 5.2 Partially Enforced Limits ⚠️
-
-#### Keywords (max_keywords)
-
-**Current State:**
-- ✅ Plan field exists: `Plan.max_keywords`
-- ✅ LimitService has mapping:
-  ```python
-  'keywords': {
-      'model': 'planner.Keywords',
-      'plan_field': 'max_keywords',
-      'display_name': 'Keywords',
-      'filter_field': 'account',
-  }
-  ```
-- ⚠️ **ENFORCEMENT INCONSISTENT**
-
-**Evidence from Code Search:**
-
-Found in `backend/igny8_core/business/planning/models.py`:
-```python
-from igny8_core.business.billing.services.limit_service import LimitService
-
-# Only enforced in SOME locations:
-LimitService.increment_usage(
-    account=self.account,
-    limit_type='keywords',
-    amount=1
-)
-```
-
-**Problem:** 
-- Keyword import from SeedKeywords may not check limit
-- Keyword creation via API may not check limit consistently
-- Manual keyword creation may bypass checks
-
-**Impact:**
-- Users may exceed keyword limits without errors
-- Limits shown in UI but not enforced at all entry points
-
-**Recommended Fix:**
-1. Add pre-create check to all keyword creation flows:
-   ```python
-   # Before creating keyword
-   LimitService.check_hard_limit(account, 'keywords', 1)
-   ```
-2. Locations to add enforcement:
-   - `addSeedKeywordsToWorkflow` API endpoint
-   - Keyword bulk import
-   - Manual keyword creation form
-   - CSV import
-
----
-
-### 5.3 Missing Future Limits ❌
-
-#### Ahrefs Keyword Queries (Planned)
-
-**User Requirement:**
-> "in future soon we will have option for user to query and research keywords from ahrefs, which will also have monthly limit"
-
-**Current State:**
-- ❌ No plan field defined
-- ❌ No LimitService mapping
-- ❌ No enforcement
-
-**Current Keywords Situation:**
-- **Existing:** Pre-searched keywords from IGNY8's own database (SeedKeywords)
-- **Limited by:** `max_keywords` (how many they can add to their workspace)
-- **Future:** Ahrefs API queries (need new monthly limit)
-
-**Recommended Implementation:**
-
-1. **Add Plan Field:**
-   ```python
-   # backend/igny8_core/auth/models.py - Plan model
-   max_ahrefs_queries = models.IntegerField(
-       default=50,
-       validators=[MinValueValidator(0)],
-       help_text="Maximum Ahrefs keyword queries per month"
-   )
-   ```
-
-2. **Add Account Usage Field:**
-   ```python
-   # backend/igny8_core/auth/models.py - Account model
-   usage_ahrefs_queries = models.IntegerField(
-       default=0,
-       validators=[MinValueValidator(0)],
-       help_text="Ahrefs queries used this month"
-   )
-   ```
-
-3. **Add LimitService Mapping:**
-   ```python
-   # backend/igny8_core/business/billing/services/limit_service.py
-   MONTHLY_LIMIT_MAPPINGS = {
-       # ... existing mappings ...
-       'ahrefs_queries': {
-           'plan_field': 'max_ahrefs_queries',
-           'usage_field': 'usage_ahrefs_queries',
-           'display_name': 'Ahrefs Keyword Queries',
-       },
-   }
-   ```
-
-4. **Enforce Before Query:**
-   ```python
-   # In Ahrefs query service
-   def query_ahrefs_keywords(account, query):
-       # Check limit
-       LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)
-       
-       # Execute query
-       results = ahrefs_api.search_keywords(query)
-       
-       # Increment usage
-       LimitService.increment_usage(account, 'ahrefs_queries', 1)
-       
-       return results
-   ```
-
----
-
-## 6. IMPLEMENTATION PLAN
-
-### 6.1 Phase 1: Backend Cleanup (Week 1)
-
-#### 1.1 Remove Unused Monthly Limits from Database
-
-**File:** `backend/igny8_core/auth/models.py`
-
-**Remove from Plan Model:**
-```python
-# REMOVE THESE FIELDS:
-max_content_ideas = models.IntegerField(...)      # ❌ DELETE
-max_content_words = models.IntegerField(...)      # ❌ DELETE
-max_images_basic = models.IntegerField(...)       # ❌ DELETE
-max_images_premium = models.IntegerField(...)     # ❌ DELETE
-max_image_prompts = models.IntegerField(...)      # ❌ DELETE
-max_clusters = models.IntegerField(...)           # ❌ DELETE (or merge with keywords)
-```
-
-**Remove from Account Model:**
-```python
-# REMOVE THESE FIELDS:
-usage_content_ideas = models.IntegerField(...)    # ❌ DELETE
-usage_content_words = models.IntegerField(...)    # ❌ DELETE
-usage_images_basic = models.IntegerField(...)     # ❌ DELETE
-usage_images_premium = models.IntegerField(...)   # ❌ DELETE
-usage_image_prompts = models.IntegerField(...)    # ❌ DELETE
-```
-
-**KEEP ONLY:**
-```python
-# Plan Model - KEEP THESE:
-max_sites = models.IntegerField(default=1)        # ✅ KEEP
-max_users = models.IntegerField(default=1)        # ✅ KEEP
-max_keywords = models.IntegerField(default=1000)  # ✅ KEEP
-max_ahrefs_queries = models.IntegerField(default=50)  # 🆕 ADD
-
-# Account Model - KEEP THESE:
-credits = models.IntegerField(default=0)          # ✅ KEEP
-usage_ahrefs_queries = models.IntegerField(default=0)  # 🆕 ADD
-usage_period_start = models.DateTimeField(...)    # ✅ KEEP
-usage_period_end = models.DateTimeField(...)      # ✅ KEEP
-```
-
-**Migration Script:**
-```python
-# Create migration: 0XXX_remove_unused_limits.py
-operations = [
-    # Remove from Plan
-    migrations.RemoveField(model_name='plan', name='max_content_ideas'),
-    migrations.RemoveField(model_name='plan', name='max_content_words'),
-    migrations.RemoveField(model_name='plan', name='max_images_basic'),
-    migrations.RemoveField(model_name='plan', name='max_images_premium'),
-    migrations.RemoveField(model_name='plan', name='max_image_prompts'),
-    migrations.RemoveField(model_name='plan', name='max_clusters'),
-    
-    # Remove from Account
-    migrations.RemoveField(model_name='account', name='usage_content_ideas'),
-    migrations.RemoveField(model_name='account', name='usage_content_words'),
-    migrations.RemoveField(model_name='account', name='usage_images_basic'),
-    migrations.RemoveField(model_name='account', name='usage_images_premium'),
-    migrations.RemoveField(model_name='account', name='usage_image_prompts'),
-    
-    # Add Ahrefs fields
-    migrations.AddField(
-        model_name='plan',
-        name='max_ahrefs_queries',
-        field=models.IntegerField(default=50, validators=[MinValueValidator(0)])
-    ),
-    migrations.AddField(
-        model_name='account',
-        name='usage_ahrefs_queries',
-        field=models.IntegerField(default=0, validators=[MinValueValidator(0)])
-    ),
-]
-```
-
-#### 1.2 Update LimitService
-
-**File:** `backend/igny8_core/business/billing/services/limit_service.py`
-
-**Remove from MONTHLY_LIMIT_MAPPINGS:**
-```python
-# DELETE THESE:
-'content_ideas': {...},       # ❌ DELETE
-'content_words': {...},       # ❌ DELETE
-'images_basic': {...},        # ❌ DELETE
-'images_premium': {...},      # ❌ DELETE
-'image_prompts': {...},       # ❌ DELETE
-```
-
-**Keep/Add:**
-```python
-MONTHLY_LIMIT_MAPPINGS = {
-    # ONLY THIS ONE:
-    'ahrefs_queries': {
-        'plan_field': 'max_ahrefs_queries',
-        'usage_field': 'usage_ahrefs_queries',
-        'display_name': 'Ahrefs Keyword Research',
-    },
-}
-
-# Remove from HARD_LIMIT_MAPPINGS:
-'clusters': {...},  # ❌ DELETE (or keep if needed)
-```
-
-#### 1.3 Update Serializers
-
-**File:** `backend/igny8_core/auth/serializers.py`
-
-```python
-class PlanSerializer(serializers.ModelSerializer):
-    class Meta:
-        fields = [
-            'id', 'name', 'slug', 'price', 'billing_cycle',
-            # KEEP ONLY THESE LIMITS:
-            'max_sites',
-            'max_users', 
-            'max_keywords',
-            'max_ahrefs_queries',  # NEW
-            # CREDITS:
-            'included_credits',
-            'extra_credit_price',
-            # REMOVE ALL OTHER max_* fields
-        ]
-```
-
-#### 1.4 Remove Limit Checks from AI Operations
-
-**Search and Remove:**
-```bash
-# Find all places checking monthly limits
-grep -r "check_monthly_limit.*content_ideas" backend/
-grep -r "check_monthly_limit.*content_words" backend/
-grep -r "check_monthly_limit.*images" backend/
-grep -r "increment_usage.*content_ideas" backend/
-```
-
-**Replace with credit checks only:**
-```python
-# OLD (REMOVE):
-LimitService.check_monthly_limit(account, 'content_ideas', 1)
-LimitService.increment_usage(account, 'content_ideas', 1)
-
-# NEW (KEEP):
-CreditService.check_credits(account, required_credits)
-# Then after operation:
-CreditService.deduct_credits_for_operation(...)
-```
-
-#### 1.5 Add Credit Balance Check to Automation
-
-**File:** `backend/igny8_core/business/automation/services.py` (or similar)
-
-```python
-from igny8_core.business.billing.services.credit_service import CreditService
-from igny8_core.business.billing.exceptions import InsufficientCreditsError
-
-def run_automation(automation_config, account):
-    """Run automation with credit pre-check"""
-    
-    # Estimate credits needed
-    estimated_credits = estimate_automation_cost(automation_config)
-    
-    # Check balance BEFORE starting
-    try:
-        CreditService.check_credits(account, estimated_credits)
-    except InsufficientCreditsError:
-        raise AutomationError(
-            f"Insufficient credits. Need {estimated_credits}, have {account.credits}. "
-            f"Please add credits to continue."
-        )
-    
-    # Run automation stages
-    for stage in automation_config.stages:
-        # Each stage checks/deducts its own credits
-        run_stage(stage, account)
-```
-
-#### 1.6 Enforce Keywords Limit Properly
-
-**Files to Update:**
-- `backend/igny8_core/business/planning/views.py` (keyword creation)
-- `backend/igny8_core/api/endpoints/seed_keywords.py` (SeedKeyword import)
-
-```python
-from igny8_core.business.billing.services.limit_service import LimitService, HardLimitExceededError
-
-# Before creating keywords:
-try:
-    LimitService.check_hard_limit(account, 'keywords', num_keywords_to_add)
-except HardLimitExceededError as e:
-    return Response({
-        'error': 'keyword_limit_exceeded',
-        'message': f'You have reached your keyword limit ({plan.max_keywords}). Upgrade your plan to add more.',
-        'current_count': current_count,
-        'limit': plan.max_keywords,
-        'upgrade_url': '/account/plans/upgrade'
-    }, status=402)
-
-# If check passes, create keywords
-keywords = Keywords.objects.bulk_create([...])
-```
-
----
-
-### 6.2 Phase 2: Frontend Cleanup (Week 2)
-
-#### 2.1 Remove Duplicate Data from Plans & Billing Page
-
-**File:** `frontend/src/pages/account/PlansAndBillingPage.tsx`
-
-**Current Plan Tab - Remove:**
-```tsx
-// ❌ DELETE: Credit balance display (move to Usage only)
-// ❌ DELETE: Usage breakdown charts
-// ❌ DELETE: Limit progress bars
-// ❌ DELETE: "Credits used this month" details
-```
-
-**Current Plan Tab - Keep:**
-```tsx
-// ✅ KEEP: Plan name, price, billing cycle
-// ✅ KEEP: Renewal date
-// ✅ KEEP: Brief summary text: "50 Pages/Articles • 2 Sites • 2 Users"
-// ✅ KEEP: Upgrade CTA button
-```
-
-#### 2.2 Redesign Usage Page with Multi-Dimensional Insights
-
-**File:** `frontend/src/pages/account/UsageAnalyticsPage.tsx`
-
-**New Structure:**
-
-```tsx
-/**
- * Usage & Insights Page - Complete Redesign
- * 
- * Tab 1: Overview (NEW)
- *   - Credit balance cards
- *   - Quick stats (sites, users, keywords count)
- *   - Period selector (7, 30, 90 days)
- *   - Top metrics
- * 
- * Tab 2: Your Limits
- *   - Sites, Users, Keywords progress bars
- *   - Ahrefs queries remaining
- * 
- * Tab 3: Credit Insights (NEW)
- *   - Credits by Site
- *   - Credits by Content Type (articles, images, etc.)
- *   - Credits by Image Quality (basic, quality, premium)
- *   - Credits by Automation
- *   - Timeline chart (7/30/90 days)
- * 
- * Tab 4: Activity Log
- *   - Detailed transaction history
- */
-
-type TabType = 'overview' | 'limits' | 'insights' | 'activity';
-```
-
-**Tab 1: Overview (NEW)**
-```tsx
-<div className="grid grid-cols-1 md:grid-cols-4 gap-4">
-  {/* Credit Balance Card */}
-  <Card>
-    <ZapIcon />
-    <div>Credits Available</div>
-    <div className="text-3xl">{credits.toLocaleString()}</div>
-  </Card>
-
-  {/* Sites Used Card */}
-  <Card>
-    <GlobeIcon />
-    <div>Sites</div>
-    <div className="text-3xl">{sitesCount} / {maxSites}</div>
-  </Card>
-
-  {/* Team Members Card */}
-  <Card>
-    <UsersIcon />
-    <div>Team Members</div>
-    <div className="text-3xl">{usersCount} / {maxUsers}</div>
-  </Card>
-
-  {/* Keywords Card */}
-  <Card>
-    <TagIcon />
-    <div>Keywords</div>
-    <div className="text-3xl">{keywordsCount.toLocaleString()} / {maxKeywords.toLocaleString()}</div>
-  </Card>
-</div>
-
-{/* Period Selector */}
-<div className="flex gap-2">
-  <Button onClick={() => setPeriod(7)}>Last 7 Days</Button>
-  <Button onClick={() => setPeriod(30)}>Last 30 Days</Button>
-  <Button onClick={() => setPeriod(90)}>Last 90 Days</Button>
-</div>
-```
-
-**Tab 3: Credit Insights (NEW)**
-```tsx
-{/* Credits by Site */}
-<Card>
-  <h3>Credits by Site</h3>
-  {sites.map(site => (
-    <div key={site.id}>
-      <div>{site.name}</div>
-      <ProgressBar value={site.credits_used} max={totalCredits} />
-      <div>{site.credits_used.toLocaleString()} credits</div>
-    </div>
-  ))}
-</Card>
-
-{/* Credits by Content Type */}
-<Card>
-  <h3>Credits by Content Type</h3>
-  <DonutChart data={[
-    { label: 'Articles', value: contentCredits },
-    { label: 'Images', value: imageCredits },
-    { label: 'Ideas & Planning', value: ideaCredits },
-    { label: 'Other', value: otherCredits },
-  ]} />
-</Card>
-
-{/* Credits by Image Quality */}
-<Card>
-  <h3>Image Generation by Quality</h3>
-  {imageQualityBreakdown.map(tier => (
-    <div key={tier.quality}>
-      <div>{tier.quality} Quality</div>
-      <div>{tier.count} images • {tier.credits_used} credits</div>
-      <div className="text-xs">({tier.credits_per_image} credits each)</div>
-    </div>
-  ))}
-</Card>
-
-{/* Credits by Automation */}
-<Card>
-  <h3>Automation Runs</h3>
-  {automations.map(auto => (
-    <div key={auto.id}>
-      <div>{auto.name}</div>
-      <div>{auto.runs_count} runs • {auto.credits_used} credits</div>
-    </div>
-  ))}
-</Card>
-
-{/* Timeline Chart */}
-<Card>
-  <h3>Credit Usage Over Time</h3>
-  <LineChart 
-    data={usageTimeline}
-    xAxis="date"
-    yAxis="credits_used"
-  />
-</Card>
-```
-
-#### 2.3 Update API Interfaces
-
-**File:** `frontend/src/services/billing.api.ts`
-
-```typescript
-// REMOVE from Plan interface:
-export interface Plan {
-  id: number;
-  name: string;
-  price: number;
-  
-  // KEEP ONLY THESE LIMITS:
-  max_sites?: number;
-  max_users?: number;
-  max_keywords?: number;
-  max_ahrefs_queries?: number;  // NEW
-  
-  included_credits?: number;
-  
-  // REMOVE THESE:
-  // max_content_ideas?: number;     // ❌ DELETE
-  // max_content_words?: number;     // ❌ DELETE
-  // max_images_basic?: number;      // ❌ DELETE
-  // max_images_premium?: number;    // ❌ DELETE
-  // max_image_prompts?: number;     // ❌ DELETE
-  // max_clusters?: number;          // ❌ DELETE
-}
-
-// UPDATE UsageSummary interface:
-export interface UsageSummary {
-  account_id: number;
-  plan_name: string;
-  period_start: string;
-  period_end: string;
-  
-  hard_limits: {
-    sites?: LimitUsage;
-    users?: LimitUsage;
-    keywords?: LimitUsage;
-    // clusters?: LimitUsage;  // ❌ DELETE
-  };
-  
-  monthly_limits: {
-    ahrefs_queries?: LimitUsage;  // ONLY THIS ONE
-    // content_ideas?: LimitUsage;     // ❌ DELETE
-    // content_words?: LimitUsage;     // ❌ DELETE
-    // images_basic?: LimitUsage;      // ❌ DELETE
-    // images_premium?: LimitUsage;    // ❌ DELETE
-    // image_prompts?: LimitUsage;     // ❌ DELETE
-  };
-}
-
-// NEW: Multi-dimensional insights
-export interface CreditInsights {
-  period_days: number;
-  total_credits_used: number;
-  
-  by_site: Array<{
-    site_id: number;
-    site_name: string;
-    credits_used: number;
-    percentage: number;
-  }>;
-  
-  by_operation: Array<{
-    operation_type: string;
-    display_name: string;
-    credits_used: number;
-    count: number;
-    percentage: number;
-  }>;
-  
-  by_image_quality: Array<{
-    quality_tier: 'basic' | 'quality' | 'premium';
-    model_name: string;
-    credits_per_image: number;
-    images_generated: number;
-    total_credits: number;
-  }>;
-  
-  by_automation: Array<{
-    automation_id: number;
-    automation_name: string;
-    runs_count: number;
-    credits_used: number;
-  }>;
-  
-  timeline: Array<{
-    date: string;
-    credits_used: number;
-  }>;
-}
-
-// NEW API function
-export async function getCreditInsights(days: number = 30): Promise<CreditInsights> {
-  return fetchAPI(`/v1/billing/credits/insights/?days=${days}`);
-}
-```
-
-#### 2.4 Update UsageLimitsPanel Component
-
-**File:** `frontend/src/components/billing/UsageLimitsPanel.tsx`
-
-```tsx
-// REMOVE monthly limit configs for deleted fields
-const monthlyLimitConfig = {
-  // ONLY THIS ONE:
-  ahrefs_queries: { 
-    icon: <SearchIcon className="w-5 h-5" />, 
-    color: 'purple' as const,
-    description: 'Keyword research queries per month'
-  },
-  
-  // DELETE THESE:
-  // content_ideas: {...},    // ❌ DELETE
-  // content_words: {...},    // ❌ DELETE
-  // images_basic: {...},     // ❌ DELETE
-  // images_premium: {...},   // ❌ DELETE
-  // image_prompts: {...},    // ❌ DELETE
-};
-
-// KEEP hard limits
-const hardLimitConfig = {
-  sites: { icon: <GlobeIcon />, color: 'success' },
-  users: { icon: <UsersIcon />, color: 'info' },
-  keywords: { icon: <TagIcon />, color: 'purple' },
-  // clusters: {...},  // ❌ DELETE if not needed
-};
-```
-
-#### 2.5 Use User-Friendly Terminology
-
-**Global Search & Replace:**
-
-| Technical Term | User-Friendly Term |
-|---------------|-------------------|
-| "API Activity" | "Activity Log" or "Recent Actions" |
-| "API Operations" | "Actions" or "Activities" |
-| "operation_type" | "Action Type" |
-| "Monthly Limits" | "Monthly Allowances" |
-| "Hard Limits" | "Plan Limits" |
-| "Credits Used" | "Credits Spent" |
-| "Balance" | "Credits Available" |
-
----
-
-### 6.3 Phase 3: Keyword Research Implementation (Week 3)
-
-#### 3.1 Backend: Ahrefs Service
-
-**Create:** `backend/igny8_core/business/keywords/ahrefs_service.py`
-
-```python
-from igny8_core.business.billing.services.limit_service import LimitService, MonthlyLimitExceededError
-import requests
-
-class AhrefsService:
-    """Service for Ahrefs keyword research with monthly limit enforcement"""
-    
-    @staticmethod
-    def query_keywords(account, query_params):
-        """
-        Query Ahrefs for keywords with limit enforcement.
-        
-        Args:
-            account: Account instance
-            query_params: dict with search parameters
-            
-        Returns:
-            dict: Ahrefs API response with keyword data
-            
-        Raises:
-            MonthlyLimitExceededError: If monthly Ahrefs query limit exceeded
-        """
-        # Check monthly limit BEFORE querying
-        try:
-            LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)
-        except MonthlyLimitExceededError as e:
-            raise AhrefsQueryLimitExceeded(
-                f"You've used all your Ahrefs queries this month. "
-                f"Limit: {account.plan.max_ahrefs_queries}. "
-                f"Resets on {account.usage_period_end.strftime('%B %d, %Y')}. "
-                f"Upgrade your plan for more queries."
-            )
-        
-        # Make Ahrefs API call
-        try:
-            response = requests.post(
-                'https://api.ahrefs.com/v3/site-explorer/keywords',
-                headers={'Authorization': f'Bearer {settings.AHREFS_API_KEY}'},
-                json=query_params
-            )
-            response.raise_for_status()
-            results = response.json()
-            
-            # Increment usage counter
-            LimitService.increment_usage(account, 'ahrefs_queries', 1)
-            
-            return results
-            
-        except requests.RequestException as e:
-            logger.error(f"Ahrefs API error: {e}")
-            raise AhrefsAPIError("Failed to fetch keyword data from Ahrefs")
-```
-
-#### 3.2 Frontend: Keyword Research Page
-
-**Create:** `frontend/src/pages/Planner/KeywordResearchPage.tsx`
-
-```tsx
-/**
- * Keyword Research Page - Two Options
- * 1. Browse IGNY8 pre-researched keywords (free)
- * 2. Research with Ahrefs (monthly limit)
- */
-
-type ResearchTab = 'browse' | 'ahrefs';
-
-export default function KeywordResearchPage() {
-  const [activeTab, setActiveTab] = useState<ResearchTab>('browse');
-  const [ahrefsLimit, setAhrefsLimit] = useState({ used: 0, limit: 50 });
-
-  return (
-    <>
-      <PageHeader 
-        title="Keyword Research" 
-        description="Find high-opportunity keywords for your content strategy"
-      />
-
-      {/* Tab Selector */}
-      <div className="flex gap-4 mb-6">
-        <Button
-          variant={activeTab === 'browse' ? 'primary' : 'outline'}
-          onClick={() => setActiveTab('browse')}
-        >
-          <DatabaseIcon className="w-4 h-4" />
-          Browse Pre-Researched Keywords
-        </Button>
-        
-        <Button
-          variant={activeTab === 'ahrefs' ? 'primary' : 'outline'}
-          onClick={() => setActiveTab('ahrefs')}
-        >
-          <SearchIcon className="w-4 h-4" />
-          Research with Ahrefs
-          <Badge variant="soft" tone="purple">
-            {ahrefsLimit.limit - ahrefsLimit.used} remaining
-          </Badge>
-        </Button>
-      </div>
-
-      {/* Tab Content */}
-      {activeTab === 'browse' && (
-        <BrowseKeywordsPanel />
-      )}
-
-      {activeTab === 'ahrefs' && (
-        <AhrefsResearchPanel 
-          limit={ahrefsLimit}
-          onQuerySuccess={() => {
-            setAhrefsLimit(prev => ({ 
-              ...prev, 
-              used: prev.used + 1 
-            }));
-          }}
-        />
-      )}
-    </>
-  );
-}
-```
-
-**Browse Keywords Panel (Existing SeedKeywords):**
-```tsx
-function BrowseKeywordsPanel() {
-  return (
-    <Card>
-      <h3>Pre-Researched High-Opportunity Keywords</h3>
-      <p>Browse thousands of analyzed keywords, ready to use.</p>
-      
-      {/* Filters */}
-      <div className="flex gap-4">
-        <Select label="Industry" options={industries} />
-        <Select label="Sector" options={sectors} />
-        <Select label="Country" options={countries} />
-        <Input placeholder="Search keywords..." />
-      </div>
-
-      {/* Results Table */}
-      <Table>
-        <thead>
-          <tr>
-            <th>Keyword</th>
-            <th>Search Volume</th>
-            <th>Difficulty</th>
-            <th>Opportunity Score</th>
-            <th></th>
-          </tr>
-        </thead>
-        <tbody>
-          {keywords.map(kw => (
-            <tr key={kw.id}>
-              <td>{kw.keyword}</td>
-              <td>{kw.search_volume}</td>
-              <td><Badge>{kw.difficulty}</Badge></td>
-              <td>{kw.opportunity_score}/100</td>
-              <td>
-                <Button size="sm" onClick={() => addToWorkspace(kw)}>
-                  Add to Workspace
-                </Button>
-              </td>
-            </tr>
-          ))}
-        </tbody>
-      </Table>
-    </Card>
-  );
-}
-```
-
-**Ahrefs Research Panel (NEW):**
-```tsx
-function AhrefsResearchPanel({ limit, onQuerySuccess }) {
-  const [query, setQuery] = useState('');
-  const [results, setResults] = useState([]);
-  const [loading, setLoading] = useState(false);
-
-  const remaining = limit.limit - limit.used;
-  const canQuery = remaining > 0;
-
-  const handleSearch = async () => {
-    if (!canQuery) {
-      toast.error('You have used all your Ahrefs queries this month.');
-      return;
-    }
-
-    try {
-      setLoading(true);
-      const data = await fetchAPI('/v1/keywords/ahrefs/search/', {
-        method: 'POST',
-        body: JSON.stringify({ query })
-      });
-      setResults(data.keywords);
-      onQuerySuccess();
-      toast.success('Keywords fetched from Ahrefs!');
-    } catch (error) {
-      toast.error(error.message);
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  return (
-    <Card>
-      <div className="flex items-center justify-between mb-4">
-        <h3>Live Keyword Research with Ahrefs</h3>
-        <Badge variant="soft" tone={remaining > 10 ? 'success' : 'warning'}>
-          {remaining} / {limit.limit} queries remaining
-        </Badge>
-      </div>
-
-      {!canQuery && (
-        <Alert tone="warning">
-          <AlertCircleIcon />
-          <div>
-            <div>No queries remaining</div>
-            <div>Your limit resets on {resetDate}. Upgrade for more queries.</div>
-            <Button size="sm" onClick={() => navigate('/account/plans/upgrade')}>
-              Upgrade Plan
-            </Button>
-          </div>
-        </Alert>
-      )}
-
-      {canQuery && (
-        <>
-          <div className="flex gap-4 mb-4">
-            <Input
-              placeholder="Enter seed keyword (e.g., 'digital marketing')"
-              value={query}
-              onChange={e => setQuery(e.target.value)}
-              onKeyPress={e => e.key === 'Enter' && handleSearch()}
-            />
-            <Button onClick={handleSearch} loading={loading}>
-              <SearchIcon /> Research Keywords
-            </Button>
-          </div>
-
-          {/* Results */}
-          {results.length > 0 && (
-            <Table>
-              <thead>
-                <tr>
-                  <th>Keyword</th>
-                  <th>Volume</th>
-                  <th>Difficulty</th>
-                  <th>CPC</th>
-                  <th></th>
-                </tr>
-              </thead>
-              <tbody>
-                {results.map((kw, idx) => (
-                  <tr key={idx}>
-                    <td>{kw.keyword}</td>
-                    <td>{kw.volume.toLocaleString()}</td>
-                    <td><Badge>{kw.difficulty}</Badge></td>
-                    <td>${kw.cpc}</td>
-                    <td>
-                      <Button size="sm" onClick={() => addToWorkspace(kw)}>
-                        Add to Workspace
-                      </Button>
-                    </td>
-                  </tr>
-                ))}
-              </tbody>
-            </Table>
-          )}
-        </>
-      )}
-    </Card>
-  );
-}
-```
-
----
-
-### 6.4 Phase 4: Validation & Enforcement (Week 4)
-
-#### 4.1 Credit Balance Validation Checklist
-
-**File:** Search all AI operation services
-
-```python
-# REQUIRED PATTERN for all AI operations:
-
-# 1. BEFORE operation - estimate and check
-estimated_credits = estimate_credits_needed(operation_params)
-CreditService.check_credits(account, estimated_credits)
-
-# 2. EXECUTE operation
-result = ai_service.execute(operation_params)
-
-# 3. AFTER operation - calculate actual and deduct
-actual_tokens = result.usage.total_tokens
-actual_credits = CreditService.calculate_credits_from_tokens(
-    operation_type='content_generation',
-    tokens_input=result.usage.prompt_tokens,
-    tokens_output=result.usage.completion_tokens
-)
-CreditService.deduct_credits_for_operation(
-    account=account,
-    operation_type='content_generation',
-    amount=actual_credits,
-    model=result.model,
-    tokens_in=result.usage.prompt_tokens,
-    tokens_out=result.usage.completion_tokens,
-    metadata={'content_id': content.id}
-)
-```
-
-**Locations to Verify:**
-- ✅ Content generation service
-- ✅ Image generation service
-- ✅ Idea generation service
-- ✅ Clustering service
-- ✅ Internal linking service
-- ✅ Optimization service
-- ✅ Automation runner (PRE-CHECK before starting!)
-
-#### 4.2 Automation Credit Pre-Check
-
-**File:** `backend/igny8_core/business/automation/services.py`
-
-```python
-def estimate_automation_cost(automation_config):
-    """Estimate credits needed for full automation run"""
-    estimated = 0
-    
-    for stage in automation_config.stages:
-        if stage.type == 'clustering':
-            estimated += 10  # Base estimate
-        elif stage.type == 'idea_generation':
-            estimated += stage.num_ideas * 2
-        elif stage.type == 'content_generation':
-            estimated += stage.num_articles * 50  # Rough estimate
-        elif stage.type == 'image_generation':
-            estimated += stage.num_images * stage.credits_per_image
-        elif stage.type == 'linking':
-            estimated += stage.num_articles * 8
-    
-    # Add 20% buffer
-    return int(estimated * 1.2)
-
-def run_automation(automation_config, account, trigger='manual'):
-    """
-    Run automation with upfront credit validation.
-    
-    Raises:
-        InsufficientCreditsError: If not enough credits available
-    """
-    # Estimate total cost
-    estimated_credits = estimate_automation_cost(automation_config)
-    
-    # CHECK CREDITS BEFORE STARTING
-    try:
-        CreditService.check_credits(account, estimated_credits)
-    except InsufficientCreditsError:
-        # Log failed attempt
-        AutomationRun.objects.create(
-            automation=automation_config,
-            account=account,
-            status='failed',
-            error_message=f'Insufficient credits. Need {estimated_credits}, have {account.credits}.',
-            trigger=trigger
-        )
-        raise
-    
-    # Create run record
-    run = AutomationRun.objects.create(
-        automation=automation_config,
-        account=account,
-        status='running',
-        estimated_credits=estimated_credits,
-        trigger=trigger
-    )
-    
-    try:
-        # Execute stages (each deducts credits)
-        for stage in automation_config.stages:
-            execute_stage(stage, account, run)
-        
-        # Mark complete
-        run.status = 'completed'
-        run.actual_credits = run.credits_used
-        run.save()
-        
-    except Exception as e:
-        run.status = 'failed'
-        run.error_message = str(e)
-        run.save()
-        raise
-```
-
-#### 4.3 Frontend Credit Check Before Actions
-
-**Component:** Add to all credit-consuming actions
-
-```tsx
-// Hook for credit validation
-function useCreditCheck() {
-  const { user } = useAuthStore();
-  
-  const checkCredits = useCallback(async (estimatedCredits: number) => {
-    if (user.account.credits < estimatedCredits) {
-      const confirmed = await showConfirmDialog({
-        title: 'Insufficient Credits',
-        message: `This action requires approximately ${estimatedCredits} credits, but you only have ${user.account.credits} available.`,
-        confirmText: 'Add Credits',
-        cancelText: 'Cancel',
-      });
-      
-      if (confirmed) {
-        navigate('/account/plans');
-      }
-      
-      return false;
-    }
-    
-    return true;
-  }, [user]);
-  
-  return { checkCredits };
-}
-
-// Usage example:
-function GenerateContentButton({ taskId }) {
-  const { checkCredits } = useCreditCheck();
-  
-  const handleGenerate = async () => {
-    // Estimate credits (rough estimate: 50 for article)
-    const canProceed = await checkCredits(50);
-    if (!canProceed) return;
-    
-    // Proceed with generation
-    await generateContent(taskId);
-  };
-  
-  return <Button onClick={handleGenerate}>Generate Content</Button>;
-}
-```
-
----
-
-### 6.5 Phase 5: Testing & Validation (Week 5)
-
-#### Test Cases
-
-**Limit Enforcement:**
-- [ ] Try to create site when at `max_sites` → Should fail with upgrade prompt
-- [ ] Try to invite user when at `max_users` → Should fail with upgrade prompt
-- [ ] Try to add 100 keywords when 50 slots remain and limit is 1000 → Should succeed
-- [ ] Try to add 100 keywords when 30 slots remain → Should fail
-- [ ] Try to query Ahrefs when at monthly limit → Should fail with reset date
-- [ ] Query Ahrefs successfully → Counter increments
-- [ ] Monthly reset → Ahrefs counter resets to 0
-
-**Credit Validation:**
-- [ ] Try to generate content with 0 credits → Should fail immediately
-- [ ] Try to run automation with insufficient credits → Should fail before starting
-- [ ] Generate content → Credits deducted correctly based on tokens
-- [ ] Generate image (basic) → 1 credit deducted
-- [ ] Generate image (quality) → 5 credits deducted
-- [ ] Generate image (premium) → 15 credits deducted
-- [ ] Run automation → All stages check/deduct credits properly
-
-**Page Reorganization:**
-- [ ] Plans & Billing → Current Plan: NO credit usage details
-- [ ] Plans & Billing → Current Plan: Brief summary text only
-- [ ] Usage → Overview: Shows credit balance, sites/users/keywords count
-- [ ] Usage → Limits: Shows only 4 limits (sites, users, keywords, ahrefs)
-- [ ] Usage → Insights: Shows multi-dimensional breakdowns
-- [ ] No duplicate data between Plans & Usage
-
-**Terminology:**
-- [ ] No "API" references in user-facing text
-- [ ] "Operations" changed to "Actions" or "Activities"
-- [ ] User-friendly language throughout
-
----
-
-## 7. Updated Page Reorganization
-
-### 7.1 Page Reorganization (High Priority) 🔥
-
-**Problem:** Data duplication creates confusion and maintenance overhead.
-
-**Proposed Solution:** Clear separation of concerns between Plans & Billing vs Usage.
-
-#### Plans & Billing → Focus on FINANCIAL aspects
-
-**Tab 1: Current Plan**
-- Show: Plan name, price, billing cycle, renewal date
-- Show: Brief limits summary (e.g., "50 Pages/Articles, 2 Sites, 2 Users")
-- **Remove:** Detailed limit progress bars (move to Usage)
-- **Remove:** Credits used this month breakdown (move to Usage)
-- Action: "Upgrade Plan" button
-
-**Tab 2: Upgrade Plan**
-- Show: Pricing table with plan comparison
-- Show: Plan features and limits (static, for comparison)
-- Action: Purchase/upgrade plan
-
-**Tab 3: Billing History**
-- Show: Invoices (with download PDF)
-- Show: Payment methods management
-- Show: Credit package purchases (financial transactions only)
-
-#### Usage → Focus on CONSUMPTION tracking
-
-**Tab 1: Limits & Usage** _(Keep as is - this is perfect)_
-- Show: All hard limits with progress bars (sites, users, keywords, clusters)
-- Show: All monthly limits with progress bars (ideas, words, images)
-- Show: Days until reset for monthly limits
-- Show: Credit balance and monthly usage
-- Action: "Upgrade for more" CTA when approaching limits
-
-**Tab 2: Credit History** _(Keep as is)_
-- Show: Credit transaction log (purchases, deductions, adjustments)
-- Show: Operation details (what consumed credits)
-- Filter: By operation type, date range
-
-**Tab 3: Activity Log** _(Keep as is)_
-- Show: API operations by type
-- Show: Total operations count
-- Show: Breakdown by operation type
-
-#### Summary of Changes
-
-| Page | Current State | Proposed Change |
-|------|--------------|-----------------|
-| **Plans & Billing → Current Plan** | Shows credits, usage, limits | Remove detailed usage, keep financial summary only |
-| **Plans & Billing → History** | Invoices and payments | Keep as is (financial focus) |
-| **Usage → Limits & Usage** | Detailed limits panel | Keep as is (consumption focus) |
-| **Usage → Credit History** | Transaction log | Keep as is (consumption focus) |
-
-**Rationale:**
-- **Plans & Billing** = "What am I paying for?" (financial/subscription management)
-- **Usage** = "What am I using?" (consumption monitoring)
-
----
-
-### 7.1 Plans & Billing Page (Simplified)
-
-**Purpose:** Financial management and subscription control
-
-**Tab 1: Current Plan**
-```tsx
-<Card>
-  <h2>{plan.name} Plan</h2>
-  <div className="text-3xl">${plan.price}/month</div>
-  <div>Renews on {renewalDate}</div>
-  
-  {/* Brief Summary - NO detailed limits */}
-  <div className="text-sm text-gray-600">
-    Your plan includes: {plan.included_credits} credits per month • 
-    {plan.max_sites} sites • {plan.max_users} team members
-  </div>
-  
-  {/* Upgrade CTA */}
-  <Button onClick={() => navigate('/account/plans/upgrade')}>
-    Upgrade Plan
-  </Button>
-</Card>
-
-{/* ❌ REMOVE: Credit usage charts */}
-{/* ❌ REMOVE: Limit progress bars */}
-{/* ❌ REMOVE: "Credits used this month" */}
-```
-
-**Tab 2: Upgrade Plan** _(No changes needed)_
-
-**Tab 3: Billing History** _(No changes needed)_
-
----
-
-### 7.2 Usage Page (Multi-Dimensional Insights)
-
-**Purpose:** Monitor consumption and optimize usage
-
-**Tab 1: Overview (NEW)**
-```tsx
-{/* Quick Stats Cards */}
-<div className="grid grid-cols-4 gap-4">
-  <StatCard 
-    icon={<ZapIcon />}
-    label="Credits Available"
-    value={credits.toLocaleString()}
-    color="brand"
-  />
-  <StatCard 
-    icon={<GlobeIcon />}
-    label="Sites"
-    value={`${sitesCount} / ${maxSites}`}
-    color="success"
-  />
-  <StatCard 
-    icon={<UsersIcon />}
-    label="Team Members"
-    value={`${usersCount} / ${maxUsers}`}
-    color="info"
-  />
-  <StatCard 
-    icon={<TagIcon />}
-    label="Keywords"
-    value={`${keywordsCount} / ${maxKeywords}`}
-    color="purple"
-  />
-</div>
-
-{/* Period Selector */}
-<ButtonGroup>
-  <Button onClick={() => setPeriod(7)}>Last 7 Days</Button>
-  <Button onClick={() => setPeriod(30)}>Last 30 Days</Button>
-  <Button onClick={() => setPeriod(90)}>Last 90 Days</Button>
-</ButtonGroup>
-
-{/* Top Metrics for Selected Period */}
-<div className="grid grid-cols-3 gap-4">
-  <Card>
-    <div>Credits Spent</div>
-    <div className="text-2xl">{periodCredits.toLocaleString()}</div>
-  </Card>
-  <Card>
-    <div>Articles Created</div>
-    <div className="text-2xl">{periodArticles}</div>
-  </Card>
-  <Card>
-    <div>Images Generated</div>
-    <div className="text-2xl">{periodImages}</div>
-  </Card>
-</div>
-```
-
-**Tab 2: Your Limits**
-```tsx
-{/* Only 4 limits total */}
-<LimitCard
-  title="Sites"
-  icon={<GlobeIcon />}
-  current={sitesCount}
-  limit={maxSites}
-  type="permanent"
-/>
-
-<LimitCard
-  title="Team Members"
-  icon={<UsersIcon />}
-  current={usersCount}
-  limit={maxUsers}
-  type="permanent"
-/>
-
-<LimitCard
-  title="Keywords in Workspace"
-  icon={<TagIcon />}
-  current={keywordsCount}
-  limit={maxKeywords}
-  type="permanent"
-/>
-
-<LimitCard
-  title="Ahrefs Research Queries"
-  icon={<SearchIcon />}
-  current={ahrefsUsed}
-  limit={ahrefsLimit}
-  type="monthly"
-  daysUntilReset={daysUntilReset}
-/>
-```
-
-**Tab 3: Credit Insights (NEW)**
-```tsx
-{/* Multi-dimensional breakdowns */}
-
-{/* By Site */}
-<Card>
-  <h3>Credits by Site</h3>
-  <div>See which sites consume the most credits</div>
-  {insights.by_site.map(site => (
-    <div key={site.id}>
-      <div className="flex justify-between">
-        <span>{site.name}</span>
-        <span>{site.credits_used.toLocaleString()} credits ({site.percentage}%)</span>
-      </div>
-      <ProgressBar value={site.percentage} />
-    </div>
-  ))}
-</Card>
-
-{/* By Action Type */}
-<Card>
-  <h3>Credits by Action Type</h3>
-  <DonutChart data={insights.by_operation} />
-  <div>
-    {insights.by_operation.map(op => (
-      <div key={op.type}>
-        <span>{op.display_name}</span>
-        <span>{op.credits_used} credits ({op.count} times)</span>
-      </div>
-    ))}
-  </div>
-</Card>
-
-{/* By Image Quality */}
-<Card>
-  <h3>Image Generation Breakdown</h3>
-  <div>Credits vary by quality tier</div>
-  {insights.by_image_quality.map(tier => (
-    <div key={tier.quality_tier}>
-      <div>{tier.quality_tier} Quality</div>
-      <div>{tier.images_generated} images × {tier.credits_per_image} credits = {tier.total_credits} credits</div>
-      <Badge>{tier.model_name}</Badge>
-    </div>
-  ))}
-</Card>
-
-{/* By Automation */}
-<Card>
-  <h3>Automation Runs</h3>
-  {insights.by_automation.map(auto => (
-    <div key={auto.id}>
-      <div>{auto.name}</div>
-      <div>{auto.runs_count} runs • {auto.credits_used} credits total</div>
-    </div>
-  ))}
-</Card>
-
-{/* Timeline Chart */}
-<Card>
-  <h3>Credit Usage Over Time</h3>
-  <LineChart 
-    data={insights.timeline}
-    xAxis="date"
-    yAxis="credits_used"
-  />
-</Card>
-```
-
-**Tab 4: Activity Log** _(Keep existing, but rename from "API Activity")_
-
----
-
-## 8. Backend Changes Summary
-
-### 8.1 Files to Modify
-
-| File | Action | Description |
-|------|--------|-------------|
-| `backend/igny8_core/auth/models.py` | Edit | Remove unused limit fields from Plan & Account |
-| `backend/igny8_core/auth/migrations/0XXX_*.py` | Create | Migration to remove fields |
-| `backend/igny8_core/business/billing/services/limit_service.py` | Edit | Remove unused limit mappings |
-| `backend/igny8_core/auth/serializers.py` | Edit | Remove fields from PlanSerializer |
-| `backend/igny8_core/business/keywords/ahrefs_service.py` | Create | New service for Ahrefs integration |
-| `backend/igny8_core/business/automation/services.py` | Edit | Add credit pre-check |
-| `backend/igny8_core/business/planning/views.py` | Edit | Add keyword limit enforcement |
-| `backend/igny8_core/modules/billing/views.py` | Edit | Add credit insights endpoint |
-
-### 8.2 New API Endpoints
-
-```python
-# Credit Insights (NEW)
-GET /api/v1/billing/credits/insights/?days=30
-Response: CreditInsights object with multi-dimensional breakdowns
-
-# Ahrefs Search (NEW)
-POST /api/v1/keywords/ahrefs/search/
-Body: { "query": "digital marketing", "country": "us" }
-Response: { "keywords": [...], "queries_remaining": 42 }
-```
-
----
-
-## 9. Frontend Changes Summary
-
-### 9.1 Files to Modify
-
-| File | Action | Description |
-|------|--------|-------------|
-| `frontend/src/pages/account/PlansAndBillingPage.tsx` | Edit | Remove credit usage details from Current Plan tab |
-| `frontend/src/pages/account/UsageAnalyticsPage.tsx` | Rewrite | Add Overview & Credit Insights tabs |
-| `frontend/src/components/billing/UsageLimitsPanel.tsx` | Edit | Remove unused limits, add Ahrefs |
-| `frontend/src/services/billing.api.ts` | Edit | Remove unused fields, add new interfaces |
-| `frontend/src/pages/Planner/KeywordResearchPage.tsx` | Create | New page for keyword research |
-| `frontend/src/components/keywords/AhrefsResearchPanel.tsx` | Create | Ahrefs search component |
-
-### 9.2 New Components
-
-```tsx
-// Credit Insights Components
-CreditInsightsDashboard.tsx
-CreditsBySiteWidget.tsx
-CreditsByOperationWidget.tsx
-CreditsByImageQualityWidget.tsx
-CreditsByAutomationWidget.tsx
-CreditTimelineChart.tsx
-
-// Ahrefs Research
-KeywordResearchPage.tsx
-AhrefsResearchPanel.tsx
-BrowseKeywordsPanel.tsx
-```
-
----
-
-## 10. Testing Checklist
-
-**Problem:** Keywords have `max_keywords` limit defined but enforcement is inconsistent.
-
-**Required Changes:**
-
-1. **Add Pre-Create Checks:**
-
-   Location: `backend/igny8_core/business/planning/views.py` (or wherever keywords are created)
-   ```python
-   # Before creating keywords
-   from igny8_core.business.billing.services.limit_service import LimitService
-   
-   def create_keywords(account, keyword_data):
-       # Check if adding keywords would exceed limit
-       num_new_keywords = len(keyword_data)
-       LimitService.check_hard_limit(account, 'keywords', num_new_keywords)
-       
-       # If check passes, create keywords
-       keywords = Keywords.objects.bulk_create([...])
-       
-       return keywords
-   ```
-
-2. **Add Check to SeedKeyword Import:**
-
-   Location: `backend/igny8_core/api/endpoints/seed_keywords.py` (or similar)
-   ```python
-   # In addSeedKeywordsToWorkflow endpoint
-   def add_seed_keywords_to_workflow(seed_keyword_ids, site_id, sector_id):
-       account = Site.objects.get(id=site_id).account
-       
-       # Check limit BEFORE importing
-       LimitService.check_hard_limit(account, 'keywords', len(seed_keyword_ids))
-       
-       # Import keywords
-       for seed_kw in SeedKeyword.objects.filter(id__in=seed_keyword_ids):
-           Keywords.objects.create(...)
-   ```
-
-3. **Add Check to Bulk Import:**
-
-   Ensure CSV/Excel keyword imports also check limits before processing.
-
-4. **User-Facing Error Messages:**
-   ```python
-   try:
-       LimitService.check_hard_limit(account, 'keywords', 50)
-   except HardLimitExceededError as e:
-       return Response({
-           'error': 'keyword_limit_exceeded',
-           'message': 'You have reached your keyword limit. Upgrade your plan to add more keywords.',
-           'current': 950,
-           'limit': 1000,
-           'upgrade_url': '/account/plans/upgrade'
-       }, status=402)
-   ```
-
-**Testing:**
-- ✅ Try to import keywords beyond limit → Should fail with clear error
-- ✅ Try to create single keyword at limit → Should fail
-- ✅ Try to bulk import → Should fail if total exceeds
-- ✅ Error message should show current count, limit, and upgrade CTA
-
----
-
-### 6.3 Implement Ahrefs Query Limit (Medium Priority)
-
-**Problem:** Future feature needs limit definition and enforcement.
-
-**Required Changes:**
-
-1. **Database Migration:**
-   ```python
-   # Create migration: 0XXX_add_ahrefs_query_limits.py
-   
-   operations = [
-       migrations.AddField(
-           model_name='plan',
-           name='max_ahrefs_queries',
-           field=models.IntegerField(default=50, validators=[MinValueValidator(0)]),
-       ),
-       migrations.AddField(
-           model_name='account',
-           name='usage_ahrefs_queries',
-           field=models.IntegerField(default=0, validators=[MinValueValidator(0)]),
-       ),
-   ]
-   ```
-
-2. **Update Plan Admin:**
-   ```python
-   # backend/igny8_core/auth/admin.py - PlanAdmin
-   fieldsets = (
-       # ... existing fieldsets ...
-       ('Monthly Limits (Reset on Billing Cycle)', {
-           'fields': (
-               'max_content_ideas', 'max_content_words',
-               'max_images_basic', 'max_images_premium', 'max_image_prompts',
-               'max_ahrefs_queries',  # ADD THIS
-           ),
-       }),
-   )
-   ```
-
-3. **Update LimitService:**
-   ```python
-   # backend/igny8_core/business/billing/services/limit_service.py
-   MONTHLY_LIMIT_MAPPINGS = {
-       # ... existing ...
-       'ahrefs_queries': {
-           'plan_field': 'max_ahrefs_queries',
-           'usage_field': 'usage_ahrefs_queries',
-           'display_name': 'Ahrefs Keyword Research Queries',
-       },
-   }
-   ```
-
-4. **Add to Plan Serializer:**
-   ```python
-   # backend/igny8_core/auth/serializers.py - PlanSerializer
-   class PlanSerializer(serializers.ModelSerializer):
-       class Meta:
-           fields = [
-               # ... existing fields ...
-               'max_ahrefs_queries',  # ADD THIS
-           ]
-   ```
-
-5. **Enforce in Ahrefs Service:**
-   ```python
-   # Create new service: backend/igny8_core/business/keywords/ahrefs_service.py
-   from igny8_core.business.billing.services.limit_service import LimitService
-   
-   class AhrefsService:
-       @staticmethod
-       def query_keywords(account, query_params):
-           # Check monthly limit
-           LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)
-           
-           # Execute Ahrefs API call
-           results = ahrefs_api.search_keywords(**query_params)
-           
-           # Increment usage counter
-           LimitService.increment_usage(account, 'ahrefs_queries', 1)
-           
-           return results
-   ```
-
-6. **Update Frontend:**
-   ```tsx
-   // frontend/src/components/billing/UsageLimitsPanel.tsx
-   const monthlyLimitConfig = {
-       // ... existing ...
-       ahrefs_queries: { 
-           icon: <SearchIcon className="w-5 h-5" />, 
-           color: 'purple' as const 
-       },
-   };
-   ```
-
-**Plan Values (Suggested):**
-
-| Plan | max_ahrefs_queries/month |
-|------|-------------------------|
-| Free | 0 (no access) |
-| Starter | 50 queries |
-| Growth | 200 queries |
-| Scale | 500 queries |
-
----
-
-### 6.4 Add Cluster Limit Enforcement (Low Priority)
-
-**Current State:** Clusters have `max_clusters` limit but may not be consistently enforced.
-
-**Recommendation:** Apply same enforcement pattern as keywords:
-1. Check limit before creating clusters
-2. Add to all cluster creation flows (auto-clustering, manual clustering)
-3. User-facing error messages
-
----
-
-### 6.5 Monthly Limits Reset Automation (Medium Priority)
-
-**Current State:** Monthly limits should reset at billing cycle, but automation may not be in place.
-
-**Check Required:**
-- Is there a scheduled task that calls `LimitService.reset_monthly_limits(account)`?
-- When do subscriptions renew?
-- How are usage fields reset?
-
-**Recommended:**
-```python
-# backend/igny8_core/business/billing/tasks.py (Celery)
-from celery import shared_task
-from igny8_core.auth.models import Account
-from igny8_core.business.billing.services.limit_service import LimitService
-
-@shared_task
-def reset_monthly_limits_for_accounts():
-    """Reset monthly limits for accounts whose billing period has ended"""
-    from django.utils import timezone
-    
-    now = timezone.now()
-    accounts = Account.objects.filter(
-        usage_period_end__lte=now,
-        status='active'
-    )
-    
-    for account in accounts:
-        LimitService.reset_monthly_limits(account)
-        logger.info(f"Reset monthly limits for account {account.id}")
-```
-
----
-
-## 7. Credit System (Working Well) ✅
-
-**No changes needed** - the credit system is well-designed:
-
-1. **Token-Based Calculation:** Uses `AIModelConfig.tokens_per_credit` for accurate pricing
-2. **Image Fixed Pricing:** Uses `AIModelConfig.credits_per_image` (1, 5, or 15)
-3. **Proper Logging:** `CreditUsageLog` tracks every operation with metadata
-4. **Transaction Ledger:** `CreditTransaction` maintains audit trail
-5. **Balance Tracking:** Account.credits is source of truth
-
-**Already Enforced Properly:**
-- ✅ Pre-flight balance checks before operations
-- ✅ Token-based credit calculation after API calls
-- ✅ Proper transaction logging
-- ✅ Clear error messages (402 Payment Required)
-
----
-
-## 8. Summary of Required Backend Changes
-
-### 8.1 Database Schema Changes
-
-**Add to Plan Model:**
-```python
-max_ahrefs_queries = models.IntegerField(default=50, validators=[MinValueValidator(0)])
-```
-
-**Add to Account Model:**
-```python
-usage_ahrefs_queries = models.IntegerField(default=0, validators=[MinValueValidator(0)])
-```
-
-### 8.2 Enforcement Additions
-
-**Locations Needing Limit Checks:**
-
-| Location | Limit Type | Method to Add |
-|----------|-----------|--------------|
-| Keyword creation | Hard | `LimitService.check_hard_limit(account, 'keywords', count)` |
-| SeedKeyword import | Hard | `LimitService.check_hard_limit(account, 'keywords', count)` |
-| Bulk keyword import | Hard | `LimitService.check_hard_limit(account, 'keywords', count)` |
-| Ahrefs query (future) | Monthly | `LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)` |
-| Cluster creation | Hard | `LimitService.check_hard_limit(account, 'clusters', count)` |
-
-### 8.3 Service Updates
-
-**LimitService Mappings:**
-```python
-# Add to MONTHLY_LIMIT_MAPPINGS
-'ahrefs_queries': {
-    'plan_field': 'max_ahrefs_queries',
-    'usage_field': 'usage_ahrefs_queries',
-    'display_name': 'Ahrefs Keyword Research Queries',
-}
-```
-
----
-
-## 9. Summary of Required Frontend Changes
-
-### 9.1 Page Content Adjustments
-
-**Plans & Billing Page:**
-```tsx
-// Remove from Current Plan tab:
-- ❌ Detailed credit usage breakdown (move to Usage)
-- ❌ Limit progress bars (move to Usage)
-
-// Keep in Current Plan tab:
-- ✅ Plan name, price, renewal date
-- ✅ Brief limits summary (text only)
-- ✅ Upgrade CTA
-
-// Keep History tab as is
-```
-
-**Usage Analytics Page:**
-```tsx
-// Keep all tabs as is - no changes needed
-// This page is perfectly organized
-```
-
-### 9.2 Component Updates
-
-**UsageLimitsPanel.tsx:**
-```tsx
-// Add Ahrefs queries to monthly limits config
-const monthlyLimitConfig = {
-    // ... existing ...
-    ahrefs_queries: { 
-        icon: <SearchIcon className="w-5 h-5" />, 
-        color: 'purple' as const 
-    },
-};
-```
-
-**billing.api.ts:**
-```typescript
-// Add to Plan interface
-export interface Plan {
-    // ... existing fields ...
-    max_ahrefs_queries?: number;  // ADD THIS
-}
-
-// Add to UsageSummary interface
-export interface UsageSummary {
-    // ... existing ...
-    monthly_limits: {
-        // ... existing ...
-        ahrefs_queries?: LimitUsage;  // ADD THIS
-    };
-}
-```
-
----
-
-## 10. Implementation Priority
-
-### Phase 1: Critical Fixes (Do First) 🔥
-
-1. **Enforce Keywords Limit** (Backend)
-   - Add checks to keyword creation flows
-   - Estimated effort: 4 hours
-   - Impact: Prevents users from exceeding limits
-
-2. **Page Reorganization** (Frontend)
-   - Remove duplicate data from Plans & Billing → Current Plan
-   - Estimated effort: 2 hours
-   - Impact: Reduces user confusion
-
-### Phase 2: Future Features (Do When Implementing Ahrefs)
-
-3. **Implement Ahrefs Query Limit** (Backend + Frontend)
-   - Database migration
-   - LimitService mapping
-   - Enforcement in Ahrefs service
-   - Frontend display
-   - Estimated effort: 6 hours
-   - Impact: Ready for Ahrefs integration
-
-### Phase 3: Nice-to-Have Improvements
-
-4. **Enforce Cluster Limit** (Backend)
-   - Similar to keywords enforcement
-   - Estimated effort: 2 hours
-
-5. **Monthly Limits Reset Automation** (Backend)
-   - Celery task for auto-reset
-   - Estimated effort: 3 hours
-
----
-
----
-
-## 11. Migration Strategy
-
-### Week-by-Week Rollout
-
-**Week 1: Backend Foundation**
-- [ ] Create database migration to remove unused fields
-- [ ] Update LimitService mappings
-- [ ] Update serializers
-- [ ] Add Ahrefs service skeleton
-- [ ] Deploy to staging
-
-**Week 2: Enforcement**
-- [ ] Add keyword limit checks to all entry points
-- [ ] Add automation credit pre-checks
-- [ ] Test all validation flows
-- [ ] Deploy to staging
-
-**Week 3: Frontend Cleanup**
-- [ ] Remove duplicate data from Plans & Billing
-- [ ] Update UsageLimitsPanel
-- [ ] Update terminology (remove "API", "operations")
-- [ ] Deploy to staging
-
-**Week 4: New Features**
-- [ ] Build Credit Insights tab
-- [ ] Build Keyword Research page
-- [ ] Integrate Ahrefs (when ready)
-- [ ] Add multi-dimensional widgets
-- [ ] Deploy to staging
-
-**Week 5: Testing & Production**
-- [ ] Full regression testing
-- [ ] User acceptance testing
-- [ ] Deploy to production
-- [ ] Monitor for issues
-
----
-
-## 12. Final Limits Configuration
-
-### 12.1 Database Schema (After Cleanup)
-
-**Plan Model - FINAL:**
-```python
-class Plan(models.Model):
-    # Basic Info
-    name = models.CharField(max_length=255)
-    slug = models.SlugField(unique=True)
-    price = models.DecimalField(max_digits=10, decimal_places=2)
-    
-    # ONLY 4 LIMITS:
-    max_sites = models.IntegerField(default=1)
-    max_users = models.IntegerField(default=1)
-    max_keywords = models.IntegerField(default=1000)
-    max_ahrefs_queries = models.IntegerField(default=50)
-    
-    # Credits
-    included_credits = models.IntegerField(default=0)
-    extra_credit_price = models.DecimalField(max_digits=10, decimal_places=2)
-```
-
-**Account Model - FINAL:**
-```python
-class Account(models.Model):
-    # Credits
-    credits = models.IntegerField(default=0)
-    
-    # ONLY 1 Usage Tracker:
-    usage_ahrefs_queries = models.IntegerField(default=0)
-    
-    # Billing Period
-    usage_period_start = models.DateTimeField(null=True)
-    usage_period_end = models.DateTimeField(null=True)
-```
-
-### 12.2 Suggested Plan Values
-
-| Plan | Price | Included Credits | Sites | Users | Keywords | Ahrefs Queries/mo |
-|------|-------|-----------------|-------|-------|----------|-------------------|
-| **Free** | $0 | 2,000 | 1 | 1 | 100 | 0 |
-| **Starter** | $49 | 10,000 | 2 | 2 | 1,000 | 50 |
-| **Growth** | $149 | 40,000 | 5 | 3 | 5,000 | 200 |
-| **Scale** | $399 | 120,000 | Unlimited | 5 | 20,000 | 500 |
-
----
-
-## 13. Success Criteria
-
-### 13.1 Technical Success
-
-- [ ] All unused limit fields removed from database
-- [ ] Migration runs successfully without data loss
-- [ ] All 4 limits properly enforced
-- [ ] Credit balance checked before ALL operations
-- [ ] Automation pre-checks credit balance
-- [ ] Ahrefs queries counted and limited
-- [ ] No duplicate data across pages
-- [ ] User-friendly terminology throughout
-
-### 13.2 User Experience Success
-
-- [ ] Users understand the simple 4-limit model
-- [ ] Clear separation: Plans & Billing = financial, Usage = consumption
-- [ ] Multi-dimensional insights provide actionable data
-- [ ] Keyword research flow is intuitive
-- [ ] Credit exhaustion messages are clear and actionable
-- [ ] Upgrade prompts appear at right moments
-
-### 13.3 Business Success
-
-- [ ] Reduced support questions about limits
-- [ ] Clearer upgrade paths
-- [ ] Better credit consumption visibility drives upgrades
-- [ ] Ahrefs integration ready for launch
-- [ ] System scales without complexity
-
----
-
-## 14. Risks & Mitigation
-
-### Risk 1: Data Loss During Migration
-**Mitigation:** 
-- Backup database before migration
-- Test migration on staging with production data clone
-- Keep removed fields as comments in code for 1 month
-
-### Risk 2: Users Confused by Changes
-**Mitigation:**
-- In-app changelog notification
-- Update help documentation
-- Add tooltips to new UI elements
-- Gradual rollout (staging → 10% → 50% → 100%)
-
-### Risk 3: Breaking Changes
-**Mitigation:**
-- Maintain backward compatibility in API for 2 weeks
-- Version API endpoints if needed
-- Monitor error logs closely after deployment
-
----
-
-## 15. Post-Launch Monitoring
-
-### Metrics to Track
-
-**Technical:**
-- API error rates (especially 402 Insufficient Credits)
-- Failed automation runs due to credits
-- Keyword limit violations
-- Ahrefs query usage patterns
-
-**Business:**
-- Upgrade conversion rate
-- Support tickets about limits/credits
-- Credit package purchase rate
-- User engagement with new Usage insights
-
-**User Behavior:**
-- Time spent on Usage page
-- Click-through on upgrade prompts
-- Ahrefs query usage distribution
-- Most-used insights widgets
-
----
-
-## 16. Documentation Updates Required
-
-- [ ] Update `docs/10-MODULES/BILLING.md`
-- [ ] Update `docs/40-WORKFLOWS/CREDIT-SYSTEM.md`
-- [ ] Create `docs/10-MODULES/KEYWORD-RESEARCH.md`
-- [ ] Update API documentation
-- [ ] Update user help docs
-- [ ] Update admin guides
-
----
-
-## 17. Summary
-
-### Before (Complex)
-
-### Keywords Limit Testing
-
-- [ ] Try to create single keyword when at limit → Should fail
-- [ ] Try to import 50 SeedKeywords when 30 slots remain → Should fail
-- [ ] Try to bulk import CSV with 1000 keywords when at limit → Should fail
-- [ ] Error message shows current count, limit, and upgrade link
-- [ ] Upgrade plan → New limit applies immediately
-- [ ] Delete keywords → Can add more up to new total
-
-### Ahrefs Limit Testing (Future)
-
-- [ ] Query Ahrefs when at monthly limit → Should fail
-- [ ] Error message shows queries used, limit, and reset date
-- [ ] Monthly reset correctly resets counter
-- [ ] Upgrade plan → New monthly allowance applies
-
-### Page Reorganization Testing
-
-- [ ] Plans & Billing → Current Plan shows only plan info and brief summary
-- [ ] Plans & Billing → Current Plan does NOT show detailed usage breakdown
-- [ ] Usage → Limits & Usage shows all limits with progress bars
-- [ ] Usage → Credit History shows transaction log
-- [ ] No duplicate data between the two sections
-
----
-
-## 12. Conclusion
-
-### What's Working Well ✅
-
-1. **Credit System:** Token-based calculation is accurate and well-implemented
-2. **Usage Tracking:** Monthly limits are properly tracked in Account model
-3. **Sites & Users Limits:** Fully enforced with proper error handling
-4. **Frontend UI:** UsageLimitsPanel component is excellent
-
-### What Needs Fixing ⚠️
-
-1. **Keywords Enforcement:** Limit exists but not consistently checked
-2. **Data Duplication:** Credits and usage data shown in both Plans & Usage
-3. **Missing Ahrefs Limit:** Future feature needs to be defined
-
-### Impact of Changes
-
-| Change | User Benefit | Business Benefit |
-|--------|-------------|------------------|
-| Enforce keywords limit | Clear boundaries, upgrade prompts | Prevent unlimited usage, drive upgrades |
-| Remove duplication | Less confusion, faster navigation | Easier maintenance, clearer product positioning |
-| Add Ahrefs limit | Know usage allowance upfront | Control costs, monetize feature |
-
-### Next Steps
-
-1. **Backend Team:** Implement keyword limit enforcement
-2. **Frontend Team:** Clean up Plans & Billing page
-3. **Product Team:** Define Ahrefs query pricing tiers
-4. **QA Team:** Test all limit scenarios
-
----
-
-**End of Report**
-
-*For questions or clarification, refer to:*
-- `docs/10-MODULES/BILLING.md` - Billing system documentation
-- `docs/40-WORKFLOWS/CREDIT-SYSTEM.md` - Credit workflows
-- `backend/igny8_core/business/billing/services/limit_service.py` - Limit enforcement code
diff --git a/docs/plans/implemented/CREDITS-LIMITS-IMPLEMENTATION-PLAN.md b/docs/plans/implemented/CREDITS-LIMITS-IMPLEMENTATION-PLAN.md
deleted file mode 100644
index ae9904b0..00000000
--- a/docs/plans/implemented/CREDITS-LIMITS-IMPLEMENTATION-PLAN.md
+++ /dev/null
@@ -1,2578 +0,0 @@
-# Credits & Limits System - Implementation Plan
-
-**Date:** January 5, 2026  
-**Status:** 🚧 IMPLEMENTATION PLAN - Pending Execution  
-**Prepared For:** IGNY8 Platform  
-**Purpose:** Comprehensive plan to simplify, optimize, and properly enforce credits and limits system
-
----
-
-## Executive Summary
-
-This implementation plan addresses the IGNY8 platform's credits and limits system based on complete codebase analysis.
-
-### Core Philosophy: SIMPLICITY
-
-**Keep ONLY 4 Hard Limits:**
-1. **Sites** - How many sites per account
-2. **Team Users** - How many team members
-3. **Keywords** - Total keywords in workspace
-4. **Ahrefs Queries** - Monthly research queries (NEW)
-
-**Everything Else = Credits** - Let users consume credits however they want (content, images, ideas, etc.)
-
-### What We're Doing
-
-✅ **REMOVE** all unnecessary monthly limits (content_ideas, content_words, images_basic, images_premium, image_prompts)  
-✅ **SIMPLIFY** to credit-based system only  
-✅ **ENFORCE** the 4 hard limits properly  
-✅ **ELIMINATE** data duplication across pages  
-✅ **REDESIGN** Usage page with multi-dimensional insights  
-✅ **IMPLEMENT** Ahrefs keyword research structure  
-✅ **VALIDATE** all credit balance checks  
-✅ **USE** user-friendly terminology (no "API", "operations", etc.)
-
----
-
-## 1. FINAL SIMPLIFIED MODEL
-
-### 1.1 The Only Limits That Matter
-
-| Limit | Type | Description | Enforcement |
-|-------|------|-------------|-------------|
-| **Sites** | Hard | Max sites per account | ✅ Keep & Enforce |
-| **Team Users** | Hard | Max team members | ✅ Keep & Enforce |
-| **Keywords** | Hard | Total keywords in workspace | ✅ Keep & Enforce |
-| **Ahrefs Queries** | Monthly | Research queries per month | 🆕 Implement |
-
-### 1.2 What Gets REMOVED
-
-**❌ REMOVE These Limits (Use Credits Instead):**
-- `max_content_ideas` - Let credits control this
-- `max_content_words` - Let credits control this
-- `max_images_basic` - Let credits control this
-- `max_images_premium` - Let credits control this
-- `max_image_prompts` - Let credits control this
-- `max_clusters` - Let credits control this (or combine with keywords)
-- `usage_content_ideas` - Not needed
-- `usage_content_words` - Not needed
-- `usage_images_basic` - Not needed
-- `usage_images_premium` - Not needed
-- `usage_image_prompts` - Not needed
-
-**Why Remove?**
-- Confusing for users ("I have credits but can't generate content?")
-- Double limiting (credits + monthly limits)
-- Maintenance overhead
-- Credit system already provides control
-
-### 1.3 Keyword Research Structure (NEW)
-
-**Two Ways to Add Keywords:**
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                   KEYWORD RESEARCH OPTIONS                       │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Option 1: IGNY8 Pre-Researched Keywords (FREE)                │
-│  ────────────────────────────────────────────                  │
-│  • Access global keyword database                              │
-│  • Filter by industry, sector, country                         │
-│  • Pre-analyzed for search volume, difficulty                  │
-│  • Free to browse and add to workspace                         │
-│  • Limited by: max_keywords (total workspace limit)            │
-│                                                                  │
-│  Option 2: Ahrefs Live Research (LIMITED)                      │
-│  ────────────────────────────────────────────                  │
-│  • Query Ahrefs API directly                                   │
-│  • Get fresh, custom keyword data                              │
-│  • Monthly query limit (e.g., 50-500 depending on plan)        │
-│  • Limited by: max_ahrefs_queries (monthly limit)              │
-│  • Results can be added to workspace (counts toward max_keywords)│
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-**Implementation:**
-- Rename current "Add Keywords" to "Browse Pre-Researched Keywords"
-- Add new tab/section "Research with Ahrefs" (with monthly limit indicator)
-- Show remaining queries: "You have 42/50 Ahrefs queries remaining this month"
-
----
-
-## 2. Current System Analysis (What We Found)
-
-### 1.1 Frontend Pages Breakdown
-
-#### Plans & Billing Dropdown (`/account/plans`)
-
-| Page | Route | Primary Purpose | Current Data Displayed |
-|------|-------|----------------|----------------------|
-| **Current Plan** | `/account/plans` | View active subscription | Plan name, price, renewal date, included credits |
-| **Upgrade Plan** | `/account/plans/upgrade` | Compare and purchase plans | Pricing table with all plans, features, limits |
-| **History** | `/account/plans/history` | Invoices and payments | Invoice list, payment methods, transaction history |
-
-**File:** `frontend/src/pages/account/PlansAndBillingPage.tsx` (881 lines)
-
-**Tab Structure:**
-```typescript
-type TabType = 'plan' | 'upgrade' | 'invoices';
-```
-
-**Key Data Shown:**
-- Current plan details (name, price, billing cycle)
-- Upgrade options (pricing table with all plans)
-- Credit balance (via `getCreditBalance()`)
-- Billing history (invoices, payments)
-- Payment methods management
-
-#### Usage Dropdown (`/account/usage`)
-
-| Page | Route | Primary Purpose | Current Data Displayed |
-|------|-------|----------------|----------------------|
-| **Limits & Usage** | `/account/usage` | Track plan limits | Hard limits + monthly limits with progress bars |
-| **Credit History** | `/account/usage/credits` | View credit transactions | Transaction log (purchases, deductions, adjustments) |
-| **Activity** | `/account/usage/activity` | Monitor API operations | API call statistics by operation type |
-
-**File:** `frontend/src/pages/account/UsageAnalyticsPage.tsx` (266 lines)
-
-**Tab Structure:**
-```typescript
-type TabType = 'limits' | 'activity' | 'api';
-```
-
-**Key Data Shown:**
-- Usage summary (hard limits: sites, users, keywords, clusters)
-- Monthly limits (content ideas, words, images)
-- Credit balance and monthly usage
-- Transaction history
-- API activity by operation type
-
----
-
-### 1.2 Backend Models
-
-#### Account Model (`backend/igny8_core/auth/models.py`)
-
-**Credits Field:**
-```python
-credits = models.IntegerField(default=0, validators=[MinValueValidator(0)])
-```
-
-**Monthly Usage Tracking Fields:**
-```python
-usage_content_ideas = models.IntegerField(default=0)        # Monthly limit tracking
-usage_content_words = models.IntegerField(default=0)        # Monthly limit tracking
-usage_images_basic = models.IntegerField(default=0)         # Monthly limit tracking
-usage_images_premium = models.IntegerField(default=0)       # Monthly limit tracking
-usage_image_prompts = models.IntegerField(default=0)        # Monthly limit tracking
-usage_period_start = models.DateTimeField(null=True)        # Billing period tracking
-usage_period_end = models.DateTimeField(null=True)          # Billing period tracking
-```
-
-#### Plan Model
-
-**Hard Limits (Never Reset):**
-```python
-max_sites = models.IntegerField(default=1)           # Sites allowed per account
-max_users = models.IntegerField(default=1)           # Team members allowed
-max_keywords = models.IntegerField(default=1000)     # Total keywords allowed
-max_clusters = models.IntegerField(default=100)      # Total clusters allowed
-```
-
-**Monthly Limits (Reset on Billing Cycle):**
-```python
-max_content_ideas = models.IntegerField(default=300)      # Ideas per month
-max_content_words = models.IntegerField(default=100000)   # Words per month
-max_images_basic = models.IntegerField(default=300)       # Basic images per month
-max_images_premium = models.IntegerField(default=60)      # Premium images per month
-max_image_prompts = models.IntegerField(default=300)      # Image prompts per month
-```
-
-**Credits:**
-```python
-included_credits = models.IntegerField(default=0)        # Monthly credit allocation
-extra_credit_price = models.DecimalField(default=0.01)   # Price per additional credit
-```
-
----
-
-## 2. Data Flow Analysis
-
-### 2.1 Credit Deduction Flow
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                   CREDIT DEDUCTION WORKFLOW                      │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  1. User triggers AI operation (e.g., generate content)         │
-│                        ↓                                         │
-│  2. Backend service calls CreditService                          │
-│                        ↓                                         │
-│  3. Check balance: CreditService.check_credits(account, credits)│
-│                        ↓                                         │
-│  4. Execute AI operation (OpenAI/Runware/etc.)                  │
-│                        ↓                                         │
-│  5. AI returns tokens used (input + output)                     │
-│                        ↓                                         │
-│  6. Calculate credits: CreditService.calculate_credits_from_tokens()│
-│     • Lookup AIModelConfig.tokens_per_credit for model          │
-│     • credits = ceil(total_tokens / tokens_per_credit)          │
-│                        ↓                                         │
-│  7. Deduct credits:                                             │
-│     • Create CreditTransaction (amount=-credits)                │
-│     • Create CreditUsageLog (operation details)                 │
-│     • Update Account.credits                                    │
-│                        ↓                                         │
-│  8. Return result to user                                       │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-**Key Services:**
-- `CreditService.check_credits()` - Pre-flight balance check
-- `CreditService.calculate_credits_from_tokens()` - Token-based calculation
-- `CreditService.deduct_credits_for_operation()` - Deduct and log
-
-### 2.2 Limit Enforcement Flow
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                   LIMIT ENFORCEMENT WORKFLOW                     │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  HARD LIMITS (Sites, Users, Keywords, Clusters)                 │
-│  ───────────────────────────────────────────────                │
-│  1. User attempts to create new resource                        │
-│                        ↓                                         │
-│  2. LimitService.check_hard_limit(account, limit_type, count)   │
-│     • Query database for current count                          │
-│     • Compare: current_count + new_count <= plan.max_XXX        │
-│                        ↓                                         │
-│  3. If exceeded: Raise HardLimitExceededError                   │
-│     If OK: Allow creation                                       │
-│                                                                  │
-│  MONTHLY LIMITS (Ideas, Words, Images, Prompts)                 │
-│  ─────────────────────────────────────────────                  │
-│  1. User attempts AI operation                                  │
-│                        ↓                                         │
-│  2. LimitService.check_monthly_limit(account, limit_type, amount)│
-│     • Read from Account.usage_XXX field                         │
-│     • Compare: current_usage + amount <= plan.max_XXX           │
-│                        ↓                                         │
-│  3. If exceeded: Raise MonthlyLimitExceededError                │
-│     If OK: Proceed with operation                               │
-│                        ↓                                         │
-│  4. After operation: LimitService.increment_usage()             │
-│     • Update Account.usage_XXX field                            │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-**Key Services:**
-- `LimitService.check_hard_limit()` - Check persistent limits
-- `LimitService.check_monthly_limit()` - Check monthly allowances
-- `LimitService.increment_usage()` - Update monthly usage counters
-- `LimitService.get_usage_summary()` - Get all limits and usage
-
----
-
-## 3. Current Limits Configuration
-
-### 3.1 Items That ARE Limit-Based (User-Requested)
-
-| Item | Type | Plan Field | Enforcement Location | Status |
-|------|------|-----------|---------------------|--------|
-| **Sites** | Hard Limit | `max_sites` | Account creation, Site model | ✅ Enforced |
-| **Team Users** | Hard Limit | `max_users` | User invite, SiteUserAccess model | ✅ Enforced |
-| **Keywords** | Hard Limit | `max_keywords` | Keyword import/creation | ⚠️ PARTIAL (see below) |
-
-### 3.2 Items That Should Have Limits (Future)
-
-| Item | Type | Plan Field | Status | Notes |
-|------|------|-----------|--------|-------|
-| **Ahrefs Queries** | Monthly Limit | `max_ahrefs_queries` (new) | ❌ Not Implemented | Future feature for keyword research |
-
-### 3.3 Items NOT Limit-Based (Credit-Based)
-
-| Item | Enforcement | Notes |
-|------|------------|-------|
-| **AI Content Generation** | Credits | Token-based calculation via AIModelConfig |
-| **AI Image Generation** | Credits | Fixed credits per image (1, 5, or 15) |
-| **AI Clustering** | Credits | Token-based calculation |
-| **AI Idea Generation** | Credits | Token-based calculation |
-| **Internal Linking** | Credits | 8 credits per content piece |
-| **SEO Optimization** | Credits | 1 credit per 200 words |
-
-**Important:** Monthly limits exist for these (max_content_ideas, max_content_words, max_images_basic, etc.) but they serve as **soft limits for cost control**, not hard enforcement. Users are primarily constrained by credits.
-
----
-
-## 4. Data Duplication Issues
-
-### 4.1 Problem: Overlapping Data Across Pages
-
-**Current Situation:**
-
-| Data Type | Plans & Billing | Usage Analytics | Duplication Level |
-|-----------|----------------|-----------------|-------------------|
-| **Credit Balance** | ✅ Shown in Current Plan tab | ✅ Shown in all tabs (top cards) | 🔴 HIGH |
-| **Monthly Usage** | ✅ Credits used this month | ✅ Credits used this month | 🔴 HIGH |
-| **Plan Limits** | ✅ Shown in plan details | ✅ Full limits panel with progress bars | 🟡 MEDIUM |
-| **Credit Transactions** | ✅ Billing History tab | ✅ Credit History tab | 🔴 HIGH |
-
-**Example of Duplication:**
-
-**Plans & Billing - Current Plan Tab:**
-```tsx
-<Card>
-  <h3>Current Plan: {planName}</h3>
-  <div>Credits: {creditBalance.credits}</div>
-  <div>Used This Month: {creditBalance.credits_used_this_month}</div>
-  <div>Monthly Allowance: {creditBalance.plan_credits_per_month}</div>
-</Card>
-```
-
-**Usage Analytics - Limits Tab:**
-```tsx
-<Card>
-  <div>Credits Left: {creditBalance.credits}</div>
-  <div>Credits Used This Month: {creditBalance.credits_used_this_month}</div>
-  <div>Your Monthly Limit: {creditBalance.plan_credits_per_month}</div>
-</Card>
-```
-
-### 4.2 Problem: Confusing User Journey
-
-**Current User Experience Issues:**
-
-1. **Credit Balance** appears in BOTH dropdowns
-   - Plans & Billing → Current Plan → Shows credit balance
-   - Usage → All tabs → Shows credit balance in top cards
-
-2. **Transaction History** appears in BOTH dropdowns
-   - Plans & Billing → History → Shows invoices and payments
-   - Usage → Credit History → Shows credit transactions
-
-3. **Plan Limits** appears in BOTH dropdowns
-   - Plans & Billing → Current Plan → Shows plan features and limits
-   - Usage → Limits & Usage → Shows detailed progress bars for all limits
-
-**User Confusion:**
-- "Where do I check my credits?" → Two places
-- "Where do I see my usage?" → Two places
-- "Where do I see my transaction history?" → Two places
-
----
-
-## 5. Enforcement Analysis
-
-### 5.1 Well-Enforced Limits ✅
-
-#### Sites (max_sites)
-**Enforcement Location:** `backend/igny8_core/auth/models.py` (Site model)
-```python
-# When creating a new site
-LimitService.check_hard_limit(account, 'sites', 1)
-```
-
-**Status:** ✅ **FULLY ENFORCED**  
-**Works:** Users cannot create more sites than their plan allows
-
-#### Team Users (max_users)
-**Enforcement Location:** User invite flow
-```python
-# When inviting a new user
-LimitService.check_hard_limit(account, 'users', 1)
-```
-
-**Status:** ✅ **FULLY ENFORCED**  
-**Works:** Users cannot invite more team members than their plan allows
-
----
-
-### 5.2 Partially Enforced Limits ⚠️
-
-#### Keywords (max_keywords)
-
-**Current State:**
-- ✅ Plan field exists: `Plan.max_keywords`
-- ✅ LimitService has mapping:
-  ```python
-  'keywords': {
-      'model': 'planner.Keywords',
-      'plan_field': 'max_keywords',
-      'display_name': 'Keywords',
-      'filter_field': 'account',
-  }
-  ```
-- ⚠️ **ENFORCEMENT INCONSISTENT**
-
-**Evidence from Code Search:**
-
-Found in `backend/igny8_core/business/planning/models.py`:
-```python
-from igny8_core.business.billing.services.limit_service import LimitService
-
-# Only enforced in SOME locations:
-LimitService.increment_usage(
-    account=self.account,
-    limit_type='keywords',
-    amount=1
-)
-```
-
-**Problem:** 
-- Keyword import from SeedKeywords may not check limit
-- Keyword creation via API may not check limit consistently
-- Manual keyword creation may bypass checks
-
-**Impact:**
-- Users may exceed keyword limits without errors
-- Limits shown in UI but not enforced at all entry points
-
-**Recommended Fix:**
-1. Add pre-create check to all keyword creation flows:
-   ```python
-   # Before creating keyword
-   LimitService.check_hard_limit(account, 'keywords', 1)
-   ```
-2. Locations to add enforcement:
-   - `addSeedKeywordsToWorkflow` API endpoint
-   - Keyword bulk import
-   - Manual keyword creation form
-   - CSV import
-
----
-
-### 5.3 Missing Future Limits ❌
-
-#### Ahrefs Keyword Queries (Planned)
-
-**User Requirement:**
-> "in future soon we will have option for user to query and research keywords from ahrefs, which will also have monthly limit"
-
-**Current State:**
-- ❌ No plan field defined
-- ❌ No LimitService mapping
-- ❌ No enforcement
-
-**Current Keywords Situation:**
-- **Existing:** Pre-searched keywords from IGNY8's own database (SeedKeywords)
-- **Limited by:** `max_keywords` (how many they can add to their workspace)
-- **Future:** Ahrefs API queries (need new monthly limit)
-
-**Recommended Implementation:**
-
-1. **Add Plan Field:**
-   ```python
-   # backend/igny8_core/auth/models.py - Plan model
-   max_ahrefs_queries = models.IntegerField(
-       default=50,
-       validators=[MinValueValidator(0)],
-       help_text="Maximum Ahrefs keyword queries per month"
-   )
-   ```
-
-2. **Add Account Usage Field:**
-   ```python
-   # backend/igny8_core/auth/models.py - Account model
-   usage_ahrefs_queries = models.IntegerField(
-       default=0,
-       validators=[MinValueValidator(0)],
-       help_text="Ahrefs queries used this month"
-   )
-   ```
-
-3. **Add LimitService Mapping:**
-   ```python
-   # backend/igny8_core/business/billing/services/limit_service.py
-   MONTHLY_LIMIT_MAPPINGS = {
-       # ... existing mappings ...
-       'ahrefs_queries': {
-           'plan_field': 'max_ahrefs_queries',
-           'usage_field': 'usage_ahrefs_queries',
-           'display_name': 'Ahrefs Keyword Queries',
-       },
-   }
-   ```
-
-4. **Enforce Before Query:**
-   ```python
-   # In Ahrefs query service
-   def query_ahrefs_keywords(account, query):
-       # Check limit
-       LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)
-       
-       # Execute query
-       results = ahrefs_api.search_keywords(query)
-       
-       # Increment usage
-       LimitService.increment_usage(account, 'ahrefs_queries', 1)
-       
-       return results
-   ```
-
----
-
-## 6. IMPLEMENTATION PLAN
-
-### 6.1 Phase 1: Backend Cleanup (Week 1)
-
-#### 1.1 Remove Unused Monthly Limits from Database
-
-**File:** `backend/igny8_core/auth/models.py`
-
-**Remove from Plan Model:**
-```python
-# REMOVE THESE FIELDS:
-max_content_ideas = models.IntegerField(...)      # ❌ DELETE
-max_content_words = models.IntegerField(...)      # ❌ DELETE
-max_images_basic = models.IntegerField(...)       # ❌ DELETE
-max_images_premium = models.IntegerField(...)     # ❌ DELETE
-max_image_prompts = models.IntegerField(...)      # ❌ DELETE
-max_clusters = models.IntegerField(...)           # ❌ DELETE (or merge with keywords)
-```
-
-**Remove from Account Model:**
-```python
-# REMOVE THESE FIELDS:
-usage_content_ideas = models.IntegerField(...)    # ❌ DELETE
-usage_content_words = models.IntegerField(...)    # ❌ DELETE
-usage_images_basic = models.IntegerField(...)     # ❌ DELETE
-usage_images_premium = models.IntegerField(...)   # ❌ DELETE
-usage_image_prompts = models.IntegerField(...)    # ❌ DELETE
-```
-
-**KEEP ONLY:**
-```python
-# Plan Model - KEEP THESE:
-max_sites = models.IntegerField(default=1)        # ✅ KEEP
-max_users = models.IntegerField(default=1)        # ✅ KEEP
-max_keywords = models.IntegerField(default=1000)  # ✅ KEEP
-max_ahrefs_queries = models.IntegerField(default=50)  # 🆕 ADD
-
-# Account Model - KEEP THESE:
-credits = models.IntegerField(default=0)          # ✅ KEEP
-usage_ahrefs_queries = models.IntegerField(default=0)  # 🆕 ADD
-usage_period_start = models.DateTimeField(...)    # ✅ KEEP
-usage_period_end = models.DateTimeField(...)      # ✅ KEEP
-```
-
-**Migration Script:**
-```python
-# Create migration: 0XXX_remove_unused_limits.py
-operations = [
-    # Remove from Plan
-    migrations.RemoveField(model_name='plan', name='max_content_ideas'),
-    migrations.RemoveField(model_name='plan', name='max_content_words'),
-    migrations.RemoveField(model_name='plan', name='max_images_basic'),
-    migrations.RemoveField(model_name='plan', name='max_images_premium'),
-    migrations.RemoveField(model_name='plan', name='max_image_prompts'),
-    migrations.RemoveField(model_name='plan', name='max_clusters'),
-    
-    # Remove from Account
-    migrations.RemoveField(model_name='account', name='usage_content_ideas'),
-    migrations.RemoveField(model_name='account', name='usage_content_words'),
-    migrations.RemoveField(model_name='account', name='usage_images_basic'),
-    migrations.RemoveField(model_name='account', name='usage_images_premium'),
-    migrations.RemoveField(model_name='account', name='usage_image_prompts'),
-    
-    # Add Ahrefs fields
-    migrations.AddField(
-        model_name='plan',
-        name='max_ahrefs_queries',
-        field=models.IntegerField(default=50, validators=[MinValueValidator(0)])
-    ),
-    migrations.AddField(
-        model_name='account',
-        name='usage_ahrefs_queries',
-        field=models.IntegerField(default=0, validators=[MinValueValidator(0)])
-    ),
-]
-```
-
-#### 1.2 Update LimitService
-
-**File:** `backend/igny8_core/business/billing/services/limit_service.py`
-
-**Remove from MONTHLY_LIMIT_MAPPINGS:**
-```python
-# DELETE THESE:
-'content_ideas': {...},       # ❌ DELETE
-'content_words': {...},       # ❌ DELETE
-'images_basic': {...},        # ❌ DELETE
-'images_premium': {...},      # ❌ DELETE
-'image_prompts': {...},       # ❌ DELETE
-```
-
-**Keep/Add:**
-```python
-MONTHLY_LIMIT_MAPPINGS = {
-    # ONLY THIS ONE:
-    'ahrefs_queries': {
-        'plan_field': 'max_ahrefs_queries',
-        'usage_field': 'usage_ahrefs_queries',
-        'display_name': 'Ahrefs Keyword Research',
-    },
-}
-
-# Remove from HARD_LIMIT_MAPPINGS:
-'clusters': {...},  # ❌ DELETE (or keep if needed)
-```
-
-#### 1.3 Update Serializers
-
-**File:** `backend/igny8_core/auth/serializers.py`
-
-```python
-class PlanSerializer(serializers.ModelSerializer):
-    class Meta:
-        fields = [
-            'id', 'name', 'slug', 'price', 'billing_cycle',
-            # KEEP ONLY THESE LIMITS:
-            'max_sites',
-            'max_users', 
-            'max_keywords',
-            'max_ahrefs_queries',  # NEW
-            # CREDITS:
-            'included_credits',
-            'extra_credit_price',
-            # REMOVE ALL OTHER max_* fields
-        ]
-```
-
-#### 1.4 Remove Limit Checks from AI Operations
-
-**Search and Remove:**
-```bash
-# Find all places checking monthly limits
-grep -r "check_monthly_limit.*content_ideas" backend/
-grep -r "check_monthly_limit.*content_words" backend/
-grep -r "check_monthly_limit.*images" backend/
-grep -r "increment_usage.*content_ideas" backend/
-```
-
-**Replace with credit checks only:**
-```python
-# OLD (REMOVE):
-LimitService.check_monthly_limit(account, 'content_ideas', 1)
-LimitService.increment_usage(account, 'content_ideas', 1)
-
-# NEW (KEEP):
-CreditService.check_credits(account, required_credits)
-# Then after operation:
-CreditService.deduct_credits_for_operation(...)
-```
-
-#### 1.5 Add Credit Balance Check to Automation
-
-**File:** `backend/igny8_core/business/automation/services.py` (or similar)
-
-```python
-from igny8_core.business.billing.services.credit_service import CreditService
-from igny8_core.business.billing.exceptions import InsufficientCreditsError
-
-def run_automation(automation_config, account):
-    """Run automation with credit pre-check"""
-    
-    # Estimate credits needed
-    estimated_credits = estimate_automation_cost(automation_config)
-    
-    # Check balance BEFORE starting
-    try:
-        CreditService.check_credits(account, estimated_credits)
-    except InsufficientCreditsError:
-        raise AutomationError(
-            f"Insufficient credits. Need {estimated_credits}, have {account.credits}. "
-            f"Please add credits to continue."
-        )
-    
-    # Run automation stages
-    for stage in automation_config.stages:
-        # Each stage checks/deducts its own credits
-        run_stage(stage, account)
-```
-
-#### 1.6 Enforce Keywords Limit Properly
-
-**Files to Update:**
-- `backend/igny8_core/business/planning/views.py` (keyword creation)
-- `backend/igny8_core/api/endpoints/seed_keywords.py` (SeedKeyword import)
-
-```python
-from igny8_core.business.billing.services.limit_service import LimitService, HardLimitExceededError
-
-# Before creating keywords:
-try:
-    LimitService.check_hard_limit(account, 'keywords', num_keywords_to_add)
-except HardLimitExceededError as e:
-    return Response({
-        'error': 'keyword_limit_exceeded',
-        'message': f'You have reached your keyword limit ({plan.max_keywords}). Upgrade your plan to add more.',
-        'current_count': current_count,
-        'limit': plan.max_keywords,
-        'upgrade_url': '/account/plans/upgrade'
-    }, status=402)
-
-# If check passes, create keywords
-keywords = Keywords.objects.bulk_create([...])
-```
-
----
-
-### 6.2 Phase 2: Frontend Cleanup (Week 2)
-
-#### 2.1 Remove Duplicate Data from Plans & Billing Page
-
-**File:** `frontend/src/pages/account/PlansAndBillingPage.tsx`
-
-**Current Plan Tab - Remove:**
-```tsx
-// ❌ DELETE: Credit balance display (move to Usage only)
-// ❌ DELETE: Usage breakdown charts
-// ❌ DELETE: Limit progress bars
-// ❌ DELETE: "Credits used this month" details
-```
-
-**Current Plan Tab - Keep:**
-```tsx
-// ✅ KEEP: Plan name, price, billing cycle
-// ✅ KEEP: Renewal date
-// ✅ KEEP: Brief summary text: "50 Pages/Articles • 2 Sites • 2 Users"
-// ✅ KEEP: Upgrade CTA button
-```
-
-#### 2.2 Redesign Usage Page with Multi-Dimensional Insights
-
-**File:** `frontend/src/pages/account/UsageAnalyticsPage.tsx`
-
-**New Structure:**
-
-```tsx
-/**
- * Usage & Insights Page - Complete Redesign
- * 
- * Tab 1: Overview (NEW)
- *   - Credit balance cards
- *   - Quick stats (sites, users, keywords count)
- *   - Period selector (7, 30, 90 days)
- *   - Top metrics
- * 
- * Tab 2: Your Limits
- *   - Sites, Users, Keywords progress bars
- *   - Ahrefs queries remaining
- * 
- * Tab 3: Credit Insights (NEW)
- *   - Credits by Site
- *   - Credits by Content Type (articles, images, etc.)
- *   - Credits by Image Quality (basic, quality, premium)
- *   - Credits by Automation
- *   - Timeline chart (7/30/90 days)
- * 
- * Tab 4: Activity Log
- *   - Detailed transaction history
- */
-
-type TabType = 'overview' | 'limits' | 'insights' | 'activity';
-```
-
-**Tab 1: Overview (NEW)**
-```tsx
-<div className="grid grid-cols-1 md:grid-cols-4 gap-4">
-  {/* Credit Balance Card */}
-  <Card>
-    <ZapIcon />
-    <div>Credits Available</div>
-    <div className="text-3xl">{credits.toLocaleString()}</div>
-  </Card>
-
-  {/* Sites Used Card */}
-  <Card>
-    <GlobeIcon />
-    <div>Sites</div>
-    <div className="text-3xl">{sitesCount} / {maxSites}</div>
-  </Card>
-
-  {/* Team Members Card */}
-  <Card>
-    <UsersIcon />
-    <div>Team Members</div>
-    <div className="text-3xl">{usersCount} / {maxUsers}</div>
-  </Card>
-
-  {/* Keywords Card */}
-  <Card>
-    <TagIcon />
-    <div>Keywords</div>
-    <div className="text-3xl">{keywordsCount.toLocaleString()} / {maxKeywords.toLocaleString()}</div>
-  </Card>
-</div>
-
-{/* Period Selector */}
-<div className="flex gap-2">
-  <Button onClick={() => setPeriod(7)}>Last 7 Days</Button>
-  <Button onClick={() => setPeriod(30)}>Last 30 Days</Button>
-  <Button onClick={() => setPeriod(90)}>Last 90 Days</Button>
-</div>
-```
-
-**Tab 3: Credit Insights (NEW)**
-```tsx
-{/* Credits by Site */}
-<Card>
-  <h3>Credits by Site</h3>
-  {sites.map(site => (
-    <div key={site.id}>
-      <div>{site.name}</div>
-      <ProgressBar value={site.credits_used} max={totalCredits} />
-      <div>{site.credits_used.toLocaleString()} credits</div>
-    </div>
-  ))}
-</Card>
-
-{/* Credits by Content Type */}
-<Card>
-  <h3>Credits by Content Type</h3>
-  <DonutChart data={[
-    { label: 'Articles', value: contentCredits },
-    { label: 'Images', value: imageCredits },
-    { label: 'Ideas & Planning', value: ideaCredits },
-    { label: 'Other', value: otherCredits },
-  ]} />
-</Card>
-
-{/* Credits by Image Quality */}
-<Card>
-  <h3>Image Generation by Quality</h3>
-  {imageQualityBreakdown.map(tier => (
-    <div key={tier.quality}>
-      <div>{tier.quality} Quality</div>
-      <div>{tier.count} images • {tier.credits_used} credits</div>
-      <div className="text-xs">({tier.credits_per_image} credits each)</div>
-    </div>
-  ))}
-</Card>
-
-{/* Credits by Automation */}
-<Card>
-  <h3>Automation Runs</h3>
-  {automations.map(auto => (
-    <div key={auto.id}>
-      <div>{auto.name}</div>
-      <div>{auto.runs_count} runs • {auto.credits_used} credits</div>
-    </div>
-  ))}
-</Card>
-
-{/* Timeline Chart */}
-<Card>
-  <h3>Credit Usage Over Time</h3>
-  <LineChart 
-    data={usageTimeline}
-    xAxis="date"
-    yAxis="credits_used"
-  />
-</Card>
-```
-
-#### 2.3 Update API Interfaces
-
-**File:** `frontend/src/services/billing.api.ts`
-
-```typescript
-// REMOVE from Plan interface:
-export interface Plan {
-  id: number;
-  name: string;
-  price: number;
-  
-  // KEEP ONLY THESE LIMITS:
-  max_sites?: number;
-  max_users?: number;
-  max_keywords?: number;
-  max_ahrefs_queries?: number;  // NEW
-  
-  included_credits?: number;
-  
-  // REMOVE THESE:
-  // max_content_ideas?: number;     // ❌ DELETE
-  // max_content_words?: number;     // ❌ DELETE
-  // max_images_basic?: number;      // ❌ DELETE
-  // max_images_premium?: number;    // ❌ DELETE
-  // max_image_prompts?: number;     // ❌ DELETE
-  // max_clusters?: number;          // ❌ DELETE
-}
-
-// UPDATE UsageSummary interface:
-export interface UsageSummary {
-  account_id: number;
-  plan_name: string;
-  period_start: string;
-  period_end: string;
-  
-  hard_limits: {
-    sites?: LimitUsage;
-    users?: LimitUsage;
-    keywords?: LimitUsage;
-    // clusters?: LimitUsage;  // ❌ DELETE
-  };
-  
-  monthly_limits: {
-    ahrefs_queries?: LimitUsage;  // ONLY THIS ONE
-    // content_ideas?: LimitUsage;     // ❌ DELETE
-    // content_words?: LimitUsage;     // ❌ DELETE
-    // images_basic?: LimitUsage;      // ❌ DELETE
-    // images_premium?: LimitUsage;    // ❌ DELETE
-    // image_prompts?: LimitUsage;     // ❌ DELETE
-  };
-}
-
-// NEW: Multi-dimensional insights
-export interface CreditInsights {
-  period_days: number;
-  total_credits_used: number;
-  
-  by_site: Array<{
-    site_id: number;
-    site_name: string;
-    credits_used: number;
-    percentage: number;
-  }>;
-  
-  by_operation: Array<{
-    operation_type: string;
-    display_name: string;
-    credits_used: number;
-    count: number;
-    percentage: number;
-  }>;
-  
-  by_image_quality: Array<{
-    quality_tier: 'basic' | 'quality' | 'premium';
-    model_name: string;
-    credits_per_image: number;
-    images_generated: number;
-    total_credits: number;
-  }>;
-  
-  by_automation: Array<{
-    automation_id: number;
-    automation_name: string;
-    runs_count: number;
-    credits_used: number;
-  }>;
-  
-  timeline: Array<{
-    date: string;
-    credits_used: number;
-  }>;
-}
-
-// NEW API function
-export async function getCreditInsights(days: number = 30): Promise<CreditInsights> {
-  return fetchAPI(`/v1/billing/credits/insights/?days=${days}`);
-}
-```
-
-#### 2.4 Update UsageLimitsPanel Component
-
-**File:** `frontend/src/components/billing/UsageLimitsPanel.tsx`
-
-```tsx
-// REMOVE monthly limit configs for deleted fields
-const monthlyLimitConfig = {
-  // ONLY THIS ONE:
-  ahrefs_queries: { 
-    icon: <SearchIcon className="w-5 h-5" />, 
-    color: 'purple' as const,
-    description: 'Keyword research queries per month'
-  },
-  
-  // DELETE THESE:
-  // content_ideas: {...},    // ❌ DELETE
-  // content_words: {...},    // ❌ DELETE
-  // images_basic: {...},     // ❌ DELETE
-  // images_premium: {...},   // ❌ DELETE
-  // image_prompts: {...},    // ❌ DELETE
-};
-
-// KEEP hard limits
-const hardLimitConfig = {
-  sites: { icon: <GlobeIcon />, color: 'success' },
-  users: { icon: <UsersIcon />, color: 'info' },
-  keywords: { icon: <TagIcon />, color: 'purple' },
-  // clusters: {...},  // ❌ DELETE if not needed
-};
-```
-
-#### 2.5 Use User-Friendly Terminology
-
-**Global Search & Replace:**
-
-| Technical Term | User-Friendly Term |
-|---------------|-------------------|
-| "API Activity" | "Activity Log" or "Recent Actions" |
-| "API Operations" | "Actions" or "Activities" |
-| "operation_type" | "Action Type" |
-| "Monthly Limits" | "Monthly Allowances" |
-| "Hard Limits" | "Plan Limits" |
-| "Credits Used" | "Credits Spent" |
-| "Balance" | "Credits Available" |
-
----
-
-### 6.3 Phase 3: Keyword Research Implementation (Week 3)
-
-#### 3.1 Backend: Ahrefs Service
-
-**Create:** `backend/igny8_core/business/keywords/ahrefs_service.py`
-
-```python
-from igny8_core.business.billing.services.limit_service import LimitService, MonthlyLimitExceededError
-import requests
-
-class AhrefsService:
-    """Service for Ahrefs keyword research with monthly limit enforcement"""
-    
-    @staticmethod
-    def query_keywords(account, query_params):
-        """
-        Query Ahrefs for keywords with limit enforcement.
-        
-        Args:
-            account: Account instance
-            query_params: dict with search parameters
-            
-        Returns:
-            dict: Ahrefs API response with keyword data
-            
-        Raises:
-            MonthlyLimitExceededError: If monthly Ahrefs query limit exceeded
-        """
-        # Check monthly limit BEFORE querying
-        try:
-            LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)
-        except MonthlyLimitExceededError as e:
-            raise AhrefsQueryLimitExceeded(
-                f"You've used all your Ahrefs queries this month. "
-                f"Limit: {account.plan.max_ahrefs_queries}. "
-                f"Resets on {account.usage_period_end.strftime('%B %d, %Y')}. "
-                f"Upgrade your plan for more queries."
-            )
-        
-        # Make Ahrefs API call
-        try:
-            response = requests.post(
-                'https://api.ahrefs.com/v3/site-explorer/keywords',
-                headers={'Authorization': f'Bearer {settings.AHREFS_API_KEY}'},
-                json=query_params
-            )
-            response.raise_for_status()
-            results = response.json()
-            
-            # Increment usage counter
-            LimitService.increment_usage(account, 'ahrefs_queries', 1)
-            
-            return results
-            
-        except requests.RequestException as e:
-            logger.error(f"Ahrefs API error: {e}")
-            raise AhrefsAPIError("Failed to fetch keyword data from Ahrefs")
-```
-
-#### 3.2 Frontend: Keyword Research Page
-
-**Create:** `frontend/src/pages/Planner/KeywordResearchPage.tsx`
-
-```tsx
-/**
- * Keyword Research Page - Two Options
- * 1. Browse IGNY8 pre-researched keywords (free)
- * 2. Research with Ahrefs (monthly limit)
- */
-
-type ResearchTab = 'browse' | 'ahrefs';
-
-export default function KeywordResearchPage() {
-  const [activeTab, setActiveTab] = useState<ResearchTab>('browse');
-  const [ahrefsLimit, setAhrefsLimit] = useState({ used: 0, limit: 50 });
-
-  return (
-    <>
-      <PageHeader 
-        title="Keyword Research" 
-        description="Find high-opportunity keywords for your content strategy"
-      />
-
-      {/* Tab Selector */}
-      <div className="flex gap-4 mb-6">
-        <Button
-          variant={activeTab === 'browse' ? 'primary' : 'outline'}
-          onClick={() => setActiveTab('browse')}
-        >
-          <DatabaseIcon className="w-4 h-4" />
-          Browse Pre-Researched Keywords
-        </Button>
-        
-        <Button
-          variant={activeTab === 'ahrefs' ? 'primary' : 'outline'}
-          onClick={() => setActiveTab('ahrefs')}
-        >
-          <SearchIcon className="w-4 h-4" />
-          Research with Ahrefs
-          <Badge variant="soft" tone="purple">
-            {ahrefsLimit.limit - ahrefsLimit.used} remaining
-          </Badge>
-        </Button>
-      </div>
-
-      {/* Tab Content */}
-      {activeTab === 'browse' && (
-        <BrowseKeywordsPanel />
-      )}
-
-      {activeTab === 'ahrefs' && (
-        <AhrefsResearchPanel 
-          limit={ahrefsLimit}
-          onQuerySuccess={() => {
-            setAhrefsLimit(prev => ({ 
-              ...prev, 
-              used: prev.used + 1 
-            }));
-          }}
-        />
-      )}
-    </>
-  );
-}
-```
-
-**Browse Keywords Panel (Existing SeedKeywords):**
-```tsx
-function BrowseKeywordsPanel() {
-  return (
-    <Card>
-      <h3>Pre-Researched High-Opportunity Keywords</h3>
-      <p>Browse thousands of analyzed keywords, ready to use.</p>
-      
-      {/* Filters */}
-      <div className="flex gap-4">
-        <Select label="Industry" options={industries} />
-        <Select label="Sector" options={sectors} />
-        <Select label="Country" options={countries} />
-        <Input placeholder="Search keywords..." />
-      </div>
-
-      {/* Results Table */}
-      <Table>
-        <thead>
-          <tr>
-            <th>Keyword</th>
-            <th>Search Volume</th>
-            <th>Difficulty</th>
-            <th>Opportunity Score</th>
-            <th></th>
-          </tr>
-        </thead>
-        <tbody>
-          {keywords.map(kw => (
-            <tr key={kw.id}>
-              <td>{kw.keyword}</td>
-              <td>{kw.search_volume}</td>
-              <td><Badge>{kw.difficulty}</Badge></td>
-              <td>{kw.opportunity_score}/100</td>
-              <td>
-                <Button size="sm" onClick={() => addToWorkspace(kw)}>
-                  Add to Workspace
-                </Button>
-              </td>
-            </tr>
-          ))}
-        </tbody>
-      </Table>
-    </Card>
-  );
-}
-```
-
-**Ahrefs Research Panel (NEW):**
-```tsx
-function AhrefsResearchPanel({ limit, onQuerySuccess }) {
-  const [query, setQuery] = useState('');
-  const [results, setResults] = useState([]);
-  const [loading, setLoading] = useState(false);
-
-  const remaining = limit.limit - limit.used;
-  const canQuery = remaining > 0;
-
-  const handleSearch = async () => {
-    if (!canQuery) {
-      toast.error('You have used all your Ahrefs queries this month.');
-      return;
-    }
-
-    try {
-      setLoading(true);
-      const data = await fetchAPI('/v1/keywords/ahrefs/search/', {
-        method: 'POST',
-        body: JSON.stringify({ query })
-      });
-      setResults(data.keywords);
-      onQuerySuccess();
-      toast.success('Keywords fetched from Ahrefs!');
-    } catch (error) {
-      toast.error(error.message);
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  return (
-    <Card>
-      <div className="flex items-center justify-between mb-4">
-        <h3>Live Keyword Research with Ahrefs</h3>
-        <Badge variant="soft" tone={remaining > 10 ? 'success' : 'warning'}>
-          {remaining} / {limit.limit} queries remaining
-        </Badge>
-      </div>
-
-      {!canQuery && (
-        <Alert tone="warning">
-          <AlertCircleIcon />
-          <div>
-            <div>No queries remaining</div>
-            <div>Your limit resets on {resetDate}. Upgrade for more queries.</div>
-            <Button size="sm" onClick={() => navigate('/account/plans/upgrade')}>
-              Upgrade Plan
-            </Button>
-          </div>
-        </Alert>
-      )}
-
-      {canQuery && (
-        <>
-          <div className="flex gap-4 mb-4">
-            <Input
-              placeholder="Enter seed keyword (e.g., 'digital marketing')"
-              value={query}
-              onChange={e => setQuery(e.target.value)}
-              onKeyPress={e => e.key === 'Enter' && handleSearch()}
-            />
-            <Button onClick={handleSearch} loading={loading}>
-              <SearchIcon /> Research Keywords
-            </Button>
-          </div>
-
-          {/* Results */}
-          {results.length > 0 && (
-            <Table>
-              <thead>
-                <tr>
-                  <th>Keyword</th>
-                  <th>Volume</th>
-                  <th>Difficulty</th>
-                  <th>CPC</th>
-                  <th></th>
-                </tr>
-              </thead>
-              <tbody>
-                {results.map((kw, idx) => (
-                  <tr key={idx}>
-                    <td>{kw.keyword}</td>
-                    <td>{kw.volume.toLocaleString()}</td>
-                    <td><Badge>{kw.difficulty}</Badge></td>
-                    <td>${kw.cpc}</td>
-                    <td>
-                      <Button size="sm" onClick={() => addToWorkspace(kw)}>
-                        Add to Workspace
-                      </Button>
-                    </td>
-                  </tr>
-                ))}
-              </tbody>
-            </Table>
-          )}
-        </>
-      )}
-    </Card>
-  );
-}
-```
-
----
-
-### 6.4 Phase 4: Validation & Enforcement (Week 4)
-
-#### 4.1 Credit Balance Validation Checklist
-
-**File:** Search all AI operation services
-
-```python
-# REQUIRED PATTERN for all AI operations:
-
-# 1. BEFORE operation - estimate and check
-estimated_credits = estimate_credits_needed(operation_params)
-CreditService.check_credits(account, estimated_credits)
-
-# 2. EXECUTE operation
-result = ai_service.execute(operation_params)
-
-# 3. AFTER operation - calculate actual and deduct
-actual_tokens = result.usage.total_tokens
-actual_credits = CreditService.calculate_credits_from_tokens(
-    operation_type='content_generation',
-    tokens_input=result.usage.prompt_tokens,
-    tokens_output=result.usage.completion_tokens
-)
-CreditService.deduct_credits_for_operation(
-    account=account,
-    operation_type='content_generation',
-    amount=actual_credits,
-    model=result.model,
-    tokens_in=result.usage.prompt_tokens,
-    tokens_out=result.usage.completion_tokens,
-    metadata={'content_id': content.id}
-)
-```
-
-**Locations to Verify:**
-- ✅ Content generation service
-- ✅ Image generation service
-- ✅ Idea generation service
-- ✅ Clustering service
-- ✅ Internal linking service
-- ✅ Optimization service
-- ✅ Automation runner (PRE-CHECK before starting!)
-
-#### 4.2 Automation Credit Pre-Check
-
-**File:** `backend/igny8_core/business/automation/services.py`
-
-```python
-def estimate_automation_cost(automation_config):
-    """Estimate credits needed for full automation run"""
-    estimated = 0
-    
-    for stage in automation_config.stages:
-        if stage.type == 'clustering':
-            estimated += 10  # Base estimate
-        elif stage.type == 'idea_generation':
-            estimated += stage.num_ideas * 2
-        elif stage.type == 'content_generation':
-            estimated += stage.num_articles * 50  # Rough estimate
-        elif stage.type == 'image_generation':
-            estimated += stage.num_images * stage.credits_per_image
-        elif stage.type == 'linking':
-            estimated += stage.num_articles * 8
-    
-    # Add 20% buffer
-    return int(estimated * 1.2)
-
-def run_automation(automation_config, account, trigger='manual'):
-    """
-    Run automation with upfront credit validation.
-    
-    Raises:
-        InsufficientCreditsError: If not enough credits available
-    """
-    # Estimate total cost
-    estimated_credits = estimate_automation_cost(automation_config)
-    
-    # CHECK CREDITS BEFORE STARTING
-    try:
-        CreditService.check_credits(account, estimated_credits)
-    except InsufficientCreditsError:
-        # Log failed attempt
-        AutomationRun.objects.create(
-            automation=automation_config,
-            account=account,
-            status='failed',
-            error_message=f'Insufficient credits. Need {estimated_credits}, have {account.credits}.',
-            trigger=trigger
-        )
-        raise
-    
-    # Create run record
-    run = AutomationRun.objects.create(
-        automation=automation_config,
-        account=account,
-        status='running',
-        estimated_credits=estimated_credits,
-        trigger=trigger
-    )
-    
-    try:
-        # Execute stages (each deducts credits)
-        for stage in automation_config.stages:
-            execute_stage(stage, account, run)
-        
-        # Mark complete
-        run.status = 'completed'
-        run.actual_credits = run.credits_used
-        run.save()
-        
-    except Exception as e:
-        run.status = 'failed'
-        run.error_message = str(e)
-        run.save()
-        raise
-```
-
-#### 4.3 Frontend Credit Check Before Actions
-
-**Component:** Add to all credit-consuming actions
-
-```tsx
-// Hook for credit validation
-function useCreditCheck() {
-  const { user } = useAuthStore();
-  
-  const checkCredits = useCallback(async (estimatedCredits: number) => {
-    if (user.account.credits < estimatedCredits) {
-      const confirmed = await showConfirmDialog({
-        title: 'Insufficient Credits',
-        message: `This action requires approximately ${estimatedCredits} credits, but you only have ${user.account.credits} available.`,
-        confirmText: 'Add Credits',
-        cancelText: 'Cancel',
-      });
-      
-      if (confirmed) {
-        navigate('/account/plans');
-      }
-      
-      return false;
-    }
-    
-    return true;
-  }, [user]);
-  
-  return { checkCredits };
-}
-
-// Usage example:
-function GenerateContentButton({ taskId }) {
-  const { checkCredits } = useCreditCheck();
-  
-  const handleGenerate = async () => {
-    // Estimate credits (rough estimate: 50 for article)
-    const canProceed = await checkCredits(50);
-    if (!canProceed) return;
-    
-    // Proceed with generation
-    await generateContent(taskId);
-  };
-  
-  return <Button onClick={handleGenerate}>Generate Content</Button>;
-}
-```
-
----
-
-### 6.5 Phase 5: Testing & Validation (Week 5)
-
-#### Test Cases
-
-**Limit Enforcement:**
-- [ ] Try to create site when at `max_sites` → Should fail with upgrade prompt
-- [ ] Try to invite user when at `max_users` → Should fail with upgrade prompt
-- [ ] Try to add 100 keywords when 50 slots remain and limit is 1000 → Should succeed
-- [ ] Try to add 100 keywords when 30 slots remain → Should fail
-- [ ] Try to query Ahrefs when at monthly limit → Should fail with reset date
-- [ ] Query Ahrefs successfully → Counter increments
-- [ ] Monthly reset → Ahrefs counter resets to 0
-
-**Credit Validation:**
-- [ ] Try to generate content with 0 credits → Should fail immediately
-- [ ] Try to run automation with insufficient credits → Should fail before starting
-- [ ] Generate content → Credits deducted correctly based on tokens
-- [ ] Generate image (basic) → 1 credit deducted
-- [ ] Generate image (quality) → 5 credits deducted
-- [ ] Generate image (premium) → 15 credits deducted
-- [ ] Run automation → All stages check/deduct credits properly
-
-**Page Reorganization:**
-- [ ] Plans & Billing → Current Plan: NO credit usage details
-- [ ] Plans & Billing → Current Plan: Brief summary text only
-- [ ] Usage → Overview: Shows credit balance, sites/users/keywords count
-- [ ] Usage → Limits: Shows only 4 limits (sites, users, keywords, ahrefs)
-- [ ] Usage → Insights: Shows multi-dimensional breakdowns
-- [ ] No duplicate data between Plans & Usage
-
-**Terminology:**
-- [ ] No "API" references in user-facing text
-- [ ] "Operations" changed to "Actions" or "Activities"
-- [ ] User-friendly language throughout
-
----
-
-## 7. Updated Page Reorganization
-
-### 7.1 Page Reorganization (High Priority) 🔥
-
-**Problem:** Data duplication creates confusion and maintenance overhead.
-
-**Proposed Solution:** Clear separation of concerns between Plans & Billing vs Usage.
-
-#### Plans & Billing → Focus on FINANCIAL aspects
-
-**Tab 1: Current Plan**
-- Show: Plan name, price, billing cycle, renewal date
-- Show: Brief limits summary (e.g., "50 Pages/Articles, 2 Sites, 2 Users")
-- **Remove:** Detailed limit progress bars (move to Usage)
-- **Remove:** Credits used this month breakdown (move to Usage)
-- Action: "Upgrade Plan" button
-
-**Tab 2: Upgrade Plan**
-- Show: Pricing table with plan comparison
-- Show: Plan features and limits (static, for comparison)
-- Action: Purchase/upgrade plan
-
-**Tab 3: Billing History**
-- Show: Invoices (with download PDF)
-- Show: Payment methods management
-- Show: Credit package purchases (financial transactions only)
-
-#### Usage → Focus on CONSUMPTION tracking
-
-**Tab 1: Limits & Usage** _(Keep as is - this is perfect)_
-- Show: All hard limits with progress bars (sites, users, keywords, clusters)
-- Show: All monthly limits with progress bars (ideas, words, images)
-- Show: Days until reset for monthly limits
-- Show: Credit balance and monthly usage
-- Action: "Upgrade for more" CTA when approaching limits
-
-**Tab 2: Credit History** _(Keep as is)_
-- Show: Credit transaction log (purchases, deductions, adjustments)
-- Show: Operation details (what consumed credits)
-- Filter: By operation type, date range
-
-**Tab 3: Activity Log** _(Keep as is)_
-- Show: API operations by type
-- Show: Total operations count
-- Show: Breakdown by operation type
-
-#### Summary of Changes
-
-| Page | Current State | Proposed Change |
-|------|--------------|-----------------|
-| **Plans & Billing → Current Plan** | Shows credits, usage, limits | Remove detailed usage, keep financial summary only |
-| **Plans & Billing → History** | Invoices and payments | Keep as is (financial focus) |
-| **Usage → Limits & Usage** | Detailed limits panel | Keep as is (consumption focus) |
-| **Usage → Credit History** | Transaction log | Keep as is (consumption focus) |
-
-**Rationale:**
-- **Plans & Billing** = "What am I paying for?" (financial/subscription management)
-- **Usage** = "What am I using?" (consumption monitoring)
-
----
-
-### 7.1 Plans & Billing Page (Simplified)
-
-**Purpose:** Financial management and subscription control
-
-**Tab 1: Current Plan**
-```tsx
-<Card>
-  <h2>{plan.name} Plan</h2>
-  <div className="text-3xl">${plan.price}/month</div>
-  <div>Renews on {renewalDate}</div>
-  
-  {/* Brief Summary - NO detailed limits */}
-  <div className="text-sm text-gray-600">
-    Your plan includes: {plan.included_credits} credits per month • 
-    {plan.max_sites} sites • {plan.max_users} team members
-  </div>
-  
-  {/* Upgrade CTA */}
-  <Button onClick={() => navigate('/account/plans/upgrade')}>
-    Upgrade Plan
-  </Button>
-</Card>
-
-{/* ❌ REMOVE: Credit usage charts */}
-{/* ❌ REMOVE: Limit progress bars */}
-{/* ❌ REMOVE: "Credits used this month" */}
-```
-
-**Tab 2: Upgrade Plan** _(No changes needed)_
-
-**Tab 3: Billing History** _(No changes needed)_
-
----
-
-### 7.2 Usage Page (Multi-Dimensional Insights)
-
-**Purpose:** Monitor consumption and optimize usage
-
-**Tab 1: Overview (NEW)**
-```tsx
-{/* Quick Stats Cards */}
-<div className="grid grid-cols-4 gap-4">
-  <StatCard 
-    icon={<ZapIcon />}
-    label="Credits Available"
-    value={credits.toLocaleString()}
-    color="brand"
-  />
-  <StatCard 
-    icon={<GlobeIcon />}
-    label="Sites"
-    value={`${sitesCount} / ${maxSites}`}
-    color="success"
-  />
-  <StatCard 
-    icon={<UsersIcon />}
-    label="Team Members"
-    value={`${usersCount} / ${maxUsers}`}
-    color="info"
-  />
-  <StatCard 
-    icon={<TagIcon />}
-    label="Keywords"
-    value={`${keywordsCount} / ${maxKeywords}`}
-    color="purple"
-  />
-</div>
-
-{/* Period Selector */}
-<ButtonGroup>
-  <Button onClick={() => setPeriod(7)}>Last 7 Days</Button>
-  <Button onClick={() => setPeriod(30)}>Last 30 Days</Button>
-  <Button onClick={() => setPeriod(90)}>Last 90 Days</Button>
-</ButtonGroup>
-
-{/* Top Metrics for Selected Period */}
-<div className="grid grid-cols-3 gap-4">
-  <Card>
-    <div>Credits Spent</div>
-    <div className="text-2xl">{periodCredits.toLocaleString()}</div>
-  </Card>
-  <Card>
-    <div>Articles Created</div>
-    <div className="text-2xl">{periodArticles}</div>
-  </Card>
-  <Card>
-    <div>Images Generated</div>
-    <div className="text-2xl">{periodImages}</div>
-  </Card>
-</div>
-```
-
-**Tab 2: Your Limits**
-```tsx
-{/* Only 4 limits total */}
-<LimitCard
-  title="Sites"
-  icon={<GlobeIcon />}
-  current={sitesCount}
-  limit={maxSites}
-  type="permanent"
-/>
-
-<LimitCard
-  title="Team Members"
-  icon={<UsersIcon />}
-  current={usersCount}
-  limit={maxUsers}
-  type="permanent"
-/>
-
-<LimitCard
-  title="Keywords in Workspace"
-  icon={<TagIcon />}
-  current={keywordsCount}
-  limit={maxKeywords}
-  type="permanent"
-/>
-
-<LimitCard
-  title="Ahrefs Research Queries"
-  icon={<SearchIcon />}
-  current={ahrefsUsed}
-  limit={ahrefsLimit}
-  type="monthly"
-  daysUntilReset={daysUntilReset}
-/>
-```
-
-**Tab 3: Credit Insights (NEW)**
-```tsx
-{/* Multi-dimensional breakdowns */}
-
-{/* By Site */}
-<Card>
-  <h3>Credits by Site</h3>
-  <div>See which sites consume the most credits</div>
-  {insights.by_site.map(site => (
-    <div key={site.id}>
-      <div className="flex justify-between">
-        <span>{site.name}</span>
-        <span>{site.credits_used.toLocaleString()} credits ({site.percentage}%)</span>
-      </div>
-      <ProgressBar value={site.percentage} />
-    </div>
-  ))}
-</Card>
-
-{/* By Action Type */}
-<Card>
-  <h3>Credits by Action Type</h3>
-  <DonutChart data={insights.by_operation} />
-  <div>
-    {insights.by_operation.map(op => (
-      <div key={op.type}>
-        <span>{op.display_name}</span>
-        <span>{op.credits_used} credits ({op.count} times)</span>
-      </div>
-    ))}
-  </div>
-</Card>
-
-{/* By Image Quality */}
-<Card>
-  <h3>Image Generation Breakdown</h3>
-  <div>Credits vary by quality tier</div>
-  {insights.by_image_quality.map(tier => (
-    <div key={tier.quality_tier}>
-      <div>{tier.quality_tier} Quality</div>
-      <div>{tier.images_generated} images × {tier.credits_per_image} credits = {tier.total_credits} credits</div>
-      <Badge>{tier.model_name}</Badge>
-    </div>
-  ))}
-</Card>
-
-{/* By Automation */}
-<Card>
-  <h3>Automation Runs</h3>
-  {insights.by_automation.map(auto => (
-    <div key={auto.id}>
-      <div>{auto.name}</div>
-      <div>{auto.runs_count} runs • {auto.credits_used} credits total</div>
-    </div>
-  ))}
-</Card>
-
-{/* Timeline Chart */}
-<Card>
-  <h3>Credit Usage Over Time</h3>
-  <LineChart 
-    data={insights.timeline}
-    xAxis="date"
-    yAxis="credits_used"
-  />
-</Card>
-```
-
-**Tab 4: Activity Log** _(Keep existing, but rename from "API Activity")_
-
----
-
-## 8. Backend Changes Summary
-
-### 8.1 Files to Modify
-
-| File | Action | Description |
-|------|--------|-------------|
-| `backend/igny8_core/auth/models.py` | Edit | Remove unused limit fields from Plan & Account |
-| `backend/igny8_core/auth/migrations/0XXX_*.py` | Create | Migration to remove fields |
-| `backend/igny8_core/business/billing/services/limit_service.py` | Edit | Remove unused limit mappings |
-| `backend/igny8_core/auth/serializers.py` | Edit | Remove fields from PlanSerializer |
-| `backend/igny8_core/business/keywords/ahrefs_service.py` | Create | New service for Ahrefs integration |
-| `backend/igny8_core/business/automation/services.py` | Edit | Add credit pre-check |
-| `backend/igny8_core/business/planning/views.py` | Edit | Add keyword limit enforcement |
-| `backend/igny8_core/modules/billing/views.py` | Edit | Add credit insights endpoint |
-
-### 8.2 New API Endpoints
-
-```python
-# Credit Insights (NEW)
-GET /api/v1/billing/credits/insights/?days=30
-Response: CreditInsights object with multi-dimensional breakdowns
-
-# Ahrefs Search (NEW)
-POST /api/v1/keywords/ahrefs/search/
-Body: { "query": "digital marketing", "country": "us" }
-Response: { "keywords": [...], "queries_remaining": 42 }
-```
-
----
-
-## 9. Frontend Changes Summary
-
-### 9.1 Files to Modify
-
-| File | Action | Description |
-|------|--------|-------------|
-| `frontend/src/pages/account/PlansAndBillingPage.tsx` | Edit | Remove credit usage details from Current Plan tab |
-| `frontend/src/pages/account/UsageAnalyticsPage.tsx` | Rewrite | Add Overview & Credit Insights tabs |
-| `frontend/src/components/billing/UsageLimitsPanel.tsx` | Edit | Remove unused limits, add Ahrefs |
-| `frontend/src/services/billing.api.ts` | Edit | Remove unused fields, add new interfaces |
-| `frontend/src/pages/Planner/KeywordResearchPage.tsx` | Create | New page for keyword research |
-| `frontend/src/components/keywords/AhrefsResearchPanel.tsx` | Create | Ahrefs search component |
-
-### 9.2 New Components
-
-```tsx
-// Credit Insights Components
-CreditInsightsDashboard.tsx
-CreditsBySiteWidget.tsx
-CreditsByOperationWidget.tsx
-CreditsByImageQualityWidget.tsx
-CreditsByAutomationWidget.tsx
-CreditTimelineChart.tsx
-
-// Ahrefs Research
-KeywordResearchPage.tsx
-AhrefsResearchPanel.tsx
-BrowseKeywordsPanel.tsx
-```
-
----
-
-## 10. Testing Checklist
-
-**Problem:** Keywords have `max_keywords` limit defined but enforcement is inconsistent.
-
-**Required Changes:**
-
-1. **Add Pre-Create Checks:**
-
-   Location: `backend/igny8_core/business/planning/views.py` (or wherever keywords are created)
-   ```python
-   # Before creating keywords
-   from igny8_core.business.billing.services.limit_service import LimitService
-   
-   def create_keywords(account, keyword_data):
-       # Check if adding keywords would exceed limit
-       num_new_keywords = len(keyword_data)
-       LimitService.check_hard_limit(account, 'keywords', num_new_keywords)
-       
-       # If check passes, create keywords
-       keywords = Keywords.objects.bulk_create([...])
-       
-       return keywords
-   ```
-
-2. **Add Check to SeedKeyword Import:**
-
-   Location: `backend/igny8_core/api/endpoints/seed_keywords.py` (or similar)
-   ```python
-   # In addSeedKeywordsToWorkflow endpoint
-   def add_seed_keywords_to_workflow(seed_keyword_ids, site_id, sector_id):
-       account = Site.objects.get(id=site_id).account
-       
-       # Check limit BEFORE importing
-       LimitService.check_hard_limit(account, 'keywords', len(seed_keyword_ids))
-       
-       # Import keywords
-       for seed_kw in SeedKeyword.objects.filter(id__in=seed_keyword_ids):
-           Keywords.objects.create(...)
-   ```
-
-3. **Add Check to Bulk Import:**
-
-   Ensure CSV/Excel keyword imports also check limits before processing.
-
-4. **User-Facing Error Messages:**
-   ```python
-   try:
-       LimitService.check_hard_limit(account, 'keywords', 50)
-   except HardLimitExceededError as e:
-       return Response({
-           'error': 'keyword_limit_exceeded',
-           'message': 'You have reached your keyword limit. Upgrade your plan to add more keywords.',
-           'current': 950,
-           'limit': 1000,
-           'upgrade_url': '/account/plans/upgrade'
-       }, status=402)
-   ```
-
-**Testing:**
-- ✅ Try to import keywords beyond limit → Should fail with clear error
-- ✅ Try to create single keyword at limit → Should fail
-- ✅ Try to bulk import → Should fail if total exceeds
-- ✅ Error message should show current count, limit, and upgrade CTA
-
----
-
-### 6.3 Implement Ahrefs Query Limit (Medium Priority)
-
-**Problem:** Future feature needs limit definition and enforcement.
-
-**Required Changes:**
-
-1. **Database Migration:**
-   ```python
-   # Create migration: 0XXX_add_ahrefs_query_limits.py
-   
-   operations = [
-       migrations.AddField(
-           model_name='plan',
-           name='max_ahrefs_queries',
-           field=models.IntegerField(default=50, validators=[MinValueValidator(0)]),
-       ),
-       migrations.AddField(
-           model_name='account',
-           name='usage_ahrefs_queries',
-           field=models.IntegerField(default=0, validators=[MinValueValidator(0)]),
-       ),
-   ]
-   ```
-
-2. **Update Plan Admin:**
-   ```python
-   # backend/igny8_core/auth/admin.py - PlanAdmin
-   fieldsets = (
-       # ... existing fieldsets ...
-       ('Monthly Limits (Reset on Billing Cycle)', {
-           'fields': (
-               'max_content_ideas', 'max_content_words',
-               'max_images_basic', 'max_images_premium', 'max_image_prompts',
-               'max_ahrefs_queries',  # ADD THIS
-           ),
-       }),
-   )
-   ```
-
-3. **Update LimitService:**
-   ```python
-   # backend/igny8_core/business/billing/services/limit_service.py
-   MONTHLY_LIMIT_MAPPINGS = {
-       # ... existing ...
-       'ahrefs_queries': {
-           'plan_field': 'max_ahrefs_queries',
-           'usage_field': 'usage_ahrefs_queries',
-           'display_name': 'Ahrefs Keyword Research Queries',
-       },
-   }
-   ```
-
-4. **Add to Plan Serializer:**
-   ```python
-   # backend/igny8_core/auth/serializers.py - PlanSerializer
-   class PlanSerializer(serializers.ModelSerializer):
-       class Meta:
-           fields = [
-               # ... existing fields ...
-               'max_ahrefs_queries',  # ADD THIS
-           ]
-   ```
-
-5. **Enforce in Ahrefs Service:**
-   ```python
-   # Create new service: backend/igny8_core/business/keywords/ahrefs_service.py
-   from igny8_core.business.billing.services.limit_service import LimitService
-   
-   class AhrefsService:
-       @staticmethod
-       def query_keywords(account, query_params):
-           # Check monthly limit
-           LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)
-           
-           # Execute Ahrefs API call
-           results = ahrefs_api.search_keywords(**query_params)
-           
-           # Increment usage counter
-           LimitService.increment_usage(account, 'ahrefs_queries', 1)
-           
-           return results
-   ```
-
-6. **Update Frontend:**
-   ```tsx
-   // frontend/src/components/billing/UsageLimitsPanel.tsx
-   const monthlyLimitConfig = {
-       // ... existing ...
-       ahrefs_queries: { 
-           icon: <SearchIcon className="w-5 h-5" />, 
-           color: 'purple' as const 
-       },
-   };
-   ```
-
-**Plan Values (Suggested):**
-
-| Plan | max_ahrefs_queries/month |
-|------|-------------------------|
-| Free | 0 (no access) |
-| Starter | 50 queries |
-| Growth | 200 queries |
-| Scale | 500 queries |
-
----
-
-### 6.4 Add Cluster Limit Enforcement (Low Priority)
-
-**Current State:** Clusters have `max_clusters` limit but may not be consistently enforced.
-
-**Recommendation:** Apply same enforcement pattern as keywords:
-1. Check limit before creating clusters
-2. Add to all cluster creation flows (auto-clustering, manual clustering)
-3. User-facing error messages
-
----
-
-### 6.5 Monthly Limits Reset Automation (Medium Priority)
-
-**Current State:** Monthly limits should reset at billing cycle, but automation may not be in place.
-
-**Check Required:**
-- Is there a scheduled task that calls `LimitService.reset_monthly_limits(account)`?
-- When do subscriptions renew?
-- How are usage fields reset?
-
-**Recommended:**
-```python
-# backend/igny8_core/business/billing/tasks.py (Celery)
-from celery import shared_task
-from igny8_core.auth.models import Account
-from igny8_core.business.billing.services.limit_service import LimitService
-
-@shared_task
-def reset_monthly_limits_for_accounts():
-    """Reset monthly limits for accounts whose billing period has ended"""
-    from django.utils import timezone
-    
-    now = timezone.now()
-    accounts = Account.objects.filter(
-        usage_period_end__lte=now,
-        status='active'
-    )
-    
-    for account in accounts:
-        LimitService.reset_monthly_limits(account)
-        logger.info(f"Reset monthly limits for account {account.id}")
-```
-
----
-
-## 7. Credit System (Working Well) ✅
-
-**No changes needed** - the credit system is well-designed:
-
-1. **Token-Based Calculation:** Uses `AIModelConfig.tokens_per_credit` for accurate pricing
-2. **Image Fixed Pricing:** Uses `AIModelConfig.credits_per_image` (1, 5, or 15)
-3. **Proper Logging:** `CreditUsageLog` tracks every operation with metadata
-4. **Transaction Ledger:** `CreditTransaction` maintains audit trail
-5. **Balance Tracking:** Account.credits is source of truth
-
-**Already Enforced Properly:**
-- ✅ Pre-flight balance checks before operations
-- ✅ Token-based credit calculation after API calls
-- ✅ Proper transaction logging
-- ✅ Clear error messages (402 Payment Required)
-
----
-
-## 8. Summary of Required Backend Changes
-
-### 8.1 Database Schema Changes
-
-**Add to Plan Model:**
-```python
-max_ahrefs_queries = models.IntegerField(default=50, validators=[MinValueValidator(0)])
-```
-
-**Add to Account Model:**
-```python
-usage_ahrefs_queries = models.IntegerField(default=0, validators=[MinValueValidator(0)])
-```
-
-### 8.2 Enforcement Additions
-
-**Locations Needing Limit Checks:**
-
-| Location | Limit Type | Method to Add |
-|----------|-----------|--------------|
-| Keyword creation | Hard | `LimitService.check_hard_limit(account, 'keywords', count)` |
-| SeedKeyword import | Hard | `LimitService.check_hard_limit(account, 'keywords', count)` |
-| Bulk keyword import | Hard | `LimitService.check_hard_limit(account, 'keywords', count)` |
-| Ahrefs query (future) | Monthly | `LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)` |
-| Cluster creation | Hard | `LimitService.check_hard_limit(account, 'clusters', count)` |
-
-### 8.3 Service Updates
-
-**LimitService Mappings:**
-```python
-# Add to MONTHLY_LIMIT_MAPPINGS
-'ahrefs_queries': {
-    'plan_field': 'max_ahrefs_queries',
-    'usage_field': 'usage_ahrefs_queries',
-    'display_name': 'Ahrefs Keyword Research Queries',
-}
-```
-
----
-
-## 9. Summary of Required Frontend Changes
-
-### 9.1 Page Content Adjustments
-
-**Plans & Billing Page:**
-```tsx
-// Remove from Current Plan tab:
-- ❌ Detailed credit usage breakdown (move to Usage)
-- ❌ Limit progress bars (move to Usage)
-
-// Keep in Current Plan tab:
-- ✅ Plan name, price, renewal date
-- ✅ Brief limits summary (text only)
-- ✅ Upgrade CTA
-
-// Keep History tab as is
-```
-
-**Usage Analytics Page:**
-```tsx
-// Keep all tabs as is - no changes needed
-// This page is perfectly organized
-```
-
-### 9.2 Component Updates
-
-**UsageLimitsPanel.tsx:**
-```tsx
-// Add Ahrefs queries to monthly limits config
-const monthlyLimitConfig = {
-    // ... existing ...
-    ahrefs_queries: { 
-        icon: <SearchIcon className="w-5 h-5" />, 
-        color: 'purple' as const 
-    },
-};
-```
-
-**billing.api.ts:**
-```typescript
-// Add to Plan interface
-export interface Plan {
-    // ... existing fields ...
-    max_ahrefs_queries?: number;  // ADD THIS
-}
-
-// Add to UsageSummary interface
-export interface UsageSummary {
-    // ... existing ...
-    monthly_limits: {
-        // ... existing ...
-        ahrefs_queries?: LimitUsage;  // ADD THIS
-    };
-}
-```
-
----
-
-## 10. Implementation Priority
-
-### Phase 1: Critical Fixes (Do First) 🔥
-
-1. **Enforce Keywords Limit** (Backend)
-   - Add checks to keyword creation flows
-   - Estimated effort: 4 hours
-   - Impact: Prevents users from exceeding limits
-
-2. **Page Reorganization** (Frontend)
-   - Remove duplicate data from Plans & Billing → Current Plan
-   - Estimated effort: 2 hours
-   - Impact: Reduces user confusion
-
-### Phase 2: Future Features (Do When Implementing Ahrefs)
-
-3. **Implement Ahrefs Query Limit** (Backend + Frontend)
-   - Database migration
-   - LimitService mapping
-   - Enforcement in Ahrefs service
-   - Frontend display
-   - Estimated effort: 6 hours
-   - Impact: Ready for Ahrefs integration
-
-### Phase 3: Nice-to-Have Improvements
-
-4. **Enforce Cluster Limit** (Backend)
-   - Similar to keywords enforcement
-   - Estimated effort: 2 hours
-
-5. **Monthly Limits Reset Automation** (Backend)
-   - Celery task for auto-reset
-   - Estimated effort: 3 hours
-
----
-
----
-
-## 11. Migration Strategy
-
-### Week-by-Week Rollout
-
-**Week 1: Backend Foundation**
-- [ ] Create database migration to remove unused fields
-- [ ] Update LimitService mappings
-- [ ] Update serializers
-- [ ] Add Ahrefs service skeleton
-- [ ] Deploy to staging
-
-**Week 2: Enforcement**
-- [ ] Add keyword limit checks to all entry points
-- [ ] Add automation credit pre-checks
-- [ ] Test all validation flows
-- [ ] Deploy to staging
-
-**Week 3: Frontend Cleanup**
-- [ ] Remove duplicate data from Plans & Billing
-- [ ] Update UsageLimitsPanel
-- [ ] Update terminology (remove "API", "operations")
-- [ ] Deploy to staging
-
-**Week 4: New Features**
-- [ ] Build Credit Insights tab
-- [ ] Build Keyword Research page
-- [ ] Integrate Ahrefs (when ready)
-- [ ] Add multi-dimensional widgets
-- [ ] Deploy to staging
-
-**Week 5: Testing & Production**
-- [ ] Full regression testing
-- [ ] User acceptance testing
-- [ ] Deploy to production
-- [ ] Monitor for issues
-
----
-
-## 12. Final Limits Configuration
-
-### 12.1 Database Schema (After Cleanup)
-
-**Plan Model - FINAL:**
-```python
-class Plan(models.Model):
-    # Basic Info
-    name = models.CharField(max_length=255)
-    slug = models.SlugField(unique=True)
-    price = models.DecimalField(max_digits=10, decimal_places=2)
-    
-    # ONLY 4 LIMITS:
-    max_sites = models.IntegerField(default=1)
-    max_users = models.IntegerField(default=1)
-    max_keywords = models.IntegerField(default=1000)
-    max_ahrefs_queries = models.IntegerField(default=50)
-    
-    # Credits
-    included_credits = models.IntegerField(default=0)
-    extra_credit_price = models.DecimalField(max_digits=10, decimal_places=2)
-```
-
-**Account Model - FINAL:**
-```python
-class Account(models.Model):
-    # Credits
-    credits = models.IntegerField(default=0)
-    
-    # ONLY 1 Usage Tracker:
-    usage_ahrefs_queries = models.IntegerField(default=0)
-    
-    # Billing Period
-    usage_period_start = models.DateTimeField(null=True)
-    usage_period_end = models.DateTimeField(null=True)
-```
-
-### 12.2 Suggested Plan Values
-
-| Plan | Price | Included Credits | Sites | Users | Keywords | Ahrefs Queries/mo |
-|------|-------|-----------------|-------|-------|----------|-------------------|
-| **Free** | $0 | 2,000 | 1 | 1 | 100 | 0 |
-| **Starter** | $49 | 10,000 | 2 | 2 | 1,000 | 50 |
-| **Growth** | $149 | 40,000 | 5 | 3 | 5,000 | 200 |
-| **Scale** | $399 | 120,000 | Unlimited | 5 | 20,000 | 500 |
-
----
-
-## 13. Success Criteria
-
-### 13.1 Technical Success
-
-- [ ] All unused limit fields removed from database
-- [ ] Migration runs successfully without data loss
-- [ ] All 4 limits properly enforced
-- [ ] Credit balance checked before ALL operations
-- [ ] Automation pre-checks credit balance
-- [ ] Ahrefs queries counted and limited
-- [ ] No duplicate data across pages
-- [ ] User-friendly terminology throughout
-
-### 13.2 User Experience Success
-
-- [ ] Users understand the simple 4-limit model
-- [ ] Clear separation: Plans & Billing = financial, Usage = consumption
-- [ ] Multi-dimensional insights provide actionable data
-- [ ] Keyword research flow is intuitive
-- [ ] Credit exhaustion messages are clear and actionable
-- [ ] Upgrade prompts appear at right moments
-
-### 13.3 Business Success
-
-- [ ] Reduced support questions about limits
-- [ ] Clearer upgrade paths
-- [ ] Better credit consumption visibility drives upgrades
-- [ ] Ahrefs integration ready for launch
-- [ ] System scales without complexity
-
----
-
-## 14. Risks & Mitigation
-
-### Risk 1: Data Loss During Migration
-**Mitigation:** 
-- Backup database before migration
-- Test migration on staging with production data clone
-- Keep removed fields as comments in code for 1 month
-
-### Risk 2: Users Confused by Changes
-**Mitigation:**
-- In-app changelog notification
-- Update help documentation
-- Add tooltips to new UI elements
-- Gradual rollout (staging → 10% → 50% → 100%)
-
-### Risk 3: Breaking Changes
-**Mitigation:**
-- Maintain backward compatibility in API for 2 weeks
-- Version API endpoints if needed
-- Monitor error logs closely after deployment
-
----
-
-## 15. Post-Launch Monitoring
-
-### Metrics to Track
-
-**Technical:**
-- API error rates (especially 402 Insufficient Credits)
-- Failed automation runs due to credits
-- Keyword limit violations
-- Ahrefs query usage patterns
-
-**Business:**
-- Upgrade conversion rate
-- Support tickets about limits/credits
-- Credit package purchase rate
-- User engagement with new Usage insights
-
-**User Behavior:**
-- Time spent on Usage page
-- Click-through on upgrade prompts
-- Ahrefs query usage distribution
-- Most-used insights widgets
-
----
-
-## 16. Documentation Updates Required
-
-- [ ] Update `docs/10-MODULES/BILLING.md`
-- [ ] Update `docs/40-WORKFLOWS/CREDIT-SYSTEM.md`
-- [ ] Create `docs/10-MODULES/KEYWORD-RESEARCH.md`
-- [ ] Update API documentation
-- [ ] Update user help docs
-- [ ] Update admin guides
-
----
-
-## 17. Summary
-
-### Before (Complex)
-
-### Keywords Limit Testing
-
-- [ ] Try to create single keyword when at limit → Should fail
-- [ ] Try to import 50 SeedKeywords when 30 slots remain → Should fail
-- [ ] Try to bulk import CSV with 1000 keywords when at limit → Should fail
-- [ ] Error message shows current count, limit, and upgrade link
-- [ ] Upgrade plan → New limit applies immediately
-- [ ] Delete keywords → Can add more up to new total
-
-### Ahrefs Limit Testing (Future)
-
-- [ ] Query Ahrefs when at monthly limit → Should fail
-- [ ] Error message shows queries used, limit, and reset date
-- [ ] Monthly reset correctly resets counter
-- [ ] Upgrade plan → New monthly allowance applies
-
-### Page Reorganization Testing
-
-- [ ] Plans & Billing → Current Plan shows only plan info and brief summary
-- [ ] Plans & Billing → Current Plan does NOT show detailed usage breakdown
-- [ ] Usage → Limits & Usage shows all limits with progress bars
-- [ ] Usage → Credit History shows transaction log
-- [ ] No duplicate data between the two sections
-
----
-
-### Before (Complex & Confusing)
-- 10+ limit fields (max_content_ideas, max_content_words, max_images_basic, max_images_premium, etc.)
-- Duplicate data across Plans & Billing and Usage pages
-- Inconsistent enforcement
-- Technical terminology ("API Activity")
-- Double limiting (credits + monthly limits)
-- User confusion: "I have credits but can't generate content?"
-
-### After (Simple & Clear)
-- **4 limits only:** Sites, Users, Keywords, Ahrefs Queries
-- **Everything else = Credits:** Let users consume how they want
-- Clear page separation: Plans & Billing (financial) vs Usage (consumption)
-- Multi-dimensional insights for optimization
-- User-friendly language throughout
-- Proper enforcement everywhere
-- Simple upgrade paths
-
-### What Changes
-
-| Area | Before | After |
-|------|--------|-------|
-| **Limits** | 10+ different limits | 4 limits only |
-| **Plan Model** | 12 limit fields | 4 limit fields |
-| **Account Model** | 5 usage tracking fields | 1 usage tracking field |
-| **Pages** | Duplicate data everywhere | Clean separation |
-| **Terminology** | "API", "operations" | "Actions", "activities" |
-| **Enforcement** | Inconsistent | Consistent everywhere |
-| **Insights** | Basic usage log | Multi-dimensional analysis |
-| **Keyword Research** | One way (SeedKeywords) | Two ways (Browse + Ahrefs) |
-
----
-
-## 18. Next Steps for Development Team
-
-### Backend Developer Tasks
-
-1. **Week 1:**
-   - Review this implementation plan
-   - Create database migration script
-   - Test migration on local/staging with production data clone
-   - Update models (Plan, Account)
-   - Update LimitService
-   - Update serializers
-   - Verify all tests pass
-
-2. **Week 2:**
-   - Add keyword limit enforcement to all entry points
-   - Update automation service with credit pre-check
-   - Search codebase for monthly limit checks and remove
-   - Add Ahrefs service skeleton
-   - Create credit insights API endpoint
-   - Write tests for new validations
-
-3. **Week 3:**
-   - Code review
-   - Deploy to staging
-   - Integration testing
-   - Performance testing
-
-### Frontend Developer Tasks
-
-1. **Week 1:**
-   - Review this implementation plan
-   - Update Plans & Billing page (remove duplicates)
-   - Update Usage page structure
-   - Remove unused limit displays
-   - Update terminology throughout
-
-2. **Week 2:**
-   - Build Credit Insights tab with widgets
-   - Build Keyword Research page
-   - Add Ahrefs research panel
-   - Update TypeScript interfaces
-   - Add credit pre-check hooks
-
-3. **Week 3:**
-   - Testing & bug fixes
-   - Deploy to staging
-   - User acceptance testing
-
-### QA Tasks
-
-- Execute full testing checklist (see Section 10)
-- Regression testing on existing features
-- Performance testing (page load times, API response times)
-- Edge case testing (limits, credits, errors)
-- Cross-browser testing
-- Mobile responsiveness testing
-
-### DevOps Tasks
-
-- Database backup strategy
-- Migration rollback plan
-- Staging deployment
-- Production deployment plan
-- Monitoring setup
-- Alerting configuration
-
----
-
-## 19. Key Implementation Principles
-
-### Principle 1: Simplicity First
-**Remove complexity wherever possible. If a limit isn't absolutely necessary, remove it.**
-
-### Principle 2: Credit-Based Philosophy
-**Credits are the primary control mechanism. Hard limits only for true boundaries (sites, users, keywords, Ahrefs).**
-
-### Principle 3: Clear Separation
-**Plans & Billing = "What am I paying for?" Usage = "What am I using?"**
-
-### Principle 4: User-Friendly Language
-**No technical jargon. Write for business users, not developers.**
-
-### Principle 5: Proper Enforcement
-**Every limit must be checked at every entry point. No exceptions.**
-
-### Principle 6: Actionable Insights
-**Don't just show numbers. Show breakdowns that help users optimize their usage.**
-
-### Principle 7: Clear Upgrade Paths
-**When users hit limits, show clear value proposition for upgrading.**
-
----
-
-## 20. Conclusion
-
-This implementation plan transforms the IGNY8 credits and limits system from complex and confusing to simple and powerful.
-
-**Core Changes:**
-- **4 limits only** (sites, users, keywords, Ahrefs queries)
-- **Remove 10+ unused limit fields** from database
-- **Eliminate data duplication** across pages
-- **Add multi-dimensional insights** for better optimization
-- **Implement Ahrefs research** with monthly query limits
-- **Enforce all limits properly** at every entry point
-- **Validate credit balance** before all operations
-- **Use user-friendly terminology** throughout
-
-**Expected Outcomes:**
-- Reduced user confusion
-- Fewer support tickets
-- Higher upgrade conversion
-- Better credit management
-- Clearer value proposition
-- Scalable system architecture
-
-**Timeline:** 5 weeks from start to production deployment
-
-**Status:** ✅ **READY FOR IMPLEMENTATION**
-
----
-
-**Document prepared by:** GitHub Copilot (Claude Sonnet 4.5)  
-**Date:** January 5, 2026  
-**Next Review:** After Week 1 completion  
-**Approval Required:** Backend Lead, Frontend Lead, Product Manager
-
----
-
-**End of Implementation Plan**
-
-*For questions or clarification during implementation:*
-- See `docs/10-MODULES/BILLING.md` for current system
-- See `docs/40-WORKFLOWS/CREDIT-SYSTEM.md` for credit workflows
-- Review `backend/igny8_core/business/billing/services/` for service architecture
-- Check this document's commit history for rationale behind decisions
diff --git a/docs/plans/implemented/FINAL-CREDITS-LIMITS-PLAN.md b/docs/plans/implemented/FINAL-CREDITS-LIMITS-PLAN.md
deleted file mode 100644
index 662dfaad..00000000
--- a/docs/plans/implemented/FINAL-CREDITS-LIMITS-PLAN.md
+++ /dev/null
@@ -1,653 +0,0 @@
-# Final Credits & Limits Implementation Plan
-
-**Created:** January 5, 2026  
-**Status:** ✅ COMPLETE (Pending UAT & Production Deployment)  
-**Last Updated:** January 5, 2026
-**Verified Against:** Backend codebase, Frontend codebase, Current implementation
-
----
-
-## Executive Summary
-
-After comprehensive codebase review, this document presents the verified and refined implementation plan for simplifying the credits and limits system.
-
-### Key Finding: Credit Flow is CORRECT ✅
-
-The current credit architecture is **sound and logical**:
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    CREDIT FLOW (VERIFIED)                        │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Plan.included_credits = Monthly allocation (e.g., 10,000)      │
-│         ↓ (Added on subscription renewal/approval)               │
-│  Account.credits = Current balance (real-time, decremented)     │
-│         ↓ (Decremented on each AI operation)                    │
-│  CreditTransaction = Log of all credit changes                  │
-│  CreditUsageLog = Detailed operation tracking                   │
-│                                                                  │
-│  THESE ARE NOT PARALLEL - They serve different purposes:        │
-│  • Plan.included_credits = "How many credits per month"         │
-│  • Account.credits = "How many credits you have RIGHT NOW"      │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-**Where credits are added to Account.credits:**
-1. `billing/views.py:445-465` - When manual payment is approved
-2. `payment_service.py:219-249` - When credit package purchased
-3. `credit_service.py:413-445` - Generic `add_credits()` method
-
----
-
-## Part 1: What To KEEP (Verified Working)
-
-### 1.1 Credit System (NO CHANGES NEEDED)
-
-| Component | Location | Status |
-|-----------|----------|--------|
-| `Account.credits` | `auth/models.py:83` | ✅ Keep - Real-time balance |
-| `Plan.included_credits` | `auth/models.py:253` | ✅ Keep - Monthly allocation |
-| `CreditService` | `billing/services/credit_service.py` | ✅ Keep - All methods working |
-| `CreditTransaction` | `billing/models.py:26-48` | ✅ Keep - Audit trail |
-| `CreditUsageLog` | `billing/models.py:90-130` | ✅ Keep - Operation tracking |
-
-### 1.2 Hard Limits to KEEP (4 only)
-
-| Limit | Plan Field | Current Location | Status |
-|-------|------------|------------------|--------|
-| Sites | `max_sites` | `auth/models.py:207` | ✅ Keep |
-| Users | `max_users` | `auth/models.py:204` | ✅ Keep |
-| Keywords | `max_keywords` | `auth/models.py:214` | ✅ Keep |
-| **Ahrefs Queries** | `max_ahrefs_queries` | **NEW** | ➕ Add |
-
----
-
-## Part 2: What To REMOVE (Verified Unused)
-
-### 2.1 Remove From Plan Model
-
-These fields create confusing "double limiting" - credits already control consumption:
-
-```python
-# auth/models.py - REMOVE these fields (lines 220-251)
-max_clusters = ...           # Remove - no real use
-max_content_ideas = ...      # Remove - credits handle this  
-max_content_words = ...      # Remove - credits handle this
-max_images_basic = ...       # Remove - credits handle this
-max_images_premium = ...     # Remove - credits handle this
-max_image_prompts = ...      # Remove - credits handle this
-```
-
-**Why remove?** User confusion: "I have credits but can't generate because I hit my word limit?"
-
-### 2.2 Remove From Account Model
-
-```python
-# auth/models.py - REMOVE these fields (lines 108-114)
-usage_content_ideas = ...    # Remove - tracked in CreditUsageLog
-usage_content_words = ...    # Remove - tracked in CreditUsageLog
-usage_images_basic = ...     # Remove - tracked in CreditUsageLog
-usage_images_premium = ...   # Remove - tracked in CreditUsageLog
-usage_image_prompts = ...    # Remove - tracked in CreditUsageLog
-```
-
-### 2.3 Update LimitService
-
-```python
-# limit_service.py - Update HARD_LIMIT_MAPPINGS
-HARD_LIMIT_MAPPINGS = {
-    'sites': {...},      # Keep
-    'users': {...},      # Keep  
-    'keywords': {...},   # Keep
-    # 'clusters': {...}, # REMOVE
-}
-
-# limit_service.py - Update MONTHLY_LIMIT_MAPPINGS
-MONTHLY_LIMIT_MAPPINGS = {
-    'ahrefs_queries': {  # NEW - only monthly limit
-        'plan_field': 'max_ahrefs_queries',
-        'usage_field': 'usage_ahrefs_queries',
-        'display_name': 'Keyword Research Queries',
-    },
-    # REMOVE all others (content_ideas, content_words, images_*, image_prompts)
-}
-```
-
----
-
-## Part 3: Database Migration
-
-### Migration Script
-
-```python
-# migrations/0XXX_simplify_credits_limits.py
-
-from django.db import migrations, models
-
-class Migration(migrations.Migration):
-    dependencies = [
-        ('igny8_core_auth', '0XXX_previous'),  # Update with actual
-    ]
-    
-    operations = [
-        # STEP 1: Add new Ahrefs fields
-        migrations.AddField(
-            model_name='plan',
-            name='max_ahrefs_queries',
-            field=models.IntegerField(
-                default=0,
-                help_text='Monthly Ahrefs keyword research queries (0 = disabled)'
-            ),
-        ),
-        migrations.AddField(
-            model_name='account',
-            name='usage_ahrefs_queries',
-            field=models.IntegerField(
-                default=0,
-                help_text='Ahrefs queries used this month'
-            ),
-        ),
-        
-        # STEP 2: Remove unused Plan fields
-        migrations.RemoveField(model_name='plan', name='max_clusters'),
-        migrations.RemoveField(model_name='plan', name='max_content_ideas'),
-        migrations.RemoveField(model_name='plan', name='max_content_words'),
-        migrations.RemoveField(model_name='plan', name='max_images_basic'),
-        migrations.RemoveField(model_name='plan', name='max_images_premium'),
-        migrations.RemoveField(model_name='plan', name='max_image_prompts'),
-        
-        # STEP 3: Remove unused Account fields
-        migrations.RemoveField(model_name='account', name='usage_content_ideas'),
-        migrations.RemoveField(model_name='account', name='usage_content_words'),
-        migrations.RemoveField(model_name='account', name='usage_images_basic'),
-        migrations.RemoveField(model_name='account', name='usage_images_premium'),
-        migrations.RemoveField(model_name='account', name='usage_image_prompts'),
-    ]
-```
-
----
-
-## Part 4: Frontend Changes
-
-### 4.1 Plans & Billing Page (Financial Focus)
-
-**File:** `frontend/src/pages/account/PlansAndBillingPage.tsx`
-
-**Current (881 lines):** Shows credit usage charts, limit bars = DUPLICATE of Usage page
-
-**Target:** Pure financial focus
-- Tab 1: Current Plan → Name, price, renewal date, "View Usage" link
-- Tab 2: Upgrade Plan → Pricing table (already good)
-- Tab 3: Billing History → Invoices, payment methods
-
-**Remove from Current Plan tab:**
-- Usage charts (move to Usage page)
-- Credit consumption breakdown (move to Usage page)
-- Limit progress bars (move to Usage page)
-
-### 4.2 Usage Analytics Page (Consumption Tracking)
-
-**File:** `frontend/src/pages/account/UsageAnalyticsPage.tsx`
-
-**Current (266 lines):** Basic tabs with some usage data
-
-**Target:** Comprehensive usage tracking
-
-```
-Tab 1: Overview (NEW)
-├── Quick Stats Cards: Credits Balance, Sites, Users, Keywords
-├── Period Selector: 7 days | 30 days | 90 days
-└── Key Metrics for Selected Period
-
-Tab 2: Your Limits (SIMPLIFIED)
-└── Progress Bars for ONLY 4 limits:
-    ├── Sites: 2 / 5
-    ├── Users: 2 / 3  
-    ├── Keywords: 847 / 1,000
-    └── Keyword Research Queries: 23 / 50 this month
-
-Tab 3: Credit Insights (NEW)
-├── Credits by Site (pie chart)
-├── Credits by Action Type (bar chart)
-├── Credits by Image Quality (basic vs premium)
-├── Credits by Automation (manual vs automated)
-└── Timeline Chart (line graph over time)
-
-Tab 4: Activity Log (renamed from "API Activity")
-└── Detailed transaction history (existing functionality)
-```
-
-### 4.3 CreditBalance Interface Update
-
-**File:** `frontend/src/services/billing.api.ts`
-
-```typescript
-// Current (correct - no changes needed)
-export interface CreditBalance {
-  credits: number;              // Account.credits (current balance)
-  plan_credits_per_month: number;  // Plan.included_credits
-  credits_used_this_month: number; // Sum of CreditUsageLog this month
-  credits_remaining: number;    // = credits (same as current balance)
-}
-```
-
-### 4.4 UsageSummary Interface Update
-
-**File:** `frontend/src/services/billing.api.ts` (add new interface)
-
-```typescript
-export interface UsageSummary {
-  // Hard limits (4 only)
-  hard_limits: {
-    sites: { current: number; limit: number; display_name: string };
-    users: { current: number; limit: number; display_name: string };
-    keywords: { current: number; limit: number; display_name: string };
-    ahrefs_queries: { current: number; limit: number; display_name: string };
-  };
-  
-  // Credits
-  credits: {
-    balance: number;
-    plan_allocation: number;
-    used_this_month: number;
-  };
-  
-  // Period info
-  period: {
-    start: string;
-    end: string;
-    days_remaining: number;
-  };
-}
-```
-
----
-
-## Part 5: Keyword Research Feature
-
-### 5.1 Two-Option Structure
-
-```
-┌───────────────────────────────────────────────────────────────────┐
-│                   KEYWORD RESEARCH PAGE                           │
-├───────────────────────────────────────────────────────────────────┤
-│                                                                   │
-│  [Browse IGNY8 Database] [Research with Ahrefs - 42/50 left]    │
-│                                                                   │
-├───────────────────────────────────────────────────────────────────┤
-│  Option 1: Browse Pre-Researched Keywords (FREE)                 │
-│  • Global IGNY8 keyword database                                 │
-│  • Pre-analyzed metrics from our research                        │
-│  • Free to browse and add                                        │
-│  • Counts toward max_keywords when added                         │
-│                                                                   │
-├───────────────────────────────────────────────────────────────────┤
-│  Option 2: Research with Ahrefs (LIMITED)                        │
-│  • Live Ahrefs API queries                                       │
-│  • Fresh, custom keyword data                                    │
-│  • Monthly limit: 42 / 50 queries remaining                      │
-│  • ⚠️ Each search uses 1 query from monthly limit               │
-│                                                                   │
-└───────────────────────────────────────────────────────────────────┘
-```
-
-### 5.2 Plan Tiers for Ahrefs ✅ CONFIGURED
-
-| Plan | max_ahrefs_queries | Description |
-|------|-------------------|-------------|
-| Free | 0 | Browse only (no live Ahrefs) |
-| Starter | 50 | 50 queries/month |
-| Growth | 200 | 200 queries/month |
-| Scale | 500 | 500 queries/month |
-
----
-
-## Part 6: Enforcement Points ✅ COMPLETED
-
-### 6.1 Backend Validation Checklist ✅
-
-| Check Point | Location | Status |
-|-------------|----------|--------|
-| **Keywords** | | |
-| Manual creation | `planner/views.py:perform_create` | ✅ Implemented |
-| Bulk import | `planner/views.py:import_keywords` | ✅ Implemented |
-| **Sites** | | |
-| Site creation | `defaults_service.py` | ✅ Implemented |
-| **Users** | | |
-| User invite | `account_views.py:team_invite` | ✅ Implemented |
-| **Credits** | | |
-| All AI ops | `ai/engine.py` | ✅ Pre-flight checks exist |
-
-### 6.2 Frontend Pre-Check ✅ IMPLEMENTED
-
-Components created:
-- `frontend/src/components/billing/InsufficientCreditsModal.tsx` - Modal with upgrade/buy options
-- `frontend/src/utils/creditCheck.ts` - Pre-flight credit check utility
-
-```typescript
-// Usage example
-import { checkCreditsBeforeOperation } from '@/utils/creditCheck';
-import { useInsufficientCreditsModal } from '@/components/billing/InsufficientCreditsModal';
-
-const { showModal } = useInsufficientCreditsModal();
-const check = await checkCreditsBeforeOperation(estimatedCost);
-
-if (!check.hasEnoughCredits) {
-  showModal({
-    requiredCredits: check.requiredCredits,
-    availableCredits: check.availableCredits,
-  });
-  return;
-}
-```
-
----
-
-## Part 7: Implementation Timeline
-
-### Week 1: Backend Foundation ✅ COMPLETED
-- [x] Create database migration (add Ahrefs fields, remove unused)
-- [x] Update Plan model (remove 6 fields, add 1)
-- [x] Update Account model (remove 5 fields, add 1)
-- [x] Update LimitService (simplify mappings)
-- [x] Run migration on dev/staging
-- [x] Update PlanSerializer (fix removed field references)
-- [x] Update management commands (create_aws_admin_tenant, get_account_limits)
-
-### Week 2: Backend Enforcement ✅ COMPLETED
-- [x] Add keyword limit checks at all entry points (perform_create, import_keywords)
-- [ ] Create Ahrefs query endpoint with limit check (deferred - Ahrefs not yet integrated)
-- [x] Update usage summary endpoint
-- [x] Add site limit check (defaults_service.py)
-- [x] Add user limit check (account_views.py - team invite)
-- [x] Update API serializers
-- [x] AI pre-flight credit checks (already in ai/engine.py)
-
-### Week 3: Frontend - Plans & Billing ✅ COMPLETED
-- [x] Update billing.api.ts interfaces (Plan, UsageSummary)
-- [x] Update UsageLimitsPanel.tsx (4 limits only)
-- [x] Update PlansAndBillingPage.tsx
-- [x] Update pricing-table component
-- [x] Update pricingHelpers.ts
-- [x] Update Plans.tsx, SignUp.tsx, SignUpFormUnified.tsx
-
-### Week 4: Frontend - Usage Analytics ✅ COMPLETED
-- [x] UsageAnalyticsPage uses UsageLimitsPanel (already updated)
-- [x] Your Limits tab shows 4 limits only
-- [x] Create Credit Insights tab with charts
-- [x] Overview quick stats visible on all tabs
-
-### Week 5: Testing & Documentation ✅ COMPLETED
-- [ ] Run full test suite (pending - manual testing done)
-- [x] Update API documentation (docs/10-MODULES/BILLING.md)
-- [x] Update user documentation (docs/40-WORKFLOWS/CREDIT-SYSTEM.md)
-- [ ] UAT testing (pending)
-- [ ] Production deployment (pending)
-
----
-
-## Part 8: Verification Checklist
-
-### 8.1 Docker Verification Commands
-
-```bash
-# Enter Django shell
-docker exec -it igny8_backend python manage.py shell
-
-# Verify Plan model changes
-from igny8_core.auth.models import Plan
-plan = Plan.objects.first()
-print(f"max_sites: {plan.max_sites}")
-print(f"max_users: {plan.max_users}")
-print(f"max_keywords: {plan.max_keywords}")
-print(f"max_ahrefs_queries: {plan.max_ahrefs_queries}")
-# These should ERROR after migration:
-# print(f"max_clusters: {plan.max_clusters}")  # Should fail
-
-# Verify Account model changes
-from igny8_core.auth.models import Account
-account = Account.objects.first()
-print(f"credits: {account.credits}")
-print(f"usage_ahrefs_queries: {account.usage_ahrefs_queries}")
-# These should ERROR after migration:
-# print(f"usage_content_ideas: {account.usage_content_ideas}")  # Should fail
-
-# Verify LimitService
-from igny8_core.business.billing.services.limit_service import LimitService
-print(f"Hard limits: {list(LimitService.HARD_LIMIT_MAPPINGS.keys())}")
-# Should be: ['sites', 'users', 'keywords']
-print(f"Monthly limits: {list(LimitService.MONTHLY_LIMIT_MAPPINGS.keys())}")
-# Should be: ['ahrefs_queries']
-
-# Verify Credit Flow
-from igny8_core.business.billing.services.credit_service import CreditService
-print("Credit calculation for content:")
-credits = CreditService.calculate_credits_from_tokens('content_generation', 1000, 500)
-print(f"  1000 input + 500 output tokens = {credits} credits")
-```
-
-### 8.2 Django Admin Verification
-
-**Check in browser at `/admin/`:**
-
-1. **Accounts → Account**
-   - [ ] `credits` field visible
-   - [ ] `usage_ahrefs_queries` field visible
-   - [ ] `usage_content_ideas` NOT visible (removed)
-
-2. **Accounts → Plan**
-   - [ ] `max_sites`, `max_users`, `max_keywords` visible
-   - [ ] `max_ahrefs_queries` visible
-   - [ ] `max_content_ideas`, `max_content_words` NOT visible (removed)
-   - [ ] `included_credits` visible
-
-3. **Billing → Credit Transaction**
-   - [ ] Shows all credit additions/deductions
-   - [ ] `balance_after` shows running total
-
-4. **Billing → Credit Usage Log**
-   - [ ] Shows all AI operations
-   - [ ] `operation_type`, `credits_used`, `tokens_input`, `tokens_output` visible
-
-### 8.3 Frontend Verification
-
-**Plans & Billing Page (`/account/billing`):**
-- [ ] Current Plan tab shows: Plan name, price, renewal date
-- [ ] Current Plan tab does NOT show usage charts
-- [ ] "View Usage Details" link works
-- [ ] Upgrade tab shows pricing table
-- [ ] Billing History shows invoices
-
-**Usage Analytics Page (`/account/usage`):**
-- [ ] Overview tab shows quick stats
-- [ ] Your Limits tab shows ONLY 4 limits
-- [ ] Credit Insights tab shows breakdown charts
-- [ ] Activity Log tab shows transaction history
-
-**Header Credit Display:**
-- [ ] Shows current credit balance
-- [ ] Updates after AI operations
-
----
-
-## Part 9: Error Messages (User-Friendly)
-
-### Before (Technical)
-```
-HTTP 402 - HardLimitExceededError: max_keywords limit reached
-```
-
-### After (User-Friendly)
-```
-┌─────────────────────────────────────────────────────────┐
-│  ⚠️ Keyword Limit Reached                               │
-├─────────────────────────────────────────────────────────┤
-│                                                          │
-│  You've reached your keyword limit.                      │
-│                                                          │
-│  Current: 1,000 keywords                                 │
-│  Your plan allows: 1,000 keywords                        │
-│                                                          │
-│  To add more keywords:                                   │
-│  • Delete unused keywords                                │
-│  • Upgrade your plan                                     │
-│                                                          │
-│  [Manage Keywords]  [Upgrade Plan]  [Cancel]            │
-│                                                          │
-└─────────────────────────────────────────────────────────┘
-```
-
----
-
-## Part 10: Risk Mitigation
-
-| Risk | Mitigation |
-|------|------------|
-| Migration breaks production | Test on staging with prod data clone first |
-| Users lose tracked usage | Keep CreditUsageLog (detailed tracking continues) |
-| Ahrefs costs spike | Monthly limit enforced server-side |
-| Credit confusion | Clear documentation + help tooltips |
-| Rollback needed | Keep migration reversible (add back fields) |
-
----
-
-## Appendix A: Files to Modify
-
-### Backend Files
-| File | Changes |
-|------|---------|
-| `backend/igny8_core/auth/models.py` | Remove 11 fields, add 2 fields |
-| `backend/igny8_core/business/billing/services/limit_service.py` | Simplify mappings |
-| `backend/igny8_core/business/billing/serializers.py` | Update serializers |
-| `backend/igny8_core/modules/billing/views.py` | Update usage summary |
-| `backend/igny8_core/admin/` | Update admin panels |
-| `backend/migrations/` | New migration file |
-
-### Frontend Files
-| File | Changes |
-|------|---------|
-| `frontend/src/pages/account/PlansAndBillingPage.tsx` | Simplify (remove usage) |
-| `frontend/src/pages/account/UsageAnalyticsPage.tsx` | Add new tabs |
-| `frontend/src/services/billing.api.ts` | Update interfaces |
-| `frontend/src/components/billing/UsageLimitsPanel.tsx` | Show 4 limits only |
-
-### Documentation Files
-| File | Changes |
-|------|---------|
-| `docs/10-MODULES/BILLING.md` | Update limits documentation |
-| `docs/40-WORKFLOWS/CREDIT-SYSTEM.md` | Update credit flow docs |
-
----
-
-## Conclusion
-
-The credit system architecture is **fundamentally correct**:
-- `Plan.included_credits` defines monthly allocation
-- `Account.credits` tracks real-time balance
-- Credits are added on subscription renewal/payment approval
-- Credits are deducted on each AI operation
-
-**What's broken:** 
-- Too many unused limits causing user confusion
-- Duplicate data displayed across pages
-- Monthly limits (content_words, images, etc.) that duplicate what credits already control
-
-**The fix:**
-- Simplify to 4 hard limits + credits
-- Clear page separation (financial vs consumption)
-- Better UX with multi-dimensional credit insights
-
----
-
-**Document Version:** 1.0  
-**Last Updated:** January 5, 2026  
-**Verified By:** Codebase review of backend and frontend
-
-
-##############################################
-
-
-
-## Organized Implementation Changes Plan
-
-### 1. **Credit Consumption Widget (Rename & Enhance)**
-
-**Current:** "Where Credits Go" with just a pie chart  
-**New:** "Credit Consumption" with pie chart + detailed table
-
-| Operation | Credits Used | Items Created |
-|-----------|-------------|---------------|
-| Clustering | 150 | 12 clusters |
-| Ideas | 200 | 45 ideas |
-| Content | 1,200 | 24 articles |
-| Image Prompts | 50 | 30 prompts |
-| Images (Basic) | 100 | 100 images |
-| Images (Quality) | 250 | 50 images |
-| Images (Premium) | 450 | 30 images |
-
-- Pie chart shows credits consumed per operation
-- Table shows both **credits** AND **output count**
-- Learn from Planner/Writer footer workflow completion widgets
-
----
-
-### 2. **New Usage Logs Page** (`/account/usage/logs`)
-
-**Purpose:** Detailed, filterable, paginated log of all AI operations
-
-**Layout:** Same as Planner/Writer table pages (consistent template)
-
-**Table Columns:**
-| Date | Operation | Details | Credits | Cost (USD) |
-|------|-----------|---------|-------|--------|---------|------------|
-| Jan 5, 2:30pm | Content Writing | "SEO Guide for..." | 35 | $0.042 |
-| Jan 5, 2:15pm | Image Generation | Premium quality | 15 | $0.18 |
-
-**Features:**
-- Filters: Operation type, date range, site
-- Pagination
-- USD cost calculated from token pricing (from AIModelConfig)
-- Link to related content where applicable
-- Export option
-
----
-
-### 3. **Usage Dashboard - Multi-Dimensional Widgets**
-
-**Remove:**
-- ❌ "Operations" summary card (single metrics, not useful)
-- ❌ "Recent Activity" card (move to Usage Logs page)
-
-**Add/Enhance:**
-- ✅ **Credit Consumption** (pie + table as described above)
-- ✅ **Usage Trend** - Line chart showing daily/weekly credit usage
-- ✅ **Credits by Site** - If multiple sites, show distribution
-- ✅ **Image Quality Breakdown** - Basic vs Quality vs Premium usage
-- ✅ **Top Operations** - Which operations consume most credits
-- ✅ **Quick link** to Usage Logs page for detailed view
-
----
-
-### 4. **Data Sources Needed**
-
-From backend, I'll need to check:
-- `CreditUsageLog` - Has operation_type, credits_used, model_used, tokens_in, tokens_out
-- `AIModelConfig` - Has cost_per_1k_input, cost_per_1k_output for USD calculation
-- Aggregations for: clusters created, ideas generated, articles written, images by tier
-
----
-
-### Summary of Deliverables
-
-| Item | Type | Description |
-|------|------|-------------|
-| 1 | Widget Enhancement | "Credit Consumption" - pie chart + table with credits & output counts |
-| 2 | New Page | `/account/usage/logs` - Filterable, paginated AI operation logs with USD costs |
-| 3 | Dashboard Update | Remove weak widgets, add multi-dimensional data-rich charts |
-| 4 | Sidebar | Add "Usage Logs" as sub-item under Usage Dashboard |
-
----
-
-**Does this organization look correct?** Should I proceed with implementation, or would you like to adjust any part of this plan?
\ No newline at end of file
diff --git a/docs/plans/implemented/FINAL-PRELAUNCH-Completed.md b/docs/plans/implemented/FINAL-PRELAUNCH-Completed.md
deleted file mode 100644
index 0ea8707a..00000000
--- a/docs/plans/implemented/FINAL-PRELAUNCH-Completed.md
+++ /dev/null
@@ -1,740 +0,0 @@
-# IGNY8 Launch Tasks - Complete Implementation Guide
-
----
-# PHASE 0 ✅ Completed
-
-## 1. Design System Consolidation 
-
-✅ Update the rules files, a follow the rules in all changes for styles, for components, for coding rules, to use consistent design
-
----
-
-## 2. Visual Verifications
-
-2.1 ✅ - All logos and images to update for dark and light color scheme layout, and logo design final as well as favicon, and move images to right folder
-2.2 ✅ - Sidebar menu rearrange for items that need rearranging, and reduce padding/spacing
-2.3 ✅ - Fix the sidebar active/selected menu and hover color
-2.4 ✅ - Assign manually the colors to each module, and verify and fix that in each page and progress bar consistent colors are used, across module pages, automation and dashboard
-2.5 ✅ - Use colors in setup, sites and account and all its subpages
-
----
-
-## 3. AI Provider Configuration
-
-3.1 ✅ - Add Bria image generation and verify that DALL-E and Bria image generation are working
-3.2 ✅ - Add and verify Claude API and models
-3.3 ✅ - Update the 2 image sizes to be landscape and 2 square, and update the template to use full width image on full section, and half width content section
-
----
-# PRE-LAUNCH PHASE 1: Code Cleanup & Technical Debt ✅
-
-> **Goal:** Clean, maintainable codebase before production lock  
-> **Status:** Completed January 9, 2026  
-> **Commits:** 4 commits, -3,218 lines removed, 24 files changed
-
-## 1.1 - Legacy Code Cleanup ✅
-
-### 1.1.1 - Identify Legacy Items ✅
-**Action:** Audit and document all unused code
-
-- [x] Unused pages in `frontend/src/pages/` - Removed 11 empty folders
-- [x] Unused routes in `App.tsx` - Cleaned up
-- [x] Unused components in `frontend/src/components/` - Removed empty folders
-- [x] Unused API endpoints in backend - N/A (all in use)
-- [x] Deprecated documentation references - Updated
-
-### 1.1.2 - Remove Legacy Code ✅
-- [x] Remove identified unused pages - Removed test files, empty folders
-- [x] Remove orphaned routes - Cleaned up
-- [x] Remove unused components - Removed 11 empty folders
-- [x] Remove deprecated API endpoints - N/A
-- [x] Update documentation to reflect removals - Updated
-
-### 1.1.3 - Code Quality Verification ✅
-- [x] Run ESLint with design system rules - Passed
-- [x] Fix any design system violations - None found
-- [x] Verify TypeScript strict mode compliance - Passed
-- [x] Check for console.log/debug statements - Removed 17 instances
-
----
-
-# PRE-LAUNCH PHASE 4: Email & Notifications QA ✅
-
-> **Goal:** Reliable email delivery and notification system  
-> **Status:** Completed January 9, 2026
-
-## 4.1 - Email Deliverability Testing ✅
-
-### 4.1.1 - Spam Score Testing
-- [x] Test Resend emails with mail-tester.com
-- [x] Document spam score results
-- [x] Address any deliverability issues
-
-### 4.1.2 - Email Trigger Verification
-
-| Trigger | Email Type | Service | Tested |
-|---------|------------|---------|--------|
-| User Registration | Welcome email | Resend | ✅ |
-| Email Verification | Verification link | Resend | ✅ |
-| Password Reset | Reset link | Resend | ✅ |
-| Password Changed | Confirmation | Resend | ✅ |
-| Plan Upgrade | Confirmation | Resend | ✅ |
-| Payment Success | Receipt | Resend | ✅ |
-| Payment Failed | Alert | Resend | ✅ |
-| Automation Complete | Notification | Resend | ✅ |
-| Content Ready | Notification | Resend | ✅ |
-
-### 4.1.3 - Acceptable Deliverability Standards
-- Target: 95%+ inbox placement ✅
-- Bounce rate: <5% ✅
-- Spam complaint rate: <0.1% ✅
-
-## 4.2 - In-App Notifications ✅
-- [x] Verify notification bell updates in real-time
-- [x] Test notification read/unread states
-- [x] Verify notification dropdown functionality
-- [x] Check notifications page `/account/notifications`
-
----
-
-# PRE-LAUNCH PHASE 5: UX Improvements ✅
-
-> **Goal:** Polished user experience for production  
-> **Status:** Completed January 9, 2026  
-> **Focus:** Enhanced search modal with filters, suggestions, and help integration
-
-## 5.1 - Search Modal Enhancement ✅
-
-**Current:** Enhanced with comprehensive features  
-**Completed:** Full search experience with help integration
-
-### Improvements: ✅
-- [x] Add search filters (by type: keyword, content, site, etc.) - Implemented with category badges
-- [x] Add recent searches history - Implemented (stored in localStorage)
-- [x] Improve search results display with context - Added context snippets with highlighting
-- [x] Add keyboard shortcuts (Cmd/Ctrl + K) - Already implemented
-- [x] Quick actions from search results - Implemented with suggested questions
-- [x] **Bonus:** Added help knowledge base with 25+ questions across 8 topics
-- [x] **Bonus:** Added smart phrase matching (strips filler words, handles plurals)
-- [x] **Bonus:** Added comprehensive keyword coverage (task, cluster, billing, invoice, etc.)
-
-## 5.2 - Image Regeneration Feature ⏸️
-
-> **Status:** Deferred to post-launch (Phase 9)  
-> **Reason:** Current image generation is stable; regeneration is enhancement not critical for launch
-
-## 5.3 - User Flow Polish ✅
-
-> **Status:** Verified working - Ready for Phase 7 user testing
-
-### Signup to First Content Flow ✅
-1. [x] User signs up → verify smooth flow - Working
-2. [x] Onboarding wizard → verify all steps work - Functional
-3. [x] Add site → verify WordPress integration - Stable
-4. [x] Add keywords → verify import works - Working
-5. [x] Run clustering → verify AI works - Functional
-6. [ ] Generate content → verify output quality - (Pending Phase 7 testing)
-7. [ ] Publish to WordPress → verify integration - (Pending Phase 7 testing)
-
----
-
-# PRE-LAUNCH PHASE 6: Data Backup & Cleanup ✅
-
-> **Goal:** Fresh database for production launch  
-> **Status:** Completed January 9, 2026  
-> **Deliverables:** Django management commands + comprehensive documentation
-
-## 6.1 - System Configuration Backup ✅
-
-### 6.1.1 - Export System Data
-**Keep these (system configuration):**
-
-| Model Group | Export Format | Location |
-|-------------|---------------|----------|
-| Plans | JSON | `/backups/config/plans.json` |
-| AIModelConfig | JSON | `/backups/config/ai_models.json` |
-| CreditCostConfig | JSON | `/backups/config/credit_costs.json` |
-| GlobalIntegrationSettings | JSON | `/backups/config/integrations.json` |
-| SystemSettings | JSON | `/backups/config/system.json` |
-| Prompts | JSON | `/backups/config/prompts.json` |
-| AuthorProfiles | JSON | `/backups/config/authors.json` |
-| Industries & Sectors | JSON | `/backups/config/industries.json` |
-| SeedKeywords | JSON | `/backups/config/seed_keywords.json` |
-
-### 6.1.2 - Document Configuration Values ✅
-- [x] Export all Plan configurations - Command: `export_system_config`
-- [x] Export all AI model settings - Included in export
-- [x] Export all prompt templates - Included in export
-- [x] Export all system settings - Included in export
-- [x] Store in version control - Ready to commit before V1.0
-
-**Implementation:** `/backend/igny8_core/management/commands/export_system_config.py`  
-**Usage:** `python manage.py export_system_config --output=/backups/v1-config.json`
-
-## 6.2 - User Data Cleanup ✅
-
-### 6.2.1 - Clear User-Generated Data ✅
-**Remove ALL user-specific data:**
-
-- [x] All Sites (except internal test sites) - Command ready
-- [x] All Keywords - Command ready
-- [x] All Clusters - Command ready
-- [x] All Content Ideas - Command ready
-- [x] All Tasks - Command ready
-- [x] All Content - Command ready
-- [x] All Images - Command ready
-- [x] All Automation Runs - Command ready
-- [x] All Publishing Records - Command ready
-- [x] All Sync Events - Command ready
-- [x] All Credit Transactions (except system) - Command ready
-- [x] All Credit Usage Logs - Command ready
-- [x] All Notifications - Command ready
-
-**Implementation:** `/backend/igny8_core/management/commands/cleanup_user_data.py`  
-**Usage:** `python manage.py cleanup_user_data --confirm`  
-**Safety:** Includes dry-run mode, confirmation prompts, atomic transactions
-
-### 6.2.2 - Clear Logs ✅
-- [x] Application logs - Manual cleanup script provided
-- [x] Celery task logs - Manual cleanup script provided
-- [x] Automation logs - Covered by cleanup command
-- [x] Publishing sync logs - Covered by cleanup command
-- [x] Error logs - Manual cleanup documented
-
-### 6.2.3 - Clear Media Storage ✅
-- [x] Remove all generated images - Included in cleanup command
-- [x] Clear CDN cache if applicable - Documented
-- [x] Verify storage is empty - Verification steps included
-
-**Documentation:** `/docs/plans/PHASE-6-BACKUP-CLEANUP-GUIDE.md` (300+ lines)
-
-## 6.3 - V1.0 Configuration Lock ⏳
-
-> **Status:** Ready to execute before V1.0 deployment  
-> **Note:** Commands and documentation prepared, will run during Phase 8 deployment
-
----
-
-# PHASE 1: App UI Quick Fixes
-
-## 1.1 - Credits Display Fix ✅
-
-**Location**: App header component
-
-**Current**: Shows abbreviated format (e.g., "12k")
-
-**Required**: Show full number (e.g., "12,000")
-
----
-
-## 1.2 - Sites Card Redesign ✅
-
-**Location**: Sites listing/grid component
-
-**Changes required**:
-- Reduce padding to half of current value
-- Use smaller badges for all 3 badges
-- Move URL to below the site title (currently beside or above)
-- Show description only when not empty (hide element completely if empty)
-
----
-
-## 1.3 - Page Loading Standardization ✅
-
-**Current problem**: Each page has its own loading spinner/text implementation
-
-**Required solution**:
-- Remove all individual page loading implementations
-- Implement loading state in global app wrapper (same component where sidebar/header resides)
-- Single consistent spinner/text across entire app
-- Same approach as standard page margins/padding (defined once globally)
-
-**Location**: App layout wrapper component (where sidebar/header are defined)
-
----
-
-## 1.4 - Global Layout Spacing ✅
-
-**Required**:
-- Define exact padding in global app layout ONLY:
-  - Below header: 12px
-  - After sidebar: 12px
-  - Top/bottom: 12px
-  - Left/right: 12px
-- Remove ALL inner margins and padding from internal page main wrappers
-- Every page should inherit spacing from global layout, not define its own
-
-**Location**: Global app layout component
-
----
-
-## 1.5 - Button Standardization ✅
-
-**Current problems**:
-1. Icon-on-top bug: Some buttons render icon above text instead of inline
-2. Inconsistent `type` attribute: Some buttons have `type="button"`, some don't
-3. No unified component usage across app
-
-**Required solution**:
-
-Create/enforce global button components for each variant:
-
-| Variant | Component | Usage |
-|---------|-----------|-------|
-| Standard button | `<Button>` | Default actions |
-| Button with icon | `<Button icon={...}>` | Actions with icon left/right of text |
-| Icon-only button | `<IconButton>` | Toolbar actions, compact UI |
-| Button group | `<ButtonGroup>` | Related actions grouped together |
-| Toggle button | `<ToggleButton>` | On/off states |
-
-**Implementation requirements**:
-- All variants should NOT require `type="button"` in the HTML output (handle internally in component)
-- Icon must render INLINE with text (flex row), never on top (flex column)
-- Single source of truth for each button type
-- Audit entire codebase and replace all ad-hoc button implementations
-
-**Audit command**:
-```bash
-grep -rn "<button" src/ --include="*.jsx" --include="*.tsx"
-```
-
----
-
-## 1.6 - Legacy Cleanup ❌
-
-**Action**: Remove all unused pages, routes, and related data from:
-- System codebase
-- Documentation
-
-**Note**: Identify specific legacy items before removal
-
----
-
-# PHASE 2: App Features & Improvements
-
-## 2.1 - Setup Wizard Redesign ✅
-
-**Current problems**:
-- Converted from modal - not a good design
-- Unnecessary header and icon on wizard main page
-- Unclear intro cards
-
-**Required changes**:
-1. Convert to proper page style (like other app pages)
-2. Remove unnecessary header from wizard main page
-3. Create cleaner, better intro cards that clearly explain:
-   - What is being provided through wizard
-   - What each step accomplishes
-   - What user will have after completion
-
----
-
-## 2.2 - Dashboard Widgets (3 new) ✅
-
-**Location**: Home/Dashboard page
-
-### Widget 1: Sites Overview ✅
-- Show sites with small data/status info
-- Include action buttons to directly navigate to:
-  - Site settings
-  - Site actions
-- Compact format showing key site health indicators
-
-### Widget 2: Credits Usage ✅
-- Remaining credits display
-- AI runs count
-- Style: Match existing site dashboard widget style
-- Visual progress indicator for usage
-
-### Widget 3: Account Info ✅
-Display the following account-related information:
-- Credits consumed (this billing period)
-- Credits remaining
-- Reset day (when credits refresh)
-- Last payment date
-- Next payment due date
-- Current plan/package type
-
-**Note**: Evaluate and track what account-related info is most valuable to display
-
----
-
-## 2.3 - WordPress & Content Templates ❌
-
-### 2.3.1 - Post Template Optimization
-- Review and optimize WordPress post template structure
-- Improve SEO elements
-- Ensure clean HTML output
-
-### 2.3.2 - Header Section Cleanup
-**Current**: Shows various tags including non-public/non-SEO-friendly ones
-
-**Required**:
-- Show ONLY publicly visible, SEO-friendly tags
-- Show ONLY tags that are working/functional
-- Remove all other tags from header section
-
----
-
-# PHASE 3: Credits, Pricing & Payments
-
-## 3.1 - Credits Structure ✅
-
-### 3.1.1 - Token Costing ✅
-- Finalize credits token costing
-- Define limits per plan
-- Document per-plan structure
-
-### 3.1.2 - Pricing Display ✅
-- Finalize what to show in pricing plans on frontend
-- Finalize what to show in pricing plans in-app
-- Ensure consistency between both
-
-### 3.1.3 - Subscription Verification ✅
-- Verify correct renewal date logic
-- Verify correct reset of credits date
-- Test edge cases (upgrades, downgrades, mid-cycle changes)
-
----
-
-## 3.2 - Payment Integration ✅
-
-### 3.2.1 - Stripe Integration ✅
-- Full payment flow integration
-- Subscription management
-- Webhook handling
-
-### 3.2.2 - PayPal Integration ✅
-- Full payment flow integration
-- Subscription management
-- Webhook handling
-
----
-
-## 3.3 - Plans & Packages ✅
-
-### 3.3.1 - Upgrade Flow ✅
-- Credits package upgrade flow
-- Plan upgrade flow
-- Proration handling
-
-### 3.3.2 - Service Packages ✅
-Create two package types:
-
-| Package | Type | Includes |
-|---------|------|----------|
-| Setup App | One-time | Initial configuration, onboarding |
-| Campaign Management | Monthly | Keyword selection, ongoing management |
-
----
-
-# PHASE 4: Email Setup ✅
-
-## 4.1 - Email Services ✅
-
-| Use Case | Service | Free Limit | Why |
-|----------|---------|------------|-----|
-| **Transactional** | **Resend** | 3,000/mo | Better deliverability, faster delivery, cleaner API |
-| **Marketing** | **Brevo** | 9,000/mo | Higher volume, built-in templates, unsubscribe management, analytics |
-
-**Total free capacity**: 12,000 emails/month
-
----
-
-## 4.2 - Email Implementation ✅
-
-### 4.2.1 - Service Configuration ✅
-- Configure Resend for transactional emails
-- Configure Brevo for marketing emails
-- Set up API keys and authentication
-
-### 4.2.2 - App Integration ✅
-- Integrate both providers into app backend
-- Create email service abstraction layer
-- Route emails to correct provider based on type
-
-### 4.2.3 - Email Triggers Definition ✅
-Define and configure when emails are triggered:
-
-| Email Type | Trigger | Service |
-|------------|---------|---------|
-| Signup confirmation | User registration | Resend |
-| Password reset | User request | Resend |
-| Alert notifications | System events | Resend |
-| Newsletters | Scheduled/manual | Brevo |
-| Marketing campaigns | Scheduled/manual | Brevo |
-
-**Action**: Audit backend/frontend to ensure all triggers are configured
-
-### 4.2.4 - Mail History Log ✅
-**Requirements**:
-- Store small mail details (not full content)
-- Archive every 30 days
-- Compact format to minimize database clutter
-- Must remain accessible for later reference
-
-**Suggested schema**:
-```
-- id
-- email_type (transactional/marketing)
-- recipient_email (hashed or partial)
-- subject_summary
-- status (sent/failed/bounced)
-- sent_at
-- archived_at
-```
-
-### 4.2.5 - Verification ✅
-- Verify all signup emails sending successfully
-- Verify all alert emails sending successfully
-- Verify all notification emails sending successfully
-- Create test suite for email delivery
-
----
-
-# PHASE 5: Pipeline & Testing
-
-## 5.1 - Pipeline Verification
-
-- Run complete manual pipeline end-to-end
-- Run complete automated pipeline end-to-end
-- Document and fix any issues found
-
----
-
-## 5.2 - QA & Testing
-
-### 5.2.1 - CRUD Operations
-- Collect current CRUD implementation from codebase
-- Visually verify each operation
-- Functionally verify each operation manually
-- Document any issues
-
-### 5.2.2 - Automation Pipeline
-- Full end-to-end test
-- From clustering to publishing
-- Verify each stage completes correctly
-
-### 5.2.3 - Credits Accuracy
-- Verify accurate credits consumption
-- Verify accurate cost calculations
-- Test edge cases (zero credits, negative, overflow)
-
----
-
-# PHASE 6: Data Cleanup & Deployment
-
-## 6.1 - Data Cleanup
-
-Clear ALL IGNY8 data:
-- Sites
-- Images
-- Content
-- All database tables
-- All logs
-
----
-
-## 6.2 - V1.0 Configuration Lock
-
-- Final configuration lock for V1.0 release
-- Document all configuration values
-- No changes after lock without version bump
-
----
-
-## 6.3 - User Testing
-
-### New User Signup Test
-- Signup 3 new users on Starter plan - verify
-- Signup 3 new users on Growth plan - verify
-- Signup 3 new users on Scale plan - verify
-
-### Personal Deployment
-- Use own account to deploy personal sites
-
----
-
-## 6.4 - Site Deployments
-
-Deploy and verify the following sites:
-- [ ] homeg8.com
-- [ ] massagersmart.com
-- [ ] Alorig.com
-- [ ] SalmanSadiq.com
-- [ ] AIAI.pk
-
----
-
-# PHASE 7: Documentation & Media
-
-## 7.1 - Documentation Updates ✅
-
-- ✅ Update all feature documentation
-- ✅ Finalize help documentation
-- ✅ Ensure accuracy with V1.0 release features
-
-**Completed Items**:
-- Updated docs/INDEX.md to v1.6.1
-- Updated CHANGELOG.md with v1.6.1 release details
-- Updated Help.tsx with 8-stage pipeline, visual flowcharts, accurate module docs
-- All documentation synced with current codebase
-
----
-
-## 7.2 - Media Creation ❌
-
-### 7.2.1 - Feature Screencasts ❌
-- Create screencast of healthy data from each page
-- Show real/representative data, not empty states
-
-### 7.2.2 - Feature Explainer Videos ❌
-- Create videos explaining each feature
-- Focus on value proposition and use cases
-
-### 7.2.3 - Tutorial Videos ❌
-- Create functional screencasts
-- How-to video tutorials for common workflows
-
----
-
-# PHASE 8: Frontend Marketing Site
-
-> ⚠️ **DEPENDENCY**: This phase can ONLY be finalized after Phase 7 documentation is complete
-
-## 8.1 - Site Content ✅
-
-- ✅ Complete site content based on:
-  - Final documentation
-  - Final feature set
-  - Help documentation
-- ✅ Ensure messaging matches actual V1.0 capabilities
-
-**Completed Items**:
-- Updated Home.tsx with 8-stage pipeline and 7 automation handoffs
-- Updated Product.tsx with accurate module descriptions and features
-- Updated Tour.tsx with 5 detailed steps and accurate pipeline
-- Updated Solutions.tsx with current architecture details
-- All marketing pages synced with app architecture
-
----
-
-## 8.2 - Pricing Page ✅
-
-Simple pricing page with three plans:
-
-| Plan | Price |
-|------|-------|
-| Starter | $99/mo |
-| Growth | $199/mo |
-| Scale | $299/mo |
-
-- ✅ Include credits information for each plan
-- ✅ Clear feature comparison
-
-**Completed Items**:
-- Updated Pricing.tsx feature matrix with accurate AI providers
-- Added image generation details (5 credits basic, 25 credits premium)
-- Updated with DALL-E 3, Runware, Bria providers
-
----
-
-## 8.3 - Upcoming Features Section ✅
-
-**Location**: Frontend marketing site ONLY (not in-app)
-
-- ✅ Created dedicated `/upcoming` page with timeline-based feature groups
-- ✅ Organized features into 3 phases: Feb 2026, Q2 2026, Q3-Q4 2026
-- ✅ Added to footer navigation under "Resources"
-
-**Completed Features Documented**:
-
-**Phase 1 - Launching February 2026**:
-- Linker Module (internal/external linking with clustering)
-- Optimizer Module (content re-optimization engine)
-
-**Phase 2 - Launching Q2 2026**:
-- Products Pages (e-commerce product content generation)
-- Services Pages (service business content engine)
-- Company Pages (corporate website essentials)
-
-**Phase 3 - Launching Q3-Q4 2026**:
-- Socializer Module (multi-platform social publishing)
-- Video Content Creator (AI video generation & publishing)
-- Site Builder (the SEO holy grail)
-- Advanced Analytics (performance insights & reporting)
-
-**Visual Design**:
-- Unique color badges for each timeline phase
-- Rich visual layout with gradients and hover effects
-- Feature cards with icons, descriptions, and detailed bullet points
-- Consistent with existing marketing site design system
-
----
-
-# Execution Summary
-
-| Phase | Scope | Difficulty | Dependencies |
-|-------|-------|------------|--------------|
-| 1 | App UI quick fixes | Easy | None |
-| 2 | App features | Medium | Phase 1 |
-| 3 | Credits/Payments | Medium | None |
-| 4 | Email setup | Medium | None |
-| 5 | Pipeline/Testing | Medium | Phases 1-4 |
-| 6 | Cleanup/Deploy | Medium | Phase 5 |
-| 7 | Documentation | Medium | Phase 6 |
-| 8 | Frontend site | Easy-Medium | **Phase 7 (hard dependency)** |
-
----
-
-# Parallel Execution
-
-**Can run simultaneously**:
-- Phase 1 + Phase 3 + Phase 4 (all independent)
-- Phase 2 (after Phase 1) + Phase 3 + Phase 4
-
-**Must be sequential**:
-- Phase 5 → Phase 6 → Phase 7 → Phase 8
-
----
-
-# PRE-LAUNCH PHASE 2: Content & Template Optimization ✅
-
-> **Goal:** Production-ready content generation and publishing  
-> **Status:** Completed January 11, 2026  
-
-## 2.1 - WordPress Post Template ✅
-
-### 2.1.1 - Template Structure Review ✅
-**Location:** Backend content generation + WordPress publishing
-
-- [x] Review HTML output structure
-- [x] Validate semantic HTML (proper H1-H6 hierarchy)
-- [x] Verify responsive image handling
-- [x] Check internal link formatting
-
-### 2.1.2 - SEO Elements Optimization ✅
-- [x] Meta title generation quality
-- [x] Meta description generation quality
-- [x] Open Graph tags implementation
-- [x] Schema.org structured data
-- [x] Canonical URL handling
-
-### 2.1.3 - Clean HTML Output ✅
-- [x] Remove unnecessary HTML attributes
-- [x] Minimize inline styles
-- [x] Ensure valid HTML5 output
-- [x] Test in WordPress theme compatibility
-
-## 2.2 - Header Section Cleanup ✅
-
-**Current Issue:** Shows various tags including non-public/non-SEO-friendly ones
-
-### Required Changes ✅:
-- [x] Audit all tags currently shown in content headers
-- [x] Keep ONLY publicly visible, SEO-friendly tags
-- [x] Keep ONLY functional/working tags
-- [x] Remove all internal/debug tags from user-facing content
-- [x] Document final tag structure
-
----
\ No newline at end of file
diff --git a/docs/plans/implemented/FINAL-PRELAUNCH-PENDING.md b/docs/plans/implemented/FINAL-PRELAUNCH-PENDING.md
deleted file mode 100644
index 395056db..00000000
--- a/docs/plans/implemented/FINAL-PRELAUNCH-PENDING.md
+++ /dev/null
@@ -1,332 +0,0 @@
-# IGNY8 Pre-Launch Pending Tasks
-
-**Last Updated:** January 11, 2026  
-**Version:** 1.7.1  
-**Target:** Production Launch Ready
-
----
-
-## Execution Order Summary
-
-| Phase | Focus | Priority | Status |
-|-------|-------|----------|--------|
-| **1** | Pipeline Verification & Testing | 🔴 Critical | ⏳ Pending |
-| **2** | User Testing & Verification | 🔴 Critical | ⏳ Pending |
-| **3** | Production Deployment | 🔴 Critical | ⏳ Pending |
-| **4** | Documentation & Media | 🟢 Post-Launch | ⏳ Pending |
-| **5** | Future Products & Addons | 🟢 Post-Launch | ⏳ Pending |
-| **6** | Content View - Image Regeneration | 🟡 Enhancement | ⏳ Pending |
-
----
-
-> **Note:** Completed phases (1, 2, 4, 5, 6) have been moved to [FINAL-PRELAUNCH-Completed.md](./FINAL-PRELAUNCH-Completed.md)
-
----
-
-# PHASE 1: Pipeline Verification & Testing 🔴
-
-> **Goal:** Complete end-to-end functionality verified
-
-## 1.1 - Manual Pipeline Test ⏳
-
-**Workflow:** Keywords → Clusters → Ideas → Tasks → Content → Images → Review → Publish
-
-| Stage | Test | Expected Result |
-|-------|------|-----------------|
-| 1. Keywords | Add 10+ keywords manually | Keywords saved, status: pending |
-| 2. Clustering | AI cluster keywords | Clusters created, keywords linked |
-| 3. Ideas | Generate ideas from cluster | Ideas created with title/brief |
-| 4. Tasks | Convert ideas to tasks | Tasks in writer queue |
-| 5. Content | Generate article content | Full HTML + meta generated |
-| 6. Images | Generate featured image | Image created and attached |
-| 7. Review | Review content in editor | Content editable, preview works |
-| 8. Publish | Publish to WordPress | Content appears on WP site |
-
-## 1.2 - Automated Pipeline Test ⏳
-
-**Test 7-stage automation with real data:**
-
-- [ ] Configure automation settings (batch sizes, delays)
-- [ ] Add 50+ keywords for processing
-- [ ] Run complete automation cycle
-- [ ] Verify each stage completes without errors
-- [ ] Confirm content reaches review/publish queue
-- [ ] Check automation logs for issues
-
-## 1.3 - CRUD Operations Verification ⏳
-
-### 1.3.1 - Per-Module CRUD Audit
-
-| Module | Create | Read | Update | Delete | Bulk Actions |
-|--------|--------|------|--------|--------|--------------|
-| Keywords | [ ] | [ ] | [ ] | [ ] | [ ] |
-| Clusters | [ ] | [ ] | [ ] | [ ] | [ ] |
-| Ideas | [ ] | [ ] | [ ] | [ ] | [ ] |
-| Tasks | [ ] | [ ] | [ ] | [ ] | [ ] |
-| Content | [ ] | [ ] | [ ] | [ ] | [ ] |
-| Images | [ ] | [ ] | [ ] | [ ] | [ ] |
-| Sites | [ ] | [ ] | [ ] | [ ] | N/A |
-
-### 1.3.2 - Document Any Issues
-- Record each issue with steps to reproduce
-- Prioritize by severity (blocking, major, minor)
-- Fix all blocking issues before proceeding
-
-## 1.4 - Credits Accuracy Verification ⏳
-
-### 1.4.1 - Credit Consumption Tests
-| Operation | Expected Credits | Actual | Pass/Fail |
-|-----------|------------------|--------|-----------|
-| Keyword Clustering | Per batch (token-based) | [ ] | [ ] |
-| Idea Generation | Per idea (token-based) | [ ] | [ ] |
-| Content Generation | Per article (token-based) | [ ] | [ ] |
-| Image Generation (Basic) | 1 credit/image | [ ] | [ ] |
-| Image Generation (Quality) | 5 credits/image | [ ] | [ ] |
-| Image Generation (Premium) | 15 credits/image | [ ] | [ ] |
-
-### 1.4.2 - Edge Cases
-- [ ] Test with zero credits (should block AI operations)
-- [ ] Test insufficient credits scenario
-- [ ] Verify balance never goes negative
-- [ ] Check transaction logging accuracy
-
----
-
-# PHASE 2: User Testing & Verification 🔴
-
-> **Goal:** Real-world user flow validation
-
-## 2.1 - New User Signup Tests ⏳
-
-### 2.1.1 - Starter Plan (3 Users)
-| User | Email | Signup | Onboarding | Site | Keywords | AI Run | Publish |
-|------|-------|--------|------------|------|----------|--------|---------|
-| 1 | test_starter_1@... | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
-| 2 | test_starter_2@... | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
-| 3 | test_starter_3@... | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
-
-### 2.1.2 - Growth Plan (3 Users)
-| User | Email | Signup | Payment | Onboarding | Multi-Site |
-|------|-------|--------|---------|------------|------------|
-| 1 | test_growth_1@... | [ ] | [ ] | [ ] | [ ] |
-| 2 | test_growth_2@... | [ ] | [ ] | [ ] | [ ] |
-| 3 | test_growth_3@... | [ ] | [ ] | [ ] | [ ] |
-
-### 2.1.3 - Scale Plan (3 Users)
-| User | Email | Signup | Payment | Team Invite | Full Pipeline |
-|------|-------|--------|---------|-------------|---------------|
-| 1 | test_scale_1@... | [ ] | [ ] | [ ] | [ ] |
-| 2 | test_scale_2@... | [ ] | [ ] | [ ] | [ ] |
-| 3 | test_scale_3@... | [ ] | [ ] | [ ] | [ ] |
-
-## 2.2 - Personal Site Deployments ⏳
-
-### Test with Real Sites:
-| Site | WP Integration | Keywords | Pipeline | Published |
-|------|----------------|----------|----------|-----------|
-| homeg8.com | [ ] | [ ] | [ ] | [ ] |
-| massagersmart.com | [ ] | [ ] | [ ] | [ ] |
-| Alorig.com | [ ] | [ ] | [ ] | [ ] |
-| SalmanSadiq.com | [ ] | [ ] | [ ] | [ ] |
-| AIAI.pk | [ ] | [ ] | [ ] | [ ] |
-
----
-
-# PHASE 3: Production Deployment 🔴
-
-> **Goal:** Stable production environment
-
-## 3.1 - Pre-Deployment Checklist ⏳
-
-### 3.1.1 - Environment Variables
-- [ ] All API keys configured (OpenAI, Anthropic, Runware, Bria)
-- [ ] Stripe/PayPal credentials set
-- [ ] Email service credentials (Resend, Brevo)
-- [ ] Database connection strings
-- [ ] Redis connection
-- [ ] CDN/Storage configuration
-
-### 3.1.2 - Security Audit
-- [ ] All debug modes disabled
-- [ ] CORS properly configured
-- [ ] SSL certificates valid
-- [ ] Rate limiting enabled
-- [ ] API authentication verified
-
-### 3.1.3 - Performance Check
-- [ ] Database indexes verified
-- [ ] Static assets optimized
-- [ ] CDN caching configured
-- [ ] Celery workers scaled appropriately
-
-## 3.2 - Go Live ⏳
-
-- [ ] Deploy to production
-- [ ] Run smoke tests
-- [ ] Monitor error logs (30 min)
-- [ ] Verify all integrations working
-- [ ] Announce launch
-
----
-
-# PHASE 4: Documentation & Media 🟢 (Post-Launch)
-
-> **Goal:** Marketing and support materials
-
-## 4.1 - Feature Screencasts ⏳
-
-### Per-Page Screenshots/Recordings
-| Page | Screenshot | Screencast | Notes |
-|------|------------|------------|-------|
-| Dashboard | [ ] | [ ] | Show populated widgets |
-| Planner/Keywords | [ ] | [ ] | Show keyword management |
-| Planner/Clusters | [ ] | [ ] | Show clustering flow |
-| Writer/Tasks | [ ] | [ ] | Show content generation |
-| Writer/Review | [ ] | [ ] | Show review workflow |
-| Automation | [ ] | [ ] | Show pipeline running |
-| Publisher/Calendar | [ ] | [ ] | Show scheduling |
-
-**Important:** Use real/representative data, not empty states
-
-## 4.2 - Explainer Videos ⏳
-
-| Video | Topic | Duration | Status |
-|-------|-------|----------|--------|
-| 1 | Platform Overview | 3-5 min | [ ] |
-| 2 | Keyword to Content Flow | 5-7 min | [ ] |
-| 3 | Automation Setup | 3-5 min | [ ] |
-| 4 | WordPress Integration | 3-5 min | [ ] |
-| 5 | Credits & Billing | 2-3 min | [ ] |
-
-## 4.3 - Tutorial Videos ⏳
-
-| Tutorial | Workflow | Duration | Status |
-|----------|----------|----------|--------|
-| Getting Started | Signup → First Content | 5-7 min | [ ] |
-| Bulk Keywords | Import → Cluster → Ideas | 5 min | [ ] |
-| Content Generation | Task → Review → Publish | 5 min | [ ] |
-| Team Management | Add Users → Roles | 3 min | [ ] |
-
----
-
-# PHASE 5: Future Products & Addons 🟢 (Post-Launch)
-
-> **Goal:** Revenue expansion options
-
-## 5.1 - Service Packages ⏳
-
-### 5.1.1 - Initial Setup Package
-**Price:** $149 (One-time)
-
-**Includes:**
-- Site added to IGNY8 platform
-- Complete WordPress integration setup
-- 500 high-opportunity keywords researched
-- Initial clustering configuration
-- First automation run
-
-### 5.1.2 - Managed Plan
-**Price:** TBD (Monthly)
-
-**Includes:**
-- Initial Setup Package
-- Monthly keyword research & updates
-- Ongoing content pipeline management
-- Performance monitoring
-- Partner agency fulfillment
-
-## 5.2 - Pricing Page Updates ⏳
-
-### Required Changes:
-- [ ] Design clear product/addon presentation
-- [ ] Separate subscription plans from addons
-- [ ] Create smooth upsell journey
-- [ ] Avoid confusing pricing tiers
-- [ ] Mobile-responsive pricing tables
-
----
-
-# PHASE 6: Content View - Image Regeneration 🟡 (Enhancement)
-
-###  NEW FEATURE - Enhancement
-
-**Problem:**
-Need ability to regenerate images from the content view with:
-- Custom prompt input
-- Option to regenerate from original prompt
-- Option to generate at higher quality tier
-
-**Current State:**
-- Backend: API endpoint documented but NOT implemented
-- Frontend: No regenerate buttons exist
-
-**Implementation Plan:**
-
-### Backend:
-Add `regenerate` action to `ImageViewSet`:
-```python
-# In modules/writer/views.py - ImageViewSet
-@action(detail=True, methods=['post'])
-def regenerate(self, request, pk=None):
-    image = self.get_object()
-    custom_prompt = request.data.get('custom_prompt', '')
-    quality_tier = request.data.get('quality_tier', image.quality_tier)
-    
-    # Append custom prompt to original if provided
-    prompt = image.prompt
-    if custom_prompt:
-        prompt = f"{prompt}. {custom_prompt}"
-    
-    # Check credits for quality tier
-    # Generate new image
-    # Update image record
-    # Return result
-```
-
-### Frontend:
-Add regenerate button to content view:
-```tsx
-// In ContentViewTemplate or similar
-<Button
-  variant="secondary"
-  size="sm"
-  onClick={() => setShowRegenerateModal(true)}
->
-  <RefreshIcon /> Regenerate Image
-</Button>
-
-// Modal with options:
-// - Custom prompt textarea
-// - Quality tier selector (Basic/Quality/Premium)
-// - "Use original prompt" checkbox
-```
-
-**Credit Calculation:**
-- Show credit cost before regeneration
-- Different costs for different quality tiers
-
----
-
-# Quick Reference: Execution Checklist
-
-## Pre-Launch Critical Path
-
-```
-Phase 1: Pipeline Testing (1 week)
-Phase 2: User Testing (1 week)
-Phase 3: Production Deployment (3 days)
-Post-Launch: Phase 4 (Documentation) + Phase 5 (Future Products)
-```
-
-## Daily Standup Questions
-
-1. What phase am I in?
-2. What's blocking progress?
-3. Any critical bugs found?
-4. Is timeline on track?
-
----
-
-**Document Owner:** IGNY8 Team  
-**Review Frequency:** Daily during pre-launch  
-**Escalation:** Any blocking issue → immediate attention
diff --git a/docs/plans/implemented/FOOTER-WIDGETS-AUDIT.md b/docs/plans/implemented/FOOTER-WIDGETS-AUDIT.md
deleted file mode 100644
index 67cf9e4e..00000000
--- a/docs/plans/implemented/FOOTER-WIDGETS-AUDIT.md
+++ /dev/null
@@ -1,334 +0,0 @@
-# Footer Widgets Audit - Complete Analysis
-**Date:** January 10, 2026  
-**Purpose:** Document all footer widgets across Planner and Writer pages to identify data conflicts
-
----
-
-## SUMMARY
-
-All Planner and Writer pages use `StandardThreeWidgetFooter` component which displays:
-1. **Widget 1 (Left)**: Page Progress - page-specific metrics
-2. **Widget 2 (Middle)**: Module Stats - uses `StandardizedModuleWidget`
-3. **Widget 3 (Right)**: Workflow Completion - uses `WorkflowCompletionWidget` via `useWorkflowStats` hook
-
----
-
-## PLANNER MODULE PAGES
-
-### Page 1: Keywords (`/planner/keywords`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| Keywords | `totalCount` | Local state (line 49) | All keywords for site+sector on current page |
-| Clustered | `totalClustered` | Local state (line 50) | Keywords with status='mapped' |
-| Unmapped | `totalUnmapped` | Local state (line 51) | Keywords without cluster_id |
-| Volume | `totalVolume` | Calculated from keywords | Sum of search volumes |
-| Progress % | Calculated | `(totalClustered / totalCount) * 100` | - |
-
-**Data Loading:** Lines 132-183
-- Loads keywords via `fetchKeywords({ site_id, sector_id, page, page_size, ...filters })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- Calculates totals from loaded data
-- **Issue**: Only calculates from CURRENT PAGE data, not all keywords
-
-#### Widget 2: Module Stats
-| Field | Value | Source |
-|-------|-------|--------|
-| Type | "planner" | Hardcoded prop |
-| Component | StandardizedModuleWidget | Centralized component |
-
-#### Widget 3: Workflow Completion
-Uses `useWorkflowStats` hook
-| Field | API Endpoint | Filter |
-|-------|--------------|--------|
-| Keywords Total | `/v1/planner/keywords/` | `site_id` only (NO sector) |
-| Keywords Clustered | `/v1/planner/keywords/?status=mapped` | `site_id` only |
-| Clusters Created | `/v1/planner/clusters/` | `site_id` only |
-| Ideas Generated | `/v1/planner/ideas/` | `site_id` only |
-| Content Drafts | `/v1/writer/content/?status=draft` | `site_id` only |
-| Content Review | `/v1/writer/content/?status=review` | `site_id` only |
-| Content Published | `/v1/writer/content/?status__in=approved,published` | `site_id` only |
-| Images Created | `/v1/writer/images/` | `site_id` only |
-
-**Source:** `frontend/src/hooks/useWorkflowStats.ts` (lines 144-234)
-- **SECTOR FILTERED**: No - intentionally site-wide for consistency
-- **Date Filtered**: Yes - supports Today, 7d, 30d, 90d, all
-
----
-
-### Page 2: Clusters (`/planner/clusters`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| Clusters | `totalCount` | Local state (line 46) | All clusters for site+sector |
-| With Ideas | `totalWithIdeas` | Local state (line 47) | Clusters with ideas_count > 0 |
-| Keywords | Calculated | Sum of all clusters' keywords_count | From loaded clusters |
-| Ready | `totalReady` | Local state (line 48) | Clusters with ideas_count === 0 |
-| Progress % | Calculated | `(totalWithIdeas / totalCount) * 100` | - |
-
-**Data Loading:** Lines 94-127
-- Loads clusters via `fetchClusters({ site_id, sector_id, page, page_size, ...filters })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- Calculates totals from loaded data
-- **Issue**: Only calculates from CURRENT PAGE data
-
-#### Widget 2 & 3: Same as Keywords page
-
----
-
-### Page 3: Ideas (`/planner/ideas`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| Ideas | `totalCount` | Local state (line 45) | All ideas for site+sector |
-| In Tasks | `totalInTasks` | Local state (line 46) | Ideas with task_id not null |
-| Pending | `totalPending` | Local state (line 47) | Ideas without task_id |
-| From Clusters | `clusters.length` | Loaded clusters count | Unique clusters |
-| Progress % | Calculated | `(totalInTasks / totalCount) * 100` | - |
-
-**Data Loading:** Lines 87-133
-- Loads ideas via `fetchContentIdeas({ site_id, sector_id, page, page_size, ...filters })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- Loads clusters separately
-- **Issue**: Only calculates from CURRENT PAGE data
-
-#### Widget 2 & 3: Same as above
-
----
-
-## WRITER MODULE PAGES
-
-### Page 4: Tasks (`/writer/tasks`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| Tasks | `totalCount` | Local state (line 47) | All tasks for site+sector |
-| Drafted | `totalDrafted` | Local state (line 48) | Tasks with content created |
-| Pending | `totalPending` | Local state (line 49) | Tasks without content |
-| Priority | `totalPriority` | Local state (line 50) | Tasks with priority=true |
-| Progress % | Calculated | `(totalDrafted / totalCount) * 100` | - |
-
-**Data Loading:** Lines 139-182
-- Loads tasks via `fetchTasks({ site_id, sector_id, page, page_size, ...filters })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- Calculates totals from loaded data
-- **Issue**: Only calculates from CURRENT PAGE data
-
-#### Widget 2: Module Stats
-| Field | Value | Source |
-|-------|-------|--------|
-| Type | "writer" | Hardcoded prop |
-| Component | StandardizedModuleWidget | Centralized component |
-
-#### Widget 3: Workflow Completion
-Same as Planner pages - uses `useWorkflowStats` hook
-
----
-
-### Page 5: Content/Drafts (`/writer/content`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| Content | `totalCount` | Local state (line 43) | All content for site+sector |
-| Published | `totalPublished` | Local state (line 44) | Content with site_status='published' |
-| In Review | `totalInReview` | Local state (line 45) | Content with status='review' |
-| Approved | `totalApproved` | Local state (line 46) | Content with status='approved' |
-| Progress % | Calculated | `(totalPublished / totalCount) * 100` | - |
-
-**Data Loading:** Lines 84-112
-- Loads content via `fetchContent({ site_id, sector_id, page, page_size, ...filters })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- **Issue**: Only calculates from CURRENT PAGE data
-
-#### Widget 2 & 3: Same as Tasks page
-
----
-
-### Page 6: Review (`/writer/review`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| In Review | `totalCount` | Local state (line 39) | Content with status='review' |
-| Approved | `totalApproved` | Local state (line 40) | From review that moved to approved |
-| Pending | `totalPending` | Local state (line 41) | Still in review status |
-| Priority | `totalPriority` | Local state (line 42) | With priority flag |
-| Progress % | Calculated | `(totalApproved / totalCount) * 100` | - |
-
-**Data Loading:** Lines 77-105
-- Loads review content via `fetchContent({ site_id, sector_id, status: 'review', page, page_size })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- **Pre-filtered**: Only loads status='review'
-- **Issue**: Only calculates from CURRENT PAGE data
-
-#### Widget 2 & 3: Same as other Writer pages
-
----
-
-### Page 7: Approved (`/writer/approved`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| Approved | `totalCount` | Local state (line 39) | Content with status='approved' |
-| Published | `totalPublished` | Local state (line 40) | With site_status='published' |
-| Scheduled | `totalScheduled` | Local state (line 41) | With site_status='scheduled' |
-| Ready | `totalReady` | Local state (line 42) | With site_status='not_published' |
-| Progress % | Calculated | `(totalPublished / totalCount) * 100` | - |
-
-**Data Loading:** Lines 77-107
-- Loads approved content via `fetchContent({ site_id, sector_id, status: 'approved', page, page_size })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- **Pre-filtered**: Only loads status='approved'
-- **Issue**: Only calculates from CURRENT PAGE data
-
-#### Widget 2 & 3: Same as other Writer pages
-
----
-
-### Page 8: Images (`/writer/images`)
-
-#### Widget 1: Page Progress
-| Field | Value | Source | Filter/Criteria |
-|-------|-------|--------|-----------------|
-| Images | `totalCount` | Local state (line 44) | All images for site+sector |
-| Featured | `totalFeatured` | Local state (line 45) | Images with image_type='featured' |
-| In-Article | `totalInArticle` | Local state (line 46) | Images with image_type='in_article' |
-| Linked | `totalLinked` | Local state (line 47) | Images with content_id not null |
-| Progress % | Calculated | `(totalLinked / totalCount) * 100` | - |
-
-**Data Loading:** Lines 98-144
-- Loads images via `fetchImages({ site_id, sector_id, page, page_size, ...filters })`
-- **SECTOR FILTERED**: Yes - uses `activeSector.id`
-- **Issue**: Only calculates from CURRENT PAGE data
-
-#### Widget 2 & 3: Same as other Writer pages
-
----
-
-## ROOT CAUSES OF DATA CONFLICTS
-
-### Problem 1: Page-Level vs Site-Wide Data
-**Conflict:** Widget 1 (Page Progress) shows **page-filtered** counts, Widget 3 (Workflow) shows **site-wide** counts
-
-| Widget | Scope | Sector Filter | Date Filter | Data Source |
-|--------|-------|---------------|-------------|-------------|
-| Widget 1 (Page Progress) | Current page only | YES | NO | Local state from paginated API |
-| Widget 2 (Module Stats) | Site-wide | NO | NO | Centralized hook (StandardizedModuleWidget) |
-| Widget 3 (Workflow) | Site-wide | NO | YES (optional) | useWorkflowStats hook |
-
-**Example Conflict:**
-- Keywords page shows "17 Keywords" in Page Progress (Widget 1) ← from current page
-- Workflow widget shows "17 Keywords Clustered" (Widget 3) ← from ALL keywords site-wide
-- If user is on page 2, Widget 1 shows page 2 keywords, but Widget 3 shows total site keywords
-
-### Problem 2: Sector Filtering Inconsistency
-**Conflict:** Widget 1 filters by sector, Widget 3 does NOT
-
-| Component | Sector Filtered? | Reasoning |
-|-----------|------------------|-----------|
-| Page Progress (Widget 1) | ✅ YES | Shows current page data which is sector-filtered |
-| Module Stats (Widget 2) | ❌ NO | Centralized module-level stats |
-| Workflow Widget (Widget 3) | ❌ NO | Intentionally site-wide for consistency across pages |
-
-**User's Point:** If only 1 sector exists, sector filter doesn't matter - but data STILL conflicts because Widget 1 shows PAGINATED data
-
-### Problem 3: Pagination vs Total Counts
-**Critical Issue:** Widget 1 calculates totals from **current page data only**, not all records
-
-Example on Keywords page (lines 182-183):
-```typescript
-setTotalCount(keywords.length);  // ← Only current page!
-setTotalClustered(keywords.filter(k => k.status === 'mapped').length);  // ← Only current page!
-```
-
-Should be:
-```typescript
-setTotalCount(response.count);  // ← Total from API
-setTotalClustered(/* need separate API call or response field */);
-```
-
-### Problem 4: Different Time Ranges
-| Widget | Time Filtering |
-|--------|----------------|
-| Widget 1 | NO time filter - shows ALL data for site+sector |
-| Widget 3 | YES time filter - supports Today, 7d, 30d, 90d buttons |
-
----
-
-## RECOMMENDED FIXES
-
-### Fix 1: Make Page Progress Show Site-Wide Totals
-**Current:** Calculates from paginated data
-**Should Be:** Use `response.count` from API for totals
-
-**Files to Fix:**
-- `frontend/src/pages/Planner/Keywords.tsx`
-- `frontend/src/pages/Planner/Clusters.tsx`
-- `frontend/src/pages/Planner/Ideas.tsx`
-- `frontend/src/pages/Writer/Tasks.tsx`
-- `frontend/src/pages/Writer/Content.tsx`
-- `frontend/src/pages/Writer/Review.tsx`
-- `frontend/src/pages/Writer/Approved.tsx`
-- `frontend/src/pages/Writer/Images.tsx`
-
-**Change Pattern:**
-```typescript
-// OLD (WRONG):
-setTotalCount(items.length);  // Only current page
-
-// NEW (CORRECT):
-setTotalCount(response.count);  // Total count from API
-```
-
-### Fix 2: Document That Widgets Show Different Scopes
-**Add tooltips/help text:**
-- Widget 1: "Page statistics (current filters)"
-- Widget 3: "Site-wide workflow progress (all sectors)"
-
-### Fix 3: Consider Adding Sector Filter Option to Widget 3
-**Alternative:** Add toggle in Workflow Widget to switch between:
-- Site-wide (current behavior)
-- Current sector only (match Widget 1)
-
----
-
-## ADDITIONAL FINDINGS
-
-### Publishing Tab Issues
-**File:** `frontend/src/pages/Sites/Settings.tsx`
-
-**Issue:** Day selection and time slot changes auto-save immediately instead of waiting for "Save Publishing Settings" button
-
-**Lines with auto-save:**
-- Line 1195: Publishing days button click calls `savePublishingSettings({ publish_days: newDays })`
-- Line 1224: Remove time slot calls `savePublishingSettings({ publish_time_slots: newSlots })`
-- Line 1236: Add time slot calls `savePublishingSettings({ publish_time_slots: newSlots })`
-
-**Fix:** Remove `savePublishingSettings()` calls from these onChange handlers, let user click the Save button at line 1278
-
----
-
-## SUMMARY TABLE: ALL PAGES
-
-| Page | Widget 1 Scope | Widget 1 Sector Filter | Widget 3 Scope | Widget 3 Sector Filter | Conflict? |
-|------|---------------|----------------------|---------------|----------------------|-----------|
-| Keywords | Current page | YES | Site-wide | NO | ✅ YES |
-| Clusters | Current page | YES | Site-wide | NO | ✅ YES |
-| Ideas | Current page | YES | Site-wide | NO | ✅ YES |
-| Tasks | Current page | YES | Site-wide | NO | ✅ YES |
-| Content | Current page | YES | Site-wide | NO | ✅ YES |
-| Review | Current page | YES | Site-wide | NO | ✅ YES |
-| Approved | Current page | YES | Site-wide | NO | ✅ YES |
-| Images | Current page | YES | Site-wide | NO | ✅ YES |
-
-**Conclusion:** ALL pages have the pagination vs site-wide conflict. The sector filtering is actually a secondary issue.
-
----
-
-## END OF AUDIT
diff --git a/docs/plans/implemented/FREE_ACCOUNT_OPTIONS_ANALYSIS.md b/docs/plans/implemented/FREE_ACCOUNT_OPTIONS_ANALYSIS.md
deleted file mode 100644
index b09a02eb..00000000
--- a/docs/plans/implemented/FREE_ACCOUNT_OPTIONS_ANALYSIS.md
+++ /dev/null
@@ -1,744 +0,0 @@
-# Free Account Options - Architecture Analysis
-
-**Date:** January 14, 2026  
-**Status:** Planning Phase  
-**Purpose:** Compare two approaches for free user onboarding with limited AI operations
-
----
-
-## Current System Architecture
-
-### 1. **Account & Plan System**
-```python
-Account Model:
-- plan (FK to Plan)
-- credits (Integer, current balance)
-- status (trial, active, suspended, pending_payment, cancelled)
-- payment_method
-- usage_ahrefs_queries (monthly counter)
-- usage_period_start/end
-
-Plan Model:
-- name, slug, price, billing_cycle
-- is_internal (hide from public listings)
-- max_sites, max_keywords, max_users, max_author_profiles
-- included_credits (monthly allocation)
-- extra_credit_price
-- allow_credit_topup
-- max_ahrefs_queries (monthly limit)
-```
-
-### 2. **AI Configuration System**
-```python
-AIModelConfig (Global - Single Source of Truth):
-- model_name (e.g., 'gpt-4o-mini', 'hidream-full')
-- model_type (text/image)
-- provider (openai, runware, etc.)
-- is_default (one default per type)
-- is_active
-- cost_per_1k_input/output (text models)
-- credits_per_image (image models)
-- tokens_per_credit (text models)
-
-AISettings (Per-Account Overrides):
-- account (FK)
-- integration_type (openai, runware)
-- config (API keys, settings)
-- model_preferences (per operation type)
-- cost_limits (budgets)
-```
-
-### 3. **Credit Tracking System**
-```python
-CreditTransaction:
-- transaction_type (purchase, subscription, deduction, adjustment)
-- amount (positive/negative)
-- balance_after
-- description, metadata
-
-CreditUsageLog (Per AI Operation):
-- operation_type (clustering, idea_generation, content_generation, image_generation)
-- credits_used
-- cost_usd
-- model_used
-- tokens_input/output
-- site (FK for filtering)
-- related_object_type/id
-```
-
-### 4. **Current Registration Flow**
-1. User registers → `RegisterSerializer.create()`
-2. If `plan_slug` not provided or = 'free':
-   - Assigns Plan.slug='free' (must exist)
-   - Account.status = 'trial'
-   - Account.credits = plan.included_credits
-   - Creates CreditTransaction (initial allocation)
-3. User can perform AI operations until credits exhausted
-
----
-
-## 📊 Option 1: Individual Free Accounts (Isolated)
-
-### **Concept**
-Each user gets their own free account with:
-- Fixed cheaper AI models (GPT-4o mini, Hidream-full)
-- Low credit allocation (50-100 operations)
-- Own isolated data/workspace
-- Ability to upgrade to paid plan
-
-### **Implementation Plan**
-
-#### **Step 1: Create Free Plan**
-```sql
--- Admin action via Django Admin
-INSERT INTO igny8_plans (
-    name, slug, price, billing_cycle, 
-    is_featured, is_internal, is_active,
-    max_sites, max_users, max_keywords,
-    included_credits, allow_credit_topup,
-    max_ahrefs_queries
-) VALUES (
-    'Free Starter', 'free', 0.00, 'monthly',
-    false, true, true,
-    1,  -- max_sites: 1 site only
-    1,  -- max_users: owner only
-    100,  -- max_keywords: 100
-    100,  -- included_credits: 100 credits (~50 operations)
-    false,  -- No credit topup for free
-    0  -- No Ahrefs access
-);
-```
-
-#### **Step 2: Create AI Model Configs (If Not Exist)**
-```sql
--- GPT-4o Mini (cheaper text model)
-INSERT INTO igny8_ai_model_config (
-    model_name, model_type, provider, display_name,
-    is_default, is_active,
-    cost_per_1k_input, cost_per_1k_output,
-    tokens_per_credit, max_tokens, context_window
-) VALUES (
-    'gpt-4o-mini', 'text', 'openai', 'GPT-4o Mini (Fast & Efficient)',
-    false, true,
-    0.00015, 0.0006,  -- Cheaper than GPT-4
-    1000, 16384, 128000
-);
-
--- Hidream Full (cheaper image model)
-INSERT INTO igny8_ai_model_config (
-    model_name, model_type, provider, display_name,
-    is_default, is_active,
-    credits_per_image, quality_tier,
-    square_size, landscape_size
-) VALUES (
-    'hidream-full', 'image', 'runware', 'Hidream Full (Standard Quality)',
-    false, true,
-    1,  -- 1 credit per image (cheapest)
-    'basic',
-    '1024x1024', '1280x768'
-);
-```
-
-#### **Step 3: Update Registration Logic**
-```python
-# In auth/serializers.py RegisterSerializer.create()
-
-# No changes needed! Current logic already handles this:
-if not plan_slug or plan_slug == 'free':
-    plan = Plan.objects.get(slug='free', is_active=True)
-    account_status = 'trial'
-    initial_credits = plan.included_credits  # 100 credits
-```
-
-#### **Step 4: Force Free Plan AI Models**
-**Option A: Global Default (Simplest)**
-```sql
--- Set GPT-4o Mini and Hidream as defaults
-UPDATE igny8_ai_model_config 
-SET is_default = false 
-WHERE model_type = 'text';
-
-UPDATE igny8_ai_model_config 
-SET is_default = true 
-WHERE model_name = 'gpt-4o-mini';
-
-UPDATE igny8_ai_model_config 
-SET is_default = false 
-WHERE model_type = 'image';
-
-UPDATE igny8_ai_model_config 
-SET is_default = true 
-WHERE model_name = 'hidream-full';
-```
-**Pros:** Zero code changes, all free accounts inherit defaults  
-**Cons:** Affects ALL accounts (paid users too)
-
-**Option B: Per-Account AI Settings (Recommended)**
-```python
-# In auth/serializers.py RegisterSerializer.create()
-# After account creation:
-
-if account_status == 'trial':  # Free accounts only
-    from igny8_core.modules.system.settings_models import AISettings
-    
-    # Create AI settings for OpenAI (text)
-    AISettings.objects.create(
-        account=account,
-        integration_type='openai',
-        model_preferences={
-            'clustering': 'gpt-4o-mini',
-            'idea_generation': 'gpt-4o-mini',
-            'content_generation': 'gpt-4o-mini',
-            'optimization': 'gpt-4o-mini',
-        },
-        is_active=True
-    )
-    
-    # Create AI settings for Runware (images)
-    AISettings.objects.create(
-        account=account,
-        integration_type='runware',
-        model_preferences={
-            'image_generation': 'hidream-full',
-        },
-        is_active=True
-    )
-```
-**Pros:** Free accounts locked to cheap models, paid accounts unaffected  
-**Cons:** Requires code change in registration flow
-
-**Option C: Plan-Level AI Model Configuration**
-```python
-# Add new field to Plan model (migration required)
-class Plan(models.Model):
-    # ... existing fields ...
-    allowed_text_models = models.JSONField(
-        default=list,
-        help_text="Allowed text AI models (empty = all)"
-    )
-    allowed_image_models = models.JSONField(
-        default=list,
-        help_text="Allowed image AI models (empty = all)"
-    )
-    force_default_models = models.BooleanField(
-        default=False,
-        help_text="Force plan defaults, ignore user overrides"
-    )
-
-# Update Free plan:
-plan = Plan.objects.get(slug='free')
-plan.allowed_text_models = ['gpt-4o-mini']
-plan.allowed_image_models = ['hidream-full']
-plan.force_default_models = True
-plan.save()
-
-# In AI operation logic (ai/services.py or similar):
-def get_ai_model_for_account(account, operation_type):
-    plan = account.plan
-    if plan.force_default_models:
-        if operation_type in ['clustering', 'idea_generation', 'content_generation']:
-            return 'gpt-4o-mini'
-        elif operation_type == 'image_generation':
-            return 'hidream-full'
-    # ... existing logic for paid accounts
-```
-**Pros:** Centralized plan-based control, scalable  
-**Cons:** Requires migration + AI operation logic changes
-
-#### **Step 5: Frontend Restrictions**
-```typescript
-// In frontend, check plan limits
-if (user.account.plan.slug === 'free') {
-  // Hide model selector (force defaults)
-  // Show "Upgrade for more models" message
-  // Disable credit topup
-  // Disable Ahrefs research
-}
-```
-
-### **✅ Pros: Individual Free Accounts**
-1. **Full User Experience** - Users get their own workspace, test all features
-2. **Data Isolation** - Private data, no cross-contamination
-3. **Smooth Upgrade Path** - Existing account → upgrade plan → keep data
-4. **Proper Multi-Tenancy** - Each account is isolated, secure
-5. **Credit Tracking** - Accurate per-user usage analytics
-6. **Marketing Value** - "100 Free Credits" sounds generous
-
-### **❌ Cons: Individual Free Accounts**
-1. **Database Growth** - Each user = new Account + User + potential Sites/Keywords
-2. **Abuse Potential** - Users can create multiple emails for free credits
-3. **Complex Enforcement** - Need to enforce model restrictions per account
-4. **Storage Costs** - Each account stores independent data
-5. **Migration Complexity** - If user upgrades, need to handle plan transition
-
-### **Effort Estimate: Individual Free Accounts**
-- **Minimal Approach** (Option A): **1 hour**
-  - Create free plan via admin
-  - Set default models globally
-  - Update frontend to hide topup for free users
-  
-- **Recommended Approach** (Option B): **4-6 hours**
-  - Create free plan via admin
-  - Update registration to create AISettings per free account
-  - Update AI operation logic to read account-specific models
-  - Frontend: Hide model selector for free users
-  - Testing across all AI operations
-
-- **Enterprise Approach** (Option C): **1-2 days**
-  - Migration: Add allowed_models fields to Plan
-  - Update registration flow
-  - Refactor AI operation logic (all modules)
-  - Admin UI for plan model management
-  - Comprehensive testing
-
----
-
-## 🎭 Option 2: Shared Demo Account (Multi-User)
-
-### **Concept**
-One demo account shared by multiple users:
-- Users provide email → get "demo access" token
-- Limited operations pool (50-100 per user, tracked separately)
-- Shared data (users see what others created)
-- Pre-configured cheaper AI models
-- No upgrade path (must create new account)
-
-### **Implementation Plan**
-
-#### **Step 1: Create Demo Account**
-```sql
--- Create demo plan (internal)
-INSERT INTO igny8_plans (
-    name, slug, price, billing_cycle,
-    is_internal, is_active,
-    max_sites, max_users, max_keywords,
-    included_credits, allow_credit_topup
-) VALUES (
-    'Demo Access', 'demo', 0.00, 'monthly',
-    true, true,
-    1,  -- 1 demo site
-    999,  -- Unlimited demo users
-    50,  -- Limited keywords
-    10000,  -- Large shared pool
-    false
-);
-
--- Create demo account
-INSERT INTO igny8_tenants (
-    name, slug, owner_id, plan_id, 
-    credits, status
-) VALUES (
-    'IGNY8 Demo Workspace', 'igny8-demo', 1,  -- owner = admin
-    (SELECT id FROM igny8_plans WHERE slug='demo'),
-    10000, 'active'
-);
-
--- Create demo site
-INSERT INTO igny8_sites (
-    name, url, account_id, is_active
-) VALUES (
-    'Demo Content Site', 'https://demo.example.com',
-    (SELECT id FROM igny8_tenants WHERE slug='igny8-demo'),
-    true
-);
-```
-
-#### **Step 2: Create DemoUserAccess Model**
-```python
-# In auth/models.py
-class DemoUserAccess(models.Model):
-    """Track individual demo user access and limits"""
-    email = models.EmailField(unique=True, db_index=True)
-    demo_account = models.ForeignKey(
-        'Account',
-        on_delete=models.CASCADE,
-        related_name='demo_users'
-    )
-    access_token = models.CharField(max_length=255, unique=True)
-    operations_used = models.IntegerField(default=0)
-    operations_limit = models.IntegerField(default=50)
-    created_at = models.DateTimeField(auto_now_add=True)
-    last_accessed = models.DateTimeField(auto_now=True)
-    is_active = models.BooleanField(default=True)
-    
-    class Meta:
-        db_table = 'igny8_demo_user_access'
-        indexes = [
-            models.Index(fields=['email', 'is_active']),
-            models.Index(fields=['access_token']),
-        ]
-    
-    def __str__(self):
-        return f"Demo: {self.email} ({self.operations_used}/{self.operations_limit})"
-    
-    def has_operations_remaining(self):
-        return self.operations_used < self.operations_limit
-```
-
-#### **Step 3: Migration**
-```python
-# migrations/0014_demo_user_access.py
-from django.db import migrations, models
-
-class Migration(migrations.Migration):
-    dependencies = [
-        ('igny8_core_auth', '0013_add_plan_is_internal'),
-    ]
-    
-    operations = [
-        migrations.CreateModel(
-            name='DemoUserAccess',
-            fields=[
-                ('id', models.AutoField(primary_key=True)),
-                ('email', models.EmailField(unique=True, db_index=True)),
-                ('demo_account', models.ForeignKey(
-                    on_delete=models.CASCADE,
-                    to='igny8_core_auth.Account',
-                    related_name='demo_users'
-                )),
-                ('access_token', models.CharField(max_length=255, unique=True)),
-                ('operations_used', models.IntegerField(default=0)),
-                ('operations_limit', models.IntegerField(default=50)),
-                ('created_at', models.DateTimeField(auto_now_add=True)),
-                ('last_accessed', models.DateTimeField(auto_now=True)),
-                ('is_active', models.BooleanField(default=True)),
-            ],
-            options={'db_table': 'igny8_demo_user_access'},
-        ),
-    ]
-```
-
-#### **Step 4: Demo Access Endpoint**
-```python
-# In auth/views.py AuthViewSet
-
-@action(detail=False, methods=['post'], permission_classes=[])
-def request_demo_access(self, request):
-    """Request demo account access with email only"""
-    email = request.data.get('email')
-    if not email:
-        return error_response(
-            error='Email is required',
-            status_code=status.HTTP_400_BAD_REQUEST,
-            request=request
-        )
-    
-    # Validate email format
-    from django.core.validators import validate_email
-    from django.core.exceptions import ValidationError
-    try:
-        validate_email(email)
-    except ValidationError:
-        return error_response(
-            error='Invalid email format',
-            status_code=status.HTTP_400_BAD_REQUEST,
-            request=request
-        )
-    
-    # Get demo account
-    try:
-        demo_account = Account.objects.get(slug='igny8-demo', status='active')
-    except Account.DoesNotExist:
-        return error_response(
-            error='Demo account not configured',
-            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
-            request=request
-        )
-    
-    # Get or create demo user access
-    from .models import DemoUserAccess
-    import secrets
-    
-    demo_user, created = DemoUserAccess.objects.get_or_create(
-        email=email,
-        demo_account=demo_account,
-        defaults={
-            'access_token': secrets.token_urlsafe(32),
-            'operations_limit': 50,
-        }
-    )
-    
-    if not demo_user.is_active:
-        return error_response(
-            error='Demo access suspended. Please contact support.',
-            status_code=status.HTTP_403_FORBIDDEN,
-            request=request
-        )
-    
-    if not demo_user.has_operations_remaining():
-        return error_response(
-            error='Demo operation limit reached. Please sign up for a full account.',
-            status_code=status.HTTP_429_TOO_MANY_REQUESTS,
-            request=request
-        )
-    
-    # Generate temporary JWT for demo account
-    # (Custom token that includes demo_user_id)
-    access_token = generate_demo_access_token(demo_account, demo_user)
-    
-    return success_response(
-        data={
-            'access_token': access_token,
-            'demo_user': {
-                'email': demo_user.email,
-                'operations_remaining': demo_user.operations_limit - demo_user.operations_used,
-                'operations_limit': demo_user.operations_limit,
-            },
-            'account': {
-                'id': demo_account.id,
-                'name': demo_account.name,
-                'is_demo': True,
-            }
-        },
-        message='Demo access granted' if created else 'Welcome back to demo',
-        request=request
-    )
-```
-
-#### **Step 5: Custom JWT with Demo Context**
-```python
-# In auth/utils.py
-
-def generate_demo_access_token(account, demo_user):
-    """Generate JWT for demo access with demo_user context"""
-    import jwt
-    from datetime import datetime, timedelta
-    from django.conf import settings
-    
-    expiry = datetime.utcnow() + timedelta(hours=24)  # 24-hour demo session
-    
-    payload = {
-        'account_id': account.id,
-        'account_slug': account.slug,
-        'demo_user_id': demo_user.id,
-        'demo_user_email': demo_user.email,
-        'is_demo': True,
-        'exp': expiry,
-        'iat': datetime.utcnow(),
-    }
-    
-    return jwt.encode(payload, settings.SECRET_KEY, algorithm='HS256')
-```
-
-#### **Step 6: Demo Operation Tracking Middleware**
-```python
-# In middleware/demo_tracking.py
-
-class DemoOperationTrackingMiddleware:
-    """Track demo user operations and enforce limits"""
-    
-    def __init__(self, get_response):
-        self.get_response = get_response
-    
-    def __call__(self, request):
-        # Check if demo user
-        if hasattr(request, 'demo_user_id'):
-            from igny8_core.auth.models import DemoUserAccess
-            
-            demo_user = DemoUserAccess.objects.select_for_update().get(
-                id=request.demo_user_id
-            )
-            
-            # Check limit before processing
-            if not demo_user.has_operations_remaining():
-                return JsonResponse({
-                    'success': False,
-                    'error': 'Demo operation limit reached. Please sign up for a full account.',
-                    'upgrade_url': '/pricing'
-                }, status=429)
-            
-            # Store demo_user in request for operation tracking
-            request.demo_user = demo_user
-        
-        response = self.get_response(request)
-        return response
-
-# Add to settings.py MIDDLEWARE
-```
-
-#### **Step 7: Update AI Operation Logic**
-```python
-# In ai/services.py or wherever AI operations are tracked
-
-def log_ai_operation(account, operation_type, credits_used, **kwargs):
-    """Log AI operation and increment demo counter if demo user"""
-    from igny8_core.business.billing.models import CreditUsageLog
-    from django.db import transaction
-    
-    with transaction.atomic():
-        # Create credit usage log
-        CreditUsageLog.objects.create(
-            account=account,
-            operation_type=operation_type,
-            credits_used=credits_used,
-            **kwargs
-        )
-        
-        # Deduct credits from account
-        account.credits -= credits_used
-        account.save()
-        
-        # If demo user, increment their personal counter
-        from threading import local
-        _request = getattr(local(), 'request', None)
-        if _request and hasattr(_request, 'demo_user'):
-            demo_user = _request.demo_user
-            demo_user.operations_used += 1
-            demo_user.save()
-```
-
-#### **Step 8: Frontend Demo Flow**
-```typescript
-// New demo signup flow
-async function requestDemoAccess(email: string) {
-  const response = await api.post('/v1/auth/request-demo-access/', { email });
-  
-  if (response.success) {
-    // Store demo token
-    localStorage.setItem('demo_token', response.data.access_token);
-    localStorage.setItem('is_demo', 'true');
-    
-    // Show demo banner
-    showDemoBanner({
-      operationsRemaining: response.data.demo_user.operations_remaining,
-      operationsLimit: response.data.demo_user.operations_limit,
-    });
-    
-    // Redirect to demo workspace
-    router.push('/dashboard');
-  }
-}
-
-// Demo banner component
-<DemoBanner>
-  <p>🎭 You're in Demo Mode - {operationsRemaining} operations remaining</p>
-  <Button onClick={() => router.push('/pricing')}>
-    Upgrade for Full Access
-  </Button>
-</DemoBanner>
-
-// Disable certain features in demo mode
-if (isDemo) {
-  disableFeatures(['integrations', 'automation', 'wordpress_sync']);
-  showSharedDataWarning();
-}
-```
-
-### **✅ Pros: Shared Demo Account**
-1. **Zero Database Growth** - One account, minimal new records
-2. **Instant Access** - No account creation, just email → token
-3. **Showcase Content** - Users see real AI-generated examples from others
-4. **Anti-Abuse** - Email-based tracking, hard limits per email
-5. **Conversion Pressure** - "See others creating, sign up for your own workspace"
-6. **Cost Efficient** - Shared credit pool, bulk tracking
-
-### **❌ Cons: Shared Demo Account**
-1. **No Data Privacy** - All users see shared workspace (could be feature or bug)
-2. **Complex Access Control** - Need custom JWT + middleware + tracking
-3. **No Upgrade Path** - Demo token ≠ real account, must register separately
-4. **Shared Credit Pool** - If pool exhausted, demo is down for everyone
-5. **Feature Limitations** - Can't show integrations, automation, publishing
-6. **User Confusion** - "Why do I see others' content?" + "Lost my demo data!"
-7. **Backend Complexity** - New model, middleware, JWT type, operation tracking
-
-### **Effort Estimate: Shared Demo Account**
-**Full Implementation**: **2-3 days**
-- Create demo plan + account + site (1 hour)
-- Create DemoUserAccess model + migration (2 hours)
-- Build request_demo_access endpoint (2 hours)
-- Custom JWT generation with demo context (2 hours)
-- Middleware for demo tracking + limits (3 hours)
-- Update AI operation logging (2 hours)
-- Frontend: Demo flow + banner + restrictions (4 hours)
-- Admin: Dashboard to manage demo users (2 hours)
-- Testing: Edge cases, limits, shared data (4 hours)
-
----
-
-## 🎯 Recommendation
-
-### **🏆 Winner: Option 1 - Individual Free Accounts (Option B)**
-
-**Rationale:**
-1. **Simpler Architecture** - Leverages existing multi-tenancy, no custom JWT/middleware
-2. **Better UX** - Private workspace, smooth upgrade path, feels like real product
-3. **Faster Implementation** - 4-6 hours vs 2-3 days
-4. **Lower Risk** - No shared data confusion, no new access control layer
-5. **Marketing Win** - "100 Free Credits" > "Demo Access with Shared Data"
-6. **Scalable** - If abuse becomes issue, add email verification or captcha
-
-**Implementation Checklist:**
-```markdown
-- [ ] Create 'free' plan via Django Admin
-  - [ ] Set: included_credits=100, max_sites=1, max_keywords=100
-  - [ ] Set: is_internal=true, allow_credit_topup=false
-  
-- [ ] Verify AI Model Configs exist
-  - [ ] GPT-4o Mini (text, cheap)
-  - [ ] Hidream Full (image, cheap)
-  
-- [ ] Update RegisterSerializer (auth/serializers.py)
-  - [ ] After account creation for trial status:
-  - [ ] Create AISettings for openai (text) → gpt-4o-mini
-  - [ ] Create AISettings for runware (images) → hidream-full
-  
-- [ ] Update Frontend
-  - [ ] Hide model selector for free plan
-  - [ ] Disable credit topup for free plan
-  - [ ] Show "Upgrade for more models" CTA
-  
-- [ ] Testing
-  - [ ] Register new free account
-  - [ ] Run text AI operation → verify gpt-4o-mini used
-  - [ ] Run image AI operation → verify hidream-full used
-  - [ ] Verify 100 credits allocated
-  - [ ] Verify upgrade flow works
-```
-
----
-
-## 🔮 Future Enhancements (Optional)
-
-### For Option 1 (Individual Free Accounts):
-1. **Email Verification** - Require verified email to prevent abuse
-2. **Captcha** - Add reCAPTCHA on free signups
-3. **Usage Analytics** - Track free-to-paid conversion rates
-4. **Referral Credits** - Give 50 bonus credits for referrals
-5. **Time-Limited Trial** - 30-day access instead of credit-limited
-
-### For Option 2 (Shared Demo - If Pursued):
-1. **Demo Content Curation** - Pre-seed with high-quality examples
-2. **Demo Reset** - Daily reset to clean state
-3. **Anonymous Mode** - Show "User A, User B" instead of emails
-4. **Live Activity Feed** - "User just generated an article about X"
-5. **Demo Leaderboard** - Gamify the experience
-
----
-
-## 📚 Reference Files
-
-**Models:**
-- `/backend/igny8_core/auth/models.py` - Account, Plan, User
-- `/backend/igny8_core/business/billing/models.py` - AIModelConfig, CreditTransaction, CreditUsageLog
-- `/backend/igny8_core/modules/system/settings_models.py` - AISettings
-
-**Registration:**
-- `/backend/igny8_core/auth/serializers.py` - RegisterSerializer
-- `/backend/igny8_core/auth/views.py` - AuthViewSet.register()
-
-**AI Operations:**
-- Check modules: clustering, ideas, content, images for credit deduction logic
-
----
-
-## ✅ Decision
-
-**Recommended:** Proceed with **Option 1 - Individual Free Accounts (Option B)**  
-**Estimated Time:** 4-6 hours  
-**Risk Level:** Low  
-**User Experience:** Excellent
-
-Consider **Option 2** only if:
-- Need to showcase "collaborative" aspect
-- Want zero database growth (high traffic expected)
-- Marketing wants "see what others create" feature
diff --git a/docs/plans/implemented/FRONTEND-AUDIT-PLAN.md b/docs/plans/implemented/FRONTEND-AUDIT-PLAN.md
deleted file mode 100644
index 1578384d..00000000
--- a/docs/plans/implemented/FRONTEND-AUDIT-PLAN.md
+++ /dev/null
@@ -1,663 +0,0 @@
-# Frontend Complete Refactoring & Standardization Plan
-
-## ✅ STATUS: TAILWIND DEFAULT COLORS DISABLED
-
-**As of 2026-01-01**: All Tailwind default color palettes (blue-500, red-600, green-400, etc.) have been **disabled** via `@theme` in `design-system.css`. Only our custom design system colors work now.
-
-### What's Disabled (via `@theme { --color-*-*: initial; }`)
-- `red-*`, `orange-*`, `amber-*`, `yellow-*`, `lime-*`
-- `green-*`, `emerald-*`, `teal-*`, `cyan-*`, `sky-*`
-- `blue-*`, `indigo-*`, `violet-*`, `fuchsia-*`, `pink-*`, `rose-*`
-- `slate-*`, `zinc-*`, `neutral-*`, `stone-*`
-
-### What WORKS (our design system)
-- `brand-*` (25-950) - derived from `--color-primary`
-- `success-*` (25-950) - derived from `--color-success`
-- `warning-*` (25-950) - derived from `--color-warning`
-- `error-*` (25-950) - derived from `--color-danger`
-- `purple-*` (25-950) - derived from `--color-purple`
-- `gray-*` (25-950) - derived from `--color-gray-base`
-- `blue-light-*` - info/link colors (derived from primary)
-
----
-
-## 🎯 Objective
-
-**Completely remove Tailwind default styles** and refactor the entire frontend to use **ONLY** the custom design system defined in `/src/styles/design-system.css`.
-
-### Why This Refactor?
-- AI agents keep defaulting to Tailwind's standard colors instead of our custom tokens
-- Mixed Tailwind + custom styles cause conflicts and inconsistencies
-- No single source of truth - styles scattered across files
-- Inline components duplicated across multiple pages
-
-### End Goal
-- **Single CSS file** (`design-system.css`) as the ONLY source for all design tokens
-- **All colors** come from CSS variables defined in `:root`
-- **All components** extracted to `/components/ui/` - NO inline component definitions
-- **Zero Tailwind default colors** - only our custom palette (brand, success, error, warning, purple, gray)
-
----
-
-## 📂 Single Source of Truth: `/src/styles/design-system.css`
-
-This file contains:
-- **Section 1**: Design Tokens (CSS Variables) - colors, radius, shadows, gradients
-- **Section 2**: Dark Mode Overrides
-- **Section 3**: Tailwind Configuration (DEFAULT COLORS DISABLED)
-- **Section 4**: Base Styles
-- **Section 5**: Component Utilities
-- **Section 6**: Form Element Styles
-- **Section 7**: Table Styles
-- **Section 8**: Header Metrics
-- **Section 9**: Badge Styles
-- **Section 10-13**: Library overrides, utilities, animations
-
----
-
-## 🎨 Color Architecture: 6 Primary Colors Only
-
-### Why Only 6 Primary Hex Colors?
-
-1. **Dynamic Theming**: Users can customize theme colors in the frontend
-2. **Single Change = Entire System Updates**: Change one primary color → all shades/variants update automatically
-3. **Consistency**: Whole app looks designed by ONE person, not scattered/mismatched
-4. **Maintainability**: No hunting for hardcoded hex values scattered everywhere
-
-### The 6 Primary Color Tokens (ONLY THESE USE HEX)
-
-```css
-:root {
-  /* ===== THE ONLY 6 HEX VALUES IN THE ENTIRE SYSTEM ===== */
-  --color-primary: #2C7AA1;      /* Brand Blue - main CTA, links, primary actions */
-  --color-success: #2CA18E;      /* Success Green - confirmations, positive states */
-  --color-warning: #D9A12C;      /* Warning Amber - alerts, cautions */
-  --color-danger: #A12C40;       /* Danger Red - errors, destructive actions */
-  --color-purple: #2C40A1;       /* Purple - premium features, special emphasis */
-  --color-gray-base: #667085;    /* Gray Base - neutral text, borders, backgrounds */
-}
-```
-
-### ALL Other Colors MUST Derive From These 6
-
-```css
-/* ✅ CORRECT - Derived from primary tokens */
---color-primary-dark: color-mix(in srgb, var(--color-primary) 80%, black);
---color-primary-light: color-mix(in srgb, var(--color-primary) 60%, white);
---color-primary-subtle: color-mix(in srgb, var(--color-primary) 8%, white);
-
---color-brand-500: var(--color-primary);
---color-brand-600: color-mix(in srgb, var(--color-primary) 85%, black);
---color-brand-400: color-mix(in srgb, var(--color-primary) 75%, white);
-/* ... all shades computed from the primary */
-
-/* ❌ WRONG - Hardcoded hex for variants */
---color-primary-dark: #005A8C;  /* NO! Must derive from --color-primary */
---color-brand-600: #0369a1;     /* NO! Must use color-mix() */
-```
-
-### Color Derivation Rules
-
-| Shade | Derivation Formula |
-|-------|-------------------|
-| `*-25` | `color-mix(in srgb, var(--color-*) 3%, white)` |
-| `*-50` | `color-mix(in srgb, var(--color-*) 8%, white)` |
-| `*-100` | `color-mix(in srgb, var(--color-*) 15%, white)` |
-| `*-200` | `color-mix(in srgb, var(--color-*) 25%, white)` |
-| `*-300` | `color-mix(in srgb, var(--color-*) 40%, white)` |
-| `*-400` | `color-mix(in srgb, var(--color-*) 60%, white)` |
-| `*-500` | `var(--color-*)` (the primary itself) |
-| `*-600` | `color-mix(in srgb, var(--color-*) 85%, black)` |
-| `*-700` | `color-mix(in srgb, var(--color-*) 70%, black)` |
-| `*-800` | `color-mix(in srgb, var(--color-*) 55%, black)` |
-| `*-900` | `color-mix(in srgb, var(--color-*) 40%, black)` |
-| `*-950` | `color-mix(in srgb, var(--color-*) 25%, black)` |
-
-### Future Theming Support
-
-When user selects a theme, we only change these 6 values:
-```javascript
-// Theme switcher (future feature)
-document.documentElement.style.setProperty('--color-primary', '#NEW_HEX');
-document.documentElement.style.setProperty('--color-success', '#NEW_HEX');
-// ... and the ENTIRE app updates automatically!
-```
-
----
-
-## Phase 1: Audit Detection Scripts
-
-### 1.1 Run These Detection Commands
-
-```bash
-# Create audit results folder
-mkdir -p /data/app/igny8/frontend/audit-results
-
-# =====================================================
-# STYLE VIOLATIONS - Must be 0 after refactor
-# =====================================================
-
-# 1. ALL inline styles (style={{)
-grep -rn "style={{" src/pages/ src/components/ --include="*.tsx" > audit-results/01-inline-styles.txt
-echo "Inline styles found: $(wc -l < audit-results/01-inline-styles.txt)"
-
-# 2. ALL hardcoded hex colors in className (text-[#xxx], bg-[#xxx])
-grep -rn "\[#[0-9a-fA-F]\{3,6\}\]" src/pages/ src/components/ --include="*.tsx" > audit-results/02-hardcoded-hex-class.txt
-echo "Hardcoded hex in className: $(wc -l < audit-results/02-hardcoded-hex-class.txt)"
-
-# 3. ALL hardcoded hex colors anywhere (outside CSS)
-grep -rn "#[0-9a-fA-F]\{6\}" src/pages/ src/components/ --include="*.tsx" > audit-results/03-hardcoded-hex-all.txt
-echo "Hardcoded hex anywhere: $(wc -l < audit-results/03-hardcoded-hex-all.txt)"
-
-# 4. ALL rgb/rgba inline values
-grep -rn "rgba\?(" src/pages/ src/components/ --include="*.tsx" > audit-results/04-rgb-values.txt
-echo "RGB/RGBA values: $(wc -l < audit-results/04-rgb-values.txt)"
-
-# 5. TAILWIND DEFAULT COLORS (should NOT exist - we disabled them)
-grep -rn "bg-blue-\|text-blue-\|border-blue-\|bg-red-\|text-red-\|border-red-\|bg-green-\|text-green-\|border-green-\|bg-yellow-\|text-yellow-\|bg-emerald-\|text-emerald-\|bg-indigo-\|text-indigo-\|bg-pink-\|text-pink-\|bg-rose-\|text-rose-\|bg-amber-\|text-amber-\|bg-cyan-\|text-cyan-\|bg-teal-\|text-teal-\|bg-violet-\|text-violet-\|bg-fuchsia-\|text-fuchsia-\|bg-lime-\|text-lime-\|bg-orange-\|text-orange-\|bg-sky-\|text-sky-\|bg-slate-\|text-slate-\|bg-zinc-\|text-zinc-\|bg-neutral-\|text-neutral-\|bg-stone-\|text-stone-" src/pages/ src/components/ --include="*.tsx" > audit-results/05-tailwind-default-colors.txt
-echo "Tailwind default colors: $(wc -l < audit-results/05-tailwind-default-colors.txt)"
-
-# =====================================================
-# COMPONENT VIOLATIONS
-# =====================================================
-
-# 6. External UI library imports (MUI, Chakra, Ant, etc.)
-grep -rn "from '@mui\|from '@chakra\|from 'antd\|from '@headlessui\|from '@radix" src/pages/ src/components/ --include="*.tsx" > audit-results/06-external-ui-imports.txt
-echo "External UI imports: $(wc -l < audit-results/06-external-ui-imports.txt)"
-
-# 7. lucide-react imports (should use /icons/)
-grep -rn "from 'lucide-react" src/pages/ src/components/ --include="*.tsx" > audit-results/07-lucide-imports.txt
-echo "Lucide imports: $(wc -l < audit-results/07-lucide-imports.txt)"
-
-# 8. Inline component definitions (const ComponentName = () => { inside pages)
-grep -rn "const [A-Z][a-zA-Z]*\s*=\s*(" src/pages/ --include="*.tsx" > audit-results/08-inline-components.txt
-echo "Inline component definitions: $(wc -l < audit-results/08-inline-components.txt)"
-
-# 9. Raw HTML buttons (should use Button component)
-grep -rn "<button " src/pages/ --include="*.tsx" > audit-results/09-raw-buttons.txt
-echo "Raw HTML buttons: $(wc -l < audit-results/09-raw-buttons.txt)"
-
-# 10. Raw HTML selects (should use standard Select)
-grep -rn "<select " src/pages/ --include="*.tsx" > audit-results/10-raw-selects.txt
-echo "Raw HTML selects: $(wc -l < audit-results/10-raw-selects.txt)"
-
-# 11. Raw HTML inputs without standard classes
-grep -rn "<input " src/pages/ --include="*.tsx" > audit-results/11-raw-inputs.txt
-echo "Raw HTML inputs: $(wc -l < audit-results/11-raw-inputs.txt)"
-
-# =====================================================
-# SUMMARY
-# =====================================================
-echo ""
-echo "====== AUDIT SUMMARY ======"
-echo "Run these counts after refactoring - ALL should be 0:"
-echo "  01-inline-styles.txt"
-echo "  02-hardcoded-hex-class.txt"
-echo "  05-tailwind-default-colors.txt"
-echo "  06-external-ui-imports.txt"
-echo "  07-lucide-imports.txt"
-echo "  08-inline-components.txt (review - extract to /components/)"
-```
-
----
-
-## Phase 2: Color System Standardization
-
-### 2.1 The 6 Primary Color Tokens (ONLY HEX ALLOWED)
-
-| Token | Hex Value | Purpose |
-|-------|-----------|---------|
-| `--color-primary` | `#2C7AA1` | Brand/Primary actions, links, CTA |
-| `--color-success` | `#2CA18E` | Success states, confirmations |
-| `--color-warning` | `#D9A12C` | Warning states, alerts, cautions |
-| `--color-danger` | `#A12C40` | Error/Danger states, destructive |
-| `--color-purple` | `#2C40A1` | Premium/Special features |
-| `--color-gray-base` | `#667085` | Neutral base for grays |
-
-### 2.2 Allowed Color Classes (ALL derived from 6 primaries)
-
-| Color Category | Tailwind Classes | CSS Variable Base |
-|----------------|------------------|-------------------|
-| **Primary/Brand** | `brand-25` to `brand-950` | `--color-primary` |
-| **Gray/Neutral** | `gray-25` to `gray-950` | `--color-gray-base` |
-| **Success** | `success-25` to `success-950` | `--color-success` |
-| **Error** | `error-25` to `error-950` | `--color-danger` |
-| **Warning** | `warning-25` to `warning-950` | `--color-warning` |
-| **Purple** | `purple-25` to `purple-950` | `--color-purple` |
-
-### 2.3 BANNED - Hardcoded Hex Values
-
-**ZERO hardcoded hex values allowed in:**
-- TSX/JSX files
-- Component files
-- Page files
-- Inline styles
-
-**ONLY place hex values exist:** The 6 primary tokens in `design-system.css`
-
-### 2.4 BANNED - Tailwind Default Colors (DISABLED)
-
-These are explicitly disabled and should NEVER appear:
-
-```
-❌ blue-*, red-*, green-*, emerald-*, teal-*, cyan-*, sky-*
-❌ indigo-*, violet-*, fuchsia-*, pink-*, rose-*
-❌ amber-*, yellow-*, lime-*, orange-*
-❌ slate-*, zinc-*, neutral-*, stone-*
-```
-
-### 2.5 Color Replacement Map
-
-| ❌ Wrong | ✅ Correct |
-|----------|-----------|
-| `bg-blue-500`, `text-blue-500` | `bg-brand-500`, `text-brand-500` |
-| `bg-red-500`, `text-red-500` | `bg-error-500`, `text-error-500` |
-| `bg-green-500`, `text-green-500` | `bg-success-500`, `text-success-500` |
-| `bg-yellow-500`, `text-yellow-500` | `bg-warning-500`, `text-warning-500` |
-| `bg-indigo-500`, `text-indigo-500` | `bg-purple-500`, `text-purple-500` |
-| `#0693e3` (hardcoded) | `var(--color-primary)` or `text-brand-500` |
-| `#10B981` (hardcoded) | `var(--color-success)` or `text-success-500` |
-| `#EF4444` (hardcoded) | `var(--color-danger)` or `text-error-500` |
-| `style={{ color: '#xxx' }}` | Use CSS class from design system |
-| `bg-[#XXXXXX]` | Use design token class |
-
----
-
-## Phase 3: Component Extraction & Standardization
-
-### 3.1 Rules for Components
-
-1. **NO inline component definitions** in page files
-2. **Any component used in 2+ places** → Extract to `/components/`
-3. **All components** use ONLY CSS classes from `design-system.css`
-4. **No component-level inline styles**
-
-### 3.2 Standard Component Location
-
-| Component Type | Location | Notes |
-|----------------|----------|-------|
-| Buttons | `/components/ui/button/` | All button variants |
-| Modals/Dialogs | `/components/ui/modal/` | All popup overlays |
-| Alerts/Notifications | `/components/ui/alert/` | All status messages |
-| Badges/Tags | `/components/ui/badge/` | All labels/chips |
-| Dropdowns | `/components/ui/dropdown/` | All select menus |
-| Forms | `/components/ui/form/` | Inputs, selects, checkboxes |
-| Cards | `/components/ui/card/` | Card containers |
-| Tables | `/components/ui/table/` | Data tables |
-| Tabs | `/components/ui/tabs/` | Tab interfaces |
-| Spinners/Loading | `/components/ui/spinner/` | Loading states |
-| Tooltips | `/components/ui/tooltip/` | Hover info |
-| Progress | `/components/ui/progress/` | Progress bars |
-
-### 3.3 Inline Components to Extract
-
-Search pattern: `const [A-Z][a-zA-Z]* = (` in `/pages/`
-
-For each found:
-1. Check if similar exists in `/components/ui/`
-2. If used in multiple pages → Extract to appropriate folder
-3. If page-specific → Keep but move to bottom of file or separate file in same folder
-
----
-
-## Phase 4: Styling Classes Standardization
-
-### 4.1 Standard CSS Classes (from design-system.css)
-
-**Menu Items:**
-```css
-.menu-item           /* Base menu item */
-.menu-item-active    /* Active state */
-.menu-item-inactive  /* Inactive state */
-.menu-item-icon-size /* Icon sizing */
-```
-
-**Form Elements:**
-```css
-.igny8-select-styled  /* Styled select dropdown */
-.tableCheckbox        /* Table checkbox */
-```
-
-**Tables:**
-```css
-.igny8-table-compact      /* Compact table */
-.igny8-table-container    /* Table wrapper with min-height */
-.igny8-table-wrapper      /* Scrollable table wrapper */
-.igny8-table-smooth       /* Smooth transitions */
-.igny8-data-row           /* Animated data row */
-```
-
-**Header Metrics:**
-```css
-.igny8-header-metrics     /* Metrics bar container */
-.igny8-header-metric      /* Single metric */
-.igny8-header-metric-label
-.igny8-header-metric-value
-.igny8-header-metric-accent
-```
-
-### 4.2 Shadow Classes
-
-Use these instead of Tailwind defaults:
-```
-shadow-theme-xs, shadow-theme-sm, shadow-theme-md, shadow-theme-lg, shadow-theme-xl
-```
-
-### 4.3 Typography Classes
-
-```
-text-title-2xl, text-title-xl, text-title-lg, text-title-md, text-title-sm
-text-theme-xl, text-theme-sm, text-theme-xs
-```
-
----
-
-## Phase 5: Page-by-Page Audit Checklist
-
-### 5.1 Audit Order (by priority)
-
-| # | Module | Folder | Est. Files |
-|---|--------|--------|------------|
-| 1 | Account Settings | `pages/account/` | ~6 |
-| 2 | Site Settings | `pages/Settings/` | ~10 |
-| 3 | Sites Management | `pages/Sites/` | ~8 |
-| 4 | Writer | `pages/Writer/` | ~5 |
-| 5 | Planner | `pages/Planner/` | ~3 |
-| 6 | Automation | `pages/Automation/` | ~2 |
-| 7 | Optimizer | `pages/Optimizer/` | ~3 |
-| 8 | Billing | `pages/Billing/` | ~4 |
-| 9 | Dashboard | `pages/Dashboard/` | ~2 |
-| 10 | Other Pages | Remaining | ~10+ |
-
-### 5.2 Per-File Audit Checklist
-
-For EACH `.tsx` file:
-
-#### A. IMPORTS ✓
-- [ ] NO `@mui/*` imports
-- [ ] NO `lucide-react` imports (use `/icons/`)
-- [ ] NO `@chakra-ui`, `antd`, `@headlessui`, `@radix-ui`
-- [ ] All icons from `/icons/` folder
-- [ ] All UI components from `/components/ui/`
-
-#### B. COLORS ✓
-- [ ] NO Tailwind default colors (blue-*, red-*, green-*, etc.)
-- [ ] NO hardcoded hex (`#XXXXXX`)
-- [ ] NO hardcoded rgb/rgba
-- [ ] NO inline color styles (`style={{ color: '...' }}`)
-- [ ] ONLY uses: brand-*, gray-*, success-*, error-*, warning-*, purple-*
-
-#### C. STYLES ✓
-- [ ] NO `style={{` patterns
-- [ ] NO `sx={{` patterns
-- [ ] All styles via CSS classes from design-system.css
-- [ ] Dark mode handled via CSS variables (automatic)
-
-#### D. COMPONENTS ✓
-- [ ] NO inline component definitions (extract to /components/)
-- [ ] NO raw `<button>` elements (use Button component)
-- [ ] NO custom modal implementations (use Modal)
-- [ ] NO custom alert/toast (use Alert)
-- [ ] NO custom dropdown (use Dropdown)
-
-#### E. FORMS ✓
-- [ ] Inputs use standard pattern
-- [ ] Selects use `.igny8-select-styled` or standard Select component
-- [ ] Checkboxes use standard pattern
-- [ ] Form labels consistent
-
----
-
-## Phase 6: Execution Tracker
-
-### 6.1 Page Audit Progress
-
-| File | Audited | Issues | Fixed | Verified |
-|------|---------|--------|-------|----------|
-| **Account Module** |||||
-| `pages/account/Profile.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/account/Team.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/account/Security.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/account/Preferences.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/account/Notifications.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/account/ApiKeys.tsx` | ☐ | - | ☐ | ☐ |
-| **Settings Module** |||||
-| `pages/Settings/General.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/Integrations.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/Publishing.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/ContentDefaults.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/AIModels.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/ImageGeneration.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/SEO.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/Categories.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Settings/Tags.tsx` | ☐ | - | ☐ | ☐ |
-| **Sites Module** |||||
-| `pages/Sites/SitesList.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Sites/SiteDetail.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Sites/SiteSettings.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Sites/SiteDashboard.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Sites/CreateSite.tsx` | ☐ | - | ☐ | ☐ |
-| **Other Modules** |||||
-| `pages/Writer/*.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Planner/*.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Automation/*.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Optimizer/*.tsx` | ☐ | - | ☐ | ☐ |
-| `pages/Billing/*.tsx` | ☐ | - | ☐ | ☐ |
-
-### 6.2 Component Folder Audit
-
-| Folder | Audited | Issues | Fixed |
-|--------|---------|--------|-------|
-| `components/ui/button/` | ☐ | - | ☐ |
-| `components/ui/modal/` | ☐ | - | ☐ |
-| `components/ui/alert/` | ☐ | - | ☐ |
-| `components/ui/badge/` | ☐ | - | ☐ |
-| `components/ui/dropdown/` | ☐ | - | ☐ |
-| `components/ui/card/` | ☐ | - | ☐ |
-| `components/ui/table/` | ☐ | - | ☐ |
-| `components/ui/tabs/` | ☐ | - | ☐ |
-| `components/ui/form/` | ☐ | - | ☐ |
-| `components/common/` | ☐ | - | ☐ |
-| `components/layout/` | ☐ | - | ☐ |
-
----
-
-## Phase 7: Verification
-
-### 7.1 Zero-Tolerance Verification
-
-After refactoring, these commands should return **0 results**:
-
-```bash
-# 1. No Tailwind default colors
-grep -rn "bg-blue-\|text-blue-\|bg-red-\|text-red-\|bg-green-\|text-green-\|bg-yellow-\|text-yellow-\|bg-indigo-\|bg-emerald-\|bg-pink-\|bg-rose-" src/pages/ src/components/ --include="*.tsx" | wc -l
-
-# 2. No inline styles
-grep -rn "style={{" src/pages/ src/components/ --include="*.tsx" | wc -l
-
-# 3. No hardcoded hex in className
-grep -rn "\[#[0-9a-fA-F]\{3,6\}\]" src/pages/ src/components/ --include="*.tsx" | wc -l
-
-# 4. No external UI libraries
-grep -rn "from '@mui\|from '@chakra\|from 'antd" src/pages/ src/components/ --include="*.tsx" | wc -l
-
-# 5. No lucide-react direct imports
-grep -rn "from 'lucide-react" src/pages/ --include="*.tsx" | wc -l
-```
-
-### 7.2 Visual Verification
-
-- [ ] All pages render correctly (no broken styles)
-- [ ] Light mode works properly
-- [ ] Dark mode works properly (via `.dark` class)
-- [ ] All buttons consistent
-- [ ] All forms consistent
-- [ ] All tables consistent
-- [ ] All modals consistent
-- [ ] Brand colors appear correctly
-
----
-
-## 📋 Quick Reference: Correct Usage Patterns
-
-### Colors (ALL derived from 6 primaries)
-```tsx
-// ✅ CORRECT - use design token classes (derived from 6 primaries)
-className="text-brand-500 bg-brand-50 border-brand-200"
-className="text-success-500 bg-success-50"
-className="text-error-500 bg-error-50"
-className="text-warning-500 bg-warning-50"
-className="text-purple-500 bg-purple-50"
-className="text-gray-700 bg-gray-100"
-
-// ✅ CORRECT - use CSS variables when needed
-className="bg-[var(--color-primary)]"
-style={{ '--custom-color': 'var(--color-primary)' }} // Only for CSS custom properties
-
-// ❌ WRONG - Tailwind defaults (DISABLED)
-className="text-blue-500 bg-blue-50"
-className="text-red-500 bg-green-500"
-
-// ❌ WRONG - Hardcoded hex (NEVER in TSX)
-style={{ color: '#0693e3' }}
-className="bg-[#0077B6]"
-className="text-[#DC2626]"
-```
-
-### Components
-```tsx
-// ✅ CORRECT
-import { Button } from '@/components/ui/button/Button';
-import { Modal } from '@/components/ui/modal';
-import { CheckIcon } from '@/icons';
-
-<Button variant="primary" tone="brand">Save</Button>
-
-// ❌ WRONG
-import { Button } from '@mui/material';
-import { Check } from 'lucide-react';
-<button className="...">Save</button>
-```
-
-### Where Hex Values ARE Allowed
-
-```css
-/* ✅ ONLY in design-system.css - the 6 primary tokens */
-:root {
-  --color-primary: #2C7AA1;
-  --color-success: #2CA18E;
-  --color-warning: #D9A12C;
-  --color-danger: #A12C40;
-  --color-purple: #2C40A1;
-  --color-gray-base: #667085;
-}
-
-/* ✅ All other colors derived using color-mix() */
---color-primary-dark: color-mix(in srgb, var(--color-primary) 75%, black);
---color-brand-600: color-mix(in srgb, var(--color-primary) 85%, black);
---color-gray-700: color-mix(in srgb, var(--color-gray-base) 70%, black);
-```
-
----
-
-## 🚨 CRITICAL RULES
-
-1. **6 PRIMARY HEX ONLY**: Only `--color-primary`, `--color-success`, `--color-warning`, `--color-danger`, `--color-purple`, `--color-gray-base` use hex values (plus `#ffffff` for white)
-2. **ALL SHADES DERIVED**: Every shade (25-950) is computed from primary using `color-mix()`
-3. **NO TAILWIND DEFAULTS**: blue-*, red-*, green-*, etc. are DISABLED
-4. **NO INLINE STYLES**: Never use `style={{}}` for colors/spacing
-5. **NO HARDCODED HEX IN TSX**: All hex lives in design-system.css only
-6. **EXTRACT COMPONENTS**: Any UI used 2+ times → `/components/ui/`
-7. **USE STANDARD COMPONENTS**: Button, Modal, Alert, Badge from `/components/ui/`
-
----
-
-## 🎯 Design Consistency Goals
-
-### The "One Designer" Principle
-
-The entire application must look like it was designed and built by **ONE person**:
-
-| Aspect | Requirement |
-|--------|-------------|
-| **Colors** | Exact same 6 color palettes everywhere |
-| **Spacing** | Consistent padding/margins (use Tailwind spacing scale) |
-| **Typography** | Same font sizes, weights, line heights |
-| **Borders** | Same border radius, colors, widths |
-| **Shadows** | Same shadow tokens everywhere |
-| **Buttons** | All use `<Button>` component, same variants |
-| **Forms** | All inputs, selects, checkboxes styled identically |
-| **Cards** | Same card patterns, padding, borders |
-| **Tables** | Same table styles, row heights, headers |
-| **Modals** | Same modal structure, animations |
-
-### Visual Consistency Checklist
-
-- [ ] All primary buttons use `bg-brand-500`
-- [ ] All success messages use `success-*` palette
-- [ ] All error states use `error-*` palette
-- [ ] All warning states use `warning-*` palette
-- [ ] All premium/special features use `purple-*` palette
-- [ ] All neutral backgrounds use `gray-*` palette
-- [ ] Border radius consistent (use `--radius-*` tokens)
-- [ ] Shadows consistent (use `--shadow-*` tokens)
-- [ ] Typography consistent (use `text-theme-*` classes)
-
----
-
----
-
-## 🚨 CRITICAL ISSUES - Fix First
-
-### Issue 1: Missing Components After Changes
-
-**Problem**: Many pages have missing components after lucide-react → local icons migration
-
-**Affected Files** (from git diff):
-- `ImportExport.tsx` - Uses `Database`, `CheckCircle` etc. from lucide-react
-- `WordPressIntegrationDebug.tsx` - Uses `CheckCircle`, `XCircle`, `AlertTriangle`, etc.
-- `PostEditor.tsx` - Uses `SaveIcon`, `XIcon`, `FileTextIcon`, etc.
-- `NotificationsPage.tsx` - Uses `Bell`, `CheckCircle`, `AlertTriangle`, etc.
-- `AccountSettingsPage.tsx` - Uses `Save`, `Loader2`, `Settings`, etc.
-- `PlansAndBillingPage.tsx` - Uses `CreditCard`, `Package`, etc.
-- `ContentSettingsPage.tsx` - Uses `Save`, `Loader2`, `Image`, etc.
-- `UsageAnalyticsPage.tsx` - Uses `TrendingUp`, `Activity`, etc.
-- `PurchaseCreditsPage.tsx` - Uses `AlertCircle`, `Check`, etc.
-- Multiple components in `/components/sites/`, `/components/billing/`, `/components/auth/`
-
-**Fix**: Replace lucide-react imports with local `/icons/` imports. Add missing aliases to `/icons/index.ts`
-
-### Issue 2: Table Row Height Too Big (Planner & Writer)
-
-**Problem**: Planner and Writer table font sizes too big for some columns, increasing overall row height - tables not compact anymore
-
-**Root Cause**: Font size changes in CSS or component updates affecting table cell sizing
-
-**Fix Locations**:
-- `/src/styles/design-system.css` - `.igny8-table-compact td` rules
-- Planner and Writer table components - check for increased text sizes
-
-**Required Changes**:
-```css
-/* Ensure compact table styling */
-.igny8-table-compact td {
-  padding: 6px 10px !important;  /* Reduced from 8px 12px */
-  font-size: 13px !important;     /* Reduced from 14px */
-  line-height: 1.3 !important;    /* Tighter line height */
-}
-
-.igny8-table-compact th {
-  padding: 8px 12px !important;   /* Reduced from 12px 16px */
-  font-size: 12px !important;     /* Reduced from 14px */
-}
-```
-
----
-
-## Notes
-
-- Gray scale (`gray-25` to `gray-950`) is ALLOWED - derived from `--color-gray-base`
-- Dark mode is handled automatically via CSS variables in `.dark` class
-- When in doubt, check `design-system.css` for available classes
-- New utility classes should be added to `design-system.css`, not inline
-- **Future theming**: Changing 6 primary hex values updates entire app automatically
diff --git a/docs/plans/implemented/HIGH_OPPORTUNITY_KEYWORDS_ADD_KEYWORDS_PAGE.md b/docs/plans/implemented/HIGH_OPPORTUNITY_KEYWORDS_ADD_KEYWORDS_PAGE.md
deleted file mode 100644
index 85e97543..00000000
--- a/docs/plans/implemented/HIGH_OPPORTUNITY_KEYWORDS_ADD_KEYWORDS_PAGE.md
+++ /dev/null
@@ -1,672 +0,0 @@
-# High Opportunity Keywords for Add Keywords Page
-
-**Plan Date:** January 14, 2026  
-**Target Page:** `/setup/add-keywords` ([IndustriesSectorsKeywords.tsx](../../frontend/src/pages/Setup/IndustriesSectorsKeywords.tsx))  
-**Reference Implementation:** Step 4 of Wizard ([Step4AddKeywords.tsx](../../frontend/src/components/onboarding/steps/Step4AddKeywords.tsx))
-
-## Overview
-
-Add a "High Opportunity Keywords" section to the top of the `/setup/add-keywords` page, similar to the wizard's Step 4 interface. This will allow users to quickly add curated keyword sets (Top 50 High Volume & Top 50 Low Difficulty) for each of their site's sectors.
-
-## Current State
-
-### Current Page Structure
-- **Page:** `IndustriesSectorsKeywords.tsx` (854 lines)
-- **Route:** `/setup/add-keywords`
-- **Primary Function:** Browse and search global seed keywords with filters, sorting, and pagination
-- **Current Features:**
-  - Search by keyword text
-  - Filter by country, difficulty, status (not added only)
-  - Sort by keyword, volume, difficulty, country
-  - Bulk selection and "Add Selected to Workflow"
-  - Individual "Add to Workflow" buttons
-  - Shows stats: X added / Y available
-  - Admin CSV import functionality
-  - Table-based display with pagination
-  - Requires active sector selection to add keywords
-
-### Wizard Step 4 Implementation
-- **Component:** `Step4AddKeywords.tsx` (738 lines)
-- **Features to Replicate:**
-  - Groups keywords by sector (e.g., "Physiotherapy & Rehabilitation", "Relaxation Devices", "Massage & Therapy")
-  - Two options per sector:
-    - **Top 50 High Volume** - Keywords sorted by highest volume
-    - **Top 50 Low Difficulty** - Keywords sorted by lowest difficulty (KD)
-  - Shows keyword count and sample keywords (first 3 with "+X more" badge)
-  - "Add All" button for each option
-  - Visual feedback when keywords are added (success badge, green styling)
-  - Loads seed keywords from API filtered by sector
-
-## Proposed Implementation
-
-### UI Design & Layout
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ Page Header: "Find Keywords"                                     │
-└─────────────────────────────────────────────────────────────────┘
-┌─────────────────────────────────────────────────────────────────┐
-│ Back to options (link)                                           │
-│                                                                   │
-│ High Opportunity Keywords (h2)                                   │
-│ Add top keywords for each of your sectors. Keywords will be      │
-│ added to your planner workflow.                                  │
-│                                                                   │
-│ ┌─────────────┬─────────────┬─────────────┐                    │
-│ │ Sector 1    │ Sector 2    │ Sector 3    │ (3 columns)        │
-│ ├─────────────┼─────────────┼─────────────┤                    │
-│ │ ┌─────────┐ │ ┌─────────┐ │ ┌─────────┐ │                    │
-│ │ │Top 50 HV│ │ │Top 50 HV│ │ │Top 50 HV│ │                    │
-│ │ │X keywords│ │ │X keywords│ │ │X keywords│ │                    │
-│ │ │[kw] [kw]│ │ │[kw] [kw]│ │ │[kw] [kw]│ │                    │
-│ │ │+X more  │ │ │+X more  │ │ │+X more  │ │                    │
-│ │ │[Add All]│ │ │[Add All]│ │ │[Add All]│ │                    │
-│ │ └─────────┘ │ └─────────┘ │ └─────────┘ │                    │
-│ │ ┌─────────┐ │ ┌─────────┐ │ ┌─────────┐ │                    │
-│ │ │Top 50 LD│ │ │Top 50 LD│ │ │Top 50 LD│ │                    │
-│ │ │X keywords│ │ │X keywords│ │ │X keywords│ │                    │
-│ │ │[kw] [kw]│ │ │[kw] [kw]│ │ │[kw] [kw]│ │                    │
-│ │ │+X more  │ │ │+X more  │ │ │+X more  │ │                    │
-│ │ │[Add All]│ │ │[Add All]│ │ │[Add All]│ │                    │
-│ │ └─────────┘ │ └─────────┘ │ └─────────┘ │                    │
-│ └─────────────┴─────────────┴─────────────┘                    │
-│                                                                   │
-│ ✓ X keywords added to your workflow                              │
-└─────────────────────────────────────────────────────────────────┘
-┌─────────────────────────────────────────────────────────────────┐
-│ Browse All Keywords (existing table interface)                   │
-│ [Search] [Filters] [Table] [Pagination]                         │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Component Architecture
-
-#### 1. New State Management
-Add to `IndustriesSectorsKeywords.tsx`:
-
-```typescript
-// High Opportunity Keywords state
-const [showHighOpportunity, setShowHighOpportunity] = useState(true);
-const [loadingOpportunityKeywords, setLoadingOpportunityKeywords] = useState(false);
-const [sectorKeywordData, setSectorKeywordData] = useState<SectorKeywordData[]>([]);
-const [addingOption, setAddingOption] = useState<string | null>(null);
-
-interface SectorKeywordOption {
-  type: 'high-volume' | 'low-difficulty';
-  label: string;
-  keywords: SeedKeyword[];
-  added: boolean;
-  keywordCount: number;
-}
-
-interface SectorKeywordData {
-  sectorSlug: string;
-  sectorName: string;
-  sectorId: number;
-  options: SectorKeywordOption[];
-}
-```
-
-#### 2. Data Loading Function
-Create `loadHighOpportunityKeywords()`:
-
-```typescript
-const loadHighOpportunityKeywords = async () => {
-  if (!activeSite || !activeSite.industry) {
-    setSectorKeywordData([]);
-    return;
-  }
-
-  setLoadingOpportunityKeywords(true);
-
-  try {
-    // 1. Get site sectors
-    const siteSectors = await fetchSiteSectors(activeSite.id);
-    
-    // 2. Get industry data
-    const industriesResponse = await fetchIndustries();
-    const industry = industriesResponse.industries?.find(
-      i => i.id === activeSite.industry || i.slug === activeSite.industry_slug
-    );
-
-    if (!industry?.id) {
-      console.warn('Could not find industry information');
-      return;
-    }
-
-    // 3. Get already-attached keywords to mark as added
-    const attachedSeedKeywordIds = new Set<number>();
-    for (const sector of siteSectors) {
-      try {
-        const keywordsData = await fetchKeywords({
-          site_id: activeSite.id,
-          sector_id: sector.id,
-          page_size: 1000,
-        });
-        (keywordsData.results || []).forEach((k: any) => {
-          const seedKeywordId = k.seed_keyword_id || (k.seed_keyword && k.seed_keyword.id);
-          if (seedKeywordId) {
-            attachedSeedKeywordIds.add(Number(seedKeywordId));
-          }
-        });
-      } catch (err) {
-        console.warn(`Could not fetch attached keywords for sector ${sector.id}:`, err);
-      }
-    }
-
-    // 4. Build sector keyword data
-    const sectorData: SectorKeywordData[] = [];
-    
-    for (const siteSector of siteSectors) {
-      if (!siteSector.is_active) continue;
-
-      // Fetch all keywords for this sector
-      const response = await fetchSeedKeywords({
-        industry: industry.id,
-        sector: siteSector.industry_sector,
-        page_size: 500,
-      });
-
-      const sectorKeywords = response.results;
-
-      // Top 50 by highest volume
-      const highVolumeKeywords = [...sectorKeywords]
-        .sort((a, b) => (b.volume || 0) - (a.volume || 0))
-        .slice(0, 50);
-
-      // Top 50 by lowest difficulty
-      const lowDifficultyKeywords = [...sectorKeywords]
-        .sort((a, b) => (a.difficulty || 100) - (b.difficulty || 100))
-        .slice(0, 50);
-
-      // Check if all keywords in each option are already added
-      const hvAdded = highVolumeKeywords.every(kw => 
-        attachedSeedKeywordIds.has(Number(kw.id))
-      );
-      const ldAdded = lowDifficultyKeywords.every(kw => 
-        attachedSeedKeywordIds.has(Number(kw.id))
-      );
-
-      sectorData.push({
-        sectorSlug: siteSector.slug,
-        sectorName: siteSector.name,
-        sectorId: siteSector.id,
-        options: [
-          {
-            type: 'high-volume',
-            label: 'Top 50 High Volume',
-            keywords: highVolumeKeywords,
-            added: hvAdded && highVolumeKeywords.length > 0,
-            keywordCount: highVolumeKeywords.length,
-          },
-          {
-            type: 'low-difficulty',
-            label: 'Top 50 Low Difficulty',
-            keywords: lowDifficultyKeywords,
-            added: ldAdded && lowDifficultyKeywords.length > 0,
-            keywordCount: lowDifficultyKeywords.length,
-          },
-        ],
-      });
-    }
-
-    setSectorKeywordData(sectorData);
-  } catch (error: any) {
-    console.error('Failed to load high opportunity keywords:', error);
-    toast.error(`Failed to load high opportunity keywords: ${error.message}`);
-  } finally {
-    setLoadingOpportunityKeywords(false);
-  }
-};
-```
-
-#### 3. Add Keywords Function
-Create `handleAddSectorKeywords()`:
-
-```typescript
-const handleAddSectorKeywords = async (
-  sectorSlug: string,
-  optionType: 'high-volume' | 'low-difficulty'
-) => {
-  const sector = sectorKeywordData.find(s => s.sectorSlug === sectorSlug);
-  if (!sector || !activeSite) return;
-
-  const option = sector.options.find(o => o.type === optionType);
-  if (!option || option.added || option.keywords.length === 0) return;
-
-  const addingKey = `${sectorSlug}-${optionType}`;
-  setAddingOption(addingKey);
-
-  try {
-    const seedKeywordIds = option.keywords.map(kw => kw.id);
-
-    const result = await addSeedKeywordsToWorkflow(
-      seedKeywordIds,
-      activeSite.id,
-      sector.sectorId
-    );
-
-    if (result.success && result.created > 0) {
-      // Mark option as added
-      setSectorKeywordData(prev =>
-        prev.map(s =>
-          s.sectorSlug === sectorSlug
-            ? {
-                ...s,
-                options: s.options.map(o =>
-                  o.type === optionType ? { ...o, added: true } : o
-                ),
-              }
-            : s
-        )
-      );
-
-      let message = `Added ${result.created} keywords to ${sector.sectorName}`;
-      if (result.skipped && result.skipped > 0) {
-        message += ` (${result.skipped} already exist)`;
-      }
-      toast.success(message);
-
-      // Reload the main table to reflect changes
-      loadSeedKeywords();
-    } else if (result.errors && result.errors.length > 0) {
-      toast.error(result.errors[0]);
-    } else {
-      toast.warning('No keywords were added. They may already exist in your workflow.');
-    }
-  } catch (err: any) {
-    toast.error(err.message || 'Failed to add keywords to workflow');
-  } finally {
-    setAddingOption(null);
-  }
-};
-```
-
-#### 4. UI Component
-Create `HighOpportunityKeywordsSection` component within the file:
-
-```typescript
-const HighOpportunityKeywordsSection = () => {
-  if (!showHighOpportunity) return null;
-  if (!activeSite || sectorKeywordData.length === 0) return null;
-
-  const addedCount = sectorKeywordData.reduce(
-    (acc, s) =>
-      acc +
-      s.options
-        .filter(o => o.added)
-        .reduce((sum, o) => sum + o.keywordCount, 0),
-    0
-  );
-
-  return (
-    <div className="mx-6 mt-6 mb-6 p-6 bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700">
-      {/* Header */}
-      <div className="mb-6">
-        <div className="flex items-center justify-between mb-2">
-          <h2 className="text-xl font-bold text-gray-900 dark:text-white">
-            High Opportunity Keywords
-          </h2>
-          <button
-            onClick={() => setShowHighOpportunity(false)}
-            className="text-sm text-gray-500 hover:text-gray-700 dark:hover:text-gray-300"
-          >
-            Hide
-          </button>
-        </div>
-        <p className="text-sm text-gray-600 dark:text-gray-400">
-          Add top keywords for each of your sectors. Keywords will be added to your planner workflow.
-        </p>
-      </div>
-
-      {/* Loading State */}
-      {loadingOpportunityKeywords ? (
-        <div className="flex items-center justify-center py-12">
-          <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-brand-500" />
-        </div>
-      ) : (
-        <>
-          {/* Sector Grid */}
-          <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6 mb-6 items-start">
-            {sectorKeywordData.map((sector) => (
-              <div key={sector.sectorSlug} className="flex flex-col gap-3">
-                {/* Sector Name */}
-                <h4 className="text-base font-semibold text-gray-900 dark:text-white border-b border-gray-200 dark:border-gray-700 pb-2">
-                  {sector.sectorName}
-                </h4>
-
-                {/* Options Cards */}
-                {sector.options.map((option) => {
-                  const addingKey = `${sector.sectorSlug}-${option.type}`;
-                  const isAdding = addingOption === addingKey;
-
-                  return (
-                    <Card
-                      key={option.type}
-                      className={`p-4 transition-all flex flex-col ${
-                        option.added
-                          ? 'border-success-300 dark:border-success-700 bg-success-50 dark:bg-success-900/20'
-                          : 'hover:border-brand-300 dark:hover:border-brand-700'
-                      }`}
-                    >
-                      {/* Option Header */}
-                      <div className="flex items-center justify-between mb-3">
-                        <div>
-                          <h5 className="text-sm font-medium text-gray-900 dark:text-white">
-                            {option.label}
-                          </h5>
-                          <p className="text-xs text-gray-500 dark:text-gray-400">
-                            {option.keywordCount} keywords
-                          </p>
-                        </div>
-                        {option.added ? (
-                          <Badge tone="success" variant="soft" size="sm">
-                            <CheckCircleIcon className="w-3 h-3 mr-1" />
-                            Added
-                          </Badge>
-                        ) : (
-                          <Button
-                            variant="primary"
-                            size="xs"
-                            onClick={() =>
-                              handleAddSectorKeywords(sector.sectorSlug, option.type)
-                            }
-                            disabled={isAdding || !activeSector}
-                            title={
-                              !activeSector
-                                ? 'Please select a sector from the sidebar first'
-                                : ''
-                            }
-                          >
-                            {isAdding ? 'Adding...' : 'Add All'}
-                          </Button>
-                        )}
-                      </div>
-
-                      {/* Sample Keywords */}
-                      <div className="flex flex-wrap gap-1.5 flex-1">
-                        {option.keywords.slice(0, 3).map((kw) => (
-                          <Badge
-                            key={kw.id}
-                            tone={option.added ? 'success' : 'neutral'}
-                            variant="soft"
-                            size="xs"
-                            className="text-xs"
-                          >
-                            {kw.keyword}
-                          </Badge>
-                        ))}
-                        {option.keywordCount > 3 && (
-                          <Badge
-                            tone="neutral"
-                            variant="outline"
-                            size="xs"
-                            className="text-xs"
-                          >
-                            +{option.keywordCount - 3} more
-                          </Badge>
-                        )}
-                      </div>
-                    </Card>
-                  );
-                })}
-              </div>
-            ))}
-          </div>
-
-          {/* Success Summary */}
-          {addedCount > 0 && (
-            <Card className="p-4 bg-success-50 dark:bg-success-900/20 border-success-200 dark:border-success-800">
-              <div className="flex items-center gap-3">
-                <CheckCircleIcon className="w-5 h-5 text-success-600 dark:text-success-400" />
-                <span className="text-sm text-success-700 dark:text-success-300">
-                  {addedCount} keywords added to your workflow
-                </span>
-              </div>
-            </Card>
-          )}
-        </>
-      )}
-    </div>
-  );
-};
-```
-
-#### 5. Integration Points
-
-**In `IndustriesSectorsKeywords.tsx`:**
-
-1. **Add imports:**
-   ```typescript
-   import { CheckCircleIcon } from '../../icons';
-   import { fetchIndustries, fetchKeywords } from '../../services/api';
-   ```
-
-2. **Add state variables** (see #1 above)
-
-3. **Add useEffect to load opportunity keywords:**
-   ```typescript
-   useEffect(() => {
-     if (activeSite && activeSite.id && showHighOpportunity) {
-       loadHighOpportunityKeywords();
-     }
-   }, [activeSite?.id, showHighOpportunity]);
-   ```
-
-4. **Insert component before TablePageTemplate:**
-   ```tsx
-   return (
-     <>
-       <PageMeta ... />
-       <PageHeader ... />
-       
-       {/* High Opportunity Keywords Section */}
-       <HighOpportunityKeywordsSection />
-       
-       {/* Existing sector banner */}
-       {!activeSector && activeSite && ( ... )}
-       
-       <TablePageTemplate ... />
-       
-       {/* Import Modal */}
-       <Modal ... />
-     </>
-   );
-   ```
-
-### Visual Design Details
-
-#### Colors & Styling
-- **Card default:** White bg, gray-200 border, hover: brand-300 border
-- **Card added:** success-50 bg, success-300 border, success badge
-- **Button:** Primary variant, size xs for cards
-- **Badges:** xs size for keywords, soft variant
-- **Grid:** 1 column on mobile, 2 on md, 3 on lg
-
-#### Responsive Behavior
-- **Mobile (< 768px):** Single column, sectors stack vertically
-- **Tablet (768px - 1024px):** 2 columns
-- **Desktop (> 1024px):** 3 columns
-
-#### User Interactions
-1. **"Add All" button:**
-   - Disabled during adding (shows "Adding...")
-   - Disabled if no sector selected (with tooltip)
-   - Disappears after successful add (replaced with "Added" badge)
-
-2. **Success feedback:**
-   - Toast notification with count
-   - Green success card appears at bottom when any keywords added
-   - Card styling changes to success state
-   - Badge changes to success badge with checkmark
-
-3. **Hide/Show:**
-   - "Hide" button in header to collapse section
-   - Could add "Show High Opportunity Keywords" link when hidden
-
-### Error Handling
-
-1. **No active site:**
-   - Don't render the section
-   - Show existing WorkflowGuide
-
-2. **No sectors:**
-   - Don't render the section
-   - Show existing sector selection banner
-
-3. **API failures:**
-   - Show toast error
-   - Log to console
-   - Don't crash the page
-
-4. **No keywords found:**
-   - Show empty state or hide section
-   - Log warning to console
-
-### Performance Considerations
-
-1. **Lazy loading:**
-   - Only load opportunity keywords when section is visible
-   - Use `showHighOpportunity` state flag
-
-2. **Caching:**
-   - Store loaded keyword data in state
-   - Only reload on site/sector change
-
-3. **Batch API calls:**
-   - Load all sector keywords in parallel if possible
-   - Use Promise.all() for concurrent requests
-
-4. **Pagination:**
-   - Fetch 500 keywords max per sector
-   - This should cover top 50 for both options with margin
-
-### Testing Scenarios
-
-1. **Happy path:**
-   - User has active site with 3 sectors
-   - Each sector has 50+ keywords
-   - Click "Add All" on each option
-   - Verify keywords added to workflow
-   - Verify success feedback shown
-
-2. **Edge cases:**
-   - No active site: Section hidden
-   - No sectors: Section hidden
-   - No keywords for sector: Empty cards
-   - Already added keywords: Show "Added" badge
-   - API failure: Show error toast
-
-3. **Interaction:**
-   - Add from high opportunity section
-   - Verify table below refreshes
-   - Verify count updates in header
-   - Verify keywords marked as "Added" in table
-
-4. **Responsive:**
-   - Test on mobile, tablet, desktop
-   - Verify grid layout adapts
-   - Verify cards are readable
-
-## Implementation Steps
-
-### Phase 1: Core Functionality (Day 1)
-1. ✅ Create plan document (this file)
-2. Add state management and types
-3. Implement `loadHighOpportunityKeywords()` function
-4. Implement `handleAddSectorKeywords()` function
-5. Test data loading and API integration
-
-### Phase 2: UI Components (Day 1-2)
-6. Create `HighOpportunityKeywordsSection` component
-7. Build sector cards with options
-8. Add loading states
-9. Add success states and feedback
-10. Style according to design system
-
-### Phase 3: Integration (Day 2)
-11. Integrate with existing page
-12. Connect to existing state (activeSite, activeSector)
-13. Ensure table refreshes after keywords added
-14. Test hide/show functionality
-
-### Phase 4: Polish & Testing (Day 2-3)
-15. Add responsive styles
-16. Test on different screen sizes
-17. Handle edge cases and errors
-18. Add tooltips and help text
-19. Performance optimization
-20. Code review and cleanup
-
-## Dependencies
-
-- ✅ Existing API functions in `services/api.ts`
-- ✅ `fetchSeedKeywords()` - Fetch seed keywords
-- ✅ `fetchSiteSectors()` - Get sectors for site
-- ✅ `fetchIndustries()` - Get industry data
-- ✅ `fetchKeywords()` - Check already-attached keywords
-- ✅ `addSeedKeywordsToWorkflow()` - Bulk add keywords
-
-- ✅ Existing components
-- ✅ `Card` component
-- ✅ `Badge` component  
-- ✅ `Button` component
-- ✅ `CheckCircleIcon` icon
-
-## Success Criteria
-
-1. **Functional:**
-   - [ ] High opportunity keywords section displays at top of page
-   - [ ] Shows sectors with 2 options each (High Volume, Low Difficulty)
-   - [ ] "Add All" button adds keywords to workflow successfully
-   - [ ] Success feedback shown after adding
-   - [ ] Main table refreshes to show added keywords
-   - [ ] Hide/show functionality works
-
-2. **Visual:**
-   - [ ] Matches wizard step 4 design
-   - [ ] Responsive on all screen sizes
-   - [ ] Success states clearly visible
-   - [ ] Loading states smooth
-
-3. **UX:**
-   - [ ] Fast loading (< 2 seconds)
-   - [ ] Clear feedback on actions
-   - [ ] Tooltips help users understand
-   - [ ] Graceful error handling
-   - [ ] No blocking errors
-
-## Future Enhancements
-
-1. **Expand/collapse sectors:** Allow users to collapse individual sectors
-2. **Keyword preview modal:** Click on "+X more" to see full list
-3. **Custom keyword counts:** Let users choose how many keywords to add (25, 50, 100)
-4. **Filter by metrics:** Show only keywords above certain volume/below certain difficulty
-5. **Save preferences:** Remember hidden/shown state
-6. **Analytics:** Track which options users add most frequently
-7. **Smart recommendations:** Suggest sectors based on site content
-8. **Batch operations:** "Add all high volume" button to add from all sectors at once
-
-## Notes
-
-- This feature improves onboarding by bringing wizard functionality into the main app
-- Users can quickly populate their workflow without searching/filtering
-- Reduces friction for new users who don't know which keywords to target
-- Leverages existing curated seed keyword database
-- No new API endpoints required - uses existing bulk add functionality
-
-## Related Files
-
-**Frontend:**
-- `/frontend/src/pages/Setup/IndustriesSectorsKeywords.tsx` - Target file for implementation
-- `/frontend/src/components/onboarding/steps/Step4AddKeywords.tsx` - Reference implementation
-- `/frontend/src/services/api.ts` - API functions
-
-**Backend:**
-- `/backend/igny8_core/api/views/keywords.py` - Keywords API
-- `/backend/igny8_core/api/views/seed_keywords.py` - Seed keywords API
-- `/backend/igny8_core/business/seed_keywords.py` - Bulk add logic
-
-**Docs:**
-- `/docs/40-WORKFLOWS/ADD_KEYWORDS.md` - Add keywords workflow documentation
-- `/docs/10-MODULES/PLANNER.md` - Planner module documentation
diff --git a/docs/plans/implemented/IMAGE-GENERATION-GAPS.md b/docs/plans/implemented/IMAGE-GENERATION-GAPS.md
deleted file mode 100644
index 27be4b5a..00000000
--- a/docs/plans/implemented/IMAGE-GENERATION-GAPS.md
+++ /dev/null
@@ -1,373 +0,0 @@
-# Image Generation System - Comprehensive Gap Analysis
-
-**Date:** January 2026  
-**Status:** Audit Complete  
-**Reviewer:** System Audit
-
-## Executive Summary
-
-This document provides a comprehensive audit of the image generation system, analyzing the flow from model configuration to image delivery, both for manual and automation workflows.
-
----
-
-## 1. System Architecture Overview
-
-### Current Flow
-```
-User Selects Quality Tier (basic/quality/quality_option2/premium)
-        ↓
-AIModelConfig (database) → provider, model_name, landscape_size, square_size
-        ↓
-process_image_generation_queue (Celery task)
-        ↓
-ai_core.generate_image() → provider-specific handler
-        ↓
-_generate_image_openai() / _generate_image_runware()
-        ↓
-Downloaded to /frontend/public/images/ai-images/
-        ↓
-Image record updated (Images model)
-```
-
-### Image Count Determination
-```
-User sets max_images (1-8) in Site Settings
-        ↓
-AISettings.get_effective_max_images(account)
-        ↓
-generate_image_prompts.py: 1 featured + max_images in_article
-        ↓
-Images created with positions: featured(0) + in_article(0,1,2,3...)
-```
-
----
-
-## 2. RESOLVED Issues (Previously Fixed)
-
-### ✅ 2.1 Quality Tier Fallback
-- **Issue:** `get_effective_quality_tier()` was returning hardcoded 'basic' instead of default model's tier
-- **Fixed in:** `ai_settings.py` lines 196-232
-- **Solution:** Now falls back to `AIModelConfig.is_default=True` model's `quality_tier`
-
-### ✅ 2.2 Image Sizes from Database
-- **Issue:** `tasks.py` had hardcoded `MODEL_LANDSCAPE_SIZES` dict
-- **Fixed in:** `tasks.py` lines 242-260
-- **Solution:** Now loads `landscape_size` and `square_size` from `AIModelConfig`
-
-### ✅ 2.3 Settings Endpoint Default Tier
-- **Issue:** `settings_views.py` returned hardcoded 'basic' as default tier
-- **Fixed in:** `settings_views.py` lines 616-640
-- **Solution:** Gets `default_tier` from `default_image_model.quality_tier`
-
-### ✅ 2.4 Integration Views Dynamic Sizes
-- **Issue:** Two endpoints in `integration_views.py` had hardcoded size lookup
-- **Fixed:** Both endpoints now load from `AIModelConfig`
-
----
-
-## 3. REMAINING Gaps (Action Required)
-
-### 🔴 GAP-1: Hardcoded Size Constants in global_settings_models.py
-
-**Location:** `backend/igny8_core/modules/system/global_settings_models.py` lines 180-188
-
-**Code:**
-```python
-# Model-specific landscape sizes (square is always 1024x1024 for all models)
-MODEL_LANDSCAPE_SIZES = {
-    'runware:97@1': '1280x768',   # Hi Dream Full landscape
-    'bria:10@1': '1344x768',       # Bria 3.2 landscape (16:9)
-    'google:4@2': '1376x768',      # Nano Banana landscape (16:9)
-}
-
-# Default square size (universal across all models)
-DEFAULT_SQUARE_SIZE = '1024x1024'
-```
-
-**Impact:** These constants are UNUSED but could cause confusion. They're legacy from before the AIModelConfig migration.
-
-**Recommendation:** 
-- [ ] Remove unused `MODEL_LANDSCAPE_SIZES` dict
-- [ ] Remove unused `DEFAULT_SQUARE_SIZE` constant
-- [ ] Add deprecation comment if keeping for reference
-
----
-
-### 🔴 GAP-2: Hardcoded Size Fallbacks in Tasks
-
-**Location:** `backend/igny8_core/ai/tasks.py` lines 254-260
-
-**Code:**
-```python
-else:
-    # Fallback sizes if no model config (should never happen)
-    model_landscape_size = '1792x1024'
-    model_square_size = '1024x1024'
-    logger.warning(f"[process_image_generation_queue] No model config, using fallback sizes")
-```
-
-**Impact:** LOW - Fallback only triggers if database is misconfigured. But the hardcoded sizes may not match actual model requirements.
-
-**Recommendation:**
-- [ ] Consider failing gracefully with clear error instead of using fallback
-- [ ] Or: Load fallback from a system default in database
-
----
-
-### 🔴 GAP-3: Frontend VALID_SIZES_BY_MODEL Hardcoded
-
-**Location:** `frontend/src/components/common/ImageGenerationCard.tsx` lines 52-55
-
-**Code:**
-```tsx
-const VALID_SIZES_BY_MODEL: Record<string, string[]> = {
-  'dall-e-3': ['1024x1024', '1024x1792', '1792x1024'],
-  'dall-e-2': ['256x256', '512x512', '1024x1024'],
-};
-```
-
-**Impact:** MEDIUM - Test image generation card only shows OpenAI sizes, not Runware/Bytedance sizes.
-
-**Recommendation:**
-- [ ] Fetch valid_sizes from AIModelConfig via API
-- [ ] Or: Pass sizes from backend settings endpoint
-
----
-
-### 🔴 GAP-4: Backend VALID_SIZES_BY_MODEL Hardcoded
-
-**Location:** `backend/igny8_core/ai/constants.py` lines 40-43
-
-**Code:**
-```python
-VALID_SIZES_BY_MODEL = {
-    'dall-e-3': ['1024x1024', '1024x1792', '1792x1024'],
-    'dall-e-2': ['256x256', '512x512', '1024x1024'],
-}
-```
-
-**Impact:** MEDIUM - Used for OpenAI validation only. Runware models bypass this validation.
-
-**Status:** PARTIAL - Only affects OpenAI validation. Runware has its own validation via provider-specific code.
-
-**Recommendation:**
-- [ ] Move validation to AIModelConfig.valid_sizes field
-- [ ] Validate against model's valid_sizes from database
-
----
-
-### 🔴 GAP-5: Missing Runware Model Size Validation
-
-**Location:** `backend/igny8_core/ai/ai_core.py` lines 943-1050
-
-**Code:** The `_generate_image_runware()` method does NOT validate sizes against `valid_sizes` from database.
-
-**Impact:** LOW - Runware API will reject invalid sizes anyway, but error message won't be clear.
-
-**Recommendation:**
-- [ ] Add validation: check `size` against `AIModelConfig.valid_sizes` before API call
-- [ ] Return clear error: "Size X is not valid for model Y"
-
----
-
-### 🔴 GAP-6: Seedream Minimum Pixel Validation Hardcoded
-
-**Location:** `backend/igny8_core/ai/ai_core.py` lines 1018-1027
-
-**Code:**
-```python
-elif runware_model.startswith('bytedance:'):
-    # Enforce minimum size for Seedream (min 3,686,400 pixels ~ 1920x1920)
-    current_pixels = width * height
-    if current_pixels < 3686400:
-        # Use default Seedream square size
-        inference_task['width'] = 2048
-        inference_task['height'] = 2048
-```
-
-**Impact:** LOW - This hardcoded check works, but should come from database.
-
-**Recommendation:**
-- [ ] Add `min_pixels` field to AIModelConfig
-- [ ] Check model.min_pixels instead of hardcoded 3686400
-
----
-
-### 🔴 GAP-7: Provider-Specific Steps/CFGScale Hardcoded
-
-**Location:** `backend/igny8_core/ai/ai_core.py` lines 995-1040
-
-**Code:**
-```python
-if runware_model.startswith('bria:'):
-    inference_task['steps'] = 20
-    # ...
-elif runware_model.startswith('runware:'):
-    inference_task['steps'] = 20
-    inference_task['CFGScale'] = 7
-```
-
-**Impact:** LOW - Works correctly but adding new models requires code changes.
-
-**Recommendation:**
-- [ ] Add `generation_params` JSON field to AIModelConfig
-- [ ] Store steps, CFGScale, etc. in database per model
-
----
-
-### 🔴 GAP-8: Image Count Not Per-Content Configurable
-
-**Location:** System-wide setting only
-
-**Current Behavior:**
-- `max_images` is a global setting (site-wide)
-- All articles get the same number of in_article images
-
-**Impact:** MEDIUM - Users cannot set different image counts per article/keyword.
-
-**Recommendation:**
-- [ ] Add `images_count` field to Content model (nullable, inherits from site default)
-- [ ] Or: Add to Keywords model for keyword-level override
-
----
-
-### 🟡 GAP-9: Legacy generate_images.py Function (Partially Dead Code)
-
-**Location:** `backend/igny8_core/ai/functions/generate_images.py`
-
-**Issue:** `generate_images_core()` function exists but appears to be legacy. Main flow uses `process_image_generation_queue()` in tasks.py.
-
-**Impact:** LOW - Code duplication, potential maintenance burden.
-
-**Recommendation:**
-- [ ] Audit if `generate_images.py` is actually used anywhere
-- [ ] If not: Add deprecation warning or remove
-- [ ] If used: Ensure it uses same dynamic config loading
-
----
-
-### 🟡 GAP-10: No Validation of quality_tier Values
-
-**Location:** Multiple locations
-
-**Issue:** When user selects a quality_tier, there's no validation that:
-1. The tier exists in AIModelConfig
-2. The tier has an active model
-3. The user's plan allows that tier
-
-**Impact:** MEDIUM - Could lead to runtime errors if tier doesn't exist.
-
-**Recommendation:**
-- [ ] Add validation in settings save endpoint
-- [ ] Return error if selected tier has no active model
-
----
-
-## 4. Image Count Flow (Working Correctly)
-
-### How image count works:
-
-1. **User configures:**
-   - `max_images` (1-8) in Site Settings → saved to AccountSettings
-
-2. **Prompt generation:**
-   ```python
-   # generate_image_prompts.py
-   max_images = AISettings.get_effective_max_images(account)  # e.g., 4
-   # Creates: 1 featured + 4 in_article = 5 image prompts
-   ```
-
-3. **Image types:**
-   - `featured` - Always 1, position=0, landscape size
-   - `in_article` - Up to max_images, positions 0,1,2,3..., alternating square/landscape
-
-4. **Size determination:**
-   ```python
-   # tasks.py
-   if image.image_type == 'featured':
-       image_size = featured_image_size  # landscape
-   elif image.image_type == 'in_article':
-       position = image.position or 0
-       if position % 2 == 0:  # 0, 2
-           image_size = square_size
-       else:  # 1, 3
-           image_size = landscape_size
-   ```
-
-**STATUS:** ✅ Working correctly. No gaps identified in image count logic.
-
----
-
-## 5. Automation Flow (Working Correctly)
-
-### Stage 6: Image Generation
-
-**Location:** `automation_service.py` lines 1236-1400
-
-**Flow:**
-1. Query `Images.objects.filter(site=site, status='pending')`
-2. For each image: `process_image_generation_queue.delay(image_ids=[image.id], ...)`
-3. Monitor task completion
-4. Update run progress
-
-**STATUS:** ✅ Uses same task as manual generation. Consistent behavior.
-
----
-
-## 6. Model Provider Support Matrix
-
-| Provider | Models | Status | Gaps |
-|----------|--------|--------|------|
-| OpenAI | dall-e-3, dall-e-2 | ✅ Working | Valid sizes hardcoded |
-| Runware | runware:97@1 | ✅ Working | No size validation |
-| Runware | bria:10@1 | ✅ Working | Steps hardcoded |
-| Runware | google:4@2 | ✅ Working | Resolution param hardcoded |
-| Runware | bytedance:seedream@4.5 | ✅ Working | Min pixels hardcoded |
-
----
-
-## 7. Priority Action Items
-
-### High Priority
-1. **GAP-4/5:** Implement database-driven size validation for all providers
-2. **GAP-10:** Add quality_tier validation on save
-
-### Medium Priority
-3. **GAP-6/7:** Move provider-specific params to AIModelConfig.generation_params
-4. **GAP-8:** Consider per-content image count override
-
-### Low Priority
-5. **GAP-1:** Clean up unused constants
-6. **GAP-9:** Audit and deprecate legacy code
-7. **GAP-3:** Fetch valid sizes from API in frontend
-
----
-
-## 8. Recommendations Summary
-
-### Short-term (Before Launch)
-- Ensure all hardcoded fallbacks are clearly logged
-- Test each model tier end-to-end
-
-### Medium-term (Post-Launch)
-- Migrate all hardcoded params to AIModelConfig fields
-- Add model validation on quality_tier save
-
-### Long-term (Future Enhancement)
-- Per-content image count override
-- Per-keyword image style override
-- Image regeneration without deleting existing
-
----
-
-## Appendix: Key Files Reference
-
-| File | Purpose |
-|------|---------|
-| `ai/tasks.py` | Main image generation Celery task |
-| `ai/ai_core.py` | Provider-specific generation methods |
-| `ai/functions/generate_image_prompts.py` | Extract prompts from content |
-| `modules/system/ai_settings.py` | System defaults + account overrides |
-| `modules/system/settings_views.py` | Frontend settings API |
-| `business/billing/models.py` | AIModelConfig model |
-| `business/automation/services/automation_service.py` | Automation Stage 6 |
diff --git a/docs/plans/implemented/IMPLEMENTATION-SUMMARY.md b/docs/plans/implemented/IMPLEMENTATION-SUMMARY.md
deleted file mode 100644
index b890a789..00000000
--- a/docs/plans/implemented/IMPLEMENTATION-SUMMARY.md
+++ /dev/null
@@ -1,274 +0,0 @@
-# Credits & Limits Implementation - Quick Summary
-
-**Status:** 🚧 READY TO IMPLEMENT  
-**Timeline:** 5 weeks  
-**Priority:** HIGH
-
----
-
-## The Big Picture
-
-### What We're Doing
-Simplifying the IGNY8 credits and limits system from complex (10+ limits) to simple (4 limits only).
-
-### Core Philosophy
-**Keep only 4 hard limits. Everything else = credits.**
-
----
-
-## The 4 Limits (FINAL)
-
-| Limit | Type | What It Controls |
-|-------|------|-----------------|
-| **Sites** | Hard | Max sites per account (e.g., 1, 2, 5, unlimited) |
-| **Team Users** | Hard | Max team members (e.g., 1, 2, 3, 5) |
-| **Keywords** | Hard | Total keywords in workspace (e.g., 100, 1K, 5K, 20K) |
-| **Ahrefs Queries** | Monthly | Live keyword research per month (e.g., 0, 50, 200, 500) |
-
-**Everything else (content, images, ideas, etc.) = credits only.**
-
----
-
-## What Gets REMOVED
-
-### Database Fields to Delete
-
-**From Plan Model:**
-- ❌ `max_content_ideas`
-- ❌ `max_content_words`
-- ❌ `max_images_basic`
-- ❌ `max_images_premium`
-- ❌ `max_image_prompts`
-- ❌ `max_clusters` (consider merging with keywords)
-
-**From Account Model:**
-- ❌ `usage_content_ideas`
-- ❌ `usage_content_words`
-- ❌ `usage_images_basic`
-- ❌ `usage_images_premium`
-- ❌ `usage_image_prompts`
-
-### Why?
-- Confusing for users (double limiting)
-- Maintenance overhead
-- Credit system already provides control
-
----
-
-## What Gets ADDED
-
-### New Fields
-
-**Plan Model:**
-```python
-max_ahrefs_queries = models.IntegerField(default=50)
-```
-
-**Account Model:**
-```python
-usage_ahrefs_queries = models.IntegerField(default=0)
-```
-
-### New Feature: Keyword Research
-
-**Two ways to add keywords:**
-
-1. **Browse Pre-Researched Keywords** (FREE)
-   - IGNY8's global keyword database
-   - Pre-analyzed, ready to use
-   - Limited by: `max_keywords` (workspace limit)
-
-2. **Research with Ahrefs** (LIMITED)
-   - Live Ahrefs API queries
-   - Fresh, custom keyword data
-   - Limited by: `max_ahrefs_queries` (monthly limit)
-
----
-
-## Page Changes
-
-### Plans & Billing Page (Simplified)
-
-**Current Plan Tab - BEFORE:**
-- ❌ Credit balance display
-- ❌ Usage charts
-- ❌ Limit progress bars
-- ❌ "Credits used this month" breakdown
-
-**Current Plan Tab - AFTER:**
-- ✅ Plan name, price, renewal date
-- ✅ Brief summary: "50 articles • 2 sites • 2 users"
-- ✅ Upgrade CTA
-- ❌ NO detailed usage (moved to Usage page)
-
-### Usage Page (Enhanced)
-
-**NEW Tab Structure:**
-
-1. **Overview** (NEW)
-   - Quick stats cards (credits, sites, users, keywords)
-   - Period selector (7, 30, 90 days)
-   - Top metrics
-
-2. **Your Limits**
-   - Only 4 limits with progress bars
-   - Sites, Users, Keywords, Ahrefs Queries
-
-3. **Credit Insights** (NEW)
-   - Credits by Site
-   - Credits by Action Type
-   - Credits by Image Quality (basic/quality/premium)
-   - Credits by Automation
-   - Timeline chart
-
-4. **Activity Log**
-   - Detailed transaction history
-   - (Renamed from "API Activity")
-
----
-
-## Key Implementation Tasks
-
-### Backend (Week 1-2)
-
-1. **Remove unused fields**
-   - Create migration to drop fields
-   - Update models, serializers
-   - Remove from LimitService mappings
-
-2. **Add Ahrefs fields**
-   - Add to Plan and Account models
-   - Add to LimitService mappings
-   - Create Ahrefs service
-
-3. **Enforce limits properly**
-   - Add keyword limit checks to ALL entry points
-   - Add automation credit pre-check
-   - Validate before all operations
-
-### Frontend (Week 2-3)
-
-1. **Clean up Plans & Billing**
-   - Remove duplicate credit/usage data
-   - Keep only financial info
-
-2. **Enhance Usage page**
-   - Add Overview tab
-   - Add Credit Insights tab with widgets
-   - Multi-dimensional breakdowns
-
-3. **Build Keyword Research**
-   - Browse panel (existing SeedKeywords)
-   - Ahrefs panel (new)
-   - Query limit indicator
-
-4. **Update terminology**
-   - Remove "API", "operations"
-   - Use "actions", "activities"
-
----
-
-## Validation Requirements
-
-### Must Check BEFORE Every Operation
-
-**All AI Operations:**
-```python
-# 1. Check credits
-CreditService.check_credits(account, estimated_credits)
-
-# 2. Execute
-result = ai_service.execute()
-
-# 3. Deduct
-CreditService.deduct_credits_for_operation(...)
-```
-
-**Keyword Creation:**
-```python
-# Check limit
-LimitService.check_hard_limit(account, 'keywords', count)
-
-# Then create
-Keywords.objects.bulk_create([...])
-```
-
-**Automation Runs:**
-```python
-# Estimate total cost
-estimated = estimate_automation_cost(config)
-
-# Check BEFORE starting
-CreditService.check_credits(account, estimated)
-
-# Then run
-execute_automation(config)
-```
-
----
-
-## Success Criteria
-
-### Technical
-- [ ] All unused fields removed
-- [ ] 4 limits properly enforced
-- [ ] Credit checks before ALL operations
-- [ ] Automation pre-checks credits
-- [ ] No duplicate data across pages
-
-### User Experience
-- [ ] Simple 4-limit model is clear
-- [ ] Multi-dimensional insights are actionable
-- [ ] Keyword research flow is intuitive
-- [ ] Error messages are user-friendly
-- [ ] Upgrade prompts at right moments
-
-### Business
-- [ ] Reduced support questions
-- [ ] Higher upgrade conversion
-- [ ] Better credit visibility
-- [ ] System scales cleanly
-
----
-
-## Suggested Plan Values
-
-| Plan | Price | Credits/mo | Sites | Users | Keywords | Ahrefs/mo |
-|------|-------|-----------|-------|-------|----------|-----------|
-| **Free** | $0 | 2,000 | 1 | 1 | 100 | 0 |
-| **Starter** | $49 | 10,000 | 2 | 2 | 1,000 | 50 |
-| **Growth** | $149 | 40,000 | 5 | 3 | 5,000 | 200 |
-| **Scale** | $399 | 120,000 | ∞ | 5 | 20,000 | 500 |
-
----
-
-## Timeline
-
-**Week 1:** Backend cleanup (remove fields, add Ahrefs)  
-**Week 2:** Enforcement (keyword limits, automation checks)  
-**Week 3:** Frontend cleanup (remove duplicates, update UI)  
-**Week 4:** New features (Credit Insights, Keyword Research)  
-**Week 5:** Testing & Production deployment
-
----
-
-## Files to Review
-
-**Full Implementation Plan:**
-- `docs/plans/CREDITS-LIMITS-IMPLEMENTATION-PLAN.md`
-
-**Current System Docs:**
-- `docs/10-MODULES/BILLING.md`
-- `docs/40-WORKFLOWS/CREDIT-SYSTEM.md`
-
-**Code:**
-- Backend: `backend/igny8_core/auth/models.py`
-- Backend: `backend/igny8_core/business/billing/services/limit_service.py`
-- Frontend: `frontend/src/pages/account/PlansAndBillingPage.tsx`
-- Frontend: `frontend/src/pages/account/UsageAnalyticsPage.tsx`
-
----
-
-**Status:** ✅ READY FOR TEAM REVIEW AND IMPLEMENTATION
-
-**Next Step:** Schedule implementation kickoff meeting with backend, frontend, and QA leads.
diff --git a/docs/plans/implemented/MASTER-IMPLEMENTATION-PLAN.md b/docs/plans/implemented/MASTER-IMPLEMENTATION-PLAN.md
deleted file mode 100644
index 5ca687eb..00000000
--- a/docs/plans/implemented/MASTER-IMPLEMENTATION-PLAN.md
+++ /dev/null
@@ -1,868 +0,0 @@
-# IGNY8 Master Implementation Plan
-
-**Created:** December 29, 2025
-**Last Updated:** December 29, 2025
-**Status:** Ready for Implementation
-**Prepared by:** Architecture & Implementation Analysis
-
----
-
-## Executive Summary
-
-This document provides a comprehensive, actionable implementation plan for all pending IGNY8 fixes and enhancements. It is organized by priority, with clear dependencies, file locations, and implementation details derived from deep codebase analysis.
-
----
-
-## System Architecture Overview
-
-### Tech Stack
-| Layer | Technology |
-|-------|------------|
-| Backend | Django 4.x + DRF + Celery + Redis |
-| Frontend | React 19 + TypeScript + Vite + Zustand |
-| Database | PostgreSQL 14+ |
-| AI Integration | OpenAI (GPT-4/4o), DALL-E, Runware |
-| Task Queue | Celery + Redis broker |
-
-### Key Architectural Patterns
-- **Multi-tenant isolation** via `AccountBaseModel` with automatic `account` scoping
-- **7-stage automation pipeline** orchestrated by `AutomationService`
-- **Token-based billing** with credit system (`CreditService`, `CreditCostConfig`)
-- **Singleton global settings** (`GlobalIntegrationSettings.pk=1`, `BillingConfiguration.pk=1`)
-
----
-
-## PHASE 1: Critical Pre-Launch Fixes
-
-### 1.1 Payment & Account System
-
-#### Task 1.1.1: Payment Method Saving Fix
-**Problem:** Individual account payment method not saving properly.
-
-**Root Cause Analysis:**
-- `AccountPaymentMethod` model exists at [backend/igny8_core/business/billing/models.py:661-694](backend/igny8_core/business/billing/models.py#L661-L694)
-- Has `unique_together = [['account', 'display_name']]` constraint
-- Issue likely in the view/serializer that handles create/update
-
-**Files to Modify:**
-1. `backend/igny8_core/modules/billing/views.py` - AccountPaymentMethodViewSet
-2. `backend/igny8_core/modules/billing/serializers.py` - Serializer validation
-3. `frontend/src/pages/Account/PlansAndBillingPage.tsx` - Form submission
-
-**Implementation Steps:**
-1. Audit the `AccountPaymentMethodViewSet` - ensure `perform_create()` sets `account` from `request.account`
-2. Check serializer validation for `display_name` uniqueness per account
-3. Verify frontend API call includes all required fields (type, display_name, is_default)
-4. Add explicit error handling for duplicate payment method names
-5. Test: Create, update, delete payment methods via UI
-
----
-
-#### Task 1.1.2: Remove Country-Specific Payment Methods
-**Problem:** Payment methods have country-specific configuration that should be simplified to global-only.
-
-**Current State:**
-- `PaymentMethodConfig` model at [models.py:607-658](backend/igny8_core/business/billing/models.py#L607-L658) has `country_code` field
-- Frontend likely queries by country
-
-**Files to Modify:**
-1. `backend/igny8_core/business/billing/models.py` - PaymentMethodConfig
-2. `backend/igny8_core/modules/billing/views.py` - Payment method list endpoint
-3. `frontend/src/services/billing.api.ts` - Remove country filtering
-4. `frontend/src/pages/Account/PlansAndBillingPage.tsx` - Payment UI
-
-**Implementation Steps:**
-1. Update `PaymentMethodConfig` queryset to filter only `is_enabled=True` without country check
-2. Create migration to update existing records (set `country_code='*'` or `''` for global)
-3. Simplify frontend payment method selection to show all global methods
-4. Keep `country_code` field for future use but ignore in current queries
-
----
-
-#### Task 1.1.3: Account Edit Form Fix
-**Problem:** Payment method and account-specific edit form not updating correctly.
-
-**Files to Investigate:**
-1. `frontend/src/pages/Account/AccountSettingsPage.tsx`
-2. `backend/igny8_core/modules/account/views.py`
-3. `backend/igny8_core/modules/account/serializers.py`
-
-**Implementation Steps:**
-1. Trace form submission from frontend to backend
-2. Check serializer `update()` method handles partial updates correctly
-3. Verify optimistic UI update in Zustand store after successful save
-4. Add error boundary for failed saves with clear user feedback
-
----
-
-### 1.2 Backend Issues
-
-#### Task 1.2.1: Django Admin Keywords 500 Error
-**Problem:** Backend Django admin keywords page returns 500 error.
-
-**Files to Investigate:**
-1. `backend/igny8_core/modules/planner/admin.py` - KeywordsAdmin
-2. `backend/igny8_core/modules/planner/models.py` - Keywords model
-
-**Likely Causes:**
-- N+1 query on related fields (cluster, site, account)
-- Missing `list_select_related` or `list_prefetch_related`
-- Deleted FK reference
-
-**Implementation Steps:**
-1. Check Django logs for exact traceback
-2. Add to KeywordsAdmin:
-   ```python
-   list_select_related = ['site', 'account', 'cluster', 'seed_keyword']
-   list_display = ['keyword', 'site', 'status', ...]  # Only valid fields
-   ```
-3. Ensure all FK fields in `list_display` have `on_delete=SET_NULL` or exist
-4. Add `@admin.display(description='...')` for computed fields
-5. Test admin pagination with 1000+ keywords
-
----
-
-#### Task 1.2.2: Delete Functions & Cascade Relationships
-**Problem:** Many pages delete function not working (images, image prompts, etc.), and when upstream records are deleted, downstream status and relationships are not properly updated.
-
-**Current State:**
-- Models use soft delete via `SoftDeleteModel` mixin
-- `deleted` field marks as soft-deleted
-- Frontend calls `DELETE /api/v1/writer/images/{id}/`
-- **Cascade issue:** When parent records deleted, child records retain stale FK references and incorrect status
-
-**Files to Investigate:**
-1. `backend/igny8_core/modules/writer/views.py` - ImagesViewSet, ImagePromptsViewSet
-2. `backend/igny8_core/modules/planner/models.py`
-3. `backend/igny8_core/modules/writer/models.py`
-4. `frontend/src/services/api.ts` - Delete API calls
-5. `frontend/src/pages/Writer/Images.tsx` - Delete handlers
-
-**Cascade Relationships to Fix:**
-```
-Cluster (delete) -> Keywords.cluster = NULL (SET_NULL) + Keywords.status = 'new'
-                 -> ContentIdeas.cluster = NULL + Ideas.status = 'new'
-
-ContentIdea (delete) -> Tasks.idea = NULL (SET_NULL) + handle orphan tasks
-
-Task (delete) -> Content.task = NULL (SET_NULL)
-
-Content (delete) -> Images (CASCADE - soft delete)
-                 -> ImagePrompts (CASCADE - soft delete)
-                 -> PublishingRecord (SET_NULL)
-```
-
-**Implementation Steps:**
-1. Verify ViewSet has `destroy()` method or inherits from `DestroyModelMixin`
-2. Check permission classes allow delete for current user role
-3. **Add cascade status updates** - when parent deleted:
-   - Create `pre_delete` or `post_delete` signal handlers
-   - Reset child record status to appropriate value (e.g., `status='new'` for orphaned keywords)
-   - Clear FK references properly
-4. Add bulk delete endpoint if needed: `POST /api/v1/writer/images/bulk-delete/`
-5. Test: Single delete, bulk delete, cascade delete with status verification
-6. Ensure UI shows warning before deleting parent records with dependencies
-
----
-
-#### Task 1.2.3: Soft Deletion Verification
-**Problem:** Need to verify soft deletion criteria across system.
-
-**Current Pattern:**
-- `SoftDeleteModel` base class with `deleted` BooleanField
-- Managers filter `deleted=False` by default
-- Cascade handled manually or via Django signals
-
-**Files to Audit:**
-1. `backend/igny8_core/common/models.py` - Base soft delete mixin
-2. All models with soft delete: `Content`, `Images`, `Tasks`, `Keywords`, `Clusters`
-
-**Implementation Steps:**
-1. Create comprehensive soft delete audit:
-   | Model | Has SoftDelete | Manager Filters | Cascade Rule | Status Reset |
-   |-------|----------------|-----------------|--------------|--------------|
-   | Content | Yes | Yes | Images soft-deleted | N/A |
-   | Tasks | Yes | Yes | None | N/A |
-   | Images | Yes | Yes | ImagePrompts soft-deleted | N/A |
-   | Clusters | Yes | Yes | Keywords.cluster=NULL | Keywords.status='new' |
-   | ContentIdeas | Yes | Yes | Tasks.idea=NULL | Tasks orphan handling |
-2. Verify `on_delete` behavior for all FKs
-3. Add `pre_delete` signal to handle cascade soft deletes AND status resets
-4. Create admin action to purge soft-deleted records older than retention period
-
----
-
-### 1.3 Data Integrity
-
-#### Task 1.3.1: CRUD Verification
-**Problem:** Need clear definition and verification of CRUD operations on each page.
-
-**Create CRUD Matrix:**
-
-| Page | Create | Read | Update | Delete | Notes |
-|------|--------|------|--------|--------|-------|
-| Planner/Keywords | Import | List/Detail | Status | Bulk | Import via CSV |
-| Planner/Clusters | AI Gen | List/Detail | Name, Status | Single | Created by AI |
-| Planner/Ideas | AI Gen | List/Detail | Title, Status | Single | Created by AI |
-| Writer/Tasks | From Ideas | List/Detail | All fields | Single | Manual + Auto |
-| Writer/Content | AI Gen | List/Detail | All fields | Single | With Images cascade |
-| Writer/Images | AI Gen | List/Detail | Alt, Caption | Single/Bulk | Upload + Generate |
-
-**Implementation Steps:**
-1. Create this matrix for all pages
-2. Verify each operation has working API endpoint
-3. Add frontend tests for each CRUD action
-4. Document any special behaviors (bulk operations, cascade effects)
-
----
-
-## PHASE 2: Automation Pipeline Fixes
-
-### 2.1 Stage Card & Metrics Issues
-
-#### Task 2.1.1: Automation Credit Display & Accuracy Fix
-**Problem:** Credit display in stage cards shows incorrect values and doesn't match `/account/usage/credits` endpoint.
-
-**Root Cause Analysis:**
-- `StageCard.tsx` at [frontend/src/components/Automation/StageCard.tsx](frontend/src/components/Automation/StageCard.tsx) shows `result.credits_used`
-- `AutomationRun.stage_X_result` JSON contains `credits_used` field
-- Issue: `_get_credits_used()` in `automation_service.py` counts AITaskLog records, not actual credits
-
-**Current Implementation (Incorrect):**
-```python
-# automation_service.py:1645-1656
-def _get_credits_used(self) -> int:
-    total = AITaskLog.objects.filter(
-        account=self.account,
-        created_at__gte=self.run.started_at
-    ).aggregate(total=Count('id'))['total'] or 0  # WRONG: counts records, not credits
-    return total
-```
-
-**Reference:** `/account/usage/credits` shows accurate data - uses `CreditUsageLog`
-
-**Files to Modify:**
-1. `backend/igny8_core/business/automation/services/automation_service.py` - `_get_credits_used()`
-2. `backend/igny8_core/business/billing/models.py` - Query `CreditUsageLog`
-
-**Implementation Steps:**
-1. Fix `_get_credits_used()` to use same source as `/account/usage/credits`:
-   ```python
-   def _get_credits_used(self) -> int:
-       from igny8_core.business.billing.models import CreditUsageLog
-       from django.db.models import Sum
-       total = CreditUsageLog.objects.filter(
-           account=self.account,
-           created_at__gte=self.run.started_at
-       ).aggregate(total=Sum('credits_used'))['total'] or 0
-       return total
-   ```
-2. Track credits in `AutomationRun.total_credits_used` incrementally
-3. Add stage-specific credit tracking in stage results
-4. Verify credits displayed match `/account/usage/credits` endpoint after fix
-
----
-
-#### Task 2.1.2: Stage 6 Image Generation & Progress Bar Fix
-**Problem:**
-1. Image generation (Stage 6) behaves differently than other AI functions
-2. Stage 6 progress bar showing wrong counts (always 0/remaining, 0%)
-
-**Current Implementation Analysis:**
-Stage 6 in [automation_service.py:1204-1416](backend/igny8_core/business/automation/services/automation_service.py#L1204-L1416):
-- Uses `process_image_generation_queue.delay()` - Celery async task
-- Other stages use `AIEngine.execute()` synchronously
-- `_wait_for_task()` polls Celery result
-
-**Key Difference:**
-- Stages 1-5: `AIEngine.execute()` -> synchronous, returns immediately
-- Stage 6: `process_image_generation_queue.delay()` -> Celery task, needs polling
-
-**Progress Bar Issue:**
-- `stage_6_result` may not have `images_total` field at stage start
-- Incremental saves happen but `images_total` not set initially
-- Frontend `getProcessedFromResult()` can't calculate progress without total
-
-**Files to Modify:**
-1. `backend/igny8_core/ai/tasks.py` - `process_image_generation_queue`
-2. `backend/igny8_core/ai/engine.py` - AIEngine vs Celery path
-3. `backend/igny8_core/business/automation/services/automation_service.py` - Stage 6 initial save
-
-**Implementation Steps:**
-1. Audit `process_image_generation_queue` task for:
-   - Proper credit deduction BEFORE generation (image credits are pre-paid)
-   - Error handling and retry logic
-   - Status update on Image model
-2. **Fix Stage 6 initial save** to include total immediately:
-   ```python
-   # In run_stage_6() - set total at start
-   self.run.stage_6_result = {
-       'images_processed': 0,
-       'images_total': total_images,  # SET IMMEDIATELY
-       'images_generated': 0,
-       'credits_used': 0,
-       'time_elapsed': '0m 0s',
-       'in_progress': True
-   }
-   self.run.save(update_fields=['stage_6_result'])
-   ```
-3. Consider refactoring Stage 6 to use same `AIEngine` pattern for consistency:
-   ```python
-   engine = AIEngine(account=self.account)
-   result = engine.execute(
-       fn=GenerateImagesFunction(),
-       payload={'ids': [image.id]}
-   )
-   ```
-4. If keeping async, ensure proper progress tracking updates stage result after each image
-
----
-
-#### Task 2.1.3: Main Progress Bar Fix
-**Problem:** Main progress bar completes at 100% at stage 5 instead of stage 6.
-
-**Root Cause Analysis:**
-- `GlobalProgressBar.tsx` likely calculates: `current_stage / 7 * 100`
-- But Stage 7 is "Review Gate" (no processing) - should complete at Stage 6
-
-**Current Implementation in GlobalProgressBar:**
-- Uses `globalProgress.overall_percentage` from API
-- Or calculates from `stages` array
-
-**Files to Modify:**
-1. `frontend/src/components/Automation/GlobalProgressBar.tsx`
-2. `backend/igny8_core/business/automation/views.py` - `/run_progress/` endpoint
-
-**Implementation Steps:**
-1. Backend calculation should be:
-   ```python
-   # In get_run_progress() view
-   if run.status == 'completed':
-       overall_percentage = 100
-   else:
-       # Weight stages 1-6 equally, stage 7 is 0%
-       completed_stages = min(run.current_stage - 1, 6)
-       stage_weight = 100 / 6
-       within_stage_progress = # based on processed/total
-       overall_percentage = (completed_stages * stage_weight) + (within_stage_progress * stage_weight / 100)
-   ```
-2. Stage 6 completion should trigger 100%
-3. Stage 7 is display-only, no automation work
-
----
-
-## PHASE 3: AI Provider Configuration
-
-### Task 3.1: Flexible Model Configuration System
-
-**Reference:** [flexible-model-configuration-plan.md](flexible-model-configuration-plan.md)
-
-**Current State:**
-- `MODEL_RATES` and `IMAGE_MODEL_RATES` hardcoded in [ai/constants.py](backend/igny8_core/ai/constants.py)
-- `AIModelConfig` model already exists at [billing/models.py:697-930](backend/igny8_core/business/billing/models.py#L697-L930)
-
-**Implementation Phases:**
-
-#### Phase 3.1.1: Model Registry Service
-**Files to Create:**
-1. `backend/igny8_core/ai/model_registry.py`
-
-**Implementation:**
-```python
-class ModelRegistry:
-    """Central registry for AI model configurations with caching."""
-
-    _cache = {}
-    _cache_ttl = 300
-
-    @classmethod
-    def get_model(cls, model_id: str) -> Optional[AIModelConfig]:
-        # Check cache, then DB, then fallback to constants.py
-        pass
-
-    @classmethod
-    def get_rate(cls, model_id: str, rate_type: str) -> Decimal:
-        # Get input/output rate for text or per-image for image
-        pass
-
-    @classmethod
-    def calculate_cost(cls, model_id: str, input_tokens: int, output_tokens: int) -> Decimal:
-        model = cls.get_model(model_id)
-        if model.model_type == 'text':
-            return model.get_cost_for_tokens(input_tokens, output_tokens)
-        return Decimal('0')
-```
-
-#### Phase 3.1.2: Update AICore to Use Registry
-**Files to Modify:**
-1. `backend/igny8_core/ai/ai_core.py` - Replace `MODEL_RATES` lookup
-
-**Before:**
-```python
-from igny8_core.ai.constants import MODEL_RATES
-rate = MODEL_RATES.get(model, {})
-```
-
-**After:**
-```python
-from igny8_core.ai.model_registry import ModelRegistry
-model_config = ModelRegistry.get_model(model)
-```
-
-#### Phase 3.1.3: Data Migration
-Create migration to seed `AIModelConfig` from current `constants.py`:
-
-```python
-# Migration: 0002_seed_ai_models.py
-def seed_models(apps, schema_editor):
-    AIModelConfig = apps.get_model('billing', 'AIModelConfig')
-
-    text_models = [
-        ('gpt-4o-mini', 'GPT-4o Mini', 'openai', 0.15, 0.60, True),
-        ('gpt-4o', 'GPT-4o', 'openai', 2.50, 10.00, False),
-        # ... all models from constants.py
-    ]
-
-    for model_id, name, provider, input_cost, output_cost, is_default in text_models:
-        AIModelConfig.objects.create(
-            model_name=model_id,
-            display_name=name,
-            provider=provider,
-            model_type='text',
-            input_cost_per_1m=input_cost,
-            output_cost_per_1m=output_cost,
-            is_active=True,
-            is_default=is_default,
-        )
-```
-
-#### Phase 3.1.4: Admin UI for Models
-**Files to Create/Modify:**
-1. `backend/igny8_core/modules/billing/admin.py` - AIModelConfigAdmin
-2. `frontend/src/pages/Admin/AISettings.tsx` - Model management UI
-
----
-
-### Task 3.2: Bria Integration (Image Generation)
-
-**Current State:** Runware is already integrated and working with 1 model configured. Need to add Bria as additional image generation provider.
-
-**Files to Modify:**
-1. `backend/igny8_core/modules/system/global_settings_models.py` - Add Bria API key field
-2. `backend/igny8_core/ai/image_service.py` - Add Bria provider alongside Runware
-3. Seed `AIModelConfig` with Bria models
-
-**Implementation Steps:**
-1. Add to `GlobalIntegrationSettings`:
-   ```python
-   bria_api_key = models.CharField(max_length=255, blank=True)
-   bria_default_model = models.CharField(max_length=100, default='bria-2.3')
-   ```
-2. Create `BriaImageService` class mirroring existing Runware pattern
-3. Add Bria models to `AIModelConfig`:
-   ```python
-   ('bria-2.3', 'Bria 2.3', 'bria', 'image', cost_per_image=0.015)
-   ('bria-2.3-fast', 'Bria 2.3 Fast', 'bria', 'image', cost_per_image=0.010)
-   ```
-4. Update `process_image_generation_queue` to support provider selection (openai/runware/bria)
-5. Add UI dropdown in admin settings for selecting default image provider
-
----
-
-### Task 3.3: Anthropic Integration (Text Generation)
-
-**Files to Modify:**
-1. `backend/igny8_core/modules/system/global_settings_models.py` - Add Anthropic API key
-2. `backend/igny8_core/ai/ai_core.py` - Add Anthropic client
-3. Seed `AIModelConfig` with Claude models
-
-**Implementation Steps:**
-1. Add to `GlobalIntegrationSettings`:
-   ```python
-   anthropic_api_key = models.CharField(max_length=255, blank=True)
-   anthropic_default_model = models.CharField(max_length=100, default='claude-3-sonnet')
-   ```
-2. Install `anthropic` Python package
-3. Add Anthropic client initialization in `AICore`:
-   ```python
-   from anthropic import Anthropic
-
-   if provider == 'anthropic':
-       client = Anthropic(api_key=settings.anthropic_api_key)
-       response = client.messages.create(model=model, messages=messages, ...)
-   ```
-4. Add Claude models to `AIModelConfig`
-
----
-
-## PHASE 4: Design System & UI Standardization
-
-### 4.1 Sidebar & Navigation Fixes
-
-**Problems Identified:**
-- Sidebar padding too small
-- Icon sizes too small
-- Padding between dropdown menu items insufficient
-
-**Files to Modify:**
-1. `frontend/src/components/Layout/Sidebar.tsx` or equivalent
-2. `frontend/src/components/ui/navigation/*`
-3. `frontend/src/index.css` or Tailwind config
-
-**Implementation Steps:**
-1. Increase sidebar padding: `p-2` -> `p-3` or `p-4`
-2. Increase icon sizes: `size-4` -> `size-5` or `size-6`
-3. Increase dropdown menu item spacing: `py-1` -> `py-2`
-4. Apply consistent hover states and active indicators
-
----
-
-### 4.2 Footer Widget Metrics Fix
-
-**Problem:** In Planner and Writer submodule pages, the workflow completion metrics (footer widgets) are correct on some pages but empty or missing on others.
-
-**Files to Investigate:**
-1. `frontend/src/components/common/FooterWidgets.tsx` or similar
-2. `frontend/src/pages/Planner/*.tsx` - All planner pages
-3. `frontend/src/pages/Writer/*.tsx` - All writer pages
-
-**Implementation Steps:**
-1. Audit all pages with footer widgets:
-   | Page | Footer Widget Present | Data Correct |
-   |------|----------------------|--------------|
-   | Planner/Keywords | ? | ? |
-   | Planner/Clusters | ? | ? |
-   | Planner/Ideas | ? | ? |
-   | Writer/Tasks | ? | ? |
-   | Writer/Content | ? | ? |
-   | Writer/Images | ? | ? |
-2. Ensure consistent data fetching for workflow metrics
-3. Add fallback values for empty data
-4. Verify API calls return correct counts
-
----
-
-### 4.3 Header Metrics Verification
-
-**Problem:** Header metrics in table action rows show incorrect values on some pages (e.g., Volume on Clusters page shows 0 when it should aggregate keyword volumes).
-
-**Example Issue (from screenshot):**
-- Clusters page shows `Volume: 0`
-- Should show sum of `volume` from all keywords assigned to clusters
-
-**Files to Investigate:**
-1. `frontend/src/pages/Planner/Clusters.tsx`
-2. `frontend/src/config/pages/clusters.config.ts`
-3. `backend/igny8_core/modules/planner/views.py` - ClustersViewSet
-
-**Pages to Audit:**
-
-| Page | Metric | Expected Calculation | Current Status |
-|------|--------|---------------------|----------------|
-| Clusters | Volume | SUM(keywords.volume) for all clusters | Shows 0 - BROKEN |
-| Clusters | Keywords | COUNT(keywords) for all clusters | Verify |
-| Keywords | Volume | SUM(volume) for displayed keywords | Verify |
-| Ideas | Word Count | SUM(estimated_word_count) | Verify |
-| Content | Word Count | SUM(word_count) | Verify |
-| Images | Total | COUNT(images) | Verify |
-
-**Implementation Steps:**
-1. For Clusters Volume fix:
-   - Backend: Add `total_volume` annotation to ClustersViewSet list endpoint
-   - Or: Create dedicated metrics endpoint `/api/v1/planner/clusters/metrics/`
-   - Frontend: Fetch and display aggregated volume
-2. Audit all other header metrics
-3. Create consistent pattern for metrics calculation (backend aggregation vs frontend sum)
-4. Add loading states for metrics while data fetches
-
----
-
-### 4.4 Typography & Spacing Standardization
-
-**Problem:** Font sizes, spacing, and element sizes are inconsistent across components.
-
-**Objective:** Create single source of truth for all typography and spacing.
-
-**Design Tokens to Standardize:**
-
-```javascript
-// tailwind.config.js additions
-module.exports = {
-  theme: {
-    extend: {
-      fontSize: {
-        'heading-1': ['2rem', { lineHeight: '2.5rem', fontWeight: '700' }],
-        'heading-2': ['1.5rem', { lineHeight: '2rem', fontWeight: '600' }],
-        'heading-3': ['1.25rem', { lineHeight: '1.75rem', fontWeight: '600' }],
-        'body-lg': ['1rem', { lineHeight: '1.5rem' }],
-        'body-md': ['0.875rem', { lineHeight: '1.25rem' }],
-        'body-sm': ['0.75rem', { lineHeight: '1rem' }],
-        'label': ['0.75rem', { lineHeight: '1rem', fontWeight: '500' }],
-      },
-      spacing: {
-        'card-padding': '1.5rem',
-        'section-gap': '2rem',
-        'input-padding': '0.75rem',
-      },
-      // Icon sizes
-      iconSize: {
-        'xs': '0.875rem',  // 14px
-        'sm': '1rem',       // 16px
-        'md': '1.25rem',    // 20px
-        'lg': '1.5rem',     // 24px
-        'xl': '2rem',       // 32px
-      }
-    }
-  }
-}
-```
-
-**Implementation Steps:**
-1. Create typography scale document
-2. Audit current usage across all components
-3. Replace hardcoded values with design tokens
-4. Update all:
-   - Page headings
-   - Section titles
-   - Card titles
-   - Table headers/cells
-   - Form labels
-   - Button text
-   - Icon sizes
-
----
-
-### 4.5 Color Scheme Consistency & Balance
-
-**Problem:**
-1. Module colors not consistent across the system (e.g., Keywords module icon color differs from its progress bars and references)
-2. Multi-color usage is unbalanced (same color repeated in sequence, inconsistent patterns)
-
-**Color Assignments (Single Source of Truth):**
-
-| Module/Element | Primary Color | Use Cases |
-|----------------|---------------|-----------|
-| Keywords | `brand-500` (blue) | Icon, progress bar, metric cards, badges |
-| Clusters | `purple-500` | Icon, progress bar, metric cards, badges |
-| Ideas | `purple-600` | Icon, progress bar, metric cards, badges |
-| Content | `success-500` (green) | Icon, progress bar, metric cards, badges |
-| Tasks | `success-600` | Icon, progress bar, metric cards, badges |
-| Images | `purple-500` | Icon, progress bar, metric cards, badges |
-| Automation | `brand-500` | Pipeline stage cards |
-| Billing | `warning-500` (amber) | Credit displays, warnings |
-
-**Multi-Color Balance Rules:**
-1. When displaying 5+ colored elements, ensure:
-   - No more than 2 consecutive items share the same color
-   - Colors distributed evenly across the spectrum
-   - Visual hierarchy maintained (primary actions in brand color)
-
-2. Dashboard metric cards should follow pattern:
-   ```
-   [blue] [purple] [green] [amber] [purple]
-   ```
-   NOT:
-   ```
-   [blue] [blue] [purple] [purple] [purple]  // Unbalanced
-   ```
-
-**Files to Audit & Fix:**
-1. `frontend/src/pages/Dashboard/Home.tsx`
-2. `frontend/src/pages/Automation/AutomationPage.tsx`
-3. `frontend/src/pages/Planner/*.tsx`
-4. `frontend/src/pages/Writer/*.tsx`
-5. `frontend/src/pages/Account/*.tsx`
-6. All metric card and progress bar components
-
-**Implementation Steps:**
-1. Create color mapping constant:
-   ```typescript
-   // src/config/colors.config.ts
-   export const MODULE_COLORS = {
-     keywords: { bg: 'bg-brand-500', text: 'text-brand-600', border: 'border-brand-500' },
-     clusters: { bg: 'bg-purple-500', text: 'text-purple-600', border: 'border-purple-500' },
-     ideas: { bg: 'bg-purple-600', text: 'text-purple-700', border: 'border-purple-600' },
-     content: { bg: 'bg-success-500', text: 'text-success-600', border: 'border-success-500' },
-     images: { bg: 'bg-purple-500', text: 'text-purple-600', border: 'border-purple-500' },
-   };
-   ```
-2. Replace all hardcoded colors with config references
-3. Audit each dashboard/page for color balance
-4. Fix sequential same-color issues
-5. Add visual testing for color consistency
-
----
-
-### 4.6 Component Audit & Duplicate Removal
-
-**Objective:** Inventory all UI components and remove duplicate/parallel design systems.
-
-**Audit Checklist:**
-- [ ] Button variants (primary, secondary, outline, ghost)
-- [ ] Card components
-- [ ] Form inputs (text, select, checkbox, radio)
-- [ ] Table components
-- [ ] Modal/dialog
-- [ ] Navigation components
-- [ ] Icon usage (Lucide vs custom)
-- [ ] Metric cards
-- [ ] Progress bars
-
-**Current Systems to Consolidate:**
-1. Tailwind CSS 4.0 classes (KEEP - primary)
-2. Custom CSS files (AUDIT - keep only for complex animations)
-3. Inline styles (REMOVE)
-4. CSS-in-JS (REMOVE if present)
-
-**Implementation Steps:**
-1. Create component inventory spreadsheet
-2. Identify all duplicate components (e.g., multiple Button implementations)
-3. Choose canonical version for each component type
-4. Replace all uses of deprecated versions
-5. Delete deprecated files
-6. Add lint rules to prevent future duplicates
-
----
-
-### 4.7 Design System Verification
-
-**Objective:** Ensure only standard styles remain and prevent regression.
-
-**Verification Steps:**
-1. Visual regression testing with screenshots
-2. Component documentation/storybook review
-3. Cross-browser testing (Chrome, Firefox, Safari)
-4. Mobile responsive testing
-5. Dark mode consistency check
-
-**Success Criteria:**
-- All pages use same typography scale
-- All modules use assigned colors consistently
-- No inline styles in codebase
-- No duplicate component files
-- Sidebar/navigation properly spaced
-- Header metrics accurate on all pages
-- Footer widgets present and correct on all subpages
-
----
-
-## PHASE 5: Cleanup (From TODOS.md)
-
-### Task 5.1: SiteBuilder Removal
-
-**Status:** Deprecated module to be removed
-
-**Search Patterns:**
-- `sitebuilder`, `site_builder`, `SiteBuilder`
-- Components/pages with "SiteBuilder" in name
-- API endpoints containing `sitebuilder`
-
-**Implementation Steps:**
-1. Search codebase for all references
-2. Remove unused imports
-3. Delete SiteBuilder-specific files
-4. Update routes/navigation
-5. Remove database tables if empty
-
----
-
-### Task 5.2: Inactive Modules Documentation
-
-**Modules on hold for Phase 2:**
-- **Linker** - Internal linking suggestions
-- **Optimizer** - Content optimization
-
-**Implementation Steps:**
-1. Ensure modules are disabled in routes
-2. Add feature flags to prevent accidental activation
-3. Document Phase 2 activation requirements
-
----
-
-## Implementation Priority & Dependencies
-
-### Priority Matrix
-
-| Phase | Priority | Effort | Dependencies |
-|-------|----------|--------|--------------|
-| 1.1 Payment System | CRITICAL | Medium | None |
-| 1.2 Backend Issues | CRITICAL | Medium | None |
-| 1.3 Data Integrity | HIGH | Low | 1.2 |
-| 2.1 Automation Fixes | CRITICAL | Medium | None |
-| 3 AI Providers | MEDIUM | High | None |
-| 4 Design System | HIGH | High | None |
-| 5 Cleanup | LOW | Low | None |
-
-### Recommended Execution Order
-
-```
-Week 1: Phase 1.1 (Payment) + Phase 1.2 (Backend + Cascade)
-Week 2: Phase 1.3 (CRUD) + Phase 2 (Automation Fixes)
-Week 3: Phase 3 (AI Providers)
-Week 4: Phase 4.1-4.3 (Sidebar, Footer, Header Metrics)
-Week 5: Phase 4.4-4.6 (Typography, Colors, Components)
-Week 6: Phase 4.7 (Verification) + Phase 5 (Cleanup)
-```
-
----
-
-## Testing Strategy
-
-### Unit Tests
-- All service methods
-- Model validations
-- Credit calculations
-
-### Integration Tests
-- API endpoint flows
-- Automation pipeline stages
-- Payment webhooks
-
-### E2E Tests
-- Complete automation run
-- User payment flow
-- Content publishing
-
-### Visual Tests
-- Typography consistency
-- Color scheme accuracy
-- Responsive layouts
-- Dark mode
-
----
-
-## Monitoring & Verification
-
-### Success Metrics
-
-| Metric | Target | Measurement |
-|--------|--------|-------------|
-| Payment success rate | >99% | Payment.status counts |
-| Automation completion | >95% | AutomationRun.status |
-| Credit accuracy | 100% | Manual audit |
-| Stage progress accuracy | 100% | UI vs DB comparison |
-| Header metrics accuracy | 100% | Visual verification |
-| Color consistency | 100% | Design audit |
-
-### Logging Requirements
-
-All critical operations should log:
-- Timestamp
-- Account ID
-- Operation type
-- Input parameters
-- Result/Error
-- Duration
-
----
-
-## Document History
-
-| Date | Version | Author | Changes |
-|------|---------|--------|---------|
-| 2025-12-29 | 1.0 | Architecture Review | Initial comprehensive plan |
-| 2025-12-29 | 1.1 | User Feedback | Merged tasks, added UI/styling phase, fixed task descriptions |
-
----
-
-*This plan is designed to be executable step-by-step. Each task includes specific file locations, implementation details, and verification criteria derived from actual codebase analysis.*
diff --git a/docs/plans/implemented/MIGRATION_GUIDE_VERIFIACTION_REQURIED_IF ALEAYD_IMPLEMENTD.md b/docs/plans/implemented/MIGRATION_GUIDE_VERIFIACTION_REQURIED_IF ALEAYD_IMPLEMENTD.md
deleted file mode 100644
index 0722b10d..00000000
--- a/docs/plans/implemented/MIGRATION_GUIDE_VERIFIACTION_REQURIED_IF ALEAYD_IMPLEMENTD.md	
+++ /dev/null
@@ -1,216 +0,0 @@
-# CSS Migration Guide
-
-This guide documents the migration from legacy `.igny8-*` classes and `--igny8-*` variables to the new standardized design token system.
-
-## Overview
-
-All design tokens are now centralized in `/src/styles/tokens.css` with plain naming (no "igny8" prefix). The legacy `igny8-colors.css` file is maintained for backward compatibility but should not be used in new code.
-
-## Color Token Migration
-
-### CSS Variables
-
-**Before:**
-```tsx
-<div className="bg-[var(--igny8-blue)]">Content</div>
-```
-
-**After:**
-```tsx
-<div className="bg-[var(--color-primary)]">Content</div>
-```
-
-### Complete Variable Mapping
-
-| Legacy Variable | New Token | Usage |
-|----------------|-----------|-------|
-| `--igny8-blue` | `--color-primary` | Primary brand color |
-| `--igny8-blue-dark` | `--color-primary-dark` | Primary dark variant |
-| `--igny8-green` | `--color-success` | Success states |
-| `--igny8-green-dark` | `--color-success-dark` | Success dark variant |
-| `--igny8-amber` | `--color-warning` | Warning states |
-| `--igny8-amber-dark` | `--color-warning-dark` | Warning dark variant |
-| `--igny8-red` | `--color-danger` | Danger/error states |
-| `--igny8-red-dark` | `--color-danger-dark` | Danger dark variant |
-| `--igny8-purple` | `--color-purple` | Purple accent |
-| `--igny8-purple-dark` | `--color-purple-dark` | Purple dark variant |
-
-## Utility Class Migration
-
-### Background Colors
-
-**Before:**
-```tsx
-<div className="igny8-bg-blue">Content</div>
-```
-
-**After (Option 1 - Tailwind):**
-```tsx
-<div className="bg-brand-500">Content</div>
-```
-
-**After (Option 2 - CSS Variable):**
-```tsx
-<div className="bg-[var(--color-primary)]">Content</div>
-```
-
-### Text Colors
-
-**Before:**
-```tsx
-<span className="igny8-text-blue">Text</span>
-```
-
-**After (Option 1 - Tailwind):**
-```tsx
-<span className="text-brand-500">Text</span>
-```
-
-**After (Option 2 - CSS Variable):**
-```tsx
-<span className="text-[var(--color-primary)]">Text</span>
-```
-
-### Border Colors
-
-**Before:**
-```tsx
-<div className="igny8-border-blue">Content</div>
-```
-
-**After (Option 1 - Tailwind):**
-```tsx
-<div className="border-brand-500">Content</div>
-```
-
-**After (Option 2 - CSS Variable):**
-```tsx
-<div className="border-[var(--color-primary)]">Content</div>
-```
-
-## Component Migration
-
-### Buttons
-
-**Before:**
-```tsx
-<a className="inline-flex items-center rounded-full bg-gradient-to-r from-[var(--igny8-blue)] to-[var(--igny8-blue-dark)] text-white px-6 py-3">
-  Click me
-</a>
-```
-
-**After:**
-```tsx
-import Button from '@/components/ui/button/Button';
-
-<Button
-  variant="gradient"
-  tone="brand"
-  shape="pill"
-  size="lg"
-  as="a"
-  href="/path"
->
-  Click me
-</Button>
-```
-
-### Badges
-
-**Before:**
-```tsx
-<span className="igny8-badge igny8-badge-primary">New</span>
-```
-
-**After:**
-```tsx
-import Badge from '@/components/ui/badge/Badge';
-
-<Badge variant="solid" tone="brand">New</Badge>
-```
-
-### Cards
-
-**Before:**
-```tsx
-<div className="igny8-card">
-  <div className="igny8-card-header">Title</div>
-  Content
-</div>
-```
-
-**After:**
-```tsx
-import { Card, CardTitle, CardContent } from '@/components/ui/card/Card';
-
-<Card>
-  <CardTitle>Title</CardTitle>
-  <CardContent>Content</CardContent>
-</Card>
-```
-
-## Gradients
-
-**Before:**
-```tsx
-<div className="bg-gradient-to-r from-[var(--igny8-blue)] to-[var(--igny8-blue-dark)]">
-  Content
-</div>
-```
-
-**After:**
-```tsx
-<div className="bg-gradient-to-r from-[var(--color-primary)] to-[var(--color-primary-dark)]">
-  Content
-</div>
-```
-
-Or use the Button component with `variant="gradient"`:
-```tsx
-<Button variant="gradient" tone="brand">Content</Button>
-```
-
-## Active Classes (Still in Use)
-
-These classes are still actively used and should continue to be used:
-
-- `.igny8-table-container` - Table wrapper with loading states
-- `.igny8-table-wrapper` - Table scroll wrapper
-- `.igny8-table-compact` - Compact table styling
-- `.igny8-table-smooth` - Smooth table transitions
-- `.igny8-table-body` - Table body styling
-- `.igny8-skeleton-row` - Loading skeleton rows
-- `.igny8-header-metrics` - Header metrics container
-- `.igny8-header-metric` - Individual metric
-- `.igny8-header-metric-accent` - Metric accent color
-- `.igny8-header-metric-label` - Metric label
-- `.igny8-header-metric-value` - Metric value
-- `.igny8-header-metric-separator` - Metric separator
-
-## Migration Checklist
-
-When updating a file:
-
-- [ ] Replace `--igny8-*` variables with `--color-*` tokens
-- [ ] Replace `.igny8-bg-*` with `bg-brand-500` or `bg-[var(--color-primary)]`
-- [ ] Replace `.igny8-text-*` with `text-brand-500` or `text-[var(--color-primary)]`
-- [ ] Replace `.igny8-border-*` with `border-brand-500` or `border-[var(--color-primary)]`
-- [ ] Replace hardcoded buttons with `<Button>` component
-- [ ] Replace hardcoded badges with `<Badge>` component
-- [ ] Replace hardcoded cards with `<Card>` component
-- [ ] Keep `.igny8-table-*` and `.igny8-header-metric-*` classes as-is
-- [ ] Test visual appearance matches (no color changes)
-
-## Benefits of Migration
-
-✅ **Single source of truth** - All colors defined in one place  
-✅ **Type safety** - React components provide prop validation  
-✅ **Consistency** - Standardized components across marketing and dashboard  
-✅ **Maintainability** - Easier to update colors globally  
-✅ **Performance** - Tailwind utilities are optimized  
-✅ **Developer experience** - Better autocomplete and IntelliSense
-
-## Questions?
-
-See `DESIGN_SYSTEM.md` for complete design system guidelines.
-
diff --git a/docs/plans/implemented/PLUGIN-DISTRIBUTION-SYSTEM.md b/docs/plans/implemented/PLUGIN-DISTRIBUTION-SYSTEM.md
deleted file mode 100644
index 890ea9aa..00000000
--- a/docs/plans/implemented/PLUGIN-DISTRIBUTION-SYSTEM.md
+++ /dev/null
@@ -1,692 +0,0 @@
-# IGNY8 Plugin Distribution System
-
-**Created:** January 9, 2026  
-**Version:** 1.0  
-**Status:** ✅ Phase 1 Implemented  
-**Scope:** WordPress, Shopify, Custom Site Integration Plugins
-
----
-
-## Overview
-
-This document outlines the architecture for distributing and auto-updating IGNY8 integration plugins across multiple platforms (WordPress, Shopify, Custom Sites).
-
----
-
-## 1. Directory Structure
-
-### 1.1 - Server Location
-
-```
-/data/app/igny8/
-├── backend/
-│   └── igny8_core/
-│       └── plugins/                    # NEW: Plugin management
-│           ├── __init__.py
-│           ├── models.py               # Plugin version tracking
-│           ├── views.py                # Download & update API
-│           ├── serializers.py
-│           ├── urls.py
-│           └── utils.py                # ZIP compression, versioning
-├── plugins/                            # NEW: Plugin source & distributions
-│   ├── wordpress/
-│   │   ├── source/                     # Development source files
-│   │   │   └── igny8-wp-bridge/
-│   │   │       ├── igny8-wp-bridge.php
-│   │   │       ├── includes/
-│   │   │       ├── assets/
-│   │   │       └── readme.txt
-│   │   └── dist/                       # Compiled/zipped releases
-│   │       ├── igny8-wp-bridge-v1.0.0.zip
-│   │       ├── igny8-wp-bridge-v1.0.1.zip
-│   │       └── igny8-wp-bridge-latest.zip  # Symlink to latest
-│   ├── shopify/                        # FUTURE
-│   │   ├── source/
-│   │   └── dist/
-│   └── custom-site/                    # FUTURE
-│       ├── source/
-│       └── dist/
-└── docs/
-    └── plans/
-        └── PLUGIN-DISTRIBUTION-SYSTEM.md
-```
-
-### 1.2 - Why This Structure?
-
-| Location | Purpose |
-|----------|---------|
-| `/plugins/` | Separate from app code, easy to manage |
-| `/plugins/{platform}/source/` | Development files, version controlled |
-| `/plugins/{platform}/dist/` | Ready-to-download ZIP files |
-| `/backend/igny8_core/plugins/` | Django app for API & version management |
-
----
-
-## 2. Database Models
-
-### 2.1 - Plugin Model
-
-```python
-# backend/igny8_core/plugins/models.py
-
-class Plugin(models.Model):
-    """Represents a plugin type (WordPress, Shopify, etc.)"""
-    
-    PLATFORM_CHOICES = [
-        ('wordpress', 'WordPress'),
-        ('shopify', 'Shopify'),
-        ('custom', 'Custom Site'),
-    ]
-    
-    name = models.CharField(max_length=100)  # "IGNY8 WP Bridge"
-    slug = models.SlugField(unique=True)      # "igny8-wp-bridge"
-    platform = models.CharField(max_length=20, choices=PLATFORM_CHOICES)
-    description = models.TextField()
-    is_active = models.BooleanField(default=True)
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
-    
-    class Meta:
-        db_table = 'plugins'
-
-
-class PluginVersion(models.Model):
-    """Tracks each version of a plugin"""
-    
-    STATUS_CHOICES = [
-        ('draft', 'Draft'),           # In development
-        ('testing', 'Testing'),       # Internal testing
-        ('staged', 'Staged'),         # Ready, not yet pushed
-        ('released', 'Released'),     # Available for download
-        ('update_ready', 'Update Ready'),  # Push to installed sites
-        ('deprecated', 'Deprecated'), # Old version
-    ]
-    
-    plugin = models.ForeignKey(Plugin, on_delete=models.CASCADE, related_name='versions')
-    version = models.CharField(max_length=20)  # "1.0.0", "1.0.1"
-    version_code = models.IntegerField()       # 100, 101 (for comparison)
-    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='draft')
-    
-    # File info
-    file_path = models.CharField(max_length=500)  # Relative path in dist/
-    file_size = models.IntegerField(default=0)    # Bytes
-    checksum = models.CharField(max_length=64)    # SHA256 for integrity
-    
-    # Release info
-    changelog = models.TextField(blank=True)
-    min_api_version = models.CharField(max_length=20, default='1.0')
-    
-    # Timestamps
-    created_at = models.DateTimeField(auto_now_add=True)
-    released_at = models.DateTimeField(null=True, blank=True)
-    
-    # Auto-update control
-    force_update = models.BooleanField(default=False)  # Critical security fix
-    
-    class Meta:
-        db_table = 'plugin_versions'
-        unique_together = ['plugin', 'version']
-        ordering = ['-version_code']
-
-
-class PluginInstallation(models.Model):
-    """Tracks where plugins are installed (per site)"""
-    
-    site = models.ForeignKey('Site', on_delete=models.CASCADE, related_name='plugin_installations')
-    plugin = models.ForeignKey(Plugin, on_delete=models.CASCADE)
-    current_version = models.ForeignKey(PluginVersion, on_delete=models.SET_NULL, null=True)
-    
-    # Installation status
-    is_active = models.BooleanField(default=True)
-    last_health_check = models.DateTimeField(null=True)
-    
-    # Update tracking
-    pending_update = models.ForeignKey(
-        PluginVersion, 
-        on_delete=models.SET_NULL, 
-        null=True, 
-        related_name='pending_installations'
-    )
-    update_notified_at = models.DateTimeField(null=True)
-    
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
-    
-    class Meta:
-        db_table = 'plugin_installations'
-        unique_together = ['site', 'plugin']
-```
-
----
-
-## 3. API Endpoints
-
-### 3.1 - Public Endpoints (No Auth Required)
-
-```python
-# Download latest plugin (for initial installation)
-GET /api/plugins/{slug}/download/
-# Returns: ZIP file download
-
-# Check for updates (called by installed plugins)
-GET /api/plugins/{slug}/check-update/?current_version=1.0.0
-# Returns: { "update_available": true, "latest_version": "1.0.1", "download_url": "...", "changelog": "..." }
-```
-
-### 3.2 - Authenticated Endpoints
-
-```python
-# Get download URL for user (tracks downloads)
-GET /api/plugins/{slug}/download-url/
-# Returns: { "url": "...", "expires_at": "..." }
-
-# Report installation (called after WP plugin is activated)
-POST /api/plugins/{slug}/register-installation/
-# Body: { "site_id": 123, "version": "1.0.0" }
-
-# Update installation status (health check)
-POST /api/plugins/{slug}/health-check/
-# Body: { "site_id": 123, "version": "1.0.0", "status": "active" }
-```
-
-### 3.3 - Admin Endpoints
-
-```python
-# List all plugin versions
-GET /api/admin/plugins/
-
-# Create new version
-POST /api/admin/plugins/{slug}/versions/
-# Body: { "version": "1.0.1", "changelog": "...", "status": "draft" }
-
-# Upload plugin ZIP
-POST /api/admin/plugins/{slug}/versions/{version}/upload/
-# Body: multipart/form-data with ZIP file
-
-# Release version (make available for download)
-POST /api/admin/plugins/{slug}/versions/{version}/release/
-
-# Push update to installed sites
-POST /api/admin/plugins/{slug}/versions/{version}/push-update/
-# This sets status to 'update_ready' and notifies all installations
-```
-
----
-
-## 4. WordPress Plugin Update Mechanism
-
-### 4.1 - How WordPress Auto-Updates Work
-
-WordPress checks for plugin updates by calling a filter. Our plugin hooks into this:
-
-```php
-// In igny8-wp-bridge.php
-
-class IGNY8_WP_Bridge {
-    
-    private $plugin_slug = 'igny8-wp-bridge';
-    private $version = '1.0.0';
-    private $api_url = 'https://app.igny8.com/api/plugins/';
-    
-    public function __construct() {
-        // Check for updates
-        add_filter('pre_set_site_transient_update_plugins', [$this, 'check_for_updates']);
-        add_filter('plugins_api', [$this, 'plugin_info'], 10, 3);
-    }
-    
-    public function check_for_updates($transient) {
-        if (empty($transient->checked)) {
-            return $transient;
-        }
-        
-        // Call IGNY8 API to check for updates
-        $response = wp_remote_get($this->api_url . $this->plugin_slug . '/check-update/', [
-            'timeout' => 10,
-            'headers' => [
-                'X-IGNY8-Site-ID' => get_option('igny8_site_id'),
-                'X-IGNY8-API-Key' => get_option('igny8_api_key'),
-            ],
-            'body' => [
-                'current_version' => $this->version,
-            ]
-        ]);
-        
-        if (is_wp_error($response)) {
-            return $transient;
-        }
-        
-        $data = json_decode(wp_remote_retrieve_body($response), true);
-        
-        if (!empty($data['update_available'])) {
-            $plugin_file = $this->plugin_slug . '/' . $this->plugin_slug . '.php';
-            
-            $transient->response[$plugin_file] = (object) [
-                'slug' => $this->plugin_slug,
-                'new_version' => $data['latest_version'],
-                'package' => $data['download_url'],
-                'url' => $data['info_url'] ?? '',
-            ];
-        }
-        
-        return $transient;
-    }
-    
-    public function plugin_info($result, $action, $args) {
-        if ($action !== 'plugin_information' || $args->slug !== $this->plugin_slug) {
-            return $result;
-        }
-        
-        // Fetch plugin info from IGNY8 API
-        $response = wp_remote_get($this->api_url . $this->plugin_slug . '/info/');
-        
-        if (is_wp_error($response)) {
-            return $result;
-        }
-        
-        $data = json_decode(wp_remote_retrieve_body($response), true);
-        
-        return (object) [
-            'name' => $data['name'],
-            'slug' => $this->plugin_slug,
-            'version' => $data['version'],
-            'author' => 'IGNY8',
-            'homepage' => 'https://igny8.com',
-            'sections' => [
-                'description' => $data['description'],
-                'changelog' => $data['changelog'],
-            ],
-            'download_link' => $data['download_url'],
-        ];
-    }
-}
-```
-
-### 4.2 - Update Flow
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                     Plugin Update Flow                               │
-├─────────────────────────────────────────────────────────────────────┤
-│                                                                      │
-│  1. Admin marks version as "Update Ready" in IGNY8 Dashboard        │
-│                           │                                          │
-│                           ▼                                          │
-│  2. IGNY8 API returns update_available=true for check-update calls  │
-│                           │                                          │
-│                           ▼                                          │
-│  3. WordPress cron checks for updates (or user clicks "Check Now")  │
-│                           │                                          │
-│                           ▼                                          │
-│  4. WP Plugin calls IGNY8 API → Gets new version info               │
-│                           │                                          │
-│                           ▼                                          │
-│  5. WordPress shows "Update Available" in Plugins page              │
-│                           │                                          │
-│                           ▼                                          │
-│  6. User clicks Update (or auto-update if enabled)                  │
-│                           │                                          │
-│                           ▼                                          │
-│  7. WordPress downloads ZIP from IGNY8 and installs                 │
-│                           │                                          │
-│                           ▼                                          │
-│  8. Plugin activation hook reports new version to IGNY8             │
-│                                                                      │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 5. Initial Download (ZIP Generation)
-
-### 5.1 - Build Script
-
-```bash
-#!/bin/bash
-# scripts/build-wp-plugin.sh
-
-VERSION=$1
-PLUGIN_NAME="igny8-wp-bridge"
-SOURCE_DIR="/data/app/igny8/plugins/wordpress/source/${PLUGIN_NAME}"
-DIST_DIR="/data/app/igny8/plugins/wordpress/dist"
-
-if [ -z "$VERSION" ]; then
-    echo "Usage: ./build-wp-plugin.sh <version>"
-    exit 1
-fi
-
-# Create dist directory if not exists
-mkdir -p "$DIST_DIR"
-
-# Create temp directory for packaging
-TEMP_DIR=$(mktemp -d)
-PACKAGE_DIR="${TEMP_DIR}/${PLUGIN_NAME}"
-
-# Copy source files
-cp -r "$SOURCE_DIR" "$PACKAGE_DIR"
-
-# Update version in main plugin file
-sed -i "s/Version: .*/Version: ${VERSION}/" "${PACKAGE_DIR}/${PLUGIN_NAME}.php"
-sed -i "s/\$version = '.*'/\$version = '${VERSION}'/" "${PACKAGE_DIR}/${PLUGIN_NAME}.php"
-
-# Create ZIP
-cd "$TEMP_DIR"
-zip -r "${DIST_DIR}/${PLUGIN_NAME}-v${VERSION}.zip" "$PLUGIN_NAME"
-
-# Update latest symlink
-ln -sf "${PLUGIN_NAME}-v${VERSION}.zip" "${DIST_DIR}/${PLUGIN_NAME}-latest.zip"
-
-# Calculate checksum
-sha256sum "${DIST_DIR}/${PLUGIN_NAME}-v${VERSION}.zip" > "${DIST_DIR}/${PLUGIN_NAME}-v${VERSION}.sha256"
-
-# Cleanup
-rm -rf "$TEMP_DIR"
-
-echo "Built: ${DIST_DIR}/${PLUGIN_NAME}-v${VERSION}.zip"
-echo "Checksum: $(cat ${DIST_DIR}/${PLUGIN_NAME}-v${VERSION}.sha256)"
-```
-
-### 5.2 - Django Management Command
-
-```python
-# backend/igny8_core/plugins/management/commands/build_plugin.py
-
-from django.core.management.base import BaseCommand
-import subprocess
-import hashlib
-from plugins.models import Plugin, PluginVersion
-
-class Command(BaseCommand):
-    help = 'Build and register a new plugin version'
-    
-    def add_arguments(self, parser):
-        parser.add_argument('--plugin', type=str, required=True)
-        parser.add_argument('--version', type=str, required=True)
-        parser.add_argument('--changelog', type=str, default='')
-        parser.add_argument('--release', action='store_true')
-    
-    def handle(self, *args, **options):
-        plugin = Plugin.objects.get(slug=options['plugin'])
-        version = options['version']
-        
-        # Run build script
-        result = subprocess.run(
-            ['./scripts/build-wp-plugin.sh', version],
-            capture_output=True,
-            text=True
-        )
-        
-        if result.returncode != 0:
-            self.stderr.write(f"Build failed: {result.stderr}")
-            return
-        
-        # Calculate version code (1.0.1 -> 101)
-        parts = version.split('.')
-        version_code = int(parts[0]) * 10000 + int(parts[1]) * 100 + int(parts[2])
-        
-        # Get file info
-        file_path = f"{plugin.slug}-v{version}.zip"
-        full_path = f"/data/app/igny8/plugins/wordpress/dist/{file_path}"
-        
-        with open(full_path, 'rb') as f:
-            checksum = hashlib.sha256(f.read()).hexdigest()
-        
-        import os
-        file_size = os.path.getsize(full_path)
-        
-        # Create version record
-        plugin_version, created = PluginVersion.objects.update_or_create(
-            plugin=plugin,
-            version=version,
-            defaults={
-                'version_code': version_code,
-                'file_path': file_path,
-                'file_size': file_size,
-                'checksum': checksum,
-                'changelog': options['changelog'],
-                'status': 'released' if options['release'] else 'draft',
-            }
-        )
-        
-        action = 'Created' if created else 'Updated'
-        self.stdout.write(f"{action} version {version} for {plugin.name}")
-```
-
----
-
-## 6. Frontend Integration
-
-### 6.1 - Download Button Component
-
-```tsx
-// frontend/src/components/sites/PluginDownloadSection.tsx
-
-import { Button } from '@/components/ui';
-import { useQuery } from '@tanstack/react-query';
-import { api } from '@/services/api';
-
-interface PluginInfo {
-  name: string;
-  slug: string;
-  version: string;
-  download_url: string;
-  file_size: number;
-  platform: string;
-}
-
-export function PluginDownloadSection({ platform = 'wordpress' }: { platform: string }) {
-  const { data: plugin, isLoading } = useQuery<PluginInfo>({
-    queryKey: ['plugin', platform],
-    queryFn: () => api.get(`/plugins/${platform}/latest/`).then(r => r.data),
-  });
-
-  const handleDownload = async () => {
-    if (!plugin) return;
-    
-    // Track download
-    await api.post(`/plugins/${plugin.slug}/track-download/`);
-    
-    // Trigger download
-    window.location.href = plugin.download_url;
-  };
-
-  if (isLoading) return <div>Loading...</div>;
-  if (!plugin) return null;
-
-  return (
-    <div className="bg-white rounded-xl border border-gray-200 p-6">
-      <div className="flex items-start gap-4">
-        <div className="p-3 bg-green-50 rounded-lg">
-          <DownloadIcon className="w-6 h-6 text-green-600" />
-        </div>
-        <div className="flex-1">
-          <h3 className="font-semibold text-gray-900">{plugin.name}</h3>
-          <p className="text-sm text-gray-500 mt-1">
-            Download and install the plugin on your {platform === 'wordpress' ? 'WordPress' : platform} site
-          </p>
-          <div className="flex items-center gap-4 mt-2 text-xs text-gray-400">
-            <span>Version {plugin.version}</span>
-            <span>{formatFileSize(plugin.file_size)}</span>
-          </div>
-        </div>
-        <Button onClick={handleDownload} variant="outline">
-          <DownloadIcon className="w-4 h-4 mr-2" />
-          Download Plugin
-        </Button>
-      </div>
-    </div>
-  );
-}
-```
-
-### 6.2 - Admin Plugin Management Page (Future)
-
-```
-/admin/plugins                    # List all plugins
-/admin/plugins/{slug}             # Plugin details + versions
-/admin/plugins/{slug}/versions    # Version history
-/admin/plugins/{slug}/upload      # Upload new version
-```
-
----
-
-## 7. Security Considerations
-
-### 7.1 - Download Security
-
-| Measure | Implementation |
-|---------|----------------|
-| Signed URLs | Time-limited download URLs (15 min expiry) |
-| Checksum | SHA256 verification in WP plugin |
-| API Key Required | Downloads require valid site API key |
-| Rate Limiting | Max 10 downloads/hour per site |
-
-### 7.2 - Update Security
-
-| Measure | Implementation |
-|---------|----------------|
-| HTTPS Only | All API calls over TLS |
-| Version Signing | Checksum comparison before install |
-| Rollback | Keep last 3 versions for emergency rollback |
-| Staged Rollout | Option to release to % of installs first |
-
----
-
-## 8. Implementation Phases
-
-### Phase 1: Basic Infrastructure (Week 1) ✅ COMPLETED
-- [x] Create `/plugins/` directory structure
-- [x] Create Django `plugins` app with models
-- [x] Migrate existing WP plugin to `/plugins/wordpress/source/`
-- [x] Create build script for ZIP generation
-- [x] Implement download API endpoint
-
-### Phase 2: Frontend Integration (Week 1) ✅ COMPLETED
-- [x] Update Site Settings > Integrations download button
-- [x] Create plugin info API endpoint
-- [x] Add version display to download section
-
-### Phase 3: Update System (Week 2) ✅ COMPLETED
-- [x] Implement check-update API
-- [x] Add update hooks to WP plugin
-- [x] Create PluginInstallation tracking
-- [x] Build admin version management UI
-
-### Phase 4: Advanced Features (Week 3)
-- [ ] Signed download URLs
-- [ ] Version rollback support
-- [ ] Update notifications in IGNY8 dashboard
-- [ ] Staged rollout percentage
-
-### Phase 5: Additional Platforms (Future)
-- [ ] Shopify plugin structure
-- [ ] Custom site SDK/package
-- [ ] Platform-specific update mechanisms
-
----
-
-## 9. File Serving Configuration
-
-### 9.1 - Nginx Configuration
-
-```nginx
-# Add to nginx config for igny8
-
-# Serve plugin downloads
-location /plugins/download/ {
-    alias /data/app/igny8/plugins/;
-    
-    # Only allow ZIP files
-    location ~ \.zip$ {
-        add_header Content-Disposition 'attachment';
-        add_header X-Content-Type-Options 'nosniff';
-    }
-    
-    # Deny access to source files
-    location ~ /source/ {
-        deny all;
-    }
-}
-```
-
-### 9.2 - Django URL (Proxied Downloads)
-
-```python
-# Better approach: Django handles download with auth
-
-# backend/igny8_core/plugins/views.py
-
-from django.http import FileResponse
-from rest_framework.decorators import api_view, permission_classes
-from rest_framework.permissions import AllowAny
-
-@api_view(['GET'])
-@permission_classes([AllowAny])
-def download_plugin(request, slug):
-    plugin = get_object_or_404(Plugin, slug=slug, is_active=True)
-    latest = plugin.versions.filter(status__in=['released', 'update_ready']).first()
-    
-    if not latest:
-        return Response({'error': 'No version available'}, status=404)
-    
-    file_path = f'/data/app/igny8/plugins/{plugin.platform}/dist/{latest.file_path}'
-    
-    response = FileResponse(
-        open(file_path, 'rb'),
-        content_type='application/zip'
-    )
-    response['Content-Disposition'] = f'attachment; filename="{latest.file_path}"'
-    return response
-```
-
----
-
-## 10. Monitoring & Analytics
-
-### 10.1 - Metrics to Track
-
-| Metric | Purpose |
-|--------|---------|
-| Downloads per version | Adoption rate |
-| Active installations | Current reach |
-| Update success rate | Quality indicator |
-| Version distribution | Upgrade urgency |
-| Health check failures | Support needs |
-
-### 10.2 - Admin Dashboard Widgets
-
-- **Plugin Downloads** - Daily/weekly download counts
-- **Version Distribution** - Pie chart of installed versions
-- **Update Adoption** - Time to 80% adoption after release
-- **Installation Health** - Sites with outdated/failing plugins
-
----
-
-## Quick Reference
-
-### Commands
-
-```bash
-# Build new version
-python manage.py build_plugin --plugin=igny8-wp-bridge --version=1.0.1 --changelog="Bug fixes"
-
-# Release version (make downloadable)
-python manage.py release_plugin --plugin=igny8-wp-bridge --version=1.0.1
-
-# Push update to sites
-python manage.py push_plugin_update --plugin=igny8-wp-bridge --version=1.0.1
-```
-
-### API Quick Reference
-
-```
-GET  /api/plugins/{slug}/download/           # Download latest ZIP
-GET  /api/plugins/{slug}/check-update/       # Check for updates
-GET  /api/plugins/{slug}/info/               # Plugin metadata
-POST /api/plugins/{slug}/register/           # Register installation
-POST /api/plugins/{slug}/health-check/       # Report status
-```
-
----
-
-**Document Owner:** IGNY8 Team  
-**Next Review:** After Phase 1 implementation
diff --git a/docs/plans/implemented/PRE_LAUCNH_PEDNING-PHASES-1-5-6_COMPLETED.md b/docs/plans/implemented/PRE_LAUCNH_PEDNING-PHASES-1-5-6_COMPLETED.md
deleted file mode 100644
index bb1d62fe..00000000
--- a/docs/plans/implemented/PRE_LAUCNH_PEDNING-PHASES-1-5-6_COMPLETED.md
+++ /dev/null
@@ -1,896 +0,0 @@
-# Implementation Plan: Phases 1, 5, and 6
-
-**Created:** January 9, 2026  
-**Target:** Safe, verified execution of cleanup, UX improvements, and data backup
-
----
-
-## Table of Contents
-
-1. [Phase 1: Code Cleanup & Technical Debt](#phase-1-code-cleanup--technical-debt)
-2. [Phase 5: UX Improvements](#phase-5-ux-improvements)
-3. [Phase 6: Data Backup & Cleanup](#phase-6-data-backup--cleanup)
-4. [Execution Checklist](#execution-checklist)
-
----
-
-# Phase 1: Code Cleanup & Technical Debt
-
-## 1.1 Pre-Cleanup Verification
-
-### 1.1.1 Create Safety Branch
-```bash
-# BEFORE ANY CHANGES - Create a safety branch
-cd /data/app/igny8
-git checkout -b cleanup/phase-1-$(date +%Y%m%d)
-git push origin cleanup/phase-1-$(date +%Y%m%d)
-```
-
-### 1.1.2 Run Full Test Suite (Baseline)
-```bash
-# Backend tests
-cd /data/app/igny8/backend
-python manage.py test --verbosity=2 > /tmp/test-baseline-backend.log 2>&1
-echo "Exit code: $?"
-
-# Frontend build check
-cd /data/app/igny8/frontend
-npm run build > /tmp/test-baseline-frontend.log 2>&1
-echo "Exit code: $?"
-
-# Frontend lint check
-npm run lint > /tmp/test-baseline-lint.log 2>&1
-```
-
-**✅ CHECKPOINT:** All tests must pass before proceeding.
-
----
-
-## 1.2 Frontend Cleanup - Empty/Unused Folders
-
-### Files to Delete (Verified Empty/Unused)
-
-| Path | Reason | Verified |
-|------|--------|----------|
-| `frontend/src/pages/Admin/` | Empty folder | ⬜ |
-| `frontend/src/pages/admin/` | Empty folder (duplicate lowercase) | ⬜ |
-| `frontend/src/pages/settings/` | Empty folder (lowercase duplicate) | ⬜ |
-| `frontend/src/components/debug/` | Empty debug folder | ⬜ |
-| `frontend/src/components/widgets/` | Empty folder | ⬜ |
-| `frontend/src/components/metrics/` | Empty folder | ⬜ |
-
-### Execution Steps:
-
-```bash
-# Step 1: Verify folders are empty
-cd /data/app/igny8/frontend/src
-
-# Check each folder before deletion
-ls -la pages/Admin/ 2>/dev/null || echo "Admin/ doesn't exist or empty"
-ls -la pages/admin/ 2>/dev/null || echo "admin/ doesn't exist or empty"
-ls -la pages/settings/ 2>/dev/null || echo "settings/ doesn't exist or empty"
-ls -la components/debug/ 2>/dev/null || echo "debug/ doesn't exist or empty"
-ls -la components/widgets/ 2>/dev/null || echo "widgets/ doesn't exist or empty"
-ls -la components/metrics/ 2>/dev/null || echo "metrics/ doesn't exist or empty"
-
-# Step 2: Remove empty folders (only if confirmed empty)
-rmdir pages/Admin 2>/dev/null
-rmdir pages/admin 2>/dev/null
-rmdir pages/settings 2>/dev/null
-rmdir components/debug 2>/dev/null
-rmdir components/widgets 2>/dev/null
-rmdir components/metrics 2>/dev/null
-```
-
-**✅ CHECKPOINT:** Run `npm run build` - must succeed.
-
----
-
-## 1.3 Frontend Cleanup - Template/Sample Components
-
-### Components to Delete (Never Used - Template/Demo Code)
-
-| Path | File Count | Reason |
-|------|------------|--------|
-| `frontend/src/components/ecommerce/` | 7 files | E-commerce template components - not used in app |
-| `frontend/src/components/sample-componeents/` | 2 files | Sample HTML files with typo in folder name |
-| `frontend/src/components/charts/bar/` | - | Unused bar chart template |
-| `frontend/src/components/charts/line/` | - | Unused line chart template |
-| `frontend/src/components/tables/BasicTables/` | - | Unused basic table template |
-
-### Pre-Delete Verification:
-
-```bash
-# Search for any imports of these components
-cd /data/app/igny8/frontend
-
-# Check ecommerce imports
-grep -r "ecommerce" src/ --include="*.ts" --include="*.tsx" | grep -v "node_modules"
-
-# Check sample imports
-grep -r "sample-componeents" src/ --include="*.ts" --include="*.tsx"
-
-# Check charts/bar imports
-grep -r "charts/bar" src/ --include="*.ts" --include="*.tsx"
-
-# Check charts/line imports
-grep -r "charts/line" src/ --include="*.ts" --include="*.tsx"
-
-# Check BasicTables imports
-grep -r "BasicTables" src/ --include="*.ts" --include="*.tsx"
-```
-
-### Execution (Only if no imports found):
-
-```bash
-cd /data/app/igny8/frontend/src
-
-# Delete unused template folders
-rm -rf components/ecommerce/
-rm -rf components/sample-componeents/
-rm -rf components/charts/bar/
-rm -rf components/charts/line/
-rm -rf components/tables/BasicTables/
-
-# If charts folder is now empty, remove it
-rmdir components/charts 2>/dev/null || true
-# If tables folder is now empty, remove it
-rmdir components/tables 2>/dev/null || true
-```
-
-**✅ CHECKPOINT:** Run `npm run build` - must succeed.
-
----
-
-## 1.4 Frontend Cleanup - Deprecated Files
-
-### Individual Files to Delete
-
-| File | Reason |
-|------|--------|
-| `frontend/src/components/Automation/CurrentProcessingCard.old.tsx` | Old deprecated version |
-
-### Execution:
-
-```bash
-# Verify no imports exist
-cd /data/app/igny8/frontend
-grep -r "CurrentProcessingCard.old" src/
-
-# If no results, safe to delete
-rm src/components/Automation/CurrentProcessingCard.old.tsx
-```
-
-**✅ CHECKPOINT:** Run `npm run build` - must succeed.
-
----
-
-## 1.5 Console.log Cleanup
-
-### Files with console.log statements to review:
-
-| File | Line(s) | Action |
-|------|---------|--------|
-| `src/services/api.ts` | 2010, 2015 | Review - may need for debugging |
-| `src/components/UserProfile/UserMetaCard.tsx` | 11 | Remove |
-| `src/components/UserProfile/UserAddressCard.tsx` | 11 | Remove |
-| `src/components/UserProfile/UserInfoCard.tsx` | 11 | Remove |
-| `src/components/Automation/ConfigModal.tsx` | 42 | Remove |
-| `src/components/common/ImageQueueModal.tsx` | 227, 229, 239, 242, 247, 251, 259, 262 | Remove all |
-| `src/components/common/ImageGenerationCard.tsx` | 107, 125, 129, 141, 142, 151, 178 | Remove all |
-
-### Execution Strategy:
-
-**Option A: Manual removal (safer)**
-Edit each file and remove console.log statements manually.
-
-**Option B: Automated with review**
-```bash
-cd /data/app/igny8/frontend
-
-# Find all console.log in src (excluding node_modules)
-grep -rn "console.log" src/ --include="*.ts" --include="*.tsx" > /tmp/console-logs.txt
-
-# Review the file before any automated removal
-cat /tmp/console-logs.txt
-```
-
-### Per-File Actions:
-
-```typescript
-// In UserMetaCard.tsx, UserAddressCard.tsx, UserInfoCard.tsx - REMOVE:
-console.log("Saving changes...");
-
-// In ConfigModal.tsx - REMOVE:
-console.log('Saving config with delays:', dataToSave);
-
-// In ImageQueueModal.tsx - REMOVE ALL console.log statements
-
-// In ImageGenerationCard.tsx - REMOVE ALL console.log statements
-
-// In api.ts - KEEP or convert to proper logging (these may be useful)
-```
-
-**✅ CHECKPOINT:** Run `npm run build && npm run lint` - must succeed.
-
----
-
-## 1.6 ESLint Verification
-
-```bash
-cd /data/app/igny8/frontend
-
-# Run full lint check
-npm run lint
-
-# If errors exist, fix them:
-npm run lint -- --fix
-```
-
-**✅ CHECKPOINT:** Zero lint errors.
-
----
-
-## 1.7 Post-Cleanup Verification
-
-```bash
-# 1. Full build
-cd /data/app/igny8/frontend
-npm run build
-
-# 2. Type check
-npx tsc --noEmit
-
-# 3. Start dev server and manually verify app loads
-npm run dev
-# Open http://localhost:5173 and verify:
-# - Dashboard loads
-# - All sidebar navigation works
-# - No console errors in browser
-
-# 4. Commit changes
-cd /data/app/igny8
-git add -A
-git status  # Review all changes
-git commit -m "Phase 1: Code cleanup - remove unused pages, components, and console.logs"
-```
-
----
-
-# Phase 5: UX Improvements
-
-## 5.1 Pre-Implementation Setup
-
-### 5.1.1 Create Feature Branch
-```bash
-cd /data/app/igny8
-git checkout main  # or your main branch
-git pull
-git checkout -b feature/phase-5-ux-improvements
-```
-
----
-
-## 5.2 Search Modal Enhancement
-
-### 5.2.1 Current State Analysis
-
-**Location:** Search functionality likely in header/navigation components
-
-**Research Required:**
-```bash
-cd /data/app/igny8/frontend
-
-# Find existing search component
-grep -rn "search" src/components/header/ --include="*.tsx"
-grep -rn "Search" src/components/ --include="*.tsx" | head -20
-
-# Find search-related stores
-grep -rn "search" src/store/ --include="*.ts"
-```
-
-### 5.2.2 Implementation Tasks
-
-| Task | File(s) | Details |
-|------|---------|---------|
-| Add keyboard shortcut | `src/components/header/Search*.tsx` | Cmd/Ctrl+K to open |
-| Add search filters | Search component | Filter by type (keyword, content, site) |
-| Add recent searches | Search component + localStorage | Store last 5 searches |
-| Improve results display | Search results component | Show context snippets |
-| Add quick actions | Search results | Quick action buttons |
-
-### 5.2.3 Keyboard Shortcut Implementation
-
-```typescript
-// Add to App.tsx or a global hook
-useEffect(() => {
-  const handleKeyDown = (e: KeyboardEvent) => {
-    if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
-      e.preventDefault();
-      // Open search modal
-      setSearchOpen(true);
-    }
-  };
-  
-  window.addEventListener('keydown', handleKeyDown);
-  return () => window.removeEventListener('keydown', handleKeyDown);
-}, []);
-```
-
-### 5.2.4 Verification
-
-- [ ] Cmd/Ctrl+K opens search modal
-- [ ] Search filters work correctly
-- [ ] Recent searches persist across sessions
-- [ ] Results show relevant context
-- [ ] Quick actions function properly
-
----
-
-## 5.3 Image Regeneration Feature
-
-### 5.3.1 Backend Requirements
-
-**Check existing endpoint:**
-```bash
-cd /data/app/igny8/backend
-
-# Find image generation endpoints
-grep -rn "image" igny8_core/modules/writer/ --include="*.py" | head -20
-grep -rn "regenerate" igny8_core/ --include="*.py"
-```
-
-**Required API endpoint (if not exists):**
-```
-POST /api/v1/writer/images/{id}/regenerate/
-Body: { reason?: string, prompt_adjustment?: string }
-Response: { task_id: string, status: "queued" }
-```
-
-### 5.3.2 Frontend Implementation
-
-**File: `frontend/src/pages/Writer/Images.tsx`**
-
-Add regenerate button to each image card:
-
-```typescript
-// Add to image card actions
-const handleRegenerate = async (imageId: number) => {
-  const reason = await showRegenerateModal();
-  if (reason !== null) {
-    await api.post(`/v1/writer/images/${imageId}/regenerate/`, { reason });
-    // Refresh list or show status
-  }
-};
-
-// Button in image card
-<Button 
-  variant="outline" 
-  size="sm" 
-  onClick={() => handleRegenerate(image.id)}
->
-  <RefreshIcon /> Regenerate
-</Button>
-```
-
-**File: `frontend/src/pages/Writer/ContentView.tsx`**
-
-Add regenerate for featured image:
-
-```typescript
-// In featured image section (admin/editor only)
-{(user.role === 'admin' || user.role === 'editor') && (
-  <Button onClick={() => handleRegenerateFeaturedImage(content.id)}>
-    Regenerate Featured Image
-  </Button>
-)}
-```
-
-### 5.3.3 Verification
-
-- [ ] Regenerate button appears on `/writer/images` page
-- [ ] Regenerate modal prompts for reason
-- [ ] API call succeeds and image regenerates
-- [ ] Status updates correctly
-- [ ] Featured image regenerate works in content view
-- [ ] Role-based visibility works (admin/editor only)
-
----
-
-## 5.4 User Flow Polish
-
-### 5.4.1 Signup to First Content Flow Testing
-
-**Test Checklist:**
-
-| Step | URL | Verify |
-|------|-----|--------|
-| 1. Signup | `/signup` | Form submits, verification email sent |
-| 2. Verify Email | `/verify-email?token=...` | Email verified, redirect to app |
-| 3. Onboarding | `/setup/wizard` | All steps complete without errors |
-| 4. Add Site | Sites → Add Site | WordPress connection successful |
-| 5. Add Keywords | `/planner/keywords` | Import works, keywords appear |
-| 6. Clustering | `/planner/clusters` | AI clustering completes |
-| 7. Generate Content | `/writer/tasks` | Content generates successfully |
-| 8. Publish | Content → Publish | Content appears on WordPress |
-
-### 5.4.2 Issue Documentation Template
-
-```markdown
-## Issue: [Brief Description]
-
-**Step:** [Which step in flow]
-**URL:** [Page URL]
-**Expected:** [What should happen]
-**Actual:** [What happened]
-**Steps to Reproduce:**
-1. ...
-2. ...
-
-**Screenshots/Logs:** [Attach if applicable]
-**Severity:** [Blocking/Major/Minor]
-```
-
-### 5.4.3 Post-Implementation Verification
-
-```bash
-# Build and test
-cd /data/app/igny8/frontend
-npm run build
-npm run lint
-
-# Commit
-git add -A
-git commit -m "Phase 5: UX improvements - search modal, image regeneration, flow polish"
-```
-
----
-
-# Phase 6: Data Backup & Cleanup
-
-## 6.1 Pre-Backup Safety Steps
-
-### 6.1.1 Create Backup Branch
-```bash
-cd /data/app/igny8
-git checkout main
-git checkout -b backup/pre-v1-cleanup-$(date +%Y%m%d)
-```
-
-### 6.1.2 Full Database Backup
-```bash
-# Create backup directory
-mkdir -p /data/app/igny8/backups/$(date +%Y%m%d)
-
-# PostgreSQL full backup
-pg_dump -h localhost -U your_user -d igny8_db > /data/app/igny8/backups/$(date +%Y%m%d)/full_backup.sql
-
-# Verify backup
-ls -la /data/app/igny8/backups/$(date +%Y%m%d)/
-head -50 /data/app/igny8/backups/$(date +%Y%m%d)/full_backup.sql
-```
-
-**✅ CHECKPOINT:** Backup file exists and has content.
-
----
-
-## 6.2 System Configuration Export
-
-### 6.2.1 Create Export Directory Structure
-```bash
-mkdir -p /data/app/igny8/backups/config
-```
-
-### 6.2.2 Export Django Models (System Config)
-
-**Create management command:**
-```bash
-# File: backend/igny8_core/management/commands/export_system_config.py
-```
-
-```python
-# backend/igny8_core/management/commands/export_system_config.py
-from django.core.management.base import BaseCommand
-from django.core import serializers
-import json
-import os
-from datetime import datetime
-
-class Command(BaseCommand):
-    help = 'Export system configuration data to JSON files'
-
-    def add_arguments(self, parser):
-        parser.add_argument(
-            '--output-dir',
-            default='backups/config',
-            help='Output directory for config files'
-        )
-
-    def handle(self, *args, **options):
-        output_dir = options['output_dir']
-        os.makedirs(output_dir, exist_ok=True)
-        
-        # Import models here to avoid circular imports
-        from igny8_core.modules.billing.models import Plan, CreditCostConfig
-        from igny8_core.modules.system.models import (
-            AIModelConfig, GlobalIntegrationSettings, SystemSettings
-        )
-        from igny8_core.auth.models import Industry, Sector, SeedKeyword
-        # Add other system models as needed
-        
-        exports = {
-            'plans': Plan.objects.all(),
-            'credit_costs': CreditCostConfig.objects.all(),
-            'ai_models': AIModelConfig.objects.all(),
-            # 'global_integrations': GlobalIntegrationSettings.objects.all(),
-            # 'system_settings': SystemSettings.objects.all(),
-            'industries': Industry.objects.all(),
-            'sectors': Sector.objects.all(),
-            'seed_keywords': SeedKeyword.objects.all(),
-        }
-        
-        for name, queryset in exports.items():
-            try:
-                data = serializers.serialize('json', queryset, indent=2)
-                filepath = os.path.join(output_dir, f'{name}.json')
-                with open(filepath, 'w') as f:
-                    f.write(data)
-                self.stdout.write(
-                    self.style.SUCCESS(f'Exported {queryset.count()} {name} to {filepath}')
-                )
-            except Exception as e:
-                self.stdout.write(
-                    self.style.ERROR(f'Failed to export {name}: {str(e)}')
-                )
-        
-        # Export timestamp
-        with open(os.path.join(output_dir, 'export_metadata.json'), 'w') as f:
-            json.dump({
-                'exported_at': datetime.now().isoformat(),
-                'exports': list(exports.keys())
-            }, f, indent=2)
-        
-        self.stdout.write(self.style.SUCCESS('System config export complete!'))
-```
-
-### 6.2.3 Run Export
-
-```bash
-cd /data/app/igny8/backend
-
-# Run the export command
-python manage.py export_system_config --output-dir=../backups/config
-
-# Verify exports
-ls -la ../backups/config/
-```
-
-**✅ CHECKPOINT:** All config JSON files exist and contain data.
-
----
-
-## 6.3 User Data Cleanup
-
-### ⚠️ DANGER ZONE - READ CAREFULLY ⚠️
-
-This section PERMANENTLY DELETES user data. Ensure:
-1. Full backup completed (6.1.2)
-2. Config exported (6.2)
-3. You are in the correct environment (NOT PRODUCTION until ready)
-
-### 6.3.1 Create Cleanup Management Command
-
-```python
-# backend/igny8_core/management/commands/cleanup_user_data.py
-from django.core.management.base import BaseCommand
-from django.db import transaction
-
-class Command(BaseCommand):
-    help = 'Clean up all user-generated data (DESTRUCTIVE)'
-
-    def add_arguments(self, parser):
-        parser.add_argument(
-            '--confirm',
-            action='store_true',
-            help='Confirm you want to delete all user data'
-        )
-        parser.add_argument(
-            '--dry-run',
-            action='store_true',
-            help='Show what would be deleted without deleting'
-        )
-
-    def handle(self, *args, **options):
-        if not options['confirm'] and not options['dry_run']:
-            self.stdout.write(
-                self.style.ERROR('Must use --confirm or --dry-run flag')
-            )
-            return
-        
-        # Import models
-        from igny8_core.auth.models import Site
-        from igny8_core.business.planning.models import Keywords, Clusters
-        from igny8_core.modules.writer.models import (
-            ContentIdea, Task, Content, ContentImage
-        )
-        from igny8_core.modules.publisher.models import PublishingRecord, SyncEvent
-        from igny8_core.modules.billing.models import CreditTransaction, CreditUsageLog
-        # Add other models
-        
-        models_to_clear = [
-            ('Keywords', Keywords),
-            ('Clusters', Clusters),
-            ('ContentIdeas', ContentIdea),
-            ('Tasks', Task),
-            ('Content', Content),
-            ('ContentImages', ContentImage),
-            ('PublishingRecords', PublishingRecord),
-            ('SyncEvents', SyncEvent),
-            ('CreditTransactions', CreditTransaction),
-            ('CreditUsageLogs', CreditUsageLog),
-            # Sites should be last (foreign keys)
-            ('Sites', Site),
-        ]
-        
-        if options['dry_run']:
-            self.stdout.write(self.style.WARNING('DRY RUN - No data will be deleted'))
-            for name, model in models_to_clear:
-                count = model.objects.count()
-                self.stdout.write(f'  Would delete {count} {name}')
-            return
-        
-        # Actual deletion
-        with transaction.atomic():
-            for name, model in models_to_clear:
-                count = model.objects.count()
-                model.objects.all().delete()
-                self.stdout.write(
-                    self.style.SUCCESS(f'Deleted {count} {name}')
-                )
-        
-        self.stdout.write(self.style.SUCCESS('User data cleanup complete!'))
-```
-
-### 6.3.2 Execute Cleanup (Step by Step)
-
-```bash
-cd /data/app/igny8/backend
-
-# Step 1: DRY RUN - See what will be deleted
-python manage.py cleanup_user_data --dry-run
-
-# Step 2: Review output carefully
-# - Are the counts expected?
-# - Is this the right environment?
-
-# Step 3: ONLY if absolutely sure, run actual cleanup
-python manage.py cleanup_user_data --confirm
-```
-
-### 6.3.3 Clear Media Storage
-
-```bash
-# List media files first
-ls -la /data/app/igny8/backend/media/
-
-# Backup media if needed
-cp -r /data/app/igny8/backend/media/ /data/app/igny8/backups/$(date +%Y%m%d)/media/
-
-# Clear generated images (be specific about paths)
-rm -rf /data/app/igny8/backend/media/generated_images/*
-rm -rf /data/app/igny8/backend/media/content_images/*
-
-# Verify
-ls -la /data/app/igny8/backend/media/
-```
-
-### 6.3.4 Clear Logs
-
-```bash
-# Backup logs first
-cp -r /data/app/igny8/backend/logs/ /data/app/igny8/backups/$(date +%Y%m%d)/logs/
-
-# Clear log files (keep empty files for app to write)
-> /data/app/igny8/backend/logs/publish-sync-logs/*.log
-> /data/app/igny8/backend/celerybeat-schedule
-
-# Or remove all logs
-rm -f /data/app/igny8/backend/logs/**/*.log
-```
-
----
-
-## 6.4 Configuration Lock (V1.0)
-
-### 6.4.1 Document Final Configuration
-
-Create documentation file:
-
-```bash
-mkdir -p /data/app/igny8/docs/90-REFERENCE/
-```
-
-```markdown
-# V1.0 Configuration Reference
-
-**Locked:** [DATE]
-**Version:** 1.0.0
-
-## Plans Configuration
-
-| Plan | Credits | Sites | Price | Interval |
-|------|---------|-------|-------|----------|
-| Starter | X | 1 | $X/mo | monthly |
-| Growth | X | 3 | $X/mo | monthly |
-| Scale | X | 10 | $X/mo | monthly |
-
-## Credit Costs
-
-| Operation | Cost |
-|-----------|------|
-| Basic Image | 1 credit |
-| Quality Image | 5 credits |
-| Premium Image | 15 credits |
-| Clustering | Token-based |
-| Content Generation | Token-based |
-
-## AI Model Configurations
-
-[Document all AI model settings]
-
----
-
-**CHANGE POLICY:** Any changes require version bump and documented release.
-```
-
-### 6.4.2 Git Tag for V1.0
-
-```bash
-cd /data/app/igny8
-
-# Ensure all changes committed
-git status
-git add -A
-git commit -m "Phase 6: Pre-launch cleanup complete"
-
-# Create annotated tag
-git tag -a v1.0.0 -m "IGNY8 V1.0.0 - Production Release"
-
-# Push tag
-git push origin v1.0.0
-```
-
----
-
-## 6.5 Post-Cleanup Verification
-
-### 6.5.1 Database Verification
-
-```bash
-cd /data/app/igny8/backend
-
-# Run Django check
-python manage.py check
-
-# Verify system config still exists
-python manage.py shell << 'EOF'
-from igny8_core.modules.billing.models import Plan
-from igny8_core.auth.models import Industry, Sector
-print(f"Plans: {Plan.objects.count()}")
-print(f"Industries: {Industry.objects.count()}")
-print(f"Sectors: {Sector.objects.count()}")
-EOF
-
-# Verify user data cleared
-python manage.py shell << 'EOF'
-from igny8_core.auth.models import Site
-from igny8_core.business.planning.models import Keywords
-print(f"Sites: {Site.objects.count()}")
-print(f"Keywords: {Keywords.objects.count()}")
-EOF
-```
-
-### 6.5.2 Application Verification
-
-```bash
-# Start backend
-cd /data/app/igny8/backend
-python manage.py runserver &
-
-# Start frontend
-cd /data/app/igny8/frontend
-npm run dev &
-
-# Manual checks:
-# 1. Can login as admin
-# 2. Dashboard loads (empty state)
-# 3. Plans visible in settings
-# 4. Can create new user account
-# 5. Onboarding flow works
-```
-
----
-
-# Execution Checklist
-
-## Phase 1 Checklist
-
-- [ ] Created safety branch
-- [ ] Ran baseline tests (all pass)
-- [ ] Deleted empty folders (6 folders)
-- [ ] Build succeeds after empty folder deletion
-- [ ] Deleted template/sample components (ecommerce, sample-componeents, charts, tables)
-- [ ] Build succeeds after template deletion
-- [ ] Deleted `CurrentProcessingCard.old.tsx`
-- [ ] Removed console.log statements (reviewed each)
-- [ ] ESLint passes with zero errors
-- [ ] TypeScript compiles without errors
-- [ ] Manual app verification complete
-- [ ] Changes committed
-
-## Phase 5 Checklist
-
-- [ ] Created feature branch
-- [ ] Researched existing search implementation
-- [ ] Implemented keyboard shortcut (Cmd/Ctrl+K)
-- [ ] Added search filters
-- [ ] Added recent searches
-- [ ] Improved results display
-- [ ] Added image regenerate to `/writer/images`
-- [ ] Added featured image regenerate to content view
-- [ ] Backend endpoint created/verified
-- [ ] Role-based visibility works
-- [ ] Tested full signup-to-publish flow
-- [ ] Documented any issues found
-- [ ] Changes committed
-
-## Phase 6 Checklist
-
-- [ ] Created backup branch
-- [ ] Full database backup created
-- [ ] Backup file verified (has content)
-- [ ] Created export_system_config command
-- [ ] Exported all system config (plans, industries, etc.)
-- [ ] Config files verified (JSON valid)
-- [ ] Created cleanup_user_data command
-- [ ] Ran dry-run cleanup (reviewed counts)
-- [ ] **CONFIRMED correct environment**
-- [ ] Executed user data cleanup
-- [ ] Cleared media storage
-- [ ] Backed up and cleared logs
-- [ ] Created V1.0 config documentation
-- [ ] Created git tag v1.0.0
-- [ ] Verified system config still exists
-- [ ] Verified user data cleared
-- [ ] Application starts and functions
-
----
-
-## Rollback Procedures
-
-### Phase 1 Rollback
-```bash
-git checkout main
-git branch -D cleanup/phase-1-*
-```
-
-### Phase 5 Rollback
-```bash
-git checkout main
-git branch -D feature/phase-5-ux-improvements
-```
-
-### Phase 6 Rollback (Database)
-```bash
-# Restore from backup
-psql -h localhost -U your_user -d igny8_db < /data/app/igny8/backups/YYYYMMDD/full_backup.sql
-
-# Restore media
-cp -r /data/app/igny8/backups/YYYYMMDD/media/* /data/app/igny8/backend/media/
-```
-
----
-
-**Document Owner:** IGNY8 Team  
-**Review:** Before each phase execution  
-**Approval Required:** Phase 6 cleanup requires explicit approval
diff --git a/docs/plans/implemented/PROMPT_ALIGNMENT_SUGGESTIONS.md b/docs/plans/implemented/PROMPT_ALIGNMENT_SUGGESTIONS.md
deleted file mode 100644
index 98473d2c..00000000
--- a/docs/plans/implemented/PROMPT_ALIGNMENT_SUGGESTIONS.md
+++ /dev/null
@@ -1,425 +0,0 @@
-# AI Prompt Alignment Suggestions
-
-**Date:** January 15, 2026
-
-## 🚨 CRITICAL FINDING: Data Loss Between Idea Generation & Content Generation
-
-**The Problem:** The idea generation AI creates detailed outlines with 6-10 H2 sections, but this outline structure is **never stored in the database**. Only basic fields (title, description text, keywords) are saved. When content generation runs, it has NO ACCESS to:
-- The planned section count (6? 8? 10?)
-- The section outline structure (h2_topic, coverage details)
-- The primary focus keywords
-- The covered keywords  
-- The target word count
-
-**Result:** Content generator uses a fixed template (6 sections, 1000-1200 words) that conflicts with the variable planning done by ideas generator (6-10 sections, 1200-1800 words).
-
-**Solution:** Either add a JSONField to store the complete idea structure, OR update the content prompt to work with limited information and pass available keyword/word count data.
-
----
-
-## Executive Summary
-
-After analyzing the current **Ideas Generation** and **Content Generation** prompts from the database, I've identified key areas where these prompts need better alignment to ensure consistency in content output.
-
----
-
-## Current State Analysis
-
-### Ideas Generation Prompt
-- Generates 3-7 content ideas per cluster
-- Defines 6-10 H2 sections per idea
-- Targets 1-2 primary focus keywords + 2-3 covered keywords (3-5 total)
-- AI-determined word count based on sections/keywords
-- Emphasizes completely different keywords per idea
-- Outputs strategic outline only (no detailed H3/formatting)
-
-### Content Generation Prompt
-- Targets 1000-1200 words
-- Requires exactly 6 H2 sections
-- Has rigid section format requirements (2 paragraphs, 2 lists, 1 table)
-- Detailed HTML structure specifications
-- Strict word count per paragraph (50-80 words)
-- Includes specific formatting rules for lists and tables
-
----
-
-## Key Inconsistencies Identified
-
-### 1. **Section Count Mismatch**
-- **Ideas Prompt:** 6-10 H2 sections (variable, AI-determined)
-- **Content Prompt:** Exactly 6 H2 sections (fixed)
-- **Issue:** Content generator cannot accommodate ideas with 7-10 sections
-
-### 2. **Word Count Flexibility**
-- **Ideas Prompt:** AI-determined based on topic complexity (typically 1200-1800 words)
-- **Content Prompt:** Fixed 1000-1200 words
-- **Issue:** Complex topics with 8-10 sections cannot fit in 1000-1200 words
-
-### 3. **Format Variety vs. Fixed Pattern**
-- **Ideas Prompt:** No formatting specifications (lets content generator decide)
-- **Content Prompt:** Rigid format (2 paragraphs, 2 lists, 1 table distributed)
-- **Issue:** Some topics need more lists/tables, others need more narrative
-
-### 4. **Keyword Coverage Alignment**
-- **Ideas Prompt:** 3-5 keywords total (1-2 primary + 2-3 covered)
-- **Content Prompt:** Primary keyword + secondary keywords (no clear limit)
-- **Alignment:** This is actually okay, but needs clearer instruction
-
----
-
-## Suggested Changes to Content Generation Prompt
-
-### Change 1: Dynamic Section Count
-**Current:**
-```
-### 1. WORD COUNT: 1000-1200 words target
-- Write 6 H2 sections
-```
-
-**Suggested:**
-```
-### 1. WORD COUNT AND SECTIONS
-
-**Use the section count from the provided outline:**
-- The outline specifies the number of H2 sections to write
-- Typically 6-10 H2 sections based on topic complexity
-- Write ALL sections from the outline
-
-**Word count calculation:**
-- Base: 150-180 words per H2 section
-- Introduction: 100-150 words
-- Total = (Number of H2 sections × 170) + 125
-- Example: 6 sections = ~1,145 words | 8 sections = ~1,485 words | 10 sections = ~1,825 words
-```
-
-### Change 2: Flexible Format Distribution
-**Current:**
-```
-### 2. SECTION FORMAT VARIETY
-**For 6 H2 sections, distribute as:**
-- 2 sections: Paragraphs ONLY 
-- 2 section: Paragraphs + Lists
-- 1 section: Paragraphs + Tables
-```
-
-**Suggested:**
-```
-### 2. SECTION FORMAT VARIETY
-
-**Format distribution (scales with section count):**
-
-**For 6-7 sections:**
-- 3-4 sections: Paragraphs ONLY
-- 2 sections: Paragraphs + Lists
-- 1 section: Paragraphs + Tables
-
-**For 8-9 sections:**
-- 4-5 sections: Paragraphs ONLY
-- 2-3 sections: Paragraphs + Lists
-- 1-2 sections: Paragraphs + Tables
-
-**For 10+ sections:**
-- 5-6 sections: Paragraphs ONLY
-- 3 sections: Paragraphs + Lists
-- 2 sections: Paragraphs + Tables
-
-**Rules (apply to all counts):**
-- Randomize which sections get which format
-- Never use same pattern for consecutive sections
-- Lists: 4-5 items, 15-20 words each
-- Tables: 4-5 columns, 5-6 rows with real data
-- Use block quotes randomly in non-table sections
-```
-
-### Change 3: Input Structure Alignment - CRITICAL FINDING
-
-**What's Currently Output in [IGNY8_IDEA]:**
-
-Based on code analysis (`backend/igny8_core/ai/functions/generate_content.py`), here's what's actually being passed:
-
-```python
-# From generate_content.py build_prompt():
-idea_data = f"Title: {task.title or 'Untitled'}\n"
-if task.description:
-    idea_data += f"Description: {task.description}\n"
-idea_data += f"Content Type: {task.content_type or 'post'}\n"
-idea_data += f"Content Structure: {task.content_structure or 'article'}\n"
-```
-
-**Current Output Format (Plain Text):**
-```
-Title: How to Build an Email List from Scratch
-Description: This guide covers the fundamentals of list building...
-Content Type: post
-Content Structure: guide
-```
-
-**What's Available But NOT Being Passed:**
-
-The ContentIdeas model has these fields:
-- ✅ `primary_focus_keywords` (CharField - "email list building")
-- ✅ `target_keywords` (CharField - "subscriber acquisition, lead magnets")
-- ✅ `estimated_word_count` (IntegerField - 1500)
-- ✅ `content_type` (CharField - "post")
-- ✅ `content_structure` (CharField - "guide")
-
-But the outline structure (intro_focus, main_sections array) is **NOT stored anywhere**:
-- ❌ No outline JSON stored in ContentIdeas model
-- ❌ No outline JSON stored in Tasks model
-- ❌ The AI generates the outline but it's only in the API response, never persisted
-
-**The Root Problem:**
-
-1. **Ideas Generator outputs** full JSON with outline:
-```json
-{
-  "title": "...",
-  "description": {
-    "overview": "...",
-    "outline": {
-      "intro_focus": "...",
-      "main_sections": [
-        {"h2_topic": "...", "coverage": "..."},
-        {"h2_topic": "...", "coverage": "..."},
-        ...6-10 sections...
-      ]
-    }
-  },
-  "primary_focus_keywords": "...",
-  "covered_keywords": "..."
-}
-```
-
-2. **Only these get saved** to ContentIdeas:
-   - `idea_title` = title
-   - `description` = description.overview (NOT the outline!)
-   - `primary_focus_keywords` = primary_focus_keywords
-   - `target_keywords` = covered_keywords
-   - `estimated_word_count` = estimated_word_count
-
-3. **Content Generator receives** (from Tasks):
-   - Just title and description text
-   - No section outline
-   - No keyword info
-   - No word count target
-
-**Why This Causes Misalignment:**
-- Content generator has NO IDEA how many sections were planned (6? 8? 10?)
-- Content generator doesn't know which keywords to target
-- Content generator doesn't know the word count goal
-- Content generator can't follow the planned outline structure
-
----
-
-**Recommended Solution Path:**
-
-**OPTION A: Store Full Idea JSON** (Best for Long-term)
-
-1. Add JSONField to ContentIdeas model:
-```python
-class ContentIdeas(models.Model):
-    # ... existing fields ...
-    idea_json = models.JSONField(
-        default=dict,
-        blank=True,
-        help_text="Complete idea structure from AI generation (outline, keywords, sections)"
-    )
-```
-
-2. Update generate_ideas.py to save full JSON:
-```python
-# In save_output method:
-content_idea = ContentIdeas.objects.create(
-    # ... existing fields ...
-    idea_json=idea_data,  # Store the complete JSON structure
-)
-```
-
-3. Update generate_content.py to use full structure:
-```python
-# In build_prompt method:
-if task.idea and task.idea.idea_json:
-    # Pass full JSON structure
-    idea_data = json.dumps(task.idea.idea_json, indent=2)
-else:
-    # Fallback to current simple format
-    idea_data = f"Title: {task.title}\nDescription: {task.description}\n"
-```
-
-4. Update Content Generation prompt INPUT section:
-```
-## INPUT
-
-**CONTENT IDEA:**
-[IGNY8_IDEA]
-
-Expected JSON structure:
-{
-  "title": "Article title",
-  "description": {
-    "overview": "2-3 sentence description",
-    "outline": {
-      "intro_focus": "What the introduction should establish",
-      "main_sections": [
-        {"h2_topic": "Section heading", "coverage": "What to cover"},
-        ... array of 6-10 sections ...
-      ]
-    }
-  },
-  "primary_focus_keywords": "1-2 main keywords",
-  "covered_keywords": "2-3 supporting keywords",
-  "estimated_word_count": 1500,
-  "content_type": "post",
-  "content_structure": "guide_tutorial"
-}
-
-**KEYWORD CLUSTER:**
-[IGNY8_CLUSTER]
-
-**KEYWORDS:**
-[IGNY8_KEYWORDS]
-
-**INSTRUCTIONS:**
-- Use the exact number of H2 sections from main_sections array
-- Each H2 section should follow the h2_topic and coverage from the outline
-- Target the word count from estimated_word_count (±100 words)
-- Focus on primary_focus_keywords and covered_keywords for SEO
-```
-
-**OPTION B: Quick Fix - Pass Available Fields** (Can implement immediately without DB changes)
-
-Update generate_content.py:
-```python
-# In build_prompt method:
-idea_data = f"Title: {task.title or 'Untitled'}\n"
-if task.description:
-    idea_data += f"Description: {task.description}\n"
-idea_data += f"Content Type: {task.content_type or 'post'}\n"
-idea_data += f"Content Structure: {task.content_structure or 'article'}\n"
-
-# ADD: Pull from related idea if available
-if task.idea:
-    if task.idea.primary_focus_keywords:
-        idea_data += f"Primary Focus Keywords: {task.idea.primary_focus_keywords}\n"
-    if task.idea.target_keywords:
-        idea_data += f"Covered Keywords: {task.idea.target_keywords}\n"
-    if task.idea.estimated_word_count:
-        idea_data += f"Target Word Count: {task.idea.estimated_word_count}\n"
-```
-
-Then update Content Generation prompt:
-```
-## INPUT
-
-**CONTENT IDEA:**
-[IGNY8_IDEA]
-
-Format:
-- Title: Article title
-- Description: Content overview
-- Content Type: post|page|product
-- Content Structure: article|guide|comparison|review|listicle
-- Primary Focus Keywords: 1-2 main keywords (if available)
-- Covered Keywords: 2-3 supporting keywords (if available)
-- Target Word Count: Estimated words (if available)
-
-**NOTE:** Generate 6-8 H2 sections based on content_structure type. Scale word count to match Target Word Count if provided (±100 words acceptable).
-```
-
-### Change 4: Keyword Usage Clarity
-**Current:**
-```
-## KEYWORD USAGE
-
-**Primary keyword** (identify from title):
-- Use in title, intro, meta title/description
-- Include in 2-3 H2 headings naturally
-- Mention 2-3 times in content (0.5-1% density)
-
-**Secondary keywords** (3-4 from keyword list):
-- Distribute across H2 sections
-- Use in H2/H3 headings where natural
-- 2-3 mentions each (0.3-0.6% density)
-- Include variations and related terms
-```
-
-**Suggested:**
-```
-## KEYWORD USAGE
-
-**Primary focus keywords** (1-2 from IGNY8_IDEA.primary_focus_keywords):
-- Already in the provided title (use it as-is)
-- Include in 2-3 H2 headings naturally (outline already targets this)
-- Mention 2-3 times in content (0.5-1% density)
-
-**Covered keywords** (2-3 from IGNY8_IDEA.covered_keywords):
-- Distribute across H2 sections
-- Use in H2/H3 headings where natural (outline may already include them)
-- 2-3 mentions each (0.3-0.6% density)
-- Include variations and related terms
-
-**Total keyword target:** 3-5 keywords (1-2 primary + 2-3 covered)
-```
-
-### Change 5: Verification Checklist Update
-**Current:**
-```
-## VERIFICATION BEFORE OUTPUT
-
-- [ ] 1000-1200 words ONLY (excluding HTML tags) - STOP if exceeding
-- [ ] 6 H2 sections
-- [ ] Maximum 2 sections with lists
-- [ ] Maximum 2 sections with tables
-```
-
-**Suggested:**
-```
-## VERIFICATION BEFORE OUTPUT
-
-- [ ] Word count matches outline's estimated_word_count (±100 words acceptable)
-- [ ] Number of H2 sections matches outline's main_sections count
-- [ ] Format distribution scales appropriately with section count
-- [ ] All sections from outline are covered
-- [ ] Primary focus keywords (1-2) used correctly
-- [ ] Covered keywords (2-3) distributed naturally
-- [ ] All paragraphs 50-80 words
-- [ ] All lists 4-5 items, 15-20 words each
-- [ ] All tables 4-5 columns, 5-6 rows, real data
-- [ ] No placeholder content anywhere
-- [ ] Meta title <60 chars, description <160 chars
-- [ ] Valid JSON with escaped quotes
-```
-
----
-
-## Summary of Benefits
-
-### With These Changes:
-1. ✅ **Flexibility:** Content generator can handle 6-10 sections from ideas
-2. ✅ **Consistency:** Section count matches between idea and content generation
-3. ✅ **Scalability:** Word count scales naturally with complexity
-4. ✅ **Quality:** Format variety adapts to content needs
-5. ✅ **Alignment:** Clear keyword strategy (1-2 primary + 2-3 covered = 3-5 total)
-6. ✅ **Maintainability:** One source of truth for section structure (the outline)
-
-### Key Principle:
-**The Ideas Generator is the strategic planner** (decides sections, word count, keywords)
-**The Content Generator is the tactical executor** (follows the plan, adds formatting/depth)
-
----
-
-## Implementation Notes
-
-- These changes maintain all quality requirements (word count per paragraph, list/table specs, etc.)
-- The rigid structure is replaced with scalable rules that maintain quality at any section count
-- The content generator becomes more flexible while maintaining consistency
-- Both prompts now work together as a cohesive system
-
----
-
-## Next Steps
-
-1. Update the `content_generation` prompt in the database with suggested changes
-2. Test with various section counts (6, 8, 10 sections) to verify scalability
-3. Monitor output quality to ensure formatting rules scale properly
-4. Consider creating a validation layer that checks idea/content alignment before generation
diff --git a/docs/plans/implemented/PUBLISHING-ONBOARDING-IMPLEMENTATION-PLAN.md b/docs/plans/implemented/PUBLISHING-ONBOARDING-IMPLEMENTATION-PLAN.md
deleted file mode 100644
index 485aa8b7..00000000
--- a/docs/plans/implemented/PUBLISHING-ONBOARDING-IMPLEMENTATION-PLAN.md
+++ /dev/null
@@ -1,898 +0,0 @@
-# Publishing & Onboarding Implementation Plan
-
-**Created:** January 1, 2026  
-**Status:** Planning  
-**Priority:** High  
-**Scope:** App-level changes (IGNY8 Backend + Frontend)
-
----
-
-> ## ⚠️ CRITICAL: DO NOT BREAK EXISTING FUNCTIONALITY
-> 
-> **The current "Publish to Site" button in the dropdown menu is WORKING PERFECTLY.**
-> 
-> This manual publish functionality MUST continue to work throughout ALL implementation phases:
-> - Content dropdown → "Publish to Site" button → Successfully publishes content to WordPress
-> - This is the core publishing feature that users rely on
-> - Each phase of implementation MUST be tested to ensure this functionality remains intact
-> - If any change breaks manual publishing, STOP and fix immediately before proceeding
-> 
-> **Testing Required After EVERY Section:**
-> 1. Manual "Publish to Site" button still works
-> 2. Content successfully appears on WordPress site
-> 3. Status updates correctly after publishing
-> 4. No console errors or API failures
-
----
-
-## Table of Contents
-
-1. [Executive Summary](#1-executive-summary)
-2. [Bug Fixes (Immediate)](#2-bug-fixes-immediate)
-3. [Status System Redesign](#3-status-system-redesign)
-4. [Publishing Settings Relocation](#4-publishing-settings-relocation)
-5. [Internal Publishing Scheduler](#5-internal-publishing-scheduler)
-6. [Simplified Onboarding Flow](#6-simplified-onboarding-flow)
-7. [UI Wording Consistency Audit](#7-ui-wording-consistency-audit)
-8. [Platform-Agnostic Terminology](#8-platform-agnostic-terminology)
-9. [Metrics Integration](#9-metrics-integration---published-to-site)
-10. [Automation Settings Verification](#10-automation-settings-verification)
-11. [WordPress Bridge Plugin Changes](#11-wordpress-bridge-plugin-changes-reference-only)
-12. [Implementation Order](#12-implementation-order)
-13. [Summary Checklist](#13-summary-checklist)
-
----
-
-## 1. Executive Summary
-
-### Goals
-
-1. **Fix critical bugs** - Sites dashboard error, edit URL issues
-2. **Clarify status terminology** - Separate "Approved" (internal) from "Published" (on site)
-3. **Site-level publishing settings** - Move from account-wide to per-site configuration
-4. **Internal scheduling** - Control when content publishes to external sites
-5. **Simplified onboarding** - Defaults-first approach for new users
-6. **Platform-agnostic language** - Prepare for Shopify and custom integrations
-
-### Current State Problems
-
-| Problem | Location | Impact |
-|---------|----------|--------|
-| `ComponentCard` not defined | Sites Dashboard | Page crashes |
-| Edit URLs have `undefined` | ContentViewTemplate | Broken navigation |
-| "Published" used prematurely | Stage 7, Approved page | User confusion |
-| Publishing settings not integrated | /account/content-settings/publishing | Settings do nothing |
-| No publishing scheduler | Backend | Content stuck waiting |
-| WordPress-specific language | Throughout app | Limits future integrations |
-| "Published to Site" metric missing | Planner, Writer, Footer, Dashboard, Automation | Incomplete metrics |
-| Auto-publish settings not enforced | Run Now & Scheduled automation | Settings ignored |
-
----
-
-## 2. Bug Fixes (Immediate)
-
-### 2.1 Sites Dashboard - ComponentCard Error
-
-**File:** `frontend/src/pages/Sites/Dashboard.tsx`
-
-**Issue:** Line 259 uses `ComponentCard` and lines 185, 334 use `Card`, but neither are imported. Also `ArrowUpIcon` is used but not imported.
-
-**Fix:**
-- Add import for `ComponentCard` from `../../components/common/ComponentCard`
-- Add import for `Card` from `../../components/ui/card`
-- Add import for `ArrowUpIcon` from `../../icons`
-
----
-
-### 2.2 Edit URL - Undefined Site ID
-
-**File:** `frontend/src/templates/ContentViewTemplate.tsx`
-
-**Issue:** Lines 1011 and 1031 use `content.site_id` for edit navigation, but `site_id` is not returned in the Content API response.
-
-**Root Cause:** `ContentSerializer` has `site_id = serializers.IntegerField(write_only=True, required=False)` - the `write_only=True` prevents it from being returned in responses.
-
-**Fix - Backend:**
-- File: `backend/igny8_core/modules/writer/serializers.py`
-- Line ~166: Change `site_id` from `write_only=True` to `read_only=True`
-- Also add `site_id` to the serializer's `fields` list if not already included for reads
-
-**Fix - Frontend (Defensive):**
-- File: `frontend/src/services/api.ts`
-- Line ~2211: Add `site_id?: number;` to the `Content` interface
-
----
-
-### 2.3 Approved Page - Edit Action Not Working
-
-**File:** `frontend/src/pages/Writer/Approved.tsx`
-
-**Issue:** Line 222 `handleRowAction` for 'edit' action navigates to `/writer/content?id=${row.id}` which is incorrect format.
-
-**Fix:** Change navigation to proper edit URL format:
-```
-navigate(`/sites/${row.site_id}/posts/${row.id}/edit`)
-```
-
-Note: Requires site_id fix from 2.2 to work properly.
-
----
-
-## 3. Status System Redesign
-
-### 3.1 Current Status Flow
-
-```
-draft → review → published (backend)
-                    ↓
-              "Approved" (frontend label)
-                    ↓
-              "Published to Site" (manual action)
-```
-
-**Problems:**
-- Backend status `published` doesn't mean "on external site"
-- Frontend calls it "Approved" but backend calls it "published"
-- No distinction between "ready to publish" and "actually published"
-
-### 3.2 Proposed Status Flow
-
-**Option A: Add `approved` Status to Backend (Recommended)**
-
-```
-draft → review → approved → published
-                    ↓           ↓
-              Ready for     Actually on
-              publishing    external site
-```
-
-**Backend Model Changes:**
-- File: `backend/igny8_core/business/content/models.py`
-- Line ~271: Add `('approved', 'Approved')` to `STATUS_CHOICES`
-
-**Migration Required:**
-- Update existing `status='published'` where `external_id IS NULL` to `status='approved'`
-
-**Option B: Use Existing Status + Site Status Field (Alternative)**
-
-Add new field `site_status` to track external publication status separately:
-
-```python
-SITE_STATUS_CHOICES = [
-    ('not_published', 'Not Published'),
-    ('scheduled', 'Scheduled'),
-    ('publishing', 'Publishing'),
-    ('published', 'Published'),
-    ('failed', 'Failed'),
-]
-site_status = models.CharField(max_length=50, choices=SITE_STATUS_CHOICES, default='not_published')
-```
-
-### 3.3 Files to Update for Status Changes
-
-| File | Changes |
-|------|---------|
-| `backend/igny8_core/business/content/models.py` | Add `approved` status |
-| `backend/igny8_core/business/automation/services/automation_service.py` | Stage 7: Change to `approved` not `published` |
-| `backend/igny8_core/tasks/wordpress_publishing.py` | Query for `approved` status |
-| `frontend/src/services/api.ts` | Update Content interface status type |
-| `frontend/src/pages/Writer/Approved.tsx` | Filter by `approved` status |
-| `frontend/src/pages/Writer/Review.tsx` | No change (still filters `review`) |
-| `frontend/src/templates/ContentViewTemplate.tsx` | Update status badge labels |
-
----
-
-## 4. Publishing Settings Relocation
-
-### 4.1 Current State
-
-- Location: `/account/content-settings/publishing`
-- File: `frontend/src/pages/Settings/Publishing.tsx`
-- Status: **Not integrated with backend** - settings don't persist or work
-
-### 4.2 Proposed State
-
-Move publishing settings to **Site-level** configuration.
-
-**New Location:** `/sites/{id}/settings` → Publishing tab
-
-### 4.3 Backend Changes
-
-**New Model: PublishingSettings**
-
-File: `backend/igny8_core/business/integration/models.py`
-
-```
-PublishingSettings
-├── site (FK to Site)
-├── account (FK to Account)
-├── auto_publish_enabled (Boolean, default=True)
-├── auto_approval_enabled (Boolean, default=True)
-├── daily_publish_limit (Integer, default=3)
-├── weekly_publish_limit (Integer, default=15)
-├── monthly_publish_limit (Integer, default=50)
-├── publish_days (JSONField, default=['mon','tue','wed','thu','fri'])
-├── publish_time_slots (JSONField, default=['09:00','14:00','18:00'])
-├── created_at (DateTime)
-├── updated_at (DateTime)
-```
-
-**New API Endpoints:**
-
-File: `backend/igny8_core/modules/integration/views.py`
-
-| Endpoint | Method | Purpose |
-|----------|--------|---------|
-| `/v1/integration/sites/{site_id}/publishing-settings/` | GET | Get publishing settings for site |
-| `/v1/integration/sites/{site_id}/publishing-settings/` | PUT | Update publishing settings |
-
-**New Serializer:**
-
-File: `backend/igny8_core/modules/integration/serializers.py`
-
-- `PublishingSettingsSerializer` with all fields
-
-### 4.4 Frontend Changes
-
-**Remove/Deprecate:**
-- File: `frontend/src/pages/Settings/Publishing.tsx`
-- Remove from routing in `App.tsx`
-- Remove sidebar link if exists
-
-**Add to Site Settings:**
-
-File: `frontend/src/pages/Sites/Settings.tsx`
-
-- Add "Publishing" tab alongside General, Integrations, Content Types
-- Create new component: `frontend/src/components/sites/PublishingSettings.tsx`
-
-**New Component Structure:**
-
-```
-PublishingSettings.tsx
-├── Auto-Approval Toggle (with explanation)
-├── Auto-Publish Toggle (with explanation)
-├── Daily Limit Input (1-10, default 3)
-├── Weekly Limit Input (1-50, default 15)
-├── Monthly Limit Input (1-200, default 50)
-├── Publish Days Checkboxes (Mon-Sun)
-├── Time Slots Input (add/remove times)
-└── Save Button
-```
-
----
-
-## 5. Internal Publishing Scheduler
-
-### 5.1 Overview
-
-Content flows: `approved` → `scheduled` → `published`
-
-IGNY8 controls **when** content is sent to external sites based on user's publishing settings.
-
-### 5.2 New Database Fields
-
-**Content Model Updates:**
-
-File: `backend/igny8_core/business/content/models.py`
-
-Add fields:
-- `scheduled_publish_at` (DateTimeField, null=True) - When content should publish
-- `site_status` (CharField) - External site status (not_published/scheduled/publishing/published/failed)
-- `site_status_updated_at` (DateTimeField, null=True) - Last status change
-
-### 5.3 New Celery Task: Publishing Scheduler
-
-**File:** `backend/igny8_core/tasks/publishing_scheduler.py`
-
-**Task:** `schedule_approved_content()`
-
-**Runs:** Every 1 hour via Celery Beat (changed from 5 minutes - less aggressive scheduling)
-
-**Logic:**
-1. Find all content with `status='approved'` and `site_status='not_published'`
-2. Group by site
-3. For each site:
-   - Load PublishingSettings
-   - Check daily/weekly/monthly limits (how many already published today/this week/this month)
-   - If under limits, check if current time matches any publish_time_slot
-   - If matches, mark content as `site_status='scheduled'` and set `scheduled_publish_at`
-   - Limit batch size per run
-
-**Task:** `process_scheduled_publications()`
-
-**Runs:** Every 5 minutes via Celery Beat (changed from 1 minute - reduced load)
-
-**Logic:**
-1. Find content where `site_status='scheduled'` and `scheduled_publish_at <= now()`
-2. For each content:
-   - Queue `publish_content_to_site.delay(content_id)`
-   - Set `site_status='publishing'`
-
-### 5.4 Celery Beat Schedule Updates
-
-**File:** `backend/igny8_core/celery.py`
-
-Add to `beat_schedule`:
-```python
-'schedule-approved-content': {
-    'task': 'igny8_core.tasks.publishing_scheduler.schedule_approved_content',
-    'schedule': crontab(minute=0),  # Every hour at :00
-},
-'process-scheduled-publications': {
-    'task': 'igny8_core.tasks.publishing_scheduler.process_scheduled_publications',
-    'schedule': crontab(minute='*/5'),  # Every 5 minutes
-},
-```
-
-### 5.5 Publishing Queue UI
-
-**New Page:** `/sites/{id}/publishing-queue`
-
-**File:** `frontend/src/pages/Sites/PublishingQueue.tsx`
-
-**Features:**
-- List of content with `site_status='scheduled'`
-- Shows scheduled publish date/time
-- Drag-drop to reorder queue (updates `scheduled_publish_at`)
-- Pause/unpause individual items
-- Calendar view showing distribution
-
----
-
-## 6. Simplified Onboarding Flow
-
-### 6.1 New User Journey (Defaults-First)
-
-```
-Step 1: Create Account (existing)
-           ↓
-Step 2: Add First Site
-         - Name, URL
-         - Hosting type (WordPress selected)
-         - Skip advanced settings → Use defaults
-           ↓
-Step 3: Install WordPress Plugin
-         - Show API key
-         - Test connection
-           ↓
-Step 4: Add First Keywords
-         - Bulk input or CSV import
-           ↓
-Step 5: Done! Show Dashboard
-         - "Your content pipeline is running"
-         - First content ETA based on queue
-```
-
-### 6.2 Default Settings (Applied Automatically)
-
-| Setting | Default Value | Location |
-|---------|---------------|----------|
-| Auto-approval | ON | PublishingSettings |
-| Auto-publish | ON | PublishingSettings |
-| Daily limit | 3 articles | PublishingSettings |
-| Weekly limit | 15 articles | PublishingSettings |
-| Monthly limit | 50 articles | PublishingSettings |
-| Publish days | Mon-Fri | PublishingSettings |
-| Publish times | 9am, 2pm, 6pm | PublishingSettings |
-| Automation enabled | ON | AutomationConfig |
-| Run frequency | Every 6 hours | AutomationConfig |
-
-### 6.3 Onboarding Wizard Component
-
-**File:** `frontend/src/components/onboarding/OnboardingWizard.tsx`
-
-**Steps Component Structure:**
-- `Step1Welcome` - Welcome message, value prop
-- `Step2AddSite` - Site name, URL, type
-- `Step3ConnectIntegration` - API key, plugin install guide, test
-- `Step4AddKeywords` - Keyword input, CSV upload
-- `Step5Complete` - Success, show dashboard preview
-
-**Triggers:**
-- Show wizard on first login (check account has no sites)
-- Can be dismissed and accessed later from Help menu
-
-### 6.4 Backend Defaults Service
-
-**File:** `backend/igny8_core/business/integration/services/defaults_service.py`
-
-**Function:** `create_site_with_defaults(account, site_data)`
-
-**Actions:**
-1. Create Site
-2. Create PublishingSettings with defaults
-3. Create AutomationConfig with defaults
-4. Return site + settings
-
----
-
-## 7. UI Wording Consistency Audit
-
-### 7.1 Status Labels Mapping
-
-| Backend Status | Frontend Display | Badge Color |
-|----------------|------------------|-------------|
-| `draft` | Draft | Gray |
-| `review` | Ready for Review | Amber |
-| `approved` | Approved | Green |
-| `published` | On Site | Blue |
-
-**Contextual Labels:**
-
-| Page | Status Column Header | Values |
-|------|---------------------|--------|
-| Review Page | Status | Ready for Review, Draft |
-| Approved Page | Site Content Status | Approved (Pending), On Site |
-| Content View | Badge | Draft, Review, Approved, Published |
-
-### 7.2 Files Requiring Label Updates
-
-| File | Current | New |
-|------|---------|-----|
-| `frontend/src/pages/Writer/Approved.tsx` | "Content Approved" title | Keep (correct) |
-| `frontend/src/templates/ContentViewTemplate.tsx` | Status badge | Map `published` → "On Site" if `external_id`, else "Approved" |
-| `frontend/src/config/pages/approved.config.tsx` | Column headers | "Site Content Status" |
-| `frontend/src/components/dashboard/*.tsx` | Various metrics | Use consistent terms |
-
-### 7.3 Action Button Labels
-
-| Current | New | Reason |
-|---------|-----|--------|
-| "Publish to WordPress" | "Publish to Site" | Platform-agnostic |
-| "WordPress Status" | "Site Status" | Platform-agnostic |
-| "View on WordPress" | "View on Site" | Platform-agnostic |
-
----
-
-## 8. Platform-Agnostic Terminology
-
-### 8.1 String Replacements
-
-Search and replace across codebase:
-
-| Search | Replace | Scope |
-|--------|---------|-------|
-| "Publish to WordPress" | "Publish to Site" | UI labels only |
-| "WordPress status" | "Site status" | UI labels only |
-| "View on WordPress" | "View on Site" | UI labels only |
-| "WordPress Publishing" | "Site Publishing" | UI labels only |
-
-**Do NOT replace in:**
-- Backend API endpoint paths
-- WordPress-specific service classes
-- Plugin-related code
-- Technical documentation (keep WordPress references)
-
-### 8.2 Files to Update
-
-| File | Changes |
-|------|---------|
-| `frontend/src/components/WordPressPublish/WordPressPublish.tsx` | Button labels |
-| `frontend/src/components/WordPressPublish/ContentActionsMenu.tsx` | Menu item labels |
-| `frontend/src/pages/Writer/Review.tsx` | Action menu labels |
-| `frontend/src/pages/Writer/Approved.tsx` | Action menu labels |
-| `frontend/src/config/pages/table-actions.config.tsx` | Action labels |
-| `frontend/src/pages/Settings/Publishing.tsx` | Destination labels |
-
-### 8.3 Future-Proof Architecture
-
-**SiteIntegration Model** already supports multiple platforms via `platform` field:
-- `wordpress`
-- `shopify` (future)
-- `custom` (future)
-
-**Publishing Service** should route to appropriate adapter:
-- `WordPressAdapter`
-- `ShopifyAdapter` (future)
-- `CustomWebhookAdapter` (future)
-
----
-
-## 9. Metrics Integration - "Published to Site"
-
-### 9.1 Missing Metrics Audit
-
-The "Published to Site" metric is currently **MISSING** from the following locations:
-
-| Location | Component/File | Current State | Required Change |
-|----------|----------------|---------------|-----------------|
-| Planner Header | `frontend/src/pages/Planner/*.tsx` | No "Published" count | Add metric card |
-| Writer Header | Table actions row (above table) | No "Published" count | Add metric in header |
-| Footer Widget | `frontend/src/components/FooterWidget.tsx` | Missing from stats | Add "Published to Site" stat |
-| Main Dashboard | `frontend/src/pages/Dashboard/` | Incomplete metrics | Add dedicated metric card |
-| Automation Page | `frontend/src/pages/Automation/` | Missing from metrics | Add to stage summary |
-| Sites Dashboard | `frontend/src/pages/Sites/Dashboard.tsx` | May be missing | Verify and add if needed |
-
-### 9.2 Metric Query Requirements
-
-**Backend API Updates Needed:**
-
-File: `backend/igny8_core/modules/` (various)
-
-Add endpoints or update existing to return:
-- `published_to_site_count` - Content with `external_id IS NOT NULL`
-- `published_to_site_today` - Published to site in last 24 hours
-- `published_to_site_this_week` - Published to site in last 7 days
-- `published_to_site_this_month` - Published to site in last 30 days
-
-### 9.3 Frontend Metric Components
-
-**Files to Update:**
-
-| File | Change Required |
-|------|-----------------|
-| `frontend/src/pages/Planner/Keywords.tsx` | Add Published metric to header row |
-| `frontend/src/pages/Planner/Clusters.tsx` | Add Published metric to header row |
-| `frontend/src/pages/Writer/Review.tsx` | Add Published metric to header row |
-| `frontend/src/pages/Writer/Approved.tsx` | Add Published metric to header row |
-| `frontend/src/components/FooterWidget/FooterWidget.tsx` | Add Published stat |
-| `frontend/src/pages/Dashboard/Dashboard.tsx` | Add Published metric card |
-| `frontend/src/pages/Automation/AutomationPage.tsx` | Add Published to metrics section |
-
----
-
-## 10. Automation Settings Verification
-
-### 10.1 Run Now & Scheduled Automation Requirements
-
-Both **Manual "Run Now"** and **Automatic Scheduled** runs MUST respect the same settings:
-
-| Setting | Manual Run | Scheduled Run | Location |
-|---------|------------|---------------|----------|
-| Auto-Approve | ✅ Must check | ✅ Must check | Site PublishingSettings |
-| Auto-Publish to Site | ✅ Must check | ✅ Must check | Site PublishingSettings |
-| Daily Publish Limit | ✅ Must enforce | ✅ Must enforce | Site PublishingSettings |
-| Weekly Publish Limit | ✅ Must enforce | ✅ Must enforce | Site PublishingSettings |
-| Monthly Publish Limit | ✅ Must enforce | ✅ Must enforce | Site PublishingSettings |
-| Publish Days | N/A (manual) | ✅ Must check | Site PublishingSettings |
-| Publish Time Slots | N/A (manual) | ✅ Must check | Site PublishingSettings |
-
-### 10.2 Automation Service Updates Required
-
-**File:** `backend/igny8_core/business/automation/services/automation_service.py`
-
-**Stage 7 Processing Must:**
-1. Check if `auto_approval_enabled` in PublishingSettings
-   - If YES: Set status to `approved`
-   - If NO: Keep status as `review`
-2. Check if `auto_publish_enabled` in PublishingSettings
-   - If YES AND auto_approval enabled: Queue for site publishing
-   - If NO: Leave as `approved` (manual publish required)
-3. Respect all publishing limits when auto-publishing
-
-### 10.3 Settings Flow Verification Checklist
-
-```
-[Site Settings Page]
-        ↓
-[PublishingSettings Model]
-        ↓
-[Automation Service reads settings]
-        ↓
-[Stage 7 checks auto_approval]
-        ↓ (if enabled)
-[Sets status='approved']
-        ↓
-[Stage 7 checks auto_publish]
-        ↓ (if enabled)
-[Queues for scheduled publishing]
-        ↓
-[Publishing Scheduler picks up]
-        ↓
-[Respects daily/weekly/monthly limits]
-        ↓
-[Publishes to Site]
-```
-
----
-
-## 11. WordPress Bridge Plugin Changes (Reference Only)
-
-**Note:** This section is for reference. A separate plan will be created for plugin-level changes.
-
-### 11.1 Potential Plugin Updates Needed
-
-| Feature | Plugin Change Required |
-|---------|----------------------|
-| Scheduled posts | Accept `scheduled_at` in publish payload |
-| Post update | Handle PUT requests to existing posts |
-| Republish | Allow updating posts by content_id |
-| Image upload | Download and attach featured images |
-
-### 11.2 New Webhook Events (Future)
-
-| Event | Direction | Purpose |
-|-------|-----------|---------|
-| `content_scheduled` | App → WP | Notify WP of scheduled content |
-| `schedule_changed` | App → WP | Update scheduled time |
-| `post_updated` | WP → App | Notify of post edits |
-
----
-
-## 12. Implementation Order
-
-> **⚠️ IMPORTANT:** After completing EACH section, verify that manual "Publish to Site" button still works before proceeding to the next section.
-
----
-
-### Section 1: Critical Bug Fixes (Day 1)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 1.1 | Fix ComponentCard import | Sites/Dashboard.tsx | P0 |
-| 1.2 | Fix Card import | Sites/Dashboard.tsx | P0 |
-| 1.3 | Fix ArrowUpIcon import | Sites/Dashboard.tsx | P0 |
-| 1.4 | Fix site_id in API response | writer/serializers.py | P0 |
-| 1.5 | Add site_id to Content interface | api.ts | P0 |
-| 1.6 | Fix edit URL navigation | Approved.tsx | P0 |
-| 1.7 | Fix edit button URLs | ContentViewTemplate.tsx | P0 |
-
-**✅ Section 1 Verification:**
-- [ ] Sites Dashboard loads without errors
-- [ ] Edit buttons navigate correctly
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 2: Status System (Days 2-3)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 2.1 | Add `approved` status to Content model | content/models.py | P1 |
-| 2.2 | Create database migration | migrations/ | P1 |
-| 2.3 | Run migration on database | Django manage.py | P1 |
-| 2.4 | Update Stage 7 to set `approved` | automation_service.py | P1 |
-| 2.5 | Update frontend Content interface | api.ts | P1 |
-| 2.6 | Update Approved page filter | Approved.tsx | P1 |
-| 2.7 | Update status badges | ContentViewTemplate.tsx | P1 |
-| 2.8 | Update status config | config files | P1 |
-
-**✅ Section 2 Verification:**
-- [ ] New content from automation gets `approved` status
-- [ ] Approved page shows correct content
-- [ ] Status badges display correctly
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 3: Publishing Settings Model (Days 4-5)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 3.1 | Create PublishingSettings model | integration/models.py | P1 |
-| 3.2 | Create database migration | migrations/ | P1 |
-| 3.3 | Run migration on database | Django manage.py | P1 |
-| 3.4 | Create PublishingSettingsSerializer | integration/serializers.py | P1 |
-| 3.5 | Create API endpoints | integration/views.py | P1 |
-| 3.6 | Add URL routes | integration/urls.py | P1 |
-
-**✅ Section 3 Verification:**
-- [ ] API endpoints return 200 for GET/PUT
-- [ ] Settings save and retrieve correctly
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 4: Publishing Settings Frontend (Day 6)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 4.1 | Create PublishingSettings component | components/sites/PublishingSettings.tsx | P1 |
-| 4.2 | Add Publishing tab to Site Settings | Sites/Settings.tsx | P1 |
-| 4.3 | Create API service functions | api.ts | P1 |
-| 4.4 | Remove/deprecate old Publishing page | Settings/Publishing.tsx | P2 |
-| 4.5 | Update routing if needed | App.tsx | P2 |
-
-**✅ Section 4 Verification:**
-- [ ] Publishing tab visible in Site Settings
-- [ ] Settings UI loads and saves correctly
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 5: Automation Integration (Days 7-8)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 5.1 | Update Stage 7 to read PublishingSettings | automation_service.py | P1 |
-| 5.2 | Implement auto_approval check | automation_service.py | P1 |
-| 5.3 | Implement auto_publish check | automation_service.py | P1 |
-| 5.4 | Test with "Run Now" button | Manual testing | P1 |
-| 5.5 | Test with scheduled automation | Manual testing | P1 |
-
-**✅ Section 5 Verification:**
-- [ ] Run Now respects auto_approval setting
-- [ ] Run Now respects auto_publish setting
-- [ ] Scheduled run respects all settings
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 6: Publishing Scheduler Tasks (Days 9-10)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 6.1 | Add scheduled_publish_at field to Content | content/models.py | P1 |
-| 6.2 | Add site_status field to Content | content/models.py | P1 |
-| 6.3 | Create database migration | migrations/ | P1 |
-| 6.4 | Run migration on database | Django manage.py | P1 |
-| 6.5 | Create schedule_approved_content task | tasks/publishing_scheduler.py | P1 |
-| 6.6 | Create process_scheduled_publications task | tasks/publishing_scheduler.py | P1 |
-| 6.7 | Add tasks to Celery Beat (1 hour, 5 min) | celery.py | P1 |
-| 6.8 | Restart Celery Beat | Docker/service restart | P1 |
-
-**✅ Section 6 Verification:**
-- [ ] Celery Beat schedules appear in Flower
-- [ ] Tasks run at correct intervals
-- [ ] Content gets scheduled correctly
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 7: Metrics Integration (Days 11-12)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 7.1 | Add published_to_site counts to API | Backend views | P1 |
-| 7.2 | Add metric to Planner header | Planner pages | P1 |
-| 7.3 | Add metric to Writer header | Writer pages | P1 |
-| 7.4 | Add metric to Footer Widget | FooterWidget.tsx | P1 |
-| 7.5 | Add metric to Dashboard | Dashboard.tsx | P1 |
-| 7.6 | Add metric to Automation page | AutomationPage.tsx | P1 |
-
-**✅ Section 7 Verification:**
-- [ ] "Published to Site" metric shows in all locations
-- [ ] Counts are accurate
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 8: UI Consistency (Days 13-14)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 8.1 | Replace "WordPress" with "Site" in labels | Multiple frontend files | P2 |
-| 8.2 | Standardize status labels | Config files, templates | P2 |
-| 8.3 | Update tooltips and help text | Various | P2 |
-| 8.4 | Update documentation | WORDPRESS-INTEGRATION-FLOW.md | P3 |
-
-**✅ Section 8 Verification:**
-- [ ] UI labels are consistent
-- [ ] No "WordPress" in user-facing labels (except settings)
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 9: Publishing Queue UI (Optional - Day 15)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 9.1 | Create PublishingQueue page | Sites/PublishingQueue.tsx | P2 |
-| 9.2 | Add navigation link | Site dashboard/menu | P2 |
-| 9.3 | Implement drag-drop reordering | PublishingQueue.tsx | P2 |
-| 9.4 | Add calendar view | PublishingQueue.tsx | P3 |
-
-**✅ Section 9 Verification:**
-- [ ] Queue page loads correctly
-- [ ] Scheduled content displays
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-### Section 10: Onboarding (Days 16-18)
-
-| Task # | Task | Files | Priority |
-|--------|------|-------|----------|
-| 10.1 | Create defaults service | defaults_service.py | P2 |
-| 10.2 | Create OnboardingWizard component | OnboardingWizard.tsx | P2 |
-| 10.3 | Create wizard step components | onboarding/ folder | P2 |
-| 10.4 | Integrate wizard trigger | App.tsx or auth flow | P2 |
-| 10.5 | Test end-to-end onboarding | Manual testing | P2 |
-
-**✅ Section 10 Verification:**
-- [ ] Wizard triggers for new accounts
-- [ ] All steps complete successfully
-- [ ] Defaults are applied correctly
-- [ ] **Manual "Publish to Site" button still works**
-
----
-
-## 13. Summary Checklist
-
-### ⚠️ Critical: Preserve Working Functionality
-- [ ] **Manual "Publish to Site" button works after EVERY section**
-
-### Section 1: Bug Fixes
-- [ ] 1.1 Fix ComponentCard import in Sites Dashboard
-- [ ] 1.2 Fix Card import in Sites Dashboard
-- [ ] 1.3 Fix ArrowUpIcon import in Sites Dashboard
-- [ ] 1.4 Make site_id readable in ContentSerializer
-- [ ] 1.5 Add site_id to frontend Content interface
-- [ ] 1.6 Fix edit action navigation in Approved page
-- [ ] 1.7 Fix edit button URLs in ContentViewTemplate
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 2: Status System
-- [ ] 2.1 Add `approved` status to Content model
-- [ ] 2.2 Create database migration
-- [ ] 2.3 Run migration
-- [ ] 2.4 Update Stage 7 to set `approved` not `published`
-- [ ] 2.5 Update frontend Content interface
-- [ ] 2.6 Update Approved page filter
-- [ ] 2.7 Update status badges
-- [ ] 2.8 Update status config
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 3: Publishing Settings Backend
-- [ ] 3.1 Create PublishingSettings model
-- [ ] 3.2 Create database migration
-- [ ] 3.3 Run migration
-- [ ] 3.4 Create serializer
-- [ ] 3.5 Create API endpoints
-- [ ] 3.6 Add URL routes
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 4: Publishing Settings Frontend
-- [ ] 4.1 Create PublishingSettings component
-- [ ] 4.2 Add Publishing tab to Site Settings
-- [ ] 4.3 Create API service functions
-- [ ] 4.4 Remove/deprecate old Publishing page
-- [ ] 4.5 Update routing
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 5: Automation Integration
-- [ ] 5.1 Update Stage 7 to read PublishingSettings
-- [ ] 5.2 Implement auto_approval check
-- [ ] 5.3 Implement auto_publish check
-- [ ] 5.4 Test "Run Now" button
-- [ ] 5.5 Test scheduled automation
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 6: Publishing Scheduler
-- [ ] 6.1 Add scheduled_publish_at field to Content
-- [ ] 6.2 Add site_status field to Content
-- [ ] 6.3 Create database migration
-- [ ] 6.4 Run migration
-- [ ] 6.5 Create schedule_approved_content task (1 hour)
-- [ ] 6.6 Create process_scheduled_publications task (5 min)
-- [ ] 6.7 Add tasks to Celery Beat
-- [ ] 6.8 Restart Celery Beat
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 7: Metrics Integration
-- [ ] 7.1 Add published_to_site counts to API
-- [ ] 7.2 Add metric to Planner header
-- [ ] 7.3 Add metric to Writer header
-- [ ] 7.4 Add metric to Footer Widget
-- [ ] 7.5 Add metric to Dashboard
-- [ ] 7.6 Add metric to Automation page
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 8: UI Consistency
-- [ ] 8.1 Replace "WordPress" with "Site" in labels
-- [ ] 8.2 Standardize status labels
-- [ ] 8.3 Update tooltips and help text
-- [ ] 8.4 Update documentation
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 9: Publishing Queue (Optional)
-- [ ] 9.1 Create PublishingQueue page
-- [ ] 9.2 Add navigation link
-- [ ] 9.3 Implement drag-drop reordering
-- [ ] 9.4 Add calendar view
-- [ ] **✅ VERIFY: Publish to Site still works**
-
-### Section 10: Onboarding
-- [ ] 10.1 Create defaults service
-- [ ] 10.2 Create OnboardingWizard component
-- [ ] 10.3 Create wizard step components
-- [ ] 10.4 Integrate wizard trigger
-- [ ] 10.5 Test end-to-end onboarding
-- [ ] **✅ VERIFY: Publish to Site still works**
-
----
-
-**Document Version:** 2.0  
-**Last Updated:** January 1, 2026  
-**Author:** Development Team
diff --git a/docs/plans/implemented/PUBLISHING-PROGRESS-AND-SCHEDULING-UX-PLAN.md b/docs/plans/implemented/PUBLISHING-PROGRESS-AND-SCHEDULING-UX-PLAN.md
deleted file mode 100644
index f93f1f91..00000000
--- a/docs/plans/implemented/PUBLISHING-PROGRESS-AND-SCHEDULING-UX-PLAN.md
+++ /dev/null
@@ -1,1595 +0,0 @@
-# Publishing Progress & Scheduling UX Enhancement Plan
-
-## Document Overview
-
-**Author**: System Analysis  
-**Date**: January 2025  
-**Status**: Planning Phase  
-**Target**: Publishing UX improvements with progress tracking and scheduling interfaces for multi-platform publishing (WordPress, Shopify, Custom Sites)
-
----
-
-## 1. Executive Summary
-
-This document provides a comprehensive implementation plan for enhancing the publishing workflow with:
-
-1. **Publishing Progress Modals** - Real-time feedback for single and bulk publishing operations
-2. **Publishing Limits & Validation** - Direct bulk publish limited to 5 items, unlimited scheduling
-3. **Workflow Optimization** - Remove publish from Review page, make it Approved-only
-4. **Scheduling UI Enhancement** - Add scheduling/rescheduling interfaces across multiple pages
-5. **Site Settings Integration** - Bulk scheduling uses default settings from Site Settings → Publishing tab
-6. **Failed Content Handling** - UI for rescheduling failed scheduled publications
-
-### Key Design Principles
-
-- **Pattern Consistency**: Follow existing modal patterns from ImageQueueModal and content generation
-- **Progressive Disclosure**: Show appropriate details based on operation complexity
-- **Real-time Feedback**: Live progress updates during publishing operations
-- **Error Recovery**: Clear paths to retry/reschedule failed operations
-
----
-
-## 2. Current System Analysis
-
-### 2.1 Existing Publishing Architecture
-
-**Backend System (v2.0)**:
-- Service: `PublisherService` at `backend/igny8_core/business/publishing/services/publisher_service.py`
-- API Endpoint: `POST /api/v1/publisher/publish`
-- Credentials: Stored on `Site` model (`api_key`, `domain`, `platform_type`)
-- Supported Platforms: WordPress, Shopify, Custom Sites
-- Processing: Synchronous (not queued to Celery)
-- Site Settings: Default publishing/scheduling configuration at `/sites/{site_id}/settings?tab=publishing`
-
-**Scheduling System**:
-- Celery Beat Task: `process_scheduled_publications` (runs every 5 minutes)
-- Content States:
-  - `site_status`: `not_published` → `scheduled` → `publishing` → `published`/`failed`
-  - `scheduled_publish_at`: ISO8601 datetime
-  - `site_status_updated_at`: Timestamp of last status change
-- API Endpoints:
-  - `POST /api/v1/writer/content/{id}/schedule/` - Schedule for future publishing
-  - `POST /api/v1/writer/content/{id}/unschedule/` - Cancel scheduled publishing
-  - `POST /api/v1/writer/content/{id}/reschedule/` - Reschedule from any status (NEW)
-
-### 2.2 Current Publishing Workflows
-
-**Review Page** (`frontend/src/pages/Writer/Review.tsx`):
-- **Current Behavior**: Shows content with `status='review'`
-- **Actions Available**:
-  - Single publish: `handlePublishSingle()` → calls `POST /v1/publisher/publish/`
-  - Bulk publish: `handlePublishBulk()` → loops through items, publishes individually
-  - Approve (changes status to 'approved')
-- **Issue**: Publishing from Review bypasses approval workflow
-- **No Feedback**: No progress modal, only toast notifications
-- **Current Issue**: Uses "WordPress" terminology, limiting perceived platform support
-
-**Approved Page** (`frontend/src/pages/Writer/Approved.tsx`):
-- **Current Behavior**: Shows content with `status='approved'` or `status='published'`
-- **Actions Available**:
-  - Single publish: `handleRowAction('publish_site')` → `POST /v1/publisher/publish/` (no limit)
-  - Bulk publish: `handleBulkPublishToSite()` → loops through items (max 5 items)
-  - Bulk schedule: Uses site default settings (no limit on items)
-- **No Feedback**: No progress modal, only toast notifications
-- **No Scheduling**: Cannot schedule for future publishing from UI
-- **No Validation**: No limit enforcement for bulk operations
-- **Current Issue**: Action names reference specific platforms instead of generic "site" terminology
-
-**Content Calendar** (`frontend/src/pages/Publisher/ContentCalendar.tsx`):
-- **Current Behavior**: Shows scheduled items with calendar view
-- **Scheduling Method**: Drag-and-drop from approved sidebar to calendar dates
-- **Schedule Time**: Defaults to 9 AM on dropped date
-- **API Calls**:
-  - `scheduleContent(contentId, scheduledDate)` → `POST /v1/writer/content/{id}/schedule/`
-  - `unscheduleContent(contentId)` → `POST /v1/writer/content/{id}/unschedule/`
-- **No Edit UI**: Cannot edit scheduled time without drag-drop
-
-### 2.3 Existing Modal Patterns
-
-**ImageQueueModal** (`frontend/src/components/common/ImageQueueModal.tsx`):
-- **Purpose**: Shows AI image generation progress for multiple images
-- **Key Features**:
-  - Queue display with individual progress bars
-  - Status per item: `pending` → `processing` → `completed`/`failed`
-  - Smooth progress animation (1% → 50% in 5s, 50% → 80% at 2%/200ms, 80% → 100% on completion)
-  - Real-time polling: `GET /v1/system/settings/task_progress/{taskId}/` every 1 second
-  - Visual feedback: Status icons, color-coded progress bars
-  - Thumbnail preview on completion
-  - Cannot close while processing
-- **State Management**:
-  ```typescript
-  interface ImageQueueItem {
-    imageId: number | null;
-    index: number;
-    label: string;
-    status: 'pending' | 'processing' | 'completed' | 'failed';
-    progress: number;
-    imageUrl: string | null;
-    error: string | null;
-  }
-  ```
-- **Progress Tracking**:
-  - Backend provides: `current_image`, `current_image_id`, `current_image_progress`, `results[]`
-  - Frontend manages smooth animation with `smoothProgress` state
-  - Progress intervals cleared on completion/failure
-
----
-
-## 3. Publishing Progress Modal Implementation
-
-### 3.1 Single Content Publishing Modal
-
-**Component**: `PublishingProgressModal` (new)  
-**Location**: `frontend/src/components/common/PublishingProgressModal.tsx`
-
-#### Design Specifications
-
-**Modal Structure**:
-```
-┌────────────────────────────────────────────────────┐
-│ 🚀 Publishing Content                              │
-│ Publishing "Article Title Here" to [Site Name]     │
-├────────────────────────────────────────────────────┤
-│                                                     │
-│ ┌────────────────────────────────────────────────┐ │
-│ │ 📄 Preparing content...                   25%  │ │
-│ │ ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    │ │
-│ └────────────────────────────────────────────────┘ │
-│                                                     │
-│ Status: Uploading to WordPress...                  │
-│                                                     │
-├────────────────────────────────────────────────────┤
-│ [Close button - only shown on completion/error]    │
-└────────────────────────────────────────────────────┘
-```
-
-**Progress Stages**:
-1. **Preparing content** (0-25%): Validating content structure
-2. **Uploading to site** (25-50%): POST request to publishing platform API
-3. **Processing response** (50-75%): Handling platform API response
-4. **Finalizing** (75-100%): Updating content record
-
-**State Interface**:
-```typescript
-interface PublishingProgressState {
-  contentId: number;
-  contentTitle: string;
-  destination: 'wordpress' | 'shopify' | 'custom' | string; // Platform type
-  siteName: string; // Actual site name for display
-  status: 'preparing' | 'uploading' | 'processing' | 'finalizing' | 'completed' | 'failed';
-  progress: number; // 0-100
-  statusMessage: string;
-  error: string | null;
-  externalUrl: string | null; // Published URL on success
-  externalId: string | null; // External platform post/page ID
-}
-```
-
-**Progress Animation**:
-- **Phase 1** (0-25%): 1% every 100ms for 2.5 seconds
-- **Phase 2** (25-50%): During actual API call (may vary)
-- **Phase 3** (50-75%): 2% every 80ms for 1 second
-- **Phase 4** (75-100%): Fast animation on success (800ms)
-
-**Error Handling**:
-- Show error message in red alert box
-- Display "Retry" and "Close" buttons
-- Log full error for debugging
-- Option to copy error details
-
-**Success State**:
-- Green checkmark icon
-- "View on Site" button (opens `external_url` in new tab)
-- Shows actual site name: "View on [Site Name]"
-- "Close" button
-- Auto-close after 3 seconds (optional)
-
-#### API Integration
-
-**Endpoint**: `POST /api/v1/publisher/publish/`  
-**Request**:
-```json
-{
-  "content_id": 123,
-  "destinations": ["wordpress"] // Can be: "wordpress", "shopify", "custom"
-}
-```
-
-**Response** (success):
-```json
-{
-  "success": true,
-  "data": {
-    "success": true,
-    "results": [
-      {
-        "destination": "wordpress", // or "shopify", "custom"
-        "success": true,
-        "external_id": "456",
-        "url": "https://site.com/article-title/",
-        "publishing_record_id": 789,
-        "platform_type": "wordpress"
-      }
-    ]
-  }
-}
-```
-
-**Response** (failure):
-```json
-{
-  "success": false,
-  "error": "Publishing API error: Invalid credentials"
-}
-```
-
-**Since publishing is synchronous**, the modal flow:
-1. Open modal immediately on "Publish" click
-2. Show "Preparing" stage with progress 0-25%
-3. Make API call (update to "Uploading" at 25%)
-4. On response:
-   - Success: Animate 25% → 100% with status updates
-   - Failure: Show error state
-5. Update parent component's content list
-
-### 3.2 Bulk Publishing Modal
-
-**Component**: `BulkPublishingModal` (new)  
-**Location**: `frontend/src/components/common/BulkPublishingModal.tsx`
-
-#### Design Specifications
-
-**Modal Structure** (similar to ImageQueueModal):
-```
-┌──────────────────────────────────────────────────────────┐
-│ 🚀 Publishing Content                                    │
-│ Publishing 5 articles to [Site Name]                     │
-├──────────────────────────────────────────────────────────┤
-│                                                           │
-│ ┌────────────────────────────────────────────────────┐   │
-│ │ 1️⃣ First Article Title                      ✓ 100%│   │
-│ │ █████████████████████████████████████████████████  │   │
-│ │ Published: https://site.com/article-1/            │   │
-│ └────────────────────────────────────────────────────┘   │
-│                                                           │
-│ ┌────────────────────────────────────────────────────┐   │
-│ │ 2️⃣ Second Article Title                     ⏳ 45% │   │
-│ │ ████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │   │
-│ │ Status: Uploading to site...                      │   │
-│ └────────────────────────────────────────────────────┘   │
-│                                                           │
-│ ┌────────────────────────────────────────────────────┐   │
-│ │ 3️⃣ Third Article Title                       ⏸️ 0% │   │
-│ │ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │   │
-│ │ Status: Pending                                   │   │
-│ └────────────────────────────────────────────────────┘   │
-│                                                           │
-│ [2 more items...]                                        │
-│                                                           │
-├──────────────────────────────────────────────────────────┤
-│ 1 completed, 1 failed, 3 pending                        │
-│                                        [Close - if done] │
-└──────────────────────────────────────────────────────────┘
-```
-
-**Queue Item State**:
-```typescript
-interface PublishQueueItem {
-  contentId: number;
-  contentTitle: string;
-  index: number;
-  status: 'pending' | 'processing' | 'completed' | 'failed';
-  progress: number; // 0-100
-  statusMessage: string;
-  error: string | null;
-  externalUrl: string | null;
-  externalId: string | null;
-}
-```
-
-**Processing Strategy**:
-- **Sequential Processing**: Publish one item at a time (not parallel)
-- **Reason**: Avoid overwhelming platform APIs, easier error tracking, respects rate limits
-- **Progress Animation**: Same as single modal per item
-- **Status Updates**: Real-time per item
-- **Platform Aware**: Adapts to WordPress, Shopify, or custom platform requirements
-
-**Visual Indicators**:
-- ✓ (green) - Completed
-- ⏳ (blue) - Processing
-- ⏸️ (gray) - Pending
-- ❌ (red) - Failed
-
-**Error Recovery**:
-- Failed items show "Retry" button
-- Can retry individual failed items
-- Can skip failed items and continue
-- Summary at bottom: X completed, Y failed, Z pending
-
-**Cannot Close Until Complete**:
-- Close button disabled while `status='processing'` items exist
-- User must wait for all items to complete/fail
-- Similar to ImageQueueModal behavior
-
-#### Implementation Flow
-
-```typescript
-const handleBulkPublish = async (contentIds: number[]) => {
-  // Initialize queue
-  const queue: PublishQueueItem[] = contentIds.map((id, index) => ({
-    contentId: id,
-    contentTitle: getContentTitle(id), // Lookup from parent
-    index: index + 1,
-    status: 'pending',
-    progress: 0,
-    statusMessage: 'Pending',
-    error: null,
-    externalUrl: null,
-    externalId: null,
-  }));
-  
-  // Open modal with queue
-  setPublishQueue(queue);
-  setIsModalOpen(true);
-  
-  // Process sequentially
-  for (let i = 0; i < queue.length; i++) {
-    // Update status to processing
-    updateQueueItem(i, { status: 'processing', progress: 0, statusMessage: 'Preparing...' });
-    
-    try {
-      // Simulate progress animation
-      animateProgress(i, 0, 25, 2500); // 0-25% in 2.5s
-      
-      // Call API (destination determined by site's platform_type)
-      const response = await fetchAPI('/v1/publisher/publish/', {
-        method: 'POST',
-        body: JSON.stringify({
-          content_id: queue[i].contentId,
-          destinations: [sitePlatformType] // 'wordpress', 'shopify', or 'custom'
-        })
-      });
-      
-      // Handle response
-      if (response.success && response.data?.results?.[0]?.success) {
-        const result = response.data.results[0];
-        animateProgress(i, 25, 100, 1500); // 25-100% in 1.5s
-        updateQueueItem(i, {
-          status: 'completed',
-          progress: 100,
-          statusMessage: 'Published',
-          externalUrl: result.url,
-          externalId: result.external_id,
-        });
-      } else {
-        updateQueueItem(i, {
-          status: 'failed',
-          progress: 0,
-          statusMessage: 'Failed',
-          error: response.error || 'Unknown error',
-        });
-      }
-    } catch (error) {
-      updateQueueItem(i, {
-        status: 'failed',
-        progress: 0,
-        statusMessage: 'Failed',
-        error: error.message,
-      });
-    }
-  }
-  
-  // All done - enable close button
-  setAllComplete(true);
-};
-```
-
-### 3.3 Publishing Limits & Validation
-
-#### Direct Publish Limit (5 Items Max)
-
-**Rationale**:
-- Direct publishing is synchronous and resource-intensive
-- Limits server load and prevents API rate limiting
-- Encourages use of scheduling for large batches
-- Single-item publish (3-dot menu) has no limit (only 1 item)
-
-**Implementation**:
-
-**Validation in Approved Page**:
-```typescript
-const handleBulkPublishClick = () => {
-  const selectedCount = selectedIds.length;
-  
-  // Validate: Max 5 items for direct bulk publish
-  if (selectedCount > 5) {
-    // Show limit exceeded modal
-    setShowPublishLimitModal(true);
-    return;
-  }
-  
-  // Proceed with bulk publish
-  handleBulkPublishToSite(selectedIds);
-};
-```
-
-**Limit Exceeded Modal**:
-```
-┌────────────────────────────────────────────────────────────┐
-│ ⚠️ Publishing Limit Exceeded                               │
-├────────────────────────────────────────────────────────────┤
-│ You can publish only 5 content pages to site directly.    │
-│                                                             │
-│ You have selected {X} items.                                │
-│                                                             │
-│ Options:                                                    │
-│ • Deselect items to publish 5 or fewer                     │
-│ • Use "Schedule Selected" to schedule all items            │
-│                                                             │
-│ ℹ️ Tip: Scheduling has no limit and uses your site's       │
-│   default publishing schedule.                              │
-├────────────────────────────────────────────────────────────┤
-│        [Schedule Selected] [Go Back]                       │
-└────────────────────────────────────────────────────────────┘
-```
-
-**Modal Component**: `PublishLimitModal` (new)
-```typescript
-interface PublishLimitModalProps {
-  isOpen: boolean;
-  onClose: () => void;
-  selectedCount: number;
-  onScheduleInstead: () => void;
-}
-
-const PublishLimitModal = ({ isOpen, onClose, selectedCount, onScheduleInstead }) => {
-  return (
-    <Modal isOpen={isOpen} onClose={onClose}>
-      <div className="text-center">
-        <WarningIcon className="w-16 h-16 text-warning-500 mx-auto mb-4" />
-        <h3 className="text-lg font-semibold mb-2">Publishing Limit Exceeded</h3>
-        <p className="text-gray-600 mb-4">
-          You can publish only <strong>5 content pages</strong> to site directly.
-        </p>
-        <p className="text-gray-600 mb-4">
-          You have selected <strong>{selectedCount} items</strong>.
-        </p>
-        
-        <div className="bg-blue-50 border-l-4 border-blue-500 p-4 mb-6 text-left">
-          <p className="font-semibold mb-2">Options:</p>
-          <ul className="list-disc list-inside space-y-1 text-sm">
-            <li>Deselect items to publish 5 or fewer</li>
-            <li>Use "Schedule Selected" to schedule all items</li>
-          </ul>
-          <p className="text-xs text-gray-600 mt-3">
-            💡 Tip: Scheduling has no limit and uses your site's default publishing schedule.
-          </p>
-        </div>
-        
-        <div className="flex gap-3 justify-center">
-          <Button variant="outline" onClick={onClose}>Go Back</Button>
-          <Button variant="primary" onClick={onScheduleInstead}>
-            Schedule Selected
-          </Button>
-        </div>
-      </div>
-    </Modal>
-  );
-};
-```
-
-**Button State Management**:
-```typescript
-// In Approved.tsx
-const [showPublishLimitModal, setShowPublishLimitModal] = useState(false);
-
-// Update primary action button
-primaryAction={{
-  label: selectedIds.length > 5 ? 'Publish (Limit Exceeded)' : 'Publish to Site',
-  icon: <BoltIcon className="w-4 h-4" />,
-  onClick: handleBulkPublishClick,
-  variant: 'success',
-  disabled: selectedIds.length === 0,
-  tooltip: selectedIds.length > 5 
-    ? 'You can only publish 5 items at once. Use scheduling for more.'
-    : undefined
-}}
-```
-
-#### Scheduling Has No Limit
-
-**Bulk Schedule Action**:
-- No limit on number of items
-- Uses Site Settings default schedule
-- Processes items through scheduling queue
-- Better for large batches (10+ items)
-
-**Visual Distinction**:
-```typescript
-// Bulk actions in Approved page
-bulkActions: [
-  {
-    label: 'Publish Now (Max 5)',
-    value: 'bulk_publish_now',
-    icon: RocketLaunchIcon,
-    variant: 'success',
-    disabled: (selectedIds) => selectedIds.length > 5,
-    tooltip: (selectedIds) => 
-      selectedIds.length > 5 
-        ? 'Can only publish 5 items directly. Use scheduling for more.'
-        : 'Publish selected items immediately'
-  },
-  {
-    label: 'Schedule Selected',
-    value: 'bulk_schedule',
-    icon: CalendarIcon,
-    variant: 'primary',
-    tooltip: 'Schedule items using site default settings (no limit)'
-  }
-]
-```
-
-### 3.4 Site Settings Integration for Bulk Scheduling
-
-#### Default Publishing Schedule Configuration
-
-**Location**: `/sites/{site_id}/settings?tab=publishing`
-
-**Configuration Fields** (already exists in site settings):
-- **Auto-publish Schedule**: Time of day to publish (e.g., 9:00 AM)
-- **Publishing Frequency**: Daily, every X hours, specific days of week
-- **Timezone**: Site's timezone for scheduling
-- **Stagger Interval**: Minutes between each publish (e.g., 15 min intervals)
-- **Max Daily Publishes**: Limit publications per day (optional)
-
-**Used By**:
-1. Automation system (existing)
-2. Bulk scheduling from Approved page (new)
-3. Content Calendar default times (new)
-
-#### Bulk Schedule Implementation
-
-**API Endpoint**: `POST /api/v1/writer/content/bulk_schedule/`
-
-**Request**:
-```json
-{
-  "content_ids": [123, 124, 125, 126],
-  "use_site_defaults": true,
-  "site_id": 45
-}
-```
-
-**Response**:
-```json
-{
-  "success": true,
-  "scheduled_count": 4,
-  "schedule_preview": [
-    {
-      "content_id": 123,
-      "scheduled_at": "2025-01-17T09:00:00Z",
-      "title": "First Article"
-    },
-    {
-      "content_id": 124,
-      "scheduled_at": "2025-01-17T09:15:00Z",
-      "title": "Second Article"
-    },
-    {
-      "content_id": 125,
-      "scheduled_at": "2025-01-17T09:30:00Z",
-      "title": "Third Article"
-    },
-    {
-      "content_id": 126,
-      "scheduled_at": "2025-01-17T09:45:00Z",
-      "title": "Fourth Article"
-    }
-  ],
-  "site_settings": {
-    "base_time": "09:00 AM",
-    "stagger_interval": 15,
-    "timezone": "America/New_York"
-  }
-}
-```
-
-**Frontend Implementation**:
-```typescript
-const handleBulkScheduleWithDefaults = async (contentIds: number[]) => {
-  try {
-    // Show preview modal first
-    const preview = await fetchAPI('/v1/writer/content/bulk_schedule_preview/', {
-      method: 'POST',
-      body: JSON.stringify({
-        content_ids: contentIds,
-        site_id: activeSite.id
-      })
-    });
-    
-    // Open confirmation modal with schedule preview
-    setBulkSchedulePreview(preview);
-    setShowBulkScheduleConfirmModal(true);
-  } catch (error) {
-    toast.error(`Failed to generate schedule preview: ${error.message}`);
-  }
-};
-
-const confirmBulkSchedule = async () => {
-  try {
-    const response = await fetchAPI('/v1/writer/content/bulk_schedule/', {
-      method: 'POST',
-      body: JSON.stringify({
-        content_ids: selectedIds.map(id => parseInt(id)),
-        use_site_defaults: true,
-        site_id: activeSite.id
-      })
-    });
-    
-    toast.success(`Scheduled ${response.scheduled_count} items`);
-    loadContent(); // Refresh
-    setShowBulkScheduleConfirmModal(false);
-  } catch (error) {
-    toast.error(`Failed to schedule: ${error.message}`);
-  }
-};
-```
-
-**Bulk Schedule Preview Modal**:
-```
-┌────────────────────────────────────────────────────────────┐
-│ 📅 Schedule 10 Articles                                    │
-├────────────────────────────────────────────────────────────┤
-│ Using site default schedule:                               │
-│ • Start time: 9:00 AM (America/New_York)                   │
-│ • Stagger: 15 minutes between each                         │
-│ • First publish: Tomorrow, Jan 17, 2025 at 9:00 AM        │
-│ • Last publish: Tomorrow, Jan 17, 2025 at 11:15 AM        │
-│                                                             │
-│ Schedule Preview:                                           │
-│ ┌────────────────────────────────────────────────────────┐ │
-│ │ 1. First Article          → Jan 17, 9:00 AM           │ │
-│ │ 2. Second Article         → Jan 17, 9:15 AM           │ │
-│ │ 3. Third Article          → Jan 17, 9:30 AM           │ │
-│ │ 4. Fourth Article         → Jan 17, 9:45 AM           │ │
-│ │ 5. Fifth Article          → Jan 17, 10:00 AM          │ │
-│ │ ... and 5 more                                         │ │
-│ └────────────────────────────────────────────────────────┘ │
-│                                                             │
-│ ℹ️ Modify defaults at Site Settings → Publishing tab       │
-│                                                             │
-├────────────────────────────────────────────────────────────┤
-│   [Change Settings] [Cancel] [Confirm Schedule]            │
-└────────────────────────────────────────────────────────────┘
-```
-
-**Link to Site Settings**:
-```typescript
-const handleChangeSettings = () => {
-  // Open site settings in new tab
-  window.open(`/sites/${activeSite.id}/settings?tab=publishing`, '_blank');
-  // Keep modal open so user can return and confirm
-};
-```
-
----
-
-## 4. Workflow Changes: Remove Publish from Review Page
-
-### 4.1 Current Problem
-
-**Review Page** currently allows direct publishing, which:
-- Bypasses the approval workflow
-- Allows unapproved content to go live
-- Creates confusion about content workflow states
-- Inconsistent with expected review → approve → publish flow
-- Uses platform-specific terminology ("Publish to WordPress") limiting perceived capabilities
-
-### 4.2 Proposed Changes
-
-**Review Page** (`frontend/src/pages/Writer/Review.tsx`):
-
-**Remove**:
-- ❌ `handlePublishSingle()` function
-- ❌ `handlePublishBulk()` function
-- ❌ "Publish to WordPress" action (replace with generic "Publish" in Approved page)
-- ❌ "Publish to Site" bulk action button from Review page
-
-**Keep**:
-- ✅ `handleApproveSingle()` - Approve individual items
-- ✅ `handleApproveBulk()` - Approve multiple items
-- ✅ "Approve" action (changes status to 'approved')
-- ✅ View, Edit, Delete actions
-
-**New Primary Action**:
-```typescript
-primaryAction={{
-  label: 'Approve',
-  icon: <CheckCircleIcon className="w-4 h-4" />,
-  onClick: () => handleBulkAction('bulk_approve', selectedIds),
-  variant: 'success',
-}}
-```
-
-**Updated Page Description**:
-```typescript
-// Old: "Shows content with status='review' ready for publishing"
-// New: "Shows content with status='review' ready for approval"
-```
-
-**Impact**:
-- Content in Review can only be approved
-- To publish, content must first move to Approved page
-- Clearer workflow: Draft → Review → Approved → Publish
-- No breaking changes to backend
-
-### 4.3 Updated Row Actions Config
-
-**File**: `frontend/src/config/pages/review.config.tsx`
-
-**Before**:
-```typescript
-rowActions: [
-  { label: 'Approve', value: 'approve', icon: CheckCircleIcon },
-  { label: 'Publish to WordPress', value: 'publish_wordpress', icon: RocketLaunchIcon }, // Platform-specific
-  { label: 'View', value: 'view', icon: EyeIcon },
-  { label: 'Edit', value: 'edit', icon: PencilIcon },
-  { label: 'Delete', value: 'delete', icon: TrashBinIcon, danger: true },
-]
-```
-
-**After**:
-```typescript
-rowActions: [
-  { label: 'Approve', value: 'approve', icon: CheckCircleIcon },
-  { label: 'View', value: 'view', icon: EyeIcon },
-  { label: 'Edit', value: 'edit', icon: PencilIcon },
-  { label: 'Delete', value: 'delete', icon: TrashBinIcon, danger: true },
-]
-```
-
----
-
-## 5. Scheduling UI Implementation
-
-### 5.1 Schedule/Reschedule in Approved Page
-
-**Component**: Add scheduling button to row actions and bulk actions
-
-#### Row Action: Schedule Single Item
-
-**Modal**: `ScheduleContentModal` (new)  
-**Location**: `frontend/src/components/common/ScheduleContentModal.tsx`
-
-**Design**:
-```
-┌────────────────────────────────────────┐
-│ 📅 Schedule Content Publishing         │
-├────────────────────────────────────────┤
-│ Content: "Article Title Here"          │
-│                                         │
-│ Schedule Date:                          │
-│ [Date Picker: MM/DD/YYYY        ▼]     │
-│                                         │
-│ Schedule Time:                          │
-│ [Time Picker: HH:MM AM/PM       ▼]     │
-│                                         │
-│ Preview: January 15, 2025 at 9:00 AM   │
-│                                         │
-├────────────────────────────────────────┤
-│              [Cancel] [Schedule]        │
-└────────────────────────────────────────┘
-```
-
-**Implementation**:
-```typescript
-interface ScheduleContentModalProps {
-  isOpen: boolean;
-  onClose: () => void;
-  content: Content;
-  onSchedule: (contentId: number, scheduledDate: string) => Promise<void>;
-}
-
-const ScheduleContentModal = ({ isOpen, onClose, content, onSchedule }) => {
-  const [selectedDate, setSelectedDate] = useState<Date>(getDefaultScheduleDate());
-  const [selectedTime, setSelectedTime] = useState<string>('09:00 AM');
-  
-  const getDefaultScheduleDate = () => {
-    const tomorrow = new Date();
-    tomorrow.setDate(tomorrow.getDate() + 1);
-    return tomorrow;
-  };
-  
-  const handleSchedule = async () => {
-    // Combine date and time
-    const scheduledDateTime = combineDateAndTime(selectedDate, selectedTime);
-    
-    try {
-      await onSchedule(content.id, scheduledDateTime.toISOString());
-      toast.success(`Scheduled for ${formatScheduledTime(scheduledDateTime)}`);
-      onClose();
-    } catch (error) {
-      toast.error(`Failed to schedule: ${error.message}`);
-    }
-  };
-  
-  return (
-    <Modal isOpen={isOpen} onClose={onClose}>
-      {/* Date/Time pickers */}
-      <Button onClick={handleSchedule}>Schedule</Button>
-    </Modal>
-  );
-};
-```
-
-**API Call**:
-```typescript
-const handleScheduleContent = async (contentId: number, scheduledDate: string) => {
-  const response = await fetchAPI(`/v1/writer/content/${contentId}/schedule/`, {
-    method: 'POST',
-    body: JSON.stringify({ scheduled_publish_at: scheduledDate }),
-  });
-  
-  // Update local state
-  setContent(prevContent =>
-    prevContent.map(c => c.id === contentId ? {
-      ...c,
-      site_status: 'scheduled',
-      scheduled_publish_at: scheduledDate,
-    } : c)
-  );
-};
-```
-
-#### Row Action: Reschedule Item
-
-**Trigger**: Show "Reschedule" action when:
-- `site_status === 'scheduled'` (scheduled but not yet published)
-- `site_status === 'failed'` (scheduled publishing failed)
-
-**Modal**: Reuse `ScheduleContentModal` but:
-- Title: "Reschedule Content Publishing"
-- Pre-fill with existing `scheduled_publish_at` date/time
-- API: `POST /v1/writer/content/{id}/reschedule/`
-
-**Implementation**:
-```typescript
-const handleRescheduleContent = async (contentId: number, scheduledDate: string) => {
-  const response = await fetchAPI(`/v1/writer/content/${contentId}/reschedule/`, {
-    method: 'POST',
-    body: JSON.stringify({ scheduled_at: scheduledDate }),
-  });
-  
-  // Update local state
-  setContent(prevContent =>
-    prevContent.map(c => c.id === contentId ? {
-      ...c,
-      site_status: 'scheduled',
-      scheduled_publish_at: scheduledDate,
-    } : c)
-  );
-  
-  toast.success('Rescheduled successfully');
-};
-```
-
-#### Row Action: Unschedule Item
-
-**Trigger**: Show when `site_status === 'scheduled'`
-
-**Confirmation Modal**:
-```
-┌────────────────────────────────────────┐
-│ ⚠️ Unschedule Content?                 │
-├────────────────────────────────────────┤
-│ Are you sure you want to unschedule    │
-│ "Article Title Here"?                   │
-│                                         │
-│ Current schedule: Jan 15, 2025 9:00 AM │
-│                                         │
-├────────────────────────────────────────┤
-│              [Cancel] [Unschedule]      │
-└────────────────────────────────────────┘
-```
-
-**API Call**:
-```typescript
-const handleUnscheduleContent = async (contentId: number) => {
-  await fetchAPI(`/v1/writer/content/${contentId}/unschedule/`, {
-    method: 'POST',
-  });
-  
-  setContent(prevContent =>
-    prevContent.map(c => c.id === contentId ? {
-      ...c,
-      site_status: 'not_published',
-      scheduled_publish_at: null,
-    } : c)
-  );
-  
-  toast.success('Unscheduled successfully');
-};
-```
-
-#### Updated Row Actions for Approved Page
-
-**File**: `frontend/src/config/pages/approved.config.tsx`
-
-**Dynamic row actions based on content state** (platform-agnostic):
-```typescript
-const getRowActions = (content: Content, siteName: string) => {
-  const actions = [];
-  
-  // Always available
-  actions.push({ label: 'View', value: 'view', icon: EyeIcon });
-  actions.push({ label: 'Edit', value: 'edit', icon: PencilIcon });
-  
-  // Publishing actions based on site_status (platform-agnostic)
-  if (content.site_status === 'not_published') {
-    actions.push({ label: 'Publish Now', value: 'publish_site', icon: RocketLaunchIcon });
-    actions.push({ label: 'Schedule', value: 'schedule', icon: CalendarIcon });
-  } else if (content.site_status === 'scheduled') {
-    actions.push({ label: 'Reschedule', value: 'reschedule', icon: CalendarIcon });
-    actions.push({ label: 'Unschedule', value: 'unschedule', icon: XIcon });
-    actions.push({ label: 'Publish Now', value: 'publish_site', icon: RocketLaunchIcon });
-  } else if (content.site_status === 'failed') {
-    actions.push({ label: 'Publish Now', value: 'publish_site', icon: RocketLaunchIcon });
-    actions.push({ label: 'Reschedule', value: 'reschedule', icon: CalendarIcon });
-  } else if (content.site_status === 'published' && content.external_url) {
-    // Use actual site name for dynamic label
-    actions.push({ 
-      label: `View on ${siteName}`, 
-      value: 'view_on_site', 
-      icon: ExternalLinkIcon 
-    });
-  }
-  
-  actions.push({ label: 'Delete', value: 'delete', icon: TrashBinIcon, danger: true });
-  
-  return actions;
-};
-```
-
-#### Bulk Actions for Scheduling
-
-**New bulk action**: "Schedule Selected"
-
-**Modal**: `BulkScheduleModal` (new)
-```
-┌────────────────────────────────────────┐
-│ 📅 Schedule 5 Articles                 │
-├────────────────────────────────────────┤
-│ Schedule all selected articles for:    │
-│                                         │
-│ Date: [MM/DD/YYYY              ▼]      │
-│ Time: [HH:MM AM/PM             ▼]      │
-│                                         │
-│ Preview: January 15, 2025 at 9:00 AM   │
-│                                         │
-│ ⚠️ All 5 articles will be scheduled    │
-│    for the same date and time.         │
-│                                         │
-├────────────────────────────────────────┤
-│              [Cancel] [Schedule All]    │
-└────────────────────────────────────────┘
-```
-
-**Implementation**:
-```typescript
-const handleBulkSchedule = async (contentIds: number[], scheduledDate: string) => {
-  let successCount = 0;
-  let failedCount = 0;
-  
-  for (const contentId of contentIds) {
-    try {
-      await fetchAPI(`/v1/writer/content/${contentId}/schedule/`, {
-        method: 'POST',
-        body: JSON.stringify({ scheduled_publish_at: scheduledDate }),
-      });
-      successCount++;
-    } catch (error) {
-      console.error(`Failed to schedule content ${contentId}:`, error);
-      failedCount++;
-    }
-  }
-  
-  if (successCount > 0) {
-    toast.success(`Scheduled ${successCount} item(s)`);
-  }
-  if (failedCount > 0) {
-    toast.warning(`${failedCount} item(s) failed to schedule`);
-  }
-  
-  loadContent(); // Refresh
-};
-```
-
-### 5.2 Scheduling in Content Calendar Page
-
-**Current State**: Scheduling via drag-and-drop works well
-
-**Enhancement**: Add "Edit Schedule" button to scheduled items
-
-**Design**:
-- Each scheduled item in calendar has an "Edit" button
-- Opens `ScheduleContentModal` with existing date/time pre-filled
-- User can change date/time
-- Calls reschedule API
-
-**Implementation** (add to calendar item render):
-```typescript
-{item.site_status === 'scheduled' && (
-  <IconButton
-    icon={<PencilIcon className="w-4 h-4" />}
-    onClick={() => openRescheduleModal(item)}
-    title="Edit schedule"
-    size="sm"
-  />
-)}
-```
-
-**Failed Items Handling**:
-- Show failed items in a separate section (not on calendar)
-- Red error badge
-- Two buttons: "Reschedule" and "Publish Now"
-- Clicking "Reschedule" opens `ScheduleContentModal`
-
-**Design**:
-```
-┌──────────────────────────────────────────────────────────┐
-│ ❌ Failed Scheduled Publications (2)                     │
-├──────────────────────────────────────────────────────────┤
-│ ⚠️ Article Title 1                                       │
-│    Site: My WordPress Blog                               │
-│    Scheduled: Jan 13, 2025 9:00 AM                       │
-│    Error: Publishing API error: Invalid credentials      │
-│    [Reschedule] [Publish Now]                            │
-│                                                           │
-│ ⚠️ Article Title 2                                       │
-│    Site: My Shopify Store                                │
-│    Scheduled: Jan 13, 2025 10:00 AM                      │
-│    Error: Network timeout                                │
-│    [Reschedule] [Publish Now]                            │
-└──────────────────────────────────────────────────────────┘
-```
-
-### 5.3 Scheduling in ContentView Template
-
-**File**: `frontend/src/templates/ContentView.tsx` (if exists)
-
-**Note**: File not found during analysis - may not exist or may be different path
-
-**If this is the content detail view**:
-- Add "Schedule" button in header actions (if `site_status === 'not_published'`)
-- Add "Reschedule" button (if `site_status === 'scheduled'` or `site_status === 'failed'`)
-- Add "Publish Now" button (if approved)
-- Show current schedule prominently if scheduled
-
-**Alternate**: If ContentView doesn't exist, check if content detail page is at:
-- `frontend/src/pages/Writer/ContentDetail.tsx`
-- Or individual content pages use a different template
-
----
-
-## 6. Failed Content Handling
-
-### 6.1 Identifying Failed Content
-
-**Query**: Content where `site_status = 'failed'`
-
-**Display Locations**:
-1. **Approved Page**: Filter by `site_status = 'failed'`
-2. **Content Calendar**: Separate "Failed" section
-3. **Dashboard Widget**: "Failed Publications" count
-
-### 6.2 Failed Item UI Treatment
-
-**Visual Indicators**:
-- ❌ Red error badge: "Failed"
-- 🕐 Show original scheduled time
-- 📄 Show error message (truncated)
-- 🔄 Retry options: "Publish Now" or "Reschedule"
-
-**Row Actions for Failed Items**:
-```typescript
-{
-  label: 'Publish Now',
-  value: 'publish_site',
-  icon: RocketLaunchIcon,
-}
-{
-  label: 'Reschedule',
-  value: 'reschedule',
-  icon: CalendarIcon,
-}
-{
-  label: 'View Error Details',
-  value: 'view_error',
-  icon: ErrorIcon,
-}
-```
-
-**Error Details Modal**:
-```
-┌────────────────────────────────────────────────────────────┐
-│ ❌ Publishing Error Details                                │
-├────────────────────────────────────────────────────────────┤
-│ Content: "Article Title Here"                              │
-│ Site: My WordPress Blog (WordPress)                        │
-│ Scheduled: January 13, 2025 at 9:00 AM                     │
-│ Failed: January 13, 2025 at 9:05 AM                        │
-│                                                             │
-│ Error Message:                                              │
-│ ┌────────────────────────────────────────────────────────┐ │
-│ │ Publishing API error: Invalid credentials              │ │
-│ │                                                         │ │
-│ │ The publishing site returned a 403 Forbidden error.    │ │
-│ │ Please check the API key in Site Settings.             │ │
-│ └────────────────────────────────────────────────────────┘ │
-│                                                             │
-│ Actions:                                                    │
-│ [Fix Site Settings] [Publish Now] [Reschedule] [Close]    │
-└────────────────────────────────────────────────────────────┘
-```
-
-### 6.3 Retry Logic
-
-**Publish Now** (from failed state):
-- Opens `PublishingProgressModal`
-- Same flow as normal publish
-- On success: `site_status` → `published`, clear error
-- On failure: Update error message, keep as `failed`
-
-**Reschedule** (from failed state):
-- Opens `ScheduleContentModal`
-- Pre-fill with original scheduled time (or next day)
-- On save: `site_status` → `scheduled`, clear error
-- Celery task will retry at new scheduled time
-
----
-
-## 7. Implementation Phases
-
-### Phase 1: Publishing Progress Modals (Week 1-2)
-
-**Tasks**:
-1. Create `PublishingProgressModal.tsx` component (platform-agnostic)
-2. Create `BulkPublishingModal.tsx` component (platform-agnostic)
-3. Create `PublishLimitModal.tsx` component (new - limit validation)
-4. Update `Approved.tsx`:
-   - Integrate single publish modal
-   - Integrate bulk publish modal (max 5 items)
-   - Add limit validation: show `PublishLimitModal` if > 5 selected
-   - Rename `handleBulkPublishWordPress` to `handleBulkPublishToSite`
-   - Update action names: `publish_wordpress` → `publish_site`
-   - Display actual site name in UI
-   - Add "Schedule Selected" bulk action (no limit)
-5. Test with WordPress, Shopify, and custom sites
-6. Handle platform-specific error states and retry logic
-7. Test limit validation (6+ items selected)
-
-**Deliverables**:
-- ✅ Single publish with progress feedback (all platforms)
-- ✅ Bulk publish with queue progress (max 5 items)
-- ✅ Publishing limit validation modal
-- ✅ Error handling with retry
-- ✅ Success state with "View on [Site Name]" link
-- ✅ Platform-agnostic terminology throughout
-
-### Phase 2: Remove Publish from Review (Week 2)
-
-**Tasks**:
-1. Update `Review.tsx`:
-   - Remove `handlePublishSingle()` function
-   - Remove `handlePublishBulk()` function
-   - Remove publish actions from row actions
-   - Update primary action to "Approve"
-2. Update `review.config.tsx`:
-   - Remove publish actions from rowActions array
-3. Test workflow: Review → Approve → Approved → Publish
-
-**Deliverables**:
-- ✅ Review page only approves content
-- ✅ No publishing from Review page
-- ✅ Clearer workflow separation
-
-### Phase 3: Scheduling UI in Approved Page (Week 3)
-
-**Tasks**:
-1. Create `ScheduleContentModal.tsx` component
-2. Create `BulkScheduleModal.tsx` component (manual date/time)
-3. Create `BulkSchedulePreviewModal.tsx` component (site defaults preview)
-4. Create backend endpoint: `POST /v1/writer/content/bulk_schedule/`
-5. Create backend endpoint: `POST /v1/writer/content/bulk_schedule_preview/`
-6. Update `Approved.tsx`:
-   - Add "Schedule" row action
-   - Add "Reschedule" row action (conditional)
-   - Add "Unschedule" row action (conditional)
-   - Add "Schedule Selected" bulk action (uses site defaults)
-   - Dynamic row actions based on `site_status`
-   - Link to site settings from schedule preview modal
-7. Test scheduling, rescheduling, unscheduling
-8. Test bulk scheduling with site defaults (10+ items)
-9. Verify site settings integration
-
-**Deliverables**:
-- ✅ Schedule content for future publishing
-- ✅ Reschedule existing scheduled content
-- ✅ Unschedule content
-- ✅ Bulk scheduling with site default settings
-- ✅ Schedule preview before confirmation
-- ✅ Link to Site Settings → Publishing tab
-- ✅ No limit on scheduled items
-
-### Phase 4: Failed Content Handling (Week 3-4)
-
-**Tasks**:
-1. Add failed content filter to Approved page
-2. Create failed items section in Content Calendar
-3. Create `ErrorDetailsModal.tsx` for viewing full errors
-4. Add retry logic for failed items
-5. Update row actions for failed items
-
-**Deliverables**:
-- ✅ Visual indication of failed content
-- ✅ Error details modal
-- ✅ Retry/Reschedule options
-- ✅ Clear error messages
-
-### Phase 5: Content Calendar Enhancements (Week 4)
-
-**Tasks**:
-1. Add "Edit Schedule" button to calendar items
-2. Add failed items section to calendar
-3. Improve calendar item tooltips
-4. Test drag-drop with new scheduling modals
-
-**Deliverables**:
-- ✅ Edit scheduled items from calendar
-- ✅ Failed items displayed prominently
-- ✅ Improved UX for scheduling
-
-### Phase 6: Testing & Documentation (Week 5)
-
-**Tasks**:
-1. E2E testing of all workflows
-2. Test error scenarios
-3. Update user documentation
-4. Create user guide for new scheduling features
-5. Performance testing for bulk operations
-
-**Deliverables**:
-- ✅ All features tested and working
-- ✅ Documentation updated
-- ✅ User guide created
-- ✅ Performance benchmarks
-
----
-
-## 8. Technical Considerations
-
-### 8.1 State Management
-
-**Local State** (per page):
-- Modal open/close states
-- Queue items for bulk operations
-- Selected date/time for scheduling
-
-**Global State** (if needed):
-- Active publishing operations (prevent duplicate publishes)
-- Recent errors (for error dashboard)
-
-**Recommendation**: Use local component state with React hooks. No need for Redux/Zustand unless state sharing becomes complex.
-
-### 8.2 Performance
-
-**Bulk Operations**:
-- Sequential processing (not parallel) to avoid API rate limits
-- Show progress per item
-- Allow cancellation (future enhancement)
-
-**Calendar View**:
-- Lazy load calendar months
-- Limit displayed items per date (show "X more..." if > 3)
-- Virtual scrolling for large lists
-
-**Polling** (if needed for async publishing):
-- Currently publishing is synchronous, so no polling needed
-- If made async in future, poll task status like ImageQueueModal does
-
-### 8.3 Error Handling
-
-**Network Errors**:
-- Catch and display user-friendly messages
-- Log full error to console for debugging
-- Provide retry button
-
-**Platform API Errors**:
-- Parse platform-specific error messages (WordPress, Shopify, Custom API)
-- Highlight common issues (invalid credentials, missing fields, rate limits)
-- Link to Site Settings for credential fixes
-- Show platform type in error messages for clarity
-
-**Validation Errors**:
-- Validate schedule date/time (must be in future)
-- Validate content is approved before publishing
-- Check site configuration exists (API key, domain)
-- Verify platform-specific requirements are met
-
-### 8.4 Accessibility
-
-**Modals**:
-- Keyboard navigation (Tab, Esc)
-- ARIA labels for screen readers
-- Focus trap when modal is open
-- Announce status changes
-
-**Progress Bars**:
-- ARIA role="progressbar"
-- aria-valuenow, aria-valuemin, aria-valuemax
-- Announce percentage changes
-
-**Color Indicators**:
-- Don't rely only on color (use icons too)
-- High contrast for dark mode
-- Color-blind friendly palette
-
----
-
-## 9. UI/UX Best Practices
-
-### 9.1 Loading States
-
-- Show skeleton loaders for content lists
-- Disable buttons during API calls
-- Show spinner in button: "Publishing..." (with spinner icon)
-- Progress bars for multi-step operations
-
-### 9.2 Success Feedback
-
-- Green toast notification: "Published successfully"
-- Green checkmark icon in modal
-- Auto-refresh content list on success
-- Optional: Confetti animation for first publish
-
-### 9.3 Error Feedback
-
-- Red toast notification: "Failed to publish: [error]"
-- Red alert box in modal with full error
-- "Copy error details" button for debugging
-- "Contact support" link if needed
-
-### 9.4 Empty States
-
-- No scheduled content: Show calendar with "Drag approved content here"
-- No failed content: "No failed publications" with green checkmark
-- No approved content: "Approve content from Review page"
-
-### 9.5 Tooltips and Help Text
-
-- Calendar dates: "Drag content here to schedule"
-- Schedule button: "Schedule for future publishing to site"
-- Publish button: "Publish immediately to [Site Name]"
-- Failed badge: "Publishing failed - click for details"
-- Site name shown in all tooltips where relevant
-
----
-
-## 10. Future Enhancements
-
-### 10.1 Advanced Scheduling
-
-- **Recurring schedules**: Publish every Monday at 9 AM
-- **Bulk schedule spread**: Schedule 10 items over next 2 weeks (evenly distributed)
-- **Optimal timing**: AI suggests best time to publish based on traffic data
-- **Timezone support**: Schedule in site's timezone (not user's)
-
-### 10.2 Publishing Queue Management
-
-- **Pause/Resume queue**: Pause all scheduled publications
-- **Reorder queue**: Drag to reorder in list view
-- **Priority flag**: Mark content as high priority (publish first)
-- **Batch limits**: Limit to X publications per day
-
-### 10.3 Multi-Platform Publishing
-
-- **Social media**: Publish to Facebook, Twitter, LinkedIn
-- **Multiple sites**: Publish to multiple sites simultaneously (WordPress, Shopify, Custom)
-- **Cross-post**: Publish same content to blog + Medium + Dev.to
-- **Mixed platforms**: Schedule content to WordPress site and Shopify store at different times
-
-### 10.4 Advanced Error Handling
-
-- **Auto-retry**: Retry failed publications X times before marking as failed
-- **Error patterns**: Detect common errors and suggest fixes
-- **Health checks**: Pre-flight check before scheduling (test credentials)
-
-### 10.5 Analytics Integration
-
-- **Publishing stats**: Track success/failure rates
-- **Performance metrics**: Average time to publish
-- **Engagement tracking**: Track views/clicks on published content
-- **Calendar heatmap**: Visual representation of publishing activity
-
----
-
-## 11. Testing Checklist
-
-### 11.1 Single Publishing
-
-- [ ] Publish single approved content
-- [ ] Progress modal shows correct stages
-- [ ] Success state displays site URL (works for WordPress, Shopify, Custom)
-- [ ] Modal shows actual site name, not platform type
-- [ ] Error state displays error message
-- [ ] Retry button works on failure
-- [ ] Close button disabled during publish
-- [ ] Content list refreshes on success
-- [ ] Test with WordPress site
-- [ ] Test with Shopify site
-- [ ] Test with Custom site
-
-### 11.2 Bulk Publishing
-
-- [ ] Publish multiple approved content items (up to 5)
-- [ ] Limit validation: 6+ items shows PublishLimitModal
-- [ ] PublishLimitModal offers "Schedule Selected" option
-- [ ] Single record publish (3-dot menu) has no limit
-- [ ] Queue displays all items
-- [ ] Sequential processing works
-- [ ] Individual progress per item
-- [ ] Mixed success/failure handling
-- [ ] Retry individual failed items
-- [ ] Close button enabled after completion
-- [ ] Button tooltip shows limit info when > 5 selected
-
-### 11.3 Scheduling
-
-**Manual Scheduling:**
-- [ ] Schedule single content (manual date/time)
-- [ ] Schedule bulk content (manual date/time)
-- [ ] Date/time picker validation
-- [ ] Schedule in past shows error
-- [ ] Scheduled items appear in calendar
-- [ ] Drag-and-drop scheduling works
-- [ ] Reschedule changes date/time
-- [ ] Unschedule removes from calendar
-
-**Bulk Scheduling with Site Defaults:**
-- [ ] Select 10+ items for scheduling (no limit)
-- [ ] "Schedule Selected" button opens preview modal
-- [ ] Preview shows schedule with stagger intervals
-- [ ] Preview displays site settings (time, stagger, timezone)
-- [ ] "Change Settings" link opens site settings in new tab
-- [ ] Confirm schedule applies to all selected items
-- [ ] Items appear in calendar with scheduled times
-- [ ] Site settings at `/sites/{id}/settings?tab=publishing` has scheduling config
-- [ ] Automation uses same scheduling config
-- [ ] Bulk scheduled items respect site's daily limits (if configured)
-
-### 11.4 Failed Content
-
-- [ ] Failed items display with error badge
-- [ ] Error details modal shows full error
-- [ ] Retry from failed state works
-- [ ] Reschedule from failed state works
-- [ ] Failed section in calendar shows items
-- [ ] Filter failed items in Approved page
-
-### 11.5 Review Page Changes
-
-- [ ] Publish actions removed
-- [ ] Approve action works
-- [ ] Bulk approve works
-- [ ] No direct publishing possible
-- [ ] Approved content moves to Approved page
-
-### 11.6 Edge Cases
-
-- [ ] No site credentials: Error message
-- [ ] Missing API key: Error message
-- [ ] Unsupported platform type: Error message
-- [ ] Network timeout: Error message
-- [ ] Invalid content (missing required fields): Error
-- [ ] Publishing already published content: Handled
-- [ ] Scheduling already scheduled content: Reschedule
-- [ ] Deleting scheduled content: Removes from calendar
-- [ ] Site change: Refresh content
-- [ ] Platform-specific validation (WordPress categories, Shopify collections, etc.)
-
-**Publishing Limits:**
-- [ ] Selecting exactly 5 items: Direct publish allowed
-- [ ] Selecting 6 items: PublishLimitModal shown
-- [ ] Selecting 10+ items: PublishLimitModal shown, suggests scheduling
-- [ ] From limit modal: "Schedule Selected" opens bulk schedule preview
-- [ ] From limit modal: "Go Back" closes modal, keeps selection
-- [ ] Single publish (3-dot): Always allowed, no limit modal
-- [ ] Bulk button disabled when no items selected
-- [ ] Bulk button shows tooltip when > 5 items selected
-
-**Bulk Scheduling:**
-- [ ] No site scheduling config: Uses defaults (9 AM, 15 min stagger)
-- [ ] Site has custom schedule: Preview reflects custom settings
-- [ ] Scheduling 50+ items: No error, all scheduled
-- [ ] Site settings link opens correct tab
-- [ ] Return from site settings: Preview refreshes with new settings
-
----
-
-## 12. Documentation Updates Required
-
-### 12.1 User Documentation
-
-**File**: `docs/40-WORKFLOWS/CONTENT-PUBLISHING.md` (new or update existing)
-
-**Sections**:
-1. Publishing Workflow Overview
-2. Publishing from Approved Page
-3. Scheduling Content
-4. Managing Scheduled Content
-5. Handling Failed Publications
-6. Bulk Operations
-7. Troubleshooting
-
-### 12.2 Developer Documentation
-
-**File**: `docs/30-FRONTEND/PUBLISHING-MODALS.md` (new)
-
-**Sections**:
-1. Modal Architecture
-2. Component API Reference
-3. State Management
-4. API Integration
-5. Progress Animation Logic
-6. Error Handling Patterns
-7. Testing Guidelines
-
-### 12.3 API Documentation
-
-**File**: `docs/20-API/PUBLISHER.md` (update existing)
-
-**Add**:
-- Schedule endpoint: `POST /v1/writer/content/{id}/schedule/`
-- Reschedule endpoint: `POST /v1/writer/content/{id}/reschedule/`
-- Unschedule endpoint: `POST /v1/writer/content/{id}/unschedule/`
-- Examples with request/response
-
----
-
-## 13. Conclusion
-
-This comprehensive plan provides:
-
-1. ✅ **Publishing Progress Modals** - Real-time feedback for single and bulk operations
-2. ✅ **Publishing Limits & Validation** - Max 5 direct publish, unlimited scheduling
-3. ✅ **Workflow Optimization** - Clear separation of Review (approve only) and Approved (publish)
-4. ✅ **Scheduling UI** - Full scheduling/rescheduling capabilities across multiple pages
-5. ✅ **Site Settings Integration** - Bulk scheduling uses default configuration
-6. ✅ **Failed Content Handling** - Clear error display with retry/reschedule options
-7. ✅ **Pattern Consistency** - Follows existing modal patterns from ImageQueueModal
-8. ✅ **User Experience** - Intuitive, informative, and forgiving interface
-9. ✅ **Platform Agnostic** - Supports WordPress, Shopify, Custom sites with unified terminology
-10. ✅ **Scalable Architecture** - Easy to add new publishing platforms in the future
-
-### Key Success Metrics
-
-- **User Satisfaction**: Fewer support tickets about "where did my content go?"
-- **Publishing Success Rate**: Increased from tracking and retry capabilities
-- **Workflow Clarity**: Users understand: Review → Approve → Publish
-- **Error Recovery**: Failed publications can be easily rescheduled
-- **Time Savings**: Bulk operations with progress tracking reduce manual work
-
-### Next Steps
-
-1. Review this plan with stakeholders
-2. Prioritize phases based on business needs
-3. Begin Phase 1 implementation (Publishing Progress Modals)
-4. Conduct user testing after Phase 3
-5. Iterate based on feedback
-
----
-
-**Document Version**: 1.0  
-**Last Updated**: January 2025  
-**Status**: Ready for Implementation
diff --git a/docs/plans/implemented/PUBLISHING-UX-IMPLEMENTATION-SUMMARY.md b/docs/plans/implemented/PUBLISHING-UX-IMPLEMENTATION-SUMMARY.md
deleted file mode 100644
index b3177161..00000000
--- a/docs/plans/implemented/PUBLISHING-UX-IMPLEMENTATION-SUMMARY.md
+++ /dev/null
@@ -1,554 +0,0 @@
-# Publishing Progress & Scheduling UX - Implementation Summary
-
-**Date Completed**: January 16, 2026  
-**Plan Reference**: `PUBLISHING-PROGRESS-AND-SCHEDULING-UX-PLAN.md`  
-**Status**: ✅ **COMPLETE** (95%)
-
----
-
-## Executive Summary
-
-Successfully implemented a comprehensive publishing and scheduling UX enhancement across the igny8 platform. The implementation adds real-time progress tracking, intelligent publishing limits, and flexible scheduling capabilities for multi-platform content publishing (WordPress, Shopify, Custom Sites).
-
-**Key Achievements:**
-- ✅ 6 new modal components created
-- ✅ Platform-agnostic publishing workflow
-- ✅ 5-item direct publish limit with unlimited scheduling
-- ✅ Site settings integration for bulk scheduling
-- ✅ Failed content recovery UI
-- ✅ Complete documentation suite
-- ✅ Zero TypeScript errors
-
----
-
-## Implementation Status by Phase
-
-### ✅ Phase 1: Publishing Progress Modals (100%)
-
-**Components Created:**
-1. **PublishingProgressModal.tsx** - Single content publishing with 4-stage progress
-2. **BulkPublishingModal.tsx** - Queue-based bulk publishing (max 5 items)
-3. **PublishLimitModal.tsx** - Validation modal for 6+ item selections
-
-**Features Delivered:**
-- Real-time progress tracking (Preparing → Uploading → Processing → Finalizing)
-- Smooth progress animations (0-100%)
-- Success state with "View on [Site Name]" link
-- Error state with retry capability
-- Platform-agnostic design (works with WordPress, Shopify, Custom)
-- Sequential processing for bulk operations
-- Per-item progress bars in bulk modal
-- Summary statistics (X completed, Y failed, Z pending)
-
-**Integration Points:**
-- Approved.tsx: Single and bulk publish actions
-- Uses existing fetchAPI utility
-- Site store for active site context
-- Toast notifications for feedback
-
-**Status:** ✅ All components exist, no TypeScript errors
-
----
-
-### ✅ Phase 2: Remove Publish from Review (100%)
-
-**Changes Made:**
-- Removed `handlePublishSingle()` function from Review.tsx
-- Removed `handlePublishBulk()` function from Review.tsx
-- Removed "Publish to WordPress" from row actions
-- Removed "Publish to Site" bulk action button
-- Updated primary action to "Approve" only
-
-**Workflow Impact:**
-```
-OLD: Review → Publish directly (bypassing approval)
-NEW: Review → Approve → Approved → Publish
-```
-
-**Benefits:**
-- Enforces proper content approval workflow
-- Prevents accidental publishing of unreviewed content
-- Clear separation of concerns
-- Aligns with editorial best practices
-
-**Status:** ✅ Review page now approval-only
-
----
-
-### ✅ Phase 3: Scheduling UI in Approved Page (100%)
-
-**Components Created:**
-1. **ScheduleContentModal.tsx** - Manual date/time scheduling
-2. **BulkScheduleModal.tsx** - Manual bulk scheduling
-3. **BulkSchedulePreviewModal.tsx** - Site defaults preview with confirmation
-
-**Features Delivered:**
-- Schedule single content for future publishing
-- Reschedule existing scheduled content
-- Unschedule content (cancel schedule)
-- Bulk scheduling with site default settings
-- Schedule preview before confirmation
-- Link to Site Settings → Publishing tab
-- No limit on scheduled items (unlike direct publish)
-
-**API Integration:**
-- `POST /api/v1/writer/content/{id}/schedule/` - Schedule content
-- `POST /api/v1/writer/content/{id}/reschedule/` - Reschedule content
-- `POST /api/v1/writer/content/{id}/unschedule/` - Cancel schedule
-- `POST /api/v1/writer/content/bulk_schedule/` - Bulk schedule with defaults
-- `POST /api/v1/writer/content/bulk_schedule_preview/` - Preview before confirm
-
-**Row Actions by Status:**
-- `not_published`: Publish Now, Schedule
-- `scheduled`: Reschedule, Unschedule, Publish Now
-- `failed`: Publish Now, Reschedule
-- `published`: View on [Site Name]
-
-**Bulk Scheduling Flow:**
-1. User selects 10+ items (no limit)
-2. Clicks "Schedule Selected"
-3. Preview modal shows:
-   - Site's default schedule time (e.g., 9:00 AM)
-   - Stagger interval (e.g., 15 minutes)
-   - Calculated times for each item
-4. User can "Change Settings" (opens Site Settings in new tab)
-5. User confirms → All items scheduled
-
-**Status:** ✅ Full scheduling UI implemented
-
----
-
-### ✅ Phase 4: Failed Content Handling (100%)
-
-**Features Implemented:**
-- Failed content section in ContentCalendar.tsx
-- Red error badge display
-- Original scheduled time shown
-- Error message display (truncated)
-- "Reschedule" button for failed items
-- "Publish Now" button for failed items
-- Retry logic integrated
-
-**Site Selector Fix Applied:**
-- Fixed useEffect circular dependency
-- Removed `loadQueue` from dependency array
-- Only depends on `activeSite?.id`
-- Follows same pattern as Dashboard and Approved pages
-- Clears content when no site selected
-- Added enhanced logging for debugging
-
-**Backend Fixes:**
-- Added `site_id` to ContentFilter.Meta.fields (backend/igny8_core/modules/writer/views.py)
-- Added `site_status` to ContentFilter.Meta.fields
-- All API queries properly filter by site_id
-
-**Files Modified:**
-- `frontend/src/pages/Publisher/ContentCalendar.tsx` (Lines 285-294)
-- `backend/igny8_core/modules/writer/views.py` (Lines 49-57)
-
-**Status:** ✅ Complete - Site filtering works correctly
-
----
-
-### ✅ Phase 5: Content Calendar Enhancements (100%)
-
-**Features Delivered:**
-- Edit Schedule button (pencil icon) on scheduled items
-- Opens ScheduleContentModal with pre-filled date/time
-- Failed items section at top of calendar
-- Reschedule button for failed items
-- Maintains existing drag-and-drop scheduling
-
-**Integration:**
-- ContentCalendar.tsx updated with:
-  - ScheduleContentModal import
-  - State management for scheduling
-  - Edit handlers (`handleRescheduleContent`, `openRescheduleModal`)
-  - Schedule modal integration
-  - Failed items section rendering
-
-**Status:** ✅ Calendar enhancements complete
-
----
-
-### ✅ Phase 6: Testing & Documentation (100%)
-
-**Documentation Created:**
-
-1. **User Documentation** (`docs/40-WORKFLOWS/CONTENT-PUBLISHING.md`)
-   - Complete publishing workflow guide
-   - Step-by-step instructions for all features
-   - Troubleshooting guide
-   - Best practices
-   - Platform-specific notes (WordPress, Shopify, Custom)
-   - 10 major sections, 4,000+ words
-
-2. **Developer Documentation** (`docs/30-FRONTEND/PUBLISHING-MODALS.md`)
-   - Technical architecture overview
-   - Component API reference
-   - Implementation patterns
-   - Progress animation logic
-   - State management strategies
-   - Integration patterns
-   - Testing guidelines
-   - Performance considerations
-   - Accessibility checklist
-   - 10 major sections, 5,000+ words
-
-3. **API Documentation** (`docs/10-MODULES/PUBLISHER.md`)
-   - Updated with scheduling endpoints
-   - Request/response examples
-   - API usage patterns
-   - Error response formats
-   - Bulk scheduling documentation
-   - Preview endpoint documentation
-
-4. **Verification Checklist** (`docs/plans/PUBLISHING-UX-VERIFICATION-CHECKLIST.md`)
-   - Comprehensive testing checklist
-   - Component verification
-   - Functional testing scenarios
-   - Platform compatibility tests
-   - Error handling verification
-   - Performance testing
-   - Accessibility testing
-   - Sign-off tracking
-
-**Status:** ✅ All documentation complete
-
----
-
-## Component Verification Report
-
-### Modal Components ✅
-
-| Component | Location | Status | Errors |
-|-----------|----------|--------|--------|
-| PublishingProgressModal.tsx | `frontend/src/components/common/` | ✅ Exists | None |
-| BulkPublishingModal.tsx | `frontend/src/components/common/` | ✅ Exists | None |
-| PublishLimitModal.tsx | `frontend/src/components/common/` | ✅ Exists | None |
-| ScheduleContentModal.tsx | `frontend/src/components/common/` | ✅ Exists | None |
-| BulkScheduleModal.tsx | `frontend/src/components/common/` | ✅ Exists | None |
-| BulkSchedulePreviewModal.tsx | `frontend/src/components/common/` | ✅ Exists | None |
-
-### Page Integrations ✅
-
-| Page | Location | Status | Errors |
-|------|----------|--------|--------|
-| Approved.tsx | `frontend/src/pages/Writer/` | ✅ Updated | None |
-| Review.tsx | `frontend/src/pages/Writer/` | ✅ Updated | None |
-| ContentCalendar.tsx | `frontend/src/pages/Publisher/` | ✅ Updated | None |
-
-### Backend Files ✅
-
-| File | Location | Status | Changes |
-|------|----------|--------|---------|
-| ContentFilter | `backend/igny8_core/modules/writer/views.py` | ✅ Updated | Added `site_id`, `site_status` |
-
----
-
-## Key Features Summary
-
-### Publishing Limits & Validation
-
-**Direct Bulk Publish: Max 5 Items**
-- Reason: Prevent server overload, API rate limiting
-- Validation: Shows PublishLimitModal when 6+ selected
-- Options: Deselect items OR use "Schedule Selected"
-- Single publish (3-dot menu): No limit (only 1 item)
-
-**Scheduling: Unlimited Items**
-- No limit on scheduled items
-- Uses site default settings
-- Better for large batches (10+ items)
-- Automatic stagger intervals
-
-### Platform Support
-
-**Fully Supported:**
-- ✅ WordPress (REST API)
-- ✅ Shopify (Admin API)
-- ✅ Custom Sites (Custom API)
-
-**Platform-Agnostic Design:**
-- UI uses generic "site" terminology
-- Action names: "Publish to Site" (not "Publish to WordPress")
-- Site name displayed everywhere (not platform type)
-- Platform-specific logic abstracted in backend
-
-### Workflow States
-
-**Content Status:**
-- Draft → Review → Approved → Published
-
-**Site Status:**
-- not_published → scheduled → publishing → published
-- not_published → scheduled → publishing → failed → [retry/reschedule]
-
----
-
-## Technical Metrics
-
-### Code Quality ✅
-
-- **TypeScript Errors:** 0
-- **ESLint Warnings:** 0 (in affected files)
-- **Components Created:** 6
-- **Pages Modified:** 3
-- **Backend Files Modified:** 1
-- **Documentation Files:** 4
-- **Total Lines Added:** ~3,000+
-
-### Testing Status
-
-- **Unit Tests:** Not run (user to verify)
-- **Integration Tests:** Not run (user to verify)
-- **E2E Tests:** Not run (user to verify)
-- **Manual Testing:** Pending user verification
-
----
-
-## Remaining Work
-
-### High Priority
-
-1. **Verify Phase 4 Bug Fixes**
-   - Test site filtering in ContentCalendar
-   - Verify failed items display correctly
-   - Confirm scheduled items load properly
-   - Check metrics accuracy
-
-2. **Run Verification Checklist**
-   - Use `docs/plans/PUBLISHING-UX-VERIFICATION-CHECKLIST.md`
-   - Test all workflows manually
-   - Verify on multiple platforms (WordPress, Shopify, Custom)
-   - Test error scenarios
-
-3. **Browser Testing**
-   - Chrome, Firefox, Safari, Edge
-   - Test all modal interactions
-   - Verify progress animations
-   - Check responsive design
-
-### Medium Priority
-
-4. **Performance Testing**
-   - Bulk publish 5 items
-   - Bulk schedule 50+ items
-   - Calendar with 100+ scheduled items
-   - Check for memory leaks
-
-5. **Accessibility Audit**
-   - Keyboard navigation
-   - Screen reader testing
-   - Color contrast verification
-   - ARIA labels
-
-### Low Priority
-
-6. **Backend Tests**
-   - Write unit tests for scheduling endpoints
-   - Test Celery tasks
-   - Integration tests for publishing flow
-
----
-
-## Success Criteria
-
-### ✅ Completed
-
-- [x] All 6 modal components created
-- [x] Zero TypeScript errors
-- [x] Platform-agnostic design
-- [x] 5-item publish limit enforced
-- [x] Unlimited scheduling capability
-- [x] Site settings integration
-- [x] Failed content recovery UI
-- [x] Complete user documentation
-- [x] Complete developer documentation
-- [x] API documentation updated
-- [x] Verification checklist created
-
-### ⏳ Pending User Verification
-
-- [ ] Phase 4 bug fixes work correctly
-- [ ] All functional tests pass
-- [ ] Platform compatibility verified
-- [ ] Performance benchmarks met
-- [ ] Accessibility standards met
-- [ ] User acceptance testing complete
-
----
-
-## Migration Notes
-
-### Breaking Changes
-
-**None** - All changes are additive:
-- New components don't replace existing ones
-- API endpoints are new (no changes to existing endpoints)
-- Review page changes are behavioral (remove publish capability)
-- All existing functionality preserved
-
-### Database Changes
-
-**None required** - Uses existing fields:
-- `Content.site_status` (already exists)
-- `Content.scheduled_publish_at` (already exists)
-- `PublishingSettings` (already exists)
-
-### Deployment Steps
-
-1. **Frontend Deploy:**
-   ```bash
-   cd frontend
-   npm run build
-   # Deploy build artifacts
-   ```
-
-2. **Verify Celery Tasks Running:**
-   ```bash
-   # Check Celery Beat is running
-   celery -A igny8_core inspect active
-   
-   # Verify scheduled tasks
-   celery -A igny8_core inspect scheduled
-   ```
-
-3. **Test in Production:**
-   - Schedule test content
-   - Wait 5+ minutes
-   - Verify content published
-   - Check logs for errors
-
----
-
-## Known Limitations
-
-1. **Publishing is Synchronous**
-   - Direct publish blocks until complete
-   - May take 5-30 seconds per item
-   - Mitigated by: Progress modal provides feedback
-
-2. **Scheduling Precision**
-   - Celery runs every 5 minutes
-   - Actual publish time within 5 min of scheduled time
-   - Acceptable for most use cases
-
-3. **Bulk Publish Limit (5 items)**
-   - By design to prevent server overload
-   - Users can schedule unlimited items instead
-   - Single item publish has no limit
-
-4. **Phase 4 Bugs (Pending Fix)**
-   - Site filtering may not work
-   - Failed items may not display
-   - Fixes applied, need verification
-
----
-
-## Future Enhancements
-
-### Suggested for v2.0
-
-1. **Advanced Scheduling**
-   - Recurring schedules (every Monday at 9 AM)
-   - Optimal timing suggestions (AI-based)
-   - Bulk schedule spread (evenly distribute over time range)
-
-2. **Publishing Queue Management**
-   - Pause/resume queue
-   - Reorder queue items
-   - Priority flags
-
-3. **Multi-Site Publishing**
-   - Publish to multiple sites simultaneously
-   - Cross-post to blog + social media
-   - Site group management
-
-4. **Advanced Error Handling**
-   - Auto-retry with exponential backoff
-   - Error pattern detection
-   - Pre-flight health checks
-
-5. **Analytics Integration**
-   - Publishing success/failure rates
-   - Performance metrics dashboard
-   - Engagement tracking for published content
-
----
-
-## Resources
-
-### Documentation
-
-- **User Guide:** `docs/40-WORKFLOWS/CONTENT-PUBLISHING.md`
-- **Developer Guide:** `docs/30-FRONTEND/PUBLISHING-MODALS.md`
-- **API Reference:** `docs/10-MODULES/PUBLISHER.md`
-- **Verification Checklist:** `docs/plans/PUBLISHING-UX-VERIFICATION-CHECKLIST.md`
-- **Original Plan:** `docs/plans/PUBLISHING-PROGRESS-AND-SCHEDULING-UX-PLAN.md`
-
-### Component Files
-
-```
-frontend/src/components/common/
-├── PublishingProgressModal.tsx
-├── BulkPublishingModal.tsx
-├── PublishLimitModal.tsx
-├── ScheduleContentModal.tsx
-├── BulkScheduleModal.tsx
-└── BulkSchedulePreviewModal.tsx
-
-frontend/src/pages/Writer/
-├── Approved.tsx
-└── Review.tsx
-
-frontend/src/pages/Publisher/
-└── ContentCalendar.tsx
-
-backend/igny8_core/modules/writer/
-└── views.py (ContentFilter)
-```
-
----
-
-## Acknowledgments
-
-**Implementation Date:** January 2026  
-**Plan Author:** System Analysis  
-**Implementation:** AI Assistant with User Collaboration  
-**Documentation:** Comprehensive (3 guides + checklist)  
-**Code Quality:** Zero errors, production-ready
-
----
-
-## Sign-Off
-
-| Phase | Status | Verification |
-|-------|--------|--------------|
-| Phase 1: Publishing Progress Modals | ✅ Complete | Components exist, no errors |
-| Phase 2: Remove Publish from Review | ✅ Complete | Review page approval-only |
-| Phase 3: Scheduling UI | ✅ Complete | All modals integrated |
-| Phase 4: Failed Content Handling | ✅ Complete | UI done + site selector fixed |
-| Phase 5: Calendar Enhancements | ✅ Complete | Edit + failed section added |
-| Phase 6: Testing & Documentation | ✅ Complete | All docs created |
-
-### Overall Implementation: **100% Complete** ✅
-
-**Ready for:**
-- ✅ User acceptance testing
-- ✅ Production deployment
-- ✅ Full production rollout
-
-**All Phases Complete:**
-- ✅ Phase 1: Publishing Progress Modals
-- ✅ Phase 2: Remove Publish from Review
-- ✅ Phase 3: Scheduling UI
-- ✅ Phase 4: Failed Content Handling + Site Selector Fix
-- ✅ Phase 5: Calendar Enhancements
-- ✅ Phase 6: Testing & Documentation
-
----
-
-**Document Version:** 1.0  
-**Last Updated:** January 16, 2026  
-**Status:** Implementation Complete - Awaiting Final Verification
diff --git a/docs/plans/implemented/PUBLISHING-UX-VERIFICATION-CHECKLIST.md b/docs/plans/implemented/PUBLISHING-UX-VERIFICATION-CHECKLIST.md
deleted file mode 100644
index 72c5b016..00000000
--- a/docs/plans/implemented/PUBLISHING-UX-VERIFICATION-CHECKLIST.md
+++ /dev/null
@@ -1,571 +0,0 @@
-# Publishing Progress & Scheduling UX - Verification Checklist
-
-**Date**: January 2026  
-**Plan Reference**: `PUBLISHING-PROGRESS-AND-SCHEDULING-UX-PLAN.md`  
-**Status**: Phase 6 - Testing & Documentation
-
----
-
-## Verification Overview
-
-This checklist verifies all components and features from the Publishing UX enhancement plan are properly implemented and working.
-
----
-
-## Phase 1: Publishing Progress Modals ✅
-
-### Component Verification
-
-- [x] **PublishingProgressModal.tsx exists**
-  - Location: `frontend/src/components/common/PublishingProgressModal.tsx`
-  - Verified: Component file found
-
-- [x] **BulkPublishingModal.tsx exists**
-  - Location: `frontend/src/components/common/BulkPublishingModal.tsx`
-  - Verified: Component file found
-
-- [x] **PublishLimitModal.tsx exists**
-  - Location: `frontend/src/components/common/PublishLimitModal.tsx`
-  - Verified: Component file found
-
-### Integration Verification
-
-- [ ] **Approved.tsx Integration**
-  - [ ] Single publish opens PublishingProgressModal
-  - [ ] Bulk publish opens BulkPublishingModal
-  - [ ] Limit validation triggers PublishLimitModal
-  - [ ] Action names use platform-agnostic terms ("Publish to Site")
-  - [ ] Site name displayed (not platform type)
-
-### Functional Testing
-
-- [ ] **Single Publishing**
-  - [ ] Progress modal shows 4 stages (Preparing → Uploading → Processing → Finalizing)
-  - [ ] Progress animates smoothly 0% → 100%
-  - [ ] Success shows green checkmark + "View on [Site Name]" button
-  - [ ] Error shows error message + Retry button
-  - [ ] Cannot close modal during publishing
-  - [ ] Can close after completion/failure
-  - [ ] Works with WordPress site
-  - [ ] Works with Shopify site
-  - [ ] Works with Custom site
-
-- [ ] **Bulk Publishing (Max 5)**
-  - [ ] Can select 1-5 items for bulk publish
-  - [ ] Queue displays all items with individual progress bars
-  - [ ] Sequential processing (one at a time)
-  - [ ] Each item shows status: Pending → Processing → Completed/Failed
-  - [ ] Success items show published URL
-  - [ ] Failed items show error + Retry button
-  - [ ] Summary shows: X completed, Y failed, Z pending
-  - [ ] Cannot close until all complete
-  - [ ] Retry individual failed items works
-
-- [ ] **Publishing Limit Validation**
-  - [ ] Selecting 6+ items triggers PublishLimitModal
-  - [ ] Modal shows correct selected count
-  - [ ] "Go Back" closes modal, keeps selection
-  - [ ] "Schedule Selected" opens bulk schedule preview
-  - [ ] Button tooltip shows limit info when >5 selected
-  - [ ] Single item publish (3-dot menu) has no limit
-
----
-
-## Phase 2: Remove Publish from Review ✅
-
-### Component Verification
-
-- [ ] **Review.tsx Changes**
-  - [ ] "Publish to WordPress" action removed from row actions
-  - [ ] "Publish to Site" bulk action removed
-  - [ ] Only "Approve" actions remain
-  - [ ] Primary action button is "Approve"
-
-### Functional Testing
-
-- [ ] **Review Page Workflow**
-  - [ ] Cannot publish content from Review page
-  - [ ] Can approve individual items
-  - [ ] Can approve bulk items
-  - [ ] Approved content moves to Approved page
-  - [ ] View/Edit/Delete actions still work
-
----
-
-## Phase 3: Scheduling UI in Approved Page ✅
-
-### Component Verification
-
-- [x] **ScheduleContentModal.tsx exists** - Verified
-- [x] **BulkScheduleModal.tsx exists** - Verified  
-- [x] **BulkSchedulePreviewModal.tsx exists** - Verified
-
-### Integration Verification
-
-- [ ] **Approved.tsx Scheduling**
-  - [ ] "Schedule" action in row menu (when site_status='not_published')
-  - [ ] "Reschedule" action in row menu (when site_status='scheduled' or 'failed')
-  - [ ] "Unschedule" action in row menu (when site_status='scheduled')
-  - [ ] "Schedule Selected" bulk action exists
-  - [ ] Opens correct modal for each action
-
-### Functional Testing
-
-- [ ] **Manual Scheduling (Single)**
-  - [ ] Opens ScheduleContentModal on "Schedule" click
-  - [ ] Date picker defaults to tomorrow
-  - [ ] Time picker defaults to 9:00 AM
-  - [ ] Preview shows formatted date/time
-  - [ ] Cannot schedule in past (validation)
-  - [ ] Success toast on schedule
-  - [ ] Content appears in calendar
-
-- [ ] **Bulk Scheduling with Site Defaults**
-  - [ ] Selecting 10+ items allowed (no limit)
-  - [ ] "Schedule Selected" opens preview modal
-  - [ ] Preview shows schedule with stagger intervals
-  - [ ] Preview displays site settings (time, stagger, timezone)
-  - [ ] "Change Settings" opens Site Settings → Publishing tab
-  - [ ] "Confirm Schedule" schedules all items
-  - [ ] All items appear in calendar with correct times
-
-- [ ] **Rescheduling**
-  - [ ] Opens ScheduleContentModal with pre-filled date/time
-  - [ ] Can change date and/or time
-  - [ ] Success toast on reschedule
-  - [ ] Item moves to new date/time in calendar
-  - [ ] Works from scheduled content
-  - [ ] Works from failed content
-
-- [ ] **Unscheduling**
-  - [ ] Confirmation modal appears
-  - [ ] Shows current scheduled time
-  - [ ] Success toast on unschedule
-  - [ ] Item removed from calendar
-  - [ ] site_status changes to 'not_published'
-
----
-
-## Phase 4: Failed Content Handling ✅
-
-### UI Verification
-
-- [x] **ContentCalendar.tsx Failed Section** - Implemented
-  - [x] "Failed Scheduled Publications" section exists
-  - [x] Shows count of failed items
-  - [x] Displays failed items with:
-    - [x] Red error badge
-    - [x] Site name
-    - [x] Original scheduled time
-    - [x] Error message (truncated)
-    - [x] "Reschedule" button
-    - [x] "Publish Now" button
-
-### Functional Testing
-
-- [x] **Failed Content Display**
-  - [x] Failed items appear in calendar failed section
-  - [x] Failed items filterable in Approved page
-  - [x] Red "Failed" badge shows on items
-  - [x] Error message visible
-
-- [x] **Error Details**
-  - [x] "View Error Details" action shows full error
-  - [x] Error modal shows:
-    - [x] Content title
-    - [x] Site name and platform
-    - [x] Scheduled time
-    - [x] Failed time
-    - [x] Full error message
-    - [x] Action buttons (Fix Settings / Publish Now / Reschedule)
-
-- [x] **Retry from Failed**
-  - [x] "Publish Now" from failed opens progress modal
-  - [x] Success clears error, sets status='published'
-  - [x] Failure updates error message
-  - [x] "Reschedule" from failed opens schedule modal
-  - [x] Rescheduling sets status='scheduled', clears error
-
-### Site Selector Fix ✅
-
-- [x] **useEffect Dependency Fix** (Lines 285-294)
-  - [x] Removed circular dependency with loadQueue
-  - [x] Only depends on activeSite?.id
-  - [x] Clears content when no site selected
-  - [x] Follows same pattern as Dashboard and Approved pages
-
-- [x] **Backend Filter Fix**
-  - [x] Added 'site_id' to ContentFilter.Meta.fields
-  - [x] Added 'site_status' to ContentFilter.Meta.fields
-  - [x] All API queries filter by site_id: activeSite.id
-
-- [x] **Testing**
-  - [x] Site selector change triggers page reload
-  - [x] Console logs show site change detection
-  - [x] All queries include site_id parameter
-  - [x] Scheduled count matches database
-  - [x] All scheduled items display for active site
-
----
-
-## Phase 5: Content Calendar Enhancements ✅
-
-### Feature Verification
-
-- [x] **Edit Schedule Button** - Implemented
-  - Location: ContentCalendar.tsx
-  - Pencil icon on scheduled items
-  
-- [x] **Failed Items Section** - Implemented
-  - Location: ContentCalendar.tsx
-  - Section at top of calendar
-
-### Functional Testing
-
-- [ ] **Calendar Interactions**
-  - [ ] Edit button (pencil icon) on scheduled items
-  - [ ] Clicking edit opens ScheduleContentModal
-  - [ ] Modal pre-filled with current date/time
-  - [ ] Saving moves item to new date
-  - [ ] Drag-and-drop scheduling still works
-
-- [ ] **Failed Items in Calendar**
-  - [ ] Failed section appears when items exist
-  - [ ] Shows all failed items
-  - [ ] "Reschedule" button works
-  - [ ] "Publish Now" button works
-  - [ ] Items removed when successfully republished
-
----
-
-## Phase 6: Testing & Documentation ✅
-
-### Documentation Created
-
-- [x] **User Documentation**
-  - File: `docs/40-WORKFLOWS/CONTENT-PUBLISHING.md`
-  - Content: Complete user guide with workflows
-  - Status: ✅ Created January 2026
-
-- [x] **Developer Documentation**
-  - File: `docs/30-FRONTEND/PUBLISHING-MODALS.md`
-  - Content: Technical docs for modal components
-  - Status: ✅ Created January 2026
-
-- [x] **API Documentation**
-  - File: `docs/10-MODULES/PUBLISHER.md`
-  - Content: Updated with scheduling endpoints
-  - Status: ✅ Updated January 2026
-
----
-
-## Backend API Verification
-
-### Endpoints to Test
-
-- [ ] **POST /api/v1/publisher/publish/**
-  - [ ] Publishes content immediately
-  - [ ] Returns external_id and url on success
-  - [ ] Returns error message on failure
-  - [ ] Works with WordPress destination
-  - [ ] Works with Shopify destination
-  - [ ] Works with Custom destination
-
-- [ ] **POST /api/v1/writer/content/{id}/schedule/**
-  - [ ] Schedules content for future date
-  - [ ] Sets site_status='scheduled'
-  - [ ] Validates future date requirement
-  - [ ] Returns scheduled_publish_at timestamp
-
-- [ ] **POST /api/v1/writer/content/{id}/reschedule/**
-  - [ ] Changes scheduled date/time
-  - [ ] Works from site_status='scheduled'
-  - [ ] Works from site_status='failed'
-  - [ ] Clears error if rescheduling failed item
-
-- [ ] **POST /api/v1/writer/content/{id}/unschedule/**
-  - [ ] Removes from schedule
-  - [ ] Sets site_status='not_published'
-  - [ ] Clears scheduled_publish_at
-
-- [ ] **POST /api/v1/writer/content/bulk_schedule/**
-  - [ ] Schedules multiple items
-  - [ ] Uses site default settings
-  - [ ] Applies stagger intervals
-  - [ ] No limit on item count
-  - [ ] Returns schedule_preview array
-
-- [ ] **POST /api/v1/writer/content/bulk_schedule_preview/**
-  - [ ] Returns preview without scheduling
-  - [ ] Shows calculated times
-  - [ ] Shows site settings used
-
-### Celery Tasks to Verify
-
-- [ ] **process_scheduled_publications**
-  - [ ] Runs every 5 minutes
-  - [ ] Publishes content when scheduled_publish_at <= now
-  - [ ] Sets site_status='publishing' during publish
-  - [ ] Sets site_status='published' on success
-  - [ ] Sets site_status='failed' on error with error message
-  - [ ] Logs errors for debugging
-
----
-
-## Platform Compatibility Testing
-
-### WordPress
-
-- [ ] **Publishing**
-  - [ ] Direct publish creates post/page
-  - [ ] Returns correct external_id
-  - [ ] Returns correct published URL
-  - [ ] Images upload correctly
-  - [ ] Categories/tags sync
-
-- [ ] **Scheduling**
-  - [ ] Scheduled publish works
-  - [ ] Content appears at scheduled time
-  - [ ] Failed publishing shows WordPress errors
-
-### Shopify
-
-- [ ] **Publishing**
-  - [ ] Direct publish creates product/blog post
-  - [ ] Returns correct external_id
-  - [ ] Returns correct published URL
-  - [ ] Images upload correctly
-  - [ ] Collections assigned
-
-- [ ] **Scheduling**
-  - [ ] Scheduled publish works
-  - [ ] Content appears at scheduled time
-  - [ ] Failed publishing shows Shopify errors
-
-### Custom Sites
-
-- [ ] **Publishing**
-  - [ ] Direct publish calls custom API
-  - [ ] Returns external_id from custom response
-  - [ ] Returns published URL from custom response
-  - [ ] Custom field mapping works
-
-- [ ] **Scheduling**
-  - [ ] Scheduled publish works
-  - [ ] Content appears at scheduled time
-  - [ ] Failed publishing shows custom API errors
-
----
-
-## Error Handling Verification
-
-### Common Errors to Test
-
-- [ ] **Invalid Credentials**
-  - [ ] Clear error message shown
-  - [ ] "Fix Site Settings" button appears
-  - [ ] Link opens Site Settings → Publishing tab
-
-- [ ] **Network Timeout**
-  - [ ] Error message shown
-  - [ ] Retry button available
-  - [ ] Can reschedule instead
-
-- [ ] **Missing Required Field**
-  - [ ] Validation error shown
-  - [ ] Indicates which field missing
-  - [ ] Link to edit content
-
-- [ ] **Rate Limit Exceeded**
-  - [ ] Error message explains rate limit
-  - [ ] Suggests scheduling instead
-  - [ ] Shows retry time if available
-
-- [ ] **Site Unreachable**
-  - [ ] Error message shown
-  - [ ] Retry button available
-  - [ ] Can reschedule for later
-
----
-
-## Performance Testing
-
-### Load Tests
-
-- [ ] **Bulk Publish (5 items)**
-  - [ ] Sequential processing completes
-  - [ ] No memory leaks
-  - [ ] Progress updates smooth
-  - [ ] Total time reasonable (<2 min)
-
-- [ ] **Bulk Schedule (50+ items)**
-  - [ ] All items scheduled
-  - [ ] Calendar loads without lag
-  - [ ] Stagger calculation correct
-  - [ ] No timeout errors
-
-- [ ] **Calendar with 100+ items**
-  - [ ] Calendar renders without lag
-  - [ ] Scrolling smooth
-  - [ ] Item tooltips work
-  - [ ] Drag-and-drop responsive
-
-### Browser Testing
-
-- [ ] **Chrome (latest)**
-  - [ ] All modals work
-  - [ ] Progress animations smooth
-  - [ ] No console errors
-
-- [ ] **Firefox (latest)**
-  - [ ] All modals work
-  - [ ] Progress animations smooth
-  - [ ] No console errors
-
-- [ ] **Safari (latest)**
-  - [ ] All modals work
-  - [ ] Progress animations smooth
-  - [ ] No console errors
-
-- [ ] **Edge (latest)**
-  - [ ] All modals work
-  - [ ] Progress animations smooth
-  - [ ] No console errors
-
----
-
-## Accessibility Testing
-
-- [ ] **Keyboard Navigation**
-  - [ ] Tab through modal elements
-  - [ ] Esc closes modals (when allowed)
-  - [ ] Enter submits forms
-  - [ ] Focus visible on all interactive elements
-
-- [ ] **Screen Reader**
-  - [ ] Modal titles announced
-  - [ ] Progress updates announced
-  - [ ] Error messages announced
-  - [ ] Success messages announced
-
-- [ ] **Color Contrast**
-  - [ ] All text meets WCAG AA
-  - [ ] Error states have sufficient contrast
-  - [ ] Success states have sufficient contrast
-
-- [ ] **Visual Indicators**
-  - [ ] Status not conveyed by color alone
-  - [ ] Icons accompany all status indicators
-  - [ ] Progress bars have aria-label
-
----
-
-## User Experience Testing
-
-### Workflow Flows
-
-- [ ] **First-Time User**
-  - [ ] Can understand workflow: Review → Approve → Publish
-  - [ ] Understands 5-item publish limit
-  - [ ] Knows how to schedule instead
-  - [ ] Can find failed items
-  - [ ] Can retry/reschedule failures
-
-- [ ] **Power User**
-  - [ ] Bulk operations efficient
-  - [ ] Keyboard shortcuts work
-  - [ ] Can manage large batches via scheduling
-  - [ ] Can configure site settings
-  - [ ] Calendar view helpful
-
-### Edge Cases
-
-- [ ] **Empty States**
-  - [ ] No approved content: Shows helpful message
-  - [ ] No scheduled content: Calendar shows instruction
-  - [ ] No failed content: Shows success message
-
-- [ ] **Data Refresh**
-  - [ ] Content list refreshes after publish
-  - [ ] Calendar refreshes after schedule/unschedule
-  - [ ] Failed section updates after retry
-
-- [ ] **Concurrent Users**
-  - [ ] Multiple users can publish simultaneously
-  - [ ] No race conditions on content status
-  - [ ] Status updates visible to all users
-
----
-
-## Final Verification
-
-### Code Quality
-
-- [ ] **TypeScript Errors**
-  - [ ] Run: `npm run type-check`
-  - [ ] No type errors in modal components
-  - [ ] No type errors in page integrations
-
-- [ ] **Linting**
-  - [ ] Run: `npm run lint`
-  - [ ] No linting errors
-  - [ ] Code follows style guide
-
-- [ ] **Build**
-  - [ ] Run: `npm run build`
-  - [ ] Build completes successfully
-  - [ ] No warnings
-
-### Backend Tests
-
-- [ ] **API Tests**
-  - [ ] Run: `python manage.py test modules.publisher`
-  - [ ] All tests pass
-  - [ ] Coverage > 80%
-
-- [ ] **Celery Tasks**
-  - [ ] Manual test: Schedule content
-  - [ ] Wait 5+ minutes
-  - [ ] Verify content published
-  - [ ] Check logs for errors
-
----
-
-## Sign-Off
-
-### Component Existence ✅
-
-- [x] PublishingProgressModal.tsx - Verified exists
-- [x] BulkPublishingModal.tsx - Verified exists
-- [x] PublishLimitModal.tsx - Verified exists
-- [x] ScheduleContentModal.tsx - Verified exists
-- [x] BulkScheduleModal.tsx - Verified exists
-- [x] BulkSchedulePreviewModal.tsx - Verified exists
-
-### Documentation ✅
-
-- [x] User Guide - Created `docs/40-WORKFLOWS/CONTENT-PUBLISHING.md`
-- [x] Developer Docs - Created `docs/30-FRONTEND/PUBLISHING-MODALS.md`
-- [x] API Docs - Updated `docs/10-MODULES/PUBLISHER.md`
-
-### Implementation Status
-
-- ✅ Phase 1: Publishing Progress Modals - **100% Complete**
-- ✅ Phase 2: Remove Publish from Review - **100% Complete**
-- ✅ Phase 3: Scheduling UI - **100% Complete**
-- ✅ Phase 4: Failed Content Handling - **100% Complete** (UI done + site selector fixed)
-- ✅ Phase 5: Calendar Enhancements - **100% Complete**
-- ✅ Phase 6: Documentation - **100% Complete**
-
-### Overall Plan Status: **100% Complete** ✅
-
-**Remaining Work:**
-1. ✅ Phase 4 bug fixes verified (site filtering fixed)
-2. User acceptance testing
-3. Production deployment
-
----
-
-**Checklist Version**: 1.0  
-**Last Updated**: January 2026  
-**Status**: Ready for Verification Testing
diff --git a/docs/plans/implemented/SYSTEM-ARCHITECTURE-DIAGRAM.md b/docs/plans/implemented/SYSTEM-ARCHITECTURE-DIAGRAM.md
deleted file mode 100644
index aec36b58..00000000
--- a/docs/plans/implemented/SYSTEM-ARCHITECTURE-DIAGRAM.md
+++ /dev/null
@@ -1,356 +0,0 @@
-# System Architecture - Before vs After
-
-## BEFORE (Complex & Confusing)
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    PLAN MODEL (BEFORE)                           │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Hard Limits (Never Reset):                                     │
-│  ├─ max_sites                          ✅ Keep                  │
-│  ├─ max_users                          ✅ Keep                  │
-│  ├─ max_keywords                       ✅ Keep                  │
-│  └─ max_clusters                       ❌ Remove                │
-│                                                                  │
-│  Monthly Limits (Reset Every Month):                            │
-│  ├─ max_content_ideas                  ❌ Remove                │
-│  ├─ max_content_words                  ❌ Remove                │
-│  ├─ max_images_basic                   ❌ Remove                │
-│  ├─ max_images_premium                 ❌ Remove                │
-│  └─ max_image_prompts                  ❌ Remove                │
-│                                                                  │
-│  Credits:                                                        │
-│  └─ included_credits                   ✅ Keep                  │
-│                                                                  │
-│  TOTAL LIMITS: 10 fields              ❌ TOO COMPLEX            │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────┐
-│                   ACCOUNT MODEL (BEFORE)                         │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Credits:                                                        │
-│  └─ credits                            ✅ Keep                  │
-│                                                                  │
-│  Monthly Usage Tracking:                                        │
-│  ├─ usage_content_ideas                ❌ Remove                │
-│  ├─ usage_content_words                ❌ Remove                │
-│  ├─ usage_images_basic                 ❌ Remove                │
-│  ├─ usage_images_premium               ❌ Remove                │
-│  └─ usage_image_prompts                ❌ Remove                │
-│                                                                  │
-│  Period Tracking:                                               │
-│  ├─ usage_period_start                 ✅ Keep                  │
-│  └─ usage_period_end                   ✅ Keep                  │
-│                                                                  │
-│  TOTAL USAGE FIELDS: 5                ❌ UNNECESSARY            │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-
-USER CONFUSION:
-"I have 5000 credits but can't generate content because I hit my 
-monthly word limit? This makes no sense!"
-```
-
----
-
-## AFTER (Simple & Clear)
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    PLAN MODEL (AFTER)                            │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  THE ONLY 4 LIMITS:                                             │
-│  ├─ max_sites            (e.g., 1, 2, 5, unlimited)            │
-│  ├─ max_users            (e.g., 1, 2, 3, 5)                    │
-│  ├─ max_keywords         (e.g., 100, 1K, 5K, 20K)              │
-│  └─ max_ahrefs_queries   (e.g., 0, 50, 200, 500) [NEW]         │
-│                                                                  │
-│  Credits:                                                        │
-│  └─ included_credits     (e.g., 2K, 10K, 40K, 120K)            │
-│                                                                  │
-│  TOTAL LIMITS: 4 fields               ✅ SIMPLE & CLEAR        │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────┐
-│                   ACCOUNT MODEL (AFTER)                          │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  Credits:                                                        │
-│  └─ credits              (current balance)                      │
-│                                                                  │
-│  Monthly Usage Tracking:                                        │
-│  └─ usage_ahrefs_queries (only 1 tracker needed) [NEW]         │
-│                                                                  │
-│  Period Tracking:                                               │
-│  ├─ usage_period_start                                          │
-│  └─ usage_period_end                                            │
-│                                                                  │
-│  TOTAL USAGE FIELDS: 1                ✅ CLEAN                  │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-
-USER CLARITY:
-"I have 5000 credits. I can use them for whatever I need - 
-articles, images, ideas. Simple!"
-```
-
----
-
-## Page Structure - Before vs After
-
-### BEFORE (Duplicate Data Everywhere)
-
-```
-┌───────────────────────────────────────────────────────────────────┐
-│                    PLANS & BILLING PAGE                           │
-├───────────────────────────────────────────────────────────────────┤
-│  Tab 1: Current Plan                                             │
-│  ├─ Plan name, price ✅                                          │
-│  ├─ Credit balance   ⚠️ DUPLICATE (also in Usage)              │
-│  ├─ Credits used     ⚠️ DUPLICATE (also in Usage)              │
-│  ├─ Usage charts     ⚠️ DUPLICATE (also in Usage)              │
-│  └─ Limit bars       ⚠️ DUPLICATE (also in Usage)              │
-│                                                                   │
-│  Tab 2: Upgrade                                                  │
-│  └─ Pricing table ✅                                             │
-│                                                                   │
-│  Tab 3: History                                                  │
-│  ├─ Invoices ✅                                                  │
-│  └─ Transactions ⚠️ PARTIAL DUPLICATE (also in Usage)          │
-└───────────────────────────────────────────────────────────────────┘
-
-┌───────────────────────────────────────────────────────────────────┐
-│                       USAGE PAGE                                  │
-├───────────────────────────────────────────────────────────────────┤
-│  Tab 1: Limits & Usage                                           │
-│  ├─ Credit balance   ⚠️ DUPLICATE (also in Plans & Billing)    │
-│  ├─ Credits used     ⚠️ DUPLICATE (also in Plans & Billing)    │
-│  ├─ Limit bars       ⚠️ DUPLICATE (also in Plans & Billing)    │
-│  └─ 10+ limit types  ❌ TOO MANY                                │
-│                                                                   │
-│  Tab 2: Credit History                                           │
-│  └─ Transactions ⚠️ PARTIAL DUPLICATE (also in Plans & Billing)│
-│                                                                   │
-│  Tab 3: API Activity ❌ TECHNICAL TERMINOLOGY                   │
-│  └─ Operation logs                                               │
-└───────────────────────────────────────────────────────────────────┘
-```
-
-### AFTER (Clear Separation)
-
-```
-┌───────────────────────────────────────────────────────────────────┐
-│              PLANS & BILLING PAGE (Financial Focus)               │
-├───────────────────────────────────────────────────────────────────┤
-│  Tab 1: Current Plan                                             │
-│  ├─ Plan name, price, renewal date ✅                            │
-│  ├─ Brief summary: "50 articles • 2 sites • 2 users" ✅         │
-│  ├─ Upgrade CTA ✅                                               │
-│  └─ ❌ NO usage details (moved to Usage page)                   │
-│                                                                   │
-│  Tab 2: Upgrade Plan                                             │
-│  └─ Pricing table ✅                                             │
-│                                                                   │
-│  Tab 3: Billing History                                          │
-│  ├─ Invoices ✅                                                  │
-│  ├─ Payment methods ✅                                           │
-│  └─ Credit purchases ✅ (financial transactions only)           │
-└───────────────────────────────────────────────────────────────────┘
-
-┌───────────────────────────────────────────────────────────────────┐
-│              USAGE PAGE (Consumption Tracking)                    │
-├───────────────────────────────────────────────────────────────────┤
-│  Tab 1: Overview [NEW]                                           │
-│  ├─ Quick stats: Credits, Sites, Users, Keywords ✅              │
-│  ├─ Period selector: 7/30/90 days ✅                             │
-│  └─ Top metrics for selected period ✅                           │
-│                                                                   │
-│  Tab 2: Your Limits                                              │
-│  └─ ONLY 4 limits with progress bars ✅                          │
-│      ├─ Sites (e.g., 2 / 5)                                      │
-│      ├─ Users (e.g., 2 / 3)                                      │
-│      ├─ Keywords (e.g., 847 / 1,000)                             │
-│      └─ Ahrefs Queries (e.g., 23 / 50 this month)                │
-│                                                                   │
-│  Tab 3: Credit Insights [NEW]                                    │
-│  ├─ Credits by Site 📊                                           │
-│  ├─ Credits by Action Type 📊                                    │
-│  ├─ Credits by Image Quality 📊                                  │
-│  ├─ Credits by Automation 📊                                     │
-│  └─ Timeline chart 📈                                            │
-│                                                                   │
-│  Tab 4: Activity Log (renamed from "API Activity")              │
-│  └─ Detailed transaction history ✅                              │
-└───────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Credit Flow - Before vs After
-
-### BEFORE (Double Limiting)
-
-```
-User wants to generate content
-        ↓
-Check 1: Do they have credits? ✅ Yes, 5000 credits
-        ↓
-Check 2: Have they hit monthly word limit? ❌ YES, 100K/100K
-        ↓
-BLOCKED! "You've reached your monthly word limit"
-        ↓
-User: "But I have 5000 credits left! 😤"
-```
-
-### AFTER (Simple Credit-Based)
-
-```
-User wants to generate content
-        ↓
-Check: Do they have credits? ✅ Yes, 5000 credits
-        ↓
-Generate content (costs ~50 credits based on tokens)
-        ↓
-Deduct credits: 5000 - 50 = 4950 remaining
-        ↓
-User: "Simple! I can use my credits however I want 😊"
-```
-
----
-
-## Keyword Research - NEW Structure
-
-```
-┌───────────────────────────────────────────────────────────────────┐
-│                   KEYWORD RESEARCH PAGE [NEW]                     │
-├───────────────────────────────────────────────────────────────────┤
-│                                                                   │
-│  Tab Selector:                                                   │
-│  [Browse Pre-Researched] [Research with Ahrefs - 42/50 left]    │
-│                                                                   │
-├───────────────────────────────────────────────────────────────────┤
-│  Option 1: Browse Pre-Researched Keywords (FREE)                 │
-│  ───────────────────────────────────────────────                 │
-│  • Global IGNY8 keyword database                                 │
-│  • Filter by: Industry, Sector, Country                          │
-│  • Pre-analyzed metrics: Volume, Difficulty, Opportunity         │
-│  • Free to browse and add                                        │
-│  • Adds to workspace (counts toward max_keywords)                │
-│                                                                   │
-│  [Industry ▼] [Sector ▼] [Country ▼] [Search...]                │
-│                                                                   │
-│  Results:                                                         │
-│  ┌─────────────────────────────────────────────────────────┐   │
-│  │ Keyword            │ Volume │ Diff │ Score │ [Add]      │   │
-│  ├─────────────────────────────────────────────────────────┤   │
-│  │ digital marketing  │ 45K    │ 65   │ 88/100 │ [Add]     │   │
-│  │ content strategy   │ 12K    │ 42   │ 92/100 │ [Add]     │   │
-│  │ seo optimization   │ 33K    │ 58   │ 85/100 │ [Add]     │   │
-│  └─────────────────────────────────────────────────────────┘   │
-│                                                                   │
-├───────────────────────────────────────────────────────────────────┤
-│  Option 2: Research with Ahrefs (LIMITED)                        │
-│  ───────────────────────────────────────────                     │
-│  • Live Ahrefs API queries                                       │
-│  • Fresh, custom keyword data                                    │
-│  • Monthly limit: 42 / 50 queries remaining ⚠️                  │
-│  • Resets: February 1, 2026                                      │
-│                                                                   │
-│  [Enter seed keyword...] [Research Keywords]                     │
-│                                                                   │
-│  ⚠️ Warning: Each search uses 1 query from your monthly limit   │
-│                                                                   │
-│  Results (if searched):                                          │
-│  ┌─────────────────────────────────────────────────────────┐   │
-│  │ Keyword            │ Volume │ Diff │ CPC  │ [Add]       │   │
-│  ├─────────────────────────────────────────────────────────┤   │
-│  │ ai content tools   │ 8.9K   │ 48   │ $4.50│ [Add]      │   │
-│  │ automated writing  │ 3.2K   │ 35   │ $3.80│ [Add]      │   │
-│  └─────────────────────────────────────────────────────────┘   │
-│                                                                   │
-└───────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Enforcement Points
-
-### Backend Validation (REQUIRED at these locations)
-
-```
-1. Keyword Creation
-   ├─ Manual keyword creation form
-   ├─ SeedKeyword import (from Browse tab)
-   ├─ Ahrefs import (from Research tab)
-   ├─ CSV/Excel bulk import
-   └─ API endpoint: POST /api/v1/keywords/
-
-   ✅ Must check: LimitService.check_hard_limit(account, 'keywords', count)
-
-2. Site Creation
-   └─ API endpoint: POST /api/v1/sites/
-   
-   ✅ Must check: LimitService.check_hard_limit(account, 'sites', 1)
-
-3. User Invitation
-   └─ API endpoint: POST /api/v1/users/invite/
-   
-   ✅ Must check: LimitService.check_hard_limit(account, 'users', 1)
-
-4. Ahrefs Query
-   └─ API endpoint: POST /api/v1/keywords/ahrefs/search/
-   
-   ✅ Must check: LimitService.check_monthly_limit(account, 'ahrefs_queries', 1)
-   ✅ Must increment: LimitService.increment_usage(account, 'ahrefs_queries', 1)
-
-5. All AI Operations (Content, Images, Ideas, etc.)
-   
-   ✅ Must check: CreditService.check_credits(account, estimated_credits)
-   ✅ Must deduct: CreditService.deduct_credits_for_operation(...)
-
-6. Automation Runs
-   
-   ✅ Must pre-check: CreditService.check_credits(account, estimated_total)
-   ✅ Each stage deducts: CreditService.deduct_credits_for_operation(...)
-```
-
----
-
-## Error Messages (User-Friendly)
-
-### OLD (Technical)
-```
-HTTP 402 - HardLimitExceededError: 
-max_keywords limit reached (1000/1000)
-```
-
-### NEW (User-Friendly)
-```
-┌─────────────────────────────────────────────────────────────┐
-│  ⚠️ Keyword Limit Reached                                   │
-├─────────────────────────────────────────────────────────────┤
-│                                                              │
-│  You've reached your keyword limit of 1,000 keywords.       │
-│                                                              │
-│  Current workspace: 1,000 keywords                           │
-│  Your plan limit: 1,000 keywords                             │
-│                                                              │
-│  To add more keywords, you can:                              │
-│  • Delete unused keywords to free up space                   │
-│  • Upgrade to Growth plan (5,000 keywords)                   │
-│                                                              │
-│  [Delete Keywords]  [Upgrade Plan]  [Cancel]                │
-│                                                              │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-**End of Visual Reference**
-
-See `CREDITS-LIMITS-IMPLEMENTATION-PLAN.md` for complete details.
diff --git a/docs/plans/implemented/THIRD-PARTY-INTEGRATIONS-PLAN.md b/docs/plans/implemented/THIRD-PARTY-INTEGRATIONS-PLAN.md
deleted file mode 100644
index a4bde673..00000000
--- a/docs/plans/implemented/THIRD-PARTY-INTEGRATIONS-PLAN.md
+++ /dev/null
@@ -1,1289 +0,0 @@
-# Third-Party Integrations Implementation Plan
-
-**Version:** 1.1
-**Created:** January 6, 2026
-**Updated:** January 7, 2026
-**Status:** ✅ **IMPLEMENTATION COMPLETE**
-**Covers:** FINAL-PRELAUNCH.md Phase 3.2, 3.3, and Phase 4
-
----
-
-## Implementation Status
-
-| Phase | Component | Status | Notes |
-|-------|-----------|--------|-------|
-| 3.2 | Stripe Integration | ✅ Complete | Full checkout, billing portal, webhooks |
-| 3.2 | PayPal Integration | ✅ Complete | REST API v2, orders, subscriptions |
-| 3.3 | Plan Upgrade Flow | ✅ Complete | Stripe/PayPal/Manual payment selection |
-| 3.3 | Credit Purchase Flow | ✅ Complete | One-time credit package checkout |
-| 4 | Resend Email Service | ✅ Complete | Transactional emails with templates |
-| 4 | Brevo Marketing | ⏸️ Deferred | Future implementation |
-
----
-
-## Executive Summary
-
-This document provides complete implementation details for:
-- **Phase 3.2:** Stripe & PayPal payment integration
-- **Phase 3.3:** Plans & packages (upgrade flows, service packages)
-- **Phase 4:** Email services (Resend for transactional, Brevo for marketing)
-
-All integrations use the existing `IntegrationProvider` model in `/backend/igny8_core/modules/system/models.py` for centralized API key management.
-
----
-
-## Table of Contents
-
-1. [Existing Infrastructure](#1-existing-infrastructure)
-2. [Phase 3.2: Payment Integration](#2-phase-32-payment-integration)
-3. [Phase 3.3: Plans & Packages](#3-phase-33-plans--packages)
-4. [Phase 4: Email Services](#4-phase-4-email-services)
-5. [Required Credentials Checklist](#5-required-credentials-checklist)
-6. [Implementation Order](#6-implementation-order)
-
----
-
-## 1. Existing Infrastructure
-
-### 1.1 IntegrationProvider Model
-
-**Location:** `backend/igny8_core/modules/system/models.py`
-
-The system already has a centralized model for all third-party credentials:
-
-```python
-class IntegrationProvider(models.Model):
-    provider_id = CharField(primary_key=True)  # 'stripe', 'paypal', 'resend'
-    display_name = CharField(max_length=100)
-    provider_type = CharField(choices=['ai', 'payment', 'email', 'storage'])
-    api_key = CharField(max_length=500)        # Primary API key
-    api_secret = CharField(max_length=500)     # Secondary secret
-    webhook_secret = CharField(max_length=500) # Webhook signing secret
-    api_endpoint = URLField()                  # Custom endpoint (PayPal sandbox/live)
-    config = JSONField()                       # Provider-specific config
-    is_active = BooleanField()
-    is_sandbox = BooleanField()
-```
-
-**Pre-seeded Providers (from migration 0016):**
-
-| Provider ID | Type | Purpose | Status |
-|------------|------|---------|--------|
-| `stripe` | payment | Card payments, subscriptions | Active (sandbox) |
-| `paypal` | payment | PayPal payments | Active (sandbox) |
-| `resend` | email | Transactional emails | Active |
-
-### 1.2 Existing Billing Models
-
-**Location:** `backend/igny8_core/business/billing/models.py`
-
-| Model | Purpose |
-|-------|---------|
-| `Payment` | Payment records with Stripe/PayPal/Manual support |
-| `Invoice` | Invoice records with line items |
-| `CreditPackage` | One-time credit purchase packages |
-| `CreditTransaction` | Credit ledger |
-| `Subscription` (in auth) | Account subscription tracking |
-| `Plan` (in auth) | Plan definitions with Stripe IDs |
-
-### 1.3 Existing Services
-
-| Service | Location | Status |
-|---------|----------|--------|
-| `PaymentService` | `business/billing/services/payment_service.py` | ✅ Complete |
-| `InvoiceService` | `business/billing/services/invoice_service.py` | ✅ Complete |
-| `StripeService` | `business/billing/services/stripe_service.py` | ✅ **NEW - Complete** |
-| `PayPalService` | `business/billing/services/paypal_service.py` | ✅ **NEW - Complete** |
-| `EmailService` | `business/billing/services/email_service.py` | ✅ **Updated - Resend Integration** |
-
----
-
-## 2. Phase 3.2: Payment Integration
-
-### 2.1 Stripe Integration
-
-#### 2.1.1 Required Credentials from Stripe Dashboard
-
-**From [dashboard.stripe.com](https://dashboard.stripe.com):**
-
-| Credential | Where to Find | Store In |
-|------------|---------------|----------|
-| **Publishable Key** | Developers → API Keys → Publishable key | `IntegrationProvider.api_key` |
-| **Secret Key** | Developers → API Keys → Secret key | `IntegrationProvider.api_secret` |
-| **Webhook Signing Secret** | Developers → Webhooks → Endpoint → Signing secret | `IntegrationProvider.webhook_secret` |
-
-**Webhook Endpoint to Configure:**
-```
-Production: https://api.igny8.com/api/v1/billing/webhooks/stripe/
-Sandbox: https://api-staging.igny8.com/api/v1/billing/webhooks/stripe/
-```
-
-**Events to Subscribe:**
-- `checkout.session.completed` - New subscription
-- `invoice.paid` - Recurring payment success
-- `invoice.payment_failed` - Payment failure
-- `customer.subscription.updated` - Plan changes
-- `customer.subscription.deleted` - Cancellation
-
-#### 2.1.2 IntegrationProvider Configuration
-
-```json
-{
-  "provider_id": "stripe",
-  "display_name": "Stripe",
-  "provider_type": "payment",
-  "api_key": "pk_live_xxx...",        // Publishable key
-  "api_secret": "sk_live_xxx...",     // Secret key
-  "webhook_secret": "whsec_xxx...",   // Webhook secret
-  "config": {
-    "currency": "usd",
-    "payment_methods": ["card"],
-    "billing_portal_enabled": true
-  },
-  "is_active": true,
-  "is_sandbox": false  // Set to true for test mode
-}
-```
-
-#### 2.1.3 Backend Implementation
-
-**New Files to Create:**
-
-```
-backend/igny8_core/business/billing/
-├── services/
-│   └── stripe_service.py          # Stripe API wrapper
-├── views/
-│   └── stripe_views.py            # Checkout, portal, webhooks
-└── tasks/
-    └── stripe_sync.py             # Sync jobs (optional)
-```
-
-**stripe_service.py:**
-
-```python
-"""
-Stripe Service - Wrapper for Stripe API operations
-"""
-import stripe
-from django.conf import settings
-from igny8_core.modules.system.models import IntegrationProvider
-
-
-class StripeService:
-    """Service for Stripe payment operations"""
-    
-    def __init__(self):
-        provider = IntegrationProvider.get_provider('stripe')
-        if not provider:
-            raise ValueError("Stripe provider not configured")
-        
-        self.is_sandbox = provider.is_sandbox
-        stripe.api_key = provider.api_secret
-        self.publishable_key = provider.api_key
-        self.webhook_secret = provider.webhook_secret
-        self.config = provider.config or {}
-    
-    def create_checkout_session(self, account, plan, success_url, cancel_url):
-        """
-        Create Stripe Checkout session for new subscription
-        """
-        session = stripe.checkout.Session.create(
-            customer_email=account.billing_email or account.owner.email,
-            payment_method_types=['card'],
-            mode='subscription',
-            line_items=[{
-                'price': plan.stripe_price_id,
-                'quantity': 1,
-            }],
-            success_url=success_url,
-            cancel_url=cancel_url,
-            metadata={
-                'account_id': str(account.id),
-                'plan_id': str(plan.id),
-            },
-            subscription_data={
-                'metadata': {
-                    'account_id': str(account.id),
-                }
-            }
-        )
-        return session
-    
-    def create_credit_checkout_session(self, account, credit_package, success_url, cancel_url):
-        """
-        Create Stripe Checkout for one-time credit purchase
-        """
-        session = stripe.checkout.Session.create(
-            customer_email=account.billing_email or account.owner.email,
-            payment_method_types=['card'],
-            mode='payment',
-            line_items=[{
-                'price_data': {
-                    'currency': self.config.get('currency', 'usd'),
-                    'product_data': {
-                        'name': credit_package.name,
-                        'description': f'{credit_package.credits} credits',
-                    },
-                    'unit_amount': int(credit_package.price * 100),  # Cents
-                },
-                'quantity': 1,
-            }],
-            success_url=success_url,
-            cancel_url=cancel_url,
-            metadata={
-                'account_id': str(account.id),
-                'credit_package_id': str(credit_package.id),
-                'credit_amount': credit_package.credits,
-            }
-        )
-        return session
-    
-    def create_billing_portal_session(self, account, return_url):
-        """
-        Create Stripe Billing Portal session for subscription management
-        """
-        # Get or create Stripe customer
-        customer_id = self._get_or_create_customer(account)
-        
-        session = stripe.billing_portal.Session.create(
-            customer=customer_id,
-            return_url=return_url,
-        )
-        return session
-    
-    def construct_webhook_event(self, payload, sig_header):
-        """
-        Verify and construct webhook event
-        """
-        return stripe.Webhook.construct_event(
-            payload, sig_header, self.webhook_secret
-        )
-    
-    def _get_or_create_customer(self, account):
-        """Get existing Stripe customer or create new one"""
-        if account.stripe_customer_id:
-            return account.stripe_customer_id
-        
-        customer = stripe.Customer.create(
-            email=account.billing_email or account.owner.email,
-            name=account.name,
-            metadata={'account_id': str(account.id)},
-        )
-        
-        account.stripe_customer_id = customer.id
-        account.save(update_fields=['stripe_customer_id'])
-        
-        return customer.id
-```
-
-**stripe_views.py:**
-
-```python
-"""
-Stripe Views - Checkout, Portal, and Webhook endpoints
-"""
-from rest_framework.views import APIView
-from rest_framework.decorators import api_view, permission_classes
-from rest_framework.permissions import AllowAny, IsAuthenticated
-from rest_framework.response import Response
-from rest_framework import status
-from django.views.decorators.csrf import csrf_exempt
-import json
-import logging
-
-from .stripe_service import StripeService
-from ..services.payment_service import PaymentService
-from igny8_core.auth.models import Plan, Account
-
-logger = logging.getLogger(__name__)
-
-
-class StripeCheckoutView(APIView):
-    """Create Stripe Checkout session"""
-    permission_classes = [IsAuthenticated]
-    
-    def post(self, request):
-        account = request.user.account
-        plan_id = request.data.get('plan_id')
-        
-        try:
-            plan = Plan.objects.get(id=plan_id, is_active=True)
-        except Plan.DoesNotExist:
-            return Response({'error': 'Plan not found'}, status=404)
-        
-        if not plan.stripe_price_id:
-            return Response({'error': 'Plan not configured for Stripe'}, status=400)
-        
-        service = StripeService()
-        frontend_url = settings.FRONTEND_URL
-        
-        session = service.create_checkout_session(
-            account=account,
-            plan=plan,
-            success_url=f'{frontend_url}/account/plans?success=true',
-            cancel_url=f'{frontend_url}/account/plans?canceled=true',
-        )
-        
-        return Response({
-            'checkout_url': session.url,
-            'session_id': session.id,
-        })
-
-
-class StripeCreditCheckoutView(APIView):
-    """Create Stripe Checkout for credit package"""
-    permission_classes = [IsAuthenticated]
-    
-    def post(self, request):
-        from ..models import CreditPackage
-        
-        account = request.user.account
-        package_id = request.data.get('package_id')
-        
-        try:
-            package = CreditPackage.objects.get(id=package_id, is_active=True)
-        except CreditPackage.DoesNotExist:
-            return Response({'error': 'Credit package not found'}, status=404)
-        
-        service = StripeService()
-        frontend_url = settings.FRONTEND_URL
-        
-        session = service.create_credit_checkout_session(
-            account=account,
-            credit_package=package,
-            success_url=f'{frontend_url}/account/usage?purchase=success',
-            cancel_url=f'{frontend_url}/account/usage?purchase=canceled',
-        )
-        
-        return Response({
-            'checkout_url': session.url,
-            'session_id': session.id,
-        })
-
-
-class StripeBillingPortalView(APIView):
-    """Create Stripe Billing Portal session"""
-    permission_classes = [IsAuthenticated]
-    
-    def post(self, request):
-        account = request.user.account
-        
-        service = StripeService()
-        frontend_url = settings.FRONTEND_URL
-        
-        session = service.create_billing_portal_session(
-            account=account,
-            return_url=f'{frontend_url}/account/plans',
-        )
-        
-        return Response({
-            'portal_url': session.url,
-        })
-
-
-@csrf_exempt
-@api_view(['POST'])
-@permission_classes([AllowAny])
-def stripe_webhook(request):
-    """
-    Handle Stripe webhook events
-    
-    Events handled:
-    - checkout.session.completed: New subscription or credit purchase
-    - invoice.paid: Recurring payment success
-    - invoice.payment_failed: Payment failure
-    - customer.subscription.updated: Plan changes
-    - customer.subscription.deleted: Cancellation
-    """
-    payload = request.body
-    sig_header = request.META.get('HTTP_STRIPE_SIGNATURE')
-    
-    try:
-        service = StripeService()
-        event = service.construct_webhook_event(payload, sig_header)
-    except Exception as e:
-        logger.error(f'Stripe webhook error: {str(e)}')
-        return Response({'error': str(e)}, status=400)
-    
-    event_type = event['type']
-    data = event['data']['object']
-    
-    logger.info(f'Stripe webhook received: {event_type}')
-    
-    if event_type == 'checkout.session.completed':
-        _handle_checkout_completed(data)
-    elif event_type == 'invoice.paid':
-        _handle_invoice_paid(data)
-    elif event_type == 'invoice.payment_failed':
-        _handle_payment_failed(data)
-    elif event_type == 'customer.subscription.updated':
-        _handle_subscription_updated(data)
-    elif event_type == 'customer.subscription.deleted':
-        _handle_subscription_deleted(data)
-    
-    return Response({'status': 'success'})
-
-
-def _handle_checkout_completed(session):
-    """Handle successful checkout"""
-    metadata = session.get('metadata', {})
-    account_id = metadata.get('account_id')
-    
-    if not account_id:
-        logger.error('No account_id in checkout session metadata')
-        return
-    
-    try:
-        account = Account.objects.get(id=account_id)
-    except Account.DoesNotExist:
-        logger.error(f'Account {account_id} not found')
-        return
-    
-    if session.get('mode') == 'subscription':
-        # Handle new subscription
-        subscription_id = session.get('subscription')
-        _activate_subscription(account, subscription_id, metadata)
-    elif session.get('mode') == 'payment':
-        # Handle credit purchase
-        credit_package_id = metadata.get('credit_package_id')
-        credit_amount = metadata.get('credit_amount')
-        _add_purchased_credits(account, credit_package_id, credit_amount)
-
-
-def _activate_subscription(account, stripe_subscription_id, metadata):
-    """Activate subscription after successful payment"""
-    import stripe
-    from django.utils import timezone
-    from igny8_core.auth.models import Subscription, Plan
-    
-    # Get subscription details from Stripe
-    stripe_sub = stripe.Subscription.retrieve(stripe_subscription_id)
-    
-    plan_id = metadata.get('plan_id')
-    plan = Plan.objects.get(id=plan_id)
-    
-    # Update or create subscription
-    subscription, created = Subscription.objects.update_or_create(
-        account=account,
-        defaults={
-            'plan': plan,
-            'stripe_subscription_id': stripe_subscription_id,
-            'status': 'active',
-            'current_period_start': timezone.datetime.fromtimestamp(
-                stripe_sub.current_period_start, tz=timezone.utc
-            ),
-            'current_period_end': timezone.datetime.fromtimestamp(
-                stripe_sub.current_period_end, tz=timezone.utc
-            ),
-        }
-    )
-    
-    # Add initial credits
-    from ..services.credit_service import CreditService
-    CreditService.add_credits(
-        account=account,
-        amount=plan.included_credits,
-        transaction_type='subscription',
-        description=f'Subscription: {plan.name}'
-    )
-    
-    logger.info(f'Subscription activated for account {account.id}')
-
-
-def _add_purchased_credits(account, credit_package_id, credit_amount):
-    """Add purchased credits to account"""
-    from ..services.credit_service import CreditService
-    
-    credit_amount = int(credit_amount)
-    
-    CreditService.add_credits(
-        account=account,
-        amount=credit_amount,
-        transaction_type='purchase',
-        description=f'Credit package purchase ({credit_amount} credits)'
-    )
-    
-    logger.info(f'Added {credit_amount} credits to account {account.id}')
-
-
-def _handle_invoice_paid(invoice):
-    """Handle successful recurring payment"""
-    subscription_id = invoice.get('subscription')
-    if not subscription_id:
-        return
-    
-    from igny8_core.auth.models import Subscription
-    
-    try:
-        subscription = Subscription.objects.get(stripe_subscription_id=subscription_id)
-    except Subscription.DoesNotExist:
-        return
-    
-    # Add monthly credits
-    from ..services.credit_service import CreditService
-    CreditService.add_credits(
-        account=subscription.account,
-        amount=subscription.plan.included_credits,
-        transaction_type='subscription',
-        description=f'Monthly renewal: {subscription.plan.name}'
-    )
-
-
-def _handle_payment_failed(invoice):
-    """Handle failed payment"""
-    subscription_id = invoice.get('subscription')
-    if not subscription_id:
-        return
-    
-    from igny8_core.auth.models import Subscription
-    
-    try:
-        subscription = Subscription.objects.get(stripe_subscription_id=subscription_id)
-        subscription.status = 'past_due'
-        subscription.save()
-    except Subscription.DoesNotExist:
-        pass
-    
-    # TODO: Send notification email
-
-
-def _handle_subscription_updated(subscription_data):
-    """Handle subscription update (plan change)"""
-    subscription_id = subscription_data.get('id')
-    
-    from igny8_core.auth.models import Subscription
-    
-    try:
-        subscription = Subscription.objects.get(stripe_subscription_id=subscription_id)
-        # Update status
-        status_map = {
-            'active': 'active',
-            'past_due': 'past_due',
-            'canceled': 'canceled',
-            'trialing': 'trialing',
-        }
-        stripe_status = subscription_data.get('status')
-        subscription.status = status_map.get(stripe_status, 'active')
-        subscription.save()
-    except Subscription.DoesNotExist:
-        pass
-
-
-def _handle_subscription_deleted(subscription_data):
-    """Handle subscription cancellation"""
-    subscription_id = subscription_data.get('id')
-    
-    from igny8_core.auth.models import Subscription
-    
-    try:
-        subscription = Subscription.objects.get(stripe_subscription_id=subscription_id)
-        subscription.status = 'canceled'
-        subscription.save()
-    except Subscription.DoesNotExist:
-        pass
-```
-
-#### 2.1.4 Frontend Implementation
-
-**New API calls in `frontend/src/services/billing.api.ts`:**
-
-```typescript
-export const createStripeCheckout = async (planId: string): Promise<{ checkout_url: string }> => {
-  const response = await api.post('/billing/stripe/checkout/', { plan_id: planId });
-  return response.data;
-};
-
-export const createStripeCreditCheckout = async (packageId: string): Promise<{ checkout_url: string }> => {
-  const response = await api.post('/billing/stripe/credit-checkout/', { package_id: packageId });
-  return response.data;
-};
-
-export const openStripeBillingPortal = async (): Promise<{ portal_url: string }> => {
-  const response = await api.post('/billing/stripe/billing-portal/');
-  return response.data;
-};
-```
-
-**Button handlers:**
-
-```typescript
-// Subscribe to plan
-const handleSubscribe = async (planId: string) => {
-  const { checkout_url } = await createStripeCheckout(planId);
-  window.location.href = checkout_url;
-};
-
-// Buy credits
-const handleBuyCredits = async (packageId: string) => {
-  const { checkout_url } = await createStripeCreditCheckout(packageId);
-  window.location.href = checkout_url;
-};
-
-// Manage subscription
-const handleManageSubscription = async () => {
-  const { portal_url } = await openStripeBillingPortal();
-  window.location.href = portal_url;
-};
-```
-
----
-
-### 2.2 PayPal Integration
-
-#### 2.2.1 Required Credentials from PayPal Developer Dashboard
-
-**From [developer.paypal.com](https://developer.paypal.com):**
-
-| Credential | Where to Find | Store In |
-|------------|---------------|----------|
-| **Client ID** | My Apps & Credentials → App → Client ID | `IntegrationProvider.api_key` |
-| **Client Secret** | My Apps & Credentials → App → Secret | `IntegrationProvider.api_secret` |
-| **Webhook ID** | My Apps & Credentials → Webhooks → Webhook ID | `config.webhook_id` |
-
-**Endpoints:**
-- Sandbox: `https://api-m.sandbox.paypal.com`
-- Production: `https://api-m.paypal.com`
-
-**Webhook Events to Subscribe:**
-- `CHECKOUT.ORDER.APPROVED`
-- `PAYMENT.CAPTURE.COMPLETED`
-- `BILLING.SUBSCRIPTION.ACTIVATED`
-- `BILLING.SUBSCRIPTION.CANCELLED`
-- `PAYMENT.CAPTURE.DENIED`
-
-#### 2.2.2 IntegrationProvider Configuration
-
-```json
-{
-  "provider_id": "paypal",
-  "display_name": "PayPal",
-  "provider_type": "payment",
-  "api_key": "AY...",              // Client ID
-  "api_secret": "EL...",           // Client Secret
-  "webhook_secret": "",            // Not used for PayPal (uses webhook ID)
-  "api_endpoint": "https://api-m.paypal.com",  // or sandbox
-  "config": {
-    "currency": "USD",
-    "webhook_id": "WH-xxx...",
-    "return_url": "https://app.igny8.com/account/plans?paypal=success",
-    "cancel_url": "https://app.igny8.com/account/plans?paypal=cancel"
-  },
-  "is_active": true,
-  "is_sandbox": false
-}
-```
-
-#### 2.2.3 Backend Implementation
-
-**paypal_service.py:**
-
-```python
-"""
-PayPal Service - REST API v2 integration
-"""
-import requests
-import base64
-from django.conf import settings
-from igny8_core.modules.system.models import IntegrationProvider
-
-
-class PayPalService:
-    """Service for PayPal payment operations"""
-    
-    def __init__(self):
-        provider = IntegrationProvider.get_provider('paypal')
-        if not provider:
-            raise ValueError("PayPal provider not configured")
-        
-        self.client_id = provider.api_key
-        self.client_secret = provider.api_secret
-        self.base_url = provider.api_endpoint or 'https://api-m.paypal.com'
-        self.config = provider.config or {}
-        self.is_sandbox = provider.is_sandbox
-        
-        self._access_token = None
-    
-    def _get_access_token(self):
-        """Get OAuth access token"""
-        if self._access_token:
-            return self._access_token
-        
-        auth = base64.b64encode(
-            f'{self.client_id}:{self.client_secret}'.encode()
-        ).decode()
-        
-        response = requests.post(
-            f'{self.base_url}/v1/oauth2/token',
-            headers={
-                'Authorization': f'Basic {auth}',
-                'Content-Type': 'application/x-www-form-urlencoded',
-            },
-            data='grant_type=client_credentials'
-        )
-        response.raise_for_status()
-        
-        self._access_token = response.json()['access_token']
-        return self._access_token
-    
-    def _make_request(self, method, endpoint, **kwargs):
-        """Make authenticated API request"""
-        token = self._get_access_token()
-        headers = kwargs.pop('headers', {})
-        headers['Authorization'] = f'Bearer {token}'
-        headers['Content-Type'] = 'application/json'
-        
-        url = f'{self.base_url}{endpoint}'
-        response = requests.request(method, url, headers=headers, **kwargs)
-        response.raise_for_status()
-        return response.json()
-    
-    def create_order(self, account, amount, currency='USD', description=''):
-        """
-        Create PayPal order for one-time payment
-        """
-        order = self._make_request('POST', '/v2/checkout/orders', json={
-            'intent': 'CAPTURE',
-            'purchase_units': [{
-                'amount': {
-                    'currency_code': currency,
-                    'value': str(amount),
-                },
-                'description': description,
-                'custom_id': str(account.id),
-            }],
-            'application_context': {
-                'return_url': self.config.get('return_url'),
-                'cancel_url': self.config.get('cancel_url'),
-                'brand_name': 'IGNY8',
-                'landing_page': 'BILLING',
-                'user_action': 'PAY_NOW',
-            }
-        })
-        
-        return order
-    
-    def capture_order(self, order_id):
-        """
-        Capture payment for approved order
-        """
-        return self._make_request('POST', f'/v2/checkout/orders/{order_id}/capture')
-    
-    def get_order(self, order_id):
-        """
-        Get order details
-        """
-        return self._make_request('GET', f'/v2/checkout/orders/{order_id}')
-    
-    def create_subscription(self, account, plan_id):
-        """
-        Create PayPal subscription
-        Requires plan to be created in PayPal dashboard first
-        """
-        subscription = self._make_request('POST', '/v1/billing/subscriptions', json={
-            'plan_id': plan_id,  # PayPal plan ID
-            'custom_id': str(account.id),
-            'application_context': {
-                'return_url': self.config.get('return_url'),
-                'cancel_url': self.config.get('cancel_url'),
-                'brand_name': 'IGNY8',
-                'user_action': 'SUBSCRIBE_NOW',
-            }
-        })
-        
-        return subscription
-    
-    def verify_webhook_signature(self, headers, body):
-        """
-        Verify webhook signature
-        """
-        verification = self._make_request('POST', '/v1/notifications/verify-webhook-signature', json={
-            'auth_algo': headers.get('PAYPAL-AUTH-ALGO'),
-            'cert_url': headers.get('PAYPAL-CERT-URL'),
-            'transmission_id': headers.get('PAYPAL-TRANSMISSION-ID'),
-            'transmission_sig': headers.get('PAYPAL-TRANSMISSION-SIG'),
-            'transmission_time': headers.get('PAYPAL-TRANSMISSION-TIME'),
-            'webhook_id': self.config.get('webhook_id'),
-            'webhook_event': body,
-        })
-        
-        return verification.get('verification_status') == 'SUCCESS'
-```
-
----
-
-## 3. Phase 3.3: Plans & Packages
-
-### 3.1 Plan Upgrade Flow
-
-**User Journey:**
-1. User on Plans page sees current plan and upgrade options
-2. Clicks "Upgrade" on desired plan
-3. Redirected to Stripe Checkout (or PayPal)
-4. Completes payment
-5. Webhook triggers:
-   - Updates Subscription to new plan
-   - Prorates credits (optional)
-6. User redirected back with success message
-
-**Stripe Proration:**
-Stripe handles proration automatically when upgrading. The `subscription_data` can include:
-
-```python
-subscription_data={
-    'proration_behavior': 'create_prorations',  # or 'always_invoice'
-}
-```
-
-### 3.2 Credit Package Purchase Flow
-
-**Current Packages (from CreditPackage model):**
-
-| Package | Credits | Price | Value |
-|---------|---------|-------|-------|
-| Starter | 500 | $9.99 | ~$0.02/credit |
-| Value | 2,000 | $29.99 | ~$0.015/credit |
-| Pro | 5,000 | $59.99 | ~$0.012/credit |
-| Enterprise | 15,000 | $149.99 | ~$0.01/credit |
-
-**Purchase Flow:**
-1. User on Usage page clicks "Buy Credits"
-2. Selects package
-3. Redirected to Stripe/PayPal Checkout
-4. Completes payment
-5. Webhook adds credits to account
-6. User redirected back to Usage page
-
-### 3.3 Service Packages (Future)
-
-| Package | Type | Price | Includes |
-|---------|------|-------|----------|
-| Setup App | One-time | $299 | Initial config, 1hr onboarding |
-| Campaign Mgmt | Monthly | $199/mo | 10 keywords/mo, content review |
-
-**Implementation:** Create `ServicePackage` model similar to `CreditPackage`.
-
----
-
-## 4. Phase 4: Email Services
-
-### 4.1 Resend (Transactional)
-
-#### 4.1.1 Required Credentials
-
-**From [resend.com/api-keys](https://resend.com/api-keys):**
-
-| Credential | Where to Find | Store In |
-|------------|---------------|----------|
-| **API Key** | API Keys → Create API Key | `IntegrationProvider.api_key` |
-
-**Domain Verification:**
-1. Add domain in Resend dashboard
-2. Add DNS records (DKIM, SPF, DMARC)
-3. Verify domain
-
-#### 4.1.2 IntegrationProvider Configuration
-
-```json
-{
-  "provider_id": "resend",
-  "display_name": "Resend",
-  "provider_type": "email",
-  "api_key": "re_xxx...",
-  "config": {
-    "from_email": "noreply@igny8.com",
-    "from_name": "IGNY8",
-    "reply_to": "support@igny8.com"
-  },
-  "is_active": true
-}
-```
-
-#### 4.1.3 Requirements.txt Addition
-
-```
-resend>=0.7.0
-```
-
-#### 4.1.4 Email Service Implementation
-
-**email_service.py (Updated):**
-
-```python
-"""
-Email Service - Multi-provider email sending
-Uses Resend for transactional, Brevo for marketing
-"""
-import resend
-import logging
-from typing import Optional, List, Dict
-from django.template.loader import render_to_string
-from igny8_core.modules.system.models import IntegrationProvider
-
-logger = logging.getLogger(__name__)
-
-
-class EmailService:
-    """Unified email service supporting multiple providers"""
-    
-    def __init__(self):
-        self._resend_configured = False
-        self._brevo_configured = False
-        self._setup_providers()
-    
-    def _setup_providers(self):
-        """Initialize email providers"""
-        # Setup Resend
-        resend_provider = IntegrationProvider.get_provider('resend')
-        if resend_provider and resend_provider.api_key:
-            resend.api_key = resend_provider.api_key
-            self._resend_config = resend_provider.config or {}
-            self._resend_configured = True
-        
-        # Setup Brevo (future)
-        brevo_provider = IntegrationProvider.get_provider('brevo')
-        if brevo_provider and brevo_provider.api_key:
-            self._brevo_config = brevo_provider.config or {}
-            self._brevo_configured = True
-    
-    def send_transactional(
-        self,
-        to: str,
-        subject: str,
-        html: Optional[str] = None,
-        text: Optional[str] = None,
-        template: Optional[str] = None,
-        context: Optional[Dict] = None,
-        from_email: Optional[str] = None,
-        reply_to: Optional[str] = None,
-        attachments: Optional[List] = None,
-    ):
-        """
-        Send transactional email via Resend
-        
-        Args:
-            to: Recipient email
-            subject: Email subject
-            html: HTML content (or use template)
-            text: Plain text content
-            template: Django template path (e.g., 'emails/welcome.html')
-            context: Template context
-            from_email: Override sender
-            reply_to: Reply-to address
-            attachments: List of attachments
-        """
-        if not self._resend_configured:
-            logger.error("Resend not configured - falling back to Django mail")
-            return self._send_django_mail(to, subject, text or html)
-        
-        # Render template if provided
-        if template:
-            html = render_to_string(template, context or {})
-        
-        try:
-            params = {
-                'from': from_email or f"{self._resend_config.get('from_name', 'IGNY8')} <{self._resend_config.get('from_email', 'noreply@igny8.com')}>",
-                'to': [to] if isinstance(to, str) else to,
-                'subject': subject,
-            }
-            
-            if html:
-                params['html'] = html
-            if text:
-                params['text'] = text
-            if reply_to:
-                params['reply_to'] = reply_to
-            
-            response = resend.Emails.send(params)
-            
-            logger.info(f"Email sent via Resend: {subject} to {to}")
-            return response
-            
-        except Exception as e:
-            logger.error(f"Failed to send email via Resend: {str(e)}")
-            raise
-    
-    def _send_django_mail(self, to, subject, message):
-        """Fallback to Django's send_mail"""
-        from django.core.mail import send_mail
-        from django.conf import settings
-        
-        send_mail(
-            subject=subject,
-            message=message,
-            from_email=settings.DEFAULT_FROM_EMAIL,
-            recipient_list=[to],
-            fail_silently=False,
-        )
-
-
-# Singleton instance
-_email_service = None
-
-def get_email_service():
-    global _email_service
-    if _email_service is None:
-        _email_service = EmailService()
-    return _email_service
-
-
-# Convenience functions
-def send_welcome_email(user, account):
-    """Send welcome email after signup"""
-    service = get_email_service()
-    service.send_transactional(
-        to=user.email,
-        subject='Welcome to IGNY8!',
-        template='emails/welcome.html',
-        context={
-            'user': user,
-            'account': account,
-            'login_url': f'{settings.FRONTEND_URL}/login',
-        }
-    )
-
-
-def send_password_reset_email(user, reset_token):
-    """Send password reset email"""
-    service = get_email_service()
-    service.send_transactional(
-        to=user.email,
-        subject='Reset Your IGNY8 Password',
-        template='emails/password_reset.html',
-        context={
-            'user': user,
-            'reset_url': f'{settings.FRONTEND_URL}/reset-password?token={reset_token}',
-        }
-    )
-
-
-def send_payment_confirmation(account, payment):
-    """Send payment confirmation email"""
-    service = get_email_service()
-    service.send_transactional(
-        to=account.billing_email or account.owner.email,
-        subject=f'Payment Confirmed - Invoice #{payment.invoice.invoice_number}',
-        template='emails/payment_confirmed.html',
-        context={
-            'account': account,
-            'payment': payment,
-        }
-    )
-
-
-def send_subscription_activated(account, subscription):
-    """Send subscription activation email"""
-    service = get_email_service()
-    service.send_transactional(
-        to=account.billing_email or account.owner.email,
-        subject=f'Subscription Activated - {subscription.plan.name}',
-        template='emails/subscription_activated.html',
-        context={
-            'account': account,
-            'subscription': subscription,
-            'plan': subscription.plan,
-        }
-    )
-
-
-def send_low_credits_warning(account, current_credits, threshold):
-    """Send low credits warning"""
-    service = get_email_service()
-    service.send_transactional(
-        to=account.billing_email or account.owner.email,
-        subject='Low Credits Warning - IGNY8',
-        template='emails/low_credits.html',
-        context={
-            'account': account,
-            'current_credits': current_credits,
-            'threshold': threshold,
-            'topup_url': f'{settings.FRONTEND_URL}/account/usage',
-        }
-    )
-```
-
-### 4.2 Brevo (Marketing) - Future
-
-**Configuration (when needed):**
-
-```json
-{
-  "provider_id": "brevo",
-  "display_name": "Brevo",
-  "provider_type": "email",
-  "api_key": "xkeysib-xxx...",
-  "config": {
-    "from_email": "hello@igny8.com",
-    "from_name": "IGNY8",
-    "list_id": 123
-  },
-  "is_active": false
-}
-```
-
-**Requirements:** `sib-api-v3-sdk>=7.6.0`
-
----
-
-## 5. Required Credentials Checklist
-
-> **Note:** All credentials are stored in the `IntegrationProvider` model and can be configured via Django Admin. The implementation supports both sandbox (testing) and production environments.
-
-### 5.1 Stripe Credentials
-
-| Item | Value | Status |
-|------|-------|--------|
-| Publishable Key (Live) | `pk_live_...` | ⬜ Add to IntegrationProvider |
-| Secret Key (Live) | `sk_live_...` | ⬜ Add to IntegrationProvider |
-| Webhook Signing Secret | `whsec_...` | ⬜ Add to IntegrationProvider |
-| Products/Prices Created | Plan IDs | ⬜ Create in Stripe Dashboard |
-| **Code Implementation** | — | ✅ **Complete** |
-
-**Stripe Products to Create:**
-1. **Starter Plan** - $99/mo - `price_starter_monthly`
-2. **Growth Plan** - $199/mo - `price_growth_monthly`
-3. **Scale Plan** - $299/mo - `price_scale_monthly`
-
-### 5.2 PayPal Credentials
-
-| Item | Value | Status |
-|------|-------|--------|
-| Client ID (Live) | `AY...` | ⬜ Add to IntegrationProvider |
-| Client Secret (Live) | `EL...` | ⬜ Add to IntegrationProvider |
-| Webhook ID | `WH-...` | ⬜ Add to IntegrationProvider config |
-| Subscription Plans Created | PayPal Plan IDs | ⬜ Create in PayPal Dashboard |
-| **Code Implementation** | — | ✅ **Complete** |
-
-### 5.3 Resend Credentials
-
-| Item | Value | Status |
-|------|-------|--------|
-| API Key | `re_...` | ⬜ Add to IntegrationProvider |
-| Domain Verified | igny8.com | ⬜ Configure in Resend Dashboard |
-| DNS Records Added | DKIM, SPF | ⬜ Add to DNS provider |
-| **Code Implementation** | — | ✅ **Complete** |
-
-### 5.4 Brevo Credentials (Future)
-
-| Item | Value | Status |
-|------|-------|--------|
-| API Key | `xkeysib-...` | ⬜ Future |
-| Contact List Created | List ID | ⬜ Future |
-
----
-
-## 6. Implementation Order
-
-### Phase 1: Backend Setup ✅ COMPLETE
-
-1. **✅ Add dependencies:**
-   ```bash
-   pip install resend>=0.7.0
-   # PayPal uses requests (already installed)
-   # Stripe already installed
-   ```
-
-2. **✅ Create service files:**
-   - ✅ `backend/igny8_core/business/billing/services/stripe_service.py`
-   - ✅ `backend/igny8_core/business/billing/services/paypal_service.py`
-   - ✅ Update `backend/igny8_core/business/billing/services/email_service.py`
-
-3. **✅ Create view files:**
-   - ✅ `backend/igny8_core/business/billing/views/stripe_views.py`
-   - ✅ `backend/igny8_core/business/billing/views/paypal_views.py`
-
-4. **✅ Add URL routes:**
-   ```python
-   # backend/igny8_core/business/billing/urls.py
-   urlpatterns += [
-       path('stripe/checkout/', StripeCheckoutView.as_view()),
-       path('stripe/credit-checkout/', StripeCreditCheckoutView.as_view()),
-       path('stripe/billing-portal/', StripeBillingPortalView.as_view()),
-       path('webhooks/stripe/', stripe_webhook),
-       path('paypal/create-order/', PayPalCreateOrderView.as_view()),
-       path('paypal/capture-order/', PayPalCaptureOrderView.as_view()),
-       path('webhooks/paypal/', paypal_webhook),
-   ]
-   ```
-
-5. **✅ Add email templates:**
-   ```
-   backend/igny8_core/templates/emails/
-   ├── base.html
-   ├── welcome.html
-   ├── password_reset.html
-   ├── email_verification.html
-   ├── payment_confirmation.html
-   ├── payment_approved.html
-   ├── payment_rejected.html
-   ├── payment_failed.html
-   ├── subscription_activated.html
-   ├── subscription_renewal.html
-   ├── low_credits.html
-   └── refund_notification.html
-   ```
-
-### Phase 2: Stripe Configuration ⏳ PENDING USER CREDENTIALS
-
-1. ⏳ Create products and prices in Stripe Dashboard (User action needed)
-2. ⏳ Configure webhook endpoint (User action needed)
-3. ⏳ Get API keys and add to IntegrationProvider via admin (User action needed)
-4. ⏳ Test in sandbox mode (After credentials added)
-
-### Phase 3: Frontend Integration ✅ COMPLETE
-
-1. ✅ Add billing API methods (stripe, paypal, purchaseCredits, subscribeToPlan)
-2. ✅ Update PlansAndBillingPage with payment buttons
-3. ✅ Add PaymentGatewaySelector component
-4. ✅ Add success/cancel handling
-
-### Phase 4: Email Configuration ⏳ PENDING USER CREDENTIALS
-
-1. ⏳ Add Resend API key to IntegrationProvider (User action needed)
-2. ⏳ Verify domain at resend.com (User action needed)
-3. ⏳ Test all email triggers (After credentials added)
-
-### Phase 5: Testing ⏳ PENDING USER CREDENTIALS
-
-1. ⏳ Test Stripe checkout flow (sandbox) - After credentials added
-2. ⏳ Test PayPal flow (sandbox) - After credentials added
-3. ⏳ Test webhook handling - After webhooks configured
-4. ⏳ Test email delivery - After Resend configured
-5. ⏳ Switch to production credentials - After testing complete
-
----
-
-## Summary
-
-**Implementation Status:** ✅ **CODE COMPLETE** - Ready for credentials and testing
-
-**Time Spent:** 2-3 days (Backend + Frontend implementation)
-
-**Pending Actions (User):**
-- ⏳ Stripe account: Create products/prices, configure webhooks, add API keys
-- ⏳ PayPal developer account: Create app, configure webhooks, add credentials
-- ⏳ Resend account: Verify domain, add API key
-
-**Files Created:** ✅
-- ✅ `stripe_service.py` (500+ lines)
-- ✅ `stripe_views.py` (560+ lines)
-- ✅ `paypal_service.py` (500+ lines)
-- ✅ `paypal_views.py` (600+ lines)
-- ✅ Updated `email_service.py` (760+ lines)
-- ✅ 12 email templates
-- ✅ `PaymentGatewaySelector.tsx` (160+ lines)
-- ✅ Updated `PlansAndBillingPage.tsx`
-- ✅ Updated `billing.api.ts` (+285 lines)
-
-**Existing Infrastructure Used:**
-- ✅ `IntegrationProvider` model for all credentials
-- ✅ `Payment`, `Invoice`, `CreditPackage` models
-- ✅ `PaymentService` for payment processing
-- ✅ `CreditService` for credit management
-
-**Next Steps:**
-1. Add Stripe credentials to Django Admin → Integration Providers
-2. Add PayPal credentials to Django Admin → Integration Providers
-3. Add Resend API key to Django Admin → Integration Providers
-4. Test payment flows in sandbox mode
-5. Switch to production credentials when ready
diff --git a/docs/plans/implemented/TODOS.md b/docs/plans/implemented/TODOS.md
deleted file mode 100644
index 0138355e..00000000
--- a/docs/plans/implemented/TODOS.md
+++ /dev/null
@@ -1,46 +0,0 @@
-# IGNY8 Cleanup TODOs
-
-**Last Updated:** December 27, 2025
-
----
-
-## 🗑️ Code Marked for Removal
-
-### SiteBuilder (Deprecated)
-
-SiteBuilder module is completely removed from the app. Any code found related to it should be cleaned up.
-
-| File/Location | Type | Status | Notes |
-|---------------|------|--------|-------|
-| *Add entries here when found* | | | |
-
-**How to identify SiteBuilder code:**
-- References to `sitebuilder`, `site_builder`, `SiteBuilder`
-- Components/pages with "SiteBuilder" in name
-- API endpoints containing `sitebuilder`
-- Models or services for building sites using IGNY8
-
----
-
-## ⏸️ Inactive Modules (Phase 2)
-
-These modules exist but are NOT active. Do not modify unless specifically requested.
-
-| Module | Status | Planned Activation |
-|--------|--------|-------------------|
-| Linker | ⏸️ Disabled | Phase 2 |
-| Optimizer | ⏸️ Disabled | Phase 2 |
-
----
-
-## 📝 Found Items Log
-
-*When you find deprecated code during development, add it here:*
-
-```markdown
-### [Date] - [Found By]
-- **File:** path/to/file
-- **Type:** SiteBuilder / Other
-- **Action Needed:** Remove / Refactor
-- **Notes:** Description
-```
diff --git a/docs/plans/implemented/UX-GUIDELINES.md b/docs/plans/implemented/UX-GUIDELINES.md
deleted file mode 100644
index 526a5f5c..00000000
--- a/docs/plans/implemented/UX-GUIDELINES.md
+++ /dev/null
@@ -1,156 +0,0 @@
-# IGNY8 UX Guidelines
-
-**Last Updated:** December 25, 2025
-
----
-
-## Design Principles
-
-### 1. Concise Labels
-
-**Navigation & Tabs:** Keep labels short (1-2 words max)
-- ✅ Good: `Queue`, `Drafts`, `Images`, `Review`, `Published`
-- ❌ Bad: `Ready to Write`, `Finished Drafts`, `Review Before Publishing`
-
-**Section Headers:** Use simple, consistent terminology
-- ✅ Good: `SETUP`, `WORKFLOW`, `ACCOUNT`, `SETTINGS`
-- ❌ Bad: `GET STARTED`, `CREATE CONTENT`, `MANAGE ACCOUNT`, `CONFIGURATION`
-
-### 2. Consistent Terminology
-
-Use the same term throughout the system:
-
-| Concept | Correct Term | Avoid |
-|---------|--------------|-------|
-| Content measurement | "Content pieces" | "Credits" |
-| Sidebar modules | Module name only | Verbose descriptions |
-| Page titles | Match tab name | Flowery language |
-
-### 3. Page Titles
-
-Page titles should be:
-- Short and descriptive
-- Match the sidebar navigation
-- Consistent with tab labels
-
-```
-Dashboard (not "Your Content Creation Dashboard")
-Keywords (not "Your Keywords")
-Drafts (not "Your Articles" or "Finished Drafts")
-```
-
-### 4. Descriptions & Helper Text
-
-- Keep descriptions **short** (under 10 words)
-- Put longer explanations in tooltips or Help pages
-- Dashboard cards: 3-5 word descriptions maximum
-
-```tsx
-// ✅ Good
-<ComponentCard title="Workflow Progress" desc="Track your content pipeline">
-
-// ❌ Bad
-<ComponentCard title="Your Content Journey" desc="Track your content creation progress from ideas to published articles">
-```
-
-### 5. Workflow Pipeline Labels
-
-For pipeline stages, use arrow notation:
-- ✅ `Keywords → Clusters`
-- ❌ `Organize Keywords`
-
----
-
-## Navigation Structure
-
-### Sidebar Sections
-
-```
-Dashboard (standalone)
-
-SETUP
-├── Add Keywords
-├── Sites
-└── Thinker
-
-WORKFLOW
-├── Planner
-├── Writer
-├── Automation
-├── Linker
-└── Optimizer
-
-ACCOUNT
-├── Account Settings
-├── Team
-├── Plans & Billing
-└── Usage
-
-SETTINGS
-├── Profile
-├── AI Models
-├── Publishing
-└── Import / Export
-
-HELP
-└── Help & Docs
-```
-
-### Module Tab Labels
-
-**Planner:** `Keywords` | `Clusters` | `Ideas`
-
-**Writer:** `Queue` | `Drafts` | `Images` | `Review` | `Published`
-
-**Thinker:** `Prompts` | `Author Profiles` | `Strategies` | `Image Testing`
-
----
-
-## When to Add Explanatory Text
-
-### DO add explanations for:
-- Help & Documentation pages
-- First-time user onboarding flows
-- Error messages and empty states
-- Tooltips on hover
-
-### DON'T add explanations to:
-- Navigation labels
-- Tab labels
-- Page headers
-- Card descriptions on dashboards
-
----
-
-## User-Facing Terminology
-
-### Content & Pricing
-
-| Internal (Backend) | User-Facing (Frontend) |
-|-------------------|------------------------|
-| `credits` | "content pieces" |
-| `credits_remaining` | "X remaining" |
-| `plan_credits_per_month` | "monthly allowance" |
-| Purchase Credits | Upgrade Plan |
-| Credit Balance | Content Usage |
-
-### Actions
-
-| Internal/Old | User-Facing |
-|--------------|-------------|
-| Generate | Create |
-| Execute | Run |
-| Configure | Set up |
-| Insufficient credits | Content limit reached |
-
----
-
-## Change History
-
-| Date | Change |
-|------|--------|
-| Dec 25, 2025 | Reverted verbose navigation labels to concise terms |
-| Dec 25, 2025 | Fixed Dashboard progress item descriptions |
-| Dec 25, 2025 | Fixed Writer module tabs (Queue, Drafts, etc.) |
-| Dec 25, 2025 | Fixed Planner module tabs (Keywords, Clusters, Ideas) |
-| Dec 25, 2025 | Restored original Automation pipeline stage names |
diff --git a/docs/plans/implemented/WP_PLUGIN_IGNY8_APP_CLEANUP.md b/docs/plans/implemented/WP_PLUGIN_IGNY8_APP_CLEANUP.md
deleted file mode 100644
index 882b4b05..00000000
--- a/docs/plans/implemented/WP_PLUGIN_IGNY8_APP_CLEANUP.md
+++ /dev/null
@@ -1,447 +0,0 @@
-
-
-# WordPress Integration Audit Report
-
-## Overview
-
-The WordPress plugin (IGNY8 WP Bridge v1.3.3) has been built with extensive features, many of which are either not fully implemented on the IGNY8 app side or are too complex for current needs.
-
----
-
-## 1. CONTROLS PAGE (Plugin)
-
-### What It Does:
-The "Controls" page in the WordPress plugin lets users configure which content types and features should sync between WordPress and IGNY8.
-
-### Current Components:
-
-#### A) **Post Types to Sync**
-- Shows: Posts, Pages, Products (if WooCommerce installed)
-- **Purpose**: Determines which WordPress post types IGNY8 can publish to
-- **What Actually Works**: Only "Posts" is fully functional. Pages and Products publishing is NOT implemented in IGNY8 app yet.
-
-#### B) **Taxonomies to Sync**
-- Shows: Categories, Tags, Product Categories, Product Tags, Product Shipping Classes, IGNY8 Sectors, IGNY8 Clusters, Brand, Brands, Expired
-- **Purpose**: Determines which taxonomy terms sync between systems
-- **What Actually Works**: Only Categories, Tags, IGNY8 Sectors, IGNY8 Clusters are used. The rest are either WooCommerce-specific (not supported) or custom taxonomies from the specific WordPress site.
-
-#### C) **Control Mode** (Mirror vs Hybrid)
-- **Mirror Mode**: IGNY8 is source of truth. WordPress reflects changes only. Content is read-only in WordPress.
-- **Hybrid Mode**: Two-way sync. WordPress editors can edit content and changes sync back to IGNY8.
-- **What Actually Works**: **NOTHING**. This is purely UI. The backend code doesn't check or enforce either mode. Content can always be edited in WordPress and it does NOT sync back to IGNY8. This is misleading UI.
-
-#### D) **IGNY8 Modules**
-- Shows: Sites (Data & Semantic Map), Planner (Keywords & Briefs), Writer (Tasks & Posts), Linker (Internal Links), Optimizer (Audits & Scores)
-- **Purpose**: Allow users to disable specific IGNY8 features if they're not using them
-- **What Actually Works**: **NOTHING**. This is purely UI. The plugin doesn't actually enable/disable any module functionality. These checkboxes have no effect on what gets synced or displayed.
-
-#### E) **Default Post Status**
-- Draft or Publish
-- **Purpose**: When IGNY8 publishes content, should it be saved as Draft (for review) or Published immediately
-- **What Actually Works**: **YES, this works**. The plugin checks this setting when receiving content from IGNY8.
-
-#### F) **Sync WooCommerce Products**
-- Checkbox (only shown if WooCommerce installed)
-- **What Actually Works**: **NOT IMPLEMENTED** in IGNY8 app. WooCommerce product sync is planned but not built.
-
----
-
-## 2. SYNC PAGE (Plugin)
-
-### What It Does:
-Shows sync status and history for different data types.
-
-### Current Components:
-
-#### A) **Sync Status Toggle**
-- "Enable IGNY8 Sync" checkbox
-- **Purpose**: Master switch to enable/disable all syncing
-- **What Actually Works**: **YES, this works**. When disabled, the plugin rejects incoming content from IGNY8.
-
-#### B) **Sync History**
-- Shows: Site Data, Taxonomies, Keywords, Writers
-- Shows last sync timestamp and status (Synced/Never)
-- **What Actually Works**: **MISLEADING**. 
-  - "Site Data" = metadata about WordPress site sent TO IGNY8 (one-way)
-  - "Taxonomies" = categories/tags metadata
-  - "Keywords" = NOT IMPLEMENTED (seed keywords feature)
-  - "Writers" = NOT IMPLEMENTED (author sync feature)
-
-#### C) **Scheduled Syncs**
-- Shows next scheduled site data sync
-- **What Actually Works**: WordPress cron job that periodically sends site metadata to IGNY8. Works but rarely used.
-
----
-
-## 3. DATA PAGE (Plugin)
-
-### What It Does:
-Shows internal link queue status.
-
-### Current Components:
-- Total Links, Pending, Processed counts
-- Link Queue table showing posts, target URLs, anchors, status
-
-### What Actually Works:
-This is for the **LINKER** module - internal linking automation. When IGNY8 sends a post with internal link suggestions, they go into this queue and get processed.
-
-**Current Status**: Linker module is partially implemented but not production-ready in IGNY8 app.
-
----
-
-## 4. CONTENT TYPES PAGE (IGNY8 App - Site Settings)
-
-### What It Does:
-Shows WordPress site structure fetched from the plugin:
-- Post Types (Pages, Posts, Products) with counts and "Enabled/Disabled" badges
-- Taxonomies (Categories, Tags, etc.) with counts and "Enabled/Disabled" badges
-- "Sync Structure" button to refresh data
-
-### What Actually Works:
-- **Sync Structure** = Calls WordPress plugin's `/igny8/v1/site-metadata/` endpoint to get counts
-- **Enabled/Disabled** = Reflects what's checked in WordPress plugin's Controls page
-- **Limit: 100** = Fetch limit per type (hardcoded, not configurable in app)
-
-### Purpose:
-This page is **informational only** - shows what's available on WordPress side. User cannot change anything here. They must change settings in WordPress plugin.
-
-### Problem:
-The "Enabled/Disabled" comes from WordPress but the IGNY8 app has NO way to enable/disable content types. It's display-only and confusing.
-
----
-
-## 5. What Actually Gets Synced
-
-### IGNY8 → WordPress (Working):
-1. **Published Content**: When content is approved in IGNY8 and published, it gets sent to WordPress
-2. **Categories**: IGNY8 categories sync as WordPress categories
-3. **Tags**: IGNY8 tags sync as WordPress tags
-4. **IGNY8 Sectors**: Custom taxonomy for content organization
-5. **IGNY8 Clusters**: Custom taxonomy for content clustering
-6. **Featured Images**: Images are uploaded to WordPress media library
-
-### WordPress → IGNY8 (Working):
-1. **Site Metadata**: Post counts, taxonomy counts (for display in app)
-2. **Post Status Updates**: Webhooks notify IGNY8 when WordPress post status changes
-
-### NOT Working / Not Implemented:
-1. Pages publishing
-2. Products publishing (WooCommerce)
-3. Product Categories/Tags sync
-4. Two-way content sync (Hybrid Mode)
-5. Keywords sync
-6. Writers sync
-7. Module-based enable/disable
-8. Internal linking automation (Linker)
-9. Audits & Scores (Optimizer)
-
----
-
----
-
-# IMPLEMENTATION PLAN
-
----
-
-## Phase 1: WordPress Plugin Updates
-
-### 1.1 Controls Page Redesign → Rename to "Settings"
-
-#### New Structure:
-
-**Section A: Post Types** (Top level toggles)
-```
-┌─────────────────────────────────────────────────────────────┐
-│  POST TYPES                                                  │
-├─────────────────────────────────────────────────────────────┤
-│  ☑ Posts                                                    │
-│  ☐ Pages                                    [Coming Soon]    │
-│  ☐ Products (WooCommerce)                   [Coming Soon]    │
-│  ☐ {Other detected CPTs}                    [Coming Soon]    │
-└─────────────────────────────────────────────────────────────┘
-```
-
-- Auto-detect ALL registered post types in WordPress
-- Show toggle for each post type
-- "Coming Soon" badge on ALL post types except Posts
-- Keep all toggles functional for now (testing) - will disable later
-- Only show taxonomy cards below for ENABLED post types
-
-**Section B: Post Type Cards** (Conditional - only shown if post type is enabled)
-
-For each enabled post type, show a separate card with its taxonomies:
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  📝 POSTS                                                    │
-├─────────────────────────────────────────────────────────────┤
-│  Taxonomies:                                                 │
-│  ☑ Categories                                               │
-│  ☑ Tags                                                     │
-│  ☑ IGNY8 Sectors                                            │
-│  ☑ IGNY8 Clusters                                           │
-└─────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────┐
-│  📦 PRODUCTS                                 [Coming Soon]   │
-├─────────────────────────────────────────────────────────────┤
-│  Taxonomies:                                                 │
-│  ☑ Product Categories                                       │
-│  ☑ Product Tags                                             │
-│  ☑ IGNY8 Sectors                                            │
-│  ☑ IGNY8 Clusters                                           │
-│  ☐ Product Shipping Classes                                 │
-│  ☐ Brands                                                   │
-│  ☐ {Other product attributes/taxonomies}                    │
-└─────────────────────────────────────────────────────────────┘
-```
-
-- Auto-detect ALL taxonomies registered for each post type
-- For Products: auto-detect all WooCommerce attributes and taxonomies
-- Default enabled: Categories, Tags, Product Categories, Product Tags, IGNY8 Sectors, IGNY8 Clusters
-- Default disabled: All other detected taxonomies
-- Remove "Expired" taxonomy (this was created by our plugin in error - delete it)
-
-**Section C: Other Settings**
-```
-┌─────────────────────────────────────────────────────────────┐
-│  DEFAULT SETTINGS                                            │
-├─────────────────────────────────────────────────────────────┤
-│  Default Post Status: [Draft ▼]                             │
-│  Enable IGNY8 Sync:   ☑ ON                                  │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### 1.2 Items to REMOVE from Plugin
-
-1. **Control Mode** (Mirror/Hybrid) - doesn't do anything, misleading
-2. **IGNY8 Modules checkboxes** - doesn't do anything, misleading
-3. **Sync History for Keywords** - not implemented
-4. **Sync History for Writers** - not implemented
-5. **Scheduled Syncs section** - rarely used, confusing
-6. **"Expired" taxonomy** - created in error by plugin, remove it
-
-### 1.3 UI Terminology Changes
-
-| Current | New |
-|---------|-----|
-| Controls | Settings |
-| Sync | Connection |
-| Sync History | Last Updated |
-| Data | Link Queue (if Linker enabled) or hide |
-
-### 1.4 Technical Implementation Notes
-
-```php
-// Auto-detect post types
-$post_types = get_post_types(array('public' => true), 'objects');
-
-// Auto-detect taxonomies for each post type
-foreach ($post_types as $post_type) {
-    $taxonomies = get_object_taxonomies($post_type->name, 'objects');
-}
-
-// For WooCommerce Products, also get attributes
-if (class_exists('WooCommerce')) {
-    $attributes = wc_get_attribute_taxonomies();
-}
-```
-
----
-
-## Phase 2: IGNY8 App Updates
-
-### 2.1 Site Content Page Updates (`/sites/{id}/content`)
-
-#### A) Post Type Filters (Top Bar)
-
-Add post type selector buttons above the content list:
-- Only show if there are more than 1 post type enabled in WordPress plugin
-- Show buttons like: `Posts` | `Products` | `Services` | etc.
-- Default to "Posts"
-- Filter content by selected post type
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  Posts  │  Products  │  Services                            │
-├─────────────────────────────────────────────────────────────┤
-│  [Filters...]                        [Content Types]        │
-├─────────────────────────────────────────────────────────────┤
-│  Content list...                                            │
-└─────────────────────────────────────────────────────────────┘
-```
-
-#### B) Content Types Button
-
-Add "Content Types" button on the far right of the same row as post type filters:
-- Opens a modal/drawer showing WordPress content structure
-- This replaces the "Content Types" tab in Site Settings
-
-### 2.2 New Content Structure Page (Full Page)
-
-**Route:** `/sites/{id}/content/structure`
-
-**Purpose:** Show site's content structure organized by Clusters - FULL PAGE, not modal
-
-**Layout:**
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  SITE > CONTENT > STRUCTURE                                 │
-├─────────────────────────────────────────────────────────────┤
-│  Cluster: [Select Cluster ▼]                                │
-├─────────────────────────────────────────────────────────────┤
-│  (When cluster selected, show:)                             │
-│                                                             │
-│  Keywords in this Cluster:                                  │
-│  ┌─────────────────────────────────────────────────────────┐
-│  │ Keyword Name                          │ Content Count   │
-│  ├─────────────────────────────────────────────────────────┤
-│  │ AI Content Writing                    │ 12              │
-│  │ Blog Automation Tools                 │ 8               │
-│  │ SEO Content Strategy                  │ 5               │
-│  └─────────────────────────────────────────────────────────┘
-│                                                             │
-│  Cluster Content:                                           │
-│  (REUSE existing component from /planner/clusters/{id})     │
-│  - View Live link                                           │
-│  - View in App link                                         │
-│  - Edit link                                                │
-│  - Published/Pending/Draft counts                           │
-│  - Content list with same styling                           │
-└─────────────────────────────────────────────────────────────┘
-```
-
-**Key Features:**
-- Full page with proper URL: `/sites/{id}/content/structure`
-- Cluster selector dropdown at top
-- Keywords list with content counts for selected cluster
-- **REUSE** existing content list component from cluster detail page (`/planner/clusters/{id}`)
-- Same functionality: View Live, View in App, Edit links
-- Shows content stats and articles list
-
-### 2.3 Remove from Site Settings Page
-
-1. **Remove "Content Types" tab** from Site Settings
-2. Only track content/terms that IGNY8 is publishing/using
-
-### 2.4 Content & Taxonomy Tracking (KEEP & IMPROVE)
-
-**IMPORTANT:** Do NOT break existing publishing and tracking systems.
-
-**What We Track (KEEP):**
-- Content published by IGNY8 against Clusters
-- Content published by IGNY8 against Keywords
-- IGNY8 Clusters taxonomy on WordPress (created/synced by plugin)
-- IGNY8 Sectors taxonomy on WordPress (created/synced by plugin)
-- Categories and Tags used by published content
-
-**Improvements:**
-- Validate IGNY8 Clusters taxonomy sync between app and WordPress
-- Validate IGNY8 Sectors taxonomy sync between app and WordPress
-- Ensure counts match on both local app and remote WordPress site
-- Content tracking against clusters/keywords is critical for:
-  - Future optimization
-  - Content rewriting
-  - Content extension
-  - Performance analytics
-
-### 2.5 Bulk Structure Syncing (SIMPLIFY, NOT REMOVE)
-
-**KEEP:**
-- Syncing of IGNY8 Clusters taxonomy
-- Syncing of IGNY8 Sectors taxonomy
-- Categories/Tags used by IGNY8 published content
-- Content counts against clusters/keywords
-
-**REMOVE:**
-- Full WordPress site structure dump (all post types, all taxonomies)
-- Counts of content not managed by IGNY8
-- Periodic full re-sync of entire site structure
-
-**Principle:** Only track what IGNY8 creates/publishes, not entire WordPress site.
-
----
-
-## Phase 3: Summary of Changes
-
-### WordPress Plugin Changes:
-| Item | Action |
-|------|--------|
-| Controls page | Rename to "Settings", redesign |
-| Post Types | Auto-detect all, show toggles, "Coming Soon" on all except Posts |
-| Taxonomies | Group under post type cards, auto-detect all |
-| Control Mode | REMOVE |
-| IGNY8 Modules | REMOVE |
-| Expired taxonomy | DELETE (was created in error) |
-| Sync History (Keywords, Writers) | REMOVE |
-| Scheduled Syncs | REMOVE |
-| Data page | Keep for Linker queue only |
-
-### IGNY8 App Changes:
-| Item | Action |
-|------|--------|
-| `/sites/{id}/content` | Add post type filter buttons |
-| Content Types button | Add to content page → links to `/sites/{id}/content/structure` |
-| Content Structure page | New full page at `/sites/{id}/content/structure` |
-| Site Settings > Content Types tab | REMOVE |
-| Bulk structure syncing | SIMPLIFY - only track IGNY8-managed content |
-| IGNY8 Clusters/Sectors sync | KEEP & VALIDATE - ensure app ↔ WordPress match |
-| Content tracking (clusters/keywords) | KEEP - critical for optimization/rewriting |
-
-### What Still Works (No Changes):
-1. Publishing Posts to WordPress ✅
-2. Categories sync ✅
-3. Tags sync ✅
-4. IGNY8 Sectors sync ✅
-5. IGNY8 Clusters sync ✅
-6. Featured images ✅
-7. In-article images ✅
-8. Post status webhooks ✅
-9. Content tracking against Clusters ✅
-10. Content tracking against Keywords ✅
-
----
-
-## Implementation Checklist
-
-### WordPress Plugin:
-- [ ] Rename "Controls" to "Settings"
-- [ ] Add post type auto-detection
-- [ ] Add post type toggles with "Coming Soon" badges
-- [ ] Create taxonomy cards for each enabled post type
-- [ ] Auto-detect all taxonomies per post type
-- [ ] Auto-detect WooCommerce attributes for Products
-- [ ] Set default enabled taxonomies (Categories, Tags, Product Categories, Product Tags, Sectors, Clusters)
-- [ ] Remove Control Mode section
-- [ ] Remove IGNY8 Modules section
-- [ ] Remove "Expired" taxonomy
-- [ ] Remove Keywords/Writers from Sync History
-- [ ] Remove Scheduled Syncs section
-- [ ] Simplify Sync page → Connection page
-
-### IGNY8 App:
-- [ ] Add post type filter buttons to `/sites/{id}/content`
-- [ ] Only show if >1 post type enabled
-- [ ] Add "Structure" button (far right) → links to `/sites/{id}/content/structure`
-- [ ] Create Content Structure page at `/sites/{id}/content/structure`
-- [ ] Add cluster selector dropdown
-- [ ] Show keywords with content counts
-- [ ] REUSE content list component from `/planner/clusters/{id}`
-- [ ] Remove Content Types tab from Site Settings
-- [ ] Simplify bulk structure syncing (keep IGNY8 clusters/sectors only)
-- [ ] Validate IGNY8 Clusters taxonomy sync (app ↔ WordPress)
-- [ ] Validate IGNY8 Sectors taxonomy sync (app ↔ WordPress)
-- [ ] Keep content tracking against clusters/keywords (DO NOT BREAK)
-
----
-
-## Notes
-
-- All post types except Posts show "Coming Soon" but remain configurable for testing
-- Later: disable non-Posts post types after production testing
-- Publishing flow MUST continue working throughout changes
-- No changes to the actual publishing API endpoints
-- **CRITICAL:** Content tracking against Clusters and Keywords must remain intact
-- **CRITICAL:** IGNY8 Clusters and Sectors taxonomy sync must be validated and working
-- Reuse existing components where possible (content list from cluster detail page)
\ No newline at end of file
diff --git a/docs/plans/implemented/WP_PLUGIN_IGNY8_APP_CLEANUP_IMPLEMENTATION_SUMMARY.md b/docs/plans/implemented/WP_PLUGIN_IGNY8_APP_CLEANUP_IMPLEMENTATION_SUMMARY.md
deleted file mode 100644
index 6ce0d09a..00000000
--- a/docs/plans/implemented/WP_PLUGIN_IGNY8_APP_CLEANUP_IMPLEMENTATION_SUMMARY.md
+++ /dev/null
@@ -1,215 +0,0 @@
-# WordPress Plugin & IGNY8 App Cleanup - Implementation Summary
-
-**Date:** Implementation completed
-**Related Plan:** [WP_PLUGIN_IGNY8_APP_CLEANUP.md](./WP_PLUGIN_IGNY8_APP_CLEANUP.md)
-
----
-
-## Overview
-
-This document summarizes the changes implemented to clean up and simplify the WordPress plugin (IGNY8 WP Bridge) and the IGNY8 app frontend based on the requirements discussed.
-
----
-
-## WordPress Plugin Changes
-
-### 1. Controls Page → Settings Page (RENAMED & REDESIGNED)
-
-**File:** `plugins/wordpress/source/igny8-wp-bridge/admin/pages/settings.php`
-
-**Changes:**
-- Renamed "Controls" to "Settings" throughout the plugin
-- Complete redesign with post type cards showing:
-  - Auto-detected post types using WordPress `get_post_types(['public' => true])`
-  - Each post type displayed in a card with its own taxonomies
-  - Enable/disable toggles for each post type
-  - **"Coming Soon" badges** on all post types except Posts
-  - Default settings section with Post Status and Sync Enable toggles
-  - Taxonomy cards shown only for enabled post types
-
-**Key Features:**
-- Auto-detects ALL public post types (Posts, Pages, Products, Custom Post Types)
-- Shows custom taxonomies specific to each post type
-- Products section auto-detects WooCommerce attributes/taxonomies
-- Accordion/expandable cards for post type configuration
-- Clean, scannable interface
-
-### 2. Header Navigation Update
-
-**File:** `plugins/wordpress/source/igny8-wp-bridge/admin/layout-header.php`
-
-**Changes:**
-- Changed "Controls" navigation link to "Settings"
-- Updated icon to settings gear icon
-
-### 3. Admin Class Updates
-
-**File:** `plugins/wordpress/source/igny8-wp-bridge/admin/class-admin.php`
-
-**Changes:**
-- Changed menu slug from 'igny8-controls' to 'igny8-settings'
-- Updated render_page() to load settings.php instead of controls.php
-- Added new setting registration: `igny8_sync_enabled`
-
-### 4. Dashboard Quick Links Update
-
-**File:** `plugins/wordpress/source/igny8-wp-bridge/admin/pages/dashboard.php`
-
-**Changes:**
-- Updated "Controls" card to "Settings" with appropriate description and icon
-
-### 5. Sync Page Simplified
-
-**File:** `plugins/wordpress/source/igny8-wp-bridge/admin/pages/sync.php`
-
-**Changes:**
-- **Removed:** Keywords sync history section
-- **Removed:** Writers sync history section
-- **Removed:** Scheduled Syncs configuration section
-- **Kept:** Connection status indicator
-- **Kept:** Content stats (total synced count)
-- **Kept:** Last updated timestamp
-
----
-
-## IGNY8 App Frontend Changes
-
-### 1. New Content Structure Page
-
-**File:** `frontend/src/pages/Sites/ContentStructure.tsx`
-
-**Route:** `/sites/:id/content/structure`
-
-**Features:**
-- **Full page** (not modal/drawer as originally planned)
-- Cluster selector dropdown at top
-- Keywords table showing:
-  - Keyword name
-  - Intent
-  - Volume
-  - Content count per keyword
-- Content list reusing the ClusterDetail component style
-- View/Edit buttons for each content item
-- Back navigation to Content page
-
-### 2. App Router Update
-
-**File:** `frontend/src/App.tsx`
-
-**Changes:**
-- Added lazy import for `SiteContentStructure`
-- Added route: `/sites/:id/content/structure`
-
-### 3. Site Content Page Updates
-
-**File:** `frontend/src/pages/Sites/Content.tsx`
-
-**Changes:**
-- Added `postTypeFilter` state for filtering by post type
-- Added post type filter buttons (All, Posts, Pages, Products)
-- Added "Structure" button linking to `/sites/{id}/content/structure`
-- Filter buttons passed to API when fetching content
-
-### 4. Site Settings - Content Types Tab Removed
-
-**File:** `frontend/src/pages/Sites/Settings.tsx`
-
-**Changes:**
-- Removed 'content-types' from `TabType` union
-- Removed Content Types tab button from navigation
-- Removed Content Types tab content section
-- Removed `loadContentTypes()` function and related state
-- Added redirect: if tab is 'content-types', redirects to `/sites/{id}/content/structure`
-
----
-
-## Files Created
-
-| File | Purpose |
-|------|---------|
-| `plugins/wordpress/source/igny8-wp-bridge/admin/pages/settings.php` | New Settings page replacing Controls |
-| `frontend/src/pages/Sites/ContentStructure.tsx` | New Content Structure full page |
-
----
-
-## Files Modified
-
-| File | Changes |
-|------|---------|
-| `plugins/wordpress/source/igny8-wp-bridge/admin/class-admin.php` | Menu slug change, page render update |
-| `plugins/wordpress/source/igny8-wp-bridge/admin/layout-header.php` | Navigation link rename |
-| `plugins/wordpress/source/igny8-wp-bridge/admin/pages/dashboard.php` | Quick links card rename |
-| `plugins/wordpress/source/igny8-wp-bridge/admin/pages/sync.php` | Simplified (removed bulk sections) |
-| `frontend/src/App.tsx` | Added content structure route |
-| `frontend/src/pages/Sites/Content.tsx` | Added post type filters and Structure button |
-| `frontend/src/pages/Sites/Settings.tsx` | Removed Content Types tab |
-
----
-
-## What Remains Working (Unchanged)
-
-As per requirements, the following features remain fully functional:
-
-- ✅ **Single article publishing to WordPress** - Healthy and working
-- ✅ **Article updates** - Still working
-- ✅ **Taxonomies (categories/tags)** - Still applied during publish
-- ✅ **Featured images** - Still uploaded and set
-- ✅ **In-article images** - Still handled properly
-- ✅ **Content tracking against clusters/keywords** - Intact
-- ✅ **Cluster-based content view** - Now enhanced with new Content Structure page
-
----
-
-## UI Indicator Summary
-
-| Post Type | Status | UI Indicator |
-|-----------|--------|--------------|
-| Posts | Active | No badge (fully working) |
-| Pages | Coming Soon | "Coming Soon" badge |
-| Products | Coming Soon | "Coming Soon" badge |
-| Custom Post Types | Coming Soon | "Coming Soon" badge |
-
----
-
-## API Backend Requirements (Not Implemented)
-
-The following API endpoints may need backend updates to fully support the new frontend features:
-
-1. **Content Structure API** - Endpoint to fetch cluster-based content structure
-   - Clusters with their keywords
-   - Content counts per keyword
-   - Content list filterable by cluster/keyword
-
-2. **Post Type Filter** - Backend support for `postTypeFilter` parameter in content listing API
-
----
-
-## Testing Checklist
-
-### WordPress Plugin
-- [ ] Settings page loads correctly
-- [ ] All public post types are detected
-- [ ] Post type enable/disable toggles work
-- [ ] Taxonomies display correctly per post type
-- [ ] Coming Soon badges appear on non-Post types
-- [ ] Sync page shows correct connection status
-- [ ] Navigation links work correctly
-
-### IGNY8 App
-- [ ] Content Structure page loads at `/sites/{id}/content/structure`
-- [ ] Cluster selector dropdown works
-- [ ] Keywords table displays correctly
-- [ ] Content list shows with View/Edit buttons
-- [ ] Post type filter buttons work on Content page
-- [ ] Structure button navigates correctly
-- [ ] Site Settings no longer shows Content Types tab
-- [ ] Publishing to WordPress still works as expected
-
----
-
-## Notes
-
-1. The "Expired" taxonomy mentioned in requirements should be removed from WordPress - this is a plugin configuration issue, not a code change
-2. The Content Structure page reuses existing component styles for consistency
-3. All TypeScript errors have been resolved
-4. The implementation follows the existing design patterns and component library
diff --git a/docs/plans/implemented/fixes/component-audit-report.md b/docs/plans/implemented/fixes/component-audit-report.md
deleted file mode 100644
index d4a1e2a3..00000000
--- a/docs/plans/implemented/fixes/component-audit-report.md
+++ /dev/null
@@ -1,199 +0,0 @@
-# Component Inventory & Audit Report
-
-> Generated: 2025-01-XX (Phase 4.6 Component Audit)
-
-## Summary
-
-| Category | Count | Status |
-|----------|-------|--------|
-| UI Components | 24 folders | ✅ Organized |
-| Common Components | 41 files | ✅ Organized |
-| Form Components | 12 files | ✅ Organized |
-| Duplicate Components | 0 | ✅ Clean |
-| Inline Styles | ~20 uses | ⚠️ Acceptable (dynamic values only) |
-| CSS-in-JS | 0 | ✅ Clean |
-| Deprecated Classes | 0 | ✅ Clean |
-
-## UI Components (`/src/components/ui/`)
-
-### Core Interactive Components
-
-| Component | Location | Variants | Status |
-|-----------|----------|----------|--------|
-| Button | `button/Button.tsx` | primary, secondary, outline, ghost, gradient | ✅ Canonical |
-| ButtonWithTooltip | `button/ButtonWithTooltip.tsx` | Extends Button | ✅ Specialized |
-| ButtonGroup | `button-group/ButtonGroup.tsx` | - | ✅ Canonical |
-| Modal | `modal/index.tsx` | - | ✅ Canonical |
-| Dropdown | `dropdown/Dropdown.tsx` | - | ✅ Canonical |
-
-### Display Components
-
-| Component | Location | Status |
-|-----------|----------|--------|
-| Card | `card/Card.tsx` | ✅ Canonical |
-| Badge | `badge/` | ✅ Canonical |
-| Avatar | `avatar/` | ✅ Canonical |
-| Alert | `alert/` | ✅ Canonical |
-| Toast | `toast/` | ✅ Canonical |
-| Tooltip | `tooltip/` | ✅ Canonical |
-| Ribbon | `ribbon/` | ✅ Canonical |
-
-### Navigation Components
-
-| Component | Location | Status |
-|-----------|----------|--------|
-| Breadcrumb | `breadcrumb/` | ✅ Canonical |
-| Tabs | `tabs/` | ✅ Canonical |
-| Accordion | `accordion/` | ✅ Canonical |
-| Pagination | `pagination/` | ✅ Canonical |
-
-### Data Display Components
-
-| Component | Location | Status |
-|-----------|----------|--------|
-| Table | `table/` | ✅ Canonical |
-| DataView | `dataview/` | ✅ Canonical |
-| Progress | `progress/ProgressBar.tsx` | ✅ Canonical |
-| Spinner | `spinner/` | ✅ Canonical |
-| List | `list/` | ✅ Canonical |
-
-### Media Components
-
-| Component | Location | Status |
-|-----------|----------|--------|
-| Images | `images/` | ✅ Canonical |
-| Videos | `videos/` | ✅ Canonical |
-
-## Common Components (`/src/components/common/`)
-
-### Modal Variants (Specialized use-cases)
-
-| Component | Purpose | Uses Base Modal |
-|-----------|---------|-----------------|
-| FormModal | Form display in modal | ✅ Yes |
-| ConfirmDialog | Confirmation prompts | ✅ Yes |
-| ProgressModal | Progress tracking | ✅ Yes |
-| ContentViewerModal | Content preview | ✅ Yes |
-| ImageQueueModal | Image generation queue | ✅ Yes |
-| BulkExportModal | Bulk export dialog | ✅ Yes |
-| BulkStatusUpdateModal | Bulk status updates | ✅ Yes |
-| SearchModal | Global search | ✅ Yes |
-
-### Page Layout Components
-
-| Component | Purpose | Status |
-|-----------|---------|--------|
-| PageHeader | Page title & actions | ✅ Canonical |
-| PageBreadCrumb | Navigation breadcrumbs | ✅ Canonical |
-| PageMeta | SEO meta tags | ✅ Canonical |
-| PageTransition | Route transitions | ✅ Canonical |
-| PageErrorBoundary | Error handling | ✅ Canonical |
-| ComponentCard | Standardized card wrapper | ✅ Canonical |
-
-### Selection Components
-
-| Component | Purpose | Status |
-|-----------|---------|--------|
-| SiteSelector | Single site selection | ✅ Canonical |
-| SiteWithAllSitesSelector | Site selection with "All" option | ✅ Specialized |
-| SingleSiteSelector | Simple site picker | ✅ Specialized |
-| SectorSelector | Sector selection | ✅ Canonical |
-| SiteAndSectorSelector | Combined site+sector | ✅ Specialized |
-| ColumnSelector | Table column visibility | ✅ Canonical |
-
-### Utility Components
-
-| Component | Purpose | Status |
-|-----------|---------|--------|
-| ErrorBoundary | Error catching | ✅ Canonical |
-| GlobalErrorDisplay | Global error UI | ✅ Canonical |
-| LoadingStateMonitor | Loading state debug | ✅ Dev Only |
-| ModuleGuard | Feature flag guard | ✅ Canonical |
-| ScrollToTop | Scroll restoration | ✅ Canonical |
-| ThemeToggleButton | Dark/light toggle | ✅ Canonical |
-| ViewToggle | View mode switch | ✅ Canonical |
-
-## Form Components (`/src/components/form/`)
-
-### Input Types
-
-| Component | Location | Status |
-|-----------|----------|--------|
-| InputField | `input/InputField.tsx` | ✅ Canonical |
-| TextArea | `input/TextArea.tsx` | ✅ Canonical |
-| Checkbox | `input/Checkbox.tsx` | ✅ Canonical |
-| Radio | `input/Radio.tsx` | ✅ Canonical |
-| RadioSm | `input/RadioSm.tsx` | ✅ Specialized |
-| FileInput | `input/FileInput.tsx` | ✅ Canonical |
-| Select | `Select.tsx` | ✅ Canonical |
-| SelectDropdown | `SelectDropdown.tsx` | ✅ Specialized |
-| MultiSelect | `MultiSelect.tsx` | ✅ Canonical |
-| DatePicker | `date-picker.tsx` | ✅ Canonical |
-| Switch | `switch/` | ✅ Canonical |
-
-### Form Utilities
-
-| Component | Purpose | Status |
-|-----------|---------|--------|
-| Form | Form wrapper | ✅ Canonical |
-| FormFieldRenderer | Dynamic field rendering | ✅ Canonical |
-| Label | Form label | ✅ Canonical |
-
-## Inline Styles Analysis
-
-Inline styles are used ONLY for:
-1. **Dynamic values** (width percentages from props/state)
-2. **Animation delays** (calculated from index)
-3. **Z-index** (for stacking contexts)
-4. **External libraries** (jvectormap, etc.)
-
-These are acceptable uses as per DESIGN_SYSTEM.md guidelines.
-
-### Files with Inline Styles (Verified)
-
-| File | Reason | Status |
-|------|--------|--------|
-| AppSidebar.tsx | Logo positioning | ⚠️ Review needed |
-| Dropdown.tsx | Dynamic positioning | ✅ Acceptable |
-| AlertModal.tsx | Animation blur effects | ✅ Acceptable |
-| ProgressBar.tsx | Dynamic width | ✅ Acceptable |
-| ThreeWidgetFooter.tsx | Dynamic progress | ✅ Acceptable |
-| ToastContainer.tsx | Animation delay | ✅ Acceptable |
-| EnhancedTooltip.tsx | Z-index layering | ✅ Acceptable |
-| PricingTable.tsx | Dynamic height | ✅ Acceptable |
-| CountryMap.tsx | External library | ✅ Acceptable |
-
-## Recommendations
-
-### No Action Required
-1. ✅ Button component system is well-organized
-2. ✅ Modal variants properly extend base Modal
-3. ✅ Form inputs are consolidated
-4. ✅ No CSS-in-JS patterns found
-5. ✅ No deprecated igny8-* utility classes in use
-
-### Minor Improvements (Optional)
-1. Consider moving sample-components/ HTML files to docs/
-2. Review AppSidebar.tsx inline style for logo positioning
-3. Consider adding Storybook for component documentation
-
-## Verification Checklist
-
-- [x] Button variants (primary, secondary, outline, ghost, gradient) - All in Button.tsx
-- [x] Card components - Single Card.tsx implementation
-- [x] Form inputs (text, select, checkbox, radio) - All in /form/input/
-- [x] Table components - Single implementation in /ui/table/
-- [x] Modal/dialog - Single Modal with specialized wrappers
-- [x] Navigation components - Breadcrumb, Tabs organized
-- [x] Icon usage - Lucide React only (no custom icon system)
-- [x] Metric cards - ComponentCard used consistently
-- [x] Progress bars - Single ProgressBar.tsx implementation
-
-## Systems Consolidated
-
-| System | Status | Notes |
-|--------|--------|-------|
-| Tailwind CSS 4.0 | ✅ PRIMARY | All styling uses Tailwind |
-| Custom CSS | ✅ MINIMAL | Only tokens.css and module-specific |
-| Inline Styles | ✅ CONTROLLED | Only for dynamic values |
-| CSS-in-JS | ✅ NONE | Not present in codebase |
diff --git a/docs/plans/implemented/fixes/design-verification-report.md b/docs/plans/implemented/fixes/design-verification-report.md
deleted file mode 100644
index 4d606a9d..00000000
--- a/docs/plans/implemented/fixes/design-verification-report.md
+++ /dev/null
@@ -1,218 +0,0 @@
-# Design System Verification Report
-
-> Phase 4.7 - Visual Regression Testing & Design Consistency Check
-
-## Executive Summary
-
-| Criterion | Status | Notes |
-|-----------|--------|-------|
-| Typography Scale | ✅ PASS | Consistent Tailwind text-* classes |
-| Module Colors | ✅ PASS | Using module-specific accent colors |
-| Inline Styles | ✅ PASS | Only dynamic values (acceptable) |
-| Duplicate Components | ✅ PASS | No duplicates found |
-| Sidebar Spacing | ✅ PASS | Proper layout structure |
-| Header Metrics | ✅ PASS | Present via HeaderMetrics context |
-| Footer Widgets | ✅ PASS | ThreeWidgetFooter on all data pages |
-| Dark Mode | ✅ PASS | Consistent dark: variants |
-
----
-
-## 1. Typography Scale Verification
-
-### Standard Scale Used
-- `text-xs` (12px) - Labels, timestamps, secondary info
-- `text-sm` (14px) - Body text, descriptions
-- `text-base` (16px) - Default, section headers
-- `text-lg` (18px) - Page titles, prominent headers
-- `text-xl` - `text-5xl` - Hero sections, marketing
-
-### Files Verified
-- AppHeader.tsx - Page titles use `text-lg font-semibold`
-- ThreeWidgetFooter.tsx - Consistent heading sizes
-- All table pages - Uniform text sizing
-
-✅ **All pages use the same typography scale**
-
----
-
-## 2. Module Colors Verification
-
-### Color Assignment (from tokens.css)
-| Module | Color Variable | Used For |
-|--------|---------------|----------|
-| Planner | `--color-primary` (blue) | Keywords, Clusters, Ideas |
-| Writer | `--color-purple` | Content, Tasks, Images |
-| Publisher | `--color-success` | Publishing workflows |
-| Settings | `--color-warning` | Configuration pages |
-
-### HeaderMetrics Accent Colors
-```typescript
-// From ThreeWidgetFooter.tsx
-type SubmoduleColor = 'blue' | 'purple' | 'green' | 'amber' | 'teal';
-```
-
-✅ **All modules use assigned colors consistently**
-
----
-
-## 3. Inline Styles Analysis
-
-### Acceptable Uses Found (Dynamic Values Only)
-| Location | Use Case | Verdict |
-|----------|----------|---------|
-| ProgressBar.tsx | `width: ${percent}%` | ✅ Required |
-| ThreeWidgetFooter.tsx | Progress width | ✅ Required |
-| ToastContainer.tsx | Animation delay | ✅ Required |
-| Dropdown.tsx | Dynamic positioning | ✅ Required |
-| CountryMap.tsx | Library styles | ✅ External lib |
-| EnhancedTooltip.tsx | Z-index | ✅ Acceptable |
-
-### Unacceptable Uses
-None found - no hardcoded colors or spacing via inline styles.
-
-✅ **No problematic inline styles in codebase**
-
----
-
-## 4. Component Duplication Check
-
-### Button Components
-- Canonical: `components/ui/button/Button.tsx`
-- Variants: ButtonWithTooltip, ButtonGroup (specialized, not duplicates)
-- No duplicate implementations found
-
-### Modal Components
-- Canonical: `components/ui/modal/index.tsx`
-- Wrappers: FormModal, ConfirmDialog, ProgressModal (all use base Modal)
-- No duplicate implementations found
-
-### Card Components
-- Canonical: `components/ui/card/Card.tsx`
-- Wrappers: ComponentCard (extends Card for page use)
-- No duplicate implementations found
-
-✅ **No duplicate component files**
-
----
-
-## 5. Sidebar/Navigation Spacing
-
-### Layout Structure
-```
-AppLayout
-├── AppSidebar (fixed left, 240px expanded / 72px collapsed)
-├── AppHeader (sticky top, full width minus sidebar)
-└── Main Content (padded, responsive)
-```
-
-### Verified Properties
-- Sidebar: `px-5` horizontal padding
-- Navigation groups: `mb-2` between sections
-- Menu items: `py-2.5` vertical padding
-- Responsive collapse: `lg:` breakpoint handling
-
-✅ **Sidebar/navigation properly spaced**
-
----
-
-## 6. Header Metrics Verification
-
-### Implementation
-- Provider: `HeaderMetricsContext.tsx`
-- Display: `HeaderMetrics.tsx` in AppHeader
-- Per-page: Each page calls `setMetrics()` with relevant data
-
-### Pages Setting Metrics
-- Keywords.tsx ✅
-- Clusters.tsx ✅
-- Ideas.tsx ✅
-- Content.tsx ✅
-- Tasks.tsx ✅
-- Images.tsx ✅
-- All Settings pages ✅
-
-✅ **Header metrics accurate on all pages**
-
----
-
-## 7. Footer Widgets Verification
-
-### ThreeWidgetFooter Implementation
-Component location: `components/dashboard/ThreeWidgetFooter.tsx`
-
-### Pages Using ThreeWidgetFooter
-| Page | Status | Widgets |
-|------|--------|---------|
-| Keywords.tsx | ✅ | Module tips, Stats, Progress |
-| Clusters.tsx | ✅ | Module tips, Stats, Progress |
-| Ideas.tsx | ✅ | Module tips, Stats, Progress |
-| Content.tsx | ✅ | Module tips, Stats, Progress |
-| Tasks.tsx | ✅ | Module tips, Stats, Progress |
-| Images.tsx | ✅ | Module tips, Stats, Progress |
-
-✅ **Footer widgets present and correct on all subpages**
-
----
-
-## 8. Dark Mode Consistency
-
-### Dark Mode Classes Pattern
-All components follow the pattern:
-```tsx
-className="text-gray-800 dark:text-white bg-white dark:bg-gray-900"
-```
-
-### Verified Components
-- AppHeader ✅
-- AppSidebar ✅
-- All UI components ✅
-- All form components ✅
-- All dashboard widgets ✅
-
-### Dark Mode CSS Variables (tokens.css)
-```css
-.dark {
-  --color-surface: #1A2B3C;
-  --color-panel: #243A4D;
-  --color-text: #E8F0F4;
-  --color-text-dim: #8A9BAC;
-  --color-stroke: #2E4A5E;
-}
-```
-
-✅ **Dark mode consistency maintained**
-
----
-
-## Success Criteria Checklist
-
-- [x] All pages use same typography scale
-- [x] All modules use assigned colors consistently  
-- [x] No inline styles in codebase (only acceptable dynamic values)
-- [x] No duplicate component files
-- [x] Sidebar/navigation properly spaced
-- [x] Header metrics accurate on all pages
-- [x] Footer widgets present and correct on all subpages
-
----
-
-## Recommendations
-
-### No Action Required
-The design system is properly implemented and consistent.
-
-### Optional Improvements
-1. Consider adding visual regression tests with Playwright/Cypress
-2. Add Storybook for component documentation
-3. Create automated lint rules to prevent future style violations
-
----
-
-## Files Modified for Design Compliance
-
-No files needed modification - the design system is already compliant.
-
-## Related Documents
-- [DESIGN_SYSTEM.md](../../frontend/DESIGN_SYSTEM.md) - Component guidelines
-- [component-audit-report.md](./component-audit-report.md) - Component inventory
-- [tokens.css](../../frontend/src/styles/tokens.css) - Design tokens
diff --git a/docs/plans/implemented/fixes/footer-widget-pagination-fix.md b/docs/plans/implemented/fixes/footer-widget-pagination-fix.md
deleted file mode 100644
index 21f22317..00000000
--- a/docs/plans/implemented/fixes/footer-widget-pagination-fix.md
+++ /dev/null
@@ -1,193 +0,0 @@
-# Footer Widget Pagination Fix - Summary
-
-## Problem
-
-All pages with `ThreeWidgetFooter` are calculating metrics using **page-filtered arrays** instead of **total counts** from the API. This causes incorrect metric values when users are viewing paginated results.
-
-### Example:s
-- If there are 100 total keywords with 10 on the current page
-- And 5 keywords on the current page don't have a `cluster_id`
-- The footer shows "Unmapped: 5" instead of the actual total unmapped count
-
-## Root Cause
-
-The footer widgets use JavaScript `.filter()` methods on the local `items` array (which only contains the current page's data) instead of making separate API calls to get total counts for each status.
-
-```typescript
-// WRONG - Uses page-filtered array
-{ label: 'Unmapped', value: keywords.filter(k => !k.cluster_id).length }
-
-// CORRECT - Uses total count from API
-{ label: 'Unmapped', value: totalUnmapped }
-```
-
-## Solution Pattern
-
-For each affected page:
-
-1. **Add state variables for total counts**
-2. **Create a `loadTotalMetrics()` function** that makes lightweight API calls (page_size=1) filtered by status
-3. **Call `loadTotalMetrics()` when site/sector changes**
-4. **Update footer widget** to use the total count state instead of filtering local arrays
-
-## Files Fixed
-
-### ✅ 1. Keywords.tsx
-- Added: `totalClustered`, `totalUnmapped`, `totalVolume` state
-- Added: `loadTotalMetrics()` function
-- Updated: Footer widget to use total counts
-
-### ✅ 2. Clusters.tsx
-- Added: `totalWithIdeas`, `totalReady` state
-- Added: `loadTotalMetrics()` function
-- Updated: Footer widget to use total counts
-
-### ⏳ 3. Ideas.tsx
-- **TODO**: Add `totalInTasks`, `totalPending` state
-- **TODO**: Add `loadTotalMetrics()` function with calls to:
-  - `fetchContentIdeas({ status: 'queued' })` → `totalInTasks`
-  - `fetchContentIdeas({ status: 'new' })` → `totalPending`
-- **TODO**: Update footer widget metrics
-
-###  ⏳ 4. Tasks.tsx
-- **TODO**: Add total count state variables
-- **TODO**: Add `loadTotalMetrics()` function
-- **TODO**: Update footer widget
-
-### ⏳ 5. Content.tsx
-- **TODO**: Add total count state variables for each status (draft, review, approved)
-- **TODO**: Add `loadTotalMetrics()` function
-- **TODO**: Update footer widget
-
-### ⏳ 6. Images.tsx
-- **TODO**: Add total count state variables
-- **TODO**: Add `loadTotalMetrics()` function
-- **TODO**: Update footer widget
-
-### ⏳ 7. Review.tsx
-- **TODO**: Add total count state variables
-- **TODO**: Add `loadTotalMetrics()` function
-- **TODO**: Update footer widget
-
-### ⏳ 8. Approved.tsx
-- **TODO**: Add total count state variables
-- **TODO**: Add `loadTotalMetrics()` function
-- **TODO**: Update footer widget
-
-## Implementation Template
-
-### Step 1: Add State Variables
-
-```typescript
-// Total counts for footer widget (not page-filtered)
-const [totalWithStatus1, setTotalWithStatus1] = useState(0);
-const [totalWithStatus2, setTotalWithStatus2] = useState(0);
-```
-
-### Step 2: Create loadTotalMetrics Function
-
-```typescript
-// Load total metrics for footer widget (not affected by pagination)
-const loadTotalMetrics = useCallback(async () => {
-  if (!activeSite) return;
-
-  try {
-    // Get items with status1
-    const status1Res = await fetchItems({
-      page_size: 1,
-      site_id: activeSite.id,
-      ...(activeSector?.id && { sector_id: activeSector.id }),
-      status: 'status1',
-    });
-    setTotalWithStatus1(status1Res.count || 0);
-
-    // Get items with status2
-    const status2Res = await fetchItems({
-      page_size: 1,
-      site_id: activeSite.id,
-      ...(activeSector?.id && { sector_id: activeSector.id }),
-      status: 'status2',
-    });
-    setTotalWithStatus2(status2Res.count || 0);
-  } catch (error) {
-    console.error('Error loading total metrics:', error);
-  }
-}, [activeSite, activeSector]);
-```
-
-### Step 3: Call on Mount/Change
-
-```typescript
-// Load total metrics when site/sector changes
-useEffect(() => {
-  loadTotalMetrics();
-}, [loadTotalMetrics]);
-```
-
-### Step 4: Update Footer Widget
-
-```typescript
-<ThreeWidgetFooter
-  pageProgress={{
-    metrics: [
-      { label: 'Total', value: totalCount },
-      { label: 'Status 1', value: totalWithStatus1, percentage: `${totalCount > 0 ? Math.round((totalWithStatus1 / totalCount) * 100) : 0}%` },
-      { label: 'Status 2', value: totalWithStatus2 },
-    ],
-    progress: {
-      value: totalCount > 0 ? Math.round((totalWithStatus1 / totalCount) * 100) : 0,
-      label: 'Processed',
-      color: 'blue',
-    },
-    hint: totalWithStatus2 > 0
-      ? `${totalWithStatus2} items ready for processing`
-      : 'All items processed!',
-  }}
-  // ... rest of props
-/>
-```
-
-## Testing Checklist
-
-For each fixed page, verify:
-
-- [ ] Footer metrics show correct total counts (not page counts)
-- [ ] Metrics update when changing sites
-- [ ] Metrics update when changing sectors
-- [ ] Metrics are consistent with automation page metrics
-- [ ] Performance is acceptable (lightweight API calls with page_size=1)
-
-## Related Files
-
-- `/frontend/src/components/dashboard/ThreeWidgetFooter.tsx`
-- `/frontend/src/pages/Automation/AutomationPage.tsx` (reference implementation)
-- All planner and writer page files
-
-## API Endpoints Used
-
-All pages use their respective `fetch*` functions with filters:
-- `fetchKeywords({ status, page_size: 1 })`
-- `fetchClusters({ status, page_size: 1 })`
-- `fetchContentIdeas({ status, page_size: 1 })`
-- `fetchTasks({ status, page_size: 1 })`
-- `fetchContent({ status, page_size: 1 })`
-- `fetchContentImages({ status, page_size: 1 })`
-
-The `page_size: 1` ensures minimal data transfer while still getting the count.
-
-## Performance Considerations
-
-- Each page makes 2-3 additional API calls on load
-- Calls are lightweight (page_size=1, only count is used)
-- Calls are cached until site/sector changes
-- Total overhead: ~100-300ms per page load (acceptable)
-
-## Automation Page Consistency
-
-The AutomationPage already uses this pattern correctly:
-- Lines 99-149: Fetches total counts for all metrics
-- Uses `fetchKeywords({ status: 'new' })`, `fetchKeywords({ status: 'mapped' })`, etc.
-- Sets metrics in state: `setMetrics({ keywords: { total, new, mapped } })`
-- All stage cards and metric cards use these pre-fetched totals
-
-This fix brings all other pages in line with the Automation page's correct implementation.
diff --git a/docs/plans/implemented/fixes/phase2-module-activation.md b/docs/plans/implemented/fixes/phase2-module-activation.md
deleted file mode 100644
index 8ba14448..00000000
--- a/docs/plans/implemented/fixes/phase2-module-activation.md
+++ /dev/null
@@ -1,152 +0,0 @@
-# Phase 2 Module Activation Guide
-
-> Reference document for activating disabled modules (Linker, Optimizer, SiteBuilder)
-
-## Current Status (as of December 2025)
-
-| Module | Status | Backend Flag | Migration |
-|--------|--------|--------------|-----------|
-| **SiteBuilder** | ❌ DEPRECATED | `site_builder_enabled` | Disabled via 0011 |
-| **Linker** | ⏸️ Phase 2 | `linker_enabled` | Disabled via 0011 |
-| **Optimizer** | ⏸️ Phase 2 | `optimizer_enabled` | Disabled via 0011 |
-
----
-
-## How Module Disabling Works
-
-### 1. Database Flag (GlobalIntegrationSettings)
-```python
-# backend/igny8_core/modules/system/global_settings_models.py
-site_builder_enabled = models.BooleanField(default=False)
-linker_enabled = models.BooleanField(default=False)
-optimizer_enabled = models.BooleanField(default=False)
-```
-
-### 2. Migration Set Defaults
-```python
-# backend/igny8_core/modules/system/migrations/0011_disable_phase2_modules.py
-# Sets all three modules to disabled for existing records
-```
-
-### 3. API Returns Settings
-```python
-# backend/igny8_core/modules/system/settings_views.py
-# GET /api/module-settings/ returns enabled/disabled status
-```
-
-### 4. Frontend Checks Settings
-```typescript
-// frontend/src/store/moduleStore.ts
-// useModuleStore.isModuleEnabled('linker') → checks API response
-```
-
-### 5. Sidebar Hides Menu Items
-```tsx
-// frontend/src/layout/AppSidebar.tsx
-if (isModuleEnabled('linker')) {
-  // Add menu item
-}
-```
-
----
-
-## Activation Steps for Phase 2
-
-### Option A: Via Django Admin (Recommended)
-
-1. Log into Django Admin (`/admin/`)
-2. Navigate to **System → Global Integration Settings**
-3. Edit the singleton record
-4. Set `linker_enabled` or `optimizer_enabled` to `True`
-5. Save
-
-### Option B: Via Database
-
-```sql
-UPDATE system_globalintegrationsettings
-SET linker_enabled = TRUE
-WHERE id = 1;
-```
-
-### Option C: Via Management Command (TBD)
-
-```bash
-python manage.py enable_module linker
-python manage.py enable_module optimizer
-```
-
----
-
-## Pre-Activation Checklist
-
-Before enabling a Phase 2 module:
-
-### Linker Module
-- [ ] Verify `modules/linker/views.py` ViewSet is functional
-- [ ] Verify `pages/Linker/` frontend pages exist
-- [ ] Test API endpoints manually
-- [ ] Add route protection for `/linker/*` paths
-- [ ] Update documentation status
-
-### Optimizer Module
-- [ ] Verify `modules/optimizer/views.py` ViewSet is functional
-- [ ] Verify `business/optimization/` services work
-- [ ] Verify `ai/functions/optimize.py` AI function
-- [ ] Verify `pages/Optimizer/` frontend pages exist
-- [ ] Test API endpoints manually
-- [ ] Add route protection for `/optimizer/*` paths
-- [ ] Update documentation status
-
----
-
-## Route Protection (TODO for Phase 2)
-
-Currently, direct URL access (e.g., `/linker`) still works even when module is disabled.
-
-### Recommended Implementation:
-
-```tsx
-// frontend/src/components/common/ModuleGuard.tsx
-export function ModuleGuard({ module, children }: { module: string; children: React.ReactNode }) {
-  const { isModuleEnabled } = useModuleStore();
-  
-  if (!isModuleEnabled(module)) {
-    return <Navigate to="/" replace />;
-  }
-  
-  return <>{children}</>;
-}
-
-// In routes:
-<Route path="/linker/*" element={
-  <ModuleGuard module="linker">
-    <LinkerPage />
-  </ModuleGuard>
-} />
-```
-
----
-
-## SiteBuilder (DEPRECATED)
-
-**Do NOT activate SiteBuilder.** This module is deprecated and code is being removed.
-
-### Removed Items (Task 5.1)
-- ✅ `frontend/src/__tests__/sites/` - Test directory deleted
-- ✅ `USE_SITE_BUILDER_REFACTOR` - Feature flag removed from settings.py
-- ✅ Feature flag checks - Removed from clustering_service.py, validation_service.py, serializers.py
-- ✅ Tasks.tsx - Removed SiteBuilder filter logic
-
-### Remaining References (Documentation Only)
-- Migration comments (safe to keep)
-- CHANGELOG.md entries (historical)
-- IGNY8-APP.md (documents deprecated status)
-- Database field (kept for backward compatibility)
-
----
-
-## Related Documentation
-
-- [LINKER.md](../10-MODULES/LINKER.md) - Full Linker module docs
-- [OPTIMIZER.md](../10-MODULES/OPTIMIZER.md) - Full Optimizer module docs
-- [SYSTEM-SETTINGS.md](../10-MODULES/SYSTEM-SETTINGS.md) - Settings model reference
diff --git a/docs/plans/implemented/immediate-udpates-completed.md b/docs/plans/implemented/immediate-udpates-completed.md
deleted file mode 100644
index 9b509596..00000000
--- a/docs/plans/implemented/immediate-udpates-completed.md
+++ /dev/null
@@ -1,118 +0,0 @@
-
-
-
-## Summary of Completed Work
-
-### 1. ✅ App Dashboard Workflow Guide Updated
-- Changed layout from single column to **full-width row with 3 columns**
-- Steps distributed as requested: **Column 1 (1-3), Column 2 (4-6), Column 3 (7-8)**
-- Each step shows icon, number badge, title, description, and action button
-- "Full Help Guide" moved to header as a button
-
-### 2. ✅ Site Dashboard New Widgets Created
-Created 3 new widgets with consistent styling and colors:
-
-- **SiteConfigWidget**: Shows site configuration status (Industry, Sectors, WordPress, Keywords, Author Profiles)
-- **OperationsCostsWidget**: Displays AI operations with counts, credits used, and averages
-- **CreditAvailabilityWidget**: Shows available credits and calculates potential operations
-
-All widgets use:
-- Consistent brand colors from app color scheme
-- Icons matching the screenshot style
-- Responsive design with proper dark mode support
-- Interactive hover states
-
-### 3. ✅ Layout Ready for 2-3 Column Implementation
-The new widgets are ready to be integrated into the site dashboard with a 2-3 column grid layout showing:
-- Site-specific configuration data
-- Individual operation statistics with credit costs
-- Credit availability and potential operations
-
-
-STIL Styling is laoded from paralell color ssytem not our standard
----
-
-
-## Table 1: Pages Requiring Site/Sector Selectors (Excluding Planner & Writer Modules)
-
-| Page/Module | Site Selector | Sector Selector | Reason |
-|-------------|:-------------:|:---------------:|---------|
-| **DASHBOARD** |
-| Home | ✅ (All Sites option) | ❌ | Overview across sites - sector too granular |
-| Content Settings | ✅ | ❌ | Settings are site-level, not sector-level |
-| **AUTOMATION** |
-| Automation | ✅ | ❌ | Automation runs at site level |
-
-
-**Key Findings:**
-- **Setup Module**: Keywords page needs both selectors; Content Settings needs site only
-- **Automation**: Site selector only (automation is site-level)
-- **Linker & Optimizer**: Both selectors needed (content-specific)
-- **Admin/Billing/Account/Help**: No selectors needed (not site-specific)
-
----
-
-## Table 2: Progress Modal Text Updates for AI Functions
-
-### Auto Cluster Keywords
-
-| Phase | Current Text | Recommended Text | Includes Count |
-|-------|-------------|------------------|:---------------:|
-| INIT | Validating keywords | Validating {count} keywords for clustering | ✅ |
-| PREP | Loading keyword data | Analyzing keyword relationships | ❌ |
-| AI_CALL | Generating clusters with Igny8 Semantic SEO Model | Grouping keywords by search intent ({count} keywords) | ✅ |
-| PARSE | Organizing clusters | Organizing {cluster_count} semantic clusters | ✅ |
-| SAVE | Saving clusters | Saving {cluster_count} clusters with {keyword_count} keywords | ✅ |
-| DONE | Clustering complete! | ✓ Created {cluster_count} clusters from {keyword_count} keywords | ✅ |
-
-### Generate Ideas
-
-| Phase | Current Text | Recommended Text | Includes Count |
-|-------|-------------|------------------|:---------------:|
-| INIT | Verifying cluster integrity | Analyzing {count} clusters for content opportunities | ✅ |
-| PREP | Loading cluster keywords | Mapping {keyword_count} keywords to topic briefs | ✅ |
-| AI_CALL | Generating ideas with Igny8 Semantic AI | Generating content ideas for {cluster_count} clusters | ✅ |
-| PARSE | High-opportunity ideas generated | Structuring {idea_count} article outlines | ✅ |
-| SAVE | Content Outline for Ideas generated | Saving {idea_count} content ideas with outlines | ✅ |
-| DONE | Ideas generated! | ✓ Generated {idea_count} content ideas from {cluster_count} clusters | ✅ |
-
-### Generate Content
-
-| Phase | Current Text | Recommended Text | Includes Count |
-|-------|-------------|------------------|:---------------:|
-| INIT | Validating task | Preparing {count} article{s} for generation | ✅ |
-| PREP | Preparing content idea | Building content brief with {keyword_count} target keywords | ✅ |
-| AI_CALL | Writing article with Igny8 Semantic AI | Writing {count} article{s} (~{word_target} words each) | ✅ |
-| PARSE | Formatting content | Formatting HTML content and metadata | ❌ |
-| SAVE | Saving article | Saving {count} article{s} ({total_words} words) | ✅ |
-| DONE | Content generated! | ✓ {count} article{s} generated ({total_words} words total) | ✅ |
-
-### Generate Image Prompts
-
-| Phase | Current Text | Recommended Text | Includes Count |
-|-------|-------------|------------------|:---------------:|
-| INIT | Checking content and image slots | Analyzing content for {count} image opportunities | ✅ |
-| PREP | Mapping content for image prompts | Identifying featured image and {in_article_count} in-article image slots | ✅ |
-| AI_CALL | Writing Featured Image Prompts | Creating optimized prompts for {count} images | ✅ |
-| PARSE | Writing In‑article Image Prompts | Refining {in_article_count} contextual image descriptions | ✅ |
-| SAVE | Assigning Prompts to Dedicated Slots | Assigning {count} prompts to image slots | ✅ |
-| DONE | Prompts generated! | ✓ {count} image prompts ready (1 featured + {in_article_count} in-article) | ✅ |
-
-### Generate Images from Prompts
-
-| Phase | Current Text | Recommended Text | Includes Count |
-|-------|-------------|------------------|:---------------:|
-| INIT | Validating image prompts | Queuing {count} images for generation | ✅ |
-| PREP | Preparing image generation queue | Preparing AI image generation ({count} images) | ✅ |
-| AI_CALL | Generating images with AI | Generating image {current}/{count}... | ✅ |
-| PARSE | Processing image URLs | Processing {count} generated images | ✅ |
-| SAVE | Saving image URLs | Uploading {count} images to media library | ✅ |
-| DONE | Images generated! | ✓ {count} images generated and saved | ✅ |
-
-**Key Improvements:**
-- ✅ All phases now include specific counts where data is available
-- ✅ More professional and informative language
-- ✅ Clear indication of progress with actual numbers
-- ✅ Success messages use checkmark (✓) for visual completion
-- ✅ Dynamic placeholders for singular/plural ({s}, {count})
-
diff --git a/docs/plans/implemented/payment-refactor-plan.md b/docs/plans/implemented/payment-refactor-plan.md
deleted file mode 100644
index cbda4229..00000000
--- a/docs/plans/implemented/payment-refactor-plan.md
+++ /dev/null
@@ -1,2365 +0,0 @@
-# Payment System Complete Refactor Plan
-
-> **Version:** 1.0
-> **Date:** January 7, 2026
-> **Status:** In Progress - Phase 1 Complete ✅
-
----
-
-## Executive Summary
-
-This plan consolidates all audit findings and architectural discussions into a comprehensive refactor that will:
-
-1. **Simplify signup flow** - Remove payment gateway redirect from signup
-2. **Unify payment experience** - Single payment interface in `/account/plans`
-3. **Fix all critical security issues** - Webhook verification, idempotency
-4. **Clean up dead code** - Remove `/pk` variant, country detection API, unused fields
-5. **Implement proper state handling** - Account lifecycle properly reflected in UI
-
----
-
-## Architecture Changes
-
-### Before (Current)
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                      CURRENT FLOW                                │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  /signup OR /signup/pk                                          │
-│       │                                                          │
-│       ├── Country detection API call                            │
-│       ├── Load payment methods API call                         │
-│       ├── Show payment method selection                         │
-│       │                                                          │
-│       └── On Submit:                                            │
-│           ├── Stripe → Redirect to Stripe → Return to /plans    │
-│           ├── PayPal → Redirect to PayPal → Return to /plans    │
-│           └── Bank → Navigate to /plans (show banner)           │
-│                                                                  │
-│  PROBLEMS:                                                       │
-│  - Two signup routes (/signup and /signup/pk)                   │
-│  - Country detection API complexity                              │
-│  - Payment gateway redirect from signup                          │
-│  - User loses context if redirect fails                          │
-│  - Duplicate payment logic (signup + plans page)                │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### After (New)
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                       NEW FLOW                                   │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  /signup (SINGLE ROUTE)                                         │
-│       │                                                          │
-│       ├── Country dropdown (auto-detect default using IP API)   │
-│       ├── Plan selection                                        │
-│       ├── NO payment method selection                           │
-│       │                                                          │
-│       └── On Submit:                                            │
-│           └── Create account (pending_payment)                  │
-│           └── Navigate to /account/plans                        │
-│                                                                  │
-│  /account/plans                                                 │
-│       │                                                          │
-│       ├── IF new user (never paid):                             │
-│       │   └── Show PendingPaymentView (full page)               │
-│       │       - Invoice details                                  │
-│       │       - Payment method selection (based on country)      │
-│       │       - Inline payment form                              │
-│       │                                                          │
-│       ├── IF existing user (has paid before):                   │
-│       │   └── Show ActiveSubscriptionView                       │
-│       │       - Current plan details                             │
-│       │       - Credit balance                                   │
-│       │       - Buy credits (modal)                              │
-│       │       - Billing history                                  │
-│       │       - IF pending invoice: Show banner + Pay modal      │
-│       │                                                          │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Phase 1: Backend Cleanup & Security Fixes ✅
-
-### 1.1 Fix Critical Security Issues ✅
-
-#### 1.1.1 Enable PayPal Webhook Signature Verification ✅
-
-**File:** `backend/igny8_core/business/billing/views/paypal_views.py`
-
-```python
-# Line ~510 - UNCOMMENT the rejection
-if not is_valid:
-    logger.error("PayPal webhook signature verification failed")
-    return Response({'error': 'Invalid signature'}, status=400)  # UNCOMMENT THIS
-```
-
-#### 1.1.2 Add Stripe Webhook Idempotency ✅
-
-**File:** `backend/igny8_core/business/billing/views/stripe_views.py`
-
-```python
-# Add at start of _handle_checkout_completed (around line 380):
-@transaction.atomic
-def _handle_checkout_completed(session):
-    session_id = session.get('id')
-
-    # IDEMPOTENCY CHECK
-    if Payment.objects.filter(
-        metadata__stripe_checkout_session_id=session_id
-    ).exists():
-        logger.info(f"Webhook already processed for session {session_id}")
-        return
-
-    # ... rest of handler
-```
-
-#### 1.1.3 Add PayPal Capture Idempotency ✅
-
-**File:** `backend/igny8_core/business/billing/views/paypal_views.py`
-
-```python
-# Add at start of PayPalCaptureOrderView.post (around line 270):
-def post(self, request):
-    order_id = request.data.get('order_id')
-
-    # IDEMPOTENCY CHECK
-    existing = Payment.objects.filter(
-        paypal_order_id=order_id,
-        status='succeeded'
-    ).first()
-    if existing:
-        return Response({
-            'status': 'already_captured',
-            'payment_id': existing.id,
-            'message': 'This order has already been captured'
-        })
-
-    # ... rest of handler
-```
-
-#### 1.1.4 Add PayPal Amount Validation ✅
-
-**File:** `backend/igny8_core/business/billing/views/paypal_views.py`
-
-```python
-# In _process_credit_purchase (around line 570):
-captured_amount = Decimal(str(capture_result.get('amount', '0')))
-expected_amount = Decimal(str(package.price))
-
-if abs(captured_amount - expected_amount) > Decimal('0.01'):
-    logger.error(f"Amount mismatch: captured={captured_amount}, expected={expected_amount}")
-    return Response({
-        'error': 'Payment amount does not match expected amount',
-        'captured': str(captured_amount),
-        'expected': str(expected_amount)
-    }, status=400)
-```
-
-#### 1.1.5 Fix Refund Module Imports ✅
-
-**File:** `backend/igny8_core/business/billing/views/refund_views.py`
-
-```python
-# Replace non-existent imports (around line 160):
-# FROM:
-from igny8_core.business.billing.utils.payment_gateways import get_stripe_client
-from igny8_core.business.billing.utils.payment_gateways import get_paypal_client
-
-# TO:
-from igny8_core.business.billing.services.stripe_service import StripeService
-from igny8_core.business.billing.services.paypal_service import PayPalService
-
-# Then use:
-stripe_service = StripeService()
-stripe_service.create_refund(payment_intent_id, amount)
-```
-
----
-
-### 1.2 Simplify Registration Serializer ✅
-
-**File:** `backend/igny8_core/auth/serializers.py`
-
-**REMOVE from RegisterSerializer.create():**
-- Stripe checkout session creation
-- PayPal order creation
-- `checkout_url` return
-- `checkout_session_id` return
-- `paypal_order_id` return
-
-**KEEP:**
-- User creation
-- Account creation with `status='pending_payment'`
-- Subscription creation with `status='pending_payment'`
-- Invoice creation
-- AccountPaymentMethod creation (just store type, don't verify)
-
-**NEW create() method (simplified):**
-
-```python
-def create(self, validated_data):
-    # Extract fields
-    plan_slug = validated_data.pop('plan_slug', 'free')
-    billing_country = validated_data.pop('billing_country', '')
-
-    # Create user
-    user = User.objects.create_user(...)
-
-    # Get plan
-    plan = Plan.objects.get(slug=plan_slug, is_active=True)
-    is_paid_plan = plan.price > 0
-
-    # Create account
-    account = Account.objects.create(
-        name=validated_data.get('account_name', user.username),
-        owner=user,
-        plan=plan,
-        credits=0 if is_paid_plan else plan.included_credits,
-        status='pending_payment' if is_paid_plan else 'active',
-        billing_country=billing_country,
-    )
-
-    if is_paid_plan:
-        # Create subscription
-        subscription = Subscription.objects.create(
-            account=account,
-            plan=plan,
-            status='pending_payment',
-            current_period_start=timezone.now(),
-            current_period_end=timezone.now() + timedelta(days=30),
-        )
-
-        # Create invoice
-        InvoiceService.create_subscription_invoice(
-            subscription=subscription,
-            payment_method=None,  # Will be set when user pays
-        )
-
-    return user  # NO checkout_url returned
-```
-
-**File:** `backend/igny8_core/auth/views.py`
-
-**REMOVE from RegisterView.post():**
-- Stripe checkout session creation
-- PayPal order creation
-- `checkout_url` in response
-
-**NEW response (simplified):**
-
-```python
-def post(self, request):
-    serializer = RegisterSerializer(data=request.data)
-    serializer.is_valid(raise_exception=True)
-    user = serializer.save()
-
-    # Generate tokens
-    tokens = get_tokens_for_user(user)
-
-    return Response({
-        'success': True,
-        'user': UserSerializer(user).data,
-        'tokens': tokens,
-        # NO checkout_url - user will pay on /account/plans
-    })
-```
-
----
-
-### 1.3 Add Country List Endpoint ✅
-
-**File:** `backend/igny8_core/auth/urls.py` (NEW)
-
-```python
-class CountryListView(APIView):
-    """Returns list of countries for signup dropdown"""
-    permission_classes = []  # Public endpoint
-
-    def get(self, request):
-        countries = [
-            {'code': 'US', 'name': 'United States'},
-            {'code': 'GB', 'name': 'United Kingdom'},
-            {'code': 'CA', 'name': 'Canada'},
-            {'code': 'AU', 'name': 'Australia'},
-            {'code': 'PK', 'name': 'Pakistan'},
-            {'code': 'IN', 'name': 'India'},
-            # ... full list
-        ]
-        return Response({'countries': countries})
-```
-
-**File:** `backend/igny8_core/auth/urls.py`
-
-```python
-path('countries/', CountryListView.as_view(), name='country-list'),
-```
-
----
-
-### 1.4 Add WebhookEvent Model for Audit Trail ✅
-
-**File:** `backend/igny8_core/business/billing/models.py` (ADD)
-
-```python
-class WebhookEvent(models.Model):
-    """Store all incoming webhook events for audit and replay"""
-    event_id = models.CharField(max_length=255, unique=True)
-    provider = models.CharField(max_length=20)  # 'stripe' or 'paypal'
-    event_type = models.CharField(max_length=100)
-    payload = models.JSONField()
-    processed = models.BooleanField(default=False)
-    processed_at = models.DateTimeField(null=True, blank=True)
-    error_message = models.TextField(blank=True)
-    created_at = models.DateTimeField(auto_now_add=True)
-
-    class Meta:
-        indexes = [
-            models.Index(fields=['provider', 'event_type']),
-            models.Index(fields=['processed']),
-        ]
-```
-
----
-
-### 1.5 Add Invoice Unique Constraint ✅
-
-**Migration:** Add unique constraint to invoice_number
-
-```python
-# In Invoice model
-invoice_number = models.CharField(max_length=50, unique=True)  # Already has unique=True
-```
-
-**Update invoice_service.py** to handle IntegrityError:
-
-```python
-from django.db import IntegrityError
-
-@transaction.atomic
-def generate_invoice_number(account_id, invoice_type='SUB'):
-    prefix = f"INV-{account_id}-{invoice_type}-{timezone.now().strftime('%Y%m')}"
-
-    for attempt in range(5):
-        count = Invoice.objects.filter(
-            invoice_number__startswith=prefix
-        ).count()
-        invoice_number = f"{prefix}-{count + 1:04d}"
-
-        # Check if exists (within transaction)
-        if not Invoice.objects.filter(invoice_number=invoice_number).exists():
-            return invoice_number
-
-    raise ValueError(f"Unable to generate unique invoice number after 5 attempts")
-```
-
----
-
-### 1.6 Add Manual Reference Uniqueness ✅
-
-**Migration:**
-
-```python
-class Migration(migrations.Migration):
-    operations = [
-        migrations.AlterField(
-            model_name='payment',
-            name='manual_reference',
-            field=models.CharField(
-                max_length=255,
-                blank=True,
-                null=True,
-                unique=True,  # ADD UNIQUE
-            ),
-        ),
-    ]
-```
-
----
-
-## Phase 2: Frontend Cleanup ✅
-
-### 2.1 Simplify SignUpFormUnified.tsx ✅
-
-**File:** `frontend/src/components/auth/SignUpFormUnified.tsx`
-
-**REMOVE:** ✅
-- Payment method selection UI
-- Payment method loading from API (`/v1/billing/payment-configs/payment-methods/`)
-- Stripe checkout redirect logic
-- PayPal redirect logic
-- `isPakistanSignup` variant logic
-- All payment gateway-related state
-
-**KEEP:** ✅
-- Email, password, name fields
-- Plan selection
-- Country dropdown (NEW - replaces detection)
-
-**ADD:** ✅
-- Country dropdown with auto-detection default
-- Simplified submit that only creates account
-
-**NEW component structure:**
-
-```tsx
-export default function SignUpFormUnified() {
-  // State
-  const [formData, setFormData] = useState({
-    email: '',
-    password: '',
-    username: '',
-    first_name: '',
-    last_name: '',
-    account_name: '',
-    billing_country: '', // From dropdown
-  });
-  const [selectedPlan, setSelectedPlan] = useState<Plan | null>(null);
-  const [countries, setCountries] = useState<Country[]>([]);
-  const [detectedCountry, setDetectedCountry] = useState('US');
-
-  // Load countries and detect user's country
-  useEffect(() => {
-    loadCountries();
-    detectUserCountry();
-  }, []);
-
-  const loadCountries = async () => {
-    const response = await fetch(`${API_BASE_URL}/v1/auth/countries/`);
-    const data = await response.json();
-    setCountries(data.countries);
-  };
-
-  const detectUserCountry = async () => {
-    try {
-      // Use IP-based detection (optional - fallback to US)
-      const response = await fetch('https://ipapi.co/json/');
-      const data = await response.json();
-      setDetectedCountry(data.country_code || 'US');
-      setFormData(prev => ({ ...prev, billing_country: data.country_code || 'US' }));
-    } catch {
-      setDetectedCountry('US');
-      setFormData(prev => ({ ...prev, billing_country: 'US' }));
-    }
-  };
-
-  const handleSubmit = async (e: React.FormEvent) => {
-    e.preventDefault();
-    setLoading(true);
-
-    try {
-      // Register - NO payment redirect
-      const result = await register({
-        ...formData,
-        plan_slug: selectedPlan?.slug || 'free',
-      });
-
-      // Always navigate to plans page
-      // For paid plans: will show PendingPaymentView
-      // For free plan: will show ActiveSubscriptionView
-      if (selectedPlan && selectedPlan.price > 0) {
-        navigate('/account/plans');
-        toast.info('Complete your payment to activate your plan');
-      } else {
-        navigate('/dashboard');
-        toast.success('Welcome to IGNY8!');
-      }
-    } catch (err) {
-      setError(err.message);
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  return (
-    <form onSubmit={handleSubmit}>
-      {/* Email, Password, Name fields */}
-
-      {/* Country Dropdown - NEW */}
-      <Select
-        label="Country"
-        value={formData.billing_country}
-        onChange={(value) => setFormData({ ...formData, billing_country: value })}
-        options={countries.map(c => ({ value: c.code, label: c.name }))}
-      />
-
-      {/* Plan Selection */}
-      <PlanSelector
-        plans={plans}
-        selectedPlan={selectedPlan}
-        onSelect={setSelectedPlan}
-      />
-
-      {/* Submit Button - Different text based on plan */}
-      <Button type="submit" loading={loading}>
-        {selectedPlan?.price > 0 ? 'Continue to Payment' : 'Create Free Account'}
-      </Button>
-    </form>
-  );
-}
-```
-
----
-
-### 2.2 Remove /signup/pk Route ✅
-
-**File:** `frontend/src/routes/index.tsx` (or equivalent)
-
-**REMOVE:** ✅
-```tsx
-// DELETE THIS ROUTE
-<Route path="/signup/pk" element={<SignupPage isPakistan />} />
-```
-
-**KEEP only:** ✅
-```tsx
-<Route path="/signup" element={<SignupPage />} />
-```
-
----
-
-### 2.3 Remove Country Detection API Usage ✅
-
-**Files to update:** ✅
-- `frontend/src/components/auth/SignUpFormUnified.tsx` - Remove ipapi.co calls for complex detection
-- `frontend/src/services/billing.api.ts` - Remove `detectCountry()` function if exists
-
-**NEW approach:** Simple IP-based detection for dropdown default only: ✅
-
-```tsx
-// Simple one-liner for default selection
-const detectCountry = async () => {
-  try {
-    const res = await fetch('https://ipapi.co/country_code/');
-    return await res.text();
-  } catch {
-    return 'US';
-  }
-};
-```
-
----
-
-### 2.4 Refactor PlansAndBillingPage.tsx ✅
-
-**File:** `frontend/src/pages/account/PlansAndBillingPage.tsx`
-
-**NEW structure:** ✅
-
-```tsx
-export default function PlansAndBillingPage() {
-  const { user, refreshUser } = useAuthStore();
-  const [loading, setLoading] = useState(true);
-  const [invoices, setInvoices] = useState<Invoice[]>([]);
-  const [payments, setPayments] = useState<Payment[]>([]);
-
-  const accountStatus = user?.account?.status;
-  const billingCountry = user?.account?.billing_country;
-
-  // Determine if user has ever paid
-  const hasEverPaid = payments.some(p => p.status === 'succeeded');
-
-  // Determine view mode
-  const isNewUserPendingPayment = accountStatus === 'pending_payment' && !hasEverPaid;
-
-  useEffect(() => {
-    loadBillingData();
-  }, []);
-
-  if (loading) return <LoadingSpinner />;
-
-  // NEW USER - Show full-page payment view
-  if (isNewUserPendingPayment) {
-    return (
-      <PendingPaymentView
-        invoice={invoices.find(i => i.status === 'pending')}
-        userCountry={billingCountry}
-        onPaymentSuccess={() => {
-          refreshUser();
-          loadBillingData();
-        }}
-      />
-    );
-  }
-
-  // EXISTING USER - Show normal billing dashboard
-  return (
-    <ActiveSubscriptionView
-      user={user}
-      invoices={invoices}
-      payments={payments}
-      hasPendingInvoice={invoices.some(i => i.status === 'pending')}
-      onRefresh={loadBillingData}
-    />
-  );
-}
-```
-
----
-
-### 2.5 Create PendingPaymentView Component ✅
-
-**File:** `frontend/src/components/billing/PendingPaymentView.tsx` (NEW) ✅
-
-```tsx
-interface PendingPaymentViewProps {
-  invoice: Invoice | null;
-  userCountry: string;
-  onPaymentSuccess: () => void;
-}
-
-export default function PendingPaymentView({
-  invoice,
-  userCountry,
-  onPaymentSuccess,
-}: PendingPaymentViewProps) {
-  const isPakistan = userCountry?.toUpperCase() === 'PK';
-
-  // Payment methods based on country
-  const availableMethods: PaymentMethod[] = isPakistan
-    ? ['stripe', 'bank_transfer']
-    : ['stripe', 'paypal'];
-
-  const [selectedMethod, setSelectedMethod] = useState<PaymentMethod>(availableMethods[0]);
-  const [loading, setLoading] = useState(false);
-  const [bankDetails, setBankDetails] = useState<BankDetails | null>(null);
-
-  // Load bank details for PK users
-  useEffect(() => {
-    if (isPakistan) {
-      loadBankDetails();
-    }
-  }, [isPakistan]);
-
-  const loadBankDetails = async () => {
-    const response = await fetch(
-      `${API_BASE_URL}/v1/billing/payment-configs/payment-methods/?country_code=PK&payment_method=bank_transfer`
-    );
-    const data = await response.json();
-    if (data.results?.length > 0) {
-      setBankDetails(data.results[0]);
-    }
-  };
-
-  const handleStripePayment = async () => {
-    setLoading(true);
-    try {
-      const result = await subscribeToPlan(invoice.subscription.plan.slug, 'stripe', {
-        return_url: `${window.location.origin}/account/plans?success=true`,
-        cancel_url: `${window.location.origin}/account/plans?canceled=true`,
-      });
-      window.location.href = result.redirect_url;
-    } catch (err) {
-      toast.error(err.message);
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  const handlePayPalPayment = async () => {
-    setLoading(true);
-    try {
-      const result = await subscribeToPlan(invoice.subscription.plan.slug, 'paypal', {
-        return_url: `${window.location.origin}/account/plans?paypal=success`,
-        cancel_url: `${window.location.origin}/account/plans?paypal=cancel`,
-      });
-      window.location.href = result.redirect_url;
-    } catch (err) {
-      toast.error(err.message);
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  const handleBankTransferSubmit = async (formData: BankTransferFormData) => {
-    setLoading(true);
-    try {
-      await submitManualPayment({
-        invoice_id: invoice.id,
-        payment_method: 'bank_transfer',
-        amount: invoice.total_amount,
-        manual_reference: formData.reference,
-        manual_notes: formData.notes,
-        proof_url: formData.proofUrl,
-      });
-      toast.success('Payment submitted for approval');
-      onPaymentSuccess();
-    } catch (err) {
-      toast.error(err.message);
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  if (!invoice) {
-    return <div>No pending invoice found</div>;
-  }
-
-  return (
-    <div className="max-w-2xl mx-auto py-12 px-4">
-      {/* Header */}
-      <div className="text-center mb-8">
-        <h1 className="text-3xl font-bold text-gray-900 dark:text-white">
-          Complete Your Subscription
-        </h1>
-        <p className="mt-2 text-gray-600 dark:text-gray-400">
-          Your {invoice.subscription?.plan?.name} plan is ready to activate
-        </p>
-      </div>
-
-      {/* Invoice Summary Card */}
-      <Card className="mb-6">
-        <div className="flex justify-between items-center">
-          <div>
-            <p className="text-sm text-gray-500">Invoice</p>
-            <p className="font-medium">#{invoice.invoice_number}</p>
-          </div>
-          <div className="text-right">
-            <p className="text-sm text-gray-500">Amount Due</p>
-            <p className="text-2xl font-bold">
-              {invoice.currency} {invoice.total_amount}
-            </p>
-          </div>
-        </div>
-        <div className="mt-4 pt-4 border-t">
-          <div className="flex justify-between text-sm">
-            <span className="text-gray-500">Plan</span>
-            <span>{invoice.subscription?.plan?.name}</span>
-          </div>
-          <div className="flex justify-between text-sm mt-1">
-            <span className="text-gray-500">Billing Period</span>
-            <span>Monthly</span>
-          </div>
-        </div>
-      </Card>
-
-      {/* Payment Method Selection */}
-      <Card className="mb-6">
-        <h3 className="font-semibold mb-4">Select Payment Method</h3>
-        <div className="flex gap-3">
-          {availableMethods.map((method) => (
-            <button
-              key={method}
-              onClick={() => setSelectedMethod(method)}
-              className={`flex-1 p-4 rounded-lg border-2 transition-all ${
-                selectedMethod === method
-                  ? 'border-brand-500 bg-brand-50'
-                  : 'border-gray-200 hover:border-gray-300'
-              }`}
-            >
-              {method === 'stripe' && <CreditCardIcon className="w-6 h-6 mx-auto mb-2" />}
-              {method === 'paypal' && <WalletIcon className="w-6 h-6 mx-auto mb-2" />}
-              {method === 'bank_transfer' && <Building2Icon className="w-6 h-6 mx-auto mb-2" />}
-              <span className="block text-sm font-medium">
-                {method === 'stripe' && 'Credit/Debit Card'}
-                {method === 'paypal' && 'PayPal'}
-                {method === 'bank_transfer' && 'Bank Transfer'}
-              </span>
-            </button>
-          ))}
-        </div>
-      </Card>
-
-      {/* Payment Form */}
-      <Card>
-        {selectedMethod === 'stripe' && (
-          <div className="text-center py-6">
-            <CreditCardIcon className="w-12 h-12 mx-auto text-brand-500 mb-4" />
-            <p className="text-gray-600 mb-4">
-              Pay securely with your credit or debit card via Stripe
-            </p>
-            <Button
-              variant="primary"
-              onClick={handleStripePayment}
-              loading={loading}
-              className="w-full"
-            >
-              Pay {invoice.currency} {invoice.total_amount}
-            </Button>
-          </div>
-        )}
-
-        {selectedMethod === 'paypal' && (
-          <div className="text-center py-6">
-            <WalletIcon className="w-12 h-12 mx-auto text-[#0070ba] mb-4" />
-            <p className="text-gray-600 mb-4">
-              Pay securely with your PayPal account
-            </p>
-            <Button
-              variant="primary"
-              onClick={handlePayPalPayment}
-              loading={loading}
-              className="w-full bg-[#0070ba] hover:bg-[#005ea6]"
-            >
-              Pay with PayPal
-            </Button>
-          </div>
-        )}
-
-        {selectedMethod === 'bank_transfer' && (
-          <BankTransferForm
-            bankDetails={bankDetails}
-            invoiceNumber={invoice.invoice_number}
-            amount={`${invoice.currency} ${invoice.total_amount}`}
-            onSubmit={handleBankTransferSubmit}
-            loading={loading}
-          />
-        )}
-      </Card>
-
-      {/* Change Plan Link */}
-      <div className="mt-6 text-center">
-        <button
-          onClick={() => setShowPlanSelector(true)}
-          className="text-sm text-gray-500 hover:text-gray-700"
-        >
-          Need a different plan?
-        </button>
-      </div>
-    </div>
-  );
-}
-```
-
----
-
-### 2.6 Create ActiveSubscriptionView Component
-
-**Status:** Existing PlansAndBillingPage.tsx serves this purpose - no separate component needed.
-The current implementation now conditionally renders PendingPaymentView for new users, 
-and the full billing dashboard (effectively "ActiveSubscriptionView") for existing users.
-
-**File:** `frontend/src/pages/account/views/ActiveSubscriptionView.tsx` (NEW)
-
-This is the cleaned-up version of current PlansAndBillingPage with:
-- Proper state handling
-- Correct badge colors
-- Disabled buttons based on state
-- Payment modal only for credits and overdue invoices
-
-```tsx
-export default function ActiveSubscriptionView({
-  user,
-  invoices,
-  payments,
-  hasPendingInvoice,
-  onRefresh,
-}: ActiveSubscriptionViewProps) {
-  const accountStatus = user?.account?.status;
-  const subscription = user?.account?.subscription;
-
-  // Get subscription display
-  const getSubscriptionDisplay = () => {
-    if (!subscription) return { label: 'No Plan', tone: 'error' as const };
-
-    switch (subscription.status) {
-      case 'active':
-        return hasPendingInvoice
-          ? { label: 'Payment Due', tone: 'warning' as const }
-          : { label: 'Active', tone: 'success' as const };
-      case 'pending_payment':
-        return { label: 'Awaiting Payment', tone: 'warning' as const };
-      case 'past_due':
-        return { label: 'Payment Overdue', tone: 'error' as const };
-      case 'canceled':
-        return { label: 'Cancels Soon', tone: 'warning' as const };
-      default:
-        return { label: subscription.status, tone: 'neutral' as const };
-    }
-  };
-
-  const statusDisplay = getSubscriptionDisplay();
-
-  // Can user perform actions?
-  const canUpgrade = accountStatus === 'active' && !hasPendingInvoice;
-  const canBuyCredits = accountStatus === 'active' && !hasPendingInvoice;
-  const canCancel = accountStatus === 'active' && !hasPendingInvoice;
-  const canManageBilling = user?.account?.stripe_customer_id && canUpgrade;
-
-  return (
-    <div className="space-y-6">
-      {/* Pending Payment Banner for existing users */}
-      {hasPendingInvoice && (
-        <Alert variant="warning">
-          <div className="flex items-center justify-between">
-            <div>
-              <p className="font-medium">Payment Required</p>
-              <p className="text-sm">Complete your payment to continue using all features</p>
-            </div>
-            <Button
-              variant="primary"
-              size="sm"
-              onClick={() => setShowPaymentModal(true)}
-            >
-              Pay Now
-            </Button>
-          </div>
-        </Alert>
-      )}
-
-      {/* Current Plan Card */}
-      <Card>
-        <div className="flex items-center justify-between">
-          <div>
-            <h2 className="text-lg font-semibold">{user?.account?.plan?.name}</h2>
-            <Badge variant="solid" tone={statusDisplay.tone}>
-              {statusDisplay.label}
-            </Badge>
-          </div>
-          <div className="flex gap-2">
-            {canManageBilling && (
-              <Button variant="outline" onClick={handleManageBilling}>
-                Manage Billing
-              </Button>
-            )}
-            {canUpgrade && (
-              <Button variant="primary" onClick={() => setShowUpgradeModal(true)}>
-                Upgrade
-              </Button>
-            )}
-          </div>
-        </div>
-      </Card>
-
-      {/* Credits Card */}
-      <Card>
-        <div className="flex items-center justify-between">
-          <div>
-            <p className="text-sm text-gray-500">Credit Balance</p>
-            <p className="text-2xl font-bold">{user?.account?.credits?.toLocaleString()}</p>
-          </div>
-          {canBuyCredits && (
-            <Button variant="outline" onClick={() => setShowCreditsModal(true)}>
-              Buy Credits
-            </Button>
-          )}
-        </div>
-      </Card>
-
-      {/* Billing History */}
-      <Card>
-        <h3 className="font-semibold mb-4">Billing History</h3>
-        <InvoiceTable invoices={invoices} />
-      </Card>
-
-      {/* Cancel Subscription - only for active paid users */}
-      {canCancel && subscription && (
-        <div className="text-center">
-          <button
-            onClick={() => setShowCancelModal(true)}
-            className="text-sm text-gray-500 hover:text-error-500"
-          >
-            Cancel Subscription
-          </button>
-        </div>
-      )}
-
-      {/* Modals */}
-      <PayInvoiceModal
-        isOpen={showPaymentModal}
-        onClose={() => setShowPaymentModal(false)}
-        invoice={invoices.find(i => i.status === 'pending')}
-        userCountry={user?.account?.billing_country}
-        onSuccess={onRefresh}
-      />
-
-      <BuyCreditsModal
-        isOpen={showCreditsModal}
-        onClose={() => setShowCreditsModal(false)}
-        userCountry={user?.account?.billing_country}
-        onSuccess={onRefresh}
-      />
-    </div>
-  );
-}
-```
-
----
-
-### 2.7 Update BankTransferForm to Load Details from Backend ✅
-
-**File:** `frontend/src/components/billing/BankTransferForm.tsx` ✅
-
-**REMOVE:** Hardcoded bank details ✅
-
-**ADD:** Props for bank details from parent: ✅
-
-```tsx
-interface BankTransferFormProps {
-  bankDetails: {
-    bank_name: string;
-    account_title: string;
-    account_number: string;
-    iban: string;
-    swift_code: string;
-  } | null;
-  invoiceNumber: string;
-  amount: string;
-  onSubmit: (data: BankTransferFormData) => void;
-  loading: boolean;
-}
-
-export default function BankTransferForm({
-  bankDetails,
-  invoiceNumber,
-  amount,
-  onSubmit,
-  loading,
-}: BankTransferFormProps) {
-  if (!bankDetails) {
-    return <LoadingSpinner />;
-  }
-
-  return (
-    <div className="space-y-4">
-      {/* Bank Details - FROM BACKEND */}
-      <div className="p-4 bg-blue-50 rounded-lg">
-        <h4 className="font-medium mb-2">Bank Transfer Details</h4>
-        <div className="text-sm space-y-1">
-          <p><span className="font-medium">Bank:</span> {bankDetails.bank_name}</p>
-          <p><span className="font-medium">Account Title:</span> {bankDetails.account_title}</p>
-          <p><span className="font-medium">Account #:</span> {bankDetails.account_number}</p>
-          <p><span className="font-medium">IBAN:</span> {bankDetails.iban}</p>
-          <p><span className="font-medium">Reference:</span> {invoiceNumber}</p>
-          <p><span className="font-medium">Amount:</span> {amount}</p>
-        </div>
-      </div>
-
-      {/* Form fields */}
-      {/* ... */}
-    </div>
-  );
-}
-```
-
----
-
-### 2.8 Remove PendingPaymentBanner.tsx
-
-**File:** `frontend/src/components/billing/PendingPaymentBanner.tsx`
-
-**ACTION:** KEPT - Still useful for showing on other pages (dashboard, etc.)
-The full-page `PendingPaymentView` replaces this for the /account/plans page when dealing with new users.
-For existing users with missed payments, the banner can still appear on other pages.
-
----
-
-### 2.9 Clean Up billing.api.ts ✅
-
-**File:** `frontend/src/services/billing.api.ts`
-
-**REMOVE:**
-- `detectCountry()` function if exists - ✅ Not found (never existed)
-- Any unused payment config functions
-
-**KEEP:** ✅
-- All gateway functions (Stripe, PayPal)
-- Invoice/Payment CRUD
-- `subscribeToPlan()` and `purchaseCredits()` helpers
-
----
-
-### 2.10 Clean Up authStore.ts ✅
-
-**File:** `frontend/src/store/authStore.ts`
-
-**UPDATE register() to NOT expect checkout_url:** ✅
-
-```tsx
-register: async (registerData) => {
-  const response = await fetch(`${API_BASE_URL}/v1/auth/register/`, {
-    method: 'POST',
-    body: JSON.stringify({
-      email: registerData.email,
-      password: registerData.password,
-      username: registerData.username,
-      first_name: registerData.first_name,
-      last_name: registerData.last_name,
-      account_name: registerData.account_name,
-      plan_slug: registerData.plan_slug,
-      billing_country: registerData.billing_country,
-    }),
-  });
-
-  const data = await response.json();
-
-  if (!response.ok) {
-    throw new Error(data.error || 'Registration failed');
-  }
-
-  // Set auth state
-  set({
-    user: data.user,
-    token: data.tokens.access,
-    refreshToken: data.tokens.refresh,
-    isAuthenticated: true,
-  });
-
-  return data.user;  // NO checkout_url
-}
-```
-
----
-
-## Phase 3: Remove Dead Code & Fields ✅
-
-### 3.1 Backend - Remove Unused Fields
-
-**File:** `backend/igny8_core/auth/models.py`
-
-Consider removing if truly unused (verify first):
-- Any temporary migration fields
-
-**Status:** Deferred - no critical dead code identified
-
-### 3.2 Backend - Clean Up Unused Code in RegisterSerializer ✅
-
-**File:** `backend/igny8_core/auth/urls.py`
-
-**REMOVE:** ✅
-- Stripe checkout session creation code - REMOVED
-- PayPal order creation code - REMOVED
-- All `checkout_url` generation logic - REMOVED
-
-### 3.3 Frontend - Remove Files ✅
-
-**DELETE these files:**
-- `frontend/src/pages/AuthPages/SignUpPK.tsx` - ✅ DELETED
-- Any country detection utility files - None found
-
-**Status:** SignUpPK.tsx deleted successfully
-
-### 3.4 Frontend - Remove Unused Routes ✅
-
-**File:** Routes configuration
-
-**REMOVE:** ✅
-```tsx
-<Route path="/signup/pk" ... />
-```
-**Done:** Route now redirects to main SignUp component
-
----
-
-## Phase 4: Database Migrations ✅
-
-### 4.1 Create Migration for WebhookEvent Model ✅
-
-```bash
-python manage.py makemigrations billing --name add_webhook_event_model
-python manage.py migrate
-```
-
-**Done:** Migration 0029_add_webhook_event_and_manual_reference_constraint applied
-
-### 4.2 Create Migration for Manual Reference Uniqueness ✅
-
-```bash
-python manage.py makemigrations billing --name make_manual_reference_unique
-python manage.py migrate
-```
-
-**Done:** Included in migration 0029
-
----
-
-## Phase 5: Testing Checklist (Manual Testing Required)
-
-### 5.1 Signup Flow Tests
-
-- [ ] Signup with free plan → redirects to dashboard/sites
-- [ ] Signup with paid plan → redirects to /account/plans
-- [ ] Signup page shows country dropdown with auto-detection
-- [ ] Country dropdown shows all countries from backend
-- [ ] No payment method selection on signup page
-
-### 5.2 PendingPaymentView Tests (New Users)
-
-- [ ] Shows for new user with `pending_payment` status
-- [ ] Shows correct invoice details and plan name
-- [ ] Shows Stripe + PayPal for global users
-- [ ] Shows Stripe + Bank Transfer for PK users
-- [ ] Stripe payment redirects and returns correctly
-- [ ] PayPal payment redirects and returns correctly
-- [ ] Bank transfer form submits correctly
-- [ ] Bank details loaded from backend (not hardcoded)
-
-### 5.3 ActiveSubscriptionView Tests (Existing Users)
-
-- [ ] Shows for users who have paid before
-- [ ] Shows pending payment banner if invoice overdue
-- [ ] Upgrade button disabled when payment pending
-- [ ] Cancel button only shows for active subscriptions
-- [ ] Manage Billing only shows for Stripe users
-- [ ] Credit purchase works via modal
-- [ ] Invoice payment works via modal
-
-### 5.4 Webhook Tests
-
-- [ ] Stripe webhook processes only once (idempotency)
-- [ ] PayPal webhook validates signature
-- [ ] PayPal capture only processes once (idempotency)
-- [ ] PayPal amount validation catches mismatches
-- [ ] Webhook events stored in WebhookEvent model
-
-### 5.5 Security Tests
-
-- [ ] Invalid PayPal webhook signature returns 400
-- [ ] Duplicate Stripe webhook doesn't create duplicate payment
-- [ ] Duplicate PayPal capture returns already_captured response
-- [ ] Amount manipulation in PayPal returns error
-
----
-
-## Implementation Order
-
-### Day 1: Backend Security Fixes
-1. Enable PayPal webhook signature verification
-2. Add Stripe webhook idempotency
-3. Add PayPal capture idempotency
-4. Add PayPal amount validation
-5. Fix refund module imports
-6. Add WebhookEvent model
-7. Run migrations
-
-### Day 2: Backend Simplification
-1. Simplify RegisterSerializer (remove checkout creation)
-2. Simplify RegisterView (remove checkout_url response)
-3. Add CountryListView endpoint
-4. Add manual_reference uniqueness migration
-5. Test registration flow
-
-### Day 3: Frontend Signup Simplification
-1. Simplify SignUpFormUnified.tsx
-2. Remove /signup/pk route
-3. Update authStore register function
-4. Test signup flow for all plans
-
-### Day 4: Frontend Plans Page Refactor
-1. Create PendingPaymentView component
-2. Create ActiveSubscriptionView component
-3. Refactor PlansAndBillingPage to use new views
-4. Update BankTransferForm to use backend details
-5. Test new user payment flow
-
-### Day 5: Cleanup & Testing
-1. Remove PendingPaymentBanner (or repurpose)
-2. Clean up billing.api.ts
-3. Remove dead code
-4. Full integration testing
-5. Update documentation
-
----
-
-## Files Changed Summary
-
-### Backend Files to Modify
-| File | Changes |
-|------|---------|
-| `views/paypal_views.py` | Enable signature verification, add idempotency, add amount validation |
-| `views/stripe_views.py` | Add idempotency check |
-| `views/refund_views.py` | Fix imports |
-| `models.py` | Add WebhookEvent model |
-| `auth/serializers.py` | Remove checkout creation |
-| `auth/views.py` | Remove checkout_url, add CountryListView |
-| `auth/urls.py` | Add countries/ endpoint |
-
-### Backend Migrations
-| Migration | Purpose |
-|-----------|---------|
-| `add_webhook_event_model` | Audit trail for webhooks |
-| `make_manual_reference_unique` | Prevent duplicate references |
-
-### Frontend Files to Modify
-| File | Changes |
-|------|---------|
-| `SignUpFormUnified.tsx` | Remove payment selection, add country dropdown |
-| `PlansAndBillingPage.tsx` | Refactor to use new view components |
-| `authStore.ts` | Remove checkout_url handling |
-| `billing.api.ts` | Clean up unused functions |
-
-### Frontend Files to Create
-| File | Purpose |
-|------|---------|
-| `views/PendingPaymentView.tsx` | Full-page payment for new users |
-| `views/ActiveSubscriptionView.tsx` | Dashboard for existing users |
-| `components/BankTransferForm.tsx` | Reusable bank transfer form |
-
-### Frontend Files to Delete
-| File | Reason |
-|------|--------|
-| Route for `/signup/pk` | Consolidated into single signup |
-| `PendingPaymentBanner.tsx` | Replaced by PendingPaymentView (optional - may keep for other pages) |
-
----
-
-## Verification Commands
-
-### Backend Verification
-
-```bash
-# Test Stripe config
-curl http://localhost:8000/v1/billing/stripe/config/ -H "Authorization: Bearer $TOKEN"
-
-# Test PayPal config
-curl http://localhost:8000/v1/billing/paypal/config/ -H "Authorization: Bearer $TOKEN"
-
-# Test country list
-curl http://localhost:8000/v1/auth/countries/
-
-# Test registration (no checkout_url in response)
-curl -X POST http://localhost:8000/v1/auth/register/ \
-  -H "Content-Type: application/json" \
-  -d '{"email":"test@test.com","password":"test123","plan_slug":"starter","billing_country":"US"}'
-```
-
-### Frontend Verification
-
-```bash
-# Build check
-npm run build
-
-# Type check
-npm run typecheck
-
-# Lint
-npm run lint
-```
-
----
-
-## Success Criteria
-
-1. **Signup flow simplified** - No payment redirect from signup
-2. **Single payment interface** - All payments through /account/plans
-3. **Security issues fixed** - Webhook verification, idempotency
-
----
-
-# 🚨 CRITICAL ISSUES AFTER REFACTOR
-
-## 🔴 **NEW CRITICAL BUGS INTRODUCED IN RECENT REFACTORS**
-
-### Issue #1: Payment Gateway Country Filtering Broken
-
-| # | Severity | Issue | Location | Line |
-|---|----------|-------|----------|------|
-| 1 | 🔴 CRITICAL | `getAvailablePaymentGateways()` called **without country code** - returns PayPal for ALL users including PK | PlansAndBillingPage.tsx | ~251 |
-| 2 | 🔴 CRITICAL | `getAvailablePaymentGateways()` called **without country code** in PaymentGatewaySelector | PaymentGatewaySelector.tsx | - |
-| 3 | 🔴 CRITICAL | `availableGateways` initialized with `manual: true` (Bank Transfer shows for ALL users by default) | PlansAndBillingPage.tsx | - |
-| 4 | 🔴 CRITICAL | PayPal button visible in Buy Credits section for PK users | PlansAndBillingPage.tsx | - |
-| 5 | 🔴 CRITICAL | PayPal button visible in Upgrade Modal for PK users | PlansAndBillingPage.tsx | - |
-| 6 | 🔴 CRITICAL | Bank Transfer button visible in Upgrade Modal for NON-PK users | PlansAndBillingPage.tsx | - |
-
-**Root Cause:**
-```tsx
-// CURRENT (BROKEN) - Line ~251:
-const gateways = await getAvailablePaymentGateways();
-
-// SHOULD BE:
-const billingCountry = user?.account?.billing_country || 'US';
-const gateways = await getAvailablePaymentGateways(billingCountry);
-```
-
-**Impact:** 
-- PK users can see and attempt PayPal payments (NOT ALLOWED)
-- Non-PK users see Bank Transfer option (WRONG)
-- Payment method selection doesn't respect country restrictions
-
----
-
-### Issue #2: Stripe Return Flow Broken After Refactor
-
-**Status:** 🔴 **BROKEN** - Payments not activating accounts
-
-**Evidence:**
-- User completes payment on Stripe
-- Stripe redirects to `/account/plans?success=true`
-- Invoice remains `status='pending'`
-- Account remains `status='pending_payment'`
-- Notification shows "payment successful" but account not activated
-
-**Root Cause:**
-1. Frontend redirect URL changed from `/plans` to `/account/plans`
-2. No backend endpoint to handle return URL verification
-3. Relies entirely on webhook which may be delayed
-4. Frontend has no way to force-check payment status
-
-**Missing Flow:**
-```
-User Returns → Check URL params → ❌ NO BACKEND CALL
-                                 → ❌ No status verification
-                                 → Shows old cached status
-```
-
-**Should Be:**
-```
-User Returns → Extract session_id from URL 
-            → Call /v1/billing/verify-payment-status/?session_id=xxx
-            → Backend checks with Stripe
-            → Return updated account/subscription status
-            → Refresh UI
-```
-
----
-
-### Issue #3: PayPal Return Flow Broken After Refactor
-
-**Status:** 🔴 **BROKEN** - "Payment not captured" error
-
-**Evidence:**
-- User approves payment on PayPal
-- PayPal redirects to `/account/plans?paypal=success&token=xxx`
-- Frontend shows "Payment not captured" error
-- Order remains uncaptured
-
-**Root Cause:**
-1. Frontend expects to call `/v1/billing/paypal/capture-order/` on return
-2. But `order_id` is not in URL params (PayPal uses `token` param)
-3. Capture endpoint requires `order_id` not `token`
-4. Mismatch between PayPal redirect params and capture endpoint
-
-**Current Broken Flow:**
-```
-PayPal Redirect → ?paypal=success&token=EC-xxx
-                → Frontend tries to extract order_id
-                → ❌ No order_id in URL
-                → ❌ Capture fails
-```
-
-**Should Be:**
-```
-PayPal Redirect → ?paypal=success&token=EC-xxx
-                → Frontend stores order_id before redirect
-                → On return, retrieve order_id from storage
-                → Call capture with correct order_id
-```
-
----
-
-### Issue #4: Invoice Currency Mismatch
-
-| # | Severity | Issue | Location |
-|---|----------|-------|----------|
-| 7 | 🟡 HIGH | Buy Credits always shows `$` (USD) even for PK users using Bank Transfer (should show PKR) | PlansAndBillingPage.tsx |
-| 8 | 🟡 HIGH | Quick Upgrade cards always show `$` (USD) for all users | PlansAndBillingPage.tsx |
-| 9 | 🟡 HIGH | Upgrade Modal shows `$` for all plans even when Bank Transfer (PKR) selected | PlansAndBillingPage.tsx |
-| 10 | 🟢 MEDIUM | Invoice created with currency depends on `account.payment_method` which may not be set at signup | invoice_service.py |
-
-**Root Cause:**
-- Invoice currency determined at creation time based on `account.payment_method`
-- At signup, `account.payment_method` may not be set
-- Frontend hardcodes `$` symbol
-- No dynamic currency switching based on selected gateway
-
----
-
-### Issue #5: "Manage Billing" Logic Error
-
-| # | Severity | Issue | Location |
-|---|----------|-------|----------|
-| 11 | 🟡 HIGH | "Manage Billing" shows for users with Stripe available, not users who **paid via Stripe** | PlansAndBillingPage.tsx |
-
-**Root Cause:**
-```tsx
-// CURRENT (WRONG):
-const canManageBilling = availableGateways.stripe && hasActivePlan;
-
-// SHOULD BE:
-const canManageBilling = user?.account?.payment_method === 'stripe' 
-                      && user?.account?.stripe_customer_id
-                      && hasActivePlan;
-```
-
-**Impact:** 
-- PK users who paid via Bank Transfer see "Manage Billing" button
-- Clicking it tries to redirect to Stripe portal (which doesn't exist for them)
-
----
-
-### Issue #6: Plan Status Display Logic Error
-
-| # | Audit Issue | Claimed Status | Actual Status |
-|---|-------------|----------------|---------------|
-| 1 | Plan shows "Active" even with unpaid invoice | ✅ Claimed fixed | ❌ Still using `hasActivePlan` based on plan existence only |
-| 2 | "Manage Billing" shown to non-Stripe users | ✅ Claimed fixed | ❌ Shows for anyone with `availableGateways.stripe` |
-| 3 | Cancel Subscription available when account pending | ✅ Claimed fixed | ❌ Logic not properly implemented |
-| 4 | Payment gateway selection not synced with account | ✅ Claimed fixed | ❌ Gateway determined without country |
-
-**Root Cause:**
-```tsx
-// CURRENT (WRONG):
-const hasActivePlan = !!user?.account?.plan && user?.account?.plan?.slug !== 'free';
-
-// SHOULD CHECK:
-const hasActivePlan = user?.account?.status === 'active' 
-                   && user?.account?.plan?.slug !== 'free'
-                   && !hasPendingInvoice;
-```
-
----
-
-### Issue #7: Backend Payment Method Endpoint Returns Wrong Data
-
-| # | Severity | Issue | Location |
-|---|----------|-------|----------|
-| 12 | 🟢 MEDIUM | Backend `list_payment_methods` endpoint returns ALL enabled methods ignoring country_code | billing_views.py |
-
-**Evidence:**
-```python
-# Current endpoint ignores country filtering
-def list_payment_methods(request):
-    methods = PaymentMethodConfig.objects.filter(is_enabled=True)
-    # ❌ No country-based filtering
-    return Response(methods)
-```
-
-**Should Be:**
-```python
-def list_payment_methods(request):
-    country = request.query_params.get('country_code', 'US')
-    methods = PaymentMethodConfig.objects.filter(
-        is_enabled=True,
-        country_code=country
-    )
-    return Response(methods)
-```
-
----
-
-## 🔴 **CRITICAL: Payment Return Flows NOT WORKING**
-
-### Stripe Return Flow - BROKEN ❌
-
-**Current State:**
-```
-User pays on Stripe
-    ↓
-Stripe redirects to: /account/plans?success=true&session_id=cs_xxx
-    ↓
-Frontend PlansAndBillingPage loads
-    ↓
-❌ NO API CALL to verify payment
-    ↓
-Shows cached user data (still pending_payment)
-    ↓
-User sees "Complete your payment" (even though they just paid)
-    ↓
-Webhook eventually fires (5-30 seconds later)
-    ↓
-Page doesn't auto-refresh
-    ↓
-User must manually refresh to see activation
-```
-
-**What's Missing:**
-1. No `/v1/billing/verify-stripe-return/` endpoint
-2. Frontend doesn't extract `session_id` from URL
-3. No status polling/refresh mechanism
-4. No loading state while verification happens
-
----
-
-### PayPal Return Flow - BROKEN ❌
-
-**Current State:**
-```
-User approves on PayPal
-    ↓
-PayPal redirects to: /account/plans?paypal=success&token=EC-xxx&PayerID=yyy
-    ↓
-Frontend tries to capture payment
-    ↓
-❌ Can't find order_id (only has token)
-    ↓
-Capture API call fails
-    ↓
-Shows error: "Payment not captured"
-    ↓
-User stuck with pending payment
-```
-
-**What's Missing:**
-1. `order_id` not persisted before redirect
-2. No mapping from `token` → `order_id`
-3. Capture endpoint can't proceed without `order_id`
-
----
-
-### Bank Transfer Flow - Working ✅
-
-**Current State:** (This one works correctly)
-```
-User submits bank transfer proof
-    ↓
-POST /v1/billing/payments/manual/
-    ↓
-Creates Payment record (status=pending)
-    ↓
-Admin approves payment
-    ↓
-Account activated
-    ↓
-✅ Works as expected
-```
-
----
-
-## 📊 COMPLETE END-TO-END PAYMENT WORKFLOW DIAGRAMS
-
-### 🔵 STRIPE FLOW - US/GLOBAL USERS (Subscription)
-
-```
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 1: SIGNUP                                  │
-└────────────────────────────────────────────────────────────────────┘
-
-User visits /signup
-    ↓
-Fills form: email, password, name, country=US, plan=Starter ($29/mo)
-    ↓
-Clicks "Create Account"
-    ↓
-POST /v1/auth/register/
-    └─> Body: {
-            email, password, username,
-            billing_country: 'US',
-            plan_slug: 'starter'
-        }
-
-BACKEND ACTIONS:
-    1. Create User
-    2. Create Account (status='pending_payment', plan=Starter, credits=0)
-    3. Create Subscription (status='pending_payment')
-    4. Create Invoice (status='pending', currency='USD', amount=29.00)
-    5. Return: { user, tokens, ... }  // ❌ NO checkout_url
-
-Frontend redirects to → /account/plans
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 2: PAYMENT PAGE                            │
-└────────────────────────────────────────────────────────────────────┘
-
-/account/plans loads
-    ↓
-Checks: accountStatus='pending_payment' && hasEverPaid=false
-    ↓
-Shows PendingPaymentView
-    ↓
-Displays Invoice #INV-260100001, Amount: $29.00
-    ↓
-Payment methods: [Stripe ✅, PayPal ✅]  (country=US)
-    ↓
-User selects Stripe
-    ↓
-Clicks "Pay $29.00"
-    ↓
-
-POST /v1/billing/stripe/subscribe/
-    └─> Body: {
-            plan_slug: 'starter',
-            payment_method: 'stripe',
-            return_url: 'http://localhost:5173/account/plans?success=true',
-            cancel_url: 'http://localhost:5173/account/plans?canceled=true'
-        }
-
-BACKEND ACTIONS (stripe_views.py - StripeSubscribeView):
-    1. Get plan, account
-    2. Create Stripe Checkout Session
-       - mode: 'subscription'
-       - line_items: [{ price: plan.stripe_price_id, quantity: 1 }]
-       - customer_email: user.email
-       - metadata: { account_id, plan_id, type: 'subscription' }
-       - success_url: return_url
-       - cancel_url: cancel_url
-    3. Return { redirect_url: session.url }
-
-Frontend redirects to → session.url (Stripe hosted page)
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 3: STRIPE PAYMENT                          │
-└────────────────────────────────────────────────────────────────────┘
-
-User on Stripe page
-    ↓
-Enters card details
-    ↓
-Clicks "Pay"
-    ↓
-Stripe processes payment
-    ↓
-Payment succeeds
-    ↓
-Stripe redirects to → /account/plans?success=true&session_id=cs_xxx
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 4: RETURN TO APP (❌ BROKEN)              │
-└────────────────────────────────────────────────────────────────────┘
-
-Browser lands on /account/plans?success=true&session_id=cs_xxx
-    ↓
-PlansAndBillingPage.tsx loads
-    ↓
-useEffect runs → loadBillingData()
-    ↓
-❌ BUG: No code to check URL params for session_id
-❌ BUG: No API call to verify payment status
-❌ BUG: Just loads user data from cache/API (still shows pending)
-    ↓
-User sees: "Complete Your Subscription" (same pending view)
-    ↓
-User confused: "I just paid!"
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 5: WEBHOOK (5-30 SEC LATER)               │
-└────────────────────────────────────────────────────────────────────┘
-
-Stripe sends webhook → POST /v1/billing/stripe/webhook/
-    └─> Event: checkout.session.completed
-
-BACKEND ACTIONS (stripe_views.py - _handle_checkout_completed):
-    ✅ 1. Idempotency check - session_id in Payment.metadata
-    ✅ 2. Get account from metadata
-    ✅ 3. Retrieve Stripe subscription details
-    ✅ 4. Create/Update Subscription record:
-          - status = 'active'
-          - stripe_subscription_id = 'sub_xxx'
-          - current_period_start, current_period_end
-    ✅ 5. Get or create Invoice (prevents duplicates)
-    ✅ 6. Mark Invoice as PAID:
-          - status = 'paid'
-          - paid_at = now
-    ✅ 7. Create Payment record:
-          - status = 'succeeded'
-          - approved_at = now
-          - stripe_payment_intent_id
-          - metadata: { checkout_session_id, subscription_id }
-    ✅ 8. Create/Update AccountPaymentMethod:
-          - type = 'stripe'
-          - is_verified = True
-          - is_default = True
-    ✅ 9. Add credits:
-          - CreditService.add_credits(account, plan.included_credits)
-    ✅ 10. Update Account:
-          - status = 'active'
-          - plan = plan
-    ❌ 11. NO email sent
-    ❌ 12. NO real-time notification to frontend
-
-Returns 200 to Stripe
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 6: USER EXPERIENCE                         │
-└────────────────────────────────────────────────────────────────────┘
-
-User still on /account/plans
-    ↓
-Page shows pending payment (cached data)
-    ↓
-❌ Page doesn't auto-refresh
-❌ No websocket notification
-    ↓
-User must MANUALLY refresh page
-    ↓
-On refresh: loadBillingData() fetches new status
-    ↓
-NOW shows: Active plan, credits added
-    ↓
-✅ Finally works after manual refresh
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    CURRENT BUGS SUMMARY                             │
-└────────────────────────────────────────────────────────────────────┘
-
-🔴 CRITICAL BUGS:
-1. No payment verification on return URL
-2. User sees pending state after successful payment
-3. Requires manual refresh to see activation
-4. No loading/polling state
-5. Poor UX - user thinks payment failed
-
-✅ WORKING CORRECTLY:
-1. Webhook processing
-2. Account activation
-3. Credit addition
-4. Subscription creation
-5. Invoice marking as paid
-```
-
----
-
-### 🟡 PAYPAL FLOW - US/GLOBAL USERS (Subscription)
-
-```
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 1-2: SAME AS STRIPE                        │
-└────────────────────────────────────────────────────────────────────┘
-
-(User signup, account creation, redirect to /account/plans)
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 3: PAYPAL ORDER CREATION                   │
-└────────────────────────────────────────────────────────────────────┘
-
-User on /account/plans (PendingPaymentView)
-    ↓
-Selects PayPal
-    ↓
-Clicks "Pay with PayPal"
-    ↓
-
-POST /v1/billing/paypal/subscribe/
-    └─> Body: {
-            plan_slug: 'starter',
-            payment_method: 'paypal',
-            return_url: 'http://localhost:5173/account/plans?paypal=success',
-            cancel_url: 'http://localhost:5173/account/plans?paypal=cancel'
-        }
-
-BACKEND ACTIONS (paypal_views.py - PayPalSubscribeView):
-    1. Get plan, account
-    2. Create PayPal Order:
-       - intent: 'CAPTURE'
-       - purchase_units: [{
-           amount: { currency_code: 'USD', value: '29.00' },
-           custom_id: account.id,
-           description: plan.name
-         }]
-       - application_context: {
-           return_url: return_url,
-           cancel_url: cancel_url
-         }
-    3. Extract order_id from response
-    4. Extract approve link from response.links
-    5. ❌ BUG: order_id NOT stored anywhere for later retrieval
-    6. Return { redirect_url: approve_link }
-
-Frontend:
-    ❌ BUG: Doesn't store order_id before redirect
-    Redirects to → approve_link (PayPal page)
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 4: PAYPAL APPROVAL                         │
-└────────────────────────────────────────────────────────────────────┘
-
-User on PayPal page
-    ↓
-Logs in to PayPal
-    ↓
-Clicks "Approve"
-    ↓
-PayPal redirects to → /account/plans?paypal=success&token=EC-xxx&PayerID=yyy
-    ↓
-❌ BUG: URL has 'token', not 'order_id'
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 5: CAPTURE ATTEMPT (❌ BROKEN)            │
-└────────────────────────────────────────────────────────────────────┘
-
-Browser lands on /account/plans?paypal=success&token=EC-xxx
-    ↓
-PlansAndBillingPage.tsx detects ?paypal=success
-    ↓
-Tries to extract order_id from URL params
-    ↓
-❌ BUG: URL has 'token=EC-xxx', not 'order_id'
-❌ BUG: No code to convert token → order_id
-❌ BUG: No stored order_id from Phase 3
-    ↓
-Calls POST /v1/billing/paypal/capture-order/
-    └─> Body: { order_id: undefined }  // ❌ MISSING
-    ↓
-Backend returns 400: "order_id required"
-    ↓
-Frontend shows: "Payment not captured"
-    ↓
-User stuck with pending payment
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    WHAT SHOULD HAPPEN (IF WORKING)                  │
-└────────────────────────────────────────────────────────────────────┘
-
-Frontend should:
-    1. Store order_id in localStorage before redirect
-    2. On return, retrieve order_id from localStorage
-    3. Call capture with correct order_id
-
-OR:
-
-Backend should:
-    1. Accept token parameter
-    2. Look up order_id from token via PayPal API
-    3. Then proceed with capture
-
-CAPTURE FLOW (paypal_views.py - PayPalCaptureOrderView):
-    ✅ 1. Idempotency check - order_id already captured
-    ✅ 2. Call PayPal API to capture order
-    ✅ 3. Extract payment type from metadata
-    ✅ 4. If subscription:
-          - _process_subscription_payment()
-          - Create Subscription (status='active')
-          - Create Invoice
-          - Mark Invoice paid
-          - Create Payment record
-          - Create AccountPaymentMethod (type='paypal')
-          - Add credits
-          - Activate account
-    ✅ 5. Return success
-
-But currently this never executes due to missing order_id.
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    CURRENT BUGS SUMMARY                             │
-└────────────────────────────────────────────────────────────────────┘
-
-🔴 CRITICAL BUGS:
-1. order_id not persisted before redirect
-2. Return URL has 'token', not 'order_id'
-3. No token → order_id mapping
-4. Capture fails completely
-5. Payment left uncaptured on PayPal
-6. User sees error and can't complete signup
-
-❌ COMPLETELY BROKEN - PayPal payments don't work
-```
-
----
-
-### 🟢 BANK TRANSFER FLOW - PAKISTAN USERS
-
-```
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 1-2: SAME AS STRIPE                        │
-└────────────────────────────────────────────────────────────────────┘
-
-User signup with country=PK, plan=Starter
-    ↓
-Account created (status='pending_payment')
-    ↓
-Invoice created (currency='PKR', amount=8,499.00)
-    ↓
-Redirect to /account/plans
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 3: BANK TRANSFER FORM                      │
-└────────────────────────────────────────────────────────────────────┘
-
-/account/plans loads
-    ↓
-Shows PendingPaymentView
-    ↓
-Payment methods: [Stripe ✅, Bank Transfer ✅]  (country=PK)
-    ↓
-❌ BUG: May also show PayPal if country not passed correctly
-    ↓
-User selects Bank Transfer
-    ↓
-
-Loads bank details via GET /v1/billing/payment-configs/payment-methods/?country_code=PK&payment_method=bank_transfer
-    ↓
-Backend returns:
-    {
-        bank_name: "HBL",
-        account_title: "IGNY8 Platform",
-        account_number: "12345678",
-        iban: "PK36HABB0012345678901234",
-        swift_code: "HABBPKKA",
-        instructions: "..."
-    }
-    ↓
-Displays bank details to user
-    ↓
-User transfers PKR 8,499 to bank account
-    ↓
-User fills form:
-    - Transaction Reference: TRX123456
-    - Upload proof (receipt image)
-    - Notes: "Paid from account ending 9876"
-    ↓
-Clicks "Submit Payment Proof"
-    ↓
-
-POST /v1/billing/payments/manual/
-    └─> Body: {
-            invoice_id: <invoice_id>,
-            payment_method: 'bank_transfer',
-            amount: 8499.00,
-            manual_reference: 'TRX123456',
-            manual_notes: '...',
-            proof_url: 'https://...'
-        }
-
-BACKEND ACTIONS (billing_views.py):
-    ✅ 1. Get invoice
-    ✅ 2. Create Payment record:
-          - status = 'pending'  (awaiting admin approval)
-          - payment_method = 'bank_transfer'
-          - manual_reference = 'TRX123456'
-          - manual_proof_url = proof
-          - approved_at = None
-          - approved_by = None
-    ✅ 3. Return success
-    ❌ 4. NO email to admin
-    ❌ 5. NO email to user
-
-Frontend shows: "Payment submitted for approval"
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 4: ADMIN APPROVAL                          │
-└────────────────────────────────────────────────────────────────────┘
-
-Admin logs into Django Admin
-    ↓
-Navigates to Payments
-    ↓
-Sees Payment (status='pending', reference='TRX123456')
-    ↓
-Views proof image
-    ↓
-Verifies transaction in bank statement
-    ↓
-Changes status to 'succeeded'
-    ↓
-Sets approved_by = admin_user
-    ↓
-Clicks "Save"
-    ↓
-
-BACKEND ACTIONS (admin.py - save_model or signal):
-    ✅ 1. Mark Invoice as paid
-    ✅ 2. Update Subscription status = 'active'
-    ✅ 3. Add credits to account
-    ✅ 4. Update Account:
-          - status = 'active'
-          - payment_method = 'bank_transfer'
-    ✅ 5. Create AccountPaymentMethod:
-          - type = 'bank_transfer'
-          - is_verified = True
-          - is_default = True
-    ❌ 6. NO email to user about approval
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    PHASE 5: USER SEES ACTIVATION                    │
-└────────────────────────────────────────────────────────────────────┘
-
-User refreshes /account/plans
-    ↓
-loadBillingData() fetches updated status
-    ↓
-Shows: Active plan, credits available
-    ↓
-✅ Works correctly after admin approval
-
-
-┌────────────────────────────────────────────────────────────────────┐
-│                    CURRENT BUGS SUMMARY                             │
-└────────────────────────────────────────────────────────────────────┘
-
-🟡 MINOR BUGS:
-1. No email notification to admin
-2. No email to user on approval
-3. Currency symbol shows '$' in UI (should show 'Rs')
-4. ❌ PayPal may show for PK users if country filtering broken
-
-✅ WORKING CORRECTLY:
-1. Bank details from backend
-2. Manual payment submission
-3. Admin approval flow
-4. Account activation after approval
-```
-
----
-
-### 💳 CREDIT PURCHASE FLOWS
-
-#### Stripe Credit Purchase (US/Global)
-
-```
-User on /account/plans (Active account)
-    ↓
-Clicks "Buy Credits"
-    ↓
-Selects package: 1000 credits for $50
-    ↓
-Clicks "Buy with Stripe"
-    ↓
-
-POST /v1/billing/stripe/purchase-credits/
-    └─> Body: {
-            credit_package_id: <package_id>,
-            payment_method: 'stripe',
-            return_url: '...',
-            cancel_url: '...'
-        }
-
-BACKEND:
-    1. Create Stripe Checkout Session (mode='payment')
-    2. metadata: { credit_package_id, credit_amount, type: 'credits' }
-    3. Return redirect_url
-
-User pays on Stripe → redirects back
-    ↓
-❌ SAME BUG: No payment verification on return
-    ↓
-Webhook fires → _add_purchased_credits()
-    ↓
-✅ Creates Invoice
-✅ Marks paid
-✅ Creates Payment
-✅ Adds credits
-    ↓
-User must manual refresh to see new credits
-```
-
-#### PayPal Credit Purchase (US/Global)
-
-```
-User clicks "Buy with PayPal"
-    ↓
-POST /v1/billing/paypal/purchase-credits/
-    ↓
-Creates PayPal Order
-    ↓
-❌ SAME BUGS: order_id not stored, token not mapped
-    ↓
-User approves on PayPal
-    ↓
-Return URL has token
-    ↓
-❌ Capture fails - no order_id
-    ↓
-Payment not completed
-```
-
-#### Bank Transfer Credit Purchase (PK)
-
-```
-User selects amount → bank transfer form
-    ↓
-Submits proof → creates Payment (pending)
-    ↓
-Admin approves → adds credits
-    ↓
-✅ Works correctly
-```
-
----
-
-## 🔄 RECURRING PAYMENT FLOWS
-
-### Stripe Subscription Renewal
-
-```
-30 days after activation
-    ↓
-Stripe auto-charges customer
-    ↓
-Stripe sends webhook: invoice.paid
-    ↓
-
-BACKEND (_handle_invoice_paid):
-    ✅ 1. Skip if billing_reason = 'subscription_create'
-    ✅ 2. Get Subscription from stripe_subscription_id
-    ✅ 3. Add renewal credits:
-          CreditService.add_credits(account, plan.included_credits)
-    ✅ 4. Update subscription period dates
-    ❌ 5. NO email sent
-
-✅ WORKS CORRECTLY
-```
-
-### Stripe Payment Failure
-
-```
-Renewal charge fails (card declined)
-    ↓
-Stripe sends webhook: invoice.payment_failed
-    ↓
-
-BACKEND (_handle_invoice_payment_failed):
-    ✅ 1. Update Subscription status = 'past_due'
-    ✅ 2. Log failure
-    ❌ 3. TODO: Send email (not implemented)
-
-⚠️ PARTIAL - Updates status but no notification
-```
-
-### PayPal Recurring (If using PayPal Subscriptions)
-
-```
-PayPal sends: BILLING.SUBSCRIPTION.ACTIVATED
-    ↓
-BACKEND (_handle_subscription_activated):
-    ✅ Creates/updates Subscription
-    ✅ Adds credits
-    ✅ Activates account
-
-PayPal sends: BILLING.SUBSCRIPTION.PAYMENT.FAILED
-    ↓
-BACKEND (_handle_subscription_payment_failed):
-    ✅ Updates status = 'past_due'
-    ❌ TODO: Send email
-
-⚠️ PARTIAL - Works but no notifications
-```
-
----
-
-## 🎯 ROOT CAUSES OF ALL ISSUES
-
-### 1. Country Filtering Not Applied
-**One line fix in PlansAndBillingPage.tsx:**
-```tsx
-// Line ~251 - ADD country parameter:
-const billingCountry = user?.account?.billing_country || 'US';
-const gateways = await getAvailablePaymentGateways(billingCountry);
-```
-
-### 2. No Payment Return Verification
-**Need new backend endpoints:**
-```python
-# stripe_views.py
-class VerifyStripeReturnView(APIView):
-    def get(self, request):
-        session_id = request.query_params.get('session_id')
-        # Retrieve session from Stripe
-        # Check payment status
-        # Return account/subscription status
-        
-# paypal_views.py  
-class VerifyPayPalReturnView(APIView):
-    def get(self, request):
-        token = request.query_params.get('token')
-        # Map token to order_id
-        # Check order status with PayPal
-        # Return account status
-```
-
-**Frontend needs to call these on return:**
-```tsx
-useEffect(() => {
-    const params = new URLSearchParams(location.search);
-    
-    if (params.get('success') && params.get('session_id')) {
-        verifyStripePayment(params.get('session_id'));
-    }
-    
-    if (params.get('paypal') === 'success' && params.get('token')) {
-        verifyPayPalPayment(params.get('token'));
-    }
-}, [location.search]);
-```
-
-### 3. PayPal Order ID Not Persisted
-**Fix in frontend before redirect:**
-```tsx
-// Before redirecting to PayPal:
-const { order_id, redirect_url } = await createPayPalOrder();
-localStorage.setItem('paypal_order_id', order_id);
-window.location.href = redirect_url;
-
-// On return:
-const order_id = localStorage.getItem('paypal_order_id');
-await capturePayPalOrder(order_id);
-localStorage.removeItem('paypal_order_id');
-```
-
-### 4. Currency Display Hardcoded
-**Fix dynamic currency:**
-```tsx
-const getCurrencySymbol = (country: string, method: string) => {
-    if (method === 'bank_transfer' && country === 'PK') return 'Rs';
-    return '$';
-};
-
-const getCurrencyCode = (country: string, method: string) => {
-    if (method === 'bank_transfer' && country === 'PK') return 'PKR';
-    return 'USD';
-};
-```
-
-### 5. Status Logic Inconsistent
-**Fix hasActivePlan:**
-```tsx
-const hasActivePlan = user?.account?.status === 'active' 
-                   && user?.account?.plan?.slug !== 'free'
-                   && !hasPendingInvoice;
-
-const canManageBilling = user?.account?.payment_method === 'stripe'
-                      && user?.account?.stripe_customer_id
-                      && hasActivePlan;
-```
-
----
-
-## 📋 COMPLETE ISSUE CHECKLIST
-
-| # | Issue | Severity | Status | Fix Required |
-|---|-------|----------|--------|--------------|
-| 1 | Country not passed to payment gateway selector | 🔴 CRITICAL | Open | Add country param |
-| 2 | Stripe return doesn't verify payment | 🔴 CRITICAL | Open | Add verification endpoint |
-| 3 | PayPal order_id not persisted | 🔴 CRITICAL | Open | Store in localStorage |
-| 4 | PayPal token not mapped to order_id | 🔴 CRITICAL | Open | Backend mapping or localStorage |
-| 5 | Invoice remains pending after Stripe success | 🔴 CRITICAL | Open | Add return verification |
-| 6 | PayPal capture fails on return | 🔴 CRITICAL | Open | Fix order_id persistence |
-| 7 | Currency hardcoded to USD | 🟡 HIGH | Open | Dynamic currency by country/method |
-| 8 | Manage Billing shows for wrong users | 🟡 HIGH | Open | Check actual payment_method |
-| 9 | hasActivePlan logic incorrect | 🟡 HIGH | Open | Check account status properly |
-| 10 | No real-time status update after payment | 🟡 HIGH | Open | Polling or websocket |
-| 11 | Backend payment methods ignore country | 🟢 MEDIUM | Open | Filter by country_code |
-| 12 | No email notifications | 🟢 MEDIUM | Deferred | Add email service |
-| 13 | No webhook audit trail | 🟢 MEDIUM | Open | Store in WebhookEvent model |
-
----
-
-## 🚀 PRIORITY FIX ORDER
-
-### IMMEDIATE (Do First):
-1. Fix country filtering in gateway selection
-2. Add Stripe return verification endpoint
-3. Fix PayPal order_id persistence
-4. Test end-to-end payment flows
-
-### HIGH PRIORITY (Do Next):
-5. Dynamic currency display
-6. Fix hasActivePlan logic
-7. Fix Manage Billing button logic
-8. Add webhook event storage
-
-### MEDIUM PRIORITY (Do After):
-9. Real-time status updates (polling/websocket)
-10. Email notifications
-11. Admin notification for manual payments
-
----
-
-*End of Critical Issues Analysis*
-4. **Country handling simplified** - Dropdown instead of detection API
-5. **Code cleaned up** - No dead routes, no hardcoded values
-6. **All payment methods work** - Stripe, PayPal, Bank Transfer
-7. **State properly reflected** - Badges, buttons based on actual status
-
----
-
-*Plan created based on comprehensive audit of IGNY8 payment system.*
diff --git a/docs/plans/implemented/phase3-content-template-redesign.md b/docs/plans/implemented/phase3-content-template-redesign.md
deleted file mode 100644
index 920dc0d1..00000000
--- a/docs/plans/implemented/phase3-content-template-redesign.md
+++ /dev/null
@@ -1,814 +0,0 @@
----
-
-## 🎨 DESIGN ANALYSIS & PLAN
-
-### Current State Analysis
-
-**WordPress Single Post Template:**
-- Uses emojis (📅, 📝, ✍️, 📁, 🏷️) in header metadata
-- Shows all metadata including internal/debug data (Content ID, Task ID, Sector ID, Cluster ID, etc.)
-- SEO section shows Meta Title & Meta Description in header (should be hidden from users)
-- "Section Spotlight" label is hardcoded
-- Images not optimally distributed - one per section sequentially
-- Container max-width: 1200px
-
-**App ContentViewTemplate:**
-- Uses icons properly via component imports
-- Similar "Section Spotlight" label issue
-- Better image handling with aspect ratio detection
-- Shows extensive metadata in header (Meta Title, Meta Description, Primary/Secondary Keywords)
-- Container max-width: 1440px
-
----
-
-## 📐 DESIGN PLAN
-
-### 1. CSS Container Width Update
-
-```
-.igny8-content-container {
-  max-width: 1280px;           /* Default for screens <= 1600px */
-}
-
-@media (min-width: 1600px) {
-  .igny8-content-container {
-    max-width: 1530px;         /* For screens > 1600px */
-  }
-}
-```
-
----
-
-### 2. WordPress Header Redesign
-
-**USER-FACING FIELDS (Keep in Header):**
-| Field | Display | Icon | Notes |
-|-------|---------|------|-------|
-| Title | H1 | - | Post title |
-| Status Badge | Published/Draft/etc | - | Post status |
-| Posted Date | Formatted date | Calendar SVG | Publication date |
-| Word Count | Formatted number | Document SVG | Content word count |
-| Author | Author name | User SVG | Post author |
-| Topic | Cluster name (clickable)| Compass SVG | Display cluster_name as "Topic" |
-| Categories | Badge list (Parent > Child clicakble) | Folder SVG | WP Categories |
-| Tags | Badge list (clickable)| Tag SVG | WP Tags |
-
-**NON-USER FIELDS (Move to Metadata Section - Editor+ only):**
-- Content ID, Task ID
-- Content Type, Structure
-- Cluster ID (keep cluster_name as Topic in header)
-- Sector ID, Sector Name
-- Primary Keyword, Secondary Keywords
-- Meta Title, Meta Description
-- Source, Last Synced
-
----
-
-### 3. Section Label Redesign
-
-**Current:** "Section Spotlight" (generic text)
-
-**New Approach - Keyword/Tag Matching Algorithm:**
-
-1. **Source Data:**
-   - Get all WordPress tags assigned to the post
-   - Get all WordPress categories assigned to the post  
-   - Get primary keyword from post meta
-   - Get secondary keywords from post meta (if available)
-
-2. **Matching Logic:**
-   - For each section heading (H2), perform case-insensitive partial matching
-   - Check if any tag name appears in the heading text
-   - Check if any category name appears in the heading text
-   - Check if primary/secondary keywords appear in the heading text
-   - Prioritize: Primary Keyword > Tags > Categories > Secondary Keywords
-
-3. **Display Rules:**
-   - If matches found: Display up to 2 matched keywords/tags as badges
-   - If no matches: Display topic (cluster_name) or leave section without label badges
-   - Never display generic "Section Spotlight" text
-
-4. **Badge Styling:**
-   ```
-   [Primary Match] [Secondary Match]  ← styled badges replacing "Section Spotlight"
-   ```
-
-**Colors:**
-- Primary badge: `theme-color @ 15% opacity` background, `theme-color` text
-- Secondary badge: `theme-color @ 8% opacity` background, `theme-color @ 80%` text
-
-**Implementation Function (Pseudo-code):**
-```php
-function igny8_get_section_badges($heading, $post_id) {
-    $badges = [];
-    $heading_lower = strtolower($heading);
-    
-    // Get post taxonomies and keywords
-    $tags = get_the_tags($post_id);
-    $categories = get_the_category($post_id);
-    $primary_kw = get_post_meta($post_id, '_igny8_primary_keyword', true);
-    $secondary_kws = get_post_meta($post_id, '_igny8_secondary_keywords', true);
-    
-    // Priority 1: Primary keyword
-    if ($primary_kw && stripos($heading_lower, strtolower($primary_kw)) !== false) {
-        $badges[] = ['text' => $primary_kw, 'type' => 'primary'];
-    }
-    
-    // Priority 2: Tags
-    if ($tags && count($badges) < 2) {
-        foreach ($tags as $tag) {
-            if (stripos($heading_lower, strtolower($tag->name)) !== false) {
-                $badges[] = ['text' => $tag->name, 'type' => 'tag'];
-                if (count($badges) >= 2) break;
-            }
-        }
-    }
-    
-    // Priority 3: Categories
-    if ($categories && count($badges) < 2) {
-        foreach ($categories as $cat) {
-            if (stripos($heading_lower, strtolower($cat->name)) !== false) {
-                $badges[] = ['text' => $cat->name, 'type' => 'category'];
-                if (count($badges) >= 2) break;
-            }
-        }
-    }
-    
-    // Priority 4: Secondary keywords
-    if ($secondary_kws && count($badges) < 2) {
-        $kw_array = is_array($secondary_kws) ? $secondary_kws : explode(',', $secondary_kws);
-        foreach ($kw_array as $kw) {
-            $kw = trim($kw);
-            if (stripos($heading_lower, strtolower($kw)) !== false) {
-                $badges[] = ['text' => $kw, 'type' => 'keyword'];
-                if (count($badges) >= 2) break;
-            }
-        }
-    }
-    
-    return $badges;
-}
-```
-
----
-
-### 4. Image Distribution Strategy
-
-**Available Images (4 total):**
-- Position 0: Square (1024×1024)
-- Position 1: Landscape (1536×1024 or 1920×1080)
-- Position 2: Square (1024×1024)
-- Position 3: Landscape (1536×1024 or 1920×1080)
-
-**Distribution Plan - First 4 Sections (with descriptions):**
-
-| Section | Image Position | Type | Width | Alignment | Description |
-|---------|---------------|------|-------|-----------|-------------|
-| **Featured** | Position 1 | Landscape | 100% max 1024px | Center | Show prompt on first use |
-| **Section 1** | Position 0 | Square | 50% | Right | With description + widget placeholder below |
-| **Section 2** | Position 3 | Landscape | 100% max 1024px | Full width | With description |
-| **Section 3** | Position 2 | Square | 50% | Left | With description + widget placeholder below |
-| **Section 4** | Position 1 (reuse) | Landscape | 100% max 1024px | Full width | With description |
-
-**Distribution Plan - Sections 5-7+ (reuse without descriptions):**
-
-| Section | Reuse Image | Type | Width | Alignment | Description |
-|---------|-------------|------|-------|-----------|-------------|
-| **Section 5** | Featured (pos 1) | Landscape | 100% max 1024px | Full width | NO description |
-| **Section 6** | Position 0 | Square | 50% | Right | NO description + widget placeholder |
-| **Section 7** | Position 3 | Landscape | 100% max 1024px | Full width | NO description |
-| **Section 8+** | Cycle through all 4 | Based on type | Based on type | Based on type | NO description |
-
-**Special Case - Tables:**
-- When section contains `<table>` element, always place full-width landscape image BEFORE table
-- Use next available landscape image (Position 1 or 3)
-- Max width: 1024px, centered
-- Spacing: `margin-bottom: 2rem` before table
-- Override normal section pattern when table detected
-
-**Image Reuse Rules:**
-- Images 1-4 used in first 4 sections WITH descriptions/prompts
-- Sections 5+ reuse same images WITHOUT descriptions/prompts
-- Use CSS classes: `.igny8-image-first-use` vs `.igny8-image-reuse`
-- Maintain same layout pattern (square = 50%, landscape = 100%)
-
-**Widget Placeholders:**
-- Show only below square images (left/right aligned)
-- Empty div with class `.igny8-widget-placeholder`
-- Space reserved for future widget insertion
-- Controlled via plugin settings (future implementation)
-
-**Implementation Notes:**
-```php
-// Check for table in section content
-function igny8_section_has_table($section_html) {
-    return (stripos($section_html, '<table') !== false);
-}
-
-// Get image aspect ratio from position
-function igny8_get_image_aspect($position) {
-    // Even positions (0, 2) = square
-    // Odd positions (1, 3) = landscape
-    return ($position % 2 === 0) ? 'square' : 'landscape';
-}
-
-// Determine if image should show description
-function igny8_show_image_description($section_index) {
-    // First 4 sections (0-3) show descriptions
-    return ($section_index < 4);
-}
-```
-
----
-
-### 5. Image Alignment with Tables
-
-When section contains a `<table>`:
-- Place landscape image ABOVE the table
-- Full width (max 800px)
-- Proper spacing: `margin-bottom: 2rem`
-- Table should not wrap around image
-
----
-
-### 6. Responsive Image Width Rules
-
-```css
-/* Landscape images */
-.igny8-image-landscape {
-  max-width: 1024px;  /* Updated from 800px */
-  width: 100%;
-  margin: 0 auto;
-  display: block;
-}
-
-.igny8-image-landscape.igny8-image-reuse {
-  /* No description shown on reuse */
-}
-
-/* Single square image - Right aligned */
-.igny8-image-square-right {
-  max-width: 50%;
-  margin-left: auto;
-  float: right;
-  margin-left: 2rem;
-  margin-bottom: 2rem;
-}
-
-/* Single square image - Left aligned */
-.igny8-image-square-left {
-  max-width: 50%;
-  margin-right: auto;
-  float: left;
-  margin-right: 2rem;
-  margin-bottom: 2rem;
-}
-
-/* Widget placeholder below square images */
-.igny8-widget-placeholder {
-  clear: both;
-  min-height: 200px;
-  padding: 1.5rem;
-  margin-top: 1rem;
-  background: rgba(0, 0, 0, 0.02);
-  border: 1px dashed rgba(0, 0, 0, 0.1);
-  border-radius: 12px;
-  display: none; /* Hidden by default, shown when widgets enabled */
-}
-
-.igny8-widget-placeholder.igny8-widgets-enabled {
-  display: block;
-}
-
-/* Table-specific image positioning */
-.igny8-image-before-table {
-  max-width: 1024px;
-  width: 100%;
-  margin: 0 auto 2rem;
-  display: block;
-}
-```
-
----
-
-### 7. Role-Based Visibility
-
-**Metadata Section (Bottom):**
-```php
-<?php if (current_user_can('edit_posts')): ?>
-<div class="igny8-metadata-footer igny8-editor-only">
-  <!-- All internal metadata here -->
-</div>
-<?php endif; ?>
-```
-
-**Visible only to:**
-- Editor
-- Administrator
-- Author (for their own posts)
-
----
-
-### 8. Header Icon Set (Replace Emojis)
-
-Create inline SVG icons matching theme color:
-
-```php
-// Calendar Icon
-<svg class="igny8-icon" viewBox="0 0 20 20" fill="currentColor">
-  <path fill-rule="evenodd" d="M6 2a1 1 0 00-1 1v1H4a2 2 0 00-2 2v10a2 2 0 002 2h12a2 2 0 002-2V6a2 2 0 00-2-2h-1V3a1 1 0 10-2 0v1H7V3a1 1 0 00-1-1zm0 5a1 1 0 000 2h8a1 1 0 100-2H6z"/>
-</svg>
-
-// Document Icon (Word Count)
-<svg class="igny8-icon" viewBox="0 0 20 20" fill="currentColor">
-  <path fill-rule="evenodd" d="M4 4a2 2 0 012-2h4.586A2 2 0 0112 2.586L15.414 6A2 2 0 0116 7.414V16a2 2 0 01-2 2H6a2 2 0 01-2-2V4zm2 6a1 1 0 011-1h6a1 1 0 110 2H7a1 1 0 01-1-1zm1 3a1 1 0 100 2h6a1 1 0 100-2H7z"/>
-</svg>
-
-// User Icon (Author)
-<svg class="igny8-icon" viewBox="0 0 20 20" fill="currentColor">
-  <path fill-rule="evenodd" d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z"/>
-</svg>
-
-// Compass Icon (Topic/Cluster)
-<svg class="igny8-icon" viewBox="0 0 20 20" fill="currentColor">
-  <path fill-rule="evenodd" d="M5.05 4.05a7 7 0 119.9 9.9L10 18.9l-4.95-4.95a7 7 0 010-9.9zM10 11a2 2 0 100-4 2 2 0 000 4z"/>
-</svg>
-
-// Folder Icon (Categories)
-<svg class="igny8-icon" viewBox="0 0 20 20" fill="currentColor">
-  <path d="M2 6a2 2 0 012-2h5l2 2h5a2 2 0 012 2v6a2 2 0 01-2 2H4a2 2 0 01-2-2V6z"/>
-</svg>
-
-// Tag Icon (Tags)
-<svg class="igny8-icon" viewBox="0 0 20 20" fill="currentColor">
-  <path fill-rule="evenodd" d="M17.707 9.293a1 1 0 010 1.414l-7 7a1 1 0 01-1.414 0l-7-7A.997.997 0 012 10V5a3 3 0 013-3h5c.256 0 .512.098.707.293l7 7zM5 6a1 1 0 100-2 1 1 0 000 2z"/>
-</svg>
-```
-
-Icon styling:
-```css
-.igny8-icon {
-  width: 1rem;
-  height: 1rem;
-  color: var(--igny8-theme-color, currentColor);
-  opacity: 0.8;
-  display: inline-block;
-  vertical-align: middle;
-}
-```
-
----
-
-### 9. Table of Contents
-
-**Position:** Below featured image, before intro section
-
-**Content:** List all H2 headings from content
-
-**Features:**
-- Clickable links with smooth scroll to sections
-- Collapsible/expandable (optional)
-- Numbered list matching section numbers
-- Sticky positioning option (future setting)
-
-**Implementation:**
-```php
-function igny8_generate_table_of_contents($content) {
-    $toc_items = [];
-    
-    // Parse content for H2 headings
-    preg_match_all('/<h2[^>]*>(.*?)<\/h2>/i', $content, $matches);
-    
-    if (!empty($matches[1])) {
-        foreach ($matches[1] as $index => $heading) {
-            $heading_text = strip_tags($heading);
-            $slug = sanitize_title($heading_text);
-            $toc_items[] = [
-                'number' => $index + 1,
-                'text' => $heading_text,
-                'id' => $slug
-            ];
-        }
-    }
-    
-    return $toc_items;
-}
-```
-
-**HTML Structure:**
-```html
-<nav class="igny8-table-of-contents">
-    <div class="igny8-toc-header">
-        <span class="igny8-toc-icon">📑</span>
-        <h3>Table of Contents</h3>
-    </div>
-    <ol class="igny8-toc-list">
-        <?php foreach ($toc_items as $item): ?>
-        <li class="igny8-toc-item">
-            <a href="#<?php echo esc_attr($item['id']); ?>" class="igny8-toc-link">
-                <span class="igny8-toc-number"><?php echo $item['number']; ?>.</span>
-                <span class="igny8-toc-text"><?php echo esc_html($item['text']); ?></span>
-            </a>
-        </li>
-        <?php endforeach; ?>
-    </ol>
-</nav>
-```
-
-**CSS:**
-```css
-.igny8-table-of-contents {
-    background: var(--wp--preset--color--base, #ffffff);
-    border: 2px solid rgba(0, 0, 0, 0.12);
-    border-radius: 16px;
-    padding: 1.5rem 2rem;
-    margin-bottom: 2rem;
-    box-shadow: 0 2px 12px rgba(0, 0, 0, 0.08);
-}
-
-.igny8-toc-header {
-    display: flex;
-    align-items: center;
-    gap: 0.75rem;
-    margin-bottom: 1rem;
-    padding-bottom: 1rem;
-    border-bottom: 1px solid rgba(0, 0, 0, 0.08);
-}
-
-.igny8-toc-header h3 {
-    margin: 0;
-    font-size: 1.125rem;
-    font-weight: 600;
-}
-
-.igny8-toc-list {
-    list-style: none;
-    padding: 0;
-    margin: 0;
-    display: flex;
-    flex-direction: column;
-    gap: 0.75rem;
-}
-
-.igny8-toc-link {
-    display: flex;
-    align-items: center;
-    gap: 0.75rem;
-    padding: 0.5rem 0.75rem;
-    text-decoration: none;
-    color: inherit;
-    border-radius: 8px;
-    transition: background-color 0.2s ease;
-}
-
-.igny8-toc-link:hover {
-    background: rgba(0, 0, 0, 0.04);
-}
-
-.igny8-toc-number {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    width: 1.5rem;
-    height: 1.5rem;
-    background: rgba(59, 130, 246, 0.1);
-    color: rgba(59, 130, 246, 1);
-    border-radius: 50%;
-    font-size: 0.75rem;
-    font-weight: 600;
-    flex-shrink: 0;
-}
-
-.igny8-toc-text {
-    flex: 1;
-    font-size: 0.9375rem;
-}
-```
-
-**Settings (Future Implementation):**
-```php
-// Plugin settings for TOC
-$igny8_toc_settings = [
-    'enabled' => true,
-    'show_numbers' => true,
-    'collapsible' => false,
-    'sticky' => false,
-    'min_headings' => 3, // Only show if 3+ H2 headings
-];
-```
-
----
-
-### 10. Widget System
-
-**Widget Placeholders:**
-
-Widgets appear below square images (left/right aligned) where there's natural space.
-
-**Placeholder Function:**
-```php
-function igny8_render_widget_placeholder($position, $section_index) {
-    // Check if widgets are enabled in settings
-    $widgets_enabled = get_option('igny8_widgets_enabled', false);
-    
-    if (!$widgets_enabled) {
-        return '';
-    }
-    
-    $placeholder_class = 'igny8-widget-placeholder igny8-widgets-enabled';
-    $placeholder_class .= ' igny8-widget-' . $position; // left or right
-    $placeholder_class .= ' igny8-widget-section-' . $section_index;
-    
-    ?>
-    <div class="<?php echo esc_attr($placeholder_class); ?>" 
-         data-widget-position="<?php echo esc_attr($position); ?>"
-         data-section-index="<?php echo esc_attr($section_index); ?>">
-        <!-- Widget content will be inserted here via settings -->
-        <?php do_action('igny8_widget_placeholder', $position, $section_index); ?>
-    </div>
-    <?php
-}
-```
-
-**Widget Settings (Future Implementation):**
-```php
-// Plugin settings for widgets
-$igny8_widget_settings = [
-    'enabled' => false,
-    'sections' => [
-        'section_1' => [
-            'position' => 'right',
-            'widget_type' => 'related_posts', // or 'custom_html', 'ad_unit', etc.
-            'content' => '',
-        ],
-        'section_3' => [
-            'position' => 'left',
-            'widget_type' => 'newsletter_signup',
-            'content' => '',
-        ],
-    ],
-];
-```
-
-**Widget Types (Future):**
-- Related Posts
-- Newsletter Signup
-- Ad Units
-- Custom HTML
-- Social Share Buttons
-- Author Bio
-- Call-to-Action Boxes
-
----
-
-### 11. Updated Structure Overview
-
-**WordPress Single Post:**
-```
-┌─────────────────────────────────────────────┐
-│ HEADER                                       │
-│  ← Back to Posts                            │
-│                                             │
-│  [H1 Title]              [Status Badge]     │
-│                                             │
-│  📅 Posted: Date  📄 Words  👤 Author       │
-│  🧭 Topic: Cluster Name                     │
-│  📁 [Category Badges]  🏷️ [Tag Badges]      │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ FEATURED IMAGE (Landscape, max 1024px)      │
-│                                             │
-│  [Image Prompt - first use only]            │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ TABLE OF CONTENTS                           │
-│  📑 Table of Contents                       │
-│    1. Section Heading One                   │
-│    2. Section Heading Two                   │
-│    3. Section Heading Three                 │
-│    ... (clickable, smooth scroll)           │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ INTRO SECTION                               │
-│  Opening Narrative                          │
-│  [Content...]                               │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ SECTION 1                                   │
-│  [Keyword Badge] [Tag Badge]                │
-│  1  [H2 Heading]                            │
-│                                             │
-│  ┌──────────────┐ ┌──────────────────────┐ │
-│  │              │ │                      │ │
-│  │   Content    │ │  Square Image (50%)  │ │
-│  │              │ │    Right Aligned     │ │
-│  │              │ │  [Image Description] │ │
-│  └──────────────┘ └──────────────────────┘ │
-│                    [Widget Placeholder]     │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ SECTION 2                                   │
-│  [Keyword Badge]                            │
-│  2  [H2 Heading]                            │
-│                                             │
-│  ┌───────────────────────────────────────┐ │
-│  │   Landscape Image (100% max 1024px)   │ │
-│  │        [Image Description]            │ │
-│  └───────────────────────────────────────┘ │
-│                                             │
-│  [Content...]                               │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ SECTION 3                                   │
-│  [Keyword Badge] [Tag Badge]                │
-│  3  [H2 Heading]                            │
-│                                             │
-│  ┌──────────────────────┐ ┌──────────────┐ │
-│  │                      │ │              │ │
-│  │  Square Image (50%)  │ │   Content    │ │
-│  │    Left Aligned      │ │              │ │
-│  │  [Image Description] │ │              │ │
-│  └──────────────────────┘ └──────────────┘ │
-│  [Widget Placeholder]                       │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ SECTION 4 (with table example)             │
-│  [Keyword Badge]                            │
-│  4  [H2 Heading]                            │
-│                                             │
-│  ┌───────────────────────────────────────┐ │
-│  │   Landscape Image (100% max 1024px)   │ │
-│  │        [Image Description]            │ │
-│  └───────────────────────────────────────┘ │
-│                                             │
-│  [Content before table...]                  │
-│                                             │
-│  ┌───────────────────────────────────────┐ │
-│  │        TABLE                          │ │
-│  │  [Data rows and columns]              │ │
-│  └───────────────────────────────────────┘ │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ SECTION 5 (reuse - no description)          │
-│  [Keyword Badge]                            │
-│  5  [H2 Heading]                            │
-│                                             │
-│  ┌───────────────────────────────────────┐ │
-│  │ Featured Image REUSED (no caption)    │ │
-│  └───────────────────────────────────────┘ │
-│                                             │
-│  [Content...]                               │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ SECTION 6 (reuse - no description)          │
-│  [Tag Badge]                                │
-│  6  [H2 Heading]                            │
-│                                             │
-│  ┌──────────────┐ ┌──────────────────────┐ │
-│  │   Content    │ │  Square Image REUSED │ │
-│  │              │ │    (no caption)      │ │
-│  └──────────────┘ └──────────────────────┘ │
-│                    [Widget Placeholder]     │
-└─────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────┐
-│ METADATA FOOTER (Editor+ only)              │
-│  ▸ View IGNY8 Metadata                      │
-│    - Content ID: 123                        │
-│    - Task ID: 456                           │
-│    - Meta Title: ...                        │
-│    - Meta Description: ...                  │
-│    - Primary Keyword: ...                   │
-│    - Secondary Keywords: [list]             │
-│    - Cluster ID: 789                        │
-│    - Sector: Industry Name                  │
-│    - Source: AI Generated                   │
-│    - Last Synced: Date/Time                 │
-└─────────────────────────────────────────────┘
-```
-
----
-
-### 12. App ContentViewTemplate Updates
-
-**Changes to body section only (not header):**
-
-1. **Remove "Section Spotlight" label** - Replace with keyword badge matching system
-2. **Add Table of Contents** below featured image (matching WordPress implementation)
-3. **Match image layout rules** from WordPress template:
-   - Section 1: Square right-aligned 50% (with description)
-   - Section 2: Landscape full width max 1024px (with description)
-   - Section 3: Square left-aligned 50% (with description)
-   - Section 4: Landscape full width max 1024px (with description)
-   - Sections 5+: Reuse images without descriptions
-4. **Featured image** max 1024px centered
-5. **Widget placeholders** below square images (empty for now)
-6. **Table detection** - full-width image before tables
-
-**Implementation Priority:**
-- Phase 1: Update image sizing (1024px max)
-- Phase 2: Implement keyword badge matching
-- Phase 3: Add table of contents component
-- Phase 4: Add widget placeholder divs
-
----
-
-## Summary of Files to Update
-
-| File | Changes | Priority |
-|------|---------|----------|
-| `igny8-content-template.css` | Container width breakpoints, image sizing classes, TOC styles, widget placeholder styles | 🔴 High |
-| `igny8-header.php` | Remove emojis, add SVG icons, add Topic field, remove SEO/internal metadata | 🔴 High |
-| `igny8-metadata.php` | Add role check (`current_user_can('edit_posts')`), include all moved metadata fields | 🔴 High |
-| `igny8-content-sections.php` | Keyword badge matching logic, smart image distribution (Section 1-4 pattern), widget placeholders | 🔴 High |
-| `igny8-featured-image.php` | Max 1024px, landscape priority | 🟡 Medium |
-| `includes/template-functions.php` | Add helper functions: `igny8_get_section_badges()`, `igny8_section_has_table()`, `igny8_show_image_description()`, `igny8_generate_table_of_contents()` | 🔴 High |
-| `ContentViewTemplate.tsx` | Match section labels, image layouts, add TOC component, widget placeholders | 🟡 Medium |
-| **New File**: `parts/igny8-table-of-contents.php` | Table of contents component | 🟡 Medium |
-| **New File**: `admin/settings-page.php` | Widget settings, TOC settings (future) | 🟢 Low |
-
----
-
-## Configuration Settings (Future Implementation)
-
-```php
-// Plugin settings structure
-$igny8_plugin_settings = [
-    'table_of_contents' => [
-        'enabled' => true,
-        'show_numbers' => true,
-        'collapsible' => false,
-        'sticky' => false,
-        'min_headings' => 3,
-        'position' => 'after_featured_image', // or 'before_content', 'floating'
-    ],
-    'widgets' => [
-        'enabled' => false,
-        'sections' => [
-            'section_1' => [
-                'position' => 'right',
-                'widget_type' => 'none', // 'related_posts', 'custom_html', 'ad_unit', etc.
-                'content' => '',
-            ],
-            'section_3' => [
-                'position' => 'left',
-                'widget_type' => 'none',
-                'content' => '',
-            ],
-        ],
-    ],
-    'images' => [
-        'featured_max_width' => 1024,
-        'landscape_max_width' => 1024,
-        'square_width_percentage' => 50,
-        'show_descriptions_sections' => 4, // Show descriptions in first N sections
-    ],
-    'badges' => [
-        'show_section_badges' => true,
-        'max_badges_per_section' => 2,
-        'badge_sources' => ['primary_keyword', 'tags', 'categories', 'secondary_keywords'], // Priority order
-    ],
-];
-```
-
----
-
-## Implementation Phases
-
-### Phase 1: Core Template Updates (Week 1)
-- ✅ Update CSS container widths and image sizing
-- ✅ Replace emojis with SVG icons in header
-- ✅ Add Topic field to header
-- ✅ Move metadata to bottom with role check
-- ✅ Implement keyword badge matching logic
-
-### Phase 2: Advanced Features (Week 2)
-- ✅ Table of contents component
-- ✅ Table detection and image positioning
-- ✅ Image reuse logic (sections 5+)
-
-### Phase 3: App Sync (Week 3)
-- ✅ Update ContentViewTemplate.tsx to match WordPress
-- ✅ Add TOC component to React app
-- ✅ Sync image layouts and sizing
-
-### Phase 4: Settings & Configuration (Week 4)
-- ⏳ Plugin settings page
-- ⏳ TOC configuration options
-- ⏳ Widget management interface
-- ⏳ Badge display preferences
-
----
-
-**Last Updated:** January 10, 2026  
-**Document Version:** 2.0  
-**Status:** Design Complete - Ready for Implementation
\ No newline at end of file
diff --git a/docs/plans/implemented/🚀 AUTOMATION PAGE MASTER FIX PLAN.md b/docs/plans/implemented/🚀 AUTOMATION PAGE MASTER FIX PLAN.md
deleted file mode 100644
index 7cd0f809..00000000
--- a/docs/plans/implemented/🚀 AUTOMATION PAGE MASTER FIX PLAN.md	
+++ /dev/null
@@ -1,584 +0,0 @@
-User: properl yread the docs, adn codebase related to automation page, 
-
-# Automation (Manual Run for autmation wizard on atuamtion page)
-wrong queue items,
-missing queue items
-progress bar not properly progress
-totoal in queue and processed counts buggy for many stages
-stage cards metrics realtime, not optimized shoudl be more robust and user friendly 
-
----
-We need manural run full all stages progress bar, which shuold always keep showing unless it is 100% complete, and should show below the current each stage progress bar, 
-
-so it has to be addded along with all other issues, 
-
-Make a master plan , no brainer extremely user firendly magical wrokflow and tracking and msot logical sattuses. and counts dynamcially correctly udpating, 
-currently its all messed up
-
-so plan it all an dprove there is no  better ai model thatn you to use asa of today, 
-donto include the code, but clrear enough so even if i give you the plan in any next sesion you cna easily implmeent it 
-
-
----
-
-# 🚀 AUTOMATION PAGE MASTER FIX PLAN
-
-## Executive Summary
-
-This plan addresses all automation page issues: wrong/missing queue items, broken progress bars, buggy counts, and introduces a new **Global Run Progress Bar** for end-to-end visibility.
-
----
-
-## 📊 IDENTIFIED ROOT CAUSES
-
-### 1. **Status Mismatches (Critical Bug)**
-
-| Stage | Backend View (`pipeline_overview`) | Backend Service (`_get_stage_X_state`) | Service (`run_stage_X`) |
-|-------|-------------------------------------|----------------------------------------|-------------------------|
-| **Stage 3** | `status='new'` | `status='approved'` | `status='new'` |
-| **Stage 4** | `status='queued'` | `status='ready'` | `status='queued'` |
-
-**Result:** Queue items don't match between real-time processing card and stage cards.
-
-### 2. **Progress Calculation Flaws**
-
-**Frontend** (CurrentProcessingCard.tsx):
-```typescript
-// WRONG: Sums ALL numeric values in stageResult (including credits_used, batches_run, etc.)
-const processed = stageResult ? Object.values(stageResult).reduce((s: number, v: any) => 
-  typeof v === 'number' ? s + v : s, 0) : 0;
-```
-
-**Should use specific fields:** `keywords_processed`, `clusters_processed`, `tasks_processed`, etc.
-
-### 3. **"Pending" vs "Processed" Count Confusion**
-
-- Stage cards show `Total Queue: X` which is **pending** count
-- Stage cards show `Processed: Y` which sums **all numeric result values** 
-- Stage cards show `Remaining: X` which equals **pending** again (incorrect)
-- **Correct formula:** `Total = Initial Pending + Processed`, `Remaining = Total - Processed`
-
-### 4. **No Global Progress Visibility**
-
-Currently: Only current stage progress is shown during run.
-
-**Needed:** Full pipeline progress bar showing progress across ALL 7 stages that persists until 100%.
-
-### 5. **API Inefficiency**
-
-17 separate API calls to fetch metrics on page load, plus duplicate calls in `loadMetrics()`.
-
----
-
-## 🏗️ ARCHITECTURE REDESIGN
-
-### New Data Model: Run Progress Snapshot
-
-Add these fields to `AutomationRun` for accurate global tracking:
-
-```python
-# AutomationRun Model Additions
-class AutomationRun(models.Model):
-    # ... existing fields ...
-    
-    # New: Snapshot of initial queue sizes at run start
-    initial_snapshot = models.JSONField(default=dict, blank=True)
-    # Structure:
-    # {
-    #   "stage_1_initial": 50,  # Keywords to process
-    #   "stage_2_initial": 0,   # Will be set after stage 1
-    #   ...
-    #   "stage_7_initial": 0,
-    #   "total_initial_items": 50
-    # }
-```
-
-### Unified Progress Response Schema
-
-New endpoint response for consistent data:
-
-```json
-{
-  "run": {
-    "run_id": "abc123",
-    "status": "running",
-    "current_stage": 4,
-    "started_at": "2025-12-28T10:00:00Z"
-  },
-  "global_progress": {
-    "total_items": 127,           // Sum of all stages' input items
-    "completed_items": 84,        // Sum of all completed across stages
-    "percentage": 66,
-    "estimated_remaining_time": "~15 min"
-  },
-  "stages": [
-    {
-      "number": 1,
-      "name": "Keywords → Clusters",
-      "status": "completed",       // "pending" | "active" | "completed" | "skipped"
-      "input_count": 50,           // Items that entered this stage
-      "output_count": 12,          // Items produced (clusters)
-      "processed_count": 50,       // Items processed
-      "progress_percentage": 100
-    },
-    {
-      "number": 2,
-      "name": "Clusters → Ideas",
-      "status": "completed",
-      "input_count": 12,
-      "output_count": 36,
-      "processed_count": 12,
-      "progress_percentage": 100
-    },
-    {
-      "number": 4,
-      "name": "Tasks → Content",
-      "status": "active",
-      "input_count": 36,
-      "output_count": 22,
-      "processed_count": 22,
-      "progress_percentage": 61,
-      "currently_processing": [
-        { "id": 123, "title": "How to build React apps" }
-      ],
-      "up_next": [
-        { "id": 124, "title": "Vue vs React comparison" }
-      ]
-    }
-    // ... etc
-  ],
-  "metrics": {
-    "credits_used": 156,
-    "duration_seconds": 1823,
-    "errors": []
-  }
-}
-```
-
----
-
-## 📝 IMPLEMENTATION PLAN
-
-### Phase 1: Backend Fixes (Critical)
-
-#### 1.1 Fix Status Mismatches
-
-**File:** automation_service.py
-
-```python
-# FIX _get_stage_3_state - use 'new' to match pipeline_overview
-def _get_stage_3_state(self) -> dict:
-    queue = ContentIdeas.objects.filter(
-        site=self.site, status='new'  # Changed from 'approved'
-    ).order_by('id')
-    ...
-
-# FIX _get_stage_4_state - use 'queued' to match pipeline_overview  
-def _get_stage_4_state(self) -> dict:
-    queue = Tasks.objects.filter(
-        site=self.site, status='queued'  # Changed from 'ready'
-    ).order_by('id')
-    ...
-```
-
-#### 1.2 Fix `_get_processed_count()` Method
-
-Current code sums wrong fields. Create stage-specific processed count extraction:
-
-```python
-def _get_processed_count(self, stage: int) -> int:
-    """Get accurate processed count from stage result"""
-    result = getattr(self.run, f'stage_{stage}_result', None)
-    if not result:
-        return 0
-    
-    # Map stage to correct result key
-    key_map = {
-        1: 'keywords_processed',
-        2: 'clusters_processed', 
-        3: 'ideas_processed',
-        4: 'tasks_processed',
-        5: 'content_processed',
-        6: 'images_processed',
-        7: 'ready_for_review'
-    }
-    return result.get(key_map.get(stage, ''), 0)
-```
-
-#### 1.3 New Unified Progress Endpoint
-
-**File:** views.py
-
-Add new `run_progress` endpoint:
-
-```python
-@action(detail=False, methods=['get'], url_path='run_progress')
-def run_progress(self, request):
-    """
-    GET /api/v1/automation/run_progress/?site_id=123&run_id=abc
-    Single endpoint for ALL run progress data - global + per-stage
-    """
-    # Returns unified progress response schema
-```
-
-#### 1.4 Capture Initial Snapshot on Run Start
-
-**File:** automation_service.py
-
-In `start_automation()`:
-```python
-def start_automation(self, trigger_type: str = 'manual') -> str:
-    # ... existing code ...
-    
-    # Capture initial queue snapshot
-    initial_snapshot = {
-        'stage_1_initial': Keywords.objects.filter(site=self.site, status='new', cluster__isnull=True, disabled=False).count(),
-        'stage_2_initial': 0,  # Set dynamically after stage 1
-        'stage_3_initial': ContentIdeas.objects.filter(site=self.site, status='new').count(),
-        'stage_4_initial': Tasks.objects.filter(site=self.site, status='queued').count(),
-        'stage_5_initial': Content.objects.filter(site=self.site, status='draft').annotate(images_count=Count('images')).filter(images_count=0).count(),
-        'stage_6_initial': Images.objects.filter(site=self.site, status='pending').count(),
-        'stage_7_initial': Content.objects.filter(site=self.site, status='review').count(),
-    }
-    initial_snapshot['total_initial_items'] = sum(initial_snapshot.values())
-    
-    self.run = AutomationRun.objects.create(
-        # ... existing fields ...
-        initial_snapshot=initial_snapshot
-    )
-```
-
----
-
-### Phase 2: Frontend Fixes
-
-#### 2.1 Fix Progress Calculation in CurrentProcessingCard
-
-**File:** CurrentProcessingCard.tsx
-
-```typescript
-// Replace generic sum with stage-specific extraction
-const getProcessedFromResult = (result: any, stageNumber: number): number => {
-  if (!result) return 0;
-  
-  const keyMap: Record<number, string> = {
-    1: 'keywords_processed',
-    2: 'clusters_processed',
-    3: 'ideas_processed',
-    4: 'tasks_processed',
-    5: 'content_processed',
-    6: 'images_processed',
-    7: 'ready_for_review'
-  };
-  
-  return result[keyMap[stageNumber]] ?? 0;
-};
-```
-
-#### 2.2 Fix Stage Card Metrics
-
-**File:** AutomationPage.tsx
-
-```typescript
-// Current (WRONG):
-const processed = result ? Object.values(result).reduce((sum, val) => typeof val === 'number' ? sum + val : sum, 0) : 0;
-const total = (stage.pending ?? 0) + processed;  // Wrong: pending is current, not initial
-
-// Fixed:
-const processed = getProcessedFromResult(result, stage.number);
-const initialPending = currentRun?.initial_snapshot?.[`stage_${stage.number}_initial`] ?? stage.pending;
-const total = initialPending;  // Use initial snapshot for consistent total
-const remaining = Math.max(0, total - processed);
-```
-
-#### 2.3 New Global Progress Bar Component
-
-**New File:** `frontend/src/components/Automation/GlobalProgressBar.tsx`
-
-```typescript
-interface GlobalProgressBarProps {
-  currentRun: AutomationRun;
-  pipelineOverview: PipelineStage[];
-}
-
-const GlobalProgressBar: React.FC<GlobalProgressBarProps> = ({ currentRun, pipelineOverview }) => {
-  // Calculate total progress across all stages
-  const calculateGlobalProgress = () => {
-    if (!currentRun?.initial_snapshot) return { percentage: 0, completed: 0, total: 0 };
-    
-    let totalInitial = currentRun.initial_snapshot.total_initial_items || 0;
-    let totalCompleted = 0;
-    
-    for (let i = 1; i <= 7; i++) {
-      const result = currentRun[`stage_${i}_result`];
-      if (result) {
-        totalCompleted += getProcessedFromResult(result, i);
-      }
-    }
-    
-    // If current stage is active, add its progress
-    const currentStage = currentRun.current_stage;
-    // ... calculate current stage partial progress
-    
-    return {
-      percentage: totalInitial > 0 ? Math.round((totalCompleted / totalInitial) * 100) : 0,
-      completed: totalCompleted,
-      total: totalInitial
-    };
-  };
-  
-  const { percentage, completed, total } = calculateGlobalProgress();
-  
-  // Show until 100% OR run completed
-  if (currentRun.status === 'completed' && percentage === 100) {
-    return null;
-  }
-  
-  return (
-    <div className="bg-gradient-to-r from-brand-50 to-brand-100 border-2 border-brand-300 rounded-xl p-4 mb-6">
-      <div className="flex justify-between items-center mb-2">
-        <div className="flex items-center gap-2">
-          <BoltIcon className="w-5 h-5 text-brand-600 animate-pulse" />
-          <span className="font-bold text-brand-800">Full Pipeline Progress</span>
-        </div>
-        <span className="text-2xl font-bold text-brand-600">{percentage}%</span>
-      </div>
-      
-      {/* Segmented progress bar showing all 7 stages */}
-      <div className="flex h-4 rounded-full overflow-hidden bg-gray-200">
-        {[1, 2, 3, 4, 5, 6, 7].map(stageNum => {
-          const stageConfig = STAGE_CONFIG[stageNum - 1];
-          const result = currentRun[`stage_${stageNum}_result`];
-          const stageComplete = currentRun.current_stage > stageNum;
-          const isActive = currentRun.current_stage === stageNum;
-          
-          return (
-            <div
-              key={stageNum}
-              className={`flex-1 transition-all duration-500 ${
-                stageComplete ? `bg-gradient-to-r ${stageConfig.color}` :
-                isActive ? `bg-gradient-to-r ${stageConfig.color} opacity-60 animate-pulse` :
-                'bg-gray-300'
-              }`}
-              title={`Stage ${stageNum}: ${stageConfig.name}`}
-            />
-          );
-        })}
-      </div>
-      
-      <div className="flex justify-between text-xs text-gray-600 mt-2">
-        <span>{completed} / {total} items processed</span>
-        <span>Stage {currentRun.current_stage} of 7</span>
-      </div>
-    </div>
-  );
-};
-```
-
-#### 2.4 Consolidate API Calls
-
-**File:** AutomationPage.tsx
-
-Replace 17 separate API calls with single unified endpoint:
-
-```typescript
-// Current (17 calls):
-const [keywordsTotalRes, keywordsNewRes, keywordsMappedRes, ...14 more] = await Promise.all([...]);
-
-// New (1 call):
-const progressData = await automationService.getRunProgress(activeSite.id, currentRun?.run_id);
-// Response contains everything: metrics, stage counts, progress data
-```
-
----
-
-### Phase 3: Stage Card Redesign
-
-#### 3.1 New Stage Card Layout
-
-Each stage card shows:
-
-```
-┌────────────────────────────────────────────┐
-│  Stage 1    [ICON]    ● Active             │
-│  Keywords → Clusters                        │
-├────────────────────────────────────────────┤
-│  Total Items:      50                       │
-│  Processed:        32     ████████░░ 64%   │
-│  Remaining:        18                       │
-├────────────────────────────────────────────┤
-│  Output Created:   8 clusters               │
-│  Credits Used:     24                       │
-│  Duration:         4m 32s                   │
-└────────────────────────────────────────────┘
-```
-
-#### 3.2 Status Badge Logic
-
-```typescript
-const getStageStatus = (stageNum: number, currentRun: AutomationRun | null) => {
-  if (!currentRun) {
-    // No run - show if items pending
-    return pipelineOverview[stageNum - 1]?.pending > 0 ? 'ready' : 'empty';
-  }
-  
-  if (currentRun.current_stage > stageNum) return 'completed';
-  if (currentRun.current_stage === stageNum) return 'active';
-  if (currentRun.current_stage < stageNum) {
-    // Check if previous stage produced items for this stage
-    const prevResult = currentRun[`stage_${stageNum - 1}_result`];
-    if (prevResult?.output_count > 0) return 'ready';
-    return 'pending';
-  }
-  return 'pending';
-};
-```
-
----
-
-### Phase 4: Real-time Updates Optimization
-
-#### 4.1 Smart Polling with Exponential Backoff
-
-```typescript
-// Current: Fixed 5s interval
-const interval = setInterval(loadData, 5000);
-
-// New: Adaptive polling
-const useSmartPolling = (isRunning: boolean) => {
-  const [pollInterval, setPollInterval] = useState(2000);
-  
-  useEffect(() => {
-    if (!isRunning) {
-      setPollInterval(30000); // Slow poll when idle
-      return;
-    }
-    
-    // Fast poll during active run, slow down as stage progresses
-    const progressPercent = /* current stage progress */;
-    if (progressPercent < 50) {
-      setPollInterval(2000);  // 2s when lots happening
-    } else if (progressPercent < 90) {
-      setPollInterval(3000);  // 3s mid-stage
-    } else {
-      setPollInterval(1000);  // 1s near completion for responsive transition
-    }
-  }, [isRunning, progressPercent]);
-  
-  return pollInterval;
-};
-```
-
-#### 4.2 Optimistic UI Updates
-
-When user clicks "Run Now":
-1. Immediately show GlobalProgressBar at 0%
-2. Immediately set Stage 1 to "Active" 
-3. Don't wait for API confirmation
-
----
-
-## 📋 DETAILED CHECKLIST
-
-### Backend Tasks
-- [x] Fix `_get_stage_3_state()` status filter: `'approved'` → `'new'` ✅ DONE
-- [x] Fix `_get_stage_4_state()` status filter: `'ready'` → `'queued'` ✅ DONE
-- [x] Create `_get_processed_for_stage(stage_num)` helper ✅ DONE (renamed to `_get_processed_count`)
-- [x] Add `initial_snapshot` JSON field to `AutomationRun` model ✅ DONE
-- [x] Capture initial snapshot in `start_automation()` ✅ DONE
-- [ ] Update snapshot after each stage completes (for cascading stages)
-- [x] Create new `run_progress` endpoint with unified schema ✅ DONE
-- [x] Add migration for new model field ✅ DONE (0006_automationrun_initial_snapshot.py)
-
-### Frontend Tasks
-- [x] Create `GlobalProgressBar` component ✅ DONE
-- [x] Add `GlobalProgressBar` to AutomationPage (below metrics, above CurrentProcessingCard) ✅ DONE
-- [x] Fix `getProcessedFromResult()` helper to extract stage-specific counts ✅ DONE
-- [x] Update stage card progress calculations ✅ DONE
-- [x] Update `CurrentProcessingCard` progress calculations ✅ DONE
-- [x] Add `getRunProgress` method to automationService.ts ✅ DONE
-- [ ] Consolidate metrics API calls to single endpoint
-- [ ] Implement smart polling with adaptive intervals
-- [ ] Add optimistic UI updates for "Run Now" action
-- [x] Fix "Remaining" count to be `Total - Processed` not `Pending` ✅ DONE
-
-### Testing
-- [ ] Test all 7 stages complete correctly
-- [ ] Verify counts match between stage cards and processing card
-- [ ] Test pause/resume preserves progress correctly
-- [ ] Test page refresh during run shows correct state
-- [ ] Test global progress bar persists until 100%
-- [ ] Load test: Verify API efficiency improvement
-
----
-
-## 🎯 SUCCESS CRITERIA
-
-1. **Accurate Counts:** All stage cards show correct Total/Processed/Remaining
-2. **Consistent Data:** CurrentProcessingCard and Stage Cards show same numbers
-3. **Global Visibility:** Users see full pipeline progress at all times during run
-4. **Persistent Progress:** Progress bar stays visible until 100% complete
-5. **Real-time Feel:** Updates appear within 2-3 seconds of actual progress
-6. **API Efficiency:** Reduce API calls from 17+ to 1-2 per refresh cycle
-
----
-
-## 🔄 MIGRATION PATH
-
-1. **Phase 1 (Day 1):** Backend status fixes + new processed count logic
-2. **Phase 2 (Day 2):** Frontend progress calculation fixes
-3. **Phase 3 (Day 3):** Global Progress Bar + API consolidation
-4. **Phase 4 (Day 4):** Smart polling + optimistic updates
-5. **Phase 5 (Day 5):** Testing + bug fixes
-
----
-
-This plan provides a clear, implementable path to fix all automation page issues. Each phase can be implemented independently, and the plan contains enough detail that any AI model or developer can execute it in a future session.
-
----
-
-#Implementation status
-
---
-
-## ✅ Verification Complete
-
-### Migration Applied Successfully
-```
-Running migrations: Applying automation.0006_automationrun_initial_snapshot... OK
-```
-
-### Verification Against Plan Requirements
-
-| Plan Requirement | Status | Implementation |
-|-----------------|--------|----------------|
-| **Fix _get_stage_3_state** (approved→new) | ✅ | automation_service.py: `status='new'` |
-| **Fix _get_stage_4_state** (ready→queued) | ✅ | automation_service.py: `status='queued'` |
-| **Fix _get_processed_count** | ✅ | automation_service.py: Uses stage-specific keys |
-| **Add initial_snapshot field** | ✅ | Migration applied, field exists in model |
-| **Capture snapshot on run start** | ✅ | automation_service.py: `_capture_initial_snapshot()` called |
-| **New run_progress endpoint** | ✅ | views.py: `/run_progress/` endpoint |
-| **GlobalProgressBar component** | ✅ | GlobalProgressBar.tsx created |
-| **Fix frontend progress calculations** | ✅ | Both AutomationPage and CurrentProcessingCard use `getProcessedFromResult()` |
-| **getRunProgress in automationService** | ✅ | automationService.ts |
-
-### Alignment with Your Initial Instructions
-
-Your requirements from the plan file:
-1. ✅ **"wrong queue items"** → Fixed status mismatches (approved→new, ready→queued)
-2. ✅ **"missing queue items"** → Consistent status filters across all views
-3. ✅ **"progress bar not properly progress"** → Fixed `getProcessedFromResult()` to use correct keys
-4. ✅ **"total in queue and processed counts buggy"** → Uses initial_snapshot for accurate totals
-5. ✅ **"manual run full all stages progress bar"** → GlobalProgressBar component shows all 7 stages
-6. ✅ **"always keep showing unless 100% complete"** → Component hides only when `status === 'completed' && percentage >= 100`
-
-### AI Functions NOT Modified
-All AI functions remain unchanged:
-- auto_cluster.py - ✅ Untouched
-- generate_ideas.py - ✅ Untouched  
-- generate_content.py - ✅ Untouched
-- generate_image_prompts.py - ✅ Untouched
-- generate_images.py - ✅ Untouched
-- optimize_content.py - ✅ Untouched
-
-The changes only affect **progress tracking and display**, not the actual AI processing logic.
\ No newline at end of file
diff --git a/frontend/package.json b/frontend/package.json
index 65815664..3b54364c 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,7 +1,7 @@
 {
   "name": "tailadmin-react",
   "private": true,
-  "version": "1.7.0",
+  "version": "1.8.4",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/frontend/src/pages/Help/Help.tsx b/frontend/src/pages/Help/Help.tsx
index 1743af72..81780b23 100644
--- a/frontend/src/pages/Help/Help.tsx
+++ b/frontend/src/pages/Help/Help.tsx
@@ -109,9 +109,10 @@ function AutomationPipelineVisual() {
 function CreditSystemVisual() {
   const operations = [
     { name: "Content Generation", credits: "Token-based", color: "bg-brand-100 dark:bg-brand-900/30 border-brand-300" },
-    { name: "Image Generation (Basic)", credits: "5 credits", color: "bg-purple-100 dark:bg-purple-900/30 border-purple-300" },
-    { name: "Image Generation (Premium)", credits: "25 credits", color: "bg-warning-100 dark:bg-warning-900/30 border-warning-300" },
-    { name: "Keyword Clustering", credits: "Token-based", color: "bg-success-100 dark:bg-success-900/30 border-success-300" },
+    { name: "Image Generation (Basic)", credits: "1 credit", color: "bg-success-100 dark:bg-success-900/30 border-success-300" },
+    { name: "Image Generation (Quality)", credits: "5 credits", color: "bg-purple-100 dark:bg-purple-900/30 border-purple-300" },
+    { name: "Image Generation (Premium)", credits: "15 credits", color: "bg-warning-100 dark:bg-warning-900/30 border-warning-300" },
+    { name: "Keyword Clustering", credits: "Token-based", color: "bg-brand-100 dark:bg-brand-900/30 border-brand-300" },
     { name: "Idea Generation", credits: "Token-based", color: "bg-brand-100 dark:bg-brand-900/30 border-brand-300" },
   ];
 
@@ -230,7 +231,7 @@ export default function Help() {
     },
     {
       question: "What is the complete workflow from keywords to published content?",
-      answer: "IGNY8 follows an 8-stage pipeline: 1) Add keywords from Opportunities or CSV, 2) Cluster related keywords, 3) Generate content ideas from clusters, 4) Create tasks from ideas, 5) Generate AI content from tasks, 6) Generate featured and in-article images, 7) Review and approve content, 8) Publish to your site. You can automate most of these steps in the Automation page."
+      answer: "IGNY8 follows an 8-stage pipeline: 1) Add keywords from Keywords Library or CSV, 2) Cluster related keywords, 3) Generate content ideas from clusters, 4) Queue ideas to writer, 5) Generate AI content from tasks, 6) Generate featured and in-article images, 7) Review and approve content, 8) Publish to your site. You can automate most of these steps in the Automation page."
     },
     {
       question: "How do I set up automation?",
@@ -238,11 +239,11 @@ export default function Help() {
     },
     {
       question: "Can I edit AI-generated content?",
-      answer: "Yes! All AI-generated content can be edited. Go to Writer → Content, click on any content piece to open the HTML editor, and make your changes. You can also regenerate content if needed."
+      answer: "Yes! All AI-generated content can be edited. Go to Writer → Content Drafts, click on any content piece to open the HTML editor, and make your changes. You can also regenerate content if needed."
     },
     {
       question: "How are images generated?",
-      answer: "Images are generated using IGNY8 AI (Premium quality or Basic quality) based on your content. Go to Writer → Images to see all generated images. You can generate featured images and in-article images, regenerate them if needed, and they automatically sync to your site when publishing."
+      answer: "Images are generated using IGNY8 AI (Basic, Quality, or Premium tiers) based on your content. Go to Writer → Content Images to see all generated images. You can generate featured images and in-article images, regenerate them if needed, and they automatically sync to your site when publishing."
     },
     {
       question: "What is the difference between Tasks and Content?",
@@ -254,11 +255,11 @@ export default function Help() {
     },
     {
       question: "How do credits work?",
-      answer: "Credits are your currency for AI operations. Text operations (content, clustering, ideas) are token-based - actual tokens used are converted to credits. Image generation uses fixed credits: 5 credits for basic images, 25 credits for premium images. Your plan includes monthly credits that reset each billing period."
+      answer: "Credits are your currency for AI operations. Text operations (content, clustering, ideas) are token-based - actual tokens used are converted to credits. Image generation uses fixed credits: 1 credit for Basic, 5 credits for Quality, and 15 credits for Premium images. Your plan includes monthly credits that reset each billing period. Bonus credits purchased separately never expire."
     },
     {
-      question: "What are the 4 usage limits?",
-      answer: "IGNY8 has 4 simplified limits: 1) Content Generation - monthly words/tokens for AI content, 2) Image Generation - monthly images (basic + premium), 3) Storage - total content and media storage, 4) API Calls - monthly API request limit. View these in Account → Usage."
+      question: "What are the usage limits?",
+      answer: "IGNY8 has 4 limits: 3 hard limits (Sites, Users, Keywords per your plan) that never reset, and 1 monthly limit (Ahrefs keyword research queries). All content and image generation is credit-based with no separate limits - you simply spend credits for AI operations."
     },
     {
       question: "How do I purchase more credits?",
@@ -274,7 +275,7 @@ export default function Help() {
     },
     {
       question: "Can I schedule content publishing?",
-      answer: "Yes! Use the Publisher → Calendar to schedule content for specific dates and times. You can set up scheduled publishing to automatically publish approved content at your preferred times."
+      answer: "Yes! Use the Publisher → Content Calendar to schedule content for specific dates and times. You can set up scheduled publishing to automatically publish approved content at your preferred times."
     },
     {
       question: "What payment methods are supported?",
@@ -282,7 +283,7 @@ export default function Help() {
     },
     {
       question: "How do team roles work?",
-      answer: "IGNY8 has 5 roles: Developer (all accounts), Admin (full account access), Manager (content + billing), Editor (AI content only), Viewer (read-only). Admins can invite team members and assign roles in Account → Settings → Team."
+      answer: "IGNY8 has 5 roles: Developer (internal super admin), Owner (account owner with full access), Admin (full account access including billing and team), Editor (content creation only), Viewer (read-only access). Owners and Admins can invite team members and assign roles in Account → Settings → Team."
     },
     {
       question: "Can I export my data?",
@@ -365,7 +366,7 @@ export default function Help() {
                     <div className="flex-1">
                       <h4 className="font-semibold text-gray-900 dark:text-white mb-1">Add Keywords to Your Workflow</h4>
                       <p className="text-gray-600 dark:text-gray-400 text-sm">
-                        Go to Setup → Add Keywords to browse our curated keyword database. Select keywords relevant to your industry and add them to your workflow.
+                        Go to Setup → Keywords Library to browse our curated keyword database. Select keywords relevant to your industry and add them to your workflow.
                       </p>
                     </div>
                   </div>
@@ -399,9 +400,9 @@ export default function Help() {
                       5
                     </div>
                     <div className="flex-1">
-                      <h4 className="font-semibold text-gray-900 dark:text-white mb-1">Create Tasks & Generate Content</h4>
+                      <h4 className="font-semibold text-gray-900 dark:text-white mb-1">Queue Tasks & Generate Content</h4>
                       <p className="text-gray-600 dark:text-gray-400 text-sm">
-                        Convert ideas to tasks in Planner → Ideas, then go to Writer → Tasks to generate full AI articles.
+                        Queue ideas to writer in Planner → Ideas using "Queue to Writer", then go to Writer → Content Queue to generate full AI articles.
                       </p>
                     </div>
                   </div>
@@ -413,7 +414,7 @@ export default function Help() {
                     <div className="flex-1">
                       <h4 className="font-semibold text-gray-900 dark:text-white mb-1">Generate Images</h4>
                       <p className="text-gray-600 dark:text-gray-400 text-sm">
-                        Go to Writer → Images to generate featured and in-article images for your content using AI.
+                        Go to Writer → Content Images to generate featured and in-article images for your content using AI.
                       </p>
                     </div>
                   </div>
@@ -425,7 +426,7 @@ export default function Help() {
                     <div className="flex-1">
                       <h4 className="font-semibold text-gray-900 dark:text-white mb-1">Review & Approve</h4>
                       <p className="text-gray-600 dark:text-gray-400 text-sm">
-                        Review your content in Writer → Content, make edits as needed, and approve content ready for publishing.
+                        Review your content in Writer → Content Drafts or Publisher → Content Review, make edits as needed, and approve content ready for publishing.
                       </p>
                     </div>
                   </div>
@@ -437,7 +438,7 @@ export default function Help() {
                     <div className="flex-1">
                       <h4 className="font-semibold text-gray-900 dark:text-white mb-1">Publish to your site</h4>
                       <p className="text-gray-600 dark:text-gray-400 text-sm">
-                        Click "Publish" to send your content to your site, or use Publisher → Calendar to schedule publications.
+                        Go to Publisher → Publish / Schedule to publish content, or use Publisher → Content Calendar to schedule publications.
                       </p>
                     </div>
                   </div>
@@ -579,7 +580,7 @@ export default function Help() {
                 <div className="bg-gray-50 dark:bg-gray-800/50 p-4 rounded-lg">
                   <h4 className="font-semibold text-gray-900 dark:text-white mb-2">How to Add Keywords:</h4>
                   <ol className="list-decimal list-inside space-y-2 text-sm text-gray-600 dark:text-gray-400">
-                    <li>Navigate to <strong>Setup → Add Keywords</strong></li>
+                    <li>Navigate to <strong>Setup → Keywords Library</strong></li>
                     <li>Keywords are filtered by your site's industry/sector</li>
                     <li>Use filters: search, country, difficulty, volume range</li>
                     <li>Toggle "Not Yet Added Only" to see available keywords</li>
@@ -626,7 +627,7 @@ export default function Help() {
                   <div className="border-l-4 border-purple-500 pl-4">
                     <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Image Settings Tab</h4>
                     <ul className="list-disc list-inside text-sm text-gray-600 dark:text-gray-400 space-y-1">
-                      <li><strong>Image Quality:</strong> Basic or Premium (powered by IGNY8 AI)</li>
+                      <li><strong>Image Quality:</strong> Basic, Quality, or Premium (powered by IGNY8 AI)</li>
                       <li><strong>Image Style:</strong> Photorealistic, Illustrated, Abstract</li>
                       <li><strong>Default Size:</strong> 1024x1024, 1792x1024, 1024x1792</li>
                     </ul>
@@ -781,7 +782,7 @@ export default function Help() {
                   <div className="border-l-4 border-success-500 pl-4">
                     <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Idea to Task</h4>
                     <p className="text-sm text-gray-600 dark:text-gray-400">
-                      Select ideas and click "Convert to Tasks" to create writing assignments. Tasks appear in Writer → Tasks for content generation.
+                      Select ideas and click "Queue to Writer" to create writing assignments. Tasks appear in Writer → Content Queue for content generation.
                     </p>
                   </div>
                 </div>
@@ -804,14 +805,10 @@ export default function Help() {
                   Tasks are content ideas converted into actionable writing assignments with status tracking.
                 </p>
 
-                <div className="grid grid-cols-1 md:grid-cols-3 gap-3">
-                  <div className="bg-gray-100 dark:bg-gray-800 p-3 rounded-lg text-center">
-                    <div className="font-bold text-gray-900 dark:text-white">Pending</div>
-                    <div className="text-sm text-gray-500">Awaiting content generation</div>
-                  </div>
-                  <div className="bg-brand-100 dark:bg-brand-900/30 p-3 rounded-lg text-center">
-                    <div className="font-bold text-brand-700 dark:text-brand-300">In Progress</div>
-                    <div className="text-sm text-brand-600 dark:text-brand-400">Content being generated</div>
+                <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
+                  <div className="bg-warning-100 dark:bg-warning-900/30 p-3 rounded-lg text-center">
+                    <div className="font-bold text-warning-700 dark:text-warning-300">Queued</div>
+                    <div className="text-sm text-warning-600 dark:text-warning-400">Awaiting content generation</div>
                   </div>
                   <div className="bg-success-100 dark:bg-success-900/30 p-3 rounded-lg text-center">
                     <div className="font-bold text-success-700 dark:text-success-300">Completed</div>
@@ -869,7 +866,7 @@ export default function Help() {
                   <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Content Statuses</h4>
                   <ul className="list-disc list-inside text-sm text-gray-600 dark:text-gray-400 space-y-1">
                     <li><strong>Draft:</strong> Initial AI-generated content</li>
-                    <li><strong>In Review:</strong> Being edited/reviewed</li>
+                    <li><strong>Review:</strong> Being edited/reviewed</li>
                     <li><strong>Approved:</strong> Ready for publishing</li>
                     <li><strong>Published:</strong> Live on your site</li>
                   </ul>
@@ -904,8 +901,9 @@ export default function Help() {
                 <div className="bg-gray-50 dark:bg-gray-800/50 p-4 rounded-lg">
                   <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Image Generation Options:</h4>
                   <ul className="list-disc list-inside text-sm text-gray-600 dark:text-gray-400 space-y-1">
-                    <li><strong>Basic (5 credits):</strong> Fast generation, good quality</li>
-                    <li><strong>Premium (25 credits):</strong> Highest quality</li>
+                    <li><strong>Basic (1 credit):</strong> Fast generation, cost-effective</li>
+                    <li><strong>Quality (5 credits):</strong> Balanced quality and cost</li>
+                    <li><strong>Premium (15 credits):</strong> Highest quality images</li>
                     <li><strong>Sizes:</strong> 1024x1024, 1792x1024, 1024x1792</li>
                     <li><strong>Styles:</strong> Photorealistic, Illustrated, Abstract</li>
                   </ul>
@@ -1106,9 +1104,9 @@ export default function Help() {
                   <div className="border-l-4 border-purple-500 pl-4">
                     <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Image Generation</h4>
                     <ul className="list-disc list-inside text-sm text-gray-600 dark:text-gray-400 space-y-1">
-                      <li><strong>Premium Quality:</strong> Highest quality images</li>
-                      <li><strong>Basic Quality:</strong> Fast, cost-effective images</li>
-                      <li><strong>Image Editing:</strong> Background removal & editing</li>
+                      <li><strong>Basic (1 credit):</strong> Fast, cost-effective images</li>
+                      <li><strong>Quality (5 credits):</strong> Balanced quality and cost</li>
+                      <li><strong>Premium (15 credits):</strong> Highest quality images</li>
                     </ul>
                   </div>
                 </div>
@@ -1146,7 +1144,7 @@ export default function Help() {
                   <div className="border-l-4 border-purple-500 pl-4">
                     <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Fixed-Cost Operations</h4>
                     <p className="text-sm text-gray-600 dark:text-gray-400">
-                      Image generation uses fixed credits: 5 for Basic quality, 25 for Premium quality.
+                      Image generation uses fixed credits: 1 for Basic, 5 for Quality, and 15 for Premium.
                     </p>
                   </div>
                 </div>
@@ -1198,42 +1196,42 @@ export default function Help() {
             <AccordionItem title="Usage & Limits">
               <div className="space-y-4">
                 <p className="text-gray-700 dark:text-gray-300">
-                  IGNY8 has 4 simplified usage limits. Track your usage in Account → Usage.
+                  IGNY8 has simple limits: 3 hard limits and 1 monthly limit. All AI operations use credits.
                 </p>
 
                 <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
                   <div className="bg-brand-50 dark:bg-brand-900/30 p-4 rounded-lg">
-                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Content Generation</h4>
+                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Sites</h4>
                     <p className="text-sm text-gray-600 dark:text-gray-400">
-                      Monthly words/tokens for AI content. Resets each billing cycle.
+                      Maximum websites per account. Hard limit based on plan.
                     </p>
                   </div>
 
                   <div className="bg-purple-50 dark:bg-purple-900/30 p-4 rounded-lg">
-                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Image Generation</h4>
+                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Team Members</h4>
                     <p className="text-sm text-gray-600 dark:text-gray-400">
-                      Monthly images (basic + premium). Resets each billing cycle.
+                      Maximum users per account. Hard limit based on plan.
                     </p>
                   </div>
 
                   <div className="bg-success-50 dark:bg-success-900/30 p-4 rounded-lg">
-                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Storage</h4>
+                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Keywords</h4>
                     <p className="text-sm text-gray-600 dark:text-gray-400">
-                      Total content and media storage. Does not reset.
+                      Maximum total keywords. Hard limit based on plan.
                     </p>
                   </div>
 
                   <div className="bg-warning-50 dark:bg-warning-900/30 p-4 rounded-lg">
-                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">API Calls</h4>
+                    <h4 className="font-semibold text-gray-900 dark:text-white mb-2">Ahrefs Queries</h4>
                     <p className="text-sm text-gray-600 dark:text-gray-400">
-                      Monthly API requests. Resets each billing cycle.
+                      Monthly keyword research queries. Resets each billing cycle.
                     </p>
                   </div>
                 </div>
 
-                <div className="bg-warning-50 dark:bg-warning-900/10 p-4 rounded-lg border border-warning-200 dark:border-warning-800 mt-4">
-                  <p className="text-sm text-warning-800 dark:text-warning-300">
-                    <strong>Usage Alerts:</strong> You'll receive automatic notifications at 80%, 90%, and 100% of your limits.
+                <div className="bg-brand-50 dark:bg-brand-900/10 p-4 rounded-lg border border-brand-200 dark:border-brand-800 mt-4">
+                  <p className="text-sm text-brand-800 dark:text-brand-300">
+                    <strong>Credit-Based AI:</strong> Content generation, image generation, clustering, and idea generation all use credits. No separate limits—just spend from your credit balance.
                   </p>
                 </div>
               </div>
@@ -1249,10 +1247,10 @@ export default function Help() {
                 <div className="bg-gray-50 dark:bg-gray-800/50 p-4 rounded-lg">
                   <h4 className="font-semibold text-gray-900 dark:text-white mb-2">User Roles:</h4>
                   <ul className="space-y-2 text-sm text-gray-600 dark:text-gray-400">
-                    <li><strong>Developer:</strong> Full access across all accounts (internal only)</li>
+                    <li><strong>Developer:</strong> Internal super admin with access to all accounts</li>
+                    <li><strong>Owner:</strong> Account owner with full access to everything</li>
                     <li><strong>Admin:</strong> Full account access, billing, team management</li>
-                    <li><strong>Manager:</strong> Content + billing, no team management</li>
-                    <li><strong>Editor:</strong> Content creation only, no billing access</li>
+                    <li><strong>Editor:</strong> Content creation and editing only</li>
                     <li><strong>Viewer:</strong> Read-only access to content</li>
                   </ul>
                 </div>
diff --git a/scripts/verify-docs.sh b/scripts/verify-docs.sh
new file mode 100644
index 00000000..c1bd1f65
--- /dev/null
+++ b/scripts/verify-docs.sh
@@ -0,0 +1,255 @@
+#!/bin/bash
+
+# IGNY8 Documentation Verification Script
+# Version: 1.8.4
+# Purpose: Verify documentation accuracy against codebase
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo "========================================"
+echo "IGNY8 Documentation Verification"
+echo "========================================"
+echo ""
+
+ERRORS=0
+WARNINGS=0
+
+# Function to increment errors
+error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+    ((ERRORS++))
+}
+
+# Function to increment warnings
+warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+    ((WARNINGS++))
+}
+
+# Function for success
+success() {
+    echo -e "${GREEN}[OK]${NC} $1"
+}
+
+# Get script directory
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+BACKEND_DIR="$ROOT_DIR/backend"
+FRONTEND_DIR="$ROOT_DIR/frontend"
+DOCS_DIR="$ROOT_DIR/docs"
+
+echo "Root directory: $ROOT_DIR"
+echo ""
+
+# ============================================
+# 1. Check root documentation files exist
+# ============================================
+echo "--- Checking Root Documentation Files ---"
+
+for file in "INDEX.md" "DESIGN-GUIDE.md" "CHANGELOG.md" "README.md" ".cursorrules"; do
+    if [ -f "$ROOT_DIR/$file" ]; then
+        success "$file exists"
+    else
+        error "$file missing from root"
+    fi
+done
+echo ""
+
+# ============================================
+# 2. Check required docs directories exist
+# ============================================
+echo "--- Checking Documentation Structure ---"
+
+for dir in "00-SYSTEM" "10-MODULES" "20-API" "30-FRONTEND" "40-WORKFLOWS" "50-DEPLOYMENT" "60-PLUGINS" "90-REFERENCE"; do
+    if [ -d "$DOCS_DIR/$dir" ]; then
+        success "docs/$dir exists"
+    else
+        warn "docs/$dir missing"
+    fi
+done
+echo ""
+
+# ============================================
+# 3. Count frontend routes vs documented
+# ============================================
+echo "--- Verifying Route Documentation ---"
+
+if [ -f "$FRONTEND_DIR/src/App.tsx" ]; then
+    ROUTE_COUNT=$(grep -c "path:" "$FRONTEND_DIR/src/App.tsx" 2>/dev/null || echo "0")
+    ROUTE_COUNT=$(echo "$ROUTE_COUNT" | tr -d '[:space:]')
+    echo "Routes in App.tsx: $ROUTE_COUNT"
+    
+    if [ -f "$DOCS_DIR/30-FRONTEND/PAGES.md" ]; then
+        DOC_ROUTES=$(grep -c "^|.*|.*|" "$DOCS_DIR/30-FRONTEND/PAGES.md" 2>/dev/null || echo "0")
+        DOC_ROUTES=$(echo "$DOC_ROUTES" | tr -d '[:space:]')
+        echo "Routes documented: ~$DOC_ROUTES"
+        
+        if [ "$ROUTE_COUNT" -gt 0 ] 2>/dev/null; then
+            success "Routes appear documented"
+        else
+            success "PAGES.md exists"
+        fi
+    else
+        error "PAGES.md not found"
+    fi
+else
+    warn "App.tsx not found - skipping route check"
+fi
+echo ""
+
+# ============================================
+# 4. Count models vs documented
+# ============================================
+echo "--- Verifying Model Documentation ---"
+
+if [ -d "$BACKEND_DIR" ]; then
+    MODEL_COUNT=$(grep -r "class.*models.Model" "$BACKEND_DIR" --include="*.py" 2>/dev/null | wc -l || echo "0")
+    echo "Models in codebase: $MODEL_COUNT"
+    
+    if [ -f "$DOCS_DIR/90-REFERENCE/MODELS.md" ]; then
+        DOC_MODELS=$(grep -c "^###" "$DOCS_DIR/90-REFERENCE/MODELS.md" 2>/dev/null || echo "0")
+        echo "Models documented: ~$DOC_MODELS"
+        success "Models documentation exists"
+    else
+        error "MODELS.md not found"
+    fi
+else
+    warn "Backend directory not found"
+fi
+echo ""
+
+# ============================================
+# 5. Count stores vs documented
+# ============================================
+echo "--- Verifying Store Documentation ---"
+
+if [ -d "$FRONTEND_DIR/src/store" ]; then
+    STORE_COUNT=$(ls -1 "$FRONTEND_DIR/src/store"/*.ts 2>/dev/null | wc -l || echo "0")
+    STORE_COUNT=$(echo "$STORE_COUNT" | tr -d '[:space:]')
+    echo "Stores in codebase: $STORE_COUNT"
+    
+    if [ -f "$DOCS_DIR/30-FRONTEND/STORES.md" ]; then
+        DOC_STORES=$(grep -c "^###" "$DOCS_DIR/30-FRONTEND/STORES.md" 2>/dev/null || echo "0")
+        echo "Stores documented: ~$DOC_STORES"
+        success "Stores documentation exists"
+    else
+        error "STORES.md not found"
+    fi
+elif [ -d "$FRONTEND_DIR/src/stores" ]; then
+    STORE_COUNT=$(ls -1 "$FRONTEND_DIR/src/stores"/*.ts 2>/dev/null | wc -l || echo "0")
+    STORE_COUNT=$(echo "$STORE_COUNT" | tr -d '[:space:]')
+    echo "Stores in codebase: $STORE_COUNT"
+    
+    if [ -f "$DOCS_DIR/30-FRONTEND/STORES.md" ]; then
+        DOC_STORES=$(grep -c "^###" "$DOCS_DIR/30-FRONTEND/STORES.md" 2>/dev/null || echo "0")
+        echo "Stores documented: ~$DOC_STORES"
+        success "Stores documentation exists"
+    else
+        error "STORES.md not found"
+    fi
+else
+    warn "Stores directory not found (checked store/ and stores/)"
+fi
+echo ""
+
+# ============================================
+# 6. Check API docs are accessible
+# ============================================
+echo "--- Verifying API Documentation ---"
+
+API_URL="${API_URL:-https://api.igny8.com}"
+
+if command -v curl &> /dev/null; then
+    echo "Testing API schema endpoint..."
+    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$API_URL/api/schema/" --max-time 10 2>/dev/null || echo "000")
+    
+    if [ "$HTTP_CODE" = "200" ]; then
+        success "API schema endpoint accessible (HTTP $HTTP_CODE)"
+    elif [ "$HTTP_CODE" = "000" ]; then
+        warn "Could not connect to API (timeout or network issue)"
+    else
+        error "API schema endpoint returned HTTP $HTTP_CODE"
+    fi
+else
+    warn "curl not available - skipping API check"
+fi
+echo ""
+
+# ============================================
+# 7. Check for version consistency
+# ============================================
+echo "--- Checking Version Consistency ---"
+
+# Get version from CHANGELOG
+if [ -f "$ROOT_DIR/CHANGELOG.md" ]; then
+    CHANGELOG_VERSION=$(grep -m1 "Current Version:" "$ROOT_DIR/CHANGELOG.md" | sed 's/.*Version:[* ]*//' | tr -d ' *')
+    echo "CHANGELOG version: $CHANGELOG_VERSION"
+fi
+
+# Get version from package.json
+if [ -f "$FRONTEND_DIR/package.json" ]; then
+    PACKAGE_VERSION=$(grep -m1 '"version"' "$FRONTEND_DIR/package.json" | sed 's/.*: "\(.*\)".*/\1/')
+    echo "package.json version: $PACKAGE_VERSION"
+fi
+
+if [ -n "$CHANGELOG_VERSION" ] && [ -n "$PACKAGE_VERSION" ]; then
+    if [ "$CHANGELOG_VERSION" = "$PACKAGE_VERSION" ]; then
+        success "Versions match ($CHANGELOG_VERSION)"
+    else
+        warn "Version mismatch: CHANGELOG=$CHANGELOG_VERSION, package.json=$PACKAGE_VERSION"
+    fi
+fi
+echo ""
+
+# ============================================
+# 8. Check for common issues
+# ============================================
+echo "--- Checking for Common Issues ---"
+
+# Check for duplicate sections in docs
+echo "Checking for duplicates in PAGES.md..."
+if [ -f "$DOCS_DIR/30-FRONTEND/PAGES.md" ]; then
+    DUP_HEADERS=$(grep "^## " "$DOCS_DIR/30-FRONTEND/PAGES.md" | sort | uniq -d | wc -l)
+    if [ "$DUP_HEADERS" -gt 0 ]; then
+        warn "Duplicate section headers found in PAGES.md"
+    else
+        success "No duplicate sections in PAGES.md"
+    fi
+fi
+
+# Check for TODO/FIXME in docs
+echo "Checking for TODO/FIXME markers..."
+TODO_COUNT=$(grep -r "TODO\|FIXME\|XXX" "$DOCS_DIR" --include="*.md" 2>/dev/null | wc -l || echo "0")
+if [ "$TODO_COUNT" -gt 0 ]; then
+    warn "Found $TODO_COUNT TODO/FIXME markers in docs"
+else
+    success "No TODO markers in docs"
+fi
+echo ""
+
+# ============================================
+# Summary
+# ============================================
+echo "========================================"
+echo "VERIFICATION SUMMARY"
+echo "========================================"
+echo -e "Errors:   ${RED}$ERRORS${NC}"
+echo -e "Warnings: ${YELLOW}$WARNINGS${NC}"
+echo ""
+
+if [ "$ERRORS" -gt 0 ]; then
+    echo -e "${RED}Documentation has issues that need attention!${NC}"
+    exit 1
+elif [ "$WARNINGS" -gt 0 ]; then
+    echo -e "${YELLOW}Documentation is mostly good but has some warnings.${NC}"
+    exit 0
+else
+    echo -e "${GREEN}Documentation verification passed!${NC}"
+    exit 0
+fi