# プラットフォームの基礎技術方針を策定

2025年11月のリポジトリ開設後の数週間に、多層構成、データベース中心のデータアクセス、警告ゼロという基礎方針を定め、9か月後も維持した。

2025

**状況.** リポジトリは2025年11月25日、空の状態で始まった。層の分け方、業務ロジックの置き場、品質基準など、最初の数週間の判断が大きく影響する。3日目には安い判断も、6か月目には後続のすべてが前提にしていて、覆すのがほぼ不可能になる。

**課題.** 他の人や当時よりはるかに大きなコードへ引き継いでも残る形で、基礎方針を早期に、意図的に決める必要があった。

**行動.** 3つの判断が大半を支えた。まず、その日の便利さでロジックを置かず、Next.js画面、検証・転送のGo API、業務ルールを持つPostgreSQL関数の各層に1つずつ役割を与えた。次に、後付けなら全ハンドラーを書き直すことになるため、最初からデータアクセスをストアド関数の背後に置いた。最後に、5,000コミット目なら大規模な修正作業を要する基準も、50コミット目なら通常の進め方になるため、コードが少ないうちから警告ゼロを適用した。どれも当時の簡単な選択ではなく、最初の月の進行速度を犠牲にした。

**結果.** 9か月、数千コミット後にも3つすべてが残った。層は曖昧にならず、ハンドラーはテーブルを直接扱わず、ビルドに警告はない。基礎判断は正しく聞こえたかでなく、その後の作業量に耐えたかで評価すべきだった。便利さだけの選択は、その時点で静かに捨てられることが多いためだった。

---

- 役割: エンジニアリング責任者
- カテゴリー: [プラットフォーム設計](https://engineer.company/ja/categories/platform-architecture/), [ソリューション設計](https://engineer.company/ja/categories/solution-architecture/), [バックエンド開発](https://engineer.company/ja/categories/backend/), [フロントエンド開発](https://engineer.company/ja/categories/frontend/), [フルスタック開発](https://engineer.company/ja/categories/full-stack/), [データベース](https://engineer.company/ja/categories/databases/), [DevOps](https://engineer.company/ja/categories/devops/), [セキュリティ](https://engineer.company/ja/categories/security/), [チームの統率](https://engineer.company/ja/categories/team-leadership/), [技術面の統率](https://engineer.company/ja/categories/technical-leadership/)
- サービス: [プラットフォーム・ソリューション設計](https://engineer.company/ja/services/platform-architecture/), [バックエンド・API開発](https://engineer.company/ja/services/backend-development/), [フロントエンド開発](https://engineer.company/ja/services/frontend-development/), [フルスタックのプロダクト開発](https://engineer.company/ja/services/full-stack-development/), [技術面の統率・コンサルティング](https://engineer.company/ja/services/technical-leadership/)

<https://engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/>
