Seller OS

Sarmoya Ustasi — O'zbekiston marketpleyslarida savdo boshlamoqchi bo'lganlar uchun 6 qadamli yo'l: profil → yo'nalish → tovar va miqdor → Xitoydan topish → buyurtma va kargo → do'kon va sotish.

Farqi: tavsiyani kod beradi, AI faqat tushuntiradi. Quruq statistika yolg'on gapiradi, shuning uchun har tavsiya 8 ta hiyla-filtrdan o'tadi.

Avval shularni o'qing

Fayl	Nima
QOIDALAR.md	Agent konstitutsiyasi. Har sessiya shundan boshlanadi
SXEMA.md	Ma'lumot modeli
FORMULA.md	Ball tizimi (v0 — tasdiq kutmoqda)
TUZOQLAR.md	8 hiyla-filtr
BACKLOG.md	Yangi g'oyalar — joriy bosqichga emas
docs/SKREYPER.md	Uzum ma'lumotini yig'ish: ish oqimlari, jadvallar, kuzatuv namunasini yangilash, tekshirish, ma'lum muammolar

Tuzilishi

apps/backend     Fastify — yagona kirish nuqtasi
apps/web         Next.js — Usta suhbati (uz/ru); tartibni server beradi
apps/extension   Chrome MV3 — Uzum sahifasida "Xitoydan top"
apps/studiya-worker  Cloudflare Worker — 9-qadam: surat oq fonda, 3:4 (docs/STUDIYA.md)
apps/scraper     Python — yig'uvchi, "hurmat rejimi"
packages/shared  Ball, tuzoq turlari, chegaralar — BITTA joyda
supabase/        Migratsiyalar va seed

Web, bot va kengaytma bazaga to'g'ridan-to'g'ri tegmaydi — hammasi backend API orqali. Sabab: tavsiya mantiqi bitta joyda tursin.

ZumSavdo va SellerOS — BITTA mahsulot

Buni birinchi oʻqing. Agent bu yerda ikki marta adashgan (2026-08-24 va 2026-08-25) va ikkalasida ham xato bir xil boʻlgan: ikkita nom ikkita mahsulot deb tushunilgan.

Nom	Nima
ZumSavdo	Mahsulotning nomi. Foydalanuvchi shuni koʻradi.
seller-os	Shu mahsulotning kod ombori. Ichki nom.
zumsavdo sxemasi	Bazadagi Uzum xom oʻlchovi (~1,5 mln tovar)
selleros sxemasi	Bazadagi Usta maʼlumoti — profil, tavsiya, obuna

Bitta sayt, bitta Vercel loyihasi: apps/web. / sotuv sahifasi · /usta Usta (suhbat, 12 qadamli ssenariy) · /olchov ichki panel. Alohida "ZumSavdo sayti" degan narsa YOʻQ.

Dizayn — apps/web/dizayn/

Nazoratchi tasdiqlagan dizayn (2026-09-24) — ikki ekran, manba fayllari shu papkada:

Fayl	Sahifa
ZUMSavdo-K-Journey-Tinted.dc.html	/ — bosh sahifa ("Besh bekat")
ZUMSavdo-Chat.dc.html	/usta — suhbat
ZUMSavdo-Chat-print.dc.html	butun yoʻl bir sahifada (yorugʻ)

Qora + sariq, tungi mavzu standart, Instrument Sans + JetBrains Mono. Tokenlar apps/web/src/app/globals.css dagi .zs-mavzu da — ikkala sahifa uchun bitta. Dizayndan qayerda va nega chetga chiqilgani — dizayn/HOLAT.md.

Ishga tushirish

cp .env.example .env     # to'ldiring — `.env` omborga tushmaydi
npm install
npx vitest run           # Node testlari
cd apps/scraper && pip install -e '.[dev]' && python -m pytest -q

Bosqichlar

B0 poydevor · B1 ma'lumot + birinchi filtrlar · B2 Usta 1–3-qadam · B3 to'lov va kirish · B4 Xitoy qadami · B5 kartochka va xizmatlar · B6 kengayish (WB, Yandex)

Har bosqich darvoza bilan qulflanadi: testdan o'tmasa keyingisi boshlanmaydi.

---

Ichki loyiha.