How vaish1101/vintage-watch-parts-pricing-turnover-intelligence works
This repository publishes a synthetic-data vintage watch-parts pricing and turnover demo. Its workflow generates sample inventory and marketplace candidates, normalizes inventory, scores and deduplicates evidence, computes pricing and turnover, builds a dashboard contract, and presents that frozen JSON in a read-only dashboard. The pricing and turnover stages are distinct and both are orchestrated by the contract builder. The README documents the dashboard’s use of the frozen contract; private operational storage and live marketplace retrieval are described but not included as public runtime components.
Main entry points: contract.py Dashboard contract · build_demo_data.py Synthetic data generator · cleaning.py Inventory normalization · evidence.py Evidence acceptance
Components 12
Demo inputs
- Synthetic data generator
scripts/build_demo_data.py - Inventory normalization
src/vwp_intelligence/cleaning.py - Inventory identity
src/vwp_intelligence/identity.py - CSV inventory reader
src/vwp_intelligence/ingestion.py
Evidence governance
- Candidate scoring
src/vwp_intelligence/matching.py - Evidence acceptance
src/vwp_intelligence/evidence.py
Decision analytics
- Price recommendations
src/vwp_intelligence/pricing.py - Turnover estimates
src/vwp_intelligence/turnover.py - Dashboard contract
src/vwp_intelligence/contract.py
Dashboard
- Frozen dashboard data
dashboard/demo-data.json - Read-only dashboard
dashboard/app.js
Other components
- Dashboard user
Connections 11
- Synthetic data generator → Inventory normalization: normalizes inventory
scripts/build_demo_data.py - Synthetic data generator → Dashboard contract: builds contract
scripts/build_demo_data.py - Synthetic data generator → Frozen dashboard data: writes JSON
scripts/build_demo_data.py - CSV inventory reader → Inventory normalization: normalizes rows
src/vwp_intelligence/ingestion.py - Inventory normalization → Inventory identity: canonicalizes identifiers
src/vwp_intelligence/cleaning.py - Dashboard contract → Evidence acceptance: classifies evidence
src/vwp_intelligence/contract.py - Dashboard contract → Price recommendations: prices items
src/vwp_intelligence/contract.py - Dashboard contract → Turnover estimates: estimates turnover
src/vwp_intelligence/contract.py - Evidence acceptance → Candidate scoring: scores candidates
src/vwp_intelligence/evidence.py - Read-only dashboard → Frozen dashboard data: reads contract
README.md - Dashboard user → Read-only dashboard: views results
README.md