اگر بین چند پروژه، ایده و کار روزانه پراکنده شده‌اید، ساخت یک سیستم مدیریت وظایف شخصی با پایتون و SQLite راهی ساده و کاربردی برای مرتب‌کردن کارهاست. در این آموزش از صفر یک برنامه خط فرمان می‌سازیم که بتواند وظیفه جدید ثبت کند، فهرست کارها را نشان دهد، وضعیت آن‌ها را تغییر دهد و اطلاعات را در یک پایگاه‌داده سبک ذخیره کند؛ بدون نیاز به نصب سرویس جداگانه یا رابط کاربری پیچیده.

پاسخ کوتاه: برای ساخت مدیریت وظایف با پایتون از کجا شروع کنیم؟

یک مدل ساده برای وظیفه تعریف کنید، داده‌ها را در SQLite نگه دارید و چند فرمان برای افزودن، مشاهده، تکمیل و حذف کارها بسازید. ترکیب ماژول‌های sqlite3 و argparse برای نسخه اول کاملاً کافی است. در ادامه همین مسیر را مرحله‌به‌مرحله پیاده می‌کنیم.

چرا پایتون و SQLite برای این پروژه انتخاب خوبی هستند؟

هدف این پروژه یادگیری معماری یک ابزار کوچک و قابل توسعه است، نه ساخت یک نرم‌افزار سنگین. پایتون خوانا، سریع برای نمونه‌سازی و دارای کتابخانه‌های استاندارد فراوان است. SQLite نیز یک پایگاه‌داده فایل‌محور است؛ یعنی تمام اطلاعات در یک فایل محلی ذخیره می‌شود و برای پروژه شخصی، نمونه اولیه یا ابزار آفلاین به سرور جداگانه نیاز ندارید.

راه‌اندازی سریع: بیشتر ابزارهای لازم همراه خود پایتون نصب هستند.
قابل حمل: می‌توانید فایل پایگاه‌داده را به سیستم دیگری منتقل کنید.
قابل ارتقا: بعداً امکان افزودن برچسب، مهلت انجام، اولویت و رابط وب وجود دارد.

ساختار پیشنهادی پروژه مدیریت وظایف

برای شروع، پروژه را کوچک نگه دارید تا منطق اصلی شفاف بماند. ساختار زیر برای نسخه اول کافی است:

task_manager/
├── app.py
├── database.py
└── tasks.db

فایل database.py مسئول اتصال و عملیات ذخیره‌سازی است و app.py فرمان‌های کاربر را مدیریت می‌کند. جداکردن این دو بخش باعث می‌شود در آینده، اگر رابط خط فرمان را با وب یا دسکتاپ جایگزین کردید، مجبور نباشید کل برنامه را بازنویسی کنید.

طراحی جدول وظایف

هر وظیفه حداقل به یک شناسه، عنوان، وضعیت و زمان ایجاد نیاز دارد. وضعیت را می‌توان با مقدار صفر و یک نگه داشت، اما استفاده از متن خواناتر است. در این مثال وضعیت‌های pending و done را انتخاب می‌کنیم:

CREATE TABLE IF NOT EXISTS tasks (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    title TEXT NOT NULL,
    priority INTEGER DEFAULT 2,
    status TEXT NOT NULL DEFAULT 'pending',
    created_at TEXT NOT NULL
)

اتصال امن به SQLite و آماده‌سازی پایگاه‌داده

اتصال را در یک تابع متمرکز کنید تا هر فرمان از الگوی یکسانی استفاده کند. بهتر است از with برای مدیریت اتصال بهره ببرید؛ در این حالت commit و بستن اتصال قابل پیش‌بینی‌تر است.

import sqlite3
from datetime import datetime

DB_NAME = "tasks.db"

def get_connection():
    connection = sqlite3.connect(DB_NAME)
    connection.row_factory = sqlite3.Row
    return connection

def init_db():
    with get_connection() as connection:
        connection.execute("""
            CREATE TABLE IF NOT EXISTS tasks (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                title TEXT NOT NULL,
                priority INTEGER DEFAULT 2,
                status TEXT NOT NULL DEFAULT 'pending',
                created_at TEXT NOT NULL
            )
        """)

استفاده از query پارامتری در تمام ورودی‌های کاربر ضروری است. به‌جای چسباندن مستقیم عنوان به رشته SQL، مقدار را با علامت سؤال ارسال کنید تا هم خوانایی بیشتر شود و هم خطر تزریق SQL کاهش پیدا کند.

پیاده‌سازی قابلیت‌های اصلی برنامه

اکنون چهار عملیات اصلی را می‌سازیم: افزودن، نمایش، تکمیل و حذف. هر عملیات باید یک کار مشخص انجام دهد و نتیجه‌ای قابل فهم به کاربر برگرداند.

افزودن وظیفه جدید

عنوان، ورودی اصلی است و اولویت را می‌توان اختیاری در نظر گرفت. مقدار اولویت را بین ۱ تا ۳ محدود کنید؛ عدد ۱ برای کار فوری و عدد ۳ برای کار کم‌اهمیت مناسب است.

def add_task(title, priority=2):
    now = datetime.now().isoformat(timespec="minutes")
    with get_connection() as connection:
        cursor = connection.execute(
            "INSERT INTO tasks (title, priority, created_at) VALUES (?, ?, ?)",
            (title, priority, now)
        )
    return cursor.lastrowid

نمایش فهرست وظایف

در نمایش فهرست، کارهای در حال انجام را بالاتر از کارهای تکمیل‌شده قرار دهید و سپس بر اساس اولویت مرتب کنید. برای جلوگیری از شلوغی، اطلاعاتی مثل زمان ایجاد را فقط زمانی چاپ کنید که واقعاً به آن نیاز است.

def list_tasks(show_done=False):
    query = "SELECT * FROM tasks"
    params = ()
    if not show_done:
        query += " WHERE status = ?"
        params = ("pending",)
    query += " ORDER BY priority ASC, id DESC"
    with get_connection() as connection:
        return connection.execute(query, params).fetchall()

تکمیل و حذف وظیفه

برای تغییر وضعیت یا حذف، ابتدا شناسه را اعتبارسنجی کنید. اگر شناسه وجود نداشته باشد، برنامه نباید با خطای فنی متوقف شود؛ پیام کوتاهی مثل «وظیفه‌ای با این شناسه پیدا نشد» تجربه بهتری ایجاد می‌کند.

def complete_task(task_id):
    with get_connection() as connection:
        result = connection.execute(
            "UPDATE tasks SET status = ? WHERE id = ?",
            ("done", task_id)
        )
    return result.rowcount

def delete_task(task_id):
    with get_connection() as connection:
        result = connection.execute(
            "DELETE FROM tasks WHERE id = ?",
            (task_id,)
        )
    return result.rowcount

ساخت رابط خط فرمان با argparse

ماژول argparse اجازه می‌دهد برنامه را با فرمان‌هایی مانند python app.py add اجرا کنید. برای هر عملیات یک subparser بسازید تا راهنمای استفاده خودکار تولید شود.

import argparse

def build_parser():
    parser = argparse.ArgumentParser(description="مدیریت وظایف شخصی")
    commands = parser.add_subparsers(dest="command", required=True)

    add = commands.add_parser("add", help="افزودن وظیفه")
    add.add_argument("title")
    add.add_argument("--priority", type=int, choices=[1, 2, 3], default=2)

    commands.add_parser("list", help="نمایش وظایف")
    done = commands.add_parser("done", help="تکمیل وظیفه")
    done.add_argument("id", type=int)
    remove = commands.add_parser("delete", help="حذف وظیفه")
    remove.add_argument("id", type=int)
    return parser

در تابع main، ابتدا init_db() را اجرا کنید و بعد بر اساس مقدار args.command تابع درست را فراخوانی کنید. این الگو بعدها برای افزودن فرمان جست‌وجو یا ویرایش وظیفه هم قابل استفاده است.

بهبود تجربه کاربری و جلوگیری از خطا

یک ابزار کوچک زمانی ارزشمند است که استفاده روزمره از آن راحت باشد. چند کنترل ساده، کیفیت برنامه را به شکل محسوسی بهتر می‌کند:

عنوان خالی را نپذیرید و فاصله‌های ابتدا و انتهای آن را حذف کنید.
اگر کاربر عددی به‌جای شناسه وارد کرد، خطای قابل فهم نمایش دهید.
بعد از هر عملیات، نتیجه را با یک پیام کوتاه اعلام کنید.
برای فهرست خالی بنویسید «وظیفه‌ای برای نمایش وجود ندارد».
از چاپ متن‌های بسیار طولانی در جدول خط فرمان جلوگیری کنید.

اگر خروجی جدولی‌تر می‌خواهید، می‌توانید بعداً از کتابخانه‌هایی مانند Rich استفاده کنید. برای ساخت داشبورد تعاملی خط فرمان نیز مطالعه آموزش ساخت داشبورد خط فرمان با Textual ایده‌های خوبی درباره رنگ‌بندی، پنل‌ها و کنترل‌های تعاملی ارائه می‌دهد.

مقایسه گزینه‌های ذخیره‌سازی برای مدیریت وظایف

روش ذخیره‌سازی	مزیت اصلی	محدودیت	مناسب برای
فایل JSON	سادگی و قابل خواندن بودن	جست‌وجو و ویرایش هم‌زمان ضعیف	نمونه اولیه بسیار کوچک
SQLite	پایدار، سبک و بدون سرور	برای چندکاربره سنگین ایده‌آل نیست	ابزار شخصی و دسکتاپ
PostgreSQL	قدرت و امکانات کامل	نیازمند سرویس و پیکربندی	اپلیکیشن چندکاربره

برای همین پروژه، SQLite تعادل مناسبی میان سادگی و قابلیت اطمینان دارد. اگر تصمیم گرفتید نسخه وب بسازید، می‌توانید منطق پایگاه‌داده را نگه دارید و فقط یک API روی آن قرار دهید. برای آشنایی با مسیر طراحی API، راهنمای ساخت API حرفه‌ای با FastAPI نقطه شروع مناسبی است.

قابلیت‌های بعدی که ارزش اضافه‌کردن دارند

پس از اینکه نسخه پایه بدون خطا کار کرد، قابلیت‌ها را یکی‌یکی اضافه کنید. افزودن همه امکانات از ابتدا معمولاً پروژه را پیچیده و نیمه‌کاره می‌کند.

مهلت انجام: ستون due_date برای شناسایی کارهای عقب‌افتاده.
برچسب‌ها: دسته‌بندی کارهای شخصی، کاری یا خرید.
جست‌وجو: استفاده از LIKE برای پیدا کردن عنوان‌های مرتبط.
پشتیبان‌گیری: کپی زمان‌بندی‌شده از فایل SQLite.
آزمون خودکار: تست عملیات افزودن، تکمیل و حذف با pytest.

برای پشتیبان‌گیری، فایل پایگاه‌داده را هنگام بازبودن برنامه به‌صورت دستی کپی نکنید؛ از قابلیت backup خود SQLite یا یک اسکریپت مشخص استفاده کنید تا داده ناقص ذخیره نشود. همچنین ورودی‌های کاربر را همیشه در لایه برنامه بررسی کنید، حتی اگر محدودیت‌هایی در جدول تعریف کرده‌اید.

جمع‌بندی ساخت مدیریت وظایف با پایتون

در این پروژه یک هسته کاربردی برای مدیریت وظایف ساختیم: SQLite داده‌ها را نگه می‌دارد، توابع CRUD عملیات را انجام می‌دهند و argparse یک رابط خط فرمان ساده فراهم می‌کند. مهم‌ترین اصل، شروع با کمترین قابلیت ضروری و جدا نگه‌داشتن لایه ذخیره‌سازی از رابط کاربر است. حالا می‌توانید ابزار را هر روز استفاده کنید و بر اساس نیاز واقعی، امکانات بعدی را اضافه کنید.

سوالات متداول

آیا برای اجرای این پروژه به نصب SQLite نیاز داریم؟

خیر. ماژول sqlite3 معمولاً همراه پایتون ارائه می‌شود و خود برنامه فایل پایگاه‌داده را ایجاد می‌کند. فقط کافی است پایتون نسخه‌ای جدید روی سیستم داشته باشید.

آیا می‌توان اطلاعات را بین چند دستگاه همگام کرد؟

نسخه محلی به‌تنهایی همگام‌سازی نمی‌کند. برای این کار باید یک API یا سرویس ابری بسازید و احراز هویت، تعارض داده و پشتیبان‌گیری را هم در نظر بگیرید.

چطور پروژه را به رابط گرافیکی تبدیل کنیم؟

می‌توانید منطق موجود را حفظ کنید و یک لایه جدید با Tkinter، Textual یا یک فریم‌ورک وب بسازید. بهتر است رابط جدید مستقیماً SQL اجرا نکند و از توابع سرویس فعلی استفاده کند.

آموزش ساخت سیستم مدیریت وظایف با پایتون و SQLite