Femida Edu

Huquq bo'yicha hammasi bir joyda — milliy sertifikatga tayyorgarlik va istalgan huquq sohasini mustaqil o'rganish. Next.js 16 + Supabase + Telegram. YURISTIM TEAM MChJ mahsuloti.

Femida Edu — A+ Huquq 2.0 kodidan boshlangan alohida mahsulot (alohida repo, alohida Supabase, alohida bot). A+ Huquq o'z holicha ishlashda davom etadi. Reja: docs/V3_REJA.md, brend: docs/BREND.md, qarorlar: data/v3/polls.json (93 ta).

Femida Edu uchun farqlar (A+ dan)

• Brend: S1 logosi (src/components/logo.tsx), to'q ko'k + oltin ranglar, sarlavhalar Playfair Display.
• Ikonkalar: 180 px+ — tarozi tutgan Femida haykali (public/brand/femida-statue.svg), favicon — oltin nuqtali F.
• Payme: buyurtma kodi F… (DOYSE kassasi F-buyurtmalarni shu saytga uzatadi).
• Telegram texnik email domeni: telegram.femidaedu.uz; bot: @FemidaEduBot (yaratilishi kerak).

V3 — 2-qism: qonun bazasi ✅ (kod), ⏳ real import

• 18 ta huquq sohasi (A/B/C), hujjat → bob → modda, hayotiy mavzular, modda bo'yicha progress (20261001000015_law_base.sql).
• npm run lex:import -- MK — lex.uz'dan (yoki --file matn.txt bilan nusxalangan matndan) import; all — ro'yxatdagi hammasi, --dry — bazaga yozmasdan tahlil. Ro'yxat: data/lex/documents.json (A darajali 7 ta kodeks; lex_id'lar tekshirilishi kerak — skript sahifa sarlavhasini solishtiradi va mos kelmasa to'xtaydi).
• Qayta import: bo'shliq/apostrof farqi o'zgarish hisoblanmaydi; modda matni o'zgarsa — changed, yo'qolsa — repealed, ularga bog'langan e'lon qilingan savollar review holatiga qaytadi. Ekspert ko'rib chiqqach: ack_article_change(id).

V3 — 3-qism: huquq sohalari katalogi ✅ (kod)

• /app/sohalar — 18 soha (A/B/C guruhlari, rang/ikonka, o'zlashtirish foizi); /app/sohalar/<soha> — "Kodeks bo'yicha" (hujjat → bob → modda, moddalar xaritasi) va "Hayotiy mavzular"; /app/sohalar/<soha>/<modda> — modda matni, lex.uz havolasi, "Shu modda bo'yicha test", oldingi/keyingi modda.
• Bepul: har hujjatning 1-bobi va C sohalar; qolgan testlar — Premium (article_is_free, start_article_practice).
• Modda progressi javob yozilganda trigger bilan yangilanadi; o'zlashtirish — kamida 2 to'g'ri va ≥ 2/3.
• Supabase'siz ko'rish: npm run dev → /dev/sohalar (namuna ma'lumot).

V3 — 4-qism: AI bilan test yaratish va ulashish ✅ (kod)

• /app/testlar — mening testlarim, guruhga berilgan testlar, kod bilan ochish, haftalik AI limiti.
• /app/testlar/yangi — manba: bazadagi moddalar (raqamlar yoki bob), matn, PDF/rasm; 5–50 savol (bepul: haftasiga 10 test × 10 savol). AI 10 talik bo'laklarda tuzadi, savollar article_ref bo'yicha bazadagi moddaga bog'lanadi (topilmasa — "o'z materiali").
• /app/testlar/<id> — har savolni tahrirlash; javob kaliti o'zgarsa key_version++ va barcha natijalar jimgina qayta hisoblanadi (eski ball score_history da); nashr: faqat men / havola / guruh / ochiq katalog; taymer, muddat, urinishlar, aralashtirish, javob ko'rsatish (har savoldan keyin / oxirida / muddat tugagach), mehmonlar; natijalar va har savol bo'yicha to'g'ri %.
• Ulashish: /t/<KOD> (6 belgi, 0/O/1/I yo'q), t.me/<bot>?startapp=t_<KOD> (Mini App), bot /start t_<KOD>, Telegram share.
• Ishlovchi: kartada "natijangiz va ismingiz muallifga ko'rinadi"; mehmon — ism + httpOnly token (keyin kirsa urinishlar akkauntga o'tadi).
• Ochiq katalog /t: public + ishonch darajasi ≥ 1 (admin beradi) + AI moderatsiya + bazaga bog'langan + ≥ 5 savol + izohli ≥ 50%.
• Javob kaliti klientga hech qachon berilmaydi — barcha amallar service_role funksiyalari orqali.
• Supabase'siz ko'rish: npm run dev → /dev/testlar?sahifa=bosh|yangi|tahrir|karta|ishlash.

V3 — 5-qism: AI ustoz ✅ (kod)

• /app/yordamchi — "Tushuntirish" (modda/tushuncha, misol bilan) va "Kazus tahlili" (o'quv masalasi) suhbatlari; kontekst bazadagi moddalardan (search_articles — to'liq matnli qidiruv + suhbat moddasi + matndagi "12-modda" havolalari). Har javob ostida manba moddalar (havola) va "Bu yuridik maslahat emas"; shaxsiy ish bo'yicha — yuristga murojaat tavsiyasi.
• Modda sahifasida "💡 AI tushuntirsin"; bosh sahifada AI kartasi.
• "Xatolardan test": weak_articles (xato bor, o'zlashtirilmagan) → AI test (4-qism, test limitiga kiradi).
• /app/yordamchi/reja — maqsad (sertifikat/soha), sana, kunlik vaqt, daraja + zaif moddalar → 8 haftagacha reja.
• Limit: bepul — haftasiga 10 ta savol (reja ham 1 ta), Premium — 200; AI xatosida qaytariladi.
• Supabase'siz ko'rish: /dev/ustoz?sahifa=bosh|suhbat|reja.

V3 — 6-qism: jonli viktorina ✅ (kod)

• Muallif sahifasida "🎮 Jonli viktorina" → xona: 6 raqamli PIN + QR (Telegram Mini App startapp=j_<PIN>), har savolga 10–60 s, ixtiyoriy guruh. Bepul — 30 ishtirokchigacha, Premium — 200. Bir hostda bitta faol xona.
• /jonli — PIN va ism bilan qo'shilish (kirmaganlar ham, httpOnly token); bot /start j_<PIN>.
• /jonli/host/<xona> — proyektor uchun ekran: ishtirokchilar, savol va taymer, javob berganlar soni, variantlar taqsimoti, to'g'ri javob, top-5, yakuniy natijalar. /jonli/<xona> — o'quvchi ekrani (tanlov turida bir bosishda javob).
• Holat har 1,5 soniyada /api/jonli/<xona> orqali olinadi; vaqt server soati bo'yicha; javob kaliti faqat "reveal" bosqichida. Ball: to'g'ri — 500 + 500 × qolgan vaqt ulushi.
• Supabase'siz ko'rish: /dev/jonli?kim=host|oquvchi|kirish&holat=lobby|question|reveal|finished.

---

A+ Huquq 2.0 dan meros (holat)

Huquq fanidan milliy sertifikat imtihoniga tayyorgarlik platformasi — Next.js 16 + Supabase + Telegram. Reja: ../HUQUQSHUNOSLIK KURSI/05_TEXNIK_ONLAYN_TIZIM/PLATFORMA_2.0_REJA.md

Holat

0-bosqich (poydevor) ✅

• Loyiha skeleti, dizayn tizimi (grafit + firuza, Manrope, tungi rejim)
• Ma'lumotlar bazasi sxemasi + RLS (supabase/migrations) va boshlang'ich ma'lumot (supabase/seed.sql)
• Telegram Login Widget orqali kirish (server tomonda imzo tekshiruvi) + Google orqali kirish
• Profil: ism, maqsad, hudud, yozuv (lotin/kirill), Telegram'ni bog'lash

1-bosqich (kontent va mashq) ✅

• v1 importi: 6 835 element → 3 023 unikal savol (52 hujjat + 8–11-sinf darsliklari), hisobot: data/v1/REPORT.md
• Mashq: mavzu/modul katalogi, 10 talik sessiya, 6 xil savol turi, izoh + modda, natija tahlili
• Kunlik bepul limit (20 savol), xatolar navbati (Leitner 1→3→7→14→30 kun), streak — atomar SQL funksiyada
• Kirill yozuvi: kontent ko'rsatishda o'giriladi, kirillda yozilgan javob ham qabul qilinadi
• "Savolda xato bor" shikoyati

2-bosqich (imtihon va takrorlash) ✅

• Sinov imtihoni: 45 topshiriq (35 yopiq + 10 yozma a/b), 90 daqiqa, server vaqtiga bog'langan taymer, avtomatik saqlash, navigator; qiyinlik taqsimoti 10/18/7 va ball 1,3/2,2/3,2 — jami 100 → 75 shkala → A+…C
• Natija: daraja, keyingi darajagacha ball, yopiq/yozma qismlar, hujjatlar bo'yicha zaif joylar, to'liq tahlil
• Bepul tarif: oyiga 1 ta sinov (atomar tekshiruv), tugallanmagan sinov davom ettiriladi
• Takrorlash rejimi (muddati kelgan xatolar), kunlik test (hamma uchun bir xil 10 savol, kuniga bitta)
• Yozma (qisqa javobli) savollar mashqqa ham qo'shildi; mobil pastki navigatsiya

3-bosqich (Premium va to'lov) ✅ — qo'lda to'lov

• Tariflar (plans) va to'lov rekvizitlari admin paneldan o'zgartiriladi — narxlar: 1 oy — 49 000, 3 oy — 129 000 so'm
• /app/premium: bepul va Premium solishtirmasi, karta rekvizitlari, chek yuklash (JPG/PNG/WEBP/PDF ≤ 5 MB, tur fayl baytlaridan tekshiriladi), to'lovlar tarixi va holati
• Chek yopiq receipts bucket'ida; admin 10 daqiqalik imzolangan havola orqali ko'radi
• /admin/tolovlar: tasdiqlash (obuna joriy muddat tugagan kundan uzaytiriladi) yoki sabab bilan rad etish
• /admin/sozlamalar: tarif narxlari, karta raqami (bo'sh bo'lsa — to'lov formasi yopiq)
• Click / Payme / Uzum — merchant ma'lumotlari (YaTT yoki MChJ) kerak

4-bosqich (Telegram bot va Mini App) ✅

• Webhook /api/bot (maxfiy token bilan): /start (hisobni bog'lash), /kunlik, /natija, /sozlamalar, /yordam
• Mini App (/tg): Telegram ichida bir bosishda kirish (initData imzosi + Origin tekshiruvi)
• Eslatmalar (Vercel Cron): 08:00 — kunlik test, 20:00 — bugun 10 savol yechmaganlarga streak eslatmasi; botni bloklaganlar avtomatik o'chiriladi; profil sahifasida yoqish/o'chirish
• Sinov imtihoni natijasi botga yuboriladi

5-bosqich (o'qituvchi paneli) ✅

• /app/ustoz: guruh ochish, taklif havolasi (nusxalash / Telegram'da ulashish), o'quvchi chiqarish
• Guruh: o'quvchilar statistikasi (7 kun va umumiy aniqlik, streak, oxirgi sinov), zaif mavzular (30 kun)
• Vazifalar: mavzu + savollar soni + muddat; bajarilish (kim bajardi, necha foiz); o'quvchi bosh sahifasida
• /app/qoshilish/<kod>: o'quvchi bir bosishda qo'shiladi
• Admin: rol berish (o'qituvchi, ekspert…), Premium sovg'a qilish, guruhni "Premium guruh" qilish

6-bosqich (AI) ✅ — Claude Opus 5.5 (claude-opus-5-5), rad etilsa server tomonda fallbacks: "default"

• Yozma javobni AI qayta tekshirishi (matnli javob, mazmunan to'g'ri bo'lsa qabul qilinadi; sinov natijasiga ta'sir qilmaydi)
• "AI'dan so'rash": javobdan keyin savol, izoh va manba asosida tushuntirish (Premium, kuniga 30 ta)
• /app/kontent: savol generatori (muallif manba matnini joylashtiradi) → qoralama → ekspert tasdiqlaydi; shikoyatlarni ko'rib chiqish (to'g'ri shikoyat — savol muomaladan olinadi)
• Har bir AI chaqiruvi ai_usage jadvaliga yoziladi (tokenlar, maqsad)
• Jonli API bilan sinov — ANTHROPIC_API_KEY qo'yilgach (hozircha soxta klient bilan testlangan)

7-bosqich (motivatsiya) ✅

• Reyting (/app/reyting): haftalik va umumiy, viloyat bo'yicha; ball = aniqlik × 0,7 + faollik × 0,3; faqat "Ali V." ko'rinishidagi ism, profilda reytingdan chiqish
• Nishonlar (9 ta): mashq/sinov/musobaqa yakunida avtomatik beriladi, botga xabar, profilda ko'rinadi
• Musobaqalar: admin vaqt/davomiylik/savollar/mavzuni belgilaydi va botda e'lon qiladi; hamma bir xil savollarni ishlaydi, javoblar va natijalar tugagach ochiladi; o'rin — to'g'ri javoblar, teng bo'lsa vaqt; top-3 ga nishon

8-bosqich (kalibrlash) — vosita tayyor, real ma'lumot kutilmoqda

• npm run db:calibrate: Rasch (JMLE) bilan savol qiyinligi, 10/18/7 toifalari, hisobot data/calibration/REPORT.md: javob kaliti shubhali savollar (ajratish kuchi manfiy) va yorlig'i noto'g'ri savollar
• ~200 ta sinov imtihoni yig'ilgach ishga tushirish, keyin -- --apply (sinov imtihoni kalibrlangan toifalarni ishlatadi)

Kontent sifati va PWA

• /app/kontent/savollar: qidiruv, hujjat filtri, "javobi ko'zga tashlanadi" filtri; savolni tahrirlash (versiya oshadi — qayta import ustidan yozmaydi; ikki ekspert bir vaqtda tahrirlasa — to'qnashuv aniqlanadi)
• To'g'ri javobi keskin uzun 1 074 ta savol tuzatildi — chalg'ituvchi variantlar uzaytirildi (data/v1/fixes.json, to'g'ri javob o'zgarmagan)
• PWA: manifest, ikonkalar, service worker (faqat statik fayllar keshlanadi), offline sahifa, xavfsizlik sarlavhalari

Kurs o'quvchilarini ko'chirish: v1 da akkaunt yo'q edi (ism + telefon), shuning uchun avtomatik ko'chirilmaydi. Tartib: o'zingizga admin panelda "O'qituvchi" rolini bering → /app/ustoz da "Femida Edu kurs" guruhini oching → /admin/guruhlar da uni "Premium guruh" qiling → taklif havolasini kurs Telegram guruhiga tashlang.

Ishga tushirish

Node.js ~/.local/node ga o'rnatilgan. Terminalda bir marta:

export PATH="$HOME/.local/node/bin:$PATH"

1. Supabase loyihasi

1. supabase.com → New project (region: Frankfurt eu-central-1 — O'zbekistonga eng yaqin).

2. Project Settings → API Keys dan URL, publishable va secret kalitlarni, Connect → Session pooler dan DATABASE_URL ni oling.

3. .env.example ni .env.local ga nusxalab, qiymatlarni to'ldiring.

4. Sxema va boshlang'ich ma'lumot (qayta ishga tushirish xavfsiz — faqat yangi migratsiyalar qo'llanadi):

   npm run db:migrate -- --seed
   

5. Authentication → Sign In / Providers → Email — o'chiring. Platforma faqat Telegram va Google orqali kiritadi; ochiq email ro'yxati begona Telegram hisobini oldindan egallashga urinish uchun ishlatilishi mumkin (kod bundan himoyalangan, lekin keraksiz eshikni yopib qo'ygan ma'qul).

2. Telegram bot

1. @BotFather → /newbot → token va username'ni .env.local ga yozing.

2. /setdomain → saytning domeni (masalan femidaedu.uz). Widget localhost'da ishlamaydi — sinash uchun Vercel preview domeni yoki ngrok tunnelidan foydalaning va NEXT_PUBLIC_SITE_URL ni shunga moslang.

3. Webhook va menyu (sayt HTTPS domenda ishga tushgach): .env.local ga TELEGRAM_WEBHOOK_SECRET (openssl rand -hex 32) yozing, keyin npm run bot:setup (holatni ko'rish: npm run bot:setup -- info).

4. Vercel → Settings → Environment Variables: CRON_SECRET (openssl rand -hex 32) — eslatmalar vercel.json dagi jadval bo'yicha (03:00 va 15:00 UTC = 08:00 va 20:00 Toshkent) ishlaydi.

3. Google orqali kirish

1. Google Cloud Console → OAuth client (Web) yarating. Authorized redirect URI: https://<loyiha>.supabase.co/auth/v1/callback
2. Supabase → Authentication → Sign In / Providers → Google → Client ID va Secret'ni kiriting.
3. Supabase → Authentication → URL Configuration:
   • Site URL: NEXT_PUBLIC_SITE_URL qiymati
   • Redirect URLs: http://localhost:3000/auth/callback, https://<domen>/auth/callback

4. Birinchi admin va to'lov sozlamalari

Kirgandan keyin Supabase SQL Editor'da:

update public.profiles set role = 'admin' where id = (select id from auth.users order by created_at limit 1);

Keyin /admin/sozlamalar da tarif narxlarini va to'lov qabul qilinadigan karta raqamini kiriting — karta kiritilmaguncha /app/premium dagi to'lov formasi yopiq turadi.

5. Savollarni yuklash

.env.local ga DATABASE_URL qo'shing (Supabase → Connect → Session pooler satri, parol bilan), keyin:

npm run db:import

Import tranzaksiyada ishlaydi (xato bo'lsa hech narsa o'zgarmaydi) va qayta ishga tushirsa ham xavfsiz: admin panelda tahrirlangan savollar (version > 1) qayta importda ustidan yozilmaydi.

v1 materiallari o'zgarsa, to'plamni qayta quring (../HUQUQSHUNOSLIK KURSI dan o'qiydi):

npm run import:build

6. Ishga tushirish

npm install
npm run dev        # http://localhost:3000  (Supabase'siz namunalar: /dev/savollar, /dev/imtihon, /dev/premium — faqat dev)
npm test           # 234 ta test: RLS, import, mashq/imtihon SQL funksiyalari (PGlite), baholash, transliteratsiya
npm run typecheck
npm run lint

Xavfsizlik qoidalari (kod yozganda buzmang)

• To'g'ri javob va izoh (questions.answer, explanation) mijozga ochilmaydi — ustun GRANT'lari bilan yopilgan. Javobni tekshirish va izohni qaytarish faqat serverda (createSupabaseAdmin), foydalanuvchi huquqi tekshirilgandan keyin.
• Ball, urinish, obuna, to'lov jadvallariga mijoz yoza olmaydi — faqat server.
• profiles.role, telegram_id, groups.grants_premium ni foydalanuvchi o'zi o'zgartira olmaydi.
• SUPABASE_SECRET_KEY va TELEGRAM_BOT_TOKEN faqat serverda; hech qachon NEXT_PUBLIC_ bilan boshlanmasin.
• Telegram'ni mavjud akkauntga bog'lash faqat profil sahifasidan boshlangan bo'lsa ishlaydi (tg_link cookie) — begona imzoli havola orqali akkauntni egallashdan himoya.
• Har bir yangi jadval/ustun uchun tests/db.test.ts ga RLS testi qo'shing.

Tuzilma

src/
  proxy.ts                    sessiyani yangilash + yopiq bo'limlarga yo'naltirish (Next 16: middleware → proxy)
  app/
    page.tsx                  landing
    kirish/                   Telegram + Google
    app/                      o'quvchi kabineti (bosh sahifa, mashq, imtihon, takrorlash, premium, profil)
    app/ustoz                 o'qituvchi paneli; app/qoshilish — guruhga qo'shilish
    app/kontent               kontent paneli: AI generator, tasdiqlash, shikoyatlar
    admin/                    admin panel: to'lovlar, sozlamalar
    dev/                      Supabase'siz namunalar (faqat dev)
    api/auth/telegram/        widget qaytish manzili, bog'lash
    api/auth/telegram-webapp  Mini App orqali kirish
    api/bot, api/cron         bot webhook va eslatmalar
    tg/                       Mini App kirish sahifasi
    auth/callback, chiqish    Google OAuth, chiqish
  lib/
    questions.ts              savol modeli va javobni tekshirish
    grading-open.ts           yozma javob (v1 mantiqi: sonlar so'zda, xatoga chidamli)
    translit.ts               lotin ↔ kirill
    practice.ts               mashq: javobni yozish (server)
    mock.ts                   sinov rejasi, ball, daraja, tahlil (sof funksiyalar)
    mock-server.ts            sinovni boshlash / saqlash / baholash (server)
    payments.ts, receipt.ts   qo'lda to'lov: chekni tekshirish va yuklash
    ai.ts, ai-server.ts       Claude: qayta tekshirish, tushuntirish, savol generatori
    telegram.ts               Login Widget va Mini App imzosini tekshirish
    bot/                      Bot API klienti, buyruqlar, ommaviy xabar yuborish
    auth-telegram.ts          Telegram → Supabase foydalanuvchisi
    auth.ts                   requireUser / requireRole
    supabase/                 server, brauzer va admin klientlar
scripts/import/              v1 → data/v1/bundle.json → SQL (build.ts, load.ts)
data/v1/                      import to'plami va hisobot
supabase/
  migrations/                 sxema + RLS, mashq funksiyalari
  seed.sql                    spetsifikatsiya bo'limlari, standart mock shabloni, nishonlar
tests/                        vitest