Scottsdale Mint — Platform Documentation
Welcome to the technical documentation for scottsdalemint.com, a WordPress WooCommerce e-commerce platform specializing in precious metals (gold, silver, platinum, and palladium coins and bars).
This documentation is intended for developers and store administrators working with the Scottsdale Mint codebase.
What Is This Site?
Scottsdale Mint is a direct-to-consumer precious metals dealer. The platform provides:
- Real-time precious metals pricing — Product prices update every minute, sourced from the NFusion pricing API via an external Laravel middleware.
- Multiple payment methods — PayPal (cards, Apple Pay, Google Pay), ACH bank transfer, bank wire with deposit, cryptocurrency (BTC, LTC, ETH, BCH, SOL), and credit card.
- Fraud protection — Kount AI-powered Pre-Authorization review before any payment is captured.
- Full KYC verification — Identity document upload to S3 for high-value transactions.
- Tax compliance — Avalara AvaTax for real-time sales tax calculation.
- Algolia-powered search — Product search, autocomplete, and faceted filtering throughout the site.
- Elementor Pro page building — All pages and templates are managed in the Elementor visual editor.
- Multi-channel fulfillment — ShipStation + FedEx integration; Walmart Marketplace product feed.
- Marketing automation — Klaviyo (email) and Attentive (SMS) integrations with WooCommerce event triggers.
- Customer reviews — Yotpo integration for verified product reviews.
Documentation Map
Use the sidebar to navigate to any section. Key starting points:
| If you are... | Start here |
|---|---|
| Setting up a local environment | Local Development |
| Learning the system architecture | Architecture Overview |
| Working on a custom plugin | Custom Plugins |
| Working on the theme | Suma Elementor Theme |
| Debugging a payment issue | Payment Gateways |
| Understanding pricing data flow | Precious Metals Pricing |
| Deploying a change | Build & Deployment |
| Investigating fraud/orders | Fraud Detection |
| Configuring a new integration | See the project's AGENTS.md file |
Technology Overview
| Layer | Technology |
|---|---|
| CMS | WordPress 6.9.1 (Bedrock framework) |
| E-Commerce | WooCommerce 10.5.1 |
| Page Builder | Elementor Pro 3.35.3 |
| Language | PHP 8.3 |
| Database | Amazon Aurora MySQL |
| Object Cache | Valkey / Redis (Object Cache Pro, Relay client) |
| CDN | Amazon CloudFront |
| Hosting | Ymir (serverless AWS Lambda) |
| Search | Algolia |
| Tax | Avalara AvaTax |
| Fraud | Kount |
| Mailgun via WP Mail SMTP | |
| Email Marketing | Klaviyo |
| SMS | Attentive |
| Reviews | Yotpo |
Repository Overview
scottsdalemint/
├── AGENTS.md ← Full system reference for AI agents and developers
├── composer.json ← All plugins, themes, and WordPress core managed here
├── ymir.yml ← Hosting/deployment configuration
├── config/ ← WordPress configuration (environment-based)
├── docs/ ← This documentation site (Docusaurus 3.x)
├── web/ ← Web root (Bedrock convention)
│ ├── app/plugins/ ← All plugins (Composer-managed)
│ ├── app/themes/ ← suma-elementor theme
│ ├── app/mu-plugins/ ← Must-use plugins
│ └── wp/ ← WordPress core (DO NOT EDIT)
└── tools/ ← CLI tools (db-sync, nfusion-import)
Key Contacts
- Development Agency: Rhino Group
- Repository: Bitbucket (private)
- Hosting Panel: Ymir Dashboard
For AI Agents
If you are an AI coding agent, read the AGENTS.md file at the repository root before making any changes. It contains critical operational rules, coding conventions, and integration details.