📄
【#1】Javaレガシー帳票出力アプリをPythonにリメイクした話
Flask帳票出力アプリ
0. はじめに
昔SIerにて、以下の構築の案件に関わったことがある。
この帳票出力アプリの構築では、
ユーザがJavaScript UIの画面に入力した値をバックエンド側で処理し,
生成されたSQLでDBに問い合わせ、結果をもとにPDFを生成する。
しかし、帳票出力処理とバックエンド処理が密結合なため動作が重く、
保守性も拡張性も絶望的であった。
フロントとバックが密に絡んでて「改修したくても壊れる」状態であった。
これらの経験から、軽量でモダンな構築で実現できないか考察した。
1. Flaskで作り直したときの構成メモ
以下の記事で Python + Postgres + Apache2 の開発環境を作成済み(この構築ではApacheは未使用)
また、WSL上でVSCodeを起動できるようにしている。
- アプリ側は Python + Flask + Jinja2 + PostgreSQL（※ORMはSQLAlchemyでもいいし、生でもいい）
- 帳票生成ロジックは 入力HTML → Flask（処理&テンプレート）→ HTML（Jinja2） → weasyprint → PDF
ディレクトリ構成
.
├── Dockerfile
├── README.md
├── app.py --アプリ実行ファイル
├── docker-compose.yml
├── init.sql --DB初期化用SQL
├── requirements.txt --Pythonパッケージの依存関係記録
├── static
│ └── style.css
└── templates
├── index.html
├── layout.html
└── report.html
- アプリ実行部は
app.pyのみのシンプル実装。 -
layout.htmlを繰返しのベースとし、画面部はindex.html、帳票部はreport.htmlに分けて責務を明確化。 - バックエンド主軸のため、CSSなどUI部分は最小限の構成にとどめる。レスポンシブ対応も省略。
2. 実装内容の詳細
2.1 バックエンドロジックの分離とPDF出力
-
入力補助（オートコンプリート）の際、バックエンドからキーと値の
JSON形式で返却- 保守性・拡張性が高い形式であり、Flaskの
jsonify()とも好相性。
- 保守性・拡張性が高い形式であり、Flaskの
-
保守性のための画面部と帳票部の分離構造を実現
2.2 フロント側の実装ロジック
- 商品コード、商品名が入力されたときに、DBをクエリして問合せ結果が返る場合、商品コード、商品名、単価（円）の情報をオートコンプリートする。
- 商品コード、商品名、数量、単価は入力必須とし、不正値が入力された状態で「納品リストに追加」ボタンが押されるとエラーが出るようにHTML実装。
- スマホ対応は今回の主旨から外れるため省略
3. 入力画面＋PDF出力結果
4. おわりに
今回は1画面のみの実装であるが、「保守しやすさ」「分かりやすい責務分離」を意識してバックエンド構築ができた。PDF帳票のようなシンプルな機能でも、裏側の処理整理と役割分離は実務で重要になる。CI/CDやクラウド連携も視野に見据えて、「見た目より構造で勝負する」設計姿勢を残しておきたい。
Discussion