How ghaly26/precious-metals-dashboard works
Queen Jewelry’s portal turns metal, purity, weight, and fee inputs into valuation quotes or invoices. The React app also supports client verification, address confirmation, PDF generation, quote notifications, and invoice shipping labels; the Express service supplies market data and handles verification, notification, and USPS operations. The README documents purity-scaled gold/silver pricing and the ounce/gram matrix. Source excerpts are partial, so uncertain endpoint wiring is omitted.
Main entry points: App.jsx Portal and calculators · server.js Spot-price service · main.jsx React entry point
Components 19
Valuation interface
- Portal and calculators
frontend/src/App.jsx - React entry point
frontend/src/main.jsx - Melt estimator
frontend/src/App.jsx - Quote and invoice PDF
frontend/src/App.jsx
Market pricing
- Spot-price service
backend/src/server.js - Price cache
backend/src/server.js - Purity and price matrix
backend/src/server.js
Client transactions
- Express API
backend/src/server.js - Invoice verification
backend/src/server.js - Address confirmation
backend/src/server.js - Quote notifications
backend/src/server.js - Shipping label creation
backend/src/server.js - Quota reminders
backend/src/server.js
External integrations
- goldprice.dev
- metals.dev
- Resend email
- USPS services
- IP geolocation
Other components
- Jewelry evaluator
Connections 23
- React entry point → Portal and calculators: renders
- Jewelry evaluator → Portal and calculators: enters inputs
- Portal and calculators → Express API: fetches prices
- Express API → Spot-price service: requests prices
- Spot-price service → Price cache: reads or writes
- Spot-price service → goldprice.dev: queries XAU/XAG
- Spot-price service → metals.dev: queries XAU/XAG
- Spot-price service → Purity and price matrix: builds price payload
- Express API → Portal and calculators: returns prices
- Portal and calculators → Melt estimator: calculates valuation
- Portal and calculators → Invoice verification: requests code
- Portal and calculators → Address confirmation: verifies address
- Portal and calculators → Quote and invoice PDF: generates document
- Portal and calculators → Quote notifications: sends quote data
- Quote notifications → Resend email: sends email
- Invoice verification → Resend email: sends code
- Portal and calculators → Shipping label creation: requests label
- Shipping label creation → USPS services: requests label
- Address confirmation → USPS services: checks address
- Quota reminders → goldprice.dev: checks usage
- Quota reminders → Resend email: sends reminder
- Express API → Quota reminders: schedules checks
- Express API → IP geolocation: looks up IP