diff --git a/v2/Alorig-Master-Plan-v1.md b/v2/Alorig-Master-Plan-v1.md new file mode 100644 index 00000000..1c29f667 --- /dev/null +++ b/v2/Alorig-Master-Plan-v1.md @@ -0,0 +1,639 @@ +**ALORIG SYSTEMS** + +**Infrastructure & Platform Master Plan** + +Multi-App Centralized Server Architecture + +IGNY8 Phase 2 Development Roadmap + +Complete Execution Sequence with File References + +Version 1.0 \| March 2026 + +Confidential --- Alorig Systems + +*For use with Claude Code Desktop & Cowork* + +**1. Executive Context** + +This document is the single operational reference for building and +deploying the Alorig multi-app ecosystem on a centralized KVM 4 VPS, and +for executing the IGNY8 Phase 2 development roadmap. It is designed to +be loaded into Claude Code Desktop or Cowork as the primary instruction +document, alongside the referenced project files. + +**1.1 What This Document Covers** + +- New VPS setup: shared infrastructure for 7 apps on Hostinger KVM 4 + (4 vCPU, 16GB RAM, 200GB NVMe) + +- DNS migration from hosting middleman to Cloudflare (free tier) + +- IGNY8 production migration from old server to new clean architecture + +- IGNY8 staging environment for Phase 2 development + +- IGNY8 Phase 2 complete execution sequence (SAG implementation + through all modules) + +- Container pruning: removing 6 unnecessary containers from legacy + setup + +- Subsequent app deployment order for Psydge, Snapify, Observer OS, + Alorig Site Builder, AstroTiming, ASMS + +**1.2 The 7 Long-Term Resident Apps** + + -------- ------------------------- -------------------------------------------------------------- ---------------------- + **\#** **App** **Description** **Stack** + 1 **IGNY8** AI-powered SEO content automation SaaS (flagship) Django + React + 2 **Psydge** AI trading platform with real-time WebSockets (heaviest app) Django + Channels + 3 **Snapify** E-commerce platform for Pakistani sellers Django + React + 4 **Observer OS** Consciousness/behavioral awareness app (migrates when heavy) Django + React + 5 **Alorig Site Builder** AI-powered multi-tenant website platform Django + Payload CMS + 6 **AstroTiming** Planetary hour timing engine Django/FastAPI + 7 **ASMS** School management system Phase 1 Django + React + -------- ------------------------- -------------------------------------------------------------- ---------------------- + +**1.3 Reference Files Index** + +All IGNY8 development plans exist as separate documents. This is the +complete index with their role in the execution sequence: + + ---------------------------------------------------- ---------------------------------------------------------------------------------------- --------------------- + **Filename** **Scope** **Used In Phase** + **IGNY8-Current-State.md** Complete platform state, tech stack, all modules All phases + **SAG-Master-Document.md** Pure SAG methodology and clustering rules Phase 3 reference + **SAG-IGNY8-Implementation.md** Three-layer SAG architecture, Case 1/Case 2 flows, data models, 9-phase implementation Phase 3 primary + **DocA-SAG-Architecture-Dev-Guide.md** Developer implementation guide for SAG backend Phase 3 code ref + **DocB-Platform-Modules-Dev-Guide.md** Developer guide for all platform modules Phases 3-5 code ref + **DocC-WordPress-Ecosystem-Dev-Guide.md** Plugin, theme, toolkit developer guide Phases 4-5 code ref + **DocD-Business-Services-Dev-Guide.md** Managed services and business layer guide Phase 6 code ref + **IGNY8-Consolidated-Module-Plans.md** Content Types, Taxonomy, Optimizer, GSC, Socializer, Video plans Phase 3B parallel + **SAG-Doc3-Interlinking-Specification-PLAN.md** Linker module evolution with SAG-aware linking Phase 4 + **SAG-Doc4-External-Backlink-Campaign-PLAN.md** External backlink campaign generation and tracking Phase 4 + **IGNY8-Plugin-Build-Plan.md** Full standalone SEO plugin (free + connected) Phase 5 + **Theme-Build-Plan.md** Premium WordPress theme with CPTs, taxonomies, WooCommerce Phase 5 + **IGNY8-Rich-Schema-SERP-Enhancement-Module.docx** Rich schema / structured data module Phase 5 + **IGNY8-Industry-Sector-Master-List.md** 50+ industries with sector classifications Phase 3 data + **SAG-Niche-Definition-Process.docx** Niche definition production workflow Phase 3 reference + **SAGIndustry01HealthcareMedical.xlsx** Healthcare sector Excel template (formatting reference) Phase 3 template + ---------------------------------------------------- ---------------------------------------------------------------------------------------- --------------------- + +**2. Infrastructure Setup (Phase 1)** + +Everything starts here. No app deployment happens until the shared +foundation is solid on the new KVM 4 VPS. + +**2.1 DNS Migration to Cloudflare** + +Current state: domain nameservers point to hosting provider, hosting +provider has A records to VPS, email settings on hosting server. This +adds an unnecessary middleman. + +**Actions:** + +- Create Cloudflare account (free tier), add all Alorig domains + +- At each domain registrar, change nameservers to Cloudflare-assigned + nameservers + +- In Cloudflare, create wildcard A record (\*.igny8.com, + \*.alorig.com, etc.) pointing to new VPS IP + +- Add MX, SPF, DKIM, DMARC records for email (same mail server, just + managed in Cloudflare now) + +- Create Cloudflare API token with Edit Zone DNS permission (needed + for Caddy SSL automation) + +- Verify all domains resolve correctly before proceeding + +**Result:** + +All DNS managed in Cloudflare dashboard. DDoS protection and CDN caching +included. Wildcard SSL via Caddy + Cloudflare DNS challenge. Email +routing unchanged. + +**2.2 Shared Alorig Infrastructure Layer** + +The foundation that all 7 apps share. Built once, used by everything. + +**Docker Network:** + +- Create external Docker network: alorig\_net + +- All app containers and shared services join this network + +**Shared Services (alorig-infra docker-compose.yml):** + + ---------------------- -------------- ------------------------ ----------------------------------------------------------------- + **Container** **Image** **Purpose** **Notes** + **alorig\_postgres** postgres:16 Primary database Separate database per app, shared instance + **alorig\_redis** redis:7 Cache + Celery broker App-specific key prefixes (igny8:, psydge:, etc.) + **alorig\_caddy** caddy:2 Reverse proxy + SSL Cloudflare DNS challenge for wildcard certs, routes all domains + **portainer** portainer-ce Docker GUI management Keep for managing 25+ containers visually + **flower** mher/flower Celery task monitoring On-demand later; essential during multi-app setup + ---------------------- -------------- ------------------------ ----------------------------------------------------------------- + +**2.3 Container Pruning (Legacy Cleanup)** + +The current IGNY8 server runs 14 containers. Six must be removed +permanently: + + ------------------------- ------------------------------------------------------------------------ --------------- + **Container to Remove** **Why** **RAM Freed** + **igny8\_frontend-dev** Vite dev server on production. Build static, serve via Caddy. \~250 MB + **igny8\_marketing** Entire Django instance for marketing site. WordPress replaces this. \~400 MB + **igny8\_pgadmin** Redundant. psql CLI + Django manage.py dbshell cover everything. \~250 MB + **gitea** Self-hosted Git server. GitHub free tier handles private repos. \~400 MB + **igny8\_filebrowser** Web file manager. VS Code Remote SSH or Claude Code SSH replaces this. \~150 MB + **setup-helper** Alpine container running sleep infinity. Dead weight. \~0 MB + ------------------------- ------------------------------------------------------------------------ --------------- + +**Total RAM recovered:** \~1.5 GB --- equivalent to one additional app's +worth of headroom. + +**2.4 Per-App Container Pattern** + +Every Django app follows an identical container structure: + +- appname\_backend --- Django + Gunicorn (WSGI) or Daphne (ASGI for + Psydge) + +- appname\_celery\_worker --- Background task processing + +- appname\_celery\_beat --- Scheduled task scheduling + +- React frontend built as static files, served through alorig\_caddy + (no separate frontend container) + +**Exception:** Psydge adds a 4th container for Django Channels +(ASGI/WebSocket). Alorig Site Builder adds a Node.js/Payload CMS +container alongside its Django containers. + +**2.5 Resource Budget** + + -------------------------------------------------------- ----------------------- ------------------------------------------------------------- + **Component** **RAM Estimate** **Notes** + Shared infra (PG + Redis + Caddy + Portainer + Flower) \~2.5 GB PostgreSQL serving 7 databases is the biggest consumer + IGNY8 (prod + staging) \~1.8 GB Heaviest AI processing but I/O-bound (external APIs) + Psydge \~1.75 GB WebSockets hold memory per connection; heaviest at 30 users + Snapify \~700 MB Standard CRUD with image processing tasks + Observer OS \~700 MB AI pattern detection is external API calls + Alorig Site Builder \~1.25 GB Django + Payload/Node.js dual runtime + AstroTiming \~400 MB Lightest app. Brief CPU bursts for ephemeris calculations + ASMS Phase 1 \~600 MB Pilot scale, basic modules only + OS + Docker overhead \~1.0 GB + **TOTAL STEADY STATE** **\~10.7 GB / 16 GB** **\~5 GB headroom for spikes and growth** + -------------------------------------------------------- ----------------------- ------------------------------------------------------------- + +**Upgrade trigger:** Steady-state RAM consistently above 13 GB, or OOM +kills on any container. Options: upgrade to KVM 8, or split Psydge to +its own KVM 1. + +**3. IGNY8 Migration & Stabilization (Phase 2)** + +Before any new development begins, IGNY8 must be running cleanly on the +new server with both production and staging environments. + +**3.1 Production Migration** + +- Build clean Docker Compose for IGNY8 on new VPS: igny8\_backend, + igny8\_celery\_worker, igny8\_celery\_beat + +- Build React frontend (vite build), output static files to + Caddy-served directory + +- Configure Caddy routes: app.igny8.com → static React, api.igny8.com + → Django backend + +- pg\_dump from old server, pg\_restore to alorig\_postgres on new + server (database: igny8\_db) + +- Migrate any media files not on S3/DO Spaces + +- Update plugin distribution URLs if applicable + +- DNS cutover: point app.igny8.com and api.igny8.com to new VPS IP in + Cloudflare + +- Caddy auto-provisions SSL certificates via Cloudflare DNS challenge + +- Verify all functionality: login, content pipeline, WordPress plugin + connectivity, automation runs + +*📄 IGNY8-Current-State.md --- Section 28 (Deployment) for architecture +reference* + +**3.2 Staging Environment** + +- Identical 3-container setup: igny8\_staging\_backend, + igny8\_staging\_celery\_worker, igny8\_staging\_celery\_beat + +- Separate database: igny8\_staging\_db on same PostgreSQL instance + +- Separate Redis key prefix: igny8\_staging: + +- Caddy routes: staging-app.igny8.com and staging-api.igny8.com + +- Seed with copy of production data (anonymized if needed) + +- All Phase 2+ development happens here first, then merges to + production + +**3.3 Fix Known Limitations Before Phase 2** + +These are documented bugs and gaps in IGNY8-Current-State.md Section 26 +that should be resolved before SAG development begins: + +- Backend API gaps: Content generation settings save, publishing + settings save, profile settings save, password change + +- Module guard: Extend beyond sidebar to block direct URL access to + disabled modules + +- Missing SaaS API endpoints: /system/ping/, + /system/sites/{id}/status/, and others needed for plugin automation + +- Stripe/PayPal production credentials: Complete payment processing + setup + +*📄 IGNY8-Current-State.md --- Section 26 (Known Limitations & Pending +Items)* + +**4. IGNY8 Phase 2: SAG Implementation (Phase 3)** + +This is the core transformation: IGNY8 evolves from a keyword-driven +content tool into a structure-first site architecture engine powered by +the Semantic Authority Grid methodology. This is the largest and most +complex development phase. + +**4.1 SAG Data Foundation (Weeks 1--3)** + +Build the new data layer that SAG depends on. Backend only, no UI. + +- Create SAGBlueprint, SAGAttribute, SAGCluster models + +- Create SectorAttributeTemplate model + +- Blueprint CRUD API endpoints + +- Add nullable SAG fields to existing Cluster, Tasks, Content, + ContentIdea models + +- Basic blueprint viewer in Site Settings (read-only) + +*📄 SAG-IGNY8-Implementation.md --- Section 16 (Data Models & Schema)* + +*📄 DocA-SAG-Architecture-Dev-Guide.md --- Phase 1 implementation +details* + +**4.2 Sector Attribute Templates (Weeks 4--6)** + +Build the attribute intelligence layer that makes SAG possible. + +- Manually create attribute templates for top 5--8 sectors with + highest user base + +- AI-assisted template generation for remaining sectors + +- Template loading, merging (multi-sector), and validation logic + +- API: given industry + sectors → return attribute framework + +*📄 SAG-IGNY8-Implementation.md --- Section 5 (Layer 1: Attribute +Framework)* + +*📄 IGNY8-Industry-Sector-Master-List.md --- Complete sector +classifications* + +*📄 SAGIndustry01HealthcareMedical.xlsx --- Excel template reference* + +**4.3 Cluster Formation & Keyword Generation (Weeks 7--9)** + +Core SAG intelligence: turning attributes into clusters and +auto-generating keywords. + +- AI prompt for forming clusters from attribute intersections + +- Cluster type classification logic (Product, Condition, Feature, + Brand, Informational, Comparison) + +- Keyword auto-generation engine (templates per sector type, 300--500+ + keywords per site) + +- Blueprint assembly from attributes → clusters → keywords + +*📄 SAG-IGNY8-Implementation.md --- Section 7 (Layer 3: Cluster +Formation)* + +*📄 SAG-Master-Document.md --- Clustering rules and methodology* + +*📄 SAG-Niche-Definition-Process.docx --- Production workflow reference* + +**4.4 Setup Wizard --- Case 2: New Site (Weeks 10--12)** + +First user-facing SAG feature. New site setup generates full +architecture automatically. + +- Add Site Structure step to wizard (Step 3) + +- Attribute review UI --- user confirms or adjusts AI-proposed + attributes + +- Business details input forms (per site type) + +- Blueprint preview UI + +- Quick mode vs detailed mode + +- Blueprint confirmation and storage + +*📄 SAG-IGNY8-Implementation.md --- Section 9 (Case 2: New Site from +Scratch)* + +**4.5 Blueprint-Aware Content Pipeline (Weeks 13--15)** + +Enhance the existing 7-stage pipeline to use SAG blueprints for content +generation. + +- Idea generation reads blueprint context (correct Sector, Structure, + Type, Cluster) + +- Task creation with blueprint context and content type mapping + +- Type-specific prompt selection in Writer (hub pages, product pages, + service pages, etc.) + +- Auto taxonomy assignment on content creation + +- Blueprint execution priority drives automation queue ordering + +*📄 SAG-IGNY8-Implementation.md --- Section 14 (Integration with IGNY8 +Pipeline)* + +*📄 IGNY8-Consolidated-Module-Plans.md --- Section A (Content Types +Writing Plan)* + +**4.6 Taxonomy Creation Flow (Weeks 16--17)** + +Push SAG-generated taxonomies from IGNY8 to WordPress. + +- Taxonomy creation payload generator from blueprint + +- Plugin endpoint to create WordPress taxonomies + +- Existing taxonomy detection and mapping (for Case 1 sites) + +- Taxonomy sync status tracking + +*📄 SAG-IGNY8-Implementation.md --- Section 13 (Taxonomy Creation Flow)* + +*📄 IGNY8-Consolidated-Module-Plans.md --- Section B (Taxonomy & Term +Content Plan)* + +**4.7 Case 1: Existing Site Analysis (Weeks 18--21)** + +AI extracts SAG structure from existing site data --- the +reverse-engineering path. + +- Plugin sends site data (products, categories, taxonomies, content) + to IGNY8 + +- AI attribute extraction from unstructured site data + +- Gap analysis engine: what the site has vs what SAG recommends + +- User confirmation UI for discovered attributes and proposed + structure + +- Product auto-tagging based on discovered attributes + +*📄 SAG-IGNY8-Implementation.md --- Section 8 (Case 1: Existing Site +Intelligence)* + +**4.8 SAG Health Monitoring (Weeks 22--24)** + +- SAG Health Score calculation per blueprint + +- Weekly health check automation via Celery Beat + +- Blueprint evolution triggers (when to recommend adding + clusters/attributes) + +- Dashboard SAG Health widget + +- End-to-end testing of both Case 1 and Case 2 flows + +*📄 SAG-IGNY8-Implementation.md --- Phase 8 details* + +**4.9 Parallel Track: Module Development** + +These modules can be developed alongside SAG phases 4.5--4.8 since they +have independent or lighter dependencies. + +**GSC Integration (10 weeks, parallel with SAG Phases 4.3+)** + +- Google Search Console OAuth + site connection + +- URL inspection queue and status tracking + +- Auto-indexing hooks for newly published content + +- Plugin status sync and performance metrics + +*📄 IGNY8-Consolidated-Module-Plans.md --- Section F (GSC Integration)* + +**Content Types Writing (parallel with SAG Phase 4.5)** + +- Extend Writer pipeline: pages, products, services, company pages, + taxonomy terms + +- Type-specific idea templates, writer prompts, and publishing + mappings + +*📄 IGNY8-Consolidated-Module-Plans.md --- Section A (Content Types +Writing Plan)* + +**5. Post-SAG Module Development (Phase 4)** + +With SAG foundation in place, these modules activate in sequence. + +**5.1 Interlinking Specification (Linker Module)** + +Evolve the existing (inactive) Linker module into a SAG-aware internal +linking engine. + +- 7 link relationship types: vertical upward, vertical downward, + horizontal sibling, cross-cluster, taxonomy contextual, breadcrumb + structural, related content + +- Pre-computed links generated at review stage (before publish) + +- Link density rules per page type + +- WordPress plugin integration for link injection + +*📄 SAG-Doc3-Interlinking-Specification-PLAN.md --- Complete +specification plan* + +**5.2 External Backlink Campaign Module** + +Auto-generate backlink campaigns from SAG blueprints. + +- Page tier assignment from cluster types (T1--T5) + +- Country-specific campaign generation (PK, UK, USA, CA templates) + +- FatGrid marketplace integration for link ordering + +- Monthly execution roadmap automation + +- Tipping point detection via GSC data + +*📄 SAG-Doc4-External-Backlink-Campaign-PLAN.md --- Complete +specification plan* + +**5.3 Optimizer Module** + +Content optimization based on cluster mapping and performance data. + +*📄 IGNY8-Consolidated-Module-Plans.md --- Section E (Optimizer Module +Plan)* + +**6. WordPress Ecosystem Build (Phase 5)** + +The complete WordPress product suite that makes SAG visible on client +sites. + +**6.1 IGNY8 Plugin (Standalone SEO + Connected Premium)** + +Full replacement for Yoast/RankMath as a free standalone plugin, with +premium connected features when linked to IGNY8 SaaS. + +- 14 modules across 9 phases + +- Standalone: SEO meta, schema, sitemap, redirects, analytics, site + intelligence, linking suggestions + +- Connected: content sync, SAG blueprint sync, taxonomy creation, + automation triggers + +- WordPress.org distribution as free plugin + +*📄 IGNY8-Plugin-Build-Plan.md --- Complete build plan* + +*📄 DocC-WordPress-Ecosystem-Dev-Guide.md --- Developer implementation +guide* + +**6.2 Companion Theme** + +Premium WordPress theme providing SAG-optimized site structure. + +- 7 custom post types, 9 custom taxonomies + +- 5 site-type starter templates (Blog, SaaS, E-Commerce, Corporate, + Portfolio) + +- 50+ block patterns, section-based landing page builder + +- Full WooCommerce template overrides + +- Interlinking display components reading data from IGNY8 plugin + +*📄 Theme-Build-Plan.md --- Complete build plan* + +**6.3 Rich Schema / SERP Enhancement** + +*📄 IGNY8-Rich-Schema-SERP-Enhancement-Module.docx --- Module +specification* + +**7. Business & Services Layer (Phase 6)** + +- Managed services add-on: Lite (\$100/site/mo), Pro (\$399/site/mo) + +- White-label reporting for agency clients + +- Client onboarding automation + +- Plan pricing increase timed to new feature release + +*📄 DocD-Business-Services-Dev-Guide.md --- Complete developer guide* + +**8. Other App Deployment Sequence (Phase 7)** + +Once IGNY8 is stable on the new server, apps are added one at a time. +Each follows the per-app container pattern from Section 2.4. + +**8.1 Deployment Order** + + -------- ------------------ ----------------------------------------------------------------------------- --------------------- + **\#** **App** **Why This Order** **Trigger** + 1 **Psydge** Most complex (WebSockets). Deploy early to validate server under real load. After IGNY8 stable + 2 **Snapify** Standard Django stack. Good validation that multi-app pattern works. After Psydge stable + 3 **Site Builder** Dual runtime (Django + Payload). Tests Node.js alongside Django stack. After Snapify + 4 **Observer OS** Standard Django stack. Light resource requirements initially. When ready + 5 **AstroTiming** Lightest app. Minimal containers needed. When ready + 6 **ASMS Phase 1** School management MVP. Basic modules for pilot deployment. When ready + -------- ------------------ ----------------------------------------------------------------------------- --------------------- + +Each app gets its own Docker Compose file that joins alorig\_net, its +own database on shared PostgreSQL, its own Redis key prefix, and its own +Caddy routes. Monitor actual RAM usage after each deployment. + +**9. Development Tooling** + +**9.1 Claude Code Desktop** + +Primary development interface. Use the Code tab with SSH connection to +VPS for all server-side work. Visual diff review for code changes. +Parallel sessions for working on multiple apps simultaneously. + +**9.2 Claude Web Interface (claude.ai)** + +Continue using for strategic planning, document generation (Word/Excel +via skills), SAG methodology discussions, and project knowledge queries. +Project knowledge and memory sync between web and desktop. + +**9.3 GitHub** + +All repos hosted on GitHub (free private repos). Replaces self-hosted +Gitea. Each app gets its own repository. + +**10. Execution Summary** + +The complete sequence at a glance: + + ----------- -------------------------- ----------------------------------------------------------------------------- + **Phase** **What** **Key Deliverable** + **1** **Infrastructure Setup** New VPS with shared Alorig infra, Cloudflare DNS, clean Docker architecture + **2** **IGNY8 Migration** Production + staging running on new server, known limitations fixed + **3** **SAG Implementation** IGNY8 transforms from keyword tool to site architecture engine (24 weeks) + **3B** **Parallel Modules** GSC Integration + Content Types Writing (parallel with Phase 3) + **4** **Post-SAG Modules** Linker, Backlink Campaigns, Optimizer activated with SAG awareness + **5** **WordPress Ecosystem** Plugin (free + connected), Companion Theme, Rich Schema module + **6** **Business Layer** Managed services, pricing increase, white-label reporting + **7** **Other Apps** Psydge → Snapify → Site Builder → Observer OS → AstroTiming → ASMS + ----------- -------------------------- ----------------------------------------------------------------------------- + +**Key Principles** + +- Nothing currently working breaks. All new features use nullable + fields and feature flags. + +- SAG methodology is attribute-first, not keyword-first. Keywords + emerge from attribute intersections. + +- Every app on the shared server follows the same container pattern. + No snowflakes. + +- Staging first, production second. Always. + +- Monitor real resource usage after each deployment. Upgrade decisions + are data-driven. + +- This document is the single source of truth. All referenced files + contain the implementation details. + +*End of Document* diff --git a/v2/IGNY8-Complete-Platform-Features.md b/v2/IGNY8-Complete-Platform-Features.md new file mode 100644 index 00000000..a4ccdffd --- /dev/null +++ b/v2/IGNY8-Complete-Platform-Features.md @@ -0,0 +1,1118 @@ +**IGNY8** + +Infinity Growth Engine + +Complete Platform Features & Capabilities + +AI-Powered SEO Content Automation SaaS Platform + +**Alorig Systems** + +March 2026 + +*Confidential --- Internal Product Reference* + +**1. Executive Overview** + +IGNY8 (Infinity Growth Engine) is a full-stack, AI-powered SEO content +automation SaaS platform that transforms how businesses build topical +authority online. Unlike traditional content tools that focus on +individual keyword optimization, IGNY8 operates as a complete site +architecture engine --- discovering market structure, generating content +at scale, building intelligent internal linking, managing external +backlink campaigns, and publishing to WordPress, all through a unified +platform. + +The platform serves content marketers, SEO agencies, digital publishers, +and businesses seeking to dominate their niche through systematic, +AI-driven content operations. IGNY8 automates the entire content +lifecycle from keyword intelligence through to social distribution and +video creation, with the proprietary Semantic Authority Grid (SAG) +methodology as its strategic foundation. + +**1.1 Platform Architecture** + +IGNY8 operates as a multi-tenant SaaS application with complete data +isolation per account. The platform comprises three domains: + +- app.igny8.com --- React single-page application frontend + +- api.igny8.com --- Django REST API backend + +- igny8.com --- Marketing and documentation site + +**1.2 Technology Foundation** + + ---------------- ----------------------------------------------------------------------------------------------- + **Layer** **Technology** + Backend Django 5.1 / Django REST Framework, PostgreSQL, Redis, Celery + Frontend React 19 / TypeScript, Zustand state management, Tailwind CSS + AI Engine Multi-provider: OpenAI (GPT, DALL-E), Anthropic (Claude), ElevenLabs, Coqui TTS, Runware/Flux + Publishing WordPress via IGNY8 Bridge Plugin, REST API sync + Infrastructure Docker, Caddy reverse proxy, Celery Beat scheduling + SEO Data Ahrefs API, Google Search Console API, FatGrid API, SEMrush Sensor + ---------------- ----------------------------------------------------------------------------------------------- + +**1.3 Target Users** + +- Content marketers managing multi-site SEO campaigns + +- SEO agencies serving client portfolios + +- Digital publishers scaling content operations + +- E-commerce businesses building product authority + +- SaaS companies establishing thought leadership + +- Local businesses dominating regional search + +**2. Semantic Authority Grid (SAG) Methodology** + +The Semantic Authority Grid is the proprietary strategic framework at +the core of IGNY8. SAG is not a clustering algorithm --- it is a +complete site architecture philosophy where attribute-based intelligence +generates site structure, and keywords emerge as outputs of that +structure rather than inputs. + ++----------------------------------------------------------------------+ +| **Core Innovation** | +| | +| Traditional SEO tools start with keywords and try to organize them. | +| SAG starts with the dimensional reality of a market --- what | +| attributes define the space --- and generates a complete site | +| blueprint from those dimensions. Keywords, content plans, | +| taxonomies, internal links, and backlink strategies all flow from | +| the architecture, not the other way around. | ++----------------------------------------------------------------------+ + +**2.1 Three-Layer Architecture** + +**Layer 1: Attribute Framework** + +Identifies the classification axes (facets) that organize a sector. Each +attribute represents one way to categorize content, products, or +services within a niche. For example, a personal massager site might +have attributes like Target Area, Device Type, Relief Focus, Therapy +Method, and Brand. + +**Layer 2: Attribute Population** + +Populates each attribute with specific values drawn from real market +data. For the Target Area attribute, values might include Foot, Neck, +Back, Full Body, and Face. Each attribute value becomes a taxonomy term +with its own SEO-optimized landing page. + +**Layer 3: Cluster Formation & Keyword Generation** + +Meaningful intersections of two or more attribute values form clusters +--- self-contained topical ecosystems. For example, Target Area: Foot +intersecting with Relief Focus: Neuropathy creates the cluster "Foot +Massagers for Neuropathy." Keywords are then auto-generated from these +intersections using templates and modifiers, producing 300-500+ keywords +per site. + +**2.2 SAG Blueprint** + +The SAG Blueprint is the complete site architecture document generated +from the three-layer analysis. A single active blueprint per site drives +all downstream operations: + +- Cluster definitions with hub pages and supporting content plans + +- Taxonomy structure (each attribute becomes a WordPress custom + taxonomy) + +- Execution priority phasing (what to build first, second, third) + +- Internal linking map (deterministic link rules between all pages) + +- Content type assignments per cluster (product, service, comparison, + informational) + +- Health scoring (0-100 completeness metric tracked over time) + +**2.3 Two Entry Scenarios** + +**Case 1: Existing Site Intelligence** + +For sites with existing content, products, and categories, IGNY8 +analyzes the live site data --- products, taxonomies, content structure +--- and extracts an attribute framework from what already exists. The +system identifies gaps between the current site structure and the ideal +SAG architecture, producing a gap analysis report with prioritized +recommendations. + +**Case 2: New Site Builder Wizard** + +For new sites starting from scratch, a guided six-step wizard collects +business data (industry, sectors, business type, product catalog or +service list) and generates a complete blueprint automatically. The user +reviews the proposed architecture, confirms it, and the system proceeds +to generate content, create taxonomies, and build the site. + +**2.4 Pre-Built SAG Library** + +IGNY8 includes a comprehensive library of pre-built sector attribute +frameworks covering 45+ industries. Each sector template contains +predefined attributes, suggested values, keyword generation templates, +and cluster formation patterns. This means users in supported industries +get a head start --- the system already knows the dimensional structure +of their market. + + ------------------------- -------------------------------------- + **Metric** **Value** + Industries Covered 45+ + Sectors per Industry Up to 10 + Clusters per Sector Up to 25 (max 50 hard cap) + Keywords per Cluster 15-25 + Total Keywords per Site 300-500+ + Attributes per Sector \~6 (primary + secondary + tertiary) + ------------------------- -------------------------------------- + +**2.5 SAG Niche Adaptation** + +The SAG framework adapts to any business type through niche-specific +dimensional patterns: + +- E-Commerce: Product type, feature, condition/use-case, brand, price + range, audience + +- SaaS / Technology: Feature category, use case, industry vertical, + company size, integration type + +- Services Business: Service type, industry served, location, + methodology, outcome + +- Content / Media: Subject area, reader level, content format, + timeliness + +- Local Business: Service type, location, audience, urgency + +**3. Core Content Pipeline** + +IGNY8 follows a structured, multi-stage content pipeline that transforms +raw keyword intelligence into published, SEO-optimized content. The +pipeline operates in both manual mode (full editorial control at every +stage) and automation mode (configure once, let IGNY8 handle everything +on schedule). + +**3.1 Pipeline Stages** + + ----------- ----------------------- ---------------------------------------------------------------------------------- + **Stage** **Name** **Function** + 0 Blueprint Check Verify SAG blueprint status and priorities (when SAG is active) + 1 Process Keywords Ingest and validate new keywords with volume, difficulty, and CPC data + 2 Cluster Keywords AI-powered semantic clustering or SAG-aware cluster mapping + 3 Generate Ideas AI generates content ideas per cluster, type-aware and blueprint-guided + 4 Create Tasks Convert approved ideas into writer tasks with content type and structure presets + 5 Generate Content AI writes full articles with SEO metadata, type-specific prompts, and schema + 6 Extract Image Prompts AI analyzes content to generate relevant image prompts + 7 Generate Images AI creates featured and in-article images; content enters review queue + 7.5 Auto-Index via GSC Submit published URLs to Google for indexing via URL Inspection API + 8 Generate Links SAG-aware internal link generation and injection into content + 9 Socializer Adapt published content into social posts for 5 platforms + 10 Video Creator Convert content into video projects for YouTube, TikTok, Reels + ----------- ----------------------- ---------------------------------------------------------------------------------- + +**3.2 Manual Mode** + +In manual mode, users walk through each stage with complete editorial +control. Every keyword can be reviewed, every cluster adjusted, every +idea edited, and every piece of content refined before progressing to +the next stage. This mode is ideal for agencies with strict quality +standards or businesses in sensitive industries. + +**3.3 Automation Mode** + +Automation mode processes all stages on a configurable schedule --- +daily, weekly, or monthly runs. Once configured, IGNY8 handles the +entire pipeline automatically: processing keywords, forming clusters, +generating ideas, writing content, creating images, and queueing +everything for review. The system provides credit estimation before each +run, real-time progress tracking, and a detailed activity log. + +**3.4 Workflow States** + +Content moves through four workflow states: Queue (waiting for AI +processing), Draft (content generated, ready for editing), Review +(content polished, awaiting approval), and Published (live on +WordPress). Each state has dedicated management views in the Writer +module with filtering, bulk actions, and status tracking. + +**4. Multi-Type Content Writing** + +IGNY8 produces content across multiple WordPress post types, not just +blog posts. Every content type flows through the same pipeline but with +type-specific prompts, structural templates, and SEO requirements. + +**4.1 Supported Content Types** + + ------------------------ ----------------------- -------------------------------------------------------------------- + **Content Type** **WordPress Mapping** **Key Features** + Blog Posts post Articles, guides, how-tos, comparisons, reviews, roundups + Pages page Landing pages, about, contact, pillar pages, FAQs + Products product (WooCommerce) Feature/benefit sections, specs tables, comparison, product schema + Services Custom post type Service overview, process steps, outcomes, local SEO sections + Company Pages page Brand mission, values, team bios, media/press blocks + Taxonomy Landing Pages Term descriptions Topical definitions, subtopic links, related items, FAQ sections + Cluster Hub Pages page/post Comprehensive guides, supporting topic sections, product roundups + ------------------------ ----------------------- -------------------------------------------------------------------- + +**4.2 Type-Specific Writing Intelligence** + +Each content type has dedicated prompt templates that guide AI +generation. Product pages automatically include features/benefits +sections, specification tables, comparisons to alternatives, and product +schema placeholders. Service pages include process step sections, +outcome descriptions, and location-specific content when applicable. +Cluster hub pages are structured as comprehensive guides with sections +per supporting topic and internal linking placeholders. + +**4.3 Content Configuration** + +Users control content generation through configurable settings: word +count range (500 to 5,000+ words), tone and style preferences, custom +prompt appendices, keyword density targets, heading structure +requirements, and image placement preferences. These settings apply +globally or per-site, with per-task overrides available for fine-grained +control. + +**4.4 AI Image Generation** + +Every piece of content can include AI-generated featured images and +in-article images. The system supports multiple quality tiers (basic, +quality, premium) and multiple AI providers (DALL-E 2/3, Runware/Flux). +Image prompts are extracted from content context by AI, and generated +images are associated with their content for seamless WordPress +publishing. + +**5. Internal Linking Engine** + +The Linker module provides SAG-aware, deterministic internal linking +that transforms isolated content into a connected authority network. +Unlike generic linking tools that suggest links based on keyword +similarity, IGNY8's linker understands the architectural relationships +between every page in the SAG blueprint. + +**5.1 Seven Link Relationship Types** + + ---------- ---------------------------------------------- ------------------------------------------------------------------------------------------- + **Type** **Relationship** **Rule** + Type 1 Vertical Upward (Supporting → Hub) Every supporting article links to its cluster hub. Mandatory, exactly 1 link per article. + Type 2 Vertical Downward (Hub → Supporting) Every hub page links to all its published supporting content via structured sections. + Type 3 Horizontal Sibling (Supporting ↔ Supporting) Within-cluster links where topically relevant. Maximum 2 per article. + Type 4 Cross-Cluster (Hub ↔ Hub) Hubs sharing an attribute value are cross-linked. Maximum 2 per hub. + Type 5 Taxonomy Contextual (Term → Hubs) Each attribute term page links to every cluster hub using that attribute value. + Type 6 Breadcrumb Structural Navigational breadcrumbs on every page. Not counted toward link density. + Type 7 Related Content (Cross-Cluster) 2-3 semantically related links in a "Related Reading" section. Lowest priority. + ---------- ---------------------------------------------- ------------------------------------------------------------------------------------------- + +**5.2 Authority Flow Architecture** + +External backlink authority enters through hub pages and the homepage, +then distributes through the SAG internal linking structure to all other +pages. This creates the SAG compounding effect: pages without any direct +backlinks begin ranking through inherited authority. The system tracks +link coverage scores per cluster and provides a visual site link map +showing clusters as nodes and links as edges. + +**5.3 Link Generation & Injection** + +Links are generated automatically as content is published. The system +loads blueprint context, generates required link records per the seven +type rules, and injects link HTML into content before it enters the +review queue. Link anchor text is varied using cluster keywords, hub +page titles, and natural descriptive phrases to avoid over-optimization. + +**5.4 Link Audit System** + +Automated weekly link audits produce health scores covering total links, +missing mandatory links, broken links, orphan content, and link density +per cluster. Audit history is maintained as snapshots for trend +analysis. + +**6. External Backlink Campaign Engine** + +IGNY8 automates external backlink campaign planning, execution tracking, +and ROI measurement. The system takes a SAG blueprint and a country +market profile, then generates a complete campaign plan with monthly +targets, budget allocation, anchor text strategies, and quality scoring. + +**6.1 Page Tier System** + +Every page in the SAG blueprint is automatically classified into one of +five tiers based on its role and commercial value: + + ---------- -------------------------------------------- -------------------- ----------------------- + **Tier** **Page Type** **Backlinks/Page** **Budget Allocation** + T1 Homepage 10-30 12-16% + T2 Top Pillar/Category Hub Pages 5-15 35-45% + T3 Money Pages / Remaining Hubs 3-10 25-35% + T4 Supporting Blog Posts 1-4 10-18% + T5 Authority Magnets (studies, tools, guides) 2-6 5-10% + ---------- -------------------------------------------- -------------------- ----------------------- + +**6.2 Country Market Profiles** + +Campaign generation is calibrated per target market. IGNY8 includes +detailed profiles for four countries --- Pakistan, UK, Canada, and USA +--- each with distinct parameters for competition levels, DR targets, +budget ranges, link velocity curves, anchor text distributions, and +quality thresholds. The framework supports adding new country profiles +without code changes. + + ------------- -------------- ------------------ ---------------------- ----------------- + **Country** **Timeline** **Budget Range** **Tipping Point DR** **Competition** + Pakistan 8 months \$2,000-\$5,000 DR 25-30 Easiest + Canada 12 months \$3,000-\$7,000 DR 35-40 Medium + UK 14 months \$3,000-\$9,000 DR 35-40 Medium-High + USA 18 months \$5,000-\$13,000 DR 40-45 Highest + ------------- -------------- ------------------ ---------------------- ----------------- + +**6.3 FatGrid Marketplace Integration** + +IGNY8 connects to the FatGrid API to provide real-time publisher +discovery, pricing comparison across 15+ backlink marketplaces, and bulk +domain lookup capabilities. Users can search for guest post +opportunities filtered by country, niche, DR range, and budget, with +results showing the best available price across all aggregated +marketplaces including Collaborator, PRNews.io, Adsy, WhitePress, +Bazoom, and others. + +**6.4 Premium PR Distribution** + +For tier-1 media placements beyond standard guest posts, IGNY8 +integrates with PR distribution networks including PRNews.io (100K+ +outlets, API access), EIN Presswire (budget PR starting at +\$99/release), and Linking News (white-label reports). PR placements on +outlets like Yahoo Finance, Bloomberg, and Fox News are available +through managed service tiers. + +**6.5 Authority Tipping Point Detection** + +IGNY8's key differentiator in backlink management is automated tipping +point detection --- the ability to identify exactly when the SAG +compounding effect has activated. The system cross-references backlink +data with Google Search Console metrics to detect when pages without any +direct backlinks begin ranking through inherited authority. +Country-specific DR thresholds trigger notifications when three or more +indicators simultaneously pass their threshold, recommending a shift +from link velocity to content creation. + +**6.6 Campaign KPI Dashboard** + +Monthly KPI snapshots track 18+ metrics including Domain Rating, +referring domains, keyword positions across rank bands (Top 10/20/50), +organic traffic, impressions, CTR, cost per link, pages ranking without +backlinks, and dead/lost link rates. Data sources include Ahrefs API (DR +tracking, competitor analysis, lost links), Google Search Console API +(traffic, keywords, indexing status), and internal SAGBacklink records. + +**7. Taxonomy & Term Content Management** + +In SAG architecture, every attribute becomes a WordPress custom +taxonomy, and every attribute value becomes a taxonomy term with its own +SEO-optimized landing page. IGNY8 manages the complete lifecycle of +taxonomy creation, term content generation, and synchronization with +WordPress. + +**7.1 Taxonomy Creation Flow** + +When a SAG blueprint is confirmed, the system generates a taxonomy plan +mapping each attribute to a WordPress taxonomy. The IGNY8 Bridge Plugin +receives this plan and creates the taxonomies and terms on the WordPress +site. Each term gets a rich landing page with an introduction, topical +definition, key subtopics with internal link placeholders, related +items, and an FAQ section. + +**7.2 Term Landing Pages** + +Term landing pages are not simple archive listings. They are full SEO +content pages featuring a hero section with H1, description, and +breadcrumbs; rich editorial content generated by AI; child term +navigation grids; related cluster hub links (Type 5 taxonomy contextual +links); and FAQ sections with FAQ schema markup. These pages serve as +the dimensional connecting layer of the SAG grid, linking to every +cluster hub that uses that attribute value. + +**7.3 Taxonomy Sync** + +Bidirectional synchronization keeps IGNY8 and WordPress in alignment. +The platform pushes taxonomy structures and term content to WordPress, +while the plugin reports back on sync status, term counts, and content +publication state. Sync status is tracked per attribute with states of +pending, synced, or failed. + +**8. Content Optimizer** + +The Optimizer module analyzes and enhances content quality through +cluster-aware scoring, SEO analysis, and AI-powered content improvement. +It operates on both newly generated content and existing published +pages. + +**8.1 Optimization Capabilities** + +- Cluster matching: Analyzes content against cluster keyword sets and + provides coverage scores + +- Content rewrite: Rebuilds structure to match search intent and + cluster focus + +- Missing section injection: Adds FAQs, comparisons, benefits, and use + case sections + +- Tone normalization: Aligns content with site-wide prompt settings + +- SEO enhancement: Meta title/description refresh, heading structure + refinement + +- Internal link opportunities: Identifies and hands off to the Linker + module + +- Schema generation: Produces appropriate structured data based on + content type + +**8.2 Optimization Workflow** + +The optimizer works in phases: analysis and scoring of existing content, +cluster mapping suggestions with confidence scoring, content rewrite +with structural improvements, and SEO metadata refresh. Users control +whether optimizations are auto-applied or require manual review through +site-level settings. + +**9. Google Search Console Integration** + +IGNY8 integrates directly with Google Search Console through OAuth 2.0 +to provide real-time search performance data, automated indexing +submission, and comprehensive analytics within the platform. + +**9.1 Core Capabilities** + +- OAuth 2.0 authentication with property selection and multi-site + support + +- URL Inspection API integration for submitting new pages for indexing + +- Automated auto-indexing: Published content is submitted to Google + automatically + +- Search analytics: Impressions, clicks, CTR, and average position + data per page and query + +- Index status tracking with coverage state monitoring + +- Re-inspection scheduling for content that fails initial indexing + +**9.2 Integration with Other Modules** + +GSC data feeds multiple other IGNY8 modules. The Campaign KPI dashboard +uses organic traffic and keyword position data. The Blueprint health +score incorporates indexed page counts and crawl status. Tipping point +detection relies on GSC data to identify pages ranking without +backlinks. The Optimizer uses search performance data to prioritize +which content to enhance next. + +**9.3 WordPress Plugin Integration** + +The IGNY8 Bridge Plugin receives index status updates from the platform +and displays them in the WordPress admin. A dedicated metabox on the +post edit screen shows the current index status for each piece of +content, and the content list view includes an index status column for +at-a-glance monitoring. + +**10. Rich Schema & SERP Enhancement** + +The Rich Schema module automatically injects structured data markup and +on-page SEO elements into content without rewriting the core body text. +It operates in two modes: new content generation (elements injected +during the pipeline) and retroactive enhancement (existing pages +scanned, analyzed, and enriched). + +**10.1 Supported Schema Types** + + ---------------------------- -------------- --------------------------------------------------------- + **Schema Type** **Priority** **SERP Impact** + FAQ Schema (FAQPage) High Expandable Q&A accordion doubles/triples listing height + HowTo Schema High Step-by-step cards with images; captures position zero + Review / AggregateRating High Star ratings in SERP; drives purchase clicks + Pros & Cons High Structured pros/cons list with visual indicators + Article Schema High Enhanced listing with author, date, publisher + Author / Person Schema High E-E-A-T signal; author expertise display + Video Schema (VideoObject) Medium Video thumbnail in SERP with duration + Breadcrumb Schema Medium Clean navigational path replaces raw URL + Speakable Schema Low Positions content for voice search / Google Assistant + SiteLinks Search Box Low Homepage search box in branded SERP results + ---------------------------- -------------- --------------------------------------------------------- + +**10.2 Non-Schema SERP Elements** + +- TL;DR / Key Takeaways Box: 3-4 sentence summary targeted at AI + Overviews and featured snippets + +- Table of Contents with Jump Links: Auto-generated from H2/H3 + structure; Google displays as sitelinks + +- Comparison Tables (HTML): Structured tables that Google pulls into + rich table results + +- Definition Blocks: Clean 2-3 sentence definitions for "What is X?" + featured snippets + +- PAA Subheadings: People Also Ask-style subheadings within content + +**10.3 Content Type to Schema Mapping** + +The module uses an intelligent mapping matrix that automatically +determines which schemas and elements apply to each content type. Blog +articles receive Article Schema, FAQ, TL;DR, TOC, and definition blocks. +Product reviews add Review/Rating and Pros & Cons. Tutorial content +triggers HowTo Schema. Service pages get local business schema when +location-based. Every piece of content receives breadcrumb schema +universally. + +**10.4 Retroactive Enhancement Engine** + +For existing published sites, the retroactive engine scans all pages, +classifies content types, identifies missing schema opportunities, +generates the appropriate markup, and pushes it to WordPress via the +Bridge Plugin --- all without modifying the original content. A review +dashboard allows bulk approval before injection, and automated Google +Rich Results Test validation ensures everything is eligible before +deployment. + +**10.5 Validation Pipeline** + +Every generated schema passes three validation steps: structural +validation (JSON-LD syntax and schema.org conformance), Google Rich +Results Test (automated API call for eligibility verification), and live +monitoring (GSC integration tracks schema errors and triggers alerts in +the IGNY8 dashboard). + +**11. Socializer --- Multi-Platform Social Publishing** + +The Socializer module adapts published content into platform-specific +social posts and manages distribution across five major social networks: +LinkedIn, Twitter/X, Facebook, Instagram, and TikTok. + +**11.1 Content Adaptation** + +AI adapts each piece of content for platform-specific requirements: + + -------------- ---------------------------- ----------------------- ---------------- + **Platform** **Format** **Character Limit** **Image Spec** + LinkedIn Professional tone 1,300 chars 1200x627 + Twitter/X Punchy, thread option 280 chars 1600x900 + Facebook Conversational \~500 chars 1200x630 + Instagram Visual-first + hashtags 2,200 chars + 30 tags 1080x1080 + TikTok Gen-Z tone, trending hooks Platform-specific 1080x1920 + -------------- ---------------------------- ----------------------- ---------------- + +**11.2 Social Post Types** + +- Announcement: New article/product/service posts with direct links + +- Highlights: Key takeaways and call-to-action posts + +- Quote Cards: Single insight with branded visual template + +- FAQ Snippets: For services or product categories + +- Twitter Threads: Multi-tweet deep dives on topic content + +**11.3 Social Calendar & Scheduling** + +A drag-and-drop social calendar provides visual scheduling with +best-time slot optimization, frequency caps per platform, and queue +management. Auto-publish triggers on content approval or scheduled +publication. Engagement metrics (clicks, likes, shares, comments, +impressions) are fetched every 6 hours for analytics dashboards. + +**11.4 OAuth Platform Connections** + +Each social platform connects through OAuth 2.0 with token refresh +management. Rate limits are handled with per-destination cooldowns +(minimum 4-6 hours between posts to the same page/group), API usage +tracking with alerts, and time-spread queuing to prevent burst +publishing. + +**12. Video Content Creator** + +The Video Creator module converts published articles into video content +and publishes to YouTube, Instagram Reels, TikTok, and YouTube Shorts. +The system handles script generation, voiceover production, visual asset +assembly, and multi-platform distribution. + +**12.1 Video Types** + + ------------- ---------------- ----------------------- ------------------ + **Format** **Duration** **Platform** **Aspect Ratio** + Short Form 30-90 seconds TikTok, Reels, Shorts 9:16 (1080x1920) + Medium Form 60-180 seconds TikTok, Reels 9:16 (1080x1920) + Long Form 5-15 minutes YouTube 16:9 (1920x1080) + ------------- ---------------- ----------------------- ------------------ + +**12.2 Production Pipeline** + +- Script Generation: AI converts article content into narrated video + scripts with section breakdowns + +- Voice Selection: Multiple TTS providers (OpenAI standard/HD, + ElevenLabs premium, Coqui self-hosted) with voice preview + +- Visual Asset Assembly: Stock video/images from Pexels and Pixabay, + AI-generated visuals, text overlays, and transitions + +- Subtitle Generation: Automated subtitle creation for accessibility + and engagement + +- Thumbnail Generation: AI-generated thumbnails optimized per platform + +- Video Composition: FFmpeg + MoviePy rendering on a dedicated Celery + queue + +- Video SEO: Title, description, tags, and metadata optimized per + platform + +**12.3 Script Editor** + +A section-by-section script editor allows users to review and modify +AI-generated scripts before rendering. Each section includes editable +text, visual cue suggestions, timing markers, and voice selection. +Scripts can be approved as-is for automated rendering or fine-tuned for +specific messaging. + +**13. WordPress Ecosystem** + +IGNY8's WordPress ecosystem comprises three independent but +complementary deliverables: the IGNY8 SEO Plugin, a Companion Theme, and +a Toolkit Plugin. Each piece works independently; together they create +the full SAG-optimized WordPress experience. + +**13.1 IGNY8 SEO Plugin** + +A comprehensive SEO plugin designed to replace Yoast, RankMath, and +AIOSEO. The plugin operates in two modes: standalone (free, full SEO +capabilities for any WordPress site) and connected (premium features via +IGNY8 SaaS subscription). It works with any WordPress theme. + +**Free SEO Features** + +- Focus keyword per post/page with SERP preview + +- SEO title and meta description management + +- Canonical URL management and robots meta control + +- Content analysis: keyword density, headings, readability, internal + links + +- Title tag template system with site-wide patterns + +- Breadcrumb generation with schema markup + +- XML sitemap generation + +- 301/302 redirect management with 404 monitoring + +- OG tags and social meta for all platforms + +- Google Analytics and Tag Manager integration + +- Webmaster verification codes + +- SMTP mail delivery override + +**Connected Premium Features** + +- Multi-keyword optimization from SAG cluster data + +- Cluster-aware content scoring ("this post covers 60% of its + cluster's targets") + +- Auto-suggest missing headings based on cluster keyword gaps + +- Content freshness scoring and update recommendations + +- Full SAG gap analysis and architecture blueprint visualization + +- SAG-aware automatic internal link suggestions and bulk insertion + +- Content sync from IGNY8 platform to WordPress + +- SAG structure sync: taxonomy creation from blueprint + +- Auto-post to social platforms on WordPress publish + +- Google Search Console integration with indexing and analytics + +**Site Intelligence** + +The plugin includes a site intelligence module providing orphan page +detection, thin content identification, empty taxonomy term listing, +duplicate title/meta detection, cannibalization warnings, and internal +link analysis. In connected mode, this extends to full SAG gap analysis +with cluster health scores and competitor gap comparison. + +**13.2 Companion Theme** + +A premium WordPress theme providing the physical infrastructure for +SAG-optimized sites. The theme handles all presentation, structure, and +display concerns while reading intelligence data from the IGNY8 plugin. + +**Custom Post Types (7)** + +- Services, Portfolio/Case Studies, Landing Pages, Team Members, + Testimonials, FAQs, Documentation + +**Custom Taxonomies (9)** + +- Service Category, Service Area, Service Attribute, Cluster, + Portfolio Category, Portfolio Tag, FAQ Category, Documentation + Category, Topic Tag + +**Template System** + +- SAG-optimized term landing page templates with rich content display + +- Section-based landing page builder with 15 section types and 8 + presets + +- 50+ block patterns organized by type (heroes, features, social + proof, CTAs, pricing) + +- 5 site-type starter templates: Blog, SaaS, E-Commerce, Corporate, + Portfolio + +- Full WooCommerce template overrides: shop, product, cart, checkout, + account + +- Interlinking display components: related content, cluster + navigation, attribute browsing + +**13.3 Toolkit Plugin** + +A companion plugin handling site infrastructure that the theme and SEO +plugin do not cover: + + ------------- -------------------------------------------------------------------------------------------------------- ------------------------------- + **Module** **Capabilities** **Replaces** + Performance Page caching, asset optimization, image optimization, WebP conversion, critical CSS, HTML minification WP Rocket, LiteSpeed Cache + Forms Form builder, submissions, notifications, conditional logic, anti-spam Contact Form 7, Gravity Forms + Security Login protection, firewall rules, hardening, security headers, audit log Wordfence, Sucuri + SMTP Mail delivery override, email log, test email WP Mail SMTP + WooCommerce Quick view, wishlist, AJAX cart, product filters, enhanced gallery 5-6 separate Woo plugins + ------------- -------------------------------------------------------------------------------------------------------- ------------------------------- + +**14. AI Engine & Model Architecture** + +IGNY8's AI engine is provider-agnostic, supporting multiple AI services +through a unified registry pattern. This architecture ensures the +platform is never locked into a single provider and can leverage the +best model for each specific task. + +**14.1 Provider Registry** + +AI providers are registered through the IntegrationProvider model with +API keys stored in the database (not environment variables). Each +provider supports multiple model configurations through the +AIModelConfig model, which defines per-model pricing (tokens per credit, +credits per image), capabilities, and context windows. + +**14.2 Supported Providers & Uses** + + ---------------- --------------------------------- ------------------------------------------------------------------- + **Provider** **Models** **Used For** + OpenAI GPT-4o, GPT-4o-mini, DALL-E 2/3 Content generation, clustering, idea generation, image generation + Anthropic Claude (Opus, Sonnet) Content generation, analysis, schema generation + ElevenLabs Voice models Premium TTS voiceover for video content + Coqui TTS Self-hosted models Budget TTS voiceover (optional GPU server) + Runware/Flux Image models Alternative image generation (quality/premium tiers) + Pexels/Pixabay Stock media Video visual assets + ---------------- --------------------------------- ------------------------------------------------------------------- + +**14.3 AI Functions Registry** + +Every AI operation in IGNY8 is registered as a named function in the AI +engine. This includes auto\_cluster, generate\_ideas, generate\_content, +generate\_image\_prompts, generate\_images, optimize\_content, +adapt\_social\_content, generate\_hashtags, generate\_video\_script, +generate\_schema\_elements, generate\_keywords, and +retroactive\_analyzer. Each function has defined input/output contracts +and credit costs. + +**14.4 Custom Prompt System** + +Users can customize AI behavior through the Thinker module (admin only). +Prompts are stored in the PromptTemplate model with defaults for every +AI function. Users can override any template with custom instructions, +append additional context, and set tone/style preferences that propagate +across all content generation. + +**15. Credit System & Billing** + +**15.1 Subscription Plans** + + ---------- ----------- ----------- ----------- ------------------- + **Plan** **Price** **Sites** **Users** **Credits/Month** + Free \$0 1 1 100 + Starter \$49/mo 3 3 1,000 + Growth \$149/mo 10 10 5,000 + Scale \$349/mo Unlimited Unlimited 25,000 + ---------- ----------- ----------- ----------- ------------------- + +**15.2 Credit Economy** + +Credits serve as the universal throttle across all IGNY8 features. Every +AI operation deducts credits through the CreditService, which validates +balance before execution and logs all transactions. + + ---------------------------------------- -------------------------------- + **Operation** **Credit Cost** + Content generation 5 per 100 words + Content optimization (rewrite) 5 per 100 words + Content analysis for optimization 2 per page + Schema element generation 2 per page + Retroactive scan + enhancement 1 per scan + 2 per enhancement + Social content adaptation (1 platform) 1 + Hashtag generation 0.5 + Twitter thread generation 2 + Social image generation 3-10 + Full social suite (5 platforms) 15-25 per content item + Video script generation 5 + TTS voiceover (standard) 10 per minute + TTS voiceover (HD) 20 per minute + TTS voiceover (self-hosted) 2 per minute + Video visual assets 15-50 per video + Video composition (render) 5 per render + Full short-form video \~40-80 total + Full long-form video \~100-250 total + ---------------------------------------- -------------------------------- + +**15.3 Payment Processing** + +IGNY8 supports Stripe and PayPal for payment processing, with manual +payment methods available as an interim solution. The billing system +handles subscription management, plan upgrades/downgrades, transaction +history, and invoice generation. + +**15.4 Usage Tracking** + +Real-time usage dashboards show credit balance, monthly usage versus +plan limits, transaction history, and API activity logs. Hard limits on +sites, users, keywords, and clusters are enforced per plan, while +monthly limits on ideas, words, and images reset on billing cycle. + +**16. Managed Services & Business Layer** + +**16.1 Managed Service Tiers** + +IGNY8 offers managed service add-ons where the Alorig team operates the +platform on behalf of clients. These are purchased per site, layered on +top of existing subscription plans. + + -------------- ------------------ ------------------- ---------------------------------------------------------------------------------------------------------------------------------------------------- + **Tier** **Price** **Content** **Includes** + Managed Lite \$100/site/month 10 articles/month SAG blueprint generation, automation configuration, WordPress publishing, basic optimization, monthly report + Managed Pro \$399/site/month 30 articles/month Full SAG build, all automation stages, backlink campaign management, social posting, retroactive schema, weekly reports, dedicated account manager + -------------- ------------------ ------------------- ---------------------------------------------------------------------------------------------------------------------------------------------------- + +**16.2 Backlink Service Packages** + +Backlink services are available in both self-service (client uses IGNY8 +intelligence and executes themselves) and managed modes (Alorig team +handles execution): + + ------------ --------------------------- ------------------ ------------ + **Tier** **Link Quality** **Client Price** **Margin** + Basic Guest Post DR 30-50 \$150-\$300 3-5x + Standard Guest Post DR 50-70 \$400-\$800 2-3x + Premium Guest Post DR 70+ \$1,500-\$5,000 2-3x + PR Basic 300+ outlets distribution \$500-\$1,500 3-5x + PR Premium Yahoo/Bloomberg/Fox \$2,000-\$15,000 3-4x + ------------ --------------------------- ------------------ ------------ + +**16.3 White-Label Reporting** + +Managed service clients receive branded reports with customizable +templates, client-facing dashboards, and automated delivery schedules. +Reports include content production summaries, keyword ranking progress, +backlink campaign status, and organic traffic trends. All reports can be +white-labeled for agency resale. + +**16.4 Client Onboarding Automation** + +Automated onboarding workflows handle site connection, WordPress plugin +installation guidance, SAG blueprint generation, automation +configuration, and initial content scheduling. The system tracks +onboarding progress and sends notifications at each milestone. + +**17. Multi-Tenant Architecture & Security** + +**17.1 Data Isolation** + +IGNY8 implements complete multi-tenant separation at the database level +via AccountContextMiddleware. Every query is scoped to the authenticated +account, ensuring no data leakage between tenants. Site-level isolation +further segments data within accounts. + +**17.2 Authentication & Access Control** + +- JWT token authentication with Redis session management + +- Data encrypted at rest and in transit + +- Role-based permissions: Admin (full access + billing + team), + Manager (content + billing view), Editor (AI content, clusters, + tasks), Viewer (read-only) + +- Secure cookie handling with session integrity checks + +- Plugin API key authentication with signed distribution URLs and + SHA256 checksums + +**17.3 Module Access Control** + +Feature access is controlled through a two-level flag system. +GlobalModuleSettings control platform-wide availability, while +ModuleEnableSettings provide per-account toggles. When a module is +disabled, its sidebar entry is hidden, its API endpoints return 403, and +its automation stages are skipped. Feature flags control activation of +all major modules: SAG, Linker, Optimizer, GSC, Schema, Socializer, +Video Creator, and Campaign. + +**18. Dashboard & User Interface** + +**18.1 Dashboard Widgets** + +- Workflow Pipeline Widget: Visual representation of content flowing + through all stages + +- AI Operations Widget: Real-time AI task monitoring and completion + rates + +- Recent Activity Widget: Latest actions across all modules + +- Content Velocity Widget: Content production metrics and trends + +- Automation Status Widget: Active pipeline status with controls + +- SAG Health Widget: Blueprint health score gauge with cluster + completion bars + +- Blueprint Progress Widget: Per-cluster content published versus + planned + +**18.2 Navigation Structure** + +The platform organizes around four main sections: + +- Setup: Add Keywords, Content Settings, Sites, Thinker (admin) + +- Workflow: Planner, Writer, Automation, Blueprint, Linker, Campaigns, + Search Console, Optimizer, Socializer, Video Creator + +- Account: Settings, Plans & Billing, Usage, AI Models (admin) + +- Help: Documentation and guides + +**18.3 Notification System** + +A real-time notification system delivers alerts for content generation +completion, automation run results, credit warnings, indexing status +changes, tipping point detection, and team activity. Notifications +appear in the header dropdown and can trigger email alerts based on user +preferences. + +**19. Industry & Sector Coverage** + +IGNY8's SAG library provides pre-built sector attribute frameworks for a +comprehensive range of industries. Each framework includes predefined +attributes, suggested values, keyword generation templates, and cluster +formation patterns, giving users in supported industries a significant +head start in building their site architecture. + +The library spans 45+ industries organized into sectors with +approximately 25 clusters per sector, 15 keywords per cluster, and 6 +attributes per sector. Industries range from Healthcare & Medical to +Technology, Education, Finance, Real Estate, Legal, Automotive, Food & +Beverage, Home Services, Pets & Animals, Beauty & Personal Care, Fitness +& Wellness, Travel & Tourism, and many more. + +New sector templates can be generated using the SAG Niche Definition +Process --- a documented methodology for AI-assisted niche generation. +When provided to an AI assistant, the process document contains all the +context, rules, terminology, constraints, and examples needed to +generate new niche definitions at consistent quality. This means the +library continuously expands as new sectors are created for client +engagements. + +**20. Plugin Distribution & Updates** + +IGNY8 includes a complete plugin distribution system for delivering the +WordPress plugin and theme to users: + +- Signed download URLs with expiration timestamps for security + +- SHA256 checksums for file integrity verification + +- Rate-limited download endpoints to prevent abuse + +- Automatic update checking from WordPress admin + +- Version management with changelog tracking + +- WordPress.org compliance for the free tier (readme.txt, screenshots, + FAQ, internationalization) + +- Premium distribution through the Alorig site with license key + validation + +**21. Performance Standards** + +The WordPress ecosystem (theme + plugins) is engineered to meet strict +performance targets ensuring zero frontend impact when features are not +actively outputting content: + + -------------------------- ----------------- + **Metric** **Target** + First Contentful Paint \< 1.0 second + Largest Contentful Paint \< 1.5 seconds + Total Blocking Time \< 50ms + Cumulative Layout Shift \< 0.05 + Page Weight (uncached) \< 200KB + PageSpeed Score (Mobile) 95+ + Theme CSS Total \< 35KB gzipped + Frontend JS Total \< 15KB gzipped + -------------------------- ----------------- + +Conditional asset loading ensures CSS and JavaScript are only delivered +on pages where features are active. The theme uses vanilla ES6+ +JavaScript with zero jQuery on the frontend. + +**22. Deployment & Reference Sites** + +IGNY8 is deployed and actively operational across multiple production +sites, each serving as a reference implementation of the SAG methodology +and platform capabilities: + +- MassagerSmart.com --- Primary SAG reference implementation + (e-commerce, personal massagers) + +- homeg8.com --- Home services vertical + +- Alorig.com --- Agency site and platform marketing + +- SalmanSadiq.com --- Personal brand and thought leadership + +- AIAI.pk --- AI industry content + +- Client portfolio including Banner Printing (UK), Aterna Advisors + (CA), Seva Mattress, VAINO, African Fair Trade Society, Halal VPN, + and others + +**IGNY8 --- Infinity Growth Engine** + +*From Keywords to Authority. Automated.* + +© 2026 Alorig Systems. All rights reserved.