壊れやすいシステムを育てる

はじめに

ストーリー

危うく素朴に実装された動物病院の予約・カルテ管理アプリの開発・運用を任されたあなた。

しかし、次々と要件が増えていき、プロダクトはさらに複雑になっていきます。

それぞれの要件をそのまま素朴にAIエージェントへ任せると、思わぬ破綻が生じることでしょう。

章ごとに設計のヒントを得ながら、堅牢で変更容易性の高いサーバアプリケーションの作り方を学んでいきます。

ゴール

このシリーズは、他言語（Java / Go / Elixir など）の経験を持ちながら、サーバサイドTypeScriptの本番環境レベルでの実践に不安を持つエンジニアに向けて執筆しています。

完走することで、業務レベルで要求されるサーバアプリケーションの設計スキルが身につくことでしょう。

• Discriminated Union による状態モデリング
• Result 型と Railway Oriented Programming
• スキーマライブラリによる境界防御
• Sensitive 型による機微情報保護

本書の特徴

リファクタしながら学べる

最初から完成された設計を写経するのではなく、現場の実務のように開発とリファクタを繰り返しながら学習できます。

危うくて素朴な実装に対して、新たな要件に対応しながら設計を改善していくことで、それぞれの設計パターンをどのようなシーンで適用するべきか、身をもって体験できます。

エージェント時代の文脈

各章の冒頭で、同じ要件を素朴な指示でAIエージェントに依頼するとどう実装されがちか例示します。

これにより、私たちが設計の原則を理解せずにエージェントへ依頼することでどのような結果をもたらすか体感できます。

題材について

動物病院の予約・カルテ管理アプリを題材に選んだ理由は次のとおりです。

状態遷移の重要性

動物病院には予約 → 受付 → 診察 → 会計、そしてキャンセルという複雑な状態遷移があります。

これらの状態遷移が誤った方向へ進んでしまった場合の業務影響は大きい一方で、状態ごとに必要なプロパティが大きく違います。

高いデータ要件

検査機関 API からの結果取り込み、ペット ID と飼い主 ID の取り違え、診断名・処置内容といった機微情報のログ流出など、データの取り扱いに慎重さが求められるサービスです。

進め方

各章は次のように進行します。

1. 新たな要件
2. 素朴にエージェントに依頼してみる
3. 発生する問題を認識する
4. リファクタと要件対応を進める

なお、章ごとに 20〜30分程度の読了時間を想定しています。

執筆状況

本書は現在執筆中です。各章の本文は順次公開予定です。