📋 開発記録

オリジン

Dr. Tim HackettのCRI計算Excelワークシート(松葉洋宗先生・小宮山典寛先生による日本語版)を臨床で使い込んだことが起点。気づけば個人備忘録として50枚超のExcelシートを運用していた。CRI計算・薬用量・栄養計算・体表面積など、臨床で繰り返し必要になる計算を手元に集積していった結果だった。

Pythonでの再現を試みたが学習コストの壁に当たり、AIとのバイブコーディングによる開発へ転換。「タダで使わせてもらった恩返し」としてOSS・無料公開を選択した。

開発を通じて確立したスタイルは、Claude・ChatGPT・Geminiを用途で使い分けるAIペアプログラミングだった。Claudeは構造分析と論理チェック、ChatGPTは検証と調整、Geminiは積極的な実装という役割分担が自然と定着していった。

開発変遷

v1.0.0 — 2026-02-04 / 初期リリース

Excelシートをそのままの発想でWebアプリ化。犬・猫の基本薬用量計算ロジック(体重 × 用量 ÷ 濃度)を実装した最初の形。Dr. Tim HackettのCRI計算ワークシートがベースになっている。

v2.0.0 — 2026-02-25 / ローカルWebアプリ基盤確立

単一HTMLとして基本構造を確立。この時点でVetCalc PROの骨格が決まった。用量範囲・濃度のユーザー編集機能、localStorageを使ったデータバックアップ・インポート機能を実装。「Excelの代替」から「独立したWebツール」へ脱皮した段階。

v4.0.0〜v4.3.0 — 2026-02-26 / UI基盤と表示カスタマイズ

注射薬・内服薬・外用薬の3モード切り替えUIを確立。動物種ごとに前回体重を記憶する機能、フォントサイズ・カードサイズの表示カスタマイズ機能を実装。

v4.4.0 — 2026-02-26 / プロトコルセット機能

特定シチュエーションで用いる複数薬剤をグループ化し一括計算するプロトコルセット機能を追加。麻酔導入・CPR・ウサギ麻酔(BMK)等を収録。

v4.6.0 — 2026-03-01 / エキゾチック動物対応・211剤へ

エキゾチック動物(ウサギ・フェレット・モルモット・ハリネズミ・ハムスター)の用量データを追加し収録薬剤数211剤へ拡張。「アレルギー・皮膚科」カテゴリ新設と看護師向けNurseモードも追加。

v4.7.0 — 2026-03-01 / 投与経路の配列対応

注射と経口で異なる用量を持つ薬剤データのタブ切り替えに正式対応。

v4.9.0〜v4.9.7 — 2026-03-03〜03-04 / 情報アクセス強化

PMDAおよびNVALの公式添付文書への直リンク機能を追加。詳細画面のフルスクリーン化、カラーテーマ実装(10通り)、薬剤追加UIの刷新など、使い勝手を磨いた。

v5.1.0 — 2026-03-06 / 薬剤ID・検索システム導入

薬剤ID管理と検索機能を導入。薬剤データベース化への転換点。

v5.2.0 — 2026-03-06 / データ分離の検証

単一HTMLの肥大化対策として外部ファイル参照形式への移行を一時検証。この時点では見送り。

v5.3.0 — 2026-03-08 / 鑑別診断(DDx)モジュール

115症状・11カテゴリの鑑別診断リスト(出典: JBVP 2017)を実装。

v5.4.0〜v5.5.0 — 2026-03-10 / VetCalc Diet実装

安静時RER・病態別DERの自動計算、ホームメイド食レシピの栄養素計算、市販療法食とのブレンド比率計算を実装。v5.5.0でBCSから理想体重を推定してRERを補正する機能を追加。Excelシートで長年手計算していた内容の移植。

v5.6.0 — 2026-03-14 / BSA計算統合

Meehの式によるBSA(体表面積)計算と化学療法剤用量換算テーブルを統合。

v5.7.0〜v5.11.0 — 2026-03-20〜03-21 / 計算モードの大幅拡張

計算モードタブを新設し、臨床で頻用する計算ツールを集中実装した時期。血漿浸透圧・K/P補正・輸液量計算・チョコレート中毒リスク判定を追加(v5.7〜v5.10)。v5.11では輸血/アルブミン計算を追加。Excelシートの移植がほぼ完了した。

v5.12.0 — 2026-03-21 / 輸血・アルブミン計算ツール

目標PCV / ALB値から必要輸血量(mL)とアルブミン量(g)を算出する機能を追加。

v5.13.0〜v5.14.0 — 2026-03-22 / 別名検索対応

薬剤データに商品名・略称などの別名(エイリアス)検索を対応。新規エントリ用領域をdrug_275〜315に確保。

v5.16.0 — 2026-03-24 / CRI機能統合・テンシロンテスト追加

独立していたCRI計算機能を本体モジュールとして統合。バッグ調製・投与速度計算・フェンタニル・プロポフォール等を強化。ガンマ計算など集中治療向け機能を追加。テンシロンテスト(エドロホニウム+アトロピン必要量算出)と点眼瓶投薬計算も加わり、Excelシートの移植が完了した。

v5.19.0〜v5.20.0 — 2026-03-26 / 療法食DB本格整備

ロイヤルカナン・ヒルズ・ペットラインなど計220製品のカロリー・保証分析値をデータベース化(VetCalc Diet拡充)。犬/猫フィルタと疾患カテゴリフィルタを実装した療法食パネルを追加。

v5.22.0 — 2026-04-05 / 計算モジュール追加

MLK CRI・エピネフリンCRI・PPN(末梢静脈栄養)計算、慢性腸症スコア(CCECAI/CIBDAI)、妊娠診断(交配日からのエコー・X線診断可能日・分娩予定日算出)、年齢換算テーブルを追加。点眼瓶投薬計算(体重入力による各薬剤の滴数早見表)も実装。

v5.27.0 — 2026-05-01 / 中毒DB拡充・UIアコーディオン化

ユリ(猫)・キシリトール(犬)・ぶどうなど8物質を追加し計25物質へ拡充。アコーディオン式UIで催吐・胃洗浄等の処置可否をアイコン表示に変更。

v5.30.0 — 2026-05-02 / 錠剤分割・必要錠数計算

1回量・処方日数から総錠数を逆算する機能を追加(μg錠対応)。

v5.32.0 — 2026-05-10 / 単一HTML版の完成

ファイルサイズ約912KB・約23,000行に達し、単一HTML版としての最終構成とした。次バージョンより分離アーキテクチャへ移行することを決定。

v6.0.0 — 2026-05-30 / GitHub Pages正式公開

GitHub Pagesでの公開を目的として、単一HTMLからUI(HTML/JS)+薬剤データ(JSON)の分離構造へアーキテクチャを移行。この時点でリポジトリが作成され、以降の開発履歴はGitの記録に引き継がれる。PWA対応によりホーム画面追加でネイティブアプリのように起動・オフライン動作を実現。AI検索最適化(GEO対策)としてJSON-LD・llms.txt・about.htmlを追加。

公開後まもなく、App Store知的財産権申立て案件を経験。これを契機としてCHANGELOG整備・Git履歴保存・設計思想の文書化を継続する運用へ移行した。

v6.0.0以降 — 2026-05-30〜 / GitHub公開後の改善履歴(CACHE_NAMEベース)

リポジトリ作成以降の変更はGitの記録に引き継がれる。以下はService Workerのキャッシュバージョン(CACHE_NAME)を実質的なリリースノートとして記録したもの。

CACHE日付内容
v12026-05-30単一HTMLから分離アーキテクチャへの移行初期
v22026-05-31PWA対応・ホーム画面追加・オフライン動作・初回免責同意画面の実装
v32026-06-06Safe Area(ノッチ)対応。PWAフルスクリーン化でiPhoneのノッチに❌ボタンが隠れる問題を解消
v42026-06-06チュートリアル・READMEにOS別「ホーム画面追加方法」とキャッシュクリア案内を追記
v52026-06-06誤操作リスクが高かった「全データをリセット」ボタンを管理メニューから削除
v6〜v82026-06-06チュートリアルをヒントカードに置き換えようとして沼にはまり、「免責同意のみ」のシンプル構成へ回帰(v8で安定)
v92026-06-07プロトコル(犬・猫の鎮静)を追加。体重入力を必ず挟む安全設計に変更
v102026-06-07vimスワップファイル等によるGit混乱状態からコードを復元。強制キャッシュ更新のためにバンプ
v11〜v122026-06-0834件に及ぶ「注射・内服の完全分割」やsourceフィールド修正など、DBの構造的負債を一掃
v132026-06-11SW更新通知のバグ修正・「このブラウザのみに保存されます」警告トーストを追加
v14〜v172026-06-11錠剤分割画面のラベルフォントサイズを15px→22pxへ段階的に拡大
v18〜v192026-06-11体重入力のkg/g表示スパンをラベル内に移動、ボタンが画面端で切れる問題を修正
v20〜v212026-06-11Nurseモードの「±」ボタンサイズを固定し表示崩れを防止
v222026-06-11EOD(隔日投与)等の錠剤計算バグ修正。parseInt→parseFloatに変更し小数対応。臨床的に重要なロジック修正
v23〜v242026-06-15年齢換算UI改善・プロトコル動物種紐付け。Qiita記事執筆期と重なりドキュメント整理中心
v252026-06-23計算カードの並び替えをドラッグ&ドロップ操作に変更
v262026-06-25スマホ狭画面での内服薬モーダル2段組対応
v272026-06-26初回インストール時にcontrollerがnullになる問題を修正し、SW更新判定を即時化
v282026-06-27計算カードUIの全面刷新(2列固定グリッド化・アイコン横並び)。既存ユーザーへ強制反映
v292026-07-09FAQ・AboutページのSEO強化。フッターからの導線追加、FAQ構造化データ(JSON-LD)追加
v302026-07-10フッターに開発記録・GitHub・Licenseリンクを追加
v31〜322026-07-13フッターver-tag重複削除
v332026-07-14慢性腸症スコア 免疫抑制薬 体重入力で計算が走らないバグ修正
v342026-07-14慢性腸症スコア 体重入力フォーカス喪失バグ修正
v352026-07-14慢性腸症スコア 監修者謝辞を追加

試みと断念・委譲

試み結果理由
Python学習挫折学習コストよりAI活用が現実的と判断
Dify連携断念データ管理とUI分離の複雑さ
Google Apps Script断念CacheService 100KB制限でファイルサイズ超過
Docker運用断念GitHub Pagesで十分と判断
英語対応機能スマホに委譲スマホ翻訳で代替可能

Excelオリジン → VCP実装マップ

ExcelシートVCP実装状況
MLK・FLK・フェンタニル・ドパミン等CRI群✅ 全実装
K・P補正・血漿浸透圧・チョコレート中毒✅ 実装
BSA・体表面積✅ 実装
ホームメイド食レシピ・PPN犬猫✅ 実装
輸血・アルブミン量の計算✅ 実装
テンシロンテスト・点眼瓶投薬✅ 実装
英語電話・英会話➡️ スマホに委譲

開発ポリシー

© 2026 Nobutaka Kikuchi — VetCalc PRO