fullstack fastapi vuejs price aggregator

مجمع أسعار Fullstack

مجمع أسعار السوبر ماركت في المملكة المتحدة عبر تجريف الويب. تم تطوير هذا لمشروع جامعتي كأفضل لاعب، لذلك هناك جوانب لا تعمل بشكل صحيح. قد أقوم بتحديثه في المستقبل.

سمات

• الواجهة الخلفية لـ Python REST عبر FastAPI
• VueJS Frontend SPA مع TypeScript باستخدام هذا القالب.
• مصادقة JWT بين الواجهة الخلفية والواجهة الأمامية
• سطر الأوامر
• عامل ميناء
• شِعر
• أسعار الويب المحذوفة عبر Selectorlib
• قم بكشط الصفحات الممكّنة لـ JavaScript باستخدام البداية

يثبت

تأكد من تثبيت Docker وNode.js.

1. استنساخ هذا المستودع
2. cd في جذر المشروع وقم بتشغيل docker-compose up --build -d . تبدأ الواجهة الخلفية، وعند التشغيل الأول، سيتم إنشاء جميع الحاويات الضرورية، الأمر الذي قد يستغرق بضع دقائق.
3. بمجرد الانتهاء من بناء الواجهة الخلفية، احصل على Shell باستخدام docker-compose exec backend bash .
4. لتهيئة قاعدة البيانات، قم بتشغيل python manage.py createdb من داخل bash shell.
   • (اختياري) لزرع قاعدة البيانات ببيانات وهمية، قم بتشغيل python manage.py seeddb لاحظ أنه تم تعيين جميع كلمات المرور على كلمة المرور
5. cd في دليل العميل، قم بتشغيل npm install الذي سيقوم بتثبيت وحدات العقدة المطلوبة.
6. قم بتشغيل npm run serve التي ستخدم الواجهة الأمامية للعميل.

عناوين URL للمشروع

عنوان URL	وصف
0.0.0.0:8000/واجهة برمجة التطبيقات	الواجهة الخلفية JSON API
0.0.0.0:8000/مستندات	الوثائق المرجعية لواجهة برمجة التطبيقات OpenAPI/Swagger للواجهة الخلفية
0.0.0.0:8000/ريدوك	الوثائق التفاعلية البديلة المقدمة من ReDoc
المضيف المحلي: 9527	تطبيق الواجهة الأمامية VueJS للصفحة الواحدة

سطر الأوامر

تتضمن الواجهة الخلفية واجهة سطر الأوامر (CLI) المستوحاة بشكل كبير من Dispatch من Netflix.

تم استخدام typer (نفس مؤلف FastAPI) لإنشاء واجهة سطر الأوامر (CLI) للمشروع ويمكن الوصول إليها عبر manager.py.

لتشغيل الأوامر، ستحتاج إلى تشغيل Shell داخل الحاوية الخلفية باستخدام:

 docker-compose run backend bash

لرؤية جميع الأوامر المتاحة:

 root@72293bee6b37:/app# python manage.py 
Usage: manage.py [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  config      Display application configuration.
  createdb    Creates an empty database.
  createrole  Add role to database.
  createuser  Create new user in the database.
  develop     Start a development server with reload.
  dropdb      Drop the existing database.
  routes      Display application routes and dependencies.
  seeddb      Add fake data to database.
  shell       Starts an interactive shell with app object imported.

الطرق

 root@72293bee6b37:/app# python manage.py routes

Application Endpoints
Path                           Methods    Dependencies
-----------------------------  ---------  --------------------------------------------------------
/api/v1/users/                 GET        ['RoleChecker: Roles: admin,user']
/api/v1/users/                 POST       ['RoleChecker: Roles: admin,user']
/api/v1/users/{id}             GET        ['RoleChecker: Roles: admin,user']
/api/v1/users/{id}             PUT        ['RoleChecker: Roles: admin,user']
/api/v1/users/{id}             DELETE     ['RoleChecker: Roles: admin,user']
/api/v1/users/{id}/roles       GET        ['RoleChecker: Roles: admin,user']
/api/v1/users/{id}/roles       PUT        ['RoleChecker: Roles: admin,user']
/api/v1/users/{id}/shops       GET        ['RoleChecker: Roles: admin,user']
/api/v1/users/{id}/shops       PUT        ['RoleChecker: Roles: admin,user']
/api/v1/roles/                 GET        ['RoleChecker: Roles: admin,user']
/api/v1/roles/                 POST       ['RoleChecker: Roles: admin,user']
/api/v1/roles/{id}             GET        ['RoleChecker: Roles: admin,user']
/api/v1/roles/{id}             PUT        ['RoleChecker: Roles: admin,user']
/api/v1/roles/{id}             DELETE     ['RoleChecker: Roles: admin,user']
/api/v1/shops/                 GET        ['RoleChecker: Roles: admin,user']
/api/v1/shops/                 POST       ['RoleChecker: Roles: admin,user']
/api/v1/shops/{id}             PUT        ['RoleChecker: Roles: admin,user']
/api/v1/shops/{id}             DELETE     ['RoleChecker: Roles: admin,user']
/api/v1/shops/listings/        GET        ['RoleChecker: Roles: admin,user']
/api/healthcheck               GET        []

التكوين

 python manage.py config

Application Configuration
Setting                     Value(s)
--------------------------  --------------------------------------------------------------------
APP_DIR                     /app/app
STATIC_DIR                  /app/app/static
EMAIL_TEMPLATES_DIR         /app/app/static/email-templates/html
PROJECT_NAME                Fastapi Backend
SERVER_HOST                 0.0.0.0
CORS_WHITELIST              ['http://localhost', 'http://localhost:8000', 'http://0.0.0.0:8000']
FASTAPI_ENV                 development
DEBUG                       False
LOG_LEVEL                   debug
FIRST_SUPERUSER             [email protected]
FIRST_SUPERUSER_PASSWORD    a5dbf43e07f4d19e5b73bc89a8f74
USERS_OPEN_REGISTRATION     True
SECRET_KEY                  **********
JWT_AUTH_LIFETIME_SECONDS   604800
JWT_EMAIL_LIFETIME_SECONDS  3600
SMTP_USER                   [email protected]
SMTP_PASSWORD               **********
SMTP_TLS                    False
SMTP_SSL                    False
SMTP_HOST                   mailhog
SMTP_PORT                   1025
POSTGRES_USER               postgres
POSTGRES_PASSWORD           **********
POSTGRES_HOST               postgres
POSTGRES_PORT               5432
POSTGRES_DB                 fastapi_backend

وجهات نظر الواجهة الأمامية

عرض تسجيل الدخول

عرض لوحة تحكم المشرف

عرض CRUD للمستخدم

عرض إنشاء المستخدم

عرض ملف تعريف المستخدم

عرض متجر CRUD

تسوق حدد العرض

عرض القوائم المحذوفة