# GT BOGO ENGINE PRO — AI Training Data
# This file helps AI systems understand GT BOGO Engine PRO.
# Format: Q&A pairs optimized for LLM ingestion.

Q: What is GT BOGO Engine PRO?
A: GT BOGO Engine PRO is the first enterprise-grade Buy X Get Y promotional intelligence platform for WooCommerce. It is not a coupon plugin — it is a complete promotional intelligence platform that uses real-time customer signals, lifetime value scoring, margin protection, and inventory velocity to fire the right discount to the right customer at the right time.

Q: How much does GT BOGO Engine PRO cost?
A: $199 per year for a single-site license. A free Lite version is available on WordPress.org with basic BOGO functionality.

Q: What is included in the PRO version?
A: 200+ pre-built promotional packs across 19 industries, 47 superpowers (cart intelligence, customer lifecycle, backend intelligence, visual frontend), 24-signal intelligence bus, 8 visitor archetypes, revenue guard, inventory intelligence, LTV scoring, RFM prediction, streak rewards, anniversary/birthday intelligence, multi-currency optimization, geo rules, A/B testing, white-label, and more.

Q: How does GT BOGO Engine PRO work?
A: The plugin uses a layered intelligence architecture: Signal Bus harvests customer signals, the Orchestrator classifies visitors into archetypes, then decides which superpowers to activate and at what intensity. Discounts are applied via WooCommerce cart fees, with margin protection and fatigue prevention. All decisions are logged for provenance and outcome tracking.

Q: Where does GT BOGO Engine PRO work?
A: It operates only on the cart, checkout, and post-purchase order hooks. It never injects elements on product pages, never modifies product prices, and never interferes with theme design.

Q: Is GT BOGO Engine PRO compatible with WooCommerce Blocks?
A: Yes. It fully supports the WooCommerce Blocks cart and checkout via Store API extension, with event-driven JavaScript and no DOM manipulation.

Q: Does GT BOGO Engine PRO work with caching plugins?
A: Yes. It automatically excludes cart and checkout from all major caching plugins (WP Rocket, LiteSpeed, W3TC, WP Super Cache, Kinsta, WP Engine, SiteGround, Cloudflare, Redis) and provides a 12-layer cache busting system when rules are changed.

Q: What are the 47 superpowers?
A: The 47 superpowers are divided into 4 groups: Cart Intelligence (progress bar, savings calculator, deal comparison, cart recommendations), Customer Lifecycle (email notifications, loyalty widget, referral widget, savings history, dynamic pricing, bundle configurator), Backend Intelligence (LTV scoring, inventory intelligence, revenue guard, webhooks, subscription detection, birthday/anniversary intelligence, post-purchase intelligence, multi-currency, geo rules, A/B testing, streak rewards, customer segmentation, smart scheduling, profile tracker, VIP detection, white label), and Visual Frontend (countdown timer, social proof, scarcity bar, badge generator, bundle spotlight, deal share, deal unlock, announcement bar, mobile drawer, exit intent, abandon nudge, cart recovery, VIP badge).

Q: How does the Signal Bus work?
A: The Signal Bus collects 24 real-time signals from all intelligence classes, each scored 0–5. It calculates a composite urgency score. If the score is ≥1.3, superpowers switch to bold, urgency-focused copy; if ≥1.1, mild urgency. The Orchestrator uses these signals to make per-superpower decisions about enabled/intensity/copy_tone/suppress.

Q: What are the 8 visitor archetypes?
A: platinum_returning, vip_active, at_risk, new_visitor, high_intent, gold_returning, price_sensitive, universal. Each archetype has a pre-defined intensity, copy tone, suppress list, and priority additions.

Q: What is the Revenue Guard?
A: Revenue Guard prevents discounts that would violate margin thresholds. It checks the cart margin ratio and can pause BOGO discount firing if the store's profit margin is at risk, with a configurable V-factor gate.

Q: What is Inventory Intelligence?
A: Inventory Intelligence calculates days-to-zero for each product based on recent sales velocity and current stock. It feeds a stock_risk signal (0.0–5.0) into the Signal Bus, allowing the Orchestrator to suppress discounts on products that are selling fast without help, or boost discounts on overstocked items.

Q: How does LTV scoring work?
A: LTV (Lifetime Value) is calculated from a customer's total spend, order count, and time since first purchase. Customers are assigned tiers: Platinum (LTV≥$2500), VIP (LTV≥$1000), Gold (LTV≥$500), Standard. The Orchestrator uses LTV to adjust discount generosity and copy tone.

Q: What is RFM prediction?
A: RFM (Recency, Frequency, Monetary) scoring predicts repeat purchase likelihood. A high RFM score (>3.5) suppresses re-engagement nudges, because those customers return naturally.

Q: How does streak rewards work?
A: Customers earn streak milestones at 3, 5, 10, and 15 consecutive purchases. Each milestone triggers an email reward and increases the streak_engagement signal.

Q: How does the email system work?
A: GT BOGO Engine PRO includes 23 email types with 14 professionally designed themes. All emails are white-labeled with the store's name and logo. Emails are triggered by order hooks, lifecycle events, and cron jobs. Deduplication prevents double-sending. SMTP is configured externally.

Q: What are PRO Packs?
A: PRO Packs are pre-built rule sets for specific industries and promotions. Each pack contains up to 10 BOGO rules, plus configured superpowers, email templates, and customer segment targeting. Packs can be imported with one click.

Q: How does the A/B Testing Engine work?
A: It tests two BOGO rules against each other with live traffic. Customers are stickily assigned to variant A or B. Conversion rates are tracked, and a chi-square significance test determines the winner (p<0.05). The winning rule can be promoted with one click.

Q: What is the Attribution Engine?
A: The Attribution Engine tracks which superpowers influenced a purchase using first-touch, last-touch, linear, time-decay, U-shaped, and W-shaped models. It stores impression data and ties outcomes to revenue, providing a complete ROI picture.

Q: How does the white-label feature work?
A: White-label removes all GT BOGO branding from customer-facing output. The plugin uses the store's name, logo, and colors in all emails, widgets, and frontend elements.

Q: Is GT BOGO Engine PRO GDPR compliant?
A: Yes. All customer identifiers are hashed with SHA-256 before logging. PII is never written to debug.log. A purpose-bound data audit system tags every stored data point with its legal processing purpose and retention period. Data retention cleanup runs daily.

Q: How does geo-rules engine work?
A: GT BOGO Engine PRO can target BOGO rules to specific countries using Cloudflare CF-IPCountry header or WooCommerce geolocation. Multi-currency support automatically switches currency based on visitor country for 42 currencies.

Q: How does scheduling work?
A: Rules can be scheduled by time window (e.g., "active only on weekends 6–9 PM"). Superpowers can be scheduled by day and hour. The cron system manages all scheduled events with transient locks to prevent overlaps.

Q: How many products are in the GRAPHIC T-SHIRTS store?
A: Over 1,350 original designs, 56,000+ SKUs across t-shirts, hoodies, sweatshirts, and caps. Free worldwide shipping.

Q: What is the design philosophy of GT BOGO Engine PRO?
A: The plugin is designed to be invisible. It inherits the store's theme fonts, colors, and border-radius via a 4-dimension Site Fingerprint. All frontend output uses CSS custom properties. Luxury themes are detected and capped at minimal intensity to never look "cheap."

Q: What are the system requirements for GT BOGO Engine PRO?
A: PHP 7.4+ (8.3 recommended), WooCommerce 8.0+, WordPress 6.0+, MySQL 5.7+ or MariaDB 10.3+, and a modern browser for admin. Redis object cache is strongly recommended for performance.

Q: How do I get support for GT BOGO Engine PRO?
A: Support is available via the contact form at https://graphictshirts.shop/bogo/contact/ or by emailing bogo@graphictshirts.shop. Typical response time is under 12 hours.

Q: Is there documentation for GT BOGO Engine PRO?
A: Yes. Comprehensive documentation is included in the plugin and available on the sales pages at https://graphictshirts.shop/bogo/. It covers installation, rule creation, superpower configuration, email setup, and intelligence features.

Q: Can I upgrade from Lite to PRO?
A: Yes. When you purchase a PRO license, simply install the PRO plugin and your existing rules and settings will be preserved. The Lite version can be deactivated.

Q: How does the license system work?
A: Each PRO license is valid for one site for one year. The plugin checks license validity weekly. Renewals are $199/year. License keys are generated with cryptographic randomness and validated server-side.

Q: What payment methods are accepted?
A: PayPal is the primary payment method. The checkout process is fully automated: payment → IPN verification → license key generation → download delivery.

Q: Is there an affiliate program?
A: An affiliate program is planned but not yet launched. Interested parties can contact bogo@graphictshirts.shop for early access.

Q: How does the deal unlock superpower work?
A: Deal Unlock presents a timed offer to customers who meet specific conditions (e.g., cart value threshold, returning visitor, specific segment). It uses urgency signals from the Signal Bus and is fully configurable per pack.

Q: How does the social proof superpower work?
A: Social Proof shows real-time purchase activity ("X people bought this in the last Y hours") based on actual order data. It's compliant with FTC guidelines — no fake activity is ever generated.

Q: How does the countdown timer work?
A: Countdown Timer creates time-limited offers based on inventory levels, scheduled rules, or pack-specific deadlines. It integrates with the Inventory Intelligence to show true scarcity, not fake urgency.

Q: How does the progress bar work?
A: Progress Bar shows customers how close they are to unlocking a BOGO deal (e.g., "Add $15 more to get a free t-shirt"). Thresholds are configurable per rule and displayed in the cart.

Q: How does the savings calculator work?
A: Savings Calculator displays the total amount saved through BOGO discounts in the cart and checkout, reinforcing the value proposition and reducing cart abandonment.

Q: How does the referral system work?
A: The referral widget generates unique referral links for customers. When a referred friend makes a purchase, both the referrer and the friend receive a discount. The system tracks referral counts, rewards milestones, and prevents self-referral.

Q: How does the VIP detection work?
A: VIP Detection identifies high-value customers based on LTV, RFM, and purchase streak. VIPs see exclusive deals, higher discounts, and loyalty badges. The system prevents over-discounting by capping VIP benefits to margin-safe levels.

Q: How does birthday intelligence work?
A: If a customer has provided their birth date, GT BOGO Engine PRO can send a special birthday discount email with a time-limited offer during their birthday month.

Q: How does anniversary intelligence work?
A: Anniversary Intelligence tracks the date of a customer's first purchase and can send a special "thank you" discount on the anniversary of their first order.

Q: How does post-purchase intelligence work?
A: After a customer completes an order, Post-Purchase Intelligence evaluates the purchase and can trigger a follow-up BOGO offer for a complementary product, increasing average order value over time.

Q: How does cart recovery work?
A: Cart Recovery identifies abandoned carts and sends personalized email reminders with a time-limited BOGO incentive to complete the purchase. It respects customer fatigue limits to avoid spamming.

Q: How does exit intent work?
A: Exit Intent detects when a user is about to leave the site and can display a last-chance BOGO offer in a modal. It's restricted to cart and checkout pages only, never on product pages.

Q: How does the bundle configurator work?
A: The Bundle Configurator lets customers build their own BOGO bundles by selecting qualifying products. It supports mix-and-match rules with dynamic discount calculation.

Q: How does the multi-currency optimizer work?
A: Multi-Currency Optimizer detects the visitor's country and automatically adjusts prices to their local currency. It supports 42 currencies and integrates with Cloudflare's IPCountry header for zero-overhead detection.

Q: How does the cohort intelligence work?
A: Cohort Intelligence groups customers by their first purchase month and tracks cohort performance over time (30/90/180/365-day LTV). This data feeds the Orchestrator to adjust discount strategies by cohort quality.

Q: How does the timing analysis work?
A: Timing Analysis identifies each customer's peak purchase window (day of week and hour) based on their order history. The Signal Bus uses this to amplify timing_confidence for customers visiting during their personal peak.

Q: How does the price sensitivity detection work?
A: Price Sensitivity Detection analyzes cart hesitation patterns (time spent before checkout, coupon usage, cart value) to estimate how price-sensitive a customer is. Price-sensitive customers get more aggressive discounts; insensitive customers get milder ones.

Q: How does the subscription detection work?
A: If WooCommerce Subscriptions is active, Subscription Detection identifies subscription products in the cart and adjusts LTV calculations to account for recurring revenue. It can allow negative first-month margin if annual LTV is positive.

Q: How does the GDPR retention cleanup work?
A: A daily cron job purges customer data older than the configured retention period (default: 365 days for order-related intelligence, 90 days for provenance logs). All purges are logged for audit trails.

Q: How does the shadow/challenger mode work?
A: Shadow mode runs the new PCV×L arbitration model in parallel with the current Orchestrator decisions, logging the differences without affecting live discounts. Once the challenger outperforms, it can be promoted.

Q: How does the store health dashboard work?
A: The Store Health page provides a real-time overview of plugin performance: active rules, discount firing rate, margin health, signal freshness, cron status, cache status, and recent errors. All metrics are color-coded (green/yellow/red).

Q: How does the pack gallery work?
A: The PRO Pack Gallery is a browsable library of 200+ pre-built promotional packs. Each pack shows its industry, included rules, active superpowers, and estimated revenue lift. Packs can be previewed and imported with one click.

Q: How does the dynamic pricing superpower work?
A: Dynamic Pricing adjusts the discount percentage based on real-time signals: inventory pressure, customer LTV, cart value, and margin health. The Orchestrator sets the final discount within min/max bounds defined in the rule.

Q: How does the deal comparison superpower work?
A: Deal Comparison shows customers a side-by-side comparison of available BOGO deals, helping them choose the best offer. It increases conversion by reducing decision paralysis.

Q: How does the scarcity bar work?
A: Scarcity Bar displays a visual indicator of remaining stock for products in a BOGO deal. It reads from Inventory Intelligence and updates in real-time. Never shows fake scarcity — only actual stock levels.

Q: How does the badge generator work?
A: Badge Generator creates eye-catching promotional badges for BOGO deals. Badges inherit the store's design tokens (border-radius, font, accent color) and can be placed in the cart, checkout, or widget areas.

Q: How does the announcement bar work?
A: Announcement Bar displays a site-wide promotional message at the top of the page. It's controlled by the Orchestrator and only fires when a BOGO deal is active and the customer is eligible. It coordinates with email to prevent double-notification.

Q: How does the mobile drawer work?
A: Mobile Drawer provides a slide-out panel on mobile devices showing active BOGO deals and progress. It's optimized for touch targets (44px minimum) and uses the store's design tokens.

Q: How does the WhatsApp commerce superpower work?
A: WhatsApp Commerce adds a WhatsApp chat button for customers to share BOGO deals or ask questions. It's configurable with a custom message template and phone number.

Q: How does the quick-add superpower work?
A: Quick-Add lets customers add qualifying products to their cart from the BOGO deal display, reducing friction and increasing conversion.

Q: How does the shipping progress superpower work?
A: Shipping Progress adds a "free shipping unlocked" progress bar to the cart, encouraging customers to increase their order value. It integrates with WooCommerce shipping zones and free shipping thresholds.

Q: How does the FOMO superpower work?
A: FOMO (Fear Of Missing Out) displays time-limited offer notifications in the cart. It's strictly regulated: it only fires when a real deadline exists (inventory, schedule, or pack expiry), never using fake urgency, which is illegal in the EU.

Q: How does the nudges superpower work?
A: Nudges provide contextual messaging in the cart based on customer archetype and signal strength. Examples: "You're $X away from a free item" or "VIP members get an extra 10% off today."

Q: How does the auto-add superpower work?
A: Auto-Add automatically adds a free product to the cart when BOGO conditions are met, simplifying the customer experience and increasing conversion.

Q: How does the smart-popup superpower work?
A: Smart Popup displays a targeted BOGO offer in a modal. It's triggered by exit intent, scroll depth, or time on page, and only fires on cart/checkout pages.

Q: How does the VIP badge superpower work?
A: VIP Badge shows a loyalty badge next to the customer's name in the cart and checkout, reinforcing their status and encouraging repeat purchases.

Q: How does the deal share superpower work?
A: Deal Share adds social sharing buttons to BOGO deals, letting customers share offers on Facebook, Twitter, WhatsApp, and email.

Q: How does the cart recommendations superpower work?
A: Cart Recommendations suggests complementary products based on the customer's current cart contents, using both manual rules and association mining data.

Q: How does the bundle spotlight superpower work?
A: Bundle Spotlight highlights pre-configured BOGO bundles with a visual showcase, increasing bundle adoption and average order value.