Linear migration metadata¶

• Linear issue: TAK-199
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-199/tak-192-e-既存ユーザー既存マスタとの照合方式を設計する
• Linear status: Done
• Linear team: Takayuki Komoda
• Linear project: EPAA App
• Linear assignee: Takayuki Komoda
• Linear labels:
• Linear created: 2026-07-12T21:50:43.484Z
• Linear updated: 2026-07-20T07:05:38.650Z
• Linear archived:

Original description¶

目的¶

Excel取込で新規マスタを作るだけでなく、既存のユーザーや既存マスタデータに紐付けるケースの扱いを設計する。

対応内容¶

• ユーザーID、ログインID、メールアドレス、表示名など、既存ユーザーとの照合キー候補を整理する。
• 既存マスタコード、名称、外部IDなど、既存マスタとの照合キー候補を整理する。
• Excel上の整数IDが既存DB id を指す場合と、外部システム上のIDを指す場合を区別する。
• 既存DB id を直接参照させる場合のテナント境界、存在チェック、CSV importエラー表示を設計する。
• 既存データと照合できない行をエラーにするか、新規マスタ生成にフォールバックするかを決める。

受入条件¶

• 既存ユーザー/既存マスタへの紐付け方針が明文化されている。
• 既存DB id を使う場合の安全条件が明確になっている。
• TAK-192本体に入れる範囲と後続実装に分ける範囲が明確になっている。
• 不明なIDやテナント外IDがCSV import時にエラーとして扱える設計になっている。

Linear attachments¶

• [TAK-199] 既存ユーザー・既存マスタ照合方針を文書化

Linear comments¶

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-20T01:50:36.911Z)¶

dev.epaa.jp 適用試行メモ（2026-07-20）

結果: Blocked / 未適用

確認したこと:

• https://dev.epaa.jp/、https://dev.epaa.jp/api/health、https://dev.epaa.jp/docs/requirements/generated-application-requirements.html は未認証で HTTP 401。Basic認証保護は有効。
• ローカルの SSH config は未設定。
• $HOME/.ssh には秘密鍵がなく、known_hostsのみ。
• ssh -o BatchMode=yes 133.18.143.17 "echo ok" と ssh -o BatchMode=yes dev.epaa.jp "echo ok" は Permission denied (publickey,password)。
• .modelify/deployment-settings.json は存在しない。
• Notionの dev.epaa.jp 検証環境情報 でも、秘密値は記録せず、接続情報または既存デプロイ手順の提供待ちとされている。

注意事項:

• TAK-199自体はdocs-onlyのため、5002/browser/dev反映は必須ゲートではありません。
• 実際にdevへ反映するには、Basic認証情報とSSH/デプロイ設定、または既存デプロイ手順の提供が必要です。
• 秘密値はNotion/Linear/Gitへ記載しません。

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-20T01:24:42.975Z)¶

TAK-199の文書化対応をDraft PR化しました。

PR: https://github.com/takataka328-max/EPAA/pull/120

注意事項:

• このPRはドキュメントのみの変更です。
• FE/BE/DB/OpenAPI/生成ソース/ランタイム挙動の変更はありません。
• 5002検証、ブラウザスモーク、dev.epaa.jp反映は、ブラウザ表示や実行時挙動に影響しないため未実施です。
• 後続で照合設定をメタデータ化する場合は、Generator GUIで作成・編集・削除できる管理経路が必要です。
• 未追跡の .modelify/ は既存の対象外変更として触っていません。