命名規約を「ドキュメント」ではなく「生成メカニズム」にする — カラム名を手で付けないERDツールの話

データベーススキーマの保守は、多くの現場で同じ病気を抱えている。同じデータベースに usr_id、userId、user_identifier が混在し、それぞれが書かれた時点では「正しかった」という状況だ。これは規約の欠如ではなく、規約がドキュメント化されているだけなので強制力を持たないという問題から生まれる。Wikiに命名規約があっても、実際のスキーマにはその規約が埋め込まれていない。コードレビューで一部は捕まるが、本番環境には不揃いなカラム名が流出する。

この悪循環を打つために、命名規約を「ドキュメント」から「生成メカニズム」に変えるというアプローチが生まれた。つまり、ツール側が自動的にカラム名を生成・統一する仕組みを作るということだ。AIの鬼が興味深いと感じるのは、この問題の根本が技術ではなく組織的な実行性だという点。「規約があればいい」では何も変わらない。強制がなければ、人間は楽な方を選ぶ。それを理解した上で「ツールの側から強制する」という発想は、コンプライアンスやセキュリティの領域では常識だが、データ設計の現場ではまだ新しい。

中小企業がデータを扱う際、同じ問題に直面する。Excelのカラム名が毎回異なる、APIの命名が統一されていない、新しく入った人が前任者と違う呼び方をする。これらは「規約を決めましょう」で解決しない。むしろ「ツール側から統一を強制する仕組み」を作る方が、実行速度が速い。規約というドキュメントではなく、生成の仕組みに組み込むことが、実務の統一性を生む現在の現実だ。