Linear migration metadata¶

• Linear issue: TAK-270
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-270/tak-246-follow-up-csv照合キーを廃止しpk必須csv項目へ整理する
• Linear status: Done
• Linear team: Takayuki Komoda
• Linear project: EPAA Core
• Linear assignee: Takayuki Komoda
• Linear labels:
• Linear created: 2026-09-21T13:33:59.980Z
• Linear updated: 2026-09-22T01:31:31.472Z
• Linear archived:

Original description¶

背景¶

TAK-246の簡単/詳細モード棚卸中に、CSV設定の現行仕様が不整合であることを確認した。

問題¶

• 照合項目(import_csv_match_fields) はCSV項目制御と連動しておらず、単独で設定できても取込可能性を保証できない。
• 現行実装ではCSV取込対象が 編集可=true かつ CSV出力=true に依存し、出力項目と取込項目が分離されていない。
• 簡単モードでCSV ON/OFFだけを触っても、照合キー列や取込列を用意できない可能性がある。
• 論理削除項目 / 論理削除値 をCSV設定で個別に持つと、システム全体の削除方式・一覧・監査・復元方針とズレる。

方針¶

• CSVの 照合項目 は利用しない前提で廃止する。
• id(=PK) はCSV項目に必ず含める。UI上もCSV項目として必須扱いにし、無効化できないようにする。
• CSV取込時の照合キーは固定で id とする。
• 論理削除項目 / 論理削除値 はCSV設定から削除する。
• 論理削除を扱う場合は、CSV固有設定ではなくアプリ/テーブル全体の削除方式設定を参照する。

実装対象候補¶

• Core GUI / WebView2 GUI のCSV設定UI
• YAML管理の保存/読込モデル
• Generator metadata loader/validator
• 生成Backend CSV import/export
• Excel棚卸 TAK-246-core-gui-simple-detail-inventory.xlsx

受入条件¶

• CSV設定UIから照合項目、論理削除項目、論理削除値が消える。
• CSV出力/取込で id が必須CSV項目として扱われる。
• CSV取込の照合は id 固定になる。
• 簡単モードでCSV ON/OFFを設定しただけでも、最低限PK列を含むCSVとして成立する。
• 既存の論理削除方式とCSV取込欠損時処理の整合性が崩れない。

注意事項¶

• 既存メタデータに import_csv_match_fields、import_csv_logical_delete_field、import_csv_logical_delete_value がある場合の移行方針が必要。
• 新規登録CSVで id 空を許可するか、更新専用としてエラーにするかは実装前に決める必要がある。

Linear attachments¶

• TAK-270/271: CSV設定と出力ルールを整理