WAN NYAN CLINIC

🐱 TypeScriptで学ぶ関数型ドメインモデリング

ようこそ
WAN NYAN
OSへ!!

動物病院の予約・カルテ管理システムを題材に、業務ルールを型と関数で表現する教材です。既存のコードを順に改善しながら、設計の理由を学びます。個人学習にもハンズオンにも使えます。

WAN NYAN OS / Reservation & Chart

今日の診察

画面例
09:20ポチ / ワクチン

受付済み。診察室 1 への案内待ち。体重測定済み。

09:40ミケ / 皮膚相談

予約済み。飼い主アプリから問診票を受信した。

10:10もも / 再診

診察中。体重と食欲メモをカルテに反映。

カルテ #AC-2408

ミケ / 3歳 / メス避妊済み。主訴は耳まわりのかゆみと皮膚の赤み。

予約済み来院済み診察中会計済み
注意アレルギー歴: ペニシリン系は要確認
バイタル体重 4.2kg / 体温 38.4℃ / 食欲あり
検査皮膚スタンプ検査を実施予定
処方外用薬 7日分。再診は 2週間後
会計診察料 + 検査料で見積り作成
下にスクロールして、WAN NYAN OS の機能と、運用中に発生し始めた問題を確認します。

WAN NYAN OSでできること

最初は便利でした。予約から会計までがつながり、スタッフは画面を切り替えながら動物たちの来院に対応できるようになりました。

予約管理来院予定、問診、受付状況をひとつの画面で確認。
カルテ診察メモ、バイタル、処方、注意事項を記録。
待合室受付済み、問診済み、診察中の患者を一覧で表示。
会計診察料、検査料、処方料をまとめて会計。
フォロー連絡検査後に連絡が必要な飼い主を抽出。
連絡先管理飼い主の電話番号やメールアドレスを管理。
申し送りスタッフ間で注意事項や次回対応を共有。

ところが、問題が増えてきました

便利になった分だけ、要求も増えました。小さな改修を重ねるうちに、どの状態でどの操作を許可するのか、どの情報を外部へ出力してよいのかが不明確になっています。

🐕 現状と事故を対応付ける業務の流れ、画面操作、保存先、ログを確認し、二重請求と、監査記録で個人情報を閲覧できる問題の発生箇所を確認します。
🐇 許可されない状態遷移会計済み・キャンセルの予約を遷移関数へ渡すコードの誤りを、状態と遷移の型で実行前に検出します。
🦔 状態の分岐漏れ予約の状態を追加したときに、表示名などの分岐の修正漏れを、コンパイルエラーで防止します。
🐦 未検証の外部入力HTTPから受け取った値をZodで検証し、値の制約を型で表した診察開始の入力へ変換します。監査記録に個人情報を含めない形にします。
🐹 ユースケースの予期できる失敗throw と undefined で表している業務上の失敗を、呼び出し側が扱える結果へ変換します。
🐈 予約キャンセルを設計する予約のデータから始め、キャンセルを工程に分けて失敗の流れを捉え、I/Oの分離を確認します。工程の条件を守る仕組みも選びます。
🐢 出力イベントと副作用時刻や保存処理を外部から渡し、状態と監査記録を同じ整合性境界で保存します。