tax-assistant: クライアント切替機能の設計

複数クライアントのDBを運用し始めたことで、UIからのクライアント切替が必要になった。以前作っておいた計画書をベースに、Planエージェントで詳細設計を行い、Codex（GPT-5.3）にレビューしてもらった。

背景

tax-assistantは、クライアントごとにSQLiteのDBファイルを分離する設計になっている。これまではclient_001だけで開発していたが、client_003を追加した時点で「UIにクライアント切替がない」という問題が表面化した。

ヘッダー左上に「サンプル美容室」とハードコードされたバッジがあり、ここをクライアント切替のエントリーポイントにするのが自然な流れだった。

2026-01-27に作成していた client-switcher-plan.md を引っ張り出してきた。ステータスは pending のまま。

計画書の想定と現在の実装を突き合わせると、DBパスの動的解決やclientsテーブルの構造など、すでに実装済みの部分がそこそこあった。一方で、APIレイヤーのクライアント切替エンドポイントやフロントエンドのUI部分は手つかずだった。

この差分を踏まえて、計画を現状に合わせて更新する方針にした。

Claude CodeのPlanエージェントモードで、関連ファイルを一通り確認してから計画を策定した。確認したのは以下のあたり。

計画を10タスクに分割した。バックエンドとフロントエンドで並行して進められる構成にしている。

Task	内容
1	クライアント切替APIの実装（`/api/client/switch`）
2	現在のクライアント情報を返すエンドポイント
3	クライアント一覧API
4	DB接続のクライアントID動的切替
5	セッション管理（どのクライアントが選択されているか）
6	`/api/client/profile` エンドポイント（Codexレビューで追加）

Task 10はE2Eテスト。

計画を memo/2026-02-12/ に保存してからCodexにレビューを依頼した。最初はプランモードのファイルパス（~/.claude/plans/）がプロジェクト外だったため失敗したが、memo側にコピーしてから再実行した。

主な指摘と対応をまとめる。

1. セキュリティ対策（Critical）

Task 1に以下の3点を追加した。

クライアントIDはそのままDBファイルパスの構築に使うため、ここの入力検証は確かに重要だった。

2. /api/client/profile エンドポイント

クライアントの表示名や事業形態など、UI表示に必要な情報を返す専用エンドポイント。元の計画にはなかったが、ヘッダーのバッジ表示にはこれが要る。Task 6として追加した。

3. 遅延初期化

クライアント切替時にDB接続を即座に切り替えるのではなく、次のAPI呼び出し時に初期化する方式。不要な接続を避けられる。

4. テスト計画の強化

E2Eテストに加えて、セキュリティ系のユニットテスト（不正なclient_idのバリデーション等）を追加する指摘。Task 10のスコープを拡張した。

残りの3件は軽微な改善提案で、命名規則の統一やエラーメッセージのフォーマットに関するものだった。

最終的に以下の2箇所に計画を保存した。

codex_review_countフィールドを付与して、レビュー済みであることを明示している。