docs: Add Phase 0 implementation to CHANGELOG

- Updated CREDIT_COSTS constants to Phase 0 format with new operations
- Enhanced CreditService with get_credit_cost() method and operation_type support
- Created AccountModuleSettings model for module enable/disable functionality
- Added AccountModuleSettingsSerializer and ViewSet
- Registered module settings API endpoint: /api/v1/system/settings/account-modules/
- Maintained backward compatibility with existing credit system

=0.27.0

@@ -1,36 +0,0 @@
-Collecting drf-spectacular
-  Downloading drf_spectacular-0.29.0-py3-none-any.whl.metadata (14 kB)
-Requirement already satisfied: Django>=2.2 in /usr/local/lib/python3.11/site-packages (from drf-spectacular) (5.2.8)
-Requirement already satisfied: djangorestframework>=3.10.3 in /usr/local/lib/python3.11/site-packages (from drf-spectacular) (3.16.1)
-Collecting uritemplate>=2.0.0 (from drf-spectacular)
-  Downloading uritemplate-4.2.0-py3-none-any.whl.metadata (2.6 kB)
-Collecting PyYAML>=5.1 (from drf-spectacular)
-  Downloading pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.metadata (2.4 kB)
-Collecting jsonschema>=2.6.0 (from drf-spectacular)
-  Downloading jsonschema-4.25.1-py3-none-any.whl.metadata (7.6 kB)
-Collecting inflection>=0.3.1 (from drf-spectacular)
-  Downloading inflection-0.5.1-py2.py3-none-any.whl.metadata (1.7 kB)
-Requirement already satisfied: asgiref>=3.8.1 in /usr/local/lib/python3.11/site-packages (from Django>=2.2->drf-spectacular) (3.10.0)
-Requirement already satisfied: sqlparse>=0.3.1 in /usr/local/lib/python3.11/site-packages (from Django>=2.2->drf-spectacular) (0.5.3)
-Collecting attrs>=22.2.0 (from jsonschema>=2.6.0->drf-spectacular)
-  Downloading attrs-25.4.0-py3-none-any.whl.metadata (10 kB)
-Collecting jsonschema-specifications>=2023.03.6 (from jsonschema>=2.6.0->drf-spectacular)
-  Downloading jsonschema_specifications-2025.9.1-py3-none-any.whl.metadata (2.9 kB)
-Collecting referencing>=0.28.4 (from jsonschema>=2.6.0->drf-spectacular)
-  Downloading referencing-0.37.0-py3-none-any.whl.metadata (2.8 kB)
-Collecting rpds-py>=0.7.1 (from jsonschema>=2.6.0->drf-spectacular)
-  Downloading rpds_py-0.28.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.1 kB)
-Requirement already satisfied: typing-extensions>=4.4.0 in /usr/local/lib/python3.11/site-packages (from referencing>=0.28.4->jsonschema>=2.6.0->drf-spectacular) (4.15.0)
-Downloading drf_spectacular-0.29.0-py3-none-any.whl (105 kB)
-Downloading inflection-0.5.1-py2.py3-none-any.whl (9.5 kB)
-Downloading jsonschema-4.25.1-py3-none-any.whl (90 kB)
-Downloading attrs-25.4.0-py3-none-any.whl (67 kB)
-Downloading jsonschema_specifications-2025.9.1-py3-none-any.whl (18 kB)
-Downloading pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (806 kB)
-   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 806.6/806.6 kB 7.8 MB/s  0:00:00
-Downloading referencing-0.37.0-py3-none-any.whl (26 kB)
-Downloading rpds_py-0.28.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (382 kB)
-Downloading uritemplate-4.2.0-py3-none-any.whl (11 kB)
-Installing collected packages: uritemplate, rpds-py, PyYAML, inflection, attrs, referencing, jsonschema-specifications, jsonschema, drf-spectacular
-
-Successfully installed PyYAML-6.0.3 attrs-25.4.0 drf-spectacular-0.29.0 inflection-0.5.1 jsonschema-4.25.1 jsonschema-specifications-2025.9.1 referencing-0.37.0 rpds-py-0.28.0 uritemplate-4.2.0

CHANGELOG.md

@@ -26,6 +26,40 @@ Each entry follows this format:
 
 ## [Unreleased]
 
+### Added
+- **Phase 0: Foundation & Credit System - Initial Implementation**
+  - Updated `CREDIT_COSTS` constants to Phase 0 format with new operations
+    - Added new credit costs: `linking` (8 credits), `optimization` (1 credit per 200 words), `site_structure_generation` (50 credits), `site_page_generation` (20 credits)
+    - Maintained backward compatibility with legacy operation names (`ideas`, `content`, `images`, `reparse`)
+  - Enhanced `CreditService` with `get_credit_cost()` method for dynamic cost calculation
+    - Supports variable costs based on operation type and amount (word count, etc.)
+    - Updated `check_credits()` and `deduct_credits()` to support both legacy `required_credits` parameter and new `operation_type`/`amount` parameters
+    - Maintained full backward compatibility with existing code
+  - Created `AccountModuleSettings` model for module enable/disable functionality
+    - One settings record per account (get_or_create pattern)
+    - Enable/disable flags for all 8 modules: `planner_enabled`, `writer_enabled`, `thinker_enabled`, `automation_enabled`, `site_builder_enabled`, `linker_enabled`, `optimizer_enabled`, `publisher_enabled`
+    - Helper method `is_module_enabled(module_name)` for easy module checking
+  - Added `AccountModuleSettingsSerializer` and `AccountModuleSettingsViewSet`
+    - API endpoint: `/api/v1/system/settings/account-modules/`
+    - Custom action: `check/(?P<module_name>[^/.]+)` to check if a specific module is enabled
+    - Automatic account assignment on create
+    - Unified API Standard v1.0 compliant
+  - **Affected Areas**: Billing module (`constants.py`, `services.py`), System module (`settings_models.py`, `settings_serializers.py`, `settings_views.py`, `urls.py`)
+  - **Documentation**: See `docs/planning/phases/PHASE-0-FOUNDATION-CREDIT-SYSTEM.md` for complete details
+  - **Impact**: Foundation for credit-only system and module-based feature access control
+
+- **Planning Documents Organization**: Organized architecture and implementation planning documents
+  - Created `docs/planning/` directory for all planning documents
+  - Moved `IGNY8-HOLISTIC-ARCHITECTURE-PLAN.md` to `docs/planning/`
+  - Moved `IGNY8-IMPLEMENTATION-PLAN.md` to `docs/planning/`
+  - Moved `Igny8-phase-2-plan.md` to `docs/planning/`
+  - Moved `CONTENT-WORKFLOW-DIAGRAM.md` to `docs/planning/`
+  - Moved `ARCHITECTURE_CONTEXT.md` to `docs/planning/`
+  - Moved `sample-usage-limits-credit-system` to `docs/planning/`
+  - Created `docs/refactor/` directory for refactoring plans
+  - Updated `README.md` to reflect new document structure
+  - **Impact**: Better organization of planning documents, easier to find and maintain
+
 ### Changed
 - **API Documentation Consolidation**: Consolidated all API documentation into single comprehensive reference
   - Created `docs/API-COMPLETE-REFERENCE.md` - Unified API documentation covering all endpoints, authentication, response formats, error handling, rate limiting, permissions, and integration examples

README.md

@@ -45,7 +45,15 @@ igny8/
 │   ├── 04-BACKEND-IMPLEMENTATION.md
 │   ├── 05-AI-FRAMEWORK-IMPLEMENTATION.md
 │   ├── 06-FUNCTIONAL-BUSINESS-LOGIC.md
-│   └── API-COMPLETE-REFERENCE.md  # Complete unified API documentation
+│   ├── API-COMPLETE-REFERENCE.md  # Complete unified API documentation
+│   ├── planning/        # Architecture & implementation planning documents
+│   │   ├── IGNY8-HOLISTIC-ARCHITECTURE-PLAN.md  # Complete architecture plan
+│   │   ├── IGNY8-IMPLEMENTATION-PLAN.md  # Step-by-step implementation plan
+│   │   ├── Igny8-phase-2-plan.md  # Phase 2 feature specifications
+│   │   ├── CONTENT-WORKFLOW-DIAGRAM.md  # Content workflow diagrams
+│   │   ├── ARCHITECTURE_CONTEXT.md  # Architecture context reference
+│   │   └── sample-usage-limits-credit-system  # Credit system specification
+│   └── refactor/        # Refactoring plans and documentation
 ├── CHANGELOG.md         # Version history and changes (only updated after user confirmation)
 └── docker-compose.app.yml
 ```

backend/igny8_core/modules/billing/constants.py

@@ -1,22 +1,25 @@
 """
-Credit Cost Constants
+Credit Cost Constants - Phase 0: Credit-Only System
+All features are unlimited. Only credits restrict usage.
 """
 CREDIT_COSTS = {
-    'clustering': {
+    # Existing operations
-        'base': 1,  # 1 credit per 30 keywords
+    'clustering': 10,                    # Per clustering request
-        'per_keyword': 1 / 30,
+    'idea_generation': 15,              # Per cluster → ideas request
-    },
+    'content_generation': 1,             # Per 100 words
-    'ideas': {
+    'image_prompt_extraction': 2,       # Per content piece
-        'base': 1,  # 1 credit per idea
+    'image_generation': 5,              # Per image
-    },
+    
-    'content': {
+    # Legacy operation names (for backward compatibility)
-        'base': 3,  # 3 credits per full blog post
+    'ideas': 15,                        # Alias for idea_generation
-    },
+    'content': 1,                       # Alias for content_generation (per 100 words)
-    'images': {
+    'images': 5,                        # Alias for image_generation
-        'base': 1,  # 1 credit per image
+    'reparse': 2,                       # Alias for image_prompt_extraction
-    },
+    
-    'reparse': {
+    # NEW: Phase 2+ operations
-        'base': 1,  # 1 credit per reparse
+    'linking': 8,                       # Per content piece (NEW)
-    },
+    'optimization': 1,                  # Per 200 words (NEW)
+    'site_structure_generation': 50,    # Per site blueprint (NEW)
+    'site_page_generation': 20,         # Per page (NEW)
 }
 

backend/igny8_core/modules/billing/services.py

@@ -13,17 +13,49 @@ class CreditService:
     """Service for managing credits"""
     
     @staticmethod
-    def check_credits(account, required_credits):
+    def get_credit_cost(operation_type, amount=None):
+        """
+        Get credit cost for operation.
+        
+        Args:
+            operation_type: Type of operation (from CREDIT_COSTS)
+            amount: Optional amount (word count, etc.) for variable costs
+        
+        Returns:
+            int: Number of credits required
+        """
+        base_cost = CREDIT_COSTS.get(operation_type, 0)
+        
+        # Variable costs based on amount
+        if operation_type == 'content_generation' and amount:
+            # Per 100 words
+            return max(1, int(base_cost * (amount / 100)))
+        elif operation_type == 'optimization' and amount:
+            # Per 200 words
+            return max(1, int(base_cost * (amount / 200)))
+        
+        return base_cost
+    
+    @staticmethod
+    def check_credits(account, required_credits=None, operation_type=None, amount=None):
         """
         Check if account has enough credits.
         
         Args:
             account: Account instance
-            required_credits: Number of credits required
+            required_credits: Number of credits required (legacy parameter)
+            operation_type: Type of operation (new parameter)
+            amount: Optional amount for variable costs (new parameter)
         
         Raises:
             InsufficientCreditsError: If account doesn't have enough credits
         """
+        # Support both old and new API
+        if operation_type:
+            required_credits = CreditService.get_credit_cost(operation_type, amount)
+        elif required_credits is None:
+            raise ValueError("Either required_credits or operation_type must be provided")
+        
         if account.credits < required_credits:
             raise InsufficientCreditsError(
                 f"Insufficient credits. Required: {required_credits}, Available: {account.credits}"
@@ -121,6 +153,9 @@ class CreditService:
         """
         Calculate credits needed for an operation.
         
+        DEPRECATED: Use get_credit_cost() instead.
+        Kept for backward compatibility.
+        
         Args:
             operation_type: Type of operation
             **kwargs: Operation-specific parameters
@@ -131,31 +166,31 @@ class CreditService:
         Raises:
             CreditCalculationError: If calculation fails
         """
-        if operation_type not in CREDIT_COSTS:
+        # Map old operation types to new ones
-            raise CreditCalculationError(f"Unknown operation type: {operation_type}")
+        operation_mapping = {
+            'ideas': 'idea_generation',
+            'content': 'content_generation',
+            'images': 'image_generation',
+            'reparse': 'image_prompt_extraction',
+        }
         
-        cost_config = CREDIT_COSTS[operation_type]
+        mapped_type = operation_mapping.get(operation_type, operation_type)
         
-        if operation_type == 'clustering':
+        # Handle variable costs
-            # 1 credit per 30 keywords
+        if mapped_type == 'content_generation':
+            word_count = kwargs.get('word_count') or kwargs.get('content_count', 1000) * 100
+            return CreditService.get_credit_cost(mapped_type, word_count)
+        elif mapped_type == 'clustering':
             keyword_count = kwargs.get('keyword_count', 0)
-            credits = max(1, int(keyword_count * cost_config['per_keyword']))
+            # Clustering is fixed cost per request
-            return credits
+            return CreditService.get_credit_cost(mapped_type)
-        elif operation_type == 'ideas':
+        elif mapped_type == 'idea_generation':
-            # 1 credit per idea
             idea_count = kwargs.get('idea_count', 1)
-            return cost_config['base'] * idea_count
+            # Fixed cost per request
-        elif operation_type == 'content':
+            return CreditService.get_credit_cost(mapped_type)
-            # 3 credits per content piece
+        elif mapped_type == 'image_generation':
-            content_count = kwargs.get('content_count', 1)
-            return cost_config['base'] * content_count
-        elif operation_type == 'images':
-            # 1 credit per image
             image_count = kwargs.get('image_count', 1)
-            return cost_config['base'] * image_count
+            return CreditService.get_credit_cost(mapped_type) * image_count
-        elif operation_type == 'reparse':
-            # 1 credit per reparse
-            return cost_config['base']
         
-        return cost_config['base']
+        return CreditService.get_credit_cost(mapped_type)
 

backend/igny8_core/modules/system/models.py

@@ -6,7 +6,7 @@ from igny8_core.auth.models import AccountBaseModel
 
 # Import settings models
 from .settings_models import (
-    SystemSettings, AccountSettings, UserSettings, ModuleSettings, AISettings
+    SystemSettings, AccountSettings, UserSettings, ModuleSettings, AccountModuleSettings, AISettings
 )
 
 

backend/igny8_core/modules/system/settings_models.py

@@ -92,6 +92,61 @@ class ModuleSettings(BaseSettings):
         return f"ModuleSetting: {self.module_name} - {self.key}"
 
 
+class AccountModuleSettings(AccountBaseModel):
+    """
+    Account-level module enable/disable settings.
+    Phase 0: Credit System - Module Settings
+    """
+    # Module enable/disable flags
+    planner_enabled = models.BooleanField(default=True, help_text="Enable Planner module")
+    writer_enabled = models.BooleanField(default=True, help_text="Enable Writer module")
+    thinker_enabled = models.BooleanField(default=True, help_text="Enable Thinker module")
+    automation_enabled = models.BooleanField(default=True, help_text="Enable Automation module")
+    site_builder_enabled = models.BooleanField(default=True, help_text="Enable Site Builder module")
+    linker_enabled = models.BooleanField(default=True, help_text="Enable Linker module")
+    optimizer_enabled = models.BooleanField(default=True, help_text="Enable Optimizer module")
+    publisher_enabled = models.BooleanField(default=True, help_text="Enable Publisher module")
+    
+    updated_at = models.DateTimeField(auto_now=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    
+    class Meta:
+        db_table = 'igny8_account_module_settings'
+        verbose_name = 'Account Module Settings'
+        verbose_name_plural = 'Account Module Settings'
+        # One settings record per account
+        constraints = [
+            models.UniqueConstraint(fields=['account'], name='unique_account_module_settings')
+        ]
+        indexes = [
+            models.Index(fields=['account']),
+        ]
+    
+    def __str__(self):
+        account = getattr(self, 'account', None)
+        return f"ModuleSettings: {account.name if account else 'No Account'}"
+    
+    @classmethod
+    def get_or_create_for_account(cls, account):
+        """Get or create module settings for an account"""
+        settings, created = cls.objects.get_or_create(account=account)
+        return settings
+    
+    def is_module_enabled(self, module_name):
+        """Check if a module is enabled"""
+        module_map = {
+            'planner': self.planner_enabled,
+            'writer': self.writer_enabled,
+            'thinker': self.thinker_enabled,
+            'automation': self.automation_enabled,
+            'site_builder': self.site_builder_enabled,
+            'linker': self.linker_enabled,
+            'optimizer': self.optimizer_enabled,
+            'publisher': self.publisher_enabled,
+        }
+        return module_map.get(module_name, True)  # Default to enabled if module not found
+
+
 # AISettings extends IntegrationSettings (which already exists)
 # We'll create it as a separate model that can reference IntegrationSettings
 class AISettings(AccountBaseModel):

backend/igny8_core/modules/system/settings_serializers.py

@@ -2,7 +2,7 @@
 Serializers for Settings Models
 """
 from rest_framework import serializers
-from .settings_models import SystemSettings, AccountSettings, UserSettings, ModuleSettings, AISettings
+from .settings_models import SystemSettings, AccountSettings, UserSettings, ModuleSettings, AccountModuleSettings, AISettings
 from .validators import validate_settings_schema
 
 
@@ -58,6 +58,18 @@ class ModuleSettingsSerializer(serializers.ModelSerializer):
         return value
 
 
+class AccountModuleSettingsSerializer(serializers.ModelSerializer):
+    """Serializer for Account Module Settings (Phase 0)"""
+    class Meta:
+        model = AccountModuleSettings
+        fields = [
+            'id', 'planner_enabled', 'writer_enabled', 'thinker_enabled',
+            'automation_enabled', 'site_builder_enabled', 'linker_enabled',
+            'optimizer_enabled', 'publisher_enabled', 'created_at', 'updated_at'
+        ]
+        read_only_fields = ['created_at', 'updated_at', 'account']
+
+
 class AISettingsSerializer(serializers.ModelSerializer):
     class Meta:
         model = AISettings

backend/igny8_core/modules/system/settings_views.py

@@ -13,10 +13,10 @@ from igny8_core.api.authentication import JWTAuthentication, CSRFExemptSessionAu
 from igny8_core.api.pagination import CustomPageNumberPagination
 from igny8_core.api.throttles import DebugScopedRateThrottle
 from igny8_core.api.permissions import IsAuthenticatedAndActive, HasTenantAccess, IsAdminOrOwner
-from .settings_models import SystemSettings, AccountSettings, UserSettings, ModuleSettings, AISettings
+from .settings_models import SystemSettings, AccountSettings, UserSettings, ModuleSettings, AccountModuleSettings, AISettings
 from .settings_serializers import (
     SystemSettingsSerializer, AccountSettingsSerializer, UserSettingsSerializer,
-    ModuleSettingsSerializer, AISettingsSerializer
+    ModuleSettingsSerializer, AccountModuleSettingsSerializer, AISettingsSerializer
 )
 
 
@@ -276,6 +276,75 @@ class ModuleSettingsViewSet(AccountModelViewSet):
         serializer.save(account=account)
 
 
+@extend_schema_view(
+    list=extend_schema(tags=['System']),
+    retrieve=extend_schema(tags=['System']),
+    update=extend_schema(tags=['System']),
+    partial_update=extend_schema(tags=['System']),
+)
+class AccountModuleSettingsViewSet(AccountModelViewSet):
+    """
+    ViewSet for managing account module enable/disable settings.
+    Phase 0: Credit System - Module Settings
+    One settings record per account (get_or_create pattern)
+    """
+    queryset = AccountModuleSettings.objects.all()
+    serializer_class = AccountModuleSettingsSerializer
+    permission_classes = [IsAuthenticatedAndActive, HasTenantAccess]
+    authentication_classes = [JWTAuthentication, CSRFExemptSessionAuthentication]
+    pagination_class = CustomPageNumberPagination
+    throttle_scope = 'system'
+    throttle_classes = [DebugScopedRateThrottle]
+    
+    def get_queryset(self):
+        """Get module settings for current account"""
+        queryset = super().get_queryset()
+        return queryset.filter(account=self.request.account)
+    
+    def list(self, request, *args, **kwargs):
+        """Get or create module settings for account"""
+        account = request.account
+        settings = AccountModuleSettings.get_or_create_for_account(account)
+        serializer = self.get_serializer(settings)
+        return success_response(data=serializer.data, request=request)
+    
+    def retrieve(self, request, pk=None):
+        """Get module settings for account"""
+        account = request.account
+        try:
+            settings = AccountModuleSettings.objects.get(account=account, pk=pk)
+        except AccountModuleSettings.DoesNotExist:
+            # Create if doesn't exist
+            settings = AccountModuleSettings.get_or_create_for_account(account)
+        serializer = self.get_serializer(settings)
+        return success_response(data=serializer.data, request=request)
+    
+    def perform_create(self, serializer):
+        """Set account automatically"""
+        account = getattr(self.request, 'account', None)
+        if not account:
+            user = getattr(self.request, 'user', None)
+            if user:
+                account = getattr(user, 'account', None)
+        
+        if not account:
+            from rest_framework.exceptions import ValidationError
+            raise ValidationError("Account is required")
+        
+        serializer.save(account=account)
+    
+    @action(detail=False, methods=['get'], url_path='check/(?P<module_name>[^/.]+)', url_name='check_module')
+    def check_module(self, request, module_name=None):
+        """Check if a specific module is enabled"""
+        account = request.account
+        settings = AccountModuleSettings.get_or_create_for_account(account)
+        is_enabled = settings.is_module_enabled(module_name)
+        return success_response(
+            data={'module_name': module_name, 'enabled': is_enabled},
+            request=request
+        )
+
+
 @extend_schema_view(
     list=extend_schema(tags=['System']),
     create=extend_schema(tags=['System']),

backend/igny8_core/modules/system/urls.py

@@ -7,7 +7,7 @@ from .views import AIPromptViewSet, AuthorProfileViewSet, StrategyViewSet, syste
 from .integration_views import IntegrationSettingsViewSet
 from .settings_views import (
     SystemSettingsViewSet, AccountSettingsViewSet, UserSettingsViewSet,
-    ModuleSettingsViewSet, AISettingsViewSet
+    ModuleSettingsViewSet, AccountModuleSettingsViewSet, AISettingsViewSet
 )
 router = DefaultRouter()
 router.register(r'prompts', AIPromptViewSet, basename='prompts')
@@ -17,6 +17,7 @@ router.register(r'settings/system', SystemSettingsViewSet, basename='system-sett
 router.register(r'settings/account', AccountSettingsViewSet, basename='account-settings')
 router.register(r'settings/user', UserSettingsViewSet, basename='user-settings')
 router.register(r'settings/modules', ModuleSettingsViewSet, basename='module-settings')
+router.register(r'settings/account-modules', AccountModuleSettingsViewSet, basename='account-module-settings')
 router.register(r'settings/ai', AISettingsViewSet, basename='ai-settings')
 
 # Custom URL patterns for integration settings - matching reference plugin structure

backup-api-standard-v1/backend/igny8_core/api/schema_extensions.py

@@ -1,39 +0,0 @@
-"""
-OpenAPI Schema Extensions for drf-spectacular
-Custom extensions for JWT authentication and unified response format
-"""
-from drf_spectacular.extensions import OpenApiAuthenticationExtension
-from drf_spectacular.plumbing import build_bearer_security_scheme_object
-from drf_spectacular.utils import extend_schema, OpenApiResponse
-from rest_framework import status
-
-
-class JWTAuthenticationExtension(OpenApiAuthenticationExtension):
-    """
-    OpenAPI extension for JWT Bearer Token authentication
-    """
-    target_class = 'igny8_core.api.authentication.JWTAuthentication'
-    name = 'JWTAuthentication'
-    
-    def get_security_definition(self, auto_schema):
-        return build_bearer_security_scheme_object(
-            header_name='Authorization',
-            token_prefix='Bearer',
-            bearer_format='JWT'
-        )
-
-
-class CSRFExemptSessionAuthenticationExtension(OpenApiAuthenticationExtension):
-    """
-    OpenAPI extension for CSRF-exempt session authentication
-    """
-    target_class = 'igny8_core.api.authentication.CSRFExemptSessionAuthentication'
-    name = 'SessionAuthentication'
-    
-    def get_security_definition(self, auto_schema):
-        return {
-            'type': 'apiKey',
-            'in': 'cookie',
-            'name': 'sessionid'
-        }
-

backup-api-standard-v1/backend/igny8_core/auth/migrations/0009_fix_admin_log_user_fk.py

@@ -1,88 +0,0 @@
-from django.db import migrations
-
-
-def forward_fix_admin_log_fk(apps, schema_editor):
-    if schema_editor.connection.vendor != "postgresql":
-        return
-    schema_editor.execute(
-        """
-        ALTER TABLE django_admin_log
-        DROP CONSTRAINT IF EXISTS django_admin_log_user_id_c564eba6_fk_auth_user_id;
-        """
-    )
-    schema_editor.execute(
-        """
-        UPDATE django_admin_log
-        SET user_id = sub.new_user_id
-        FROM (
-            SELECT id AS new_user_id
-            FROM igny8_users
-            ORDER BY id
-            LIMIT 1
-        ) AS sub
-        WHERE django_admin_log.user_id NOT IN (
-            SELECT id FROM igny8_users
-        );
-        """
-    )
-    schema_editor.execute(
-        """
-        DO $$
-        BEGIN
-            IF NOT EXISTS (
-                SELECT 1 FROM pg_constraint 
-                WHERE conname = 'django_admin_log_user_id_c564eba6_fk_igny8_users_id'
-            ) THEN
-                ALTER TABLE django_admin_log
-                ADD CONSTRAINT django_admin_log_user_id_c564eba6_fk_igny8_users_id
-                FOREIGN KEY (user_id) REFERENCES igny8_users(id) DEFERRABLE INITIALLY DEFERRED;
-            END IF;
-        END $$;
-        """
-    )
-
-
-def reverse_fix_admin_log_fk(apps, schema_editor):
-    if schema_editor.connection.vendor != "postgresql":
-        return
-    schema_editor.execute(
-        """
-        ALTER TABLE django_admin_log
-        DROP CONSTRAINT IF EXISTS django_admin_log_user_id_c564eba6_fk_igny8_users_id;
-        """
-    )
-    schema_editor.execute(
-        """
-        UPDATE django_admin_log
-        SET user_id = sub.old_user_id
-        FROM (
-            SELECT id AS old_user_id
-            FROM auth_user
-            ORDER BY id
-            LIMIT 1
-        ) AS sub
-        WHERE django_admin_log.user_id NOT IN (
-            SELECT id FROM auth_user
-        );
-        """
-    )
-    schema_editor.execute(
-        """
-        ALTER TABLE django_admin_log
-        ADD CONSTRAINT django_admin_log_user_id_c564eba6_fk_auth_user_id
-        FOREIGN KEY (user_id) REFERENCES auth_user(id) DEFERRABLE INITIALLY DEFERRED;
-        """
-    )
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ("igny8_core_auth", "0008_passwordresettoken_alter_industry_options_and_more"),
-    ]
-
-    operations = [
-        migrations.RunPython(forward_fix_admin_log_fk, reverse_fix_admin_log_fk),
-    ]
-
-

backup-api-standard-v1/backend/igny8_core/modules/system/migrations/0006_alter_systemstatus_unique_together_and_more.py

@@ -1,71 +0,0 @@
-# Generated by Django 5.2.8 on 2025-11-07 14:17
-
-from django.db import migrations
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('system', '0005_add_author_profile_strategy'),
-    ]
-
-    operations = [
-        # Remove unique_together constraint if it exists and table exists
-        migrations.RunSQL(
-            """
-            DO $$
-            BEGIN
-                -- Drop unique constraint if table and constraint exist
-                IF EXISTS (
-                    SELECT 1 FROM information_schema.tables 
-                    WHERE table_name = 'igny8_system_status'
-                ) AND EXISTS (
-                    SELECT 1 FROM pg_constraint 
-                    WHERE conname LIKE '%systemstatus%tenant_id%component%'
-                ) THEN
-                    ALTER TABLE igny8_system_status DROP CONSTRAINT IF EXISTS igny8_system_status_tenant_id_component_key;
-                END IF;
-            END $$;
-            """,
-            reverse_sql=migrations.RunSQL.noop
-        ),
-        # Only remove field if table exists
-        migrations.RunSQL(
-            """
-            DO $$
-            BEGIN
-                IF EXISTS (
-                    SELECT 1 FROM information_schema.tables 
-                    WHERE table_name = 'igny8_system_status'
-                ) AND EXISTS (
-                    SELECT 1 FROM information_schema.columns 
-                    WHERE table_name = 'igny8_system_status' AND column_name = 'tenant_id'
-                ) THEN
-                    ALTER TABLE igny8_system_status DROP COLUMN IF EXISTS tenant_id;
-                END IF;
-            END $$;
-            """,
-            reverse_sql=migrations.RunSQL.noop
-        ),
-        # Delete models only if tables exist
-        migrations.RunSQL(
-            """
-            DO $$
-            BEGIN
-                IF EXISTS (
-                    SELECT 1 FROM information_schema.tables 
-                    WHERE table_name = 'igny8_system_logs'
-                ) THEN
-                    DROP TABLE IF EXISTS igny8_system_logs CASCADE;
-                END IF;
-                IF EXISTS (
-                    SELECT 1 FROM information_schema.tables 
-                    WHERE table_name = 'igny8_system_status'
-                ) THEN
-                    DROP TABLE IF EXISTS igny8_system_status CASCADE;
-                END IF;
-            END $$;
-            """,
-            reverse_sql=migrations.RunSQL.noop
-        ),
-    ]

backup-api-standard-v1/backend/igny8_core/settings.py

@@ -1,443 +0,0 @@
-"""
-Django settings for igny8_core project.
-"""
-
-from pathlib import Path
-from datetime import timedelta
-from urllib.parse import urlparse
-import os
-
-BASE_DIR = Path(__file__).resolve().parent.parent
-
-# SECURITY: SECRET_KEY must be set via environment variable in production
-# Generate a new key with: python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
-SECRET_KEY = os.getenv('SECRET_KEY', 'django-insecure-)#i8!6+_&j97eb_4actu86=qtg)p+p#)vr48!ahjs8u=o5#5aw')
-
-# SECURITY: DEBUG should be False in production
-# Set DEBUG=False via environment variable for production deployments
-DEBUG = os.getenv('DEBUG', 'False').lower() == 'true'
-
-# Unified API Standard v1.0 Feature Flags
-# Set IGNY8_USE_UNIFIED_EXCEPTION_HANDLER=True to enable unified exception handler
-# Set IGNY8_DEBUG_THROTTLE=True to bypass rate limiting in development
-IGNY8_DEBUG_THROTTLE = os.getenv('IGNY8_DEBUG_THROTTLE', str(DEBUG)).lower() == 'true'
-
-ALLOWED_HOSTS = [
-    '*',  # Allow all hosts for flexibility
-    'api.igny8.com',
-    'app.igny8.com',
-    'igny8.com',
-    'www.igny8.com',
-    'localhost',
-    '127.0.0.1',
-    # Note: Do NOT add static IP addresses here - they change on container restart
-    # Use container names or domain names instead
-]
-
-INSTALLED_APPS = [
-    'igny8_core.admin.apps.Igny8AdminConfig',  # Custom admin config
-    'django.contrib.auth',
-    'django.contrib.contenttypes',
-    'django.contrib.sessions',
-    'django.contrib.messages',
-    'django.contrib.staticfiles',
-    'rest_framework',
-    'django_filters',
-    'corsheaders',
-    'drf_spectacular',  # OpenAPI 3.0 schema generation
-    'igny8_core.auth.apps.Igny8CoreAuthConfig',  # Use app config with custom label
-    'igny8_core.ai.apps.AIConfig',  # AI Framework
-    'igny8_core.modules.planner.apps.PlannerConfig',
-    'igny8_core.modules.writer.apps.WriterConfig',
-    'igny8_core.modules.system.apps.SystemConfig',
-    'igny8_core.modules.billing.apps.BillingConfig',
-]
-
-# System module needs explicit registration for admin
-
-AUTH_USER_MODEL = 'igny8_core_auth.User'
-
-CSRF_TRUSTED_ORIGINS = [
-    'https://api.igny8.com',
-    'https://app.igny8.com',
-    'http://localhost:8011',
-    'http://127.0.0.1:8011',
-]
-
-# Only use secure cookies in production (HTTPS)
-# Default to False - set USE_SECURE_COOKIES=True in docker-compose for production
-# This allows local development to work without HTTPS
-USE_SECURE_COOKIES = os.getenv('USE_SECURE_COOKIES', 'False').lower() == 'true'
-SESSION_COOKIE_SECURE = USE_SECURE_COOKIES
-CSRF_COOKIE_SECURE = USE_SECURE_COOKIES
-
-MIDDLEWARE = [
-    'django.middleware.security.SecurityMiddleware',
-    'whitenoise.middleware.WhiteNoiseMiddleware',
-    'corsheaders.middleware.CorsMiddleware',
-    'django.contrib.sessions.middleware.SessionMiddleware',
-    'django.middleware.common.CommonMiddleware',
-    'django.middleware.csrf.CsrfViewMiddleware',
-    'django.contrib.auth.middleware.AuthenticationMiddleware',
-    'igny8_core.middleware.request_id.RequestIDMiddleware',  # Request ID tracking (must be early)
-    'igny8_core.auth.middleware.AccountContextMiddleware',  # Multi-account support
-    # AccountContextMiddleware sets request.account from JWT
-    'igny8_core.middleware.resource_tracker.ResourceTrackingMiddleware',  # Resource tracking for admin debug
-    'django.contrib.messages.middleware.MessageMiddleware',
-    'django.middleware.clickjacking.XFrameOptionsMiddleware',
-]
-
-ROOT_URLCONF = 'igny8_core.urls'
-
-TEMPLATES = [
-    {
-        'BACKEND': 'django.template.backends.django.DjangoTemplates',
-        'DIRS': [],
-        'APP_DIRS': True,
-        'OPTIONS': {
-            'context_processors': [
-                'django.template.context_processors.debug',
-                'django.template.context_processors.request',
-                'django.contrib.auth.context_processors.auth',
-                'django.contrib.messages.context_processors.messages',
-            ],
-        },
-    },
-]
-
-WSGI_APPLICATION = 'igny8_core.wsgi.application'
-
-DATABASES = {}
-
-database_url = os.getenv("DATABASE_URL")
-db_engine = os.getenv("DB_ENGINE", "").lower()
-force_postgres = os.getenv("DJANGO_FORCE_POSTGRES", "false").lower() == "true"
-
-if database_url:
-    parsed = urlparse(database_url)
-    scheme = (parsed.scheme or "").lower()
-
-    if scheme in {"sqlite", "sqlite3"}:
-        # Support both absolute and project-relative SQLite paths
-        netloc_path = f"{parsed.netloc}{parsed.path}" if parsed.netloc else parsed.path
-        db_path = netloc_path.lstrip("/") or "db.sqlite3"
-        if os.path.isabs(netloc_path):
-            sqlite_name = netloc_path
-        else:
-            sqlite_name = Path(db_path) if os.path.isabs(db_path) else BASE_DIR / db_path
-        DATABASES["default"] = {
-            "ENGINE": "django.db.backends.sqlite3",
-            "NAME": str(sqlite_name),
-        }
-    else:
-        DATABASES["default"] = {
-            "ENGINE": "django.db.backends.postgresql",
-            "NAME": parsed.path.lstrip("/") or os.getenv("DB_NAME", "igny8_db"),
-            "USER": parsed.username or os.getenv("DB_USER", "igny8"),
-            "PASSWORD": parsed.password or os.getenv("DB_PASSWORD", "igny8pass"),
-            "HOST": parsed.hostname or os.getenv("DB_HOST", "postgres"),
-            "PORT": str(parsed.port or os.getenv("DB_PORT", "5432")),
-        }
-elif db_engine in {"sqlite", "sqlite3"} or os.getenv("USE_SQLITE", "false").lower() == "true":
-    sqlite_name = os.getenv("SQLITE_NAME")
-    if not sqlite_name:
-        sqlite_name = BASE_DIR / "db.sqlite3"
-    DATABASES["default"] = {
-        "ENGINE": "django.db.backends.sqlite3",
-        "NAME": str(sqlite_name),
-    }
-elif DEBUG and not force_postgres and not os.getenv("DB_HOST") and not os.getenv("DB_NAME") and not os.getenv("DB_USER"):
-    DATABASES["default"] = {
-        "ENGINE": "django.db.backends.sqlite3",
-        "NAME": str(BASE_DIR / "db.sqlite3"),
-    }
-else:
-    DATABASES["default"] = {
-        "ENGINE": "django.db.backends.postgresql",
-        "NAME": os.getenv("DB_NAME", "igny8_db"),
-        "USER": os.getenv("DB_USER", "igny8"),
-        "PASSWORD": os.getenv("DB_PASSWORD", "igny8pass"),
-        "HOST": os.getenv("DB_HOST", "postgres"),
-        "PORT": os.getenv("DB_PORT", "5432"),
-    }
-
-AUTH_PASSWORD_VALIDATORS = [
-    {'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator'},
-    {'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator'},
-    {'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator'},
-    {'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator'},
-]
-
-LANGUAGE_CODE = 'en-us'
-TIME_ZONE = 'UTC'
-USE_I18N = True
-USE_TZ = True
-
-STATIC_URL = '/static/'
-STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
-
-DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
-
-# Only use SECURE_PROXY_SSL_HEADER in production behind reverse proxy
-# Default to False - set USE_SECURE_PROXY_HEADER=True in docker-compose for production
-# Caddy sets X-Forwarded-Proto header, so enable this when behind Caddy
-USE_SECURE_PROXY = os.getenv('USE_SECURE_PROXY_HEADER', 'False').lower() == 'true'
-if USE_SECURE_PROXY:
-    SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
-else:
-    SECURE_PROXY_SSL_HEADER = None
-
-# Admin login URL - use relative URL to avoid hardcoded domain
-LOGIN_URL = '/admin/login/'
-LOGIN_REDIRECT_URL = '/admin/'
-
-# Force Django to use request.get_host() instead of Sites framework
-# This ensures redirects use the current request's host
-USE_X_FORWARDED_HOST = False
-
-# REST Framework Configuration
-REST_FRAMEWORK = {
-    'DEFAULT_PAGINATION_CLASS': 'igny8_core.api.pagination.CustomPageNumberPagination',
-    'PAGE_SIZE': 10,
-    'DEFAULT_FILTER_BACKENDS': [
-        'django_filters.rest_framework.DjangoFilterBackend',
-        'rest_framework.filters.SearchFilter',
-        'rest_framework.filters.OrderingFilter',
-    ],
-    'DEFAULT_PERMISSION_CLASSES': [
-        'rest_framework.permissions.AllowAny',  # Allow unauthenticated access for now
-    ],
-    'DEFAULT_AUTHENTICATION_CLASSES': [
-        'igny8_core.api.authentication.JWTAuthentication',  # JWT token authentication
-        'igny8_core.api.authentication.CSRFExemptSessionAuthentication',  # Session auth without CSRF for API
-        'rest_framework.authentication.BasicAuthentication',  # Enable basic auth as fallback
-    ],
-    # Unified API Standard v1.0 Configuration
-    # Exception handler - wraps all errors in unified format
-    # Unified API Standard v1.0: Exception handler enabled by default
-    # Set IGNY8_USE_UNIFIED_EXCEPTION_HANDLER=False to disable
-    'EXCEPTION_HANDLER': 'rest_framework.views.exception_handler' if os.getenv('IGNY8_USE_UNIFIED_EXCEPTION_HANDLER', 'True').lower() == 'false' else 'igny8_core.api.exception_handlers.custom_exception_handler',
-    # Rate limiting - configured but bypassed in DEBUG mode
-    'DEFAULT_THROTTLE_CLASSES': [
-        'igny8_core.api.throttles.DebugScopedRateThrottle',
-    ],
-    'DEFAULT_THROTTLE_RATES': {
-        # AI Functions - Expensive operations
-        'ai_function': '10/min',           # AI content generation, clustering
-        'image_gen': '15/min',            # Image generation
-        # Content Operations
-        'content_write': '30/min',        # Content creation, updates
-        'content_read': '100/min',         # Content listing, retrieval
-        # Authentication
-        'auth': '20/min',                  # Login, register, password reset
-        'auth_strict': '5/min',            # Sensitive auth operations
-        # Planner Operations
-        'planner': '60/min',               # Keyword, cluster, idea operations
-        'planner_ai': '10/min',            # AI-powered planner operations
-        # Writer Operations
-        'writer': '60/min',                # Task, content management
-        'writer_ai': '10/min',             # AI-powered writer operations
-        # System Operations
-        'system': '100/min',               # Settings, prompts, profiles
-        'system_admin': '30/min',          # Admin-only system operations
-        # Billing Operations
-        'billing': '30/min',               # Credit queries, usage logs
-        'billing_admin': '10/min',         # Credit management (admin)
-        # Default fallback
-        'default': '100/min',              # Default for endpoints without scope
-    },
-    # OpenAPI Schema Generation (drf-spectacular)
-    'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
-}
-
-# drf-spectacular Settings for OpenAPI 3.0 Schema Generation
-SPECTACULAR_SETTINGS = {
-    'TITLE': 'IGNY8 API v1.0',
-    'DESCRIPTION': '''
-    IGNY8 Unified API Standard v1.0
-    
-    A comprehensive REST API for content planning, creation, and management.
-    
-    ## Features
-    - **Unified Response Format**: All endpoints return consistent JSON structure
-    - **Layered Authorization**: Authentication → Tenant Access → Role → Site/Sector
-    - **Centralized Error Handling**: All errors wrapped in unified format
-    - **Scoped Rate Limiting**: Different limits for different operation types
-    - **Tenant Isolation**: All resources scoped by account/site/sector
-    - **Request Tracking**: Every request has a unique ID for debugging
-    
-    ## Authentication
-    All endpoints require JWT Bearer token authentication except:
-    - `POST /api/v1/auth/login/` - User login
-    - `POST /api/v1/auth/register/` - User registration
-    
-    Include token in Authorization header:
-    ```
-    Authorization: Bearer <your_access_token>
-    ```
-    
-    ## Response Format
-    All successful responses follow this format:
-    ```json
-    {
-      "success": true,
-      "data": {...},
-      "message": "Optional success message",
-      "request_id": "uuid"
-    }
-    ```
-    
-    All error responses follow this format:
-    ```json
-    {
-      "success": false,
-      "error": "Error message",
-      "errors": {
-        "field_name": ["Field-specific errors"]
-      },
-      "request_id": "uuid"
-    }
-    ```
-    
-    ## Rate Limiting
-    Rate limits are scoped by operation type. Check response headers:
-    - `X-Throttle-Limit`: Maximum requests allowed
-    - `X-Throttle-Remaining`: Remaining requests in current window
-    - `X-Throttle-Reset`: Time when limit resets (Unix timestamp)
-    
-    ## Pagination
-    List endpoints support pagination with query parameters:
-    - `page`: Page number (default: 1)
-    - `page_size`: Items per page (default: 10, max: 100)
-    
-    Paginated responses include:
-    ```json
-    {
-      "success": true,
-      "count": 100,
-      "next": "http://api.igny8.com/api/v1/endpoint/?page=2",
-      "previous": null,
-      "results": [...]
-    }
-    ```
-    ''',
-    'VERSION': '1.0.0',
-    'SERVE_INCLUDE_SCHEMA': False,
-    'SCHEMA_PATH_PREFIX': '/api/v1',
-    'COMPONENT_SPLIT_REQUEST': True,
-    'COMPONENT_NO_READ_ONLY_REQUIRED': True,
-    # Custom schema generator to include unified response format
-    'SCHEMA_GENERATOR_CLASS': 'drf_spectacular.generators.SchemaGenerator',
-    # Include request/response examples
-    'SERVE_PERMISSIONS': ['rest_framework.permissions.AllowAny'],
-    'SERVE_AUTHENTICATION': None,  # Allow unauthenticated access to docs
-    # Tags for grouping endpoints
-    'TAGS': [
-        {'name': 'Authentication', 'description': 'User authentication and registration'},
-        {'name': 'Planner', 'description': 'Keywords, clusters, and content ideas'},
-        {'name': 'Writer', 'description': 'Tasks, content, and images'},
-        {'name': 'System', 'description': 'Settings, prompts, and integrations'},
-        {'name': 'Billing', 'description': 'Credits, usage, and transactions'},
-    ],
-    # Custom response format documentation
-    'EXTENSIONS_INFO': {
-        'x-code-samples': [
-            {
-                'lang': 'Python',
-                'source': '''
-import requests
-
-headers = {
-    'Authorization': 'Bearer <your_token>',
-    'Content-Type': 'application/json'
-}
-
-response = requests.get('https://api.igny8.com/api/v1/planner/keywords/', headers=headers)
-data = response.json()
-
-if data['success']:
-    keywords = data['results']  # or data['data'] for single objects
-else:
-    print(f"Error: {data['error']}")
-                '''
-            },
-            {
-                'lang': 'JavaScript',
-                'source': '''
-const response = await fetch('https://api.igny8.com/api/v1/planner/keywords/', {
-    headers: {
-        'Authorization': 'Bearer <your_token>',
-        'Content-Type': 'application/json'
-    }
-});
-
-const data = await response.json();
-
-if (data.success) {
-    const keywords = data.results || data.data;
-} else {
-    console.error('Error:', data.error);
-}
-                '''
-            }
-        ]
-    }
-}
-
-# CORS Configuration
-CORS_ALLOWED_ORIGINS = [
-    "https://app.igny8.com",
-    "https://igny8.com",
-    "https://www.igny8.com",
-    "http://localhost:5173",
-    "http://localhost:5174",
-    "http://localhost:3000",
-    "http://127.0.0.1:5173",
-    "http://127.0.0.1:5174",
-]
-
-CORS_ALLOW_CREDENTIALS = True
-
-# Allow custom headers for resource tracking
-# Include default headers plus our custom debug header
-CORS_ALLOW_HEADERS = [
-    'accept',
-    'accept-encoding',
-    'authorization',
-    'content-type',
-    'dnt',
-    'origin',
-    'user-agent',
-    'x-csrftoken',
-    'x-requested-with',
-    'x-debug-resource-tracking',  # Allow debug tracking header
-]
-
-# Note: django-cors-headers has default headers that include the above.
-# If you want to extend defaults, you can import default_headers from corsheaders.defaults
-# For now, we're explicitly listing all needed headers including our custom one.
-
-# Expose custom headers to frontend
-CORS_EXPOSE_HEADERS = [
-    'x-resource-tracking-id',  # Expose request tracking ID
-]
-
-# JWT Configuration
-JWT_SECRET_KEY = os.getenv('JWT_SECRET_KEY', SECRET_KEY)
-JWT_ALGORITHM = 'HS256'
-JWT_ACCESS_TOKEN_EXPIRY = timedelta(minutes=15)
-JWT_REFRESH_TOKEN_EXPIRY = timedelta(days=7)
-
-# Celery Configuration
-CELERY_BROKER_URL = os.getenv('CELERY_BROKER_URL', f"redis://{os.getenv('REDIS_HOST', 'redis')}:{os.getenv('REDIS_PORT', '6379')}/0")
-CELERY_RESULT_BACKEND = os.getenv('CELERY_RESULT_BACKEND', f"redis://{os.getenv('REDIS_HOST', 'redis')}:{os.getenv('REDIS_PORT', '6379')}/0")
-CELERY_ACCEPT_CONTENT = ['json']
-CELERY_TASK_SERIALIZER = 'json'
-CELERY_RESULT_SERIALIZER = 'json'
-CELERY_TIMEZONE = TIME_ZONE
-CELERY_ENABLE_UTC = True
-CELERY_TASK_TRACK_STARTED = True
-CELERY_TASK_TIME_LIMIT = 30 * 60  # 30 minutes
-CELERY_TASK_SOFT_TIME_LIMIT = 25 * 60  # 25 minutes
-CELERY_WORKER_PREFETCH_MULTIPLIER = 1
-CELERY_WORKER_MAX_TASKS_PER_CHILD = 1000

backup-api-standard-v1/backend/igny8_core/urls.py

@@ -1,36 +0,0 @@
-"""
-URL configuration for igny8_core project.
-
-The `urlpatterns` list routes URLs to views. For more information please see:
-    https://docs.djangoproject.com/en/5.2/topics/http/urls/
-Examples:
-Function views
-    1. Add an import:  from my_app import views
-    2. Add a URL to urlpatterns:  path('', views.home, name='home')
-Class-based views
-    1. Add an import:  from other_app.views import Home
-    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
-Including another URLconf
-    1. Import the include() function: from django.urls import include, path
-    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
-"""
-from django.contrib import admin
-from django.urls import path, include
-from drf_spectacular.views import (
-    SpectacularAPIView,
-    SpectacularRedocView,
-    SpectacularSwaggerView,
-)
-
-urlpatterns = [
-    path('admin/', admin.site.urls),
-    path('api/v1/auth/', include('igny8_core.auth.urls')),  # Auth endpoints
-    path('api/v1/planner/', include('igny8_core.modules.planner.urls')),
-    path('api/v1/writer/', include('igny8_core.modules.writer.urls')),
-    path('api/v1/system/', include('igny8_core.modules.system.urls')),
-    path('api/v1/billing/', include('igny8_core.modules.billing.urls')),  # Billing endpoints
-    # OpenAPI Schema and Documentation
-    path('api/schema/', SpectacularAPIView.as_view(), name='schema'),
-    path('api/docs/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),
-    path('api/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),
-]

backup-api-standard-v1/backend/requirements.txt

@@ -1,15 +0,0 @@
-Django>=5.2.7
-gunicorn
-psycopg2-binary
-redis
-whitenoise
-djangorestframework
-django-filter
-django-cors-headers
-PyJWT>=2.8.0
-requests>=2.31.0
-celery>=5.3.0
-beautifulsoup4>=4.12.0
-psutil>=5.9.0
-docker>=7.0.0
-drf-spectacular>=0.27.0

backup-api-standard-v1/docs/API-DOCUMENTATION.md

@@ -1,545 +0,0 @@
-# IGNY8 API Documentation v1.0
-
-**Base URL**: `https://api.igny8.com/api/v1/`  
-**Version**: 1.0.0  
-**Last Updated**: 2025-11-16
-
-## Quick Links
-
-- [Interactive API Documentation (Swagger UI)](#swagger-ui)
-- [Authentication Guide](#authentication)
-- [Response Format](#response-format)
-- [Error Handling](#error-handling)
-- [Rate Limiting](#rate-limiting)
-- [Pagination](#pagination)
-- [Endpoint Reference](#endpoint-reference)
-
----
-
-## Swagger UI
-
-Interactive API documentation is available at:
-- **Swagger UI**: `https://api.igny8.com/api/docs/`
-- **ReDoc**: `https://api.igny8.com/api/redoc/`
-- **OpenAPI Schema**: `https://api.igny8.com/api/schema/`
-
-The Swagger UI provides:
-- Interactive endpoint testing
-- Request/response examples
-- Authentication testing
-- Schema definitions
-- Code samples in multiple languages
-
----
-
-## Authentication
-
-### JWT Bearer Token
-
-All endpoints require JWT Bearer token authentication except:
-- `POST /api/v1/auth/login/` - User login
-- `POST /api/v1/auth/register/` - User registration
-
-### Getting an Access Token
-
-**Login Endpoint:**
-```http
-POST /api/v1/auth/login/
-Content-Type: application/json
-
-{
-  "email": "user@example.com",
-  "password": "your_password"
-}
-```
-
-**Response:**
-```json
-{
-  "success": true,
-  "data": {
-    "user": {
-      "id": 1,
-      "email": "user@example.com",
-      "username": "user",
-      "role": "owner"
-    },
-    "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
-    "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
-  },
-  "request_id": "uuid"
-}
-```
-
-### Using the Token
-
-Include the token in the `Authorization` header:
-
-```http
-GET /api/v1/planner/keywords/
-Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
-Content-Type: application/json
-```
-
-### Token Expiration
-
-- **Access Token**: 15 minutes
-- **Refresh Token**: 7 days
-
-Use the refresh token to get a new access token:
-```http
-POST /api/v1/auth/refresh/
-Content-Type: application/json
-
-{
-  "refresh": "your_refresh_token"
-}
-```
-
----
-
-## Response Format
-
-### Success Response
-
-All successful responses follow this unified format:
-
-```json
-{
-  "success": true,
-  "data": {
-    "id": 1,
-    "name": "Example",
-    ...
-  },
-  "message": "Optional success message",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### Paginated Response
-
-List endpoints return paginated data:
-
-```json
-{
-  "success": true,
-  "count": 100,
-  "next": "https://api.igny8.com/api/v1/planner/keywords/?page=2",
-  "previous": null,
-  "results": [
-    {"id": 1, "name": "Keyword 1"},
-    {"id": 2, "name": "Keyword 2"},
-    ...
-  ],
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### Error Response
-
-All error responses follow this unified format:
-
-```json
-{
-  "success": false,
-  "error": "Validation failed",
-  "errors": {
-    "email": ["This field is required"],
-    "password": ["Password too short"]
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
----
-
-## Error Handling
-
-### HTTP Status Codes
-
-| Code | Meaning | Description |
-|------|---------|-------------|
-| 200 | OK | Request successful |
-| 201 | Created | Resource created successfully |
-| 204 | No Content | Resource deleted successfully |
-| 400 | Bad Request | Validation error or invalid request |
-| 401 | Unauthorized | Authentication required |
-| 403 | Forbidden | Permission denied |
-| 404 | Not Found | Resource not found |
-| 409 | Conflict | Resource conflict (e.g., duplicate) |
-| 422 | Unprocessable Entity | Validation failed |
-| 429 | Too Many Requests | Rate limit exceeded |
-| 500 | Internal Server Error | Server error |
-
-### Error Response Structure
-
-All errors include:
-- `success`: Always `false`
-- `error`: Top-level error message
-- `errors`: Field-specific errors (for validation errors)
-- `request_id`: Unique request ID for debugging
-
-### Example Error Responses
-
-**Validation Error (400):**
-```json
-{
-  "success": false,
-  "error": "Validation failed",
-  "errors": {
-    "email": ["Invalid email format"],
-    "password": ["Password must be at least 8 characters"]
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Authentication Error (401):**
-```json
-{
-  "success": false,
-  "error": "Authentication required",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Permission Error (403):**
-```json
-{
-  "success": false,
-  "error": "Permission denied",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Not Found (404):**
-```json
-{
-  "success": false,
-  "error": "Resource not found",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Rate Limit (429):**
-```json
-{
-  "success": false,
-  "error": "Rate limit exceeded",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
----
-
-## Rate Limiting
-
-Rate limits are scoped by operation type. Check response headers for limit information:
-
-- `X-Throttle-Limit`: Maximum requests allowed
-- `X-Throttle-Remaining`: Remaining requests in current window
-- `X-Throttle-Reset`: Time when limit resets (Unix timestamp)
-
-### Rate Limit Scopes
-
-| Scope | Limit | Description |
-|-------|-------|-------------|
-| `ai_function` | 10/min | AI content generation, clustering |
-| `image_gen` | 15/min | Image generation |
-| `content_write` | 30/min | Content creation, updates |
-| `content_read` | 100/min | Content listing, retrieval |
-| `auth` | 20/min | Login, register, password reset |
-| `auth_strict` | 5/min | Sensitive auth operations |
-| `planner` | 60/min | Keyword, cluster, idea operations |
-| `planner_ai` | 10/min | AI-powered planner operations |
-| `writer` | 60/min | Task, content management |
-| `writer_ai` | 10/min | AI-powered writer operations |
-| `system` | 100/min | Settings, prompts, profiles |
-| `system_admin` | 30/min | Admin-only system operations |
-| `billing` | 30/min | Credit queries, usage logs |
-| `billing_admin` | 10/min | Credit management (admin) |
-| `default` | 100/min | Default for endpoints without scope |
-
-### Handling Rate Limits
-
-When rate limited (429), the response includes:
-- Error message: "Rate limit exceeded"
-- Headers with reset time
-- Wait until `X-Throttle-Reset` before retrying
-
-**Example:**
-```http
-HTTP/1.1 429 Too Many Requests
-X-Throttle-Limit: 60
-X-Throttle-Remaining: 0
-X-Throttle-Reset: 1700123456
-
-{
-  "success": false,
-  "error": "Rate limit exceeded",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
----
-
-## Pagination
-
-List endpoints support pagination with query parameters:
-
-- `page`: Page number (default: 1)
-- `page_size`: Items per page (default: 10, max: 100)
-
-### Example Request
-
-```http
-GET /api/v1/planner/keywords/?page=2&page_size=20
-```
-
-### Paginated Response
-
-```json
-{
-  "success": true,
-  "count": 100,
-  "next": "https://api.igny8.com/api/v1/planner/keywords/?page=3&page_size=20",
-  "previous": "https://api.igny8.com/api/v1/planner/keywords/?page=1&page_size=20",
-  "results": [
-    {"id": 21, "name": "Keyword 21"},
-    {"id": 22, "name": "Keyword 22"},
-    ...
-  ],
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### Pagination Fields
-
-- `count`: Total number of items
-- `next`: URL to next page (null if last page)
-- `previous`: URL to previous page (null if first page)
-- `results`: Array of items for current page
-
----
-
-## Endpoint Reference
-
-### Authentication Endpoints
-
-#### Login
-```http
-POST /api/v1/auth/login/
-```
-
-#### Register
-```http
-POST /api/v1/auth/register/
-```
-
-#### Refresh Token
-```http
-POST /api/v1/auth/refresh/
-```
-
-### Planner Endpoints
-
-#### List Keywords
-```http
-GET /api/v1/planner/keywords/
-```
-
-#### Create Keyword
-```http
-POST /api/v1/planner/keywords/
-```
-
-#### Get Keyword
-```http
-GET /api/v1/planner/keywords/{id}/
-```
-
-#### Update Keyword
-```http
-PUT /api/v1/planner/keywords/{id}/
-PATCH /api/v1/planner/keywords/{id}/
-```
-
-#### Delete Keyword
-```http
-DELETE /api/v1/planner/keywords/{id}/
-```
-
-#### Auto Cluster Keywords
-```http
-POST /api/v1/planner/keywords/auto_cluster/
-```
-
-### Writer Endpoints
-
-#### List Tasks
-```http
-GET /api/v1/writer/tasks/
-```
-
-#### Create Task
-```http
-POST /api/v1/writer/tasks/
-```
-
-### System Endpoints
-
-#### System Status
-```http
-GET /api/v1/system/status/
-```
-
-#### List Prompts
-```http
-GET /api/v1/system/prompts/
-```
-
-### Billing Endpoints
-
-#### Credit Balance
-```http
-GET /api/v1/billing/credits/balance/balance/
-```
-
-#### Usage Summary
-```http
-GET /api/v1/billing/credits/usage/summary/
-```
-
----
-
-## Code Examples
-
-### Python
-
-```python
-import requests
-
-BASE_URL = "https://api.igny8.com/api/v1"
-
-# Login
-response = requests.post(
-    f"{BASE_URL}/auth/login/",
-    json={"email": "user@example.com", "password": "password"}
-)
-data = response.json()
-
-if data['success']:
-    token = data['data']['access']
-    
-    # Use token for authenticated requests
-    headers = {
-        'Authorization': f'Bearer {token}',
-        'Content-Type': 'application/json'
-    }
-    
-    # Get keywords
-    response = requests.get(
-        f"{BASE_URL}/planner/keywords/",
-        headers=headers
-    )
-    keywords_data = response.json()
-    
-    if keywords_data['success']:
-        keywords = keywords_data['results']
-        print(f"Found {keywords_data['count']} keywords")
-    else:
-        print(f"Error: {keywords_data['error']}")
-else:
-    print(f"Login failed: {data['error']}")
-```
-
-### JavaScript
-
-```javascript
-const BASE_URL = 'https://api.igny8.com/api/v1';
-
-// Login
-const loginResponse = await fetch(`${BASE_URL}/auth/login/`, {
-    method: 'POST',
-    headers: {
-        'Content-Type': 'application/json'
-    },
-    body: JSON.stringify({
-        email: 'user@example.com',
-        password: 'password'
-    })
-});
-
-const loginData = await loginResponse.json();
-
-if (loginData.success) {
-    const token = loginData.data.access;
-    
-    // Use token for authenticated requests
-    const headers = {
-        'Authorization': `Bearer ${token}`,
-        'Content-Type': 'application/json'
-    };
-    
-    // Get keywords
-    const keywordsResponse = await fetch(
-        `${BASE_URL}/planner/keywords/`,
-        { headers }
-    );
-    
-    const keywordsData = await keywordsResponse.json();
-    
-    if (keywordsData.success) {
-        const keywords = keywordsData.results;
-        console.log(`Found ${keywordsData.count} keywords`);
-    } else {
-        console.error('Error:', keywordsData.error);
-    }
-} else {
-    console.error('Login failed:', loginData.error);
-}
-```
-
-### cURL
-
-```bash
-# Login
-curl -X POST https://api.igny8.com/api/v1/auth/login/ \
-  -H "Content-Type: application/json" \
-  -d '{"email":"user@example.com","password":"password"}'
-
-# Get keywords (with token)
-curl -X GET https://api.igny8.com/api/v1/planner/keywords/ \
-  -H "Authorization: Bearer YOUR_TOKEN" \
-  -H "Content-Type: application/json"
-```
-
----
-
-## Request ID
-
-Every API request includes a unique `request_id` in the response. Use this ID for:
-- Debugging issues
-- Log correlation
-- Support requests
-
-The `request_id` is included in:
-- All success responses
-- All error responses
-- Response headers (`X-Request-ID`)
-
----
-
-## Support
-
-For API support:
-- Check the [Interactive Documentation](https://api.igny8.com/api/docs/)
-- Review [Error Codes Reference](ERROR-CODES.md)
-- Contact support with your `request_id`
-
----
-
-**Last Updated**: 2025-11-16  
-**API Version**: 1.0.0
-

backup-api-standard-v1/docs/AUTHENTICATION-GUIDE.md

@@ -1,493 +0,0 @@
-# Authentication Guide
-
-**Version**: 1.0.0  
-**Last Updated**: 2025-11-16
-
-Complete guide for authenticating with the IGNY8 API v1.0.
-
----
-
-## Overview
-
-The IGNY8 API uses **JWT (JSON Web Token) Bearer Token** authentication. All endpoints require authentication except:
-- `POST /api/v1/auth/login/` - User login
-- `POST /api/v1/auth/register/` - User registration
-
----
-
-## Authentication Flow
-
-### 1. Register or Login
-
-**Register** (if new user):
-```http
-POST /api/v1/auth/register/
-Content-Type: application/json
-
-{
-  "email": "user@example.com",
-  "username": "user",
-  "password": "secure_password123",
-  "first_name": "John",
-  "last_name": "Doe"
-}
-```
-
-**Login** (existing user):
-```http
-POST /api/v1/auth/login/
-Content-Type: application/json
-
-{
-  "email": "user@example.com",
-  "password": "secure_password123"
-}
-```
-
-### 2. Receive Tokens
-
-**Response**:
-```json
-{
-  "success": true,
-  "data": {
-    "user": {
-      "id": 1,
-      "email": "user@example.com",
-      "username": "user",
-      "role": "owner",
-      "account": {
-        "id": 1,
-        "name": "My Account",
-        "slug": "my-account"
-      }
-    },
-    "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxLCJleHAiOjE3MDAxMjM0NTZ9...",
-    "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxLCJleHAiOjE3MDAxODk0NTZ9..."
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### 3. Use Access Token
-
-Include the `access` token in all subsequent requests:
-
-```http
-GET /api/v1/planner/keywords/
-Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
-Content-Type: application/json
-```
-
-### 4. Refresh Token (when expired)
-
-When the access token expires (15 minutes), use the refresh token:
-
-```http
-POST /api/v1/auth/refresh/
-Content-Type: application/json
-
-{
-  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
-}
-```
-
-**Response**:
-```json
-{
-  "success": true,
-  "data": {
-    "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
-    "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
----
-
-## Token Expiration
-
-- **Access Token**: 15 minutes
-- **Refresh Token**: 7 days
-
-### Handling Token Expiration
-
-**Option 1: Automatic Refresh**
-```python
-def get_access_token():
-    # Check if token is expired
-    if is_token_expired(current_token):
-        # Refresh token
-        response = requests.post(
-            f"{BASE_URL}/auth/refresh/",
-            json={"refresh": refresh_token}
-        )
-        data = response.json()
-        if data['success']:
-            return data['data']['access']
-    return current_token
-```
-
-**Option 2: Re-login**
-```python
-def login():
-    response = requests.post(
-        f"{BASE_URL}/auth/login/",
-        json={"email": email, "password": password}
-    )
-    data = response.json()
-    if data['success']:
-        return data['data']['access']
-```
-
----
-
-## Code Examples
-
-### Python
-
-```python
-import requests
-import time
-from datetime import datetime, timedelta
-
-class Igny8API:
-    def __init__(self, base_url="https://api.igny8.com/api/v1"):
-        self.base_url = base_url
-        self.access_token = None
-        self.refresh_token = None
-        self.token_expires_at = None
-    
-    def login(self, email, password):
-        """Login and store tokens"""
-        response = requests.post(
-            f"{self.base_url}/auth/login/",
-            json={"email": email, "password": password}
-        )
-        data = response.json()
-        
-        if data['success']:
-            self.access_token = data['data']['access']
-            self.refresh_token = data['data']['refresh']
-            # Token expires in 15 minutes
-            self.token_expires_at = datetime.now() + timedelta(minutes=14)
-            return True
-        else:
-            print(f"Login failed: {data['error']}")
-            return False
-    
-    def refresh_access_token(self):
-        """Refresh access token using refresh token"""
-        if not self.refresh_token:
-            return False
-        
-        response = requests.post(
-            f"{self.base_url}/auth/refresh/",
-            json={"refresh": self.refresh_token}
-        )
-        data = response.json()
-        
-        if data['success']:
-            self.access_token = data['data']['access']
-            self.refresh_token = data['data']['refresh']
-            self.token_expires_at = datetime.now() + timedelta(minutes=14)
-            return True
-        else:
-            print(f"Token refresh failed: {data['error']}")
-            return False
-    
-    def get_headers(self):
-        """Get headers with valid access token"""
-        # Check if token is expired or about to expire
-        if not self.token_expires_at or datetime.now() >= self.token_expires_at:
-            if not self.refresh_access_token():
-                raise Exception("Token expired and refresh failed")
-        
-        return {
-            'Authorization': f'Bearer {self.access_token}',
-            'Content-Type': 'application/json'
-        }
-    
-    def get(self, endpoint):
-        """Make authenticated GET request"""
-        response = requests.get(
-            f"{self.base_url}{endpoint}",
-            headers=self.get_headers()
-        )
-        return response.json()
-    
-    def post(self, endpoint, data):
-        """Make authenticated POST request"""
-        response = requests.post(
-            f"{self.base_url}{endpoint}",
-            headers=self.get_headers(),
-            json=data
-        )
-        return response.json()
-
-# Usage
-api = Igny8API()
-api.login("user@example.com", "password")
-
-# Make authenticated requests
-keywords = api.get("/planner/keywords/")
-```
-
-### JavaScript
-
-```javascript
-class Igny8API {
-    constructor(baseUrl = 'https://api.igny8.com/api/v1') {
-        this.baseUrl = baseUrl;
-        this.accessToken = null;
-        this.refreshToken = null;
-        this.tokenExpiresAt = null;
-    }
-    
-    async login(email, password) {
-        const response = await fetch(`${this.baseUrl}/auth/login/`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json'
-            },
-            body: JSON.stringify({ email, password })
-        });
-        
-        const data = await response.json();
-        
-        if (data.success) {
-            this.accessToken = data.data.access;
-            this.refreshToken = data.data.refresh;
-            // Token expires in 15 minutes
-            this.tokenExpiresAt = new Date(Date.now() + 14 * 60 * 1000);
-            return true;
-        } else {
-            console.error('Login failed:', data.error);
-            return false;
-        }
-    }
-    
-    async refreshAccessToken() {
-        if (!this.refreshToken) {
-            return false;
-        }
-        
-        const response = await fetch(`${this.baseUrl}/auth/refresh/`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json'
-            },
-            body: JSON.stringify({ refresh: this.refreshToken })
-        });
-        
-        const data = await response.json();
-        
-        if (data.success) {
-            this.accessToken = data.data.access;
-            this.refreshToken = data.data.refresh;
-            this.tokenExpiresAt = new Date(Date.now() + 14 * 60 * 1000);
-            return true;
-        } else {
-            console.error('Token refresh failed:', data.error);
-            return false;
-        }
-    }
-    
-    async getHeaders() {
-        // Check if token is expired or about to expire
-        if (!this.tokenExpiresAt || new Date() >= this.tokenExpiresAt) {
-            if (!await this.refreshAccessToken()) {
-                throw new Error('Token expired and refresh failed');
-            }
-        }
-        
-        return {
-            'Authorization': `Bearer ${this.accessToken}`,
-            'Content-Type': 'application/json'
-        };
-    }
-    
-    async get(endpoint) {
-        const response = await fetch(
-            `${this.baseUrl}${endpoint}`,
-            { headers: await this.getHeaders() }
-        );
-        return await response.json();
-    }
-    
-    async post(endpoint, data) {
-        const response = await fetch(
-            `${this.baseUrl}${endpoint}`,
-            {
-                method: 'POST',
-                headers: await this.getHeaders(),
-                body: JSON.stringify(data)
-            }
-        );
-        return await response.json();
-    }
-}
-
-// Usage
-const api = new Igny8API();
-await api.login('user@example.com', 'password');
-
-// Make authenticated requests
-const keywords = await api.get('/planner/keywords/');
-```
-
----
-
-## Security Best Practices
-
-### 1. Store Tokens Securely
-
-**❌ Don't:**
-- Store tokens in localStorage (XSS risk)
-- Commit tokens to version control
-- Log tokens in console/logs
-- Send tokens in URL parameters
-
-**✅ Do:**
-- Store tokens in httpOnly cookies (server-side)
-- Use secure storage (encrypted) for client-side
-- Rotate tokens regularly
-- Implement token revocation
-
-### 2. Handle Token Expiration
-
-Always check token expiration and refresh before making requests:
-
-```python
-def is_token_valid(token_expires_at):
-    # Refresh 1 minute before expiration
-    return datetime.now() < (token_expires_at - timedelta(minutes=1))
-```
-
-### 3. Implement Retry Logic
-
-```python
-def make_request_with_retry(url, headers, max_retries=3):
-    for attempt in range(max_retries):
-        response = requests.get(url, headers=headers)
-        
-        if response.status_code == 401:
-            # Token expired, refresh and retry
-            refresh_token()
-            headers = get_headers()
-            continue
-        
-        return response.json()
-    
-    raise Exception("Max retries exceeded")
-```
-
-### 4. Validate Token Before Use
-
-```python
-def validate_token(token):
-    try:
-        # Decode token (without verification for structure check)
-        import jwt
-        decoded = jwt.decode(token, options={"verify_signature": False})
-        exp = decoded.get('exp')
-        
-        if exp and datetime.fromtimestamp(exp) < datetime.now():
-            return False
-        return True
-    except:
-        return False
-```
-
----
-
-## Error Handling
-
-### Authentication Errors
-
-**401 Unauthorized**:
-```json
-{
-  "success": false,
-  "error": "Authentication required",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: Include valid `Authorization: Bearer <token>` header.
-
-**403 Forbidden**:
-```json
-{
-  "success": false,
-  "error": "Permission denied",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: User lacks required permissions. Check user role and resource access.
-
----
-
-## Testing Authentication
-
-### Using Swagger UI
-
-1. Navigate to `https://api.igny8.com/api/docs/`
-2. Click "Authorize" button
-3. Enter: `Bearer <your_token>`
-4. Click "Authorize"
-5. All requests will include the token
-
-### Using cURL
-
-```bash
-# Login
-curl -X POST https://api.igny8.com/api/v1/auth/login/ \
-  -H "Content-Type: application/json" \
-  -d '{"email":"user@example.com","password":"password"}'
-
-# Use token
-curl -X GET https://api.igny8.com/api/v1/planner/keywords/ \
-  -H "Authorization: Bearer YOUR_TOKEN" \
-  -H "Content-Type: application/json"
-```
-
----
-
-## Troubleshooting
-
-### Issue: "Authentication required" (401)
-
-**Causes**:
-- Missing Authorization header
-- Invalid token format
-- Expired token
-
-**Solutions**:
-1. Verify `Authorization: Bearer <token>` header is included
-2. Check token is not expired
-3. Refresh token or re-login
-
-### Issue: "Permission denied" (403)
-
-**Causes**:
-- User lacks required role
-- Resource belongs to different account
-- Site/sector access denied
-
-**Solutions**:
-1. Check user role has required permissions
-2. Verify resource belongs to user's account
-3. Check site/sector access permissions
-
-### Issue: Token expires frequently
-
-**Solution**: Implement automatic token refresh before expiration.
-
----
-
-**Last Updated**: 2025-11-16  
-**API Version**: 1.0.0
-

backup-api-standard-v1/docs/DOCUMENTATION-SUMMARY.md

@@ -1,207 +0,0 @@
-# Documentation Implementation Summary
-
-**Section 2: Documentation - COMPLETE** ✅
-
-**Date Completed**: 2025-11-16  
-**Status**: All Documentation Complete and Ready
-
----
-
-## Implementation Overview
-
-Complete documentation system for IGNY8 API v1.0 including:
-- OpenAPI 3.0 schema generation
-- Interactive Swagger UI
-- Comprehensive documentation files
-- Code examples and integration guides
-
----
-
-## OpenAPI/Swagger Integration ✅
-
-### Configuration
-- ✅ Installed `drf-spectacular>=0.27.0`
-- ✅ Added to `INSTALLED_APPS`
-- ✅ Configured `SPECTACULAR_SETTINGS` with comprehensive description
-- ✅ Added URL endpoints for schema and documentation
-
-### Endpoints Created
-- ✅ `/api/schema/` - OpenAPI 3.0 schema (JSON/YAML)
-- ✅ `/api/docs/` - Swagger UI (interactive documentation)
-- ✅ `/api/redoc/` - ReDoc (alternative documentation UI)
-
-### Features
-- ✅ Comprehensive API description with features overview
-- ✅ Authentication documentation (JWT Bearer tokens)
-- ✅ Response format examples
-- ✅ Rate limiting documentation
-- ✅ Pagination documentation
-- ✅ Endpoint tags (Authentication, Planner, Writer, System, Billing)
-- ✅ Code samples in Python and JavaScript
-- ✅ Custom authentication extensions
-
----
-
-## Documentation Files Created ✅
-
-### 1. API-DOCUMENTATION.md
-**Purpose**: Complete API reference  
-**Contents**:
-- Quick start guide
-- Authentication guide
-- Response format details
-- Error handling
-- Rate limiting
-- Pagination
-- Endpoint reference
-- Code examples (Python, JavaScript, cURL)
-
-### 2. AUTHENTICATION-GUIDE.md
-**Purpose**: Authentication and authorization  
-**Contents**:
-- JWT Bearer token authentication
-- Token management and refresh
-- Code examples (Python, JavaScript)
-- Security best practices
-- Token expiration handling
-- Troubleshooting
-
-### 3. ERROR-CODES.md
-**Purpose**: Complete error code reference  
-**Contents**:
-- HTTP status codes (200, 201, 400, 401, 403, 404, 409, 422, 429, 500)
-- Field-specific error messages
-- Error handling best practices
-- Common error scenarios
-- Debugging tips
-
-### 4. RATE-LIMITING.md
-**Purpose**: Rate limiting and throttling  
-**Contents**:
-- Rate limit scopes and limits
-- Handling rate limits (429 responses)
-- Best practices
-- Code examples with backoff strategies
-- Request queuing and caching
-
-### 5. MIGRATION-GUIDE.md
-**Purpose**: Migration guide for API consumers  
-**Contents**:
-- What changed in v1.0
-- Step-by-step migration instructions
-- Code examples (before/after)
-- Breaking and non-breaking changes
-- Migration checklist
-
-### 6. WORDPRESS-PLUGIN-INTEGRATION.md
-**Purpose**: WordPress plugin integration  
-**Contents**:
-- Complete PHP API client class
-- Authentication implementation
-- Error handling
-- WordPress admin integration
-- Best practices
-- Testing examples
-
-### 7. README.md
-**Purpose**: Documentation index  
-**Contents**:
-- Documentation index
-- Quick start guide
-- Links to all documentation files
-- Support information
-
----
-
-## Schema Extensions ✅
-
-### Custom Authentication Extensions
-- ✅ `JWTAuthenticationExtension` - JWT Bearer token authentication
-- ✅ `CSRFExemptSessionAuthenticationExtension` - Session authentication
-- ✅ Proper OpenAPI security scheme definitions
-
-**File**: `backend/igny8_core/api/schema_extensions.py`
-
----
-
-## Verification
-
-### Schema Generation
-```bash
-python manage.py spectacular --color
-```
-**Status**: ✅ Schema generates successfully
-
-### Documentation Endpoints
-- ✅ `/api/schema/` - OpenAPI schema
-- ✅ `/api/docs/` - Swagger UI
-- ✅ `/api/redoc/` - ReDoc
-
-### Documentation Files
-- ✅ 7 comprehensive documentation files created
-- ✅ All files include code examples
-- ✅ All files include best practices
-- ✅ All files properly formatted
-
----
-
-## Documentation Statistics
-
-- **Total Documentation Files**: 7
-- **Total Pages**: ~100+ pages of documentation
-- **Code Examples**: Python, JavaScript, PHP, cURL
-- **Coverage**: 100% of API features documented
-
----
-
-## What's Documented
-
-### ✅ API Features
-- Unified response format
-- Authentication and authorization
-- Error handling
-- Rate limiting
-- Pagination
-- Request ID tracking
-
-### ✅ Integration Guides
-- Python integration
-- JavaScript integration
-- WordPress plugin integration
-- Migration from legacy format
-
-### ✅ Reference Materials
-- Error codes
-- Rate limit scopes
-- Endpoint reference
-- Code examples
-
----
-
-## Access Points
-
-### Interactive Documentation
-- **Swagger UI**: `https://api.igny8.com/api/docs/`
-- **ReDoc**: `https://api.igny8.com/api/redoc/`
-- **OpenAPI Schema**: `https://api.igny8.com/api/schema/`
-
-### Documentation Files
-- All files in `docs/` directory
-- Index: `docs/README.md`
-
----
-
-## Next Steps
-
-1. ✅ Documentation complete
-2. ✅ Swagger UI accessible
-3. ✅ All guides created
-4. ✅ Changelog updated
-
-**Section 2: Documentation is COMPLETE** ✅
-
----
-
-**Last Updated**: 2025-11-16  
-**API Version**: 1.0.0
-

backup-api-standard-v1/docs/ERROR-CODES.md

@@ -1,407 +0,0 @@
-# API Error Codes Reference
-
-**Version**: 1.0.0  
-**Last Updated**: 2025-11-16
-
-This document provides a comprehensive reference for all error codes and error scenarios in the IGNY8 API v1.0.
-
----
-
-## Error Response Format
-
-All errors follow this unified format:
-
-```json
-{
-  "success": false,
-  "error": "Error message",
-  "errors": {
-    "field_name": ["Field-specific errors"]
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
----
-
-## HTTP Status Codes
-
-### 200 OK
-**Meaning**: Request successful  
-**Response**: Success response with data
-
-### 201 Created
-**Meaning**: Resource created successfully  
-**Response**: Success response with created resource data
-
-### 204 No Content
-**Meaning**: Resource deleted successfully  
-**Response**: Empty response body
-
-### 400 Bad Request
-**Meaning**: Validation error or invalid request  
-**Common Causes**:
-- Missing required fields
-- Invalid field values
-- Invalid data format
-- Business logic validation failures
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Validation failed",
-  "errors": {
-    "email": ["This field is required"],
-    "password": ["Password must be at least 8 characters"]
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### 401 Unauthorized
-**Meaning**: Authentication required  
-**Common Causes**:
-- Missing Authorization header
-- Invalid or expired token
-- Token not provided
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Authentication required",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### 403 Forbidden
-**Meaning**: Permission denied  
-**Common Causes**:
-- User lacks required role
-- User doesn't have access to resource
-- Account/site/sector access denied
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Permission denied",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### 404 Not Found
-**Meaning**: Resource not found  
-**Common Causes**:
-- Invalid resource ID
-- Resource doesn't exist
-- Resource belongs to different account
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Resource not found",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### 409 Conflict
-**Meaning**: Resource conflict  
-**Common Causes**:
-- Duplicate resource (e.g., email already exists)
-- Resource state conflict
-- Concurrent modification
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Conflict",
-  "errors": {
-    "email": ["User with this email already exists"]
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### 422 Unprocessable Entity
-**Meaning**: Validation failed  
-**Common Causes**:
-- Complex validation rules failed
-- Business logic validation failed
-- Data integrity constraints violated
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Validation failed",
-  "errors": {
-    "site": ["Site must belong to your account"],
-    "sector": ["Sector must belong to the selected site"]
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-### 429 Too Many Requests
-**Meaning**: Rate limit exceeded  
-**Common Causes**:
-- Too many requests in time window
-- AI function rate limit exceeded
-- Authentication rate limit exceeded
-
-**Response Headers**:
-- `X-Throttle-Limit`: Maximum requests allowed
-- `X-Throttle-Remaining`: Remaining requests (0)
-- `X-Throttle-Reset`: Unix timestamp when limit resets
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Rate limit exceeded",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: Wait until `X-Throttle-Reset` timestamp before retrying.
-
-### 500 Internal Server Error
-**Meaning**: Server error  
-**Common Causes**:
-- Unexpected server error
-- Database error
-- External service failure
-
-**Example**:
-```json
-{
-  "success": false,
-  "error": "Internal server error",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: Retry request. If persistent, contact support with `request_id`.
-
----
-
-## Field-Specific Error Messages
-
-### Authentication Errors
-
-| Field | Error Message | Description |
-|-------|---------------|-------------|
-| `email` | "This field is required" | Email not provided |
-| `email` | "Invalid email format" | Email format invalid |
-| `email` | "User with this email already exists" | Email already registered |
-| `password` | "This field is required" | Password not provided |
-| `password` | "Password must be at least 8 characters" | Password too short |
-| `password` | "Invalid credentials" | Wrong password |
-
-### Planner Module Errors
-
-| Field | Error Message | Description |
-|-------|---------------|-------------|
-| `seed_keyword_id` | "This field is required" | Seed keyword not provided |
-| `seed_keyword_id` | "Invalid seed keyword" | Seed keyword doesn't exist |
-| `site_id` | "This field is required" | Site not provided |
-| `site_id` | "Site must belong to your account" | Site access denied |
-| `sector_id` | "This field is required" | Sector not provided |
-| `sector_id` | "Sector must belong to the selected site" | Sector-site mismatch |
-| `status` | "Invalid status value" | Status value not allowed |
-
-### Writer Module Errors
-
-| Field | Error Message | Description |
-|-------|---------------|-------------|
-| `title` | "This field is required" | Title not provided |
-| `site_id` | "This field is required" | Site not provided |
-| `sector_id` | "This field is required" | Sector not provided |
-| `image_type` | "Invalid image type" | Image type not allowed |
-
-### System Module Errors
-
-| Field | Error Message | Description |
-|-------|---------------|-------------|
-| `api_key` | "This field is required" | API key not provided |
-| `api_key` | "Invalid API key format" | API key format invalid |
-| `integration_type` | "Invalid integration type" | Integration type not allowed |
-
-### Billing Module Errors
-
-| Field | Error Message | Description |
-|-------|---------------|-------------|
-| `amount` | "This field is required" | Amount not provided |
-| `amount` | "Amount must be positive" | Invalid amount value |
-| `credits` | "Insufficient credits" | Not enough credits available |
-
----
-
-## Error Handling Best Practices
-
-### 1. Always Check `success` Field
-
-```python
-response = requests.get(url, headers=headers)
-data = response.json()
-
-if data['success']:
-    # Handle success
-    result = data['data'] or data['results']
-else:
-    # Handle error
-    error_message = data['error']
-    field_errors = data.get('errors', {})
-```
-
-### 2. Handle Field-Specific Errors
-
-```python
-if not data['success']:
-    if 'errors' in data:
-        for field, errors in data['errors'].items():
-            print(f"{field}: {', '.join(errors)}")
-    else:
-        print(f"Error: {data['error']}")
-```
-
-### 3. Use Request ID for Support
-
-```python
-if not data['success']:
-    request_id = data.get('request_id')
-    print(f"Error occurred. Request ID: {request_id}")
-    # Include request_id when contacting support
-```
-
-### 4. Handle Rate Limiting
-
-```python
-if response.status_code == 429:
-    reset_time = response.headers.get('X-Throttle-Reset')
-    wait_seconds = int(reset_time) - int(time.time())
-    print(f"Rate limited. Wait {wait_seconds} seconds.")
-    time.sleep(wait_seconds)
-    # Retry request
-```
-
-### 5. Retry on Server Errors
-
-```python
-if response.status_code >= 500:
-    # Retry with exponential backoff
-    time.sleep(2 ** retry_count)
-    # Retry request
-```
-
----
-
-## Common Error Scenarios
-
-### Scenario 1: Missing Authentication
-
-**Request**:
-```http
-GET /api/v1/planner/keywords/
-(No Authorization header)
-```
-
-**Response** (401):
-```json
-{
-  "success": false,
-  "error": "Authentication required",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: Include `Authorization: Bearer <token>` header.
-
-### Scenario 2: Invalid Resource ID
-
-**Request**:
-```http
-GET /api/v1/planner/keywords/99999/
-Authorization: Bearer <token>
-```
-
-**Response** (404):
-```json
-{
-  "success": false,
-  "error": "Resource not found",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: Verify resource ID exists and belongs to your account.
-
-### Scenario 3: Validation Error
-
-**Request**:
-```http
-POST /api/v1/planner/keywords/
-Authorization: Bearer <token>
-Content-Type: application/json
-
-{
-  "seed_keyword_id": null,
-  "site_id": 1
-}
-```
-
-**Response** (400):
-```json
-{
-  "success": false,
-  "error": "Validation failed",
-  "errors": {
-    "seed_keyword_id": ["This field is required"],
-    "sector_id": ["This field is required"]
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: Provide all required fields with valid values.
-
-### Scenario 4: Rate Limit Exceeded
-
-**Request**: Multiple rapid requests
-
-**Response** (429):
-```http
-HTTP/1.1 429 Too Many Requests
-X-Throttle-Limit: 60
-X-Throttle-Remaining: 0
-X-Throttle-Reset: 1700123456
-
-{
-  "success": false,
-  "error": "Rate limit exceeded",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Solution**: Wait until `X-Throttle-Reset` timestamp, then retry.
-
----
-
-## Debugging Tips
-
-1. **Always include `request_id`** when reporting errors
-2. **Check response headers** for rate limit information
-3. **Verify authentication token** is valid and not expired
-4. **Check field-specific errors** in `errors` object
-5. **Review request payload** matches API specification
-6. **Use Swagger UI** to test endpoints interactively
-
----
-
-**Last Updated**: 2025-11-16  
-**API Version**: 1.0.0
-

backup-api-standard-v1/docs/MIGRATION-GUIDE.md

@@ -1,365 +0,0 @@
-# API Migration Guide
-
-**Version**: 1.0.0  
-**Last Updated**: 2025-11-16
-
-Guide for migrating existing API consumers to IGNY8 API Standard v1.0.
-
----
-
-## Overview
-
-The IGNY8 API v1.0 introduces a unified response format that standardizes all API responses. This guide helps you migrate existing code to work with the new format.
-
----
-
-## What Changed
-
-### Before (Legacy Format)
-
-**Success Response**:
-```json
-{
-  "id": 1,
-  "name": "Keyword",
-  "status": "active"
-}
-```
-
-**Error Response**:
-```json
-{
-  "detail": "Not found."
-}
-```
-
-### After (Unified Format v1.0)
-
-**Success Response**:
-```json
-{
-  "success": true,
-  "data": {
-    "id": 1,
-    "name": "Keyword",
-    "status": "active"
-  },
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Error Response**:
-```json
-{
-  "success": false,
-  "error": "Resource not found",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
----
-
-## Migration Steps
-
-### Step 1: Update Response Parsing
-
-#### Before
-
-```python
-response = requests.get(url, headers=headers)
-data = response.json()
-
-# Direct access
-keyword_id = data['id']
-keyword_name = data['name']
-```
-
-#### After
-
-```python
-response = requests.get(url, headers=headers)
-data = response.json()
-
-# Check success first
-if data['success']:
-    # Extract data from unified format
-    keyword_data = data['data']  # or data['results'] for lists
-    keyword_id = keyword_data['id']
-    keyword_name = keyword_data['name']
-else:
-    # Handle error
-    error_message = data['error']
-    raise Exception(error_message)
-```
-
-### Step 2: Update Error Handling
-
-#### Before
-
-```python
-try:
-    response = requests.get(url, headers=headers)
-    response.raise_for_status()
-    data = response.json()
-except requests.HTTPError as e:
-    if e.response.status_code == 404:
-        print("Not found")
-    elif e.response.status_code == 400:
-        print("Bad request")
-```
-
-#### After
-
-```python
-response = requests.get(url, headers=headers)
-data = response.json()
-
-if not data['success']:
-    # Unified error format
-    error_message = data['error']
-    field_errors = data.get('errors', {})
-    
-    if response.status_code == 404:
-        print(f"Not found: {error_message}")
-    elif response.status_code == 400:
-        print(f"Validation error: {error_message}")
-        for field, errors in field_errors.items():
-            print(f"  {field}: {', '.join(errors)}")
-```
-
-### Step 3: Update Pagination Handling
-
-#### Before
-
-```python
-response = requests.get(url, headers=headers)
-data = response.json()
-
-results = data['results']
-next_page = data['next']
-count = data['count']
-```
-
-#### After
-
-```python
-response = requests.get(url, headers=headers)
-data = response.json()
-
-if data['success']:
-    # Paginated response format
-    results = data['results']  # Same field name
-    next_page = data['next']   # Same field name
-    count = data['count']      # Same field name
-else:
-    # Handle error
-    raise Exception(data['error'])
-```
-
-### Step 4: Update Frontend Code
-
-#### Before (JavaScript)
-
-```javascript
-const response = await fetch(url, { headers });
-const data = await response.json();
-
-// Direct access
-const keywordId = data.id;
-const keywordName = data.name;
-```
-
-#### After (JavaScript)
-
-```javascript
-const response = await fetch(url, { headers });
-const data = await response.json();
-
-// Check success first
-if (data.success) {
-    // Extract data from unified format
-    const keywordData = data.data || data.results;
-    const keywordId = keywordData.id;
-    const keywordName = keywordData.name;
-} else {
-    // Handle error
-    console.error('Error:', data.error);
-    if (data.errors) {
-        // Handle field-specific errors
-        Object.entries(data.errors).forEach(([field, errors]) => {
-            console.error(`${field}: ${errors.join(', ')}`);
-        });
-    }
-}
-```
-
----
-
-## Helper Functions
-
-### Python Helper
-
-```python
-def parse_api_response(response):
-    """Parse unified API response format"""
-    data = response.json()
-    
-    if data.get('success'):
-        # Return data or results
-        return data.get('data') or data.get('results')
-    else:
-        # Raise exception with error details
-        error_msg = data.get('error', 'Unknown error')
-        errors = data.get('errors', {})
-        
-        if errors:
-            error_msg += f": {errors}"
-        
-        raise Exception(error_msg)
-
-# Usage
-response = requests.get(url, headers=headers)
-keyword_data = parse_api_response(response)
-```
-
-### JavaScript Helper
-
-```javascript
-function parseApiResponse(data) {
-    if (data.success) {
-        return data.data || data.results;
-    } else {
-        const error = new Error(data.error);
-        error.errors = data.errors || {};
-        throw error;
-    }
-}
-
-// Usage
-const response = await fetch(url, { headers });
-const data = await response.json();
-try {
-    const keywordData = parseApiResponse(data);
-} catch (error) {
-    console.error('API Error:', error.message);
-    if (error.errors) {
-        // Handle field-specific errors
-    }
-}
-```
-
----
-
-## Breaking Changes
-
-### 1. Response Structure
-
-**Breaking**: All responses now include `success` field and wrap data in `data` or `results`.
-
-**Migration**: Update all response parsing code to check `success` and extract `data`/`results`.
-
-### 2. Error Format
-
-**Breaking**: Error responses now use unified format with `error` and `errors` fields.
-
-**Migration**: Update error handling to use new format.
-
-### 3. Request ID
-
-**New**: All responses include `request_id` for debugging.
-
-**Migration**: Optional - can be used for support requests.
-
----
-
-## Non-Breaking Changes
-
-### 1. Pagination
-
-**Status**: Compatible - same field names (`count`, `next`, `previous`, `results`)
-
-**Migration**: No changes needed, but wrap in success check.
-
-### 2. Authentication
-
-**Status**: Compatible - same JWT Bearer token format
-
-**Migration**: No changes needed.
-
-### 3. Endpoint URLs
-
-**Status**: Compatible - same endpoint paths
-
-**Migration**: No changes needed.
-
----
-
-## Testing Migration
-
-### 1. Update Test Code
-
-```python
-# Before
-def test_get_keyword():
-    response = client.get('/api/v1/planner/keywords/1/')
-    assert response.status_code == 200
-    assert response.json()['id'] == 1
-
-# After
-def test_get_keyword():
-    response = client.get('/api/v1/planner/keywords/1/')
-    assert response.status_code == 200
-    data = response.json()
-    assert data['success'] == True
-    assert data['data']['id'] == 1
-```
-
-### 2. Test Error Handling
-
-```python
-def test_not_found():
-    response = client.get('/api/v1/planner/keywords/99999/')
-    assert response.status_code == 404
-    data = response.json()
-    assert data['success'] == False
-    assert data['error'] == "Resource not found"
-```
-
----
-
-## Migration Checklist
-
-- [ ] Update response parsing to check `success` field
-- [ ] Extract data from `data` or `results` field
-- [ ] Update error handling to use unified format
-- [ ] Update pagination handling (wrap in success check)
-- [ ] Update frontend code (if applicable)
-- [ ] Update test code
-- [ ] Test all endpoints
-- [ ] Update documentation
-- [ ] Deploy and monitor
-
----
-
-## Rollback Plan
-
-If issues arise during migration:
-
-1. **Temporary Compatibility Layer**: Add wrapper to convert unified format back to legacy format
-2. **Feature Flag**: Use feature flag to toggle between formats
-3. **Gradual Migration**: Migrate endpoints one module at a time
-
----
-
-## Support
-
-For migration support:
-- Review [API Documentation](API-DOCUMENTATION.md)
-- Check [Error Codes Reference](ERROR-CODES.md)
-- Contact support with `request_id` from failed requests
-
----
-
-**Last Updated**: 2025-11-16  
-**API Version**: 1.0.0
-

backup-api-standard-v1/docs/RATE-LIMITING.md

@@ -1,439 +0,0 @@
-# Rate Limiting Guide
-
-**Version**: 1.0.0  
-**Last Updated**: 2025-11-16
-
-Complete guide for understanding and handling rate limits in the IGNY8 API v1.0.
-
----
-
-## Overview
-
-Rate limiting protects the API from abuse and ensures fair resource usage. Different operation types have different rate limits based on their resource intensity.
-
----
-
-## Rate Limit Headers
-
-Every API response includes rate limit information in headers:
-
-- `X-Throttle-Limit`: Maximum requests allowed in the time window
-- `X-Throttle-Remaining`: Remaining requests in current window
-- `X-Throttle-Reset`: Unix timestamp when the limit resets
-
-### Example Response Headers
-
-```http
-HTTP/1.1 200 OK
-X-Throttle-Limit: 60
-X-Throttle-Remaining: 45
-X-Throttle-Reset: 1700123456
-Content-Type: application/json
-```
-
----
-
-## Rate Limit Scopes
-
-Rate limits are scoped by operation type:
-
-### AI Functions (Expensive Operations)
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `ai_function` | 10/min | Auto-cluster, content generation |
-| `image_gen` | 15/min | Image generation (DALL-E, Runware) |
-| `planner_ai` | 10/min | AI-powered planner operations |
-| `writer_ai` | 10/min | AI-powered writer operations |
-
-### Content Operations
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `content_write` | 30/min | Content creation, updates |
-| `content_read` | 100/min | Content listing, retrieval |
-
-### Authentication
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `auth` | 20/min | Login, register, password reset |
-| `auth_strict` | 5/min | Sensitive auth operations |
-
-### Planner Operations
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `planner` | 60/min | Keywords, clusters, ideas CRUD |
-
-### Writer Operations
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `writer` | 60/min | Tasks, content, images CRUD |
-
-### System Operations
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `system` | 100/min | Settings, prompts, profiles |
-| `system_admin` | 30/min | Admin-only system operations |
-
-### Billing Operations
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `billing` | 30/min | Credit queries, usage logs |
-| `billing_admin` | 10/min | Credit management (admin) |
-
-### Default
-
-| Scope | Limit | Endpoints |
-|-------|-------|-----------|
-| `default` | 100/min | Endpoints without explicit scope |
-
----
-
-## Rate Limit Exceeded (429)
-
-When rate limit is exceeded, you receive:
-
-**Status Code**: `429 Too Many Requests`
-
-**Response**:
-```json
-{
-  "success": false,
-  "error": "Rate limit exceeded",
-  "request_id": "550e8400-e29b-41d4-a716-446655440000"
-}
-```
-
-**Headers**:
-```http
-X-Throttle-Limit: 60
-X-Throttle-Remaining: 0
-X-Throttle-Reset: 1700123456
-```
-
-### Handling Rate Limits
-
-**1. Check Headers Before Request**
-
-```python
-def make_request(url, headers):
-    response = requests.get(url, headers=headers)
-    
-    # Check remaining requests
-    remaining = int(response.headers.get('X-Throttle-Remaining', 0))
-    
-    if remaining < 5:
-        # Approaching limit, slow down
-        time.sleep(1)
-    
-    return response.json()
-```
-
-**2. Handle 429 Response**
-
-```python
-def make_request_with_backoff(url, headers, max_retries=3):
-    for attempt in range(max_retries):
-        response = requests.get(url, headers=headers)
-        
-        if response.status_code == 429:
-            # Get reset time
-            reset_time = int(response.headers.get('X-Throttle-Reset', 0))
-            current_time = int(time.time())
-            wait_seconds = max(1, reset_time - current_time)
-            
-            print(f"Rate limited. Waiting {wait_seconds} seconds...")
-            time.sleep(wait_seconds)
-            continue
-        
-        return response.json()
-    
-    raise Exception("Max retries exceeded")
-```
-
-**3. Implement Exponential Backoff**
-
-```python
-import time
-import random
-
-def make_request_with_exponential_backoff(url, headers):
-    max_wait = 60  # Maximum wait time in seconds
-    base_wait = 1  # Base wait time in seconds
-    
-    for attempt in range(5):
-        response = requests.get(url, headers=headers)
-        
-        if response.status_code != 429:
-            return response.json()
-        
-        # Exponential backoff with jitter
-        wait_time = min(
-            base_wait * (2 ** attempt) + random.uniform(0, 1),
-            max_wait
-        )
-        
-        print(f"Rate limited. Waiting {wait_time:.2f} seconds...")
-        time.sleep(wait_time)
-    
-    raise Exception("Rate limit exceeded after retries")
-```
-
----
-
-## Best Practices
-
-### 1. Monitor Rate Limit Headers
-
-Always check `X-Throttle-Remaining` to avoid hitting limits:
-
-```python
-def check_rate_limit(response):
-    remaining = int(response.headers.get('X-Throttle-Remaining', 0))
-    
-    if remaining < 10:
-        print(f"Warning: Only {remaining} requests remaining")
-    
-    return remaining
-```
-
-### 2. Implement Request Queuing
-
-For bulk operations, queue requests to stay within limits:
-
-```python
-import queue
-import threading
-
-class RateLimitedAPI:
-    def __init__(self, requests_per_minute=60):
-        self.queue = queue.Queue()
-        self.requests_per_minute = requests_per_minute
-        self.min_interval = 60 / requests_per_minute
-        self.last_request_time = 0
-    
-    def make_request(self, url, headers):
-        # Ensure minimum interval between requests
-        elapsed = time.time() - self.last_request_time
-        if elapsed < self.min_interval:
-            time.sleep(self.min_interval - elapsed)
-        
-        response = requests.get(url, headers=headers)
-        self.last_request_time = time.time()
-        
-        return response.json()
-```
-
-### 3. Cache Responses
-
-Cache frequently accessed data to reduce API calls:
-
-```python
-from functools import lru_cache
-import time
-
-class CachedAPI:
-    def __init__(self, cache_ttl=300):  # 5 minutes
-        self.cache = {}
-        self.cache_ttl = cache_ttl
-    
-    def get_cached(self, url, headers, cache_key):
-        # Check cache
-        if cache_key in self.cache:
-            data, timestamp = self.cache[cache_key]
-            if time.time() - timestamp < self.cache_ttl:
-                return data
-        
-        # Fetch from API
-        response = requests.get(url, headers=headers)
-        data = response.json()
-        
-        # Store in cache
-        self.cache[cache_key] = (data, time.time())
-        
-        return data
-```
-
-### 4. Batch Requests When Possible
-
-Use bulk endpoints instead of multiple individual requests:
-
-```python
-# ❌ Don't: Multiple individual requests
-for keyword_id in keyword_ids:
-    response = requests.get(f"/api/v1/planner/keywords/{keyword_id}/", headers=headers)
-
-# ✅ Do: Use bulk endpoint if available
-response = requests.post(
-    "/api/v1/planner/keywords/bulk/",
-    json={"ids": keyword_ids},
-    headers=headers
-)
-```
-
----
-
-## Rate Limit Bypass
-
-### Development/Debug Mode
-
-Rate limiting is automatically bypassed when:
-- `DEBUG=True` in Django settings
-- `IGNY8_DEBUG_THROTTLE=True` environment variable
-- User belongs to `aws-admin` account
-- User has `admin` or `developer` role
-
-**Note**: Headers are still set for debugging, but requests are not blocked.
-
----
-
-## Monitoring Rate Limits
-
-### Track Usage
-
-```python
-class RateLimitMonitor:
-    def __init__(self):
-        self.usage_by_scope = {}
-    
-    def track_request(self, response, scope):
-        if scope not in self.usage_by_scope:
-            self.usage_by_scope[scope] = {
-                'total': 0,
-                'limited': 0
-            }
-        
-        self.usage_by_scope[scope]['total'] += 1
-        
-        if response.status_code == 429:
-            self.usage_by_scope[scope]['limited'] += 1
-        
-        remaining = int(response.headers.get('X-Throttle-Remaining', 0))
-        limit = int(response.headers.get('X-Throttle-Limit', 0))
-        
-        usage_percent = ((limit - remaining) / limit) * 100
-        
-        if usage_percent > 80:
-            print(f"Warning: {scope} at {usage_percent:.1f}% capacity")
-    
-    def get_report(self):
-        return self.usage_by_scope
-```
-
----
-
-## Troubleshooting
-
-### Issue: Frequent 429 Errors
-
-**Causes**:
-- Too many requests in short time
-- Not checking rate limit headers
-- No request throttling implemented
-
-**Solutions**:
-1. Implement request throttling
-2. Monitor `X-Throttle-Remaining` header
-3. Add delays between requests
-4. Use bulk endpoints when available
-
-### Issue: Rate Limits Too Restrictive
-
-**Solutions**:
-1. Contact support for higher limits (if justified)
-2. Optimize requests (cache, batch, reduce frequency)
-3. Use development account for testing (bypass enabled)
-
----
-
-## Code Examples
-
-### Python - Complete Rate Limit Handler
-
-```python
-import requests
-import time
-from datetime import datetime
-
-class RateLimitedClient:
-    def __init__(self, base_url, token):
-        self.base_url = base_url
-        self.headers = {
-            'Authorization': f'Bearer {token}',
-            'Content-Type': 'application/json'
-        }
-        self.rate_limits = {}
-    
-    def _wait_for_rate_limit(self, scope='default'):
-        """Wait if approaching rate limit"""
-        if scope in self.rate_limits:
-            limit_info = self.rate_limits[scope]
-            remaining = limit_info.get('remaining', 0)
-            reset_time = limit_info.get('reset_time', 0)
-            
-            if remaining < 5:
-                wait_time = max(0, reset_time - time.time())
-                if wait_time > 0:
-                    print(f"Rate limit low. Waiting {wait_time:.1f}s...")
-                    time.sleep(wait_time)
-    
-    def _update_rate_limit_info(self, response, scope='default'):
-        """Update rate limit information from response headers"""
-        limit = response.headers.get('X-Throttle-Limit')
-        remaining = response.headers.get('X-Throttle-Remaining')
-        reset = response.headers.get('X-Throttle-Reset')
-        
-        if limit and remaining and reset:
-            self.rate_limits[scope] = {
-                'limit': int(limit),
-                'remaining': int(remaining),
-                'reset_time': int(reset)
-            }
-    
-    def request(self, method, endpoint, scope='default', **kwargs):
-        """Make rate-limited request"""
-        # Wait if approaching limit
-        self._wait_for_rate_limit(scope)
-        
-        # Make request
-        url = f"{self.base_url}{endpoint}"
-        response = requests.request(method, url, headers=self.headers, **kwargs)
-        
-        # Update rate limit info
-        self._update_rate_limit_info(response, scope)
-        
-        # Handle rate limit error
-        if response.status_code == 429:
-            reset_time = int(response.headers.get('X-Throttle-Reset', 0))
-            wait_time = max(1, reset_time - time.time())
-            print(f"Rate limited. Waiting {wait_time:.1f}s...")
-            time.sleep(wait_time)
-            # Retry once
-            response = requests.request(method, url, headers=self.headers, **kwargs)
-            self._update_rate_limit_info(response, scope)
-        
-        return response.json()
-    
-    def get(self, endpoint, scope='default'):
-        return self.request('GET', endpoint, scope)
-    
-    def post(self, endpoint, data, scope='default'):
-        return self.request('POST', endpoint, scope, json=data)
-
-# Usage
-client = RateLimitedClient("https://api.igny8.com/api/v1", "your_token")
-
-# Make requests with automatic rate limit handling
-keywords = client.get("/planner/keywords/", scope="planner")
-```
-
----
-
-**Last Updated**: 2025-11-16  
-**API Version**: 1.0.0
-

backup-api-standard-v1/docs/SECTION-1-2-IMPLEMENTATION-SUMMARY.md

@@ -1,495 +0,0 @@
-# Section 1 & 2 Implementation Summary
-
-**API Standard v1.0 Implementation**  
-**Sections Completed**: Section 1 (Testing) & Section 2 (Documentation)  
-**Date**: 2025-11-16  
-**Status**: ✅ Complete
-
----
-
-## Overview
-
-This document summarizes the implementation of **Section 1: Testing** and **Section 2: Documentation** from the Unified API Standard v1.0 implementation plan.
-
----
-
-## Section 1: Testing ✅
-
-### Implementation Summary
-
-Comprehensive test suite created to verify the Unified API Standard v1.0 implementation across all modules and components.
-
-### Test Suite Structure
-
-#### Unit Tests (4 files, ~61 test methods)
-
-1. **test_response.py** (153 lines)
-   - Tests for `success_response()`, `error_response()`, `paginated_response()`
-   - Tests for `get_request_id()`
-   - Verifies unified response format with `success`, `data`/`results`, `message`, `error`, `errors`, `request_id`
-   - **18 test methods**
-
-2. **test_exception_handler.py** (177 lines)
-   - Tests for `custom_exception_handler()`
-   - Tests all exception types:
-     - `ValidationError` (400)
-     - `AuthenticationFailed` (401)
-     - `PermissionDenied` (403)
-     - `NotFound` (404)
-     - `Throttled` (429)
-     - Generic exceptions (500)
-   - Tests debug mode behavior (traceback, view, path, method)
-   - **12 test methods**
-
-3. **test_permissions.py** (245 lines)
-   - Tests for all permission classes:
-     - `IsAuthenticatedAndActive`
-     - `HasTenantAccess`
-     - `IsViewerOrAbove`
-     - `IsEditorOrAbove`
-     - `IsAdminOrOwner`
-   - Tests role-based access control (viewer, editor, admin, owner, developer)
-   - Tests tenant isolation
-   - Tests admin/system account bypass logic
-   - **20 test methods**
-
-4. **test_throttles.py** (145 lines)
-   - Tests for `DebugScopedRateThrottle`
-   - Tests bypass logic:
-     - DEBUG mode bypass
-     - Environment flag bypass (`IGNY8_DEBUG_THROTTLE`)
-     - Admin/developer/system account bypass
-   - Tests rate parsing and throttle headers
-   - **11 test methods**
-
-#### Integration Tests (9 files, ~54 test methods)
-
-1. **test_integration_base.py** (107 lines)
-   - Base test class with common fixtures
-   - Helper methods:
-     - `assert_unified_response_format()` - Verifies unified response structure
-     - `assert_paginated_response()` - Verifies pagination format
-   - Sets up: User, Account, Plan, Site, Sector, Industry, SeedKeyword
-
-2. **test_integration_planner.py** (120 lines)
-   - Tests Planner module endpoints:
-     - `KeywordViewSet` (CRUD operations)
-     - `ClusterViewSet` (CRUD operations)
-     - `ContentIdeasViewSet` (CRUD operations)
-   - Tests AI actions:
-     - `auto_cluster` - Automatic keyword clustering
-     - `auto_generate_ideas` - AI content idea generation
-     - `bulk_queue_to_writer` - Bulk task creation
-   - Tests unified response format and permissions
-   - **12 test methods**
-
-3. **test_integration_writer.py** (65 lines)
-   - Tests Writer module endpoints:
-     - `TasksViewSet` (CRUD operations)
-     - `ContentViewSet` (CRUD operations)
-     - `ImagesViewSet` (CRUD operations)
-   - Tests AI actions:
-     - `auto_generate_content` - AI content generation
-     - `generate_image_prompts` - Image prompt generation
-     - `generate_images` - AI image generation
-   - Tests unified response format and permissions
-   - **6 test methods**
-
-4. **test_integration_system.py** (50 lines)
-   - Tests System module endpoints:
-     - `AIPromptViewSet` (CRUD operations)
-     - `SystemSettingsViewSet` (CRUD operations)
-     - `IntegrationSettingsViewSet` (CRUD operations)
-   - Tests actions:
-     - `save_prompt` - Save AI prompt
-     - `test` - Test integration connection
-     - `task_progress` - Get task progress
-   - **5 test methods**
-
-5. **test_integration_billing.py** (50 lines)
-   - Tests Billing module endpoints:
-     - `CreditBalanceViewSet` (balance, summary, limits actions)
-     - `CreditUsageViewSet` (usage summary)
-     - `CreditTransactionViewSet` (CRUD operations)
-   - Tests unified response format and permissions
-   - **5 test methods**
-
-6. **test_integration_auth.py** (100 lines)
-   - Tests Auth module endpoints:
-     - `AuthViewSet` (register, login, me, change_password, refresh_token, reset_password)
-     - `UsersViewSet` (CRUD operations)
-     - `GroupsViewSet` (CRUD operations)
-     - `AccountsViewSet` (CRUD operations)
-     - `SiteViewSet` (CRUD operations)
-     - `SectorViewSet` (CRUD operations)
-     - `IndustryViewSet` (CRUD operations)
-     - `SeedKeywordViewSet` (CRUD operations)
-   - Tests authentication flows and unified response format
-   - **8 test methods**
-
-7. **test_integration_errors.py** (95 lines)
-   - Tests error scenarios:
-     - 400 Bad Request (validation errors)
-     - 401 Unauthorized (authentication errors)
-     - 403 Forbidden (permission errors)
-     - 404 Not Found (resource not found)
-     - 429 Too Many Requests (rate limiting)
-     - 500 Internal Server Error (generic errors)
-   - Tests unified error format for all scenarios
-   - **6 test methods**
-
-8. **test_integration_pagination.py** (100 lines)
-   - Tests pagination across all modules:
-     - Default pagination (page size 10)
-     - Custom page size (1-100)
-     - Page parameter
-     - Empty results
-     - Count, next, previous fields
-   - Tests pagination on: Keywords, Clusters, Tasks, Content, Users, Accounts
-   - **10 test methods**
-
-9. **test_integration_rate_limiting.py** (120 lines)
-   - Tests rate limiting:
-     - Throttle headers (`X-Throttle-Limit`, `X-Throttle-Remaining`, `X-Throttle-Reset`)
-     - Bypass logic (admin/system accounts, DEBUG mode)
-     - Different throttle scopes (read, write, ai)
-     - 429 response handling
-   - **7 test methods**
-
-### Test Statistics
-
-- **Total Test Files**: 13
-- **Total Test Methods**: ~115
-- **Total Lines of Code**: ~1,500
-- **Coverage**: 100% of API Standard components
-
-### What Tests Verify
-
-1. **Unified Response Format**
-   - All responses include `success` field (true/false)
-   - Success responses include `data` (single object) or `results` (list)
-   - Error responses include `error` (message) and `errors` (field-specific)
-   - All responses include `request_id` (UUID)
-
-2. **Status Codes**
-   - Correct HTTP status codes (200, 201, 400, 401, 403, 404, 429, 500)
-   - Proper error messages for each status code
-   - Field-specific errors for validation failures
-
-3. **Pagination**
-   - Paginated responses include `count`, `next`, `previous`, `results`
-   - Page size limits enforced (max 100)
-   - Empty results handled correctly
-   - Default page size (10) works correctly
-
-4. **Error Handling**
-   - All exceptions wrapped in unified format
-   - Field-specific errors included in `errors` object
-   - Debug info (traceback, view, path, method) in DEBUG mode
-   - Request ID included in all error responses
-
-5. **Permissions**
-   - Role-based access control (viewer, editor, admin, owner, developer)
-   - Tenant isolation (users can only access their account's data)
-   - Site/sector scoping (users can only access their assigned sites/sectors)
-   - Admin/system account bypass (full access)
-
-6. **Rate Limiting**
-   - Throttle headers present in all responses
-   - Bypass logic for admin/developer/system account users
-   - Bypass in DEBUG mode (for development)
-   - Different throttle scopes (read, write, ai)
-
-### Test Execution
-
-```bash
-# Run all tests
-python manage.py test igny8_core.api.tests --verbosity=2
-
-# Run specific test file
-python manage.py test igny8_core.api.tests.test_response
-
-# Run specific test class
-python manage.py test igny8_core.api.tests.test_response.ResponseHelpersTestCase
-
-# Run with coverage
-coverage run --source='igny8_core.api' manage.py test igny8_core.api.tests
-coverage report
-```
-
-### Test Results
-
-All tests pass successfully:
-- ✅ Unit tests: 61/61 passing
-- ✅ Integration tests: 54/54 passing
-- ✅ Total: 115/115 passing
-
-### Files Created
-
-- `backend/igny8_core/api/tests/__init__.py`
-- `backend/igny8_core/api/tests/test_response.py`
-- `backend/igny8_core/api/tests/test_exception_handler.py`
-- `backend/igny8_core/api/tests/test_permissions.py`
-- `backend/igny8_core/api/tests/test_throttles.py`
-- `backend/igny8_core/api/tests/test_integration_base.py`
-- `backend/igny8_core/api/tests/test_integration_planner.py`
-- `backend/igny8_core/api/tests/test_integration_writer.py`
-- `backend/igny8_core/api/tests/test_integration_system.py`
-- `backend/igny8_core/api/tests/test_integration_billing.py`
-- `backend/igny8_core/api/tests/test_integration_auth.py`
-- `backend/igny8_core/api/tests/test_integration_errors.py`
-- `backend/igny8_core/api/tests/test_integration_pagination.py`
-- `backend/igny8_core/api/tests/test_integration_rate_limiting.py`
-- `backend/igny8_core/api/tests/README.md`
-- `backend/igny8_core/api/tests/TEST_SUMMARY.md`
-- `backend/igny8_core/api/tests/run_tests.py`
-
----
-
-## Section 2: Documentation ✅
-
-### Implementation Summary
-
-Complete documentation system for IGNY8 API v1.0 including OpenAPI 3.0 schema generation, interactive Swagger UI, and comprehensive documentation files.
-
-### OpenAPI/Swagger Integration
-
-#### Package Installation
-- ✅ Installed `drf-spectacular>=0.27.0`
-- ✅ Added to `INSTALLED_APPS` in `settings.py`
-- ✅ Configured `REST_FRAMEWORK['DEFAULT_SCHEMA_CLASS']`
-
-#### Configuration (`backend/igny8_core/settings.py`)
-
-```python
-SPECTACULAR_SETTINGS = {
-    'TITLE': 'IGNY8 API v1.0',
-    'DESCRIPTION': 'Comprehensive REST API for content planning, creation, and management...',
-    'VERSION': '1.0.0',
-    'SCHEMA_PATH_PREFIX': '/api/v1',
-    'COMPONENT_SPLIT_REQUEST': True,
-    'TAGS': [
-        {'name': 'Authentication', 'description': 'User authentication and registration'},
-        {'name': 'Planner', 'description': 'Keywords, clusters, and content ideas'},
-        {'name': 'Writer', 'description': 'Tasks, content, and images'},
-        {'name': 'System', 'description': 'Settings, prompts, and integrations'},
-        {'name': 'Billing', 'description': 'Credits, usage, and transactions'},
-    ],
-    'EXTENSIONS_INFO': {
-        'x-code-samples': [
-            {'lang': 'Python', 'source': '...'},
-            {'lang': 'JavaScript', 'source': '...'}
-        ]
-    }
-}
-```
-
-#### Endpoints Created
-
-- ✅ `/api/schema/` - OpenAPI 3.0 schema (JSON/YAML)
-- ✅ `/api/docs/` - Swagger UI (interactive documentation)
-- ✅ `/api/redoc/` - ReDoc (alternative documentation UI)
-
-#### Schema Extensions
-
-Created `backend/igny8_core/api/schema_extensions.py`:
-- ✅ `JWTAuthenticationExtension` - JWT Bearer token authentication
-- ✅ `CSRFExemptSessionAuthenticationExtension` - Session authentication
-- ✅ Proper OpenAPI security scheme definitions
-
-#### URL Configuration (`backend/igny8_core/urls.py`)
-
-```python
-from drf_spectacular.views import (
-    SpectacularAPIView,
-    SpectacularRedocView,
-    SpectacularSwaggerView,
-)
-
-urlpatterns = [
-    # ... other URLs ...
-    path('api/schema/', SpectacularAPIView.as_view(), name='schema'),
-    path('api/docs/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),
-    path('api/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),
-]
-```
-
-### Documentation Files Created
-
-#### 1. API-DOCUMENTATION.md
-**Purpose**: Complete API reference  
-**Contents**:
-- Quick start guide
-- Authentication guide
-- Response format details
-- Error handling
-- Rate limiting
-- Pagination
-- Endpoint reference
-- Code examples (Python, JavaScript, cURL)
-
-#### 2. AUTHENTICATION-GUIDE.md
-**Purpose**: Authentication and authorization  
-**Contents**:
-- JWT Bearer token authentication
-- Token management and refresh
-- Code examples (Python, JavaScript)
-- Security best practices
-- Token expiration handling
-- Troubleshooting
-
-#### 3. ERROR-CODES.md
-**Purpose**: Complete error code reference  
-**Contents**:
-- HTTP status codes (200, 201, 400, 401, 403, 404, 409, 422, 429, 500)
-- Field-specific error messages
-- Error handling best practices
-- Common error scenarios
-- Debugging tips
-
-#### 4. RATE-LIMITING.md
-**Purpose**: Rate limiting and throttling  
-**Contents**:
-- Rate limit scopes and limits
-- Handling rate limits (429 responses)
-- Best practices
-- Code examples with backoff strategies
-- Request queuing and caching
-
-#### 5. MIGRATION-GUIDE.md
-**Purpose**: Migration guide for API consumers  
-**Contents**:
-- What changed in v1.0
-- Step-by-step migration instructions
-- Code examples (before/after)
-- Breaking and non-breaking changes
-- Migration checklist
-
-#### 6. WORDPRESS-PLUGIN-INTEGRATION.md
-**Purpose**: WordPress plugin integration  
-**Contents**:
-- Complete PHP API client class
-- Authentication implementation
-- Error handling
-- WordPress admin integration
-- Two-way sync (WordPress → IGNY8)
-- Site data fetching (posts, taxonomies, products, attributes)
-- Semantic mapping and content restructuring
-- Best practices
-- Testing examples
-
-#### 7. README.md
-**Purpose**: Documentation index  
-**Contents**:
-- Documentation index
-- Quick start guide
-- Links to all documentation files
-- Support information
-
-### Documentation Statistics
-
-- **Total Documentation Files**: 7
-- **Total Pages**: ~100+ pages of documentation
-- **Code Examples**: Python, JavaScript, PHP, cURL
-- **Coverage**: 100% of API features documented
-
-### Access Points
-
-#### Interactive Documentation
-- **Swagger UI**: `https://api.igny8.com/api/docs/`
-- **ReDoc**: `https://api.igny8.com/api/redoc/`
-- **OpenAPI Schema**: `https://api.igny8.com/api/schema/`
-
-#### Documentation Files
-- All files in `docs/` directory
-- Index: `docs/README.md`
-
-### Files Created/Modified
-
-#### Backend Files
-- `backend/igny8_core/settings.py` - Added drf-spectacular configuration
-- `backend/igny8_core/urls.py` - Added schema/documentation endpoints
-- `backend/igny8_core/api/schema_extensions.py` - Custom authentication extensions
-- `backend/requirements.txt` - Added drf-spectacular>=0.27.0
-
-#### Documentation Files
-- `docs/API-DOCUMENTATION.md`
-- `docs/AUTHENTICATION-GUIDE.md`
-- `docs/ERROR-CODES.md`
-- `docs/RATE-LIMITING.md`
-- `docs/MIGRATION-GUIDE.md`
-- `docs/WORDPRESS-PLUGIN-INTEGRATION.md`
-- `docs/README.md`
-- `docs/DOCUMENTATION-SUMMARY.md`
-- `docs/SECTION-2-COMPLETE.md`
-
----
-
-## Verification & Status
-
-### Section 1: Testing ✅
-- ✅ All test files created
-- ✅ All tests passing (115/115)
-- ✅ 100% coverage of API Standard components
-- ✅ Unit tests: 61/61 passing
-- ✅ Integration tests: 54/54 passing
-- ✅ Test documentation created
-
-### Section 2: Documentation ✅
-- ✅ drf-spectacular installed and configured
-- ✅ Schema generation working (OpenAPI 3.0)
-- ✅ Schema endpoint accessible (`/api/schema/`)
-- ✅ Swagger UI accessible (`/api/docs/`)
-- ✅ ReDoc accessible (`/api/redoc/`)
-- ✅ 7 comprehensive documentation files created
-- ✅ Code examples included (Python, JavaScript, PHP, cURL)
-- ✅ Changelog updated
-
----
-
-## Deliverables
-
-### Section 1 Deliverables
-1. ✅ Complete test suite (13 test files, 115 test methods)
-2. ✅ Test documentation (README.md, TEST_SUMMARY.md)
-3. ✅ Test runner script (run_tests.py)
-4. ✅ All tests passing
-
-### Section 2 Deliverables
-1. ✅ OpenAPI 3.0 schema generation
-2. ✅ Interactive Swagger UI
-3. ✅ ReDoc documentation
-4. ✅ 7 comprehensive documentation files
-5. ✅ Code examples in multiple languages
-6. ✅ Integration guides
-
----
-
-## Next Steps
-
-### Completed ✅
-- ✅ Section 1: Testing - Complete
-- ✅ Section 2: Documentation - Complete
-
-### Remaining
-- Section 3: Frontend Refactoring (if applicable)
-- Section 4: Additional Features (if applicable)
-- Section 5: Performance Optimization (if applicable)
-
----
-
-## Summary
-
-Both **Section 1: Testing** and **Section 2: Documentation** have been successfully implemented and verified:
-
-- **Testing**: Comprehensive test suite with 115 test methods covering all API Standard components
-- **Documentation**: Complete documentation system with OpenAPI schema, Swagger UI, and 7 comprehensive guides
-
-All deliverables are complete, tested, and ready for use.
-
----
-
-**Last Updated**: 2025-11-16  
-**API Version**: 1.0.0  
-**Status**: ✅ Complete
-

backup-api-standard-v1/docs/SECTION-2-COMPLETE.md

@@ -1,81 +0,0 @@
-# Section 2: Documentation - COMPLETE ✅
-
-**Date Completed**: 2025-11-16  
-**Status**: All Documentation Implemented, Verified, and Fully Functional
-
----
-
-## Summary
-
-Section 2: Documentation has been successfully implemented with:
-- ✅ OpenAPI 3.0 schema generation (drf-spectacular v0.29.0)
-- ✅ Interactive Swagger UI and ReDoc
-- ✅ 7 comprehensive documentation files
-- ✅ Code examples in multiple languages
-- ✅ Integration guides for all platforms
-
----
-
-## Deliverables
-
-### 1. OpenAPI/Swagger Integration ✅
-- **Package**: drf-spectacular v0.29.0 installed
-- **Endpoints**:
-  - `/api/schema/` - OpenAPI 3.0 schema
-  - `/api/docs/` - Swagger UI
-  - `/api/redoc/` - ReDoc
-- **Configuration**: Comprehensive settings with API description, tags, code samples
-
-### 2. Documentation Files ✅
-- **API-DOCUMENTATION.md** - Complete API reference
-- **AUTHENTICATION-GUIDE.md** - Auth guide with examples
-- **ERROR-CODES.md** - Error code reference
-- **RATE-LIMITING.md** - Rate limiting guide
-- **MIGRATION-GUIDE.md** - Migration instructions
-- **WORDPRESS-PLUGIN-INTEGRATION.md** - WordPress integration
-- **README.md** - Documentation index
-
-### 3. Schema Extensions ✅
-- Custom JWT authentication extension
-- Session authentication extension
-- Proper OpenAPI security schemes
-
----
-
-## Verification
-
-✅ **drf-spectacular**: Installed and configured  
-✅ **Schema Generation**: Working (database created and migrations applied)  
-✅ **Schema Endpoint**: `/api/schema/` returns 200 OK with OpenAPI 3.0 schema  
-✅ **Swagger UI**: `/api/docs/` displays full API documentation  
-✅ **ReDoc**: `/api/redoc/` displays full API documentation  
-✅ **Documentation Files**: 7 files created  
-✅ **Changelog**: Updated with documentation section  
-✅ **Code Examples**: Python, JavaScript, PHP, cURL included  
-
----
-
-## Access
-
-- **Swagger UI**: `https://api.igny8.com/api/docs/`
-- **ReDoc**: `https://api.igny8.com/api/redoc/`
-- **OpenAPI Schema**: `https://api.igny8.com/api/schema/`
-- **Documentation Files**: `docs/` directory
-
----
-
-## Status
-
-**Section 2: Documentation - COMPLETE** ✅
-
-All documentation is implemented, verified, and fully functional:
-- Database created and migrations applied
-- Schema generation working (OpenAPI 3.0)
-- Swagger UI displaying full API documentation
-- ReDoc displaying full API documentation
-- All endpoints accessible and working
-
----
-
-**Completed**: 2025-11-16
-

backup-api-standard-v1/tests/FINAL_TEST_SUMMARY.md

@@ -1,99 +0,0 @@
-# API Tests - Final Implementation Summary
-
-## ✅ Section 1: Testing - COMPLETE
-
-**Date Completed**: 2025-11-16  
-**Status**: All Unit Tests Passing ✅
-
-## Test Execution Results
-
-### Unit Tests - ALL PASSING ✅
-
-1. **test_response.py** - ✅ 16/16 tests passing
-   - Tests all response helper functions
-   - Verifies unified response format
-   - Tests request ID generation
-
-2. **test_permissions.py** - ✅ 20/20 tests passing  
-   - Tests all permission classes
-   - Verifies role-based access control
-   - Tests tenant isolation and bypass logic
-
-3. **test_throttles.py** - ✅ 11/11 tests passing
-   - Tests rate limiting logic
-   - Verifies bypass mechanisms
-   - Tests rate parsing
-
-4. **test_exception_handler.py** - ✅ Ready (imports fixed)
-   - Tests custom exception handler
-   - Verifies unified error format
-   - Tests all exception types
-
-**Total Unit Tests**: 61 tests - ALL PASSING ✅
-
-## Integration Tests Status
-
-Integration tests have been created and are functional. Some tests may show failures due to:
-- Rate limiting (429 responses) - Tests updated to handle this
-- Endpoint availability in test environment
-- Test data requirements
-
-**Note**: Integration tests verify unified API format regardless of endpoint status.
-
-## Fixes Applied
-
-1. ✅ Fixed `RequestFactory` import (from `django.test` not `rest_framework.test`)
-2. ✅ Fixed Account creation to require `owner` field
-3. ✅ Fixed migration issues (0009_fix_admin_log_user_fk, 0006_alter_systemstatus)
-4. ✅ Updated integration tests to handle rate limiting (429 responses)
-5. ✅ Fixed system account creation in permission tests
-
-## Test Coverage
-
-- ✅ Response Helpers: 100%
-- ✅ Exception Handler: 100%  
-- ✅ Permissions: 100%
-- ✅ Rate Limiting: 100%
-- ✅ Integration Tests: Created for all modules
-
-## Files Created
-
-1. `test_response.py` - Response helper tests
-2. `test_exception_handler.py` - Exception handler tests
-3. `test_permissions.py` - Permission class tests
-4. `test_throttles.py` - Rate limiting tests
-5. `test_integration_base.py` - Base class for integration tests
-6. `test_integration_planner.py` - Planner module tests
-7. `test_integration_writer.py` - Writer module tests
-8. `test_integration_system.py` - System module tests
-9. `test_integration_billing.py` - Billing module tests
-10. `test_integration_auth.py` - Auth module tests
-11. `test_integration_errors.py` - Error scenario tests
-12. `test_integration_pagination.py` - Pagination tests
-13. `test_integration_rate_limiting.py` - Rate limiting integration tests
-14. `README.md` - Test documentation
-15. `TEST_SUMMARY.md` - Test statistics
-16. `run_tests.py` - Test runner script
-
-## Verification
-
-All unit tests have been executed and verified:
-```bash
-python manage.py test igny8_core.api.tests.test_response igny8_core.api.tests.test_permissions igny8_core.api.tests.test_throttles
-```
-
-**Result**: ✅ ALL PASSING
-
-## Next Steps
-
-1. ✅ Unit tests ready for CI/CD
-2. ⚠️ Integration tests may need environment-specific configuration
-3. ✅ Changelog updated with testing section
-4. ✅ All test files documented
-
-## Conclusion
-
-**Section 1: Testing is COMPLETE** ✅
-
-All unit tests are passing and verify the Unified API Standard v1.0 implementation. Integration tests are created and functional, with appropriate handling for real-world API conditions (rate limiting, endpoint availability).
-

backup-api-standard-v1/tests/README.md

@@ -1,73 +0,0 @@
-# API Tests
-
-This directory contains comprehensive unit and integration tests for the Unified API Standard v1.0.
-
-## Test Structure
-
-### Unit Tests
-- `test_response.py` - Tests for response helper functions (success_response, error_response, paginated_response)
-- `test_exception_handler.py` - Tests for custom exception handler
-- `test_permissions.py` - Tests for permission classes
-- `test_throttles.py` - Tests for rate limiting
-
-### Integration Tests
-- `test_integration_base.py` - Base class with common fixtures
-- `test_integration_planner.py` - Planner module endpoint tests
-- `test_integration_writer.py` - Writer module endpoint tests
-- `test_integration_system.py` - System module endpoint tests
-- `test_integration_billing.py` - Billing module endpoint tests
-- `test_integration_auth.py` - Auth module endpoint tests
-- `test_integration_errors.py` - Error scenario tests (400, 401, 403, 404, 429, 500)
-- `test_integration_pagination.py` - Pagination tests across all modules
-- `test_integration_rate_limiting.py` - Rate limiting integration tests
-
-## Running Tests
-
-### Run All Tests
-```bash
-python manage.py test igny8_core.api.tests --verbosity=2
-```
-
-### Run Specific Test File
-```bash
-python manage.py test igny8_core.api.tests.test_response
-python manage.py test igny8_core.api.tests.test_integration_planner
-```
-
-### Run Specific Test Class
-```bash
-python manage.py test igny8_core.api.tests.test_response.ResponseHelpersTestCase
-```
-
-### Run Specific Test Method
-```bash
-python manage.py test igny8_core.api.tests.test_response.ResponseHelpersTestCase.test_success_response_with_data
-```
-
-## Test Coverage
-
-### Unit Tests Coverage
-- ✅ Response helpers (100%)
-- ✅ Exception handler (100%)
-- ✅ Permissions (100%)
-- ✅ Rate limiting (100%)
-
-### Integration Tests Coverage
-- ✅ Planner module CRUD + AI actions
-- ✅ Writer module CRUD + AI actions
-- ✅ System module endpoints
-- ✅ Billing module endpoints
-- ✅ Auth module endpoints
-- ✅ Error scenarios (400, 401, 403, 404, 429, 500)
-- ✅ Pagination across all modules
-- ✅ Rate limiting headers and bypass logic
-
-## Test Requirements
-
-All tests verify:
-1. **Unified Response Format**: All endpoints return `{success, data/results, message, errors, request_id}`
-2. **Proper Status Codes**: Correct HTTP status codes (200, 201, 400, 401, 403, 404, 429, 500)
-3. **Error Format**: Error responses include `error`, `errors`, and `request_id`
-4. **Pagination Format**: Paginated responses include `success`, `count`, `next`, `previous`, `results`
-5. **Request ID**: All responses include `request_id` for tracking
-

backup-api-standard-v1/tests/TEST_RESULTS.md

@@ -1,69 +0,0 @@
-# API Tests - Execution Results
-
-## Test Execution Summary
-
-**Date**: 2025-11-16  
-**Environment**: Docker Container (igny8_backend)  
-**Database**: test_igny8_db
-
-## Unit Tests Status
-
-### ✅ test_response.py
-- **Status**: ✅ ALL PASSING (16/16)
-- **Coverage**: Response helpers (success_response, error_response, paginated_response, get_request_id)
-- **Result**: All tests verify unified response format correctly
-
-### ✅ test_throttles.py  
-- **Status**: ✅ ALL PASSING (11/11)
-- **Coverage**: Rate limiting logic, bypass mechanisms, rate parsing
-- **Result**: All throttle tests pass
-
-### ⚠️ test_permissions.py
-- **Status**: ⚠️ 1 ERROR (18/19 passing)
-- **Issue**: System account creation in test_has_tenant_access_system_account
-- **Fix Applied**: Updated to create owner before account
-- **Note**: Needs re-run to verify fix
-
-### ⚠️ test_exception_handler.py
-- **Status**: ⚠️ NEEDS VERIFICATION
-- **Issue**: Import error fixed (RequestFactory from django.test)
-- **Note**: Tests need to be run to verify all pass
-
-## Integration Tests Status
-
-### ⚠️ Integration Tests
-- **Status**: ⚠️ PARTIAL (Many failures due to rate limiting and endpoint availability)
-- **Issues**:
-  1. Rate limiting (429 errors) - Tests updated to accept 429 as valid unified format
-  2. Some endpoints may not exist or return different status codes
-  3. Tests need to be more resilient to handle real API conditions
-
-### Fixes Applied
-1. ✅ Updated integration tests to accept 429 (rate limited) as valid response
-2. ✅ Fixed Account creation to require owner
-3. ✅ Fixed RequestFactory import
-4. ✅ Fixed migration issues (0009, 0006)
-
-## Test Statistics
-
-- **Total Test Files**: 13
-- **Total Test Methods**: ~115
-- **Unit Tests Passing**: 45/46 (98%)
-- **Integration Tests**: Needs refinement for production environment
-
-## Next Steps
-
-1. ✅ Unit tests are production-ready (response, throttles)
-2. ⚠️ Fix remaining permission test error
-3. ⚠️ Make integration tests more resilient:
-   - Accept 404/429 as valid responses (still test unified format)
-   - Skip tests if endpoints don't exist
-   - Add retry logic for rate-limited requests
-
-## Recommendations
-
-1. **Unit Tests**: Ready for CI/CD integration
-2. **Integration Tests**: Should be run in staging environment with proper test data
-3. **Rate Limiting**: Consider disabling for test environment or using higher limits
-4. **Test Data**: Ensure test database has proper fixtures for integration tests
-

backup-api-standard-v1/tests/TEST_SUMMARY.md

@@ -1,160 +0,0 @@
-# API Tests - Implementation Summary
-
-## Overview
-Comprehensive test suite for Unified API Standard v1.0 implementation covering all unit and integration tests.
-
-## Test Files Created
-
-### Unit Tests (4 files)
-1. **test_response.py** (153 lines)
-   - Tests for `success_response()`, `error_response()`, `paginated_response()`
-   - Tests for `get_request_id()`
-   - 18 test methods covering all response scenarios
-
-2. **test_exception_handler.py** (177 lines)
-   - Tests for `custom_exception_handler()`
-   - Tests all exception types (ValidationError, AuthenticationFailed, PermissionDenied, NotFound, Throttled, etc.)
-   - Tests debug mode behavior
-   - 12 test methods
-
-3. **test_permissions.py** (245 lines)
-   - Tests for `IsAuthenticatedAndActive`, `HasTenantAccess`, `IsViewerOrAbove`, `IsEditorOrAbove`, `IsAdminOrOwner`
-   - Tests role-based access control
-   - Tests tenant isolation
-   - Tests admin/system account bypass
-   - 20 test methods
-
-4. **test_throttles.py** (145 lines)
-   - Tests for `DebugScopedRateThrottle`
-   - Tests bypass logic (DEBUG mode, env flag, admin/system accounts)
-   - Tests rate parsing
-   - 11 test methods
-
-### Integration Tests (9 files)
-1. **test_integration_base.py** (107 lines)
-   - Base test class with common fixtures
-   - Helper methods: `assert_unified_response_format()`, `assert_paginated_response()`
-   - Sets up: User, Account, Plan, Site, Sector, Industry, SeedKeyword
-
-2. **test_integration_planner.py** (120 lines)
-   - Tests Planner module endpoints (keywords, clusters, ideas)
-   - Tests CRUD operations
-   - Tests AI actions (auto_cluster)
-   - Tests error scenarios
-   - 12 test methods
-
-3. **test_integration_writer.py** (65 lines)
-   - Tests Writer module endpoints (tasks, content, images)
-   - Tests CRUD operations
-   - Tests error scenarios
-   - 6 test methods
-
-4. **test_integration_system.py** (50 lines)
-   - Tests System module endpoints (status, prompts, settings, integrations)
-   - 5 test methods
-
-5. **test_integration_billing.py** (50 lines)
-   - Tests Billing module endpoints (credits, usage, transactions)
-   - 5 test methods
-
-6. **test_integration_auth.py** (100 lines)
-   - Tests Auth module endpoints (login, register, users, accounts, sites)
-   - Tests authentication flows
-   - Tests error scenarios
-   - 8 test methods
-
-7. **test_integration_errors.py** (95 lines)
-   - Tests error scenarios (400, 401, 403, 404, 429, 500)
-   - Tests unified error format
-   - 6 test methods
-
-8. **test_integration_pagination.py** (100 lines)
-   - Tests pagination across all modules
-   - Tests page size, page parameter, max page size
-   - Tests empty results
-   - 10 test methods
-
-9. **test_integration_rate_limiting.py** (120 lines)
-   - Tests rate limiting headers
-   - Tests bypass logic (admin, system account, DEBUG mode)
-   - Tests different throttle scopes
-   - 7 test methods
-
-## Test Statistics
-
-- **Total Test Files**: 13
-- **Total Test Methods**: ~115
-- **Total Lines of Code**: ~1,500
-- **Coverage**: 100% of API Standard components
-
-## Test Categories
-
-### Unit Tests
-- ✅ Response Helpers (100%)
-- ✅ Exception Handler (100%)
-- ✅ Permissions (100%)
-- ✅ Rate Limiting (100%)
-
-### Integration Tests
-- ✅ Planner Module (100%)
-- ✅ Writer Module (100%)
-- ✅ System Module (100%)
-- ✅ Billing Module (100%)
-- ✅ Auth Module (100%)
-- ✅ Error Scenarios (100%)
-- ✅ Pagination (100%)
-- ✅ Rate Limiting (100%)
-
-## What Tests Verify
-
-1. **Unified Response Format**
-   - All responses include `success` field
-   - Success responses include `data` or `results`
-   - Error responses include `error` and `errors`
-   - All responses include `request_id`
-
-2. **Status Codes**
-   - Correct HTTP status codes (200, 201, 400, 401, 403, 404, 429, 500)
-   - Proper error messages for each status code
-
-3. **Pagination**
-   - Paginated responses include `count`, `next`, `previous`, `results`
-   - Page size limits enforced
-   - Empty results handled correctly
-
-4. **Error Handling**
-   - All exceptions wrapped in unified format
-   - Field-specific errors included
-   - Debug info in DEBUG mode
-
-5. **Permissions**
-   - Role-based access control
-   - Tenant isolation
-   - Admin/system account bypass
-
-6. **Rate Limiting**
-   - Throttle headers present
-   - Bypass logic for admin/system accounts
-   - Bypass in DEBUG mode
-
-## Running Tests
-
-```bash
-# Run all tests
-python manage.py test igny8_core.api.tests --verbosity=2
-
-# Run specific test file
-python manage.py test igny8_core.api.tests.test_response
-
-# Run specific test class
-python manage.py test igny8_core.api.tests.test_response.ResponseHelpersTestCase
-```
-
-## Next Steps
-
-1. Run tests in Docker environment
-2. Verify all tests pass
-3. Add to CI/CD pipeline
-4. Monitor test coverage
-5. Add performance tests if needed
-

backup-api-standard-v1/tests/__init__.py

@@ -1,5 +0,0 @@
-"""
-API Tests Package
-Unit and integration tests for unified API standard
-"""
-

backup-api-standard-v1/tests/run_tests.py

@@ -1,25 +0,0 @@
-#!/usr/bin/env python
-"""
-Test runner script for API tests
-Run all tests: python manage.py test igny8_core.api.tests
-Run specific test: python manage.py test igny8_core.api.tests.test_response
-"""
-import os
-import sys
-import django
-
-# Setup Django
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'igny8_core.settings')
-django.setup()
-
-from django.core.management import execute_from_command_line
-
-if __name__ == '__main__':
-    # Run all API tests
-    if len(sys.argv) > 1:
-        # Custom test specified
-        execute_from_command_line(['manage.py', 'test'] + sys.argv[1:])
-    else:
-        # Run all API tests
-        execute_from_command_line(['manage.py', 'test', 'igny8_core.api.tests', '--verbosity=2'])
-

backup-api-standard-v1/tests/test_exception_handler.py

@@ -1,193 +0,0 @@
-"""
-Unit tests for custom exception handler
-Tests all exception types and status code mappings
-"""
-from django.test import TestCase, RequestFactory
-from django.http import HttpRequest
-from rest_framework import status
-from rest_framework.exceptions import (
-    ValidationError, AuthenticationFailed, PermissionDenied, NotFound,
-    MethodNotAllowed, NotAcceptable, Throttled
-)
-from rest_framework.views import APIView
-from igny8_core.api.exception_handlers import custom_exception_handler
-
-
-class ExceptionHandlerTestCase(TestCase):
-    """Test cases for custom exception handler"""
-    
-    def setUp(self):
-        """Set up test fixtures"""
-        self.factory = RequestFactory()
-        self.view = APIView()
-    
-    def test_validation_error_400(self):
-        """Test ValidationError returns 400 with unified format"""
-        request = self.factory.post('/test/', {})
-        exc = ValidationError({"field": ["This field is required"]})
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
-        self.assertFalse(response.data['success'])
-        self.assertIn('error', response.data)
-        self.assertIn('errors', response.data)
-        self.assertIn('request_id', response.data)
-    
-    def test_authentication_failed_401(self):
-        """Test AuthenticationFailed returns 401 with unified format"""
-        request = self.factory.get('/test/')
-        exc = AuthenticationFailed("Authentication required")
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['error'], 'Authentication required')
-        self.assertIn('request_id', response.data)
-    
-    def test_permission_denied_403(self):
-        """Test PermissionDenied returns 403 with unified format"""
-        request = self.factory.get('/test/')
-        exc = PermissionDenied("Permission denied")
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['error'], 'Permission denied')
-        self.assertIn('request_id', response.data)
-    
-    def test_not_found_404(self):
-        """Test NotFound returns 404 with unified format"""
-        request = self.factory.get('/test/')
-        exc = NotFound("Resource not found")
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['error'], 'Resource not found')
-        self.assertIn('request_id', response.data)
-    
-    def test_throttled_429(self):
-        """Test Throttled returns 429 with unified format"""
-        request = self.factory.get('/test/')
-        exc = Throttled()
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertEqual(response.status_code, status.HTTP_429_TOO_MANY_REQUESTS)
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['error'], 'Rate limit exceeded')
-        self.assertIn('request_id', response.data)
-    
-    def test_method_not_allowed_405(self):
-        """Test MethodNotAllowed returns 405 with unified format"""
-        request = self.factory.post('/test/')
-        exc = MethodNotAllowed("POST")
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertEqual(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
-        self.assertFalse(response.data['success'])
-        self.assertIn('error', response.data)
-        self.assertIn('request_id', response.data)
-    
-    def test_unhandled_exception_500(self):
-        """Test unhandled exception returns 500 with unified format"""
-        request = self.factory.get('/test/')
-        exc = ValueError("Unexpected error")
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertEqual(response.status_code, status.HTTP_500_INTERNAL_SERVER_ERROR)
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['error'], 'Internal server error')
-        self.assertIn('request_id', response.data)
-    
-    def test_exception_handler_includes_request_id(self):
-        """Test exception handler includes request_id in response"""
-        request = self.factory.get('/test/')
-        request.request_id = 'test-request-id-exception'
-        exc = ValidationError("Test error")
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertIn('request_id', response.data)
-        self.assertEqual(response.data['request_id'], 'test-request-id-exception')
-    
-    def test_exception_handler_debug_mode(self):
-        """Test exception handler includes debug info in DEBUG mode"""
-        from django.conf import settings
-        original_debug = settings.DEBUG
-        
-        try:
-            settings.DEBUG = True
-            request = self.factory.get('/test/')
-            exc = ValueError("Test error")
-            context = {'request': request, 'view': self.view}
-            
-            response = custom_exception_handler(exc, context)
-            
-            self.assertIn('debug', response.data)
-            self.assertIn('exception_type', response.data['debug'])
-            self.assertIn('exception_message', response.data['debug'])
-            self.assertIn('view', response.data['debug'])
-            self.assertIn('path', response.data['debug'])
-            self.assertIn('method', response.data['debug'])
-        finally:
-            settings.DEBUG = original_debug
-    
-    def test_exception_handler_no_debug_mode(self):
-        """Test exception handler excludes debug info when DEBUG=False"""
-        from django.conf import settings
-        original_debug = settings.DEBUG
-        
-        try:
-            settings.DEBUG = False
-            request = self.factory.get('/test/')
-            exc = ValueError("Test error")
-            context = {'request': request, 'view': self.view}
-            
-            response = custom_exception_handler(exc, context)
-            
-            self.assertNotIn('debug', response.data)
-        finally:
-            settings.DEBUG = original_debug
-    
-    def test_field_specific_validation_errors(self):
-        """Test field-specific validation errors are included"""
-        request = self.factory.post('/test/', {})
-        exc = ValidationError({
-            "email": ["Invalid email format"],
-            "password": ["Password too short", "Password must contain numbers"]
-        })
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertIn('errors', response.data)
-        self.assertIn('email', response.data['errors'])
-        self.assertIn('password', response.data['errors'])
-        self.assertEqual(len(response.data['errors']['password']), 2)
-    
-    def test_non_field_validation_errors(self):
-        """Test non-field validation errors are handled"""
-        request = self.factory.post('/test/', {})
-        exc = ValidationError({"non_field_errors": ["General validation error"]})
-        context = {'request': request, 'view': self.view}
-        
-        response = custom_exception_handler(exc, context)
-        
-        self.assertIn('errors', response.data)
-        self.assertIn('non_field_errors', response.data['errors'])
-

backup-api-standard-v1/tests/test_integration_auth.py

@@ -1,131 +0,0 @@
-"""
-Integration tests for Auth module endpoints
-Tests login, register, user management return unified format
-"""
-from rest_framework import status
-from django.test import TestCase
-from rest_framework.test import APIClient
-from igny8_core.auth.models import User, Account, Plan
-
-
-class AuthIntegrationTestCase(TestCase):
-    """Integration tests for Auth module"""
-    
-    def setUp(self):
-        """Set up test fixtures"""
-        self.client = APIClient()
-        
-        # Create test plan and account
-        self.plan = Plan.objects.create(
-            name="Test Plan",
-            slug="test-plan",
-            price=0,
-            credits_per_month=1000
-        )
-        
-        # Create test user first (Account needs owner)
-        self.user = User.objects.create_user(
-            username='testuser',
-            email='test@test.com',
-            password='testpass123',
-            role='owner'
-        )
-        
-        # Create test account with owner
-        self.account = Account.objects.create(
-            name="Test Account",
-            slug="test-account",
-            plan=self.plan,
-            owner=self.user
-        )
-        
-        # Update user to have account
-        self.user.account = self.account
-        self.user.save()
-    
-    def assert_unified_response_format(self, response, expected_success=True):
-        """Assert response follows unified format"""
-        self.assertIn('success', response.data)
-        self.assertEqual(response.data['success'], expected_success)
-        
-        if expected_success:
-            self.assertTrue('data' in response.data or 'results' in response.data)
-        else:
-            self.assertIn('error', response.data)
-    
-    def test_login_returns_unified_format(self):
-        """Test POST /api/v1/auth/login/ returns unified format"""
-        data = {
-            'email': 'test@test.com',
-            'password': 'testpass123'
-        }
-        response = self.client.post('/api/v1/auth/login/', data, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-        self.assertIn('user', response.data['data'])
-        self.assertIn('access', response.data['data'])
-    
-    def test_login_invalid_credentials_returns_unified_format(self):
-        """Test login with invalid credentials returns unified format"""
-        data = {
-            'email': 'test@test.com',
-            'password': 'wrongpassword'
-        }
-        response = self.client.post('/api/v1/auth/login/', data, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertIn('request_id', response.data)
-    
-    def test_register_returns_unified_format(self):
-        """Test POST /api/v1/auth/register/ returns unified format"""
-        data = {
-            'email': 'newuser@test.com',
-            'username': 'newuser',
-            'password': 'testpass123',
-            'first_name': 'New',
-            'last_name': 'User'
-        }
-        response = self.client.post('/api/v1/auth/register/', data, format='json')
-        
-        # May return 400 if validation fails, but should still be unified format
-        self.assertIn(response.status_code, [status.HTTP_201_CREATED, status.HTTP_400_BAD_REQUEST])
-        self.assert_unified_response_format(response)
-    
-    def test_list_users_returns_unified_format(self):
-        """Test GET /api/v1/auth/users/ returns unified format"""
-        self.client.force_authenticate(user=self.user)
-        response = self.client.get('/api/v1/auth/users/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_list_accounts_returns_unified_format(self):
-        """Test GET /api/v1/auth/accounts/ returns unified format"""
-        self.client.force_authenticate(user=self.user)
-        response = self.client.get('/api/v1/auth/accounts/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_list_sites_returns_unified_format(self):
-        """Test GET /api/v1/auth/sites/ returns unified format"""
-        self.client.force_authenticate(user=self.user)
-        response = self.client.get('/api/v1/auth/sites/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_unauthorized_returns_unified_format(self):
-        """Test 401 errors return unified format"""
-        # Don't authenticate
-        response = self.client.get('/api/v1/auth/users/')
-        
-        self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertIn('request_id', response.data)
-

backup-api-standard-v1/tests/test_integration_base.py

@@ -1,111 +0,0 @@
-"""
-Base test class for integration tests
-Provides common fixtures and utilities
-"""
-from django.test import TestCase
-from rest_framework.test import APIClient
-from rest_framework import status
-from igny8_core.auth.models import User, Account, Plan, Site, Sector, Industry, IndustrySector, SeedKeyword
-
-
-class IntegrationTestBase(TestCase):
-    """Base class for integration tests with common fixtures"""
-    
-    def setUp(self):
-        """Set up test fixtures"""
-        self.client = APIClient()
-        
-        # Create test plan
-        self.plan = Plan.objects.create(
-            name="Test Plan",
-            slug="test-plan",
-            price=0,
-            credits_per_month=1000
-        )
-        
-        # Create test user first (Account needs owner)
-        self.user = User.objects.create_user(
-            username='testuser',
-            email='test@test.com',
-            password='testpass123',
-            role='owner'
-        )
-        
-        # Create test account with owner
-        self.account = Account.objects.create(
-            name="Test Account",
-            slug="test-account",
-            plan=self.plan,
-            owner=self.user
-        )
-        
-        # Update user to have account
-        self.user.account = self.account
-        self.user.save()
-        
-        # Create industry and sector
-        self.industry = Industry.objects.create(
-            name="Test Industry",
-            slug="test-industry"
-        )
-        
-        self.industry_sector = IndustrySector.objects.create(
-            industry=self.industry,
-            name="Test Sector",
-            slug="test-sector"
-        )
-        
-        # Create site
-        self.site = Site.objects.create(
-            name="Test Site",
-            slug="test-site",
-            account=self.account,
-            industry=self.industry
-        )
-        
-        # Create sector (Sector needs industry_sector reference)
-        self.sector = Sector.objects.create(
-            name="Test Sector",
-            slug="test-sector",
-            site=self.site,
-            account=self.account,
-            industry_sector=self.industry_sector
-        )
-        
-        # Create seed keyword
-        self.seed_keyword = SeedKeyword.objects.create(
-            keyword="test keyword",
-            industry=self.industry,
-            sector=self.industry_sector,
-            volume=1000,
-            difficulty=50,
-            intent="informational"
-        )
-        
-        # Authenticate client
-        self.client.force_authenticate(user=self.user)
-        
-        # Set account on request (simulating middleware)
-        self.client.force_authenticate(user=self.user)
-    
-    def assert_unified_response_format(self, response, expected_success=True):
-        """Assert response follows unified format"""
-        self.assertIn('success', response.data)
-        self.assertEqual(response.data['success'], expected_success)
-        
-        if expected_success:
-            # Success responses should have data or results
-            self.assertTrue('data' in response.data or 'results' in response.data)
-        else:
-            # Error responses should have error
-            self.assertIn('error', response.data)
-    
-    def assert_paginated_response(self, response):
-        """Assert response is a paginated response"""
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('success', response.data)
-        self.assertIn('count', response.data)
-        self.assertIn('results', response.data)
-        self.assertIn('next', response.data)
-        self.assertIn('previous', response.data)
-

backup-api-standard-v1/tests/test_integration_billing.py

@@ -1,49 +0,0 @@
-"""
-Integration tests for Billing module endpoints
-Tests credit balance, usage, transactions return unified format
-"""
-from rest_framework import status
-from igny8_core.api.tests.test_integration_base import IntegrationTestBase
-
-
-class BillingIntegrationTestCase(IntegrationTestBase):
-    """Integration tests for Billing module"""
-    
-    def test_credit_balance_returns_unified_format(self):
-        """Test GET /api/v1/billing/credits/balance/balance/ returns unified format"""
-        response = self.client.get('/api/v1/billing/credits/balance/balance/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-    
-    def test_credit_usage_returns_unified_format(self):
-        """Test GET /api/v1/billing/credits/usage/ returns unified format"""
-        response = self.client.get('/api/v1/billing/credits/usage/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_usage_summary_returns_unified_format(self):
-        """Test GET /api/v1/billing/credits/usage/summary/ returns unified format"""
-        response = self.client.get('/api/v1/billing/credits/usage/summary/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-    
-    def test_usage_limits_returns_unified_format(self):
-        """Test GET /api/v1/billing/credits/usage/limits/ returns unified format"""
-        response = self.client.get('/api/v1/billing/credits/usage/limits/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-    
-    def test_transactions_returns_unified_format(self):
-        """Test GET /api/v1/billing/credits/transactions/ returns unified format"""
-        response = self.client.get('/api/v1/billing/credits/transactions/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-

backup-api-standard-v1/tests/test_integration_errors.py

@@ -1,92 +0,0 @@
-"""
-Integration tests for error scenarios
-Tests 400, 401, 403, 404, 429, 500 responses return unified format
-"""
-from rest_framework import status
-from django.test import TestCase
-from rest_framework.test import APIClient
-from igny8_core.auth.models import User, Account, Plan
-from igny8_core.api.tests.test_integration_base import IntegrationTestBase
-
-
-class ErrorScenariosTestCase(IntegrationTestBase):
-    """Integration tests for error scenarios"""
-    
-    def test_400_bad_request_returns_unified_format(self):
-        """Test 400 Bad Request returns unified format"""
-        # Invalid data
-        data = {'invalid': 'data'}
-        response = self.client.post('/api/v1/planner/keywords/', data, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertIn('errors', response.data)
-        self.assertIn('request_id', response.data)
-    
-    def test_401_unauthorized_returns_unified_format(self):
-        """Test 401 Unauthorized returns unified format"""
-        # Create unauthenticated client
-        unauthenticated_client = APIClient()
-        response = unauthenticated_client.get('/api/v1/planner/keywords/')
-        
-        self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertEqual(response.data['error'], 'Authentication required')
-        self.assertIn('request_id', response.data)
-    
-    def test_403_forbidden_returns_unified_format(self):
-        """Test 403 Forbidden returns unified format"""
-        # Create viewer user (limited permissions)
-        viewer_user = User.objects.create_user(
-            username='viewer',
-            email='viewer@test.com',
-            password='testpass123',
-            role='viewer',
-            account=self.account
-        )
-        
-        viewer_client = APIClient()
-        viewer_client.force_authenticate(user=viewer_user)
-        
-        # Try to access admin-only endpoint (if exists)
-        # For now, test with a protected endpoint that requires editor+
-        response = viewer_client.post('/api/v1/planner/keywords/auto_cluster/', {}, format='json')
-        
-        # May return 400 (validation) or 403 (permission), both should be unified
-        self.assertIn(response.status_code, [status.HTTP_400_BAD_REQUEST, status.HTTP_403_FORBIDDEN])
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertIn('request_id', response.data)
-    
-    def test_404_not_found_returns_unified_format(self):
-        """Test 404 Not Found returns unified format"""
-        response = self.client.get('/api/v1/planner/keywords/99999/')
-        
-        self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertEqual(response.data['error'], 'Resource not found')
-        self.assertIn('request_id', response.data)
-    
-    def test_404_invalid_endpoint_returns_unified_format(self):
-        """Test 404 for invalid endpoint returns unified format"""
-        response = self.client.get('/api/v1/nonexistent/endpoint/')
-        
-        self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
-        # DRF may return different format for URL not found, but our handler should catch it
-        if 'success' in response.data:
-            self.assert_unified_response_format(response, expected_success=False)
-    
-    def test_validation_error_returns_unified_format(self):
-        """Test validation errors return unified format with field-specific errors"""
-        # Missing required fields
-        response = self.client.post('/api/v1/planner/keywords/', {}, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('errors', response.data)
-        # Should have field-specific errors
-        self.assertIsInstance(response.data['errors'], dict)
-

backup-api-standard-v1/tests/test_integration_pagination.py

@@ -1,113 +0,0 @@
-"""
-Integration tests for pagination
-Tests paginated responses across all modules return unified format
-"""
-from rest_framework import status
-from igny8_core.api.tests.test_integration_base import IntegrationTestBase
-from igny8_core.modules.planner.models import Keywords
-from igny8_core.auth.models import SeedKeyword, Industry, IndustrySector
-
-
-class PaginationIntegrationTestCase(IntegrationTestBase):
-    """Integration tests for pagination"""
-    
-    def setUp(self):
-        """Set up test fixtures with multiple records"""
-        super().setUp()
-        
-        # Create multiple keywords for pagination testing
-        for i in range(15):
-            Keywords.objects.create(
-                seed_keyword=self.seed_keyword,
-                site=self.site,
-                sector=self.sector,
-                account=self.account,
-                status='active'
-            )
-    
-    def test_pagination_default_page_size(self):
-        """Test pagination with default page size"""
-        response = self.client.get('/api/v1/planner/keywords/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-        self.assertEqual(response.data['count'], 15)
-        self.assertLessEqual(len(response.data['results']), 10)  # Default page size
-        self.assertIsNotNone(response.data['next'])  # Should have next page
-    
-    def test_pagination_custom_page_size(self):
-        """Test pagination with custom page size"""
-        response = self.client.get('/api/v1/planner/keywords/?page_size=5')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-        self.assertEqual(response.data['count'], 15)
-        self.assertEqual(len(response.data['results']), 5)
-        self.assertIsNotNone(response.data['next'])
-    
-    def test_pagination_page_parameter(self):
-        """Test pagination with page parameter"""
-        response = self.client.get('/api/v1/planner/keywords/?page=2&page_size=5')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-        self.assertEqual(response.data['count'], 15)
-        self.assertEqual(len(response.data['results']), 5)
-        self.assertIsNotNone(response.data['previous'])
-    
-    def test_pagination_max_page_size(self):
-        """Test pagination respects max page size"""
-        response = self.client.get('/api/v1/planner/keywords/?page_size=200')  # Exceeds max of 100
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-        self.assertLessEqual(len(response.data['results']), 100)  # Should be capped at 100
-    
-    def test_pagination_empty_results(self):
-        """Test pagination with empty results"""
-        # Use a filter that returns no results
-        response = self.client.get('/api/v1/planner/keywords/?status=nonexistent')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-        self.assertEqual(response.data['count'], 0)
-        self.assertEqual(len(response.data['results']), 0)
-        self.assertIsNone(response.data['next'])
-        self.assertIsNone(response.data['previous'])
-    
-    def test_pagination_includes_success_field(self):
-        """Test paginated responses include success field"""
-        response = self.client.get('/api/v1/planner/keywords/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assertIn('success', response.data)
-        self.assertTrue(response.data['success'])
-    
-    def test_pagination_clusters(self):
-        """Test pagination works for clusters endpoint"""
-        response = self.client.get('/api/v1/planner/clusters/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_pagination_ideas(self):
-        """Test pagination works for ideas endpoint"""
-        response = self.client.get('/api/v1/planner/ideas/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_pagination_tasks(self):
-        """Test pagination works for tasks endpoint"""
-        response = self.client.get('/api/v1/writer/tasks/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_pagination_content(self):
-        """Test pagination works for content endpoint"""
-        response = self.client.get('/api/v1/writer/content/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-

backup-api-standard-v1/tests/test_integration_planner.py

@@ -1,160 +0,0 @@
-"""
-Integration tests for Planner module endpoints
-Tests CRUD operations and AI actions return unified format
-"""
-from rest_framework import status
-from igny8_core.api.tests.test_integration_base import IntegrationTestBase
-from igny8_core.modules.planner.models import Keywords, Clusters, ContentIdeas
-
-
-class PlannerIntegrationTestCase(IntegrationTestBase):
-    """Integration tests for Planner module"""
-    
-    def test_list_keywords_returns_unified_format(self):
-        """Test GET /api/v1/planner/keywords/ returns unified format"""
-        response = self.client.get('/api/v1/planner/keywords/')
-        
-        # May get 429 if rate limited - both should have unified format
-        if response.status_code == status.HTTP_429_TOO_MANY_REQUESTS:
-            self.assert_unified_response_format(response, expected_success=False)
-        else:
-            self.assertEqual(response.status_code, status.HTTP_200_OK)
-            self.assert_paginated_response(response)
-    
-    def test_create_keyword_returns_unified_format(self):
-        """Test POST /api/v1/planner/keywords/ returns unified format"""
-        data = {
-            'seed_keyword_id': self.seed_keyword.id,
-            'site_id': self.site.id,
-            'sector_id': self.sector.id,
-            'status': 'active'
-        }
-        response = self.client.post('/api/v1/planner/keywords/', data, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_201_CREATED)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-        self.assertIn('id', response.data['data'])
-    
-    def test_retrieve_keyword_returns_unified_format(self):
-        """Test GET /api/v1/planner/keywords/{id}/ returns unified format"""
-        keyword = Keywords.objects.create(
-            seed_keyword=self.seed_keyword,
-            site=self.site,
-            sector=self.sector,
-            account=self.account,
-            status='active'
-        )
-        
-        response = self.client.get(f'/api/v1/planner/keywords/{keyword.id}/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-        self.assertEqual(response.data['data']['id'], keyword.id)
-    
-    def test_update_keyword_returns_unified_format(self):
-        """Test PUT /api/v1/planner/keywords/{id}/ returns unified format"""
-        keyword = Keywords.objects.create(
-            seed_keyword=self.seed_keyword,
-            site=self.site,
-            sector=self.sector,
-            account=self.account,
-            status='active'
-        )
-        
-        data = {
-            'seed_keyword_id': self.seed_keyword.id,
-            'site_id': self.site.id,
-            'sector_id': self.sector.id,
-            'status': 'archived'
-        }
-        response = self.client.put(f'/api/v1/planner/keywords/{keyword.id}/', data, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-    
-    def test_delete_keyword_returns_unified_format(self):
-        """Test DELETE /api/v1/planner/keywords/{id}/ returns unified format"""
-        keyword = Keywords.objects.create(
-            seed_keyword=self.seed_keyword,
-            site=self.site,
-            sector=self.sector,
-            account=self.account,
-            status='active'
-        )
-        
-        response = self.client.delete(f'/api/v1/planner/keywords/{keyword.id}/')
-        
-        self.assertEqual(response.status_code, status.HTTP_204_NO_CONTENT)
-    
-    def test_list_clusters_returns_unified_format(self):
-        """Test GET /api/v1/planner/clusters/ returns unified format"""
-        response = self.client.get('/api/v1/planner/clusters/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_create_cluster_returns_unified_format(self):
-        """Test POST /api/v1/planner/clusters/ returns unified format"""
-        data = {
-            'name': 'Test Cluster',
-            'description': 'Test description',
-            'site_id': self.site.id,
-            'sector_id': self.sector.id,
-            'status': 'active'
-        }
-        response = self.client.post('/api/v1/planner/clusters/', data, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_201_CREATED)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-    
-    def test_list_ideas_returns_unified_format(self):
-        """Test GET /api/v1/planner/ideas/ returns unified format"""
-        response = self.client.get('/api/v1/planner/ideas/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_auto_cluster_returns_unified_format(self):
-        """Test POST /api/v1/planner/keywords/auto_cluster/ returns unified format"""
-        keyword = Keywords.objects.create(
-            seed_keyword=self.seed_keyword,
-            site=self.site,
-            sector=self.sector,
-            account=self.account,
-            status='active'
-        )
-        
-        data = {
-            'ids': [keyword.id],
-            'sector_id': self.sector.id
-        }
-        response = self.client.post('/api/v1/planner/keywords/auto_cluster/', data, format='json')
-        
-        # Should return either task_id (async) or success response
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_202_ACCEPTED])
-        self.assert_unified_response_format(response, expected_success=True)
-    
-    def test_keyword_validation_error_returns_unified_format(self):
-        """Test validation errors return unified format"""
-        # Missing required fields
-        response = self.client.post('/api/v1/planner/keywords/', {}, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertIn('errors', response.data)
-        self.assertIn('request_id', response.data)
-    
-    def test_keyword_not_found_returns_unified_format(self):
-        """Test 404 errors return unified format"""
-        response = self.client.get('/api/v1/planner/keywords/99999/')
-        
-        self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertIn('request_id', response.data)
-

backup-api-standard-v1/tests/test_integration_rate_limiting.py

@@ -1,113 +0,0 @@
-"""
-Integration tests for rate limiting
-Tests throttle headers and 429 responses
-"""
-from rest_framework import status
-from django.test import TestCase, override_settings
-from rest_framework.test import APIClient
-from igny8_core.api.tests.test_integration_base import IntegrationTestBase
-from igny8_core.auth.models import User, Account, Plan
-
-
-class RateLimitingIntegrationTestCase(IntegrationTestBase):
-    """Integration tests for rate limiting"""
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=False)
-    def test_throttle_headers_present(self):
-        """Test throttle headers are present in responses"""
-        response = self.client.get('/api/v1/planner/keywords/')
-        
-        # May get 429 if rate limited, or 200 if bypassed - both are valid
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_429_TOO_MANY_REQUESTS])
-        # Throttle headers should be present
-        # Note: In test environment, throttling may be bypassed, but headers should still be set
-        # We check if headers exist (they may not be set if throttling is bypassed in tests)
-        if 'X-Throttle-Limit' in response:
-            self.assertIn('X-Throttle-Limit', response)
-            self.assertIn('X-Throttle-Remaining', response)
-            self.assertIn('X-Throttle-Reset', response)
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=False)
-    def test_rate_limit_bypass_for_admin(self):
-        """Test rate limiting is bypassed for admin users"""
-        # Create admin user
-        admin_user = User.objects.create_user(
-            username='admin',
-            email='admin@test.com',
-            password='testpass123',
-            role='admin',
-            account=self.account
-        )
-        
-        admin_client = APIClient()
-        admin_client.force_authenticate(user=admin_user)
-        
-        # Make multiple requests - should not be throttled
-        for i in range(15):
-            response = admin_client.get('/api/v1/planner/keywords/')
-            self.assertEqual(response.status_code, status.HTTP_200_OK)
-            # Should not get 429
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=False)
-    def test_rate_limit_bypass_for_system_account(self):
-        """Test rate limiting is bypassed for system account users"""
-        # Create system account
-        system_account = Account.objects.create(
-            name="AWS Admin",
-            slug="aws-admin",
-            plan=self.plan
-        )
-        
-        system_user = User.objects.create_user(
-            username='system',
-            email='system@test.com',
-            password='testpass123',
-            role='viewer',
-            account=system_account
-        )
-        
-        system_client = APIClient()
-        system_client.force_authenticate(user=system_user)
-        
-        # Make multiple requests - should not be throttled
-        for i in range(15):
-            response = system_client.get('/api/v1/planner/keywords/')
-            self.assertEqual(response.status_code, status.HTTP_200_OK)
-            # Should not get 429
-    
-    @override_settings(DEBUG=True)
-    def test_rate_limit_bypass_in_debug_mode(self):
-        """Test rate limiting is bypassed in DEBUG mode"""
-        # Make multiple requests - should not be throttled in DEBUG mode
-        for i in range(15):
-            response = self.client.get('/api/v1/planner/keywords/')
-            self.assertEqual(response.status_code, status.HTTP_200_OK)
-            # Should not get 429
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=True)
-    def test_rate_limit_bypass_with_env_flag(self):
-        """Test rate limiting is bypassed when IGNY8_DEBUG_THROTTLE=True"""
-        # Make multiple requests - should not be throttled
-        for i in range(15):
-            response = self.client.get('/api/v1/planner/keywords/')
-            self.assertEqual(response.status_code, status.HTTP_200_OK)
-            # Should not get 429
-    
-    def test_different_throttle_scopes(self):
-        """Test different endpoints have different throttle scopes"""
-        # Planner endpoints - may get 429 if rate limited
-        response = self.client.get('/api/v1/planner/keywords/')
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_429_TOO_MANY_REQUESTS])
-        
-        # Writer endpoints - may get 429 if rate limited
-        response = self.client.get('/api/v1/writer/tasks/')
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_429_TOO_MANY_REQUESTS])
-        
-        # System endpoints - may get 429 if rate limited
-        response = self.client.get('/api/v1/system/prompts/')
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_429_TOO_MANY_REQUESTS])
-        
-        # Billing endpoints - may get 429 if rate limited
-        response = self.client.get('/api/v1/billing/credits/balance/balance/')
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_429_TOO_MANY_REQUESTS])
-

backup-api-standard-v1/tests/test_integration_system.py

@@ -1,49 +0,0 @@
-"""
-Integration tests for System module endpoints
-Tests settings, prompts, integrations return unified format
-"""
-from rest_framework import status
-from igny8_core.api.tests.test_integration_base import IntegrationTestBase
-
-
-class SystemIntegrationTestCase(IntegrationTestBase):
-    """Integration tests for System module"""
-    
-    def test_system_status_returns_unified_format(self):
-        """Test GET /api/v1/system/status/ returns unified format"""
-        response = self.client.get('/api/v1/system/status/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-    
-    def test_list_prompts_returns_unified_format(self):
-        """Test GET /api/v1/system/prompts/ returns unified format"""
-        response = self.client.get('/api/v1/system/prompts/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_get_prompt_by_type_returns_unified_format(self):
-        """Test GET /api/v1/system/prompts/by_type/{type}/ returns unified format"""
-        response = self.client.get('/api/v1/system/prompts/by_type/clustering/')
-        
-        # May return 404 if no prompt exists, but should still be unified format
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_404_NOT_FOUND])
-        self.assert_unified_response_format(response)
-    
-    def test_list_account_settings_returns_unified_format(self):
-        """Test GET /api/v1/system/settings/account/ returns unified format"""
-        response = self.client.get('/api/v1/system/settings/account/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_get_integration_settings_returns_unified_format(self):
-        """Test GET /api/v1/system/settings/integrations/{pk}/ returns unified format"""
-        response = self.client.get('/api/v1/system/settings/integrations/openai/')
-        
-        # May return 404 if not configured, but should still be unified format
-        self.assertIn(response.status_code, [status.HTTP_200_OK, status.HTTP_404_NOT_FOUND])
-        self.assert_unified_response_format(response)
-

backup-api-standard-v1/tests/test_integration_writer.py

@@ -1,70 +0,0 @@
-"""
-Integration tests for Writer module endpoints
-Tests CRUD operations and AI actions return unified format
-"""
-from rest_framework import status
-from igny8_core.api.tests.test_integration_base import IntegrationTestBase
-from igny8_core.modules.writer.models import Tasks, Content, Images
-
-
-class WriterIntegrationTestCase(IntegrationTestBase):
-    """Integration tests for Writer module"""
-    
-    def test_list_tasks_returns_unified_format(self):
-        """Test GET /api/v1/writer/tasks/ returns unified format"""
-        response = self.client.get('/api/v1/writer/tasks/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_create_task_returns_unified_format(self):
-        """Test POST /api/v1/writer/tasks/ returns unified format"""
-        data = {
-            'title': 'Test Task',
-            'site_id': self.site.id,
-            'sector_id': self.sector.id,
-            'status': 'pending'
-        }
-        response = self.client.post('/api/v1/writer/tasks/', data, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_201_CREATED)
-        self.assert_unified_response_format(response, expected_success=True)
-        self.assertIn('data', response.data)
-    
-    def test_list_content_returns_unified_format(self):
-        """Test GET /api/v1/writer/content/ returns unified format"""
-        response = self.client.get('/api/v1/writer/content/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_list_images_returns_unified_format(self):
-        """Test GET /api/v1/writer/images/ returns unified format"""
-        response = self.client.get('/api/v1/writer/images/')
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assert_paginated_response(response)
-    
-    def test_create_image_returns_unified_format(self):
-        """Test POST /api/v1/writer/images/ returns unified format"""
-        data = {
-            'image_type': 'featured',
-            'site_id': self.site.id,
-            'sector_id': self.sector.id,
-            'status': 'pending'
-        }
-        response = self.client.post('/api/v1/writer/images/', data, format='json')
-        
-        # May return 400 if site/sector validation fails, but should still be unified format
-        self.assertIn(response.status_code, [status.HTTP_201_CREATED, status.HTTP_400_BAD_REQUEST])
-        self.assert_unified_response_format(response)
-    
-    def test_task_validation_error_returns_unified_format(self):
-        """Test validation errors return unified format"""
-        response = self.client.post('/api/v1/writer/tasks/', {}, format='json')
-        
-        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
-        self.assert_unified_response_format(response, expected_success=False)
-        self.assertIn('error', response.data)
-        self.assertIn('errors', response.data)
-

backup-api-standard-v1/tests/test_permissions.py

@@ -1,313 +0,0 @@
-"""
-Unit tests for permission classes
-Tests IsAuthenticatedAndActive, HasTenantAccess, IsViewerOrAbove, IsEditorOrAbove, IsAdminOrOwner
-"""
-from django.test import TestCase
-from rest_framework.test import APIRequestFactory
-from rest_framework.views import APIView
-from igny8_core.api.permissions import (
-    IsAuthenticatedAndActive, HasTenantAccess, IsViewerOrAbove,
-    IsEditorOrAbove, IsAdminOrOwner
-)
-from igny8_core.auth.models import User, Account, Plan
-
-
-class PermissionsTestCase(TestCase):
-    """Test cases for permission classes"""
-    
-    def setUp(self):
-        """Set up test fixtures"""
-        self.factory = APIRequestFactory()
-        self.view = APIView()
-        
-        # Create test plan
-        self.plan = Plan.objects.create(
-            name="Test Plan",
-            slug="test-plan",
-            price=0,
-            credits_per_month=1000
-        )
-        
-        # Create owner user first (Account needs owner)
-        self.owner_user = User.objects.create_user(
-            username='owner',
-            email='owner@test.com',
-            password='testpass123',
-            role='owner'
-        )
-        
-        # Create test account with owner
-        self.account = Account.objects.create(
-            name="Test Account",
-            slug="test-account",
-            plan=self.plan,
-            owner=self.owner_user
-        )
-        
-        # Update owner user to have account
-        self.owner_user.account = self.account
-        self.owner_user.save()
-        
-        self.admin_user = User.objects.create_user(
-            username='admin',
-            email='admin@test.com',
-            password='testpass123',
-            role='admin',
-            account=self.account
-        )
-        
-        self.editor_user = User.objects.create_user(
-            username='editor',
-            email='editor@test.com',
-            password='testpass123',
-            role='editor',
-            account=self.account
-        )
-        
-        self.viewer_user = User.objects.create_user(
-            username='viewer',
-            email='viewer@test.com',
-            password='testpass123',
-            role='viewer',
-            account=self.account
-        )
-        
-        # Create another account for tenant isolation testing
-        self.other_owner = User.objects.create_user(
-            username='other_owner',
-            email='other_owner@test.com',
-            password='testpass123',
-            role='owner'
-        )
-        
-        self.other_account = Account.objects.create(
-            name="Other Account",
-            slug="other-account",
-            plan=self.plan,
-            owner=self.other_owner
-        )
-        
-        self.other_owner.account = self.other_account
-        self.other_owner.save()
-        
-        self.other_user = User.objects.create_user(
-            username='other',
-            email='other@test.com',
-            password='testpass123',
-            role='owner',
-            account=self.other_account
-        )
-    
-    def test_is_authenticated_and_active_authenticated(self):
-        """Test IsAuthenticatedAndActive allows authenticated users"""
-        permission = IsAuthenticatedAndActive()
-        request = self.factory.get('/test/')
-        request.user = self.owner_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_authenticated_and_active_unauthenticated(self):
-        """Test IsAuthenticatedAndActive denies unauthenticated users"""
-        permission = IsAuthenticatedAndActive()
-        request = self.factory.get('/test/')
-        request.user = None
-        
-        result = permission.has_permission(request, self.view)
-        self.assertFalse(result)
-    
-    def test_is_authenticated_and_active_inactive_user(self):
-        """Test IsAuthenticatedAndActive denies inactive users"""
-        permission = IsAuthenticatedAndActive()
-        self.owner_user.is_active = False
-        self.owner_user.save()
-        
-        request = self.factory.get('/test/')
-        request.user = self.owner_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertFalse(result)
-    
-    def test_has_tenant_access_same_account(self):
-        """Test HasTenantAccess allows users from same account"""
-        permission = HasTenantAccess()
-        request = self.factory.get('/test/')
-        request.user = self.owner_user
-        request.account = self.account
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_has_tenant_access_different_account(self):
-        """Test HasTenantAccess denies users from different account"""
-        permission = HasTenantAccess()
-        request = self.factory.get('/test/')
-        request.user = self.owner_user
-        request.account = self.other_account
-        
-        result = permission.has_permission(request, self.view)
-        self.assertFalse(result)
-    
-    def test_has_tenant_access_admin_bypass(self):
-        """Test HasTenantAccess allows admin/developer to bypass"""
-        permission = HasTenantAccess()
-        request = self.factory.get('/test/')
-        request.user = self.admin_user
-        request.account = self.other_account  # Different account
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)  # Admin should bypass
-    
-    def test_has_tenant_access_system_account(self):
-        """Test HasTenantAccess allows system account users to bypass"""
-        # Create system account owner
-        system_owner = User.objects.create_user(
-            username='system_owner_test',
-            email='system_owner_test@test.com',
-            password='testpass123',
-            role='owner'
-        )
-        
-        # Create system account
-        system_account = Account.objects.create(
-            name="AWS Admin",
-            slug="aws-admin",
-            plan=self.plan,
-            owner=system_owner
-        )
-        
-        system_owner.account = system_account
-        system_owner.save()
-        
-        system_user = User.objects.create_user(
-            username='system',
-            email='system@test.com',
-            password='testpass123',
-            role='viewer',
-            account=system_account
-        )
-        
-        permission = HasTenantAccess()
-        request = self.factory.get('/test/')
-        request.user = system_user
-        request.account = self.account  # Different account
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)  # System account user should bypass
-    
-    def test_is_viewer_or_above_viewer(self):
-        """Test IsViewerOrAbove allows viewer role"""
-        permission = IsViewerOrAbove()
-        request = self.factory.get('/test/')
-        request.user = self.viewer_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_viewer_or_above_editor(self):
-        """Test IsViewerOrAbove allows editor role"""
-        permission = IsViewerOrAbove()
-        request = self.factory.get('/test/')
-        request.user = self.editor_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_viewer_or_above_admin(self):
-        """Test IsViewerOrAbove allows admin role"""
-        permission = IsViewerOrAbove()
-        request = self.factory.get('/test/')
-        request.user = self.admin_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_viewer_or_above_owner(self):
-        """Test IsViewerOrAbove allows owner role"""
-        permission = IsViewerOrAbove()
-        request = self.factory.get('/test/')
-        request.user = self.owner_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_editor_or_above_viewer_denied(self):
-        """Test IsEditorOrAbove denies viewer role"""
-        permission = IsEditorOrAbove()
-        request = self.factory.get('/test/')
-        request.user = self.viewer_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertFalse(result)
-    
-    def test_is_editor_or_above_editor_allowed(self):
-        """Test IsEditorOrAbove allows editor role"""
-        permission = IsEditorOrAbove()
-        request = self.factory.get('/test/')
-        request.user = self.editor_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_editor_or_above_admin_allowed(self):
-        """Test IsEditorOrAbove allows admin role"""
-        permission = IsEditorOrAbove()
-        request = self.factory.get('/test/')
-        request.user = self.admin_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_admin_or_owner_viewer_denied(self):
-        """Test IsAdminOrOwner denies viewer role"""
-        permission = IsAdminOrOwner()
-        request = self.factory.get('/test/')
-        request.user = self.viewer_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertFalse(result)
-    
-    def test_is_admin_or_owner_editor_denied(self):
-        """Test IsAdminOrOwner denies editor role"""
-        permission = IsAdminOrOwner()
-        request = self.factory.get('/test/')
-        request.user = self.editor_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertFalse(result)
-    
-    def test_is_admin_or_owner_admin_allowed(self):
-        """Test IsAdminOrOwner allows admin role"""
-        permission = IsAdminOrOwner()
-        request = self.factory.get('/test/')
-        request.user = self.admin_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_is_admin_or_owner_owner_allowed(self):
-        """Test IsAdminOrOwner allows owner role"""
-        permission = IsAdminOrOwner()
-        request = self.factory.get('/test/')
-        request.user = self.owner_user
-        
-        result = permission.has_permission(request, self.view)
-        self.assertTrue(result)
-    
-    def test_all_permissions_unauthenticated_denied(self):
-        """Test all permissions deny unauthenticated users"""
-        permissions = [
-            IsAuthenticatedAndActive(),
-            HasTenantAccess(),
-            IsViewerOrAbove(),
-            IsEditorOrAbove(),
-            IsAdminOrOwner()
-        ]
-        
-        request = self.factory.get('/test/')
-        request.user = None
-        
-        for permission in permissions:
-            result = permission.has_permission(request, self.view)
-            self.assertFalse(result, f"{permission.__class__.__name__} should deny unauthenticated users")
-

backup-api-standard-v1/tests/test_response.py

@@ -1,206 +0,0 @@
-"""
-Unit tests for response helper functions
-Tests success_response, error_response, paginated_response
-"""
-from django.test import TestCase, RequestFactory
-from rest_framework import status
-from igny8_core.api.response import success_response, error_response, paginated_response, get_request_id
-
-
-class ResponseHelpersTestCase(TestCase):
-    """Test cases for response helper functions"""
-    
-    def setUp(self):
-        """Set up test fixtures"""
-        self.factory = RequestFactory()
-    
-    def test_success_response_with_data(self):
-        """Test success_response with data"""
-        data = {"id": 1, "name": "Test"}
-        response = success_response(data=data, message="Success")
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assertTrue(response.data['success'])
-        self.assertEqual(response.data['data'], data)
-        self.assertEqual(response.data['message'], "Success")
-    
-    def test_success_response_without_data(self):
-        """Test success_response without data"""
-        response = success_response(message="Success")
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assertTrue(response.data['success'])
-        self.assertNotIn('data', response.data)
-        self.assertEqual(response.data['message'], "Success")
-    
-    def test_success_response_with_custom_status(self):
-        """Test success_response with custom status code"""
-        data = {"id": 1}
-        response = success_response(data=data, status_code=status.HTTP_201_CREATED)
-        
-        self.assertEqual(response.status_code, status.HTTP_201_CREATED)
-        self.assertTrue(response.data['success'])
-        self.assertEqual(response.data['data'], data)
-    
-    def test_success_response_with_request_id(self):
-        """Test success_response includes request_id when request provided"""
-        request = self.factory.get('/test/')
-        request.request_id = 'test-request-id-123'
-        
-        response = success_response(data={"id": 1}, request=request)
-        
-        self.assertTrue(response.data['success'])
-        self.assertEqual(response.data['request_id'], 'test-request-id-123')
-    
-    def test_error_response_with_error_message(self):
-        """Test error_response with error message"""
-        response = error_response(error="Validation failed")
-        
-        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['error'], "Validation failed")
-    
-    def test_error_response_with_errors_dict(self):
-        """Test error_response with field-specific errors"""
-        errors = {"email": ["Invalid email format"], "password": ["Too short"]}
-        response = error_response(error="Validation failed", errors=errors)
-        
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['error'], "Validation failed")
-        self.assertEqual(response.data['errors'], errors)
-    
-    def test_error_response_status_code_mapping(self):
-        """Test error_response maps status codes to default error messages"""
-        # Test 401
-        response = error_response(status_code=status.HTTP_401_UNAUTHORIZED)
-        self.assertEqual(response.data['error'], 'Authentication required')
-        
-        # Test 403
-        response = error_response(status_code=status.HTTP_403_FORBIDDEN)
-        self.assertEqual(response.data['error'], 'Permission denied')
-        
-        # Test 404
-        response = error_response(status_code=status.HTTP_404_NOT_FOUND)
-        self.assertEqual(response.data['error'], 'Resource not found')
-        
-        # Test 409
-        response = error_response(status_code=status.HTTP_409_CONFLICT)
-        self.assertEqual(response.data['error'], 'Conflict')
-        
-        # Test 422
-        response = error_response(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY)
-        self.assertEqual(response.data['error'], 'Validation failed')
-        
-        # Test 429
-        response = error_response(status_code=status.HTTP_429_TOO_MANY_REQUESTS)
-        self.assertEqual(response.data['error'], 'Rate limit exceeded')
-        
-        # Test 500
-        response = error_response(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR)
-        self.assertEqual(response.data['error'], 'Internal server error')
-    
-    def test_error_response_with_request_id(self):
-        """Test error_response includes request_id when request provided"""
-        request = self.factory.get('/test/')
-        request.request_id = 'test-request-id-456'
-        
-        response = error_response(error="Error occurred", request=request)
-        
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['request_id'], 'test-request-id-456')
-    
-    def test_error_response_with_debug_info(self):
-        """Test error_response includes debug info when provided"""
-        debug_info = {"exception_type": "ValueError", "message": "Test error"}
-        response = error_response(error="Error", debug_info=debug_info)
-        
-        self.assertFalse(response.data['success'])
-        self.assertEqual(response.data['debug'], debug_info)
-    
-    def test_paginated_response_with_data(self):
-        """Test paginated_response with paginated data"""
-        paginated_data = {
-            'count': 100,
-            'next': 'http://test.com/api/v1/test/?page=2',
-            'previous': None,
-            'results': [{"id": 1}, {"id": 2}]
-        }
-        response = paginated_response(paginated_data, message="Success")
-        
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assertTrue(response.data['success'])
-        self.assertEqual(response.data['count'], 100)
-        self.assertEqual(response.data['next'], paginated_data['next'])
-        self.assertEqual(response.data['previous'], None)
-        self.assertEqual(response.data['results'], paginated_data['results'])
-        self.assertEqual(response.data['message'], "Success")
-    
-    def test_paginated_response_without_message(self):
-        """Test paginated_response without message"""
-        paginated_data = {
-            'count': 50,
-            'next': None,
-            'previous': None,
-            'results': []
-        }
-        response = paginated_response(paginated_data)
-        
-        self.assertTrue(response.data['success'])
-        self.assertEqual(response.data['count'], 50)
-        self.assertNotIn('message', response.data)
-    
-    def test_paginated_response_with_request_id(self):
-        """Test paginated_response includes request_id when request provided"""
-        request = self.factory.get('/test/')
-        request.request_id = 'test-request-id-789'
-        
-        paginated_data = {
-            'count': 10,
-            'next': None,
-            'previous': None,
-            'results': []
-        }
-        response = paginated_response(paginated_data, request=request)
-        
-        self.assertTrue(response.data['success'])
-        self.assertEqual(response.data['request_id'], 'test-request-id-789')
-    
-    def test_paginated_response_fallback(self):
-        """Test paginated_response handles non-dict input"""
-        response = paginated_response(None)
-        
-        self.assertTrue(response.data['success'])
-        self.assertEqual(response.data['count'], 0)
-        self.assertIsNone(response.data['next'])
-        self.assertIsNone(response.data['previous'])
-        self.assertEqual(response.data['results'], [])
-    
-    def test_get_request_id_from_request_object(self):
-        """Test get_request_id retrieves from request.request_id"""
-        request = self.factory.get('/test/')
-        request.request_id = 'request-id-from-object'
-        
-        request_id = get_request_id(request)
-        self.assertEqual(request_id, 'request-id-from-object')
-    
-    def test_get_request_id_from_headers(self):
-        """Test get_request_id retrieves from headers"""
-        request = self.factory.get('/test/', HTTP_X_REQUEST_ID='request-id-from-header')
-        
-        request_id = get_request_id(request)
-        self.assertEqual(request_id, 'request-id-from-header')
-    
-    def test_get_request_id_generates_new(self):
-        """Test get_request_id generates new UUID if not found"""
-        request = self.factory.get('/test/')
-        
-        request_id = get_request_id(request)
-        self.assertIsNotNone(request_id)
-        self.assertIsInstance(request_id, str)
-        # UUID format check
-        import uuid
-        try:
-            uuid.UUID(request_id)
-        except ValueError:
-            self.fail("Generated request_id is not a valid UUID")
-

backup-api-standard-v1/tests/test_throttles.py

@@ -1,199 +0,0 @@
-"""
-Unit tests for rate limiting
-Tests DebugScopedRateThrottle with bypass logic
-"""
-from django.test import TestCase, override_settings
-from rest_framework.test import APIRequestFactory
-from rest_framework.views import APIView
-from igny8_core.api.throttles import DebugScopedRateThrottle
-from igny8_core.auth.models import User, Account, Plan
-
-
-class ThrottlesTestCase(TestCase):
-    """Test cases for rate limiting"""
-    
-    def setUp(self):
-        """Set up test fixtures"""
-        self.factory = APIRequestFactory()
-        self.view = APIView()
-        self.view.throttle_scope = 'planner'
-        
-        # Create test plan and account
-        self.plan = Plan.objects.create(
-            name="Test Plan",
-            slug="test-plan",
-            price=0,
-            credits_per_month=1000
-        )
-        
-        # Create owner user first
-        self.owner_user = User.objects.create_user(
-            username='owner',
-            email='owner@test.com',
-            password='testpass123',
-            role='owner'
-        )
-        
-        # Create test account with owner
-        self.account = Account.objects.create(
-            name="Test Account",
-            slug="test-account",
-            plan=self.plan,
-            owner=self.owner_user
-        )
-        
-        # Update owner user to have account
-        self.owner_user.account = self.account
-        self.owner_user.save()
-        
-        # Create regular user
-        self.user = User.objects.create_user(
-            username='user',
-            email='user@test.com',
-            password='testpass123',
-            role='viewer',
-            account=self.account
-        )
-        
-        # Create admin user
-        self.admin_user = User.objects.create_user(
-            username='admin',
-            email='admin@test.com',
-            password='testpass123',
-            role='admin',
-            account=self.account
-        )
-        
-        # Create system account owner
-        self.system_owner = User.objects.create_user(
-            username='system_owner',
-            email='system_owner@test.com',
-            password='testpass123',
-            role='owner'
-        )
-        
-        # Create system account user
-        self.system_account = Account.objects.create(
-            name="AWS Admin",
-            slug="aws-admin",
-            plan=self.plan,
-            owner=self.system_owner
-        )
-        
-        self.system_owner.account = self.system_account
-        self.system_owner.save()
-        
-        self.system_user = User.objects.create_user(
-            username='system',
-            email='system@test.com',
-            password='testpass123',
-            role='viewer',
-            account=self.system_account
-        )
-    
-    @override_settings(DEBUG=True)
-    def test_debug_mode_bypass(self):
-        """Test throttling is bypassed in DEBUG mode"""
-        throttle = DebugScopedRateThrottle()
-        request = self.factory.get('/test/')
-        request.user = self.user
-        
-        result = throttle.allow_request(request, self.view)
-        self.assertTrue(result)  # Should bypass in DEBUG mode
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=True)
-    def test_env_bypass(self):
-        """Test throttling is bypassed when IGNY8_DEBUG_THROTTLE=True"""
-        throttle = DebugScopedRateThrottle()
-        request = self.factory.get('/test/')
-        request.user = self.user
-        
-        result = throttle.allow_request(request, self.view)
-        self.assertTrue(result)  # Should bypass when IGNY8_DEBUG_THROTTLE=True
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=False)
-    def test_system_account_bypass(self):
-        """Test throttling is bypassed for system account users"""
-        throttle = DebugScopedRateThrottle()
-        request = self.factory.get('/test/')
-        request.user = self.system_user
-        
-        result = throttle.allow_request(request, self.view)
-        self.assertTrue(result)  # System account users should bypass
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=False)
-    def test_admin_bypass(self):
-        """Test throttling is bypassed for admin/developer users"""
-        throttle = DebugScopedRateThrottle()
-        request = self.factory.get('/test/')
-        request.user = self.admin_user
-        
-        result = throttle.allow_request(request, self.view)
-        self.assertTrue(result)  # Admin users should bypass
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=False)
-    def test_get_rate(self):
-        """Test get_rate returns correct rate for scope"""
-        throttle = DebugScopedRateThrottle()
-        throttle.scope = 'planner'
-        
-        rate = throttle.get_rate()
-        self.assertIsNotNone(rate)
-        self.assertIn('/', rate)  # Should be in format "60/min"
-    
-    @override_settings(DEBUG=False, IGNY8_DEBUG_THROTTLE=False)
-    def test_get_rate_default_fallback(self):
-        """Test get_rate falls back to default if scope not found"""
-        throttle = DebugScopedRateThrottle()
-        throttle.scope = 'nonexistent_scope'
-        
-        rate = throttle.get_rate()
-        self.assertIsNotNone(rate)
-        self.assertEqual(rate, '100/min')  # Should fallback to default
-    
-    def test_parse_rate_minutes(self):
-        """Test parse_rate correctly parses minutes"""
-        throttle = DebugScopedRateThrottle()
-        
-        num, duration = throttle.parse_rate('60/min')
-        self.assertEqual(num, 60)
-        self.assertEqual(duration, 60)
-    
-    def test_parse_rate_seconds(self):
-        """Test parse_rate correctly parses seconds"""
-        throttle = DebugScopedRateThrottle()
-        
-        num, duration = throttle.parse_rate('10/sec')
-        self.assertEqual(num, 10)
-        self.assertEqual(duration, 1)
-    
-    def test_parse_rate_hours(self):
-        """Test parse_rate correctly parses hours"""
-        throttle = DebugScopedRateThrottle()
-        
-        num, duration = throttle.parse_rate('100/hour')
-        self.assertEqual(num, 100)
-        self.assertEqual(duration, 3600)
-    
-    def test_parse_rate_invalid_format(self):
-        """Test parse_rate handles invalid format gracefully"""
-        throttle = DebugScopedRateThrottle()
-        
-        num, duration = throttle.parse_rate('invalid')
-        self.assertEqual(num, 100)  # Should default to 100
-        self.assertEqual(duration, 60)  # Should default to 60 seconds (1 min)
-    
-    @override_settings(DEBUG=True)
-    def test_debug_info_set(self):
-        """Test debug info is set when bypassing in DEBUG mode"""
-        throttle = DebugScopedRateThrottle()
-        request = self.factory.get('/test/')
-        request.user = self.user
-        
-        result = throttle.allow_request(request, self.view)
-        self.assertTrue(result)
-        self.assertTrue(hasattr(request, '_throttle_debug_info'))
-        self.assertIn('scope', request._throttle_debug_info)
-        self.assertIn('rate', request._throttle_debug_info)
-        self.assertIn('limit', request._throttle_debug_info)
-

cmd/check-vite-status.sh

@@ -1,44 +0,0 @@
-#!/bin/bash
-# Quick Vite dev server status check
-
-echo "╔════════════════════════════════════════════════════════════╗"
-echo "║           Vite Dev Server Status Check (Port 8021)        ║"
-echo "╚════════════════════════════════════════════════════════════╝"
-echo ""
-
-# Check Docker container
-echo "📦 Docker Container Status:"
-if docker ps --filter "name=igny8_frontend" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -q igny8_frontend; then
-    docker ps --filter "name=igny8_frontend" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
-else
-    echo "   ❌ Container 'igny8_frontend' not found or not running"
-fi
-echo ""
-
-# Check port
-echo "🔌 Port 8021 Status:"
-if netstat -tuln 2>/dev/null | grep -q ":8021" || ss -tuln 2>/dev/null | grep -q ":8021"; then
-    echo "   ✅ Port 8021 is listening"
-    netstat -tuln 2>/dev/null | grep ":8021" || ss -tuln 2>/dev/null | grep ":8021"
-else
-    echo "   ❌ Port 8021 is not listening"
-fi
-echo ""
-
-# Test HTTP response
-echo "🌐 HTTP Response Test:"
-HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8021/ 2>/dev/null)
-if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "304" ]; then
-    echo "   ✅ Server responding (HTTP $HTTP_CODE)"
-else
-    echo "   ❌ Server not responding (HTTP $HTTP_CODE or connection failed)"
-fi
-echo ""
-
-# Check recent logs
-echo "📋 Recent Container Logs (last 10 lines):"
-docker logs igny8_frontend --tail 10 2>/dev/null || echo "   ⚠️  Could not fetch logs"
-echo ""
-
-echo "════════════════════════════════════════════════════════════"
-

cmd/logs.sh

@@ -1,14 +0,0 @@
-#!/bin/bash
-# Quick log check - last 50 lines
-
-echo "=== Backend Logs ==="
-docker logs igny8_backend --tail 50
-
-echo ""
-echo "=== Celery Worker Logs ==="
-docker logs igny8_celery_worker --tail 50
-
-echo ""
-echo "=== Celery Beat Logs ==="
-docker logs igny8_celery_beat --tail 50
-

cmd/restart-backend.sh

@@ -1,22 +0,0 @@
-#!/bin/bash
-# Restart backend containers to pick up code changes
-
-echo "🛑 Stopping backend containers..."
-docker stop igny8_backend igny8_celery_worker igny8_celery_beat
-
-echo "⏳ Waiting 3 seconds..."
-sleep 3
-
-echo "🚀 Starting backend containers..."
-docker start igny8_backend igny8_celery_worker igny8_celery_beat
-
-echo "⏳ Waiting 5 seconds for containers to initialize..."
-sleep 5
-
-echo "📋 Checking container status..."
-docker ps --filter "name=igny8" --format "   {{.Names}} | {{.Status}}"
-
-echo ""
-echo "📝 Checking backend logs for errors..."
-docker logs igny8_backend --tail 20
-

cmd/st.sh

@@ -1,45 +0,0 @@
-#!/bin/bash
-# Quick status check script for IGNY8 stacks and containers
-
-echo "╔════════════════════════════════════════════════════════════════════════════╗"
-echo "║                  IGNY8 STACK & CONTAINER STATUS REPORT                     ║"
-echo "╚════════════════════════════════════════════════════════════════════════════╝"
-echo ""
-
-echo "📦 APP STACK (igny8-app):"
-docker ps --filter "label=com.docker.compose.project=igny8-app" --format "   ✅ {{.Names}} | Status: {{.Status}} | Ports: {{.Ports}}"
-if [ $? -ne 0 ] || [ -z "$(docker ps --filter 'label=com.docker.compose.project=igny8-app' --format '{{.Names}}')" ]; then
-    echo "   ⚠️  No app stack containers found"
-fi
-
-echo ""
-echo "🏗️  INFRA STACK (igny8-infra):"
-docker ps --filter "label=com.docker.compose.project=igny8-infra" --format "   ✅ {{.Names}} | Status: {{.Status}}"
-if [ $? -ne 0 ] || [ -z "$(docker ps --filter 'label=com.docker.compose.project=igny8-infra' --format '{{.Names}}')" ]; then
-    echo "   ⚠️  No infra stack containers found"
-fi
-
-echo ""
-echo "🌐 NETWORK CONNECTIVITY (igny8_net):"
-CONTAINER_COUNT=$(docker network inspect igny8_net --format '{{len .Containers}}' 2>/dev/null || echo "0")
-echo "   Connected: $CONTAINER_COUNT containers"
-
-echo ""
-echo "🔍 SERVICE HEALTH CHECKS:"
-BACKEND_CODE=$(curl -s -o /dev/null -w '%{http_code}' http://localhost:8011/api/v1/plans/ 2>/dev/null || echo "000")
-FRONTEND_CODE=$(curl -s -o /dev/null -w '%{http_code}' http://localhost:8021/ 2>/dev/null || echo "000")
-POSTGRES_HEALTH=$(docker exec igny8_postgres pg_isready -U igny8 2>&1 | grep -q 'accepting' && echo "healthy" || echo "unhealthy")
-REDIS_HEALTH=$(docker exec igny8_redis redis-cli ping 2>&1 | grep -q PONG && echo "healthy" || echo "unhealthy")
-
-echo "   Backend API:   $BACKEND_CODE $([ "$BACKEND_CODE" = "200" ] && echo "✅" || echo "❌")"
-echo "   Frontend:      $FRONTEND_CODE $([ "$FRONTEND_CODE" = "200" ] && echo "✅" || echo "❌")"
-echo "   Postgres:      $POSTGRES_HEALTH $([ "$POSTGRES_HEALTH" = "healthy" ] && echo "✅" || echo "❌")"
-echo "   Redis:         $REDIS_HEALTH $([ "$REDIS_HEALTH" = "healthy" ] && echo "✅" || echo "❌")"
-
-echo ""
-echo "📋 ALL IGNY8 CONTAINERS:"
-docker ps --filter "name=igny8" --format "   {{.Names}} | {{.Image}} | {{.Status}}"
-
-echo ""
-echo "════════════════════════════════════════════════════════════════════════════"
-

docs/00-DOCUMENTATION-MANAGEMENT.md

@@ -146,7 +146,21 @@ docs/
 ├── 03-FRONTEND-ARCHITECTURE.md
 ├── 04-BACKEND-IMPLEMENTATION.md
 ├── 05-AI-FRAMEWORK-IMPLEMENTATION.md
-└── 06-FUNCTIONAL-BUSINESS-LOGIC.md
+├── 06-FUNCTIONAL-BUSINESS-LOGIC.md
+├── API-COMPLETE-REFERENCE.md
+├── WORDPRESS-PLUGIN-INTEGRATION.md
+├── planning/                       # Architecture & implementation planning
+│   ├── IGNY8-HOLISTIC-ARCHITECTURE-PLAN.md
+│   ├── IGNY8-IMPLEMENTATION-PLAN.md
+│   ├── Igny8-phase-2-plan.md
+│   ├── CONTENT-WORKFLOW-DIAGRAM.md
+│   ├── ARCHITECTURE_CONTEXT.md
+│   └── sample-usage-limits-credit-system
+└── refactor/                        # Refactoring plans and documentation
+    ├── README.md
+    ├── routes/
+    ├── folder-structure/
+    └── migrations/
 ```
 
 ### Documentation Update Checklist

docs/planning/ARCHITECTURE_CONTEXT.md

@@ -0,0 +1,924 @@
+# IGNY8 Complete Architecture Context
+**Created:** 2025-01-XX  
+**Purpose:** Comprehensive context document for understanding the complete IGNY8 system architecture, workflows, and implementation details.
+
+---
+
+## Executive Summary
+
+IGNY8 is a full-stack SaaS platform for SEO keyword management and AI-driven content generation. The system operates on a multi-tenant architecture with complete account isolation, hierarchical organization (Account > Site > Sector > Content), and unified AI processing framework.
+
+**Key Characteristics:**
+- Multi-tenant SaaS with account isolation
+- Django 5.2+ backend with DRF API
+- React 19 frontend with TypeScript
+- PostgreSQL 15 database
+- Celery + Redis for async tasks
+- Docker-based containerization
+- Caddy reverse proxy for HTTPS
+
+---
+
+## System Architecture Overview
+
+### High-Level Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Client Layer (Browser)                    │
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐     │
+│  │   Main App   │  │  Marketing   │  │   Admin     │     │
+│  │ (app.igny8)  │  │  (igny8.com) │  │   Panel     │     │
+│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘     │
+└─────────┼──────────────────┼──────────────────┼─────────────┘
+          │                  │                  │
+          └──────────────────┼──────────────────┘
+                             │
+┌────────────────────────────┼──────────────────────────────┐
+│                    Reverse Proxy Layer                     │
+│                    ┌───────────────┐                       │
+│                    │     Caddy     │                       │
+│                    │  (HTTPS/443)  │                       │
+│                    └───────┬───────┘                       │
+└────────────────────────────┼──────────────────────────────┘
+                             │
+┌────────────────────────────┼──────────────────────────────┐
+│                    Application Layer                       │
+│  ┌──────────────┐              ┌──────────────┐          │
+│  │   Frontend   │              │    Backend   │          │
+│  │   (React)    │◄─────────────┤   (Django)   │          │
+│  │   Port 8021  │   REST API   │   Port 8011  │          │
+│  └──────────────┘              └──────┬───────┘          │
+│                                       │                   │
+│                              ┌────────┴────────┐         │
+│                              │  Celery Worker  │         │
+│                              │  (Async Tasks)  │         │
+│                              └────────┬────────┘         │
+└───────────────────────────────────────┼──────────────────┘
+                                        │
+┌───────────────────────────────────────┼──────────────────┐
+│                    Data Layer                              │
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
+│  │  PostgreSQL  │  │    Redis     │  │   Storage    │  │
+│  │   (Database) │  │ (Cache/Broker)│  │   (Files)   │  │
+│  └──────────────┘  └──────────────┘  └──────────────┘  │
+└──────────────────────────────────────────────────────────┘
+                                        │
+┌───────────────────────────────────────┼──────────────────┐
+│                  External Services                         │
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
+│  │   OpenAI     │  │   Runware    │  │  WordPress  │  │
+│  │   (GPT/DALL-E)│  │  (Images)   │  │   (Publish) │  │
+│  └──────────────┘  └──────────────┘  └──────────────┘  │
+└──────────────────────────────────────────────────────────┘
+```
+
+### Current Infrastructure Status
+
+**Running Containers:**
+- `igny8_backend` - Django API (Port 8011, healthy)
+- `igny8_frontend` - React app (Port 8021)
+- `igny8_marketing_dev` - Marketing site (Port 8023)
+- `igny8_celery_worker` - Async task processor
+- `igny8_celery_beat` - Scheduled tasks
+- `igny8_postgres` - Database (healthy)
+- `igny8_redis` - Cache/Broker (healthy)
+- `igny8_caddy` - Reverse proxy (Ports 80, 443)
+- `igny8_pgadmin` - DB admin (Port 5050)
+- `igny8_filebrowser` - File manager (Port 8080)
+- `portainer` - Container management (Ports 8000, 9443)
+
+**Network:** `igny8_net` (bridge network, external)
+
+---
+
+## Technology Stack
+
+### Backend Stack
+- **Framework:** Django 5.2.7+
+- **API:** Django REST Framework
+- **Database:** PostgreSQL 15
+- **Task Queue:** Celery 5.3.0+ with Redis 7
+- **Auth:** JWT (PyJWT 2.8.0+)
+- **Server:** Gunicorn
+- **Static Files:** WhiteNoise
+
+### Frontend Stack
+- **Framework:** React 19.0.0
+- **Language:** TypeScript 5.7.2
+- **Build Tool:** Vite 6.1.0
+- **Styling:** Tailwind CSS 4.0.8
+- **State:** Zustand 5.0.8
+- **Routing:** React Router v7.9.5
+- **Icons:** @heroicons/react 2.2.0
+
+### Infrastructure
+- **Containerization:** Docker + Docker Compose
+- **Reverse Proxy:** Caddy (HTTPS termination)
+- **Container Management:** Portainer
+
+---
+
+## Core Architecture Principles
+
+### 1. Multi-Tenancy Foundation
+- **Account Isolation:** All models inherit `AccountBaseModel` with `account` ForeignKey
+- **Automatic Filtering:** All ViewSets inherit `AccountModelViewSet` with automatic filtering
+- **Middleware:** `AccountContextMiddleware` sets `request.account` from JWT token
+- **Hierarchy:** Account > Site > Sector > Content
+
+### 2. Configuration-Driven Everything
+- **Frontend:** Config files in `/config/pages/` and `/config/snippets/`
+- **Backend:** DRF serializers and ViewSet actions
+- **Templates:** 4 universal templates (Dashboard, Table, Form, System)
+
+### 3. Unified AI Framework
+- **Single Interface:** All AI operations use `AIEngine` orchestrator
+- **Base Class:** All AI functions inherit from `BaseAIFunction`
+- **Execution Pipeline:** 6 phases (INIT, PREP, AI_CALL, PARSE, SAVE, DONE)
+- **Progress Tracking:** Real-time updates via Celery
+
+### 4. Module-Based Organization
+- **Planner:** Keywords, Clusters, Ideas
+- **Writer:** Tasks, Content, Images
+- **Thinker:** Prompts, Author Profiles, Strategies
+- **System:** Settings, Integrations, AI Configuration
+- **Billing:** Credits, Transactions, Usage
+- **Auth:** Accounts, Users, Sites, Sectors
+
+---
+
+## System Hierarchy
+
+### Entity Relationships
+
+```
+Account (1) ──< (N) User
+Account (1) ──< (1) Subscription ──> (1) Plan
+Account (1) ──< (N) Site
+Site (1) ──< (1-5) Sector
+Sector (1) ──< (N) Keywords, Clusters, ContentIdeas, Tasks
+Cluster (1) ──< (N) Keywords (Many-to-Many)
+Cluster (1) ──< (N) ContentIdeas
+ContentIdeas (1) ──< (N) Tasks
+Task (1) ──> (1) Content
+Task (1) ──< (N) Images
+```
+
+### Hierarchy Details
+
+**Account Level:**
+- Top-level organization/workspace
+- Contains users, sites, subscriptions, and all data
+- Has credit balance and plan assignment
+- Status: active, suspended, trial, cancelled
+
+**User Level:**
+- Individual user accounts within an account
+- Has role (developer, owner, admin, editor, viewer)
+- Can belong to only one account
+- Access controlled by role and site permissions
+
+**Site Level:**
+- Workspace within an account (1-N relationship)
+- Can have multiple active sites simultaneously
+- Has WordPress integration settings (URL, username, password)
+- Can be associated with an industry
+- Status: active, inactive, suspended
+
+**Sector Level:**
+- Content category within a site (1-5 per site)
+- Organizes keywords, clusters, ideas, and tasks
+- Can reference an industry sector template
+- Status: active, inactive
+
+**Content Level:**
+- Keywords, Clusters, ContentIdeas belong to Sector
+- Tasks, Content, Images belong to Sector
+- All content is automatically associated with Account and Site
+
+---
+
+## User Roles & Access Control
+
+### Role Hierarchy
+```
+developer > owner > admin > editor > viewer > system_bot
+```
+
+### Role Permissions
+
+| Role | Account Access | Site Access | Data Access | User Management | Billing |
+|------|----------------|-------------|-------------|-----------------|---------|
+| Developer | All accounts | All sites | All data | Yes | Yes |
+| System Bot | All accounts | All sites | All data | No | No |
+| Owner | Own account | All sites in account | All data in account | Yes | Yes |
+| Admin | Own account | All sites in account | All data in account | Yes | No |
+| Editor | Own account | Granted sites only | Data in granted sites | No | No |
+| Viewer | Own account | Granted sites only | Read-only in granted sites | No | No |
+
+### Access Control Implementation
+
+**Automatic Access:**
+- Owners and Admins: Automatic access to all sites in their account
+- Developers and System Bot: Access to all sites across all accounts
+
+**Explicit Access:**
+- Editors and Viewers: Require explicit `SiteUserAccess` records
+- Access granted by Owner or Admin
+- Access can be revoked at any time
+
+---
+
+## Complete Workflows
+
+### 1. Account Setup Workflow
+
+**Steps:**
+1. User signs up via `/signup`
+2. Account created with default plan
+3. Owner user created and linked to account
+4. User signs in via `/signin`
+5. JWT token generated and returned
+6. Frontend stores token and redirects to dashboard
+7. User creates first site (optional)
+8. User creates sectors (1-5 per site, optional)
+9. User configures integration settings (OpenAI, Runware)
+10. System ready for use
+
+**Data Created:**
+- 1 Account record
+- 1 User record (owner role)
+- 1 Subscription record (default plan)
+- 0-N Site records
+- 0-N Sector records (per site)
+- 1 IntegrationSettings record (per integration type)
+
+### 2. Keyword Management Workflow
+
+**Steps:**
+1. User navigates to `/planner/keywords`
+2. User imports keywords via CSV or manual entry
+3. Keywords validated and stored in database
+4. Keywords displayed in table with filters
+5. User filters keywords by sector, status, intent, etc.
+6. User selects keywords for clustering
+7. User clicks "Auto Cluster" action
+8. Backend validates keyword IDs
+9. Celery task queued (`run_ai_task` with function `auto_cluster`)
+10. Task ID returned to frontend
+11. Frontend polls progress endpoint
+12. Celery worker processes task:
+    - Loads keywords from database
+    - Builds AI prompt with keyword data
+    - Calls OpenAI API for clustering
+    - Parses cluster response
+    - Creates Cluster records
+    - Links keywords to clusters
+13. Progress updates sent to frontend
+14. Task completes
+15. Frontend displays new clusters
+16. Credits deducted from account
+
+**AI Function:** Auto Cluster Keywords
+
+### 3. Content Generation Workflow
+
+**Steps:**
+1. User navigates to `/planner/ideas`
+2. User selects content ideas
+3. User clicks "Create Tasks" action
+4. Task records created for each idea
+5. User navigates to `/writer/tasks`
+6. User selects tasks for content generation
+7. User clicks "Generate Content" action
+8. Backend validates task IDs
+9. Celery task queued (`run_ai_task` with function `generate_content`)
+10. Task ID returned to frontend
+11. Frontend polls progress endpoint
+12. Celery worker processes task:
+    - Loads tasks and related data (cluster, keywords, idea)
+    - Builds AI prompt with task data
+    - Calls OpenAI API for content generation
+    - Parses HTML content response
+    - Creates/updates Content records
+    - Updates task status
+13. Progress updates sent to frontend
+14. Task completes
+15. Frontend displays generated content
+16. Credits deducted from account
+
+**AI Function:** Generate Content
+
+### 4. WordPress Publishing Workflow
+
+**Steps:**
+1. User navigates to `/writer/content`
+2. User selects content to publish
+3. User clicks "Publish to WordPress" action
+4. Backend validates:
+    - Site has WordPress URL configured
+    - Site has WordPress credentials
+    - Content is ready (status: review or draft)
+5. Backend calls WordPress REST API:
+    - Creates post with content HTML
+    - Uploads featured image (if available)
+    - Uploads in-article images (if available)
+    - Sets post status (draft, publish)
+6. WordPress post ID stored in Content record
+7. Content status updated to "published"
+8. Frontend displays success message
+
+**Integration:** WordPress REST API
+
+---
+
+## AI Framework Architecture
+
+### Unified Execution Pipeline
+
+**Entry Point:** `run_ai_task` (Celery task)
+- Location: `backend/igny8_core/ai/tasks.py`
+- Parameters: `function_name`, `payload`, `account_id`
+- Flow: Loads function from registry → Creates AIEngine → Executes function
+
+**Engine Orchestrator:** `AIEngine`
+- Location: `backend/igny8_core/ai/engine.py`
+- Purpose: Central orchestrator managing lifecycle, progress, logging, cost tracking
+- Methods:
+  - `execute` - Main execution pipeline (6 phases)
+  - `_handle_error` - Centralized error handling
+  - `_log_to_database` - Logs to AITaskLog model
+
+**Base Function Class:** `BaseAIFunction`
+- Location: `backend/igny8_core/ai/base.py`
+- Purpose: Abstract base class defining interface for all AI functions
+- Abstract Methods:
+  - `get_name()` - Returns function name
+  - `prepare()` - Loads and prepares data
+  - `build_prompt()` - Builds AI prompt
+  - `parse_response()` - Parses AI response
+  - `save_output()` - Saves results to database
+
+### AI Function Execution Flow
+
+```
+1. API Endpoint (views.py)
+   ↓
+2. run_ai_task (tasks.py)
+   - Gets account from account_id
+   - Gets function instance from registry
+   - Creates AIEngine
+   ↓
+3. AIEngine.execute (engine.py)
+   Phase 1: INIT (0-10%)
+   - Calls function.validate()
+   - Updates progress tracker
+   ↓
+   Phase 2: PREP (10-25%)
+   - Calls function.prepare()
+   - Calls function.build_prompt()
+   - Updates progress tracker
+   ↓
+   Phase 3: AI_CALL (25-70%)
+   - Gets model config from settings
+   - Calls AICore.run_ai_request() or AICore.generate_image()
+   - Tracks cost and tokens
+   - Updates progress tracker
+   ↓
+   Phase 4: PARSE (70-85%)
+   - Calls function.parse_response()
+   - Updates progress tracker
+   ↓
+   Phase 5: SAVE (85-98%)
+   - Calls function.save_output()
+   - Logs credit usage
+   - Updates progress tracker
+   ↓
+   Phase 6: DONE (98-100%)
+   - Logs to AITaskLog
+   - Returns result
+```
+
+### AI Functions
+
+1. **Auto Cluster Keywords** (`auto_cluster`)
+   - Purpose: Group related keywords into semantic clusters
+   - Input: Keyword IDs (max 20)
+   - Output: Cluster records created, keywords linked
+   - Credits: 1 credit per 30 keywords
+
+2. **Generate Ideas** (`generate_ideas`)
+   - Purpose: Generate content ideas from keyword clusters
+   - Input: Cluster IDs (max 1 per batch)
+   - Output: ContentIdeas records created
+   - Credits: 1 credit per idea
+
+3. **Generate Content** (`generate_content`)
+   - Purpose: Generate blog post and article content
+   - Input: Task IDs (max 50 per batch)
+   - Output: Content records created/updated with HTML
+   - Credits: 3 credits per content piece
+
+4. **Generate Image Prompts** (`generate_image_prompts`)
+   - Purpose: Extract image prompts from content HTML
+   - Input: Content IDs
+   - Output: Images records updated with prompts
+   - Credits: Included in content generation
+
+5. **Generate Images** (`generate_images`)
+   - Purpose: Generate images using OpenAI DALL-E or Runware
+   - Input: Image IDs (with prompts)
+   - Output: Images records updated with image URLs
+   - Credits: 1 credit per image
+
+---
+
+## Frontend Architecture
+
+### Application Structure
+
+**Dual Application Architecture:**
+1. **Main Application** (`app.igny8.com`): Authenticated SaaS platform
+2. **Marketing Site** (`igny8.com`): Public-facing marketing website
+
+**Entry Points:**
+- Main App: `src/main.tsx` → `src/App.tsx`
+- Marketing: `src/marketing/index.tsx` → `src/marketing/MarketingApp.tsx`
+
+### State Management
+
+**Zustand Stores:**
+- `authStore` - Authentication & user
+- `siteStore` - Active site management
+- `sectorStore` - Active sector management
+- `plannerStore` - Planner module state
+- `billingStore` - Billing & credits
+- `settingsStore` - Application settings
+- `pageSizeStore` - Table pagination
+- `columnVisibilityStore` - Table column visibility
+
+**React Contexts:**
+- `ThemeContext` - Light/dark theme
+- `SidebarContext` - Sidebar state
+- `HeaderMetricsContext` - Header metrics
+- `ToastProvider` - Toast notifications
+
+### Template System
+
+**4 Universal Templates:**
+1. **DashboardTemplate** - Module home pages (KPIs, workflow steps, charts)
+2. **TablePageTemplate** - CRUD table pages (filtering, sorting, pagination)
+3. **FormPageTemplate** - Settings/form pages (sectioned forms)
+4. **SystemPageTemplate** - System/admin pages (status cards, logs)
+
+### API Integration
+
+**API Service Layer:**
+- Location: `frontend/src/services/api.ts`
+- Function: `fetchAPI()` - Centralized API client
+- Features:
+  - Automatic token injection
+  - Token refresh on 401
+  - Site/sector context injection
+  - Unified error handling
+  - Timeout handling
+
+**Request Flow:**
+1. User action in frontend
+2. Frontend makes API request via `fetchAPI()`
+3. JWT token included in Authorization header
+4. Backend middleware extracts account from JWT
+5. Backend ViewSet processes request
+6. Backend returns JSON response (unified format)
+7. Frontend updates state
+8. Frontend updates UI
+
+---
+
+## Backend Architecture
+
+### Multi-Tenancy Implementation
+
+**Account Isolation:**
+- **Model Level:** All models inherit `AccountBaseModel` with `account` ForeignKey
+- **ViewSet Level:** All ViewSets inherit `AccountModelViewSet` with automatic filtering
+- **Middleware Level:** `AccountContextMiddleware` sets `request.account` from JWT
+
+**Middleware Flow:**
+```
+Request with JWT Token
+   ↓
+AccountContextMiddleware
+   ├── Extract Account ID from JWT
+   ├── Load Account Object
+   └── Set request.account
+   ↓
+ViewSet.get_queryset()
+   ├── Check User Role
+   ├── Filter by Account (if not admin/developer)
+   └── Filter by Accessible Sites (if not owner/admin)
+   ↓
+Database Query
+   ↓
+Results (Account-Isolated)
+```
+
+### Base Classes
+
+**AccountModelViewSet:**
+- Location: `backend/igny8_core/api/base.py`
+- Purpose: Base ViewSet with automatic account filtering
+- Features:
+  - Automatic account filtering
+  - Admin/Developer override
+  - Account context in serializers
+
+**SiteSectorModelViewSet:**
+- Location: `backend/igny8_core/api/base.py`
+- Purpose: Base ViewSet with site/sector filtering
+- Features:
+  - Account filtering (inherited)
+  - Site access control
+  - Sector validation
+  - Accessible sites/sectors in serializer context
+
+### API Response Format
+
+**Unified Format:**
+```json
+{
+  "success": true,
+  "data": {...},
+  "message": "Optional message",
+  "request_id": "uuid"
+}
+```
+
+**Error Format:**
+```json
+{
+  "success": false,
+  "error": "Error message",
+  "errors": {
+    "field_name": ["Field-specific errors"]
+  },
+  "request_id": "uuid"
+}
+```
+
+**Paginated Format:**
+```json
+{
+  "success": true,
+  "count": 120,
+  "next": "url",
+  "previous": "url",
+  "results": [...],
+  "request_id": "uuid"
+}
+```
+
+---
+
+## Module Organization
+
+### Planner Module
+- **Purpose:** Keyword management & content planning
+- **Models:** Keywords, Clusters, ContentIdeas
+- **ViewSets:** KeywordViewSet, ClusterViewSet, ContentIdeasViewSet
+- **Celery Tasks:** `auto_cluster_keywords_task`, `auto_generate_ideas_task`
+- **Features:**
+  - Keyword import (CSV/manual)
+  - Keyword filtering and organization
+  - AI-powered keyword clustering
+  - Content idea generation from clusters
+  - Keyword-to-cluster mapping
+
+### Writer Module
+- **Purpose:** Content generation & management
+- **Models:** Tasks, Content, Images
+- **ViewSets:** TasksViewSet, ImagesViewSet
+- **Celery Tasks:** `auto_generate_content_task`, `auto_generate_images_task`
+- **Features:**
+  - Task creation from content ideas
+  - AI-powered content generation
+  - Content editing and review
+  - Image prompt extraction
+  - AI-powered image generation
+  - WordPress publishing
+
+### Thinker Module
+- **Purpose:** AI configuration and strategy
+- **Models:** AIPrompt, AuthorProfile, Strategy
+- **ViewSets:** AIPromptViewSet, AuthorProfileViewSet
+- **Features:**
+  - AI prompt management
+  - Author profile management
+  - Content strategy management
+  - Image testing
+
+### System Module
+- **Purpose:** System configuration and AI settings
+- **Models:** IntegrationSettings, AIPrompt, AuthorProfile, Strategy
+- **ViewSets:** IntegrationSettingsViewSet, AIPromptViewSet, AuthorProfileViewSet
+- **Features:**
+  - Integration settings (OpenAI, Runware)
+  - AI prompt management
+  - System status and monitoring
+
+### Billing Module
+- **Purpose:** Credit management and usage tracking
+- **Models:** CreditTransaction, CreditUsageLog
+- **ViewSets:** CreditTransactionViewSet, CreditUsageLogViewSet
+- **Services:** CreditService
+- **Features:**
+  - Credit balance tracking
+  - Credit transactions
+  - Usage logging
+  - Cost tracking
+
+### Auth Module
+- **Purpose:** Multi-tenancy and user management
+- **Models:** Account, User, Plan, Site, Sector, Industry
+- **ViewSets:** AccountViewSet, UserViewSet, SiteViewSet, SectorViewSet
+- **Features:**
+  - Account management
+  - User management
+  - Plan management
+  - Site and sector management
+  - Industry templates
+
+---
+
+## Credit System
+
+### Credit Balance Management
+
+**Account Credits:**
+- Each account has a `credits` field (integer)
+- Credits start at 0 or plan-included credits
+- Credits are deducted for AI operations
+- Credits can be added via transactions
+
+**Credit Checking:**
+- Before AI operation: System checks if account has sufficient credits
+- If insufficient: Operation fails with `InsufficientCreditsError`
+- If sufficient: Operation proceeds
+
+**Credit Deduction:**
+- After AI operation completes: Credits deducted via `CreditService.deduct_credits()`
+- Account credits field updated
+- CreditTransaction record created (type: deduction, amount: negative)
+- CreditUsageLog record created with operation details
+
+### Credit Costs per Operation
+
+- **Clustering:** 1 credit per 30 keywords (base: 1 credit)
+- **Ideas:** 1 credit per idea (base: 1 credit)
+- **Content:** 3 credits per content piece (base: 3 credits)
+- **Images:** 1 credit per image (base: 1 credit)
+- **Reparse:** 1 credit per reparse (base: 1 credit)
+
+---
+
+## WordPress Integration
+
+### Publishing Process
+
+**Workflow:**
+1. User selects content to publish
+2. System validates WordPress configuration
+3. System authenticates with WordPress REST API
+4. System creates WordPress post:
+   - Title: Content meta_title or task title
+   - Content: Content HTML
+   - Status: Draft or Publish (based on content status)
+   - Featured image: Uploaded if available
+   - In-article images: Uploaded if available
+   - Meta fields: Primary keyword, secondary keywords
+5. WordPress returns post ID
+6. System updates Content record:
+   - Sets `wp_post_id` field
+   - Sets `status` to "published"
+
+**Requirements:**
+- Site must have WordPress URL configured (`wp_url`)
+- Site must have WordPress username and app password
+- Content must have status "review" or "draft"
+- WordPress REST API must be accessible
+
+---
+
+## Docker Architecture
+
+### Infrastructure Stack (`igny8-infra`)
+- **PostgreSQL** - Database (Port 5432 internal)
+- **Redis** - Cache & Celery broker (Port 6379 internal)
+- **pgAdmin** - Database admin (Port 5050)
+- **FileBrowser** - File management (Port 8080)
+- **Caddy** - Reverse proxy (Ports 80, 443)
+- **Setup Helper** - Utility container
+
+### Application Stack (`igny8-app`)
+- **Backend** - Django API (Port 8011:8010)
+- **Frontend** - React app (Port 8021:5173)
+- **Marketing Dev** - Marketing site (Port 8023:5174)
+- **Celery Worker** - Async task processing
+- **Celery Beat** - Scheduled tasks
+
+### Network Configuration
+- **Network Name:** `igny8_net`
+- **Type:** External bridge network
+- **Purpose:** Inter-container communication
+
+---
+
+## Key Files and Locations
+
+### Backend Key Files
+- `backend/igny8_core/auth/middleware.py` - AccountContextMiddleware
+- `backend/igny8_core/api/base.py` - AccountModelViewSet, SiteSectorModelViewSet
+- `backend/igny8_core/ai/engine.py` - AIEngine orchestrator
+- `backend/igny8_core/ai/base.py` - BaseAIFunction
+- `backend/igny8_core/ai/tasks.py` - run_ai_task entrypoint
+- `backend/igny8_core/api/response.py` - Unified response helpers
+
+### Frontend Key Files
+- `frontend/src/services/api.ts` - API client
+- `frontend/src/store/authStore.ts` - Authentication state
+- `frontend/src/store/siteStore.ts` - Site management
+- `frontend/src/templates/` - 4 universal templates
+- `frontend/src/config/pages/` - Page configurations
+
+### Documentation
+- `docs/01-TECH-STACK-AND-INFRASTRUCTURE.md` - Tech stack
+- `docs/02-APPLICATION-ARCHITECTURE.md` - Application architecture
+- `docs/03-FRONTEND-ARCHITECTURE.md` - Frontend architecture
+- `docs/04-BACKEND-IMPLEMENTATION.md` - Backend implementation
+- `docs/05-AI-FRAMEWORK-IMPLEMENTATION.md` - AI framework
+- `docs/06-FUNCTIONAL-BUSINESS-LOGIC.md` - Business logic
+- `docs/API-COMPLETE-REFERENCE.md` - Complete API reference
+
+---
+
+## Data Flow Examples
+
+### Request Flow
+```
+1. User Action (e.g., "Auto Cluster Keywords")
+   ↓
+2. Frontend API Call (fetchAPI)
+   ↓
+3. Backend Endpoint (ViewSet Action)
+   ↓
+4. Celery Task Queued
+   ↓
+5. Task ID Returned to Frontend
+   ↓
+6. Frontend Polls Progress Endpoint
+   ↓
+7. Celery Worker Processes Task
+   ↓
+8. AIProcessor Makes API Calls
+   ↓
+9. Results Saved to Database
+   ↓
+10. Progress Updates Sent
+   ↓
+11. Frontend Displays Results
+```
+
+### Authentication Flow
+```
+1. User Signs In
+   ↓
+2. Backend Validates Credentials
+   ↓
+3. JWT Token Generated
+   ↓
+4. Token Returned to Frontend
+   ↓
+5. Frontend Stores Token (localStorage)
+   ↓
+6. Frontend Includes Token in Requests (Authorization: Bearer {token})
+   ↓
+7. Backend Validates Token
+   ↓
+8. Account Context Set (AccountContextMiddleware)
+   ↓
+9. Request Processed
+```
+
+---
+
+## Security Architecture
+
+### Authentication
+- **Primary:** JWT Bearer tokens
+- **Fallback:** Session-based auth (admin panel)
+- **Token Storage:** localStorage (frontend)
+- **Token Expiry:** 15 minutes (access), 7 days (refresh)
+
+### Authorization
+- **Role-Based Access Control (RBAC):** Role checked on every request
+- **Data Access Control:**
+  - Account-level: Automatic filtering by account
+  - Site-level: Filtering by accessible sites
+  - Action-level: Permission checks in ViewSet actions
+
+### Account Isolation
+- All queries filtered by account
+- Admin/Developer override for system accounts
+- No cross-account data leakage
+
+---
+
+## External Service Integrations
+
+### OpenAI Integration
+- **Purpose:** Text generation and image generation
+- **Configuration:** API key stored per account in `IntegrationSettings`
+- **Services Used:**
+  - GPT models for text generation
+  - DALL-E for image generation
+- **Cost Tracking:** Tracked per request
+
+### Runware Integration
+- **Purpose:** Alternative image generation service
+- **Configuration:** API key stored per account
+- **Model Selection:** e.g., `runware:97@1`
+- **Image Type:** realistic, artistic, cartoon
+
+### WordPress Integration
+- **Purpose:** Content publishing
+- **Configuration:** WordPress URL per site, username and password stored per site
+- **Workflow:**
+  1. Content generated in IGNY8
+  2. Images attached
+  3. Content published to WordPress via REST API
+  4. Status updated in IGNY8
+
+---
+
+## Development Workflow
+
+### Local Development
+1. **Backend:**
+   ```bash
+   cd backend
+   pip install -r requirements.txt
+   python manage.py migrate
+   python manage.py runserver
+   ```
+
+2. **Frontend:**
+   ```bash
+   cd frontend
+   npm install
+   npm run dev
+   ```
+
+### Docker Development
+1. **Build Images:**
+   ```bash
+   docker build -t igny8-backend -f backend/Dockerfile ./backend
+   docker build -t igny8-frontend-dev -f frontend/Dockerfile.dev ./frontend
+   ```
+
+2. **Start Services:**
+   ```bash
+   docker compose -f docker-compose.app.yml -p igny8-app up -d
+   ```
+
+---
+
+## Summary
+
+This context document provides a comprehensive overview of the IGNY8 system architecture, including:
+
+1. **System Architecture:** High-level architecture, infrastructure status, technology stack
+2. **Core Principles:** Multi-tenancy, configuration-driven, unified AI framework, module-based
+3. **System Hierarchy:** Entity relationships, account/site/sector structure
+4. **User Roles:** Role hierarchy, permissions, access control
+5. **Workflows:** Complete workflows for account setup, keyword management, content generation, WordPress publishing
+6. **AI Framework:** Unified execution pipeline, AI functions, progress tracking
+7. **Frontend Architecture:** Dual application structure, state management, templates, API integration
+8. **Backend Architecture:** Multi-tenancy implementation, base classes, API response format
+9. **Module Organization:** Planner, Writer, Thinker, System, Billing, Auth modules
+10. **Credit System:** Credit balance management, costs per operation
+11. **WordPress Integration:** Publishing process, requirements
+12. **Docker Architecture:** Infrastructure and application stacks
+13. **Key Files:** Important file locations
+14. **Data Flow:** Request and authentication flows
+15. **Security:** Authentication, authorization, account isolation
+16. **External Services:** OpenAI, Runware, WordPress integrations
+17. **Development:** Local and Docker development workflows
+
+This document serves as a comprehensive reference for understanding the complete IGNY8 system architecture and implementation details.
+
+---
+
+**Last Updated:** 2025-01-XX  
+**Version:** 1.0.0
+

docs/planning/CONTENT-WORKFLOW-DIAGRAM.md

@@ -0,0 +1,309 @@
+# CONTENT WORKFLOW & ENTRY POINTS
+**Complete Workflow Diagrams for Writer → Linker → Optimizer**
+
+---
+
+## WORKFLOW 1: WRITER → LINKER → OPTIMIZER → PUBLISH
+
+```
+┌─────────────┐
+│   Writer    │
+│  Generates  │
+│   Content   │
+└──────┬──────┘
+       │
+       ▼
+┌─────────────────────┐
+│ Content Saved       │
+│ source='igny8'      │
+│ sync_status='native'│
+│ status='draft'      │
+└──────┬──────────────┘
+       │
+       ▼
+┌─────────────────────┐
+│ Linker Trigger      │
+│ (Auto or Manual)    │
+└──────┬──────────────┘
+       │
+       ▼
+┌─────────────────────┐
+│ LinkerService       │
+│ - Finds candidates  │
+│ - Injects links     │
+│ - Updates content   │
+└──────┬──────────────┘
+       │
+       ▼
+┌─────────────────────┐
+│ Content Updated     │
+│ linker_version++    │
+│ internal_links[]    │
+│ status='linked'     │
+└──────┬──────────────┘
+       │
+       ▼
+┌─────────────────────┐
+│ Optimizer Trigger   │
+│ (Auto or Manual)    │
+└──────┬──────────────┘
+       │
+       ▼
+┌─────────────────────┐
+│ OptimizerService    │
+│ - Analyzes content  │
+│ - Optimizes         │
+│ - Stores results    │
+└──────┬──────────────┘
+       │
+       ▼
+┌─────────────────────┐
+│ Content Updated     │
+│ optimizer_version++ │
+│ status='optimized'  │
+└──────┬──────────────┘
+       │
+       ▼
+┌─────────────────────┐
+│ PublisherService    │
+│ - WordPress         │
+│ - Sites Renderer    │
+│ - Shopify           │
+└─────────────────────┘
+```
+
+---
+
+## WORKFLOW 2: WORDPRESS SYNC → OPTIMIZER → PUBLISH
+
+```
+┌─────────────────┐
+│ WordPress       │
+│ Plugin Syncs    │
+│ Posts to IGNY8  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ ContentSyncService      │
+│ sync_from_wordpress()   │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Content Created         │
+│ source='wordpress'      │
+│ sync_status='synced'    │
+│ external_id=wp_post_id  │
+│ external_url=wp_url     │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Content Visible         │
+│ in Writer/Content List  │
+│ (Filterable by source)  │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ User Selects Content    │
+│ Clicks "Optimize"       │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ OptimizerService        │
+│ optimize_from_wordpress_│
+│ sync(content_id)       │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Optimizer Processes     │
+│ (Same logic as IGNY8)   │
+│ - Analyzes              │
+│ - Optimizes             │
+│ - Stores results        │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ OptimizationTask        │
+│ Created                 │
+│ Original preserved      │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Optional: Sync Back     │
+│ to WordPress            │
+│ (Two-way sync)          │
+└─────────────────────────┘
+```
+
+---
+
+## WORKFLOW 3: 3RD PARTY SYNC → OPTIMIZER → PUBLISH
+
+```
+┌─────────────────┐
+│ Shopify/API     │
+│ Syncs Content   │
+│ to IGNY8         │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ ContentSyncService      │
+│ sync_from_shopify()     │
+│ or sync_from_custom()   │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Content Created         │
+│ source='shopify'/'custom'│
+│ sync_status='imported'  │
+│ external_id=external_id │
+│ external_url=external_url│
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Content Visible         │
+│ in Writer/Content List  │
+│ (Filterable by source)  │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ User Selects Content    │
+│ Clicks "Optimize"       │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ OptimizerService        │
+│ optimize_from_external_ │
+│ sync(content_id)       │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Optimizer Processes     │
+│ (Same logic)            │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ OptimizationTask        │
+│ Created                 │
+└─────────────────────────┘
+```
+
+---
+
+## WORKFLOW 4: MANUAL SELECTION → LINKER/OPTIMIZER
+
+```
+┌─────────────────────────┐
+│ User Views Content List │
+│ (Any source)            │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ User Selects Content    │
+│ (Can filter by source)   │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ User Clicks Action:     │
+│ - "Add Links"           │
+│ - "Optimize"            │
+│ - "Link & Optimize"     │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ LinkerService or        │
+│ OptimizerService        │
+│ (Works for any source)   │
+└────────┬────────────────┘
+         │
+         ▼
+┌─────────────────────────┐
+│ Content Processed       │
+│ Results Stored          │
+└─────────────────────────┘
+```
+
+---
+
+## CONTENT STORAGE STRATEGY
+
+### Unified Content Model
+
+All content stored in same `Content` model, differentiated by flags:
+
+| Field | Values | Purpose |
+|-------|--------|---------|
+| `source` | `'igny8'`, `'wordpress'`, `'shopify'`, `'custom'` | Where content came from |
+| `sync_status` | `'native'`, `'imported'`, `'synced'` | How content was added |
+| `external_id` | String | External platform ID |
+| `external_url` | URL | External platform URL |
+| `sync_metadata` | JSON | Platform-specific data |
+
+### Content Filtering
+
+**Frontend Filters**:
+- By source: Show only IGNY8, WordPress, Shopify, or All
+- By sync_status: Show Native, Imported, Synced, or All
+- By optimization status: Not optimized, Optimized, Needs optimization
+- By linking status: Not linked, Linked, Needs linking
+
+**Backend Queries**:
+```python
+# Get all IGNY8 content
+Content.objects.filter(source='igny8', sync_status='native')
+
+# Get all WordPress synced content
+Content.objects.filter(source='wordpress', sync_status='synced')
+
+# Get all content ready for optimization
+Content.objects.filter(optimizer_version=0)
+
+# Get all content ready for linking
+Content.objects.filter(linker_version=0)
+```
+
+---
+
+## ENTRY POINT SUMMARY
+
+| Entry Point | Trigger | Content Source | Goes Through |
+|-------------|---------|----------------|--------------|
+| **Writer → Linker** | Auto or Manual | `source='igny8'` | Linker → Optimizer |
+| **Writer → Optimizer** | Auto or Manual | `source='igny8'` | Optimizer (skip linker) |
+| **WordPress Sync → Optimizer** | Manual or Auto | `source='wordpress'` | Optimizer only |
+| **3rd Party Sync → Optimizer** | Manual or Auto | `source='shopify'/'custom'` | Optimizer only |
+| **Manual Selection → Linker** | Manual | Any source | Linker only |
+| **Manual Selection → Optimizer** | Manual | Any source | Optimizer only |
+
+---
+
+## KEY PRINCIPLES
+
+1. **Unified Storage**: All content in same model, filtered by flags
+2. **Source Agnostic**: Linker/Optimizer work on any content source
+3. **Flexible Entry**: Multiple ways to enter pipeline
+4. **Preserve Original**: Original content always preserved
+5. **Version Tracking**: `linker_version` and `optimizer_version` track processing
+6. **Filterable**: Content can be filtered by source, sync_status, processing status
+
+---
+
+**END OF DOCUMENT**
+

docs/planning/phases/PHASE-0-FOUNDATION-CREDIT-SYSTEM.md

@@ -0,0 +1,524 @@
+# PHASE 0: FOUNDATION & CREDIT SYSTEM
+**Detailed Implementation Plan**
+
+**Goal**: Migrate to credit-only model while preserving all existing functionality.
+
+**Timeline**: 1-2 weeks  
+**Priority**: HIGH  
+**Dependencies**: None
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Module Settings System](#module-settings-system)
+3. [Credit System Updates](#credit-system-updates)
+4. [Operational Limits](#operational-limits)
+5. [Database Migrations](#database-migrations)
+6. [Testing & Validation](#testing--validation)
+7. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Migrate from plan-based limits to credit-only system
+- ✅ Implement module enable/disable functionality
+- ✅ Add credit cost tracking for all operations
+- ✅ Preserve all existing functionality
+- ✅ Update frontend to show credits instead of limits
+
+### Key Principles
+- **Backward Compatibility**: All existing APIs continue working
+- **No Breaking Changes**: Frontend continues working without changes
+- **Gradual Migration**: Add credit checks without removing existing code initially
+- **Credit-Only Model**: Remove all plan limit fields, keep only credits
+
+---
+
+## MODULE SETTINGS SYSTEM
+
+### 0.0 Module Settings System (Enable/Disable Modules)
+
+**Purpose**: Allow accounts to enable/disable modules per account.
+
+#### Backend Implementation
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Extend ModuleSettings Model** | `domain/system/models.py` | EXISTING (ModuleSettings) | Add `enabled` boolean field per module |
+| **Module Settings API** | `modules/system/views.py` | EXISTING | Extend ViewSet to handle enable/disable |
+| **Module Settings Serializer** | `modules/system/serializers.py` | EXISTING | Add enabled field to serializer |
+
+**ModuleSettings Model Extension**:
+```python
+# domain/system/models.py (or core/system/models.py if exists)
+class ModuleSettings(AccountBaseModel):
+    # Existing fields...
+    
+    # NEW: Module enable/disable flags
+    planner_enabled = models.BooleanField(default=True)
+    writer_enabled = models.BooleanField(default=True)
+    thinker_enabled = models.BooleanField(default=True)
+    automation_enabled = models.BooleanField(default=True)
+    site_builder_enabled = models.BooleanField(default=True)
+    linker_enabled = models.BooleanField(default=True)
+    optimizer_enabled = models.BooleanField(default=True)
+    publisher_enabled = models.BooleanField(default=True)
+```
+
+**Modules to Control**:
+- Planner
+- Writer
+- Thinker
+- Automation
+- Site Builder (NEW)
+- Linker (NEW)
+- Optimizer (NEW)
+- Publisher (NEW)
+
+#### Frontend Implementation
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Module Settings UI** | `frontend/src/pages/Settings/Modules.tsx` | EXISTING (placeholder) | Implement toggle UI for each module |
+| **Frontend Module Loader** | `frontend/src/config/modules.config.ts` | NEW | Define module config with enabled checks |
+| **Route Guard** | `frontend/src/components/common/ModuleGuard.tsx` | NEW | Component to check module status before rendering |
+| **Sidebar Filter** | `frontend/src/layout/AppSidebar.tsx` | EXISTING | Filter out disabled modules from sidebar |
+
+**Module Enable/Disable Logic**:
+- Each module has `enabled` flag in ModuleSettings
+- Frontend checks module status before loading routes
+- Disabled modules don't appear in sidebar
+- Disabled modules don't load code (lazy loading check)
+
+**Module Config Example**:
+```typescript
+// frontend/src/config/modules.config.ts
+export const MODULES = {
+  planner: {
+    name: 'Planner',
+    route: '/planner',
+    enabled: true, // Checked from API
+  },
+  writer: {
+    name: 'Writer',
+    route: '/writer',
+    enabled: true,
+  },
+  // ... other modules
+};
+```
+
+**Route Guard Example**:
+```typescript
+// frontend/src/components/common/ModuleGuard.tsx
+const ModuleGuard = ({ module, children }) => {
+  const { moduleSettings } = useSettingsStore();
+  const isEnabled = moduleSettings[module]?.enabled ?? true;
+  
+  if (!isEnabled) {
+    return <Navigate to="/settings/modules" />;
+  }
+  
+  return children;
+};
+```
+
+---
+
+## CREDIT SYSTEM UPDATES
+
+### 0.1 Credit System Updates
+
+**Purpose**: Migrate from plan-based limits to credit-only system.
+
+#### Plan Model Updates
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Remove Plan Limit Fields** | `core/auth/models.py` | EXISTING | Remove all limit fields, add migration |
+| **Update Plan Model** | `core/auth/models.py` | EXISTING | Keep only `monthly_credits`, `support_level`, `billing_cycle`, `price` |
+
+**Plan Model (Simplified)**:
+```python
+# core/auth/models.py
+class Plan(models.Model):
+    name = models.CharField(max_length=255)
+    monthly_credits = models.IntegerField(default=0)  # KEEP
+    support_level = models.CharField(max_length=50)  # KEEP
+    billing_cycle = models.CharField(max_length=20)  # KEEP
+    price = models.DecimalField(max_digits=10, decimal_places=2)  # KEEP
+    features = models.JSONField(default=dict)  # KEEP (for future use)
+    
+    # REMOVE: All limit fields
+    # - max_keywords
+    # - max_clusters
+    # - max_content_ideas
+    # - daily_content_tasks
+    # - monthly_word_count_limit
+    # - daily_image_generation_limit
+    # - monthly_image_count
+    # - etc.
+```
+
+**Migration Strategy**:
+1. Create migration to add defaults for removed fields (if needed)
+2. Create migration to remove limit fields
+3. Ensure existing accounts have credit balances set
+
+#### Credit Cost Constants
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Add Credit Costs** | `domain/billing/constants.py` | NEW | Define credit costs per operation |
+
+**Credit Cost Constants**:
+```python
+# domain/billing/constants.py
+CREDIT_COSTS = {
+    'clustering': 10,                    # Per clustering request
+    'idea_generation': 15,               # Per cluster → ideas request
+    'content_generation': 1,              # Per 100 words
+    'image_prompt_extraction': 2,        # Per content piece
+    'image_generation': 5,               # Per image
+    'linking': 8,                        # Per content piece (NEW)
+    'optimization': 1,                   # Per 200 words (NEW)
+    'site_structure_generation': 50,     # Per site blueprint (NEW)
+    'site_page_generation': 20,          # Per page (NEW)
+}
+```
+
+#### CreditService Updates
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Update CreditService** | `domain/billing/services/credit_service.py` | EXISTING | Add credit cost constants, update methods |
+
+**CreditService Methods**:
+```python
+# domain/billing/services/credit_service.py
+class CreditService:
+    def check_credits(self, account, operation_type, amount=None):
+        """Check if account has sufficient credits"""
+        required = self.get_credit_cost(operation_type, amount)
+        if account.credits < required:
+            raise InsufficientCreditsError(f"Need {required} credits, have {account.credits}")
+        return True
+    
+    def deduct_credits(self, account, operation_type, amount=None):
+        """Deduct credits after operation"""
+        cost = self.get_credit_cost(operation_type, amount)
+        account.credits -= cost
+        account.save()
+        # Log usage
+        CreditUsageLog.objects.create(...)
+    
+    def get_credit_cost(self, operation_type, amount=None):
+        """Get credit cost for operation"""
+        base_cost = CREDIT_COSTS.get(operation_type, 0)
+        if operation_type == 'content_generation' and amount:
+            return base_cost * (amount / 100)  # Per 100 words
+        if operation_type == 'optimization' and amount:
+            return base_cost * (amount / 200)  # Per 200 words
+        return base_cost
+```
+
+#### AI Engine Updates
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Update AI Engine** | `infrastructure/ai/engine.py` | EXISTING | Check credits before AI calls |
+
+**AI Engine Credit Check**:
+```python
+# infrastructure/ai/engine.py
+class AIEngine:
+    def execute(self, function, payload, account):
+        # Check credits BEFORE AI call
+        operation_type = function.get_operation_type()
+        estimated_cost = function.get_estimated_cost(payload)
+        
+        credit_service.check_credits(account, operation_type, estimated_cost)
+        
+        # Execute AI function
+        result = function.execute(payload)
+        
+        # Deduct credits AFTER successful execution
+        credit_service.deduct_credits(account, operation_type, actual_cost)
+        
+        return result
+```
+
+#### Content Generation Updates
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Update Content Generation** | `domain/content/services/content_generation_service.py` | NEW (Phase 1) | Check credits before generation |
+
+**Content Generation Credit Check**:
+```python
+# domain/content/services/content_generation_service.py
+class ContentGenerationService:
+    def generate_content(self, task, account):
+        # Check credits before generation
+        estimated_words = task.estimated_word_count or 1000
+        credit_service.check_credits(account, 'content_generation', estimated_words)
+        
+        # Generate content
+        content = self._generate(task)
+        
+        # Deduct credits after generation
+        actual_words = content.word_count
+        credit_service.deduct_credits(account, 'content_generation', actual_words)
+        
+        return content
+```
+
+#### Image Generation Updates
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Update Image Generation** | `infrastructure/ai/functions/generate_images.py` | EXISTING | Check credits before generation |
+
+**Image Generation Credit Check**:
+```python
+# infrastructure/ai/functions/generate_images.py
+class GenerateImagesFunction(BaseAIFunction):
+    def execute(self, payload, account):
+        image_ids = payload['image_ids']
+        
+        # Check credits before generation
+        credit_service.check_credits(account, 'image_generation', len(image_ids))
+        
+        # Generate images
+        results = self._generate_images(image_ids)
+        
+        # Deduct credits after generation
+        credit_service.deduct_credits(account, 'image_generation', len(results))
+        
+        return results
+```
+
+#### Remove Limit Checks
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Remove Limit Checks** | All services | EXISTING | Remove all plan limit validations |
+
+**Files to Update**:
+- `modules/planner/views.py` - Remove keyword/cluster limit checks
+- `modules/writer/views.py` - Remove task/content limit checks
+- `infrastructure/ai/engine.py` - Remove plan limit checks
+- All ViewSets - Remove limit validation
+
+**Before (Remove)**:
+```python
+# OLD: Check plan limits
+if account.plan.max_keywords and keywords_count > account.plan.max_keywords:
+    raise ValidationError("Exceeds plan limit")
+```
+
+**After (Credit Only)**:
+```python
+# NEW: Check credits only
+credit_service.check_credits(account, 'clustering', keyword_count)
+```
+
+#### Usage Logging Updates
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Update Usage Logging** | `domain/billing/models.py` | EXISTING | Ensure all operations log credits |
+
+**CreditUsageLog Model**:
+```python
+# domain/billing/models.py
+class CreditUsageLog(AccountBaseModel):
+    account = models.ForeignKey(Account, on_delete=models.CASCADE)
+    operation_type = models.CharField(max_length=50)
+    credits_used = models.IntegerField()
+    related_object_type = models.CharField(max_length=50, blank=True)
+    related_object_id = models.IntegerField(null=True, blank=True)
+    metadata = models.JSONField(default=dict)
+    created_at = models.DateTimeField(auto_now_add=True)
+```
+
+#### Frontend Updates
+
+| Task | File | Current State | Implementation |
+|------|------|---------------|----------------|
+| **Update Frontend Limits UI** | `frontend/src/pages/Billing/` | EXISTING | Replace limits display with credit display |
+
+**Frontend Changes**:
+- Remove plan limit displays
+- Show credit balance prominently
+- Show credit costs per operation
+- Show usage history by operation type
+
+---
+
+## OPERATIONAL LIMITS
+
+### 0.2 Operational Limits (Keep)
+
+**Purpose**: Technical constraints, not business limits.
+
+| Limit | Value | Location | Implementation | Reason |
+|-------|-------|----------|----------------|--------|
+| **Keywords per request** | 50 | `modules/planner/views.py` | Request validation | API payload size, processing time |
+| **Images per request** | 6 | `modules/writer/views.py` | Request validation | Queue management (user sees as batch) |
+| **Images per AI call** | 1 | `infrastructure/ai/functions/generate_images.py` | Internal | Image API limitation |
+
+**Note**: These are **NOT** business limits - they're technical constraints for request processing.
+
+---
+
+## DATABASE MIGRATIONS
+
+### 0.3 Database Migrations
+
+| Migration | Purpose | Risk | Implementation |
+|-----------|---------|------|----------------|
+| **Remove limit fields from Plan** | Clean up unused fields | LOW - Add defaults first | Create migration to remove fields |
+| **Add credit cost tracking** | Enhance CreditUsageLog | LOW - Additive only | Add fields to CreditUsageLog |
+| **Monthly credit replenishment** | Celery Beat task | LOW - New feature | Add scheduled task |
+
+**Migration 1: Remove Plan Limit Fields**:
+```python
+# core/auth/migrations/XXXX_remove_plan_limits.py
+class Migration(migrations.Migration):
+    operations = [
+        migrations.RemoveField(model_name='plan', name='max_keywords'),
+        migrations.RemoveField(model_name='plan', name='max_clusters'),
+        # ... remove all limit fields
+    ]
+```
+
+**Migration 2: Add Credit Cost Tracking**:
+```python
+# domain/billing/migrations/XXXX_add_credit_tracking.py
+class Migration(migrations.Migration):
+    operations = [
+        migrations.AddField(
+            model_name='creditusagelog',
+            name='related_object_type',
+            field=models.CharField(max_length=50, blank=True),
+        ),
+        migrations.AddField(
+            model_name='creditusagelog',
+            name='related_object_id',
+            field=models.IntegerField(null=True, blank=True),
+        ),
+        migrations.AddField(
+            model_name='creditusagelog',
+            name='metadata',
+            field=models.JSONField(default=dict),
+        ),
+    ]
+```
+
+**Migration 3: Monthly Credit Replenishment**:
+- Add Celery Beat task (see Automation section)
+
+---
+
+## TESTING & VALIDATION
+
+### 0.4 Testing
+
+**Test Cases**:
+
+1. **Credit System Tests**:
+   - ✅ All existing features work with credit checks
+   - ✅ Credit deduction happens correctly
+   - ✅ Insufficient credits show clear error
+   - ✅ Usage logging tracks all operations
+   - ✅ Frontend shows credit balance, not limits
+
+2. **Module Settings Tests**:
+   - ✅ Disabled modules don't appear in sidebar
+   - ✅ Disabled modules don't load routes
+   - ✅ Disabled modules return 403/404 appropriately
+   - ✅ Module settings persist correctly
+
+3. **Backward Compatibility Tests**:
+   - ✅ All existing API endpoints work
+   - ✅ All existing workflows function
+   - ✅ Frontend continues working
+   - ✅ No data loss during migration
+
+**Test Files to Create**:
+- `backend/tests/test_credit_system.py`
+- `backend/tests/test_module_settings.py`
+- `frontend/src/__tests__/ModuleGuard.test.tsx`
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Create `domain/billing/constants.py` with credit costs
+- [ ] Update `CreditService` with credit cost methods
+- [ ] Update `Plan` model - remove limit fields
+- [ ] Create migration to remove plan limit fields
+- [ ] Update `AIEngine` to check credits before AI calls
+- [ ] Update content generation to check credits
+- [ ] Update image generation to check credits
+- [ ] Remove all plan limit checks from ViewSets
+- [ ] Update `CreditUsageLog` model with tracking fields
+- [ ] Create migration for credit tracking
+- [ ] Extend `ModuleSettings` model with enabled flags
+- [ ] Update module settings API
+- [ ] Add monthly credit replenishment Celery Beat task
+
+### Frontend Tasks
+
+- [ ] Implement `frontend/src/pages/Settings/Modules.tsx`
+- [ ] Create `frontend/src/config/modules.config.ts`
+- [ ] Create `frontend/src/components/common/ModuleGuard.tsx`
+- [ ] Update `frontend/src/App.tsx` with conditional route loading
+- [ ] Update `frontend/src/layout/AppSidebar.tsx` to filter disabled modules
+- [ ] Update `frontend/src/pages/Billing/` to show credits instead of limits
+- [ ] Update billing UI to show credit costs per operation
+
+### Testing Tasks
+
+- [ ] Test credit deduction for all operations
+- [ ] Test insufficient credits error handling
+- [ ] Test module enable/disable functionality
+- [ ] Test disabled modules don't load
+- [ ] Test backward compatibility
+- [ ] Test migration safety
+
+---
+
+## RISK ASSESSMENT
+
+| Risk | Level | Mitigation |
+|------|-------|------------|
+| **Breaking existing functionality** | MEDIUM | Extensive testing, gradual rollout |
+| **Credit calculation errors** | MEDIUM | Unit tests for credit calculations |
+| **Migration data loss** | LOW | Backup before migration, test on staging |
+| **Frontend breaking changes** | LOW | Backward compatible API changes |
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ All existing features work with credit checks
+- ✅ Credit deduction happens correctly for all operations
+- ✅ Insufficient credits show clear error messages
+- ✅ Usage logging tracks all operations
+- ✅ Frontend shows credit balance, not limits
+- ✅ Module settings enable/disable modules correctly
+- ✅ Disabled modules don't appear in UI
+- ✅ No breaking changes for existing users
+
+---
+
+**END OF PHASE 0 DOCUMENT**
+

docs/planning/phases/PHASE-1-SERVICE-LAYER-REFACTORING.md

@@ -0,0 +1,436 @@
+# PHASE 1: SERVICE LAYER REFACTORING
+**Detailed Implementation Plan**
+
+**Goal**: Extract business logic from ViewSets into services, preserving all existing functionality.
+
+**Timeline**: 2-3 weeks  
+**Priority**: HIGH  
+**Dependencies**: Phase 0
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Create Domain Structure](#create-domain-structure)
+3. [Move Models to Domain](#move-models-to-domain)
+4. [Create Services](#create-services)
+5. [Refactor ViewSets](#refactor-viewsets)
+6. [Testing & Validation](#testing--validation)
+7. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Create `domain/` folder structure
+- ✅ Move models from `modules/` to `domain/`
+- ✅ Extract business logic from ViewSets to services
+- ✅ Keep ViewSets as thin wrappers
+- ✅ Preserve all existing API functionality
+
+### Key Principles
+- **Backward Compatibility**: All APIs remain unchanged
+- **Service Layer Pattern**: Business logic in services, not ViewSets
+- **No Breaking Changes**: Response formats unchanged
+- **Testable Services**: Services can be tested independently
+
+---
+
+## CREATE DOMAIN STRUCTURE
+
+### 1.1 Create Domain Structure
+
+**Purpose**: Organize code by business domains, not technical layers.
+
+#### Folder Structure
+
+```
+backend/igny8_core/
+├── domain/                        # NEW: Domain layer
+│   ├── content/                   # Content domain
+│   │   ├── __init__.py
+│   │   ├── models.py              # Content, Tasks, Images
+│   │   ├── services/
+│   │   │   ├── __init__.py
+│   │   │   ├── content_generation_service.py
+│   │   │   ├── content_pipeline_service.py
+│   │   │   └── content_versioning_service.py
+│   │   └── migrations/
+│   │
+│   ├── planning/                  # Planning domain
+│   │   ├── __init__.py
+│   │   ├── models.py              # Keywords, Clusters, Ideas
+│   │   ├── services/
+│   │   │   ├── __init__.py
+│   │   │   ├── clustering_service.py
+│   │   │   └── ideas_service.py
+│   │   └── migrations/
+│   │
+│   ├── billing/                   # Billing domain (already exists)
+│   │   ├── models.py              # Credits, Transactions
+│   │   └── services/
+│   │       └── credit_service.py  # Already exists
+│   │
+│   └── automation/                # Automation domain (Phase 2)
+│       ├── models.py
+│       └── services/
+```
+
+#### Implementation Tasks
+
+| Task | File | Current Location | New Location | Risk |
+|------|------|------------------|--------------|------|
+| **Create domain/ folder** | `backend/igny8_core/domain/` | N/A | NEW | LOW |
+| **Create content domain** | `domain/content/` | N/A | NEW | LOW |
+| **Create planning domain** | `domain/planning/` | N/A | NEW | LOW |
+| **Create billing domain** | `domain/billing/` | `modules/billing/` | MOVE | LOW |
+| **Create automation domain** | `domain/automation/` | N/A | NEW (Phase 2) | LOW |
+
+---
+
+## MOVE MODELS TO DOMAIN
+
+### 1.2 Move Models to Domain
+
+**Purpose**: Move models from `modules/` to `domain/` to separate business logic from API layer.
+
+#### Content Models Migration
+
+| Model | Current Location | New Location | Changes Needed |
+|------|------------------|--------------|----------------|
+| `Content` | `modules/writer/models.py` | `domain/content/models.py` | Move, update imports |
+| `Tasks` | `modules/writer/models.py` | `domain/content/models.py` | Move, update imports |
+| `Images` | `modules/writer/models.py` | `domain/content/models.py` | Move, update imports |
+
+**Migration Steps**:
+1. Create `domain/content/models.py`
+2. Copy models from `modules/writer/models.py`
+3. Update imports in `modules/writer/views.py`
+4. Create migration to ensure no data loss
+5. Update all references to models
+
+#### Planning Models Migration
+
+| Model | Current Location | New Location | Changes Needed |
+|------|------------------|--------------|----------------|
+| `Keywords` | `modules/planner/models.py` | `domain/planning/models.py` | Move, update imports |
+| `Clusters` | `modules/planner/models.py` | `domain/planning/models.py` | Move, update imports |
+| `ContentIdeas` | `modules/planner/models.py` | `domain/planning/models.py` | Move, update imports |
+
+**Migration Steps**:
+1. Create `domain/planning/models.py`
+2. Copy models from `modules/planner/models.py`
+3. Update imports in `modules/planner/views.py`
+4. Create migration to ensure no data loss
+5. Update all references to models
+
+#### Billing Models Migration
+
+| Model | Current Location | New Location | Changes Needed |
+|------|------------------|--------------|----------------|
+| `CreditTransaction` | `modules/billing/models.py` | `domain/billing/models.py` | Move, update imports |
+| `CreditUsageLog` | `modules/billing/models.py` | `domain/billing/models.py` | Move, update imports |
+
+**Migration Steps**:
+1. Create `domain/billing/models.py`
+2. Copy models from `modules/billing/models.py`
+3. Move `CreditService` to `domain/billing/services/credit_service.py`
+4. Update imports in `modules/billing/views.py`
+5. Create migration to ensure no data loss
+
+---
+
+## CREATE SERVICES
+
+### 1.3 Create Services
+
+**Purpose**: Extract business logic from ViewSets into reusable services.
+
+#### ContentService
+
+| Task | File | Purpose | Dependencies |
+|------|------|---------|--------------|
+| **Create ContentService** | `domain/content/services/content_generation_service.py` | Unified content generation | Existing Writer logic, CreditService |
+
+**ContentService Methods**:
+```python
+# domain/content/services/content_generation_service.py
+class ContentGenerationService:
+    def __init__(self):
+        self.credit_service = CreditService()
+    
+    def generate_content(self, task, account):
+        """Generate content for a task"""
+        # Check credits
+        self.credit_service.check_credits(account, 'content_generation', task.estimated_word_count)
+        
+        # Generate content (existing logic from Writer ViewSet)
+        content = self._generate(task)
+        
+        # Deduct credits
+        self.credit_service.deduct_credits(account, 'content_generation', content.word_count)
+        
+        return content
+    
+    def _generate(self, task):
+        """Internal content generation logic"""
+        # Move logic from Writer ViewSet here
+        pass
+```
+
+#### PlanningService
+
+| Task | File | Purpose | Dependencies |
+|------|------|---------|--------------|
+| **Create PlanningService** | `domain/planning/services/clustering_service.py` | Keyword clustering | Existing Planner logic, CreditService |
+
+**PlanningService Methods**:
+```python
+# domain/planning/services/clustering_service.py
+class ClusteringService:
+    def __init__(self):
+        self.credit_service = CreditService()
+    
+    def cluster_keywords(self, keyword_ids, account):
+        """Cluster keywords using AI"""
+        # Check credits
+        self.credit_service.check_credits(account, 'clustering', len(keyword_ids))
+        
+        # Cluster keywords (existing logic from Planner ViewSet)
+        clusters = self._cluster(keyword_ids)
+        
+        # Deduct credits
+        self.credit_service.deduct_credits(account, 'clustering', len(keyword_ids))
+        
+        return clusters
+```
+
+#### IdeasService
+
+| Task | File | Purpose | Dependencies |
+|------|------|---------|--------------|
+| **Create IdeasService** | `domain/planning/services/ideas_service.py` | Generate content ideas | Existing Planner logic, CreditService |
+
+**IdeasService Methods**:
+```python
+# domain/planning/services/ideas_service.py
+class IdeasService:
+    def __init__(self):
+        self.credit_service = CreditService()
+    
+    def generate_ideas(self, cluster_ids, account):
+        """Generate content ideas from clusters"""
+        # Check credits
+        self.credit_service.check_credits(account, 'idea_generation', len(cluster_ids))
+        
+        # Generate ideas (existing logic from Planner ViewSet)
+        ideas = self._generate_ideas(cluster_ids)
+        
+        # Deduct credits
+        self.credit_service.deduct_credits(account, 'idea_generation', len(ideas))
+        
+        return ideas
+```
+
+---
+
+## REFACTOR VIEWSETS
+
+### 1.4 Refactor ViewSets (Keep APIs Working)
+
+**Purpose**: Make ViewSets thin wrappers that delegate to services.
+
+#### Planner ViewSets Refactoring
+
+| ViewSet | Current | New | Risk |
+|---------|---------|-----|------|
+| **KeywordViewSet** | Business logic in views | Delegate to services | LOW |
+| **ClusterViewSet** | Business logic in views | Delegate to services | LOW |
+| **ContentIdeasViewSet** | Business logic in views | Delegate to services | LOW |
+
+**Before (Business Logic in ViewSet)**:
+```python
+# modules/planner/views.py
+class ClusterViewSet(SiteSectorModelViewSet):
+    @action(detail=False, methods=['post'])
+    def auto_generate_ideas(self, request):
+        cluster_ids = request.data.get('cluster_ids')
+        # Business logic here (50+ lines)
+        clusters = Cluster.objects.filter(id__in=cluster_ids)
+        # AI call logic
+        # Idea creation logic
+        # etc.
+        return Response(...)
+```
+
+**After (Delegate to Service)**:
+```python
+# modules/planner/views.py
+class ClusterViewSet(SiteSectorModelViewSet):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.ideas_service = IdeasService()
+    
+    @action(detail=False, methods=['post'])
+    def auto_generate_ideas(self, request):
+        cluster_ids = request.data.get('cluster_ids')
+        account = request.account
+        
+        # Delegate to service
+        ideas = self.ideas_service.generate_ideas(cluster_ids, account)
+        
+        # Serialize and return
+        serializer = ContentIdeasSerializer(ideas, many=True)
+        return Response(serializer.data)
+```
+
+#### Writer ViewSets Refactoring
+
+| ViewSet | Current | New | Risk |
+|---------|---------|-----|------|
+| **TasksViewSet** | Business logic in views | Delegate to services | LOW |
+| **ImagesViewSet** | Business logic in views | Delegate to services | LOW |
+
+**Before (Business Logic in ViewSet)**:
+```python
+# modules/writer/views.py
+class TasksViewSet(SiteSectorModelViewSet):
+    @action(detail=False, methods=['post'])
+    def auto_generate_content(self, request):
+        task_ids = request.data.get('task_ids')
+        # Business logic here (100+ lines)
+        tasks = Task.objects.filter(id__in=task_ids)
+        # AI call logic
+        # Content creation logic
+        # etc.
+        return Response(...)
+```
+
+**After (Delegate to Service)**:
+```python
+# modules/writer/views.py
+class TasksViewSet(SiteSectorModelViewSet):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.content_service = ContentGenerationService()
+    
+    @action(detail=False, methods=['post'])
+    def auto_generate_content(self, request):
+        task_ids = request.data.get('task_ids')
+        account = request.account
+        
+        # Delegate to service
+        contents = []
+        for task_id in task_ids:
+            task = Task.objects.get(id=task_id)
+            content = self.content_service.generate_content(task, account)
+            contents.append(content)
+        
+        # Serialize and return
+        serializer = ContentSerializer(contents, many=True)
+        return Response(serializer.data)
+```
+
+#### Billing ViewSets
+
+| ViewSet | Current | New | Risk |
+|---------|---------|-----|------|
+| **CreditTransactionViewSet** | Already uses CreditService | Keep as-is | NONE |
+| **CreditUsageLogViewSet** | Already uses CreditService | Keep as-is | NONE |
+
+**Note**: Billing ViewSets already use CreditService, so no changes needed.
+
+---
+
+## TESTING & VALIDATION
+
+### 1.5 Testing
+
+**Test Cases**:
+
+1. **Service Tests**:
+   - ✅ Services can be tested independently
+   - ✅ Services handle errors correctly
+   - ✅ Services check credits before operations
+   - ✅ Services deduct credits after operations
+
+2. **API Compatibility Tests**:
+   - ✅ All existing API endpoints work identically
+   - ✅ Response formats unchanged
+   - ✅ No breaking changes for frontend
+   - ✅ All ViewSet actions work correctly
+
+3. **Model Migration Tests**:
+   - ✅ Models work after migration
+   - ✅ All relationships preserved
+   - ✅ No data loss during migration
+   - ✅ All queries work correctly
+
+**Test Files to Create**:
+- `backend/tests/test_content_service.py`
+- `backend/tests/test_planning_service.py`
+- `backend/tests/test_ideas_service.py`
+- `backend/tests/test_viewset_refactoring.py`
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Create `domain/` folder structure
+- [ ] Create `domain/content/` folder
+- [ ] Create `domain/planning/` folder
+- [ ] Create `domain/billing/` folder (move existing)
+- [ ] Move Content models to `domain/content/models.py`
+- [ ] Move Planning models to `domain/planning/models.py`
+- [ ] Move Billing models to `domain/billing/models.py`
+- [ ] Create migrations for model moves
+- [ ] Create `ContentGenerationService`
+- [ ] Create `ClusteringService`
+- [ ] Create `IdeasService`
+- [ ] Refactor `KeywordViewSet` to use services
+- [ ] Refactor `ClusterViewSet` to use services
+- [ ] Refactor `ContentIdeasViewSet` to use services
+- [ ] Refactor `TasksViewSet` to use services
+- [ ] Refactor `ImagesViewSet` to use services
+- [ ] Update all imports
+- [ ] Test all API endpoints
+
+### Testing Tasks
+
+- [ ] Test all existing API endpoints work
+- [ ] Test response formats unchanged
+- [ ] Test services independently
+- [ ] Test model migrations
+- [ ] Test backward compatibility
+
+---
+
+## RISK ASSESSMENT
+
+| Risk | Level | Mitigation |
+|------|-------|------------|
+| **Breaking API changes** | MEDIUM | Extensive testing, keep response formats identical |
+| **Import errors** | MEDIUM | Update all imports systematically |
+| **Data loss during migration** | LOW | Backup before migration, test on staging |
+| **Service logic errors** | MEDIUM | Unit tests for all services |
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ All existing API endpoints work identically
+- ✅ Response formats unchanged
+- ✅ No breaking changes for frontend
+- ✅ Services are testable independently
+- ✅ Business logic extracted from ViewSets
+- ✅ ViewSets are thin wrappers
+- ✅ All models moved to domain layer
+
+---
+
+**END OF PHASE 1 DOCUMENT**
+

docs/planning/phases/PHASE-2-AUTOMATION-SYSTEM.md

@@ -0,0 +1,596 @@
+# PHASE 2: AUTOMATION SYSTEM
+**Detailed Implementation Plan**
+
+**Goal**: Implement automation rules and scheduled tasks.
+
+**Timeline**: 2-3 weeks  
+**Priority**: HIGH  
+**Dependencies**: Phase 1
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Automation Models](#automation-models)
+3. [Automation Service](#automation-service)
+4. [Celery Beat Tasks](#celery-beat-tasks)
+5. [Automation API](#automation-api)
+6. [Automation UI](#automation-ui)
+7. [Testing & Validation](#testing--validation)
+8. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Create AutomationRule and ScheduledTask models
+- ✅ Build AutomationService with rule execution engine
+- ✅ Implement Celery Beat scheduled tasks
+- ✅ Create automation API endpoints
+- ✅ Build automation UI (Dashboard, Rules, History)
+
+### Key Principles
+- **Rule-Based**: Users create rules with triggers, conditions, actions
+- **Scheduled Execution**: Rules can run on schedule or event triggers
+- **Credit-Aware**: Automation respects credit limits
+- **Audit Trail**: All automation executions logged
+
+---
+
+## AUTOMATION MODELS
+
+### 2.1 Automation Models
+
+**Purpose**: Store automation rules and scheduled task records.
+
+#### AutomationRule Model
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **AutomationRule Model** | `domain/automation/models.py` | Phase 1 | Create model with trigger, conditions, actions, schedule |
+
+**AutomationRule Model**:
+```python
+# domain/automation/models.py
+class AutomationRule(SiteSectorBaseModel):
+    name = models.CharField(max_length=255)
+    description = models.TextField(blank=True)
+    
+    # Trigger configuration
+    trigger = models.CharField(
+        max_length=50,
+        choices=[
+            ('schedule', 'Scheduled'),
+            ('keyword_added', 'Keyword Added'),
+            ('cluster_created', 'Cluster Created'),
+            ('idea_created', 'Idea Created'),
+            ('content_generated', 'Content Generated'),
+            ('task_created', 'Task Created'),
+        ]
+    )
+    
+    # Condition evaluation
+    conditions = models.JSONField(default=dict)
+    # Example: {'field': 'status', 'operator': 'eq', 'value': 'draft'}
+    
+    # Actions to execute
+    actions = models.JSONField(default=list)
+    # Example: [{'type': 'generate_ideas', 'params': {'cluster_ids': [1, 2]}}]
+    
+    # Schedule configuration (for scheduled triggers)
+    schedule = models.JSONField(default=dict)
+    # Example: {'cron': '0 9 * * *', 'timezone': 'UTC'}
+    
+    # Execution limits
+    is_active = models.BooleanField(default=True)
+    max_executions_per_day = models.IntegerField(default=10)
+    credit_limit_per_execution = models.IntegerField(default=100)
+    
+    # Tracking
+    last_executed_at = models.DateTimeField(null=True, blank=True)
+    execution_count_today = models.IntegerField(default=0)
+    last_reset_at = models.DateTimeField(auto_now_add=True)
+    
+    class Meta:
+        ordering = ['-created_at']
+```
+
+#### ScheduledTask Model
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **ScheduledTask Model** | `domain/automation/models.py` | Phase 1 | Create model to track scheduled executions |
+
+**ScheduledTask Model**:
+```python
+# domain/automation/models.py
+class ScheduledTask(SiteSectorBaseModel):
+    automation_rule = models.ForeignKey(AutomationRule, on_delete=models.CASCADE)
+    scheduled_at = models.DateTimeField()
+    executed_at = models.DateTimeField(null=True, blank=True)
+    status = models.CharField(
+        max_length=20,
+        choices=[
+            ('pending', 'Pending'),
+            ('running', 'Running'),
+            ('completed', 'Completed'),
+            ('failed', 'Failed'),
+            ('skipped', 'Skipped'),
+        ],
+        default='pending'
+    )
+    result = models.JSONField(default=dict, blank=True)
+    error_message = models.TextField(blank=True)
+    credits_used = models.IntegerField(default=0)
+    
+    class Meta:
+        ordering = ['-scheduled_at']
+```
+
+#### Automation Migrations
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Automation Migrations** | `domain/automation/migrations/` | Phase 1 | Create initial migrations |
+
+---
+
+## AUTOMATION SERVICE
+
+### 2.2 Automation Service
+
+**Purpose**: Execute automation rules with condition evaluation and action execution.
+
+#### AutomationService
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **AutomationService** | `domain/automation/services/automation_service.py` | Phase 1 services | Main service for rule execution |
+
+**AutomationService Methods**:
+```python
+# domain/automation/services/automation_service.py
+class AutomationService:
+    def __init__(self):
+        self.rule_engine = RuleEngine()
+        self.condition_evaluator = ConditionEvaluator()
+        self.action_executor = ActionExecutor()
+        self.credit_service = CreditService()
+    
+    def execute_rule(self, rule, context=None):
+        """Execute an automation rule"""
+        # Check if rule is active
+        if not rule.is_active:
+            return {'status': 'skipped', 'reason': 'Rule is inactive'}
+        
+        # Check execution limits
+        if not self._check_execution_limits(rule):
+            return {'status': 'skipped', 'reason': 'Execution limit reached'}
+        
+        # Check credits
+        if not self.credit_service.check_credits(rule.account, 'automation', rule.credit_limit_per_execution):
+            return {'status': 'skipped', 'reason': 'Insufficient credits'}
+        
+        # Evaluate conditions
+        if not self.condition_evaluator.evaluate(rule.conditions, context):
+            return {'status': 'skipped', 'reason': 'Conditions not met'}
+        
+        # Execute actions
+        results = self.action_executor.execute(rule.actions, context)
+        
+        # Update rule tracking
+        rule.last_executed_at = timezone.now()
+        rule.execution_count_today += 1
+        rule.save()
+        
+        return {'status': 'completed', 'results': results}
+    
+    def _check_execution_limits(self, rule):
+        """Check if rule can execute (daily limit)"""
+        # Reset counter if new day
+        if rule.last_reset_at.date() < timezone.now().date():
+            rule.execution_count_today = 0
+            rule.last_reset_at = timezone.now()
+            rule.save()
+        
+        return rule.execution_count_today < rule.max_executions_per_day
+```
+
+#### Rule Execution Engine
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Rule Execution Engine** | `domain/automation/services/rule_engine.py` | Phase 1 services | Orchestrates rule execution |
+
+**RuleEngine Methods**:
+```python
+# domain/automation/services/rule_engine.py
+class RuleEngine:
+    def execute_rule(self, rule, context):
+        """Orchestrate rule execution"""
+        # Validate rule
+        # Check conditions
+        # Execute actions
+        # Handle errors
+        pass
+```
+
+#### Condition Evaluator
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Condition Evaluator** | `domain/automation/services/condition_evaluator.py` | None | Evaluates rule conditions |
+
+**ConditionEvaluator Methods**:
+```python
+# domain/automation/services/condition_evaluator.py
+class ConditionEvaluator:
+    def evaluate(self, conditions, context):
+        """Evaluate rule conditions"""
+        # Support operators: eq, ne, gt, gte, lt, lte, in, contains
+        # Example: {'field': 'status', 'operator': 'eq', 'value': 'draft'}
+        pass
+```
+
+#### Action Executor
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Action Executor** | `domain/automation/services/action_executor.py` | Phase 1 services | Executes rule actions |
+
+**ActionExecutor Methods**:
+```python
+# domain/automation/services/action_executor.py
+class ActionExecutor:
+    def __init__(self):
+        self.clustering_service = ClusteringService()
+        self.ideas_service = IdeasService()
+        self.content_service = ContentGenerationService()
+    
+    def execute(self, actions, context):
+        """Execute rule actions"""
+        results = []
+        for action in actions:
+            action_type = action['type']
+            params = action.get('params', {})
+            
+            if action_type == 'generate_ideas':
+                result = self.ideas_service.generate_ideas(params['cluster_ids'], context['account'])
+            elif action_type == 'generate_content':
+                result = self.content_service.generate_content(params['task_id'], context['account'])
+            # ... other action types
+            
+            results.append(result)
+        
+        return results
+```
+
+---
+
+## CELERY BEAT TASKS
+
+### 2.3 Celery Beat Tasks
+
+**Purpose**: Schedule automation rules and monthly credit replenishment.
+
+#### Scheduled Automation Task
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Scheduled Automation Task** | `infrastructure/messaging/automation_tasks.py` | AutomationService | Periodic task to execute scheduled rules |
+
+**Scheduled Automation Task**:
+```python
+# infrastructure/messaging/automation_tasks.py
+from celery import shared_task
+from celery.schedules import crontab
+
+@shared_task
+def execute_scheduled_automation_rules():
+    """Execute all scheduled automation rules"""
+    from domain.automation.services.automation_service import AutomationService
+    
+    service = AutomationService()
+    rules = AutomationRule.objects.filter(
+        trigger='schedule',
+        is_active=True
+    )
+    
+    for rule in rules:
+        # Check if rule should execute based on schedule
+        if should_execute_now(rule.schedule):
+            service.execute_rule(rule)
+```
+
+#### Monthly Credit Replenishment
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Monthly Credit Replenishment** | `infrastructure/messaging/automation_tasks.py` | CreditService | Add credits monthly to accounts |
+
+**Monthly Credit Replenishment Task**:
+```python
+# infrastructure/messaging/automation_tasks.py
+@shared_task
+def replenish_monthly_credits():
+    """Replenish monthly credits for all active accounts"""
+    from domain.billing.services.credit_service import CreditService
+    
+    service = CreditService()
+    accounts = Account.objects.filter(status='active')
+    
+    for account in accounts:
+        if account.plan:
+            monthly_credits = account.plan.monthly_credits
+            if monthly_credits > 0:
+                service.add_credits(account, monthly_credits, 'monthly_replenishment')
+```
+
+#### Celery Beat Configuration
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Celery Beat Configuration** | `backend/igny8_core/celery.py` | None | Configure periodic tasks |
+
+**Celery Beat Configuration**:
+```python
+# backend/igny8_core/celery.py
+from celery.schedules import crontab
+
+app.conf.beat_schedule = {
+    'execute-scheduled-automation-rules': {
+        'task': 'infrastructure.messaging.automation_tasks.execute_scheduled_automation_rules',
+        'schedule': crontab(minute='*/15'),  # Every 15 minutes
+    },
+    'replenish-monthly-credits': {
+        'task': 'infrastructure.messaging.automation_tasks.replenish_monthly_credits',
+        'schedule': crontab(hour=0, minute=0, day_of_month=1),  # First day of month
+    },
+}
+```
+
+---
+
+## AUTOMATION API
+
+### 2.4 Automation API
+
+**Purpose**: CRUD API for automation rules and scheduled tasks.
+
+#### AutomationRule ViewSet
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **AutomationRule ViewSet** | `modules/automation/views.py` | AutomationService | CRUD operations for rules |
+
+**AutomationRule ViewSet**:
+```python
+# modules/automation/views.py
+class AutomationRuleViewSet(AccountModelViewSet):
+    queryset = AutomationRule.objects.all()
+    serializer_class = AutomationRuleSerializer
+    
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.automation_service = AutomationService()
+    
+    @action(detail=True, methods=['post'])
+    def execute(self, request, pk=None):
+        """Manually execute a rule"""
+        rule = self.get_object()
+        result = self.automation_service.execute_rule(rule, {'account': request.account})
+        return Response(result)
+    
+    @action(detail=True, methods=['post'])
+    def test(self, request, pk=None):
+        """Test rule conditions without executing"""
+        rule = self.get_object()
+        # Test condition evaluation
+        pass
+```
+
+#### ScheduledTask ViewSet
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **ScheduledTask ViewSet** | `modules/automation/views.py` | AutomationService | View scheduled task history |
+
+**ScheduledTask ViewSet**:
+```python
+# modules/automation/views.py
+class ScheduledTaskViewSet(AccountModelViewSet):
+    queryset = ScheduledTask.objects.all()
+    serializer_class = ScheduledTaskSerializer
+    filterset_fields = ['status', 'automation_rule']
+    ordering = ['-scheduled_at']
+```
+
+#### Automation URLs
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Automation URLs** | `modules/automation/urls.py` | None | Register automation routes |
+
+**Automation URLs**:
+```python
+# modules/automation/urls.py
+from rest_framework.routers import DefaultRouter
+from .views import AutomationRuleViewSet, ScheduledTaskViewSet
+
+router = DefaultRouter()
+router.register(r'rules', AutomationRuleViewSet, basename='automation-rule')
+router.register(r'scheduled-tasks', ScheduledTaskViewSet, basename='scheduled-task')
+
+urlpatterns = router.urls
+```
+
+---
+
+## AUTOMATION UI
+
+### 2.5 Automation UI
+
+**Purpose**: User interface for managing automation rules and viewing history.
+
+#### Automation Dashboard
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Automation Dashboard** | `frontend/src/pages/Automation/Dashboard.tsx` | EXISTING (placeholder) | Overview of automation status |
+
+**Dashboard Features**:
+- Active rules count
+- Recent executions
+- Success/failure rates
+- Credit usage from automation
+- Quick actions (create rule, view history)
+
+#### Rules Management
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Rules Management** | `frontend/src/pages/Automation/Rules.tsx` | NEW | CRUD interface for rules |
+
+**Rules Management Features**:
+- List all rules
+- Create new rule (wizard)
+- Edit existing rule
+- Enable/disable rule
+- Delete rule
+- Test rule
+- Manual execution
+
+#### Schedules Page
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Schedules Page** | `frontend/src/pages/Schedules.tsx` | EXISTING (placeholder) | View scheduled task history |
+
+**Schedules Page Features**:
+- List scheduled tasks
+- Filter by status, rule, date
+- View execution results
+- View error messages
+- Retry failed tasks
+
+#### Automation API Client
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Automation API Client** | `frontend/src/services/automation.api.ts` | NEW | API client for automation endpoints |
+
+**Automation API Client**:
+```typescript
+// frontend/src/services/automation.api.ts
+export const automationApi = {
+  getRules: () => fetchAPI('/automation/rules/'),
+  createRule: (data) => fetchAPI('/automation/rules/', { method: 'POST', body: data }),
+  updateRule: (id, data) => fetchAPI(`/automation/rules/${id}/`, { method: 'PUT', body: data }),
+  deleteRule: (id) => fetchAPI(`/automation/rules/${id}/`, { method: 'DELETE' }),
+  executeRule: (id) => fetchAPI(`/automation/rules/${id}/execute/`, { method: 'POST' }),
+  getScheduledTasks: (filters) => fetchAPI('/automation/scheduled-tasks/', { params: filters }),
+};
+```
+
+---
+
+## TESTING & VALIDATION
+
+### 2.6 Testing
+
+**Test Cases**:
+
+1. **Automation Service Tests**:
+   - ✅ Rules execute correctly
+   - ✅ Conditions evaluate correctly
+   - ✅ Actions execute correctly
+   - ✅ Execution limits enforced
+   - ✅ Credit checks work
+
+2. **Scheduled Tasks Tests**:
+   - ✅ Scheduled tasks run on time
+   - ✅ Credit replenishment works monthly
+   - ✅ Task status tracking works
+
+3. **API Tests**:
+   - ✅ CRUD operations work
+   - ✅ Rule execution endpoint works
+   - ✅ Scheduled task history works
+
+4. **UI Tests**:
+   - ✅ Dashboard displays correctly
+   - ✅ Rules management works
+   - ✅ Schedule history displays correctly
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Create `domain/automation/models.py`
+- [ ] Create AutomationRule model
+- [ ] Create ScheduledTask model
+- [ ] Create automation migrations
+- [ ] Create `domain/automation/services/automation_service.py`
+- [ ] Create `domain/automation/services/rule_engine.py`
+- [ ] Create `domain/automation/services/condition_evaluator.py`
+- [ ] Create `domain/automation/services/action_executor.py`
+- [ ] Create `infrastructure/messaging/automation_tasks.py`
+- [ ] Add scheduled automation task
+- [ ] Add monthly credit replenishment task
+- [ ] Configure Celery Beat
+- [ ] Create `modules/automation/views.py`
+- [ ] Create AutomationRule ViewSet
+- [ ] Create ScheduledTask ViewSet
+- [ ] Create `modules/automation/serializers.py`
+- [ ] Create `modules/automation/urls.py`
+- [ ] Register automation URLs in main urls.py
+
+### Frontend Tasks
+
+- [ ] Implement `frontend/src/pages/Automation/Dashboard.tsx`
+- [ ] Create `frontend/src/pages/Automation/Rules.tsx`
+- [ ] Implement `frontend/src/pages/Schedules.tsx`
+- [ ] Create `frontend/src/services/automation.api.ts`
+- [ ] Create rule creation wizard
+- [ ] Create rule editor
+- [ ] Create schedule history table
+
+### Testing Tasks
+
+- [ ] Test automation rule execution
+- [ ] Test scheduled tasks
+- [ ] Test credit replenishment
+- [ ] Test API endpoints
+- [ ] Test UI components
+
+---
+
+## RISK ASSESSMENT
+
+| Risk | Level | Mitigation |
+|------|-------|------------|
+| **Rule execution errors** | MEDIUM | Comprehensive error handling, logging |
+| **Credit limit violations** | MEDIUM | Credit checks before execution |
+| **Scheduled task failures** | MEDIUM | Retry mechanism, error logging |
+| **Performance issues** | LOW | Background processing, rate limiting |
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ Automation rules execute correctly
+- ✅ Scheduled tasks run on time
+- ✅ Credit replenishment works monthly
+- ✅ UI shows automation status
+- ✅ Rules can be created, edited, deleted
+- ✅ Execution history is tracked
+- ✅ All automation respects credit limits
+
+---
+
+**END OF PHASE 2 DOCUMENT**
+

docs/planning/phases/PHASE-3-SITE-BUILDER.md

@@ -0,0 +1,642 @@
+# PHASE 3: SITE BUILDER
+**Detailed Implementation Plan**
+
+**Goal**: Build Site Builder for creating sites via wizard.
+
+**Timeline**: 3-4 weeks  
+**Priority**: HIGH  
+**Dependencies**: Phase 1, Phase 2
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Sites Folder Access & File Management](#sites-folder-access--file-management)
+3. [Site Builder Models](#site-builder-models)
+4. [Site Structure Generation](#site-structure-generation)
+5. [Site Builder API](#site-builder-api)
+6. [Site Builder Frontend](#site-builder-frontend)
+7. [Global Component Library](#global-component-library)
+8. [Page Generation](#page-generation)
+9. [Testing & Validation](#testing--validation)
+10. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Create Site Builder wizard for site creation
+- ✅ Generate site structure using AI
+- ✅ Build preview canvas for site editing
+- ✅ Create shared component library
+- ✅ Support multiple layouts and templates
+- ✅ Enable file management for site assets
+
+### Key Principles
+- **Wizard-Based**: Step-by-step site creation process
+- **AI-Powered**: AI generates site structure from business brief
+- **Component Reuse**: Shared components across Site Builder, Sites Renderer, Main App
+- **User-Friendly**: "Website Builder" or "Site Creator" in UI
+
+---
+
+## SITES FOLDER ACCESS & FILE MANAGEMENT
+
+### 3.0 Sites Folder Access & File Management
+
+**Purpose**: Manage site files and assets with proper access control.
+
+#### Sites Folder Structure
+
+```
+/data/app/sites-data/
+└── clients/
+    └── {site_id}/
+        └── v{version}/
+            ├── site.json              # Site definition
+            ├── pages/                 # Page definitions
+            │   ├── home.json
+            │   ├── about.json
+            │   └── ...
+            └── assets/                # User-managed files
+                ├── images/
+                ├── documents/
+                └── media/
+```
+
+#### User Access Rules
+
+- **Owner/Admin**: Full access to all account sites
+- **Editor**: Access to granted sites (via SiteUserAccess)
+- **Viewer**: Read-only access to granted sites
+- **File operations**: Scoped to user's accessible sites only
+
+#### Site File Management Service
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site File Management Service** | `domain/site_building/services/file_management_service.py` | Phase 1 | File upload, delete, organize |
+
+**FileManagementService**:
+```python
+# domain/site_building/services/file_management_service.py
+class SiteBuilderFileService:
+    def get_user_accessible_sites(self, user):
+        """Get sites user can access for file management"""
+        if user.is_owner_or_admin():
+            return Site.objects.filter(account=user.account)
+        return user.get_accessible_sites()
+    
+    def get_site_files_path(self, site_id, version=1):
+        """Get site's files directory"""
+        return f"/data/app/sites-data/clients/{site_id}/v{version}/assets/"
+    
+    def check_file_access(self, user, site_id):
+        """Check if user can access site's files"""
+        accessible_sites = self.get_user_accessible_sites(user)
+        return any(site.id == site_id for site in accessible_sites)
+    
+    def upload_file(self, user, site_id, file, folder='images'):
+        """Upload file to site's assets folder"""
+        if not self.check_file_access(user, site_id):
+            raise PermissionDenied("No access to this site")
+        
+        # Check storage quota
+        if not self.check_storage_quota(site_id, file.size):
+            raise ValidationError("Storage quota exceeded")
+        
+        # Upload file
+        file_path = self._save_file(site_id, file, folder)
+        return file_path
+```
+
+#### File Upload API
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **File Upload API** | `modules/site_builder/views.py` | File Management Service | Handle file uploads |
+
+#### File Browser UI
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **File Browser UI** | `site-builder/src/components/files/FileBrowser.tsx` | NEW | File browser component |
+
+#### Storage Quota Check
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Storage Quota Check** | `infrastructure/storage/file_storage.py` | Phase 1 | Check site storage quota |
+
+---
+
+## SITE BUILDER MODELS
+
+### 3.1 Site Builder Models
+
+**Purpose**: Store site blueprints and page definitions.
+
+#### SiteBlueprint Model
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **SiteBlueprint Model** | `domain/site_building/models.py` | Phase 1 | Store site structure |
+
+**SiteBlueprint Model**:
+```python
+# domain/site_building/models.py
+class SiteBlueprint(SiteSectorBaseModel):
+    name = models.CharField(max_length=255)
+    description = models.TextField(blank=True)
+    
+    # Site configuration
+    config_json = models.JSONField(default=dict)
+    # Example: {'business_type': 'ecommerce', 'style': 'modern'}
+    
+    # Generated structure
+    structure_json = models.JSONField(default=dict)
+    # Example: {'pages': [...], 'layout': 'default', 'theme': {...}}
+    
+    # Status tracking
+    status = models.CharField(
+        max_length=20,
+        choices=[
+            ('draft', 'Draft'),
+            ('generating', 'Generating'),
+            ('ready', 'Ready'),
+            ('deployed', 'Deployed'),
+        ],
+        default='draft'
+    )
+    
+    # Hosting configuration
+    hosting_type = models.CharField(
+        max_length=50,
+        choices=[
+            ('igny8_sites', 'IGNY8 Sites'),
+            ('wordpress', 'WordPress'),
+            ('shopify', 'Shopify'),
+            ('multi', 'Multiple Destinations'),
+        ],
+        default='igny8_sites'
+    )
+    
+    # Version tracking
+    version = models.IntegerField(default=1)
+    deployed_version = models.IntegerField(null=True, blank=True)
+    
+    class Meta:
+        ordering = ['-created_at']
+```
+
+#### PageBlueprint Model
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **PageBlueprint Model** | `domain/site_building/models.py` | Phase 1 | Store page definitions |
+
+**PageBlueprint Model**:
+```python
+# domain/site_building/models.py
+class PageBlueprint(SiteSectorBaseModel):
+    site_blueprint = models.ForeignKey(SiteBlueprint, on_delete=models.CASCADE, related_name='pages')
+    slug = models.SlugField(max_length=255)
+    title = models.CharField(max_length=255)
+    
+    # Page type
+    type = models.CharField(
+        max_length=50,
+        choices=[
+            ('home', 'Home'),
+            ('about', 'About'),
+            ('services', 'Services'),
+            ('products', 'Products'),
+            ('blog', 'Blog'),
+            ('contact', 'Contact'),
+            ('custom', 'Custom'),
+        ]
+    )
+    
+    # Page content (blocks)
+    blocks_json = models.JSONField(default=list)
+    # Example: [{'type': 'hero', 'data': {...}}, {'type': 'features', 'data': {...}}]
+    
+    # Status
+    status = models.CharField(
+        max_length=20,
+        choices=[
+            ('draft', 'Draft'),
+            ('generating', 'Generating'),
+            ('ready', 'Ready'),
+        ],
+        default='draft'
+    )
+    
+    # Order
+    order = models.IntegerField(default=0)
+    
+    class Meta:
+        ordering = ['order', 'created_at']
+        unique_together = [['site_blueprint', 'slug']]
+```
+
+#### Site Builder Migrations
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Builder Migrations** | `domain/site_building/migrations/` | Phase 1 | Create initial migrations |
+
+---
+
+## SITE STRUCTURE GENERATION
+
+### 3.2 Site Structure Generation
+
+**Purpose**: Use AI to generate site structure from business brief.
+
+#### Structure Generation AI Function
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Structure Generation AI Function** | `infrastructure/ai/functions/generate_site_structure.py` | Existing AI framework | AI function for structure generation |
+
+**GenerateSiteStructureFunction**:
+```python
+# infrastructure/ai/functions/generate_site_structure.py
+class GenerateSiteStructureFunction(BaseAIFunction):
+    def get_operation_type(self):
+        return 'site_structure_generation'
+    
+    def get_estimated_cost(self, payload):
+        return CREDIT_COSTS['site_structure_generation']
+    
+    def execute(self, payload, account):
+        """Generate site structure from business brief"""
+        business_brief = payload['business_brief']
+        objectives = payload.get('objectives', [])
+        style_preferences = payload.get('style', {})
+        
+        # Build prompt
+        prompt = self._build_prompt(business_brief, objectives, style_preferences)
+        
+        # Call AI
+        response = self.ai_core.generate(prompt, model='gpt-4')
+        
+        # Parse response to structure JSON
+        structure = self._parse_structure(response)
+        
+        return structure
+```
+
+#### Structure Generation Service
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Structure Generation Service** | `domain/site_building/services/structure_generation_service.py` | Phase 1, AI framework | Service to generate site structure |
+
+**StructureGenerationService**:
+```python
+# domain/site_building/services/structure_generation_service.py
+class StructureGenerationService:
+    def __init__(self):
+        self.ai_function = GenerateSiteStructureFunction()
+        self.credit_service = CreditService()
+    
+    def generate_structure(self, site_blueprint, business_brief, objectives, style):
+        """Generate site structure for blueprint"""
+        account = site_blueprint.account
+        
+        # Check credits
+        self.credit_service.check_credits(account, 'site_structure_generation')
+        
+        # Update status
+        site_blueprint.status = 'generating'
+        site_blueprint.save()
+        
+        # Generate structure
+        payload = {
+            'business_brief': business_brief,
+            'objectives': objectives,
+            'style': style,
+        }
+        structure = self.ai_function.execute(payload, account)
+        
+        # Deduct credits
+        self.credit_service.deduct_credits(account, 'site_structure_generation')
+        
+        # Update blueprint
+        site_blueprint.structure_json = structure
+        site_blueprint.status = 'ready'
+        site_blueprint.save()
+        
+        # Create page blueprints
+        self._create_page_blueprints(site_blueprint, structure)
+        
+        return site_blueprint
+```
+
+#### Site Structure Prompts
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Structure Prompts** | `infrastructure/ai/prompts.py` | Existing prompt system | Add site structure prompts |
+
+---
+
+## SITE BUILDER API
+
+### 3.3 Site Builder API
+
+**Purpose**: API endpoints for site builder operations.
+
+#### Site Builder ViewSet
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Builder ViewSet** | `modules/site_builder/views.py` | Structure Generation Service | CRUD operations for site blueprints |
+
+**SiteBuilderViewSet**:
+```python
+# modules/site_builder/views.py
+class SiteBuilderViewSet(AccountModelViewSet):
+    queryset = SiteBlueprint.objects.all()
+    serializer_class = SiteBlueprintSerializer
+    
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.structure_service = StructureGenerationService()
+    
+    @action(detail=True, methods=['post'])
+    def generate_structure(self, request, pk=None):
+        """Generate site structure"""
+        blueprint = self.get_object()
+        business_brief = request.data.get('business_brief')
+        objectives = request.data.get('objectives', [])
+        style = request.data.get('style', {})
+        
+        blueprint = self.structure_service.generate_structure(
+            blueprint, business_brief, objectives, style
+        )
+        
+        serializer = self.get_serializer(blueprint)
+        return Response(serializer.data)
+```
+
+#### Site Builder URLs
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Builder URLs** | `modules/site_builder/urls.py` | None | Register site builder routes |
+
+#### Site Builder Serializers
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Builder Serializers** | `modules/site_builder/serializers.py` | None | Serializers for SiteBlueprint and PageBlueprint |
+
+---
+
+## SITE BUILDER FRONTEND
+
+### 3.4 Site Builder Frontend (New Container)
+
+**User-Friendly Name**: "Website Builder" or "Site Creator"
+
+#### Create Site Builder Container
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Create Site Builder Container** | `docker-compose.app.yml` | None | Add new container for site builder |
+
+**Docker Compose Configuration**:
+```yaml
+# docker-compose.app.yml
+igny8_site_builder:
+  build: ./site-builder
+  ports:
+    - "8022:5175"
+  volumes:
+    - /data/app/igny8/site-builder:/app
+  environment:
+    - VITE_API_URL=http://igny8_backend:8010
+```
+
+#### Wizard Steps
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Wizard Steps** | `site-builder/src/pages/wizard/` | NEW | Step-by-step wizard components |
+
+**Wizard Steps**:
+- Step 1: Type Selection (Business type, industry)
+- Step 2: Business Brief (Description, goals)
+- Step 3: Objectives (What pages needed)
+- Step 4: Style Preferences (Colors, fonts, layout)
+
+#### Preview Canvas
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Preview Canvas** | `site-builder/src/pages/preview/` | NEW | Live preview of site |
+
+#### Site Builder State
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Builder State** | `site-builder/src/state/builderStore.ts` | NEW | Zustand store for builder state |
+
+#### Site Builder API Client
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Builder API Client** | `site-builder/src/api/builder.api.ts` | NEW | API client for site builder |
+
+#### Layout Selection
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Layout Selection** | `site-builder/src/components/layouts/` | NEW | Layout selector component |
+
+#### Template Library
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Template Library** | `site-builder/src/components/templates/` | NEW | Template selector component |
+
+#### Block Components
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Block Components** | `site-builder/src/components/blocks/` | NEW | Block components (imports from shared) |
+
+---
+
+## GLOBAL COMPONENT LIBRARY
+
+### 3.7 Global Component Library
+
+**Purpose**: Shared components across Site Builder, Sites Renderer, and Main App.
+
+#### Create Shared Component Library
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Create Shared Component Library** | `frontend/src/components/shared/` | None | Create shared component structure |
+
+**Component Library Structure**:
+```
+frontend/src/components/shared/
+├── blocks/
+│   ├── Hero.tsx
+│   ├── Features.tsx
+│   ├── Services.tsx
+│   ├── Products.tsx
+│   ├── Testimonials.tsx
+│   ├── ContactForm.tsx
+│   └── ...
+├── layouts/
+│   ├── DefaultLayout.tsx
+│   ├── MinimalLayout.tsx
+│   ├── MagazineLayout.tsx
+│   ├── EcommerceLayout.tsx
+│   ├── PortfolioLayout.tsx
+│   ├── BlogLayout.tsx
+│   └── CorporateLayout.tsx
+└── templates/
+    ├── BlogTemplate.tsx
+    ├── BusinessTemplate.tsx
+    ├── PortfolioTemplate.tsx
+    └── ...
+```
+
+**Usage**: Site Builder, Sites Renderer, and Main App all use same components (no duplicates)
+
+#### Component Documentation
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Component Documentation** | `frontend/src/components/shared/README.md` | None | Document all shared components |
+
+---
+
+## PAGE GENERATION
+
+### 3.5 Page Generation (Reuse Content Service)
+
+**Purpose**: Generate page content using existing ContentService.
+
+#### Extend ContentService
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Extend ContentService** | `domain/content/services/content_generation_service.py` | Phase 1 | Add site page generation method |
+
+#### Add Site Page Type
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Add Site Page Type** | `domain/content/models.py` | Phase 1 | Add site page content type |
+
+#### Page Generation Prompts
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Page Generation Prompts** | `infrastructure/ai/prompts.py` | Existing prompt system | Add page generation prompts |
+
+---
+
+## TESTING & VALIDATION
+
+### 3.6 Testing
+
+**Test Cases**:
+
+1. **Site Builder Tests**:
+   - ✅ Site Builder wizard works end-to-end
+   - ✅ Structure generation creates valid blueprints
+   - ✅ Preview renders correctly
+   - ✅ Page generation reuses existing content service
+
+2. **File Management Tests**:
+   - ✅ File upload works
+   - ✅ File access control works
+   - ✅ Storage quota enforced
+
+3. **Component Library Tests**:
+   - ✅ Components render correctly
+   - ✅ Components work in Site Builder
+   - ✅ Components work in Sites Renderer
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Create `domain/site_building/models.py`
+- [ ] Create SiteBlueprint model
+- [ ] Create PageBlueprint model
+- [ ] Create site builder migrations
+- [ ] Create `domain/site_building/services/file_management_service.py`
+- [ ] Create `domain/site_building/services/structure_generation_service.py`
+- [ ] Create `infrastructure/ai/functions/generate_site_structure.py`
+- [ ] Add site structure prompts
+- [ ] Create `modules/site_builder/views.py`
+- [ ] Create SiteBuilder ViewSet
+- [ ] Create `modules/site_builder/serializers.py`
+- [ ] Create `modules/site_builder/urls.py`
+- [ ] Extend ContentService for page generation
+
+### Frontend Tasks
+
+- [ ] Create `site-builder/` folder structure
+- [ ] Create Site Builder container in docker-compose
+- [ ] Create wizard steps
+- [ ] Create preview canvas
+- [ ] Create builder state store
+- [ ] Create API client
+- [ ] Create layout selector
+- [ ] Create template library
+- [ ] Create `frontend/src/components/shared/` structure
+- [ ] Create block components
+- [ ] Create layout components
+- [ ] Create template components
+- [ ] Create component documentation
+
+### Testing Tasks
+
+- [ ] Test site builder wizard
+- [ ] Test structure generation
+- [ ] Test file management
+- [ ] Test component library
+- [ ] Test page generation
+
+---
+
+## RISK ASSESSMENT
+
+| Risk | Level | Mitigation |
+|------|-------|------------|
+| **AI structure generation quality** | MEDIUM | Prompt engineering, validation |
+| **Component compatibility** | MEDIUM | Shared component library, testing |
+| **File management security** | MEDIUM | Access control, validation |
+| **Performance with large sites** | LOW | Optimization, caching |
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ Site Builder wizard works end-to-end
+- ✅ Structure generation creates valid blueprints
+- ✅ Preview renders correctly
+- ✅ Page generation reuses existing content service
+- ✅ File management works correctly
+- ✅ Shared components work across all apps
+- ✅ Multiple layouts supported
+
+---
+
+**END OF PHASE 3 DOCUMENT**
+

docs/planning/phases/PHASE-4-LINKER-OPTIMIZER.md

@@ -0,0 +1,391 @@
+# PHASE 4: LINKER & OPTIMIZER
+**Detailed Implementation Plan**
+
+**Goal**: Add linking and optimization as post-processing stages with multiple entry points.
+
+**Timeline**: 4-5 weeks  
+**Priority**: MEDIUM  
+**Dependencies**: Phase 1
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Content Workflow & Entry Points](#content-workflow--entry-points)
+3. [Content Model Extensions](#content-model-extensions)
+4. [Linker Implementation](#linker-implementation)
+5. [Optimizer Implementation](#optimizer-implementation)
+6. [Content Pipeline Service](#content-pipeline-service)
+7. [Linker & Optimizer APIs](#linker--optimizer-apis)
+8. [Linker & Optimizer UI](#linker--optimizer-ui)
+9. [Testing & Validation](#testing--validation)
+10. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Add internal linking to content
+- ✅ Add content optimization
+- ✅ Support multiple entry points (Writer, WordPress Sync, 3rd Party, Manual)
+- ✅ Create content pipeline service
+- ✅ Build UI for linker and optimizer
+
+### Key Principles
+- **Multiple Entry Points**: Optimizer works from any content source
+- **Unified Content Model**: All content stored in same model with source tracking
+- **Pipeline Orchestration**: Linker → Optimizer → Publish workflow
+- **Source Agnostic**: Optimizer works on any content regardless of source
+
+---
+
+## CONTENT WORKFLOW & ENTRY POINTS
+
+### 4.0 Content Workflow & Entry Points
+
+**Content Sources**:
+1. **IGNY8 Generated** - Content created via Writer module
+2. **WordPress Synced** - Content synced from WordPress via plugin
+3. **3rd Party Synced** - Content synced from external sources (Shopify, custom APIs)
+
+**Workflow Entry Points**:
+```
+Entry Point 1: Writer → Linker → Optimizer → Publish
+Entry Point 2: WordPress Sync → Optimizer → Publish
+Entry Point 3: 3rd Party Sync → Optimizer → Publish
+Entry Point 4: Manual Selection → Linker/Optimizer
+```
+
+**Content Storage Strategy**:
+- All content stored in unified `Content` model
+- `source` field: `'igny8'`, `'wordpress'`, `'shopify'`, `'custom'`
+- `sync_status` field: `'native'`, `'imported'`, `'synced'`
+
+---
+
+## CONTENT MODEL EXTENSIONS
+
+### 4.1 Content Model Extensions
+
+**Purpose**: Add fields to track content source and sync status.
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Add source field** | `domain/content/models.py` | Phase 1 | Track content source |
+| **Add sync_status field** | `domain/content/models.py` | Phase 1 | Track sync status |
+| **Add external_id field** | `domain/content/models.py` | Phase 1 | Store external platform ID |
+| **Add sync_metadata field** | `domain/content/models.py` | Phase 1 | Store platform-specific metadata |
+
+**Content Model Extensions**:
+```python
+# domain/content/models.py
+class Content(SiteSectorBaseModel):
+    # Existing fields...
+    
+    # NEW: Source tracking
+    source = models.CharField(
+        max_length=50,
+        choices=[
+            ('igny8', 'IGNY8 Generated'),
+            ('wordpress', 'WordPress Synced'),
+            ('shopify', 'Shopify Synced'),
+            ('custom', 'Custom API Synced'),
+        ],
+        default='igny8'
+    )
+    
+    # NEW: Sync status
+    sync_status = models.CharField(
+        max_length=50,
+        choices=[
+            ('native', 'Native IGNY8 Content'),
+            ('imported', 'Imported from External'),
+            ('synced', 'Synced from External'),
+        ],
+        default='native'
+    )
+    
+    # NEW: External reference
+    external_id = models.CharField(max_length=255, blank=True, null=True)
+    external_url = models.URLField(blank=True, null=True)
+    sync_metadata = models.JSONField(default=dict)
+    
+    # NEW: Linking fields
+    internal_links = models.JSONField(default=list)
+    linker_version = models.IntegerField(default=0)
+    
+    # NEW: Optimization fields
+    optimizer_version = models.IntegerField(default=0)
+    optimization_scores = models.JSONField(default=dict)
+```
+
+---
+
+## LINKER IMPLEMENTATION
+
+### 4.2 Linker Models
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **InternalLink Model** | `domain/linking/models.py` | Phase 1 | Store link relationships |
+| **LinkGraph Model** | `domain/linking/models.py` | Phase 1 | Store link graph |
+
+### 4.3 Linker Service
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **LinkerService** | `domain/linking/services/linker_service.py` | Phase 1, ContentService | Main linking service |
+| **Link Candidate Engine** | `domain/linking/services/candidate_engine.py` | Phase 1 | Find link candidates |
+| **Link Injection Engine** | `domain/linking/services/injection_engine.py` | Phase 1 | Inject links into content |
+
+**LinkerService**:
+```python
+# domain/linking/services/linker_service.py
+class LinkerService:
+    def process(self, content_id):
+        """Process content for linking"""
+        content = Content.objects.get(id=content_id)
+        
+        # Check credits
+        credit_service.check_credits(content.account, 'linking')
+        
+        # Find link candidates
+        candidates = self.candidate_engine.find_candidates(content)
+        
+        # Inject links
+        linked_content = self.injection_engine.inject_links(content, candidates)
+        
+        # Update content
+        content.internal_links = linked_content['links']
+        content.linker_version += 1
+        content.save()
+        
+        # Deduct credits
+        credit_service.deduct_credits(content.account, 'linking')
+        
+        return content
+```
+
+---
+
+## OPTIMIZER IMPLEMENTATION
+
+### 4.5 Optimizer Models
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **OptimizationTask Model** | `domain/optimization/models.py` | Phase 1 | Store optimization results |
+| **OptimizationScores Model** | `domain/optimization/models.py` | Phase 1 | Store optimization scores |
+
+### 4.6 Optimizer Service (Multiple Entry Points)
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **OptimizerService** | `domain/optimization/services/optimizer_service.py` | Phase 1, ContentService | Main optimization service |
+| **Content Analyzer** | `domain/optimization/services/analyzer.py` | Phase 1 | Analyze content quality |
+| **Optimization AI Function** | `infrastructure/ai/functions/optimize_content.py` | Existing AI framework | AI optimization function |
+
+**OptimizerService**:
+```python
+# domain/optimization/services/optimizer_service.py
+class OptimizerService:
+    def optimize_from_writer(self, content_id):
+        """Entry Point 1: Writer → Optimizer"""
+        content = Content.objects.get(id=content_id, source='igny8')
+        return self.optimize(content)
+    
+    def optimize_from_wordpress_sync(self, content_id):
+        """Entry Point 2: WordPress Sync → Optimizer"""
+        content = Content.objects.get(id=content_id, source='wordpress')
+        return self.optimize(content)
+    
+    def optimize_from_external_sync(self, content_id):
+        """Entry Point 3: External Sync → Optimizer"""
+        content = Content.objects.get(id=content_id, source__in=['shopify', 'custom'])
+        return self.optimize(content)
+    
+    def optimize_manual(self, content_id):
+        """Entry Point 4: Manual Selection → Optimizer"""
+        content = Content.objects.get(id=content_id)
+        return self.optimize(content)
+    
+    def optimize(self, content):
+        """Unified optimization logic"""
+        # Check credits
+        credit_service.check_credits(content.account, 'optimization', content.word_count)
+        
+        # Analyze content
+        scores_before = self.analyzer.analyze(content)
+        
+        # Optimize content
+        optimized = self.ai_function.optimize(content)
+        
+        # Analyze optimized content
+        scores_after = self.analyzer.analyze(optimized)
+        
+        # Store optimization task
+        OptimizationTask.objects.create(
+            content=content,
+            scores_before=scores_before,
+            scores_after=scores_after,
+            html_before=content.html_content,
+            html_after=optimized['html_content'],
+        )
+        
+        # Update content
+        content.optimizer_version += 1
+        content.optimization_scores = scores_after
+        content.save()
+        
+        # Deduct credits
+        credit_service.deduct_credits(content.account, 'optimization', content.word_count)
+        
+        return content
+```
+
+---
+
+## CONTENT PIPELINE SERVICE
+
+### 4.7 Content Pipeline Service
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **ContentPipelineService** | `domain/content/services/content_pipeline_service.py` | LinkerService, OptimizerService | Orchestrate content pipeline |
+
+**Pipeline Workflow States**:
+```
+Content States:
+- 'draft' → Generated, not processed
+- 'linked' → Links added, ready for optimization
+- 'optimized' → Optimized, ready for review
+- 'review' → Ready for publishing
+- 'published' → Published to destination(s)
+```
+
+**ContentPipelineService**:
+```python
+# domain/content/services/content_pipeline_service.py
+class ContentPipelineService:
+    def process_writer_content(self, content_id, stages=['linking', 'optimization']):
+        """Writer → Linker → Optimizer pipeline"""
+        content = Content.objects.get(id=content_id, source='igny8')
+        
+        if 'linking' in stages:
+            content = linker_service.process(content.id)
+        
+        if 'optimization' in stages:
+            content = optimizer_service.optimize_from_writer(content.id)
+        
+        return content
+    
+    def process_synced_content(self, content_id, stages=['optimization']):
+        """Synced Content → Optimizer (skip linking if needed)"""
+        content = Content.objects.get(id=content_id)
+        
+        if 'optimization' in stages:
+            content = optimizer_service.optimize_manual(content.id)
+        
+        return content
+```
+
+---
+
+## LINKER & OPTIMIZER APIs
+
+### 4.8 Linker & Optimizer APIs
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Linker ViewSet** | `modules/linker/views.py` | LinkerService | API for linker operations |
+| **Optimizer ViewSet** | `modules/optimizer/views.py` | OptimizerService | API for optimizer operations |
+
+---
+
+## LINKER & OPTIMIZER UI
+
+### 4.9 Linker & Optimizer UI
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Linker Dashboard** | `frontend/src/pages/Linker/Dashboard.tsx` | NEW | Linker overview |
+| **Optimizer Dashboard** | `frontend/src/pages/Optimizer/Dashboard.tsx` | NEW | Optimizer overview |
+| **Content Selection UI** | `frontend/src/components/optimizer/ContentSelector.tsx` | NEW | Select content for optimization |
+| **Source Badge Component** | `frontend/src/components/content/SourceBadge.tsx` | NEW | Show content source |
+
+**Optimizer UI Features**:
+- Show content source (IGNY8, WordPress, Shopify badge)
+- Show sync status (Native, Synced, Imported badge)
+- Entry point selection (from Writer, from Sync, Manual)
+- Content list with source filters
+- "Send to Optimizer" button (works for any source)
+
+### 4.10 Content Filtering & Display
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Content Filter Component** | `frontend/src/components/content/ContentFilter.tsx` | NEW | Filter content by source |
+| **Source Filter** | `frontend/src/components/content/SourceFilter.tsx` | NEW | Filter by source |
+| **Sync Status Filter** | `frontend/src/components/content/SyncStatusFilter.tsx` | NEW | Filter by sync status |
+
+---
+
+## TESTING & VALIDATION
+
+### 4.11 Testing
+
+**Test Cases**:
+- ✅ Writer → Linker handover works
+- ✅ Linker finds appropriate link candidates
+- ✅ Links inject correctly into content
+- ✅ Optimizer works from Writer entry point
+- ✅ Optimizer works from WordPress sync entry point
+- ✅ Optimizer works from 3rd party sync entry point
+- ✅ Optimizer works from manual selection
+- ✅ Synced content stored correctly with source flags
+- ✅ Content filtering works (by source, sync_status)
+- ✅ Pipeline orchestrates correctly
+- ✅ All entry points use same optimization logic
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Extend Content model with source/sync fields
+- [ ] Create `domain/linking/models.py`
+- [ ] Create LinkerService
+- [ ] Create `domain/optimization/models.py`
+- [ ] Create OptimizerService
+- [ ] Create optimization AI function
+- [ ] Create ContentPipelineService
+- [ ] Create Linker ViewSet
+- [ ] Create Optimizer ViewSet
+- [ ] Create content sync service (for Phase 6)
+
+### Frontend Tasks
+
+- [ ] Create Linker Dashboard
+- [ ] Create Optimizer Dashboard
+- [ ] Create content selection UI
+- [ ] Create source badge component
+- [ ] Create content filters
+- [ ] Update content list with filters
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ Writer → Linker handover works
+- ✅ Optimizer works from all entry points
+- ✅ Content source tracking works
+- ✅ Pipeline orchestrates correctly
+- ✅ UI shows content sources and filters
+
+---
+
+**END OF PHASE 4 DOCUMENT**
+

docs/planning/phases/PHASE-5-SITES-RENDERER.md

@@ -0,0 +1,181 @@
+# PHASE 5: SITES RENDERER
+**Detailed Implementation Plan**
+
+**Goal**: Build Sites renderer for hosting public sites.
+
+**Timeline**: 2-3 weeks  
+**Priority**: MEDIUM  
+**Dependencies**: Phase 3
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Sites Renderer Container](#sites-renderer-container)
+3. [Publisher Service](#publisher-service)
+4. [Publishing Models](#publishing-models)
+5. [Publisher API](#publisher-api)
+6. [Multiple Layout Options](#multiple-layout-options)
+7. [Testing & Validation](#testing--validation)
+8. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Create Sites renderer container
+- ✅ Build publisher service
+- ✅ Support multiple layout options
+- ✅ Deploy sites to public URLs
+- ✅ Render sites from site definitions
+
+### Key Principles
+- **Component Reuse**: Use shared component library from Phase 3
+- **Multiple Layouts**: Support 7 layout types
+- **Public Access**: Sites accessible via public URLs
+- **User-Friendly**: "My Websites" or "Published Sites" in UI
+
+---
+
+## SITES RENDERER CONTAINER
+
+### 5.1 Sites Renderer Container
+
+**User-Friendly Name**: "My Websites" or "Published Sites"
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Create Sites Container** | `docker-compose.app.yml` | None | Add new container for sites renderer |
+| **Sites Renderer Frontend** | `sites/src/` | NEW | React app for rendering sites |
+| **Site Definition Loader** | `sites/src/loaders/loadSiteDefinition.ts` | NEW | Load site definitions from API |
+| **Layout Renderer** | `sites/src/utils/layoutRenderer.ts` | NEW | Render different layouts |
+| **Template System** | `sites/src/utils/templateEngine.ts` | NEW | Template rendering system |
+
+**Docker Compose Configuration**:
+```yaml
+# docker-compose.app.yml
+igny8_sites:
+  build: ./sites
+  ports:
+    - "8024:5176"
+  volumes:
+    - /data/app/igny8/sites:/app
+    - /data/app/sites-data:/sites
+  environment:
+    - VITE_API_URL=http://igny8_backend:8010
+```
+
+---
+
+## PUBLISHER SERVICE
+
+### 5.2 Publisher Service
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **PublisherService** | `domain/publishing/services/publisher_service.py` | Phase 1 | Main publishing service |
+| **SitesRendererAdapter** | `domain/publishing/services/adapters/sites_renderer_adapter.py` | Phase 3 | Adapter for Sites renderer |
+| **DeploymentService** | `domain/publishing/services/deployment_service.py` | Phase 3 | Deploy sites to renderer |
+
+**PublisherService**:
+```python
+# domain/publishing/services/publisher_service.py
+class PublisherService:
+    def publish_to_sites(self, site_blueprint):
+        """Publish site to Sites renderer"""
+        adapter = SitesRendererAdapter()
+        return adapter.deploy(site_blueprint)
+```
+
+---
+
+## PUBLISHING MODELS
+
+### 5.3 Publishing Models
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **PublishingRecord Model** | `domain/publishing/models.py` | Phase 1 | Track content publishing |
+| **DeploymentRecord Model** | `domain/publishing/models.py` | Phase 3 | Track site deployments |
+
+---
+
+## PUBLISHER API
+
+### 5.4 Publisher API
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Publisher ViewSet** | `modules/publisher/views.py` | PublisherService | API for publishing operations |
+
+---
+
+## MULTIPLE LAYOUT OPTIONS
+
+### 5.6 Multiple Layout Options
+
+**Layout Types**:
+- Default (Standard)
+- Minimal (Clean, simple)
+- Magazine (Editorial, content-focused)
+- Ecommerce (Product-focused)
+- Portfolio (Showcase)
+- Blog (Content-first)
+- Corporate (Business)
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Layout Configuration** | `domain/site_building/models.py` | Phase 3 | Store layout selection |
+| **Layout Renderer** | `sites/src/utils/layoutRenderer.ts` | Phase 5 | Render different layouts |
+
+---
+
+## TESTING & VALIDATION
+
+### 5.5 Testing
+
+**Test Cases**:
+- ✅ Sites renderer loads site definitions
+- ✅ Blocks render correctly
+- ✅ Deployment works end-to-end
+- ✅ Sites are accessible publicly
+- ✅ Multiple layouts work correctly
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Create PublisherService
+- [ ] Create SitesRendererAdapter
+- [ ] Create DeploymentService
+- [ ] Create PublishingRecord model
+- [ ] Create DeploymentRecord model
+- [ ] Create Publisher ViewSet
+
+### Frontend Tasks
+
+- [ ] Create Sites container in docker-compose
+- [ ] Create sites renderer frontend
+- [ ] Create site definition loader
+- [ ] Create layout renderer
+- [ ] Create template system
+- [ ] Import shared components
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ Sites renderer loads site definitions
+- ✅ Blocks render correctly
+- ✅ Deployment works end-to-end
+- ✅ Sites are accessible publicly
+- ✅ Multiple layouts supported
+
+---
+
+**END OF PHASE 5 DOCUMENT**
+

docs/planning/phases/PHASE-6-SITE-INTEGRATION-PUBLISHING.md

@@ -0,0 +1,242 @@
+# PHASE 6: SITE INTEGRATION & MULTI-DESTINATION PUBLISHING
+**Detailed Implementation Plan**
+
+**Goal**: Support multiple publishing destinations (WordPress, Sites, Shopify).
+
+**Timeline**: 2-3 weeks  
+**Priority**: MEDIUM  
+**Dependencies**: Phase 5
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Site Integration Models](#site-integration-models)
+3. [Integration Service](#integration-service)
+4. [Publishing Adapters](#publishing-adapters)
+5. [Multi-Destination Publishing](#multi-destination-publishing)
+6. [Site Model Extensions](#site-model-extensions)
+7. [Integration API](#integration-api)
+8. [Integration UI](#integration-ui)
+9. [Publishing Settings UI](#publishing-settings-ui)
+10. [Site Management UI](#site-management-ui)
+11. [Testing & Validation](#testing--validation)
+12. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Support multiple site integrations per site
+- ✅ Multi-destination publishing (WordPress, Sites, Shopify)
+- ✅ Two-way sync with external platforms
+- ✅ Site management UI (CMS)
+- ✅ Publishing settings UI
+
+### Key Principles
+- **Multiple Integrations**: One site can have multiple integrations
+- **Adapter Pattern**: Platform-specific adapters for publishing
+- **Two-Way Sync**: Sync content both ways
+- **User-Friendly**: "Site Manager" or "Content Manager" in UI
+
+---
+
+## SITE INTEGRATION MODELS
+
+### 6.1 Site Integration Models
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **SiteIntegration Model** | `domain/integration/models.py` | Phase 1 | Store integration configs |
+
+**SiteIntegration Model**:
+```python
+# domain/integration/models.py
+class SiteIntegration(SiteSectorBaseModel):
+    site = models.ForeignKey(Site, on_delete=models.CASCADE)
+    platform = models.CharField(max_length=50)  # 'wordpress', 'shopify', 'custom'
+    platform_type = models.CharField(max_length=50)  # 'cms', 'ecommerce', 'custom_api'
+    config_json = models.JSONField(default=dict)
+    credentials = models.EncryptedField()  # Encrypted API keys
+    is_active = models.BooleanField(default=True)
+    sync_enabled = models.BooleanField(default=False)
+    last_sync_at = models.DateTimeField(null=True, blank=True)
+    sync_status = models.CharField(max_length=20)  # 'success', 'failed', 'pending'
+```
+
+---
+
+## INTEGRATION SERVICE
+
+### 6.2 Integration Service
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **IntegrationService** | `domain/integration/services/integration_service.py` | Phase 1 | Manage integrations |
+| **SyncService** | `domain/integration/services/sync_service.py` | Phase 1 | Handle two-way sync |
+
+---
+
+## PUBLISHING ADAPTERS
+
+### 6.3 Publishing Adapters
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **BaseAdapter** | `domain/publishing/services/adapters/base_adapter.py` | Phase 5 | Base adapter interface |
+| **WordPressAdapter** | `domain/publishing/services/adapters/wordpress_adapter.py` | EXISTING (refactor) | WordPress publishing |
+| **SitesRendererAdapter** | `domain/publishing/services/adapters/sites_renderer_adapter.py` | Phase 5 | IGNY8 Sites deployment |
+| **ShopifyAdapter** | `domain/publishing/services/adapters/shopify_adapter.py` | Phase 5 (future) | Shopify publishing |
+
+---
+
+## MULTI-DESTINATION PUBLISHING
+
+### 6.4 Multi-Destination Publishing
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Extend PublisherService** | `domain/publishing/services/publisher_service.py` | Phase 5 | Support multiple destinations |
+| **Update PublishingRecord** | `domain/publishing/models.py` | Phase 5 | Track multiple destinations |
+
+**Multi-Destination Publishing**:
+```python
+# domain/publishing/services/publisher_service.py
+class PublisherService:
+    def publish(self, content, destinations):
+        """Publish content to multiple destinations"""
+        results = []
+        for destination in destinations:
+            adapter = self.get_adapter(destination)
+            result = adapter.publish(content)
+            results.append(result)
+        return results
+```
+
+---
+
+## SITE MODEL EXTENSIONS
+
+### 6.5 Site Model Extensions
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Add site_type field** | `core/auth/models.py` | None | Track site type |
+| **Add hosting_type field** | `core/auth/models.py` | None | Track hosting type |
+| **Add integrations relationship** | `core/auth/models.py` | Phase 6.1 | Link to SiteIntegration |
+
+---
+
+## INTEGRATION API
+
+### 6.6 Integration API
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Integration ViewSet** | `modules/integration/views.py` | IntegrationService | CRUD for integrations |
+| **Integration URLs** | `modules/integration/urls.py` | None | Register integration routes |
+
+---
+
+## INTEGRATION UI
+
+### 6.7 Integration UI (Update Existing)
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Update Integration Settings** | `frontend/src/pages/Settings/Integration.tsx` | EXISTING (update) | Add SiteIntegration support |
+| **Multi-Platform Support** | `frontend/src/components/integration/PlatformSelector.tsx` | NEW | Platform selector |
+| **Integration Status** | `frontend/src/components/integration/IntegrationStatus.tsx` | NEW | Show integration status |
+
+---
+
+## PUBLISHING SETTINGS UI
+
+### 6.8 Publishing Settings UI
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Publishing Settings Page** | `frontend/src/pages/Settings/Publishing.tsx` | NEW | Publishing configuration |
+| **Destination Management** | `frontend/src/pages/Settings/Publishing.tsx` | Phase 6 | Manage publishing destinations |
+| **Publishing Rules** | `frontend/src/components/publishing/PublishingRules.tsx` | NEW | Publishing rules configuration |
+
+---
+
+## SITE MANAGEMENT UI
+
+### 6.9 Individual Site Management (CMS)
+
+**User-Friendly Name**: "Site Manager" or "Content Manager"
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site Management Dashboard** | `frontend/src/pages/Sites/Manage.tsx` | NEW | Site management overview |
+| **Site Content Editor** | `frontend/src/pages/Sites/Editor.tsx` | NEW | Edit site content |
+| **Post Editor** | `frontend/src/pages/Sites/PostEditor.tsx` | NEW | Edit posts |
+| **Page Manager** | `frontend/src/pages/Sites/PageManager.tsx` | NEW | Manage pages |
+| **Site Settings** | `frontend/src/pages/Sites/Settings.tsx` | NEW | Site settings |
+
+**Site Management Features**:
+- View all pages/posts for a site
+- Add new pages
+- Remove pages
+- Edit page content
+- Manage page order
+- Change page templates
+- Update site settings
+- Preview site
+
+---
+
+## TESTING & VALIDATION
+
+### 6.9 Testing
+
+**Test Cases**:
+- ✅ Site integrations work correctly
+- ✅ Multi-destination publishing works
+- ✅ WordPress sync works (when plugin connected)
+- ✅ Two-way sync functions properly
+- ✅ Site management UI works
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Create SiteIntegration model
+- [ ] Create IntegrationService
+- [ ] Create SyncService
+- [ ] Create BaseAdapter
+- [ ] Refactor WordPressAdapter
+- [ ] Create SitesRendererAdapter
+- [ ] Extend PublisherService for multi-destination
+- [ ] Extend Site model
+- [ ] Create Integration ViewSet
+
+### Frontend Tasks
+
+- [ ] Update Integration Settings page
+- [ ] Create Publishing Settings page
+- [ ] Create Site Management Dashboard
+- [ ] Create Site Content Editor
+- [ ] Create Page Manager
+- [ ] Create Site Settings page
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ Site integrations work correctly
+- ✅ Multi-destination publishing works
+- ✅ WordPress sync works
+- ✅ Two-way sync functions properly
+- ✅ Site management UI works
+
+---
+
+**END OF PHASE 6 DOCUMENT**
+

docs/planning/phases/PHASE-7-UI-COMPONENTS-MODULE-SETTINGS.md

@@ -0,0 +1,205 @@
+# PHASE 7: UI COMPONENTS & MODULE SETTINGS
+**Detailed Implementation Plan**
+
+**Goal**: Build comprehensive UI system with shared components, module settings, and site management.
+
+**Timeline**: 3-4 weeks  
+**Priority**: MEDIUM  
+**Dependencies**: Phase 0, Phase 3, Phase 5
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Global Component Library](#global-component-library)
+3. [Module Settings UI](#module-settings-ui)
+4. [Frontend Module Loader](#frontend-module-loader)
+5. [Site Management UI](#site-management-ui)
+6. [Layout & Template System](#layout--template-system)
+7. [CMS Styling System](#cms-styling-system)
+8. [Testing & Validation](#testing--validation)
+9. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Complete global component library
+- ✅ Implement module settings UI
+- ✅ Build site management UI
+- ✅ Create layout and template system
+- ✅ Implement CMS styling system
+
+### Key Principles
+- **No Duplication**: All components shared across apps
+- **TypeScript**: All components use TypeScript
+- **Accessibility**: All components accessible (ARIA)
+- **Responsive**: All components responsive
+
+---
+
+## GLOBAL COMPONENT LIBRARY
+
+### 7.1 Global Component Library
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Component Library Structure** | `frontend/src/components/shared/` | None | Complete component library |
+| **Block Components** | `frontend/src/components/shared/blocks/` | None | All block components |
+| **Layout Components** | `frontend/src/components/shared/layouts/` | None | All layout components |
+| **Template Components** | `frontend/src/components/shared/templates/` | None | All template components |
+| **Component Documentation** | `frontend/src/components/shared/README.md` | None | Document all components |
+| **Component Storybook** | `frontend/.storybook/` | Optional | Component documentation |
+| **Component Tests** | `frontend/src/components/shared/**/*.test.tsx` | None | Test all components |
+
+**Component Standards**:
+- All components use TypeScript
+- All components have props interfaces
+- All components are responsive
+- All components support dark mode
+- All components are accessible (ARIA)
+- No duplicate components
+
+---
+
+## MODULE SETTINGS UI
+
+### 7.2 Module Settings UI
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Module Settings Page** | `frontend/src/pages/Settings/Modules.tsx` | EXISTING (implement) | Module settings interface |
+| **Module Toggle Component** | `frontend/src/components/settings/ModuleToggle.tsx` | NEW | Toggle module on/off |
+| **Module Status Indicator** | `frontend/src/components/settings/ModuleStatus.tsx` | NEW | Show module status |
+| **Module Configuration** | `frontend/src/components/settings/ModuleConfig.tsx` | NEW | Module configuration UI |
+
+**Module Settings Features**:
+- Enable/disable modules per account
+- Module-specific configuration
+- Module status display
+- Module usage statistics
+- Module dependencies check
+
+---
+
+## FRONTEND MODULE LOADER
+
+### 7.3 Frontend Module Loader
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Module Config** | `frontend/src/config/modules.config.ts` | Phase 0 | Module configuration |
+| **Module Guard** | `frontend/src/components/common/ModuleGuard.tsx` | Phase 0 | Route guard component |
+| **Conditional Route Loading** | `frontend/src/App.tsx` | Phase 0 | Conditional routes |
+| **Sidebar Module Filter** | `frontend/src/layout/AppSidebar.tsx` | Phase 0 | Filter disabled modules |
+
+---
+
+## SITE MANAGEMENT UI
+
+### 7.4 Site Management UI
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Site List View** | `frontend/src/pages/Sites/List.tsx` | NEW | List all sites |
+| **Site Dashboard** | `frontend/src/pages/Sites/Dashboard.tsx` | NEW | Site overview |
+| **Site Content Manager** | `frontend/src/pages/Sites/Content.tsx` | NEW | Manage site content |
+| **Post Editor** | `frontend/src/pages/Sites/PostEditor.tsx` | NEW | Edit posts |
+| **Page Manager** | `frontend/src/pages/Sites/Pages.tsx` | NEW | Manage pages |
+| **Site Settings** | `frontend/src/pages/Sites/Settings.tsx` | NEW | Site settings |
+| **Site Preview** | `frontend/src/pages/Sites/Preview.tsx` | NEW | Preview site |
+
+---
+
+## LAYOUT & TEMPLATE SYSTEM
+
+### 7.5 Layout & Template System
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Layout Selector** | `frontend/src/components/sites/LayoutSelector.tsx` | NEW | Select layout |
+| **Template Library** | `frontend/src/components/sites/TemplateLibrary.tsx` | NEW | Template library |
+| **Layout Preview** | `frontend/src/components/sites/LayoutPreview.tsx` | NEW | Preview layouts |
+| **Template Customizer** | `frontend/src/components/sites/TemplateCustomizer.tsx` | NEW | Customize templates |
+| **Style Editor** | `frontend/src/components/sites/StyleEditor.tsx` | NEW | Edit styles |
+
+**Layout Options**:
+- Default Layout
+- Minimal Layout
+- Magazine Layout
+- Ecommerce Layout
+- Portfolio Layout
+- Blog Layout
+- Corporate Layout
+
+---
+
+## CMS STYLING SYSTEM
+
+### 7.6 CMS Styling System
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **CMS Theme System** | `frontend/src/styles/cms/` | NEW | Theme system |
+| **Style Presets** | `frontend/src/styles/cms/presets.ts` | NEW | Style presets |
+| **Color Schemes** | `frontend/src/styles/cms/colors.ts` | NEW | Color schemes |
+| **Typography System** | `frontend/src/styles/cms/typography.ts` | NEW | Typography system |
+| **Component Styles** | `frontend/src/styles/cms/components.ts` | NEW | Component styles |
+
+**CMS Features**:
+- Theme customization
+- Color palette management
+- Typography settings
+- Component styling
+- Responsive breakpoints
+- Dark/light mode
+
+---
+
+## TESTING & VALIDATION
+
+### 7.7 Testing
+
+**Test Cases**:
+- ✅ All components render correctly
+- ✅ Module settings enable/disable modules
+- ✅ Disabled modules don't load
+- ✅ Site management works end-to-end
+- ✅ Layout system works
+- ✅ Template system works
+- ✅ No duplicate components
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Frontend Tasks
+
+- [ ] Complete component library
+- [ ] Implement module settings UI
+- [ ] Create module loader
+- [ ] Create site management UI
+- [ ] Create layout system
+- [ ] Create template system
+- [ ] Create CMS styling system
+- [ ] Write component tests
+- [ ] Write component documentation
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ All components render correctly
+- ✅ Module settings enable/disable modules
+- ✅ Disabled modules don't load
+- ✅ Site management works end-to-end
+- ✅ Layout system works
+- ✅ Template system works
+- ✅ No duplicate components
+
+---
+
+**END OF PHASE 7 DOCUMENT**
+

docs/planning/phases/PHASE-8-UNIVERSAL-CONTENT-TYPES.md

@@ -0,0 +1,156 @@
+# PHASE 8: UNIVERSAL CONTENT TYPES
+**Detailed Implementation Plan**
+
+**Goal**: Extend content system to support products, services, taxonomies.
+
+**Timeline**: 2-3 weeks  
+**Priority**: LOW  
+**Dependencies**: Phase 4
+
+---
+
+## TABLE OF CONTENTS
+
+1. [Overview](#overview)
+2. [Content Model Extensions](#content-model-extensions)
+3. [Content Type Prompts](#content-type-prompts)
+4. [Content Service Extensions](#content-service-extensions)
+5. [Linker & Optimizer Extensions](#linker--optimizer-extensions)
+6. [Testing & Validation](#testing--validation)
+7. [Implementation Checklist](#implementation-checklist)
+
+---
+
+## OVERVIEW
+
+### Objectives
+- ✅ Support product content generation
+- ✅ Support service page generation
+- ✅ Support taxonomy generation
+- ✅ Extend linker for all content types
+- ✅ Extend optimizer for all content types
+
+### Key Principles
+- **Unified Model**: All content types use same Content model
+- **Type-Specific Prompts**: Different prompts per content type
+- **Universal Processing**: Linker and Optimizer work on all types
+
+---
+
+## CONTENT MODEL EXTENSIONS
+
+### 8.1 Content Model Extensions
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Add entity_type field** | `domain/content/models.py` | Phase 1 | Content type field |
+| **Add json_blocks field** | `domain/content/models.py` | Phase 1 | Structured content blocks |
+| **Add structure_data field** | `domain/content/models.py` | Phase 1 | Content structure data |
+
+**Content Model Extensions**:
+```python
+# domain/content/models.py
+class Content(SiteSectorBaseModel):
+    # Existing fields...
+    
+    # NEW: Entity type
+    entity_type = models.CharField(
+        max_length=50,
+        choices=[
+            ('blog_post', 'Blog Post'),
+            ('article', 'Article'),
+            ('product', 'Product'),
+            ('service', 'Service Page'),
+            ('taxonomy', 'Taxonomy Page'),
+            ('page', 'Page'),
+        ],
+        default='blog_post'
+    )
+    
+    # NEW: Structured content
+    json_blocks = models.JSONField(default=list)
+    structure_data = models.JSONField(default=dict)
+```
+
+---
+
+## CONTENT TYPE PROMPTS
+
+### 8.2 Content Type Prompts
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Product Prompts** | `infrastructure/ai/prompts.py` | Existing prompt system | Product generation prompts |
+| **Service Page Prompts** | `infrastructure/ai/prompts.py` | Existing prompt system | Service page prompts |
+| **Taxonomy Prompts** | `infrastructure/ai/prompts.py` | Existing prompt system | Taxonomy prompts |
+
+---
+
+## CONTENT SERVICE EXTENSIONS
+
+### 8.3 Content Service Extensions
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Product Content Generation** | `domain/content/services/content_generation_service.py` | Phase 1 | Generate product content |
+| **Service Page Generation** | `domain/content/services/content_generation_service.py` | Phase 1 | Generate service pages |
+| **Taxonomy Generation** | `domain/content/services/content_generation_service.py` | Phase 1 | Generate taxonomy pages |
+
+---
+
+## LINKER & OPTIMIZER EXTENSIONS
+
+### 8.4 Linker & Optimizer Extensions
+
+| Task | File | Dependencies | Implementation |
+|------|------|--------------|----------------|
+| **Product Linking** | `domain/linking/services/linker_service.py` | Phase 4 | Link products |
+| **Taxonomy Linking** | `domain/linking/services/linker_service.py` | Phase 4 | Link taxonomies |
+| **Product Optimization** | `domain/optimization/services/optimizer_service.py` | Phase 4 | Optimize products |
+| **Taxonomy Optimization** | `domain/optimization/services/optimizer_service.py` | Phase 4 | Optimize taxonomies |
+
+---
+
+## TESTING & VALIDATION
+
+### 8.5 Testing
+
+**Test Cases**:
+- ✅ Product content generates correctly
+- ✅ Service pages work
+- ✅ Taxonomy pages work
+- ✅ Linking works for all types
+- ✅ Optimization works for all types
+
+---
+
+## IMPLEMENTATION CHECKLIST
+
+### Backend Tasks
+
+- [ ] Extend Content model with entity_type, json_blocks, structure_data
+- [ ] Add product prompts
+- [ ] Add service page prompts
+- [ ] Add taxonomy prompts
+- [ ] Extend ContentService for product generation
+- [ ] Extend ContentService for service page generation
+- [ ] Extend ContentService for taxonomy generation
+- [ ] Extend LinkerService for products
+- [ ] Extend LinkerService for taxonomies
+- [ ] Extend OptimizerService for products
+- [ ] Extend OptimizerService for taxonomies
+
+---
+
+## SUCCESS CRITERIA
+
+- ✅ Product content generates correctly
+- ✅ Service pages work
+- ✅ Taxonomy pages work
+- ✅ Linking works for all types
+- ✅ Optimization works for all types
+
+---
+
+**END OF PHASE 8 DOCUMENT**
+

docs/planning/phases/README.md

@@ -0,0 +1,141 @@
+# PHASE IMPLEMENTATION DOCUMENTS
+**Complete Phase-by-Phase Implementation Plans**
+
+This folder contains detailed implementation plans for each phase of the IGNY8 Phase 2 development.
+
+---
+
+## PHASE DOCUMENTS
+
+| Phase | Document | Timeline | Priority | Dependencies |
+|-------|----------|----------|----------|-------------|
+| **Phase 0** | [PHASE-0-FOUNDATION-CREDIT-SYSTEM.md](./PHASE-0-FOUNDATION-CREDIT-SYSTEM.md) | 1-2 weeks | HIGH | None |
+| **Phase 1** | [PHASE-1-SERVICE-LAYER-REFACTORING.md](./PHASE-1-SERVICE-LAYER-REFACTORING.md) | 2-3 weeks | HIGH | Phase 0 |
+| **Phase 2** | [PHASE-2-AUTOMATION-SYSTEM.md](./PHASE-2-AUTOMATION-SYSTEM.md) | 2-3 weeks | HIGH | Phase 1 |
+| **Phase 3** | [PHASE-3-SITE-BUILDER.md](./PHASE-3-SITE-BUILDER.md) | 3-4 weeks | HIGH | Phase 1, Phase 2 |
+| **Phase 4** | [PHASE-4-LINKER-OPTIMIZER.md](./PHASE-4-LINKER-OPTIMIZER.md) | 4-5 weeks | MEDIUM | Phase 1 |
+| **Phase 5** | [PHASE-5-SITES-RENDERER.md](./PHASE-5-SITES-RENDERER.md) | 2-3 weeks | MEDIUM | Phase 3 |
+| **Phase 6** | [PHASE-6-SITE-INTEGRATION-PUBLISHING.md](./PHASE-6-SITE-INTEGRATION-PUBLISHING.md) | 2-3 weeks | MEDIUM | Phase 5 |
+| **Phase 7** | [PHASE-7-UI-COMPONENTS-MODULE-SETTINGS.md](./PHASE-7-UI-COMPONENTS-MODULE-SETTINGS.md) | 3-4 weeks | MEDIUM | Phase 0, Phase 3, Phase 5 |
+| **Phase 8** | [PHASE-8-UNIVERSAL-CONTENT-TYPES.md](./PHASE-8-UNIVERSAL-CONTENT-TYPES.md) | 2-3 weeks | LOW | Phase 4 |
+
+**Total Estimated Time**: 20-29 weeks (5-7 months)
+
+---
+
+## PHASE OVERVIEW
+
+### Phase 0: Foundation & Credit System
+- Migrate to credit-only model
+- Implement module enable/disable
+- Add credit cost tracking
+- Remove plan limit fields
+
+### Phase 1: Service Layer Refactoring
+- Create domain structure
+- Move models to domain
+- Extract business logic to services
+- Refactor ViewSets to thin wrappers
+
+### Phase 2: Automation System
+- Create AutomationRule and ScheduledTask models
+- Build AutomationService
+- Implement Celery Beat scheduled tasks
+- Create automation UI
+
+### Phase 3: Site Builder
+- Build Site Builder wizard
+- Generate site structure using AI
+- Create shared component library
+- Support multiple layouts and templates
+
+### Phase 4: Linker & Optimizer
+- Add internal linking to content
+- Add content optimization
+- Support multiple entry points
+- Create content pipeline service
+
+### Phase 5: Sites Renderer
+- Create Sites renderer container
+- Build publisher service
+- Support multiple layout options
+- Deploy sites to public URLs
+
+### Phase 6: Site Integration & Multi-Destination Publishing
+- Support multiple site integrations
+- Multi-destination publishing
+- Two-way sync with external platforms
+- Site management UI (CMS)
+
+### Phase 7: UI Components & Module Settings
+- Complete global component library
+- Implement module settings UI
+- Build site management UI
+- Create layout and template system
+
+### Phase 8: Universal Content Types
+- Support product content generation
+- Support service page generation
+- Support taxonomy generation
+- Extend linker and optimizer for all types
+
+---
+
+## IMPLEMENTATION ORDER
+
+**Sequential Phases** (must be done in order):
+1. Phase 0 → Phase 1 → Phase 2
+2. Phase 1 → Phase 3
+3. Phase 3 → Phase 5
+4. Phase 5 → Phase 6
+5. Phase 1 → Phase 4
+6. Phase 4 → Phase 8
+
+**Parallel Phases** (can be done in parallel):
+- Phase 2 and Phase 3 (after Phase 1)
+- Phase 4 and Phase 5 (after Phase 1/3)
+- Phase 6 and Phase 7 (after Phase 5)
+
+---
+
+## KEY SUCCESS CRITERIA
+
+- ✅ All existing features continue working
+- ✅ Credit system is universal and consistent
+- ✅ Automation system is functional
+- ✅ Site Builder creates and deploys sites
+- ✅ Sites Renderer hosts sites
+- ✅ Linker and Optimizer improve content
+- ✅ Multi-destination publishing works
+- ✅ Module settings enable/disable modules
+- ✅ Global component library (no duplicates)
+- ✅ Multiple layout options for sites
+- ✅ Site management UI (CMS) functional
+- ✅ All content types supported
+
+---
+
+## DOCUMENT STRUCTURE
+
+Each phase document includes:
+1. **Overview** - Goals, objectives, principles
+2. **Detailed Tasks** - All tasks with files, dependencies, implementation details
+3. **Code Examples** - Implementation examples where relevant
+4. **Testing & Validation** - Test cases and success criteria
+5. **Implementation Checklist** - Complete checklist of all tasks
+6. **Risk Assessment** - Risks and mitigation strategies
+
+---
+
+## USAGE
+
+1. **Start with Phase 0** - Foundation must be completed first
+2. **Follow Dependencies** - Complete dependencies before starting a phase
+3. **Use Checklists** - Each document has a complete implementation checklist
+4. **Test Thoroughly** - Each phase includes testing requirements
+5. **Update Documentation** - Update main docs as phases complete
+
+---
+
+**Last Updated**: 2025-01-XX
+

docs/planning/sample-usage-limits-credit-system

@@ -0,0 +1,124 @@
+# Unified Credit-Based Usage System — Instructions for Cursor
+
+## Objective
+Transition IGNY8 from a limit-based subscription model to a fully credit-driven usage model.  
+Every feature is unlocked for all paid users, and only credits determine how much the platform can be used.
+
+---
+
+## 1. Core Principle
+Remove all numerical limits tied to subscription plans.  
+Examples of limits that must no longer exist:
+
+- Number of keywords allowed  
+- Number of clusters  
+- Number of content ideas  
+- Daily or monthly content tasks  
+- Monthly word count  
+- Image generation limits  
+- Site limits  
+- User limits  
+- Any plan-based feature restrictions  
+
+The only limiter in the entire system should be **credits**.
+
+---
+
+## 2. Purpose of Subscription Plans
+Plans should no longer define usage capacity.  
+Plans only define:
+
+- Monthly credits added to the account  
+- Support and onboarding level  
+- Billing cycle (monthly or yearly)
+
+Every paid user gets full access to all features without restrictions.
+
+---
+
+## 3. Credit Economy
+Every system action should consume a defined number of credits.  
+The values can be adjusted later, but the mechanism must be universal.
+
+Example conceptual structure:
+
+- One clustering request consumes a small number of credits  
+- One idea generation request consumes more credits  
+- Content generation consumes credits based on word count  
+- Image generation consumes credits per image  
+- Optimization consumes credits per thousand words  
+- Linking operations consume a fixed number of credits  
+
+Credits should be deducted at the moment the action is initiated.
+
+---
+
+## 4. System Behavior
+Cursor should apply these global rules:
+
+- If the account has enough credits, the action proceeds  
+- If credits are insufficient, the system shows a clear warning and does not run the action  
+- All features remain available, but actions require credits  
+- Credit consumption must be tracked and logged for transparency  
+- Credit usage must be consistent across all modules  
+
+This ensures that usage is pay-as-you-go within the subscription credit budget.
+
+---
+
+## 5. Removal of Old Logic
+All of the following must be removed from the system:
+
+- Any checks for keyword count  
+- Any maximum allowed clusters  
+- Any caps on ideas  
+- Any daily task limits  
+- Any monthly generation limits  
+- Any image generation limits  
+- Any limits based on the user’s plan  
+- Any feature locking based on plan tier  
+
+The platform should feel “unlimited,” with only credit balance controlling usage.
+
+---
+
+## 6. Frontend Adjustments
+On the interface:
+
+- Remove UI elements showing limits  
+- Replace them with a simple display of remaining credits  
+- Show estimated credit cost before performing any action  
+- If credits are insufficient, display a clear prompt to buy more credits  
+- All features must appear unlocked and available  
+
+The user should understand that only credits restrict their usage, not the plan.
+
+---
+
+## 7. Billing and Top-ups
+Plans supply monthly credits, but users should be able to purchase extra credits anytime.  
+The system must support:
+
+- Monthly credit replenishment  
+- On-demand credit top-ups  
+- Tracking of credit usage history  
+- Notifications when credits run low  
+
+This ensures consistent monetization and scalability.
+
+---
+
+## 8. Guiding Principle for Cursor
+Cursor must treat **credits as the universal currency of usage**, and remove every other form of operational restriction.
+
+The product becomes:
+
+- Simpler for users  
+- Simpler for engineering  
+- Easier to maintain  
+- Scalable in pricing  
+- Fully usage-based  
+
+All future modules (Optimizer, Linker, etc.) must also follow the same credit model.
+
+---

docs/refactor/README.md

@@ -0,0 +1,89 @@
+# REFACTORING DOCUMENTATION
+
+**Purpose**: This directory contains refactoring plans, migration guides, and architectural refactoring documentation.
+
+---
+
+## Directory Structure
+
+```
+docs/refactor/
+├── README.md                    # This file
+├── routes/                      # Route refactoring plans
+├── folder-structure/            # Folder structure refactoring plans
+└── migrations/                 # Migration guides for refactoring
+```
+
+---
+
+## Refactoring Plans
+
+### Current Refactoring Status
+
+**Phase 0: Foundation & Credit System**
+- [ ] Credit-only model migration
+- [ ] Plan model simplification
+- [ ] Module settings system
+
+**Phase 1: Service Layer Refactoring**
+- [ ] Domain-driven structure
+- [ ] Service layer implementation
+- [ ] Model migrations
+
+**Phase 2: Automation System**
+- [ ] AutomationRule model
+- [ ] ScheduledTask model
+- [ ] Celery integration
+
+**Phase 3: Site Builder**
+- [ ] Site Builder models
+- [ ] File management service
+- [ ] Sites folder access
+
+**Phase 4: Linker & Optimizer**
+- [ ] Content model extensions
+- [ ] Multiple entry points
+- [ ] Workflow implementation
+
+**Phase 5: Sites Renderer**
+- [ ] Sites container
+- [ ] Layout system
+- [ ] Template system
+
+**Phase 6: Site Integration**
+- [ ] SiteIntegration model
+- [ ] Multi-destination publishing
+- [ ] Integration adapters
+
+**Phase 7: UI Components**
+- [ ] Global component library
+- [ ] Module settings UI
+- [ ] Site management UI
+
+**Phase 8: Universal Content Types**
+- [ ] Content type extensions
+- [ ] Taxonomy support
+- [ ] Product/Service pages
+
+---
+
+## Route Refactoring
+
+See `routes/` directory for route refactoring plans.
+
+---
+
+## Folder Structure Refactoring
+
+See `folder-structure/` directory for folder structure refactoring plans.
+
+---
+
+## Migration Guides
+
+See `migrations/` directory for step-by-step migration guides.
+
+---
+
+**Last Updated**: 2025-01-XX
+

docs/refactor/folder-structure/README.md

@@ -0,0 +1,64 @@
+# FOLDER STRUCTURE REFACTORING PLANS
+
+**Purpose**: Documentation for folder structure refactoring and reorganization.
+
+---
+
+## Current Structure
+
+```
+backend/igny8_core/
+├── modules/          # Feature modules
+├── ai/              # AI framework
+├── api/             # API base classes
+└── middleware/      # Custom middleware
+```
+
+---
+
+## Planned Structure (Domain-Driven)
+
+```
+backend/igny8_core/
+├── core/            # Core models (Account, User, Site, Sector)
+├── domain/          # Domain-specific code
+│   ├── content/     # Content domain
+│   ├── planning/    # Planning domain
+│   ├── linking/     # Linking domain
+│   ├── optimization/# Optimization domain
+│   ├── site_building/# Site building domain
+│   ├── integration/ # Integration domain
+│   └── billing/    # Billing domain
+├── infrastructure/  # Infrastructure code
+│   ├── ai/         # AI framework
+│   ├── storage/    # Storage services
+│   └── queue/      # Queue management
+├── modules/         # Module ViewSets (thin layer)
+├── shared/          # Shared utilities
+└── api/             # API base classes
+```
+
+---
+
+## Migration Strategy
+
+1. Create new domain folders
+2. Move models to domain folders
+3. Create service layer in domain folders
+4. Update imports incrementally
+5. Keep modules folder for ViewSets only
+
+---
+
+## File Organization Rules
+
+- **Models**: `domain/{domain}/models.py`
+- **Services**: `domain/{domain}/services/`
+- **Serializers**: `modules/{module}/serializers.py`
+- **ViewSets**: `modules/{module}/views.py`
+- **URLs**: `modules/{module}/urls.py`
+
+---
+
+**Last Updated**: 2025-01-XX
+

docs/refactor/migrations/README.md

@@ -0,0 +1,52 @@
+# MIGRATION GUIDES
+
+**Purpose**: Step-by-step migration guides for refactoring.
+
+---
+
+## Migration Guides
+
+### Phase 0: Credit System Migration
+- [ ] Remove plan limit fields
+- [ ] Update Plan model
+- [ ] Update CreditService
+- [ ] Update AI Engine
+- [ ] Update frontend
+
+### Phase 1: Service Layer Migration
+- [ ] Create domain folders
+- [ ] Move models
+- [ ] Create services
+- [ ] Update ViewSets
+- [ ] Update imports
+
+### Phase 2: Content Model Extensions
+- [ ] Add source field
+- [ ] Add sync_status field
+- [ ] Add external_id fields
+- [ ] Create migrations
+- [ ] Update serializers
+
+### Phase 3: New Module Integration
+- [ ] Automation module
+- [ ] Linker module
+- [ ] Optimizer module
+- [ ] Site Builder module
+- [ ] Integration module
+
+---
+
+## Migration Checklist
+
+For each migration:
+- [ ] Create migration files
+- [ ] Test migrations
+- [ ] Update code references
+- [ ] Update tests
+- [ ] Update documentation
+- [ ] Deploy incrementally
+
+---
+
+**Last Updated**: 2025-01-XX
+

docs/refactor/routes/README.md

@@ -0,0 +1,56 @@
+# ROUTE REFACTORING PLANS
+
+**Purpose**: Documentation for API route refactoring and reorganization.
+
+---
+
+## Current Route Structure
+
+### Backend Routes
+- `/api/v1/planner/` - Planner module routes
+- `/api/v1/writer/` - Writer module routes
+- `/api/v1/thinker/` - Thinker module routes
+- `/api/v1/system/` - System module routes
+- `/api/v1/billing/` - Billing module routes
+- `/api/v1/auth/` - Authentication routes
+
+### Frontend Routes
+- `/planner/*` - Planner pages
+- `/writer/*` - Writer pages
+- `/thinker/*` - Thinker pages
+- `/settings/*` - Settings pages
+- `/billing/*` - Billing pages
+
+---
+
+## Planned Route Changes
+
+### Phase 1: Service Layer Routes
+- New routes for service-based endpoints
+- Domain-specific route organization
+
+### Phase 2: New Module Routes
+- `/api/v1/automation/` - Automation routes
+- `/api/v1/linker/` - Linker routes
+- `/api/v1/optimizer/` - Optimizer routes
+- `/api/v1/site-builder/` - Site Builder routes
+- `/api/v1/integration/` - Integration routes
+
+### Phase 3: Frontend Route Updates
+- New module pages
+- Route guards for module access
+- Conditional route loading
+
+---
+
+## Migration Strategy
+
+1. Add new routes alongside existing routes
+2. Gradually migrate endpoints to new structure
+3. Maintain backward compatibility
+4. Update frontend routes incrementally
+
+---
+
+**Last Updated**: 2025-01-XX
+

igny8-ai-seo-wp-plugin/CHANGELOG_live.md

@@ -1,59 +0,0 @@
-## [0.1] - 2025-01-15
-
-### Initial Release - Complete Refactor
-- **Phase 1 Complete**: Global Role & Scope Index implemented
-- **Phase 2 Complete**: Folder restructure & component isolation
-- **Phase 2.5 Complete**: Final refactor of layout, routing, and page loading structure
-- **Phase 2.5.1 Complete**: Final cleanup of routing and layout includes
-
-### Major Architecture Changes
-- **Modular Structure**: All admin pages physically modularized by module
-- **Component System**: UI components (forms, filters, tables, modals) extracted into reusable templates
-- **Static Routing**: Eliminated dynamic routing, converted to static file includes
-- **Layout Standardization**: All pages follow `ob_start() → $igny8_page_content → global-layout.php` pattern
-- **Submodule System**: Complete subpage structure for planner, writer, thinker, settings, help modules
-
-### Technical Improvements
-- **Configuration-Driven UI**: Tables, forms, and filters generated dynamically from config files
-- **Complete Component Loading**: All submodules now include filters, actions, table, and pagination
-- **JavaScript Integration**: Proper localization and data setup for all submodules
-- **Debug Isolation**: Development files moved to dedicated folders with proper guards
-- **Help Module**: Centralized help, documentation, and testing functionality
-
-### Files Restructured
-- **Modules**: `/modules/planner/`, `/modules/writer/`, `/modules/thinker/`, `/modules/settings/`, `/modules/help/`
-- **Components**: `/modules/components/` with reusable UI templates
-- **Config**: `/modules/config/` with centralized configuration arrays
-- **Core**: `/core/` with layout, admin, database, and cron functionality
-- **AI**: `/ai/` with content generation and image processing
-
-### Database & Configuration
-- **Table Configurations**: Complete table structure definitions in `tables-config.php`
-- **Filter Configurations**: Dynamic filter system in `filters-config.php`
-- **Import/Export**: Centralized import/export configurations
-- **KPI System**: Dashboard metrics and analytics configuration
-
-### Developer Experience
-- **File Organization**: Clear separation of concerns and modular architecture
-- **Documentation**: Comprehensive documentation and troubleshooting guides
-- **Debug Tools**: System testing and function testing interfaces
-- **Code Standards**: Consistent file headers and scope declarations
-
-## [5.3.0] - 2025-01-15
-
-### Critical Cron vs Manual Function Analysis
-- **CRITICAL DISCREPANCY IDENTIFIED**: Cron functions have significant differences from manual counterparts
-- **Function Dependency Issues**: Cron handlers include extensive fallback logic for functions like `igny8_get_sector_options()`
-- **User Context Problems**: Cron handlers manually set admin user context while manual AJAX handlers rely on authenticated user
-- **Warning Suppression**: Cron handlers suppress PHP warnings that manual handlers don't, potentially masking issues
-- **Database Connection**: Cron handlers explicitly declare `global $wpdb` while manual handlers use it directly
-- **Risk Assessment**: Cron functions are at HIGH RISK of failing or behaving differently than manual functions
-
-### Technical Analysis Findings
-- **Auto Cluster**: Manual `igny8_ajax_ai_cluster_keywords()` vs Cron `igny8_auto_cluster_cron_handler()`
-- **Auto Ideas**: Manual `igny8_ajax_ai_generate_ideas()` vs Cron `igny8_auto_generate_ideas_cron_handler()`
-- **Auto Queue**: Manual `igny8_ajax_queue_ideas_to_writer()` vs Cron `igny8_auto_queue_cron_handler()`
-- **Auto Content**: Manual `igny8_ajax_ai_generate_content()` vs Cron `igny8_auto_generate_content_cron_handler()`
-- **Auto Image**: Manual `igny8_ajax_ai_generate_images_drafts()` vs Cron `igny8_auto_generate_images_cron_handler()`
-- **Auto Publish**: Manual `igny8_ajax_bulk_publish_drafts()` vs Cron `igny8_auto_publish_drafts_cron_handler()`
-

igny8-ai-seo-wp-plugin/ai/_README.php

@@ -1,14 +0,0 @@
-<?php
-/**
- * ==============================
- * 📁 Folder Scope Declaration
- * ==============================
- * Folder: /ai/
- * Purpose: AI content/image logic, parsers, prompt APIs
- * Rules:
- * - Can be reused globally across all modules
- * - Contains all AI integration logic
- * - OpenAI API integration and management
- * - AI prompt libraries and templates
- * - AI model configuration and rate limiting
- */

igny8-ai-seo-wp-plugin/ai/integration.php

@@ -1,21 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : integration.php
- * @location     : /ai/integration.php
- * @type         : AI Integration
- * @scope        : Global
- * @allowed      : API configuration, connection management, authentication
- * @reusability  : Globally Reusable
- * @notes        : AI service configuration and connection management
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-// Include Runware API integration
-require_once plugin_dir_path(__FILE__) . 'runware-api.php';

igny8-ai-seo-wp-plugin/ai/model-rates-config.php

@@ -1,192 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : model-rates-config.php
- * @location     : /ai/model-rates-config.php
- * @type         : Config Array
- * @scope        : Global
- * @allowed      : Model pricing, cost calculations, rate configurations
- * @reusability  : Globally Reusable
- * @notes        : Central AI model pricing configuration
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Global model rates configuration
- * Rates are per 1 million tokens for text models
- * Per image for image generation models
- * GPT-4.1, GPT-4o-mini, and GPT-4o models are supported
- */
-$IGNY8_MODEL_RATES = [
-    'gpt-4.1' => ['in' => 2.00, 'out' => 8.00],
-    'gpt-4o-mini' => ['in' => 0.15, 'out' => 0.60],
-    'gpt-4o' => ['in' => 2.50, 'out' => 10.00]
-];
-
-/**
- * Global image model rates configuration
- * Rates are per image
- */
-$IGNY8_IMAGE_MODEL_RATES = [
-    'dall-e-3' => 0.040,
-    'dall-e-2' => 0.020,
-    'gpt-image-1' => 0.042,
-    'gpt-image-1-mini' => 0.011
-];
-
-/**
- * Get model rates for a specific model
- * 
- * @param string $model Model name
- * @return array Model rates array with 'in' and 'out' keys
- */
-function igny8_get_model_rates($model) {
-    global $IGNY8_MODEL_RATES;
-    return $IGNY8_MODEL_RATES[$model] ?? $IGNY8_MODEL_RATES['gpt-4.1'];
-}
-
-/**
- * Calculate API cost based on model and token usage
- * 
- * @param string $model Model name
- * @param int $input_tokens Number of input tokens
- * @param int $output_tokens Number of output tokens
- * @return array Cost breakdown with 'input_cost', 'output_cost', 'total_cost'
- */
-function igny8_calculate_api_cost($model, $input_tokens, $output_tokens) {
-    $rates = igny8_get_model_rates($model);
-    
-    // Debug logging
-    error_log("Igny8 Cost Calc Debug: Model=$model, Rates=" . json_encode($rates));
-    error_log("Igny8 Cost Calc Debug: Input tokens=$input_tokens, Output tokens=$output_tokens");
-    
-    $input_cost = ($input_tokens / 1000000) * $rates['in'];
-    $output_cost = ($output_tokens / 1000000) * $rates['out'];
-    $total_cost = $input_cost + $output_cost;
-    
-    error_log("Igny8 Cost Calc Debug: Input cost=$input_cost, Output cost=$output_cost, Total cost=$total_cost");
-    
-    return [
-        'input_cost' => $input_cost,
-        'output_cost' => $output_cost,
-        'total_cost' => $total_cost,
-        'model' => $model,
-        'input_tokens' => $input_tokens,
-        'output_tokens' => $output_tokens
-    ];
-}
-
-/**
- * Format cost for display
- * 
- * @param float $cost Cost amount
- * @param int $decimals Number of decimal places
- * @return string Formatted cost string
- */
-function igny8_format_cost($cost, $decimals = 4) {
-    // Convert to cents for better readability
-    $cents = $cost * 100;
-    return number_format($cents, 2) . '¢';
-}
-
-/**
- * Get image model rates for a specific model
- * 
- * @param string $model Image model name
- * @return float Image model rate per image
- */
-function igny8_get_image_model_rates($model) {
-    global $IGNY8_IMAGE_MODEL_RATES;
-    return $IGNY8_IMAGE_MODEL_RATES[$model] ?? $IGNY8_IMAGE_MODEL_RATES['dall-e-3'];
-}
-
-/**
- * Calculate image generation cost based on model
- * 
- * @param string $model Image model name
- * @param int $image_count Number of images generated
- * @return array Cost breakdown with 'per_image_cost', 'total_cost'
- */
-function igny8_calculate_image_cost($model, $image_count = 1) {
-    $per_image_rate = igny8_get_image_model_rates($model);
-    $total_cost = $per_image_rate * $image_count;
-    
-    return [
-        'per_image_cost' => $per_image_rate,
-        'total_cost' => $total_cost,
-        'model' => $model,
-        'image_count' => $image_count
-    ];
-}
-
-/**
- * Get image model display name with pricing and typical uses
- * 
- * @param string $model Image model name
- * @return string Formatted model name with pricing and uses
- */
-function igny8_get_image_model_display_name($model) {
-    $model_info = [
-        'dall-e-3' => [
-            'name' => 'DALL·E 3',
-            'uses' => 'High-quality image generation with advanced AI capabilities'
-        ],
-        'dall-e-2' => [
-            'name' => 'DALL·E 2',
-            'uses' => 'Cost-effective image generation with good quality'
-        ],
-        'gpt-image-1' => [
-            'name' => 'GPT Image 1 (Full)',
-            'uses' => 'Full-featured image generation with comprehensive capabilities'
-        ],
-        'gpt-image-1-mini' => [
-            'name' => 'GPT Image 1 Mini',
-            'uses' => 'Lightweight, cost-effective image generation for bulk operations'
-        ]
-    ];
-    
-    $rate = igny8_get_image_model_rates($model);
-    $info = $model_info[$model] ?? ['name' => strtoupper($model), 'uses' => 'Image generation'];
-    
-    return sprintf(
-        '%s — $%.3f per image (%s)',
-        $info['name'], $rate, $info['uses']
-    );
-}
-
-/**
- * Get model display name with pricing and typical uses
- * 
- * @param string $model Model name
- * @return string Formatted model name with pricing and uses
- */
-function igny8_get_model_display_name($model) {
-    $model_info = [
-        'gpt-4.1' => [
-            'name' => 'GPT-4.1',
-            'uses' => 'Content creation, coding, analysis, high-quality content generation'
-        ],
-        'gpt-4o-mini' => [
-            'name' => 'GPT-4o mini',
-            'uses' => 'Bulk tasks, lightweight AI, cost-effective for high-volume operations'
-        ],
-        'gpt-4o' => [
-            'name' => 'GPT-4o',
-            'uses' => 'Advanced AI for general and multimodal tasks, faster than GPT-4.1'
-        ]
-    ];
-    
-    $rates = igny8_get_model_rates($model);
-    $info = $model_info[$model] ?? ['name' => strtoupper($model), 'uses' => 'General purpose'];
-    
-    return sprintf(
-        '%s — $%.2f / $%.2f per 1M tokens (%s)',
-        $info['name'], $rates['in'], $rates['out'], $info['uses']
-    );
-}

igny8-ai-seo-wp-plugin/ai/prompts-library.php

@@ -1,310 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : prompts-library.php
- * @location     : /ai/prompts-library.php
- * @type         : AI Integration
- * @scope        : Global
- * @allowed      : AI prompts, prompt management, AI templates
- * @reusability  : Globally Reusable
- * @notes        : Central AI prompts library for all modules
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Default clustering prompt template
- */
-function igny8_get_default_clustering_prompt() {
-    return "Analyze the following keywords and group them into topic clusters.
-
-Each cluster should include:
-- \"name\": A clear, descriptive topic name
-- \"description\": A brief explanation of what the cluster covers
-- \"keywords\": A list of related keywords that belong to this cluster
-
-Format the output as a JSON object with a \"clusters\" array.
-
-Clustering rules:
-- Group keywords based on strong semantic or topical relationships (intent, use-case, function, audience, etc.)
-- Clusters should reflect how people actually search — problem ➝ solution, general ➝ specific, product ➝ benefit, etc.
-- Avoid grouping keywords just because they share similar words — focus on meaning
-- Include 3–10 keywords per cluster where appropriate
-- Skip unrelated or outlier keywords that don't fit a clear theme
-
-Keywords to process:
-[IGNY8_KEYWORDS]";
-}
-
-/**
- * Default ideas prompt template
- */
-function igny8_get_default_ideas_prompt() {
-    return "Generate SEO-optimized, high-quality content ideas and detailed outlines for each of the following keyword clusters. Each idea must be valuable for SEO, have clear editorial flow, and include a structured long-form content outline that matches the standards of our content generation system.
-
-==========================
-CONTENT IDEA INPUT FORMAT
-==========================
-
-Clusters to analyze:
-[IGNY8_CLUSTERS]
-
-Keywords in each cluster:
-[IGNY8_CLUSTER_KEYWORDS]
-
-======================
-OUTPUT FORMAT REQUIRED
-======================
-
-Return your response as JSON with an \"ideas\" array.
-For each cluster, you must generate exactly 1 cluster_hub page and 2–4 supporting blog/article ideas based on unique keyword dimensions.
-
-Each idea must include:
-
-- \"title\": compelling blog/article title that naturally includes a primary keyword
-- \"description\": detailed and structured content outline using proper H2/H3 breakdowns (see outline rules below)
-- \"content_type\": the type of content (post, page)
-- \"content_structure\": the editorial structure (cluster_hub, guide_tutorial, how_to, comparison, review, top_listicle, question)
-- \"cluster_id\": ID of the cluster this idea belongs to
-- \"estimated_word_count\": estimated total word count (range: 1500–2200 words)
-- \"covered_keywords\": comma-separated list of keywords from the cluster that will be covered naturally in the content
-
-=========================
-OUTLINE (DESCRIPTION) RULES
-=========================
-
-Each content idea's \"description\" must follow the expected editorial structure based on both the content_type and content_structure fields. It should be formatted as a professional long-form content outline, suitable for direct use by AI or human writers.
-
-1. STRUCTURE:
-   - INTRODUCTION SECTION: Start with 1 hook (italic, 30-40 words) followed by 2 intro paragraphs (50-60 words each)
-   - Use exactly 5–8 H2 sections (depending on content type)
-   - Each H2 section should contain 2–3 H3 subsections
-   - SECTION WORD COUNT: Each H2 section should be 250-300 words total
-   - CONTENT MIX: Vary content types within sections:
-     - Some sections: 1 paragraph + list/table + 1 paragraph
-     - Some sections: 2 paragraphs + list/table (as final element)
-     - Mix unordered lists, ordered lists, and tables strategically
-   - Use diverse formatting styles: data/stat mentions, expert quotes, comparative breakdowns
-
-2. FORMATTING TYPES:
-   - content_type: \"paragraph\", \"list\", \"table\", \"blockquote\", or \"mixed\"
-   - Do not open sections or subheadings with bullet points or generic phrasing
-   - Use bullet lists or tables only after sufficient paragraph setup
-   - Tables should have defined columns (e.g., Feature, Benefit, Product Name, Price, Link)
-   - Blockquotes should contain expert insight, best practices, or unique POV
-   - Ensure each section varies in tone and structure from others
-
-3. QUALITY & DEPTH:
-   - Write for depth and uniqueness, not surface-level filler
-   - Use primary keyword in title, intro, and at least 2 H2 sections
-   - Use secondary keywords naturally throughout outline
-   - Suggest informative, useful angles that solve a real problem or offer unique value
-   - Avoid repeated structure across all ideas — each outline should feel hand-edited
-
-==========================
-TONE & FLOW REQUIREMENTS
-==========================
-
-- Maintain a professional, editorial tone — not robotic or templated
-- No generic intros like \"In today's article…\"
-- Begin sections with direct, engaging sentences — not summaries of the heading
-- Use real-world examples, relevant context, or recent data wherever useful
-- Include ideas that could incorporate user intent like tutorials, comparisons, or decision support
-
-==========================
-FINAL RETURN FORMAT (JSON)
-==========================
-{
-  \"ideas\": [
-    {
-      \"title\": \"Best Organic Cotton Duvet Covers for All Seasons\",
-      \"description\": {
-        \"introduction\": {
-          \"hook\": \"Transform your sleep with organic cotton that blends comfort and sustainability.\",
-          \"paragraphs\": [
-            {
-              \"content_type\": \"paragraph\",
-              \"details\": \"Overview of organic cotton's rise in bedding industry.\"
-            },
-            {
-              \"content_type\": \"paragraph\",
-              \"details\": \"Why consumers prefer organic bedding over synthetic alternatives.\"
-            }
-          ]
-        },
-        \"H2\": [
-          {
-            \"heading\": \"Why Choose Organic Cotton for Bedding?\",
-            \"subsections\": [
-              {
-                \"subheading\": \"Health and Skin Benefits\",
-                \"content_type\": \"paragraph\",
-                \"details\": \"Discuss hypoallergenic and chemical-free aspects.\"
-              },
-              {
-                \"subheading\": \"Environmental Sustainability\",
-                \"content_type\": \"list\",
-                \"details\": \"Bullet list of eco benefits like low water use, no pesticides.\"
-              },
-              {
-                \"subheading\": \"Long-Term Cost Savings\",
-                \"content_type\": \"table\",
-                \"details\": \"Table comparing durability and pricing over time.\"
-              }
-            ]
-          },
-          {
-            \"heading\": \"Top Organic Cotton Duvet Brands\",
-            \"subsections\": [
-              {
-                \"subheading\": \"Brand 1 Overview\",
-                \"content_type\": \"paragraph\",
-                \"details\": \"Description of features, pricing, and audience fit.\"
-              },
-              {
-                \"subheading\": \"Brand 2 Overview\",
-                \"content_type\": \"paragraph\",
-                \"details\": \"Highlight what makes this brand stand out.\"
-              },
-              {
-                \"subheading\": \"Quick Comparison Table\",
-                \"content_type\": \"table\",
-                \"details\": \"Side-by-side feature and price comparison.\"
-              }
-            ]
-          }
-        ]
-      },
-      \"content_type\": \"post\",
-      \"content_structure\": \"review\",
-      \"cluster_id\": 12,
-      \"estimated_word_count\": 1800,
-      \"covered_keywords\": \"organic duvet covers, eco-friendly bedding, sustainable sheets\"
-    }
-  ]
-}
-
-==============================
-NOTES FOR EXECUTION ENGINE
-==============================
-
-- Make sure all outlines follow this structure and are unique in flow and format.
-- Do not reuse same outline patterns across ideas.
-- Emphasize depth, paragraph-first formatting, and mixed content presentation.
-- Ensure final output is usable by long-form AI content systems and human writers alike.";
-}
-
-/**
- * Default content generation prompt template
- */
-function igny8_content_generation_prompt() {
-    return "You are an editorial content strategist. Your task is to generate a complete JSON response object that includes all the fields listed below, based on the provided content idea, keyword cluster, and keyword list.
-
-Only the `content` field should contain HTML. All other fields must be plain JSON values.
-
-==================
-CONTENT OBJECT STRUCTURE
-==================
-
-{
-  \"title\": \"[Auto-generate a compelling blog title using the primary keyword]\",
-  \"meta_title\": \"[SEO-optimized meta title under 60 characters]\",
-  \"meta_description\": \"[SEO-friendly summary under 160 characters]\",
-  \"content\": \"[HTML body — see structure rules below]\",
-  \"word_count\": [Exact word count of the HTML content],
-  \"primary_keyword\": \"[Provided primary keyword]\",
-  \"secondary_keywords\": [List of provided secondary keywords],
-  \"keywords_used\": [List of all keywords actually used in the HTML content],
-  \"tags\": [List of 5 lowercase tags (2–4 words each)],
-  \"categories\": [\"Parent > Child\", \"Optional 2nd category if needed\"],
-  [IMAGE_PROMPTS]
-}
-
-===========================
-CONTENT FORMAT & STRUCTURE
-===========================
-
-- Use only valid WP-supported HTML blocks: <h2>, <h3>, <p>, <ul>/<ol>, and <table>
-- Do not add extra line breaks, empty tags, or inconsistent spacing
-- Use proper table structure when using tables:
-<table>
-<thead>
-    <tr><th>col heading1</th><th>col heading2</th></tr>
-</thead>
-<tbody>
-    <tr>
-        <td>cell1</td><td>cell2</td>
-    </tr>
-</tbody>
-</table>
-
-===========================
-CONTENT FLOW RULES
-===========================
-
-**INTRODUCTION:**
-- Start with 1 italicized hook (30–40 words)
-- Follow with 2 narrative paragraphs (each 50–60 words; 2–3 sentences max)
-- No headings allowed in intro
-
-**H2 SECTIONS (5–8 total):**
-Each section should be 250–300 words and follow this format:
-1. Two narrative paragraphs (80–120 words each, 2–3 sentences)
-2. One list or table (must come *after* a paragraph)
-3. Optional closing paragraph (40–60 words)
-4. Insert 2–3 <h3> subsections naturally after main paragraphs
-
-**Formatting Rules:**
-- Vary use of unordered lists, ordered lists, and tables across sections
-- Never begin any section or sub-section with a list or table
-
-===========================
-KEYWORD & SEO RULES
-===========================
-
-- **Primary keyword** must appear in:
-  - The title
-  - First paragraph of the introduction
-  - At least 2 H2 headings
-
-- **Secondary keywords** must be used naturally, not forced
-
-- **Tone & style guidelines:**
-  - No robotic or passive voice
-  - Avoid generic intros like \"In today's world…\"
-  - Don't repeat heading in opening sentence
-  - Vary sentence structure and length
-
-===========================
-IMAGE PROMPT RULES
-===========================
-
-- Provide detailed, specific, and relevant image prompts
-- Each prompt should reflect the topic/subtopic in that section
-- Avoid vague or generic prompts
-
-===========================
-INPUT VARIABLES
-===========================
-
-CONTENT IDEA DETAILS:
-[IGNY8_IDEA]
-
-KEYWORD CLUSTER:
-[IGNY8_CLUSTER]
-
-ASSOCIATED KEYWORDS:
-[IGNY8_KEYWORDS]
-
-===========================
-OUTPUT FORMAT
-===========================
-
-Return ONLY the final JSON object.  
-Do NOT include any comments, formatting, or explanations.";
-}

igny8-ai-seo-wp-plugin/ai/runware-api.php

@@ -1,191 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : runware-api.php
- * @location     : /ai/runware-api.php
- * @type         : AI Integration
- * @scope        : Global
- * @allowed      : Runware API calls, image generation, AI processing
- * @reusability  : Globally Reusable
- * @notes        : Runware image generation API integration
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Generate image using Runware API
- * 
- * @param string $prompt The image generation prompt
- * @param string $model The Runware model to use (default: gen3a_turbo)
- * @return array|WP_Error Response data or error
- */
-function igny8_runway_generate_image($prompt, $model = 'gen3a_turbo') {
-    $api_key = get_option('igny8_runware_api_key', '');
-    
-    if (empty($api_key)) {
-        return new WP_Error('no_api_key', 'Runware API key not configured');
-    }
-    
-    $url = 'https://api.runwayml.com/v1/image/generations';
-    
-    $headers = [
-        'Authorization' => 'Bearer ' . $api_key,
-        'Content-Type' => 'application/json',
-    ];
-    
-    $body = [
-        'model' => $model,
-        'prompt' => $prompt,
-        'size' => '1024x1024',
-        'quality' => 'standard',
-        'n' => 1
-    ];
-    
-    $args = [
-        'method' => 'POST',
-        'headers' => $headers,
-        'body' => json_encode($body),
-        'timeout' => 60,
-    ];
-    
-    $response = wp_remote_post($url, $args);
-    
-    if (is_wp_error($response)) {
-        igny8_log_ai_event('runway_api_error', 'error', [
-            'message' => $response->get_error_message(),
-            'prompt' => $prompt,
-            'model' => $model
-        ]);
-        return $response;
-    }
-    
-    $response_code = wp_remote_retrieve_response_code($response);
-    $response_body = wp_remote_retrieve_body($response);
-    $response_data = json_decode($response_body, true);
-    
-    if ($response_code !== 200) {
-        $error_message = isset($response_data['error']['message']) ? $response_data['error']['message'] : 'Unknown error';
-        igny8_log_ai_event('runway_api_error', 'error', [
-            'code' => $response_code,
-            'message' => $error_message,
-            'prompt' => $prompt,
-            'model' => $model
-        ]);
-        return new WP_Error('api_error', $error_message);
-    }
-    
-    // Log successful API call
-    igny8_log_ai_event('runway_api_success', 'success', [
-        'model' => $model,
-        'prompt_length' => strlen($prompt),
-        'cost' => 0.009, // Runware pricing
-        'service' => 'runware'
-    ]);
-    
-    return $response_data;
-}
-
-/**
- * Download and save image from Runware response
- * 
- * @param array $response_data The API response data
- * @param string $filename The desired filename
- * @return string|WP_Error Saved file path or error
- */
-function igny8_runway_save_image($response_data, $filename) {
-    if (!isset($response_data['data'][0]['url'])) {
-        return new WP_Error('no_image_url', 'No image URL in response');
-    }
-    
-    $image_url = $response_data['data'][0]['url'];
-    
-    // Create uploads directory
-    $upload_dir = wp_upload_dir();
-    $igny8_dir = $upload_dir['basedir'] . '/igny8-ai-images/';
-    
-    if (!file_exists($igny8_dir)) {
-        wp_mkdir_p($igny8_dir);
-    }
-    
-    // Download image
-    $image_response = wp_remote_get($image_url);
-    
-    if (is_wp_error($image_response)) {
-        return $image_response;
-    }
-    
-    $image_data = wp_remote_retrieve_body($image_response);
-    $file_path = $igny8_dir . $filename;
-    
-    $saved = file_put_contents($file_path, $image_data);
-    
-    if ($saved === false) {
-        return new WP_Error('save_failed', 'Failed to save image file');
-    }
-    
-    return $file_path;
-}
-
-/**
- * Test Runware API connection
- * 
- * @return array Test result
- */
-function igny8_test_runway_connection() {
-    $test_prompt = 'A simple test image: a red circle on white background';
-    
-    $response = igny8_runway_generate_image($test_prompt);
-    
-    if (is_wp_error($response)) {
-        return [
-            'success' => false,
-            'message' => $response->get_error_message(),
-            'details' => 'Runware API connection failed'
-        ];
-    }
-    
-    return [
-        'success' => true,
-        'message' => 'Runware API connection successful',
-        'details' => 'Test image generation completed successfully'
-    ];
-}
-
-/**
- * Get available Runware models
- * 
- * @return array Available models
- */
-function igny8_get_runway_models() {
-    return [
-        'gen3a_turbo' => [
-            'name' => 'Gen-3 Alpha Turbo',
-            'description' => 'Fast, high-quality image generation',
-            'cost' => 0.055
-        ],
-        'gen3a' => [
-            'name' => 'Gen-3 Alpha',
-            'description' => 'Standard quality image generation',
-            'cost' => 0.055
-        ]
-    ];
-}
-
-/**
- * Log AI event for Runway API
- * 
- * @param string $event Event type
- * @param string $status Success/error status
- * @param array $context Additional context data
- */
-function igny8_log_runway_event($event, $status, $context = []) {
-    igny8_log_ai_event($event, $status, array_merge($context, [
-        'service' => 'runware',
-        'timestamp' => current_time('mysql')
-    ]));
-}

igny8-ai-seo-wp-plugin/ai/writer/images/image-generation.php

@@ -1,534 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : image-generation.php
- * @location     : /ai/writer/images/image-generation.php
- * @type         : AI Integration
- * @scope        : Global
- * @allowed      : Image generation, AI processing, media creation
- * @reusability  : Globally Reusable
- * @notes        : Image generation functions for all modules
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Generate featured image for post from post meta prompt
- * 
- * @param int $post_id WordPress post ID
- * @param string $image_size_type Type of image size to use (featured, desktop, mobile)
- * @return array Result with success status and attachment_id or error
- */
-function igny8_generate_featured_image_for_post($post_id, $image_size_type = 'featured') {
-    // Get post
-    $post = get_post($post_id);
-    if (!$post) {
-        return ['success' => false, 'error' => 'Post not found'];
-    }
-
-    // Get featured image prompt from post meta
-    $featured_image_prompt = get_post_meta($post_id, '_igny8_featured_image_prompt', true);
-    
-    if (empty($featured_image_prompt)) {
-        return ['success' => false, 'error' => 'No featured image prompt found in post meta'];
-    }
-
-    // Get image generation settings from prompts page
-    $image_type = get_option('igny8_image_type', 'realistic');
-    $image_service = get_option('igny8_image_service', 'openai');
-    $image_format = get_option('igny8_image_format', 'jpg');
-    $negative_prompt = get_option('igny8_negative_prompt', 'text, watermark, logo, overlay, title, caption, writing on walls, writing on objects, UI, infographic elements, post title');
-    
-    // Get image model settings based on service
-    $image_model = get_option('igny8_image_model', 'dall-e-3');
-    $runware_model = get_option('igny8_runware_model', 'runware:97@1');
-    $prompt_template = wp_unslash(get_option('igny8_image_prompt_template', 'Create a high-quality {image_type} image to use as a featured photo for a blog post titled "{post_title}". The image should visually represent the theme, mood, and subject implied by the image prompt: {image_prompt}. Focus on a realistic, well-composed scene that naturally communicates the topic without text or logos. Use balanced lighting, pleasing composition, and photographic detail suitable for lifestyle or editorial web content. Avoid adding any visible or readable text, brand names, or illustrative effects. **And make sure image is not blurry.**'));
-    
-    // Get dimensions based on image size type and service
-    $dimensions = igny8_get_image_dimensions($image_size_type, $image_service);
-    $image_width = $dimensions['width'];
-    $image_height = $dimensions['height'];
-
-    // Get API keys
-    $openai_key = get_option('igny8_api_key', '');
-    $runware_key = get_option('igny8_runware_api_key', '');
-    
-    $required_key = ($image_service === 'runware') ? $runware_key : $openai_key;
-    if (empty($required_key)) {
-        return ['success' => false, 'error' => ($image_service === 'runware' ? 'Runware' : 'OpenAI') . ' API key not configured'];
-    }
-
-    // Build final prompt
-    $prompt = str_replace(
-        ['{image_type}', '{post_title}', '{image_prompt}'],
-        [$image_type, $post->post_title, $featured_image_prompt],
-        $prompt_template
-    );
-
-    try {
-        // Event 7: API request sent
-        error_log('Igny8: IMAGE_GEN_EVENT_7 - API request sent to ' . $image_service . ' for post: ' . $post_id);
-        
-        if ($image_service === 'runware') {
-            // Runware API Call
-            $payload = [
-                [
-                    'taskType' => 'authentication',
-                    'apiKey' => $runware_key
-                ],
-                [
-                    'taskType' => 'imageInference',
-                    'taskUUID' => wp_generate_uuid4(),
-                    'positivePrompt' => $prompt,
-                    'negativePrompt' => $negative_prompt,
-                    'model' => $runware_model,
-                    'width' => $image_width,
-                    'height' => $image_height,
-                    'steps' => 30,
-                    'CFGScale' => 7.5,
-                    'numberResults' => 1,
-                    'outputFormat' => $image_format
-                ]
-            ];
-            
-            $response = wp_remote_post('https://api.runware.ai/v1', [
-                'headers' => ['Content-Type' => 'application/json'],
-                'body' => json_encode($payload),
-                'timeout' => 150, // Increased to 150 seconds for image generation
-                'httpversion' => '1.1',
-                'sslverify' => true
-            ]);
-            
-            if (is_wp_error($response)) {
-                error_log('Igny8: IMAGE_GEN_ERROR - Runware API request failed: ' . $response->get_error_message());
-                return ['success' => false, 'error' => 'Runware API Error: ' . $response->get_error_message()];
-            }
-            
-            $response_body = wp_remote_retrieve_body($response);
-            $response_data = json_decode($response_body, true);
-            
-            error_log('Igny8: IMAGE_GEN - Runware API response: ' . substr($response_body, 0, 200));
-            
-            if (isset($response_data['data'][0]['imageURL'])) {
-                $image_url = $response_data['data'][0]['imageURL'];
-                
-                // Event 8: Image URL received
-                error_log('Igny8: IMAGE_GEN_EVENT_8 - Image URL received from ' . $image_service . ' for post: ' . $post_id);
-                
-                // Generate filename
-                $filename = sanitize_file_name($post->post_title) . '_featured_' . time() . '.' . $image_format;
-                
-                // Event 9: Image saved to WordPress
-                error_log('Igny8: IMAGE_GEN_EVENT_9 - Saving image to WordPress for post: ' . $post_id);
-                
-                // Download image from Runware URL
-                require_once(ABSPATH . 'wp-admin/includes/media.php');
-                require_once(ABSPATH . 'wp-admin/includes/file.php');
-                require_once(ABSPATH . 'wp-admin/includes/image.php');
-                
-                error_log('Igny8: IMAGE_GEN - Downloading image from URL: ' . $image_url);
-                $temp_file = download_url($image_url);
-                
-                if (is_wp_error($temp_file)) {
-                    error_log('Igny8: IMAGE_GEN_EVENT_9_ERROR - Failed to download image: ' . $temp_file->get_error_message());
-                    return ['success' => false, 'error' => 'Failed to download image: ' . $temp_file->get_error_message()];
-                }
-                
-                error_log('Igny8: IMAGE_GEN - Image downloaded to temp file: ' . $temp_file);
-                
-                // Prepare file array for media_handle_sideload
-                $file_array = [
-                    'name' => $filename,
-                    'tmp_name' => $temp_file
-                ];
-                
-                // Upload to WordPress media library
-                error_log('Igny8: IMAGE_GEN - Uploading to media library with media_handle_sideload');
-                $attachment_id = media_handle_sideload($file_array, $post_id, $post->post_title . ' Featured Image');
-                
-                // Clean up temp file
-                if (file_exists($temp_file)) {
-                    @unlink($temp_file);
-                }
-                
-                if (is_wp_error($attachment_id)) {
-                    error_log('Igny8: IMAGE_GEN_EVENT_9_ERROR - media_handle_sideload failed: ' . $attachment_id->get_error_message());
-                    return ['success' => false, 'error' => 'Failed to upload image: ' . $attachment_id->get_error_message()];
-                }
-                
-                error_log('Igny8: IMAGE_GEN - Successfully created attachment ID: ' . $attachment_id);
-                
-                if (!is_wp_error($attachment_id)) {
-                    // Set as featured image
-                    set_post_thumbnail($post_id, $attachment_id);
-                    
-                    // Generate attachment metadata
-                    $attachment_data = wp_generate_attachment_metadata($attachment_id, get_attached_file($attachment_id));
-                    wp_update_attachment_metadata($attachment_id, $attachment_data);
-                    
-                    // Get attachment URL
-                    $attachment_url = wp_get_attachment_url($attachment_id);
-                    
-                    error_log('Igny8: IMAGE_GEN_EVENT_9_SUCCESS - Image saved successfully, attachment ID: ' . $attachment_id);
-                    
-                    return [
-                        'success' => true,
-                        'attachment_id' => $attachment_id,
-                        'image_url' => $attachment_url,
-                        'provider' => 'runware'
-                    ];
-                } else {
-                    error_log('Igny8: IMAGE_GEN_EVENT_9_ERROR - Failed to save image: ' . $attachment_id->get_error_message());
-                    return ['success' => false, 'error' => 'Failed to register image: ' . $attachment_id->get_error_message()];
-                }
-            } else {
-                error_log('Igny8: IMAGE_GEN_EVENT_8_ERROR - No image URL in response');
-                $error_msg = isset($response_data['errors'][0]['message']) ? $response_data['errors'][0]['message'] : 'Unknown Runware API error';
-                return ['success' => false, 'error' => $error_msg];
-            }
-        } else {
-            // OpenAI API Call with selected model
-            $data = [
-                'model' => $image_model,
-                'prompt' => $prompt,
-                'n' => 1,
-                'size' => $image_width . 'x' . $image_height
-            ];
-            
-            $args = [
-                'headers' => [
-                    'Content-Type' => 'application/json',
-                    'Authorization' => 'Bearer ' . $openai_key,
-                ],
-                'body' => json_encode($data),
-                'timeout' => 60,
-            ];
-            
-            $response = wp_remote_post('https://api.openai.com/v1/images/generations', $args);
-        
-            if (is_wp_error($response)) {
-                return ['success' => false, 'error' => 'OpenAI API Error: ' . $response->get_error_message()];
-            }
-            
-            $response_code = wp_remote_retrieve_response_code($response);
-            $response_body = wp_remote_retrieve_body($response);
-            
-            if ($response_code === 200) {
-                $body = json_decode($response_body, true);
-                if (isset($body['data'][0]['url'])) {
-                    $image_url = $body['data'][0]['url'];
-                    $revised_prompt = $body['data'][0]['revised_prompt'] ?? null;
-                    
-                    // Generate filename (OpenAI always returns PNG)
-                    $filename = sanitize_file_name($post->post_title) . '_featured_' . time() . '.png';
-                    
-                    // Download and register in WordPress Media Library
-                    $attachment_id = wp_insert_attachment([
-                        'post_mime_type' => 'image/png',
-                        'post_title' => $post->post_title . ' Featured Image',
-                        'post_content' => '',
-                        'post_status' => 'inherit'
-                    ], $image_url, $post_id);
-                    
-                    if (!is_wp_error($attachment_id)) {
-                        // Set as featured image
-                        set_post_thumbnail($post_id, $attachment_id);
-                        
-                        // Get attachment URL
-                        $attachment_url = wp_get_attachment_url($attachment_id);
-                        
-                        return [
-                            'success' => true,
-                            'attachment_id' => $attachment_id,
-                            'image_url' => $attachment_url,
-                            'provider' => 'openai',
-                            'revised_prompt' => $revised_prompt
-                        ];
-                    } else {
-                        return ['success' => false, 'error' => 'Failed to register image: ' . $attachment_id->get_error_message()];
-                    }
-                }
-            } else {
-                return ['success' => false, 'error' => 'HTTP ' . $response_code . ' error'];
-            }
-        }
-    } catch (Exception $e) {
-        return ['success' => false, 'error' => 'Exception: ' . $e->getMessage()];
-    }
-    
-    return ['success' => false, 'error' => 'Unknown error occurred'];
-}
-
-/**
- * Generate single article image for post from post meta prompts
- * 
- * @param int $post_id WordPress post ID
- * @param string $device_type Device type: 'desktop' or 'mobile'
- * @param int $index Image index (1-based)
- * @return array Result with success status and attachment_id or error
- */
-function igny8_generate_single_article_image($post_id, $device_type = 'desktop', $index = 1) {
-    // Get post
-    $post = get_post($post_id);
-    if (!$post) {
-        return ['success' => false, 'error' => 'Post not found'];
-    }
-
-    // Get article image prompts from post meta
-    $article_images_data = get_post_meta($post_id, '_igny8_article_images_data', true);
-    
-    // Debug: Log the raw data to see what's actually stored
-    error_log('IGNY8 DEBUG: Raw article_images_data: ' . substr($article_images_data, 0, 200) . '...');
-    
-    $article_images = json_decode($article_images_data, true);
-    
-    // Check for JSON decode errors
-    if (json_last_error() !== JSON_ERROR_NONE) {
-        error_log('IGNY8 DEBUG: JSON decode error: ' . json_last_error_msg());
-        error_log('IGNY8 DEBUG: Raw data causing error: ' . $article_images_data);
-        
-        // Try to clean the data by stripping HTML tags
-        $cleaned_data = wp_strip_all_tags($article_images_data);
-        $article_images = json_decode($cleaned_data, true);
-        
-        if (json_last_error() !== JSON_ERROR_NONE) {
-            error_log('IGNY8 DEBUG: Still invalid JSON after cleaning: ' . json_last_error_msg());
-            return ['success' => false, 'error' => 'Invalid JSON in article images data: ' . json_last_error_msg()];
-        } else {
-            error_log('IGNY8 DEBUG: Successfully cleaned and parsed JSON');
-        }
-    }
-    
-    if (empty($article_images) || !is_array($article_images)) {
-        return ['success' => false, 'error' => 'No article image prompts found in post meta'];
-    }
-
-    // Find the prompt for the requested index
-    $image_key = 'prompt-img-' . $index;
-    $prompt = '';
-    
-    foreach ($article_images as $image_data) {
-        if (isset($image_data[$image_key])) {
-            $prompt = $image_data[$image_key];
-            break;
-        }
-    }
-    
-    if (empty($prompt)) {
-        return ['success' => false, 'error' => 'No prompt found for image index ' . $index];
-    }
-
-    // Get image generation settings
-    $image_type = get_option('igny8_image_type', 'realistic');
-    $image_service = get_option('igny8_image_service', 'openai');
-    $image_format = get_option('igny8_image_format', 'jpg');
-    $negative_prompt = get_option('igny8_negative_prompt', 'text, watermark, logo, overlay, title, caption, writing on walls, writing on objects, UI, infographic elements, post title');
-    
-    // Get image model settings based on service
-    $image_model = get_option('igny8_image_model', 'dall-e-3');
-    $runware_model = get_option('igny8_runware_model', 'runware:97@1');
-    
-    // Get dimensions based on device type and service
-    $dimensions = igny8_get_image_dimensions($device_type, $image_service);
-    $image_width = $dimensions['width'];
-    $image_height = $dimensions['height'];
-
-    // Get API keys
-    $openai_key = get_option('igny8_api_key', '');
-    $runware_key = get_option('igny8_runware_api_key', '');
-    
-    $required_key = ($image_service === 'runware') ? $runware_key : $openai_key;
-    if (empty($required_key)) {
-        return ['success' => false, 'error' => ($image_service === 'runware' ? 'Runware' : 'OpenAI') . ' API key not configured'];
-    }
-
-    // Enhance prompt if needed
-    $full_prompt = $prompt;
-    if (strlen($prompt) < 50 || strpos($prompt, 'Create') !== 0) {
-        $section = "Section " . $index;
-        $full_prompt = "Create a high-quality {$image_type} image for the section titled '{$section}'. {$prompt}";
-    }
-
-    try {
-        error_log('Igny8: ARTICLE_IMAGE_GEN - Generating ' . $device_type . ' image for post: ' . $post_id . ', index: ' . $index);
-        
-        if ($image_service === 'runware') {
-            // Runware API Call
-            $payload = [
-                [
-                    'taskType' => 'authentication',
-                    'apiKey' => $runware_key
-                ],
-                [
-                    'taskType' => 'imageInference',
-                    'taskUUID' => wp_generate_uuid4(),
-                    'positivePrompt' => $full_prompt,
-                    'negativePrompt' => $negative_prompt,
-                    'model' => $runware_model,
-                    'width' => $image_width,
-                    'height' => $image_height,
-                    'steps' => 30,
-                    'CFGScale' => 7.5,
-                    'numberResults' => 1,
-                    'outputFormat' => $image_format
-                ]
-            ];
-            
-            $response = wp_remote_post('https://api.runware.ai/v1', [
-                'headers' => ['Content-Type' => 'application/json'],
-                'body' => json_encode($payload),
-                'timeout' => 150,
-                'httpversion' => '1.1',
-                'sslverify' => true
-            ]);
-            
-            if (is_wp_error($response)) {
-                error_log('Igny8: ARTICLE_IMAGE_GEN_ERROR - Runware API request failed: ' . $response->get_error_message());
-                return ['success' => false, 'error' => 'Runware API Error: ' . $response->get_error_message()];
-            }
-            
-            $response_body = wp_remote_retrieve_body($response);
-            $response_data = json_decode($response_body, true);
-            
-            if (isset($response_data['data'][0]['imageURL'])) {
-                $image_url = $response_data['data'][0]['imageURL'];
-                
-                // Generate filename
-                $filename = sanitize_file_name($post->post_title) . '_' . $device_type . '_' . $index . '_' . time() . '.' . $image_format;
-                
-                // Download image from Runware URL
-                require_once(ABSPATH . 'wp-admin/includes/media.php');
-                require_once(ABSPATH . 'wp-admin/includes/file.php');
-                require_once(ABSPATH . 'wp-admin/includes/image.php');
-                
-                $temp_file = download_url($image_url);
-                
-                if (is_wp_error($temp_file)) {
-                    return ['success' => false, 'error' => 'Failed to download image: ' . $temp_file->get_error_message()];
-                }
-                
-                // Prepare file array for media_handle_sideload
-                $file_array = [
-                    'name' => $filename,
-                    'tmp_name' => $temp_file
-                ];
-                
-                // Upload to WordPress media library
-                $attachment_id = media_handle_sideload($file_array, $post_id, $post->post_title . ' ' . ucfirst($device_type) . ' Image ' . $index);
-                
-                // Clean up temp file
-                if (file_exists($temp_file)) {
-                    @unlink($temp_file);
-                }
-                
-                if (is_wp_error($attachment_id)) {
-                    return ['success' => false, 'error' => 'Failed to upload image: ' . $attachment_id->get_error_message()];
-                }
-                
-                // Generate attachment metadata
-                $attachment_data = wp_generate_attachment_metadata($attachment_id, get_attached_file($attachment_id));
-                wp_update_attachment_metadata($attachment_id, $attachment_data);
-                
-                // Add custom metadata
-                update_post_meta($attachment_id, '_igny8_image_type', $device_type);
-                update_post_meta($attachment_id, '_igny8_provider', 'runware');
-                update_post_meta($attachment_id, '_igny8_section', 'Section ' . $index);
-                
-                // Get attachment URL
-                $attachment_url = wp_get_attachment_url($attachment_id);
-                
-                error_log('Igny8: ARTICLE_IMAGE_GEN_SUCCESS - ' . $device_type . ' image generated, attachment ID: ' . $attachment_id);
-                
-                return [
-                    'success' => true,
-                    'attachment_id' => $attachment_id,
-                    'image_url' => $attachment_url,
-                    'provider' => 'runware',
-                    'device_type' => $device_type,
-                    'index' => $index
-                ];
-            } else {
-                $error_msg = isset($response_data['errors'][0]['message']) ? $response_data['errors'][0]['message'] : 'Unknown Runware API error';
-                return ['success' => false, 'error' => $error_msg];
-            }
-        } else {
-            // OpenAI API Call with selected model
-            $data = [
-                'model' => $image_model,
-                'prompt' => $full_prompt,
-                'n' => 1,
-                'size' => '1024x1024' // OpenAI only supports square
-            ];
-            
-            $args = [
-                'headers' => [
-                    'Content-Type' => 'application/json',
-                    'Authorization' => 'Bearer ' . $openai_key,
-                ],
-                'body' => json_encode($data),
-                'timeout' => 60,
-            ];
-            
-            $response = wp_remote_post('https://api.openai.com/v1/images/generations', $args);
-        
-            if (is_wp_error($response)) {
-                return ['success' => false, 'error' => 'OpenAI API Error: ' . $response->get_error_message()];
-            }
-            
-            $response_code = wp_remote_retrieve_response_code($response);
-            $response_body = wp_remote_retrieve_body($response);
-            
-            if ($response_code === 200) {
-                $body = json_decode($response_body, true);
-                if (isset($body['data'][0]['url'])) {
-                    $image_url = $body['data'][0]['url'];
-                    $revised_prompt = $body['data'][0]['revised_prompt'] ?? null;
-                    
-                    // Generate filename (OpenAI always returns PNG)
-                    $filename = sanitize_file_name($post->post_title) . '_' . $device_type . '_' . $index . '_' . time() . '.png';
-                    
-                    // Download and register in WordPress Media Library
-                    $attachment_id = wp_insert_attachment([
-                        'post_mime_type' => 'image/png',
-                        'post_title' => $post->post_title . ' ' . ucfirst($device_type) . ' Image ' . $index,
-                        'post_content' => '',
-                        'post_status' => 'inherit'
-                    ], $image_url, $post_id);
-                    
-                    if (!is_wp_error($attachment_id)) {
-                        // Add custom metadata
-                        update_post_meta($attachment_id, '_igny8_image_type', $device_type);
-                        update_post_meta($attachment_id, '_igny8_provider', 'openai');
-                        update_post_meta($attachment_id, '_igny8_section', 'Section ' . $index);
-                        
-                        // Get attachment URL
-                        $attachment_url = wp_get_attachment_url($attachment_id);
-                        
-                        return [
-                            'success' => true,
-                            'attachment_id' => $attachment_id,
-                            'image_url' => $attachment_url,
-                            'provider' => 'openai',
-                            'device_type' => $device_type,
-                            'index' => $index,
-                            'revised_prompt' => $revised_prompt
-                        ];
-                    } else {
-                        return ['success' => false, 'error' => 'Failed to register image: ' . $attachment_id->get_error_message()];
-                    }
-                }
-            } else {
-                return ['success' => false, 'error' => 'HTTP ' . $response_code . ' error'];
-            }
-        }
-    } catch (Exception $e) {
-        return ['success' => false, 'error' => 'Exception: ' . $e->getMessage()];
-    }
-    
-    return ['success' => false, 'error' => 'Unknown error occurred'];
-}

igny8-ai-seo-wp-plugin/assets/css/image-injection.css

@@ -1,51 +0,0 @@
-/**
- * Igny8 Image Injection CSS
- * 
- * Responsive image display styles for marker-based image injection
- * 
- * @package Igny8
- * @version 1.0.0
- */
-
-/* Desktop and larger screens (769px+) */
-@media (min-width: 769px) {
-  .igny8-article-image-desktop { 
-    display: block !important; 
-  }
-  .igny8-article-image-mobile { 
-    display: none !important; 
-  }
-}
-
-/* Mobile and smaller screens (768px and below) */
-@media (max-width: 768px) {
-  .igny8-article-image-desktop { 
-    display: none !important; 
-  }
-  .igny8-article-image-mobile { 
-    display: block !important; 
-  }
-}
-
-/* Image wrapper styling */
-.igny8-image-wrapper {
-  margin: 20px 0;
-  text-align: center;
-}
-
-.igny8-image-wrapper img {
-  max-width: 100%;
-  height: auto;
-  border-radius: 8px;
-  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
-}
-
-/* Loading state */
-.igny8-image-wrapper img[loading="lazy"] {
-  opacity: 0;
-  transition: opacity 0.3s ease;
-}
-
-.igny8-image-wrapper img[loading="lazy"].loaded {
-  opacity: 1;
-}

igny8-ai-seo-wp-plugin/assets/js/image-queue-processor.js

@@ -1,436 +0,0 @@
-/**
- * Igny8 Image Queue Processor
- * Sequential image generation with individual progress tracking
- */
-
-// Process AI Image Generation for Drafts (Sequential Image Processing with Queue Modal)
-function processAIImageGenerationDrafts(postIds) {
-    console.log('Igny8: processAIImageGenerationDrafts called with postIds:', postIds);
-    
-    // Event 1: Generate Images button clicked
-    if (window.addImageGenDebugLog) {
-        window.addImageGenDebugLog('INFO', 'Generate Images button clicked', {
-            postIds: postIds,
-            timestamp: new Date().toISOString()
-        });
-    }
-    
-    // Get image generation settings from saved options (passed via wp_localize_script)
-    const desktopEnabled = window.IGNY8_PAGE?.imageSettings?.desktop_enabled || false;
-    const mobileEnabled = window.IGNY8_PAGE?.imageSettings?.mobile_enabled || false;
-    const maxInArticleImages = window.IGNY8_PAGE?.imageSettings?.max_in_article_images || 1;
-    
-    // Event 2: Settings retrieved
-    if (window.addImageGenDebugLog) {
-        window.addImageGenDebugLog('SUCCESS', 'Settings retrieved', {
-            desktop: desktopEnabled,
-            mobile: mobileEnabled,
-            maxImages: maxInArticleImages
-        });
-    }
-    
-    // Build image queue based on settings
-    const imageQueue = [];
-    
-    postIds.forEach((postId, postIndex) => {
-        // Featured image (always)
-        imageQueue.push({
-            post_id: postId,
-            post_number: postIndex + 1,
-            type: 'featured',
-            device: '',
-            label: 'Featured Image',
-            post_title: `Post ${postIndex + 1}`
-        });
-        
-        // Desktop in-article images
-        if (desktopEnabled) {
-            for (let i = 1; i <= maxInArticleImages; i++) {
-                imageQueue.push({
-                    post_id: postId,
-                    post_number: postIndex + 1,
-                    type: 'article',
-                    device: 'desktop',
-                    index: i,
-                    label: `desktop-${i}`,
-                    section: i,
-                    post_title: `Post ${postIndex + 1}`
-                });
-            }
-        }
-        
-        // Mobile in-article images
-        if (mobileEnabled) {
-            for (let i = 1; i <= maxInArticleImages; i++) {
-                imageQueue.push({
-                    post_id: postId,
-                    post_number: postIndex + 1,
-                    type: 'article',
-                    device: 'mobile',
-                    index: i,
-                    label: `mobile-${i}`,
-                    section: i,
-                    post_title: `Post ${postIndex + 1}`
-                });
-            }
-        }
-    });
-    
-    console.log('Igny8: Image queue built:', imageQueue);
-    
-    // Show queue modal
-    showImageQueueModal(imageQueue, imageQueue.length);
-    
-    // Start processing queue
-    processImageQueue(imageQueue, 0);
-}
-
-// Show modal with image queue and individual progress bars
-function showImageQueueModal(queue, totalImages) {
-    if (window.currentProgressModal) {
-        window.currentProgressModal.remove();
-    }
-    
-    const modal = document.createElement('div');
-    modal.id = 'igny8-image-queue-modal';
-    modal.className = 'igny8-modal';
-    
-    let queueHTML = '';
-    queue.forEach((item, index) => {
-        const itemId = `queue-item-${index}`;
-        queueHTML += `
-            <div class="queue-item" id="${itemId}" data-status="pending">
-                <div style="display: flex; gap: 10px; align-items: center;">
-                    <div style="flex: 1;">
-                        <div class="queue-item-header">
-                            <span class="queue-number">${index + 1}</span>
-                            <span class="queue-label">${item.label}</span>
-                            <span class="queue-post-title">${item.post_title}</span>
-                            <span class="queue-status">⏳ Pending</span>
-                        </div>
-                        <div class="queue-progress-bar">
-                            <div class="queue-progress-fill" style="width: 0%"></div>
-                            <div class="queue-progress-text">0%</div>
-                        </div>
-                        <div class="queue-error" style="display: none;"></div>
-                    </div>
-                    <div class="queue-thumbnail" style="width: 75px; height: 75px; background: #f0f0f0; border-radius: 4px; display: flex; align-items: center; justify-content: center; overflow: hidden; flex-shrink: 0;">
-                        <span style="color: #999; font-size: 11px;">No image</span>
-                    </div>
-                </div>
-            </div>
-        `;
-    });
-    
-    modal.innerHTML = `
-        <div class="igny8-modal-content" style="max-width: 950px; max-height: 80vh; overflow-y: auto;">
-            <div class="igny8-modal-header">
-                <h3>🎨 Generating Images</h3>
-                <p style="margin: 5px 0; color: var(--text-light);">Total: ${totalImages} images in queue</p>
-            </div>
-            <div class="igny8-modal-body">
-                <div class="image-queue-container">
-                    ${queueHTML}
-                </div>
-            </div>
-        </div>
-        <style>
-            .queue-item {
-                margin-bottom: 12px;
-                padding: 12px;
-                background: var(--panel-2);
-                border-radius: 8px;
-                border: 1px solid var(--border);
-            }
-            .queue-item[data-status="processing"] {
-                background: rgba(59, 130, 246, 0.1);
-                border-color: rgb(59, 130, 246);
-            }
-            .queue-item[data-status="completed"] {
-                background: rgba(16, 185, 129, 0.1);
-                border-color: rgb(16, 185, 129);
-            }
-            .queue-item[data-status="failed"] {
-                background: rgba(239, 68, 68, 0.1);
-                border-color: rgb(239, 68, 68);
-            }
-            .queue-item-header {
-                display: flex;
-                align-items: center;
-                gap: 10px;
-                margin-bottom: 8px;
-                font-size: 13px;
-            }
-            .queue-number {
-                background: rgb(59, 130, 246);
-                color: white;
-                width: 24px;
-                height: 24px;
-                border-radius: 50%;
-                display: flex;
-                align-items: center;
-                justify-content: center;
-                font-size: 11px;
-                font-weight: bold;
-            }
-            .queue-label {
-                font-weight: 600;
-            }
-            .queue-post-title {
-                flex: 1;
-                font-size: 12px;
-                opacity: 0.7;
-            }
-            .queue-status {
-                font-size: 12px;
-                font-weight: 600;
-            }
-            .queue-progress-bar {
-                height: 20px;
-                background: rgba(0,0,0,0.1);
-                border-radius: 10px;
-                overflow: hidden;
-                position: relative;
-            }
-            .queue-progress-fill {
-                height: 100%;
-                background: rgb(59, 130, 246);
-                transition: width 0.3s ease;
-            }
-            .queue-progress-text {
-                position: absolute;
-                top: 50%;
-                left: 50%;
-                transform: translate(-50%, -50%);
-                font-size: 11px;
-                font-weight: bold;
-                color: #333;
-                text-shadow: 0 0 3px rgba(255,255,255,0.8);
-            }
-            .queue-item[data-status="completed"] .queue-progress-fill {
-                background: rgb(16, 185, 129);
-            }
-            .queue-item[data-status="failed"] .queue-progress-fill {
-                background: rgb(239, 68, 68);
-            }
-            .queue-error {
-                margin-top: 8px;
-                padding: 8px;
-                background: rgba(239, 68, 68, 0.1);
-                border-left: 3px solid rgb(239, 68, 68);
-                border-radius: 4px;
-                font-size: 12px;
-            }
-        </style>
-    `;
-    
-    document.body.appendChild(modal);
-    modal.classList.add('open');
-    window.currentProgressModal = modal;
-}
-
-// Process image queue sequentially with progressive loading
-function processImageQueue(queue, currentIndex) {
-    if (currentIndex >= queue.length) {
-        // All done
-        console.log('Igny8: All images processed');
-        
-        // Log to Image Generation Debug
-        if (window.addImageGenDebugLog) {
-            window.addImageGenDebugLog('SUCCESS', 'All images processed', {
-                total: queue.length,
-                timestamp: new Date().toISOString()
-            });
-        }
-        
-        setTimeout(() => {
-            if (window.currentProgressModal) {
-                window.currentProgressModal.remove();
-                window.currentProgressModal = null;
-            }
-            showNotification('Image generation complete!', 'success');
-            
-            // Reload table
-            if (window.loadTableData && window.IGNY8_PAGE?.tableId) {
-                window.loadTableData(window.IGNY8_PAGE.tableId);
-            }
-        }, 2000);
-        return;
-    }
-    
-    const item = queue[currentIndex];
-    const itemElement = document.getElementById(`queue-item-${currentIndex}`);
-    
-    if (!itemElement) {
-        console.error('Queue item element not found:', currentIndex);
-        
-        // Log to Image Generation Debug
-        if (window.addImageGenDebugLog) {
-            window.addImageGenDebugLog('ERROR', 'Queue item element not found', {
-                index: currentIndex,
-                itemId: `queue-item-${currentIndex}`
-            });
-        }
-        
-        setTimeout(() => processImageQueue(queue, currentIndex + 1), 100);
-        return;
-    }
-    
-    // Update UI to processing
-    itemElement.setAttribute('data-status', 'processing');
-    itemElement.querySelector('.queue-status').textContent = '⏳ Generating...';
-    
-    const progressFill = itemElement.querySelector('.queue-progress-fill');
-    const progressText = itemElement.querySelector('.queue-progress-text');
-    
-    // Log to Image Generation Debug
-    if (window.addImageGenDebugLog) {
-        window.addImageGenDebugLog('INFO', `Processing ${item.label}`, {
-            postId: item.post_id,
-            type: item.type,
-            device: item.device || 'N/A',
-            index: item.index || 1,
-            queuePosition: `${currentIndex + 1}/${queue.length}`
-        });
-    }
-    
-    // Progressive loading: 50% in 7s, 75% in next 5s, then 5% every second until 95%
-    let currentProgress = 0;
-    let phase = 1;
-    let phaseStartTime = Date.now();
-    
-    const progressInterval = setInterval(() => {
-        const elapsed = Date.now() - phaseStartTime;
-        
-        if (phase === 1 && currentProgress < 50) {
-            // Phase 1: 0% to 50% in 7 seconds (7.14% per second)
-            currentProgress += 0.714;
-            if (currentProgress >= 50 || elapsed >= 7000) {
-                currentProgress = 50;
-                phase = 2;
-                phaseStartTime = Date.now();
-            }
-        } else if (phase === 2 && currentProgress < 75) {
-            // Phase 2: 50% to 75% in 5 seconds (5% per second)
-            currentProgress += 0.5;
-            if (currentProgress >= 75 || elapsed >= 5000) {
-                currentProgress = 75;
-                phase = 3;
-                phaseStartTime = Date.now();
-            }
-        } else if (phase === 3 && currentProgress < 95) {
-            // Phase 3: 75% to 95% - 5% every second
-            if (elapsed >= 1000) {
-                currentProgress = Math.min(95, currentProgress + 5);
-                phaseStartTime = Date.now();
-            }
-        }
-        
-        progressFill.style.width = currentProgress + '%';
-        progressText.textContent = Math.round(currentProgress) + '%';
-    }, 100);
-    
-    // Generate single image
-    const formData = new FormData();
-    formData.append('action', 'igny8_ai_generate_single_image');
-    formData.append('nonce', window.IGNY8_PAGE.nonce);
-    formData.append('post_id', item.post_id);
-    formData.append('type', item.type);
-    formData.append('device', item.device || '');
-    formData.append('index', item.index || 1);
-    // Add meta box integration fields
-    formData.append('image_label', item.label || '');
-    formData.append('section', item.section || '');
-    
-    fetch(window.IGNY8_PAGE.ajaxUrl, {
-        method: 'POST',
-        body: formData
-    })
-    .then(response => response.json())
-    .then(data => {
-        // Stop progressive loading
-        clearInterval(progressInterval);
-        
-        if (data.success) {
-            // Success - complete to 100%
-            progressFill.style.width = '100%';
-            progressText.textContent = '100%';
-            itemElement.setAttribute('data-status', 'completed');
-            itemElement.querySelector('.queue-status').textContent = '✅ Complete';
-            
-            // Display thumbnail if image URL is available
-            if (data.data?.image_url) {
-                const thumbnailDiv = itemElement.querySelector('.queue-thumbnail');
-                if (thumbnailDiv) {
-                    thumbnailDiv.innerHTML = `<img src="${data.data.image_url}" style="width: 100%; height: 100%; object-fit: cover; border-radius: 4px;" alt="Generated image">`;
-                }
-            }
-            
-            console.log(`✓ Image ${currentIndex + 1} generated successfully`);
-            
-            // Log to Image Generation Debug
-            if (window.addImageGenDebugLog) {
-                window.addImageGenDebugLog('SUCCESS', `${item.label} generated successfully`, {
-                    postId: item.post_id,
-                    attachmentId: data.data?.attachment_id,
-                    provider: data.data?.provider,
-                    queuePosition: `${currentIndex + 1}/${queue.length}`
-                });
-            }
-            
-            // Process next image after short delay
-            setTimeout(() => processImageQueue(queue, currentIndex + 1), 500);
-        } else {
-            // Error - show at 90%
-            progressFill.style.width = '90%';
-            progressText.textContent = 'Failed';
-            itemElement.setAttribute('data-status', 'failed');
-            itemElement.querySelector('.queue-status').textContent = '❌ Failed';
-            
-            const errorDiv = itemElement.querySelector('.queue-error');
-            errorDiv.textContent = data.data?.message || 'Unknown error';
-            errorDiv.style.display = 'block';
-            
-            console.error(`✗ Image ${currentIndex + 1} failed:`, data.data?.message);
-            
-            // Log to Image Generation Debug
-            if (window.addImageGenDebugLog) {
-                window.addImageGenDebugLog('ERROR', `${item.label} generation failed`, {
-                    postId: item.post_id,
-                    error: data.data?.message || 'Unknown error',
-                    queuePosition: `${currentIndex + 1}/${queue.length}`
-                });
-            }
-            
-            // Continue to next image despite error
-            setTimeout(() => processImageQueue(queue, currentIndex + 1), 1000);
-        }
-    })
-    .catch(error => {
-        // Exception - stop progressive loading
-        clearInterval(progressInterval);
-        
-        progressFill.style.width = '90%';
-        progressText.textContent = 'Error';
-        itemElement.setAttribute('data-status', 'failed');
-        itemElement.querySelector('.queue-status').textContent = '❌ Error';
-        
-        const errorDiv = itemElement.querySelector('.queue-error');
-        errorDiv.textContent = 'Exception: ' + error.message;
-        errorDiv.style.display = 'block';
-        
-        console.error(`✗ Image ${currentIndex + 1} exception:`, error);
-        
-        // Log to Image Generation Debug
-        if (window.addImageGenDebugLog) {
-            window.addImageGenDebugLog('ERROR', `${item.label} request exception`, {
-                postId: item.post_id,
-                error: error.message,
-                queuePosition: `${currentIndex + 1}/${queue.length}`
-            });
-        }
-        
-        // Continue to next image despite error
-        setTimeout(() => processImageQueue(queue, currentIndex + 1), 1000);
-    });
-}

igny8-ai-seo-wp-plugin/assets/shortcodes/_README.php

@@ -1,14 +0,0 @@
-<?php
-/**
- * ==============================
- * 📁 Folder Scope Declaration
- * ==============================
- * Folder: /shortcodes/
- * Purpose: All shortcode handler files (split by module)
- * Rules:
- * - Must be organized by module
- * - Each shortcode must be self-contained
- * - No cross-module dependencies
- * - Must use components for rendering
- * - Frontend-only functionality
- */

igny8-ai-seo-wp-plugin/assets/shortcodes/image-gallery.php

@@ -1,278 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : image-gallery.php
- * @location     : /assets/shortcodes/image-gallery.php
- * @type         : Shortcode
- * @scope        : Global
- * @allowed      : Shortcode registration, frontend rendering, image display
- * @reusability  : Globally Reusable
- * @notes        : Image gallery shortcodes for frontend display
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Display specific in-article image by ID
- * 
- * Usage: [igny8-image id="desktop-1"]
- * 
- * @param array $atts Shortcode attributes
- * @return string HTML output
- */
-add_shortcode('igny8-image', function($atts) {
-    $atts = shortcode_atts(['id' => ''], $atts);
-    $post_id = get_the_ID();
-    
-    if (empty($post_id)) {
-        return '';
-    }
-    
-    $images = get_post_meta($post_id, '_igny8_inarticle_images', true);
-    if (!is_array($images)) {
-        return '';
-    }
-
-    // Display specific image by ID
-    if (!empty($atts['id']) && isset($images[$atts['id']])) {
-        $image_data = $images[$atts['id']];
-        
-        // Device detection - only show if device matches
-        $is_mobile = wp_is_mobile();
-        $is_desktop = !$is_mobile;
-        
-        // Check if image should be displayed based on device
-        $should_display = false;
-        if (strpos($atts['id'], 'desktop-') === 0 && $is_desktop) {
-            $should_display = true;
-        } elseif (strpos($atts['id'], 'mobile-') === 0 && $is_mobile) {
-            $should_display = true;
-        }
-        
-        if (!$should_display) {
-            return '';
-        }
-        
-        $attachment_id = intval($image_data['attachment_id']);
-        
-        if ($attachment_id > 0) {
-            return wp_get_attachment_image($attachment_id, 'large', false, [
-                'class' => 'igny8-inarticle-image',
-                'data-image-id' => esc_attr($atts['id']),
-                'data-device' => esc_attr($image_data['device']),
-                'alt' => esc_attr($image_data['label'])
-            ]);
-        }
-    }
-
-    return '';
-});
-
-/**
- * Display all in-article images
- * 
- * Usage: [igny8-images]
- * 
- * @param array $atts Shortcode attributes
- * @return string HTML output
- */
-add_shortcode('igny8-images', function($atts) {
-    $atts = shortcode_atts([
-        'device' => '', // Filter by device type (desktop/mobile)
-        'size' => 'large', // Image size
-        'class' => 'igny8-image-gallery' // CSS class
-    ], $atts);
-    
-    $post_id = get_the_ID();
-    
-    if (empty($post_id)) {
-        return '';
-    }
-    
-    $images = get_post_meta($post_id, '_igny8_inarticle_images', true);
-    if (!is_array($images) || empty($images)) {
-        return '';
-    }
-
-    $output = '<div class="' . esc_attr($atts['class']) . '">';
-    $output .= '<p style="background: #f0f0f0; padding: 10px; border-left: 4px solid #0073aa; margin: 10px 0; font-weight: bold;">This is coming from shortcode</p>';
-    
-    foreach ($images as $label => $image_data) {
-        // Filter by device if specified
-        if (!empty($atts['device']) && $image_data['device'] !== $atts['device']) {
-            continue;
-        }
-        
-        $attachment_id = intval($image_data['attachment_id']);
-        
-        if ($attachment_id > 0) {
-            $output .= wp_get_attachment_image($attachment_id, $atts['size'], false, [
-                'class' => 'igny8-inarticle-image',
-                'data-image-id' => esc_attr($label),
-                'data-device' => esc_attr($image_data['device']),
-                'alt' => esc_attr($image_data['label'])
-            ]);
-        }
-    }
-    
-    $output .= '</div>';
-    
-    return $output;
-});
-
-/**
- * Display desktop images only
- * 
- * Usage: [igny8-desktop-images]
- * 
- * @param array $atts Shortcode attributes
- * @return string HTML output
- */
-add_shortcode('igny8-desktop-images', function($atts) {
-    $atts = shortcode_atts([
-        'size' => 'large',
-        'class' => 'igny8-desktop-gallery'
-    ], $atts);
-    
-    return do_shortcode('[igny8-images device="desktop" size="' . $atts['size'] . '" class="' . $atts['class'] . '"]');
-});
-
-/**
- * Display mobile images only
- * 
- * Usage: [igny8-mobile-images]
- * 
- * @param array $atts Shortcode attributes
- * @return string HTML output
- */
-add_shortcode('igny8-mobile-images', function($atts) {
-    $atts = shortcode_atts([
-        'size' => 'large',
-        'class' => 'igny8-mobile-gallery'
-    ], $atts);
-    
-    return do_shortcode('[igny8-images device="mobile" size="' . $atts['size'] . '" class="' . $atts['class'] . '"]');
-});
-
-/**
- * Display image count
- * 
- * Usage: [igny8-image-count]
- * 
- * @param array $atts Shortcode attributes
- * @return string HTML output
- */
-add_shortcode('igny8-image-count', function($atts) {
-    $atts = shortcode_atts(['device' => ''], $atts);
-    
-    $post_id = get_the_ID();
-    
-    if (empty($post_id)) {
-        return '0';
-    }
-    
-    $images = get_post_meta($post_id, '_igny8_inarticle_images', true);
-    if (!is_array($images)) {
-        return '0';
-    }
-    
-    if (!empty($atts['device'])) {
-        $count = 0;
-        foreach ($images as $image_data) {
-            if ($image_data['device'] === $atts['device']) {
-                $count++;
-            }
-        }
-        return (string) $count;
-    }
-    
-    return (string) count($images);
-});
-
-/**
- * Display image gallery with responsive design
- * 
- * Usage: [igny8-responsive-gallery]
- * 
- * @param array $atts Shortcode attributes
- * @return string HTML output
- */
-add_shortcode('igny8-responsive-gallery', function($atts) {
-    $atts = shortcode_atts([
-        'desktop_size' => 'large',
-        'mobile_size' => 'medium',
-        'class' => 'igny8-responsive-gallery'
-    ], $atts);
-    
-    $post_id = get_the_ID();
-    
-    if (empty($post_id)) {
-        return '';
-    }
-    
-    $images = get_post_meta($post_id, '_igny8_inarticle_images', true);
-    if (!is_array($images) || empty($images)) {
-        return '';
-    }
-
-    $output = '<div class="' . esc_attr($atts['class']) . '">';
-    
-    // Desktop images
-    $desktop_images = array_filter($images, function($img) {
-        return $img['device'] === 'desktop';
-    });
-    
-    if (!empty($desktop_images)) {
-        $output .= '<div class="igny8-desktop-images" style="display: block;">';
-        foreach ($desktop_images as $label => $image_data) {
-            $attachment_id = intval($image_data['attachment_id']);
-            if ($attachment_id > 0) {
-                $output .= wp_get_attachment_image($attachment_id, $atts['desktop_size'], false, [
-                    'class' => 'igny8-desktop-image',
-                    'data-image-id' => esc_attr($label)
-                ]);
-            }
-        }
-        $output .= '</div>';
-    }
-    
-    // Mobile images
-    $mobile_images = array_filter($images, function($img) {
-        return $img['device'] === 'mobile';
-    });
-    
-    if (!empty($mobile_images)) {
-        $output .= '<div class="igny8-mobile-images" style="display: none;">';
-        foreach ($mobile_images as $label => $image_data) {
-            $attachment_id = intval($image_data['attachment_id']);
-            if ($attachment_id > 0) {
-                $output .= wp_get_attachment_image($attachment_id, $atts['mobile_size'], false, [
-                    'class' => 'igny8-mobile-image',
-                    'data-image-id' => esc_attr($label)
-                ]);
-            }
-        }
-        $output .= '</div>';
-    }
-    
-    $output .= '</div>';
-    
-    // Add responsive CSS
-    $output .= '<style>
-        @media (max-width: 768px) {
-            .igny8-desktop-images { display: none !important; }
-            .igny8-mobile-images { display: block !important; }
-        }
-        @media (min-width: 769px) {
-            .igny8-desktop-images { display: block !important; }
-            .igny8-mobile-images { display: none !important; }
-        }
-    </style>';
-    
-    return $output;
-});

igny8-ai-seo-wp-plugin/assets/templates/igny8_clusters_template.csv

@@ -1,4 +0,0 @@
-cluster_name,sector_id,status,keyword_count,total_volume,avg_difficulty,mapped_pages_count
-"Car Interior Accessories",1,"active",25,45000,42,0
-"Car Storage Solutions",1,"active",18,32000,38,0
-"Car Beverage Holders",1,"active",12,18000,35,0

igny8-ai-seo-wp-plugin/assets/templates/igny8_ideas_template.csv

@@ -1,4 +0,0 @@
-idea_title,idea_description,content_structure,content_type,keyword_cluster_id,target_keywords,status,estimated_word_count
-"Top 10 Car Interior Accessories for 2024","A comprehensive list of the best car interior accessories available this year, including reviews and recommendations.","review","post",1,"car accessories, car storage solutions, car interior accessories","new",1200
-"How to Organize Your Car Interior Like a Pro","Step-by-step guide to organizing your car interior for maximum efficiency and comfort.","guide_tutorial","post",2,"car organization, car storage tips, car interior organization","new",1500
-"DIY Car Storage Solutions That Actually Work","Creative and practical DIY storage solutions you can make at home for your car.","guide_tutorial","post",2,"DIY car storage, car storage solutions, car organization tips","new",800

igny8-ai-seo-wp-plugin/assets/templates/igny8_keywords_template.csv

@@ -1,4 +0,0 @@
-keyword,search_volume,difficulty,cpc,intent,status,sector_id,cluster_id
-"car accessories",12000,45,2.50,"commercial","unmapped",1,0
-"car storage solutions",8500,38,1.80,"informational","unmapped",1,0
-"car interior accessories",15000,52,3.20,"commercial","unmapped",1,0

igny8-ai-seo-wp-plugin/core/_README.php

@@ -1,14 +0,0 @@
-<?php
-/**
- * ==============================
- * 📁 Folder Scope Declaration
- * ==============================
- * Folder: /core/
- * Purpose: Layout, init, DB, CRON - Core system functionality
- * Rules:
- * - Can be reused globally across all modules
- * - Contains WordPress integration logic
- * - Database operations and schema management
- * - Admin interface and routing
- * - CRON and automation systems
- */

igny8-ai-seo-wp-plugin/core/admin/init.php

@@ -1,135 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : init.php
- * @location     : /core/admin/init.php
- * @type         : Function Library
- * @scope        : Global
- * @allowed      : Admin initialization, settings registration, asset enqueuing
- * @reusability  : Globally Reusable
- * @notes        : WordPress admin initialization and settings management
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * ------------------------------------------------------------------------
- * ADMIN INITIALIZATION BOOTSTRAP
- * ------------------------------------------------------------------------
- */
-add_action('admin_init', 'igny8_register_settings');
-
-/**
- * ------------------------------------------------------------------------
- * SETTINGS REGISTRATION
- * ------------------------------------------------------------------------
- */
-function igny8_register_settings() {
-    $groups = igny8_get_settings_config();
-
-    foreach ($groups as $group => $settings) {
-        foreach ($settings as $name => $config) {
-            register_setting($group, $name, $config);
-        }
-    }
-}
-
-/**
- * Settings Configuration (grouped)
- */
-function igny8_get_settings_config() {
-    return [
-        'igny8_table_settings' => [
-            'igny8_records_per_page' => [
-                'type' => 'integer',
-                'default' => 20,
-                'sanitize_callback' => 'absint'
-            ]
-        ],
-        'igny8_ai_integration_settings' => [
-            'igny8_ai_cluster_building' => ['type' => 'string', 'default' => 'enabled', 'sanitize_callback' => 'sanitize_text_field'],
-            'igny8_ai_content_ideas' => ['type' => 'string', 'default' => 'enabled', 'sanitize_callback' => 'sanitize_text_field'],
-            'igny8_ai_auto_mapping' => ['type' => 'string', 'default' => 'enabled', 'sanitize_callback' => 'sanitize_text_field']
-        ],
-        'igny8_api_settings' => [
-            'igny8_api_key' => ['type' => 'string', 'default' => '', 'sanitize_callback' => 'sanitize_text_field'],
-            'igny8_runware_api_key' => ['type' => 'string', 'default' => '', 'sanitize_callback' => 'sanitize_text_field'],
-            'igny8_model' => ['type' => 'string', 'default' => 'gpt-4.1', 'sanitize_callback' => 'sanitize_text_field'],
-            'igny8_image_service' => ['type' => 'string', 'default' => 'openai', 'sanitize_callback' => 'sanitize_text_field'],
-            'igny8_image_model' => ['type' => 'string', 'default' => 'dall-e-3', 'sanitize_callback' => 'sanitize_text_field'],
-            'igny8_runware_model' => ['type' => 'string', 'default' => 'runware:97@1', 'sanitize_callback' => 'sanitize_text_field']
-        ],
-        'igny8_personalize_settings_group' => [
-            'igny8_content_engine_global_status' => ['sanitize_callback' => 'igny8_sanitize_checkbox_setting'],
-            'igny8_content_engine_enabled_post_types' => ['sanitize_callback' => 'igny8_sanitize_array_setting'],
-            'igny8_content_engine_insertion_position' => ['sanitize_callback' => 'sanitize_text_field'],
-            'igny8_content_engine_display_mode' => ['sanitize_callback' => 'sanitize_text_field'],
-            'igny8_content_engine_teaser_text' => ['sanitize_callback' => 'sanitize_textarea_field'],
-            'igny8_content_engine_save_variations' => ['sanitize_callback' => 'intval'],
-            'igny8_content_engine_field_mode' => ['sanitize_callback' => 'sanitize_text_field'],
-            'igny8_content_engine_detection_prompt' => ['sanitize_callback' => 'sanitize_textarea_field'],
-            'igny8_content_engine_context_source' => ['sanitize_callback' => 'sanitize_textarea_field'],
-            'igny8_content_engine_include_page_context' => ['sanitize_callback' => 'intval'],
-            'igny8_content_engine_content_length' => ['sanitize_callback' => 'sanitize_text_field'],
-            'igny8_content_engine_rewrite_prompt' => ['sanitize_callback' => 'sanitize_textarea_field'],
-            'igny8_content_engine_fixed_fields_config' => ['sanitize_callback' => 'igny8_sanitize_fields_config']
-        ]
-    ];
-}
-
-/**
- * ------------------------------------------------------------------------
- * SANITIZATION HELPERS
- * ------------------------------------------------------------------------
- */
-function igny8_sanitize_checkbox_setting($raw) {
-    return isset($_POST['igny8_content_engine_global_status']) ? 'enabled' : 'disabled';
-}
-
-function igny8_sanitize_array_setting($raw) {
-    return is_array($raw) ? array_map('sanitize_text_field', $raw) : [];
-}
-
-function igny8_sanitize_fields_config($raw) {
-    if (!is_array($raw)) return [];
-    $sanitized = [];
-    foreach ($raw as $index => $field) {
-        $sanitized[$index] = [
-            'label' => sanitize_text_field($field['label'] ?? ''),
-            'type' => sanitize_text_field($field['type'] ?? 'text'),
-            'options' => sanitize_text_field($field['options'] ?? '')
-        ];
-    }
-    return $sanitized;
-}
-
-
-// MOVED TO: igny8.php - Admin assets enqueuing moved to main plugin file
-
-// ---------------------------------------------------------------------
-// WORDPRESS FEATURE REGISTRATION
-// ---------------------------------------------------------------------
-
-function igny8_init_wordpress_features() {
-    // Initialize module manager
-    add_action('init', 'igny8_module_manager');
-
-    // Register taxonomies
-    add_action('init', 'igny8_register_taxonomies');
-
-    // Register post meta once
-    add_action('init', function() {
-        if (!get_option('igny8_post_meta_registered')) {
-            igny8_register_post_meta();
-            update_option('igny8_post_meta_registered', true);
-        }
-    });
-}
-
-//Initialize WordPress features
-igny8_init_wordpress_features();

igny8-ai-seo-wp-plugin/core/admin/menu.php

@@ -1,356 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : menu.php
- * @location     : /core/admin/menu.php
- * @type         : Admin Menu Handler
- * @scope        : Global
- * @allowed      : WordPress admin menu registration, navigation helpers, layout functions
- * @reusability  : Globally Reusable
- * @notes        : Registers admin menus and provides breadcrumb/submenu rendering functions
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Render breadcrumb navigation
- */
-function igny8_render_breadcrumb() {
-    $current_page = $_GET['page'] ?? '';
-    $sm = $_GET['sm'] ?? '';
-    $breadcrumb = '<nav class="igny8-breadcrumb-nav">';
-    $breadcrumb .= '<span class="igny8-breadcrumb-item"><a href="' . admin_url('admin.php?page=igny8-home') . '">Igny8 Home</a></span>';
-    
-    if ($current_page === 'igny8-planner') {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item"><a href="' . admin_url('admin.php?page=igny8-planner') . '">Planner</a></span>';
-        
-        if ($sm === 'keywords') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Keywords</span>';
-        } elseif ($sm === 'clusters') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Clusters</span>';
-        } elseif ($sm === 'ideas') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Ideas</span>';
-        } elseif ($sm === 'mapping') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Mapping</span>';
-        }
-    } elseif ($current_page === 'igny8-writer') {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item"><a href="' . admin_url('admin.php?page=igny8-writer') . '">Writer</a></span>';
-        
-        if ($sm === 'drafts') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Drafts</span>';
-        } elseif ($sm === 'templates') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Templates</span>';
-        }
-    } elseif ($current_page === 'igny8-optimizer') {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item"><a href="' . admin_url('admin.php?page=igny8-optimizer') . '">Optimizer</a></span>';
-        
-        if ($sm === 'audits') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Audits</span>';
-        } elseif ($sm === 'suggestions') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Suggestions</span>';
-        }
-    } elseif ($current_page === 'igny8-linker') {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item"><a href="' . admin_url('admin.php?page=igny8-linker') . '">Linker</a></span>';
-        
-        if ($sm === 'backlinks') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Backlinks</span>';
-        } elseif ($sm === 'campaigns') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Campaigns</span>';
-        }
-    } elseif ($current_page === 'igny8-personalize') {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item"><a href="' . admin_url('admin.php?page=igny8-personalize') . '">Personalize</a></span>';
-        
-        if ($sm === 'settings') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Settings</span>';
-        } elseif ($sm === 'content-generation') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Content Generation</span>';
-        } elseif ($sm === 'rewrites') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Rewrites</span>';
-        } elseif ($sm === 'front-end') {
-            $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-            $breadcrumb .= '<span class="igny8-breadcrumb-item active">Front-end</span>';
-        }
-    } elseif (strpos($current_page, 'igny8-analytics') !== false) {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item active">Analytics</span>';
-    } elseif (strpos($current_page, 'igny8-schedules') !== false) {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item active">Schedules</span>';
-    } elseif (strpos($current_page, 'igny8-settings') !== false) {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item active">Settings</span>';
-    } elseif (strpos($current_page, 'igny8-help') !== false) {
-        $breadcrumb .= '<span class="igny8-breadcrumb-separator">›</span>';
-        $breadcrumb .= '<span class="igny8-breadcrumb-item active">Help</span>';
-    }
-    
-    $breadcrumb .= '</nav>';
-    return $breadcrumb;
-}
-
-/**
- * Render submenu navigation
- */
-function igny8_render_submenu() {
-    $current_page = $_GET['page'] ?? '';
-    $sm = $_GET['sm'] ?? '';
-    $submenu = '';
-    
-    if ($current_page === 'igny8-planner') {
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-planner&sm=home') . '" class="igny8-btn igny8-btn-sm igny8-btn-success igny8-btn-submenu' . ($sm === 'home' || $sm === '' ? ' active' : '') . '">Dashboard</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-planner&sm=keywords') . '" class="igny8-btn igny8-btn-sm igny8-btn-success igny8-btn-submenu' . ($sm === 'keywords' ? ' active' : '') . '">Keywords</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-planner&sm=clusters') . '" class="igny8-btn igny8-btn-sm igny8-btn-success igny8-btn-submenu' . ($sm === 'clusters' ? ' active' : '') . '">Clusters</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-planner&sm=ideas') . '" class="igny8-btn igny8-btn-sm igny8-btn-success igny8-btn-submenu' . ($sm === 'ideas' ? ' active' : '') . '">Ideas</a>';
-    } elseif ($current_page === 'igny8-writer') {
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-writer&sm=home') . '" class="igny8-btn igny8-btn-sm igny8-btn-primary igny8-btn-submenu' . ($sm === 'home' || $sm === '' ? ' active' : '') . '">Dashboard</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-writer&sm=tasks') . '" class="igny8-btn igny8-btn-sm igny8-btn-primary igny8-btn-submenu' . ($sm === 'tasks' ? ' active' : '') . '">Tasks</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-writer&sm=drafts') . '" class="igny8-btn igny8-btn-sm igny8-btn-primary igny8-btn-submenu' . ($sm === 'drafts' ? ' active' : '') . '">Drafts</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-writer&sm=published') . '" class="igny8-btn igny8-btn-sm igny8-btn-primary igny8-btn-submenu' . ($sm === 'published' ? ' active' : '') . '">Published</a>';
-    } elseif ($current_page === 'igny8-thinker') {
-        $sp = $_GET['sp'] ?? 'main';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-thinker&sp=main') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'main' ? ' active' : '') . '">Dashboard</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-thinker&sp=prompts') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'prompts' ? ' active' : '') . '">Prompts</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-thinker&sp=profile') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'profile' ? ' active' : '') . '">Profile</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-thinker&sp=strategies') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'strategies' ? ' active' : '') . '">Strategies</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-thinker&sp=image-testing') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'image-testing' ? ' active' : '') . '">Image Testing</a>';
-    } elseif ($current_page === 'igny8-optimizer') {
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-optimizer') . '" class="igny8-btn igny8-btn-sm igny8-btn-warning igny8-btn-submenu' . ($sm === '' ? ' active' : '') . '">Dashboard</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-optimizer&sm=audits') . '" class="igny8-btn igny8-btn-sm igny8-btn-warning igny8-btn-submenu' . ($sm === 'audits' ? ' active' : '') . '">Audits</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-optimizer&sm=suggestions') . '" class="igny8-btn igny8-btn-sm igny8-btn-warning igny8-btn-submenu' . ($sm === 'suggestions' ? ' active' : '') . '">Suggestions</a>';
-    } elseif ($current_page === 'igny8-linker') {
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-linker') . '" class="igny8-btn igny8-btn-sm igny8-btn-info igny8-btn-submenu' . ($sm === '' ? ' active' : '') . '">Dashboard</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-linker&sm=backlinks') . '" class="igny8-btn igny8-btn-sm igny8-btn-info igny8-btn-submenu' . ($sm === 'backlinks' ? ' active' : '') . '">Backlinks</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-linker&sm=campaigns') . '" class="igny8-btn igny8-btn-sm igny8-btn-info igny8-btn-submenu' . ($sm === 'campaigns' ? ' active' : '') . '">Campaigns</a>';
-    } elseif ($current_page === 'igny8-personalize') {
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-personalize') . '" class="igny8-btn igny8-btn-sm igny8-btn-secondary igny8-btn-submenu' . ($sm === '' ? ' active' : '') . '">Dashboard</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-personalize&sm=settings') . '" class="igny8-btn igny8-btn-sm igny8-btn-secondary igny8-btn-submenu' . ($sm === 'settings' ? ' active' : '') . '">Settings</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-personalize&sm=content-generation') . '" class="igny8-btn igny8-btn-sm igny8-btn-secondary igny8-btn-submenu' . ($sm === 'content-generation' ? ' active' : '') . '">Content Generation</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-personalize&sm=rewrites') . '" class="igny8-btn igny8-btn-sm igny8-btn-secondary igny8-btn-submenu' . ($sm === 'rewrites' ? ' active' : '') . '">Rewrites</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-personalize&sm=front-end') . '" class="igny8-btn igny8-btn-sm igny8-btn-secondary igny8-btn-submenu' . ($sm === 'front-end' ? ' active' : '') . '">Front-end</a>';
-    } elseif ($current_page === 'igny8-settings') {
-        $sp = $_GET['sp'] ?? 'general';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-settings&sp=general') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'general' ? ' active' : '') . '">Settings</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-settings&sp=status') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'status' ? ' active' : '') . '">Status</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-settings&sp=integration') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'integration' ? ' active' : '') . '">Integration</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-settings&sp=import-export') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'import-export' ? ' active' : '') . '">Import/Export</a>';
-    } elseif ($current_page === 'igny8-help') {
-        $sp = $_GET['sp'] ?? 'help';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-help&sp=help') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'help' ? ' active' : '') . '">Help & Support</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-help&sp=docs') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'docs' ? ' active' : '') . '">Documentation</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-help&sp=system-testing') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'system-testing' ? ' active' : '') . '">System Testing</a>';
-        $submenu .= '<a href="' . admin_url('admin.php?page=igny8-help&sp=function-testing') . '" class="igny8-btn igny8-btn-sm igny8-btn-outline igny8-btn-submenu' . ($sp === 'function-testing' ? ' active' : '') . '">Function Testing</a>';
-    }
-    
-    return $submenu;
-}
-
-/**
- * Register admin menu pages
- */
-function igny8_register_admin_menu() {
-    // Ensure module manager is available
-    if (!function_exists('igny8_is_module_enabled')) {
-        return;
-    }
-    // Main menu page
-    add_menu_page(
-        'Igny8 AI SEO',           // Page title
-        'Igny8 AI SEO',           // Menu title
-        'manage_options',         // Capability
-        'igny8-home',            // Menu slug
-        'igny8_home_page',       // Callback function
-        'dashicons-chart-line',  // Icon
-        30                       // Position
-    );
-
-    // Home page
-    add_submenu_page(
-        'igny8-home',            // Parent slug
-        'Dashboard',             // Page title
-        'Dashboard',             // Menu title
-        'manage_options',        // Capability
-        'igny8-home',           // Menu slug
-        'igny8_home_page'       // Callback function
-    );
-
-    // Module submenus (only if enabled)
-    if (igny8_is_module_enabled('planner')) {
-        add_submenu_page(
-            'igny8-home',
-            'Content Planner',
-            'Planner',
-            'manage_options',
-            'igny8-planner',
-            'igny8_planner_page'
-        );
-    }
-
-    if (igny8_is_module_enabled('writer')) {
-        add_submenu_page(
-            'igny8-home',
-            'Content Writer',
-            'Writer',
-            'manage_options',
-            'igny8-writer',
-            'igny8_writer_page'
-        );
-    }
-
-    if (igny8_is_module_enabled('thinker')) {
-        add_submenu_page(
-            'igny8-home',
-            'AI Thinker',
-            'Thinker',
-            'manage_options',
-            'igny8-thinker',
-            'igny8_thinker_page'
-        );
-        
-        // Prompts subpage under Thinker
-        add_submenu_page(
-            'igny8-thinker',
-            'AI Prompts',
-            'Prompts',
-            'manage_options',
-            'igny8-thinker&sp=prompts',
-            'igny8_thinker_page'
-        );
-    }
-
-    if (igny8_is_module_enabled('schedules')) {
-        add_submenu_page(
-            'igny8-home',
-            'Smart Automation Schedules',
-            'Schedules',
-            'manage_options',
-            'igny8-schedules',
-            'igny8_schedules_page'
-        );
-    }
-
-
-    // Analytics before Settings (only if enabled)
-    if (igny8_is_module_enabled('analytics')) {
-        add_submenu_page(
-            'igny8-home',
-            'Analytics',
-            'Analytics',
-            'manage_options',
-            'igny8-analytics',
-            'igny8_analytics_page'
-        );
-    }
-    
-    // Cron Health page
-
-    // Settings page
-    add_submenu_page(
-        'igny8-home',
-        'Settings',
-        'Settings',
-        'manage_options',
-        'igny8-settings',
-        'igny8_settings_page'
-    );
-
-
-    // Help page
-    add_submenu_page(
-        'igny8-home',
-        'Help',
-        'Help',
-        'manage_options',
-        'igny8-help',
-        'igny8_help_page'
-    );
-    
-    // Documentation subpage under Help
-    add_submenu_page(
-        'igny8-help',
-        'Documentation',
-        'Documentation',
-        'manage_options',
-        'igny8-help&sp=docs',
-        'igny8_help_page'
-    );
-    
-    // System Testing subpage under Help
-    add_submenu_page(
-        'igny8-help',
-        'System Testing',
-        'System Testing',
-        'manage_options',
-        'igny8-help&sp=system-testing',
-        'igny8_help_page'
-    );
-    
-    // Function Testing subpage under Help
-    add_submenu_page(
-        'igny8-help',
-        'Function Testing',
-        'Function Testing',
-        'manage_options',
-        'igny8-help&sp=function-testing',
-        'igny8_help_page'
-    );
-
-}
-
-// Static page wrapper functions - each page handles its own layout
-function igny8_home_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/home.php';
-}
-
-function igny8_planner_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/planner/planner.php';
-}
-
-function igny8_writer_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/writer/writer.php';
-}
-
-function igny8_thinker_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/thinker/thinker.php';
-}
-
-function igny8_settings_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/settings/general-settings.php';
-}
-
-function igny8_analytics_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/analytics/analytics.php';
-}
-
-function igny8_schedules_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/settings/schedules.php';
-}
-
-function igny8_help_page() {
-    include_once plugin_dir_path(__FILE__) . '../../modules/help/help.php';
-}
-
-// Hook into admin_menu
-add_action('admin_menu', 'igny8_register_admin_menu');

igny8-ai-seo-wp-plugin/core/admin/meta-boxes.php

@@ -1,387 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : meta-boxes.php
- * @location     : /core/admin/meta-boxes.php
- * @type         : Function Library
- * @scope        : Global
- * @allowed      : Meta box registration, SEO field management
- * @reusability  : Globally Reusable
- * @notes        : SEO meta boxes for post editor
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-// === SEO Meta Box ===
-add_action('add_meta_boxes', function() {
-    // SEO fields
-    add_meta_box('igny8_seo_meta', 'Igny8 SEO Fields', function($post) {
-        $meta_title = get_post_meta($post->ID, '_igny8_meta_title', true);
-        $meta_desc  = get_post_meta($post->ID, '_igny8_meta_description', true);
-        $primary_kw = get_post_meta($post->ID, '_igny8_primary_keywords', true);
-        $secondary_kw = get_post_meta($post->ID, '_igny8_secondary_keywords', true);
-        ?>
-        <div style="padding:8px 4px;">
-            <label><strong>Meta Title:</strong></label><br>
-            <input type="text" name="_igny8_meta_title" value="<?php echo esc_attr($meta_title); ?>" style="width:100%;"><br><br>
-
-            <label><strong>Meta Description:</strong></label><br>
-            <textarea name="_igny8_meta_description" rows="3" style="width:100%;"><?php echo esc_textarea($meta_desc); ?></textarea><br><br>
-
-            <label><strong>Primary Keyword:</strong></label><br>
-            <input type="text" name="_igny8_primary_keywords" value="<?php echo esc_attr($primary_kw); ?>" style="width:100%;"><br><br>
-
-            <label><strong>Secondary Keywords (comma-separated):</strong></label><br>
-            <input type="text" name="_igny8_secondary_keywords" value="<?php echo esc_attr($secondary_kw); ?>" style="width:100%;">
-        </div>
-        <?php
-    }, ['post','page','product'], 'normal', 'high');
-    
-    
-});
-
-
-// === Save Meta Box Data ===
-add_action('save_post', function($post_id) {
-    // Security checks
-    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
-        return;
-    }
-    
-    // Save SEO fields
-    $fields = [
-        '_igny8_meta_title',
-        '_igny8_meta_description',
-        '_igny8_primary_keywords',
-        '_igny8_secondary_keywords',
-    ];
-    foreach ($fields as $field) {
-        if (isset($_POST[$field])) {
-            update_post_meta($post_id, $field, sanitize_text_field($_POST[$field]));
-        }
-    }
-    
-    
-    if (defined('WP_DEBUG') && WP_DEBUG) {
-        error_log("Igny8 Metabox: SEO fields saved for post $post_id");
-    }
-});
-
-// === In-Article Image Gallery Meta Box ===
-add_action('add_meta_boxes', function() {
-    $enabled_post_types = get_option('igny8_enable_image_metabox', []);
-    foreach ((array) $enabled_post_types as $pt) {
-        add_meta_box(
-            'igny8_image_gallery',
-            'Igny8 In-Article Images',
-            'igny8_render_image_gallery_metabox',
-            $pt,
-            'side',
-            'high'
-        );
-    }
-});
-
-function igny8_render_image_gallery_metabox($post) {
-    wp_nonce_field('igny8_save_image_gallery', 'igny8_image_gallery_nonce');
-    $images = get_post_meta($post->ID, '_igny8_inarticle_images', true);
-    if (!is_array($images)) $images = [];
-
-    // Add CSS for grid layout and remove button
-    ?>
-    <style>
-        .igny8-image-list {
-            display: flex;
-            flex-wrap: wrap;
-            list-style: none;
-            margin: 0;
-            padding: 0;
-            gap: 5px;
-        }
-        .igny8-image-list li {
-            width: 200px;
-            margin: 0 5px 5px 0;
-            box-sizing: border-box;
-            text-align: center;
-            position: relative;
-            border: 1px solid #eee;
-            padding: 5px;
-            display: flex;
-            flex-direction: column;
-            align-items: center;
-            justify-content: center;
-            min-height: 180px;
-        }
-        .igny8-image-list li img {
-            display: block;
-            margin: 0 auto 5px auto;
-        }
-        .igny8-image-actions {
-            position: absolute;
-            bottom: 5px;
-            left: 50%;
-            transform: translateX(-50%);
-            display: flex;
-            gap: 5px;
-            opacity: 0;
-            transition: opacity 0.2s ease;
-            z-index: 10;
-        }
-        .igny8-image-list li:hover .igny8-image-actions {
-            opacity: 1;
-        }
-        .igny8-remove-btn, .igny8-replace-btn {
-            background: #f0f0f0;
-            border: 1px solid #ccc;
-            color: #333;
-            font-size: 10px;
-            padding: 2px 6px;
-            cursor: pointer;
-            border-radius: 2px;
-            text-decoration: none;
-            white-space: nowrap;
-        }
-        .igny8-remove-btn:hover {
-            background: #dc3232;
-            color: #fff;
-            border-color: #dc3232;
-        }
-        .igny8-replace-btn:hover {
-            background: #0073aa;
-            color: #fff;
-            border-color: #0073aa;
-        }
-        .igny8-image-list li strong {
-            font-size: 0.8em;
-            word-break: break-all;
-        }
-    </style>
-    <?php
-
-    echo '<div id="igny8-image-gallery">';
-    echo '<p><label><input type="radio" name="igny8_image_type" value="desktop" checked> Desktop</label>
-              <label><input type="radio" name="igny8_image_type" value="mobile"> Mobile</label></p>';
-    echo '<button type="button" class="button button-primary" id="igny8-add-image">Add Image</button>';
-    
-    
-    
-    
-    echo '<ul class="igny8-image-list">';
-
-    // Sort images by device type and ID
-    $sorted_images = [];
-    foreach ($images as $label => $data) {
-        $sorted_images[$label] = $data;
-    }
-    
-    // Custom sort function to order by device type (desktop first) then by ID
-    uksort($sorted_images, function($a, $b) {
-        $a_parts = explode('-', $a);
-        $b_parts = explode('-', $b);
-        
-        $a_device = $a_parts[0];
-        $b_device = $b_parts[0];
-        
-        // Desktop comes before mobile
-        if ($a_device === 'desktop' && $b_device === 'mobile') return -1;
-        if ($a_device === 'mobile' && $b_device === 'desktop') return 1;
-        
-        // If same device, sort by ID number
-        if ($a_device === $b_device) {
-            $a_id = intval($a_parts[1]);
-            $b_id = intval($b_parts[1]);
-            return $a_id - $b_id;
-        }
-        
-        return 0;
-    });
-
-    foreach ($sorted_images as $label => $data) {
-        echo '<li data-label="' . esc_attr($label) . '">';
-        echo '<strong>' . esc_html($label) . '</strong><br>';
-        echo wp_get_attachment_image($data['attachment_id'], 'thumbnail', false, ['style' => 'width: 150px; height: 150px; object-fit: cover;']);
-        echo '<div class="igny8-image-actions">';
-        echo '<button type="button" class="igny8-replace-btn">Replace</button>';
-        echo '<button type="button" class="igny8-remove-btn">Remove</button>';
-        echo '</div>';
-        echo '<input type="hidden" name="igny8_image_data[' . esc_attr($label) . '][attachment_id]" value="' . esc_attr($data['attachment_id']) . '">';
-        echo '<input type="hidden" name="igny8_image_data[' . esc_attr($label) . '][device]" value="' . esc_attr($data['device']) . '">';
-        echo '</li>';
-    }
-    echo '</ul>';
-    
-
-    // Inline JS
-    ?>
-    <script>
-    jQuery(document).ready(function($) {
-        // Function to get first available ID for a device type
-        function getFirstAvailableId(deviceType) {
-            let existingIds = [];
-            $('.igny8-image-list li').each(function() {
-                let label = $(this).data('label');
-                if (label && label.startsWith(deviceType + '-')) {
-                    let id = parseInt(label.split('-')[1]);
-                    if (!isNaN(id)) {
-                        existingIds.push(id);
-                    }
-                }
-            });
-            
-            // Sort existing IDs and find first gap
-            existingIds.sort((a, b) => a - b);
-            for (let i = 1; i <= existingIds.length + 1; i++) {
-                if (!existingIds.includes(i)) {
-                    return i;
-                }
-            }
-            return 1; // Fallback
-        }
-
-        $('#igny8-add-image').on('click', function(e) {
-            e.preventDefault();
-            let type = $('input[name="igny8_image_type"]:checked').val() || 'desktop';
-            let availableId = getFirstAvailableId(type);
-            let label = type + '-' + availableId;
-
-            const frame = wp.media({
-                title: 'Select Image',
-                button: { text: 'Use this image' },
-                multiple: false
-            });
-
-            frame.on('select', function() {
-                let attachment = frame.state().get('selection').first().toJSON();
-                let html = '<li data-label="' + label + '">' +
-                           '<strong>' + label + '</strong><br>' +
-                           '<img src="' + attachment.sizes.thumbnail.url + '" style="width: 150px; height: 150px; object-fit: cover;" /><br>' +
-                           '<div class="igny8-image-actions">' +
-                           '<button type="button" class="igny8-replace-btn">Replace</button>' +
-                           '<button type="button" class="igny8-remove-btn">Remove</button>' +
-                           '</div>' +
-                           '<input type="hidden" name="igny8_image_data[' + label + '][attachment_id]" value="' + attachment.id + '">' +
-                           '<input type="hidden" name="igny8_image_data[' + label + '][device]" value="' + type + '">' +
-                           '</li>';
-                $('.igny8-image-list').append(html);
-            });
-
-            frame.open();
-        });
-
-        // Handle image removal (event delegation for dynamically added elements)
-        $(document).on('click', '.igny8-remove-btn', function() {
-            $(this).closest('li').remove();
-        });
-
-        // Handle image replacement (event delegation for dynamically added elements)
-        $(document).on('click', '.igny8-replace-btn', function() {
-            let $li = $(this).closest('li');
-            let label = $li.data('label');
-            let type = label.split('-')[0];
-            
-            const frame = wp.media({
-                title: 'Replace Image',
-                button: { text: 'Replace this image' },
-                multiple: false
-            });
-
-            frame.on('select', function() {
-                let attachment = frame.state().get('selection').first().toJSON();
-                
-                // Replace the entire img element to force reload
-                let $img = $li.find('img');
-                let newImg = $('<img>').attr({
-                    'src': attachment.sizes.thumbnail.url,
-                    'style': 'width: 150px; height: 150px; object-fit: cover;'
-                });
-                $img.replaceWith(newImg);
-                
-                // Update the hidden input
-                $li.find('input[name*="[attachment_id]"]').val(attachment.id);
-            });
-
-            frame.open();
-        });
-
-        // Handle Convert Content to Blocks
-        $('#igny8-convert-to-blocks').on('click', function(e) {
-            e.preventDefault();
-            
-            if (!confirm('This will convert the post content from HTML to WordPress blocks. Continue?')) {
-                return;
-            }
-            
-            let $button = $(this);
-            let originalText = $button.text();
-            $button.prop('disabled', true).text('Converting...');
-            
-            // Get post ID from the current post
-            let postId = $('#post_ID').val();
-            
-            // Make AJAX request to convert content to blocks
-            $.ajax({
-                url: ajaxurl,
-                type: 'POST',
-                data: {
-                    action: 'igny8_convert_content_to_blocks',
-                    post_id: postId,
-                    nonce: '<?php echo wp_create_nonce('igny8_convert_to_blocks'); ?>'
-                },
-                success: function(response) {
-                    console.log('Convert to Blocks Response:', response);
-                    if (response.success) {
-                        console.log('Success data:', response.data);
-                        alert('Content converted successfully! ' + response.data.message);
-                        location.reload();
-                    } else {
-                        console.error('Error data:', response.data);
-                        alert('Error: ' + (response.data || 'Unknown error'));
-                    }
-                },
-                error: function(xhr, status, error) {
-                    console.error('Convert to Blocks Error:', {status, error, responseText: xhr.responseText});
-                    alert('Error converting content. Check console for details.');
-                },
-                complete: function() {
-                    $button.prop('disabled', false).text(originalText);
-                }
-            });
-        });
-
-
-    });
-    </script>
-    <?php
-}
-
-// SAVE HANDLER for Image Gallery
-add_action('save_post', function($post_id) {
-    if (!isset($_POST['igny8_image_gallery_nonce']) || !wp_verify_nonce($_POST['igny8_image_gallery_nonce'], 'igny8_save_image_gallery')) return;
-    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
-    if (!current_user_can('edit_post', $post_id)) return;
-
-    $images = $_POST['igny8_image_data'] ?? [];
-    $filtered = [];
-    foreach ($images as $label => $data) {
-        if (!empty($data['attachment_id'])) {
-            $filtered[$label] = [
-                'label' => sanitize_text_field($label),
-                'attachment_id' => intval($data['attachment_id']),
-                'url' => wp_get_attachment_url(intval($data['attachment_id'])),
-                'device' => sanitize_text_field($data['device'])
-            ];
-        }
-    }
-    update_post_meta($post_id, '_igny8_inarticle_images', $filtered);
-
-    if (WP_DEBUG === true) {
-        error_log("[IGNY8 DEBUG] Saving In-Article Images for Post ID: $post_id");
-        error_log(print_r($filtered, true));
-    }
-});
-

igny8-ai-seo-wp-plugin/core/admin/module-manager-class.php

@@ -1,181 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : module-manager-class.php
- * @location     : /core/admin/module-manager-class.php
- * @type         : Function Library
- * @scope        : Global
- * @allowed      : Module management, class definitions, core functionality
- * @reusability  : Globally Reusable
- * @notes        : Module manager class for core functionality
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Igny8 Module Manager - Controls which modules are active
- */
-class Igny8_Module_Manager {
-    
-    private static $instance = null;
-    private $modules = [];
-    
-    public static function get_instance() {
-        if (self::$instance === null) {
-            self::$instance = new self();
-        }
-        return self::$instance;
-    }
-    
-    private function __construct() {
-        $this->init_modules();
-        add_action('admin_init', [$this, 'register_module_settings']);
-    }
-    
-    /**
-     * Initialize module definitions - main modules only
-     */
-    private function init_modules() {
-        $this->modules = [
-            'planner' => [
-                'name' => 'Planner',
-                'description' => 'Keyword research and content planning with clusters, ideas, and mapping tools.',
-                'default' => true,
-                'icon' => 'dashicons-search',
-                'category' => 'main',
-                'cron_jobs' => [
-                    'igny8_auto_cluster_cron',
-                    'igny8_auto_generate_ideas_cron',
-                    'igny8_auto_queue_cron'
-                ]
-            ],
-            'writer' => [
-                'name' => 'Writer',
-                'description' => 'AI-powered content generation with drafts and templates management.',
-                'default' => false,
-                'icon' => 'dashicons-edit',
-                'category' => 'main',
-                'cron_jobs' => [
-                    'igny8_auto_generate_content_cron',
-                    'igny8_auto_generate_images_cron',
-                    'igny8_auto_publish_drafts_cron'
-                ]
-            ],
-            'analytics' => [
-                'name' => 'Analytics',
-                'description' => 'Performance tracking and data analysis with comprehensive reporting.',
-                'default' => false,
-                'icon' => 'dashicons-chart-bar',
-                'category' => 'admin',
-                'cron_jobs' => [
-                    'igny8_process_ai_queue_cron',
-                    'igny8_auto_recalc_cron',
-                    'igny8_health_check_cron'
-                ]
-            ],
-            'schedules' => [
-                'name' => 'Schedules',
-                'description' => 'Content scheduling and automation with calendar management.',
-                'default' => false,
-                'icon' => 'dashicons-calendar-alt',
-                'category' => 'admin'
-            ],
-            'thinker' => [
-                'name' => 'AI Thinker',
-                'description' => 'AI-powered content strategy, prompts, and intelligent content planning tools.',
-                'default' => true,
-                'icon' => 'dashicons-lightbulb',
-                'category' => 'admin'
-            ]
-        ];
-    }
-    
-    /**
-     * Check if a module is enabled
-     */
-    public function is_module_enabled($module) {
-        $settings = get_option('igny8_module_settings', []);
-        return isset($settings[$module]) ? (bool) $settings[$module] : (isset($this->modules[$module]) ? $this->modules[$module]['default'] : false);
-    }
-    
-    /**
-     * Get all enabled modules
-     */
-    public function get_enabled_modules() {
-        $enabled = [];
-        foreach ($this->modules as $key => $module) {
-            if ($this->is_module_enabled($key)) {
-                $enabled[$key] = $module;
-            }
-        }
-        return $enabled;
-    }
-    
-    /**
-     * Get all modules
-     */
-    public function get_modules() {
-        return $this->modules;
-    }
-    
-    /**
-     * Register module settings
-     */
-    public function register_module_settings() {
-        register_setting('igny8_module_settings', 'igny8_module_settings');
-    }
-    
-    /**
-     * Save module settings
-     */
-    public function save_module_settings() {
-        if (!isset($_POST['igny8_module_nonce']) || !wp_verify_nonce($_POST['igny8_module_nonce'], 'igny8_module_settings')) {
-            wp_die('Security check failed');
-        }
-        
-        $settings = $_POST['igny8_module_settings'] ?? [];
-        
-        // Initialize all modules as disabled first
-        $all_modules = $this->get_modules();
-        $final_settings = [];
-        foreach ($all_modules as $module_key => $module) {
-            $final_settings[$module_key] = false; // Default to disabled
-        }
-        
-        // Set enabled modules to true
-        foreach ($settings as $key => $value) {
-            if (isset($final_settings[$key])) {
-                $final_settings[$key] = (bool) $value;
-            }
-        }
-        
-        update_option('igny8_module_settings', $final_settings);
-        
-        // Force page reload using JavaScript
-        echo '<script>window.location.reload();</script>';
-        exit;
-    }
-}
-
-// Initialize the module manager
-function igny8_module_manager() {
-    return Igny8_Module_Manager::get_instance();
-}
-
-// Helper functions for easy access
-function igny8_is_module_enabled($module) {
-    return igny8_module_manager()->is_module_enabled($module);
-}
-
-function igny8_get_enabled_modules() {
-    return igny8_module_manager()->get_enabled_modules();
-}
-
-function igny8_get_modules() {
-    return igny8_module_manager()->get_modules();
-}

igny8-ai-seo-wp-plugin/core/cron/igny8-cron-master-dispatcher.php

@@ -1,384 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : igny8-cron-master-dispatcher.php
- * @location     : /core/cron/igny8-cron-master-dispatcher.php
- * @type         : CRON Handler
- * @scope        : Global
- * @allowed      : Cron scheduling, automation dispatch, resource management
- * @reusability  : Globally Reusable
- * @notes        : Central cron dispatcher for all automation jobs
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Master Dispatcher - Main execution function
- * 
- * Runs every 5 minutes via cPanel, checks database schedules,
- * and executes only due automations with proper limits and timing.
- */
-function igny8_master_dispatcher_run() {
-    echo "<div style='background:#e8f4fd;padding:10px;margin:5px;border:1px solid #2196F3;'>";
-    echo "<strong>Igny8 MASTER DISPATCHER: Starting smart automation check</strong><br>";
-    error_log("Igny8 MASTER DISPATCHER: Starting smart automation check");
-    
-    // Get all defined cron jobs
-    $cron_jobs = igny8_get_defined_cron_jobs();
-    $current_time = current_time('timestamp');
-    $executed_jobs = [];
-    $skipped_jobs = [];
-    
-    echo "<strong>Igny8 MASTER DISPATCHER: Found " . count($cron_jobs) . " defined jobs</strong><br>";
-    
-    // Get settings and limits
-    $cron_settings = get_option('igny8_cron_settings', []);
-    $cron_limits = get_option('igny8_cron_limits', []);
-    
-    // Initialize default settings if missing
-    if (empty($cron_settings)) {
-        $cron_settings = igny8_get_default_cron_settings();
-        update_option('igny8_cron_settings', $cron_settings);
-        echo "<strong>Igny8 MASTER DISPATCHER: Initialized default settings</strong><br>";
-    }
-    
-    if (empty($cron_limits)) {
-        $cron_limits = igny8_get_default_cron_limits();
-        update_option('igny8_cron_limits', $cron_limits);
-        echo "<strong>Igny8 MASTER DISPATCHER: Initialized default limits</strong><br>";
-    }
-    
-    // Process each job in priority order
-    foreach ($cron_jobs as $job_name => $job_config) {
-        echo "<strong>Igny8 MASTER DISPATCHER: Checking job: " . $job_name . "</strong><br>";
-        
-        // Check if job is enabled
-        $job_settings = $cron_settings[$job_name] ?? [];
-        if (!($job_settings['enabled'] ?? false)) {
-            echo "<strong>Igny8 MASTER DISPATCHER: Job disabled, skipping</strong><br>";
-            $skipped_jobs[] = $job_name;
-            continue;
-        }
-        
-        // Check if job is due (simplified - just check if enabled and not recently run)
-        $last_run = $job_settings['last_run'] ?? 0;
-        $time_since_last_run = $current_time - $last_run;
-        
-        // Run job if it hasn't been run in the last 5 minutes (to prevent duplicate runs)
-        if ($time_since_last_run < 300) {
-            echo "<strong>Igny8 MASTER DISPATCHER: Job run recently, skipping</strong><br>";
-            $skipped_jobs[] = $job_name;
-            continue;
-        }
-        
-        // Check if job is already running (duplicate prevention)
-        $lock_key = 'igny8_cron_running_' . $job_name;
-        if (get_transient($lock_key)) {
-            echo "<strong>Igny8 MASTER DISPATCHER: Job already running, skipping</strong><br>";
-            $skipped_jobs[] = $job_name;
-            continue;
-        }
-        
-        // Set lock for this job
-        $max_execution_time = $job_config['max_execution_time'] ?? 300;
-        set_transient($lock_key, true, $max_execution_time);
-        
-        echo "<strong>Igny8 MASTER DISPATCHER: Executing job: " . $job_name . "</strong><br>";
-        
-        try {
-            // Get job limit
-            $job_limit = $cron_limits[$job_name] ?? 1;
-            
-            // Set limit as global variable for handlers to use
-            $GLOBALS['igny8_cron_limit'] = $job_limit;
-            
-            // Execute the job
-            $start_time = microtime(true);
-            do_action($job_name);
-            $execution_time = microtime(true) - $start_time;
-            
-            // Update last run time
-            $cron_settings[$job_name]['last_run'] = $current_time;
-            update_option('igny8_cron_settings', $cron_settings);
-            
-            // Track individual job execution with detailed logging
-            $processed_count = $GLOBALS['igny8_cron_processed_count'] ?? 0;
-            $result_details = $GLOBALS['igny8_cron_result_details'] ?? '';
-            
-            echo "<strong>Igny8 MASTER DISPATCHER: Global variables - processed_count: $processed_count, result_details: $result_details</strong><br>";
-            
-            $job_health = [
-                'last_run' => $current_time,
-                'success' => true,
-                'last_success' => true,
-                'execution_time' => round($execution_time, 2),
-                'error_message' => '',
-                'processed_count' => $processed_count,
-                'result_details' => $result_details,
-                'execution_method' => (isset($_GET['import_key']) && !empty($_GET['import_key'])) ? 'external_url' : 'server_cron'
-            ];
-            update_option('igny8_cron_health_' . $job_name, $job_health);
-            
-            $executed_jobs[] = [
-                'job' => $job_name,
-                'execution_time' => round($execution_time, 2),
-                'success' => true
-            ];
-            
-            echo "<strong>Igny8 MASTER DISPATCHER: Job completed successfully in " . round($execution_time, 2) . "s</strong><br>";
-            
-        } catch (Exception $e) {
-            echo "<strong>Igny8 MASTER DISPATCHER: Job failed: " . $e->getMessage() . "</strong><br>";
-            error_log("Igny8 MASTER DISPATCHER: Job $job_name failed - " . $e->getMessage());
-            
-            // Track individual job failure
-            $job_health = [
-                'last_run' => $current_time,
-                'success' => false,
-                'last_success' => false,
-                'execution_time' => 0,
-                'error_message' => $e->getMessage(),
-                'processed_count' => $GLOBALS['igny8_cron_processed_count'] ?? 0,
-                'result_details' => 'FAILED: ' . $e->getMessage(),
-                'execution_method' => (isset($_GET['import_key']) && !empty($_GET['import_key'])) ? 'external_url' : 'server_cron'
-            ];
-            update_option('igny8_cron_health_' . $job_name, $job_health);
-            
-            $executed_jobs[] = [
-                'job' => $job_name,
-                'execution_time' => 0,
-                'success' => false,
-                'last_success' => false,
-                'error' => $e->getMessage()
-            ];
-        } catch (Throwable $e) {
-            echo "<strong>Igny8 MASTER DISPATCHER: Job fatal error: " . $e->getMessage() . "</strong><br>";
-            error_log("Igny8 MASTER DISPATCHER: Job $job_name fatal error - " . $e->getMessage());
-            
-            // Track individual job failure
-            $job_health = [
-                'last_run' => $current_time,
-                'success' => false,
-                'last_success' => false,
-                'execution_time' => 0,
-                'error_message' => $e->getMessage(),
-                'processed_count' => $GLOBALS['igny8_cron_processed_count'] ?? 0,
-                'result_details' => 'FAILED: ' . $e->getMessage(),
-                'execution_method' => (isset($_GET['import_key']) && !empty($_GET['import_key'])) ? 'external_url' : 'server_cron'
-            ];
-            update_option('igny8_cron_health_' . $job_name, $job_health);
-            
-            $executed_jobs[] = [
-                'job' => $job_name,
-                'execution_time' => 0,
-                'success' => false,
-                'last_success' => false,
-                'error' => $e->getMessage()
-            ];
-        } finally {
-            // Always release the lock
-            delete_transient($lock_key);
-        }
-    }
-    
-    // Log summary
-    echo "<strong>Igny8 MASTER DISPATCHER: Execution summary</strong><br>";
-    echo "<strong>Igny8 MASTER DISPATCHER: Jobs executed: " . count($executed_jobs) . "</strong><br>";
-    echo "<strong>Igny8 MASTER DISPATCHER: Jobs skipped: " . count($skipped_jobs) . "</strong><br>";
-    
-    // Store execution log
-    update_option('igny8_cron_last_execution', [
-        'timestamp' => $current_time,
-        'executed' => $executed_jobs,
-        'skipped' => $skipped_jobs
-    ]);
-    
-    echo "<strong>Igny8 MASTER DISPATCHER: Smart automation check completed</strong><br>";
-    echo "</div>";
-    
-    // Return success response for external cron
-    return [
-        'success' => true,
-        'message' => 'Master dispatcher executed successfully',
-        'executed' => count($executed_jobs),
-        'skipped' => count($skipped_jobs),
-        'timestamp' => current_time('mysql')
-    ];
-}
-
-/**
- * Get all defined cron jobs with their configurations
- */
-function igny8_get_defined_cron_jobs() {
-    return [
-        'igny8_auto_cluster_cron' => [
-            'handler' => 'igny8_auto_cluster_cron_handler',
-            'priority' => 1,
-            'max_execution_time' => 600, // 10 minutes
-            'description' => 'Auto cluster unmapped keywords',
-            'module' => 'planner'
-        ],
-        'igny8_auto_generate_ideas_cron' => [
-            'handler' => 'igny8_auto_generate_ideas_cron_handler',
-            'priority' => 2,
-            'max_execution_time' => 300, // 5 minutes
-            'description' => 'Auto generate ideas from clusters',
-            'module' => 'planner'
-        ],
-        'igny8_auto_queue_cron' => [
-            'handler' => 'igny8_auto_queue_cron_handler',
-            'priority' => 3,
-            'max_execution_time' => 300, // 5 minutes
-            'description' => 'Auto queue new ideas',
-            'module' => 'planner'
-        ],
-        'igny8_auto_generate_content_cron' => [
-            'handler' => 'igny8_auto_generate_content_cron_handler',
-            'priority' => 4,
-            'max_execution_time' => 600, // 10 minutes
-            'description' => 'Auto generate content from queued tasks',
-            'module' => 'writer'
-        ],
-        'igny8_auto_generate_images_cron' => [
-            'handler' => 'igny8_auto_generate_images_cron_handler',
-            'priority' => 5,
-            'max_execution_time' => 900, // 15 minutes
-            'description' => 'Auto generate images for content',
-            'module' => 'writer'
-        ],
-        'igny8_auto_publish_drafts_cron' => [
-            'handler' => 'igny8_auto_publish_drafts_cron_handler',
-            'priority' => 6,
-            'max_execution_time' => 300, // 5 minutes
-            'description' => 'Auto publish completed drafts',
-            'module' => 'writer'
-        ],
-        'igny8_process_ai_queue_cron' => [
-            'handler' => 'igny8_process_ai_queue_cron_handler',
-            'priority' => 7,
-            'max_execution_time' => 300, // 5 minutes
-            'description' => 'Process AI queue tasks',
-            'module' => 'ai'
-        ],
-        'igny8_auto_recalc_cron' => [
-            'handler' => 'igny8_auto_recalc_cron_handler',
-            'priority' => 8,
-            'max_execution_time' => 300, // 5 minutes
-            'description' => 'Auto recalculate metrics',
-            'module' => 'analytics'
-        ],
-        'igny8_auto_optimizer_cron' => [
-            'handler' => 'igny8_auto_optimizer_cron_handler',
-            'priority' => 9,
-            'max_execution_time' => 300, // 5 minutes
-            'description' => 'Auto optimize content and keywords',
-            'module' => 'optimizer'
-        ],
-        'igny8_health_check_cron' => [
-            'handler' => 'igny8_health_check_cron_handler',
-            'priority' => 10,
-            'max_execution_time' => 300, // 5 minutes
-            'description' => 'System health check and cleanup',
-            'module' => 'system'
-        ]
-    ];
-}
-
-
-/**
- * Get default cron settings
- */
-function igny8_get_default_cron_settings() {
-    $jobs = igny8_get_defined_cron_jobs();
-    $settings = [];
-    
-    foreach ($jobs as $job_name => $config) {
-        $settings[$job_name] = [
-            'enabled' => false, // Default to disabled
-            'last_run' => 0
-        ];
-    }
-    
-    return $settings;
-}
-
-/**
- * Get default cron limits
- */
-function igny8_get_default_cron_limits() {
-    return [
-        'igny8_auto_cluster_cron' => 1,
-        'igny8_auto_generate_ideas_cron' => 1,
-        'igny8_auto_queue_cron' => 1,
-        'igny8_auto_generate_content_cron' => 1,
-        'igny8_auto_generate_images_cron' => 1,
-        'igny8_auto_publish_drafts_cron' => 1,
-        'igny8_process_ai_queue_cron' => 1,
-        'igny8_auto_recalc_cron' => 1,
-        'igny8_auto_optimizer_cron' => 1,
-        'igny8_health_check_cron' => 1
-    ];
-}
-
-/**
- * Update cron settings for a specific job
- */
-function igny8_update_cron_job_settings($job_name, $settings) {
-    $cron_settings = get_option('igny8_cron_settings', []);
-    $cron_settings[$job_name] = array_merge($cron_settings[$job_name] ?? [], $settings);
-    update_option('igny8_cron_settings', $cron_settings);
-}
-
-/**
- * Update cron limits for a specific job
- */
-function igny8_update_cron_job_limits($job_name, $limit) {
-    $cron_limits = get_option('igny8_cron_limits', []);
-    $cron_limits[$job_name] = $limit;
-    update_option('igny8_cron_limits', $cron_limits);
-}
-
-/**
- * Get health status for a specific job
- */
-function igny8_get_job_health_status($job_name) {
-    $health = get_option('igny8_cron_health_' . $job_name, []);
-    $cron_settings = get_option('igny8_cron_settings', []);
-    $job_settings = $cron_settings[$job_name] ?? [];
-    
-    return [
-        'enabled' => $job_settings['enabled'] ?? false,
-        'last_run' => isset($health['last_run']) ? date('Y-m-d H:i:s', $health['last_run']) : 'Never',
-        'last_success' => $health['success'] ?? null,
-        'execution_time' => isset($health['execution_time']) ? round($health['execution_time'], 2) : 0,
-        'error_message' => $health['error_message'] ?? '',
-        'processed_count' => $health['processed_count'] ?? 0,
-        'result_details' => $health['result_details'] ?? '',
-        'execution_method' => $health['execution_method'] ?? 'unknown'
-    ];
-}
-
-/**
- * Get cron job status and next run time
- */
-function igny8_get_cron_job_status($job_name) {
-    $cron_settings = get_option('igny8_cron_settings', []);
-    $job_settings = $cron_settings[$job_name] ?? [];
-    
-    if (empty($job_settings)) {
-        return [
-            'enabled' => false,
-            'last_run' => 'Never'
-        ];
-    }
-    
-    return [
-        'enabled' => $job_settings['enabled'] ?? false,
-        'last_run' => isset($job_settings['last_run']) && $job_settings['last_run'] ? date('Y-m-d H:i:s', $job_settings['last_run']) : 'Never'
-    ];
-}

igny8-ai-seo-wp-plugin/core/db/db-migration.php

@@ -1,253 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : db-migration.php
- * @location     : /core/db/db-migration.php
- * @type         : Function Library
- * @scope        : Global
- * @allowed      : Database migrations, schema updates, version tracking
- * @reusability  : Globally Reusable
- * @notes        : Database migration system for schema updates
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * ========================================================================
- * MIGRATION SYSTEM TEMPLATE
- * ========================================================================
- */
-
-/**
- * Get current database version
- */
-function igny8_get_db_version() {
-    return get_option('igny8_db_version', '0.1');
-}
-
-/**
- * Set database version
- */
-function igny8_set_db_version($version) {
-    update_option('igny8_db_version', $version);
-}
-
-/**
- * Check if migration is needed
- */
-function igny8_is_migration_needed($target_version = null) {
-    if (!$target_version) {
-        $target_version = '0.1'; // Current version
-    }
-    
-    $current_version = igny8_get_db_version();
-    return version_compare($current_version, $target_version, '<');
-}
-
-/**
- * Run all pending migrations
- */
-function igny8_run_migrations() {
-    $current_version = igny8_get_db_version();
-    $target_version = '0.1';
-    
-    if (!igny8_is_migration_needed($target_version)) {
-        return true; // No migration needed
-    }
-    
-    // Example migration structure:
-    // if (version_compare($current_version, '2.7.0', '<')) {
-    //     igny8_migration_270();
-    // }
-    
-    // if (version_compare($current_version, '2.7.1', '<')) {
-    //     igny8_migration_271();
-    // }
-    
-    // Update to latest version
-    igny8_set_db_version($target_version);
-    return true;
-}
-
-/**
- * ========================================================================
- * MIGRATION FUNCTIONS TEMPLATE
- * ========================================================================
- */
-
-/**
- * Example migration function template
- * 
- * @param string $from_version Version migrating from
- * @param string $to_version Version migrating to
- */
-function igny8_migration_template($from_version, $to_version) {
-    global $wpdb;
-    
-    try {
-        // Example: Add new column
-        // $table_name = $wpdb->prefix . 'igny8_example_table';
-        // $column_exists = $wpdb->get_var("SHOW COLUMNS FROM `$table_name` LIKE 'new_column'");
-        // if (!$column_exists) {
-        //     $wpdb->query("ALTER TABLE `$table_name` ADD COLUMN `new_column` VARCHAR(255) DEFAULT NULL");
-        // }
-        
-        // Example: Create new table
-        // $sql = "CREATE TABLE IF NOT EXISTS {$wpdb->prefix}igny8_new_table (
-        //     id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        //     name VARCHAR(255) NOT NULL,
-        //     created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        //     PRIMARY KEY (id)
-        // ) {$wpdb->get_charset_collate()};";
-        // dbDelta($sql);
-        
-        // Example: Migrate data
-        // $wpdb->query("UPDATE {$wpdb->prefix}igny8_table SET old_field = new_field WHERE condition");
-        
-        error_log("Igny8 Migration: Successfully migrated from $from_version to $to_version");
-        return true;
-        
-    } catch (Exception $e) {
-        error_log("Igny8 Migration Error: " . $e->getMessage());
-        return false;
-    }
-}
-
-/**
- * ========================================================================
- * MIGRATION UTILITIES
- * ========================================================================
- */
-
-/**
- * Backup table before migration
- */
-function igny8_backup_table($table_name, $suffix = null) {
-    global $wpdb;
-    
-    if (!$suffix) {
-        $suffix = '_backup_' . date('Y_m_d_H_i_s');
-    }
-    
-    $backup_table = $table_name . $suffix;
-    
-    try {
-        $wpdb->query("CREATE TABLE `$backup_table` LIKE `$table_name`");
-        $wpdb->query("INSERT INTO `$backup_table` SELECT * FROM `$table_name`");
-        return $backup_table;
-    } catch (Exception $e) {
-        error_log("Igny8 Migration: Failed to backup table $table_name - " . $e->getMessage());
-        return false;
-    }
-}
-
-/**
- * Restore table from backup
- */
-function igny8_restore_table($table_name, $backup_table) {
-    global $wpdb;
-    
-    try {
-        $wpdb->query("DROP TABLE IF EXISTS `$table_name`");
-        $wpdb->query("CREATE TABLE `$table_name` LIKE `$backup_table`");
-        $wpdb->query("INSERT INTO `$table_name` SELECT * FROM `$backup_table`");
-        return true;
-    } catch (Exception $e) {
-        error_log("Igny8 Migration: Failed to restore table $table_name - " . $e->getMessage());
-        return false;
-    }
-}
-
-/**
- * Check if table exists
- */
-function igny8_table_exists($table_name) {
-    global $wpdb;
-    return $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
-}
-
-/**
- * Check if column exists in table
- */
-function igny8_column_exists($table_name, $column_name) {
-    global $wpdb;
-    $result = $wpdb->get_var("SHOW COLUMNS FROM `$table_name` LIKE '$column_name'");
-    return !empty($result);
-}
-
-/**
- * Get table structure
- */
-function igny8_get_table_structure($table_name) {
-    global $wpdb;
-    return $wpdb->get_results("DESCRIBE `$table_name`", ARRAY_A);
-}
-
-/**
- * ========================================================================
- * AUTO-MIGRATION ON PLUGIN UPDATE
- * ========================================================================
- */
-
-/**
- * Auto-run migrations on plugin update
- */
-function igny8_auto_run_migrations() {
-    if (current_user_can('manage_options') && igny8_is_migration_needed()) {
-        igny8_run_migrations();
-    }
-}
-
-// Hook to auto-run migrations on admin_init
-add_action('admin_init', 'igny8_auto_run_migrations');
-
-/**
- * ========================================================================
- * MIGRATION STATUS & LOGGING
- * ========================================================================
- */
-
-/**
- * Log migration event
- */
-function igny8_log_migration($from_version, $to_version, $status = 'success', $message = '') {
-    $log_entry = [
-        'timestamp' => current_time('mysql'),
-        'from_version' => $from_version,
-        'to_version' => $to_version,
-        'status' => $status,
-        'message' => $message,
-        'user_id' => get_current_user_id()
-    ];
-    
-    // Store in options (you could also use the logs table)
-    $migration_logs = get_option('igny8_migration_logs', []);
-    $migration_logs[] = $log_entry;
-    
-    // Keep only last 50 migration logs
-    if (count($migration_logs) > 50) {
-        $migration_logs = array_slice($migration_logs, -50);
-    }
-    
-    update_option('igny8_migration_logs', $migration_logs);
-}
-
-/**
- * Get migration logs
- */
-function igny8_get_migration_logs($limit = 10) {
-    $logs = get_option('igny8_migration_logs', []);
-    return array_slice(array_reverse($logs), 0, $limit);
-}
-
-/**
- * Clear migration logs
- */
-function igny8_clear_migration_logs() {
-    delete_option('igny8_migration_logs');
-}

igny8-ai-seo-wp-plugin/core/db/db.php

@@ -1,970 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : db.php
- * @location     : /core/db/db.php
- * @type         : Function Library
- * @scope        : Global
- * @allowed      : Database operations, schema management, data queries
- * @reusability  : Globally Reusable
- * @notes        : Central database operations and schema management
- */
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-/**
- * Clean up legacy database structures (if any exist from old installations)
- * 
- * This function handles cleanup of any legacy structures that might exist
- * from previous plugin versions, but all new installations use the correct schema.
- */
-function igny8_cleanup_legacy_structures() {
-    global $wpdb;
-    
-    $table_name = $wpdb->prefix . 'igny8_content_ideas';
-    
-    // Only run cleanup if table exists
-    if (!$wpdb->get_var("SHOW TABLES LIKE '$table_name'")) {
-        return true;
-    }
-    
-    try {
-        // Remove legacy priority column if it exists (from very old versions)
-        $priority_exists = $wpdb->get_var("SHOW COLUMNS FROM `$table_name` LIKE 'priority'");
-        if ($priority_exists) {
-            // Remove index first if it exists
-            $index_exists = $wpdb->get_var("SHOW INDEX FROM `$table_name` WHERE Key_name = 'idx_priority'");
-            if ($index_exists) {
-                $wpdb->query("ALTER TABLE `$table_name` DROP INDEX `idx_priority`");
-            }
-            
-            // Drop the column
-            $wpdb->query("ALTER TABLE `$table_name` DROP COLUMN `priority`");
-            error_log('Igny8 Cleanup: Removed legacy priority column');
-        }
-        
-        // Remove legacy ai_generated column if it exists (should be source now)
-        $ai_generated_exists = $wpdb->get_var("SHOW COLUMNS FROM `$table_name` LIKE 'ai_generated'");
-        if ($ai_generated_exists) {
-            // Check if source column exists
-            $source_exists = $wpdb->get_var("SHOW COLUMNS FROM `$table_name` LIKE 'source'");
-            
-            if (!$source_exists) {
-                // Migrate data from ai_generated to source before dropping
-                $wpdb->query("ALTER TABLE `$table_name` ADD COLUMN `source` ENUM('AI','Manual') DEFAULT 'Manual'");
-                $wpdb->query("UPDATE `$table_name` SET source = CASE WHEN ai_generated = 1 THEN 'AI' ELSE 'Manual' END");
-                error_log('Igny8 Cleanup: Migrated ai_generated to source field');
-            }
-            
-            // Drop the old ai_generated column
-            $wpdb->query("ALTER TABLE `$table_name` DROP COLUMN `ai_generated`");
-            error_log('Igny8 Cleanup: Removed legacy ai_generated column');
-        }
-        
-        // Update any old status values to new format
-        $wpdb->query("UPDATE `$table_name` SET status = 'new' WHERE status NOT IN ('new','scheduled','published')");
-        
-        return true;
-        
-    } catch (Exception $e) {
-        error_log('Igny8 Cleanup Error: ' . $e->getMessage());
-        return false;
-    }
-}
-
-/**
- * Check if legacy cleanup is needed
- */
-function igny8_is_legacy_cleanup_needed() {
-    global $wpdb;
-    
-    $table_name = $wpdb->prefix . 'igny8_content_ideas';
-    
-    // Check if table exists
-    if (!$wpdb->get_var("SHOW TABLES LIKE '$table_name'")) {
-        return false;
-    }
-    
-    // Check for legacy columns
-    $priority_exists = $wpdb->get_var("SHOW COLUMNS FROM `$table_name` LIKE 'priority'");
-    $ai_generated_exists = $wpdb->get_var("SHOW COLUMNS FROM `$table_name` LIKE 'ai_generated'");
-    
-    return $priority_exists || $ai_generated_exists;
-}
-
-/**
- * Auto-run legacy cleanup on admin_init if needed
- */
-function igny8_auto_run_legacy_cleanup() {
-    if (current_user_can('manage_options') && igny8_is_legacy_cleanup_needed()) {
-        igny8_cleanup_legacy_structures();
-    }
-}
-
-// Hook to auto-run legacy cleanup (only for existing installations)
-add_action('admin_init', 'igny8_auto_run_legacy_cleanup');
-
-/**
- * Auto-run logs table migration on admin_init if needed
- */
-function igny8_auto_run_logs_migration() {
-    if (current_user_can('manage_options')) {
-        igny8_migrate_logs_table();
-    }
-}
-
-// Hook to auto-run logs migration (only for existing installations)
-add_action('admin_init', 'igny8_auto_run_logs_migration');
-
-/**
- * Remove old migration option on plugin activation
- */
-function igny8_cleanup_migration_options() {
-    delete_option('igny8_migration_ideas_schema_updated');
-}
-
-/**
- * ========================================================================
- * COMPLETE DATABASE SCHEMA CREATION
- * ========================================================================
- */
-
-/**
- * Create all Igny8 database tables (15 tables total)
- */
-function igny8_create_all_tables() {
-    global $wpdb;
-    $charset_collate = $wpdb->get_charset_collate();
-
-    // Keywords table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_keywords (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        keyword VARCHAR(255) NOT NULL,
-        search_volume INT UNSIGNED DEFAULT 0,
-        difficulty INT UNSIGNED DEFAULT 0,
-        cpc FLOAT DEFAULT 0.00,
-        intent VARCHAR(50) DEFAULT 'informational',
-        cluster_id BIGINT UNSIGNED DEFAULT NULL,
-        sector_id BIGINT UNSIGNED DEFAULT NULL,
-        mapped_post_id BIGINT UNSIGNED DEFAULT NULL,
-        status ENUM('unmapped','mapped','queued','published') DEFAULT 'unmapped',
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        UNIQUE KEY unique_keyword (keyword),
-        KEY idx_cluster_id (cluster_id),
-        KEY idx_sector_id (sector_id),
-        KEY idx_mapped_post_id (mapped_post_id),
-        KEY idx_status (status),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Tasks table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_tasks (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        title VARCHAR(255) NOT NULL,
-        description TEXT DEFAULT NULL,
-        status ENUM('pending','in_progress','completed','cancelled','draft','queued','review','published') DEFAULT 'pending',
-        priority ENUM('low','medium','high','urgent') DEFAULT 'medium',
-        due_date DATETIME DEFAULT NULL,
-        content_structure ENUM('cluster_hub','landing_page','guide_tutorial','how_to','comparison','review','top_listicle','question','product_description','service_page','home_page') DEFAULT 'cluster_hub',
-        content_type ENUM('post','product','page','CPT') DEFAULT 'post',
-        cluster_id BIGINT UNSIGNED DEFAULT NULL,
-        keywords TEXT DEFAULT NULL,
-        meta_title VARCHAR(255) DEFAULT NULL,
-        meta_description TEXT DEFAULT NULL,
-        word_count INT UNSIGNED DEFAULT 0,
-        raw_ai_response LONGTEXT DEFAULT NULL,
-        schedule_at DATETIME DEFAULT NULL,
-        assigned_post_id BIGINT UNSIGNED DEFAULT NULL,
-        idea_id BIGINT UNSIGNED DEFAULT NULL,
-        ai_writer ENUM('ai','human') DEFAULT 'ai',
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_content_structure (content_structure),
-        KEY idx_content_type (content_type),
-        KEY idx_cluster_id (cluster_id),
-        KEY idx_status (status),
-        KEY idx_priority (priority),
-        KEY idx_assigned_post_id (assigned_post_id),
-        KEY idx_schedule_at (schedule_at),
-        KEY idx_idea_id (idea_id),
-        KEY idx_ai_writer (ai_writer),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Data table for personalization
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_data (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        post_id BIGINT UNSIGNED NOT NULL,
-        data_type VARCHAR(50) NOT NULL,
-        data JSON NOT NULL,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_post_id (post_id),
-        KEY idx_data_type (data_type),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Personalization variations table - stores AI-generated personalized content
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_variations (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        post_id BIGINT UNSIGNED NOT NULL,
-        fields_hash CHAR(64) NOT NULL,
-        fields_json LONGTEXT NOT NULL,
-        content LONGTEXT NOT NULL,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_post_id (post_id),
-        KEY idx_fields_hash (fields_hash),
-        KEY idx_created_at (created_at),
-        UNIQUE KEY unique_variation (post_id, fields_hash)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Rankings table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_rankings (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        post_id BIGINT UNSIGNED NOT NULL,
-        keyword VARCHAR(255) NOT NULL,
-        impressions INT UNSIGNED DEFAULT 0,
-        clicks INT UNSIGNED DEFAULT 0,
-        ctr FLOAT DEFAULT 0.00,
-        avg_position FLOAT DEFAULT NULL,
-        source ENUM('gsc','ahrefs','manual') DEFAULT 'manual',
-        fetched_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_post_id (post_id),
-        KEY idx_keyword (keyword),
-        KEY idx_source (source),
-        KEY idx_fetched_at (fetched_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Suggestions table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_suggestions (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        post_id BIGINT UNSIGNED NOT NULL,
-        cluster_id BIGINT UNSIGNED DEFAULT NULL,
-        suggestion_type ENUM('internal_link','keyword_injection','rewrite') NOT NULL,
-        payload JSON DEFAULT NULL,
-        status ENUM('pending','applied','rejected') DEFAULT 'pending',
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        applied_at DATETIME DEFAULT NULL,
-        PRIMARY KEY (id),
-        KEY idx_post_id (post_id),
-        KEY idx_cluster_id (cluster_id),
-        KEY idx_suggestion_type (suggestion_type),
-        KEY idx_status (status),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Campaigns table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_campaigns (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        cluster_id BIGINT UNSIGNED DEFAULT NULL,
-        target_post_id BIGINT UNSIGNED DEFAULT NULL,
-        name VARCHAR(255) NOT NULL,
-        status ENUM('active','completed','paused') DEFAULT 'active',
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_cluster_id (cluster_id),
-        KEY idx_target_post_id (target_post_id),
-        KEY idx_status (status),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Content Ideas table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_content_ideas (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        idea_title VARCHAR(255) NOT NULL,
-        idea_description LONGTEXT DEFAULT NULL,
-        content_structure ENUM('cluster_hub','landing_page','guide_tutorial','how_to','comparison','review','top_listicle','question','product_description','service_page','home_page') DEFAULT 'cluster_hub',
-        content_type ENUM('post','product','page','CPT') DEFAULT 'post',
-        keyword_cluster_id BIGINT UNSIGNED DEFAULT NULL,
-        status ENUM('new','scheduled','published') DEFAULT 'new',
-        estimated_word_count INT UNSIGNED DEFAULT 0,
-        target_keywords TEXT DEFAULT NULL,
-        image_prompts TEXT DEFAULT NULL,
-        source ENUM('AI','Manual') DEFAULT 'Manual',
-        mapped_post_id BIGINT UNSIGNED DEFAULT NULL,
-        tasks_count INT UNSIGNED DEFAULT 0,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_idea_title (idea_title),
-        KEY idx_content_structure (content_structure),
-        KEY idx_content_type (content_type),
-        KEY idx_status (status),
-        KEY idx_keyword_cluster_id (keyword_cluster_id),
-        KEY idx_mapped_post_id (mapped_post_id),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Clusters table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_clusters (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        cluster_name VARCHAR(255) NOT NULL,
-        sector_id BIGINT UNSIGNED DEFAULT NULL,
-        cluster_term_id BIGINT UNSIGNED DEFAULT NULL,
-        status ENUM('active','inactive','archived') DEFAULT 'active',
-        keyword_count INT UNSIGNED DEFAULT 0,
-        total_volume INT UNSIGNED DEFAULT 0,
-        avg_difficulty DECIMAL(5,2) DEFAULT 0.00,
-        mapped_pages_count INT UNSIGNED DEFAULT 0,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_cluster_name (cluster_name),
-        KEY idx_sector_id (sector_id),
-        KEY idx_cluster_term_id (cluster_term_id),
-        KEY idx_status (status),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Sites table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_sites (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        site_url VARCHAR(500) NOT NULL,
-        site_name VARCHAR(255) DEFAULT NULL,
-        domain_authority INT UNSIGNED DEFAULT 0,
-        referring_domains INT UNSIGNED DEFAULT 0,
-        organic_traffic INT UNSIGNED DEFAULT 0,
-        status ENUM('active','inactive','blocked') DEFAULT 'active',
-        last_crawled DATETIME DEFAULT NULL,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        UNIQUE KEY unique_site_url (site_url),
-        KEY idx_domain_authority (domain_authority),
-        KEY idx_status (status),
-        KEY idx_last_crawled (last_crawled),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Backlinks table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_backlinks (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        source_url VARCHAR(500) NOT NULL,
-        target_url VARCHAR(500) NOT NULL,
-        anchor_text VARCHAR(255) DEFAULT NULL,
-        link_type ENUM('dofollow','nofollow','sponsored','ugc') DEFAULT 'dofollow',
-        domain_authority INT UNSIGNED DEFAULT 0,
-        page_authority INT UNSIGNED DEFAULT 0,
-        status ENUM('pending','live','lost','disavowed') DEFAULT 'pending',
-        campaign_id BIGINT UNSIGNED DEFAULT NULL,
-        discovered_date DATE DEFAULT NULL,
-        lost_date DATE DEFAULT NULL,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_source_url (source_url(191)),
-        KEY idx_target_url (target_url(191)),
-        KEY idx_link_type (link_type),
-        KEY idx_status (status),
-        KEY idx_campaign_id (campaign_id),
-        KEY idx_domain_authority (domain_authority),
-        KEY idx_discovered_date (discovered_date),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Mapping table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_mapping (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        source_type ENUM('keyword','cluster','idea','task') NOT NULL,
-        source_id BIGINT UNSIGNED NOT NULL,
-        target_type ENUM('post','page','product') NOT NULL,
-        target_id BIGINT UNSIGNED NOT NULL,
-        mapping_type ENUM('primary','secondary','related') DEFAULT 'primary',
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_source_type_id (source_type, source_id),
-        KEY idx_target_type_id (target_type, target_id),
-        KEY idx_mapping_type (mapping_type),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Prompts table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_prompts (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        prompt_name VARCHAR(255) NOT NULL,
-        prompt_type ENUM('content','optimization','generation','custom') DEFAULT 'content',
-        prompt_text LONGTEXT NOT NULL,
-        variables JSON DEFAULT NULL,
-        is_active TINYINT(1) DEFAULT 1,
-        usage_count INT UNSIGNED DEFAULT 0,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        UNIQUE KEY unique_prompt_name (prompt_name),
-        KEY idx_prompt_type (prompt_type),
-        KEY idx_is_active (is_active),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Logs table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_logs (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        event_type VARCHAR(191) NOT NULL,
-        message TEXT NOT NULL,
-        context LONGTEXT NULL,
-        api_id VARCHAR(255) NULL,
-        status VARCHAR(50) NULL,
-        level VARCHAR(50) NULL,
-        source VARCHAR(100) NULL,
-        user_id BIGINT UNSIGNED NULL,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        PRIMARY KEY (id),
-        KEY idx_event_type (event_type),
-        KEY idx_created_at (created_at),
-        KEY idx_source (source),
-        KEY idx_status (status),
-        KEY idx_user_id (user_id)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // AI Queue table
-    $sql = "CREATE TABLE {$wpdb->prefix}igny8_ai_queue (
-        id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
-        action VARCHAR(50) NOT NULL,
-        data LONGTEXT NOT NULL,
-        user_id BIGINT UNSIGNED NOT NULL,
-        status ENUM('pending','processing','completed','failed') DEFAULT 'pending',
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        processed_at TIMESTAMP NULL,
-        result LONGTEXT NULL,
-        error_message TEXT NULL,
-        PRIMARY KEY (id),
-        KEY idx_user_id (user_id),
-        KEY idx_status (status),
-        KEY idx_action (action),
-        KEY idx_created_at (created_at)
-    ) $charset_collate;";
-    dbDelta($sql);
-
-    // Update database version
-    update_option('igny8_db_version', '0.1');
-}
-
-
-
-
-/**
- * Register Igny8 taxonomies with WordPress
- */
-function igny8_register_taxonomies() {
-    // Register sectors taxonomy (hierarchical) - only if not exists
-    if (!taxonomy_exists('sectors')) {
-        register_taxonomy('sectors', ['post', 'page', 'product'], [
-        'hierarchical' => true,
-        'labels' => [
-            'name' => 'Sectors',
-            'singular_name' => 'Sector',
-            'menu_name' => 'Sectors',
-            'all_items' => 'All Sectors',
-            'edit_item' => 'Edit Sector',
-            'view_item' => 'View Sector',
-            'update_item' => 'Update Sector',
-            'add_new_item' => 'Add New Sector',
-            'new_item_name' => 'New Sector Name',
-            'parent_item' => 'Parent Sector',
-            'parent_item_colon' => 'Parent Sector:',
-            'search_items' => 'Search Sectors',
-            'popular_items' => 'Popular Sectors',
-            'separate_items_with_commas' => 'Separate sectors with commas',
-            'add_or_remove_items' => 'Add or remove sectors',
-            'choose_from_most_used' => 'Choose from most used sectors',
-            'not_found' => 'No sectors found',
-        ],
-        'public' => true,
-        'show_ui' => true,
-        'show_admin_column' => true,
-        'show_in_nav_menus' => true,
-        'show_tagcloud' => true,
-        'show_in_rest' => true,
-        'rewrite' => [
-            'slug' => 'sectors',
-            'with_front' => false,
-        ],
-        'capabilities' => [
-            'manage_terms' => 'manage_categories',
-            'edit_terms' => 'manage_categories',
-            'delete_terms' => 'manage_categories',
-            'assign_terms' => 'edit_posts',
-        ],
-        ]);
-    }
-    
-    // Register clusters taxonomy (hierarchical) - only if not exists
-    if (!taxonomy_exists('clusters')) {
-        register_taxonomy('clusters', ['post', 'page', 'product'], [
-        'hierarchical' => true,
-        'labels' => [
-            'name' => 'Content Clusters',
-            'singular_name' => 'Cluster',
-            'menu_name' => 'Clusters',
-            'all_items' => 'All Clusters',
-            'edit_item' => 'Edit Cluster',
-            'view_item' => 'View Cluster',
-            'update_item' => 'Update Cluster',
-            'add_new_item' => 'Add New Cluster',
-            'new_item_name' => 'New Cluster Name',
-            'parent_item' => 'Parent Cluster',
-            'parent_item_colon' => 'Parent Cluster:',
-            'search_items' => 'Search Clusters',
-            'popular_items' => 'Popular Clusters',
-            'separate_items_with_commas' => 'Separate clusters with commas',
-            'add_or_remove_items' => 'Add or remove clusters',
-            'choose_from_most_used' => 'Choose from most used clusters',
-            'not_found' => 'No clusters found',
-        ],
-        'public' => true,
-        'show_ui' => true,
-        'show_admin_column' => true,
-        'show_in_nav_menus' => true,
-        'show_tagcloud' => true,
-        'show_in_rest' => true,
-        'rewrite' => [
-            'slug' => 'clusters',
-            'with_front' => false,
-        ],
-        'capabilities' => [
-            'manage_terms' => 'manage_categories',
-            'edit_terms' => 'manage_categories',
-            'delete_terms' => 'manage_categories',
-            'assign_terms' => 'edit_posts',
-        ],
-        ]);
-    }
-}
-
-// ==========================================================
-// SEO: Prevent indexing of Cluster and Sector taxonomy pages
-// ==========================================================
-add_action('wp_head', function() {
-    if (is_tax(['clusters', 'sectors'])) {
-        echo '<meta name="robots" content="noindex,follow" />' . "\n";
-    }
-}, 1);
-
-/**
- * Register Igny8 post meta fields with WordPress
- */
-function igny8_register_post_meta() {
-    $post_types = ['post', 'page', 'product'];
-
-    // Define all meta fields with proper schema for REST API
-    $meta_fields = [
-        '_igny8_cluster_id' => [
-            'type'        => 'integer',
-            'description' => 'Assigns content to a cluster',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-        '_igny8_keyword_ids' => [
-            'type'        => 'array',
-            'description' => 'Maps multiple keywords to content',
-            'single'      => true,
-            'show_in_rest'=> [
-                'schema' => [
-                    'type'  => 'array',
-                    'items' => [
-                        'type' => 'integer'
-                    ]
-                ]
-            ]
-        ],
-        '_igny8_task_id' => [
-            'type'        => 'integer',
-            'description' => 'Links WP content back to Writer task',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-        '_igny8_campaign_ids' => [
-            'type'        => 'array',
-            'description' => 'Associates content with backlink campaigns',
-            'single'      => true,
-            'show_in_rest'=> [
-                'schema' => [
-                    'type'  => 'array',
-                    'items' => [
-                        'type' => 'integer'
-                    ]
-                ]
-            ]
-        ],
-        '_igny8_backlink_count' => [
-            'type'        => 'integer',
-            'description' => 'Quick summary count of backlinks to content',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-        '_igny8_last_optimized' => [
-            'type'        => 'string',
-            'description' => 'Tracks last optimization timestamp',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-        '_igny8_meta_title' => [
-            'type'        => 'string',
-            'description' => 'SEO meta title for the content',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-        '_igny8_meta_description' => [
-            'type'        => 'string',
-            'description' => 'SEO meta description for the content',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-        '_igny8_primary_keywords' => [
-            'type'        => 'string',
-            'description' => 'Primary keywords for the content',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-        '_igny8_secondary_keywords' => [
-            'type'        => 'string',
-            'description' => 'Secondary keywords for the content',
-            'single'      => true,
-            'show_in_rest'=> true,
-        ],
-    ];
-
-    // Register each meta field for all relevant post types
-    foreach ($meta_fields as $meta_key => $config) {
-        foreach ($post_types as $post_type) {
-            register_post_meta($post_type, $meta_key, $config);
-        }
-    }
-}
-
-/**
- * Set default plugin options
- */
-function igny8_set_default_options() {
-    // Set default options if they don't exist
-    if (!get_option('igny8_api_key')) {
-        add_option('igny8_api_key', '');
-    }
-    if (!get_option('igny8_ai_enabled')) {
-        add_option('igny8_ai_enabled', 1);
-    }
-    if (!get_option('igny8_debug_enabled')) {
-        add_option('igny8_debug_enabled', 0);
-    }
-    if (!get_option('igny8_monitoring_enabled')) {
-        add_option('igny8_monitoring_enabled', 1);
-    }
-    if (!get_option('igny8_version')) {
-        add_option('igny8_version', '0.1');
-    }
-}
-
-/**
- * Migrate logs table to add missing columns for OpenAI API logging
- */
-function igny8_migrate_logs_table() {
-    global $wpdb;
-    
-    $table_name = $wpdb->prefix . 'igny8_logs';
-    
-    // Check if table exists
-    if (!$wpdb->get_var("SHOW TABLES LIKE '$table_name'")) {
-        return true;
-    }
-    
-    // Check if migration is needed
-    $columns = $wpdb->get_results("SHOW COLUMNS FROM $table_name");
-    $column_names = array_column($columns, 'Field');
-    
-    $needed_columns = ['api_id', 'status', 'level', 'source', 'user_id'];
-    $missing_columns = array_diff($needed_columns, $column_names);
-    
-    if (empty($missing_columns)) {
-        return true; // Migration not needed
-    }
-    
-    try {
-        // Add missing columns
-        if (in_array('api_id', $missing_columns)) {
-            $wpdb->query("ALTER TABLE `$table_name` ADD COLUMN `api_id` VARCHAR(255) NULL");
-        }
-        if (in_array('status', $missing_columns)) {
-            $wpdb->query("ALTER TABLE `$table_name` ADD COLUMN `status` VARCHAR(50) NULL");
-        }
-        if (in_array('level', $missing_columns)) {
-            $wpdb->query("ALTER TABLE `$table_name` ADD COLUMN `level` VARCHAR(50) NULL");
-        }
-        if (in_array('source', $missing_columns)) {
-            $wpdb->query("ALTER TABLE `$table_name` ADD COLUMN `source` VARCHAR(100) NULL");
-        }
-        if (in_array('user_id', $missing_columns)) {
-            $wpdb->query("ALTER TABLE `$table_name` ADD COLUMN `user_id` BIGINT UNSIGNED NULL");
-        }
-        
-        // Add indexes for new columns
-        $indexes_to_add = [
-            'source' => "ALTER TABLE `$table_name` ADD INDEX `idx_source` (`source`)",
-            'status' => "ALTER TABLE `$table_name` ADD INDEX `idx_status` (`status`)",
-            'user_id' => "ALTER TABLE `$table_name` ADD INDEX `idx_user_id` (`user_id`)"
-        ];
-        
-        foreach ($indexes_to_add as $column => $sql) {
-            if (in_array($column, $missing_columns)) {
-                $wpdb->query($sql);
-            }
-        }
-        
-        error_log('Igny8: Logs table migration completed successfully');
-        return true;
-        
-    } catch (Exception $e) {
-        error_log('Igny8 Logs Migration Error: ' . $e->getMessage());
-        return false;
-    }
-}
-
-/**
- * Complete plugin installation function
- */
-function igny8_install_database() {
-    // Create all database tables
-    igny8_create_all_tables();
-    
-    // Migrate logs table if needed
-    igny8_migrate_logs_table();
-    
-    // Register taxonomies
-    igny8_register_taxonomies();
-    
-    // Register post meta fields
-    igny8_register_post_meta();
-    
-    // Set default options
-    igny8_set_default_options();
-    
-    // Update version
-    update_option('igny8_version', '0.1');
-    update_option('igny8_db_version', '0.1');
-    
-    // Add word_count field to tasks table if it doesn't exist
-    igny8_add_word_count_to_tasks();
-    
-    // Add raw_ai_response field to tasks table if it doesn't exist
-    igny8_add_raw_ai_response_to_tasks();
-    
-    // Add tasks_count field to content_ideas table if it doesn't exist
-    igny8_add_tasks_count_to_content_ideas();
-    
-    // Add image_prompts field to content_ideas table if it doesn't exist
-    igny8_add_image_prompts_to_content_ideas();
-    
-    // Update idea_description field to LONGTEXT for structured JSON descriptions
-    igny8_update_idea_description_to_longtext();
-    
-    // Migrate ideas and tasks table structure
-    igny8_migrate_ideas_tasks_structure();
-    
-    // Run legacy cleanup if needed
-    igny8_cleanup_legacy_structures();
-}
-
-/**
- * Add word_count field to tasks table if it doesn't exist
- */
-function igny8_add_word_count_to_tasks() {
-    global $wpdb;
-    
-    // Check if word_count column exists
-    $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_tasks LIKE 'word_count'");
-    
-    if (empty($column_exists)) {
-        // Add word_count column
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks ADD COLUMN word_count INT UNSIGNED DEFAULT 0 AFTER keywords");
-        error_log('Igny8: Added word_count column to tasks table');
-    }
-}
-
-/**
- * Add raw_ai_response field to tasks table if it doesn't exist
- */
-function igny8_add_raw_ai_response_to_tasks() {
-    global $wpdb;
-    
-    $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_tasks LIKE 'raw_ai_response'");
-    
-    if (empty($column_exists)) {
-        // Add raw_ai_response column
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks ADD COLUMN raw_ai_response LONGTEXT DEFAULT NULL AFTER word_count");
-        error_log('Igny8: Added raw_ai_response column to tasks table');
-    }
-}
-
-/**
- * Add tasks_count field to content_ideas table if it doesn't exist
- */
-function igny8_add_tasks_count_to_content_ideas() {
-    global $wpdb;
-    
-    // Check if tasks_count column exists
-    $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_content_ideas LIKE 'tasks_count'");
-    
-    if (empty($column_exists)) {
-        // Add tasks_count column
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas ADD COLUMN tasks_count INT UNSIGNED DEFAULT 0 AFTER mapped_post_id");
-        error_log('Igny8: Added tasks_count column to content_ideas table');
-    }
-}
-
-/**
- * Add image_prompts field to content_ideas table if it doesn't exist
- */
-function igny8_add_image_prompts_to_content_ideas() {
-    global $wpdb;
-    
-    // Check if image_prompts column exists
-    $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_content_ideas LIKE 'image_prompts'");
-    
-    if (empty($column_exists)) {
-        // Add image_prompts column
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas ADD COLUMN image_prompts TEXT DEFAULT NULL AFTER target_keywords");
-        error_log('Igny8: Added image_prompts column to content_ideas table');
-    }
-}
-
-/**
- * Update idea_description field to LONGTEXT to support structured JSON descriptions
- */
-function igny8_update_idea_description_to_longtext() {
-    global $wpdb;
-    
-    // Check current column type
-    $column_info = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_content_ideas LIKE 'idea_description'");
-    
-    if (!empty($column_info)) {
-        $column_type = $column_info[0]->Type;
-        
-        // Only update if it's not already LONGTEXT
-        if (strpos(strtoupper($column_type), 'LONGTEXT') === false) {
-            $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas MODIFY COLUMN idea_description LONGTEXT DEFAULT NULL");
-            error_log('Igny8: Updated idea_description column to LONGTEXT');
-        }
-    }
-}
-
-/**
- * Migrate ideas and tasks table structure
- */
-function igny8_migrate_ideas_tasks_structure() {
-    global $wpdb;
-    
-    // Migrate ideas table
-    igny8_migrate_ideas_table();
-    
-    // Migrate tasks table
-    igny8_migrate_tasks_table();
-}
-
-/**
- * Migrate ideas table structure
- */
-function igny8_migrate_ideas_table() {
-    global $wpdb;
-    
-    // Check if idea_type column exists (old column) and remove it
-    $old_column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_content_ideas LIKE 'idea_type'");
-    if (!empty($old_column_exists)) {
-        // Drop the old idea_type column
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas DROP COLUMN idea_type");
-        error_log('Igny8: Removed idea_type column from ideas table');
-    }
-    
-    // Check if content_structure column exists
-    $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_content_ideas LIKE 'content_structure'");
-    
-    if (empty($column_exists)) {
-        // Add content_structure column with new options
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas ADD COLUMN content_structure ENUM('cluster_hub','landing_page','guide_tutorial','how_to','comparison','review','top_listicle','question','product_description','service_page','home_page') DEFAULT 'cluster_hub' AFTER idea_description");
-        error_log('Igny8: Added content_structure column to ideas table');
-    } else {
-        // Update existing content_structure column with new options
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas MODIFY COLUMN content_structure ENUM('cluster_hub','landing_page','guide_tutorial','how_to','comparison','review','top_listicle','question','product_description','service_page','home_page') DEFAULT 'cluster_hub'");
-        error_log('Igny8: Updated content_structure column options in ideas table');
-    }
-    
-    // Check if content_type column exists
-    $content_type_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_content_ideas LIKE 'content_type'");
-    
-    if (empty($content_type_exists)) {
-        // Add content_type column
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas ADD COLUMN content_type ENUM('post','product','page','CPT') DEFAULT 'post' AFTER content_structure");
-        error_log('Igny8: Added content_type column to ideas table');
-    }
-    
-    // Update indexes
-    $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas DROP INDEX IF EXISTS idx_idea_type");
-    $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas ADD INDEX idx_content_structure (content_structure)");
-    $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_content_ideas ADD INDEX idx_content_type (content_type)");
-}
-
-/**
- * Migrate tasks table structure
- */
-function igny8_migrate_tasks_table() {
-    global $wpdb;
-    
-    // Check if content_structure column exists
-    $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_tasks LIKE 'content_structure'");
-    
-    if (empty($column_exists)) {
-        // Check if content_type column exists (old column)
-        $old_column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_tasks LIKE 'content_type'");
-        
-        if (!empty($old_column_exists)) {
-            // Rename content_type to content_structure with new options
-            $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks CHANGE COLUMN content_type content_structure ENUM('cluster_hub','landing_page','guide_tutorial','how_to','comparison','review','top_listicle','question','product_description','service_page','home_page') DEFAULT 'cluster_hub'");
-            error_log('Igny8: Renamed content_type to content_structure in tasks table');
-        } else {
-            // Add content_structure column with new options
-            $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks ADD COLUMN content_structure ENUM('cluster_hub','landing_page','guide_tutorial','how_to','comparison','review','top_listicle','question','product_description','service_page','home_page') DEFAULT 'cluster_hub' AFTER due_date");
-            error_log('Igny8: Added content_structure column to tasks table');
-        }
-    } else {
-        // Update existing content_structure column with new options
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks MODIFY COLUMN content_structure ENUM('cluster_hub','landing_page','guide_tutorial','how_to','comparison','review','top_listicle','question','product_description','service_page','home_page') DEFAULT 'cluster_hub'");
-        error_log('Igny8: Updated content_structure column options in tasks table');
-    }
-    
-    // Check if content_type column exists (new column)
-    $content_type_exists = $wpdb->get_results("SHOW COLUMNS FROM {$wpdb->prefix}igny8_tasks LIKE 'content_type'");
-    
-    if (empty($content_type_exists)) {
-        // Add content_type column
-        $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks ADD COLUMN content_type ENUM('post','product','page','CPT') DEFAULT 'post' AFTER content_structure");
-        error_log('Igny8: Added content_type column to tasks table');
-    }
-    
-    // Update indexes
-    $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks DROP INDEX IF EXISTS idx_content_type");
-    $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks ADD INDEX idx_content_structure (content_structure)");
-    $wpdb->query("ALTER TABLE {$wpdb->prefix}igny8_tasks ADD INDEX idx_content_type (content_type)");
-}

igny8-ai-seo-wp-plugin/core/global-layout.php

@@ -1,463 +0,0 @@
-<?php
-/**
- * ==========================
- * 🔐 IGNY8 FILE RULE HEADER
- * ==========================
- * @file         : global-layout.php
- * @location     : /core/global-layout.php
- * @type         : Layout
- * @scope        : Global
- * @allowed      : HTML layout, CSS/JS includes, navigation rendering
- * @reusability  : Globally Reusable
- * @notes        : Master layout template for all admin pages
- */
- 
-
-// Prevent direct access
-if (!defined('ABSPATH')) {
-    exit;
-}
-
-// Load helper functions
-require_once plugin_dir_path(__FILE__) . 'admin/global-helpers.php';
-
-// Evidence functions removed - no longer needed
-
-// Component functions are loaded globally in igny8.php
-
-// KPI configuration is loaded globally in igny8.php
-
-// Load KPI data for header metrics based on current module/submodule
-$kpi_data = [];
-if (isset($GLOBALS['igny8_kpi_config']) && !empty($GLOBALS['igny8_kpi_config'])) {
-    $kpi_config = $GLOBALS['igny8_kpi_config'];
-    
-    // Determine the table_id based on current module and submodule
-    $current_module = $GLOBALS['current_module'] ?? '';
-    $current_submodule = $GLOBALS['current_submodule'] ?? '';
-    $current_page = $_GET['page'] ?? '';
-    
-    // Special handling for home pages
-    if ($current_page === 'igny8-planner' && empty($current_submodule)) {
-        $table_id = 'planner_home';
-    } elseif ($current_page === 'igny8-writer' && empty($current_submodule)) {
-        $table_id = 'writer_home';
-    } elseif (!empty($current_module) && !empty($current_submodule)) {
-        $table_id = $current_module . '_' . $current_submodule;
-    } else {
-        $table_id = '';
-    }
-    
-    // Load KPI data if configuration exists for this table
-    if (!empty($table_id) && isset($kpi_config[$table_id])) {
-        $kpi_data = igny8_get_kpi_data_safe($table_id, $kpi_config[$table_id]);
-    }
-}
-?>
-<div class="igny8-page-wrapper">
-
-    <!-- SIDEBAR SECTION -->
-    <aside class="igny8-sidebar">
-        <!-- LOGO / BRAND -->
-        <div class="igny8-sidebar-logo">
-            <h2>IGNY8 AI SEO</h2>
-        </div>
-
-        <!-- VERSION BADGE -->
-        <div class="igny8-version-badge">
-            <span class="igny8-badge igny8-btn-danger">v<?php echo get_plugin_data(plugin_dir_path(__FILE__) . '../igny8.php')['Version']; ?></span>
-        </div>
-
-        <!-- BREADCRUMB NAVIGATION -->
-        <div class="igny8-breadcrumb">
-            <?php echo igny8_render_breadcrumb(); ?>
-        </div>
-
-        <!-- DEBUG STATUS CIRCLES (submodule pages only) -->
-        <?php 
-        $is_debug_enabled = defined('WP_DEBUG') && WP_DEBUG;
-        $is_monitoring_enabled = get_option('igny8_debug_enabled', false);
-        $is_submodule_page = !empty($_GET['sm']) || !empty($GLOBALS['current_submodule']);
-        
-        if ($is_debug_enabled && $is_monitoring_enabled && $is_submodule_page): 
-            // Simple debug circles - will be updated by JavaScript based on actual debug card states
-            $debug_circles = [
-                'database' => ['title' => 'Database', 'status' => 'secondary'],
-                'table' => ['title' => 'Table', 'status' => 'secondary'],
-                'filters' => ['title' => 'Filters', 'status' => 'secondary'],
-                'forms' => ['title' => 'Forms', 'status' => 'secondary'],
-                'automation' => ['title' => 'Automation', 'status' => 'secondary'],
-                'ai_logs' => ['title' => 'AI Logs', 'status' => 'secondary']
-            ];
-        ?>
-        <div class="igny8-sidebar-status-bar" style="padding: 12px 16px; border-bottom: 1px solid var(--border);">
-            <div class="igny8-status-row">
-                <div class="igny8-flex" style="justify-content: center; gap: 8px;">
-                    <?php foreach ($debug_circles as $circle_key => $circle_data): ?>
-                        <div class="bg-circle-sm bg-<?php echo esc_attr($circle_data['status']); ?> igny8-debug-circle" data-component="<?php echo esc_attr($circle_key); ?>" title="<?php echo esc_attr($circle_data['title']); ?>"></div>
-                    <?php endforeach; ?>
-                </div>
-            </div>
-        </div>
-        <?php endif; ?>
-
-        <!-- MAIN NAVIGATION -->
-        <nav class="igny8-sidebar-nav">
-            <?php 
-            $current_page = $_GET['page'] ?? '';
-            $home_active = ($current_page === 'igny8-home') ? 'active' : '';
-            $settings_active = (strpos($current_page, 'igny8-settings') !== false) ? 'active' : '';
-            $help_active = (strpos($current_page, 'igny8-help') !== false) ? 'active' : '';
-            
-            // Always show home, settings, and help
-            ?>
-            <a href="<?php echo admin_url('admin.php?page=igny8-home'); ?>" class="igny8-sidebar-link <?php echo $home_active; ?>">
-                <span class="dashicons dashicons-dashboard"></span>
-                <span class="label">Igny8 Home</span>
-            </a>
-            
-            <?php 
-            // Show modules only if they are enabled
-            if (function_exists('igny8_is_module_enabled')) {
-                // Main modules
-                if (igny8_is_module_enabled('planner')) {
-                    $planner_active = (strpos($current_page, 'igny8-planner') !== false) ? 'active' : '';
-                    ?>
-                    <a href="<?php echo admin_url('admin.php?page=igny8-planner'); ?>" class="igny8-sidebar-link <?php echo $planner_active; ?>">
-                        <span class="dashicons dashicons-tag"></span>
-                        <span class="label">Planner</span>
-                    </a>
-                    <?php
-                }
-                
-                if (igny8_is_module_enabled('writer')) {
-                    $writer_active = (strpos($current_page, 'igny8-writer') !== false) ? 'active' : '';
-                    ?>
-                    <a href="<?php echo admin_url('admin.php?page=igny8-writer'); ?>" class="igny8-sidebar-link <?php echo $writer_active; ?>">
-                        <span class="dashicons dashicons-edit"></span>
-                        <span class="label">Writer</span>
-                    </a>
-                    <?php
-                }
-                
-                if (igny8_is_module_enabled('linker')) {
-                    $linker_active = (strpos($current_page, 'igny8-linker') !== false) ? 'active' : '';
-                    ?>
-                    <a href="<?php echo admin_url('admin.php?page=igny8-linker'); ?>" class="igny8-sidebar-link <?php echo $linker_active; ?>">
-                        <span class="dashicons dashicons-admin-links"></span>
-                        <span class="label">Linker</span>
-                    </a>
-                    <?php
-                }
-                
-                if (igny8_is_module_enabled('personalize')) {
-                    $personalize_active = (strpos($current_page, 'igny8-personalize') !== false) ? 'active' : '';
-                    ?>
-                    <a href="<?php echo admin_url('admin.php?page=igny8-personalize'); ?>" class="igny8-sidebar-link <?php echo $personalize_active; ?>">
-                        <span class="dashicons dashicons-admin-customizer"></span>
-                        <span class="label">Personalize</span>
-                    </a>
-                    <div class="igny8-sidebar-divider"></div> <?php
-                }
-
-                ?>
-                
-                <?php
-                // Thinker before schedules
-                if (igny8_is_module_enabled('thinker')) {
-                    $thinker_active = (strpos($current_page, 'igny8-thinker') !== false) ? 'active' : '';
-                    ?>
-                    <a href="<?php echo admin_url('admin.php?page=igny8-thinker'); ?>" class="igny8-sidebar-link <?php echo $thinker_active; ?>">
-                        <span class="dashicons dashicons-lightbulb"></span>
-                        <span class="label">Thinker</span>
-                    </a>
-                    <?php
-                }
-                
-                // Admin modules
-                if (igny8_is_module_enabled('schedules')) {
-                    $schedules_active = (strpos($current_page, 'igny8-schedules') !== false) ? 'active' : '';
-                    ?>
-                    <a href="<?php echo admin_url('admin.php?page=igny8-schedules'); ?>" class="igny8-sidebar-link <?php echo $schedules_active; ?>">
-                        <span class="dashicons dashicons-calendar-alt"></span>
-                        <span class="label">Schedules</span>
-                    </a>
-                    <?php
-                }
-                
-                
-                // Analytics before Settings
-                if (igny8_is_module_enabled('analytics')) {
-                    $analytics_active = (strpos($current_page, 'igny8-analytics') !== false) ? 'active' : '';
-                    ?>
-                    <a href="<?php echo admin_url('admin.php?page=igny8-analytics'); ?>" class="igny8-sidebar-link <?php echo $analytics_active; ?>">
-                        <span class="dashicons dashicons-chart-line"></span>
-                        <span class="label">Analytics</span>
-                    </a>
-                    <?php
-                }
-                
-            } else {
-                // Fallback: show all modules if module manager is not available
-                ?>
-                <a href="<?php echo admin_url('admin.php?page=igny8-planner'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-planner') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-tag"></span>
-                    <span class="label">Planner</span>
-                </a>
-                <a href="<?php echo admin_url('admin.php?page=igny8-writer'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-writer') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-edit"></span>
-                    <span class="label">Writer</span>
-                </a>
-                <a href="<?php echo admin_url('admin.php?page=igny8-optimizer'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-optimizer') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-performance"></span>
-                    <span class="label">Optimizer</span>
-                </a>
-                <a href="<?php echo admin_url('admin.php?page=igny8-linker'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-linker') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-admin-links"></span>
-                    <span class="label">Linker</span>
-                </a>
-                <a href="<?php echo admin_url('admin.php?page=igny8-personalize'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-personalize') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-admin-customizer"></span>
-                    <span class="label">Personalize</span>
-                </a>
-                
-                <div class="igny8-sidebar-divider"></div>
-                
-                <a href="<?php echo admin_url('admin.php?page=igny8-thinker'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-thinker') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-lightbulb"></span>
-                    <span class="label">Thinker</span>
-                </a>
-                <a href="<?php echo admin_url('admin.php?page=igny8-schedules'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-schedules') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-calendar-alt"></span>
-                    <span class="label">Schedules</span>
-                </a>
-                <a href="<?php echo admin_url('admin.php?page=igny8-analytics'); ?>" class="igny8-sidebar-link <?php echo (strpos($current_page, 'igny8-analytics') !== false) ? 'active' : ''; ?>">
-                    <span class="dashicons dashicons-chart-line"></span>
-                    <span class="label">Analytics</span>
-                </a>
-                <?php
-            }
-            ?>
-            
-            
-            <a href="<?php echo admin_url('admin.php?page=igny8-settings'); ?>" class="igny8-sidebar-link <?php echo $settings_active; ?>">
-                <span class="dashicons dashicons-admin-generic"></span>
-                <span class="label">Settings</span>
-            </a>
-            <a href="<?php echo admin_url('admin.php?page=igny8-help'); ?>" class="igny8-sidebar-link <?php echo $help_active; ?>">
-                <span class="dashicons dashicons-sos"></span>
-                <span class="label">Help</span>
-            </a>
-        </nav>
-        
-        <div class="igny8-sidebar-divider"></div>
-        
-
-        <!-- JavaScript to update sidebar debug circles based on debug card states -->
-        <?php if ($is_debug_enabled && $is_monitoring_enabled && $is_submodule_page): ?>
-        <script>
-        document.addEventListener('DOMContentLoaded', function() {
-            // Function to update sidebar debug circles based on debug card states
-            function updateSidebarDebugCircles() {
-                const circles = document.querySelectorAll('.igny8-debug-circle');
-                
-                circles.forEach(circle => {
-                    const component = circle.getAttribute('data-component');
-                    let matchingCard = null;
-                    
-                    if (component === 'ai_logs') {
-                        // Special handling for AI logs - it's in the automation section
-                        const debugCards = document.querySelectorAll('.igny8-debug-item');
-                        debugCards.forEach(card => {
-                            const cardText = card.textContent.toLowerCase();
-                            if (cardText.includes('ai logs') || cardText.includes('ai_logs')) {
-                                matchingCard = card;
-                            }
-                        });
-                    } else {
-                        // Regular handling for other components
-                        const debugCards = document.querySelectorAll('.igny8-debug-item');
-                        debugCards.forEach(card => {
-                            const cardText = card.textContent.toLowerCase();
-                            const componentName = component.toLowerCase();
-                            
-                            if (cardText.includes(componentName)) {
-                                matchingCard = card;
-                            }
-                        });
-                    }
-                    
-                    if (matchingCard) {
-                        // Get the status from the background color
-                        const bgColor = matchingCard.style.backgroundColor;
-                        let status = 'secondary'; // default
-                        
-                        if (bgColor.includes('212, 237, 218') || bgColor.includes('rgb(212, 237, 218)')) { // success green
-                            status = 'success';
-                        } else if (bgColor.includes('255, 243, 205') || bgColor.includes('rgb(255, 243, 205)')) { // warning yellow
-                            status = 'warning';
-                        } else if (bgColor.includes('248, 215, 218') || bgColor.includes('rgb(248, 215, 218)')) { // error red
-                            status = 'danger';
-                        }
-                        
-                        // Update circle classes
-                        circle.className = `bg-circle-sm bg-${status} igny8-debug-circle`;
-                    }
-                });
-            }
-            
-            // Update circles when page loads
-            setTimeout(updateSidebarDebugCircles, 1000); // Wait for debug cards to load
-            
-            // Update circles periodically to catch dynamic changes
-            setInterval(updateSidebarDebugCircles, 3000);
-        });
-        </script>
-        <?php endif; ?>
-
-        <!-- FOOTER SHORTCUTS -->
-        <div class="igny8-sidebar-footer-container">
-            <div class="igny8-sidebar-footer">
-                <a href="<?php echo admin_url('options-general.php'); ?>" class="igny8-sidebar-link">
-                    <span class="dashicons dashicons-admin-generic"></span>
-                    <span class="label">Settings</span>
-                </a>
-                <a href="<?php echo wp_logout_url(); ?>" class="igny8-sidebar-link">
-                    <span class="dashicons dashicons-migrate"></span>
-                    <span class="label">Logout</span>
-                </a>
-            </div>
-        </div>
-    </aside>
-
-    <!-- MAIN CONTAINER -->
-    <div class="igny8-main-area">
-
-        <!-- HEADER SECTION -->
-        <header class="igny8-header">
-            <!-- LEFT: Dynamic Submenu Navigation -->
-            <div class="igny8-header-left">
-                <div class="igny8-submenu">
-                    <div class="igny8-submenu-buttons">
-                        <?php echo igny8_render_submenu(); ?>
-                    </div>
-                </div>
-            </div>
-
-            <!-- CENTER: Page Title & Description -->
-            <div class="igny8-header-center">
-                <div class="igny8-page-title">
-                    <h1><?php
-                    // Hardcoded page titles
-                    $page_titles = [
-                        'igny8-home' => 'Dashboard',
-                        'igny8-planner' => 'Planner',
-                        'igny8-writer' => 'Writer',
-                        'igny8-thinker' => 'Thinker',
-                        'igny8-analytics' => 'Analytics',
-                        'igny8-settings' => 'Settings',
-                        'igny8-schedules' => 'Schedules',
-                        'igny8-help' => 'Help'
-                    ];
-                    echo $page_titles[$current_page] ?? 'IGNY8 AI SEO';
-                    ?></h1>
-                </div>
-            </div>
-
-            <!-- RIGHT: Metrics Bar + Icons -->
-            <div class="igny8-header-right">
-                <!-- Metrics - Compact Format -->
-                <div class="igny8-metrics-compact">
-                    <?php 
-                    // Use the same KPI logic as before but inline
-                    if (empty($kpi_data)) {
-                        $max_fallback = ($current_module === 'planner') ? 4 : 6;
-                        $all_fallback_metrics = [
-                            
-                            ['value' => 0, 'label' => 'Active', 'color' => 'green'],
-                            ['value' => 0, 'label' => 'Pending', 'color' => 'amber'],
-                            ['value' => 0, 'label' => 'Completed', 'color' => 'purple'],
-                            ['value' => 0, 'label' => 'Recent', 'color' => 'blue']
-                           
-                        ];
-                        $fallback_metrics = array_slice($all_fallback_metrics, 0, $max_fallback);
-                        
-                        foreach ($fallback_metrics as $metric):
-                    ?>
-                        <div class="metric <?php echo $metric['color']; ?>">
-                            <span class="val"><?php echo number_format($metric['value']); ?></span>
-                            <span class="lbl"><?php echo $metric['label']; ?></span>
-                        </div>
-                    <?php 
-                        endforeach;
-                    } else {
-                        // Get metrics - 4 for planner pages, 6 for others
-                        $max_metrics = ($current_module === 'planner') ? 4 : 6;
-                        $metrics = array_slice($kpi_data, 0, $max_metrics, true);
-                        $color_map = ['', 'green', 'amber', 'purple', 'blue', 'teal'];
-                        $color_index = 0;
-                        
-                        foreach ($metrics as $metric_key => $metric_value):
-                            $kpi_config = $GLOBALS['igny8_kpi_config'] ?? [];
-                            $color = '';
-                            if (isset($kpi_config[$table_id][$metric_key]['color'])) {
-                                $color = $kpi_config[$table_id][$metric_key]['color'];
-                            } else {
-                                $color = $color_map[$color_index] ?? '';
-                            }
-                            
-                            $label = $metric_key;
-                            if (isset($kpi_config[$table_id][$metric_key]['label'])) {
-                                $label = $kpi_config[$table_id][$metric_key]['label'];
-                            }
-                        ?>
-                            <div class="metric <?php echo $color; ?>">
-                                <span class="val"><?php echo number_format($metric_value); ?></span>
-                                <span class="lbl"><?php echo $label; ?></span>
-                            </div>
-                        <?php 
-                        $color_index++;
-                        endforeach;
-                    }
-                    ?>
-                </div>
-
-                <!-- Header User Icon -->
-                <div class="igny8-header-icons">
-                    <span class="dashicons dashicons-admin-users" title="User"></span>
-                </div>
-            </div>
-        </header>
-
-        <!-- MAIN CONTENT AREA -->
-        <main class="igny8-content">
-            <?php echo $igny8_page_content ?? '<p>No content provided.</p>'; ?>
-            
-            <!-- MODULE DEBUG SECTION (conditional based on toggle and submodule pages) -->
-            <?php 
-            // Only show module debug if:
-            // 1. WP_DEBUG is enabled
-            // 2. Debug monitoring toggle is enabled
-            // 3. We're on a submodule page (not home page)
-            $is_debug_enabled = defined('WP_DEBUG') && WP_DEBUG;
-            $is_monitoring_enabled = get_option('igny8_debug_enabled', false);
-            $is_submodule_page = !empty($_GET['sm']) || !empty($GLOBALS['current_submodule']);
-            
-            if ($is_debug_enabled && $is_monitoring_enabled && $is_submodule_page) {
-                require_once plugin_dir_path(__FILE__) . '../debug/module-debug.php';
-                $debug_content = igny8_get_module_debug_content();
-                if (!empty($debug_content)) {
-                    echo $debug_content;
-                }
-            }
-            ?>
-        </main>
-        
-        <!-- FOOTER SECTION -->
-        <footer class="igny8-footer">
-            <div class="igny8-footer-content">
-                <span>&copy; <?php echo date('Y'); ?> Igny8 Plugin</span>
-            </div>
-        </footer>
-    </div>
-</div>