中級者向け No.05

タスク管理（DB付き）

SQLiteでデータを永続化するタスク管理アプリ。優先度・期限・カテゴリ機能付きの本格的なToDoアプリです。

🎯 難易度: ★★☆ 📦 ライブラリ: tkinter（標準ライブラリ） ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

SQLiteでデータを永続化するタスク管理アプリ。優先度・期限・カテゴリ機能付きの本格的なToDoアプリです。

このアプリは中級カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★★☆ です。

このアプリは「データベース連携」カテゴリです。データベース連携 GUI は永続化と画面更新を結びつける典型例で、トランザクション・スキーマ設計・UI 反映の三点を一度に学べます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

コードを読む前に実行することをおすすめします。動いている挙動を先に把握しておくと、解説で出てくる関数や処理がどこに対応するかが頭に入りやすくなります。

応用のヒントは、機能を 1 つ増やす・見た目を整える・例外を一つでも丁寧に扱う、のいずれかから始めるのがおすすめです。

tkinterでタスク管理を作るのが初めてなら、先にJSONファイルで保存する初心者向けのToDoリストアプリを通しておくと理解が早くなります。このアプリは Treeview の項目IDにデータベースの id をそのまま持たせて元データを特定していますが、「選択されている行から元データを引き当てる」という考え方自体は Listbox でも同じです。そこを先に押さえておくと、ここではSQLiteの処理に集中できます。

タスク管理（DB付き）実行画面（Windows） — 実行画面（Windows）

タスク管理（DB付き）実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「➕ 追加」ボタン（_add_task()）・「✏️ 更新」ボタン（_update_task()）・「🗑️ 削除」ボタン（_delete_task()）・「✅ 完了切替 (ダブルクリック)」ボタン（_toggle_done()）・「📋 クリア」ボタン（_clear_form()）で操作
イベント <<ComboboxSelected>> から _load_tasks() を実行
イベント <<ComboboxSelected>> から _load_tasks() を実行
イベント <<TreeviewSelect>> から _on_select() を実行
マウス操作 <Double-1> から _toggle_done() を実行
ttk.Treeview による表形式の一覧表示
sqlite3.connect() による SQLite データベース接続と SQL 実行
messagebox.askyesno()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「タスク管理（DB付き）」・サイズ 860x580 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

✅ 追加インストール不要（標準ライブラリのみ使用）

app05.py

import tkinter as tk
from tkinter import ttk, messagebox
import sqlite3
import os
from datetime import date, datetime


class App05:
    """タスク管理（DB付き）"""

    DB_PATH = os.path.join(os.path.dirname(__file__), "tasks.db")
    PRIORITIES = ["高", "中", "低"]
    CATEGORIES = ["仕事", "プライベート", "勉強", "買い物", "その他"]
    PRIORITY_COLOR = {"高": "#ffcccc", "中": "#fff3cc", "低": "#ccffcc"}

    def __init__(self, root):
        self.root = root
        self.root.title("タスク管理（DB付き）")
        self.root.geometry("860x580")
        self.root.configure(bg="#f8f9fc")
        self._init_db()
        self._build_ui()
        self._load_tasks()

    def _init_db(self):
        self.conn = sqlite3.connect(self.DB_PATH)
        self.conn.execute("""
            CREATE TABLE IF NOT EXISTS tasks (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                title TEXT NOT NULL,
                category TEXT,
                priority TEXT,
                deadline TEXT,
                done INTEGER DEFAULT 0,
                created_at TEXT
            )
        """)
        self.conn.commit()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=10)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="✅ タスク管理（DB付き）",
                 font=("Noto Sans JP", 15, "bold"),
                 bg="#3776ab", fg="white").pack(side=tk.LEFT, padx=12)

        # フィルターバー
        filter_frame = tk.Frame(self.root, bg="#e8eef5", pady=6)
        filter_frame.pack(fill=tk.X)
        tk.Label(filter_frame, text="表示:", bg="#e8eef5",
                 font=("Noto Sans JP", 10)).pack(side=tk.LEFT, padx=8)
        self.filter_var = tk.StringVar(value="すべて")
        for opt in ["すべて", "未完了", "完了済み"]:
            ttk.Radiobutton(filter_frame, text=opt, variable=self.filter_var,
                            value=opt, command=self._load_tasks).pack(side=tk.LEFT, padx=4)
        tk.Label(filter_frame, text="  カテゴリ:", bg="#e8eef5",
                 font=("Noto Sans JP", 10)).pack(side=tk.LEFT, padx=(12, 4))
        self.cat_filter_var = tk.StringVar(value="すべて")
        cat_cb = ttk.Combobox(filter_frame, textvariable=self.cat_filter_var,
                               values=["すべて"] + self.CATEGORIES,
                               state="readonly", width=10)
        cat_cb.pack(side=tk.LEFT)
        cat_cb.bind("<<ComboboxSelected>>", lambda e: self._load_tasks())
        tk.Label(filter_frame, text="  優先度:", bg="#e8eef5",
                 font=("Noto Sans JP", 10)).pack(side=tk.LEFT, padx=(12, 4))
        self.pri_filter_var = tk.StringVar(value="すべて")
        pri_cb = ttk.Combobox(filter_frame, textvariable=self.pri_filter_var,
                               values=["すべて"] + self.PRIORITIES,
                               state="readonly", width=6)
        pri_cb.pack(side=tk.LEFT)
        pri_cb.bind("<<ComboboxSelected>>", lambda e: self._load_tasks())

        # メインエリア
        main = tk.Frame(self.root, bg="#f8f9fc")
        main.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # タスクリスト
        list_frame = ttk.LabelFrame(main, text="タスク一覧", padding=6)
        list_frame.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        cols = ("done", "title", "category", "priority", "deadline")
        self.tree = ttk.Treeview(list_frame, columns=cols,
                                  show="headings", selectmode="browse")
        for c, h, w in [("done", "状態", 50), ("title", "タイトル", 200),
                         ("category", "カテゴリ", 80), ("priority", "優先度", 60),
                         ("deadline", "期限", 90)]:
            self.tree.heading(c, text=h, command=lambda c=c: self._sort_by(c))
            self.tree.column(c, width=w, minwidth=30)
        sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.bind("<<TreeviewSelect>>", self._on_select)
        self.tree.bind("<Double-1>", self._toggle_done)

        # 入力パネル
        input_frame = ttk.LabelFrame(main, text="タスク入力", padding=10)
        input_frame.pack(side=tk.RIGHT, fill=tk.Y, padx=(8, 0))
        input_frame.configure(width=220)

        labels = ["タイトル", "カテゴリ", "優先度", "期限 (YYYY-MM-DD)"]
        tk.Label(input_frame, text="タイトル:").grid(row=0, column=0, sticky="w", pady=4)
        self.title_var = tk.StringVar()
        ttk.Entry(input_frame, textvariable=self.title_var, width=22).grid(
            row=0, column=1, padx=4, pady=4)

        tk.Label(input_frame, text="カテゴリ:").grid(row=1, column=0, sticky="w", pady=4)
        self.cat_var = tk.StringVar(value=self.CATEGORIES[0])
        ttk.Combobox(input_frame, textvariable=self.cat_var,
                     values=self.CATEGORIES, state="readonly",
                     width=12).grid(row=1, column=1, padx=4, pady=4, sticky="w")

        tk.Label(input_frame, text="優先度:").grid(row=2, column=0, sticky="w", pady=4)
        self.pri_var = tk.StringVar(value="中")
        ttk.Combobox(input_frame, textvariable=self.pri_var,
                     values=self.PRIORITIES, state="readonly",
                     width=6).grid(row=2, column=1, padx=4, pady=4, sticky="w")

        tk.Label(input_frame, text="期限:").grid(row=3, column=0, sticky="w", pady=4)
        self.deadline_var = tk.StringVar(value=str(date.today()))
        ttk.Entry(input_frame, textvariable=self.deadline_var, width=13).grid(
            row=3, column=1, padx=4, pady=4, sticky="w")

        ttk.Button(input_frame, text="➕ 追加",
                   command=self._add_task).grid(row=4, column=0, columnspan=2,
                                                pady=10, sticky="ew")
        ttk.Button(input_frame, text="✏️ 更新",
                   command=self._update_task).grid(row=5, column=0, columnspan=2,
                                                   pady=2, sticky="ew")
        ttk.Button(input_frame, text="🗑️ 削除",
                   command=self._delete_task).grid(row=6, column=0, columnspan=2,
                                                   pady=2, sticky="ew")
        ttk.Button(input_frame, text="✅ 完了切替\n(ダブルクリック)",
                   command=self._toggle_done).grid(row=7, column=0, columnspan=2,
                                                    pady=8, sticky="ew")
        ttk.Button(input_frame, text="📋 クリア",
                   command=self._clear_form).grid(row=8, column=0, columnspan=2,
                                                   pady=2, sticky="ew")

        self.status_var = tk.StringVar(value="")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#dde", font=("Arial", 9), anchor="w", padx=8
                 ).pack(fill=tk.X, side=tk.BOTTOM)
        self._selected_id = None

    def _load_tasks(self):
        self.tree.delete(*self.tree.get_children())
        q = "SELECT id, title, category, priority, deadline, done FROM tasks WHERE 1=1"
        params = []
        f = self.filter_var.get()
        if f == "未完了":
            q += " AND done=0"
        elif f == "完了済み":
            q += " AND done=1"
        cat = self.cat_filter_var.get()
        if cat != "すべて":
            q += " AND category=?"
            params.append(cat)
        pri = self.pri_filter_var.get()
        if pri != "すべて":
            q += " AND priority=?"
            params.append(pri)
        q += " ORDER BY done, CASE priority WHEN '高' THEN 1 WHEN '中' THEN 2 ELSE 3 END, deadline"
        rows = self.conn.execute(q, params).fetchall()
        for row in rows:
            rid, title, cat_, pri_, dl, done = row
            status = "✅" if done else "⬜"
            tag = "done" if done else pri_ or ""
            iid = self.tree.insert("", "end", iid=str(rid),
                                   values=(status, title, cat_, pri_, dl or ""),
                                   tags=(tag,))
        self.tree.tag_configure("done", foreground="#aaa")
        self.tree.tag_configure("高", background="#ffcccc")
        self.tree.tag_configure("中", background="#fff3cc")
        self.status_var.set(f"{len(rows)} 件表示")

    def _on_select(self, event):
        sel = self.tree.selection()
        if not sel:
            return
        rid = int(sel[0])
        self._selected_id = rid
        row = self.conn.execute(
            "SELECT title,category,priority,deadline FROM tasks WHERE id=?",
            (rid,)).fetchone()
        if row:
            self.title_var.set(row[0])
            self.cat_var.set(row[1] or self.CATEGORIES[0])
            self.pri_var.set(row[2] or "中")
            self.deadline_var.set(row[3] or "")

    def _add_task(self):
        title = self.title_var.get().strip()
        if not title:
            messagebox.showwarning("警告", "タイトルを入力してください")
            return
        now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
        self.conn.execute(
            "INSERT INTO tasks (title,category,priority,deadline,done,created_at) "
            "VALUES (?,?,?,?,0,?)",
            (title, self.cat_var.get(), self.pri_var.get(),
             self.deadline_var.get() or None, now))
        self.conn.commit()
        self._load_tasks()
        self._clear_form()

    def _update_task(self):
        if not self._selected_id:
            messagebox.showwarning("警告", "タスクを選択してください")
            return
        title = self.title_var.get().strip()
        if not title:
            return
        self.conn.execute(
            "UPDATE tasks SET title=?,category=?,priority=?,deadline=? WHERE id=?",
            (title, self.cat_var.get(), self.pri_var.get(),
             self.deadline_var.get() or None, self._selected_id))
        self.conn.commit()
        self._load_tasks()

    def _delete_task(self):
        if not self._selected_id:
            messagebox.showwarning("警告", "タスクを選択してください")
            return
        if messagebox.askyesno("確認", "このタスクを削除しますか?"):
            self.conn.execute("DELETE FROM tasks WHERE id=?", (self._selected_id,))
            self.conn.commit()
            self._selected_id = None
            self._load_tasks()
            self._clear_form()

    def _toggle_done(self, event=None):
        if event:
            item = self.tree.identify_row(event.y)
            if item:
                self.tree.selection_set(item)
        if not self._selected_id:
            return
        self.conn.execute(
            "UPDATE tasks SET done = 1 - done WHERE id=?", (self._selected_id,))
        self.conn.commit()
        self._load_tasks()

    def _clear_form(self):
        self.title_var.set("")
        self.cat_var.set(self.CATEGORIES[0])
        self.pri_var.set("中")
        self.deadline_var.set(str(date.today()))
        self._selected_id = None


if __name__ == "__main__":
    root = tk.Tk()
    app = App05(root)
    root.mainloop()

5. コード解説

タスク管理（DB付き）のコードを、実際に書かれている実装に沿って解説します。

クラス設計とコンストラクタ

App05 クラスにアプリの全機能をまとめています（メソッド10個・全254行）。__init__ ではタイトル「タスク管理（DB付き）」とウィンドウサイズ 860x580 を設定します。そのあと _init_db() → _build_ui() → _load_tasks() の順に呼び出して初期状態を作ります。