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

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

2025

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

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

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

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

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

=> https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/ このページのウェブ版
