WebAppTemplate FARM

قالب تطبيق الويب Full Stack - FARM Stack

يحتوي هذا المستودع على قالب تطبيق ويب مكدس كامل يتم تشغيله على حزمة حلول FARM، والتي تمثل:

• F lask، إطار عمل ويب بايثون الخلفي.
• خدمات الويب mazon، وهي خدمة سحابية يمكنها استضافة البرامج.
• رد فعل، إطار ويب جافا سكريبت للواجهة الأمامية.
• M ySQL، نظام إدارة قواعد البيانات العلائقية.

ما هي المزرعة؟

يعد مكدس FARM امتدادًا أو أقل لمكدس LAMP مع هذه التغييرات الملحوظة:

• إطار عمل الوسيطة واضح (Flask)
• مثل مكدس MEAN، فهو يتضمن طبقة عرض تقديمي للتطبيق (React)
• يتم بدلاً من ذلك استبدال البيئة التي يعمل عليها البرنامج بخدمات الحوسبة السحابية PaaS/IaaS (AWS)
• لا يوجد رأي حول نظام التشغيل الذي يجب استخدامه

قارورة

يتم استخدام Flask لكتابة واجهات برمجة تطبيقات الويب/البرامج الوسيطة التي يمكنها التواصل بين واجهة مستخدم الويب والواجهة الخلفية للويب/قاعدة البيانات. هذا هو جوهر التطبيق بأكمله الذي يقوم بلصق أجزاء تطبيق المكدس الكامل معًا.

لاحظ أن هذا القالب المحدد لا يستخدم ORM، وبدلاً من ذلك يستخدم وحدة pymysql . وهذا يعني أن المطورين بحاجة إلى كتابة استعلامات SQL، ولكن يمكنهم زيادة تعقيد الاستعلامات التي يحتاجونها للتشغيل على قاعدة البيانات.

خدمات الويب الأمازون

AWS هي الخدمة السحابية التي يمكن استضافة التطبيق عليها. يمكننا استضافة حزمة البرامج بأكملها على الخدمات التالية:

• AWS Lambda لاستضافة تطبيقاتنا على بنية تحتية بدون خادم. يمكننا أيضًا اختيار استضافة واجهات برمجة تطبيقات Flask الخاصة بنا عبر Zappa، مما يجعل النشر إلى الإنتاج أمرًا سهلاً للغاية.
• AWS RDS لاستضافة قاعدة بياناتنا.
• AWS S3 لتخزين جميع أنواع الكائنات الأخرى مثل الصور والملفات.

وهذا يعني أنه يمكن للمطورين الاحتفاظ بكل شيء على نظام أساسي واحد وتقليل عمل DevOps / تكنولوجيا المعلومات.

رد فعل

React هو الإطار الذي تعمل عليه واجهة مستخدم الويب. يمكن أيضًا تشغيل تطبيق React على AWS Lambda باستخدام NodeJS.

يستخدم هذا القالب JavaScript / JSX، ولكن يمكن استخدام TypeScript أيضًا.

ماي إس كيو إل

MySQL هي قاعدة البيانات العلائقية التي تستخدمها الواجهة الخلفية للويب. يمكن أيضًا استضافة هذا على AWS من خلال خدمة RDS الخاصة بها.

كيفية التشغيل محليا

لتشغيل تطبيق الويب هذا، يجب القيام بما يلي:

1. قم بإعداد مثيل MySQL محلي باستخدام المخطط في db/
2. تثبيت وحدات لواجهة برمجة التطبيقات (API) وواجهة المستخدم (UI).
3. قم بتشغيل API وواجهة المستخدم محليًا

إعداد قاعدة البيانات

لإعداد مثيل MySQL، اتبع الخطوات التالية:

1. إنشاء مثيل قاعدة بيانات MySQL والاتصال به. الطرق الأكثر شيوعًا للقيام بذلك هي باستخدام MySQL Workbench أو mysql على واجهة سطر أوامر Linux.
2. قم بتشغيل sample.sql داخل المثيل. سيقوم بإنشاء مخطط يسمى SampleInventory ثم يقوم بتهيئة جدول يسمى Inventory .

إعداد واجهة برمجة التطبيقات

يمكن العثور على قاعدة التعليمات البرمجية لـ Flask API في دليل api/ .

الإعداد لأول مرة (macOS)

1. قم بإنشاء بيئة افتراضية لـ Python باستخدام virtualenv farm-stack بعد الانتقال إلى هذا الدليل.
2. قم بتنشيطه باستخدام source farm-stack/bin/activate
3. انتقل إلى api/ وقم بتشغيل pip3 install -r requirements.txt لتثبيت جميع وحدات Python اللازمة لواجهة برمجة التطبيقات.
4. افتح dbcreds.py في دليل api/ وقم بتحرير بيانات اعتماد قاعدة البيانات حسب الحاجة.

تشغيل واجهة برمجة التطبيقات

1. تفعيل البيئة الافتراضية من الأعلى.
2. قم بتشغيل python3 app.py لتشغيل واجهة برمجة التطبيقات على http://localhost:8080 .

إعداد واجهة المستخدم

يمكن العثور على قاعدة التعليمات البرمجية لواجهة مستخدم React في دليل ui/ . يستخدم هذا القالب yarn كمدير للحزم الخاصة به؛ من المهم ألا يخلط المطورون بين مديري الحزم الآخرين مثل npm عند إضافة وحدات نمطية جديدة.

لاحظ أن الحزم مثل react-bootstrap مفقودة من هذا القالب.

الإعداد لأول مرة (macOS)

1. قم بتشغيل yarn install لتثبيت كافة التبعيات المطلوبة.

تشغيل واجهة المستخدم

1. تشغيل yarn start في التشغيل في وضع التطوير.
2. انتقل إلى http://localhost:3000 على المتصفح.