STOCKBRIDGE — SERVER UPLOAD GUIDE (Roman Urdu)

1. Sirf design aur demo check karna hai
ZIP extract karein. stockbridge/public/ ke andar index.html, app.js aur style.css hain.
In 3 files ko apne test subdomain ke document root (aksar httpdocs) mein upload karein.
Domain open karein. Yeh browser demo hoga: data sirf us browser mein save hoga.
Is se Amazon/eBay connect ya real database activate nahi hota.

2. Asal database aur login ke saath chalana hai
Python 3.12+ ya Docker wala VPS aur SSH/terminal access chahiye.
Pooray stockbridge folder ko website document root KE BAHAR upload karein.
README.md mein Python aur Docker, dono ke startup steps diye gaye hain.
Python start:
  python3 server.py --hash-password
Is command ke output ko ADMIN_PASSWORD_HASH environment variable mein set karein.
Phir:
  python3 server.py
Default backend 127.0.0.1:8080 par chalega. Apne HTTPS subdomain ka reverse proxy
is backend ki taraf configure karein. HTTPS use karte waqt COOKIE_SECURE=1 set karein.
Docker option ke liye compose.yaml aur .env.example diye gaye hain.

IMPORTANT: Poora source, .env aur data/database folder public httpdocs mein mat rakhein.
Sirf public/ wali frontend files demo ke liye public folder mein jaati hain.
Public static demo aur Python backend alternative serving modes hain. Full app ke liye
website ko backend ki taraf proxy karein; sirf static frontend host karna kaafi nahi.

3. Real Amazon/eBay sync
Abhi koi real store connected nahi. API app registration, har seller ki authorization,
per-store refresh tokens, SKU mapping aur controlled live testing zaroori hain.
Live writes default se OFF hain. Setup/test ke baghair enable na karein.
API passwords/tokens chat mein share na karein.

4. Current release
Working inventory/order core hai; complete Linnworks clone nahi.
9 core stock tests pass; demo logic aur login/CSRF/database checks pass.
Staff roles, FBA inventory, carrier labels, marketplace shipment notifications,
returns aur full OAuth connection UI abhi implemented nahi.
Amazon/eBay adapters ka real seller accounts par validation abhi baqi hai.
