Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Статичний каталог на Python і JavaScript: як порівнювати дані без хибних результатів

2026年10月15日に「Dev.to」が公開したITニュース「Статичний каталог на Python і JavaScript: як порівнювати дані без хибних результатів」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

PythonとJSで作る静的カタログで、データを正確に比較する工夫を紹介。サービス、プログラム、都市での提供可否を分けて重複を避け、未知の価格は0とせず、範囲検索は重なりを考慮する。生成HTMLの最終チェックも重要で、正確なデータモデル構築が信頼性の鍵だ。

ITニュース解説

Webサイトやアプリケーションを開発する際、特に商品やサービスを比較する「カタログ」のようなシステムを作る場合、ただ情報を表示するだけでなく、ユーザーが求めている情報を正確に、そして信頼できる形で提供することが非常に重要だ。システムエンジニアを目指す皆さんにとって、これはデータ処理の基本であり、サービスの信頼性を左右する重要なスキルとなる。今回は、PythonとJavaScriptを使って静的なカタログを作成する際に、データの比較で誤った結果を出さずに、正確な情報を提供するための具体的なアプローチを見ていこう。

静的なカタログとは、ウェブサーバー上で動的にデータベースにアクセスしてページを生成するのではなく、あらかじめ生成されたHTMLファイルをユーザーに提供する形式のサイトのことだ。これにより、ページの表示速度が速く、サーバー負荷も低減されるというメリットがある。しかし、単にページを高速に表示するだけでは不十分で、ユーザーが情報を検索・比較する際に、データが正しく扱われることが必須となる。

ウクライナの「Racioteka」というサービス比較カタログを例に、具体的な解決策を探っていく。Raciotekaでは、基本的なページはPythonでテーブルデータから生成され、ユーザーが利用するフィルター機能はJavaScriptで実装されている。

まず、最も基本的な点のひとつに、データの「エンティティ」を適切に分離するという考え方がある。Raciotekaのカタログには、「サービス」「プログラム」「可用性」という三つの異なる種類の情報がある。「サービス」とは、食事の宅配を提供する会社そのもの。「プログラム」はその会社が提供する具体的な食事プラン(例:ダイエットプログラム、高タンパクプログラムなど)。そして「可用性」は、そのプログラムがどの都市で、どのような条件で利用できるか、という情報だ。

なぜこのように細かく分ける必要があるのか。たとえば、ある一つの食事プログラムが二つの異なる都市で提供されている場合を考えてみよう。これは「二つの都市での提供」としては数えられるが、「プログラムの種類」としては一つとして数えるべきだ。もしこれらを混同してしまうと、フィルターでプログラムを検索する際に誤った結果が表示されたり、カタログのヘッダーなどで「全X種類のプログラム」といった形で集計する際に、実際の数よりも多くカウントされてしまう可能性がある。Raciotekaでは、サービス、プログラム、都市ごとの提供情報、配送情報といったデータを別々のCSVファイルで管理し、PythonでHTMLを生成している。これにより、HTMLの基本的な表示にはJavaScriptの実行は不要となり、高速な表示を実現している。

次に、データの「欠損値」をどう扱うか、という問題がある。特に価格情報のような数値データの場合、この扱いは非常に重要だ。JavaScriptでは、空文字列("")をNumber()関数で数値に変換しようとすると、結果が0になってしまうという特性がある。もし、価格が未入力のフィールドをそのまま数値変換してしまうと、その商品は「価格が0」つまり「無料」と誤って認識され、ユーザーが「最も安い商品」を検索した際に、本来価格不明であるはずの商品が検索結果に含まれてしまう、といった問題が発生する可能性がある。

これを避けるためには、価格フィールドの値が存在するかどうかを、数値に変換する前に必ず確認する必要がある。Raciotekaでは、以下のようなロジックを使っている。まず、カード要素から価格データを取り出し、それがundefined(未定義)であるか、あるいは空文字列であるかをチェックする。もしそうであれば、その価格はnull(不明)として扱う。その後、取得した値が有効な数値であるかをNumber.isFinite()で確認し、有効な数値であればそれを返し、そうでなければやはりnullを返す。このようにすることで、価格が不明な商品は「無料」として扱われることなく、ユーザーが設定した予算のフィルターからも正しく除外される。これは、その商品が高いという意味ではなく、単に比較に必要な情報が不足している、という状態を正しく表現しているのだ。

また、プログラムのカロリー量のように「範囲」で指定されるデータを扱う場合、単純な一致検索では不十分になることがある。たとえば、あるプログラムが「1400〜1600kcal」の範囲であるのに対し、ユーザーが「1500〜1700kcal」の範囲で探しているとしよう。この場合、両者のカロリー範囲は重なっているため、このプログラムはユーザーの検索結果に含めるべきだ。しかし、単純に「1500kcalが含まれるか」といった一致検索では、これを見逃してしまう。

このような「範囲の重なり」を正確に判定するためには、少し複雑な論理が必要になる。Raciotekaでは、programMin <= selectedMax && programMax >= selectedMinという論理式を使って重なりをチェックしている。これは、「プログラムの最小値が選択された範囲の最大値以下」であり、かつ「プログラムの最大値が選択された範囲の最小値以上」である、という条件を満たす場合に、両方の範囲が重なっていると判断する。この比較を行う前には、もちろん、プログラムとユーザーが選択した両方の範囲の最小値と最大値が、それぞれ既知の有効な値であることを確認する必要がある。これにより、ユーザーは自分の求める条件に合致する、より多くの選択肢を発見できるようになる。

最後に、システムエンジニアとして非常に重要となるのが「生成結果の検証」だ。静的サイトジェネレーターを使って大量のHTMLページを生成する場合、テンプレートに一つのミスがあると、それが多数のページに一斉に反映されてしまう可能性がある。これを防ぐためには、サイトを公開する前に、生成されたHTMLが期待通りになっているかを自動的にチェックする仕組みが不可欠だ。

Raciotekaのプロジェクトでは、H1タグの数、canonicalタグ(SEOに重要なページの正規URLを示すタグ)、インデックスポリシー(検索エンジンがページをクロールするかどうか)、ローカルリンクの有効性、必要なリソース(画像やCSSファイルなど)の存在、期待される特定のページが生成されているか、といった多岐にわたる項目を検証している。さらに、プログラムの価格が「0より大きい」ことを確認するような具体的なビジネスロジックに関するチェックも行っている。このような自動化された検証プロセスは、構造的なエラーや基本的な機能に関する間違いを早期に発見し、修正するために非常に有効だ。もちろん、これらのチェックだけでは、商品の価格や配送条件が「最新の情報であるか」までは保証できないため、その点は別途、情報源との照合が必要になることを忘れてはならない。

これらの学びを自分のカタログ作成に活かすには、まず堅牢な「データモデル」を設計することから始めるべきだ。どのような情報があり、それがどのように関連し合うのかを明確にし、欠損値があった場合にどう扱うかのルールを定める。次に、カロリー範囲のような「範囲データ」の扱いや、正確な「集計」の方法を考える。これらがしっかり固まってから、実際に商品カードやフィルターのインターフェースを作り込んでいくのが、信頼性の高いシステムを構築するための順序となるだろう。

実際に自分でカタログを作ってみる際は、「価格のない商品」「部分的に重なる範囲の商品」「一つのプログラムが複数の都市で提供されているケース」という三つのシナリオで、システムが期待通りの、そして直感的に理解できる結果を返すかを確認してみよう。もしこれらのテストケースで納得のいく結果が得られれば、あなたの製品は、ユーザーに対して正直で公平な情報を提供する、強力な基盤を持っていると言えるだろう。

関連コンテンツ

関連IT用語