feat: APKダウンロード機能を追加

[Atsumi3]

概要

APKダウンロード機能の追加と、販売APIのエラーハンドリング改善、店舗管理画面の実装を行いました。

主な変更点

1. APKダウンロード機能

• APKファイルのアップロード・管理機能を追加
• バージョン管理とダウンロード機能を実装
• Web UIとAPIエンドポイントの両方をサポート

2. 販売APIエラーハンドリングの改善

• 包括的な日本語エラーメッセージの実装
• staffBarcodeフィールドのnullable化
• APIの堅牢性向上（デフォルト値の設定）
• OpenAPI仕様書を実装に合わせて更新

3. 店舗管理画面の実装

• 店舗作成画面（/stores/new）
• 店舗編集画面（/stores/{id}/edit）
• Bootstrap 5によるモダンなUI/UXデザイン
• 削除機能に確認ダイアログを追加

4. OpenAPI仕様の更新

• CreateSaleRequestスキーマの修正
• SaleResponse/SaleItemResponseスキーマの追加
• ErrorResponseスキーマの更新
• レスポンスステータスコードの適切な設定

テスト方法

APK機能のテスト

# APK管理画面にアクセス
http://localhost:8080/apk

# APIでバージョン情報取得
curl http://localhost:8080/api/apk/version

店舗管理のテスト

# 店舗管理画面にアクセス
http://localhost:8080/stores

# 新規作成画面
http://localhost:8080/stores/new

# API経由で店舗一覧取得
curl http://localhost:8080/api/stores

販売APIのテスト

# 売上作成（エラーメッセージ確認）
curl -X POST http://localhost:8080/api/sales \
  -H "Content-Type: application/json" \
  -d '{"storeId": 1, "itemIds": "", "deposit": 1000}'

チェックリスト

• APKアップロード/ダウンロード機能の実装
• 販売APIのエラーハンドリング改善
• 店舗管理画面の実装
• OpenAPI仕様書の更新
• ビルド確認済み
• アプリケーション起動確認済み

関連Issue

• APKダウンロード機能の追加要望
• 販売APIのエラーメッセージ改善
• 店舗管理画面の実装

備考

• Java 21対応済み
• Spring Boot 2.7.3
• ktlintフォーマット適用済み

[github-actions]

🎨 Visual Regression Test Results

❌ Visual regression tests failed

Some pages have visual differences. Please review the artifacts:

📋 Actions to take:

1. Download test artifacts
2. Review the diff images to understand the changes
3. If changes are intentional, add update-snapshots label to this PR

📊 Test Coverage

• Desktop (1280x720)
• Tablet (iPad)
• Mobile (iPhone 13)

[github-actions]

🎨 Visual Regression Test Results

✅ All visual regression tests passed!

All page screenshots match the expected baselines.

📊 Test Coverage

• Desktop (1280x720)
• Tablet (iPad)
• Mobile (iPhone 13)

[github-actions]

🎨 Visual Regression Test Results

❌ Visual regression tests failed

Some pages have visual differences. Please review the artifacts:

📋 Actions to take:

1. Download test artifacts
2. Review the diff images to understand the changes
3. If changes are intentional, add update-snapshots label to this PR

📊 Test Coverage

• Desktop (1280x720)
• Tablet (iPad)
• Mobile (iPhone 13)

[github-actions]

🎨 Visual Regression Test Results

✅ All visual regression tests passed!

All page screenshots match the expected baselines.

📊 Test Coverage

• Desktop (1280x720)
• Tablet (iPad)
• Mobile (iPhone 13)

[github-actions]

🎨 Visual Regression Test Results

❌ Visual regression tests failed

Some pages have visual differences. Please review the artifacts:

📋 Actions to take:

1. Download test artifacts
2. Review the diff images to understand the changes
3. If changes are intentional, add update-snapshots label to this PR

📊 Test Coverage

• Desktop (1280x720)
• Tablet (iPad)
• Mobile (iPhone 13)