Middleware Platform
The Middleware Platform (repository: certilock-storage) is a Laravel 11 application that acts as the central nervous system connecting the Scottsdale Mint ecosystem. It exposes APIs, ingests webhooks, and orchestrates automated price synchronisation across all customer-facing storefronts.
What Does This Platform Do?
| Capability | Description |
|---|---|
| CertiLock Image API | Serves signed product-sealing images stored in AWS S3, keyed by serial number |
| Shipping Dashboard | Filament admin page that visualises ShipStation shipping data in real time |
| NFusion Pricing Sync | Pulls live precious-metals spot prices from nFusion and distributes them to WooCommerce, Algolia, and HTTP targets |
| ShipStation Webhooks | Ingests ORDER_NOTIFY and SHIP_NOTIFY events, storing order/shipment data locally |
| WooCommerce Webhook | Receives product-update events from the Retail and Dealers WooCommerce sites to keep the local products table current |
Technology Stack
| Layer | Technology |
|---|---|
| Framework | Laravel 11 (PHP 8.3+) |
| Admin Panel | Filament v3 |
| Queue | Laravel Queues (Redis or Database driver) |
| Storage | AWS S3 (certilock-storage bucket) |
| Database | MySQL / MariaDB |
| Hosting | Laravel Vapor (AWS Lambda) or local Herd / Sail |
| Package Manager | Composer (PSR-4 autoloading) |
Repository Structure
certilock-storage/
├── app/
│ ├── Console/ # Artisan commands
│ ├── Filament/ # Admin panel pages, resources, actions
│ ├── Http/Controllers/ # ImageAPI, ShipStation & WooCommerce webhooks
│ ├── Jobs/ # NFusionSyncTenantPricesJob
│ ├── Models/ # Eloquent models
│ ├── Services/ # NFusionService, PriceSyncService, ShipStationService
│ └── SyncTargets/ # Algolia, HTTP, WooCommerce sync providers
├── config/ # App config, nfusion.php, sync-targets.php etc.
├── database/ # Migrations, factories, seeders
├── docs/ # This Docusaurus documentation site
├── routes/
│ ├── api.php # Public API routes (image, webhooks)
│ └── web.php
└── vapor.yml # Laravel Vapor deployment configuration