システムの境界を明確にした海事プラットフォーム
Next.jsのPWAフロントエンド、Go(Huma/Fiber)API、PostgreSQL関数層を分離し、業務ロジックをすべてデータベースに置く、多層の海事プラットフォームを設計した。
実施時期: 2025
リクエストがデータベースに届くまで
リクエスト経路の実装概要です。成果と測定条件は事例本文に記載しています。
フロントエンドからのリクエスト
海事システムのフロントエンドが構造化データを要求し、返されたJSONを表示します。
Go API
Go APIがルーティング、リクエストの検証、セキュリティ、データベース呼び出しを担います。
PostgreSQLによるJSON生成
データベース関数が完全なJSONを生成し、APIがそのまま返します。
3つの明確な層からなる海事プラットフォーム
状況. NextMarinerは、専門家の交流、企業レビュー、教育支援を扱う海事プラットフォームである。創業者の設計面の貢献は、2025年11月に始まるNextMarinerでの業務に記録されている。記録は後の雇用期間を区別しておらず、製品全体をEngineer ApSが提供したと実証するものでもない。
課題. 設計者として、各種ロジックをどこに置くかを初めに決め、急いだときに曖昧になるのではなく、圧力のもとでも保てる明白な境界を設ける必要があった。
行動. それぞれ1つの仕事を持つ3層へ整理した。Next.jsは表示と操作だけを担当する。Fiber上のHumaによるGo APIは意図的に薄くし、経路制御、リクエスト検証、セキュリティフィルター、処理調整だけを行い、業務ロジックを持たせない。業務ロジックはすべてPostgreSQL関数に置き、完成した結果を組み立ててAPIへ返し、そのまま転送する。ルール変更はSQLの1層だけで済み、他の2層は意識しなくてよい。境界を文書化し、守られない規約にならないようレビューで適用した。
結果. 実装した構成は、表示、リクエスト処理、業務ルールに別々の責任を与えている。情報源はその分離と理由を記録しており、提供速度、信頼性、事業成果の測定済みの改善を実証するものではない。

写真: mherfurt / Pixabay 
写真: atti69 / Pixabay
次に読む: PostgresからAPIへのJSONパススルーを設計. すべての実績はこちら: 実績紹介.
お客様には「システムの境界を明確にした海事プラットフォーム」という事例として紹介しています — 他の事例とあわせて見る.

