Aegis Admin User Guide

1. Executive Summary

The Aegis Admin module is a standalone, real-time web dashboard designed for managing the core routing architecture of the Aegis platform. Rather than just being a router configuration tool, it serves as the central Graphical User Interface (GUI) for almost all of the underlying Aegis microservices—including the Visual Monitor, Analytics, and Nudger. It provides teams with a centralized hub to configure URL routing, build checkout links, scan for compliance/CAPI issues, oversee ad traffic, and review the lifecycle of landing pages.

2. Origin Promotion & Route Management

The primary purpose of the Admin dashboard is to control what happens when a user visits a specific URL by promoting traffic seamlessly across diverse backend platforms.

  • Origin Promotion: Aegis unifies your tech stack. Through the dashboard, you can map any custom subpath (e.g., /spring-sale) to securely proxy traffic to entirely different backend origins. This allows you to effortlessly promote a user to a Cloudflare Pages deployment, a Shopify native liquid page, or a dynamically generated Lovable.app React SPA—all while maintaining your brand's root domain.
  • Environment Overrides: When routing to these external origins, the dashboard allows injecting custom metadata, tracking pixels, and React Router __BASENAME__ configurations directly into their outgoing HTML.
  • Fallback Configuration: In the event of an origin's backend failure, the Admin dashboard defines the DEFAULT_ROUTE_URL so traffic is gracefully redirected instead of encountering 404 errors.

3. The Traffic Sign-Off Protocol

To prevent unverified landing pages from actively receiving paid media budget, the Admin module enforces a strict Multi-Party Sign-Off Protection system.

  • How it works: A route cannot be pushed to "Live/Active" status until it receives explicit approval from three distinct stakeholders:
    1. Page Author: Confirms the content is accurate.
    2. Growth Representative: Verifies the marketing angles and UTM tags.
    3. Tech Representative: Approves performance and technical QA.
  • This ensures complete accountability and eliminates accidental deployments of unfinished pages.

4. The Checkout Link Builder

A significant part of a landing page's success relies on flawlessly redirecting users to the correct cart state. The Admin dashboard includes a dedicated Checkout Builder tool.

  • Streamlined Cart Creation: Instead of manually formatting complex Shopify cart permutations, the Checkout Builder provides an intuitive UI to construct these links.
  • Variant & Discount Management: You can easily append specific product variants, apply automatic discount codes, and define custom UTM parameters directly into the checkout URL.
  • Trello Integration: These constructed links can be seamlessly synced back to Trello for the development team, or stored in the database for the Visual Monitor to validate.

5. CAPI & Pixel Code Scanning

To maintain high data fidelity for server-side attribution, the Admin dashboard provides tools to manage and verify marketing pixels.

  • CAPI Code Management: It provides an interface to configure Meta Conversions API (CAPI) settings and map events correctly.
  • Pixel Scanning & Injection: The dashboard allows you to define which global scripts (like Google Analytics, TikTok pixels, etc.) should be injected into the <head> of specific routes. It interfaces with the Visual Monitor to scan and ensure these codes are correctly firing upon page load.

6. Analytics & Campaign Drill-Downs

The dashboard features beautiful, embedded metrics grids powered by rolling mathematical aggregates from the database.

  • Deep Dives: You can interactively drill down into high-performing campaigns, natively organized by Source and Medium.
  • Performance Monitoring: Instantly view click-through rates, conversion metrics, and webhook-attributed sales directly alongside your routing configurations.

7. Integration with Nudger QA

When a project graduates from the Nudger module (Transitioning from "Tech Work Done" to "Move to Admin"), its full QA configuration is handed off to the Aegis Admin.

  • The Admin dashboard stores the expected copy, GA tag requirements, and visual screenshot assertions.
  • It then uses these baselines to coordinate with the Monitor module for ongoing daily regression testing, ensuring long-term stability.