# 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