RetailPOS — arxitektura + PRD

• Bu nima: Chakana savdo uchun Point-of-Sale platformasi ("RetailPOS"): sotuvlar, ombor hisobi, mahsulotlar/komplektlar, oversell'dan himoyalangan ko'p terminalli qoldiq nazorati, sinxronizatsiya protokolli offline rejim, desktop kassa. Foydalanuvchining shaxsiy fullstack scaffold'i asosida qurilgan (fin_fullstack/shipkit bilan bir xil stek).
• Turi / holati / roli: web-app (+desktop) · active · contributor (arxitektor / spetsifikatsiya muallifi) — foydalanuvchi PRD/arxitekturani yozgan (4 kommit, ammo bu spetsifikatsiyaning o'zagi), asosiy implementator — Nuriddinkhuja (23 kommit).
• Faol davr: 2026-01-02 → 2026-02-17 (~1.5 oy), 27 kommit.

• Monorepo: Turborepo + Bun, .mcp.json (shadcn MCP). Ilovalar: web (Next.js 16 + React 19, next-intl ru/en/uz, Better Auth, Eden Treaty, Tailwind v4), api (Elysia/Bun + Better Auth + Swagger), admin (Next.js), `desktop` (offline sinxronizatsiyali desktop kassa). Package'lar: auth/cache/cli/db/email/entities/eslint-config/typescript-config/ui — foydalanuvchining boilerplate'i bilan aynan bir xil.
• Backend: Elysia + Drizzle ORM + Postgres, versiyalangan modullar /src/modules/v1.
• Hujjatlar (foydalanuvchi hissasining o'zagi): docs/prd/ — strukturalangan PRD: 00-overview (336L), 01-architecture (680L), 02-database-schema (1103L), 03-api-specification (1006L), apps/{desktop-app 717L, admin-panel 873L, sync-protocol 809L}, modules/{sales 466L, inventory 308L, products 548L}, 13-roadmap (487L) + bosqichma-bosqich roadmap.

Kommitlar/PRD bilan tasdiqlangan (foydalanuvchi mualliflik qilgan):

• POS uchun offline-first sinxronizatsiya protokoli (docs/prd/apps/12-sync-protocol.md, 809L): desktop kassaning server bilan offline ishlashi uchun sinxronizatsiya protokolini loyihalashtirdi — POS'dagi eng qiyin vazifalardan biri. → taqsimlangan izchillik (consistency) dizayni.
• Ko'p terminalli qoldiq rezervatsiyasi (0e5aaa7, DB schema + API): bir vaqtning o'zida bir nechta kassa sotayotganda oversell'dan himoyalangan mahsulot komplektlari + qoldiq rezervatsiyasi. → concurrency/ombor hisobini tushunish.
• Spec-driven arxitektura: implementatsiyadan oldin/bilan birga ~8000 qatorlik PRD (DB schema 1103L, API spec 1006L) — jamoa va AI uchun muammo bayoni. → tech-lead/arxitektor roli.
• Shaxsiy boilerplate'ni qayta ishlatish: RetailPOS shaxsiy Turborepo scaffold (Elysia+Next+Better Auth+Drizzle+Eden) asosida bootstrap qilingan — fin_fullstack/shipkit bilan bir xil poydevor. → tizimli va qayta ishlatsa bo'ladigan yondashuv.

• Topilgan sessiyalar: 0 ta transkript. Sessiya katalogida faqat sessions-index.json bor (.jsonl yo'q). Repozitoriyda .claude/ + .claude/commands/roadmap.md (foydalanuvchi qo'shgan maxsus roadmap-status slash buyrug'i) mavjud.
• AI bilan nima qilingan: spec-driven jarayon — PRD + roadmap + maxsus .claude/commands foydalanuvchi jamoa uchun AI vorkflow'ini sozlaganini ko'rsatadi (agent PRD bo'yicha kod yozadi).
• AI vorkflow patternlari: PRD-first + roadmap uchun maxsus slash buyruqlar; foydalanuvchi "AI/jamoani boshqaruvchi arxitektor" sifatida.

• Foydalanuvchi tomonidan yozilgan ~8000 qatorlik strukturalangan PRD (arxitektura, DB, API, sync protocol).
• Bitta Turborepo'da web + admin + desktop + offline sinxronizatsiyali fullstack POS.
• Ko'p terminalli qoldiq rezervatsiyasi (oversell'ga qarshi).
• i18n ru/en/uz.