1

SITE_BUILDER_WIZARD_REMOVAL_REFERENCE.md

@@ -0,0 +1,171 @@
+# 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
+