Technical documents
技術文書
実装の背景にある考え方、AIやクラウドの使い方、開発プロセスの整理を、読み物として残していきます。
75件の技術文書10〜18件目を表示

API設計 / OpenAPI約15分2026年7月5日
OpenAPIを手書きせず、実装から自動生成する設計
複数のHonoバックエンドでAPI仕様の手書き管理をやめ、実装に近い場所からOpenAPIを自動生成し、統合ビューへ集約する設計判断を整理します。
詳細を読む
AI開発 / RAG約10分2026年7月5日
RAG基盤でAIプロバイダを差し替え可能にする設計
OpenAI APIやGeminiを利用するRAG基盤で、生成、埋め込み、リランキングの責務を分け、AIプロバイダ変更に耐える境界設計を整理します。
詳細を読む
AI開発 / 品質評価約10分2026年7月5日
RAGの品質を継続的に見る評価データセット設計
RAGの回答品質を一度の目視確認で終わらせず、質問セット、期待引用、失敗分類、回帰検知を使って継続的に評価する方法を整理します。
詳細を読む
API設計 / RAG約10分2026年7月5日
FastAPIとPostgreSQLで作るRAG APIの責務分離
FastAPI、PostgreSQL、ベクトル検索を使うRAG APIで、取り込み、検索、回答生成、監査ログを分ける設計を整理します。
詳細を読む
アーキテクチャ / BFF約10分2026年7月5日
React RouterとHonoでBFF境界を作る実装設計
React Routerの画面実装とHono APIを組み合わせる構成で、BFF、認証、型、エラー処理の境界をどこに置くかを整理します。
詳細を読む
認証 / 権限設計約10分2026年7月5日
OAuthログイン後のセッション境界と権限設計
Google OAuthなどの外部ログインを使う業務アプリで、認証、セッション、組織所属、権限判定を分けて設計する考え方を整理します。
詳細を読む
データ設計 / マイグレーション約10分2026年7月5日
DrizzleとPostgreSQLで進めるスキーマ変更の設計
Drizzle ORMとPostgreSQLを使う業務アプリで、型安全な実装と段階的なマイグレーションを両立する考え方を整理します。
詳細を読む
クラウド / Cloud Run約10分2026年7月5日
Cloud Runでサービスを分ける時の境界設計
Cloud Run上でフロントエンド、API、ジョブを分ける構成において、責務、デプロイ、環境変数、監視の境界を整理します。
詳細を読む
データ連携 / Google Sheets約10分2026年7月5日
Google Sheets取り込みで壊れにくい検証設計
Google Sheetsを業務データの入力元にする時、列揺れ、型変換、差分検出、エラーレポートをどう設計するかを整理します。
詳細を読む