MAS-212: 論理削除の理由記録＋物理削除アーカイブ

概要

目的

本案件は次の 2 つの課題を同時に解決する。

1. 削除理由の説明責任 現状、有効フラグを FALSE にする論理削除は誰でも無言で実行できる。税務調査時等に「この行をなぜ無効化したか」を説明する手段がない。削除時に理由・操作者・日時を必須で記録することで、MAS-179 監査証跡と連携してトレーサビリティを確保する。

2. 論理削除データの蓄積によるシート肥大化防止 論理削除した行は永遠に 31/32/33 タブに残り続け、行数が増えるとマート再構築や findAll() キャッシュ更新コストが膨らむ。一定期間（デフォルト 6 ヶ月）経過した無効行を専用アーカイブシート（89_arch_*）に移動させ、元シートから物理削除することで、ワーキングタブを実稼働データのみに保つ。

現在のコード

• 31_wrk_order / 32_wrk_invoice / 33_wrk_bank は A 列に「有効フラグ」を持ち、FALSE の行は dmIsActive_ 相当のフィルタで集計・マート対象外となる（論理削除パターン）。
• 論理削除時のアテンションは既存の onEdit（100_config/101_sys_config.js:409 付近）に仕訳発行後の UPDATE 監査ロジックはあるが、削除理由を記録する仕組みは存在しない。
• 物理削除はメニューからの cleanupEmptyRows / cleanupDuplicateRows 等の限定的な運用ツールしかなく、「古くなった論理削除行を物理削除する」汎用アーカイブ機能は未実装。
• Repository 層（200_data/202_repository.js）に存在するのは OrderRepository / InvoiceRepository / BankTxRepository / JournalRepository / AccountRepository / PartnerRepository の 6 クラス。ExpenseRepository / FinanceRepository は存在しない。

修正方針

実装は以下の 2 ステップに分ける。各ステップ完了後に動作確認を行ってから次へ進む。

Step 1: DDL 変更と論理削除理由記録

1-1. setupAllSchemas() への 3 列追加（100_config/101_sys_config.js）

対象 3 シート（WRK_ORDR / WRK_INVC / WRK_BANK）の schemas 定義 headers 末尾に以下 3 列を追加する。

冪等性: setupAllSchemas() 既存パターン（confSheet.getDataRange().getValues().map(r => r[0]); if (!existKeys.includes('…')) …）はシート登録で使われており、列追加は schemas[key].headers 配列そのものをマスターソースとして setValues で上書きするパターン。既存の列の右側に 3 列を付け足す分には、既にデータが入っている下段行は影響を受けない（ヘッダー行のみ更新）。

setupAllSchemas 実行前に既存シートに値が入っている行があっても、新設 3 列は「空」のまま維持されるため安全に追加可能。

1-2. onEditLogicalDelete_ ハンドラの新設（300_ui/301_ui_assist.js）

既存 handleUxAssist(e) と同じファイルに新規関数を追加する。呼び出しはシンプルトリガー onEdit(e)（101_sys_config.js:409）から handleUxAssist(e) 同様に try { if (typeof onEditLogicalDelete_ === 'function') onEditLogicalDelete_(e); } catch(err) { console.error(...); } で受け渡す、または下記 1-3 でインストーラブルトリガーとして独立登録する（後者を採用）。

重要制約: SpreadsheetApp.getUi().prompt() / .alert() はシンプルトリガー（function onEdit(e)）からは呼び出せない（Exception: このサービスを呼び出すには認証が必要です になる）。そのため インストーラブルトリガーとして登録が必須。

ハンドラの処理フロー:

1. e.range の対象シート名が対象 3 シート（WRK_ORDR / WRK_INVC / WRK_BANK に対応する物理名）であることを確認。それ以外は即 return。
2. 編集された列が A 列（col === 1。ヘッダーから indexOf('有効フラグ') で動的取得するのが厳密だが、全シート共通で A 列固定の運用前提）であることを確認。
3. 編集後の値が false / FALSE であることを確認（true → false の遷移のみを対象にする。既に false の行への再編集は無視）。
4. SpreadsheetApp.getUi().prompt('無効化理由', '…', ui.ButtonSet.OK_CANCEL) で理由入力ダイアログを表示。
5. キャンセル時: e.range.setValue(e.oldValue) で元の値（true）にリバートし処理中断。
6. OK 時: 入力された理由、new Date()、Session.getActiveUser().getEmail() を同行の 無効化理由 / 無効化日時 / 無効化者 列に書き込む（列インデックスはヘッダーから indexOf で動的取得）。
7. Utils.auditLog('DELETE_LOGICAL', sheetName, recordId, '有効フラグ', 'onEditLogicalDelete_', true, false, reason) を呼び出す（recordId は B 列の ID 値）。

'DELETE_LOGICAL' は新設 operation コード。000_infra/004_utils.js:429 の Utils.auditLog JSDoc 列挙値 'CREATE' | 'UPDATE' | 'DELETE' | 'CONFIRM' | 'CANCEL' | 'RUN' | 'MIGRATE' に 'DELETE_LOGICAL' を追記する（ロジック変更なし、JSDoc のみ）。

1-3. インストーラブルトリガー登録関数（100_config/101_sys_config.js）

installAutoOpenSidebarTrigger の直下に類似パターンで installOnEditLogicalDeleteTrigger を追加。

function installOnEditLogicalDeleteTrigger() {
  const ui = SpreadsheetApp.getUi();
  var existing = ScriptApp.getProjectTriggers().filter(function(t) {
    return t.getHandlerFunction() === 'onEditLogicalDelete_';
  });
  existing.forEach(function(t) { ScriptApp.deleteTrigger(t); });
  ScriptApp.newTrigger('onEditLogicalDelete_')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();
  Utils.auditLog('RUN', '', '', '', 'installOnEditLogicalDeleteTrigger', '', { removed: existing.length, added: 1 }, 'N-36 計装');
  ui.alert('✅ 論理削除理由ダイアログを有効化', '有効フラグを FALSE にしたとき、理由入力ダイアログが表示されます。', ui.ButtonSet.OK);
}

uninstallOnEditLogicalDeleteTrigger も対で用意する。

メニュー登録は次節参照。

Step 2: 物理削除アーカイブ機能

2-1. アーカイブ先シートの DDL 追加

setupAllSchemas() の schemas オブジェクトに ARCH_WRK_ORDR / ARCH_WRK_INVC / ARCH_WRK_BANK を追加（対応物理名: 89_arch_31_wrk_order / 89_arch_32_wrk_invoice / 89_arch_33_wrk_bank）。ヘッダーは元シートと完全一致させる（3 列追加込みの定義を共有）。

01_sys_config の登録キーも ARCH_ORDR / ARCH_INVC / ARCH_BANK で追加。

2-2. archiveInvalidRecords() 本体（新規ファイル 800_ops/818_archive_records.js）

処理フロー:

1. 権限チェック: isPrivilegedUser_() で false なら中断（setupAllSchemas と同パターン）。
2. 保持期間取得: const retentionMonths = Constants.getParam('ARCHIVE_RETENTION_MONTHS', 6);
   • 03_sys_params に ARCHIVE_RETENTION_MONTHS が未登録でも 6 がフォールバック。初期設定として手動追記を推奨する旨を動作確認手順に含める。
3. 閾値日時計算: const threshold = new Date(); threshold.setMonth(threshold.getMonth() - retentionMonths);
4. シートごとのアーカイブ対象抽出（対象 3 シート分ループ）:
   • 該当 Repository の findAll() で { headers, dtos } を取得（OrderRepository / InvoiceRepository / BankTxRepository）。
   • dtos.filter(d => d.isActive === false && d.invalidatedAt instanceof Date && d.invalidatedAt < threshold) でアーカイブ対象を抽出。
   • dto.invalidatedAt が null / undefined / 空の行は保護対象（アーカイブしない）。旧データの誤削除を防ぐため。
5. 件数集計と確認ダイアログ:
   • 全シートの合計件数を算出。
   • 0 件ならアラートを出して正常終了。
   • 1 件以上なら SpreadsheetApp.getUi().alert('アーカイブ確認', '{シート名}: N件, {シート名}: M件\n合計 X 件をアーカイブします。よろしいですか？', ButtonSet.OK_CANCEL) を表示。キャンセル時は中断。
6. アーカイブ実行（確認 OK 後、シート単位ループ）:
   • 対象シートの全 DTO を「アーカイブ対象」と「保持レコード」に分割。
   • アーカイブ対象を 89_arch_{シート名} シートに sheet.getRange(lastRow+1, 1, n, headers.length).setValues(rowsToArchive) で追記（Contracts.dtoToRow 経由で DTO を行形式に変換）。
   • 保持レコードを元シートに Repository.save(dtos) で全件置換する。
   • Utils.auditLog('ARCHIVE', sheetName, '', '', 'archiveInvalidRecords', null, null, ${count}件アーカイブ (retention=${retentionMonths}ヶ月)) を呼び出す。
7. 完了通知: Utils.toastResult('archiveInvalidRecords', '{総件数}件をアーカイブしました') + ui.alert で完了表示。

'ARCHIVE' も新設 operation コード。Utils.auditLog JSDoc に追記する。

sheet.deleteRows() 使用禁止: Repository.save() による全件置換パターンを厳守。deleteRows() は例外時のロールバックが難しく、データ損失リスクがあるため。

2-3. onOpen メニュー追加（000_infra/002_constants.js）

Constants.MENU_DEFINITION の 「📋 サイドバー: 🔧 開発・設定」 カテゴリ（002_constants.js:241）に以下 3 項目を追加:

{ label: '🔒 論理削除ダイアログを有効化', funcName: 'installOnEditLogicalDeleteTrigger', description: '有効フラグ FALSE 時に理由入力ダイアログを表示するトリガーを設置' },
{ label: '🔓 論理削除ダイアログを無効化', funcName: 'uninstallOnEditLogicalDeleteTrigger', description: '論理削除理由ダイアログのトリガーを削除' },
{ label: '🗄️ 無効レコードをアーカイブ', funcName: 'archiveInvalidRecords', description: 'ARCHIVE_RETENTION_MONTHS 以上経過した論理削除行を 89_arch_* に移動' },

Contracts / Repository での DTO 拡張は Step 1-1 の DDL で追加した列を contracts.js の toDto/toRow にも反映する必要がある（isActive と同様に invalidationReason / invalidatedAt / invalidatedBy をマップ）。

影響範囲

注意事項

1. シンプルトリガーの制約: SpreadsheetApp.getUi().prompt() は function onEdit(e) からは呼べない。onEditLogicalDelete_ は必ずインストーラブルトリガー経由で呼び出すこと。installOnEditLogicalDeleteTrigger をユーザーがメニューから一度実行する必要がある（初回は認可ダイアログが表示される）。
2. 複数行同時変更: ユーザーが A 列を複数行まとめて FALSE に変更した（コピペ等）場合、e.range.getNumRows() > 1 となる。ダイアログを行数分表示するのは UX が悪いため、1 回だけ表示し、入力した理由を全対象行に適用する。
3. deleteRows() 禁止: アーカイブ処理の「元シートからの削除」は必ず Repository.save(保持レコード) による全件置換で実現する。deleteRows() は処理途中の例外でデータ損失リスクがある。
4. 新設 operation コードの JSDoc 同期: 'DELETE_LOGICAL' / 'ARCHIVE' は既存の Utils.auditLog JSDoc 列挙値に存在しない。実装時に必ず 000_infra/004_utils.js の JSDoc を拡張すること（ロジック変更不要だが、型推論・ドキュメント整合性のため）。
5. ARCHIVE_RETENTION_MONTHS 初期値: Constants.getParam のデフォルト値 6 が未登録時のフォールバックだが、運用開始前に 03_sys_params へ明示的に登録することを推奨（監査上、設定値の存在証明になる）。
6. Repository 未整備シートの扱い: TODO_future.md 原文では「31/32/33/42 等の主要タブ」とあったが、42_trn_journal には「有効フラグ」列が存在せず論理削除の概念が適用されない。本仕様では 42_trn_journal を対象外とする（人間検討事項に記載）。
7. 32_wrk_expense / 33_wrk_finance: これらのシートは現状のプロジェクトに存在しない（32_wrk_invoice / 33_wrk_bank のみ存在）。対象から除外する。
8. Contracts 層の同期: DDL で 3 列追加する際、000_infra/003_contracts.js の orderToDto / invoiceToDto / bankTxToDto と逆変換関数にも新プロパティを追加する。

エッジケース

実データ検証

実装着手前〜実装途中で、以下を MCP または GAS エディタで確認する。

1. 03_sys_params の ARCHIVE_RETENTION_MONTHS 登録状況確認
   • 未登録の場合: dev / prod いずれも手動で 1 行追加する（キー=ARCHIVE_RETENTION_MONTHS、値=6）。
   • 登録済みの場合: 値が妥当か（1〜24 程度の整数）を確認する。
2. 対象 3 シートのヘッダー最終列確認
   • 31_wrk_order / 32_wrk_invoice / 33_wrk_bank の現在のヘッダー末尾を MCP で取得し、無効化理由 / 無効化日時 / 無効化者 の 3 列が既に存在していないことを確認する。存在する場合は既に別案件で追加された可能性を調査する。
3. Repository 実在確認
   • 200_data/202_repository.js を Grep で ExpenseRepository / FinanceRepository を検索し、存在しないことを確認。存在した場合は対象シートを再検討する。
4. アーカイブシート命名衝突確認
   • 01_sys_config シートで 89_* / 89_arch_* というキーが既に登録されていないことを確認。
5. 既存有効フラグ=FALSE の件数確認
   • 対象 3 シートで 有効フラグ=FALSE の行数を事前にカウントしておき、初回アーカイブ実行時の期待件数と突合する（ただし 無効化日時 が空の旧データはアーカイブされない点に注意）。
6. isPrivilegedUser_() の動作確認
   • archiveInvalidRecords は特権操作とする想定。03_sys_params.PRIVILEGED_USERS に実行ユーザーが登録されているか確認する。

関連ドキュメント

• MAS-179 監査証跡の強化 — Utils.auditLog API と 98_audit_log シートの基盤。本案件の 'DELETE_LOGICAL' / 'ARCHIVE' オペレーションはこの基盤を拡張する。
• MAS-201 バックアップ基盤（809_backup_tool.js） — 800_ops/ 配下のファイル番号管理の前例。MAS-212 は 818 を使用する (旧仕様で 812 を予約していたが、MAS-057 tier seed が 812 を消費したため 2026-04-28 訂正で 818 に変更)。
• MAS-148 ワンクリック月次締め — アーカイブ実行を月次フローへ組み込む将来候補。
• CLAUDE.md プロジェクトルール — DDL (setupAllSchemas) 管理、列参照はヘッダー名ベース、有効フラグ=FALSE のスキップ方針。
• PRD プロダクトポリシー — Human-in-the-Loop（アーカイブ確認ダイアログ）の方針。

人間が検討すべき事項

1. アーカイブからの復元手順 当面は手動運用（アーカイブシート 89_arch_* から元シートへのコピペ）とする。復元専用ツール（例: restoreArchivedRecord(recordId)）は将来案件として TODO_future.md に別エントリを起こすかを検討する。
2. アーカイブ実行タイミング
   • 現行案: メニューからの手動実行のみ。
   • 将来案: MAS-148「ワンクリック月次締め」のフローへ組み込み（月次締め成功時に自動でアーカイブ走行）。自動化する場合、予期せぬデータ移動に備えて実行直前に MAS-201 バックアップを強制取得する運用を併設する。
3. 無効化理由の必須／任意
   • 現行案: 任意（空文字許容）。
   • 厳格運用案: 空文字時にダイアログ再表示、または FALSE へのリバート。
   • どちらを採用するかは UX（入力負担）と内部統制（説明責任の厳格化）のトレードオフ。
4. 旧データ（無効化日時 未記録の FALSE 行）の扱い
   • 現行案: アーカイブ保護対象（ずっと元シートに残る）。
   • 代替案 A: 別途マイグレーションスクリプト（810_migration_n36_backfill_invalidated_at.js 相当）で 無効化日時 = 案件リリース日 を一括付与し、保持期間経過後に自動アーカイブ対象化する。
   • 代替案 B: 人間が 1 行ずつ無効化日時を手動入力する（推奨しない）。
   • 対象行数次第でどちらが現実的かを決める。
5. アーカイブ先シートのアクセス権限
   • 89_arch_* シートを一般ユーザーから隠す（hideSheet()）、読み取り専用にする（protect() + 管理者のみ編集可）、またはそのまま参照可能にするかを運用で決定。税務調査対応の観点では「保持＋閲覧可能」が安全。
6. 保持期間の基準
   • 現行案: ARCHIVE_RETENTION_MONTHS = 6（無効化日時から 6 ヶ月）。
   • 代替案: 「年度末まで保持」「決算確定後N日」等の会計期準拠。後者の場合、判定ロジックが複雑化するため本案件ではシンプルな月数閾値を採用。会計期準拠が必要なら別案件化する。
7. アーカイブシートの構造
   • 現行案: タブ別（89_arch_31_wrk_order / 89_arch_32_wrk_invoice / 89_arch_33_wrk_bank）。元シートとヘッダー構造が一致するため復元が容易。
   • 代替案: 全タブ統合（89_arch_unified）にして「元シート名」列を追加。件数が少ないときはシート数を抑えられるが、ヘッダー構造の違いを吸収する実装コストが高い。
8. 自動仕訳 JNL_ID を持つ無効行のアーカイブ可否
   • JNL_ID が紐付いた行の論理削除は、既に 42_trn_journal 側の対応仕訳も無効化されている前提（現在の processInvoiceApprovals / processSettlementClearings の逆操作フロー）。本案件では「JNL_ID の有無でアーカイブ除外しない」方針だが、運用実態とのギャップがあれば要見直し。

実装プロンプト（Claude Code 用）

あなたは GAS 会計システム (bizlp-gas-accounting) のシニア開発者です。
案件 MAS-212「論理削除の理由記録＋物理削除アーカイブ」を実装してください。

## 実行前タスク（即座にツール実行。テキスト報告禁止）
1. `100_config/101_sys_config.js` を Read し、以下を確認する:
   - `setupAllSchemas()` の `schemas` オブジェクト定義パターン（`WRK_ORDR` / `WRK_INVC` / `WRK_BANK` の headers）
   - `01_sys_config` シート登録パターン (`if (!existKeys.includes('…')) confSheet.appendRow(…);`)
   - `onOpen()` の実装（Constants.MENU_DEFINITION をループして構築している）
   - `installAutoOpenSidebarTrigger` / `uninstallAutoOpenSidebarTrigger` のインストーラブルトリガー登録パターン
2. `000_infra/002_constants.js` の `Constants.MENU_DEFINITION` を Read し、「📋 サイドバー: 🔧 開発・設定」カテゴリの位置を確認する。
3. `000_infra/003_contracts.js` を Read し、`orderToDto` / `invoiceToDto` / `bankTxToDto` および逆変換関数のパターンを確認する。
4. `200_data/202_repository.js` を Read し、`OrderRepository.findAll()` / `save()` のシグネチャ、`InvoiceRepository` / `BankTxRepository` の構造を確認する。
5. `300_ui/301_ui_assist.js` を Read し、既存 `handleUxAssist(e)` の `e.range` / `e.oldValue` 参照パターンを確認する。
6. `000_infra/004_utils.js` の `Utils.auditLog` の JSDoc 列挙値 (`'CREATE' | 'UPDATE' | 'DELETE' | 'CONFIRM' | 'CANCEL' | 'RUN' | 'MIGRATE'`) を確認する。
7. `ls 800_ops/` で使用済み番号を確認し、`818_archive_records.js` が未使用であることを確認する (旧 spec で 812 を予約していたが MAS-057 tier seed が 812 を消費済のため 818 に変更済)。
8. MCP で対象 3 シート (`31_wrk_order` / `32_wrk_invoice` / `33_wrk_bank`) のヘッダー末尾列を取得し、`無効化理由` / `無効化日時` / `無効化者` の 3 列が存在しないことを確認する。
9. MCP で `03_sys_params` に `ARCHIVE_RETENTION_MONTHS` が登録済みかを確認する。未登録なら実装完了後の動作確認時に手動追加する。

## 修正対象ファイル
- `100_config/101_sys_config.js`
  - `schemas.WRK_ORDR` / `WRK_INVC` / `WRK_BANK` の headers 末尾に 3 列追加
  - `schemas.ARCH_WRK_ORDR` / `ARCH_WRK_INVC` / `ARCH_WRK_BANK` を新規追加（headers は元シート + 3 列と同一）
  - `01_sys_config` のシート登録エントリ 3 つを追加（`ARCH_ORDR` / `ARCH_INVC` / `ARCH_BANK`）
  - `installOnEditLogicalDeleteTrigger` / `uninstallOnEditLogicalDeleteTrigger` 関数を新設
- `000_infra/002_constants.js`
  - `MENU_DEFINITION` の「📋 サイドバー: 🔧 開発・設定」カテゴリに 3 メニュー項目を追加
- `000_infra/003_contracts.js`
  - `orderToDto` / `invoiceToDto` / `bankTxToDto` に `invalidationReason` / `invalidatedAt` / `invalidatedBy` を追加
  - 逆変換関数 (`dtoToOrderRow` 等) にも対応追加
- `000_infra/004_utils.js`
  - `Utils.auditLog` JSDoc の `@param operation` 列挙値に `'DELETE_LOGICAL'` と `'ARCHIVE'` を追記（ロジック変更なし）
- `300_ui/301_ui_assist.js`
  - `onEditLogicalDelete_(e)` 関数を新規追加
- `800_ops/818_archive_records.js`
  - 新規作成。`archiveInvalidRecords()` を実装

## 実装内容

### [1] setupAllSchemas の schemas 定義拡張（101_sys_config.js）
対象 3 シート（WRK_ORDR / WRK_INVC / WRK_BANK）の headers 末尾に次を追加する:
`"無効化理由", "無効化日時", "無効化者"`

アーカイブ先シートの schemas を新規定義:
- `ARCH_WRK_ORDR`: headers は WRK_ORDR と完全一致（3 列追加込み）、color は `"#434343"`（ログ系グレー）
- `ARCH_WRK_INVC`: 同上
- `ARCH_WRK_BANK`: 同上

`01_sys_config` 登録エントリ:
- `ARCH_ORDR` → `89_arch_31_wrk_order` （論理名: `アーカイブ_受発注台帳`）
- `ARCH_INVC` → `89_arch_32_wrk_invoice`（論理名: `アーカイブ_請求・債権債務台帳`）
- `ARCH_BANK` → `89_arch_33_wrk_bank` （論理名: `アーカイブ_入出金・消込台帳`）

### [2] Contracts 拡張（003_contracts.js）
`OrderDTO` / `InvoiceDTO` / `BankTxDTO` の @typedef に次のプロパティを追加:
- `invalidationReason: string`
- `invalidatedAt: Date|null`
- `invalidatedBy: string`

`orderToDto` / `invoiceToDto` / `bankTxToDto` で対応するヘッダー (`無効化理由` / `無効化日時` / `無効化者`) から読み取り。
逆変換関数でも同様に書き戻し。

### [3] Utils.auditLog JSDoc 拡張（004_utils.js）
`@param operation` 行の列挙値を次に置換（実装ロジックは変更しない）:
`'CREATE' | 'UPDATE' | 'DELETE' | 'DELETE_LOGICAL' | 'ARCHIVE' | 'CONFIRM' | 'CANCEL' | 'RUN' | 'MIGRATE'`

### [4] onEditLogicalDelete_ ハンドラ（301_ui_assist.js）
- 対象シート: `31_wrk_order` / `32_wrk_invoice` / `33_wrk_bank` のみ。それ以外は即 return。
- 編集列: A 列（col === 1）のみ。ヘッダー `有効フラグ` と一致することも確認。
- 編集後の値が `false` / `FALSE` であることを確認。それ以外は return。
- `e.range.getNumRows()` が複数なら複数行対応として処理（ダイアログは 1 回表示）。
- `SpreadsheetApp.getUi().prompt('無効化理由を入力してください', 'この論理削除の理由を記録します', ButtonSet.OK_CANCEL)` を表示。
- キャンセル時: `e.range.setValue(e.oldValue)`（複数行なら `setValues` で `e.oldValue` 相当を復元）して return。
- OK 時: `e.range.getSheet()` のヘッダーから `無効化理由` / `無効化日時` / `無効化者` の列インデックスを `indexOf` で取得。
- 対象全行の 3 列に次を書き込む（`Range#setValue` を行ごとにループ or `getRangeList` で一括）:
  - 無効化理由: prompt 入力値
  - 無効化日時: `new Date()`
  - 無効化者: `Session.getActiveUser().getEmail()`
- 各行に対して次を呼び出す:
  `Utils.auditLog('DELETE_LOGICAL', sheetName, recordId, '有効フラグ', 'onEditLogicalDelete_', true, false, reason)`
  （recordId は B 列の ID 値。`indexOf` でヘッダー `発注ID(ORD)` / `請求ID(INV)` / `決済ID(STL)` のいずれか該当するものを動的に取得）

### [5] installOnEditLogicalDeleteTrigger（101_sys_config.js）
既存 `installAutoOpenSidebarTrigger` と同じパターンで実装:
- 既存の同名ハンドラトリガーを削除
- `ScriptApp.newTrigger('onEditLogicalDelete_').forSpreadsheet(SpreadsheetApp.getActive()).onEdit().create();`
- `Utils.auditLog('RUN', ..., 'N-36 計装')` を呼び出す
- `ui.alert` で完了通知

`uninstallOnEditLogicalDeleteTrigger` も同様に実装。

### [6] MENU_DEFINITION への追加（002_constants.js）
「📋 サイドバー: 🔧 開発・設定」カテゴリに以下を追加:

```javascript
{ label: '🔒 論理削除ダイアログを有効化', funcName: 'installOnEditLogicalDeleteTrigger', description: '有効フラグ FALSE 時に理由入力ダイアログを表示するトリガーを設置' },
{ label: '🔓 論理削除ダイアログを無効化', funcName: 'uninstallOnEditLogicalDeleteTrigger', description: '論理削除理由ダイアログのトリガーを削除' },
{ label: '🗄️ 無効レコードをアーカイブ', funcName: 'archiveInvalidRecords', description: 'ARCHIVE_RETENTION_MONTHS 以上経過した論理削除行を 89_arch_* に移動' },
```

### [7] archiveInvalidRecords（新規 812_archive_records.js）
```
function archiveInvalidRecords() { ... }
```
処理順序:
1. `isPrivilegedUser_()` で false → アラート表示して return。auditLog に試行を記録。
2. `const retentionMonths = Constants.getParam('ARCHIVE_RETENTION_MONTHS', 6);`
3. `const threshold = new Date(); threshold.setMonth(threshold.getMonth() - retentionMonths);`
4. 対象シートごとのループ (WRK_ORDR / WRK_INVC / WRK_BANK):
   a. 該当 Repository の `findAll()` で `{ headers, dtos }` を取得。
   b. `filter()` で「アーカイブ対象」と「保持レコード」に分割。
      - アーカイブ対象: `dto.isActive === false && dto.invalidatedAt instanceof Date && dto.invalidatedAt < threshold`
      - `invalidatedAt` が null / undefined / 空は保護対象（保持レコード側へ）
   c. アーカイブ対象が 0 件ならスキップ。
   d. 集計に加える: `{ sheetName, archiveCount, retainDtos, archiveDtos }`
5. 総件数 0 件なら `ui.alert('アーカイブ対象レコードが見つかりませんでした')` で正常終了。
6. 確認ダイアログ表示:
   ```
   const response = ui.alert('アーカイブ確認', '31_wrk_order: N件\n32_wrk_invoice: N件\n33_wrk_bank: N件\n\n合計 X 件をアーカイブします。よろしいですか？', ui.ButtonSet.OK_CANCEL);
   if (response !== ui.Button.OK) return;
   ```
7. 各シートのアーカイブ実行:
   a. `89_arch_{シート名}` シートを取得（`setupAllSchemas` 実行済み前提）。未作成なら `insertSheet` + ヘッダー付与。
   b. アーカイブ対象 DTO を Contracts.toRow 相当で 2 次元配列化。
   c. `archSheet.getRange(lastRow+1, 1, n, headers.length).setValues(rows)` で追記。
   d. 元シートへ `Repository.save(retainDtos)` で全件置換（**`deleteRows()` 使用禁止**）。
   e. `Utils.auditLog('ARCHIVE', sheetName, '', '', 'archiveInvalidRecords', null, null, \`${count}件アーカイブ (retention=${retentionMonths}ヶ月)\`)` を呼び出す。
8. 完了通知: `Utils.toastResult('archiveInvalidRecords', '合計 {N} 件をアーカイブしました')` + `ui.alert`。

## 制約
- `sheet.deleteRows()` の使用を絶対に禁止する。全件置換（`Repository.save()`）パターンを厳守する。
- `onEditLogicalDelete_` はシンプルトリガーではなくインストーラブルトリガー経由で呼び出すこと。
- 列参照はヘッダー名ベース（`indexOf` / `buildHeaderIndex_`）で行う。列番号ハードコード禁止。
- メニュー名・関数名・シート名はすべて Read で実在する文字列のみ使用する。推測で書かない。
- `42_trn_journal` は有効フラグを持たないため対象外。
- `32_wrk_expense` / `33_wrk_finance` は存在しないため対象外。

## 動作確認（dev 環境）
1. `npm run push:dev` でデプロイ。
2. GAS エディタ (dev) で `setupAllSchemas` を実行し、対象 3 シートに 3 列が追加され、`89_arch_*` シートが新規作成されることを確認。
3. `03_sys_params` に `ARCHIVE_RETENTION_MONTHS = 3` を手動登録（テスト用に短期間）。
4. `Constants._paramsCache` をクリアするため一度 setupAllSchemas を再実行するか、テスト用に新しいセッションを開く。
5. サイドバー「🔒 論理削除ダイアログを有効化」を実行し、GAS「トリガー」画面に `onEditLogicalDelete_` が登録されることを確認。
6. `32_wrk_invoice` で任意行の有効フラグ (A 列) を FALSE に変更 → 理由入力ダイアログが表示されることを確認。
7. 理由を入力して OK → 同行の `無効化理由` / `無効化日時` / `無効化者` が埋まることを確認。
8. `98_audit_log` に `DELETE_LOGICAL` エントリが記録されることを確認。
9. 別の行で FALSE → ダイアログでキャンセル → A 列が `true` に戻り、無効化 3 列が空のままであることを確認。
10. 複数行まとめて FALSE（範囲選択→削除キー等）→ ダイアログ 1 回表示 → 全対象行に同じ理由が書き込まれることを確認。
11. テストデータとして、`無効化日時` が 4 ヶ月前の FALSE 行を手動で用意（`ARCHIVE_RETENTION_MONTHS = 3` なので対象化）。
12. サイドバー「🗄️ 無効レコードをアーカイブ」を実行 → 確認ダイアログ → OK。
13. 対象行が `89_arch_{元シート名}` に移動し、元シートから削除されていることを確認。
14. `98_audit_log` に `ARCHIVE` エントリが記録されていることを確認。
15. 「無効化日時が空の FALSE 行」を用意して 12 を再実行 → 0 件扱いでアラート表示、その行は保持されることを確認（旧データ保護の検証）。
16. テスト完了後、`ARCHIVE_RETENTION_MONTHS` を運用値 `6` に戻す。

## 本番反映
- dev で全テスト合格後、`npm run push:prod` で本番デプロイ。
- 本番の `03_sys_params` に `ARCHIVE_RETENTION_MONTHS = 6` を登録。
- 本番で `setupAllSchemas` 実行（Incremental モードでも Full 適用が走る。ハッシュ差分で検知される）。
- 特権ユーザーが「🔒 論理削除ダイアログを有効化」を実行（各スプレッドシートごとに 1 回必要）。

推奨実行モデル

変更履歴

仕様書作成プロンプト