📚 Joveh Hub - جزوه هاب
========================

📖 مقدمه
Joveh Hub یک سیستم مدیریت جزوات آموزشی است که به طور خاص برای پایه یازدهم طراحی شده است.
این سیستم امکان مشاهده جزوات به صورت آنلاین را فراهم می‌کند و از دانلود و کپی‌برداری جلوگیری می‌کند.

🔧 نیازمندی‌های سیستم
---------------------
1. سرور وب (Apache یا Nginx)
2. PHP نسخه 7.4 یا بالاتر
3. MySQL نسخه 5.7 یا بالاتر (یا MariaDB 10.2+)
4. Composer (برای وابستگی‌ها)
5. دسترسی به اینترنت برای دریافت فونت‌ها و کتابخانه‌ها

📁 ساختار پروژه
---------------
joveh-hub/
├── index.php                    # صفحه اصلی
├── login.php                    # صفحه ورود
├── logout.php                   # خروج از سیستم
├── dashboard.php                # داشبورد کاربر
├── change-password.php          # تغییر رمز عبور
├── admin/                       # پنل مدیریت
│   ├── index.php               # داشبورد ادمین
│   ├── upload.php              # آپلود جزوه
│   ├── users.php               # مدیریت کاربران
│   └── reports.php             # مدیریت گزارشات
├── notes/                       # بخش جزوات
│   ├── view.php                # مشاهده جزوه
│   └── report.php              # گزارش مشکل
├── includes/                    # فایل‌های شامل
│   ├── config.php              # تنظیمات پایگاه داده
│   ├── functions.php           # توابع کمکی
│   ├── auth.php                # اعتبارسنجی کاربران
│   └── security.php            # امنیت
├── assets/                      # منابع استاتیک
│   ├── css/                    # فایل‌های استایل
│   │   ├── style.css          # استایل اصلی
│   │   ├── admin.css          # استایل پنل ادمین
│   │   └── pdf-viewer.css     # استایل نمایش پی‌دی‌اف
│   ├── js/                     # فایل‌های جاوااسکریپت
│   │   ├── main.js            # جاوااسکریپت اصلی
│   │   ├── pdf-viewer.js      # نمایش پی‌دی‌اف
│   │   └── admin.js           # جاوااسکریپت ادمین
│   └── images/                 # تصاویر
│       ├── logo.png           # لوگو سایت
│       └── user-default.png   # تصویر پیش‌فرض کاربر
├── uploads/                    # فایل‌های آپلود شده
│   ├── notes/                 # جزوات
│   └── profile/               # تصاویر پروفایل
├── database/                   # دیتابیس
│   └── joveh_hub.sql          # فایل SQL
└── README.txt                 # این فایل

🚀 مراحل نصب
-----------
1. نصب و راه‌اندازی سرور
   ----------------------
   - سرور وب Apache یا Nginx را نصب کنید
   - PHP 7.4+ با extension‌های زیر نصب کنید:
     * mysqli
     * pdo_mysql
     * gd
     * mbstring
     * fileinfo
   - MySQL 5.7+ یا MariaDB 10.2+ نصب کنید

2. نصب پروژه
   ----------
   - فایل‌های پروژه را در پوشه root سرور کپی کنید
   - پوشه‌ها باید در مسیر زیر باشند:
     /var/www/html/joveh-hub/ (برای Apache)
     یا
     /usr/share/nginx/html/joveh-hub/ (برای Nginx)

3. تنظیمات پایگاه داده
   --------------------
   - به phpMyAdmin بروید
   - یک دیتابیس جدید با نام 'joveh_hub' ایجاد کنید
   - کدگذاری را روی 'utf8mb4_persian_ci' تنظیم کنید
   - فایل database/joveh_hub.sql را ایمپورت کنید

4. تنظیمات فایل‌ها
   ----------------
   - مجوزهای لازم را تنظیم کنید:
     chmod 755 /path/to/joveh-hub/
     chmod 755 /path/to/joveh-hub/uploads/
     chmod 755 /path/to/joveh-hub/uploads/notes/
     chmod 755 /path/to/joveh-hub/uploads/profile/

   - فایل config.php را ویرایش کنید:
     includes/config.php را باز کنید
     اطلاعات اتصال به دیتابیس را تنظیم کنید:
     $host = 'localhost';
     $username = 'root';  // یا نام کاربری دیتابیس
     $password = '';      // رمز عبور دیتابیس
     $database = 'joveh_hub';

5. تنظیمات امنیتی
   ---------------
   - یک کاربر دیتابیس مخصوص ایجاد کنید:
     CREATE USER 'joveh_app'@'localhost' IDENTIFIED BY 'YourStrongPassword123!';
     GRANT ALL PRIVILEGES ON joveh_hub.* TO 'joveh_app'@'localhost';
     FLUSH PRIVILEGES;

   - در config.php از کاربر بالا استفاده کنید

6. تنظیمات سرور (اختیاری)
   -----------------------
   - برای Apache، در فایل .htaccess:
     Options -Indexes
     php_value upload_max_filesize 50M
     php_value post_max_size 55M

   - برای Nginx، در تنظیمات:
     client_max_body_size 50M;

7. اولین راه‌اندازی
   ----------------
   - مرورگر را باز کنید و به آدرس زیر بروید:
     http://localhost/joveh-hub/

   - با اطلاعات زیر وارد شوید:
     کاربر عادی: کد ملی + رمز 1234
     ادمین: 
       نام کاربری: admin
       رمز عبور: @Ss13871387$

   - پس از ورود، رمز عبور را تغییر دهید

🔐 اطلاعات ورود پیش‌فرض
----------------------
1. کاربر ادمین:
   - کد ملی: admin
   - رمز عبور: @Ss13871387$
   - پس از ورود باید رمز را تغییر دهید

2. کاربران عادی:
   - کد ملی: (هر کد ملی 10 رقمی)
   - رمز عبور: 1234
   - پس از اولین ورود باید رمز را تغییر دهند

📊 جداول دیتابیس
---------------
1. users          - اطلاعات کاربران
2. subjects       - دروس
3. notes          - جزوات
4. reports        - گزارشات مشکلات
5. login_attempts - تلاش‌های ورود
6. activity_logs  - لاگ فعالیت‌ها

🔧 ویژگی‌های امنیتی
------------------
1. جلوگیری از SQL Injection
2. جلوگیری از XSS Attacks
3. CSRF Protection
4. Rate Limiting
5. Brute Force Protection
6. File Upload Security
7. Session Security
8. Password Hashing (bcrypt)
9. Input Validation
10. Output Encoding

🎨 ویژگی‌های سیستم
-----------------
1. مشاهده جزوات بدون امکان دانلود
2. PDF Viewer پیشرفته
3. مدیریت کاربران
4. آپلود و مدیریت جزوات
5. سیستم گزارش مشکلات
6. دسته‌بندی دروس تخصصی و عمومی
7. پنل مدیریت حرفه‌ای
8. طراحی واکنش‌گرا
9. پشتیبانی از فارسی
10. فونت زیبای وزیر

🛠 عیب‌یابی
----------
1. اگر صفحه سفید نمایش داده شد:
   - خطاهای PHP را فعال کنید
   - مجوزهای فایل‌ها را بررسی کنید
   - اتصال دیتابیس را بررسی کنید

2. اگر فایل‌ها آپلود نمی‌شوند:
   - مجوز پوشه uploads را بررسی کنید
   - تنظیمات upload_max_filesize را بررسی کنید
   - خطاهای PHP را بررسی کنید

3. اگر پی‌دی‌اف نمایش داده نمی‌شود:
   - اطمینان حاصل کنید PDF.js بارگذاری شده
   - مسیر فایل PDF را بررسی کنید
   - مجوز فایل PDF را بررسی کنید

📞 پشتیبانی
----------
در صورت بروز مشکل:
1. خطاها را در فایل error_log بررسی کنید
2. تنظیمات PHP و MySQL را بررسی کنید
3. مجوزهای فایل‌ها و پوشه‌ها را بررسی کنید

⚠️ نکات مهم
----------
1. همیشه از نسخه‌های به‌روز PHP و MySQL استفاده کنید
2. به‌طور منظم از دیتابیس بک‌آپ بگیرید
3. پسوردهای پیش‌فرض را تغییر دهید
4. فایل‌های سیستم را به‌طور منظم آپدیت کنید
5. از SSL برای امنیت بیشتر استفاده کنید

🎯 آینده‌نگاری
--------------
ویژگی‌های قابل افزودن:
1. جستجوی پیشرفته در جزوات
2. سیستم کامنت‌گذاری
3. امتیازدهی به جزوات
4. بخش سوالات متداول
5. سیستم آزمون آنلاین
6. اپلیکیشن موبایل
7. API برای توسعه‌دهندگان

📄 مجوز
-------
این پروژه برای استفاده آموزشی طراحی شده است.
هرگونه استفاده تجاری نیاز به مجوز دارد.

© 2026 Joveh Hub - جزوه هاب