プラットフォームの基礎技術方針を策定
2025年11月のリポジトリ開設後の数週間に、多層構成、データベース中心のデータアクセス、警告ゼロという基礎方針を定め、9か月後も維持した。
実施時期: 2025
今も維持される初期の判断
状況. リポジトリは2025年11月25日、空の状態で始まった。層の分け方、業務ロジックの置き場、品質基準など、最初の数週間の判断が大きく影響する。3日目には安い判断も、6か月目には後続のすべてが前提にしていて、覆すのがほぼ不可能になる。
課題. 他の人や当時よりはるかに大きなコードへ引き継いでも残る形で、基礎方針を早期に、意図的に決める必要があった。
行動. 3つの判断が大半を支えた。まず、その日の便利さでロジックを置かず、Next.js画面、検証・転送のGo API、業務ルールを持つPostgreSQL関数の各層に1つずつ役割を与えた。次に、後付けなら全ハンドラーを書き直すことになるため、最初からデータアクセスをストアド関数の背後に置いた。最後に、5,000コミット目なら大規模な修正作業を要する基準も、50コミット目なら通常の進め方になるため、コードが少ないうちから警告ゼロを適用した。どれも当時の簡単な選択ではなく、最初の月の進行速度を犠牲にした。
結果. 9か月、数千コミット後にも3つすべてが残った。層は曖昧にならず、ハンドラーはテーブルを直接扱わず、ビルドに警告はない。基礎判断は正しく聞こえたかでなく、その後の作業量に耐えたかで評価すべきだった。便利さだけの選択は、その時点で静かに捨てられることが多いためだった。

写真: manfredrichter / Pixabay 
写真: analogicus / Pixabay
次に読む: 268検査を持つリポジトリの検査基盤を構築. すべての実績はこちら: 実績紹介.

