docs update
This commit is contained in:
IGNY8 VPS (Salman)
433
IGNY8-APP.md
433
IGNY8-APP.md
@@ -1,6 +1,6 @@
|
||||
# IGNY8 - AI-Powered SEO Content Platform
|
||||
|
||||
**Version:** 1.0.5
|
||||
**Version:** 1.1.0
|
||||
**Last Updated:** December 25, 2025
|
||||
**Status:** Production Ready
|
||||
|
||||
@@ -8,216 +8,363 @@
|
||||
|
||||
## What is IGNY8?
|
||||
|
||||
IGNY8 is an enterprise-grade AI-powered content platform that helps businesses create, manage, and publish SEO-optimized content at scale. It combines artificial intelligence with workflow automation to transform keyword research into published articles with minimal manual effort.
|
||||
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 Overview
|
||||
## Platform Architecture
|
||||
|
||||
| Aspect | Details |
|
||||
|--------|---------|
|
||||
| Type | Full-stack SaaS Platform |
|
||||
| Architecture | Multi-tenant cloud application |
|
||||
| Target Users | Content marketers, SEO agencies, digital publishers |
|
||||
| Deployment | Docker-based, cloud-hosted |
|
||||
| Pricing | Credit-based usage with subscription plans |
|
||||
| **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 Capabilities
|
||||
## Core Workflow
|
||||
|
||||
### 1. AI Content Generation
|
||||
IGNY8 follows a structured 8-stage content pipeline:
|
||||
|
||||
Transform keywords into fully-formed, SEO-optimized articles:
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────────────┐
|
||||
│ SETUP WORKFLOW │
|
||||
│ ───── ──────── │
|
||||
│ Sites → Keywords → Clusters → Ideas → Tasks → Content → Images → Published │
|
||||
│ ↑ ↑ ↑ │
|
||||
│ Configure AI Groups AI Writes │
|
||||
│ WordPress Related Full Articles │
|
||||
│ Keywords + SEO Meta │
|
||||
└─────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
- **GPT-4 Powered Writing**: High-quality, contextually-aware content
|
||||
- **Smart Structuring**: Proper headings, paragraphs, lists automatically
|
||||
- **SEO Optimization**: Meta titles, descriptions, keyword density
|
||||
- **Customizable Length**: 500 to 5,000+ words per article
|
||||
- **Multiple Content Types**: Blog posts, guides, comparisons, reviews
|
||||
### Manual Mode
|
||||
Walk through each stage with full control—review and edit at every step.
|
||||
|
||||
### 2. Intelligent Keyword Management
|
||||
### 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.
|
||||
|
||||
Comprehensive keyword research and organization:
|
||||
---
|
||||
|
||||
- **Bulk Import**: Upload thousands of keywords via CSV
|
||||
- **AI Clustering**: Automatically group related keywords
|
||||
- **Global Database**: 50+ industries with seed keywords
|
||||
- **Intent Classification**: Informational, commercial, transactional
|
||||
- **Metrics Tracking**: Volume, difficulty, CPC
|
||||
## Feature Deep-Dive
|
||||
|
||||
### 3. Content Idea Generation
|
||||
### 1. Keyword Management (Planner)
|
||||
|
||||
Transform clusters into actionable content briefs:
|
||||
**Import Options:**
|
||||
- Upload CSV with thousands of keywords
|
||||
- Browse 50+ industries of pre-curated seed keywords
|
||||
- Filter by country, difficulty, search volume
|
||||
|
||||
- **AI-Powered**: Generate ideas from keyword clusters
|
||||
- **Structured Briefs**: Title, keywords, angle, outline
|
||||
- **Word Count Estimates**: Based on competition analysis
|
||||
- **Priority Scoring**: Rank by SEO potential
|
||||
**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)
|
||||
|
||||
### 4. Image Generation
|
||||
**Metrics Tracked:**
|
||||
- Search volume (monthly)
|
||||
- Keyword difficulty (0-100)
|
||||
- CPC (cost-per-click)
|
||||
- Intent classification (informational, commercial, transactional)
|
||||
|
||||
Dual AI providers for visual content:
|
||||
---
|
||||
|
||||
- **DALL-E 3**: High-quality image generation
|
||||
- **Runware**: Alternative provider for variety
|
||||
- **Smart Prompts**: Extracted from content context
|
||||
- **Multiple Types**: Featured, in-article, mobile/desktop
|
||||
### 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
|
||||
|
||||
Complete 7-stage automated workflow:
|
||||
|
||||
**7-Stage Automated Workflow:**
|
||||
```
|
||||
Keywords → Clusters → Ideas → Tasks → Content → Image Prompts → Images
|
||||
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
|
||||
```
|
||||
|
||||
- **Scheduled Runs**: Daily, weekly, or monthly
|
||||
- **Configurable**: Batch sizes, delays, stages
|
||||
- **Credit Estimation**: Know costs before running
|
||||
- **Pause/Resume**: Control running automation
|
||||
**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
|
||||
|
||||
Seamless publishing to WordPress:
|
||||
**Publishing:**
|
||||
- One-click publish from Review tab
|
||||
- Direct WordPress REST API integration
|
||||
- Supports multiple WordPress sites per account
|
||||
|
||||
- **One-Click Publish**: Push content directly
|
||||
- **Two-Way Sync**: Import and export content
|
||||
- **Taxonomy Sync**: Categories and tags
|
||||
- **Image Upload**: Featured and in-article
|
||||
- **Multiple Sites**: Manage many WordPress sites
|
||||
**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 | Description |
|
||||
|--------|--------|-------------|
|
||||
| **Planner** | ✅ Active | Keyword management, clustering, ideas |
|
||||
| **Writer** | ✅ Active | Task management, content generation, images |
|
||||
| **Automation** | ✅ Active | 7-stage automated pipeline |
|
||||
| **Billing** | ✅ Active | Credits, plans, payments |
|
||||
| **Integrations** | ✅ Active | WordPress sync |
|
||||
| **Settings** | ✅ Active | AI config, prompts, modules |
|
||||
| **Publisher** | ✅ Active | Publishing pipeline |
|
||||
| **Linker** | ⏸️ Inactive | Internal linking (available but disabled) |
|
||||
| **Optimizer** | ⏸️ Inactive | Content optimization (available but disabled) |
|
||||
| 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` |
|
||||
| **Linker** | ⏸️ Disabled | Internal linking (available, disabled by default) |
|
||||
| **Optimizer** | ⏸️ Disabled | Content optimization (available, disabled by default) |
|
||||
|
||||
---
|
||||
|
||||
## Plans & Pricing
|
||||
## Navigation Structure
|
||||
|
||||
### Subscription Plans
|
||||
|
||||
| Plan | Sites | Users | Credits/Month | Best For |
|
||||
|------|-------|-------|---------------|----------|
|
||||
| Free | 1 | 1 | 100 | Trial |
|
||||
| Starter | 3 | 3 | 1,000 | Individuals |
|
||||
| Growth | 10 | 10 | 5,000 | Small teams |
|
||||
| Scale | Unlimited | Unlimited | 25,000 | Agencies |
|
||||
|
||||
### Credit Costs (Typical)
|
||||
|
||||
| Operation | Credits |
|
||||
|-----------|---------|
|
||||
| Keyword Clustering (batch) | 10 |
|
||||
| Content Idea | 2 |
|
||||
| Content (per 100 words) | 5 |
|
||||
| Image (basic) | 3 |
|
||||
| Image (premium) | 5 |
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## User Roles
|
||||
## Technical Stack
|
||||
|
||||
| Role | Access Level |
|
||||
|------|--------------|
|
||||
| Admin | Full account access |
|
||||
| Manager | Content + billing view |
|
||||
| Editor | AI content, clusters, tasks |
|
||||
| Viewer | Read-only dashboards |
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
## Key Workflows
|
||||
## Security
|
||||
|
||||
### Manual Content Creation
|
||||
|
||||
1. Import keywords or select from database
|
||||
2. Run AI clustering to group keywords
|
||||
3. Generate content ideas from clusters
|
||||
4. Create tasks from ideas
|
||||
5. Generate content with AI
|
||||
6. Generate images for content
|
||||
7. Review and edit
|
||||
8. Publish to WordPress
|
||||
|
||||
### Automated Content Pipeline
|
||||
|
||||
1. Configure automation settings
|
||||
2. Set schedule (daily/weekly/monthly)
|
||||
3. System runs 7 stages automatically
|
||||
4. Content queued for review
|
||||
5. Approve and publish
|
||||
- **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
|
||||
|
||||
---
|
||||
|
||||
## Security & Compliance
|
||||
## Current Limitations & Known Issues
|
||||
|
||||
- Encrypted data at rest and in transit
|
||||
- Multi-tenant data isolation
|
||||
- Role-based access control
|
||||
- Session management with Redis
|
||||
- GDPR compliance ready
|
||||
**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
|
||||
|
||||
---
|
||||
|
||||
## Current Limitations
|
||||
## Getting Started
|
||||
|
||||
| Item | Status |
|
||||
|------|--------|
|
||||
| Stripe payments | Pending production credentials |
|
||||
| PayPal payments | Pending production credentials |
|
||||
| Linker module | Disabled by default |
|
||||
| Optimizer module | Disabled by default |
|
||||
### 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
|
||||
|
||||
---
|
||||
|
||||
## Technical Details
|
||||
## Documentation
|
||||
|
||||
For technical documentation, see: `/docs/INDEX.md`
|
||||
|
||||
| Component | Technology |
|
||||
|-----------|------------|
|
||||
| Backend | Django 5.x, Python |
|
||||
| Frontend | React 19, TypeScript |
|
||||
| Database | PostgreSQL |
|
||||
| Cache | Redis |
|
||||
| AI | OpenAI GPT-4, DALL-E 3 |
|
||||
| Deployment | Docker |
|
||||
|
||||
---
|
||||
|
||||
## Support & Resources
|
||||
|
||||
| Resource | Location |
|
||||
| Document | Location |
|
||||
|----------|----------|
|
||||
| Technical Docs | `/docs/INDEX.md` |
|
||||
| API Reference | `/docs/20-API/ENDPOINTS.md` |
|
||||
| API Reference | `/docs/20-API/` |
|
||||
| Pre-Launch Audit | `/PRE-LAUNCH-AUDIT.md` |
|
||||
| Changelog | `/CHANGELOG.md` |
|
||||
| Rules | `/RULES.md` |
|
||||
|
||||
---
|
||||
|
||||
## Version History
|
||||
|
||||
- **v1.0.5** (Dec 12, 2025): Purchase Credits tab, UI reorganization
|
||||
- **v1.0.4** (Dec 12, 2025): Credit Activity tab, Cost Reference panel
|
||||
- **v1.0.3** (Dec 12, 2025): Usage Limits colors, Cost Breakdown
|
||||
- **v1.0.2** (Dec 12, 2025): Design system enforcement
|
||||
- **v1.0.1** (Dec 12, 2025): Plan limits UI
|
||||
- **v1.0.0** (Dec 12, 2025): Initial production release
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
*This document provides a non-technical overview. For technical implementation details, refer to the docs folder.*
|
||||
*For detailed technical implementation, see the `/docs` folder. For known issues and improvement roadmap, see `/PRE-LAUNCH-AUDIT.md`.*
|
||||
|
||||
Reference in New Issue
Block a user