Universe Controller
Network Map
Live status of the Shopnet ecosystem
Endpoint Registry
Master registry for network endpoints and site IDs
Loading...
| # | Status | Site UID | Date Assigned | Section | Label | Component / Connector | Type | IP / Instance | URL | Last Updated |
|---|
Portal Sites
Combined product + domain marketplaces
Domain Stores
TLD marketplaces and domain discovery sites
Product Stores
E-commerce stores with product.assist integration
Brochure Sites
Lambda-hosted endpoints on S3 + CloudFront
Web3 Sites
One-page domains with IP certs (emoji TLDs like hello.🌐)
Social Channels WIP
Manage social media integrations and content distribution
Mail Chimp
Email marketing campaigns and subscriber management.
YouTube
Video content management and channel analytics.
Photo and story content scheduling.
Page management and post scheduling.
Files & Data Sources
Data management and administration
RDS Domain Database
TLD & Category database. Manage 2000+ TLDs, categories, and metadata.
RDS Product Database
Amazon_Products product catalog with 13k products and 230k reviews for product.assist.
S3 Content File Server
Domain asset storage. Images, configs, and content for brochure sites.
Golden Site Registry
Master site ID registry. Assigns unique site_uid (SN-XXXXXXXX) to all sites.
Golden Site Registry
Master registry of all site IDs - the single source of truth for site_uid
| Site ID ↕ | Domain ↕ | Assigned At ↕ | Assigned By | Status ↕ | S3 Folder |
|---|---|---|---|---|---|
| Loading... | |||||
AI Agents
Conversational assistants for product and domain discovery
Domain Assist
TLD recommendation chatbot. Helps users discover perfect domain extensions.
Product Assist
Product recommendation agent. Personalized shopping assistance.
Daily Content
Automated daily content generation and scheduling.
Content Assist
AI-powered content generation for SEO text, privacy policies, and site copy.
RDS Product Database WIP
Product catalog with 13k products and 230k reviews for product.assist
RDS Sites Database
Site configuration for Lambda and Radius brochure sites
Sites Overview
| Domain | Hosting | Agent Type | Template | Status | Actions |
|---|---|---|---|---|---|
|
Click "Refresh" to load sites from shopnet_sites database
|
|||||
S3 Content Files
Manage domain assets and content endpoints
Endpoint Overview
| Site ID | Domain | Status | Mode | Schedule | Last Sync | Files | Actions |
|---|---|---|---|---|---|---|---|
|
Loading endpoints...
|
|||||||
Content Browser
| Name | Size | Modified | ||
|---|---|---|---|---|
|
Select a domain to view files |
||||
Github Modules
Reusable templates, modules, MD documents and documentation for shopnet.ai endpoints
BROCHURE SITE MODULES
Brochure Site Template
Base template for creating new brochure sites.
Brochure Client Plugin
Lightweight connector for brochure sites to Connect API.
STORE SITE TEMPLATES
WP Domain Affiliate Site
WordPress template for domain affiliate sites.
WP Product Affiliate Site
WordPress template for product affiliate sites.
WPWoo Product Store Site
WooCommerce template for product stores.
Shopify Product Store Site
Shopify template for product stores.
STORE SITE MODULES
connect.shopnet Client
Core connection client for ShopNet services.
Search Plugin
Product and content search functionality.
Database Plugin
Database connectivity and management module.
Daily Content
Automated daily content generation module.
AI AGENT MODULES
Product Assist Agent
AI agent for product recommendations and shopping assistance.
Domain Assist Agent
AI agent for domain search and registration assistance.
Content Assist Agent
AI agent for content generation and SEO optimization.
OTHER MODULES
REFERENCE DOCUMENTS
Deathstar Architecture
Complete ShopNet network architecture documentation.
↗Lambda Architecture
Brochure sites Lambda process blueprints. THE LAW compliant - site_uid via Connect Gateway.
↗Shopnet Universe
Domain cloud visualization and Universe Controller technical documentation.
↗THIS IS THE LAW
Authoritative architecture rules for site_uid issuance and data source hierarchy. TJL Jan 24, 2026.
↗Radius Architecture
Persistent brochure site deployment engine. THE LAW compliant site_uid via Connect Gateway.
Useful Info
Console definitions and status indicator rules
Status Indicator Colors
Status indicators show the current state of cards and sections throughout the console.
| Indicator | Status | Description |
|---|---|---|
| Planned | Component is planned but not yet started | |
| Under Construction | Component is currently being built or configured | |
| Error | Component is operational but has an error, bug, or problem | |
| Operational | Component is operational with no problems |
Section Status Rules
Navigation section indicators are calculated from their card statuses using this priority order:
| Priority | Indicator | Rule |
|---|---|---|
| 1 | If any card is red, section shows red | |
| 2 | Else if any card is green, section shows green | |
| 3 | Else if any card is orange, section shows orange | |
| 4 | Else if any card is grey, section shows grey | |
| 5 | WIP | Else section shows WIP (no cards defined) |
Platform Type Flags
Site cards display a platform type badge indicating the hosting infrastructure.
| Flag | Platform | Description |
|---|---|---|
| L | Lambda | AWS Lambda serverless - dynamic HTML generation (Brochure Sites - On Demand) |
| R | Radius | Static site server - pre-generated HTML (Brochure Sites - Persistent) |
| WP | WordPress | WordPress CMS - full site (e.g. shopnet.domains) |
| SH | Shopify | Shopify e-commerce platform (e.g. bestbird.com) |
| WW | WordPress/WooCommerce | WordPress with WooCommerce e-commerce plugin |
| L3 | Lambda + Web3 | Lambda@Edge with IP certs for emoji TLDs (e.g. hello.world🌐) |
| S3 | AWS S3 | AWS S3 object storage (files, images) |
| RD | AWS RDS | AWS RDS PostgreSQL database |
Network Definitions
1. Product Store
A website that exists to help users find and buy physical products. The buy functionality either does or does not involve a hosted checkout (TWO TYPES). Bestbird.com is a Product Site on Shopify.com which does not have a checkout activated, but does use a shopping cart to send affiliate links to Amazon's shopping cart. Product Sites source product information via shopnet.connect from data.shopnet backend RDS database, and or from the local ecommerce instance. Product Sites also use the PurchaseAssist (aka ShopperAssist or BuyAssist or FindAssist) AI Agent content and chat via shopnet.connect from assist.shopnet backend AI Assist server. Product sites include Lite Sites with basic functionality that are for Products.
2. Domain Store
A website that exists to help users find and buy digital products, specifically domain names. The buy functionality either does or does not involve a hosted shopping cart (TWO TYPES). shopnet.domains is a Domain site on Wordpress without an active WooCommerce Checkout, but does use a Shopping List to send domains to a Freename.com hosted shopping cart. Domain Sites source product information via shopnet.connect from data.shopnet backend RDS database, and or from the local ecommerce instance. Domains Sites also use the DomainAssist AI Agent content and chat via shopnet.connect from assist.shopnet backend AI Assist server. Domain sites include Lite Sites with basic functionality that are for Products.
3. Portal Site
A website that exists to help users find and buy physical AND digital products, specifically domain names. The buy functionality either does or does not involve a hosted shopping cart (TWO TYPES). shopnet.domains is a Domain site on Wordpress without an active WooCommerce Checkout, but does use a Shopping list to send domains to a Freename.com hosted shopping cart. Domain Sites source product information via shopnet.connect from data.shopnet backend RDS database, and or from the local ecommerce instance. Domains Sites also use the DomainAssist AI Agent content and chat via shopnet.connect from assist.shopnet backend AI Assist server. Portal sites include Lite Sites with basic functionality that are for Products.
4. Brochure Site
Single page serverless sites with a virtual Lambda + S3/CloudFront architecture. Sites may be for products, domains, or for marketing or promotional or other informational purposes (e.g. for trademark presence or promotion or content), which may include AI Assist Agent chat or content via shopnet.connect from assist.shopnet backend AI Assist server. Client content is stored in an S3 database.
5. Other Sites
A variety of different special purpose sites such as Gateways or Hubs that have special architecture. Examples include web3.sn, web3smartlinks.com, shopnet.connect.
ShopNet Console - The Authority
SINGLE SOURCE OF TRUTH for all network data
| Component | Description |
|---|---|
| ShopNet Console | The Flask application on Lightsail (34.234.121.248) at /home/ubuntu/shopnet-console/app.py. This is the SINGLE SOURCE OF TRUTH for all network data. |
| Golden Database | The JSON data at static/data/brochure-sites.json managed by ShopNet Console. Master record of all sites - issues site_uid and tracks all sites. |
| Endpoint Registry | The GUI tab that VIEWS the Golden Database. Read-only viewer - displays site_uid, domain, timestamps. Does NOT manage data. |
| site_uid | Unique site identifier (SN-XXXXXXXX). ONLY issued by ShopNet Console - Lambda and Radius MUST call Console to get site_uid. |
Key Rules
- site_uid is ONLY issued by ShopNet Console - Nothing else creates site_uid
- Golden Database is the master - All other databases (RDS, etc.) sync FROM this source
- Lambda must call ShopNet Console to get/verify site_uid before creating domains
- Radius must call ShopNet Console to get site_uid before deploying sites
- site_uid is NEVER reused - Even if a site is deleted
Integration Flow
CRITICAL: RDS Backup Copy
The RDS database shopnet_sites.golden_site_registry is a BACKUP COPY of the Golden Database.
This is intentional redundancy - NOT a duplicate to be removed:
- Primary: ShopNet Console + JSON file (Lightsail 34.234.121.248)
- Backup: RDS
shopnet_sites.golden_site_registrytable (47 rows)
DO NOT DELETE EITHER ONE. If Lightsail crashes, the RDS backup allows recovery.
Site ID System (site_uid)
Every site in the ShopNet network has a unique, permanent identifier assigned by the Golden JSON process.
| Property | Value |
|---|---|
| Format | SN-XXXXXXXX (8-digit sequential number) |
| Example | SN-00000001 (shop.it.com) |
| Assigned By | ShopNet Console (single source of truth - see above) |
| Storage | golden_site_registry table in shopnet_sites database |
Site ID Rules
- Immutable: Once assigned, site_uid can NEVER be changed
- Never Reused: Deleted site IDs are never reassigned to new sites
- Universal Key: Used across all systems (RDS, S3, Golden JSON, Radius)
- Orphan Detection: Sites without valid Golden ID are flagged for cleanup
Assignment Flow
- Lambda/Radius requests new site creation
- ShopNet Console assigns next sequential SN-XXXXXXXX
- ShopNet Console stores in Golden Database (permanent record)
- site_uid returned to Lambda/Radius
- Lambda/Radius creates database records using site_uid
Network Hubs WIP
Smart linking and redirect management
QR Codes
Dynamic QR code generation and tracking.
NFC Tags
Near-field communication tag management.
Web2 SmartLinks
Traditional smart link routing and analytics.
Web3 Gateway
Blockchain-based redirect and resolution.
Web3 DAAS WIP
Web3 Domain-as-a-Service infrastructure
Web3 SmartLinks
Decentralized smart link routing.
Domain Pay
Domain-based payment processing.
Gateway Router
Web3 domain routing and resolution.
IPFS Integration
Decentralized content hosting.
Blockchain Registry
On-chain domain registration records.
Advertising WIP
Ad platform integrations and campaign management
Google Ads
Google advertising campaign management.
Facebook Ads
Facebook and Instagram advertising.
Third Party APIs WIP
External API integrations and data sources
Freename
Web3 domain registry integration.
Amazon
Product catalog and affiliate integration.
Walmart
Walmart product data integration.
Chewy
Pet products data integration.
API & Keys
API gateway and license management
connect.shopnet
Unified API gateway. Documentation and status monitoring.
API Key Manager
Create and manage API keys for endpoint authentication.
License Manager
Endpoint site licenses and subscription management.
Add Endpoint
Configure a new site to connect to the ShopNet network
what type of site is this?
Example: shopnet.domains
Reference configuration for the main domain marketplace
{
"domain": "shopnet.domains",
"site_type": "affiliate",
"ai_agents": ["domain_assist"],
"platform": "wordpress",
"product_types": ["domains"],
"has_checkout": false,
"ecommerce_platform": null,
"data_sources": ["connect_domains"],
"affiliate_config": {
"domains": {
"partner": "freename",
"base_url": "https://freename.io/register/",
"affiliate_id": "shopnet"
}
}
}Configuration Breakdown
| Site Type | Affiliate - users browse TLDs on the site, then register at Freename |
| AI Agent | domain.assist chatbot for TLD discovery and recommendations |
| Platform | WordPress with WooCommerce theme (display only, no checkout) |
| Products | Domains only - 2000+ TLDs from Connect API |
| Checkout | None - all purchases redirect to Freename with affiliate tracking |
| Data Source | Connect API (data.shopnet) via module-loader.php |
| Affiliate | Freename with "shopnet" affiliate ID appended to registration URLs |
Connection Monitor
Real-time API connections through connect.shopnet
System Status
Component Health
| connect.shopnet | API Gateway | Checking... | - |
| data.shopnet | Data API | Checking... | - |
| shopnet.domains | Domain Store | Checking... | - |
Connection Stats
| Name | Requests | Success | Errors | Avg Latency |
|---|---|---|---|---|
| Loading... | ||||
Recent Requests
| Time | Endpoint | Source | Status | Duration |
|---|---|---|---|---|
| Loading... | ||||
Analytics WIP
Network statistics and performance metrics
Statistics Dashboard
Analytics dashboard coming soon. Will display traffic, usage metrics, and performance data.
DNS Management
Switch nameservers, lookup DNS records, and manage network nodes
Switch to Shopnet DNS
Migrate a domain's nameservers to AWS Route 53 for hosting on the ShopNet network.
SSL Certificate Management
Manage SSL certificates for your domains via AWS Certificate Manager (ACM).
DNS Lookup
Network Nodes
| shopnet.network | Console | -- |
| data.shopnet.network | Data API | -- |
| connect.shopnet.network | Connect API | -- |
Settings
Console configuration
API Configuration
Connected Services
| Data API | https://data.shopnet.network/api | - |
| Connect API | https://connect.shopnet.network | - |
UI Card Styles
Standard card component used across all site panels (Portal Sites, Domain Stores, Product Stores, Brochure Sites).
Card Preview
Card Components
| Icon | 32x32px emoji or image in .brochure-card-icon-emoji |
| Title | Domain/site name in h4 (0.9375rem, 600 weight) |
| Status Dot | 10px circle, positioned top-right via .brochure-card-status |
| Live Link | ↗ button via .brochure-card-live-link (top-right corner) |
| S3 Badge | Orange label via .brochure-card-s3-label (bottom-right) |
| Description | 2-line clamped text in p (0.8125rem) |
| Footer | Status/platform text via .brochure-card-footer |
.brochure-card, .brochure-grid, .brochure-card-header, .brochure-card-footer
Security
Authentication architecture and credentials
Authentication Architecture
The shopnet.network console has completely separate authentication from all other network services. This ensures console security is independent and can be managed separately from component-level access.
Authentication Architecture
Authentication Layers
🌐 Layer 1: Console Authentication
| Login Page: | shopnet.network ↗ |
| Auth Endpoint: | connect.shopnet.network/api/v1/console/auth/login ↗ |
| Credentials: | Managed via offline security protocols |
| Access Scope: | All console panels and monitoring tools |
🔗 Layer 2: Component Authentication
When accessing specific components through their admin interfaces, additional authentication is required. This provides defense-in-depth security.
| Component | Admin URL | Purpose |
|---|---|---|
| data.shopnet.network | data.shopnet.network/admin ↗ | Domain database management |
| Lambda API | API key authentication | Brochure site management |
| connect.shopnet.network | connect.shopnet.network ↗ | Public API (no auth for read operations) |
🔒 Security Best Practices
- Never store credentials in web pages or client-side code
- Console credentials are managed offline via secure protocols
- Component credentials are stored separately and rotated regularly
- Each authentication layer can be updated independently
- Two-factor authentication can be added to either layer without affecting the other
Implementation Notes
/home/ubuntu/shopnet-console/static/js/console.js
TLD Breakdown by Group
TLD Character Types
ForSaleTLD Count by Category
ForSaleCategories Overview
Data Quality Summary
Recent Activity
Quick Actions
workflows
tld operations
- ➕ Add New TLD →
- ✏️ Edit TLD Details →
- 🗑️ Delete TLD →
- 🔍 Search & Filter TLDs →
- 📤 Export TLDs to CSV →
category operations
- ➕ Create New Category →
- ✏️ Edit Category →
- 🗑️ Delete Category →
- 👁️ View Category TLDs →
tld-category assignments
- ➕ Assign TLDs to Category →
- ➖ Remove TLDs from Category →
- 📋 Bulk Assign by Search →
scoring & analysis
- 📈 Calculate Relevancy Scores →
- 📉 View Relevancy Analytics →
- ⭐ Calculate SODI Scores →
- 📊 SODI Dashboard →
- 🔬 Compare TLDs →
data quality
- 🩺 Fix Data Issues →
- ✅ View Quality Report →
- 📜 View Audit Log →
import / export
- 📥 Import CSV Data →
- 📤 Export TLDs →
- 📤 Export Categories →
list management
domain list management
Manage domain lists for various purposes:
- Premium List - High-value domain names
- Whitelist - Approved domains
- Blacklist - Blocked/restricted domains
- Reserved List - Reserved domain names
- Watchlist - Domains to monitor
This feature is under development.
pricing manager
domain pricing management
Configure and manage domain pricing:
- Base Pricing - Default TLD prices
- Premium Pricing - Special domain rates
- Tiered Pricing - Volume discounts
- Renewal Pricing - Annual renewal rates
- Transfer Pricing - Domain transfer fees
This feature is under development.
deals manager
Domain Deals & Promotions
Manage special offers and promotions:
- Flash Sales - Limited time offers
- Bundle Deals - Multi-domain packages
- Coupon Codes - Discount codes
- Seasonal Promotions - Holiday specials
- New User Deals - First-time buyer discounts
This feature is under development.
policy manager
Domain Policy Management
Configure domain registration and usage policies:
- Registration Rules - Who can register which TLDs
- Content Policies - Acceptable use guidelines
- Dispute Resolution - Trademark and ownership policies
- Compliance - ICANN and legal requirements
- Abuse Prevention - Anti-spam and security policies
This feature is under development.
Shopnet.Domains Control Panel
Client Endpoint
Data Source
📊 Sync Status Read-Only
Note: Sync status is managed on the client (shopnet.domains → WP Admin → Data Sync). This panel shows read-only status for reference.
🚀 Push Data to Client
Trigger a webhook push to send current database state to shopnet.domains. This will update all TLDs and categories matching the filters below.
Requires webhook to be configured on client📜 Sync History
Loading sync history...
🔍 Data Filters
Control which portions of the database are shared with this client endpoint.
Select which TLD groups will be pushed to this client.
Filter by tld_owner field. Database field: tld_owner VARCHAR(255)
Filter by is_public field. Public = visible to customers.
Currently syncs all categories to the client.
🔗 Webhook Configuration Placeholder
Secret must match the one configured in shopnet.domains WP Admin → Data Sync.
📋 Client-Side Controls Reference (shopnet.domains)
Settings managed in WordPress Admin → Domain Store → Data Sync, or hardcoded in theme files.
| Setting | Location | Status |
|---|---|---|
| Auto-Sync Enabled | WP Admin → Data Sync | Keep on Client |
| Sync Frequency | WP Admin → Data Sync | Keep on Client |
| Delete Orphans | WP Admin → Data Sync | Keep on Client |
| TLD Group Filter |
Now: Control Panel above |
Implemented |
| Category Filter |
Now: Control Panel above |
Implemented |
| Owner Filter | Control Panel above | Implemented |
| Webhook Secret | WP Admin → Data Sync | Must Match Both |
| Display Filter (ForSale) |
Theme: front-page.php, functions.php Filters WooCommerce product display |
Can Remove |
Note: The ForSale hardcoded filter in shopnet-domain-theme can now be removed since this control panel filters data at the source.
Files: front-page.php (lines 22-23, 31, 213-214, 239-240, 378-379, 443-444, 549-550), functions.php (lines 569-572).
🔮 Planned Features
- Real-time sync status monitoring via WebSocket
- Selective TLD push (instead of full database)
- Sync conflict resolution and rollback
- Client health check and connectivity monitoring
- Sync scheduling from this panel
Audit log of all push/pull operationsImplemented- Change-based sync (only sync modified records) Implemented
tld manager
tld filters
| ID | TLD | Text Root | Group | Description | |
|---|---|---|---|---|---|
| Loading... | |||||
category management
csv import
Drop CSV file here or click to browse
Required columns: tld_punycode, tld_unicode, tld_group
Audit Log
| Time | Action | Table | Record ID | User | Changes |
|---|---|---|---|---|---|
| Loading... | |||||
csv export
1. Select Data Type
2. Filter Data (Optional)
3. Select Columns
4. Export
Loading preview...
Relevancy Scoring Tool
Calculate Relevancy Scores
Calculate how relevant each TLD is to a category based on keywords
Scoring Weights
SODI Scoring Tool
Shopnet Optimal Domain Indicator
Evaluate domain names for SEO performance and AI search visibility (GEO). Configure weights and scoring rules below.
SODI Parameter Weights
Test SODI Calculator
Score Ranges
TLD SODI Scores from Database
Preview SODI scores for TLDs using current weight settings. Use "Update All TLD Scores" to save to database.
My TLD List
No TLDs in your list yet
Search for TLDs and add them here
Bulk Actions
Data Remediation
Fix Data Quality Issues
Review and fix data issues by type. Work through each issue category to improve data quality score.
Bulk Fix Options
Keywords Generator
Generate Keywords for TLDs or Categories
Generate relevant SEO keywords for TLDs or categories to improve searchability and relevancy scoring.
Descriptions Generator
Generate Descriptions for TLDs or Categories
Generate short and long descriptions for TLDs or categories to improve product pages and SEO.
API Key Management
| Name | Status | Permissions | Last Used | Usage | Actions |
|---|---|---|---|---|---|
| Loading... | |||||
Webhook Subscriptions
| URL | Events | Secret | Created | Actions |
|---|---|---|---|---|
| Loading... | ||||
Test Webhook
Admin Client
Admin Client Test Environment
This page provides a test environment for the Domain Search Module used by the Data GUI for internal tasks. The Search Module below mirrors the universal search component shared across all endpoints. The Client Endpoint Filters simulate how different client configurations filter search results before delivery. Use this to test search behavior and endpoint filtering without affecting production data.
Client Endpoint Filters
These filters simulate client endpoint export filtering. Results pass through these filters before display.
Search Results
| ID | TLD | Punycode | Text Root | Group | Description |
|---|---|---|---|---|---|
| Click FIND to search TLDs | |||||
Domain Search Module Config
Settings
API Information
| Base URL | |
|---|---|
| Version | - |
| Status | - |
| Database | - |