Remove obsolete migration and workflow files; delete Site Builder Wizard references and related components. Update documentation to reflect the removal of the WorkflowState model and streamline the site building process.

2025-11-21 00:59:34 +00:00
parent 6bb918bad6
commit c8adfe06d1
23 changed files with 1914 additions and 3493 deletions
--- a/master-docs/02-APPLICATION-ARCHITECTURE.md
+++ b/master-docs/02-APPLICATION-ARCHITECTURE.md
@@ -1,6 +1,6 @@
 # IGNY8 Application Architecture

-**Last Updated:** 2025-01-XX  
+**Last Updated:** 2025-01-XX (Added 6 missing modules: Linker, Optimizer, Publisher, Site Builder, Automation, Integration)  
 **Purpose:** Complete application architecture documentation covering system hierarchy, user roles, access control, modules, workflows, data models, multi-tenancy, API architecture, and security.

 ---
@@ -34,6 +34,12 @@
 | **Content Generation** | AI-powered blog post and article generation | Writer |
 | **Image Generation** | AI-powered image generation (DALL-E, Runware) | Writer |
 | **WordPress Integration** | Direct publishing to WordPress sites | Writer |
+| **Internal Linking** | AI-powered internal linking suggestions | Linker |
+| **Content Optimization** | Content scoring and optimization suggestions | Optimizer |
+| **Site Publishing** | Publishing records and site deployment | Publisher |
+| **Site Blueprints** | Site structure and page blueprint management | Site Builder |
+| **Automation** | Automation rules and scheduled tasks | Automation |
+| **Site Integration** | External platform integrations and sync | Integration |
 | **Account Management** | Multi-account SaaS with user roles | Auth |
 | **Billing & Credits** | Credit-based billing system | Billing |
 | **AI Configuration** | Customizable AI prompts and settings | System |
@@ -145,7 +151,13 @@ Task (1) ──< (N) Images
 | Module | Purpose | Models | ViewSets | Celery Tasks |
 |--------|---------|--------|----------|--------------|
 | **Planner** | Keyword management & content planning | Keywords, Clusters, ContentIdeas | KeywordViewSet, ClusterViewSet, ContentIdeasViewSet | auto_cluster_keywords_task, auto_generate_ideas_task |
-| **Writer** | Content generation & management | Tasks, Content, Images | TasksViewSet, ImagesViewSet | auto_generate_content_task, auto_generate_images_task |
+| **Writer** | Content generation & management | Tasks, Content, Images | TasksViewSet, ContentViewSet, ImagesViewSet | auto_generate_content_task, auto_generate_images_task |
+| **Linker** | Internal linking operations | - | LinkerViewSet | - |
+| **Optimizer** | Content optimization & scoring | - | OptimizerViewSet | - |
+| **Publisher** | Publishing records & site deployment | PublishingRecord, DeploymentRecord | PublishingRecordViewSet, DeploymentRecordViewSet, PublisherViewSet | - |
+| **Site Builder** | Site blueprint management | SiteBlueprint, PageBlueprint, SiteBlueprintCluster, SiteBlueprintTaxonomy | SiteBlueprintViewSet, PageBlueprintViewSet, SiteAssetView, SiteBuilderMetadataView | - |
+| **Automation** | Automation rules & scheduled tasks | AutomationRule, ScheduledTask | AutomationRuleViewSet, ScheduledTaskViewSet | - |
+| **Integration** | External platform integrations | SiteIntegration | IntegrationViewSet | - |
 | **System** | Settings, prompts, integrations | AIPrompt, IntegrationSettings, AuthorProfile, Strategy | AIPromptViewSet, IntegrationSettingsViewSet, AuthorProfileViewSet | - |
 | **Billing** | Credits, transactions, usage | CreditTransaction, CreditUsageLog | CreditTransactionViewSet, CreditUsageLogViewSet | - |
 | **Auth** | Multi-tenancy, users, accounts | Account, User, Plan, Site, Sector | AccountViewSet, UserViewSet, SiteViewSet, SectorViewSet | - |
@@ -156,6 +168,12 @@ Task (1) ──< (N) Images
 Auth (Core)
  ├── Planner (depends on Auth)
  ├── Writer (depends on Auth, Planner)
+  ├── Linker (depends on Auth, Writer)
+  ├── Optimizer (depends on Auth, Writer)
+  ├── Publisher (depends on Auth, Writer, Site Builder)
+  ├── Site Builder (depends on Auth, Planner)
+  ├── Automation (depends on Auth, Planner, Writer)
+  ├── Integration (depends on Auth, Writer)
  ├── System (depends on Auth)
  └── Billing (depends on Auth)
 ```
@@ -213,6 +231,117 @@ Auth (Core)
 - `AuthorProfile`: Writing style profiles
 - `Strategy`: Content strategies

+#### Linker Module
+
+**Purpose**: Internal linking operations for content
+
+**Features**:
+- AI-powered internal linking suggestions
+- Content-to-content link analysis
+- Cluster-based link recommendations
+- Batch linking operations
+- Link validation and management
+
+**ViewSets**:
+- `LinkerViewSet`: Process content for internal linking
+
+#### Optimizer Module
+
+**Purpose**: Content optimization and scoring
+
+**Features**:
+- Content analysis and scoring
+- SEO optimization suggestions
+- Readability improvements
+- Content quality metrics
+- Batch optimization operations
+
+**ViewSets**:
+- `OptimizerViewSet`: Optimize and analyze content
+
+#### Publisher Module
+
+**Purpose**: Publishing records and site deployment
+
+**Features**:
+- Publishing record tracking
+- Deployment record management
+- Site definition management
+- Publishing status tracking
+- Multi-destination publishing support
+
+**Models**:
+- `PublishingRecord`: Records of content publishing
+- `DeploymentRecord`: Site deployment records
+
+**ViewSets**:
+- `PublishingRecordViewSet`: Manage publishing records
+- `DeploymentRecordViewSet`: Manage deployment records
+- `PublisherViewSet`: Publishing operations
+
+#### Site Builder Module
+
+**Purpose**: Site blueprint and structure management
+
+**Features**:
+- Site blueprint creation and management
+- Page blueprint management
+- Cluster attachment to blueprints
+- Taxonomy management
+- Site structure generation
+- Page content generation
+- Site asset management
+
+**Models**:
+- `SiteBlueprint`: Site structure blueprints
+- `PageBlueprint`: Individual page blueprints
+- `SiteBlueprintCluster`: Cluster-to-blueprint links
+- `SiteBlueprintTaxonomy`: Taxonomy definitions
+
+**ViewSets**:
+- `SiteBlueprintViewSet`: Manage site blueprints
+- `PageBlueprintViewSet`: Manage page blueprints
+- `SiteAssetView`: File management for site assets
+- `SiteBuilderMetadataView`: Metadata for site builder
+
+**Note**: Site Builder Wizard UI has been removed. Blueprints can be managed via API.
+
+#### Automation Module
+
+**Purpose**: Automation rules and scheduled tasks
+
+**Features**:
+- Automation rule creation and management
+- Scheduled task management
+- Rule execution tracking
+- Trigger-based automation
+- Conditional automation workflows
+
+**Models**:
+- `AutomationRule`: Automation rule definitions
+- `ScheduledTask`: Scheduled task records
+
+**ViewSets**:
+- `AutomationRuleViewSet`: Manage automation rules
+- `ScheduledTaskViewSet`: Manage scheduled tasks
+
+#### Integration Module
+
+**Purpose**: External platform integrations and synchronization
+
+**Features**:
+- Site integration management (WordPress, etc.)
+- Integration connection testing
+- Content synchronization
+- Sync health monitoring
+- Multi-platform publishing support
+
+**Models**:
+- `SiteIntegration`: Site-to-platform integration records
+
+**ViewSets**:
+- `IntegrationViewSet`: Manage site integrations
+
 #### Billing Module

 **Purpose**: Credit management and usage tracking
@@ -634,6 +763,12 @@ Results (Account-Isolated)
 - `/api/v1/auth/` - Accounts, users, sites, sectors, plans
 - `/api/v1/planner/` - Keywords, clusters, ideas
 - `/api/v1/writer/` - Tasks, content, images
+- `/api/v1/linker/` - Internal linking operations
+- `/api/v1/optimizer/` - Content optimization operations
+- `/api/v1/publisher/` - Publishing records, deployment records
+- `/api/v1/site-builder/` - Site blueprints, page blueprints, assets
+- `/api/v1/automation/` - Automation rules, scheduled tasks
+- `/api/v1/integration/` - Site integrations, sync operations
 - `/api/v1/system/` - Prompts, integrations, author-profiles, strategies
 - `/api/v1/billing/` - Credits, transactions, usage

@@ -783,13 +918,18 @@ The IGNY8 application architecture provides:
 1. **Multi-Tenancy**: Complete account isolation with automatic filtering
 2. **Hierarchical Organization**: Account > Site > Sector > Content structure
 3. **Role-Based Access**: Granular permissions for different user roles
-4. **Module-Based Design**: Clear separation of concerns across modules
+4. **Module-Based Design**: Clear separation of concerns across 10 backend modules
 5. **Complete Workflows**: End-to-end workflows from keyword import to publishing
 6. **AI Integration**: Unified AI framework for all AI operations
-7. **WordPress Integration**: Direct publishing to WordPress sites
-8. **Credit System**: Credit-based billing and usage tracking
-9. **Security First**: JWT auth, RBAC, data isolation
-10. **Scalable Design**: Supports multiple accounts, sites, and users
+7. **Content Optimization**: Internal linking and content optimization tools
+8. **Publishing System**: Multi-destination publishing with deployment tracking
+9. **Site Builder**: Site blueprint and structure management (API-based)
+10. **Automation**: Rule-based automation and scheduled tasks
+11. **Integration**: External platform integrations and synchronization
+12. **WordPress Integration**: Direct publishing to WordPress sites
+13. **Credit System**: Credit-based billing and usage tracking
+14. **Security First**: JWT auth, RBAC, data isolation
+15. **Scalable Design**: Supports multiple accounts, sites, and users

 This architecture ensures scalability, maintainability, and extensibility while providing a robust foundation for the IGNY8 platform.