# vaish1101/vintage-watch-parts-pricing-turnover-intelligence architecture

> Architecture diagram of the GitHub repository vaish1101/vintage-watch-parts-pricing-turnover-intelligence, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence
- Repository: https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence

## Overview

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: [`src/vwp_intelligence/contract.py`](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/contract.py) (Dashboard contract), [`scripts/build_demo_data.py`](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/scripts/build_demo_data.py) (Synthetic data generator), [`src/vwp_intelligence/cleaning.py`](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/cleaning.py) (Inventory normalization), [`src/vwp_intelligence/evidence.py`](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/evidence.py) (Evidence acceptance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Demo inputs"]
  node_demo_generator["Synthetic data generator<br/>[build_demo_data.py]"]
  node_inventory_cleaning["Inventory normalization<br/>[cleaning.py]"]
  node_inventory_identity["Inventory identity<br/>[identity.py]"]
  node_csv_ingestion["CSV inventory reader<br/>[ingestion.py]"]
end

subgraph group_evidence["Evidence governance"]
  node_candidate_matching["Candidate scoring<br/>[matching.py]"]
  node_evidence_governance["Evidence acceptance<br/>[evidence.py]"]
end

subgraph group_analytics["Decision analytics"]
  node_pricing["Price recommendations<br/>[pricing.py]"]
  node_turnover["Turnover estimates<br/>[turnover.py]"]
  node_contract_builder["Dashboard contract<br/>[contract.py]"]
end

subgraph group_presentation["Dashboard"]
  node_dashboard_data["Frozen dashboard data<br/>[demo-data.json]"]
  node_dashboard_app["Read-only dashboard<br/>[app.js]"]
end

node_dashboard_user(("Dashboard user"))

node_demo_generator -->|"normalizes inventory"| node_inventory_cleaning
node_demo_generator -->|"builds contract"| node_contract_builder
node_demo_generator -->|"writes JSON"| node_dashboard_data
node_csv_ingestion -->|"normalizes rows"| node_inventory_cleaning
node_inventory_cleaning -->|"canonicalizes identifiers"| node_inventory_identity
node_contract_builder -->|"classifies evidence"| node_evidence_governance
node_contract_builder -->|"prices items"| node_pricing
node_contract_builder -->|"estimates turnover"| node_turnover
node_evidence_governance -->|"scores candidates"| node_candidate_matching
node_dashboard_app -->|"reads contract"| node_dashboard_data
node_dashboard_user -->|"views results"| node_dashboard_app

click node_demo_generator "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/scripts/build_demo_data.py"
click node_inventory_cleaning "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/cleaning.py"
click node_inventory_identity "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/identity.py"
click node_csv_ingestion "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/ingestion.py"
click node_candidate_matching "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/matching.py"
click node_evidence_governance "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/evidence.py"
click node_pricing "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/pricing.py"
click node_turnover "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/turnover.py"
click node_contract_builder "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/contract.py"
click node_dashboard_data "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/dashboard/demo-data.json"
click node_dashboard_app "https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/dashboard/app.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_demo_generator,node_inventory_cleaning,node_inventory_identity,node_csv_ingestion,node_dashboard_user toneBlue
class node_candidate_matching,node_evidence_governance toneAmber
class node_pricing,node_turnover,node_contract_builder toneMint
class node_dashboard_data,node_dashboard_app toneRose
```

## Components

### Demo inputs

- [Synthetic data generator](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/scripts/build_demo_data.py): `scripts/build_demo_data.py`
- [Inventory normalization](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/cleaning.py): `src/vwp_intelligence/cleaning.py`
- [Inventory identity](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/identity.py): `src/vwp_intelligence/identity.py`
- [CSV inventory reader](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/ingestion.py): `src/vwp_intelligence/ingestion.py`

### Evidence governance

- [Candidate scoring](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/matching.py): `src/vwp_intelligence/matching.py`
- [Evidence acceptance](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/evidence.py): `src/vwp_intelligence/evidence.py`

### Decision analytics

- [Price recommendations](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/pricing.py): `src/vwp_intelligence/pricing.py`
- [Turnover estimates](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/turnover.py): `src/vwp_intelligence/turnover.py`
- [Dashboard contract](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/src/vwp_intelligence/contract.py): `src/vwp_intelligence/contract.py`

### Dashboard

- [Frozen dashboard data](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/dashboard/demo-data.json): `dashboard/demo-data.json`
- [Read-only dashboard](https://github.com/vaish1101/vintage-watch-parts-pricing-turnover-intelligence/blob/main/dashboard/app.js): `dashboard/app.js`

### Other components

- **Dashboard user**

## Connections

- Synthetic data generator → Inventory normalization: normalizes inventory (evidence: `scripts/build_demo_data.py`)
- Synthetic data generator → Dashboard contract: builds contract (evidence: `scripts/build_demo_data.py`)
- Synthetic data generator → Frozen dashboard data: writes JSON (evidence: `scripts/build_demo_data.py`)
- CSV inventory reader → Inventory normalization: normalizes rows (evidence: `src/vwp_intelligence/ingestion.py`)
- Inventory normalization → Inventory identity: canonicalizes identifiers (evidence: `src/vwp_intelligence/cleaning.py`)
- Dashboard contract → Evidence acceptance: classifies evidence (evidence: `src/vwp_intelligence/contract.py`)
- Dashboard contract → Price recommendations: prices items (evidence: `src/vwp_intelligence/contract.py`)
- Dashboard contract → Turnover estimates: estimates turnover (evidence: `src/vwp_intelligence/contract.py`)
- Evidence acceptance → Candidate scoring: scores candidates (evidence: `src/vwp_intelligence/evidence.py`)
- Read-only dashboard → Frozen dashboard data: reads contract (evidence: `README.md`)
- Dashboard user → Read-only dashboard: views results (evidence: `README.md`)
