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

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層は意識しなくてよい。境界を文書化し、守られない規約にならないようレビューで適用した。

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

---

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

<https://engineer.company/ja/portfolio/a-maritime-platform-built-in-clean-layers/>
