MENU

問い合わせ

    お問い合わせ


    【CAD図面PDFをExcelへ自動転記するツール開発 第0回】要件整理とPython開発環境、tkinterの最初の画面を作る

    (2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)

    建築・不動産・設計事務所の担当者から「CAD図面PDFに書かれた部屋名を、決まったExcelの様式へ一つひとつ手で転記している」という相談を受けることがあります。図面を目で確認しながら、寝室・洋室・トイレ・浴室といった部屋名をExcelの決まったセルへ入力していく作業は、単純なようでいて時間がかかり、見落としや入力ミスも起きやすい定型業務です。

    この連載では、この転記作業を自動化するWindows向けデスクトップツールを、Pythonだけで一から組み上げていきます。図面PDFに埋め込まれた文字を読み取り、読み取れない場合はローカルOCR、精度を上げたい場合は外部の生成AIも使い分けながら、最終的に指定のExcel様式へ書き込むところまでを、1回1機能の小さな単位で実装します。

    第0回の今回は、コードはまだ「部屋名を読み取る」ところまで進みません。要件の整理、Python環境の構築、tkinterによる最初のウィンドウ、そしてPDF・Excelファイルを選ぶダイアログの土台を作ります。地味な回に見えますが、この連載で一番大事な判断がここに詰まっています。

    目次

    この連載で最終的にできること

    先に、連載全体のゴールを共有しておきます。

    • CAD図面PDF(1〜複数ページ)を選択し、画面でプレビューできる
    • 図面に埋め込まれた文字(CADソフト由来のPDFはテキストとして抽出できることが多い)から部屋名候補を検出する
    • 文字が埋め込まれていない(スキャンされた)図面には、ローカルOCR(Tesseract)で対応する
    • 精度を上げたい場合は、外部の生成AI(画像を理解できるマルチモーダルAI)に図面画像を渡し、部屋名だけを抽出できる
    • 検出結果は必ず画面上で人が確認・修正してからExcelへ書き込む
    • 部屋名とExcelのセルの対応は、コードを直さずに設定ファイルで変更できる
    • フォルダ単位で複数のPDF・複数物件をまとめて処理できる
    • Pythonを入れていない担当者にも配布できるよう、単一のWindows実行ファイル(.exe)にまとめる

    毎回「動くコード」と「動作確認方法」を必ず載せ、前回までのコードに機能を積み上げていく方針です。なお開発・検証はLinux環境で行うため、画面の見た目や操作感、exeの起動そのものはWindows実機での確認が必要になります。どこまでをこのリポジトリの環境(Linux)で確認できて、どこからがWindows実機での確認が必要かを、各回の「動作確認の方法」で区別して書きます。

    第0回の仕組み:なぜtkinterで、なぜGUIとコア処理を分けるのか

    GUIライブラリにtkinterを選ぶ理由

    Pythonには他にもGUIライブラリがありますが、今回は追加インストールが不要な標準ライブラリのtkinterを使います。理由は配布のしやすさです。最終的にはPyInstallerで単一の.exeにまとめて配布する予定のため、GUIライブラリ自体が追加のインストール作業を発注者側に求めない、という条件を優先しました。

    GUI(画面)とコア処理を分ける設計

    もう一つの重要な判断が、画面を扱うコード(app/ui/)と、画面に依存しないロジック(app/core/)を分けることです。

    区分役割tkinterへの依存
    app/ui/画面の表示、ボタン・ダイアログの配置あり
    app/core/ファイルパスの検証、後の回で追加するPDF解析・OCR・Excel書き込みなどなし

    app/core/ をtkinterに依存させない理由は単純で、Linux上のこの開発環境ではtkinterの画面を目視確認できないためです。画面に依存しないロジックだけでも自動テスト(pytest)で検証できるようにしておけば、「動くはずのコードが実は壊れていた」という事態を減らせます。この分離は連載を通して守るルールにします。

    第0回で実装する範囲

    今回作るのは、次の3点だけです。

    1. tkinterのウィンドウを開くエントリーポイント
    2. PDF・Excelテンプレートを選ぶファイル選択ダイアログと、選んだパスを保持するメイン画面
    3. 選んだファイルが「PDFらしいか」「Excelらしいか」を検証するコア処理(拡張子・存在確認のみ)

    図面の中身を読む処理(画像化・文字抽出・OCR)は次回以降です。今回のファイル検証は「拡張子が.pdfか」「ファイルが実在するか」程度にとどめ、PDFとして壊れていないかまでは踏み込みません(それは第1回、PyMuPDFで実際に開く処理と合わせて確認します)。

    実装

    開発環境の準備(空のフォルダから始める)

    ここからは、空のフォルダから記事のとおりに作っていく手順です。コマンドはWindowsのコマンドプロンプトを前提にし、Linux・macOSで違うところはコメントで添えます。

    1. Python 3.13 を入れる:Windowsでは、Python公式サイト(python.org)のWindows用インストーラーで Python 3.13 系を入れます。インストーラーの既定のままで、tkinter(「tcl/tk and IDLE」)と、バージョンを指定して起動できる py コマンドも入ります。Ubuntuなどでは、Python本体とは別にtkinterのパッケージ(例:sudo apt-get install python3-tk)が必要なことがあります。

    2. プロジェクトのフォルダと仮想環境を作る:この連載ではフォルダ名を madori-ocr にします。以降のコマンドは、すべてこのフォルダ(プロジェクトのルート)で実行します。

    mkdir madori-ocr
    cd madori-ocr
    py -3.13 -m venv .venv
    .venv\Scripts\activate
    REM Linux・macOS の場合:python3.13 -m venv .venv
    REM                      source .venv/bin/activate
    mkdir app\core app\ui tests
    REM Linux・macOS の場合:mkdir -p app/core app/ui tests

    3. 依存パッケージを書いて入れる:第0回で入れるのは、テスト(pytest)とコードの点検(ruff)の2つだけです。画面に使うtkinterはPythonに同梱されているので、インストールは要りません。プロジェクトのルートに requirements.txt を作ります。

    requirements.txt を新しく作ります(全文)。

    # requirements.txt
    # 間取りOCR転記ツール(madori-ocr連載)の依存パッケージ。
    # バージョンは、各回の記事の公開日の時点でPyPIに存在するものに固定している
    # (`pip index versions <pkg>` で確認済み)。
    
    pytest==9.0.2
    ruff==0.14.11
    pip install -r requirements.txt

    第1回からは、回ごとに使うパッケージをこのファイルに1行ずつ足していきます。

    プロジェクトの構成(第0回時点)

    madori-ocr/
    ├ app/
    │  ├ __init__.py
    │  ├ main.py             … エントリーポイント
    │  ├ core/
    │  │  ├ __init__.py
    │  │  └ file_selection.py … 選択ファイルの検証(tkinter非依存)
    │  └ ui/
    │     ├ __init__.py
    │     └ main_window.py    … メイン画面
    ├ tests/
    │  └ test_file_selection.py
    ├ requirements.txt
    ├ pytest.ini
    └ .gitignore

    app・app/core・app/ui の3つのフォルダには、Pythonのパッケージ(import app.core.file_selection のように読み込めるフォルダ)にするための __init__.py を置きます。中身は説明の1行(docstring)だけです。

    app/__init__.py を新しく作ります(全文)。

    # app/__init__.py
    """間取りOCR転記ツールのアプリケーションパッケージ。"""

    app/core/__init__.py を新しく作ります(全文)。

    # app/core/__init__.py
    """GUI(tkinter)に依存しないコア処理をまとめるパッケージ。
    
    ここに置くモジュールは tkinter を import しない。pytest で単体テストできる
    状態を保つための取り決め(連載の横断ルール §6 コード規約)。
    """

    app/ui/__init__.py を新しく作ります(全文)。

    # app/ui/__init__.py
    """tkinter を使った画面(GUI)をまとめるパッケージ。"""

    コア処理:選択ファイルの検証(app/core/file_selection.py)

    拡張子と存在確認だけを行う、tkinterに依存しない小さなモジュールです。SelectedFiles は「PDFパスとExcelパスの両方が揃ったか」を判定するためだけの入れ物にしています。

    app/core/file_selection.py を新しく作ります(全文)。

    app/core/file_selection.py の全文(81行)
    # app/core/file_selection.py
    """PDF図面・Excelテンプレートの選択ファイルを検証するロジック。
    
    tkinter のファイル選択ダイアログ自体はユーザーが不正なパスを渡せないが、
    「拡張子が違うファイルをドラッグ&ドロップで指定した」「一覧に出ていた
    ファイルが選択後に削除された」といったケースに備え、GUIとは独立して
    検証できるようにしておく(pytestで自動テストするため)。
    """
    
    from __future__ import annotations
    
    from dataclasses import dataclass
    from pathlib import Path
    
    #: 図面PDFとして受け付ける拡張子(小文字で比較する)
    PDF_SUFFIXES = frozenset({".pdf"})
    
    #: Excelテンプレートとして受け付ける拡張子(小文字で比較する)
    EXCEL_SUFFIXES = frozenset({".xlsx", ".xlsm"})
    
    
    class FileSelectionError(ValueError):
        """選択されたファイルが要件を満たさない場合に送出する例外。"""
    
    
    @dataclass(frozen=True)
    class SelectedFiles:
        """メイン画面で選択中のPDF図面・Excelテンプレートのパスを保持する。
    
        このクラス自体はファイルの中身を読まない(読み込み・書き込みは次回
        以降の回で `app/core/pdf_loader.py` 等に実装する)。
        """
    
        pdf_path: Path | None = None
        excel_path: Path | None = None
    
        def is_ready(self) -> bool:
            """実行ボタンを有効化してよい状態かどうかを返す。"""
            return self.pdf_path is not None and self.excel_path is not None
    
        def with_pdf(self, pdf_path: Path) -> SelectedFiles:
            """PDFパスだけを差し替えた新しい `SelectedFiles` を返す。"""
            return SelectedFiles(pdf_path=pdf_path, excel_path=self.excel_path)
    
        def with_excel(self, excel_path: Path) -> SelectedFiles:
            """Excelテンプレートパスだけを差し替えた新しい `SelectedFiles` を返す。"""
            return SelectedFiles(pdf_path=self.pdf_path, excel_path=excel_path)
    
    
    def validate_pdf_path(path: str | Path) -> Path:
        """CAD図面PDFとして受け付けられるパスかを検証し、`Path` を返す。
    
        存在確認・ファイル種別・拡張子(`.pdf`)のみを見る。PDFとして実際に
        開けるか(壊れていないか)の検証は、PyMuPDFで読み込む第1回以降で行う。
        """
        resolved = Path(path)
        if not resolved.exists():
            raise FileSelectionError(f"ファイルが見つかりません: {resolved}")
        if not resolved.is_file():
            raise FileSelectionError(f"フォルダではなくファイルを選択してください: {resolved}")
        if resolved.suffix.lower() not in PDF_SUFFIXES:
            raise FileSelectionError(f"PDFファイル(拡張子 .pdf)を選択してください: {resolved.name}")
        return resolved
    
    
    def validate_excel_path(path: str | Path) -> Path:
        """Excelテンプレートとして受け付けられるパスかを検証し、`Path` を返す。
    
        存在確認・ファイル種別・拡張子(`.xlsx` / `.xlsm`)のみを見る。シート・
        セル構成の検証は、openpyxlで書き込みを実装する第7回以降で行う。
        """
        resolved = Path(path)
        if not resolved.exists():
            raise FileSelectionError(f"ファイルが見つかりません: {resolved}")
        if not resolved.is_file():
            raise FileSelectionError(f"フォルダではなくファイルを選択してください: {resolved}")
        if resolved.suffix.lower() not in EXCEL_SUFFIXES:
            raise FileSelectionError(
                f"Excelファイル(拡張子 .xlsx または .xlsm)を選択してください: {resolved.name}"
            )
        return resolved

    validate_excel_path も同様の作りで、.xlsx / .xlsm を受け付けます。

    メイン画面(app/ui/main_window.py)

    「PDFを選ぶ」「Excelを選ぶ」ボタンと、両方選ばれるまで押せない実行ボタンを配置しています。実行ボタンを押したときの処理(文字抽出・OCR・Excel書き込み)は、まだ「次回以降で実装します」というメッセージを出すだけの空の実装です。

    app/ui/main_window.py を新しく作ります(全文)。

    app/ui/main_window.py の全文(105行)
    # app/ui/main_window.py
    """メイン画面(PDF選択・Excelテンプレート選択・実行ボタン)。
    
    第0回では「ファイルを選ぶ」「選んだパスを保持する」ところまでを実装する。
    選んだファイルの検証は `app/core/file_selection.py`(tkinterに依存しないコア処理)に任せ、
    この画面はボタン・ラベルの配置と、検証結果の表示だけを受け持つ。
    """
    
    from __future__ import annotations
    
    import tkinter as tk
    from tkinter import filedialog, messagebox, ttk
    
    from app.core.file_selection import FileSelectionError, SelectedFiles, validate_excel_path, validate_pdf_path
    
    WINDOW_TITLE = "間取りOCR転記ツール"
    WINDOW_SIZE = "640x260"
    
    PDF_FILETYPES = [("PDFファイル", "*.pdf")]
    EXCEL_FILETYPES = [("Excelファイル", "*.xlsx *.xlsm")]
    
    
    class MainWindow(ttk.Frame):
        """PDF図面とExcelテンプレートを選び、実行ボタンを押すまでの画面。"""
    
        def __init__(self, master: tk.Tk) -> None:
            super().__init__(master, padding=16)
            self.selected = SelectedFiles()
    
            self.pdf_path_var = tk.StringVar(value="未選択")
            self.excel_path_var = tk.StringVar(value="未選択")
            self.status_var = tk.StringVar(value="PDF図面とExcelテンプレートを選んでください。")
    
            self._build_widgets()
            self._refresh_run_button()
    
        def _build_widgets(self) -> None:
            self.columnconfigure(0, weight=1)
    
            ttk.Label(self, text="1. CAD図面PDFを選択").grid(row=0, column=0, sticky="w")
            ttk.Button(self, text="PDFを選ぶ...", command=self._on_choose_pdf).grid(row=0, column=1, padx=8)
            ttk.Label(self, textvariable=self.pdf_path_var, foreground="#555555").grid(
                row=1, column=0, columnspan=2, sticky="w", pady=(0, 12)
            )
    
            ttk.Label(self, text="2. Excelテンプレートを選択").grid(row=2, column=0, sticky="w")
            ttk.Button(self, text="Excelを選ぶ...", command=self._on_choose_excel).grid(row=2, column=1, padx=8)
            ttk.Label(self, textvariable=self.excel_path_var, foreground="#555555").grid(
                row=3, column=0, columnspan=2, sticky="w", pady=(0, 12)
            )
    
            self.run_button = ttk.Button(
                self, text="3. 実行(次回以降で実装)", command=self._on_run, state="disabled"
            )
            self.run_button.grid(row=4, column=0, columnspan=2, sticky="ew", pady=(4, 12))
    
            ttk.Label(self, textvariable=self.status_var, foreground="#1a6b2a").grid(
                row=5, column=0, columnspan=2, sticky="w"
            )
    
        def _on_choose_pdf(self) -> None:
            path = filedialog.askopenfilename(title="CAD図面PDFを選択", filetypes=PDF_FILETYPES)
            if not path:
                return
            try:
                validated = validate_pdf_path(path)
            except FileSelectionError as exc:
                messagebox.showerror("ファイル選択エラー", str(exc))
                return
            self.selected = self.selected.with_pdf(validated)
            self.pdf_path_var.set(str(validated))
            self._refresh_run_button()
    
        def _on_choose_excel(self) -> None:
            path = filedialog.askopenfilename(title="Excelテンプレートを選択", filetypes=EXCEL_FILETYPES)
            if not path:
                return
            try:
                validated = validate_excel_path(path)
            except FileSelectionError as exc:
                messagebox.showerror("ファイル選択エラー", str(exc))
                return
            self.selected = self.selected.with_excel(validated)
            self.excel_path_var.set(str(validated))
            self._refresh_run_button()
    
        def _refresh_run_button(self) -> None:
            if self.selected.is_ready():
                self.run_button.configure(state="normal")
                self.status_var.set("PDFとExcelを選択しました。")
            else:
                self.run_button.configure(state="disabled")
    
        def _on_run(self) -> None:
            """実行ボタン。図面の読み取り・Excelへの転記は次回以降で実装する。"""
            messagebox.showinfo("実行", "図面の読み取り・Excelへの転記は次回以降で実装します。")
    
    
    def build_main_window(master: tk.Tk) -> MainWindow:
        """トップレベルウィンドウに `MainWindow` を組み込んで返す。"""
        master.title(WINDOW_TITLE)
        master.geometry(WINDOW_SIZE)
        window = MainWindow(master)
        window.pack(fill="both", expand=True)
        return window

    ファイルダイアログ自体がfiletypesで拡張子を絞り込みますが、ドラッグ&ドロップや手入力で別拡張子を渡された場合に備え、app/core/file_selection.py の検証を必ず通してから状態を更新するようにしています。

    エントリーポイント(app/main.py)

    app/main.py を新しく作ります(全文)。

    # app/main.py
    """アプリケーションのエントリーポイント。
    
    プロジェクトのルート(`app/` フォルダがあるフォルダ)で `python -m app.main` として起動する。
    Linux開発環境で起動そのものを試す場合は、tkinterと
    Xサーバーが必要なため `xvfb-run python -m app.main` を使う
    (画面が実際に正しく描画されるかはWindows実機での確認が必要。詳細は記事参照)。
    """
    
    from __future__ import annotations
    
    import tkinter as tk
    
    from app.ui.main_window import build_main_window
    
    
    def main() -> None:
        """tkinterのルートウィンドウを作成し、メイン画面を表示してイベントループへ入る。"""
        root = tk.Tk()
        build_main_window(root)
        root.mainloop()
    
    
    if __name__ == "__main__":
        main()

    テストとプロジェクトの設定(tests/test_file_selection.py・pytest.ini・.gitignore)

    コア処理のテストです。存在しないファイル・拡張子違い・フォルダを渡したときにエラーになることと、PDFとExcelの両方が揃って初めて is_ready() が True になることを確かめます。

    tests/test_file_selection.py を新しく作ります(全文)。

    tests/test_file_selection.py の全文(95行)
    # tests/test_file_selection.py
    """`app.core.file_selection` のユニットテスト(tkinter非依存)。"""
    
    from __future__ import annotations
    
    from pathlib import Path
    
    import pytest
    
    from app.core.file_selection import (
        FileSelectionError,
        SelectedFiles,
        validate_excel_path,
        validate_pdf_path,
    )
    
    
    def test_validate_pdf_path_accepts_existing_pdf(tmp_path: Path) -> None:
        pdf = tmp_path / "madori.pdf"
        pdf.write_bytes(b"%PDF-1.4\n%dummy")
    
        assert validate_pdf_path(pdf) == pdf
    
    
    def test_validate_pdf_path_accepts_uppercase_extension(tmp_path: Path) -> None:
        pdf = tmp_path / "MADORI.PDF"
        pdf.write_bytes(b"%PDF-1.4\n%dummy")
    
        assert validate_pdf_path(pdf) == pdf
    
    
    def test_validate_pdf_path_rejects_missing_file(tmp_path: Path) -> None:
        with pytest.raises(FileSelectionError):
            validate_pdf_path(tmp_path / "missing.pdf")
    
    
    def test_validate_pdf_path_rejects_wrong_extension(tmp_path: Path) -> None:
        text_file = tmp_path / "memo.txt"
        text_file.write_text("これはPDFではありません", encoding="utf-8")
    
        with pytest.raises(FileSelectionError):
            validate_pdf_path(text_file)
    
    
    def test_validate_pdf_path_rejects_directory(tmp_path: Path) -> None:
        directory = tmp_path / "folder.pdf"
        directory.mkdir()
    
        with pytest.raises(FileSelectionError):
            validate_pdf_path(directory)
    
    
    def test_validate_excel_path_accepts_xlsx(tmp_path: Path) -> None:
        xlsx = tmp_path / "template.xlsx"
        xlsx.write_bytes(b"PK\x03\x04dummy")
    
        assert validate_excel_path(xlsx) == xlsx
    
    
    def test_validate_excel_path_accepts_xlsm(tmp_path: Path) -> None:
        xlsm = tmp_path / "template.xlsm"
        xlsm.write_bytes(b"PK\x03\x04dummy")
    
        assert validate_excel_path(xlsm) == xlsm
    
    
    def test_validate_excel_path_rejects_wrong_extension(tmp_path: Path) -> None:
        csv_file = tmp_path / "template.csv"
        csv_file.write_text("a,b,c", encoding="utf-8")
    
        with pytest.raises(FileSelectionError):
            validate_excel_path(csv_file)
    
    
    def test_validate_excel_path_rejects_missing_file(tmp_path: Path) -> None:
        with pytest.raises(FileSelectionError):
            validate_excel_path(tmp_path / "missing.xlsx")
    
    
    def test_selected_files_is_ready_only_when_both_set(tmp_path: Path) -> None:
        pdf = tmp_path / "a.pdf"
        pdf.write_bytes(b"%PDF-1.4")
        xlsx = tmp_path / "b.xlsx"
        xlsx.write_bytes(b"PK\x03\x04")
    
        empty = SelectedFiles()
        assert not empty.is_ready()
    
        only_pdf = empty.with_pdf(pdf)
        assert not only_pdf.is_ready()
    
        ready = only_pdf.with_excel(xlsx)
        assert ready.is_ready()
        assert ready.pdf_path == pdf
        assert ready.excel_path == xlsx

    pytest.ini は、テストからプロジェクトのルートにある app パッケージを読み込めるようにする設定です(pythonpath = .)。これが無いと、テストが ModuleNotFoundError: No module named 'app' で止まります。

    pytest.ini を新しく作ります(全文)。

    # pytest.ini
    [pytest]
    pythonpath = .
    testpaths = tests

    .gitignore は、Gitで管理しないファイル(仮想環境・キャッシュ・転記結果のExcel・APIキーなどを書いた .env)の一覧です。

    .gitignore を新しく作ります(全文)。

    # .gitignore
    # Python仮想環境
    .venv/
    venv/
    
    # バイトコード・キャッシュ
    __pycache__/
    *.py[cod]
    .pytest_cache/
    .ruff_cache/
    .mypy_cache/
    
    # 転記結果として生成されるExcelファイル(原本テンプレートは残し、出力先は追跡しない)
    output/
    *.out.xlsx
    
    # ローカル設定・秘密情報(APIキー等はkeyring経由で保存し、.envに実値を書かない)
    .env
    .env.*
    !.env.example
    
    # OS・エディタ
    .DS_Store
    .idea/
    .vscode/

    動かしてみる

    プロジェクトのルートで、テスト・コードの点検・アプリの起動を行います。アプリは python -m app.main で起動してください(app の中のファイルを直接指定する python app/main.py では、app パッケージが見つからず起動できません)。

    pytest
    ruff check .
    python -m app.main

    pytest で「10 passed」と表示され、ruff check . で「All checks passed!」と表示されれば、ここまでの作業は完了です。python -m app.main でメイン画面が開き、PDFとExcelの両方を選ぶと「3. 実行」ボタンが押せるようになります。

    動作確認の方法

    Linux開発環境で確認できたことと、Windows実機での確認が必要なことを分けて書きます。

    Linux開発環境で確認できたこと

    • pytest:app/core/file_selection.py に対するテスト10件がすべて成功(存在しないファイル・拡張子違い・フォルダを指定した場合にエラーになること、PDFとExcelの両方が揃って初めてis_ready()がTrueになることを検証)
    • ruff check .:エラーなし
    • python -c "import app.main":importエラーなし(tkinterが利用できるPython環境で確認)
    • xvfb-run python -m app.main 相当の起動確認:仮想ディスプレイ(Xvfb)上でウィンドウを生成し、タイトルバーの文字列と、実行ボタンが初期状態で無効(disabled)になっていることをコードから確認。例外を出さずに終了できることも確認

    実際に起動した画面は次のとおりです。

    起動直後のメイン画面。CAD図面PDF・Excelテンプレートともに「未選択」と表示され、3. 文字検出ボタンと4. 実行ボタンはグレーアウトして押せない

    ※これは開発環境(Linux/Xvfb上・Ubuntu標準のTkテーマ)で起動して確認した画面です。Windows実機ではウィンドウの装飾や既定フォントなど見た目が異なります。また、この画像は第3回の時点で撮り直したもので、「3.」「4.」のボタンと図面プレビューは第1〜3回で追加します。第0回のコードでは「1.」「2.」と「3. 実行」ボタンだけが表示されます。

    Windows実機での確認が必要なこと(このリポジトリでは未確認)

    • 実際の画面レイアウト・フォント・ボタンの見た目
    • ファイル選択ダイアログの操作感(Windowsのエクスプローラーとの見た目の違いなど)
    • 高DPIディスプレイでの表示スケーリング

    Xvfbでの起動確認は「例外を出さずにウィンドウを生成できる」ことの確認であり、「Windows上で見た目どおりに動く」ことの確認ではありません。画面の実物確認は、開発会社にとって当たり前の工程ですが、Linux上で開発を進める場合はこの区別を意識しておく必要があります。

    つまずきやすい点・セキュリティ上の注意

    • 開発環境のPythonバージョン:連載の技術スタックはPython 3.13系を前提にしていますが、このリポジトリの検証環境ではPython 3.11/3.12までしか用意できませんでした。文法・標準ライブラリの使い方に3.13固有の差異は出ていませんが、Windows実機でセットアップする際は3.13系を使ってください(2026年10月29日 追記:その後、Python 3.13系の新しい仮想環境でも、記事の手順どおりにテストが通ることを確認しました)。
    • tkinterはOSの表示環境に依存する:Linuxサーバー環境ではデフォルトでtkinterが入っていないことがあります(今回の検証環境もそうでした。Ubuntuなら sudo apt-get install python3-tk で入ります)。Windows配布用のツールなので通常は問題になりませんが、開発を複数人・複数OSで行う場合はこの点を共有しておくと手戻りが減ります。
    • 次回以降で使うPyMuPDFのライセンス:図面PDFを開く処理(第1回)ではPyMuPDFを使う予定ですが、これはAGPL-3.0ライセンス(商用ライセンスも別途あり)のライブラリです。自社の内製ツールとして社内だけで使う分には問題になりにくいのですが、ツールを他社へ配布・販売する場合はライセンス条件の確認が必要になります。詳しくは第1回で扱います。
    • 図面・Excelファイルの取り扱い:図面やExcelの様式には、顧客の建物情報が含まれることがあります。この連載のサンプルコード・記事では実在の顧客情報を使わず、架空の図面・様式を前提に進めます。実際の開発では、サンプルデータにも社内の取り扱いルールを適用してください。

    発注者向けメモ

    この回で確認しておきたいこと・工数の勘所

    「決まったフォーマットへの転記」は要件が明確に見えやすい作業です。ところが実際に進めてみると、部屋名の表記ゆれ(洋室1/寝室1/ベッドルーム等)や、Excelの様式が取引先ごとに微妙に違うといった「例外」が後から効いてきて、当初の見積もりより工数がかかりがちです。開発を始める前に、対象となる図面のパターン(CADソフト由来で文字が埋め込まれているか、古いスキャン図面が混ざっているか)をできるだけ集めておくと、あとの手戻りを減らせます。

    • ☐ 対象図面のサンプルを、パターン別(CAD由来・スキャンのみ・両方混在)に最低数点ずつ集めたか
    • ☐ 転記先のExcel様式は何パターンあるか(取引先ごとに違うか)を洗い出したか
    • ☐ 部屋名の呼び方のゆれ(現場での言い方の違い)をリストアップしたか
    • ☐ 図面を外部のAIサービスに送信してよいか、社内の情報管理ルール・契約上の秘密保持義務を確認したか
    • ☐ 配布先の担当者のPCにPythonが入っているか、入っていない前提でexe配布が必要かを確認したか

    開発会社への質問例

    • 「御社では、図面PDFが『文字が埋め込まれたPDF』か『画像として取り込まれたスキャンPDF』かを、どうやって判定しますか?」
    • 「ローカルのOCRと外部の生成AI、どちらを基本の方式にする想定ですか。その理由も教えてください」
    • 「Excelの様式が途中で追加・変更になった場合、どこまでが設定ファイルの変更で済み、どこからがコードの改修になりますか?」
    • 「AI・OCRが読み取った部屋名を、人が確認・修正できる画面はどの程度作り込む想定ですか?」

    これらの質問は、見積もりの前提(対象図面のパターン数、AIを使うかどうか、人の確認をどこまで挟むか)をすり合わせるためのものです。前提が揃っていないと、開発途中で「そんな図面もあったのか」という手戻りにつながりやすくなります。

    まとめと次回予告

    第0回では、連載全体のゴールを確認したうえで、Python環境の構築、tkinterによる最初のウィンドウ、PDF・Excelファイルの選択ダイアログの土台を作りました。実際にファイルの中身を読む処理はまだ入っていませんが、画面(GUI)とロジック(コア処理)を分けるという、この連載を通して守る設計方針はここで固めています。

    次回(第1回)は、選んだPDFの図面ページをPyMuPDFで画像化し、tkinterのCanvasに表示してページ送り・拡大縮小ができるようにします。あわせて、PyMuPDFのライセンス(AGPL-3.0)についても具体的に扱います。

    この連載の記事一覧

    この記事は連載「CAD図面PDFをExcelへ自動転記するツール開発」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。

    システム制作・運用・保守のお問い合わせはこちら

      お問い合わせ


      よかったらシェアしてね!
      • URLをコピーしました!
      • URLをコピーしました!

      この記事を書いた人

      株式会社THIRD HERO代表取締役 朝野貴朗
      Webシステム開発を中心に、toC向けサービスサイトの運営、ツール開発などを行ってまいりました。

      コメント

      コメント一覧 (1件)

      目次