中級者向け No.24

時間追跡アプリ

プロジェクト・タスクごとに作業時間を記録するタイムトラッカー。SQLiteで履歴を管理し週次レポートを生成します。

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

📋 目次

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

1. アプリ概要

プロジェクト・タスクごとに作業時間を記録するタイムトラッカー。SQLiteで履歴を管理し週次レポートを生成します。

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

このアプリは「ユーティリティ」カテゴリです。小回りの効くユーティリティは Python の真骨頂で、汎用的なユーザー操作を組み合わせる発想が他のアプリにもそのまま流用できます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。

カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。

時間追跡アプリ実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「▶ 開始」ボタン（_toggle_timer()）・「⏹ リセット」ボタン（_reset_timer()）・「💾 保存」ボタン（_save_log()）・「🗑️ 削除」ボタン（_delete_log()）・「🔄 レポート更新」ボタン（_update_report()）で操作
イベント <<ComboboxSelected>> から _load_logs() を実行
after(1000, ...) による1000ミリ秒間隔の _tick() 呼び出し（画面の自動更新）
ttk.Treeview による表形式の一覧表示
sqlite3.connect() による SQLite データベース接続と SQL 実行
messagebox.askyesno()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「時間追跡アプリ」・サイズ 860x735 で起動

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. 完全なソースコード

💡

コードのコピー方法

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

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

app24.py

import tkinter as tk
from tkinter import ttk, messagebox
import sqlite3
import os
import time
import threading
from datetime import datetime, timedelta


class App24:
    """時間追跡アプリ"""

    DB_PATH = os.path.join(os.path.dirname(__file__), "timelog.db")

    def __init__(self, root):
        self.root = root
        self.root.title("時間追跡アプリ")
        self.root.geometry("860x735")
        self.root.minsize(860, 735)
        self.root.configure(bg="#f8f9fc")
        self.running = False
        self.start_time = None
        self.elapsed = 0
        self._timer_id = None
        self._init_db()
        self._build_ui()
        self._load_projects()
        self._load_logs()
        self.root.protocol("WM_DELETE_WINDOW", self._on_close)

    def _init_db(self):
        self.conn = sqlite3.connect(self.DB_PATH)
        self.conn.execute("""
            CREATE TABLE IF NOT EXISTS projects (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                name TEXT UNIQUE NOT NULL,
                color TEXT DEFAULT '#3776ab'
            )
        """)
        self.conn.execute("""
            CREATE TABLE IF NOT EXISTS time_logs (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                project_id INTEGER,
                task TEXT,
                start_time TEXT,
                end_time TEXT,
                duration INTEGER,
                notes TEXT,
                FOREIGN KEY(project_id) REFERENCES projects(id)
            )
        """)
        self.conn.commit()
        if not self.conn.execute("SELECT 1 FROM projects").fetchone():
            for name in ["開発", "デザイン", "会議", "学習", "その他"]:
                self.conn.execute("INSERT INTO projects (name) VALUES (?)", (name,))
            self.conn.commit()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#0f3460", pady=10)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="⏱️ 時間追跡アプリ",
                 font=("Noto Sans JP", 15, "bold"),
                 bg="#0f3460", fg="white").pack(side=tk.LEFT, padx=12)

        # タイマーパネル
        timer_f = tk.Frame(self.root, bg="#16213e", pady=16)
        timer_f.pack(fill=tk.X, padx=8, pady=8)

        self.timer_label = tk.Label(timer_f, text="00:00:00",
                                    font=("Courier New", 36, "bold"),
                                    bg="#16213e", fg="#e2b96f")
        self.timer_label.pack()

        ctrl_f = tk.Frame(timer_f, bg="#16213e")
        ctrl_f.pack(pady=8)
        btn_style = {"bg": "#0f3460", "fg": "#e2b96f", "relief": tk.FLAT,
                     "font": ("Arial", 12), "padx": 16, "pady": 6,
                     "activebackground": "#1a2a5e"}
        self.start_btn = tk.Button(ctrl_f, text="▶ 開始",
                                   command=self._toggle_timer, **btn_style)
        self.start_btn.pack(side=tk.LEFT, padx=6)
        tk.Button(ctrl_f, text="⏹ リセット",
                  command=self._reset_timer, **btn_style).pack(side=tk.LEFT, padx=6)
        tk.Button(ctrl_f, text="💾 保存",
                  command=self._save_log, **btn_style).pack(side=tk.LEFT, padx=6)

        # プロジェクト・タスク選択
        sel_f = tk.Frame(timer_f, bg="#16213e")
        sel_f.pack(pady=4)
        tk.Label(sel_f, text="プロジェクト:",
                 bg="#16213e", fg="#ccc").pack(side=tk.LEFT, padx=4)
        self.proj_var = tk.StringVar()
        self.proj_cb = ttk.Combobox(sel_f, textvariable=self.proj_var,
                                     state="readonly", width=14)
        self.proj_cb.pack(side=tk.LEFT, padx=4)
        tk.Label(sel_f, text="タスク:",
                 bg="#16213e", fg="#ccc").pack(side=tk.LEFT, padx=(12, 4))
        self.task_var = tk.StringVar()
        ttk.Entry(sel_f, textvariable=self.task_var, width=20).pack(side=tk.LEFT, padx=4)
        tk.Label(sel_f, text="メモ:",
                 bg="#16213e", fg="#ccc").pack(side=tk.LEFT, padx=(12, 4))
        self.notes_var = tk.StringVar()
        ttk.Entry(sel_f, textvariable=self.notes_var, width=20).pack(side=tk.LEFT)

        # メインエリア
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 左: ログ一覧
        left = ttk.LabelFrame(paned, text="作業ログ", padding=4)
        # フィルター
        filter_f = tk.Frame(left, bg=ttk.Style().lookup("TLabelframe", "background"))
        filter_f.pack(fill=tk.X, pady=2)
        tk.Label(filter_f, text="プロジェクト:").pack(side=tk.LEFT)
        self.log_proj_var = tk.StringVar(value="すべて")
        self.log_proj_cb = ttk.Combobox(filter_f, textvariable=self.log_proj_var,
                                         state="readonly", width=12)
        self.log_proj_cb.pack(side=tk.LEFT, padx=4)
        self.log_proj_cb.bind("<<ComboboxSelected>>", lambda e: self._load_logs())

        cols = ("date", "project", "task", "duration", "notes")
        self.log_tree = ttk.Treeview(left, columns=cols, show="headings", height=14)
        for c, h, w in [("date", "日時", 130), ("project", "プロジェクト", 80),
                         ("task", "タスク", 140), ("duration", "時間", 70),
                         ("notes", "メモ", 120)]:
            self.log_tree.heading(c, text=h)
            self.log_tree.column(c, width=w, minwidth=40)
        sb = ttk.Scrollbar(left, command=self.log_tree.yview)
        self.log_tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.log_tree.pack(fill=tk.BOTH, expand=True)
        ttk.Button(left, text="🗑️ 削除",
                   command=self._delete_log).pack(anchor="w", pady=2)
        paned.add(left, weight=3)

        # 右: 週次レポート
        right = ttk.LabelFrame(paned, text="週次レポート", padding=8)
        self.report_text = tk.Text(right, font=("Courier New", 10),
                                   bg="#1e1e1e", fg="#c9d1d9",
                                   relief=tk.FLAT, state=tk.DISABLED)
        self.report_text.pack(fill=tk.BOTH, expand=True)
        ttk.Button(right, text="🔄 レポート更新",
                   command=self._update_report).pack(pady=4)
        paned.add(right, weight=2)

        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)

    def _load_projects(self):
        rows = self.conn.execute(
            "SELECT name FROM projects ORDER BY name").fetchall()
        names = [r[0] for r in rows]
        self.proj_cb.configure(values=names)
        self.log_proj_cb.configure(values=["すべて"] + names)
        if names:
            self.proj_var.set(names[0])

    def _toggle_timer(self):
        if self.running:
            self.running = False
            self.elapsed += time.time() - self.start_time
            self.start_btn.config(text="▶ 開始", bg="#0f3460")
            if self._timer_id:
                self.root.after_cancel(self._timer_id)
        else:
            self.running = True
            self.start_time = time.time()
            self.start_btn.config(text="⏸ 一時停止", bg="#c62828")
            self._tick()

    def _tick(self):
        if self.running:
            total = self.elapsed + (time.time() - self.start_time)
            h = int(total // 3600)
            m = int((total % 3600) // 60)
            s = int(total % 60)
            self.timer_label.config(text=f"{h:02d}:{m:02d}:{s:02d}")
            self._timer_id = self.root.after(1000, self._tick)

    def _reset_timer(self):
        if self.running:
            self._toggle_timer()
        self.elapsed = 0
        self.start_time = None
        self.timer_label.config(text="00:00:00")

    def _save_log(self):
        if self.elapsed < 1:
            messagebox.showwarning("警告", "タイマーを使用してください")
            return
        proj_name = self.proj_var.get()
        if not proj_name:
            messagebox.showwarning("警告", "プロジェクトを選択してください")
            return
        row = self.conn.execute(
            "SELECT id FROM projects WHERE name=?", (proj_name,)).fetchone()
        if not row:
            return
        proj_id = row[0]
        duration = int(self.elapsed)
        now = datetime.now()
        start_dt = now - timedelta(seconds=duration)
        self.conn.execute(
            "INSERT INTO time_logs (project_id,task,start_time,end_time,"
            "duration,notes) VALUES (?,?,?,?,?,?)",
            (proj_id, self.task_var.get(),
             start_dt.isoformat(), now.isoformat(),
             duration, self.notes_var.get()))
        self.conn.commit()
        self._reset_timer()
        self._load_logs()
        self.status_var.set(
            f"保存: {proj_name} - {self._fmt_dur(duration)}")

    def _fmt_dur(self, seconds):
        h = seconds // 3600
        m = (seconds % 3600) // 60
        s = seconds % 60
        return f"{h:02d}:{m:02d}:{s:02d}"

    def _load_logs(self):
        proj_f = self.log_proj_var.get()
        sql = ("SELECT l.id, l.start_time, p.name, l.task, l.duration, l.notes "
               "FROM time_logs l "
               "JOIN projects p ON l.project_id=p.id WHERE 1=1")
        params = []
        if proj_f != "すべて":
            sql += " AND p.name=?"
            params.append(proj_f)
        sql += " ORDER BY l.start_time DESC LIMIT 100"
        rows = self.conn.execute(sql, params).fetchall()
        self.log_tree.delete(*self.log_tree.get_children())
        for row in rows:
            lid, start, proj, task, dur, notes = row
            self.log_tree.insert("", "end", iid=str(lid),
                                 values=(start[:16], proj, task or "",
                                         self._fmt_dur(dur), notes or ""))
        self._update_report()

    def _delete_log(self):
        sel = self.log_tree.selection()
        if sel:
            if messagebox.askyesno("確認", "削除しますか?"):
                for item in sel:
                    self.conn.execute("DELETE FROM time_logs WHERE id=?",
                                      (int(item),))
                self.conn.commit()
                self._load_logs()

    def _update_report(self):
        today = datetime.now().date()
        week_start = today - timedelta(days=today.weekday())
        rows = self.conn.execute(
            "SELECT p.name, SUM(l.duration) FROM time_logs l "
            "JOIN projects p ON l.project_id=p.id "
            "WHERE l.start_time >= ? GROUP BY p.name ORDER BY SUM(l.duration) DESC",
            (str(week_start),)).fetchall()
        total = sum(r[1] for r in rows)
        text = f"【週次レポート】{week_start} 〜 {today}\n"
        text += f"{'='*36}\n"
        for name, dur in rows:
            pct = dur / total * 100 if total else 0
            bar = "█" * int(pct / 5)
            text += f"{name:<12} {self._fmt_dur(dur):>10}  {pct:5.1f}%  {bar}\n"
        text += f"{'='*36}\n"
        text += f"合計: {self._fmt_dur(total)}\n"
        # 日別
        text += "\n【日別ログ】\n"
        daily = {}
        for i in range(7):
            d = str(week_start + timedelta(days=i))
            r = self.conn.execute(
                "SELECT COALESCE(SUM(duration),0) FROM time_logs "
                "WHERE DATE(start_time)=?", (d,)).fetchone()
            daily[d] = r[0]
            text += f"  {d}: {self._fmt_dur(r[0])}\n"

        self.report_text.config(state=tk.NORMAL)
        self.report_text.delete("1.0", tk.END)
        self.report_text.insert("1.0", text)
        self.report_text.config(state=tk.DISABLED)

    def _on_close(self):
        if self.running:
            self._toggle_timer()
        self.root.destroy()


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

5. コード解説

時間追跡アプリのコードを、実際に書かれている実装に沿って解説します。

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

App24 クラスにアプリの全機能をまとめています（メソッド13個・全294行）。__init__ ではタイトル「時間追跡アプリ」とウィンドウサイズ 860x735 を設定します。あわせて状態を保持する変数（self.running・self.start_time・self.elapsed・self._timer_id）を初期化し、そのあと _init_db() → _build_ui() → _load_projects() → _load_logs() の順に呼び出して初期状態を作ります。