banksDb Backend api

Banksdb API

API للبحث عن البنوك الهندية أو الفروع.

---

مكدس التكنولوجيا

1. Django
2. Django Rest Framework
3. postgresdb
4. redis (للتخزين المؤقت)

سمات

1. البحث عن النص الكامل
2. فهارس Postgres (للاستعلامات الأسرع ، لا أحد يكره الفهارس)
3. التخزين المؤقت (أنت تعرف لماذا)
4. postgres المشغلات
5. ترقيم الصفحات (عميلك (الواجهة الأمامية) يحبك لهذا)

---

يستخدم المشروع faetures النصي الكامل الأصلي الذي توفره PostgreSQL. هناك نوعان من البحث عن النص الكامل

1. باستخدام __Search (بواسطة Django) للبحث في عمود واحد.
2. باستخدام ترتيب البحث ، ناقل البحث والاستعلام البحث.

يحتل البحث عن النص الكامل الثاني النتائج على أساس المرتبة التي توفرها Postgres لكل نتيجة. أكبر رتبة أعلى ستكون النتيجة نتيجة.

لتحسين استعلامات البحث ، استخدمت فهارس الجن على عمود البحث. هذا جعل استفسارات بلدي تشغيل 2x أسرع. من السهل إنشاء فهرس الجن.

 CREATE INDEX INDEX_NAME ON TABLE_NAME USING GIN(COLUMN_NAME)

وفقًا لـ Postgres ، تكون فهارس GIN Docs أسرع 2-3x من الفهارس الأخرى المتوفرة في Postgres (GIST و BTREE) ولكنها تستخدم مساحة أكبر.
كما أضفت مشغلًا إلى DB والذي سيقوم تلقائيًا بإنشاء Vetor بحث على أي استعلام أو تحديث

---

باستخدام التطبيق

1. تعيين متغيرات البيئة في ملف .env في جذر المشروع

 SECRET_KEY
DB_NAME
DB_HOST
DB_USER
DB_PASSWORD
REDIS_HOST
REDIS_PASSWORD
DEBUG

2. أضف بيانات إلى قاعدة البيانات الخاصة بك ، واحصل على البيانات من هنا

psql psql -h DB_HOST -p DB_PORT -U DB_USER -d DB_NAME -f FILENAME.sql

يمكنك الحصول على ملف SQL من الريبو أعلاه

3. ترحيل DB (عبرت الأصابع ؟؟)

 python mange.py makemigrations
python manage.py migrate

4. تشغيل الخادم

 python manage.py runserver

5. قم بإجراء اختبار (اختياري)

 python manage.py test

قم بإعداد مثيل Postgres المحلي لاختبار وإضافة بيانات الاعتماد في الإعدادات.

---

نقاط النهاية

1. /API/Branses/Autocomplete/؟ q = <earch_tern> & Offset = <page_number> & limit = <age_size>
   نقطة النهاية الإكمال التلقائي ، يبحث عن عمود فرع جدول الفروع ويعيد النتيجة.

2. /api/branses/search/؟ q = <earch_term> & city = <City_Name> & Offset = <age_number> & limit = <age_size>
   يبحث في جميع أعمدة DB في جدول Bracnes في المدينة المحددة مع مصطلح البحث المحدد.

3. /API/البنوك/: معرف
   Returns Bank with id: id من جدول البنوك.

---

النشر

الهدية الحرة ؟؟ ‍♀؟ ‍♀

1. Heroku (مجاني ، مشروع Django هناك)
2. سحابة ذكية (أضف بعد أن أضيفت بعد ذلك)
3. Redis Labs Redis Cloud (مثيل Redis المجاني)

يتم تضمين كل هذه الأشياء في AWS Free Tier لكنني لا أريد مشاركة تفاصيل البطاقة الخاصة بي؟ (ليس لدي بطاقة؟).

---

القضايا المعروفة

1. البحث الجزئي Postgres Search Full Text Search هو OP ❤ ، لكنه لا يعمل بشكل جيد مع الكلمات الجزئية. على سبيل المثال ، لن تعطي أي نتيجة لـ EAS ولكنها ستقدم نتائج للشرق.
   الحل استخدم شيئًا متقدمًا مثل Elasticsearch للبحث عن النص الكامل أو مسار أو كتابة بعض المكون الإضافي المخصص للاستفادة من FTS Postgres للكلمات الجزئية.

---

التحسينات

1. أضف مستندات API (ربما تباهي) ، نظرًا لقيود الوقت ، أعتبر هذا العمل المستقبلي.

---

كلمات إغلاق

لقد استمتعت حقًا بإنشاء هذا المشروع والكثير من الأشياء الجديدة أثناء إنشاءه.

ملاحظة: اليوم (21 مايو ، 2021) هو بيثاي؟