{"canonical_url":"https://engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/","content_markdown":"# プラットフォームの基礎技術方針を策定\n\n2025年11月のリポジトリ開設後の数週間に、多層構成、データベース中心のデータアクセス、警告ゼロという基礎方針を定め、9か月後も維持した。\n\n2025\n\n**状況.** リポジトリは2025年11月25日、空の状態で始まった。層の分け方、業務ロジックの置き場、品質基準など、最初の数週間の判断が大きく影響する。3日目には安い判断も、6か月目には後続のすべてが前提にしていて、覆すのがほぼ不可能になる。\n\n**課題.** 他の人や当時よりはるかに大きなコードへ引き継いでも残る形で、基礎方針を早期に、意図的に決める必要があった。\n\n**行動.** 3つの判断が大半を支えた。まず、その日の便利さでロジックを置かず、Next.js画面、検証・転送のGo API、業務ルールを持つPostgreSQL関数の各層に1つずつ役割を与えた。次に、後付けなら全ハンドラーを書き直すことになるため、最初からデータアクセスをストアド関数の背後に置いた。最後に、5,000コミット目なら大規模な修正作業を要する基準も、50コミット目なら通常の進め方になるため、コードが少ないうちから警告ゼロを適用した。どれも当時の簡単な選択ではなく、最初の月の進行速度を犠牲にした。\n\n**結果.** 9か月、数千コミット後にも3つすべてが残った。層は曖昧にならず、ハンドラーはテーブルを直接扱わず、ビルドに警告はない。基礎判断は正しく聞こえたかでなく、その後の作業量に耐えたかで評価すべきだった。便利さだけの選択は、その時点で静かに捨てられることが多いためだった。\n\n---\n\n- 役割: エンジニアリング責任者\n- カテゴリー: [プラットフォーム設計](https://advisory.engineer.company/ja/categories/platform-architecture/), [ソリューション設計](https://advisory.engineer.company/ja/categories/solution-architecture/), [バックエンド開発](https://advisory.engineer.company/ja/categories/backend/), [フロントエンド開発](https://advisory.engineer.company/ja/categories/frontend/), [フルスタック開発](https://advisory.engineer.company/ja/categories/full-stack/), [データベース](https://advisory.engineer.company/ja/categories/databases/), [DevOps](https://advisory.engineer.company/ja/categories/devops/), [セキュリティ](https://advisory.engineer.company/ja/categories/security/), [チームの統率](https://advisory.engineer.company/ja/categories/team-leadership/), [技術面の統率](https://advisory.engineer.company/ja/categories/technical-leadership/)\n- サービス: [プラットフォーム・ソリューション設計](https://advisory.engineer.company/ja/services/platform-architecture/), [バックエンド・API開発](https://advisory.engineer.company/ja/services/backend-development/), [フロントエンド開発](https://advisory.engineer.company/ja/services/frontend-development/), [フルスタックのプロダクト開発](https://advisory.engineer.company/ja/services/full-stack-development/), [技術面の統率・コンサルティング](https://advisory.engineer.company/ja/services/technical-leadership/)\n\n\u003chttps://engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"2025年11月に多層構成、データベース中心のアクセス、警告ゼロという基礎方針を定め、現在まで維持した。","formats":{"gemtext":"https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/index.gmi","gopher":"https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/gophermap","html":"https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/","json":"https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/index.json","markdown":"https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/index.md","pdf":"https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/index.pdf"},"kind":"page","language":"ja","title":"プラットフォームの基礎技術方針を策定","url":"https://advisory.engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/","version":1}