KUMYU / SYSTEM DESIGN

図で学ぶシステムデザイン

AIシステムの構成、失敗時の動き、設計の選び方を、図解から詳しく学ぶアーキテクチャリファレンス。

学習と設計検討のための概念的な構成例です。稼働中のKumyuの実装を表す図ではありません。

学ぶ順序を決める

基礎を押さえ、チャットの1リクエストを追うところから始めます。次に非同期処理、メモリ、ツールを加え、信頼境界と負荷の制御を学びます。最後に検索、リアルタイム通信、音声へ進みましょう。

全体像：10のテーマを一つの流れで見る

クライアントから入口へ、生成処理から配信へと矢印を追ってください。メモリとRAGは情報の参照先、非同期処理は実行を継続する仕組み、ガードレールは各操作の境界として読みます。詳しい仕組みは下の各章へ進めます。

性能、状態、権限、障害を手掛かりに、システムの分け方を考えます。

会話、生成処理、配信を分け、再接続とキャンセルの競合を設計する。

outbox、冪等性、リース、再試行から非同期ジョブを組み立てる。

会話DB、モデルの文脈、要約、検索索引、キャッシュの責任を分ける。

型検証、認可、冪等性、照合から外部操作の境界を設計する。

入力・出力・ツールを別々に検査し、サーバーの認可と実行直前の承認で危険な操作を制御する。

入口での認証・経路制御から、分散レート制限、生成予算の予約と精算、再試行の増幅までを設計する。

取り込み、チャンク、版とACL、ハイブリッド検索、再順位付け、引用、検索と生成の評価を一つの流れで理解する。

SSE、fetch streaming、WebSocketを比較し、切断から復帰できる画面を設計する。

音声処理の二つの構成、WebRTC、割り込み、遅延、権限を一つの流れで学ぶ。