Linear migration metadata¶

• Linear issue: TAK-215
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-215/初期データzipをexcel取込後の生成定義に合わせて自動生成調整する
• Linear status: Done
• Linear team: Takayuki Komoda
• Linear project: EPAA App
• Linear assignee: Takayuki Komoda
• Linear labels: Improvement
• Linear created: 2026-07-20T12:58:37.395Z
• Linear updated: 2026-07-21T21:10:57.657Z
• Linear archived:

Original description¶

背景¶

TAK-204の検証で、単一シートExcelからサブテーブル付きアプリを生成する場合、生成後のDB/metadata定義に合わせて初期データZIPを別途整形する必要があることが分かった。

現状は、Excelはアプリ生成用の元ネタ、初期データZIPは生成後定義に合わせて別途作成する前提になっている。ユーザー確認では、この手動調整は避けたいが、今回のTAK-204本体からは外して将来対応とする。

対応案¶

• Excel取込で確定した親/子リソース、フィールド、計算項目、既存参照設定をもとに、初期データZIPを自動生成または調整できるようにする。
• 単一シート台帳から親CSV・子CSV・initial-data-manifest.jsonを生成する。
• 計算項目（例: 親の合計金額 = 子の金額合計）はZIPから除外する。
• users/groupsはresourcesに含めず、login_id/email/group_codeの既存参照としてmanifestへ出力する。
• previewで未解決/曖昧参照を表示し、commit不可にする既存TAK-204方針と整合させる。

受け入れ条件案¶

• 単一シートExcelから、親・子サブテーブル用CSVとmanifestを生成できる。
• users/groupsの取込CSVは生成されない。
• 既存ユーザー/グループ参照はlogin_id/email/group_codeとしてmanifestに表現される。
• 計算フィールドは初期データZIPに含めない。
• 生成ZIPを初期データ取込preview/commitに通せる。

注意¶

• TAK-204ではこの自動ZIP生成/調整は実装しない。
• TAK-204の検証は、単一シートExcelからサブテーブル付きアプリ定義を作る範囲に絞る。

Linear attachments¶

• TAK-215 初期データZIPの既存参照と固定リソース除外を改善

Linear comments¶

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-21T21:10:57.824Z)¶

完了確認。

• PR: https://github.com/takataka328-max/EPAA/pull/124
• マージ先: develop
• squash merge commit: 3c60cf8dc6f806092815e867ff049aeef07fa239

実施チェック:

• dotnet test tests\generator-gui\EPAA.Generator.Gui.Tests.csproj --filter FullyQualifiedName~ExcelImportServiceTests --verbosity minimal -> 34/34 passed
• dotnet test tests\fixed\backend\EPAA.FixedBackend.Tests.csproj --filter FullyQualifiedName~InitialDataImportServiceTests --verbosity minimal -> 21/21 passed
• npm.cmd run build -> passed（Vite chunk-size warningのみ）
• publish-generator-gui.ps1 -> passed

注意事項:

• 5002 verification matrix / browser smoke / dev.epaa.jp反映は未実施。Generator GUIのExcel import/publish範囲で、生成アプリruntime/API/DB/auth/生成アプリ画面の変更ではないため対象外。
• GUI起動ログの再取得ではログファイルを拾えなかった。publish成功とdist/exe存在は確認済み。
• npm ci で既存frontend依存のhigh auditが1件あり。TAK-215範囲外として未対応。