revise-data-modelslisted

# 複数の論理データモデルを業務知識から横断改訂する 読み終えると、各論理資料に対応する業務知識を読み取り専用の正本として先に読み、ドメインごとに現在状態・有効期間履歴・イベント列のどれを正本にするかを選び、複数資料で矛盾する分類、時刻、取消・訂正、技術イベントの扱いを一度に直して同じpathへ保存できる。業務イベントの存在だけを理由にイベント表を作らない。業務知識への永続化方式の追記、物理設計、移行、性能、API、DTO、ORMは扱わない。 同じdirectoryの`playbook.yml`が工程順の正本である。[実行指示書](references/execution-guidance.md)を読み、手順に入る前に同梱の内部skill `write-bdd`と`design-data-model`の`SKILL.md`を読み、入力の根拠づけ、業務の言葉、永続化理由、イミュータブルデータモデリング、NULL回避、関係データモデリングの判断規律を全工程へ適用する。 ## 入力 | 入力 | 内容 | 満たさないときの扱い | |---|---|---| | `user_input` | 横断改訂の目的と追加の設計指示 | 対象と目的を読めなければ止まる | | `targets` | 1件以上の`{logical_document_path, business_knowledge_paths}`。論理資料と業務知識は対象repositoryに追跡済みの通常fileの絶対path | 最初の事前条件検査で一件でも欠ければ、全資料を変更せず止まる | 論理資料と業務知識の対応は利用者が指定する。directory名や近いファイル名から推測しない。業務知識が存在しない領域は、テーブル設計ではなく`discover-domain`で業務知識を作る対象として返す。 `business_knowledge_paths`は設計判断の入力であり、この入口の更新対象ではない。業務知識に永続化、テーブル、イベント記録、正本方式などのデータモデル関心を追記しない。業務知識の意味が利用者の説明や別の正本と矛盾する場合は、業務上の対象・出来事・後の問いとして何が矛盾するかを返し、業務知識の更新はdomain discovery / formulationの独立した仕事として扱う。 ## 判断基準 | 観察対象 | 述語 | 行動 | |---|---|---| | 業務知識 | 業務上の対象、状態、業務イベント、規則、後の問いを読める | 正本選択へ進む。対応資料自体が無ければ設計せず止まる | | 業務イベント | 複数あり、その順序・取消・訂正・判断根拠を後から説明できないと業務が困る | イミュータブルなイベント列を正本候補にする。件数だけでは選ばない | | 業務イベント | 存在しても、過去の経過が後の判断・説明・権利・義務に使われない | 現在状態を正本候補にし、保存理由のないevent recordを置かない | | 設定や契約条件 | 名前のある業務イベントは乏しいが、過去時点の値が後の判断を変える | 有効期間履歴を正本候補にする | | 設定や現在値 | 過去の変更が後の業務判断に影響しない | 更新可能な現在状態を正本候補にする | | 一度成立した業務上の事実 | event recordとして残す理由がある | イベント系にし、更新・削除せず、取消・訂正も元の事実を参照する追加イベントにする | | イベント列と現在リソース |