# システムの境界を明確にした海事プラットフォーム

Next.jsのPWAフロントエンド、Go（Huma/Fiber）API、PostgreSQL関数層を分離し、業務ロジックをすべてデータベースに置く、多層の海事プラットフォームを設計した。

2025

状況. NextMarinerは、専門家の交流、企業レビュー、教育支援を扱う海事プラットフォームである。創業者の設計面の貢献は、2025年11月に始まるNextMarinerでの業務に記録されている。記録は後の雇用期間を区別しておらず、製品全体をEngineer ApSが提供したと実証するものでもない。

課題. 設計者として、各種ロジックをどこに置くかを初めに決め、急いだときに曖昧になるのではなく、圧力のもとでも保てる明白な境界を設ける必要があった。

行動. それぞれ1つの仕事を持つ3層へ整理した。Next.jsは表示と操作だけを担当する。Fiber上のHumaによるGo APIは意図的に薄くし、経路制御、リクエスト検証、セキュリティフィルター、処理調整だけを行い、業務ロジックを持たせない。業務ロジックはすべてPostgreSQL関数に置き、完成した結果を組み立ててAPIへ返し、そのまま転送する。ルール変更はSQLの1層だけで済み、他の2層は意識しなくてよい。境界を文書化し、守られない規約にならないようレビューで適用した。

結果. 実装した構成は、表示、リクエスト処理、業務ルールに別々の責任を与えている。情報源はその分離と理由を記録しており、提供速度、信頼性、事業成果の測定済みの改善を実証するものではない。

役割: プラットフォームアーキテクト
=> /ja/categories/platform-architecture/ カテゴリー: プラットフォーム設計
=> /ja/categories/solution-architecture/ カテゴリー: ソリューション設計
=> /ja/categories/backend/ カテゴリー: バックエンド開発
=> /ja/categories/frontend/ カテゴリー: フロントエンド開発
=> /ja/categories/full-stack/ カテゴリー: フルスタック開発
=> /ja/categories/api/ カテゴリー: API・システム連携
=> /ja/categories/databases/ カテゴリー: データベース
=> /ja/categories/postgresql/ カテゴリー: PostgreSQL
=> /ja/categories/technical-leadership/ カテゴリー: 技術面の統率
=> /ja/services/platform-architecture/ サービス: プラットフォーム・ソリューション設計
=> /ja/services/backend-development/ サービス: バックエンド・API開発
=> /ja/services/frontend-development/ サービス: フロントエンド開発
=> /ja/services/full-stack-development/ サービス: フルスタックのプロダクト開発
=> /ja/services/database-design/ サービス: データベース設計・モデリング

=> https://data.engineer.company/ja/portfolio/a-maritime-platform-built-in-clean-layers/ このページのウェブ版
