§01
Umumiy ko'rinish
- Bu nima: Self-service terminal vendor (UZ) uchun marketing sayti (menejment konsalting/trening, Toshkent — ai_club'da uchraydi), landing sahifasi (Figma bo'yicha 10 ta bo'lim) va kontentni boshqarish uchun admin CMS (kategoriyalar, sertifikatlar, bo'limlar, sayt sozlamalari). Tilda'dan (no-code) to'liq kod asosidagi stack'ga ko'chirilgan.
- Turi / statusi / roli: web-app (korporativ sayt + CMS) · faol (oxirgi kommit 2026-05-21) · yakka (56 kommitdan 55 tasi foydalanuvchiniki; Bobur Juraev 1 ta).
- Faollik davri: 2025-11-10 → 2026-05-21 (~6 oy), faol.
§02
Stek
- Tillar: TypeScript.
- Freymvork/kutubxonalar: shaxsiy SaaS boilerplate — Turborepo + Bun; app'lar: web (Next.js 16, App Router, SSR/SSG, next-intl ru/en/uz), api (Elysia.js, tiplashtirilgan), admin (Next.js, RBAC, auth bilan himoyalangan); paketlar: auth (Better Auth, subdomenlararo), db (Drizzle ORM + Postgres), cache (ioredis), ui (shadcn/ui), email (React Email + Resend), entities, cli; Eden Treaty (tip-xavfsiz API klient); Polar.sh (boilerplate'dagi to'lovlar).
- Infra/deploy: Turborepo,
.env.example,.claude/skills/(deploy/dizayn uchun AI qo'llanmalari), PORT orqali boshqariladigan listen. - Ma'lumotlar: PostgreSQL (Drizzle), Redis.
- E'tiborga molik tooling:
.mcp.json,.tmp_screenshots/(112 skrinshot — chrome-devtools orqali UI iteratsiyalari),backup/(Tilda sayti snapshot'i havola sifatida).
§03
Nima qilindi
Yakka o'zi 55 ta kommit yozilgan (diff'lar/xabarlar bo'yicha):
- Self-service terminal vendor (UZ) landing (2026-apr): Figma bo'yicha 10 ta bo'lim (
a062472), kontaktlar + til almashtirgichli header (63f2cce), footer (77be717), SSR data fetch + tiplar (09ea6c1), SSR ma'lumotlar bilan sahifa yig'ish va boilerplate'ni tozalash (4afcb97). - Admin CMS (2026-apr): kategoriyalar uchun CRUD (
aedffef), sertifikatlar (7c50a6f), bo'limlar (7691f83), sayt sozlamalari sahifasi (e284037), CMS sidebar navigatsiyasi (2ff7f4a), Toaster/sonner (ac24d82). - Sayqal/tiplar (2026-may): env orqali boshqariladigan subdomenlararo auth (
3b3745a), Better Auth permission body-key tuzatishi (6e95e1f), strict build'larda ko'chmas tip inferensiyasini chetlab o'tish uchun Eden Treaty/authClient annotatsiyalari (286c873,fa2508f,14be13f), brand-logos/dc-pins modullari + yangi bo'limlar (3eeb13c), UI'ni Tilda havolasiga moslashtirish (3b3051c,6b7b831), Self-service terminal vendor (UZ) favicon. - Ko'lam: 6 oy davomida 56 kommit; to'liq sikl — boilerplate'dan CMS'li production saytigacha.
§04
Texnik chellenjlar
Diff'lar bo'yicha (yakka mualliflik):
- Elysia + Drizzle + Next admin ustidagi headless CMS: dinamik landing bo'limlari DB'dan SSR fetch orqali render qilinadi (
09ea6c1,4afcb97); kontentni boshqarish (kategoriyalar/sertifikatlar/bo'limlar/sozlamalar) tiplashtirilgan API orqali. → Statik emas, to'liq kontent-sayt + CMS juftligi. - Subdomenlararo Better Auth (
3b3745a): web va admin subdomenlari o'rtasida sessiyalarni bo'lishish uchun env orqali boshqariladigan konfiguratsiya. → Haqiqiy ko'p-domenli autentifikatsiya. - TypeScript strict + Eden Treaty bilan kurash (
286c873,fa2508f,14be13f): build paytida ko'chmas tip inferensiyasini chetlab o'tish uchun klient annotatsiyalari — Eden/Better Auth uchun tipik, lekin oson bo'lmagan holat. → TS tiplashtirishdagi chuqurlik. - AI asosidagi vizual iteratsiya:
.tmp_screenshots/ichida 112 skrinshot + havola sifatida Tilda backup → foydalanuvchi UI'ni chrome-devtools orqali Figma/Tilda'ga iterativ ravishda moslashtirgan (AI bilan vizual diff). E'tiborga molik AI vorkflow.
§05
AI yordamida ishlab chiqish
- Topilgan sessiyalar: ushbu loyiha uchun Claude Code sessiyalari katalogida 4 ta
.jsonlfayl (to'liq yo'l normalizatsiyasi orqali tasdiqlangan). - AI bilan nima qilingan: landing/CMS qurish, tip tuzatishlari, vizual UI sozlash (chrome-devtools skrinshotlari), deploy (
.claude/skills/qo'llanmalar bilan). - AI vorkflow patternlari: ko'p-yordamchi konfiguratsiya (CLAUDE.md aniq ravishda Claude Code/Cursor/Copilot/Windsurf'ga murojaat qiladi),
.mcp.json,.claude/skills/(AI o'qiy oladigan deploy va dizayn qo'llanmalari), skrinshotlar orqali vizual iteratsiya. Zamonaviy stack ustidagi yetuk AI-native jarayon.
§06
Yutuqlar va metrikalar
- To'liq yakka sikl: korporativ saytni Tilda'dan → CMS'li kod asosidagi Next.js 16 stack'iga ko'chirish, ~6 oy ichida.
- Boilerplate (CLAUDE.md bo'yicha) "4+ jonli SaaS app'da ishlatiladi" — qayta ishlatiladigan poydevor.