Railway Fittings — QR Vendor Portal

A portal for railway fitting vendors to register components, stamp QR codes via laser engraver, and sell through a shared marketplace. Buyers get full traceability from the factory floor to the depot.

Register as Buyer Browse Marketplace Register as Vendor Track an Order
Features
Covers the full lifecycle — registration, engraving, sale, and inspection.

QR Code Generation

Each fitting gets two QR codes — one colour version for the web UI with the railway logo embedded, and a black-and-white 1-bit copy for the laser engraver.

ESP32 Laser Engraving

The 1-bit QR is converted to G-code and sent over WebSocket to the ESP32. Three conversion modes — raster zigzag, vector contour, and a simple fallback.

Risk Assessment

Fitting notes are checked for words like "leak", "crack", and "corrosion". A trained model scores the result and schedules the next inspection at 30, 90, or 180 days.

Component Passport

Each fitting has a scan-by-scan event log — registration, inspections, shipments, QR scans. Warranty expiry and current risk level shown inline.

Marketplace

Vendors set a price, stock count, and category per fitting. Buyers filter by category or vendor, add to cart, and check out. Stock updates at the moment of order.

Order & Shipment Tracking

Order status follows a fixed chain: Pending → Confirmed → Shipped → Delivered. Vendors enter the courier name and tracking number when marking an order shipped.

Reviews

Buyers leave a star rating and comment on the product and the vendor separately. Both show up on the respective listing and profile pages.

Admin Dashboard

Order totals, revenue, low-stock warnings, high-risk component count, upcoming inspections, expiring warranties, and a per-vendor revenue table.

Getting started
From account creation to a physical engraved fitting in four steps.
1

Register as a Vendor

Sign up with your company name, contact, railway zone, and division. Takes about a minute.

2

Register a Fitting

Fill in the UID, item type, lot number, warranty, and supply date. Risk level and inspection schedule are set automatically.

3

Engrave the QR

Hit the engrave button — G-code is generated and streamed to the ESP32 over WebSocket. The engraver runs immediately.

4

List & Fulfil Orders

Set a price and list the fitting. When a buyer orders, update the shipment status from your dashboard. Every QR scan logs to the passport.

SQLite
fittings.db + vendors.db
3
G-code modes: raster, vector, fallback
scikit-learn
Risk model
ESP32
WebSocket G-code push
per-scan
Passport event logging

Vendor or buyer?

Vendors register and manage fittings. Buyers can create an account for faster checkout and order history.

Create Buyer Account Create Vendor Account Buyer Sign In