How thehypedge/riviso_seo works
The tree describes Riviso, an SEO content-operations application, rather than the Gitleaks tool described by the supplied README; I use the tree and sampled source as the architecture evidence. The primary workflow is a user creating an article in the web app, sending a request to the API, and having the article pipeline generate and persist it. Other visible capabilities include WordPress and Shopify publishing context, AI citation tracking, research, SEO audits, and search-console services. Several subsystems are unsampled, so their internal wiring is not inferred.
Main entry points: article_pipeline.py Article generation · router.py API router · runner.py Citation runner · page.tsx Article workspace
Components 30
Web application
- Riviso web app
frontend/src/app/dashboard/page.tsx - API client
frontend/src/lib/api.ts - Article workspace
frontend/src/app/projects/[projectId]/articles/[articleId]/page.tsx - Pipeline monitor
frontend/src/lib/pipelineStream.ts
API and persistence
- FastAPI application
backend/app/main.py - API router
backend/app/api/router.py - Article endpoints
backend/app/api/routes/articles.py - Application storage
storage.py
Content operations
- Article generation
backend/app/services/article_pipeline.py - AI generation
backend/app/services/article_generation.py - Generation worker
backend/app/services/generation_worker.py
SEO and research
- AI citation API
backend/app/api/routes/ai_citation.py - Citation runner
backend/app/services/ai_citation/runner.py - Google AI Overview
backend/app/services/ai_citation/google_ai_overview_engine.py - Gemini search
backend/app/services/ai_citation/gemini_engine.py - Perplexity search
backend/app/services/ai_citation/perplexity_engine.py - Site audit API
backend/app/api/routes/site_audit_seo.py - SEO crawl worker
backend/app/services/seo_crawl_worker.py - Research API
backend/app/api/routes/research.py - Research jobs
backend/app/services/research_job_runner.py
External platforms
- WordPress context
backend/app/services/wordpress_content_pipeline.py - Shopify context
backend/app/services/shopify_product_pipeline.py - WordPress publishing
backend/app/services/wordpress_publish.py - Shopify sync
backend/app/services/shopify_sync.py
Other components
- Content operator
- OpenAI service
- Google services
- Perplexity API
- WordPress site
- Shopify store
Connections 30
- Content operator → Riviso web app: uses
- Riviso web app → Article workspace: opens
- Article workspace → API client: requests
- API client → FastAPI application: calls
- FastAPI application → API router: dispatches
- API router → Article endpoints: dispatches
- Article endpoints → Article generation: invokes
- Article generation → AI generation: generates
- AI generation → OpenAI service: requests
- Article generation → Application storage: persists
- Article generation → WordPress context: loads context
- Article generation → Shopify context: loads context
- Article generation → WordPress publishing: publishes
- Article generation → Shopify sync: syncs
- Article workspace → Pipeline monitor: monitors
- Pipeline monitor → FastAPI application: streams events
- API router → AI citation API: dispatches
- AI citation API → Citation runner: runs checks
- Citation runner → Google AI Overview: checks
- Citation runner → Gemini search: checks
- Citation runner → Perplexity search: checks
- Google AI Overview → Google services: renders search
- Gemini search → Google services: queries
- Perplexity search → Perplexity API: queries
- API router → Site audit API: dispatches
- Site audit API → SEO crawl worker: starts crawl
- API router → Research API: dispatches
- Research API → Research jobs: starts jobs
- WordPress publishing → WordPress site: publishes to
- Shopify sync → Shopify store: syncs with