課題
信頼性はスクリーンショットだけでは判断できません。小規模 SaaS の妥当性を検証できるよう、境界、障害時の挙動、運用制御を公開する必要がありました。
担当
公開 UI、API 契約、永続化モデル、ワーカーフロー、デプロイ計画、検証スイートを設計・実装しました。
制約
低コスト、ローカル再現性、明確な認証境界、シークレットをコミットしないデプロイが制約でした。
主要な判断
Hono で API を小さく保ち、PostgreSQL が永続状態を管理し、Redis と BullMQ が非同期チェックを分離し、Nginx が `/demo/` の公開名前空間を維持します。
アーキテクチャ
リクエストは API キー境界を通過してからワークスペース単位の資源へ到達します。ジョブはキューに入り、ワーカーが検査を実行し、ヘルスエンドポイントは生存性と依存関係の準備状態を分けて示します。
エンジニアリング証拠
ライブコンソール、顧客画面、OpenAPI、ヘルスプローブ、テスト、ADR、デプロイ Runbook、公開面検証が証拠を構成します。
結果
架空の利用指標に頼らず、製品挙動から API と運用証拠まで追跡できるポートフォリオシステムになりました。
制限と次の段階
これはポートフォリオ規模のデプロイです。負荷試験、マルチリージョンのフェイルオーバー、本番通知配信は現在の証拠範囲外です。