Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Book Store

یک وب‌اپلیکیشن فروشگاه کتاب ساخته‌شده با Django که امکان مدیریت، نمایش و [خرید/رزرو] کتاب‌ها را از طریق یک پنل ادمین کامل فراهم می‌کند. [یک جمله کوتاه دیگر درباره هدف پروژه — مثلاً: "کاربران می‌توانند کتاب‌ها را مرور کرده و ادمین از طریق پنل مدیریت، موجودی و اطلاعات کتاب‌ها را کنترل می‌کند."]

دمو زنده

🔗 مشاهده نسخه آنلاین

امکانات

  • نمایش لیست کتاب‌ها با جزئیات (عنوان، نویسنده، قیمت، موجودی)
  • پنل ادمین کامل برای مدیریت کتاب‌ها

تکنولوژی‌ها

  • Python / Django
  • PostgreSQL (Production) / SQLite (Development)
  • Gunicorn (سرور Production)
  • WhiteNoise (سرو فایل‌های استاتیک)
  • python-decouple / dj-database-url (مدیریت تنظیمات و اتصال دیتابیس)
  • دیپلوی روی Railway

پیش‌نیازها

  • Python 3.10 یا بالاتر
  • pip

نصب و اجرا (محلی)

کلون کردن مخزن

git clone https://github.com/mmdparimoon/Book-Store.git cd Book-Store

ساخت و فعال‌سازی محیط مجازی

python -m venv .venv source .venv/Scripts/activate # ویندوز (Git Bash)

یا: .venv\Scripts\activate # ویندوز (CMD/PowerShell)

نصب پکیج‌ها

pip install -r requirements.txt

تنظیم متغیرهای محیطی

cp .env.example .env

سپس مقادیر داخل .env را با اطلاعات واقعی پر کن (مثلاً SECRET_KEY)

اجرای مایگریشن‌ها

python manage.py migrate

ساخت کاربر ادمین (اختیاری)

python manage.py createsuperuser

اجرای سرور توسعه

python manage.py runserver سپس در مرورگر به آدرس زیر برو: http://127.0.0.1:8000/ برای دسترسی به پنل ادمین: http://127.0.0.1:8000/admin/

متغیرهای محیطی

فایل .env باید شامل موارد زیر باشد (نمونه در .env.example):

SECRET_KEY=your-secret-key-here DEBUG=True DATABASE_URL=sqlite:///db.sqlite3

دیپلوی (Deployment)

این پروژه روی Railway با PostgreSQL دیپلوی شده است. برای دیپلوی نسخه خودتان:

  1. یک مخزن PostgreSQL در Railway بسازید.
  2. متغیرهای محیطی زیر را تنظیم کنید: SECRET_KEY, DEBUG=False, DATABASE_URL, CSRF_TRUSTED_ORIGINS
  3. فایل Procfile شامل دستورات build و اجرای gunicorn است.

ساختار پروژه

Book-Store/ ├── [نام پوشه تنظیمات اصلی]/ # تنظیمات پروژه (settings, urls, wsgi) ├── [نام اپ اصلی]/ # اپلیکیشن مدیریت کتاب‌ها ├── .env.example # نمونه متغیرهای محیطی مورد نیاز ├── Procfile # دستورات اجرا برای دیپلوی ├── requirements.txt # وابستگی‌های پروژه └── manage.py

نویسنده

Mohammad Parimoon

About

A Django-based online bookstore with user authentication and admin panel

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages