# JTG Systems Enterprise SEO Suite - Full Technical Specification

> Comprehensive architectural breakdown, diagnostic rule catalog, API contracts, and Generative Engine Optimization (GEO) standards for JTG Systems SEO Suite.

## Overview
JTG Systems Enterprise SEO Suite is a full-stack search engine optimization, web performance auditing, and AI citation readiness platform. It empowers business owners, webmasters, and SEO professionals to audit web pages, simulate multi-engine search snippets, generate Schema.org JSON-LD entities, evaluate Google Core Web Vitals, and submit real-time indexing pings.

## Feature Modules

### 1. SEO Doctor Enterprise Auditor
- **5-Pillar Scoring System**: Evaluates pages across 5 distinct diagnostic categories:
  1. Meta & Social Tags (Titles, Descriptions, Open Graph, Twitter Cards)
  2. Content Depth (Word count, Text-to-HTML ratio, Heading hierarchy H1-H6)
  3. Technical SEO (Canonical tags, Robots directives, Sitemap integrity, Favicon)
  4. Security Headers (HSTS, Content Security Policy, X-Frame-Options, X-Content-Type-Options)
  5. Performance & Network (Response speed MS, HTML payload size KB)
- **Multi-Mode Auditing**: Supports Single Webpage scanning, XML Sitemap crawling, Bulk URL batch auditing, and Raw HTML source code inspection.
- **Report Generation**: Exports white-label PDF executive reports, downloadable HTML audits, and structured Markdown white-papers.

### 2. Live Google Lighthouse & Core Web Vitals
- **Google PageSpeed Insights API Integration**: Queries real-time performance, accessibility, best practices, and SEO scores directly from Google's diagnostic infrastructure.
- **Core Web Vitals Telemetry**:
  - **LCP (Largest Contentful Paint)**: Good (< 2.5s)
  - **FCP (First Contentful Paint)**: Good (< 1.8s)
  - **CLS (Cumulative Layout Shift)**: Good (< 0.1)
  - **TTFB (Time to First Byte / Server Latency)**: Good (< 800ms)
  - **TBT (Total Blocking Time)**: Good (< 200ms)
  - **INP (Interaction to Next Paint)**: Good (< 200ms)
- **Dual-Device Analysis**: Toggle between Mobile (Emulated Moto G4) and Desktop viewports.

### 3. GEO & AI Search Engine Optimizer
- **LLM Context Standards**: Verifies `/llms.txt` and `/llms-full.txt` compliance on target domains.
- **AI Crawler Access Verification**: Checks `robots.txt` permissions for top AI web crawlers:
  - `GPTBot` & `ChatGPT-User` (OpenAI)
  - `ClaudeBot` & `Claude-Web` (Anthropic)
  - `PerplexityBot` (Perplexity AI)
  - `Google-Extended` (Google Gemini & AI Overviews)
  - `Applebot-Extended` (Apple Intelligence)
  - `Bytespider` (ByteDance / TikTok)
- **Schema.org Entity Graph**: Validates JSON-LD structured data for `LocalBusiness`, `Organization`, `FAQPage`, `Service`, and `Product`.

### 4. Multi-Engine SERP Snippet Simulator
- Real-time preview renderings across 4 major search engine algorithms: Google Search, Bing, Yandex, and Yahoo.
- Supports both Desktop and Mobile layout constraints.
- Identifies title truncation (> 60 characters) and description clipping (> 160 characters).

### 5. Schema.org JSON-LD Generator
- Visual interface for generating valid, copy-pasteable JSON-LD script tags.
- Includes pre-built templates for Local IT Repair, Custom Software Development, Professional Services, E-commerce Products, and FAQ Accordions.

### 6. Indexing & XML-RPC Ping Engine
- Broadcasts instant update notifications to major search aggregators via IndexNow API and XML-RPC ping endpoints (Google, Bing, Yandex, Ping-o-Matic).

## API Endpoints

### `/api/audit.php` (or `/api/audit` in Dev Server)
- **Method**: GET
- **Query Parameter**: `url` (e.g. `https://jtgsystems.com`)
- **Response**: JSON object containing `originalUrl`, `finalUrl`, `statusCode`, `fetchTimeMs`, extracted `headers`, and raw `html`.
- **Protections**: SSRF protection preventing access to local loopbacks (`127.0.0.1`, `localhost`) and private RFC1918 IP ranges.

### `/api/auth.php` (or `/api/auth` in Dev Server)
- **Method**: POST
- **Payload**: `{ "username": "admin", "password": "Password123!" }`
- **Response**: JWT session token and authentication status.
- **Protections**: IP brute-force lockout enforcing a 15-minute ban after 5 consecutive failed login attempts.

## About JTG Systems
JTG Systems is an enterprise IT services, custom software development, and web solutions provider based in Welland, Ontario, Canada, servicing the entire Niagara region (St. Catharines, Niagara Falls, Welland, Pelham, Thorold).

- Website: https://jtgsystems.com
- Tools Portal: https://seo-tools.jtgsystems.com
- Phone: (905) 892-4555
- Address: 23 Sharon Ave, Welland, ON L3C 6V3, Canada