データ整備・マスタ追加案件

コード開発を伴わず、マスタデータの追加・DDLスキーマの軽微な変更・スプレッドシート上の手作業で完了する案件を集約したページです。 追加開発案件（TODO_future.md）から切り出したもので、開発者でなくても対応可能な作業が中心です。

対応ステータス

マスタデータ追加

DDLスキーマの軽微な変更

スプレッドシート手作業

未使用列の整理（削除候補）

以下はDDLスキーマに定義されているが、GASコードのビジネスロジックから一切参照されていない列です。 DDL定義・バリデーション設定・プルダウン生成では使用されている場合がありますが、データ処理ロジック（RPA・仕訳エンジン・データマート等）からは未参照です。

判定基準:

• 削除可: コードからもUI運用からも参照されておらず、削除しても影響なし
• 保留（将来利用）: 追加開発案件で使用予定がある、またはUI上で人間が参照している
• 保留（UI用途）: プルダウンや表示用に使われており、コードからの参照はないが運用上必要

削除可能な列

保留（将来利用予定）

保留（UI用途・人間が参照）

dev → prod 反映手順

データ整備（マスタ追加・DDLスキーマ変更等）を dev で検証した後、prod に反映する手順。

Phase 1 暫定運用: 手動反映

コードを伴わないデータ整備（D-01〜D-03 等のマスタ追加）は、dev で検証後に prod で同じ操作を手動で再実施する。

1. dev で作業・検証
   ├── マスタデータ追加（スプレッドシート手入力）
   ├── setupAllSchemas 実行（DDL変更がある場合）
   ├── RPA・マート更新で動作確認
   └── テストランナーで回帰テスト

2. prod に反映
   ├── npm run push:prod（コード変更がある場合）
   ├── prod スプレッドシートを開く（npm run open:prod）
   ├── マスタデータを手動で同じ内容を入力
   ├── setupAllSchemas 実行（DDL変更がある場合）
   └── 軽微な動作確認（RPA 1件実行等）

3. 確認チェックリスト
   □ dev と prod のヘッダー行が一致しているか
   □ 追加したマスタ行が正しく入力されているか
   □ RPA で新しいマスタを使った起票が正常に動くか

恒久対策: マイグレーションスクリプト（MAS-116）

データ整備の内容をコードとして記述し、dev/prod 両方で実行する方式。詳細は TODO_future.md MAS-116 を参照。

mas/800_ops/
  804_migration_d01_d03.js    ← D-01〜D-03: 科目マスタ3件追加
  805_migration_d04_d06.js    ← D-04/D-06: 科目マスタ説明列データ投入
  806_cleanup_empty_rows.js   ← 全シートの空行を物理削除

メリット:

• Git で差分レビュー → コードレビューしてから prod 実行
• 冪等性を担保（「既に存在したらスキップ」のチェック付き）
• 実行ログで「何をいつ適用したか」が追跡可能

変更履歴

マイグレーションスクリプト テンプレート

新規マイグレーションスクリプトを作成する際のテンプレート。804_migration_d01_d03.js の構造をベースにした汎用パターン。

ファイル作成手順

1. mas/800_ops/ に 8XX_migration_dNN_dNN.js を作成（番号は807から）
2. 以下のテンプレートをコピーしてカスタマイズ
3. 101_sys_config.js の「🔧 マイグレーション」メニューに .addItem() を追加
4. npm run push:dev → dev で実行・検証 → npm run push:prod → prod で実行

コードテンプレート

/**
 * =========================================================
 * 8XX_migration_dNN_dNN.js — (変更内容の要約)
 * =========================================================
 * D-NN: (案件の説明)
 * D-NN: (案件の説明)
 *
 * 冪等性: (どのようなチェックでスキップするか記載)
 * 手順: dev で実行・検証 → npm run push:prod → prod で実行
 */

function migrationDNNDNN() {
  var FUNC = 'migrationDNNDNN';

  // 1. 対象シートを取得
  var sheetName = Utils.getSheetNameByKey('SHEET_KEY');
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
  if (!sheet) throw new Error(sheetName + ' シートが見つかりません');

  // 2. ヘッダーインデックス構築（列番号ハードコード禁止）
  var headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
  var keyCol = headers.indexOf('キー列名');
  if (keyCol < 0) throw new Error('「キー列名」列が見つかりません');

  // 3. 既存データを読み込み（冪等性チェック用）
  var lastRow = sheet.getLastRow();
  var existingKeys = [];
  if (lastRow > 1) {
    existingKeys = sheet.getRange(2, keyCol + 1, lastRow - 1, 1)
      .getValues()
      .map(function(r) { return r[0]; });
  }

  // 4. 変更データの定義
  var changes = [
    // 変更内容をここに定義
  ];

  // 5. 冪等性チェック付きで変更を適用
  var results = [];
  var addedCount = 0;
  var skippedCount = 0;

  for (var i = 0; i < changes.length; i++) {
    var item = changes[i];
    var key = item[0]; // 一意キー

    if (existingKeys.indexOf(key) >= 0) {
      results.push(key + ': SKIP (既に存在)');
      skippedCount++;
      continue;
    }

    // 列Bで最終行を判定（列Aのチェックボックス回避）
    var appendRow = sheet.getLastRow() + 1;
    sheet.getRange(appendRow, 1, 1, item.length).setValues([item]);
    results.push(key + ': ADDED');
    addedCount++;
  }

  // 6. 結果サマリーを表示
  var summary = 'D-NN〜D-NN (変更内容の要約)\n'
    + '追加: ' + addedCount + '件 / スキップ: ' + skippedCount + '件\n\n'
    + results.join('\n');

  Utils.logInfo(FUNC, summary);
  SpreadsheetApp.getUi().alert('マイグレーション完了', summary, SpreadsheetApp.getUi().ButtonSet.OK);
}

メニュー登録（101_sys_config.js）

onOpen_() 関数内の「🔧 マイグレーション」メニュー定義に .addItem() を追加する。

ui.createMenu('🔧 マイグレーション')
  .addItem('D-01〜D-03: 科目マスタ3件追加', 'migrationD01D03')
  .addItem('D-04/D-06: 科目マスタ説明列データ投入', 'migrationD04D06')
  .addSeparator()
  .addItem('全シートの空行を物理削除', 'cleanupEmptyRows')
  .addSeparator()
  .addItem('D-NN〜D-NN: (説明)', 'migrationDNNDNN')  // ← 追加
  .addToUi();

チェックリスト

新規マイグレーション作成時に確認する項目:

• ファイル名が 8XX_migration_dNN_dNN.js の命名規則に従っている
• 関数名がファイル名と対応している（migrationDNNDNN）
• 冪等性チェックが実装されている（2回実行しても安全）
• Utils.logInfo と SpreadsheetApp.getUi().alert の両方で結果を出力している
• 「🔧 マイグレーション」メニューに登録した
• dev 環境で実行・検証を完了した
• CLAUDE.md のmas/800_ops/ファイル一覧にファイル名を追記した