# Apex Admins — SEO Architecture (Apply SEO System)

**Version:** 2.0  
**Date:** 2026-07-22  
**Source:** Combined Rank Math Pro + Yoast SEO Premium feature set

---

## 1. Overview

The Apex SEO System is a first-class Laravel module implementing WordPress-grade SEO tooling:

- Per-content SEO editor with SERP/social previews, focus keywords, synonyms, schema, and live audit scores
- Technical SEO: sitemaps (incl. news/video), robots.txt, llms.txt, IndexNow, AI bot blocking
- Redirects Pro: regex, 410, CSV, auto slug redirects, 404 monitor
- Workouts: orphan, cornerstone, stale content
- Keyword rank tracker + bulk CSV tools

Trigger for re-applying on future projects: **Apply SEO System** (Cursor skill `apply-seo-system`).

---

## 2. Data model

### `seo_meta`
title, description, keywords, focus_keyword, secondary_keywords, synonyms, is_cornerstone, breadcrumb_title, schema_type, OG/Twitter fields, canonical, robots, include_in_sitemap, is_news, video_url, video_thumbnail, schema_markup, advanced

### Other tables
- `seo_audits` — score + parameter JSON
- `seo_404_logs` — 404 monitor
- `seo_keywords` / `seo_keyword_rankings` — rank tracker
- `seo_schema_templates` — reusable schema templates
- `sitemap_entries` — inventory
- `redirects` — is_regex, notes, auto_generated, created_by, status 410

Settings groups: `seo_defaults` (robots_txt), `seo_system` (templates, AI bots, llms, report branding).

---

## 3. Public runtime

| Endpoint | Purpose |
|----------|---------|
| `/sitemap.xml` | Sitemap index |
| `/sitemaps/{type}.xml` | Child sitemaps |
| `/robots.txt` | Robots + optional AI bot blocks |
| `/llms.txt` | LLM site map |

Controllers merge stored `seo_meta` via `SeoMetaResolver` / `ResolvesPublicSeo::seo($overrides, $model)`.

Middleware: `HandleRedirects` (exact/regex/410), `LogNotFoundRequests`.

---

## 4. Admin

- Hub: `/admin/seo?tab=overview|settings|audits|404|keywords|bulk|workouts|reports`
- Content forms: `admin.partials.seo-fields` (full editor) + `x-admin.seo-panel`
- Redirects: `/admin/redirects` + CSV import/export

---

## 5. Audit engine

Weighted 0–100 across title, meta, keywords (with synonym/word-form variants), headings, content/readability, links (live HEAD checks), images, schema, URL, social, technical, local NAP.

Triggered on `syncSeoMeta`, manual recalculate, and bulk audit-all.

---

## 6. Env connectors

```
SEO_AI_API_KEY=
SEO_AI_API_URL=
SEO_AI_MODEL=
SEO_INDEXNOW_KEY=
SEO_GSC_ENABLED=
SEO_DEFAULT_LOCALE=en-AU
```

---

## 7. Feature checklist

See Cursor skill `~/.cursor/skills/apply-seo-system/features.md` for the full Rank Math ∪ Yoast inventory.