📄 TECHNICAL BRIEF
All developments must be carried out step by step, in the following order (from 1 to 4).
1️⃣ Real-Time Price Update Banner on the Homepage
Objective: Display real-time precious metal prices dynamically on the homepage.
Data Source: MetalPrice API
Deliverables:
✅ Integration of a dynamic price banner on the homepage
✅ Data retrieval via MetalPrice API
✅ Mapping and formatting based on the provided model
✅ Full integration with our PrestaShop theme (Shopicca)
✅ We can provide amateur-level code we started with to support this feature
2️⃣ "Buy-back" Option (Client Resale)
Objective: Allow customers to resell their precious metals directly on the site.
Expected Features:
✅ API integration via StoneX Bullion API (Reseller API V3 documentation)
✅ Wizard-type form (product type, quantity, live valuation)
✅ Admin-side validation + automatic email notifications
✅ Display of ongoing resale offers in the client dashboard
✅ Fully integrated into the PrestaShop theme (Shopicca)
3️⃣ 📊 Custom Client Dashboard
Features:
✅ Categorized product summary (Gold, Silver, Platinum, Palladium)
✅ Real-time metal prices + total portfolio value
✅ % variation compared to initial purchase price
✅ Display of product thumbnails, titles, quantities, and totals
✅ “Buy” / “Sell” buttons with custom redirection
✅ Fully integrated into the PrestaShop theme (Shopicca)
4️⃣ Site Adjustments
General Fixes & UI Enhancements:
✅ Modify the font used in the main slider (homepage banner)
✅ Ensure image uploads work correctly in product categories (back-office & front-end)
✅ Integrate a historical price chart (since 1968) via the MetalPrice API – A partial version was already coded but needs to be correctly integrated into PrestaShop
✅ Display the language selector and currency switcher in the site’s sticky banner – A visual example is provided
🧪 Development & Deployment Instructions
• All work must be performed on the staging environment: 🔗 https://dev.gold-heritage.com
• Once all tasks are complete, tested, and bug-free: 🔁 Transfer the entire codebase and features to production: 🔗 https://gold-heritage.com
• Final testing and QA must be done after deployment to production to ensure full compatibility.
🔒 Technical & Security Considerations
• Follow PrestaShop best practices (clean overrides, custom modules, etc.) • Write well-commented and documented code • No modifications to PrestaShop core • Secure all API interactions • Implement robust error handling (logs, alerts, fallback for API downtime)