計算ツールの数字はどう検証しているか — 1,049項目を照合した記録

検証は3段構えにしている

① 早見表はツールと同じ式から自動生成する

各ページに載せている「早見表」(数値の一覧表)は、手で数字を打ち込んでいません。ツール本体とまったく同じ計算式を使う生成プログラムが表を作ります。手作業の転記を挟まないので、「表とツールで数字が違う」という事故が構造上起きません。逆に言えば、式そのものが間違っていれば表も一緒に間違うので、これだけでは不十分です(後述の失敗③がまさにそれでした)。

② 別の言語でもう一度実装して突き合わせる

手取り計算のような制度依存の計算は、同じ仕様を別のプログラミング言語でゼロから書き直し、結果が一致するかを確認しています。たとえば額面200万円の手取りが両方の実装で1,637,520円と一致するか、といった照合です。同じ人が書いても、実装が2系統あると「片方だけの書き間違い」はあぶり出せます。

③ 実際のブラウザでツールを操作して、表と1セルずつ照合する

最後に、自動操作のブラウザで実際に各ツールへ数値を入力し、画面に出た結果と早見表の全セルを1つずつ突き合わせるテストを全ページに対して実行します。直近の実行では1,049項目を照合し、すべて一致した状態で公開しています。

実際に見つかった不具合の記録

失敗①: 人生時計の早見表の列がずれていた。ブラウザ照合テストを導入した初回、人生時計のページだけ17項目が不一致になりました。原因は、ツールの初期設定(人生84年)と早見表の列の並び(81年が先頭)が食い違っていたこと。表の列順を直して解消しましたが、「生成は正しくても、見せ方の並びで実質的に間違いになる」ことを学びました。

失敗②: ツールと表で説明の文言が違っていた。院試スケジューラーの早見表に書いた注記と、ツール本体の表示文言が微妙に違っていた(「＋出願の余裕分」と「+出願余裕分」)のを、照合テストが検出しました。数値だけでなく文言も照合対象にしていたおかげです。

失敗③: 式の前提そのものが公式と違っていた(最重要)。TOEIC・TOEFL CEFR比較のページで、採用していた区分が公式の対照表より1段甘く、TOEIC L&Rに存在しないC2を割り当てていました。①〜③の検証は「実装同士の一致」を確かめる仕組みなので、おおもとの前提が間違っていると検出できません。これは公開後の監査で発覚し、IIBC・ETSの公式資料と照合して修正しました。何をどう間違え、どう直したかは、運営の実記録TOEIC・TOEFLの比較表を公開後に作り直した話に日付つきで残しています。

2026年9月の総点検 — 「正しいか」ではなく「一致しているか」を調べた

2026年9月、サイトを院試向けに改修するのに合わせて、全ページを対象に「数字が正しいか」ではなく「数字が一致しているか」を調べる総点検をやりました。手順は3つです。①早見表とツールの突き合わせ——各ページの早見表の数値を、そのページのツールの計算処理に同じ入力を与えた結果と1セルずつ照合する。②可視文と構造化データの一致チェック——FAQの見えている文章と、ページに埋め込むFAQPage構造化データの文章が同じかを機械的に比べる。③実機レンダリング——幅400pxのブラウザで全ページを実際に開き、横スクロールが起きないか・JavaScriptのエラーが出ないかを確認する。この点検で、計算は正しいのに「書いてあることが食い違っている」箇所が2つ見つかりました。

食い違い①: 費用シミュレータのFAQと早見表で金額が違った。院試費用シミュレータのFAQは「併願2〜3校で10万円前後」と書いていましたが、同じページの早見表は、同じ前提(検定料30,000円×校数、TOEIC受験料4回分31,240円、教材費15,000円、交通費20,000円)で2校126,240円〜、3校156,240円〜を示していました。「10万円前後」は早見表を作る前の古い概算が、FAQにだけ残っていたものです。FAQを早見表と同じ計算の数字(2校で約13〜15万円、3校で約16〜19万円)に書き直しました。

食い違い②: TOEICの開催頻度が公式日程と合っていなかった。複数のページに「TOEIC公開テストは月1回」という前提の記述がありましたが、IIBCが公表している2026年度の公開テスト日程は年18回で、月2回実施される月が6つ(5・6・9・12・1・3月)あります。「月1回」を前提にした文章は受験機会を実際より少なく見積もらせるので、該当する記述を全ページから洗い出し、「月1〜2回(2026年度は年18回)」に修正しました。

2件に共通する原因は、計算の誤りではなく「同じ事実が2か所に別々に書かれていて、片方だけが更新された」ことです。冒頭の3段構えの検証は「実装と表の一致」を守る仕組みなので、文章どうし・ページどうしの食い違いは、この総点検のような横断チェックでないと見つかりません。

2026年9月15日の追記: 検証の対象に「表示される文字列」を足した。全ページのtitle(検索結果に出る見出し)を全角換算(半角英数は0.5字)で数え直したところ、日本語の検索結果で表示される目安の全角28〜32字を超えていて、末尾が検索結果に一度も出ていないページが多数ありました。このページ自身のtitleも全角39.0字で、後半の「記録と見つかった不具合」は表示されていませんでした。検索される語を前半に置き、括弧が途中で切れない位置で止めて、全角28字前後に詰め直しています。数字が一致しているかと同じように、読者に実際に届いている文字列も点検の対象にしました。

2026年10月23日の追記: 手取り計算などのツールは公開を終えました。2026年10月に、院試と関係の薄い汎用の計算ツール（手取り計算を含む17個）の公開を終えています。上の②は、当時の手取り計算ツールで行っていた照合の例です。1,049項目は、2026年9月時点の全ページでの照合数です。

この経験からの運用ルール

失敗③を受けて、制度や公的数値に依存するページには「計算条件・参照情報」欄(採用した式・数値・前提・対象外・最終確認日・公式一次情報へのリンク)を置くことにしました。実装の内部整合は自動テストで守り、前提の正しさは公式一次情報との照合と、読者からの指摘で守る。誤りに気づいた方がお問い合わせから指摘でき、修正が更新履歴に残る——この循環まで含めて検証だと考えています。2026年9月の総点検からは、同じ事実をページ内の複数の場所に書くこと自体を減らす「1ページ1ソース」のルールも加えました(決めた経緯は比較表を作り直した話の続報に書いています)。