Linear migration metadata¶

• Linear issue: TAK-211
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-211/devepaajp確認環境向けに最新サンプルアプリを再整備する
• Linear status: Done
• Linear team: Takayuki Komoda
• Linear project: EPAAサンプルアプリ
• Linear assignee: Takayuki Komoda
• Linear labels: Feature
• Linear created: 2026-07-15T21:33:32.927Z
• Linear updated: 2026-07-16T14:40:36.416Z
• Linear archived:

Original description¶

目的¶

ユーザーの動作確認先をローカルPCの 5001 から dev.epaa.jp に移し、確認環境へ常に最新のサンプルプロジェクトを配置できるようにする。あわせて、サンプルアプリを新規作成し直し、請求書機能と情報共有Wiki機能を確認できる状態にする。

Notion方針¶

• https://app.notion.com/p/39e8d886122a81a982edd1a064011bc0

スコープ¶

• dev.epaa.jp をユーザー確認先として扱う運用の整理
• サンプルプロジェクトを最新生成物で置き換える手順の整備
• サンプルアプリの新規作成
• 請求書機能の実装または再構成
• 情報共有Wiki機能の実装
• サンプルデータ、初期データ、配置手順、確認手順の整備
• AGENTS.md または関連 adoc/ への運用反映

受入条件¶

• dev.epaa.jp で最新サンプルアプリにログインできる。
• 請求書の一覧、登録、詳細、明細、ステータス確認ができる。
• Wikiの記事一覧、登録、詳細、カテゴリ/検索相当の確認ができる。
• 5002 検証を通した後に dev.epaa.jp へ反映する流れが記録されている。
• ブラウザ確認結果、必要なスクリーンショット、残リスクが報告されている。

設計時の確認事項¶

• dev.epaa.jp の実体、配置先、起動方式、DB名、TLS/リバースプロキシ管理方法
• 5001 を完全廃止するか、内部確認用として残すか
• 既存の TAK-142 サンプルアプリ：請求管理 と統合するか、新サンプル内で再構成するか
• TAK-160 サンプルアプリ：文書管理 をWiki機能へ流用するか、Wikiとして独立設計するか
• DB release SQL、初期データZIP、サンプルデータ投入方式の要否

関連Issue¶

• TAK-142 サンプルアプリ：請求管理
• TAK-160 サンプルアプリ：文書管理

Linear attachments¶

• TAK-211 dev確認向けサンプル再整備

Linear comments¶

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-16T14:23:05.041Z)¶

2026-07-16 完了扱い¶

ユーザー指示「これは完了で頼む」により、TAK-211を完了扱いにします。

• PR #115 は作成済み（target: develop / Draft）。
• ローカル 5002 / 5001 検証は完了済み。
• dev.epaa.jp 実反映は、このCodex環境のSSH/デプロイ資格情報不足により未実施。注意事項として既に記録済み。
• マージは従来ルールどおり、ユーザー承認が必要。

{"id" => "9aded6b7-dac6-4cf8-920a-d263232a992d", "name" => "Takayuki Komoda"} (2026-07-16T09:53:40.841Z)¶

2026-07-16 作業結果 / 注意事項¶

実装¶

• 請求書サンプルを下書き・確定・送付済みの3状態へ拡充。
• Wikiサンプルをナレッジ・請求・運用カテゴリへ拡充。
• 請求書既定ビューの invoice_status_flag: 12 を 1 に修正。
• start-generated-sample.cmd をDBリセット付き起動に変更し、古い epaa DBを持ち越さないようにした。
• ユーザーseedを dev.epaa.jp / ローカル検証用アカウント一覧に整理。秘密値は含めていない。

検証¶

• validate-metadata: OK
• generate-source: OK
• build-docs.ps1: OK
• 5002 / epaa_verify_5002: DBリセット、生成、backend build、frontend build OK
• generate-verification-report.ps1: 生成OK（Warningあり。既存のpermission差分系）
• run-verification-matrix.ps1 on 5002: passed=125 / failed=0 / skipped=0
• run-verification-browser-smoke.ps1 on 5002: OK
• 5001 / epaa: start-generated-sample.cmd でDBリセット付き再生成OK
• run-verification-matrix.ps1 on 5001: passed=125 / failed=0 / skipped=0
• run-verification-browser-smoke.ps1 on 5001: OK

注意事項¶

• dev.epaa.jp の実反映は未完了。このCodex環境にSSH config、EPAAデプロイ環境変数、利用可能なSSH鍵がなく、133.18.143.17 への非対話SSHは Permission denied。
• dev.epaa.jp反映には、サーバ接続情報または正式デプロイ手順の提供が必要。
• reports/ の証跡はローカル保存のみで、コミット対象外。