SEO/PBN System — Architecture & Roadmap

ROADMAP

Fazy implementacji

Od MVP do pełnej platformy — 22 fazy, 4 priorytety

MVP (Fazy 1-9)

Etap 2 (Fazy 6b-12b)

Zaawansowane (13-21)

Future (22)

FAZA 1

DB Schema + FastAPI + Aftermarket.pl

PostgreSQL 16 z pgvector, 49 tabel, Alembic migracje. FastAPI skeleton z async engine, Pydantic v2 schemas. Integracja Aftermarket.pl API (rejestracja domen, DNS, marketplace).

PostgreSQLFastAPIAlembicAftermarket API

FAZA 2

Hosting Provider APIs + Ansible

Integracja Hetzner Cloud, Vultr, DigitalOcean, AWS Lightsail (httpx direct). Ansible playbooks: LEMP setup, WP install, hardening, Cloudflare origin firewall. Dynamic inventory z DB.

HetznerVultrDOAnsible

FAZA 3

WordPress Automation

WP-CLI install + config. Randomizacja: 15-20 themes, plugin rotation (Yoast/RankMath/SEOPress), custom kolory/fonty. DirectAdmin/cPanel API dla shared hosting. Softaculous auto-install.

WP-CLIDirectAdmincPanel

FAZA 4

Cloudflare + DNS + Email

Cloudflare zones, DNS records CRUD, SSL strict, CDN config. Email Routing (forwarding rotation: 5-10 catch-all kont). Footprint: max 40% na CF, oddzielne konta, mix DNS providerów.

CloudflareDNSEmail Routing

FAZA 5

Expired Domain Hunter

5-level funnel: Discovery (Apify scraper) → Quick Filter (DataForSEO, Moz) → Wayback Analysis (AI Vision) → Deep Backlink Analysis (Majestic) → Scoring + Auto-bid. 90% automated.

DataForSEOMozMajesticWayback

FAZA 6

Content Pipeline

AI content generation: Claude Sonnet (draft) → Opus (humanization) → Gemini Flash (meta). Templates per niche×type×language. QA scoring (duplicate, readability, AI detection, SEO, GEO). Schema markup stack.

ClaudeGeminiGPTZeropgvector

FAZA 7

MainWP + Monitoring

MainWP REST API: bulk updates, content publishing, uptime monitoring. Plugin version tracking + WPScan vulnerability checks. Health checks: uptime, SSL, speed, index status. 3-level alerting.

MainWPWPScanUptimeRobot

FAZA 8

Link Management + Velocity

Link placement + verification. Velocity controller: max 2-3 linki/tydzień, anchor text randomization (branded 45%, naked 22%, generic 18%, partial 12%, exact 3%). Footprint scanner. Min 10 artykułów przed pierwszym linkiem.

Link VelocityAnchor OptimizerFootprint

FAZA 9

Frontend Dashboard (Next.js)

17 stron dashboardu. shadcn/ui + Tremor + TanStack Table. Real-time: native WebSocket + SSE. Auth.js + JWT. Orval auto-gen z FastAPI OpenAPI. Force-directed link network graph.

Next.jsshadcn/uiTremorTanStack

FAZA 6b

Content Repurposing

Artykuł → 6 formatów: tweet thread, LinkedIn post, Pinterest pin, YouTube Short script, newsletter digest, Reddit/Quora answer. Auto-scheduling via Buffer API. ~$0.03/artykuł.

Claude HaikuBuffer6 formatów

FAZA 8b

Internal Linking Engine

Auto-detect keyword overlap między artykułami na tym samym site. AI generuje contextual sentences z naturalnym anchor textem. Pillar↔cluster linking. Orphan page detection.

EmbeddingsAuto-linkOrphan detection

FAZA 9b

Scheduled Jobs Dashboard

Visibility layer for Taskiq: 15 recurring jobs (uptime, SSL, SEO metrics, domain discovery, content publish, etc.). Status grid, failure tracking, next run countdown.

TaskiqCronDashboard

FAZA 10

Multilingual PBN

15 z 50 stron multilingual (PL+EN+1-3 EU). Polylang Free (7 stron), WPML (5), TranslatePress (2), manual (1). Hybryda: AI generuje unikalne treści per język (nie tłumaczenie). hreflang via XML Sitemap.

PolylangWPMLhreflang

FAZA 11

Social + Newsletter

3+ platformy per site (FB/X/Pinterest). Auto-share via Buffer. Newsletter: Beehiiv/Mailchimp free tier. Lead magnets. Comment seeding (3-5 per post, różne style).

BufferBeehiivSocial

FAZA 12

Backup + Disaster Recovery

UpdraftPlus via MainWP. Remote: Cloudflare R2 ($0.015/GB). Daily DB + weekly full. 30/90 day retention. Monthly restore testing. Alert jeśli backup >48h stary.

UpdraftPlusR2Restore test

FAZA 12b

Redirects + Sitemaps

301 redirect management (expired domain URLs). Sitemap auto-generation, GSC submission, error monitoring. Redirect chain/loop detection.

301SitemapGSC API

FAZA 13-13b

Revenue + Lifecycle + Warming

ROI per site (revenue - cost). Lifecycle stages (seeding→growing→mature→declining→retired). Domain warming enforcement: min 10 artykułów + 30 dni + indexed przed link placement.

ROILifecycleWarming

FAZA 14-14b

Competitor Intel + Content Decay

Content gap analysis, position battles. Auto-detect articles losing rankings → queue refresh. Seasonal content planner. DataForSEO competitors_domain + domain_intersection.

Content gapAuto-refreshSeasonal

FAZA 15-15b

RBAC + Security Response

4 role (admin, seo_manager, content_editor, viewer). Audit log od dnia 1. Auto-detect: brute force, malware, defacement. Auto-heal: CF Under Attack Mode, backup restore, password rotation.

RBACAuditAuto-heal

FAZA 16

Topical Authority + SERP Features

Score 0-100 per site×niche. Track: featured snippets, PAA, AI Overviews. Alert: lost featured snippet. Opportunity: keyword has snippet, we rank top 5 but don't have it.

AuthoritySERPAI Overview

FAZA 17

Negative SEO + Disavow

Auto-detect toxic backlink spikes. Classify severity. Auto-generate disavow entries. Submit via GSC API. Monitor recovery.

DisavowGSCProtection

FAZA 18

Cannibalization Prevention v2

PBN vs Money Site check: PBN NIGDY nie może outranku money site. PBN vs PBN: deduplicate keyword targets. Auto-resolution: noindex, keyword change, consolidate.

CannibalizationnoindexWeekly scan

FAZA 19

API Rate Limiting + Circuit Breaker

Track usage per API (15+ APIs). Throttle at 10% remaining. Pause at 0%. Cost tracking per API. Dashboard: budget usage bars.

Rate limitCircuit breakerCost

FAZA 20-21

Algorithm Tracker + Portfolio Mgmt

Google core update impact analysis (before/after). Content performance attribution (which model/template wins). Money site budget allocation based on ROI. Seasonal planner.

Google UpdatesAttributionPortfolio

FAZA 22

SEM Integration (Google Ads)

Google Ads API integration. Landing page builder (Next.js SSG). A/B testing (CF Workers). Conversion tracking (GA4 + server-side GTM). ROAS optimization: organic strong → reduce PPC, organic weak → increase PPC. Shared keyword intelligence.

Google AdsA/B TestingCF WorkersROAS

UI/UX

Widoki panelu

Mockupy 17 stron dashboardu — dark theme, data-heavy

Sites Overview

Master grid z RAG status, sparklines, lifecycle, warming stage. Network Health Score. 50 stron z jednego widoku.

Content Pipeline (Kanban)

Draft → Edit → Review → Scheduled → Published. QA score, AI model, keyword, word count per card. Calendar view.

Link Network Graph

Force-directed graph: PBN nodes (blue) → Money Sites (gold). Anchor text distribution pie. Link velocity chart.

Domain Hunter Pipeline

Funnel: 800 discovered → 150 filtered → 60 analyzed → 25 qualified → 3 won. Wayback previews + AI assessment.

Monitoring & Alerts

Real-time alert feed. Uptime heatmap 50 sites × 30 days. SSL/domain expiry. Core Web Vitals gauges.

Revenue & ROI

Per-site ROI, monthly trend, cost breakdown. Money site portfolio. Network profitability: $4,200 rev vs $1,110 cost.

ARCH

Architektura systemu

Async-first Python backend + Next.js frontend + 23 integracji API

┌─────────────────────────────────────────────────────────────────────┐ │ FRONTEND (Next.js 16) │ │ shadcn/ui + Tremor │ TanStack Query + Table │ Auth.js │ Zustand │ │ Native WebSocket + SSE │ Orval auto-gen types │ Zod validation │ └──────────────────────────────┬──────────────────────────────────────┘ │ HTTPS (Caddy reverse proxy) ┌──────────────────────────────▼──────────────────────────────────────┐ │ BACKEND (FastAPI + uvicorn) │ │ /api/v1/* │ WebSocket │ SSE │ JWT RS256 auth │ ├─────────────┼─────────────┼───────┼──────────────────────────────────┤ │ SERVICES (18) │ PROVIDERS (23) │ │ provisioning │ aftermarket, hetzner, vultr, do │ │ content_pipeline │ lightsail, directadmin, cpanel │ │ content_refresh │ cloudflare, mainwp, dataforseo │ │ link_manager │ moz, majestic, google_gsc │ │ domain_hunter │ google_indexing, wpscan, gptzero │ │ warming_manager │ openai, anthropic, gemini │ │ competitor_intel │ heygen, wayback, buffer, ezoic │ │ security_response │ │ │ + 10 more... │ │ └─────────────┬─────────────┴─────────────────────────────────────────┘ │ ┌─────────────▼──────────────────────────────────────────────────────┐ │ INFRASTRUCTURE │ │ PostgreSQL 16 + pgvector │ Redis 7 │ Taskiq workers + scheduler │ │ Cloudflare R2 (media) │ MinIO (dev) │ structlog + Sentry │ │ 49 tables │ Alembic migrations │ Prometheus metrics │ └────────────────────────────────────────────────────────────────────┘

STACK

Tech Stack

Backend + Frontend + Infrastructure — all open source

Framework

FastAPI 0.115+

Async-native ASGI, uvicorn, auto OpenAPI

Runtime

Python 3.12+

Pydantic v2 (Rust core) validation

ORM

SQLAlchemy 2.0 async

asyncpg + selectinload + expire_on_commit=False

Database

PostgreSQL 16 + pgvector

49 tabel, vector similarity search, JSONB

Task Queue

Taskiq + Redis

Async-native, FastAPI DI, hot reload, scheduler

HTTP Client

httpx (async)

Connection pooling, 23 external API integrations

Media Storage

Cloudflare R2

S3-compatible, zero egress fees, MinIO dev

Auth

PyJWT RS256 + Auth.js

CredentialsProvider, role-based routes

Frontend

Next.js 16 App Router

shadcn/ui + Tremor + TanStack Query/Table

Real-time

Native WebSocket + SSE

Direct browser→FastAPI, zero socket.io overhead

API Types

Orval v7

Auto-gen TS types + TanStack hooks + Zod from OpenAPI

Observability

structlog + Sentry + Prometheus

JSON logging, error tracking, metrics + Grafana

Embeddings

text-embedding-3-small

1536 dim, $0.02/1M tokens, multilingual

Migrations

Alembic (async env)

Zero-downtime schema evolution

Testing

pytest + respx + testcontainers

5-layer strategy, 80%+ coverage target

Deploy

Docker Compose + Caddy

Dev + prod configs, healthchecks, resource limits

Baza danych — 49 tabel

PostgreSQL 16 + pgvector, 9 grup, 24 enumy, 50+ indeksów

Infrastructure (10)

domains, dns_configs, dns_records, cf_accounts, hosting_providers, hosting_accounts, registrar_accounts, servers, niches, email_configs

Sites (8)

sites, site_voices, author_personas, themes, plugin_stacks, site_plugins, sitemap_status, redirects

Content (7)

content_queue, content_clusters, content_templates, comments, content_embeddings, repurposed_content, internal_links

Links (4)

links, money_sites, link_velocity_rules, disavow_entries

Engagement (2)

social_profiles, newsletters

Domain Hunter (3)

domain_candidates, domain_budgets, keyword_seasonality

Monitoring (7)

site_health_checks, seo_metrics, keyword_rankings, alerts, provisioning_log, site_topical_authority, cannibalization_alerts

Intelligence (4)

competitors, competitor_keywords, algorithm_updates, negative_seo_events

System (7)

users, audit_log, backup_configs, site_revenue, scheduled_jobs, api_usage, security_events

$$$

Koszty operacyjne

50 stron PBN — ~$1,110/mies. ($22/site)

Infrastructure — $384/mies.

Cloud VPS (15 sites)$52

Shared hosting PL (20 sites)$60

Foreign hosts (15 sites)$37

Domains (50 × ~$4 amort.)$200

DNS/CDN (CF + Bunny)$15

Command Center VPS$20

Content Pipeline — $154/mies.

AI text (200 art × ~$0.10)$20

Multilingual premium$16

Graphics (Flux + GPT Img)$22

Video (HeyGen, ~50/mies.)$75

Repurposing (6 fmt/art)$6

Social tools (Buffer)$15

Domain Hunter — $554/mies.

DataForSEO (eval + monitor)$100

Moz Starter (DA + Spam)$49

Majestic Pro (TF/CF)$100

Domain purchases (~3/mies.)$300

Apify scraping$5

Monitoring — $18/mies.

MainWP Pro (optional)$17

Backup storage (R2)$1

Free tools (Uptime etc.)$0

~$1,110/mies.

$22 per site | Minimum viable: $420/mies. ($8.40/site)

51 SEKCJI

Wszystkie funkcje systemu

Kompletna lista 51 sekcji dokumentacji

🌐

1. Domain Acquisition

Aftermarket.pl API — rejestracja, marketplace, aukcje, DNS management

🖥️

2. Hosting Providers

12+ providerów: Hetzner, Vultr, DO, Lightsail, seohost, cal.pl + zagraniczne

⚙️

3. Panel Automation

DirectAdmin + cPanel UAPI + Softaculous — WordPress auto-install

☁️

4. Cloudflare

DNS, CDN, SSL, WAF, Workers for SEO, Email Routing

🔧

5. MainWP

Centralne zarządzanie 50+ stron WP — updates, content, monitoring

📊

6. Monitoring Stack

Uptime, SSL, domains, WP vulns, PageSpeed, SEO metrics, AI citations

✍️

7. Content Pipeline

AI generation + humanization + GEO/AEO + multimedia + QA scoring

🤖

8. GEO/AEO

Optymalizacja pod AI: answer boxes, FAQ schema, llms.txt, Speakable

🕵️

9. Footprint Avoidance

12 warstw randomizacji: registrar, hosting, DNS, CMS, themes, plugins...

💰

10. Cost Analysis

$1,110/mies. total, $22/site, warianty oszczędnościowe od $420

🔍

11. Expired Domain Hunter

5-level automated funnel: 800→150→60→25→3 won. AI Wayback analysis

🔗

12. Link Velocity

Max 2-3/tydzień, anchor distribution, min articles before first link

💾

13. Backup Strategy

UpdraftPlus + R2/B2, daily DB + weekly full, monthly restore test

🔐

14. RBAC

4 role, audit log, JWT auth, FastAPI-users

📈

15. SEM (Future)

Google Ads API, landing pages, A/B testing, ROAS optimization

🌍

16. Multilingual

15/50 stron multilingual, PL+EN+EU, hybrydowe treści (nie tłumaczenie)

💵

17. Revenue Tracking

ROI per site, Ezoic + affiliate, expand/maintain/retire decisions

♻️

18. Site Lifecycle

Discovery→Acquisition→Provisioning→Seeding→Growing→Mature→Retired

📦

19. Ansible Playbooks

LEMP, WP install, hardening, CF origin, MainWP child, backup, monitoring

✅

20. Content QA

10 automated checks, score 0-100, auto-publish >85, block <70

📱

21. Content Repurposing

Article → 6 formats: tweet, LinkedIn, pin, YT short, newsletter, Reddit

🎯

22. Competitor Intelligence

Content gap, position battles, new keyword opportunities

🌐

23. DNS Records

Individual record tracking, drift detection, auto-fix on IP change

⚡

24. No Terraform

Pure Python API calls — state in PostgreSQL, idempotent service layer

📧

25. Email Strategy

CF Email Routing, forwarding rotation, SPF/DKIM, $0 cost

📝

26. Content Templates

Structured templates per niche×type×language, reusable across sites

💡

27. Bonus Ideas

Freshness Score, Network Health, Competitor PBN Detector, Auto-Niche Discovery

📧

28. Email Config Mgmt

Per-domain forwarding tracking, rotation enforcement, SPF/DKIM status

🔄

29. Repurposing Tracking

Status per article×format, platform IDs, engagement metrics sync

🏢

30. Competitor Tables

Structured competitor + keyword storage, monthly scan pipeline

↩️

31. Redirect Management

301 for expired domains, chain/loop detection, monthly crawl verification

🔃

32. Content Decay

Auto-detect position/traffic drops, queue refresh, priority by link equity

🔌

33. Plugin Tracking

Version tracking per site, vulnerability cross-reference, auto-update status

🗺️

34. Sitemap Management

Auto-generation, GSC submission, error monitoring, hreflang sitemaps

⏰

35. Scheduled Jobs

15 recurring jobs, status dashboard, failure tracking, next run countdown

🚦

36. API Rate Limits

15+ APIs tracked, circuit breaker, cost per call, throttle at 10%

📚

37. Topical Authority

Score 0-100 per site×niche, coverage%, link density, external citations

🏆

38. SERP Features

Featured snippet, PAA, AI Overview, image/video pack tracking

🔄

39. Algorithm Tracker

Core update impact analysis, before/after comparison, correlation

🛡️

40. Negative SEO Protection

Toxic backlink detection, auto-disavow, GSC submission, recovery monitoring

⚠️

41. Cannibalization v2

PBN vs Money Site check, PBN vs PBN dedup, auto-resolution

🌡️

42. Domain Warming

6-stage pipeline, min requirements before link placement, 30-60 day warming

🔗

43. Internal Linking

Auto cross-link engine, pillar↔cluster, orphan detection, max 5/1000 words

🔒

44. Security Response

3-tier auto-heal: CF Under Attack, backup restore, password rotation

📊

45. Content Attribution

Which AI model/template/persona produces best content? A/B testing

💼

46. Portfolio Management

Per-money-site dashboard, budget allocation by ROI, priority tiers

🚫

47. Disavow Management

Structured entries, auto-generate disavow.txt, GSC submission tracking

📏

48. Metric Scales

DA/DR/TF/CF/SpamScore disambiguation — one reference for all scales

🗓️

49. Implementation Phases

22 fazy, 4 priorytety: MUST, SHOULD, NICE, FUTURE

🐍

50. Backend Tech Stack

FastAPI + SQLAlchemy + Taskiq + Redis + R2 + structlog + Sentry

⚛️

51. Frontend Tech Stack

Next.js + shadcn/ui + Tremor + TanStack + Auth.js + Orval

System SEO/PBNManagement Platform