Files
igny8/refactor-plan/COMPLETE_USER_WORKFLOW_GUIDE.md
2025-11-20 08:58:38 +05:00

51 KiB

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
  2. System Overview & Navigation
  3. Visual Workflow Overview
  4. Workflow A: New IGNY8-Hosted Site (Complete Build)
  5. Workflow B: Existing Site Management
  6. Workflow C: WordPress Sync - New Site
  7. Workflow D: WordPress Sync - Existing Site
  8. Workflow E: Quick Content Creation
  9. Workflow F: Import & Sync Existing WordPress Site
  10. Module Deep Dives
  11. Advanced Features & Tips
  12. Decision Trees & Branching Points
  13. Module-Specific Workflows
  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.