1153 lines
51 KiB
Markdown
1153 lines
51 KiB
Markdown
# IGNY8 Complete User Workflow Guide - From Signup to Publishing
|
|
|
|
**Version:** 2.0 (Visual + Detailed Text)
|
|
**Last Updated:** 2025-01-27
|
|
**Status:** Comprehensive Visual & Text End-to-End Guide
|
|
|
|
---
|
|
|
|
## Table of Contents
|
|
|
|
1. [Getting Started - Signup & Onboarding](#1-getting-started---signup--onboarding)
|
|
2. [System Overview & Navigation](#2-system-overview--navigation)
|
|
3. [Visual Workflow Overview](#3-visual-workflow-overview)
|
|
4. [Workflow A: New IGNY8-Hosted Site (Complete Build)](#4-workflow-a-new-igny8-hosted-site-complete-build)
|
|
5. [Workflow B: Existing Site Management](#5-workflow-b-existing-site-management)
|
|
6. [Workflow C: WordPress Sync - New Site](#6-workflow-c-wordpress-sync---new-site)
|
|
7. [Workflow D: WordPress Sync - Existing Site](#7-workflow-d-wordpress-sync---existing-site)
|
|
8. [Workflow E: Quick Content Creation](#8-workflow-e-quick-content-creation)
|
|
9. [Workflow F: Import & Sync Existing WordPress Site](#9-workflow-f-import--sync-existing-wordpress-site)
|
|
10. [Module Deep Dives](#10-module-deep-dives)
|
|
11. [Advanced Features & Tips](#11-advanced-features--tips)
|
|
12. [Decision Trees & Branching Points](#12-decision-trees--branching-points)
|
|
13. [Module-Specific Workflows](#13-module-specific-workflows)
|
|
14. [Quick Reference Visual Maps](#14-quick-reference-visual-maps)
|
|
|
|
---
|
|
|
|
## 1. Visual Workflow Overview
|
|
|
|
### Master Workflow Map
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
│ IGNY8 USER JOURNEY MAP │
|
|
└─────────────────────────────────────────────────────────────────────────┘
|
|
|
|
┌──────────────┐
|
|
│ SIGNUP │
|
|
│ /signup │
|
|
└──────┬───────┘
|
|
│
|
|
▼
|
|
┌──────────────┐
|
|
│ LOGIN │
|
|
│ /signin │
|
|
└──────┬───────┘
|
|
│
|
|
▼
|
|
┌──────────────┐
|
|
│ DASHBOARD │
|
|
│ / │
|
|
└──────┬───────┘
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
┌─────────┐ ┌──────────┐ ┌──────────┐
|
|
│ NEW SITE│ │EXISTING │ │WORDPRESS │
|
|
│ BUILD │ │ SITE │ │ SYNC │
|
|
└────┬────┘ └────┬─────┘ └────┬─────┘
|
|
│ │ │
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
[Workflow A] [Workflow B] [Workflow C/D]
|
|
│ │ │
|
|
│ │ │
|
|
└─────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
┌──────────────┐
|
|
│ PUBLISH │
|
|
│ & DEPLOY │
|
|
└──────────────┘
|
|
```
|
|
|
|
### Entry Points Decision Tree
|
|
|
|
```
|
|
START: What do you want to do?
|
|
│
|
|
┌─────────────────────┼─────────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
CREATE NEW MANAGE EXISTING SYNC WORDPRESS
|
|
SITE SITE SITE
|
|
│ │ │
|
|
│ │ │
|
|
┌────┴────┐ ┌──────┴──────┐ ┌──────┴──────┐
|
|
│ │ │ │ │ │
|
|
▼ ▼ ▼ ▼ ▼ ▼
|
|
IGNY8 WORDPRESS ADD CONTENT UPDATE NEW SITE EXISTING
|
|
HOSTED HOSTED TO SITE CONTENT SYNC SYNC
|
|
│ │ │ │ │
|
|
│ │ │ │ │
|
|
└─────────────┴─────────────┴──────┴─────────────┘
|
|
│
|
|
▼
|
|
PUBLISH/DEPLOY
|
|
```
|
|
|
|
---
|
|
|
|
## 2. Workflow A: New IGNY8-Hosted Site (Complete Visual Flow)
|
|
|
|
### Complete Flow Diagram
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ WORKFLOW A: NEW IGNY8-HOSTED SITE (COMPLETE BUILD) │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 1: PLANNING & KEYWORD RESEARCH │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /planner/keyword-opportunities
|
|
│ └─► Browse keyword database
|
|
│ └─► Identify target keywords
|
|
│
|
|
├─► /planner/keywords
|
|
│ ├─► [CSV Import] ──┐
|
|
│ │ │
|
|
│ └─► [Manual Entry] ─┘
|
|
│ └─► Keywords stored
|
|
│
|
|
├─► /planner/keywords
|
|
│ └─► Select keywords → "Auto-Cluster"
|
|
│ └─► AI clustering (1 credit/30 keywords)
|
|
│ └─► Clusters created
|
|
│
|
|
└─► /planner/clusters
|
|
└─► Review & refine clusters
|
|
└─► Clusters ready
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 2: SITE BUILDER WIZARD │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /sites/builder/workflow/:id
|
|
│ └─► New SiteBlueprint created
|
|
│
|
|
├─► STEP 1: Business Details
|
|
│ ├─► Site Name, Description
|
|
│ ├─► Site Type: [blog | ecommerce | company]
|
|
│ ├─► Hosting: igny8_sites
|
|
│ └─► Save → business_details: ready
|
|
│
|
|
├─► STEP 2: Cluster Assignment
|
|
│ ├─► View available clusters
|
|
│ ├─► Filter & select clusters
|
|
│ ├─► Assign roles: [hub | supporting | attribute]
|
|
│ └─► Attach → clusters_ready
|
|
│ │
|
|
│ ┌─► [Validation: ≥1 cluster required]
|
|
│ └─► [Blocked if no clusters]
|
|
│
|
|
├─► STEP 3: Taxonomy Builder
|
|
│ ├─► Create taxonomies manually
|
|
│ ├─► Import from WordPress (if exists)
|
|
│ ├─► Link to clusters
|
|
│ └─► Save → taxonomies_ready
|
|
│ │
|
|
│ ┌─► [Validation: Required taxonomies per site type]
|
|
│ └─► [Blocked if incomplete]
|
|
│
|
|
├─► STEP 4: AI Sitemap Review
|
|
│ ├─► AI generates page structure
|
|
│ ├─► Review pages in grid
|
|
│ ├─► Edit titles, slugs, types
|
|
│ ├─► Reorder/remove pages
|
|
│ └─► Approve → sitemap_ready
|
|
│ │
|
|
│ ┌─► [Can regenerate if needed - costs credits]
|
|
│ └─► [Blocked if clusters/taxonomies not ready]
|
|
│
|
|
├─► STEP 5: Coverage Validation
|
|
│ ├─► Check cluster coverage
|
|
│ ├─► Verify hub/supporting pages
|
|
│ ├─► Review attribute pages
|
|
│ └─► Approve → ideas_ready
|
|
│ │
|
|
│ ┌─► [Can return to Step 4 to fix gaps]
|
|
│ └─► [Blocked if coverage incomplete]
|
|
│
|
|
└─► STEP 6: Ideas Hand-off
|
|
├─► Select pages to convert
|
|
├─► Add secondary prompt (optional)
|
|
└─► Create Ideas → ideas_in_progress
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 3: CONTENT CREATION (WRITER) │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /planner/ideas
|
|
│ └─► Review ideas with metadata
|
|
│
|
|
├─► Select ideas → "Queue to Writer"
|
|
│ └─► Ideas → Tasks (with metadata)
|
|
│
|
|
├─► /writer/tasks
|
|
│ └─► Select tasks → "Generate Content"
|
|
│ └─► AI content generation (3 credits/content)
|
|
│ ├─► HTML content
|
|
│ ├─► Structured blocks
|
|
│ ├─► Meta tags
|
|
│ └─► Content created
|
|
│
|
|
├─► /writer/content
|
|
│ └─► Review & edit content
|
|
│ ├─► HTML editor
|
|
│ ├─► Metadata sidebar
|
|
│ └─► Validation panel
|
|
│
|
|
└─► /writer/images
|
|
└─► Generate images (1 credit/image)
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 4: OPTIMIZATION & LINKING │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /linker/content
|
|
│ ├─► System analyzes content
|
|
│ ├─► Suggests internal links
|
|
│ │ ├─► High Priority: Cluster matches
|
|
│ │ └─► Other: General relevance
|
|
│ └─► Accept/reject suggestions
|
|
│
|
|
└─► /optimizer/content
|
|
├─► System scores content
|
|
├─► Review optimization suggestions
|
|
└─► Apply improvements
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 5: VALIDATION & PUBLISHING │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /sites/:id/posts/:postId
|
|
│ └─► Content validation
|
|
│ ├─► Entity type ✓
|
|
│ ├─► Cluster mapping ✓
|
|
│ ├─► Taxonomy assignment ✓
|
|
│ ├─► Attributes complete ✓
|
|
│ └─► Publish button enabled
|
|
│
|
|
├─► /sites/:id
|
|
│ └─► Site progress check
|
|
│ └─► Review cluster coverage
|
|
│
|
|
├─► /sites/:id/deploy
|
|
│ └─► Deployment readiness
|
|
│ ├─► Cluster coverage ✓
|
|
│ ├─► Content validation ✓
|
|
│ ├─► Taxonomy completeness ✓
|
|
│ └─► Ready to deploy
|
|
│
|
|
└─► Click "Deploy"
|
|
└─► SitesRendererAdapter builds site
|
|
└─► Site live at sites.igny8.com/{slug}
|
|
│
|
|
▼
|
|
END ✓
|
|
```
|
|
|
|
### Phase Flow Summary
|
|
|
|
```
|
|
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
│ PLANNING │ --> │ WIZARD │ --> │ WRITER │ --> │OPTIMIZE │ --> │ PUBLISH │
|
|
│ │ │ │ │ │ │ │ │ │
|
|
│Keywords │ │6 Steps │ │Content │ │Link & │ │Deploy │
|
|
│Clusters │ │Validation │ │Generate │ │Optimize │ │Site │
|
|
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Workflow B: Existing Site Management (Visual Flow)
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ WORKFLOW B: EXISTING SITE MANAGEMENT │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START: Existing Site
|
|
│
|
|
├─► /sites/:id
|
|
│ └─► Site Dashboard
|
|
│
|
|
├─► ADD NEW CONTENT PATH
|
|
│ │
|
|
│ ├─► /planner/ideas
|
|
│ │ └─► Create new ideas
|
|
│ │ │
|
|
│ ├─► Queue to Writer
|
|
│ │ └─► Generate content
|
|
│ │ │
|
|
│ └─► Content added to site
|
|
│
|
|
├─► MANAGE EXISTING CONTENT PATH
|
|
│ │
|
|
│ ├─► /sites/:id/content
|
|
│ │ └─► View all site content
|
|
│ │
|
|
│ ├─► /sites/:id/posts/:postId/edit
|
|
│ │ ├─► Edit HTML content
|
|
│ │ ├─► Update metadata
|
|
│ │ ├─► Change taxonomy
|
|
│ │ └─► Re-validate
|
|
│ │
|
|
│ └─► Content updated
|
|
│
|
|
├─► SITE SETTINGS PATH
|
|
│ │
|
|
│ ├─► /sites/:id/settings?tab=general
|
|
│ │ └─► Update site info
|
|
│ │
|
|
│ ├─► /sites/:id/settings?tab=seo
|
|
│ │ └─► Update SEO settings
|
|
│ │
|
|
│ └─► /sites/:id/settings?tab=integrations
|
|
│ └─► Manage integrations
|
|
│
|
|
└─► REDEPLOY PATH
|
|
│
|
|
├─► /sites/:id/deploy
|
|
│ ├─► Check readiness
|
|
│ └─► Fix any issues
|
|
│
|
|
└─► Click "Deploy"
|
|
└─► Site updated
|
|
│
|
|
▼
|
|
END ✓
|
|
```
|
|
|
|
### Decision Points
|
|
|
|
```
|
|
Existing Site
|
|
│
|
|
┌────────────────┼────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
ADD CONTENT EDIT CONTENT CONFIGURE
|
|
│ │ │
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
Generate New Update Existing Change Settings
|
|
│ │ │
|
|
└────────────────┼────────────────┘
|
|
│
|
|
▼
|
|
REDEPLOY?
|
|
│
|
|
┌────┴────┐
|
|
│ │
|
|
▼ ▼
|
|
YES NO
|
|
│ │
|
|
▼ ▼
|
|
Deploy Keep Local
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Workflow C: WordPress Sync - New Site (Visual Flow)
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ WORKFLOW C: WORDPRESS SYNC - NEW SITE │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START: New Site with WordPress
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 1: WORDPRESS INTEGRATION SETUP │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /sites/builder/workflow/:id
|
|
│ └─► Step 1: Business Details
|
|
│ ├─► Site Type: [blog | ecommerce | company]
|
|
│ └─► Hosting: wordpress
|
|
│
|
|
└─► /sites/:id/settings?tab=integrations
|
|
├─► Click "Connect WordPress"
|
|
├─► Enter credentials:
|
|
│ ├─► WordPress Site URL
|
|
│ ├─► Application Password
|
|
│ └─► Username
|
|
├─► Test connection
|
|
└─► Save → SiteIntegration created
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 2: INITIAL SYNC FROM WORDPRESS │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /sites/:id/sync
|
|
│ └─► Click "Sync from WordPress"
|
|
│
|
|
├─► SYNC TAXONOMIES
|
|
│ ├─► Fetch WP categories
|
|
│ ├─► Fetch WP tags
|
|
│ ├─► Fetch WooCommerce categories (if ecommerce)
|
|
│ └─► Map to SiteBlueprintTaxonomy
|
|
│ └─► Store external_reference
|
|
│
|
|
├─► SYNC PRODUCTS (if ecommerce)
|
|
│ ├─► Fetch WooCommerce products
|
|
│ └─► Map to IGNY8 content structure
|
|
│
|
|
└─► SYNC POSTS/CONTENT
|
|
├─► Fetch WordPress posts
|
|
└─► Map to IGNY8 Content model
|
|
└─► Store external_reference
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 3: SITE BUILDER WITH IMPORTED DATA │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /sites/builder/workflow/:id
|
|
│ │
|
|
│ ├─► Step 2: Cluster Assignment
|
|
│ │ ├─► Use imported clusters (from WP taxonomies)
|
|
│ │ └─► OR attach Planner clusters
|
|
│ │
|
|
│ ├─► Step 3: Taxonomy Builder
|
|
│ │ ├─► Review imported taxonomies
|
|
│ │ ├─► Add missing taxonomies
|
|
│ │ └─► Link to clusters
|
|
│ │
|
|
│ └─► Steps 4-6: Continue as Workflow A
|
|
│
|
|
└─► Site structure ready
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 4: CONTENT CREATION & SYNC │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► CREATE NEW CONTENT IN IGNY8
|
|
│ └─► Follow Workflow A Phase 3
|
|
│ └─► Content with metadata
|
|
│
|
|
└─► SYNC TO WORDPRESS
|
|
│
|
|
├─► /sites/:id/sync
|
|
│ └─► Click "Sync to WordPress"
|
|
│
|
|
├─► Ensure taxonomies exist in WP
|
|
│ └─► Create if missing
|
|
│
|
|
├─► Publish content to WordPress
|
|
│ └─► Update external_reference
|
|
│
|
|
└─► Content live on WordPress
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PHASE 5: ONGOING SYNC MANAGEMENT │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
├─► /sites/:id/sync
|
|
│ ├─► Monitor sync health
|
|
│ ├─► View sync logs
|
|
│ └─► Resolve mismatches
|
|
│
|
|
└─► TWO-WAY SYNC
|
|
├─► WP → IGNY8: New posts/products sync to IGNY8
|
|
└─► IGNY8 → WP: New content syncs to WordPress
|
|
│
|
|
▼
|
|
END ✓
|
|
```
|
|
|
|
### Sync Flow Diagram
|
|
|
|
```
|
|
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
|
│ WORDPRESS │ SYNC │ IGNY8 │ SYNC │ WORDPRESS │
|
|
│ │ ──────► │ │ ──────► │ │
|
|
│ Taxonomies │ │ Taxonomies │ │ Taxonomies │
|
|
│ Products │ │ Content │ │ Products │
|
|
│ Posts │ │ Metadata │ │ Posts │
|
|
└──────────────┘ └──────────────┘ └──────────────┘
|
|
▲ │
|
|
│ │
|
|
└──────────────────────────────────────────────┘
|
|
BIDIRECTIONAL SYNC
|
|
```
|
|
|
|
---
|
|
|
|
## 5. Workflow D: WordPress Sync - Existing Site (Visual Flow)
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ WORKFLOW D: WORDPRESS SYNC - EXISTING SITE │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START: Existing IGNY8 Site
|
|
│
|
|
├─► /sites/:id/settings?tab=integrations
|
|
│ └─► Add WordPress Integration
|
|
│ ├─► Enter WP credentials
|
|
│ ├─► Test connection
|
|
│ └─► Save
|
|
│
|
|
├─► /sites/:id/sync
|
|
│ └─► Click "Sync from WordPress"
|
|
│ │
|
|
│ ├─► IMPORT TAXONOMIES
|
|
│ │ ├─► Fetch WP taxonomies
|
|
│ │ ├─► Map to existing IGNY8 taxonomies (by name/slug)
|
|
│ │ └─► Update external_reference
|
|
│ │
|
|
│ ├─► IMPORT CONTENT
|
|
│ │ └─► Fetch missing posts/products
|
|
│ │
|
|
│ └─► Initial sync complete
|
|
│
|
|
├─► MANAGE SYNC MISMATCHES
|
|
│ │
|
|
│ ├─► /sites/:id/sync
|
|
│ │ └─► View mismatches:
|
|
│ │ ├─► Taxonomies missing in WP
|
|
│ │ ├─► Taxonomies missing in IGNY8
|
|
│ │ └─► Products/posts mismatches
|
|
│ │
|
|
│ └─► Resolve mismatches
|
|
│ ├─► Click "Retry Sync"
|
|
│ ├─► Manual mapping if needed
|
|
│ └─► Mismatches resolved
|
|
│
|
|
└─► PUBLISH UPDATES
|
|
│
|
|
├─► Update content in IGNY8
|
|
│ └─► /sites/:id/posts/:postId/edit
|
|
│
|
|
└─► Sync to WordPress
|
|
└─► /sites/:id/sync → "Sync to WordPress"
|
|
└─► Updates pushed to WP
|
|
│
|
|
▼
|
|
END ✓
|
|
```
|
|
|
|
### Mismatch Resolution Flow
|
|
|
|
```
|
|
Sync Mismatch Detected
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
TAXONOMIES PRODUCTS POSTS
|
|
MISMATCH MISMATCH MISMATCH
|
|
│ │ │
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
Review Details
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
AUTO RESOLVE MANUAL MAPPING RETRY SYNC
|
|
│ │ │
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
Mismatch Resolved ✓
|
|
```
|
|
|
|
---
|
|
|
|
## 6. Workflow E: Quick Content Creation (Visual Flow)
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ WORKFLOW E: QUICK CONTENT CREATION │
|
|
│ (Without Full Site Build) │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START: Quick Content
|
|
│
|
|
├─► OPTION 1: From Keywords
|
|
│ │
|
|
│ ├─► /planner/keywords
|
|
│ │ └─► Import/select keywords
|
|
│ │
|
|
│ ├─► Auto-cluster (optional)
|
|
│ │
|
|
│ └─► /planner/ideas
|
|
│ └─► Generate ideas from keywords
|
|
│
|
|
├─► OPTION 2: Direct Idea Creation
|
|
│ │
|
|
│ └─► /planner/ideas
|
|
│ └─► Create idea manually
|
|
│
|
|
├─► Queue to Writer
|
|
│ └─► /writer/tasks
|
|
│
|
|
├─► Generate Content
|
|
│ └─► /writer/content
|
|
│ └─► Content created
|
|
│
|
|
├─► OPTIONAL: Link & Optimize
|
|
│ │
|
|
│ ├─► /linker/content
|
|
│ │ └─► Add internal links
|
|
│ │
|
|
│ └─► /optimizer/content
|
|
│ └─► Optimize content
|
|
│
|
|
└─► Publish
|
|
└─► Content ready
|
|
│
|
|
▼
|
|
END ✓
|
|
```
|
|
|
|
### Quick Path Diagram
|
|
|
|
```
|
|
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
│KEYWORDS │ --> │ IDEAS │ --> │ TASKS │ --> │ CONTENT │
|
|
│ │ │ │ │ │ │ │
|
|
│ OR │ │ OR │ │ │ │ │
|
|
│ │ │ │ │ │ │ │
|
|
│ DIRECT │ --> │ DIRECT │ --> │ GENERATE │ --> │ READY │
|
|
│ IDEA │ │ IDEA │ │ │ │ │
|
|
└──────────┘ └──────────┘ └──────────┘ └──────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 7. Workflow F: Import & Sync Existing WordPress Site (Visual Flow)
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ WORKFLOW F: IMPORT & SYNC EXISTING WORDPRESS SITE │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START: Existing WordPress Site
|
|
│
|
|
├─► /sites
|
|
│ └─► Create new site OR select existing
|
|
│
|
|
├─► /sites/:id/settings?tab=integrations
|
|
│ └─► Connect WordPress
|
|
│ └─► Enter WP credentials
|
|
│
|
|
├─► /sites/:id/sync
|
|
│ └─► INITIAL IMPORT
|
|
│ │
|
|
│ ├─► Sync Taxonomies
|
|
│ │ ├─► Categories → SiteBlueprintTaxonomy
|
|
│ │ ├─► Tags → SiteBlueprintTaxonomy
|
|
│ │ └─► Product Categories (WooCommerce)
|
|
│ │
|
|
│ ├─► Sync Products (if WooCommerce)
|
|
│ │ └─► Products → Content (entity_type: product)
|
|
│ │
|
|
│ └─► Sync Posts/Pages
|
|
│ └─► Posts → Content (entity_type: blog_post)
|
|
│
|
|
├─► AUTO-CREATE STRUCTURE
|
|
│ │
|
|
│ ├─► Clusters created from taxonomies
|
|
│ │ └─► imported=True flag
|
|
│ │
|
|
│ └─► Site structure mapped
|
|
│
|
|
├─► /sites/builder/workflow/:id (Optional)
|
|
│ └─► Refine imported structure
|
|
│ ├─► Review clusters
|
|
│ ├─► Review taxonomies
|
|
│ └─► Add missing elements
|
|
│
|
|
└─► ONGOING SYNC
|
|
│
|
|
├─► Two-way sync enabled
|
|
│
|
|
└─► Changes sync automatically
|
|
│
|
|
▼
|
|
END ✓
|
|
```
|
|
|
|
### Import Flow
|
|
|
|
```
|
|
┌──────────────┐
|
|
│ WORDPRESS │
|
|
│ SITE │
|
|
└──────┬───────┘
|
|
│
|
|
│ Connect Integration
|
|
▼
|
|
┌──────────────┐
|
|
│ SYNC FROM │
|
|
│ WORDPRESS │
|
|
└──────┬───────┘
|
|
│
|
|
├─► Taxonomies
|
|
├─► Products
|
|
└─► Posts
|
|
│
|
|
▼
|
|
┌──────────────┐
|
|
│ IGNY8 │
|
|
│ STRUCTURE │
|
|
└──────┬───────┘
|
|
│
|
|
├─► Auto-create clusters
|
|
├─► Map taxonomies
|
|
└─► Import content
|
|
│
|
|
▼
|
|
┌──────────────┐
|
|
│ READY FOR │
|
|
│ MANAGEMENT │
|
|
└──────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 8. Decision Trees & Branching Points
|
|
|
|
### Site Creation Decision Tree
|
|
|
|
```
|
|
Create New Site?
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
IGNY8 HOSTED WORDPRESS HOSTED IMPORT FROM WP
|
|
│ │ │
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
Workflow A Workflow C Workflow F
|
|
│ │ │
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
Site Created
|
|
```
|
|
|
|
### Content Creation Decision Tree
|
|
|
|
```
|
|
Need to Create Content?
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
NEW SITE BUILD EXISTING SITE QUICK CONTENT
|
|
│ │ │
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
Full Workflow A Workflow B Workflow E
|
|
│ │ │
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
Content Created
|
|
```
|
|
|
|
### Publishing Decision Tree
|
|
|
|
```
|
|
Ready to Publish?
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
IGNY8 DEPLOY WORDPRESS SYNC BOTH
|
|
│ │ │
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
Deploy to IGNY8 Sync to WordPress Deploy + Sync
|
|
│ │ │
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
Content Published
|
|
```
|
|
|
|
### Validation Decision Tree
|
|
|
|
```
|
|
Content Validation
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
ALL CHECKS PASS SOME FAILED ALL FAILED
|
|
│ │ │
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
PUBLISH ENABLED FIX ISSUES CANNOT PUBLISH
|
|
│ │ │
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
Validation Complete
|
|
```
|
|
|
|
---
|
|
|
|
## 9. Module-Specific Workflows
|
|
|
|
### Planner Module Flow
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ PLANNER MODULE WORKFLOW │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START
|
|
│
|
|
├─► /planner/keyword-opportunities
|
|
│ └─► Discover keywords
|
|
│
|
|
├─► /planner/keywords
|
|
│ ├─► Import CSV
|
|
│ ├─► Manual entry
|
|
│ └─► Keywords stored
|
|
│
|
|
├─► Auto-cluster
|
|
│ └─► /planner/clusters
|
|
│ ├─► Review clusters
|
|
│ ├─► Merge/split
|
|
│ └─► Clusters ready
|
|
│
|
|
├─► /planner/ideas
|
|
│ ├─► Generate from clusters
|
|
│ ├─► Create manually
|
|
│ └─► Ideas ready
|
|
│
|
|
└─► Queue to Writer
|
|
└─► /writer/tasks
|
|
│
|
|
▼
|
|
END
|
|
```
|
|
|
|
### Writer Module Flow
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ WRITER MODULE WORKFLOW │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START
|
|
│
|
|
├─► /writer/tasks
|
|
│ ├─► Tasks from ideas
|
|
│ └─► Select tasks
|
|
│
|
|
├─► Generate Content
|
|
│ └─► AI generation (3 credits)
|
|
│
|
|
├─► /writer/content
|
|
│ ├─► Review content
|
|
│ ├─► Edit HTML
|
|
│ └─► Update metadata
|
|
│
|
|
├─► /writer/images
|
|
│ └─► Generate images (1 credit)
|
|
│
|
|
└─► Content ready
|
|
│
|
|
▼
|
|
END
|
|
```
|
|
|
|
### Linker Module Flow
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ LINKER MODULE WORKFLOW │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START
|
|
│
|
|
├─► /linker/content
|
|
│ └─► System analyzes content
|
|
│
|
|
├─► Link Suggestions
|
|
│ ├─► High Priority (cluster matches)
|
|
│ └─► Other suggestions
|
|
│
|
|
├─► Review Suggestions
|
|
│ ├─► Accept
|
|
│ ├─► Reject
|
|
│ └─► Edit
|
|
│
|
|
└─► Links inserted
|
|
│
|
|
▼
|
|
END
|
|
```
|
|
|
|
### Optimizer Module Flow
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ OPTIMIZER MODULE WORKFLOW │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
START
|
|
│
|
|
├─► /optimizer/content
|
|
│ └─► System analyzes content
|
|
│
|
|
├─► Scoring
|
|
│ ├─► SEO score
|
|
│ ├─► Readability
|
|
│ ├─► Metadata completeness
|
|
│ └─► Overall score
|
|
│
|
|
├─► Optimization Suggestions
|
|
│ ├─► Review suggestions
|
|
│ └─► Apply improvements
|
|
│
|
|
└─► Content optimized
|
|
│
|
|
▼
|
|
END
|
|
```
|
|
|
|
---
|
|
|
|
## 10. Quick Reference Visual Maps
|
|
|
|
### Complete System Map
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ IGNY8 SYSTEM MAP │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
┌──────────────┐
|
|
│ AUTH │
|
|
│ Signup/Login │
|
|
└──────┬───────┘
|
|
│
|
|
▼
|
|
┌──────────────┐
|
|
│ DASHBOARD │
|
|
└──────┬───────┘
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
┌─────────┐ ┌──────────┐ ┌──────────┐
|
|
│PLANNER │ │ WRITER │ │ SITES │
|
|
│ │ │ │ │ │
|
|
│Keywords │ │ Tasks │ │ Builder │
|
|
│Clusters │ │ Content │ │ Deploy │
|
|
│ Ideas │ │ Images │ │ Sync │
|
|
└────┬────┘ └────┬─────┘ └────┬─────┘
|
|
│ │ │
|
|
│ │ │
|
|
└─────────────────┼──────────────────┘
|
|
│
|
|
┌─────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
┌─────────┐ ┌──────────┐ ┌──────────┐
|
|
│ LINKER │ │OPTIMIZER │ │ SETTINGS │
|
|
│ │ │ │ │ │
|
|
│Internal │ │ Scores │ │ Config │
|
|
│ Links │ │Optimize │ │ Billing │
|
|
└─────────┘ └──────────┘ └──────────┘
|
|
```
|
|
|
|
### Route Navigation Map
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ ROUTE NAVIGATION MAP │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
/ (Dashboard)
|
|
│
|
|
├─► /planner
|
|
│ ├─► /planner/keywords
|
|
│ ├─► /planner/clusters
|
|
│ ├─► /planner/ideas
|
|
│ └─► /planner/keyword-opportunities
|
|
│
|
|
├─► /writer
|
|
│ ├─► /writer/tasks
|
|
│ ├─► /writer/content
|
|
│ ├─► /writer/images
|
|
│ └─► /writer/published
|
|
│
|
|
├─► /sites
|
|
│ ├─► /sites/:id
|
|
│ ├─► /sites/builder/workflow/:id
|
|
│ ├─► /sites/:id/content
|
|
│ ├─► /sites/:id/posts/:postId
|
|
│ ├─► /sites/:id/sync
|
|
│ ├─► /sites/:id/deploy
|
|
│ └─► /sites/:id/settings
|
|
│
|
|
├─► /linker
|
|
│ └─► /linker/content
|
|
│
|
|
├─► /optimizer
|
|
│ └─► /optimizer/content
|
|
│
|
|
└─► /settings
|
|
└─► Various settings pages
|
|
```
|
|
|
|
### Credit Usage Flow
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ CREDIT USAGE FLOW │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
Check Credit Balance
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
SUFFICIENT LOW BALANCE INSUFFICIENT
|
|
│ │ │
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
Proceed with Show Warning Block Operation
|
|
Operation + Top Up CTA + Top Up CTA
|
|
│ │ │
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
Operation Executed
|
|
│
|
|
▼
|
|
Credits Deducted
|
|
```
|
|
|
|
### Validation Flow
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ VALIDATION FLOW │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
|
|
Content Ready?
|
|
│
|
|
▼
|
|
Run Validators
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
Entity Type? Cluster Map? Taxonomy?
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
✓ Assigned ✓ Mapped ✓ Assigned
|
|
│ │ │
|
|
└──────────────────┼──────────────────┘
|
|
│
|
|
▼
|
|
All Checks Pass?
|
|
│
|
|
┌──────────────────┼──────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
YES NO
|
|
│ │
|
|
│ ▼
|
|
│ Show Errors
|
|
│ │
|
|
│ ▼
|
|
│ Fix Issues
|
|
│ │
|
|
│ └──► Retry
|
|
│
|
|
▼
|
|
Publish Enabled ✓
|
|
```
|
|
|
|
---
|
|
|
|
## Workflow Comparison Matrix
|
|
|
|
| Workflow | Use Case | Starting Point | Key Steps | End Point |
|
|
|----------|----------|----------------|-----------|-----------|
|
|
| **A** | New IGNY8 site | Keywords | Planning → Wizard → Writer → Optimize → Deploy | Live IGNY8 site |
|
|
| **B** | Manage existing | Existing site | Add/Edit content → Redeploy | Updated site |
|
|
| **C** | New WP sync site | New site + WP | Connect WP → Sync → Build → Sync | Synced WP site |
|
|
| **D** | Existing WP sync | Existing site | Add WP → Sync → Manage | Synced site |
|
|
| **E** | Quick content | Keywords/Ideas | Ideas → Tasks → Content | Content ready |
|
|
| **F** | Import WP site | WP site | Connect → Import → Manage | Managed in IGNY8 |
|
|
|
|
---
|
|
|
|
## Quick Decision Guide
|
|
|
|
```
|
|
What do you want to do?
|
|
│
|
|
┌───────────────────┼───────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
CREATE NEW MANAGE EXISTING IMPORT FROM
|
|
SITE SITE WORDPRESS
|
|
│ │ │
|
|
│ │ │
|
|
┌────┴────┐ ┌─────┴─────┐ ┌─────┴─────┐
|
|
│ │ │ │ │ │
|
|
▼ ▼ ▼ ▼ ▼ ▼
|
|
IGNY8 WORDPRESS ADD CONTENT EDIT NEW SITE EXISTING
|
|
HOSTED HOSTED TO SITE CONTENT SYNC SYNC
|
|
│ │ │ │ │ │
|
|
│ │ │ │ │ │
|
|
└─────────┴─────────┴───────────┴──────┴───────────┘
|
|
│
|
|
▼
|
|
PUBLISH/DEPLOY
|
|
```
|
|
|
|
---
|
|
|
|
**End of Complete Visual Workflow Guide**
|
|
|
|
*This visual guide provides comprehensive flow diagrams for all workflows in IGNY8. Use the decision trees to determine which workflow applies to your use case.*
|