igny8/docs/00-SYSTEM/IGNY8-APP.md

IGNY8 - AI-Powered SEO Content Platform

Version: 1.8.4
Last Updated: January 20, 2026
Status: Production Ready

---

What is IGNY8?

IGNY8 is an enterprise-grade AI content platform that transforms keyword research into published, SEO-optimized articles at scale. The platform automates the entire content lifecycle—from discovering keywords to publishing polished articles with AI-generated images—reducing what typically takes days of manual work into hours.

The Problem: Creating SEO content at scale requires keyword research, content planning, writing, image creation, optimization, and publishing—a process that's labor-intensive and inconsistent.

The Solution: IGNY8 provides an end-to-end automated pipeline where AI handles clustering, ideation, writing, and image generation while you maintain editorial control.

---

Platform Architecture

Aspect	Details
Type	Full-stack SaaS Platform
Architecture	Multi-tenant with complete data isolation
Target Users	Content marketers, SEO agencies, digital publishers
Deployment	Docker-based, cloud-hosted
Pricing Model	Credits + Monthly subscription plans

---

Core Workflow

IGNY8 follows a structured 8-stage content pipeline:

┌─────────────────────────────────────────────────────────────────────────────┐
│  SETUP                              WORKFLOW                                 │
│  ─────                              ────────                                 │
│  Sites → Keywords → Clusters → Ideas → Tasks → Content → Images → Published │
│    ↑                    ↑                          ↑                         │
│   Configure          AI Groups                 AI Writes                     │
│   WordPress          Related                   Full Articles                 │
│                      Keywords                  + SEO Meta                    │
└─────────────────────────────────────────────────────────────────────────────┘

Manual Mode

Walk through each stage with full control—review and edit at every step.

Automation Mode

Configure once, let IGNY8 process all 7 stages automatically on a schedule (daily, weekly, or monthly). Content lands in your review queue ready for approval.

---

Feature Deep-Dive

1. Keyword Management (Planner)

Import Options:

• Upload CSV with thousands of keywords
• Browse 50+ industries of pre-curated seed keywords
• Filter by country, difficulty, search volume

AI Clustering:

• GPT-4 analyzes keyword intent and relationships
• Groups related keywords into topical clusters
• Enables one comprehensive article per cluster (instead of keyword stuffing)

Metrics Tracked:

• Search volume (monthly)
• Keyword difficulty (0-100)
• CPC (cost-per-click)
• Intent classification (informational, commercial, transactional)

---

2. Content Ideation (Planner)

AI-Generated Ideas:

• Each cluster becomes a content brief
• Suggested titles, angles, and outlines
• Word count recommendations based on competition
• Priority scoring by SEO potential

Bulk Operations:

• Generate ideas for multiple clusters at once
• Queue ideas directly to Writer module
• Batch status updates

---

3. Content Generation (Writer)

AI Writing Engine:

• Powered by GPT-4/GPT-4 Turbo
• Produces structured articles (H2s, H3s, lists, paragraphs)
• SEO-optimized meta titles and descriptions
• Configurable length: 500 to 5,000+ words

Content Types:

• Blog posts and articles
• How-to guides
• Product comparisons
• Reviews and roundups

Customization:

• Custom prompt additions (append to all AI prompts)
• Default tone selection (professional, casual, authoritative, etc.)
• Default article length preferences

Workflow States:

• Queue → Draft → Review → Published
• Each stage has dedicated management views

---

4. Image Generation (Writer)

Dual AI Providers:

Provider	Quality Tier	Best For
DALL-E 2	Standard	Fast, economical
DALL-E 3	Premium	High quality, detailed
Runware	Best	Alternative variety

Image Types:

• Featured images (hero/thumbnail)
• In-article images (embedded in content)
• Desktop and mobile sizes (responsive)

Smart Features:

• AI extracts image prompts from article content
• Negative prompts for style control
• Multiple format support (WebP, JPG, PNG)
• Configurable max images per article

---

5. Automation Pipeline

7-Stage Automated Workflow:

Stage 1: Process new keywords
Stage 2: AI cluster keywords
Stage 3: Generate content ideas
Stage 4: Create writer tasks
Stage 5: Generate article content
Stage 6: Extract image prompts
Stage 7: Generate images → Review queue

Configuration:

• Schedule: Daily, weekly, or monthly runs
• Run controls: Start, pause, resume
• Credit estimation before running
• Real-time progress tracking
• Activity log and run history

---

6. WordPress Integration

Publishing:

• One-click publish from Review tab
• Direct WordPress REST API integration
• Supports multiple WordPress sites per account

Synchronization:

• Two-way content sync (import/export)
• Category and tag mapping
• Featured image upload
• Post type configuration (posts, pages, custom)

Setup:

• Site URL and REST API authentication
• Content type mapping in Site Settings
• Auto-publish toggle (skip review step)
• Auto-sync toggle (keep WordPress updated)

---

7. Team & Account Management

User Roles:

Role	Permissions
Admin	Full access, billing, team management
Manager	Content + billing view, no team management
Editor	AI content, clusters, tasks
Viewer	Read-only dashboards

Team Features:

• Invite team members by email
• Remove members
• Role display (editing roles coming soon)

Account Settings:

• Organization name and billing address
• Tax ID / VAT number
• Billing email

---

8. Usage & Billing

Credit System:

Operation	Typical Credits
Keyword clustering (batch)	10
Content idea generation	2
Article (per 100 words)	5
Image (standard)	3
Image (premium/best)	5

Usage Tracking:

• Real-time credit balance
• Monthly usage vs. limits
• Transaction history
• Hard limits (sites, users, keywords, clusters)
• Monthly limits (ideas, words, images)

Subscription Plans:

Plan	Sites	Users	Credits/Month	Best For
Free	1	1	100	Trial/Evaluation
Starter	3	3	1,000	Individual creators
Growth	10	10	5,000	Small teams
Scale	Unlimited	Unlimited	25,000	Agencies

---

Module Status

Module	Status	Location
Dashboard	✅ Active	/
Add Keywords	✅ Active	/setup/add-keywords
Content Settings	✅ Active	/account/content-settings
Sites	✅ Active	/sites
Thinker	✅ Active (Admin)	/thinker/prompts
Planner	✅ Active	/planner/keywords
Writer	✅ Active	/writer/tasks
Automation	✅ Active	/automation
Account Settings	✅ Active	/account/settings
Plans & Billing	✅ Active	/account/plans
Usage	✅ Active	/account/usage
AI Models	✅ Active (Admin)	/settings/integration
Help	✅ Active	/help
SiteBuilder	❌ Deprecated	Removed - was for site structure generation
Linker	⏸️ Phase 2	Internal linking suggestions (disabled by default)
Optimizer	⏸️ Phase 2	Content optimization (disabled by default)

Module Status Details

Module	Status	Notes
SiteBuilder	❌ Deprecated	Code exists but feature is removed. Marked for cleanup.
Linker	⏸️ Phase 2	Feature flag: linker_enabled. Available but disabled by default.
Optimizer	⏸️ Phase 2	Feature flag: optimizer_enabled. Available but disabled by default.

To enable Phase 2 modules, update via Django Admin:

• GlobalModuleSettings (pk=1) for platform-wide settings
• ModuleEnableSettings for per-account settings

---

Navigation Structure

Sidebar Menu
├── Dashboard
├── SETUP
│   ├── Add Keywords
│   ├── Content Settings
│   ├── Sites (if enabled)
│   └── Thinker (admin only, if enabled)
├── WORKFLOW
│   ├── Planner (Keywords → Clusters → Ideas)
│   ├── Writer (Queue → Drafts → Images → Review → Published)
│   ├── Automation
│   ├── Linker (if enabled)
│   └── Optimizer (if enabled)
├── ACCOUNT
│   ├── Account Settings (Account → Profile → Team)
│   ├── Plans & Billing (Plan → Upgrade → History)
│   ├── Usage (Limits → Credit History → API Activity)
│   └── AI Models (admin only)
└── HELP
    └── Help & Docs

---

Technical Stack

Layer	Technology
Backend	Django 5.x, Django REST Framework, Python 3.11+
Frontend	React 19, TypeScript, Vite, TailwindCSS
Database	PostgreSQL 15+
Cache/Sessions	Redis
Task Queue	Celery + Celery Beat
AI Services	OpenAI GPT-4, DALL-E 3, Runware
Deployment	Docker, Docker Compose

---

Security

• Data Isolation: Complete multi-tenant separation at database level
• Authentication: JWT tokens with Redis session management
• Encryption: Data encrypted at rest and in transit
• Access Control: Role-based permissions per account
• Session Security: Secure cookie handling, session integrity checks

---

Current Limitations & Known Issues

Payment Processing:

• Stripe/PayPal pending production credentials
• Manual payment methods available

Pending Backend Implementation:

• Content Generation settings (append prompt, tone, length) - UI exists, API pending
• Publishing settings (auto-publish, sync) - UI exists, API pending
• Profile settings save - UI exists, API pending
• Password change functionality
• API Activity tracking (currently placeholder data)

Disabled Modules:

• Linker (internal linking) - Available but disabled
• Optimizer (content optimization) - Available but disabled

---

Getting Started

For New Users

1. Create account and verify email
2. Create your first site (industry + sectors)
3. Connect WordPress (optional)
4. Add keywords from seed database or import CSV
5. Run AI clustering on keywords
6. Generate content ideas from clusters
7. Queue ideas to Writer
8. Generate content and images
9. Review and publish

For Admins

1. Configure AI Models (OpenAI API key, Runware key)
2. Customize prompts in Thinker module
3. Set up global module settings
4. Configure automation schedules

---

Documentation

Document	Location
Technical Docs	/docs/INDEX.md
API Reference	/docs/20-API/
Pre-Launch Audit	/PRE-LAUNCH-AUDIT.md
Changelog	/CHANGELOG.md

---

Version History

Version	Date	Highlights
1.1.0	Dec 25, 2025	UX overhaul, page consolidation, pre-launch audit
1.0.5	Dec 12, 2025	Purchase Credits tab
1.0.4	Dec 12, 2025	Credit Activity tab
1.0.3	Dec 12, 2025	Usage Limits improvements
1.0.2	Dec 12, 2025	Design system enforcement
1.0.1	Dec 12, 2025	Plan limits UI
1.0.0	Dec 12, 2025	Initial production release

---

For detailed technical implementation, see the /docs folder. For known issues and improvement roadmap, see /PRE-LAUNCH-AUDIT.md.