初心者向け No.096

ペット健康ノート

ペットの体重・食事・投薬・通院を日付別に記録するノートアプリ。グラフ表示と健康アラート付き。

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

📋 目次

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

1. アプリ概要

ペットの体重・食事・投薬・通院を日付別に記録するノートアプリ。グラフ表示と健康アラート付き。

このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。

このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

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

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

ペット健康ノート実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「追加」ボタン（add_record()）・「選択削除」ボタン（delete_selected()）・「保存」ボタン（_save()）・「エクスポート」ボタン（export_json()）で操作
ttk.Treeview による表形式の一覧表示
JSON ファイルの保存（「保存」ボタン）・読み込み（起動時に自動実行）
filedialog.asksaveasfilename() によるファイル選択ダイアログ
messagebox.showerror()・messagebox.showinfo()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「ペット健康ノート」・サイズ 780x644 で起動

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

💡

コードのコピー方法

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

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

app096.py

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import json
import os
from datetime import datetime, date


class App096:
    """ペット健康ノート"""

    SAVE_FILE = "pet_health.json"
    KINDS = ("体重", "食事", "投薬", "通院")

    def __init__(self, root):
        self.root = root
        self.root.title("ペット健康ノート")
        self.root.geometry("780x644")
        self.root.minsize(780, 644)
        self.root.configure(bg="#f8f9fc")
        self.records = []  # [{date, kind, value, note}]
        self._build_ui()
        self._load()
        self._refresh()

    def _build_ui(self):
        """UIを構築する"""
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(
            title_frame, text="ペット健康ノート",
            font=("Noto Sans JP", 16, "bold"),
            bg="#3776ab", fg="white"
        ).pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=14, pady=14)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="記録の追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))

        tk.Label(input_frame, text="日付(YYYY-MM-DD):").grid(row=0, column=0, sticky="w")
        self.date_entry = ttk.Entry(input_frame, width=12)
        self.date_entry.insert(0, date.today().isoformat())
        self.date_entry.grid(row=0, column=1, padx=4)

        tk.Label(input_frame, text="種別:").grid(row=0, column=2, sticky="w")
        self.kind_var = tk.StringVar(value=self.KINDS[0])
        ttk.Combobox(
            input_frame, textvariable=self.kind_var,
            values=self.KINDS, width=8, state="readonly"
        ).grid(row=0, column=3, padx=4)

        tk.Label(input_frame, text="値:").grid(row=0, column=4, sticky="w")
        self.value_entry = ttk.Entry(input_frame, width=10)
        self.value_entry.grid(row=0, column=5, padx=4)

        tk.Label(input_frame, text="メモ:").grid(row=1, column=0, sticky="w", pady=(6, 0))
        self.note_entry = ttk.Entry(input_frame)
        self.note_entry.grid(row=1, column=1, columnspan=4, sticky="ew", padx=4, pady=(6, 0))
        input_frame.columnconfigure(3, weight=1)

        ttk.Button(input_frame, text="追加", command=self.add_record).grid(row=1, column=5, padx=4, pady=(6, 0))

        # 一覧
        list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=6)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 8))
        cols = ("date", "kind", "value", "note")
        self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=10)
        for c, w in zip(cols, (110, 80, 100, 380)):
            self.tree.heading(c, text={"date": "日付", "kind": "種別", "value": "値", "note": "メモ"}[c])
            self.tree.column(c, width=w, anchor="w")
        self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)

        # グラフ＆操作
        bottom = tk.Frame(main_frame, bg="#f8f9fc")
        bottom.pack(fill=tk.BOTH, expand=False)
        graph_frame = ttk.LabelFrame(bottom, text="体重推移グラフ", padding=6)
        graph_frame.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        self.canvas = tk.Canvas(graph_frame, height=130, bg="white", highlightthickness=1)
        self.canvas.pack(fill=tk.BOTH, expand=True)

        op_frame = tk.Frame(bottom, bg="#f8f9fc")
        op_frame.pack(side=tk.RIGHT, padx=(8, 0))
        ttk.Button(op_frame, text="選択削除", command=self.delete_selected).pack(fill=tk.X, pady=2)
        ttk.Button(op_frame, text="保存", command=self._save).pack(fill=tk.X, pady=2)
        ttk.Button(op_frame, text="エクスポート", command=self.export_json).pack(fill=tk.X, pady=2)

        # アラート表示
        self.alert_label = tk.Label(main_frame, text="", bg="#f8f9fc", fg="#dc3545", anchor="w")
        self.alert_label.pack(fill=tk.X, pady=(6, 0))

    def add_record(self):
        """記録を追加する"""
        d = self.date_entry.get().strip()
        kind = self.kind_var.get()
        val = self.value_entry.get().strip()
        note = self.note_entry.get().strip()
        try:
            datetime.strptime(d, "%Y-%m-%d")
        except ValueError:
            messagebox.showerror("エラー", "日付は YYYY-MM-DD 形式で入力してください")
            return
        if not val:
            messagebox.showwarning("警告", "値を入力してください")
            return
        self.records.append({"date": d, "kind": kind, "value": val, "note": note})
        self.value_entry.delete(0, tk.END)
        self.note_entry.delete(0, tk.END)
        self._save()
        self._refresh()

    def delete_selected(self):
        """選択行を削除"""
        sel = self.tree.selection()
        if not sel:
            return
        idx = int(self.tree.item(sel[0], "tags")[0])
        del self.records[idx]
        self._save()
        self._refresh()

    def _refresh(self):
        """一覧とグラフを再描画"""
        for i in self.tree.get_children():
            self.tree.delete(i)
        sorted_recs = sorted(enumerate(self.records), key=lambda x: x[1]["date"])
        for orig_i, r in sorted_recs:
            self.tree.insert("", tk.END, values=(r["date"], r["kind"], r["value"], r["note"]), tags=(str(orig_i),))
        self._draw_graph()
        self._check_alerts()

    def _draw_graph(self):
        """体重データを折れ線グラフで描画"""
        self.canvas.delete("all")
        weights = []
        for r in sorted(self.records, key=lambda x: x["date"]):
            if r["kind"] == "体重":
                try:
                    weights.append((r["date"], float(r["value"])))
                except ValueError:
                    continue
        self.canvas.update_idletasks()
        w = self.canvas.winfo_width() or 500
        h = self.canvas.winfo_height() or 130
        if len(weights) < 2:
            self.canvas.create_text(w / 2, h / 2, text="体重データが2件以上で表示されます", fill="#999")
            return
        ys = [v for _, v in weights]
        ymin, ymax = min(ys), max(ys)
        if ymin == ymax:
            ymin -= 1
            ymax += 1
        pad = 20
        n = len(weights)
        pts = []
        for i, (_, v) in enumerate(weights):
            x = pad + (w - 2 * pad) * i / max(1, n - 1)
            y = h - pad - (h - 2 * pad) * (v - ymin) / (ymax - ymin)
            pts.extend([x, y])
        self.canvas.create_line(*pts, fill="#3776ab", width=2)
        for i in range(0, len(pts), 2):
            self.canvas.create_oval(pts[i] - 3, pts[i + 1] - 3, pts[i] + 3, pts[i + 1] + 3, fill="#3776ab")
        self.canvas.create_text(pad, pad - 8, anchor="w", text=f"最高 {ymax}kg / 最低 {ymin}kg", fill="#333")

    def _check_alerts(self):
        """健康アラートを判定して表示"""
        weights = sorted(
            [r for r in self.records if r["kind"] == "体重"],
            key=lambda x: x["date"]
        )
        msg = ""
        if len(weights) >= 2:
            try:
                first = float(weights[0]["value"])
                last = float(weights[-1]["value"])
                if first > 0:
                    rate = (last - first) / first * 100
                    if abs(rate) >= 10:
                        msg = f"⚠ 体重が {rate:+.1f}% 変化しています。獣医師に相談を検討してください。"
            except ValueError:
                pass
        self.alert_label.config(text=msg)

    def _load(self):
        """保存ファイルを読み込む"""
        if os.path.exists(self.SAVE_FILE):
            try:
                with open(self.SAVE_FILE, "r", encoding="utf-8") as f:
                    self.records = json.load(f)
            except Exception:
                self.records = []

    def _save(self):
        """保存ファイルに書き出す"""
        try:
            with open(self.SAVE_FILE, "w", encoding="utf-8") as f:
                json.dump(self.records, f, ensure_ascii=False, indent=2)
        except Exception as e:
            messagebox.showerror("エラー", f"保存に失敗: {e}")

    def export_json(self):
        """ファイルダイアログでエクスポート"""
        path = filedialog.asksaveasfilename(defaultextension=".json", filetypes=[("JSON", "*.json")])
        if not path:
            return
        try:
            with open(path, "w", encoding="utf-8") as f:
                json.dump(self.records, f, ensure_ascii=False, indent=2)
            messagebox.showinfo("完了", f"{path} に保存しました")
        except Exception as e:
            messagebox.showerror("エラー", f"書き出しに失敗: {e}")


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

5. コード解説

ペット健康ノートのコードを、実際に書かれている実装に沿って解説します。

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

App096 クラスにアプリの全機能をまとめています（メソッド10個・全221行）。__init__ ではタイトル「ペット健康ノート」とウィンドウサイズ 780x644 を設定します。そのあと _build_ui() → _load() → _refresh() の順に呼び出して初期状態を作ります。