from django.db import models from igny8_core.auth.models import SiteSectorBaseModel, SeedKeyword class Clusters(SiteSectorBaseModel): """Clusters model for keyword grouping""" CONTEXT_TYPE_CHOICES = [ ('topic', 'Topic Cluster'), ('attribute', 'Attribute Cluster'), ('service_line', 'Service Line'), ] 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') context_type = models.CharField( max_length=50, choices=CONTEXT_TYPE_CHOICES, default='topic', help_text="Primary dimension for this cluster (topic, attribute, service line)" ) dimension_meta = models.JSONField( default=dict, blank=True, help_text="Extended metadata (taxonomy hints, attribute suggestions, coverage targets)" ) 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']), models.Index(fields=['context_type']), ] 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'), ] SITE_ENTITY_TYPE_CHOICES = [ ('post', 'Post'), ('page', 'Page'), ('product', 'Product'), ('service', 'Service'), ('taxonomy_term', 'Taxonomy Term'), ] CLUSTER_ROLE_CHOICES = [ ('hub', 'Hub'), ('supporting', 'Supporting'), ('attribute', 'Attribute'), ] 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')} ) taxonomy = models.ForeignKey( 'site_building.SiteBlueprintTaxonomy', on_delete=models.SET_NULL, null=True, blank=True, related_name='content_ideas', help_text="Optional taxonomy association when derived from blueprint planning" ) status = models.CharField(max_length=50, choices=STATUS_CHOICES, default='new') estimated_word_count = models.IntegerField(default=1000) site_entity_type = models.CharField( max_length=50, choices=SITE_ENTITY_TYPE_CHOICES, default='page', help_text="Target entity type when promoting idea into tasks/pages" ) cluster_role = models.CharField( max_length=50, choices=CLUSTER_ROLE_CHOICES, default='hub', help_text="Role within the cluster-driven sitemap" ) 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=['site_entity_type']), models.Index(fields=['cluster_role']), models.Index(fields=['site', 'sector']), ] def __str__(self): return self.idea_title