from django.db import models from igny8_core.auth.models import SiteSectorBaseModel, SeedKeyword class Clusters(SiteSectorBaseModel): """Clusters model for keyword grouping - pure topic clusters""" name = models.CharField(max_length=255, unique=True, db_index=True) description = models.TextField(blank=True, null=True) keywords_count = models.IntegerField(default=0) volume = models.IntegerField(default=0) mapped_pages = models.IntegerField(default=0) status = models.CharField(max_length=50, default='active') created_at = models.DateTimeField(auto_now_add=True) updated_at = models.DateTimeField(auto_now=True) class Meta: app_label = 'planner' db_table = 'igny8_clusters' ordering = ['name'] verbose_name = 'Cluster' verbose_name_plural = 'Clusters' indexes = [ models.Index(fields=['name']), models.Index(fields=['status']), models.Index(fields=['site', 'sector']), ] def __str__(self): return self.name class Keywords(SiteSectorBaseModel): """ Keywords model for SEO keyword management. Site-specific instances that reference global SeedKeywords. """ STATUS_CHOICES = [ ('active', 'Active'), ('pending', 'Pending'), ('archived', 'Archived'), ] # Required: Link to global SeedKeyword seed_keyword = models.ForeignKey( SeedKeyword, on_delete=models.PROTECT, # Prevent deletion if Keywords reference it related_name='site_keywords', help_text="Reference to the global seed keyword" ) # Site-specific overrides (optional) volume_override = models.IntegerField( null=True, blank=True, help_text="Site-specific volume override (uses seed_keyword.volume if not set)" ) difficulty_override = models.IntegerField( null=True, blank=True, help_text="Site-specific difficulty override (uses seed_keyword.difficulty if not set)" ) attribute_values = models.JSONField( default=list, blank=True, help_text="Optional attribute metadata (e.g., product specs, service modifiers)" ) cluster = models.ForeignKey( 'Clusters', on_delete=models.SET_NULL, null=True, blank=True, related_name='keywords', limit_choices_to={'sector': models.F('sector')} # Cluster must be in same sector ) status = models.CharField(max_length=50, choices=STATUS_CHOICES, default='pending') created_at = models.DateTimeField(auto_now_add=True) updated_at = models.DateTimeField(auto_now=True) class Meta: app_label = 'planner' db_table = 'igny8_keywords' ordering = ['-created_at'] verbose_name = 'Keyword' verbose_name_plural = 'Keywords' unique_together = [['seed_keyword', 'site', 'sector']] # One keyword per site/sector indexes = [ models.Index(fields=['seed_keyword']), models.Index(fields=['status']), models.Index(fields=['cluster']), models.Index(fields=['site', 'sector']), models.Index(fields=['seed_keyword', 'site', 'sector']), ] @property def keyword(self): """Get keyword text from seed_keyword""" return self.seed_keyword.keyword if self.seed_keyword else '' @property def volume(self): """Get volume from override or seed_keyword""" return self.volume_override if self.volume_override is not None else (self.seed_keyword.volume if self.seed_keyword else 0) @property def difficulty(self): """Get difficulty from override or seed_keyword""" return self.difficulty_override if self.difficulty_override is not None else (self.seed_keyword.difficulty if self.seed_keyword else 0) @property def intent(self): """Get intent from seed_keyword""" return self.seed_keyword.intent if self.seed_keyword else 'informational' def save(self, *args, **kwargs): """Validate that seed_keyword's industry/sector matches site's industry/sector""" if self.seed_keyword and self.site and self.sector: # Validate industry match if self.site.industry != self.seed_keyword.industry: from django.core.exceptions import ValidationError raise ValidationError( f"SeedKeyword industry ({self.seed_keyword.industry.name}) must match site industry ({self.site.industry.name})" ) # Validate sector match (site sector's industry_sector must match seed_keyword's sector) if self.sector.industry_sector != self.seed_keyword.sector: from django.core.exceptions import ValidationError raise ValidationError( f"SeedKeyword sector ({self.seed_keyword.sector.name}) must match site sector's industry sector ({self.sector.industry_sector.name if self.sector.industry_sector else 'None'})" ) super().save(*args, **kwargs) def __str__(self): return self.keyword class ContentIdeas(SiteSectorBaseModel): """Content Ideas model for planning content based on keyword clusters""" STATUS_CHOICES = [ ('new', 'New'), ('scheduled', 'Scheduled'), ('published', 'Published'), ] CONTENT_TYPE_CHOICES = [ ('post', 'Post'), ('page', 'Page'), ('product', 'Product'), ('taxonomy', 'Taxonomy'), ] CONTENT_STRUCTURE_CHOICES = [ # Post structures ('article', 'Article'), ('guide', 'Guide'), ('comparison', 'Comparison'), ('review', 'Review'), ('listicle', 'Listicle'), # Page structures ('landing_page', 'Landing Page'), ('business_page', 'Business Page'), ('service_page', 'Service Page'), ('general', 'General'), ('cluster_hub', 'Cluster Hub'), # Product structures ('product_page', 'Product Page'), # Taxonomy structures ('category_archive', 'Category Archive'), ('tag_archive', 'Tag Archive'), ('attribute_archive', 'Attribute Archive'), ] idea_title = models.CharField(max_length=255, db_index=True) description = models.TextField(blank=True, null=True) target_keywords = models.CharField(max_length=500, blank=True) # Comma-separated keywords (legacy) keyword_objects = models.ManyToManyField( 'Keywords', blank=True, related_name='content_ideas', help_text="Individual keywords linked to this content idea" ) keyword_cluster = models.ForeignKey( Clusters, on_delete=models.SET_NULL, null=True, blank=True, related_name='ideas', limit_choices_to={'sector': models.F('sector')} ) # REMOVED: taxonomy FK to SiteBlueprintTaxonomy (legacy blueprint functionality) status = models.CharField(max_length=50, choices=STATUS_CHOICES, default='new') estimated_word_count = models.IntegerField(default=1000) content_type = models.CharField( max_length=50, choices=CONTENT_TYPE_CHOICES, default='post', help_text="Content type: post, page, product, taxonomy" ) content_structure = models.CharField( max_length=50, choices=CONTENT_STRUCTURE_CHOICES, default='article', help_text="Content structure/format based on content type" ) created_at = models.DateTimeField(auto_now_add=True) updated_at = models.DateTimeField(auto_now=True) class Meta: app_label = 'planner' db_table = 'igny8_content_ideas' ordering = ['-created_at'] verbose_name = 'Content Idea' verbose_name_plural = 'Content Ideas' indexes = [ models.Index(fields=['idea_title']), models.Index(fields=['status']), models.Index(fields=['keyword_cluster']), models.Index(fields=['content_type']), models.Index(fields=['content_structure']), models.Index(fields=['site', 'sector']), ] def __str__(self): return self.idea_title