Linear migration metadata¶

• Linear issue: TAK-242
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-242/サンプルカタログの登録更新管理画面を実装する
• Linear status: Backlog
• Linear team: Takayuki Komoda
• Linear project: EPAAサンプルアプリ
• Linear assignee:
• Linear labels:
• Linear created: 2026-08-29T08:10:26.615Z
• Linear updated: 2026-09-23T06:15:14.530Z
• Linear archived:

Original description¶

背景¶

現在の sample.epaa.jp は、PostgreSQL-backed のカタログAPIと seed データでサンプル情報を表示している。
/samples.json はDB内容から生成される manifest であり、サーバ上の固定JSON配置ではない。

一方で、サンプル登録・更新・スクリーンショット差し替え・アプリセット構成変更を行う管理画面はまだない。
更新頻度は高くないため、初期運用では seed / metadata / 手動登録で十分だが、将来的には管理画面から扱えるようにしたい。

方針¶

• 初期版は複雑なウィザードにしない。
• サンプルアプリはまず固定セットとして登録・配信できるようにする。
• 例: 請求書セット = 請求書 + 商品マスタ + 顧客マスタ + 税区分マスタ。
• セット内の依存関係は role / capability として保持する。
• 将来的に、依存関係のあるアプリを選択式ウィザードで差し替えられる余地を残す。
• ユーザー操作が複雑になりすぎないよう、通常導入は「セットを選ぶだけ」を基本にする。

対象¶

• サンプルカタログの管理画面
• サンプル基本情報の登録・更新
• バージョン情報の登録・更新
• スクリーンショット/アセットの登録・差し替え
• アプリセットの構成アプリ登録
• 構成アプリ間の依存関係登録
• 公開状態: 下書き / 公開中 / アーカイブ
• manifest 生成対象への反映

受け入れ条件¶

• 管理者がコード編集なしでサンプルを登録できる。
• 管理者がサンプルの説明、タグ、カテゴリ、公開状態を更新できる。
• 管理者がバージョンとスクリーンショットを追加・差し替えできる。
• 管理者がアプリセットの構成アプリと依存関係を登録できる。
• 登録した内容が /api/samples、詳細API、/samples.json に反映される。
• 初期実装では依存解決ウィザードを必須にしない。

関連¶

• TAK-241: サンプルプログラムの配信・選択・プロジェクト追加機能を整備する
• TAK-170: サンプルアプリ作成