خادم لتطبيق فلاتر باستخدام FastAPI: من أول نقطة نهاية إلى قاعدة البيانات والنشر

أن تصبح مطوّرًا شاملًا (full-stack) بفلاتر وFastAPI أمر ممكن تمامًا. يعرض هذا المقال خريطة الطريق من أول نقطة نهاية ونماذج Pydantic إلى PostgreSQL والترحيلات والنشر بـ Docker.

3 دقيقة قراءة82 مشاهدة
خادم لتطبيق فلاتر باستخدام FastAPI: من أول نقطة نهاية إلى قاعدة البيانات والنشر

إذا كنت تعرف فلاتر، فتعلّم تطوير الخادم يحوّلك من «مطوّر تطبيقات» إلى «صانع منتجات». وFastAPI خيار ممتاز لذلك: سريع وحديث، مع توثيق تلقائي، وقريب من Dart في طريقة استخدام الأنواع.

#لماذا FastAPI؟

  • سريع وغير متزامن (async).
  • يتحقق من البيانات تلقائيًا باستخدام أنواع بايثون وPydantic.
  • يولّد توثيقًا تفاعليًا (Swagger) بنفسه؛ فيعرف فريق فلاتر ما تأخذه كل نقطة نهاية وما تعيده دون أن يسأل.

#أول نقطة نهاية

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Course(BaseModel):
    id: int
    name: str
    price: int

@app.get("/api/v1/courses", response_model=list[Course])
async def list_courses():
    return [Course(id=1, name="Flutter", price=4900000)]

شغّله بـ uvicorn main:app --reload وافتح /docs.

#نماذج المدخلات والمخرجات

لاستقبال البيانات من التطبيق عرّف نموذج Pydantic. ويرفض FastAPI البيانات غير الصالحة برسالة خطأ واضحة تلقائيًا:

class OrderIn(BaseModel):
    name: str
    phone: str
    description: str | None = None

@app.post("/api/v1/orders", status_code=201)
async def create_order(data: OrderIn):
    ...

#قاعدة البيانات: PostgreSQL وSQLAlchemy

لتخزين البيانات، PostgreSQL خيار موثوق وSQLAlchemy (غير المتزامن) طبقة الوصول. ولتغيير بنية الجداول مع الوقت استخدم Alembic، فيصبح كل تغيير ترحيلًا (migration) بإصدار يُطبَّق على الخادم بأمر واحد:

alembic revision --autogenerate -m "add orders table"
alembic upgrade head

#بنية طبقية

المبدأ نفسه الذي تعلّمته في فلاتر ينطبق هنا: الموجّه (router) يستقبل الطلب ← الخدمة (service) منطق العمل ← المستودع/ORM الوصول إلى البيانات. لا تكتب المنطق داخل الموجّه.

#إصدارات الواجهة البرمجية

ابدأ المسارات بـ /api/v1/.... وعندما تتغير البنية يومًا ما تنشئ v2، وتستمر الإصدارات القديمة من تطبيقك في العمل؛ وهذا مهم لأن المستخدمين لا يحدّثون جميعًا.

#الربط مع فلاتر

في جهة فلاتر يكفي النموذج نفسه وDio من المقال السابق. ولأن Pydantic يمنح الاستجابات شكلًا ثابتًا، يبقى fromJson بسيطًا.

#النشر

  • اجمع التطبيق في صورة Docker.
  • شغّله خلف خادم ويب مثل nginx.
  • احفظ القيم الحساسة (كلمة مرور قاعدة البيانات والمفاتيح) في بيئة الخادم، لا في الشيفرة.
  • خادم VPS بسيط يكفي للبداية؛ ثم وسّع مع نمو الزيارات.

#مسار تعلّم مقترح

1) بايثون وasync، 2) FastAPI وPydantic، 3) SQL وPostgreSQL، 4) المصادقة، 5) Docker والنشر. بعد ذلك تستطيع بناء أي تطبيق فلاتر بنفسك من البداية إلى النهاية.

هل تحتاج إلى تطبيق أو موقع؟

يبني فريق فست فلاتر تطبيقات أندرويد وiOS والويب وسطح المكتب والمواقع بفلاتر: تقدير فوري بالدولار، ودفع على مراحل، والشيفرة المصدرية كاملة.