Skip to content

About

BuildDraft.gr — Σύγκριση τιμών εξαρτημάτων υπολογιστή στην Ελλάδα από Skroutz, BestPrice, Shopflix, Snif και e-shop.gr, με ιστορικό τιμών και συναρμολόγηση υπολογιστή. © 2026 Teo Ampatzis

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

706 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BuildDraft.gr (v2.0)

Automated PC hardware price aggregation, merchant intelligence, and deterministic hardware compatibility engine for the Greek market.

Live Demo License Sync Cron Tests Lighthouse

Key Features • What's New in v2.0 • Architecture • Compatibility Engine • Tech Stack • Quickstart • Docs


⚡ Overview

BuildDraft.gr is an open-source, serverless web platform designed to solve PC building and price tracking for Greek consumers. By aggregating real-time prices from Skroutz, BestPrice, Shopflix, Snif, and e-shop.gr, BuildDraft surfaces true market lows, shipping costs, and price history trends across 9 hardware categories.

Built on an ultra-lean Static-Edge architecture, the application requires zero operational database infrastructure. Automated Python workers scrape and normalize merchant data every 6 hours on GitHub Actions, emitting hash-chunked JSON artifacts directly consumed by a high-performance React + TypeScript SPA hosted on Vercel's global edge network.


🌟 Key Features

  • Multi-Retailer Price Tracking: Compares live offers across major Greek marketplaces (Skroutz, BestPrice, Shopflix, Snif, e-shop.gr), ranking items by true total cost (product price + shipping).
  • Historical Price Trends & Dips: Tracks 7-day price fluctuations, all-time lows, and retailer promotional tags.
  • Dual-Mode PC Builder:
    • Guided Walkthrough: Tailored component recommendations dynamically adapted to target budget and use case (Gaming, Workstation, Office).
    • Freeform Workbench: Flexible part-list builder with instant hardware verification, live power tally, and shop grouping.
  • Industrial Compatibility Engine: 30 deterministic rules validating physical clearances (GPU length, cooler height, case radiator support), electrical demands (GPU TGP, CPU PL2/PPT), and motherboard chipset/BIOS matching.
  • Stateless Build Sharing & Export: Compressed URL sharing (/builder?b=...), localStorage auto-recovery, and one-click Markdown clipboard export for tech forums, Reddit, and Discord.
  • Zero-DB Edge Performance: Critical first load < 100 KB gzip, Progressive Hash Chunks (mod 256), CLS = 0.000, and 95–100 Lighthouse rating on mobile.
  • Bilingual & Responsive: Full Greek (EL) and English (EN) localization with a sleek, dark-first design system responsive from 360px smartphones to 4K displays.

🚀 What's New in v2.0 (v1 vs v2)

Version 2.0 is a complete generational leap over v1.0, re-architecting the application from the ground up for speed, reliability, and precision engineering.

Feature / Metric BuildDraft v1.0 (Legacy) BuildDraft v2.0 (Current)
Hardware Verification Basic string matching (socket only) 30 Deterministic Rules + official vendor spec matrices (power curves, dimensions, BIOS, lanes).
PC Assembly Flow Rigid linear form Dual-Mode: Guided intent/budget builder + Freeform Part List Workbench.
Recommendation Engine Naive sorting by price Intelligent Tier Balancing scoring components by budget proportion and workload.
Data Integrity Layer Direct scraper output SAFER Ingestion Guard rejecting abnormal dimensions and resolving merchant naming collisions.
System Power Modeling Static nominal wattage Dynamic Load Modeling (CPU PL2/PPT limits + GPU TBP + ATX 3.0/3.1 12V-2x6 checks).
Build Sharing Unstable hash strings Compact State Compression (/builder?b=...) + Markdown export + auto-save.
Asset Delivery Monolithic multi-MB JSON files Progressive Hash Chunks (<25 KB gzip per category slice mod 256).
Quality Assurance Basic smoke checks 1,440+ Automated Tests across 55 suites (100% pass) + 81 compatibility benchmarks.

📸 Visual Comparison

1. Hardware Catalog & Filtering

Version 1.0 (Legacy Catalog) Version 2.0 (Modern Catalog)
v1 Catalog v2 Catalog
Dense tables with basic text filtering. Modern dark-first cards, fast facet filtering, and availability badges.

2. PC Builder & Guided Recommendations

Version 1.0 (Linear Form) Version 2.0 (Smart Recommendations)
v1 Builder Flow v2 Recommendations
Rigid step progression without budget guidance. Budget allocation, tier recommendations, and contextual warnings.

3. Freeform Workbench & Comprehensive Compatibility Review

Version 1.0 (Simple Summary) Version 2.0 (Deep Compatibility & Multi-Shop Review)
v1 Review v2 Compatibility Review
Basic list without clearance verification. 30-point physical & electrical validation with per-shop checkout breakdown.

Detailed technical migration notes and analysis can be found in docs/v1-to-v2-evolution.md.


🏗️ System Architecture

BuildDraft utilizes a decoupled static-first architecture. It combines automated serverless scraping pipelines with high-speed static edge distribution:

flowchart TD
    subgraph DataCollection["Data Collection & Ingestion (Every 6h)"]
        A1["Skroutz / BestPrice / Shopflix / Snif / e-shop.gr"] --> A2["Python Scraper (curl_cffi + selectolax)"]
        A2 --> A3["SAFER Bounds & Range Validation"]
        A3 --> A4["Product Aliasing & Sibling Deduplication"]
        A4 --> A5["Custom Git History Merge Driver"]
    end

    subgraph StaticStorage["Static Storage & Optimization"]
        A5 --> B1["public/data/ JSON Manifests"]
        B1 --> B2["Category Slices & Model Chunks (mod 256)"]
        B2 --> B3["Vite Build Pipeline (Static Optimization)"]
    end

    subgraph EdgeDelivery["Edge Distribution (Vercel)"]
        B3 --> C1["Vercel Global Edge CDN"]
        C1 --> C2["Immutable Cache Headers (stale-while-revalidate)"]
    end

    subgraph ClientApplication["Client-Side Application (SPA)"]
        C2 --> D1["React 18 + TypeScript SPA"]
        D1 --> D2["Web Worker Compatibility Engine (30 Rules)"]
        D1 --> D3["Dual-Mode PC Builder (Guided + Freeform)"]
        D1 --> D4["Bilingual Localized UI (EL / EN)"]
    end
Loading

⚙️ Compatibility Engine

The deterministic compatibility engine (src/engine/rules.ts) evaluates component pairings against 30 strict hardware constraints:

  1. Physical Clearances:
    • Rule 1: GPU length vs. Case maximum clearance.
    • Rule 2: CPU cooler height vs. Case maximum cooler clearance.
    • Rule 3: Motherboard form factor (E-ATX, ATX, Micro-ATX, Mini-ITX) vs. Case support.
    • Rule 4: Radiator sizing (120/240/280/360 mm) vs. Case top/front mounting brackets.
  2. Electrical & Power Safety:
    • Rule 14: Estimated system load calculation (GPU TGP/TBP + CPU PL2/PPT + 100W peripheral overhead) vs. PSU rated continuous wattage.
    • Rule 15: PSU form factor compatibility (SFX, SFX-L, ATX) vs. Case mounting.
    • Rule 16: High-power GPU connector validation (ATX 3.0 / 3.1 12V-2x6 & 12VHPWR native vs. adapter requirements).
  3. Architecture & Chipsets:
    • Rule 5: CPU socket vs. Motherboard socket (AM4, AM5, LGA1700, LGA1851).
    • Rule 13: Chipset generation compatibility and BIOS flashback necessity.
    • Rule 25: Memory generation (DDR4 vs. DDR5) and official CPU native memory speed bounds.
    • Rule 27-30: Hardware balance scoring (preventing extreme bottlenecks like low-end CPUs paired with flagship GPUs).

All engine rules are benchmarked continuously against 81 real-world scenarios in tests/compat/engine-scenarios.test.ts.


🛠️ Tech Stack


💻 Quickstart & Local Development

Prerequisites

  • Node.js >= 20.x
  • npm >= 10.x
  • Python >= 3.12 (optional, required only for running the local scraper)

1. Web Application

# Clone the repository
git clone https://github.com/TeoAmpatzis/gpu-prices-gr.git
cd gpu-prices-gr

# Install dependencies
npm install

# Start development server (http://localhost:5173)
npm run dev

# Run comprehensive test suite (1,440+ tests)
npm test

# Run type checking
npm run typecheck

# Production build preview
npm run build
npm run preview

2. Scraper Execution (Optional)

# Set up Python virtual environment
python -m venv venv
venv/Scripts/activate  # On Windows: venv\Scripts\activate | On Unix: source venv/bin/activate

# Install scraper dependencies
pip install -r scraper/requirements.txt

# Run scraper for a single category (e.g. GPU)
python scraper/main.py --category gpu

# Run full multi-category scraper
python scraper/main.py

📂 Project Structure

├── .github/workflows/       # Automated 6h scraper cron & history sync workflows
├── docs/
│   ├── assets/              # Curated v1 & v2 screenshots and media
│   └── v1-to-v2-evolution.md# Detailed technical migration analysis
├── public/data/             # Static JSON pricing database, models, and history
├── scraper/                 # Python scraping engine, SAFER validation, normalizers
├── src/
│   ├── components/
│   │   └── builder/         # Guided & Freeform PC builder components
│   ├── engine/              # Hardware compatibility engine (Rules 1-30 & spec tables)
│   ├── lib/                 # Core utilities, filtering, state management, formatting
│   └── shell/               # Navigation, global search, layout, bilingual strings
├── tests/
│   ├── compat/              # 81 compatibility benchmark scenario suites
│   ├── e2e/                 # Playwright end-to-end user journey tests
│   └── unit/                # 1,400+ Vitest unit tests
├── CHANGELOG.md             # Semantic version history
└── vercel.json              # Edge rewrites, route rules, and immutable caching

📄 License & Legal Notice

Code distributed under the PolyForm Noncommercial 1.0.0 license.

  • Non-Commercial Use: Free for personal use, education, research, and inspection.
  • Commercial Use: Commercial deployment or use in revenue-generating services requires prior written permission from the author.
  • Brand & Identity: The name BuildDraft, logos, and visual marks are protected and may not be used without authorization.

Data & Trademarks

All product names, logos, prices, and retailer trademarks (Skroutz, BestPrice, Shopflix, Snif, e-shop.gr) are the property of their respective owners. BuildDraft.gr is an independent aggregator and is not affiliated with or endorsed by any merchant or hardware vendor.


Crafted with care by Theodoros Ampatzis

About

BuildDraft.gr — Σύγκριση τιμών εξαρτημάτων υπολογιστή στην Ελλάδα από Skroutz, BestPrice, Shopflix, Snif και e-shop.gr, με ιστορικό τιμών και συναρμολόγηση υπολογιστή. © 2026 Teo Ampatzis

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages