型付き辺: 出 1 / 入 0
ADR-0004: ヘッダー列名の統一命名規則
- Status: Accepted (旧形式「## ステータス: 採用済み」より転記)
- Mode: Standard (内容から推定・旧 README 一覧より移設)
- Kruchten Type: Property
- Scope: product
- Implementation Status: Done (ヘッダー命名規則運用中)
Kruchten Type は ADR-0031 (2026-05-13) で遡及追加。分類根拠は ADR-0031 §決定セクションおよび docs/adr/README.md の Kruchten 3 分類ガイドを参照。 Status / Mode / Scope は 2026-06-11 に遡及追加 (ADR-0031 corrigendum パターン)。出典: Status = 旧形式「## ステータス」節の機械転記 / Mode = 旧 README §既存 ADR 一覧の推定値 (git 履歴) / Scope = ADR-0049 4 層分類の遡及付与 (PR レビューで確定)。
ステータス: 採用済み (2026-04-10)
コンテキスト
各タブのヘッダー列名が不統一で、同じ意味のデータに異なる名前が使われていた。 例: 「発生年月」「発生日」「発生日(P/L計上日)」が混在し、ヒューマンエラーの温床に。
決定
全タブで以下の命名規則を採用する。DDLのRENAME_MAPでマイグレーション時のデータ保持を保証。
| カテゴリ | 命名規則 | 例 |
|---|---|---|
| 日付 | {意味} | 発生日(P/L計上日), 決済日_計画, 決済日_実績 |
| 金額 | {種別}_{フェーズ} | 税抜金額_計画, 税込金額_決済, 消費税額_発注 |
| 基準日 | 支払基準日 | 毎月の支払日(DD) |
| ステータス | {対象}ステータス | 請求ステータス, 決済ステータス, 仕訳ステータス |
理由
- ヘッダー名からデータの意味・所属フェーズが即座にわかる
- コード内のindexOfが一意に解決される（フォールバック不要）
- DDLのRENAME_MAPで旧名→新名の自動マイグレーションを実現
結果・影響
- ポジティブ: 14ファイル、340行の変更で全コードベースを統一
- ポジティブ: RENAME_MAPにより既存データが失われない
- ネガティブ: 旧名を参照するカスタムクエリ等があれば修正が必要
Confirmation (準拠確認 / Fitness Function)
本セクションは ADR-0036 (Accepted 2026-05-14) で遡及追加された。ADR-0031 パターン (業界標準準拠メタデータ後付け = 誤字修正範疇) に準拠する遡及で本文の意思決定内容は不変。
- 検証手段: scripts/adr-lint.mjs + scripts/4_review_specs_by_gemini.js
- 実行頻度: PR ごと
- 違反時の対応: 自動 fail