Linear migration metadata¶

• Linear issue: TAK-197
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-197/tak-192-c-参照マスタresourceyamlとcsv-zipを生成する
• Linear status: Done
• Linear team: Takayuki Komoda
• Linear project: EPAA App
• Linear assignee:
• Linear labels:
• Linear created: 2026-07-12T21:49:54.738Z
• Linear updated: 2026-07-19T02:54:56.898Z
• Linear archived:

Original description¶

目的¶

解析した参照マスタ候補から、マスタアプリ、元アプリ側relation、投入用CSV ZIPを生成する。

対応内容¶

• マスタ化ONの候補からマスタアプリ定義を生成する。
• 元アプリ側にrelationフィールドを生成する。
• relationの code_field はExcel整数IDまたは業務キー列を利用できるようにする。
• 同じ参照先テーブルを複数フィールドで参照する場合、relation名と物理名が衝突しないようにする。
• マスタCSVと元アプリCSVをZIPにまとめる。
• ZIP内の投入順が分かる命名にする（例: 01_master.csv, 02_main.csv）。
• マスタ化しない候補は通常項目または固定選択肢として扱う。

受入条件¶

• 生成したYAMLがmetadata検証に通る。
• マスタCSVを先に取り込むことで、元アプリCSVのrelation解決ができる。
• DB id ではなく採用した照合キーで参照解決できる。
• 同一マスタ複数参照でもrelation名が衝突しない。

Linear attachments¶

• PR #118 [TAK-192] Excel参照候補とサブテーブル取込に対応

Linear comments¶

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-19T02:55:18.553Z)¶

PR #118 / TAK-192 が develop へmerge済みのため、本Issueも完了として Done に変更しました。

完了根拠:

• 参照マスタresource/i18n/seed、relation、tenant-aware unique key、CSV __code、親先行manifest、生成名重複検証がPR #118に含まれています。
• PR #118 merge commit: 8529e854307ef39282fc2ec7fad29d432615a6b2

注意事項:

• workbook由来metadataを5002へ反映したCSV preview/commitは未実施です。構造と投入順は単体テストで検証済みです。

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-18T13:04:53.419Z)¶

PR #118 に参照マスタresource/i18n/seed、relation、tenant-aware unique key、CSV __code、親先行manifest、生成名重複検証を含めました。正式metadata検証と単体テストは成功しています。

注意事項: このworkbook由来の生成metadataを5002へ反映したCSV preview/commitは未実施です。PRマージ前レビュー待ちとしてIn Reviewです。
https://github.com/takataka328-max/EPAA/pull/118

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-18T11:31:50.743Z)¶

TAK-192 実装計画への割当（2026-07-18）¶

今回の統合ブランチ codex/tak-192-excel-reference-subtable では、本課題をC#側の担当単位として再利用します。

• VLOOKUP/XLOOKUP、INDEX/MATCH、別シート参照、名前付き範囲、入力規則、値重複の候補解析
• 候補を自動確定せず、通常/選択肢/relation/subtableの採用判断を確認モデルで保持
• relation用 resource.yaml / i18n.yaml / seed.yaml と __code CSV生成
• subtable採用時の children、子側parent relation、親→子投入順
• seedを含む一時metadata検証

既存DB移行、外部ブック取得、INDIRECT/OFFSET自動解決は対象外です。