تعلم Python ابنِ تطبيق ويب بـ Flask وSQLite من الصفر جزء ثاني

تعلم Python المتوسط: ابنِ تطبيق ويب بـ Flask وSQLite من الصفر

🐍 تعلم Python المتوسط: ابنِ تطبيق ويب احترافياً بـ Flask وSQLite من الصفر

الجزء الثاني من سلسلة بايثون: ننتقل من أكواد الطرفية إلى تطبيق ويب حقيقي يحفظ بياناته في قاعدة بيانات، مع واجهة وREST API واختبارات وGit.

✍ Soufiane Lahdim 📅 نُشر: 7 نوفمبر 2026 🔄 آخر تحديث: 7 نوفمبر 2026
الجزء 2من سلسلة بايثون
متوسطمستوى المقال
مشروع كاملFlask + SQLite
13 دقيقةوقت القراءة

بعد أن تعلمت في الجزء الأول المتغيرات والشروط والحلقات والدوال والبرمجة الكائنية، تأتي المرحلة التي يسأل عنها كل مبتدئ: كيف أحول ما تعلمته إلى تطبيق يستخدمه الناس فعلاً؟ هذا الجزء يجيب عن هذا السؤال، وهو الجزء الثاني من دليل تعلم بايثون من الصفر حتى الاحتراف.

الخلاصة السريعة: لبناء تطبيق ويب بسيط بـ Python تحتاج أربعة أشياء: بيئة افتراضية تعزل مكتبات المشروع، وقاعدة بيانات SQLite تحفظ المعلومات، وإطار Flask يستقبل طلبات المتصفح، وقوالب HTML تعرض النتيجة. ستبني كل ذلك هنا في تطبيق لإدارة المهام، ثم تتعلم كيف تختبره وتحميه وتتتبع تطوره بـ Git.
📚 سلسلة تعلم بايثون على Morocco ICO
  1. الجزء الأول: بايثون من الصفر مع مشروع إدارة مهام في الطرفية
  2. الجزء الثاني (أنت هنا): تطبيق ويب بـ Flask وSQLite
إعلان

1. ما الجديد في هذا الجزء؟

في الجزء الأول بنيت مدير مهام يعمل في الطرفية ويحفظ بياناته داخل ملف JSON. هذه طريقة ممتازة للتعلم، لكنها تتوقف عند حدود معينة: لا واجهة يستخدمها غير المبرمجين، ولا قدرة على الاستعلام عن البيانات بسهولة، ولا إمكانية لأن يتعامل معها تطبيق آخر. اليوم نعيد بناء الفكرة نفسها بأدوات المشاريع الحقيقية.

الجزء الأول CLI + ملف JSON الجزء الثاني Flask + SQLite + واجهة ويب نفس الفكرة بأدوات أقوى © Soufiane Lahdim - Morocco ICO
الانتقال من الطرفية وملف JSON إلى تطبيق ويب وقاعدة بيانات. © Soufiane Lahdim - Morocco ICO
الجانبالجزء الأول (JSON + CLI)هذا الجزء (SQLite + Flask)
طريقة الاستخدامأوامر نصية في الطرفيةصفحة ويب تفتح في المتصفح
تخزين البياناتملف JSON يُقرأ ويُكتب بالكاملجدول في قاعدة بيانات يمكن الاستعلام عنه
البحث والترتيبحلقات تكتبها بنفسكجمل SQL مثل ORDER BY
التكامل مع تطبيقات أخرىغير متاحممكن عبر REST API بصيغة JSON
المستخدم المستهدفالمبرمج نفسهأي مستخدم لديه متصفح
ملاحظة: يفترض هذا الدليل أنك تعرف أساسيات Python. إن كنت ما زلت في البداية فارجع إلى الجزء الأول ثم عد إلى هنا، فالأمثلة ستكون أوضح كثيراً.

2. إعداد بيئة العمل

كلما كبر المشروع احتجت إلى محرر يساعدك على تنظيم الملفات واكتشاف الأخطاء قبل التشغيل. اختر واحداً من هذه الخيارات:

  • Visual Studio Code: محرر مجاني ومرن يدعم Python عبر الإضافة الرسمية، وهو خيار مناسب لمعظم المبتدئين.
  • PyCharm: بيئة تطوير متخصصة في Python بإمكانات متقدمة لإدارة المشاريع.
  • Thonny: بيئة بسيطة جداً تناسب التجارب الأولى.
  • Google Colab: بيئة تعمل في المتصفح وتناسب التجارب السريعة، لكنها ليست الخيار الأنسب لتشغيل خادم ويب كمشروعنا.

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

3. تنظيم المشروع وهيكلة الملفات

أكثر خطأ يرتكبه المبتدئون هو وضع كل شيء في ملف واحد. في المشاريع الحقيقية يُقسّم العمل بحسب الوظيفة: ملف للمنطق، ومجلد للقوالب، ومجلد للملفات الثابتة مثل CSS. وهذا هو الهيكل الذي سنعمل به:

task_manager/
│
├── app.py                 # منطق التطبيق والمسارات
├── test_app.py            # الاختبارات
├── requirements.txt       # المكتبات المطلوبة
├── tasks.db               # قاعدة البيانات (تُنشأ تلقائياً)
│
├── templates/
│   ├── index.html         # الصفحة الرئيسية
│   └── edit.html          # صفحة تعديل مهمة
│
└── static/
    └── style.css          # التنسيق

يبحث Flask تلقائياً عن القوالب داخل مجلد باسم templates وعن الملفات الثابتة داخل مجلد static، لذلك التزم بهذين الاسمين تماماً.

4. البيئات الافتراضية وإدارة المكتبات

البيئة الافتراضية Virtual Environment مجلد معزول يحتفظ بمكتبات مشروعك وإصداراتها دون أن يؤثر على المشاريع الأخرى أو على بايثون العامة في جهازك. تخيل أن مشروعاً قديماً يحتاج إصداراً معيناً من مكتبة، ومشروعاً جديداً يحتاج إصداراً أحدث منها: بدون العزل سيتعارض الاثنان.

إنشاء بيئة افتراضية داخل مجلد المشروع:

python -m venv venv

تفعيلها على Windows:

venv\Scripts\activate

تفعيلها على Linux أو macOS:

source venv/bin/activate

بعد التفعيل يظهر اسم البيئة في بداية سطر الطرفية. ثبّت Flask الآن:

pip install flask

ولحفظ قائمة المكتبات التي يحتاجها مشروعك، حتى تعيد تثبيتها على جهاز آخر بأمر واحد:

pip freeze > requirements.txt
pip install -r requirements.txt
نصيحة: لا ترفع مجلد venv إلى GitHub. يكفي ملف requirements.txt، وتضيف اسم المجلد إلى ملف .gitignore كما سنرى في قسم Git.

5. قواعد البيانات مع SQLite

ما دام برنامجك يحفظ بياناته في متغيرات فستختفي كلها عند إغلاقه. قاعدة البيانات تحل المشكلة بتخزين المعلومات بشكل دائم ومنظم وقابل للاستعلام. وSQLite خيار مثالي للتعلم لأنها لا تحتاج إلى تثبيت خادم منفصل: قاعدة البيانات كلها ملف واحد، ومكتبة sqlite3 تأتي مدمجة مع Python. وإن أردت فهم أعمق لمفاهيم الجداول والعلاقات وSQL فستجده في دليل تعلم قواعد البيانات من البداية حتى الاحتراف.

إنشاء جدول

import sqlite3

connection = sqlite3.connect("database.db")
cursor = connection.cursor()

cursor.execute("""
CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL
)
""")

connection.commit()
connection.close()
print("Database created successfully!")

الأمر CREATE TABLE IF NOT EXISTS ينشئ الجدول إن لم يكن موجوداً، فيمكنك تشغيل الكود أكثر من مرة دون أخطاء. والحقل id رقم يزيد تلقائياً مع كل صف جديد، أما UNIQUE فتمنع تكرار البريد الإلكتروني.

إضافة البيانات وقراءتها

import sqlite3

connection = sqlite3.connect("database.db")
cursor = connection.cursor()

# إضافة
cursor.execute(
    "INSERT INTO users (name, email) VALUES (?, ?)",
    ("Ahmed", "ahmed@example.com")
)
connection.commit()

# قراءة
cursor.execute("SELECT * FROM users")
for user in cursor.fetchall():
    print(user)

connection.close()
قاعدة لا تتجاوزها: مرر القيم دائماً عبر علامات الاستفهام ? بدل دمجها في نص الاستعلام. هذا ما يمنع هجمات SQL Injection، وسنوضح السبب في قسم الحماية.
إعلان

6. أول تطبيق Flask

Flask إطار عمل ويب مكتوب بـ Python. يستقبل طلب المتصفح، ويشغل الدالة المرتبطة بالعنوان المطلوب، ثم يعيد الرد. من مزاياه أنه خفيف وسهل التعلم ومرن في تنظيم المشاريع، ويدعم قوالب Jinja لعرض HTML، ويمكن ربطه بقواعد بيانات متنوعة.

أنشئ ملفاً باسم app.py واكتب فيه:

from flask import Flask

app = Flask(__name__)

@app.route("/")
def home():
    return "Welcome to Python Web Development!"

if __name__ == "__main__":
    app.run(debug=True)

شغّله بالأمر python app.py ثم افتح المتصفح على العنوان http://127.0.0.1:5000. سترى الرسالة التي كتبتها. السطر @app.route("/") يسمى Decorator، ومعناه: «عندما يطلب أحد المسار الرئيسي، نفّذ الدالة التي تليني».

المتصفح يرسل الطلب ويعرض الصفحة Flask app.py + templates SQLite tasks.db طلب HTTP SQL النتائج صفحة HTML © Soufiane Lahdim - Morocco ICO
رحلة الطلب داخل تطبيق مدير المهام. © Soufiane Lahdim - Morocco ICO
تنبيه: وضع debug=True مناسب للتطوير المحلي فقط لأنه يعيد تشغيل الخادم عند تعديل الكود ويعرض تفاصيل الأخطاء. لا تفعّله أبداً عند نشر التطبيق للجمهور.

7. ربط Python بقوالب HTML وCSS

الرد النصي البسيط لا يصلح لتطبيق حقيقي، فالمستخدم يحتاج صفحة منسقة. هنا يأتي دور HTML وCSS: تتولى Python المنطق والبيانات، وتتولى القوالب العرض. تعرف أكثر على لغات الواجهة من دليل تعلم HTML وCSS وJavaScript إن لم تكن متمكناً منها.

تستخدم Flask الدالة render_template لعرض ملف من مجلد templates، وتمرر له أي بيانات تريد عرضها:

from flask import Flask, render_template

app = Flask(__name__)

@app.route("/")
def home():
    return render_template("index.html", name="أحمد")

if __name__ == "__main__":
    app.run(debug=True)

وداخل القالب تستعمل صيغة Jinja للوصول إلى المتغيرات:

<!DOCTYPE html>
<html lang="ar" dir="rtl">
<head>
    <meta charset="UTF-8">
    <title>My Python Website</title>
</head>
<body>
    <h1>مرحباً {{ name }}</h1>
    <p>هذه أول واجهة ويب باستخدام Flask.</p>
</body>
</html>

الميزة المهمة أن Jinja تهرّب المحتوى المعروض تلقائياً في قوالب HTML، أي تحول رموز مثل < إلى صيغة آمنة، وهذا يقلل خطر هجمات XSS عندما تعرض نصوصاً أدخلها المستخدمون.

8. بناء REST API

الواجهة البرمجية API تسمح لبرنامج آخر بالتحدث مع تطبيقك دون المرور بالصفحات. فتطبيق هاتف مثلاً يمكنه طلب قائمة المهام بصيغة JSON وعرضها بطريقته الخاصة. في Flask يكفي أن تعيد النتيجة عبر jsonify:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route("/api/info")
def info():
    return jsonify({
        "name": "Morocco ICO",
        "language": "Python",
        "status": "active"
    })

if __name__ == "__main__":
    app.run(debug=True)

عند زيارة /api/info ستحصل على استجابة JSON. وتتبع واجهات REST اصطلاحات معروفة في استخدام أفعال HTTP ورموز الحالة:

الفعلالاستخدام المعتادمثال
GETقراءة البياناتجلب قائمة المهام
POSTإنشاء عنصر جديدإضافة مهمة
PUTتعديل عنصرتغيير عنوان مهمة
DELETEحذف عنصرإزالة مهمة

أما رموز الحالة فأشهرها 200 للنجاح، و201 عند إنشاء عنصر، و404 حين لا يوجد المطلوب، و400 عند خطأ في الطلب، و500 عند خطأ في الخادم. سنضيف مساراً /api/tasks إلى مشروعنا في الخطوة العملية.

9. معالجة الأخطاء والاختبارات

المبرمج المحترف لا يكتفي بأن يعمل الكود في الحالة المثالية، بل يسأل: ماذا لو أدخل المستخدم نصاً بدل رقم؟ وماذا لو غاب الملف المطلوب؟ لهذا نستعمل try وexcept:

try:
    number = int(input("Enter a number: "))
    result = 100 / number
    print(result)

except ValueError:
    print("Please enter a valid number.")

except ZeroDivisionError:
    print("Division by zero is not allowed.")

التقط الأخطاء المحددة التي تتوقعها بدل استخدام except عاماً يبتلع كل شيء، لأن الأخطاء المخفية هي الأصعب في الاكتشاف لاحقاً. وفي Flask يمكنك تخصيص الرد على الأخطاء الشائعة:

@app.errorhandler(404)
def not_found(error):
    return "الصفحة المطلوبة غير موجودة", 404

الاختبارات الآلية باستخدام unittest

الاختبار الآلي كود يتحقق من أن كودك يعمل كما تتوقع، وتشغله بعد كل تعديل لتكتشف ما كسرته قبل أن يراه المستخدم. تأتي المكتبة unittest مدمجة مع Python:

import unittest

def add(a, b):
    return a + b

class TestCalculator(unittest.TestCase):

    def test_add(self):
        self.assertEqual(add(5, 3), 8)

    def test_negative(self):
        self.assertEqual(add(-2, 2), 0)

if __name__ == "__main__":
    unittest.main()

ولاختبار تطبيق Flask تستعمل app.test_client() الذي يحاكي متصفحاً دون تشغيل خادم حقيقي. سنكتب اختباراً من هذا النوع لمشروعنا في الخطوة التطبيقية.

10. Git وGitHub

عندما يكبر مشروعك تحتاج إلى سجل يوثق كل تعديل ويسمح لك بالرجوع إلى نسخة سابقة إن أفسدت شيئاً. Git هو نظام إدارة الإصدارات، وGitHub منصة لاستضافة المستودعات ومشاركتها. وهما أيضاً أسرع طريق لبناء ملف أعمال يراه أصحاب العمل، كما شرحنا في دليل إنشاء Portfolio احترافي.

git init
git add .
git commit -m "Initial project"
git status
git log

قبل أول commit أنشئ ملفاً باسم .gitignore وأضف إليه ما لا يجب رفعه:

venv/
__pycache__/
*.db

بهذا لن تُرفع البيئة الافتراضية ولا ملفات الكاش ولا قاعدة بياناتك التي قد تحتوي على معلومات شخصية. وللتعمق راجع التوثيق الرسمي لـ Git.

11. المشروع التطبيقي: بناء تطبيق مدير المهام

🎯 فكرة المشروع

تطبيق ويب يتيح للمستخدم إدارة مهامه اليومية من المتصفح، وهو النسخة الويب من مدير المهام الذي بنيناه في الطرفية سابقاً.

المميزات:
  • إضافة مهمة جديدة.
  • تعديل عنوان المهمة.
  • تحديد المهمة كمكتملة أو إعادة فتحها.
  • حذف المهمة بعد تأكيد.
  • حفظ كل شيء في SQLite.
  • نقطة API تعرض المهام بصيغة JSON.

الخطوة 1: إنشاء المشروع وتثبيت Flask

أنشئ مجلد task_manager وافتحه في الطرفية، ثم أنشئ البيئة الافتراضية وفعّلها كما في القسم الرابع، وثبّت Flask:

pip install flask

الخطوة 2: ملف app.py

انسخ الكود التالي كاملاً. لاحظ أن كل مسار يؤدي وظيفة واحدة، وأن جميع الاستعلامات تستخدم المعاملات ?:

from flask import (
    Flask, render_template, request,
    redirect, url_for, jsonify
)
import sqlite3

app = Flask(__name__)

DATABASE = "tasks.db"


def get_db():
    connection = sqlite3.connect(DATABASE)
    connection.row_factory = sqlite3.Row
    return connection


def init_db():
    with get_db() as db:
        db.execute("""
            CREATE TABLE IF NOT EXISTS tasks (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                title TEXT NOT NULL,
                completed INTEGER DEFAULT 0
            )
        """)


@app.route("/")
def index():
    with get_db() as db:
        tasks = db.execute(
            "SELECT * FROM tasks ORDER BY id DESC"
        ).fetchall()
    return render_template("index.html", tasks=tasks)


@app.route("/add", methods=["POST"])
def add_task():
    title = request.form.get("title", "").strip()
    if title:
        with get_db() as db:
            db.execute(
                "INSERT INTO tasks (title) VALUES (?)",
                (title,)
            )
    return redirect(url_for("index"))


@app.route("/complete/<int:task_id>", methods=["POST"])
def complete_task(task_id):
    with get_db() as db:
        db.execute(
            """
            UPDATE tasks
            SET completed = CASE
                WHEN completed = 0 THEN 1
                ELSE 0
            END
            WHERE id = ?
            """,
            (task_id,)
        )
    return redirect(url_for("index"))


@app.route("/delete/<int:task_id>", methods=["POST"])
def delete_task(task_id):
    with get_db() as db:
        db.execute("DELETE FROM tasks WHERE id = ?", (task_id,))
    return redirect(url_for("index"))


@app.route("/edit/<int:task_id>", methods=["GET", "POST"])
def edit_task(task_id):
    with get_db() as db:
        task = db.execute(
            "SELECT * FROM tasks WHERE id = ?", (task_id,)
        ).fetchone()

        if task is None:
            return "Task not found", 404

        if request.method == "POST":
            title = request.form.get("title", "").strip()
            if title:
                db.execute(
                    "UPDATE tasks SET title = ? WHERE id = ?",
                    (title, task_id)
                )
                return redirect(url_for("index"))

    return render_template("edit.html", task=task)


@app.route("/api/tasks")
def api_tasks():
    with get_db() as db:
        rows = db.execute(
            "SELECT * FROM tasks ORDER BY id DESC"
        ).fetchall()
    return jsonify([dict(row) for row in rows])


if __name__ == "__main__":
    init_db()
    app.run(debug=True)

ما يستحق الانتباه في هذا الكود أربعة أمور. أولاً، الدالة get_db تضبط row_factory على sqlite3.Row فتصل إلى الأعمدة بأسمائها مثل task.title بدل الأرقام. ثانياً، مسارات الحذف والإكمال تقبل POST فقط، لأن العمليات التي تغير البيانات لا يجب أن تُنفذ بمجرد فتح رابط. ثالثاً، الوسم <int:task_id> يحول جزء الرابط إلى رقم صحيح تلقائياً ويرفض القيم غير الرقمية. رابعاً، مسار /api/tasks يعيد البيانات نفسها بصيغة JSON، فأي تطبيق آخر يستطيع قراءتها.

معلومة تقنية: عند استخدام with get_db() as db تنفذ SQLite عملية commit تلقائياً عند نجاح الكتلة، أو تتراجع عند حدوث خطأ، لكن الاتصال نفسه لا يُغلق. وهذا مقبول في مشروع تعليمي صغير، وفي المشاريع الأكبر يُدار الاتصال بشكل أدق، مثلاً بإغلاقه صراحة عبر contextlib.closing أو باستخدام مكتبة ORM.

الخطوة 3: قالب index.html

أنشئ مجلد templates داخل المشروع، ثم ملف index.html. حلقة for في Jinja تعرض المهام، والجزء else يظهر عندما تكون القائمة فارغة:

<!DOCTYPE html>
<html lang="ar" dir="rtl">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>مدير المهام</title>
    <link rel="stylesheet"
          href="{{ url_for('static', filename='style.css') }}">
</head>
<body>
<div class="container">

    <h1>📋 مدير المهام</h1>
    <p>نظم مهامك اليومية بسهولة</p>

    <form action="/add" method="POST">
        <input type="text" name="title"
               placeholder="اكتب مهمة جديدة..."
               maxlength="200" required>
        <button type="submit">إضافة مهمة</button>
    </form>

    <h2>قائمة المهام</h2>

    {% for task in tasks %}
    <div class="task">
        <span class="{% if task.completed %}done{% endif %}">
            {{ task.title }}
        </span>

        <div class="actions">
            <form action="/complete/{{ task.id }}" method="POST">
                <button type="submit">
                    {% if task.completed %}إعادة فتح{% else %}إكمال{% endif %}
                </button>
            </form>

            <a href="/edit/{{ task.id }}">تعديل</a>

            <form action="/delete/{{ task.id }}" method="POST"
                  onsubmit="return confirm('هل تريد حذف المهمة؟')">
                <button type="submit" class="delete">حذف</button>
            </form>
        </div>
    </div>
    {% else %}
    <p>لا توجد مهام حالياً. أضف مهمتك الأولى!</p>
    {% endfor %}

</div>
</body>
</html>

الخطوة 4: قالب edit.html

<!DOCTYPE html>
<html lang="ar" dir="rtl">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>تعديل المهمة</title>
    <link rel="stylesheet"
          href="{{ url_for('static', filename='style.css') }}">
</head>
<body>
<div class="container">

    <h1>تعديل المهمة</h1>

    <form method="POST">
        <input type="text" name="title"
               value="{{ task.title }}"
               maxlength="200" required>
        <button type="submit">حفظ التعديلات</button>
    </form>

    <a href="/">العودة إلى القائمة</a>

</div>
</body>
</html>

الخطوة 5: ملف static/style.css

* { box-sizing: border-box; }

body {
    margin: 0;
    padding: 20px;
    background: #101827;
    color: #e5e7eb;
    font-family: Arial, sans-serif;
}

.container {
    max-width: 750px;
    margin: 35px auto;
    background: #1e293b;
    padding: 25px;
    border-radius: 15px;
}

h1 { color: #60d5a4; }

input {
    width: 100%;
    padding: 13px;
    margin: 12px 0;
    border: 1px solid #475569;
    border-radius: 8px;
    background: #0f172a;
    color: white;
}

button, .actions a {
    border: none;
    padding: 9px 14px;
    border-radius: 7px;
    background: #0d9488;
    color: white;
    cursor: pointer;
    text-decoration: none;
}

.task {
    background: #0f172a;
    padding: 15px;
    margin: 12px 0;
    border-radius: 9px;
}

.actions {
    display: flex;
    flex-wrap: wrap;
    gap: 8px;
    margin-top: 12px;
}

.actions form { margin: 0; }
.delete { background: #dc2626; }
.done { text-decoration: line-through; color: #94a3b8; }

@media (max-width: 500px) {
    .container { padding: 16px; }
}

الخطوة 6: التشغيل والتجربة

تأكد أن الملفات في أماكنها وفق هيكل المشروع، ثم نفذ:

python app.py

افتح http://127.0.0.1:5000 وجرب إضافة مهمة وتعديلها وإكمالها وحذفها. ثم افتح http://127.0.0.1:5000/api/tasks لترى المهام نفسها بصيغة JSON، أو من الطرفية:

curl http://127.0.0.1:5000/api/tasks

الخطوة 7: اختبار المشروع

أنشئ ملفاً باسم test_app.py بجوار app.py. يتحقق هذا الاختبار من أن صفحة المهام تعمل وأن مسار API يعيد JSON:

import unittest
from app import app, init_db


class TaskAppTest(unittest.TestCase):

    def setUp(self):
        init_db()
        self.client = app.test_client()

    def test_home_page(self):
        response = self.client.get("/")
        self.assertEqual(response.status_code, 200)

    def test_api_returns_json(self):
        response = self.client.get("/api/tasks")
        self.assertEqual(response.status_code, 200)
        self.assertTrue(response.is_json)


if __name__ == "__main__":
    unittest.main()

شغّله بالأمر python -m unittest. ولاحظ أن هذا الاختبار يستعمل ملف tasks.db الحقيقي لبساطته. في المشاريع الأكبر يُفضل استخدام قاعدة بيانات مؤقتة للاختبار حتى لا تختلط بياناتك الفعلية بالتجارب.

تنبيه أمني: هذا مشروع تعليمي محلي وليس تطبيقاً جاهزاً للنشر العام. قبل نشره أضف حماية CSRF، وعطّل وضع debug، واستخدم خادم إنتاج، وأضف مصادقة المستخدمين إن كانت البيانات خاصة.

12. الأخطاء الشائعة وحلولها

ستواجه بعض الأخطاء في أول تشغيل، وهذا طبيعي. هذه أكثرها تكراراً مع المبتدئين في هذا المشروع وطريقة التعامل معها:

رسالة الخطأالسبب المعتادالحل
ModuleNotFoundError: No module named 'flask'لم تُثبَّت Flask، أو البيئة الافتراضية غير مفعلةفعّل البيئة ثم نفذ pip install flask
TemplateNotFoundمجلد القوالب باسم مختلف أو في مكان خاطئسمّه templates بالضبط وضعه بجوار app.py
405 Method Not Allowedأرسلت طلباً بفعل لا يقبله المسار، مثل فتح رابط الحذف مباشرةاستخدم نموذجاً بطريقة POST كما في القالب
no such table: tasksلم تُنشأ الجدول بعدشغّل التطبيق من app.py ليستدعي init_db()
Address already in useالمنفذ 5000 مشغول ببرنامج آخر، ويحدث أحياناً على macOSغيّر المنفذ: app.run(debug=True, port=5001)
الأحرف العربية تظهر رموزاً غريبةغياب ترميز UTF-8 في القالبتأكد من وجود <meta charset="UTF-8"> وحفظ الملف بترميز UTF-8

القاعدة الذهبية في التعامل مع الأخطاء: اقرأ آخر سطر في رسالة الخطأ أولاً فهو يذكر نوع المشكلة، ثم انظر إلى اسم الملف ورقم السطر في الأعلى. وعندما يعمل المشروع ينتهي الجزء الأسهل، أما الأهم فهو أن تفهم لماذا يعمل.

13. أساسيات حماية تطبيقات الويب

تطبيق يعمل لا يعني تطبيقاً آمناً. كل مدخل يكتبه المستخدم قد يكون محاولة اختراق، لذلك يجب أن تعرف الأخطار الأشهر. وإن أردت رؤية أشمل للأمن الرقمي فاقرأ دليل الأمن السيبراني لحماية الهواتف والحواسيب.

SQL Injection

يحدث عندما تدمج مدخلات المستخدم في نص الاستعلام مباشرة، فيستطيع المهاجم تغيير معنى الاستعلام. قارن بين الطريقتين:

# خطر: دمج النص في الاستعلام
cursor.execute(f"SELECT * FROM users WHERE email = '{email}'")

# آمن: استعلام بمعاملات
cursor.execute("SELECT * FROM users WHERE email = ?", (email,))

في الطريقة الثانية تُعامل القيمة دائماً كبيانات لا كجزء من أمر SQL.

بقية المخاطر الأساسية

  • XSS: حقن سكربت في صفحة تعرض محتوى المستخدمين. تخفف Jinja منه بالتهريب التلقائي، فلا تعطّله إلا لسبب قوي.
  • CSRF: تزوير طلب يرسله متصفح مستخدم مسجل دون علمه. يعالج بمكتبات مثل Flask-WTF التي توفر CSRFProtect.
  • تخزين كلمات المرور: لا تحفظها كنص عادي أبداً. استعمل دوال تجزئة مناسبة مثل generate_password_hash وcheck_password_hash من werkzeug.security.
  • HTTPS: يشفر الاتصال بين المستخدم والخادم، ويلزم عند النشر.
  • الأسرار: احفظ المفاتيح وكلمات مرور قواعد البيانات في متغيرات بيئة لا في الكود المصدري، ولا ترفعها إلى GitHub.

لمعرفة أهم مخاطر تطبيقات الويب كما يصنفها المختصون راجع قائمة OWASP Top 10، ولتفاصيل Flask الأمنية صفحة أمان تطبيقات الويب في توثيق Flask.

14. خارطة الطريق بعد هذا الجزء

بعد إتمام المشروع ستجد أمامك عدة طرق، والاختيار يعتمد على ما يشدك. هذه المسارات الأشهر:

المسارالمهاراتالخطوة التالية المقترحة
تطوير الويبFlask، Django، APIs، SQLإضافة تسجيل دخول للمشروع
تحليل البياناتNumPy، Pandas، Matplotlibتحليل بيانات المهام المخزنة
الذكاء الاصطناعيScikit-learn، PyTorch، TensorFlowمشروع تصنيف بسيط
الأتمتةRequests، Selenium، السكربتاتأتمتة مهمة متكررة في عملك
الأمن السيبرانيالشبكات، سكربتات Python، تحليل السجلاتأدوات فحص بسيطة لشبكتك

وإن شدّك مسار الأتمتة والذكاء الاصطناعي فابدأ بقراءة دليل وكلاء الذكاء الاصطناعي AI Agents لترى كيف تُبنى الأنظمة التي تنفذ المهام بنفسها. وعندما تريد عرض مشروعك للعالم فاقرأ المقارنة بين الاستضافة المجانية والمدفوعة لتعرف ما يناسب تطبيقك قبل النشر.

خطة تعلم مقترحة لمدة 12 أسبوعاً

  • الأسبوعان 1 و2: تنظيم المشاريع والبيئات الافتراضية.
  • الأسبوعان 3 و4: قواعد البيانات وSQL.
  • الأسبوعان 5 و6: Flask وHTML وCSS.
  • الأسبوعان 7 و8: REST API والتعامل مع JSON.
  • الأسبوعان 9 و10: الاختبارات وحماية التطبيقات وGit.
  • الأسبوعان 11 و12: بناء مشروع شخصي متكامل ونشره.

هذه الخطة مجرد اقتراح وليست مدة إلزامية، فالوقت الفعلي يتوقف على خبرتك السابقة وساعات الممارسة. المهم أن تبني مشاريع صغيرة باستمرار بدل الاكتفاء بالقراءة.

15. الأسئلة الشائعة

يفضل ذلك. هذا الجزء يفترض أنك تعرف المتغيرات والشروط والحلقات والدوال وأساسيات OOP. إن كنت تعرفها فيمكنك البدء مباشرة، وإلا فابدأ بالجزء الأول ثم عد إلى هنا.
نعم، فهما إطاران مستقلان. Flask أخف وأسهل للبداية، وDjango أكثر اكتمالاً ويأتي بأدوات جاهزة كثيرة. يمكنك البدء بأي منهما ثم الانتقال للآخر عند الحاجة.
هي مناسبة للتعلم والتطبيقات الصغيرة والمتوسطة. أما التطبيقات التي تستقبل كتابات متزامنة كثيرة من مستخدمين عديدين فقد تحتاج إلى قاعدة بيانات خادمية مثل PostgreSQL.
Flask إطار خفيف يوفر الأساسيات ويترك لك حرية اختيار المكونات. Django إطار متكامل يوفر نظام مستخدمين ولوحة إدارة وأدوات قواعد بيانات جاهزة.
نعم عبر أطر مثل Kivy وBeeWare، لكن Python تستخدم بكثرة أيضاً في بناء الخوادم وواجهات API التي تعتمد عليها تطبيقات الهاتف.
لا، هو مشروع تعليمي محلي. قبل النشر يجب إضافة حماية CSRF وتعطيل وضع debug واستخدام خادم إنتاج وإضافة مصادقة عند الحاجة.
إعلان

16. مصادر رسمية للمتابعة

17. الخلاصة

لا يتوقف تعلم Python عند المتغيرات والدوال والحلقات. المرحلة الحقيقية تبدأ حين تحول أفكارك إلى تطبيقات تتعامل مع قواعد البيانات والواجهات والخدمات المختلفة. في هذا الجزء انتقلنا من أكواد الطرفية إلى تطبيق ويب كامل بـ Flask وSQLite، وتعرفنا على البيئات الافتراضية وواجهات REST والاختبارات وإدارة الإصدارات وأساسيات الحماية.

لا تكتفِ بقراءة الكود. شغّل المشروع، ثم غيّر تصميمه، وأضف إليه خاصية جديدة مثل تاريخ استحقاق المهمة أو أولويتها أو البحث بين المهام. كل خاصية تضيفها بنفسك تعلمك أكثر من عشرة أمثلة تنسخها. وإن فاتتك الأساسيات فارجع إلى الجزء الأول من سلسلة بايثون، ثم عد لإكمال المشروع.

Soufiane Lahdim

مدوّن تقني ومطور ويب من طنجة، المغرب. مؤسس مدونة Morocco ICO المتخصصة في الذكاء الاصطناعي والسيو والأمن السيبراني. أكتب بهدف تقريب التقنية لكل ناطق بالعربية.

إظهار التعليقات