title: Microservices over Monolith Architecture

content: The system uses a 7-stage microservice pipeline (AuditRequestAPI, PlaywrightRunner, AIAnalyzer, etc.) orchestrated via n8n and Redis queues. This allows independent scaling of each stage and async processing to achieve sub-60-second audit generation.


title: Radar Audit Scoring Algorithm & Weights

content: The scoring algorithm normalizes 0-10 metrics to 0-100 dimensions. The weighting hierarchy is SEO (30%) > Lead Capture (25%) > Content (20%) > Design (15%) > Mobile (10%), reflecting revenue impact. The target 'sweet spot' for reports is 40-70 (credible but alarming).


title: 5-Week Build Roadmap

content: Implementation follows a strict 5-week sequence: Week 1 (Core Infrastructure/Redis/n8n), Week 2 (Data Collection/Playwright/Lighthouse), Week 3 (AI Analysis/RAG), Week 4 (Report Generation/White-label), Week 5 (Agency Onboarding).


title: Score Interpretation Tone Mapping

content: The audit score is framed psychologically to drive action: 0-39 (Emergency/Critical tone), 40-70 (Opportunity/Optimization tone), 71-100 (Validation/Success tone). The 40-70 range is specifically designed to be alarming enough to prompt engagement but credible enough to trust.


title: MinIO over AWS S3

content: The system uses MinIO for object storage (screenshots, videos) instead of S3. This is a cost-saving architectural decision to avoid per-request API fees for storing audit artifacts.


title: Web Crawler Anti-Detection Strategy

content: To ensure high-yield data collection, the Playwright runner implements user-agent rotation, proxy rotation, and uses 'playwright-extra' for stealth. The system includes graceful degradation to handle CAPTCHAs and blocks without failing the entire pipeline.


title: Resilient Data Collection Infrastructure

content: The combination of anti-blocking strategies and graceful degradation creates a defensibility moat, ensuring high success rates on difficult-to-crawl sites where simpler tools would fail, ensuring consistent lead generation for agencies.


title: White-Label Agency Branding Injection

content: The ReportGenerator service integrates with the Agency Dashboard via `agency_id`. It dynamically injects agency logos, color schemes, and domain configurations into the audit report and dashboard, enabling full white-labeling.


title: SimilarWeb API Caching for Cost Reduction

content: To optimize costs, the system caches SimilarWeb API responses. Popular domains are stored in the database to avoid redundant paid API calls for every new audit.


title: Design Dimension Scoring Breakdown

content: The Design dimension (Weight: 15%) is scored across 4 sub-factors: Speed & Performance (50% weight - LCP, CLS, FCP), Visual Consistency (20% - fonts, colors), Modernity & Accessibility (20% - viewport, contrast), and Broken Elements (10% - 404s).


title: AI Voice-Over Report Generation

content: The Report Generator creates video summaries using Text-to-Speech (Telnyx) overlaid on screenshots, rather than recording browser replay, to enable faster generation of audit walkthroughs.