Linear migration metadata¶

• Linear issue: TAK-132
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-132/excelcsvから業務アプリ定義resourceyamlを生成する
• Linear status: Done
• Linear team: Takayuki Komoda
• Linear project: EPAA App
• Linear assignee: Takayuki Komoda
• Linear labels:
• Linear created: 2026-07-02T22:58:59.361Z
• Linear updated: 2026-07-18T22:39:30.207Z
• Linear archived:

Original description¶

背景¶

ExcelやCSVで管理している台帳をEPAAへ移行しやすくする。

対象¶

• Excel/CSV解析
• テーブル候補抽出
• フィールド型推定
• 主キー・候補キー推定
• リレーション候補提示
• resource.yaml生成
• ユーザー確認後に反映

追加要件¶

• VLOOKUP、XLOOKUP、INDEX/MATCH、名前付き範囲、入力規則リスト、別シート参照などから参照マスタ候補を抽出し、必要に応じて複数アプリを生成できること
• 複数シートを解析し、単一アプリ、複数アプリ、親子テーブル、参照マスタへの分割候補を提示できること
• Excel/CSV内の既存データを、初期データまたは業務データとして一括インポートできること
• 値の種類数、出現頻度、表記ゆれから、自由入力、選択肢、参照マスタ化の候補を自動判定できること
• パターン化された値はラジオボタン、セレクトボックス、チェックボックス候補として提示できること
• 主キー、候補キー、ユニーク制約、表示名項目、検索対象項目、一覧初期表示項目を推定できること
• TEL、メールアドレス、郵便番号、URL、日付、金額、割合、コード値、桁数、小数点、最大長、最小/最大値などから型・書式・バリデーション候補を推定できること
• 必須項目、空白許可、NULL許可、既定値候補をデータ分布から判定できること
• 個人情報らしい列を検出し、マスキング、監査、項目権限候補として提示できること
• インポート前に成功、警告、失敗件数をプレビューし、失敗レコードと理由を確認できること
• インポート時にエラーとなるレコードがある場合、行番号、項目名、原因、修正案を結果として報告できること
• エラーレコードを修正用CSV/Excelとして出力できること
• 既存resource.yamlがある場合は、新規作成だけでなく差分マージ候補を生成できること
• 生成結果はTAK-134の差分確認・マッピング・承認画面へ渡し、人が確認してからYAML反映すること

実装方針¶

• まずExcel/CSVを先行し、kintoneより先にMVPを作る。
• ExcelファイルをLLMへ丸投げせず、C#側で決定的に解析して構造化JSONへ分解する。
• LLMには、シート概要、列統計、サンプル値、数式/参照情報、推定結果など、判断が必要な要約だけを渡す。
• C#側の解析結果とLLMの提案結果をTAK-134のレビュー画面へ渡し、人が確認してからYAMLへ反映する。

MVP範囲¶

• .xlsx 1ファイル、1シートを対象にする。
• ヘッダー行とサンプル100件程度を読み取る。
• 列名、行数、空欄率、重複率、ユニーク率、値種類数、最大長を抽出する。
• 基本型、必須、ユニーク候補、選択肢候補、TEL/メール/日付/数値などの基本バリデーション候補を推定する。
• 単一アプリのresource.yaml候補を生成する。
• 生成結果はTAK-134へ渡せる中間モデルとして出力する。

後続拡張¶

• 複数シート、VLOOKUP/XLOOKUP、名前付き範囲、入力規則リスト、外部参照の解析。
• 参照マスタ自動生成、複数アプリ生成、親子テーブル化。
• Excel/CSV内データの一括インポート、エラーレコード報告、修正用ファイル出力。
• 既存resource.yamlへの差分マージ。

Linear attachments¶

• Initial deploy scriptをLFで出力する
• TAK-132 Excel選択肢のi18nキー生成を補正
• TAK-132 Excel取込のAI候補補正を追加
• TAK-132 Excel import MVP and review workflow