# مکتب‌خونه (MaktabKhaneh) - سامانه هوشمند امانت کتاب مدارس

> «مکتب‌خونه» یک پلتفرم جامع و هوشمند برای اشتراک‌گذاری، امانت همتا‌به‌همتا (P2P) و توسعه فرهنگ کتاب‌خوانی در میان دانش‌آموزان مدارس است.

## معرفی کوتاه سامانه (Overview)
مکتب‌خونه برای تقویت چرخه کتاب‌خوانی مشارکتی در مدارس طراحی شده است. هر دانش‌آموز می‌تواند قفسه کتاب‌های شخصی خود را در سامانه ثبت کند و کتاب‌هایش را برای مدتی مشخص به هم‌کلاسی‌ها یا سایر دانش‌آموزان مدرسه امانت دهد. این سامانه شامل لیگ کتابخوانی هفتگی، برد افتخارات چاپی، سیستم امتیازدهی و مدال‌دهی، مشاور هوشمند هوش مصنوعی (Gemini)، اتصال به پیام‌رسان بله و سیستم پشتیبان‌گیری خودکار در گوگل درایو است.

## ارکان و ماژول‌های اصلی (Key Modules)

- **بانک کتاب‌ها (Library & Catalog)**:
  - جستجوی سریع در عنوان، نویسنده، رده سنی، ژانر و نام اهداکننده.
  - ثبت کتاب توسط دانش‌آموزان با عکس جلد، خلاصه، رده سنی و ژانر.
  - سیستم پیشنهاد هوشمند کتاب‌ها و تفکیک کتاب‌های موجود و در حال امانت.

- **فرایند امانت کتاب و پروتکل ۱۲ ساعته (Lending Workflow)**:
  - ثبت درخواست امانت کتاب توسط دانش‌آموز با پرداخت کارمزد نمادین (۱۰,۰۰۰ تومان).
  - مهلت ۱۲ ساعته برای بررسی درخواست توسط صاحب کتاب از منزل (به دلیل ممنوعیت گوشی در مدرسه).
  - تعیین زمان و محل تحویل فیزیکی کتاب در مدرسه (مثلاً زنگ تفریح یا کتابخانه).
  - ثبت تایید تحویل و عودت کتاب، به همراه ثبت بازخورد و امتیاز دوطرفه (امتیاز به امانت‌گیرنده و امانت‌دهنده).

- **لیگ کتابخوانی و سکوی افتخارات (Reading League)**:
  - رده‌بندی برترین کتاب‌خوان‌ها، بیشترین اهداکنندگان کتاب و محبوب‌ترین کتاب‌ها.
  - اعطای نشان‌ها و مدال‌های طلا، نقره و برنز به دانش‌آموزان برتر.
  - امکان مشاهده و چاپ پوستر رسمی «برد افتخارات کتابخوانی» برای نصب در تابلوی اعلانات مدرسه.

- **مشاور هوشمند انتخاب کتاب (AI Book Advisor)**:
  - با استفاده از هوش مصنوعی گوگل جیمینای (Google Gemini).
  - پیشنهاد کتاب‌های شخصی‌سازی شده بر اساس علایق، رده سنی، کتاب‌های خوانده شده قبلی و پایه تحصیلی دانش‌آموز.

- **مدیریت کلاس‌ها و سیستم داینامیک نام‌ها (School Classes & Dynamic Sync)**:
  - دسته‌بندی دانش‌آموزان بر اساس پایه‌ها و کلاس‌های مدرسه.
  - انطباق هوشمند و داینامیک نام کلاس‌ها، به طوری که با ویرایش نام هر کلاس، اطلاعات تمامی دانش‌آموزان و کتاب‌های مرتبط به‌طور زنده به‌روزرسانی می‌شود.

- **پنل مدیریت و نظارت (Admin Panel)**:
  - مدیریت حساب‌های کاربری، تایید اعضای جدید و ترفیع نقش‌ها.
  - مدیریت تراکنش‌ها و فیش‌های واریزی کارت به کارت.
  - ارسال پیام‌های اطلاع‌رسانی از طریق پیام‌رسان بله (@Maktabkunebot).
  - مدیریت رویدادها، چالش‌های هفتگی و مناسبت‌های تقویمی.
  - مدیریت پشتیبان‌گیری تفاضلی و خودکار در گوگل درایو (Google Drive Backup).

## مسیرها و صفحات سامانه (Navigation Links)
- [کتابخانه و جستجو](/?tab=books): صفحه اصلی و مرور کتاب‌های موجود
- [لیگ کتابخوانی](/?tab=league): جدول امتیازات و رده‌بندی دانش‌آموزان برتر
- [کتاب‌های من و پروفایل](/?tab=my-books): مدیریت قفسه کتاب، امانت‌های جاری و کارنامه
- [قوانین و مقررات](/?tab=rules): آیین‌نامه رسمی امانت، نگهداری و جبران خسارت
- [رویدادها و چالش‌ها](/?tab=events): مناسبت‌های کتابخوانی و چالش‌های ویژه مدرسه
- [پنل مدیریت](/?tab=admin): داشبورد جامع مدیریت مدرسه و کتابخانه

## مستندات جامع برای هوش مصنوعی (Full LLM Documentation)
برای بررسی تخصصی معماری، الگوهای داده و مستندات تکمیلی، فایل زیر در دسترس است:
- [مستندات کامل هوش مصنوعی](/llms-full.txt)