§01
Umumiy ko'rinish
- Bu nima: Onlayn ta'lim platformasi (Udemy kloni) "CourseFlow". To'liq hayotiy sikl: student kurs topadi/sotib oladi → o'qiydi (darslar/videolar/progress) → imtihon topshiradi → sertifikat oladi; instruktorlar kurs yaratadi (become-instructor, admin-editor); adminlar boshqaradi. Ko'p tilli.
- Turi / holati / roli: web-app (LMS) · active · solo — foydalanuvchi muallif (42 kommitdan 40 tasi), +2 ta kichik kommit Boburdan.
- Faol davr: 2025-05-02 → 2025-12-20 (~7 oy), 42 kommit + CHANGELOG.
§02
Stek
- Frontend: Next.js 15 (App Router, Turbopack,
[locale]yo'nalishlari), TypeScript, Radix/shadcn (to'liq UI to'plami), TanStack Query (ma'lumot olish/kesh), TipTap (boy matnli dars muharriri + rasm/havola/suggestion), dnd-kit (drag-and-drop kurikulum quruvchi), next-intl (i18n, lokallar), next-themes, react-hook-form + Zod. - Backend: Supabase (Postgres + Auth + Storage),
@supabase/ssr, RBAC (student/teacher/admin) bilan sxema, courses→categories→chapters→lessons, ro'yxatdan o'tish + progress, imtihonlar/savollar, sertifikatlar. Migratsiyalarsupabase/migrationsichida. Next.js API route'lari: enrollments, courses, lessons, exams, questions, certificates, admin. - Tooling: Biome (ultracite ni kengaytiradi), Supabase MCP (
.mcp.json), Kombai (AI dizayn,.kombai/), Cursor + Claude.set_admin.ts(admin rolini biriktirish skripti),fix_links.js/fix-links.sh(havola migratsiyasi). - Infra: Bun,
.env.local/.env.production, auth marshrutlash uchun middleware.
§03
Nima qilindi
7 oy davomida 40 ta solo kommit (CHANGELOG + CLAUDE + SET_ADMIN hujjatlari bilan):
- Kurslar katalogi (kategoriyalar, kartochkalar, grid), kurs/dars sahifalari.
- Auth + RBAC (student/teacher/admin) Supabase + middleware marshrutlash orqali.
- Instruktorlar marketplace'i (become-instructor, teacher dashboard, admin-editor).
- TipTap bilan darslar (boy matn/rasmlar), kurikulum quruvchi (dnd-kit).
- Imtihonlar/testlar (exams/questions API) + sertifikatlar (certificates API).
- Progress/ro'yxatdan o'tishni kuzatish, i18n (next-intl).
- Hajmi: yakka o'zi qilingan, tugatilgan ko'p modulli LMS.
§04
Texnik chellenjlar
CLAUDE.md/struktura/bog'liqliklar bilan tasdiqlangan:
- Supabase'da to'liq LMS ma'lumot modeli (RBAC + courses→chapters→lessons + ro'yxatdan o'tish/progress + imtihonlar + sertifikatlar): rollar va progressga ega, oddiy bo'lmagan relatsion sxema, migratsiyalar repozitoriyda. → landing sahifa emas, to'liq mahsulotni loyihalash.
- dnd-kit'da kurikulum quruvchi + TipTap dars muharriri: interaktiv kontent yaratish (boblar/darslarni drag-and-drop qilish, boy matn) — murakkab UX. → ilg'or frontend ishi.
- i18n-first (
app/[locale], next-intl, lokallar): birinchi kundanoq ko'p tilli platforma. - Ishlab chiqishda AI tooling (
.mcp.jsondagi Supabase MCP, Kombai AI dizayn, Cursor+Claude): Supabase MCP server agentga DB/sxemaga to'g'ridan-to'g'ri kirish beradi; Kombai AI UI generatsiyasini taʼminlaydi. → zamonaviy AI-native solo vorkflow. - RBAC + auth marshrutlash Next middleware + Supabase SSR orqali.
§05
AI yordamida ishlab chiqish
- Topilgan sessiyalar: 0 ta Claude Code transkripti (papka mavjud emas). Ammo muhit AI bilan to'yingan:
.claude/(CLAUDE.md),.cursor/,.kombai/(Kombai AI dizayn),.mcp.json(Supabase MCP). - AI bilan nima qilingan: Cursor/Claude + Supabase MCP (agent DB bilan ishlaydi) + Kombai (UI generatsiyasi) bilan ishlab chiqish. CLAUDE.md agent uchun arxitekturani hujjatlashtiradi.
- AI-vorkflow patternlari: ko'p vositali AI (Cursor + Claude + Kombai), Supabase bilan MCP integratsiyasi (agent sxemani/ma'lumotlarni ko'radi). AI-native solo mahsulot ishlab chiqishning yaxshi namunasi.
§06
Yutuqlar va metrikalar
- ~7 oyda yakka o'zi qilingan to'liq funksional LMS: katalog, o'qish, imtihonlar, sertifikatlar, instruktorlar marketplace'i, RBAC, i18n.
- Zamonaviy stek (Next 15 + Supabase + TanStack + TipTap + dnd-kit).
- AI-native asboblar to'plami (Supabase MCP + Kombai + Cursor/Claude).