کتاب‌یار - پلتفرم مطالعه آنلاین

پلتفرم مطالعه آنلاین با امکانات پیشرفته برای یادگیری زبان انگلیسی

ویژگی‌ها

• مطالعه کتاب‌های انگلیسی با رابط کاربری مدرن و کاربرپسند
• ترجمه و توضیح کلمات دشوار با استفاده از هوش مصنوعی
• سیستم مدیریت واژگان و یادگیری با فلش‌کارت
• پنل مدیریت پیشرفته برای افزودن و مدیریت کتاب‌ها
• پشتیبانی از سطوح مختلف زبانی (مبتدی، متوسط، پیشرفته)
• امکان نشانک‌گذاری و هایلایت کردن متن
• تنظیمات شخصی‌سازی برای مطالعه (اندازه فونت، حالت تاریک/روشن و...)
• احراز هویت با ایمیل و گوگل

پیش‌نیازها

• Node.js نسخه 18 یا بالاتر
• حساب کاربری Supabase
• کلید API سرویس Gemini از Google AI Studio
• حساب Google Analytics (اختیاری)

نصب و راه‌اندازی

1. کلون کردن مخزن:

```bash git clone https://github.com/your-username/ketabyar.git cd ketabyar ```

2. نصب وابستگی‌ها:

```bash npm install ```

3. ایجاد فایل .env.local با استفاده از نمونه .env.example و تنظیم متغیرهای محیطی:

```bash cp .env.example .env.local ```

4. ویرایش فایل .env.local و تنظیم مقادیر مناسب برای متغیرهای محیطی.

5. اجرای برنامه در محیط توسعه:

```bash npm run dev ```

6. مرورگر به صورت خودکار در آدرس http://localhost:3000 باز می‌شود.

تنظیم پایگاه داده Supabase

1. ایجاد حساب کاربری در Supabase
2. ایجاد پروژه جدید
3. اجرای اسکریپت‌های SQL موجود در پوشه supabase/migrations برای ایجاد جداول مورد نیاز
4. کپی کردن URL و کلید Anonymous از بخش Project Settings > API و قرار دادن آن‌ها در فایل .env.local

دریافت کلید API سرویس Gemini

1. مراجعه به Google AI Studio
2. ایجاد کلید API جدید
3. کپی کردن کلید API و قرار دادن آن در فایل .env.local

انتشار

برای انتشار برنامه در محیط تولید:

```bash npm run build npm run start ```

یا استفاده از سرویس‌های ابری مانند Vercel یا Netlify.

مشارکت

از مشارکت شما در توسعه این پروژه استقبال می‌کنیم. لطفاً برای مشارکت، ابتدا یک Issue ایجاد کنید یا Pull Request ارسال نمایید.

مجوز

این پروژه تحت مجوز MIT منتشر شده است. برای اطلاعات بیشتر به فایل LICENSE مراجعه کنید.

پشتیبانی

در صورت بروز هرگونه مشکل یا سوال، لطفاً از طریق بخش Issues در GitHub با ما در ارتباط باشید.