tbm-customize

name	tbm-customize
description	TBM Templateの配賦ルール・マスターデータ・コストデータのカスタマイズを支援します。CSVシードファイルの編集、新しい部門やサービスの追加、配賦比率の変更、コストデータの追加・更新などを行います。「配賦ルールを変更」「部門を追加」「コストデータを更新」「サービスを追加」「ビジネスケイパビリティを追加」「予算データを編集」「シードを更新」「TBMデータをカスタマイズ」などのキーワードで発動します。
argument-hint	変更内容の説明（例: 「マーケティング部門を追加したい」「ERPの配賦比率を変更したい」）

TBM Template データカスタマイズ

CSVシードファイルを編集して、TBM Templateのデータをカスタマイズします。

共有リソース

• データモデル: ../tbm-core/references/data-model.md
• dbtコマンド: ../tbm-core/references/dbt-commands.md
• プロジェクト構成: ../tbm-core/references/project-structure.md

対象ファイル

すべて dbt/src/seeds/ 配下のCSVファイル:

• 組織マスター: master__business_units.csv, master__it_services.csv, master__business_capabilities.csv
• 配賦ルール: allocations__cost_to_tower.csv, allocations__tower_to_service.csv, allocations__service_to_business.csv, allocations__service_to_capability.csv
• 実績/予算: entries_cost.csv, entries_plan.csv

ワークフロー

Step 1: 変更内容の確認

ユーザーの要望を確認し、どのCSVファイルを編集するか特定する。 データモデルの詳細は ../tbm-core/references/data-model.md を参照。

Step 2: 現在のデータを読み取り

対象CSVファイルを読み取り、既存データの構造と値を把握する。

Step 3: CSVファイルの編集

以下のルールに従って編集する:

• IDの命名規則: スネークケース（英字小文字 + アンダースコア）
• 年度/月の整合性: 既存データと同じ fiscal_year, fiscal_month の組み合わせに合わせる
• 配賦比率の合計: 同じ配賦元から出る allocation_value の合計が 1.0 になるようにする
• マスターとの整合性: 配賦ルールのIDは、対応するマスターCSVに存在するIDを使用する
• 部門の階層: master__business_units.csv の parent_id で親子関係を表現。親部門の employee_count は子部門の合計

Step 4: 関連ファイルの連鎖更新

変更の影響範囲を確認し、関連ファイルも更新する:

• マスターを追加 → 対応する配賦ルールも追加が必要
• 配賦元を変更 → 下流の配賦ルールの比率調整が必要
• 年度を追加 → 全マスターと配賦ルールに新年度分を追加

Step 5: 検証

docker exec -it elt bash
cd /app/dbt/src
dbt seed --full-refresh
dbt run --full-refresh
dbt test

テスト結果を確認し、エラーがあれば修正する。

Step 6: 結果の確認

変更内容のサマリーをユーザーに提示する。 Grafana（http://localhost:3000）での確認を推奨。

注意事項

• master_tbm__*.csv（TBMタクソノミー）は基本的に変更不要
• 配賦比率の合計が1.0にならない場合、配賦されないコストが発生する
• 年度をまたぐデータは、各年度ごとにマスターと配賦ルールが必要
• 大きな変更は段階的に行い、各ステップでテストを実行することを推奨