Files
igny8/active-workflow-docs/SITE_BUILDER_WIZARD_REMOVAL_REFERENCE.md
2025-11-21 04:59:28 +05:00

5.5 KiB

Site Builder Wizard Removal - Reference Document

Date: 2025-11-20
Status: Complete


What Was Deleted

Frontend Files

  • /frontend/src/pages/Sites/Builder/Wizard.tsx
  • /frontend/src/pages/Sites/Builder/Preview.tsx
  • /frontend/src/pages/Sites/Builder/Blueprints.tsx
  • /frontend/src/pages/Sites/Builder/steps/BusinessDetailsStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/BriefStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/ObjectivesStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/StyleStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/ClusterAssignmentStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/TaxonomyBuilderStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/SitemapReviewStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/CoverageValidationStep.tsx
  • /frontend/src/pages/Sites/Builder/steps/IdeasHandoffStep.tsx
  • /frontend/src/pages/Sites/Builder/components/WizardProgress.tsx
  • /frontend/src/pages/Sites/Builder/components/HelperDrawer.tsx
  • /frontend/src/store/builderStore.ts

Backend Files

  • /backend/igny8_core/business/site_building/services/workflow_state_service.py
  • /backend/igny8_core/business/site_building/services/wizard_context_service.py
  • /backend/igny8_core/business/site_building/services/validators.py

Backend Model

  • WorkflowState model removed from models.py

Routes Removed

  • /sites/builder (Wizard route)
  • /sites/builder/preview (Preview route)
  • /sites/blueprints (Blueprints route)

Database

  • Table: igny8_site_blueprint_workflow_states (dropped)

What's Missing from Workflow Now

PHASE 2: SITE BUILDER WIZARD - Completely removed

The 6-step wizard process is gone:

  1. Business Details Step
  2. Cluster Assignment Step
  3. Taxonomy Builder Step
  4. AI Sitemap Review Step
  5. Coverage Validation Step
  6. Ideas Hand-off Step

Impact: Users can no longer use the guided wizard to build sites. Site blueprints must be created/managed through other means.


What Changed in Workflow

Before (Workflow A)

PLANNING → WIZARD (6 steps) → WRITER → OPTIMIZE → PUBLISH

After (Workflow A)

PLANNING → WRITER → OPTIMIZE → PUBLISH

Direct Path: Keywords/Clusters → Ideas → Tasks → Content (no wizard intermediary)


Migration & Database Changes

Migrations Reset

  • Deleted: 101 migration files (all numbered migrations)
  • Created: Fresh 0001_initial.py for all 11 apps
  • Removed: WorkflowState from 0003_workflow_and_taxonomies.py before deletion

Database Actions

  1. Backup: backup_postgres_20251120_232816.sql (646KB)
  2. Dropped: Database recreated
  3. Migrations Applied: 34 new migrations
  4. Data Restored: All data preserved (except WorkflowState)
  5. WorkflowState Table: Dropped from database

Migration State

  • All apps now have single 0001_initial.py
  • No migration history (clean slate)
  • Database structure matches current models

What's Still Kept (Site Builder Tables & Columns)

Models Still Active

  1. SiteBlueprint (igny8_site_blueprints)
  2. PageBlueprint (igny8_page_blueprints)
  3. SiteBlueprintCluster (igny8_site_blueprint_clusters)
  4. SiteBlueprintTaxonomy (igny8_site_blueprint_taxonomies)
  5. BusinessType (igny8_site_builder_business_types)
  6. AudienceProfile (igny8_site_builder_audience_profiles)
  7. BrandPersonality (igny8_site_builder_brand_personalities)
  8. HeroImageryDirection (igny8_site_builder_hero_imagery)

Complete Table Structure

igny8_site_blueprints

  • id, name, description, config_json, structure_json
  • status, hosting_type, version, deployed_version
  • tenant_id, site_id, sector_id
  • created_at, updated_at

igny8_page_blueprints

  • id, slug, title, type, blocks_json, status, order
  • site_blueprint_id, tenant_id, site_id, sector_id
  • created_at, updated_at

igny8_site_blueprint_clusters

  • id, role, coverage_status, metadata
  • site_blueprint_id, cluster_id, tenant_id, site_id, sector_id
  • created_at, updated_at

igny8_site_blueprint_taxonomies

  • id, name, slug, taxonomy_type, description, metadata, external_reference
  • site_blueprint_id, tenant_id, site_id, sector_id
  • created_at, updated_at

igny8_site_blueprint_taxonomies_clusters (M2M)

  • id, siteblueprinttaxonomy_id, clusters_id

Metadata Tables (Still Active)

  • igny8_site_builder_business_types
  • igny8_site_builder_audience_profiles
  • igny8_site_builder_brand_personalities
  • igny8_site_builder_hero_imagery

API Endpoints Still Available

  • GET/POST /api/v1/site-builder/blueprints/
  • GET/POST /api/v1/site-builder/pages/
  • POST /api/v1/site-builder/blueprints/{id}/generate_structure/
  • POST /api/v1/site-builder/blueprints/{id}/generate_all_pages/
  • POST /api/v1/site-builder/blueprints/{id}/clusters/attach
  • POST /api/v1/site-builder/blueprints/{id}/taxonomies/
  • GET /api/v1/site-builder/metadata/

Services Still Active

  • StructureGenerationService - AI structure generation
  • PageGenerationService - Page content generation
  • TaxonomyService - Taxonomy management
  • SiteBuilderFileService - File management

Summary

Removed: Wizard UI, WorkflowState model/service, 6-step guided process
Kept: All Site Builder models, tables, API endpoints, services
Changed: Workflow now bypasses wizard, goes directly Planning → Writer
Database: Clean migration state, WorkflowState table removed, all other data preserved