【Python】FastAPIで料金プラン見積もりシミュレーターを作ってみた

「スタンダードプランで15人、年払いにしたら結局いくら?」——料金表と電卓を行き来しながら見積もりを出すのは、意外と面倒な作業です。そこでPythonのFastAPIを使って、プラン・人数・オプション・支払い方法を選ぶと税込金額まで一発で表示される料金プラン見積もりシミュレーターを作ってみました。

テンプレートエンジンもデータベースも使わない1ファイル構成なので、FastAPI入門の題材にもちょうどいいはずです。実際に4種類の画面で表示と絞り込みの動作を確認するところまで、コードを抜粋しながら解説します。

今回作るのは、プラン(ライト/スタンダード/プレミアム)・利用人数・オプション・月払いか年払いかを選ぶと、税込の見積もり金額を表示するWebアプリです。画面は入力フォームの「/」と結果表示の「/estimate」の2つだけに絞りました。

方針はシンプルで、FastAPIのGETエンドポイントを2つ用意し、料金マスタはPythonの辞書で定義します。データベースを使わないので準備するものが少なく、HTMLもテンプレートエンジンを使わずPythonの文字列で組み立てるため、外部依存のない1ファイル構成に収まりました。

見積もり計算はcalculate関数に一本化し、小計→年払い割引→消費税の順に、円未満を切り捨てる整数計算で行う仕様です。お金の計算は適用順と丸め方で結果が変わるため、コードを書く前にこの順序を決めておきました。

この記事のコードはClaude Codeに書かせたもので、別のAIであるCodexにレビューさせています。以下は、その際に使った指示の内容です。

料金計算は仕様の曖昧さがそのまま金額のズレになるため、プラン・オプション・割引率をすべて具体的な数字で指定しました。とくに「小計から割引を引き、そのあと消費税を加える」と順番まで固定したのがポイントで、これがないと税込み額に割引をかける実装が混ざります。

依存をfastapiとuvicornだけに絞ったのは、生成コードを1ファイルに収めて写経から起動までの距離を最短にするためです。テンプレートエンジンやDBを禁止すると、読者はFastAPI本体の書き方だけに集中できます。

生成プロンプトで工夫したポイント

• 計算の順序は「小計 → 年払い割引を引く → 消費税10%を加える」に固定し：順番を明記しないと税込み額に割引をかける実装が混ざり、合計が数十円ずれることがあるためです。
• 割引額と税額は円未満を切り捨てた整数で扱う：浮動小数点のまま計算すると端数の出方が揺れるので、金額を整数に確定させて誰が実行しても同じ結果になるようにします。
• 3人まで込み・追加1人500円：実際のSaaSに多い「基本料+超過課金」の段階制を数字で示すと、超過分だけを課金する計算が正しく生成されやすくなります。
• 使うのはfastapiとuvicornだけ：依存が2つに絞られるとコードが1ファイルで完結し、環境構築でつまずく余地も小さくなるからです。

同じコードを作れる生成プロンプト（コピペ用・全文）

以下のプロンプトは、そのままコピペして同じものが作れるように整えた全文です。

この記事のセットアップ手順と掲載コードは、Windows 11 Pro、PowerShell 5.1、Python 3.13.3で動作確認しています。仮想環境を有効化せず、その中のPythonを直接指定するため、以下のコマンドはPowerShellとコマンドプロンプト（cmd）の両方で使えます。

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install fastapi uvicorn

macOS・Linuxでは仮想環境内のPythonパスが異なります。今回の動作確認環境とは異なるため、以下は環境差分を補う参考手順です。

python3 -m venv .venv
./.venv/bin/python -m pip install fastapi uvicorn

• 起動は.\.venv\Scripts\python.exe -m uvicorn estimate_app:app --reloadで行い、ブラウザでhttp://127.0.0.1:8000を開くと確認できます。
• サーバーはCtrl+Cで停止します。ポート8000が使用中なら--port 8001のように別ポートを指定してください。

コード全体は「料金マスタの定義」「calculate関数」「HTML組み立てのrender_page」「2つのエンドポイント」という4ブロック構成です。上から順に読むと、データ→計算→表示という流れがそのまま追えるように並べました。

工夫が要ったのはオプションの複数選択です。options=support&options=backupのように同じ名前のクエリパラメータを複数並べて送り、受け取る側では引数にQuery(default=[])を指定してリストとしてまとめて受け取ります。

この書き方は自己流ではなく、FastAPIの公式ドキュメントで案内されている方法です。Queryを明示しないとリストはリクエストボディ扱いになってしまうため、GETで複数値を受けるなら必須の指定になります。

それでは、押さえておけば全体が分かる要点だけをコードから抜粋して見ていきます。

from fastapi import FastAPI, Query
from fastapi.responses import HTMLResponse

# 料金マスタの定義
PLANS = {
    "light": {"name": "ライト", "base": 5000, "included": 3, "per_user": 500},
    "standard": {"name": "スタンダード", "base": 15000, "included": 10, "per_user": 800},
    "premium": {"name": "プレミアム", "base": 50000, "included": 30, "per_user": 1200},
}
OPTIONS = {
    "support": {"name": "優先サポート", "price": 3000},
    "backup": {"name": "自動バックアップ", "price": 2000},
    "sso": {"name": "SSO連携", "price": 5000},
}
YEARLY_DISCOUNT_RATE = 0.15  # 年払いは小計から15%割引
TAX_RATE = 0.10  # 消費税10%

# アプリ本体と動作確認したい画面の一覧
app = FastAPI(title="料金プラン見積もりシミュレーター")
ROUTES = [
    "/",
    "/estimate?plan=standard&users=15&options=support&options=backup&billing=yearly",
    "/estimate?plan=light&users=3&billing=monthly",
    "/estimate?plan=premium&users=40&options=sso&billing=yearly",
]

# 見積もり計算(小計 → 年払い割引 → 消費税の順で適用する)
def calculate(plan_key: str, users: int, option_keys: list[str], billing: str) -> dict:
    plan = PLANS[plan_key]
    extra_users = max(0, users - plan["included"])
    user_fee = extra_users * plan["per_user"]
    selected_options = [OPTIONS[k] for k in option_keys if k in OPTIONS]
    option_fee = sum(o["price"] for o in selected_options)
    subtotal = plan["base"] + user_fee + option_fee
    discount = int(subtotal * YEARLY_DISCOUNT_RATE) if billing == "yearly" else 0
    tax = int((subtotal - discount) * TAX_RATE)
    return {
        "plan": plan,
        "users": users,
        "extra_users": extra_users,
        "user_fee": user_fee,
        "options": selected_options,
        "option_fee": option_fee,
        "subtotal": subtotal,
        "discount": discount,
        "tax": tax,
        "total": subtotal - discount + tax,
        "billing": billing,
    }

# ページ共通のHTMLレイアウト
def render_page(title: str, body: str) -> str:
    return f"""<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{title}</title>
<style>
  body {{ font-family: sans-serif; background: #f4f6fb; margin: 0; color: #223; }}
  main {{ max-width: 640px; margin: 40px auto; background: #fff; border-radius: 12px;
          padding: 32px; box-shadow: 0 2px 10px rgba(0,0,0,.08); }}
  h1 {{ font-size: 1.4rem; border-left: 6px solid #2563eb; padding-left: 12px; }}
  fieldset {{ border: 1px solid #d5dbe7; border-radius: 8px; margin-bottom: 20px; }}
  legend {{ font-weight: bold; padding: 0 8px; }}
  label {{ display: block; margin: 8px 0; }}
  input[type=number] {{ width: 6em; padding: 4px; }}
  button {{ background: #2563eb; color: #fff; border: none; border-radius: 8px;
            padding: 12px 32px; font-size: 1rem; cursor: pointer; }}
  table {{ width: 100%; border-collapse: collapse; margin: 16px 0; }}
  th, td {{ border-bottom: 1px solid #e2e8f0; padding: 10px 8px; text-align: left; }}
  td.amount {{ text-align: right; font-variant-numeric: tabular-nums; }}
  tr.total td {{ font-size: 1.2rem; font-weight: bold; color: #2563eb; }}
  a {{ color: #2563eb; }}
</style>
</head>
<body><main>{body}</main></body>
</html>"""

# 入力フォーム画面
@app.get("/", response_class=HTMLResponse)
def index() -> str:
    plan_inputs = "".join(
        f'<label><input type="radio" name="plan" value="{key}"'
        f'{" checked" if key == "standard" else ""}>'
        f'{p["name"]}:月額{p["base"]:,}円({p["included"]}人まで込み、追加1人{p["per_user"]:,}円)</label>'
        for key, p in PLANS.items()
    )
    option_inputs = "".join(
        f'<label><input type="checkbox" name="options" value="{key}">'
        f'{o["name"]}(+{o["price"]:,}円/月)</label>'
        for key, o in OPTIONS.items()
    )
    body = f"""
<h1>料金プラン見積もりシミュレーター</h1>
<p>プランと利用条件を選んで「見積もりを計算」を押してください。</p>
<form action="/estimate" method="get">
  <fieldset><legend>プラン</legend>{plan_inputs}</fieldset>
  <fieldset><legend>利用人数</legend>
    <label>ユーザー数 <input type="number" name="users" value="10" min="1" max="500"> 人</label>
  </fieldset>
  <fieldset><legend>オプション</legend>{option_inputs}</fieldset>
  <fieldset><legend>支払いサイクル</legend>
    <label><input type="radio" name="billing" value="monthly" checked>月払い</label>
    <label><input type="radio" name="billing" value="yearly">年払い(小計から15%割引)</label>
  </fieldset>
  <button type="submit">見積もりを計算</button>
</form>"""
    return render_page("料金プラン見積もりシミュレーター", body)

# 見積もり結果画面
@app.get("/estimate", response_class=HTMLResponse)
def estimate(
    plan: str = "standard",
    users: int = 1,
    options: list[str] = Query(default=[]),
    billing: str = "monthly",
) -> str:
    if plan not in PLANS:
        return render_page(
            "エラー",
            '<h1>エラー</h1><p>不明なプランが指定されました。</p><p><a href="/">フォームに戻る</a></p>',
        )
    users = min(max(users, 1), 500)
    result = calculate(plan, users, options, billing)

    option_rows = "".join(
        f'<tr><td>オプション:{o["name"]}</td><td class="amount">{o["price"]:,}円</td></tr>'
        for o in result["options"]
    ) or '<tr><td>オプション</td><td class="amount">0円</td></tr>'
    discount_row = (
        f'<tr><td>年払い割引(15%)</td><td class="amount">-{result["discount"]:,}円</td></tr>'
        if result["billing"] == "yearly"
        else ""
    )
    billing_label = "年払い" if result["billing"] == "yearly" else "月払い"
    body = f"""
<h1>見積もり結果</h1>
<p>{result["plan"]["name"]}プラン / {result["users"]}人 / {billing_label}</p>
<table>
  <tr><td>基本料金({result["plan"]["included"]}人まで込み)</td><td class="amount">{result["plan"]["base"]:,}円</td></tr>
  <tr><td>追加ユーザー料金({result["extra_users"]}人 × {result["plan"]["per_user"]:,}円)</td><td class="amount">{result["user_fee"]:,}円</td></tr>
  {option_rows}
  <tr><td>小計</td><td class="amount">{result["subtotal"]:,}円</td></tr>
  {discount_row}
  <tr><td>消費税(10%)</td><td class="amount">{result["tax"]:,}円</td></tr>
  <tr class="total"><td>月額合計(税込)</td><td class="amount">{result["total"]:,}円</td></tr>
</table>
<p><a href="/">条件を変えて再計算する</a></p>"""
    return render_page("見積もり結果", body)

コード全文は上の折り畳みに入れてあるので、全部を上から読む必要はありません。ここでは特に重要な部分だけを抜き出して、何をしているのか順番に見ていきます。

PLANS辞書で料金マスタを一元管理する

PLANS = {
    "light": {"name": "ライト", "base": 5000, "included": 3, "per_user": 500},
    "standard": {"name": "スタンダード", "base": 15000, "included": 10, "per_user": 800},
    "premium": {"name": "プレミアム", "base": 50000, "included": 30, "per_user": 1200},
}

3つのプランを、基本料金base・込みユーザー数included・超過1人あたりの単価per_userという共通の形で持たせています。料金改定のときはこの辞書の数値を書き換えるだけで、計算にも画面にも反映される作りです。

calculate関数に見積もりロジックを集約する

def calculate(plan_key: str, users: int, option_keys: list[str], billing: str) -> dict:
    plan = PLANS[plan_key]

金額に関わる計算はすべてこの関数に集めました。入力は文字列と数値だけ、出力は計算結果を詰めた辞書という素直な形なので、画面と切り離して単体でテストしやすくなります。

max関数で超過人数のマイナスを防ぐ

    extra_users = max(0, users - plan["included"])
    user_fee = extra_users * plan["per_user"]

利用人数がプランの込みユーザー数以下だとusers - plan["included"]は負の数になり、そのまま掛け算すると料金がマイナスになってしまいます。max(0, ...)で下限を0に固定するのが定番の守り方です。

リスト内包表記で選択オプションを取り出す

    selected_options = [OPTIONS[k] for k in option_keys if k in OPTIONS]
    option_fee = sum(o["price"] for o in selected_options)

クエリで受け取ったオプションのキーのうち、if k in OPTIONSでマスタに存在するものだけを拾います。URLに不正なキーを混ぜられても黙って無視されるだけなので、余計なエラー処理を書かずに済みました。

intの切り捨てで割引と消費税を計算する

    subtotal = plan["base"] + user_fee + option_fee
    discount = int(subtotal * YEARLY_DISCOUNT_RATE) if billing == "yearly" else 0
    tax = int((subtotal - discount) * TAX_RATE)

小計→年払いなら15%割引→残額に消費税10%、という決めた順序どおりの計算です。掛け算のたびにint()で円未満を切り捨てて整数に戻すことで、小数の誤差が金額に紛れ込むのを防いでいます。

render_pageで共通HTMLレイアウトを返す

def render_page(title: str, body: str) -> str:
    return f"""<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="utf-8">

ページごとに違うのはタイトルと本文だけなので、共通の枠をf文字列で1回だけ書き、{title}と{body}を差し込む方式にしました。テンプレートエンジンなしでも、この程度の規模なら十分に見通しよく書けます。

参考：

©FastAPI公式ドキュメント

To declare a query parameter with a type of list, like in the example above, you need to explicitly use Query, otherwise it would be interpreted as a request body.

プロンプトから作ったコードは、一見動いていても抜けや改善点が潜んでいることがあります。エラーにならない=正しい、ではないのが怖いところです。

そこで、コードを書いたClaude Codeとは別のAIであるCodexに同じコードをレビューさせ、指摘をそのまま載せます。書き手と読み手を別のAIに分けると、自分では気づきにくい問題を洗い出せます。

開発サーバーを起動してブラウザからアクセスし、フォーム画面と条件違いの見積もり結果、合わせて4種類の画面を確認しました。いずれもHTTP 200で正常に表示されています。

結果画面は次の3パターンを試しました。プランと人数、オプションの絞り込み条件を変えるたびに、金額の内訳が組み替わって表示されるのを確認できています。

あわせて、ブラウザ操作の録画でも一連の流れをチェックしました。フォームで条件を選んで送信すると、URLのクエリパラメータが変わり、その条件どおりの見積もりに切り替わる様子が追えます。

• スタンダードプラン・15人・優先サポート+自動バックアップ・年払い(/estimate?plan=standard&users=15&options=support&options=backup&billing=yearly)
• ライトプラン・3人・オプションなし・月払い(/estimate?plan=light&users=3&billing=monthly)——込みユーザー数内に収まる最小構成
• プレミアムプラン・40人・SSO連携・年払い(/estimate?plan=premium&users=40&options=sso&billing=yearly)——超過課金と割引が両方効く構成

この手の構成で初心者が遭遇しやすいエラーを、原因と対処のセットでまとめておきます。どれも一般によくあるパターンなので、動かないときはまずここから疑ってみてください。

特に4つ目のQueryまわりは、コードが一見正しく見えるだけに気づきにくいポイントです。GETでリストを受け取るときの約束事として覚えておくと、原因の切り分けが早くなります。

フォームからGETで値を渡す今回の構成は仕組みが単純なぶん、名前や順序のちょっとしたズレが「値が届かない」「金額が合わない」という分かりにくい不具合につながります。ハマりやすい点を先にまとめておきます。

「基本料金+人数課金+オプション+割引」という構造は、SaaSに限らず多くの料金体系に共通しています。PLANSとOPTIONSの中身を差し替えるだけで流用できるので、応用の幅は広いはずです。

実務での使いどころを、具体的な使い方まで含めて挙げてみます。

FastAPIのGETエンドポイント2つと辞書の料金マスタだけで、料金プラン見積もりシミュレーターを1ファイルに収めました。実際に4種類の画面で表示と絞り込みの動作を確認でき、フォームで条件を変えると内訳ごと金額が切り替わるところまで動いています。

振り返ると、学びの中心は次の3点でした。どれもFastAPIに限らず、Webアプリで「条件を受け取って計算結果を返す」場面全般で効いてくる考え方です。

次のステップとしては、Queryのge=1のような値の範囲チェックを足したり、料金マスタをJSONファイルに切り出したりする拡張が考えられます。まずはこの1ファイルを手元で動かして、PLANSの数値を自分の題材に書き換えるところから試してみてください。

• 複数選択は同名クエリパラメータの繰り返しで表現し、Query(default=[])でリストとして受け取る
• お金の計算は「小計→割引→税、円未満切り捨て」のように、適用順と丸め方を先に仕様として決めてから実装する
• 計算をcalculate関数、表示をrender_page関数に分けておくと、1ファイル構成でも見通しが保てる

参考にした一次情報

1. ^ FastAPI公式ドキュメント(日本語). https://fastapi.tiangolo.com/ja/, (参照26-07-17).
2. ^ クエリパラメータ - FastAPI. https://fastapi.tiangolo.com/ja/tutorial/query-params/, (参照26-07-17).
3. ^ カスタムレスポンス(HTMLResponse) - FastAPI. https://fastapi.tiangolo.com/ja/advanced/custom-response/, (参照26-07-17).
4. ^ Uvicorn公式ドキュメント. https://www.uvicorn.org/, (参照26-07-17).

※内容は執筆時点のものです。ライブラリやサイトの仕様は変わる可能性があるため、公式ドキュメントもあわせてご確認ください。

ITやプログラミングに関するコラム

• 
  【CSS】notで複数の件を除外する方法
• 
  【Git】remote設定を変更する方法
• 
  【VBA】コメントアウトを設定する方法
• 
  x86とx64の違いを分かりやすく解説
• 
  マークダウンで改行する方法
• 
  CapsLockキーを解除する方法
• 
  GitLabとGitHubの違いを解説
• 
  Linuxで環境変数を確認する方法
• 
  UbuntuのIPアドレスを確認する方法
• 
  パソコンのメモリの目安を用途別に選ぶ方法

ITやプログラミングに関するニュース

• 
  VercelがAI GatewayにSeedream 5.0 Proを追加、AI SDKのモデル指定で画像生成と編集が可能に
• 
  AWSがAmazon LocationのPlaces APIを強化、住所表記の指定と移動手段別の検索が可能に
• 
  VercelがトレースにTree・Waterfallビューを追加、ログ画面で処理の階層と所要時間を確認可能に
• 
  Googleがエージェント評価の再考を提唱、難易度を情報量で測るDiscovery Benchを解説
• 
  Google CloudがCloud Runサンドボックスを公開プレビューで提供、サービスヘルスは一般提供に
• 
  Google Cloud EMEAが英国金融の重要第三者に指定、イングランド銀行・PRA・FCAの直接監督下に
• 
  AWS DMS Schema ConversionがSQL Serverのオフライン変換に対応、ソースDBへ接続せずスキーマを変換可能に
• 
  EC2 G7インスタンスが米国東部（バージニア北部）で利用可能に、G6比でAI推論性能が最大4.6倍
• 
  SageMaker HyperPodが継続プロビジョニングでのAMIベース構成に対応、S3のスクリプト管理なしでSlurmクラスターを作成可能に
• 
  AWSがEMR on EKSでSparkトラブルシューティングエージェントに対応、失敗ジョブの原因分析を自然言語で依頼可能に