🏫 Xo'jayli 3-Maktab — Monorepo

📁 Tuzilma

maktab/
├── backend/       # Node.js + Express + PostgreSQL
└── frontend/      # React + Vite + TailwindCSS + TypeScript

---

🚀 Boshlash (Setup)

1. PostgreSQL — Ma'lumotlar bazasini yaratish

psql -U postgres
CREATE DATABASE maktab_db;
\q

2. Backend sozlash

cd backend

# Paketlarni o'rnatish
npm install

# .env faylini yaratish
cp .env.example .env
# .env faylini oching va DB ma'lumotlaringizni kiriting

# Migrationlarni ishga tushirish (jadvallar va seed ma'lumotlar)
npm run migrate

# Dev serverini ishga tushirish
npm run dev
# → http://localhost:3000

3. Frontend sozlash

cd frontend

# Paketlarni o'rnatish
npm install

# Dev serverini ishga tushirish
npm run dev
# → http://localhost:5173

---

🔐 Super Admin Login

Super admin login va paroli endi kodda yoki migratsiyada qattiq yozilmaydi — backend/.env faylidagi quyidagi o'zgaruvchilar orqali boshqariladi:

SUPERADMIN_LOGIN=admin
SUPERADMIN_PASSWORD=kuchli_parol_kiriting
SUPERADMIN_FULL_NAME=Bosh Administrator

Server har ishga tushganda shu login/parol bilan super_admin foydalanuvchisini yaratadi yoki yangilaydi (backend/src/utils/seedSuperAdmin.ts). Parolni o'zgartirish uchun .env dagi SUPERADMIN_PASSWORDni yangilab, serverni qayta ishga tushirish kifoya.

⚠️ .env fayli .gitignoreda — hech qachon repo'ga commit qilinmasin.

---

🎭 Rol Tizimi

Rol	Huquqlar
super_admin	Barcha sahifalar, foydalanuvchi boshqaruvi
content_manager	Yangiliklar, yutuqlar, galereya boshqaruvi
teacher	Faqat o'z fanlari: test savollar + nazorat ballari

---

📡 API Endpointlar

Method	URL	Tavsif
POST	/api/auth/login	Tizimga kirish
POST	/api/auth/refresh	Token yangilash
POST	/api/auth/logout	Chiqish
GET	/api/auth/me	Joriy foydalanuvchi
GET	/api/users	Foydalanuvchilar (admin)
POST	/api/users	Yangi foydalanuvchi (admin)
GET	/api/news	Yangiliklar (public)
POST	/api/news	Yangilik qo'shish
GET	/api/questions	Test savollari (public)
POST	/api/questions	Savol qo'shish (teacher/admin)
POST	/api/questions/submit-test	Test natijasini saqlash
GET	/api/schedule/current	Hozirgi dars (Smart Shift)
GET	/api/analytics/overview	Dashboard statistika
GET	/api/analytics/teacher-ratings	O'qituvchi reytingi
GET	/api/analytics/class-averages	Sinf o'rtacha ballari
GET	/api/analytics/class-ranking	Sinflar reytingi (public)

---

🗺️ Frontend Sahifalar

Public (hamma ko'radi)

• / — Bosh sahifa (Hero, Smart Shift, Ob-havo, Tashqi havolalar)
• /news — Yangiliklar ro'yxati
• /news/:slug — Yangilik batafsil
• /achievements — Maktab faxrlari
• /tests — Onlayn test
• /control-works — Nazorat ishlari reytingi

Admin Panel (/admin)

• /admin — Dashboard
• /admin/users — Foydalanuvchilar boshqaruvi
• /admin/news — Yangiliklar boshqaruvi
• /admin/achievements — Yutuqlar boshqaruvi
• /admin/analytics — Analitika va grafiklar

Teacher Kabineti (/teacher)

• /teacher — Kabinet bosh sahifasi
• /teacher/questions — Test savollari
• /teacher/control-works — Nazorat ishlari ballari

---

🛠️ Texnologiyalar

Backend

• Node.js + Express + TypeScript
• PostgreSQL + pg (native driver)
• JWT (access + refresh tokens)
• bcrypt (parol hashlash)
• Zod (validatsiya)
• Multer (fayl yuklash)

Frontend

• React 18 + Vite + TypeScript
• TailwindCSS
• React Router v6
• TanStack Query (server state)
• Zustand (auth state)
• React Hook Form + Zod
• Recharts (grafiklar)
• Framer Motion (animatsiyalar)
• Lucide React (ikonlar)